SendMessageConfiguration

הגדרת בקשה לשליחת הודעה.

ייצוג ב-JSON
{
  "acceptedOutputModes": [
    string
  ],
  "taskPushNotificationConfig": {
    object (TaskPushNotificationConfig)
  },
  "returnImmediately": boolean,
  "historyLength": integer
}
שדות
acceptedOutputModes[]

string

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

taskPushNotificationConfig

object (TaskPushNotificationConfig)

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

returnImmediately

boolean

אם true, הפעולה חוזרת מיד אחרי יצירת המשימה, גם אם העיבוד עדיין מתבצע. אם הערך הוא false (ברירת מחדל), הפעולה חייבת להמתין עד שהמשימה תגיע למצב סופי (COMPLETED, FAILED, CANCELED, REJECTED) או למצב של הפרעה (INPUT_REQUIRED, AUTH_REQUIRED) לפני שהיא תחזור.

historyLength

integer

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

TaskPushNotificationConfig

מאגר שמשייך הגדרת התראה בדחיפה למשימה ספציפית.

ייצוג ב-JSON
{
  "tenant": string,
  "id": string,
  "taskId": string,
  "url": string,
  "token": string,
  "authentication": {
    object (AuthenticationInfo)
  }
}
שדות
tenant

string

זה שינוי אופציונלי. מזהה ניתוב אטום. הערך חייב להיות זהה לערך tenant מהכרטיס AgentInterface שנבחר, אם השדה הזה מוגדר.

id

string

פרטי ההגדרה של ההתראה. מזהה ייחודי (למשל UUID) של הגדרת ההתראה בדחיפה הזו.

taskId

string

המזהה של המשימה שההגדרה הזו משויכת אליה.

url

string

חובה. כתובת ה-URL שאליה צריך לשלוח את ההתראה.

token

string

טוקן ייחודי למשימה או לסשן הזה.

authentication

object (AuthenticationInfo)

נדרשים פרטי אימות כדי לשלוח את ההתראה.

AuthenticationInfo

הגדרת פרטי אימות, שמשמשים להתראות פוש.

ייצוג ב-JSON
{
  "scheme": string,
  "credentials": string
}
שדות
scheme

string

חובה. סכמת אימות HTTP ממאגר IANA. דוגמאות: Bearer, Basic, Digest. שמות הסכימות לא תלויי-רישיות לפי RFC 9110 סעיף 11.1.

credentials

string

פרטי הכניסה של ההתראות. הפורמט תלוי בסכימה (למשל, טוקן ל-Bearer).