SendMessageConfiguration

Configurazione di una richiesta di invio di messaggi.

Rappresentazione JSON
{
  "acceptedOutputModes": [
    string
  ],
  "taskPushNotificationConfig": {
    object (TaskPushNotificationConfig)
  },
  "returnImmediately": boolean,
  "historyLength": integer
}
Campi
acceptedOutputModes[]

string

Un elenco di tipi di contenuti multimediali che il client è pronto ad accettare per le parti di risposta. Gli agenti DEVONO utilizzare questo parametro per personalizzare l'output.

taskPushNotificationConfig

object (TaskPushNotificationConfig)

Configurazione per l'agente per l'invio di notifiche push per gli aggiornamenti delle attività. L'ID attività deve essere vuoto quando invii questa configurazione in una richiesta message.send.

returnImmediately

boolean

Se true, l'operazione restituisce immediatamente dopo la creazione dell'attività, anche se l'elaborazione è ancora in corso. Se false (impostazione predefinita), l'operazione DEVE attendere che l'attività raggiunga uno stato terminale (COMPLETED, FAILED, CANCELED, REJECTED) o interrotto (INPUT_REQUIRED, AUTH_REQUIRED) prima di restituire.

historyLength

integer

Il numero massimo di messaggi più recenti della cronologia dell'attività da recuperare nella risposta. Un valore non impostato indica che il client non impone alcun limite. Un valore pari a zero è una richiesta di non includere alcun messaggio. Il server NON DEVE restituire più messaggi del valore fornito, ma PUÒ applicare un limite inferiore.

TaskPushNotificationConfig

Un container che associa una configurazione di notifica push a un'attività specifica.

Rappresentazione JSON
{
  "tenant": string,
  "id": string,
  "taskId": string,
  "url": string,
  "token": string,
  "authentication": {
    object (AuthenticationInfo)
  }
}
Campi
tenant

string

Facoltativo. Identificatore di routing opaco. Deve corrispondere al valore tenant di AgentInterface selezionato nella scheda dell'agente quando questo campo è impostato.

id

string

I dettagli della configurazione delle notifiche push. Un identificatore univoco (ad es. UUID) per questa configurazione di notifiche push.

taskId

string

L'ID dell'attività a cui è associata questa configurazione.

url

string

Obbligatorio. L'URL a cui deve essere inviata la notifica.

token

string

Un token univoco per questa attività o sessione.

authentication

object (AuthenticationInfo)

Informazioni di autenticazione necessarie per inviare la notifica.

AuthenticationInfo

Definisce i dettagli di autenticazione utilizzati per le notifiche push.

Rappresentazione JSON
{
  "scheme": string,
  "credentials": string
}
Campi
scheme

string

Obbligatorio. Schema di autenticazione HTTP dal registro IANA. Esempi: Bearer, Basic, Digest. I nomi degli schemi non fanno distinzione tra maiuscole e minuscole in base alla sezione 11.1 della RFC 9110.

credentials

string

Credenziali delle notifiche push. Il formato dipende dallo schema (ad es. token per Bearer).