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

כל ממשקי ה-AI API המובנים זמינים ב-localhost ב-Chrome. מגדירים את הדגלים הבאים לערך Enabled:

• chrome://flags/#optimization-guide-on-device-model
• chrome://flags/#prompt-api-for-gemini-nano-multimodal-input
• chrome://flags/#proofreader-api-for-gemini-nano

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

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

כדי להתחיל להשתמש ב-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.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 של הכלי להגהה זמין רק לחלונות ברמה העליונה ול-iframes שלהם מאותו מקור. אפשר להעניק גישה ל-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 של הכלי להגהה לא זמין ב-Web Workers. הסיבה לכך היא המורכבות של יצירת מסמך אחראי לכל עובד, כדי לבדוק את הסטטוס של מדיניות ההרשאות.

הדגמה (דמו)

אפשר להתנסות בסביבת הניסויים של Proofreader API ולעיין בקוד המקור.

אינטראקציה ושיתוף משוב

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

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

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