SendMessageConfiguration

Es la configuración de una solicitud de mensaje.

Representación JSON
{
  "acceptedOutputModes": [
    string
  ],
  "taskPushNotificationConfig": {
    object (TaskPushNotificationConfig)
  },
  "returnImmediately": boolean,
  "historyLength": integer
}
Campos
acceptedOutputModes[]

string

Es una lista de los tipos de medios que el cliente está preparado para aceptar en las partes de la respuesta. Los agentes DEBEN usar esta información para adaptar su respuesta.

taskPushNotificationConfig

object (TaskPushNotificationConfig)

Es la configuración para que el agente envíe notificaciones push sobre las actualizaciones de tareas. El ID de tarea debe estar vacío cuando se envía esta configuración en una solicitud message.send.

returnImmediately

boolean

Si es true, la operación se muestra inmediatamente después de crear la tarea, incluso si el procesamiento aún está en curso. Si es false (valor predeterminado), la operación DEBE esperar hasta que la tarea alcance un estado terminal (COMPLETED, FAILED, CANCELED, REJECTED) o interrumpido (INPUT_REQUIRED, AUTH_REQUIRED) antes de mostrar un valor de devolución.

historyLength

integer

Es la cantidad máxima de mensajes más recientes del historial de la tarea que se recuperarán en la respuesta. Un valor sin configurar significa que el cliente no impone ningún límite. Un valor de cero es una solicitud para no incluir ningún mensaje. El servidor NO DEBE devolver más mensajes que el valor proporcionado, pero PUEDE aplicar un límite inferior.

TaskPushNotificationConfig

Es un contenedor que asocia una configuración de notificación push con una tarea específica.

Representación JSON
{
  "tenant": string,
  "id": string,
  "taskId": string,
  "url": string,
  "token": string,
  "authentication": {
    object (AuthenticationInfo)
  }
}
Campos
tenant

string

Es opcional. Es un identificador de enrutamiento opaco. Debe coincidir con el valor de tenant del AgentInterface seleccionado en la tarjeta del agente cuando se establece ese campo.

id

string

Son los detalles de configuración de la notificación push. Es un identificador único (p.ej., UUID) para esta configuración de notificaciones push.

taskId

string

Es el ID de la tarea con la que se asocia esta configuración.

url

string

Obligatorio. Es la URL a la que se debe enviar la notificación.

token

string

Es un token único para esta tarea o sesión.

authentication

object (AuthenticationInfo)

Es la información de autenticación necesaria para enviar la notificación.

AuthenticationInfo

Define los detalles de autenticación que se usan para las notificaciones push.

Representación JSON
{
  "scheme": string,
  "credentials": string
}
Campos
scheme

string

Obligatorio. Es el esquema de autenticación HTTP del registro de IANA. Ejemplos: Bearer, Basic, Digest. Los nombres de Scheme no distinguen mayúsculas de minúsculas según la sección 11.1 del RFC 9110.

credentials

string

Son las credenciales de la notificación push. El formato depende del esquema (p.ej., token para Bearer).