REST Resource: projects.locations.conversations

משאב: שיחה

הודעה בשיחה.

ייצוג ב-JSON 
{
  "name": string,
  "agents": [
    string
  ],
  "createTime": string,
  "lastUsedTime": string,
  "labels": {
    string: string,
    ...
  },
  "kmsKey": string,
  "memoryPaused": boolean
}
שדות
name

string

זה שינוי אופציונלי. מזהה. שם המשאב הייחודי של שיחה. פורמט: projects/{project}/locations/{location}/conversations/{conversationId} {conversationId} הוא מזהה המשאב, צריך להיות באורך של 63 תווים לכל היותר ולהתאים לפורמט שמתואר בכתובת https://google.aip.dev/122#resource-id-segments

דוגמה: projects/1234567890/locations/global/conversations/my-conversation

מומלץ לדלג על הגדרת השדה הזה במהלך יצירת השיחה, כי הוא יוסק באופן אוטומטי ויוחלף בערך {parent}/conversations/{conversationId}.
agents[]

string

חובה. הנציגים בשיחה. בשלב הזה יש תמיכה רק בסוכן אחד. השדה הזה חוזר על עצמו כדי לאפשר תמיכה עתידית בכמה נציגים בשיחה. פורמט: projects/{project}/locations/{location}/dataAgents/{agent}
createTime

string (Timestamp format)

פלט בלבד. חותמת הזמן של היצירה.

הפלט שנוצר תמיד יהיה בפורמט RFC 3339, עם נורמליזציה של Z ושימוש ב-0, 3, 6 או 9 ספרות אחרי הנקודה. אפשר להשתמש גם בהיסטים אחרים, לא רק ב-Z. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
lastUsedTime

string (Timestamp format)

פלט בלבד. חותמת הזמן של השיחה האחרונה שהייתה בשימוש.

הפלט שנוצר תמיד יהיה בפורמט RFC 3339, עם נורמליזציה של Z ושימוש ב-0, 3, 6 או 9 ספרות אחרי הנקודה. אפשר להשתמש גם בהיסטים אחרים, לא רק ב-Z. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
labels

map (key: string, value: string)

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

אובייקט שמכיל רשימה של "key": value זוגות. דוגמה: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
kmsKey

string

זה שינוי אופציונלי. מפתח הצפנה בניהול הלקוח (CMEK) שבו יש להשתמש להצפנת משאבי השיחה. ההצפנה תתבצע בשכבת Titan, ואנחנו נעביר את מפתח ה-KMS ל-Titan.

פורמט: projects/{projectId}/locations/{location}/keyRings/{key_ring_name}/cryptoKeys/{key_name}.
memoryPaused

boolean

זה שינוי אופציונלי. האם הזיכרון מושהה בשיחה הזו.

Methods

create

 יוצר שיחה חדשה כדי לשמור את היסטוריית השיחה.

delete

 מחיקת שיחה.

get

 מקבל פרטים של שיחה אחת באמצעות מזהה השיחה והפריט הראשי.

list

 רשימה של כל השיחות של הורה מסוים.