אחרי שיוצרים תיקיית Notebook, אפשר להוסיף לה סוגי תוכן שונים כמקורות נתונים. אפשר לעשות את זה בקבוצות או בקבצים בודדים. חלק מהמקורות כוללים מסמכי Google Docs, מצגות ב-Google Slides, טקסט גולמי, תוכן מהאינטרנט וסרטונים ב-YouTube.
בדף הזה מוסבר איך לבצע את הפעולות הבאות:
לפני שמתחילים
אם אתם מתכננים להוסיף את Google Docs או Google Slides כמקור נתונים, אתם צריכים לאשר את הגישה ל-Google Drive באמצעות פרטי הכניסה של המשתמש ב-Google. כדי לעשות את זה, מריצים את הפקודה הבאה של gcloud auth login ופועלים לפי ההוראות ב-CLI.
gcloud auth login --enable-gdrive-access
שימוש בנקודת קצה עם מספר אזורים בארה"ב
אם המינוי שלכם ל-Gemini Notebook Enterprise נמצא במספר אזורים בארה"ב, אתם יכולים לשלוח את הבקשות שבדף הזה לנקודת הקצה discoveryengine.us.rep.googleapis.com. נקודת קצה עם מספר אזורים מעבדת את הבקשות ומסיימת את פרוטוקול TLS בתוך מספר האזורים, כך שנתוני הבקשות נשארים בארה"ב בזמן ההעברה. השימוש בנקודת הקצה הזו לא משנה את המיקום שבו ה-notebooks מאוחסנים. מידע נוסף זמין בקטע סקירה כללית על נקודות קצה אזוריות ורב-אזוריות ל-API במדריך האבטחה של Google Cloud.
כדי להשתמש בנקודת הקצה עם מספר אזורים בארה"ב, צריך לבצע את השינויים הבאים בכל כתובת URL של בקשה בדף הזה:
מחליפים את המארח
ENDPOINT_LOCATION-discoveryengine.googleapis.comב-discoveryengine.us.rep.googleapis.com.מגדירים את
LOCATIONלהיותus.
שאר חלקי הבקשה נשארים ללא שינוי. במאמר הרשמה למינוי מוסבר איך בוחרים את המיקום של המינוי במספר אזורים. לרשימה של נקודות קצה אזוריות ונקודות קצה במספר אזורים, קראו את המאמר נקודות קצה אזוריות ונקודות קצה במספר אזורים במדריך של ענן וירטואלי פרטי (VPC).
הוספה של מקורות נתונים באצווה
כדי להוסיף מקורות לתיקיית Notebook, צריך להפעיל את ה-method notebooks.sources.batchCreate.
REST
curl -X POST \
-H "Authorization:Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
"https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1alpha/projects/PROJECT_NUMBER/locations/LOCATION/notebooks/NOTEBOOK_ID/sources:batchCreate" \
-d '{
"userContents": [
{
USER_CONTENT
}
]
}'
מחליפים את מה שכתוב בשדות הבאים:
-
ENDPOINT_LOCATION: האזור המרובה לבקשת ה-API. מציינים אחד מהערכים הבאים:-
usלאזור הגיאוגרפי שכולל מספר אזורים בארה"ב -
euלמספר אזורים באיחוד האירופי -
globalלמיקום הגלובלי
-
-
PROJECT_NUMBER: מספר הפרויקט ב- Google Cloud . -
LOCATION: המיקום הגיאוגרפי של מאגר הנתונים, למשלglobal. מידע נוסף מופיע בקטע מיקומים. -
NOTEBOOK_ID: המזהה הייחודי של ה-notebook. -
USER_CONTENT: התוכן של מקור הנתונים.
אתם יכולים להוסיף רק אחד ממקורות הנתונים הבאים כתוכן שלכם:
כדי להוסיף תוכן מ-Google Drive שמורכב ממסמכי Google Docs או ממצגות Google Slides, מוסיפים:
"googleDriveContent": { "documentId": "DOCUMENT_ID_GOOGLE", "mimeType": "MIME_TYPE", "sourceName": "DISPLAY_NAME_GOOGLE" }מחליפים את מה שכתוב בשדות הבאים:
-
DOCUMENT_ID_GOOGLE: המזהה של הקובץ ב-Google Drive. המזהה הזה מופיע בכתובת ה-URL של הקובץ. כדי לקבל את מזהה המסמך של קובץ, פותחים את הקובץ. תבנית כתובת ה-URL שלו היא:https://docs.google.com/FILE_TYPE/d/DOCUMENT_ID_GOOGLE/edit?resourcekey=RESOURCE_KEY. -
MIME_TYPE: סוג ה-MIME של המסמך שנבחר. משתמשים ב-application/vnd.google-apps.documentב-Google Docs או ב-application/vnd.google-apps.presentationב-Google Slides. -
DISPLAY_NAME_GOOGLE: השם המוצג של מקור הנתונים.
-
כדי להזין טקסט גולמי, מוסיפים:
"textContent": { "sourceName": "DISPLAY_NAME_TEXT", "content": "TEXT_CONTENT" }מחליפים את מה שכתוב בשדות הבאים:
-
DISPLAY_NAME_TEXT: השם המוצג של מקור הנתונים. -
TEXT_CONTENT: תוכן הטקסט הגולמי שרוצים להעלות כמקור נתונים.
-
לתוכן מהאינטרנט, מוסיפים:
"webContent": { "url": "URL_WEBCONTENT", "sourceName": "DISPLAY_NAME_WEB" }מחליפים את מה שכתוב בשדות הבאים:
-
URL_WEBCONTENT: כתובת ה-URL של התוכן שרוצים להעלות כמקור נתונים. -
DISPLAY_NAME_WEB: השם המוצג של מקור הנתונים.
-
בקטעי וידאו, צריך להוסיף:
"videoContent": { "youtubeUrl": "URL_YOUTUBE" }מחליפים את
URL_YOUTUBEבכתובת ה-URL של הסרטון ב-YouTube שרוצים להעלות כמקור נתונים.
אם הבקשה תצליח, תקבלו מופע של האובייקט source כתגובה, בדומה ל-JSON הבא. שימו לב לערכים של SOURCE_ID ו-SOURCE_RESOURCE_NAME, שנדרשים כדי לבצע משימות אחרות, כמו אחזור או מחיקה של מקור הנתונים.
{
"sources": [
{
"sourceId": {
"id": "SOURCE_ID"
},
"title": "DISPLAY_NAME",
"metadata": {
"xyz": "abc"
},
"settings": {
"status": "SOURCE_STATUS_COMPLETE"
},
"name": "SOURCE_RESOURCE_NAME"
}
]
}
העלאת קובץ כמקור
בנוסף להוספת מקורות נתונים בכמות גדולה, אתם יכולים להעלות קבצים בודדים שישמשו כמקורות נתונים ב-Notebook.
כדי להעלות קובץ אחד, מפעילים את השיטה notebooks.sources.uploadFile.
REST
curl -X POST --data-binary "@PATH/TO/FILE" \
-H "Authorization:Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-Upload-File-Name: FILE_DISPLAY_NAME" \
-H "X-Goog-Upload-Protocol: raw" \
-H "Content-Type: CONTENT_TYPE" \
"https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/upload/v1alpha/projects/PROJECT_NUMBER/locations/LOCATION/notebooks/NOTEBOOK_ID/sources:uploadFile" \
מחליפים את מה שכתוב בשדות הבאים:
-
PATH/TO/FILE: הנתיב לקובץ שרוצים להעלות. -
FILE_DISPLAY_NAME: מחרוזת שמציינת את השם המוצג של הקובץ ב-Notebook. -
CONTENT_TYPE: סוג התוכן שרוצים להעלות. כאן אפשר למצוא רשימה של סוגי התוכן הנתמכים. -
ENDPOINT_LOCATION: האזור המרובה לבקשת ה-API. מציינים אחד מהערכים הבאים:-
usלאזור הגיאוגרפי שכולל מספר אזורים בארה"ב -
euלמספר אזורים באיחוד האירופי -
globalלמיקום הגלובלי
-
-
PROJECT_NUMBER: מספר הפרויקט ב- Google Cloud . -
LOCATION: המיקום הגיאוגרפי של מאגר הנתונים, למשלglobal. מידע נוסף מופיע בקטע מיקומים. -
NOTEBOOK_ID: המזהה הייחודי של ה-notebook.
אם הבקשה תצליח, תקבלו תגובת JSON שדומה לזו:
{
"sourceId": {
"id": "SOURCE_ID"
}
}
סוגי התוכן הנתמכים
הקובץ שאתם מעלים כמקור חייב להיות בפורמט נתמך.
אלה סוגי התוכן של המסמכים שנתמכים:
| סיומת הקובץ | סוג תוכן |
|---|---|
application/pdf |
|
| .txt | text/plain |
| .md | text/markdown |
| .docx | application/vnd.openxmlformats-officedocument.wordprocessingml.document |
| .pptx | application/vnd.openxmlformats-officedocument.presentationml.presentation |
| .xlsx | application/vnd.openxmlformats-officedocument.spreadsheetml.sheet |
אלה סוגי תוכן האודיו שנתמכים:
| סיומת הקובץ | סוג תוכן |
|---|---|
| .3g2 | audio/3gpp2 |
| .3gp | audio/3gpp |
| .aac | audio/aac |
| .aif | audio/aiff |
| .aifc | audio/aiff |
| .aiff | audio/aiff |
| .amr | audio/amr |
| .au | audio/basic |
| .avi | video/x-msvideo |
| .cda | application/x-cdf |
| .m4a | audio/m4a |
| .mid | audio/midi |
| .midi | audio/midi |
| .mp3 | audio/mpeg |
| .mp4 | video/mp4 |
| .mpeg | audio/mpeg |
| .ogg | audio/ogg |
| .opus | audio/ogg |
| .ra | audio/vnd.rn-realaudio |
| .ram | audio/vnd.rn-realaudio |
| .snd | audio/basic |
| .wav | audio/wav |
| .weba | audio/webm |
| .wma | audio/x-ms-wma |
אלה סוגי התוכן של התמונות שנתמכים:
| סיומת הקובץ | סוג תוכן |
|---|---|
| .png | image/png |
| .jpg | image/jpg |
| .jpeg | image/jpeg |
אחזור מקור
כדי לאחזר מקור ספציפי שנוסף ל-Notebook, משתמשים ב-method notebooks.sources.get.
REST
curl -X GET \
-H "Authorization:Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
"https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1alpha/projects/PROJECT_NUMBER/locations/LOCATION/notebooks/NOTEBOOK_ID/sources/SOURCE_ID"
מחליפים את מה שכתוב בשדות הבאים:
-
ENDPOINT_LOCATION: האזור המרובה לבקשת ה-API. מציינים אחד מהערכים הבאים:-
usלאזור הגיאוגרפי שכולל מספר אזורים בארה"ב -
euלמספר אזורים באיחוד האירופי -
globalלמיקום הגלובלי
-
-
PROJECT_NUMBER: מספר הפרויקט ב- Google Cloud . -
LOCATION: המיקום הגיאוגרפי של מאגר הנתונים, למשלglobal. מידע נוסף מופיע בקטע מיקומים. -
NOTEBOOK_ID: המזהה הייחודי שקיבלתם כשיצרתם את ה-notebook. מידע נוסף זמין במאמר יצירת Notebook. -
SOURCE_ID: המזהה של המקור שקיבלתם כשהוספתם את המקור ל-Notebook.
אם הבקשה תצליח, אמורה להתקבל תגובת JSON שדומה לזו:
{
"sources": [
{
"sourceId": {
"id": "SOURCE_ID"
},
"title": "DISPLAY_NAME",
"metadata": {
"wordCount": 148,
"tokenCount": 160
},
"settings": {
"status": "SOURCE_STATUS_COMPLETE"
},
"name": "SOURCE_RESOURCE_NAME"
}
]
}
מחיקת מקורות נתונים מתיקיית Notebook
כדי למחוק כמה מקורות נתונים ב-Notebook, משתמשים ב-method notebooks.sources.batchDelete.
REST
curl -X POST \
-H "Authorization:Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
"https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1alpha/projects/PROJECT_NUMBER/locations/LOCATION/notebooks/NOTEBOOK_ID/sources:batchDelete" \
-d '{
"names": [
"SOURCE_RESOURCE_NAME_1",
"SOURCE_RESOURCE_NAME_2"
]
}'
מחליפים את מה שכתוב בשדות הבאים:
-
ENDPOINT_LOCATION: האזור המרובה לבקשת ה-API. מציינים אחד מהערכים הבאים:-
usלאזור הגיאוגרפי שכולל מספר אזורים בארה"ב -
euלמספר אזורים באיחוד האירופי -
globalלמיקום הגלובלי
-
-
PROJECT_NUMBER: מספר הפרויקט ב- Google Cloud . -
LOCATION: המיקום הגיאוגרפי של מאגר הנתונים, למשלglobal. מידע נוסף מופיע בקטע מיקומים. -
NOTEBOOK_ID: המזהה הייחודי של ה-notebook. -
SOURCE_RESOURCE_NAME: שם המשאב המלא של מקור הנתונים שרוצים למחוק. התבנית של השדה הזה היא:projects/PROJECT_NUMBER/locations/LOCATION/notebooks/NOTEBOOK_ID/source/SOURCE_ID.
אם הבקשה תצליח, תקבלו אובייקט JSON ריק.
המאמרים הבאים
- ליצור סקירה קולית של ה-Notebook באופן פרוגרמטי.