העלאת תוכן ל-Assistant

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

כדי להעלות תוכן לעוזר הדיגיטלי באמצעות ה-API, מריצים את פקודת ה-curl הבאה:

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -H "X-Goog-User-Project: PROJECT_ID" \
"https://discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/sessions/SESSION_ID:addContextFile" \
-d '{
      "name": "projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/sessions/SESSION_ID",
      "fileName": "FILE_NAME",
      "mimeType": "MIME_TYPE",
      "fileContents": "BASE64_ENCODED_FILE",
    }'

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

• ‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud .
• ‫APP_ID: מזהה האפליקציה.
• ‫SESSION_ID: מזהה הסשן. אפשר לקבל את המזהה הזה מהתשובה שמתקבלת כשיוצרים סשן, כמו שמוסבר במאמר שמירת פרטי סשן וקבלת תשובות.
• ‫FILE_NAME: שם הקובץ.
• ‫MIME_TYPE: סוג ה-MIME של הקובץ.
• ‫BASE64_ENCODED_FILE: ייצוג base64 (מחרוזת ASCII) של הנתונים. המחרוזת הזו צריכה להיראות בערך כך: /9j/4QAYRXhpZgAA...9tAVx/zDQDlGxn//2Q==

דוגמה לפקודה ולתגובה:

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -H "X-Goog-User-Project: 1234" \
"https://discoveryengine.googleapis.com/v1alpha/projects/1234/locations/global/collections/default_collection/engines/myapp/sessions/16002628354770206943:addContextFile" \
-d '{
      "name": "projects/1234/locations/global/collections/default_collection/engines/myapp/sessions/16002628354770206943",
      "fileName": "Hello World.pdf",
      "mimeType": "application/pdf",
      "fileContents": JVBERi0xLjQKJdPr6eEKMSAwIG9iago8PC9UaXRsZSAoSGVsbG8gd29ybGQpCi9Qcm9kdWNlciAoU2tpYS9QREYgbTEzMCBHb29nbGUgRG9jcyBSZW5kZXJlcik+PgplbmRvYmoKMyAwIG9iago8PC..............KMDAwMDAxNDk0NCAwMDAwMCBuIAp0cmFpbGVyCjw8L1NpemUgMTIKL1Jvb3QgNyAwIFIKL0luZm8gMSAwIFI+PgpzdGFydHhyZWYKMTU0NjYKJSVFT0YK",
    }'
------------------
{
  "session": "projects/1234/locations/global/collections/default_collection/engines/myapp/sessions/16002628354770206943",
  "fileId": "11157546467692423460",
  "tokenCount": "258"
}