SendMessageConfiguration

Konfiguration einer Nachrichtenanfrage.

JSON-Darstellung 
{
  "acceptedOutputModes": [
    string
  ],
  "taskPushNotificationConfig": {
    object (TaskPushNotificationConfig)
  },
  "returnImmediately": boolean,
  "historyLength": integer
}
Felder
acceptedOutputModes[]

string

Eine Liste der Medientypen, die der Client für Antwortteile akzeptieren kann. Agents SOLLTEN diese Informationen verwenden, um ihre Ausgabe anzupassen.
taskPushNotificationConfig

object (TaskPushNotificationConfig)

Konfiguration für den Agent, um Push-Benachrichtigungen für Aufgabenaktualisierungen zu senden. Die Aufgaben-ID sollte leer sein, wenn diese Konfiguration in einer message.send-Anfrage gesendet wird.
returnImmediately

boolean

Wenn true, wird der Vorgang sofort nach dem Erstellen der Aufgabe zurückgegeben, auch wenn die Verarbeitung noch läuft. Wenn false (Standard), MUSS der Vorgang warten, bis die Aufgabe einen Endstatus (COMPLETED, FAILED, CANCELED, REJECTED) oder einen unterbrochenen Status (INPUT_REQUIRED, AUTH_REQUIRED) erreicht hat, bevor er zurückgegeben wird.
historyLength

integer

Die maximale Anzahl der letzten Nachrichten aus dem Aufgabenverlauf, die in der Antwort abgerufen werden sollen. Ein nicht festgelegter Wert bedeutet, dass der Client kein Limit festlegt. Ein Wert von null bedeutet, dass keine Nachrichten einbezogen werden sollen. Der Server DARF nicht mehr Nachrichten als den angegebenen Wert zurückgeben, kann aber ein niedrigeres Limit festlegen.

TaskPushNotificationConfig

Ein Container, der eine Push-Benachrichtigungskonfiguration mit einer bestimmten Aufgabe verknüpft.

JSON-Darstellung 
{
  "tenant": string,
  "id": string,
  "taskId": string,
  "url": string,
  "token": string,
  "authentication": {
    object (AuthenticationInfo)
  }
}
Felder
tenant

string

Optional. Intransparente Routing-ID. Muss mit dem Wert tenant aus der ausgewählten AgentInterface auf der Agent-Karte übereinstimmen, wenn dieses Feld festgelegt ist.
id

string

Die Details der Push-Benachrichtigungskonfiguration. Eine eindeutige ID (z.B. UUID) für diese Push-Benachrichtigungskonfiguration.
taskId

string

Die ID der Aufgabe, mit der diese Konfiguration verknüpft ist.
url

string

Erforderlich. Die URL, an die die Benachrichtigung gesendet werden soll.
token

string

Ein Token, das für diese Aufgabe oder Sitzung eindeutig ist.
authentication

object (AuthenticationInfo)

Authentifizierungsinformationen, die zum Senden der Benachrichtigung erforderlich sind.

AuthenticationInfo

Definiert Authentifizierungsdetails, die für Push-Benachrichtigungen verwendet werden.

JSON-Darstellung 
{
  "scheme": string,
  "credentials": string
}
Felder
scheme

string

Erforderlich. HTTP-Authentifizierungsschema aus der IANA-Registrierung. Beispiele: Bearer, Basic, Digest. Schemanamen sind gemäß RFC 9110, Abschnitt 11.1, nicht case-sensitiv.
credentials

string

Anmeldedaten für Push-Benachrichtigungen. Das Format hängt vom Schema ab (z.B. Token für Bearer).