Method: projects.locations.apps.runAssistant

Ejecuta el agente de asistencia para la sesión de asistencia especificada.

Solicitud HTTP

POST https://ces.googleapis.com/v1beta/{app=projects/*/locations/*/apps/*}:runAssistant

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta

Parámetros
app

string

Obligatorio. La app para la que se ejecutará el asistente. Formato: projects/{project}/locations/{location}/apps/{app}

Cuerpo de la solicitud

El cuerpo de la solicitud contiene datos con la siguiente estructura:

Representación JSON 
{
  "assistantSession": string,
  "message": {
    object (AssistantMessage)
  },
  "interactionType": enum (RunAssistantRequest.InteractionType)
}
Campos
assistantSession

string

Obligatorio. Es la sesión del asistente que se usará para ejecutarlo. Formato: projects/{project}/locations/{location}/apps/{app}/assistantSessions/{assistantSession}
message

object (AssistantMessage)

Obligatorio. Es el mensaje que se enviará al agente de asistencia.
interactionType

enum (RunAssistantRequest.InteractionType)

Es opcional. Son los diferentes tipos de interacción para el mensaje del asistente.

Cuerpo de la respuesta

Mensaje de respuesta para AssistantService.RunAssistant.

Si se ejecuta correctamente, el cuerpo de la respuesta contiene datos con la siguiente estructura:

Representación JSON 
{
  "output": {
    object (AssistantOutput)
  },
  "state": enum (AssistantSessionState)
}
Campos
output

object (AssistantOutput)

Obligatorio. El resultado del agente asistente.
state

enum (AssistantSessionState)

Solo salida. Es el estado de la sesión de asistente.

Permisos de autorización

Se necesita uno de los siguientes permisos de OAuth:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/ces

Para obtener más información, consulta Authentication Overview.

Permisos de IAM

Se requiere el siguiente permiso de IAM en el recurso app:

  • ces.apps.update

Para obtener más información, consulta la documentación de IAM.

RunAssistantRequest.InteractionType

Es el tipo de interacción del mensaje enviado al asistente.

Enums
INTERACTION_TYPE_UNSPECIFIED Es el valor predeterminado. Este valor se usa si no se especifica el tipo.
NEW_MESSAGE El mensaje es una entrada del usuario. La entrada del usuario se proporciona en la lista de fragmentos.
POLL El mensaje es para sondear el estado de la sesión del asistente.
DISMISS El mensaje es para descartar la sesión de asistencia pendiente de revisión. Esto cambiará el estado de la sesión del asistente a inactivo.

AssistantOutput

El resultado del agente asistente.

Representación JSON 
{
  "message": {
    object (AssistantMessage)
  },
  "userResponseSuggestions": {
    object (UserResponseSuggestions)
  }
}
Campos
message

object (AssistantMessage)

Obligatorio. La respuesta del agente asistente.
userResponseSuggestions

object (UserResponseSuggestions)

Solo salida. Son las respuestas sugeridas del usuario del agente de asistencia.