ניהול סקירה קולית של מחברת (API)

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

ההבדל בין סקירה קולית לפודקאסט

סקירה קולית שונה מפודקאסט בדרכים הבאות:

  • סקירה קולית חייבת להיות משויכת ל-Notebook עם מקורות נתונים שנוספו אליו. מצד שני, אפשר ליצור פודקאסט בלי Notebook ב-Gemini Notebook Enterprise, בלי רישיון ל-Gemini Enterprise ובלי מאגר נתונים. כדי ליצור פודקאסט, צריך רק פרויקט Google Cloudפעיל ואת התפקיד "משתמש ב-Podcast API".
  • כדי ליצור סקירה קולית, צריך להפעיל את השיטה notebooks.audioOverview. כדי ליצור פודקאסט, צריך להפעיל את ה-method‏ podcasts – API נפרד.

שימוש בנקודת הקצה עם מספר אזורים בארה"ב

אם המינוי שלכם ל-Gemini Notebook Enterprise נמצא במספר אזורים בארה"ב, אתם יכולים לשלוח את הבקשות שבדף הזה לנקודת הקצה discoveryengine.us.rep.googleapis.com. נקודת קצה עם מספר אזורים מעבדת את הבקשות ומסיימת את פרוטוקול TLS בתוך מספר האזורים, כך שנתוני הבקשות נשארים בארה"ב בזמן ההעברה. השימוש בנקודת הקצה הזו לא משנה את המיקום שבו ה-notebooks מאוחסנים. מידע נוסף זמין בקטע סקירה כללית על נקודות קצה אזוריות ורב-אזוריות ל-API במדריך האבטחה של Google Cloud.

כדי להשתמש בנקודת הקצה עם מספר אזורים בארה"ב, צריך לבצע את השינויים הבאים בכל כתובת URL של בקשה בדף הזה:

  1. מחליפים את המארח ENDPOINT_LOCATION-discoveryengine.googleapis.com ב-discoveryengine.us.rep.googleapis.com.

  2. מגדירים את LOCATION להיות us.

שאר חלקי הבקשה נשארים ללא שינוי. במאמר הרשמה למינוי מוסבר איך בוחרים את המיקום של המינוי במספר אזורים. לרשימה של נקודות קצה אזוריות ונקודות קצה במספר אזורים, קראו את המאמר נקודות קצה אזוריות ונקודות קצה במספר אזורים במדריך של ענן וירטואלי פרטי (VPC).

יצירת סקירה קולית

כדי ליצור סקירה קולית של התוכן ב-Notebook, מפעילים את ה-method‏ notebooks.audioOverviews.create. בכל תיקיית Notebook יכולה להיות רק סקירה קולית אחת, אז השיטה הזו תעבוד רק אם אין בתיקייה סקירה קולית קיימת.

REST

curl -X POST \
  -H "Authorization:Bearer $(gcloud auth print-access-token)" \
  "https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1alpha/projects/PROJECT_NUMBER/locations/LOCATION/notebooks/NOTEBOOK_ID/audioOverviews" \
  -d '{
  "sourceIds": [
    {
      "id": "SOURCE_ID"
    }
  ],
  "episodeFocus": "EPISODE_FOCUS",
  "languageCode": "LANGUAGE_CODE"
  }

מחליפים את מה שכתוב בשדות הבאים:

  • ‫ENDPOINT_LOCATION: האזור המרובה לבקשת ה-API. מציינים אחד מהערכים הבאים:
    • ‫us לאזור הגיאוגרפי שכולל מספר אזורים בארה"ב
    • ‫eu למספר אזורים באיחוד האירופי
    • ‫global למיקום הגלובלי
    מידע נוסף זמין במאמר הגדרת מספר אזורים למאגר הנתונים.
  • ‫PROJECT_NUMBER: מספר הפרויקט ב- Google Cloud .
  • ‫LOCATION: המיקום הגיאוגרפי של מאגר הנתונים, למשל global. מידע נוסף מופיע בקטע מיקומים.
  • ‫NOTEBOOK_ID: המזהה הייחודי של ה-notebook.
  • ‫SOURCE_ID: המזהה של המקור שעל בסיסו רוצים ליצור את הסקירה הקולית. הפרמטר sourceIdsfield הוא מערך אופציונלי. אם לא מציינים מזהי מקורות, המערכת משתמשת בכל המקורות ב-Notebook. מידע נוסף על מזהה המקור זמין במאמר הוספה וניהול של מקורות נתונים ב-Notebook ‏ (API).
  • ‫EPISODE_FOCUS: מחרוזת שמתארת אילו נושאים או תכנים צריכים להיות מודגשים בסקירה הקולית.
  • ‫LANGUAGE_CODE: קוד השפה שבה התבקשה הסקירה הקולית.

אם הבקשה תצליח, תקבלו תגובת JSON שדומה לזו: התשובה הזו מראה שתהליך היצירה של הסקירה הקולית מתבצע.

  {
    "audioOverview": {
      "status": "AUDIO_OVERVIEW_STATUS_IN_PROGRESS",
      "audioOverviewId": "AUDIO_OVERVIEW_ID",
      "generationOptions": {},
      "name": "AUDIO_OVERVIEW_NAME"
    }
  }

יצירת סקירה קולית נמשכת כמה דקות.

איך מאמתים סקירה קולית שנוצרה

כדי לבדוק את הסקירה הקולית שנוצרה:

  1. פותחים את ה-Notebook. למידע נוסף, קראו את המאמר גישה ל-Notebook שנוצר.

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

    ב-Studio אתם יכולים לנהל את הסקירה הקולית, למשל לשנות את מהירות ההפעלה ולהוריד או למחוק את קובץ הסקירה הקולית.

מחיקת סקירה קולית

כדי למחוק סקירה קולית קיימת, צריך להפעיל את ה-method‏ notebooks.audioOverviews.delete.

REST

curl -X DELETE \
  -H "Authorization:Bearer $(gcloud auth print-access-token)" \
  "https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1alpha/projects/PROJECT_NUMBER/locations/LOCATION/notebooks/NOTEBOOK_ID/audioOverviews/default" \

מחליפים את מה שכתוב בשדות הבאים:

  • ‫ENDPOINT_LOCATION: האזור המרובה לבקשת ה-API. מציינים אחד מהערכים הבאים:
    • ‫us לאזור הגיאוגרפי שכולל מספר אזורים בארה"ב
    • ‫eu למספר אזורים באיחוד האירופי
    • ‫global למיקום הגלובלי
    מידע נוסף זמין במאמר הגדרת מספר אזורים למאגר הנתונים.
  • ‫PROJECT_NUMBER: מספר הפרויקט ב- Google Cloud .
  • ‫LOCATION: המיקום הגיאוגרפי של מאגר הנתונים, למשל global. מידע נוסף מופיע בקטע מיקומים.
  • ‫NOTEBOOK_ID: המזהה הייחודי של ה-notebook.

אם הבקשה תצליח, תקבלו קובץ JSON ריק.