The Proofreader API

Thomas Steiner

Alexandra Klepper

פורסם: 12 בספטמבר 2025

סרטון הסבר	פיתוח אתרים	תוספים	הסטטוס של Chrome	הרציונל
GitHub	גרסת מקור לניסיון	גרסת מקור לניסיון	תצוגה	כוונה ליצור אב טיפוס

הגהה היא תהליך של חיפוש ותיקון שגיאות בדקדוק, באיות ובפיסוק. דפדפנים ומערכות הפעלה מציעים יותר ויותר הגהה לכלים שלהם לכתיבת תוכן, כמו ב-Google Docs.

באמצעות Proofreader API, אתם יכולים לספק הגהה אינטראקטיבית לאפליקציית האינטרנט או לתוסף שלכם, עם AI מובנה. ה-API הזה מציע את הפונקציות הבאות:

• תיקון: תיקון של קלט המשתמש מבחינת דקדוק, איות ופיסוק.
• תוויות: מתייגים כל תיקון לפי סוג השגיאה.
• הסבר: הגדרה של השגיאה או הסבר למה היה צורך בתיקון בשפה פשוטה.

תרחישים לדוגמה

יש הרבה סיבות לשימוש ב-Proofreader API, למשל:

• להציע תיקונים להודעות בפורומים, לתגובות על מאמרים ולאימיילים, לפני שליחת הפוסט.
• לספק תיקונים במהלך סיכום פעיל.

תרחיש השימוש שלכם לא מופיע? כדי לשתף משוב, אפשר להצטרף לתוכנית הגישה המוקדמת.

שנתחיל?

הצטרפות לגרסת המקור לניסיון של Proofreader API, שפועלת ב-Chrome מגרסה 141 עד 145.

הוספת תמיכה ב-localhost

כדי לגשת ל-Proofreader API ב-localhost במהלך תקופת גרסת המקור לניסיון, צריך לעדכן את Chrome לגרסה העדכנית. לאחר מכן, בצע פעולות אלה:

1. לעבור אל chrome://flags/#proofreader-api-for-gemini-nano.
2. בוחרים באפשרות מופעל.
3. לוחצים על הפעלה מחדש או מפעילים מחדש את Chrome.

הרשמה לתקופת ניסיון של תכונה חדשה

כדי להתחיל להשתמש ב-Proofreader API, פועלים לפי השלבים הבאים:

1. אישור המדיניות של Google בנושא שימוש אסור ב-AI גנרטיבי.
2. עוברים אל גרסת המקור לניסיון של Proofreader API.
3. לוחצים על הרשמה וממלאים את הטופס. בשדה 'מקור באינטרנט', מזינים את המקור או את מזהה התוסף, chrome-extension://YOUR_EXTENSION_ID.
4. כדי לשלוח, לוחצים על הרשמה.
5. מעתיקים את האסימון שסופק ומוסיפים אותו לכל דף אינטרנט משתתף במקור או כוללים אותו במניפסט של התוסף.
   • אם אתם מפתחים תוסף, אתם צריכים לפעול לפי ההוראות לניסוי מקור של תוספים.
6. מתחילים להשתמש ב-Proofreader API.

איך מתחילים להשתמש בתקופות ניסיון של מקורות

שימוש ב-Proofreader API

כדי לקבוע אם המודל מוכן לשימוש, קוראים ל-Proofreader.availability(). אם התשובה ל-availability() הייתה "downloadable", צריך להמתין להתקדמות ההורדה ולעדכן את המשתמש, כי ההורדה עשויה להימשך זמן מה.

const options = {
  expectedInputLanguages: ['en'],
};
const available = if (Proofreader.availability("downloadable") === true);

כדי להפעיל את ההורדה וליצור מופע של הכלי להגהה, צריך לבדוק אם יש הפעלת משתמש. לאחר מכן, קוראים לפונקציה Proofreader.create() האסינכרונית.

const session = await Proofreader.create({
  monitor(m) {
    m.addEventListener('downloadprogress', (e) => {
      console.log(`Downloaded ${e.loaded * 100}%`);
    });
  },
  ...options,
});

יצירה של אובייקט Proofreader

כדי ליצור כלי להגהה, משתמשים בפונקציה Proofreader.create().

const proofreader = await Proofreader.create({
  expectedInputLanguages: ["en"],
  monitor(m) {
    m.addEventListener("downloadprogress", e => {
      console.log(Downloaded ${e.loaded * 100}%);
    });
  }
};

השיטה create() כוללת את האפשרויות הבאות:

• ‫expectedInputLanguages: מערך של שפות קלט צפויות.

האפשרויות includeCorrectionTypes ו-includeCorrectionExplanation מתוך ההסבר לא נתמכות.

מתחילים להגיה את הטקסט של המשתמש

מתקשרים אל proofread() כדי לקבל תיקונים לטקסט קלט:

const proofreadResult = await proofreader.proofread(
  'I seen him yesterday at the store, and he bought two loafs of bread.',
);

תיקונים הם סוג של ProofreadResult. אפשר למצוא את הקלט המתוקן במלואו במאפיין correctedInput ואת רשימת התיקונים במערך corrections:

let inputRenderIndex = 0;

console.log(proofreadResult.correction);

for (const correction of proofreadResult.corrections) {
  // Render part of input that has no error.
  if (correction.startIndex > inputRenderIndex) {
    const unchangedInput = document.createElement('span');
    unchangedInput.textContent = input.substring(inputRenderIndex, correction.startIndex);
    editBox.append(unchangedInput);
  }
  // Render part of input that has an error and highlight as such.
  const errorInput = document.createElement('span');
  errorInput.textContent = input.substring(correction.startIndex, correction.endIndex);
  errorInput.classList.add('error');
  editBox.append(errorInput);
  inputRenderIndex = correction.endIndex;
}

// Render the rest of the input that has no error.
if (inputRenderIndex !== input.length){
  const unchangedInput = document.createElement('span');
  unchangedInput.textContent = input.substring(inputRenderIndex, input.length);
  editBox.append(unchangedInput);
}

מדיניות הרשאות, מסגרות iframe ו-Web Workers

כברירת מחדל, ממשק ה-API של הכלי להגהה זמין רק לחלונות ברמה העליונה ולמסגרות iframe מאותו מקור. אפשר להעניק גישה ל-API ל-iframe ממקורות שונים באמצעות המאפיין allow="" של Permission Policy:

<!--
  The hosting site at https://main.example.com can grant a cross-origin iframe
  at https://cross-origin.example.com/ access to the Proofreader API by
  setting the `allow="proofreader"` attribute.
-->
<iframe src="https://cross-origin.example.com/" allow="proofreader"></iframe>

ממשק ה-API של Proofreader לא זמין ב-Web Workers. הסיבה לכך היא המורכבות של יצירת מסמך אחראי לכל עובד, כדי לבדוק את הסטטוס של מדיניות ההרשאות.

הדגמה (דמו)

אפשר להתנסות בProofreader API playground.

השתתפות ושיתוף משוב

ה-API של הכלי להגהה נמצא כרגע בתהליכי דיון, ויכול להיות שהוא ישתנה בעתיד. אם תנסו את ה-API הזה ויהיה לכם משוב, נשמח לשמוע אותו.

• לקרוא את ההסבר, לשאול שאלות ולהשתתף בדיון.
• בדיקת ההטמעה ב-Chrome בסטטוס של Chrome
• קוראים את עמדת Mozilla בנושא תקנים ואת עמדת WebKit בנושא תקנים.
• הצטרפות לתוכנית הגישה המוקדמת כדי לקבל הצצה מוקדמת לממשקי API חדשים וגישה לרשימת התפוצה שלנו.
• אם יש לכם משוב על ההטמעה של Chrome, אתם יכולים לדווח על באג ב-Chromium.

ממשקי ה-API המובנים של AI משתמשים במודלים, כולל מודלים גדולים של שפה, בדפדפן.