SessionInput

Entrada para a sessão.

Representação JSON
{
  "willContinue": boolean,
  "recordingControl": enum (SessionInput.RecordingControl),

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "text": string,
  "dtmf": string,
  "audio": string,
  "toolResponses": {
    object (ToolResponses)
  },
  "image": {
    object (Image)
  },
  "blob": {
    object (Blob)
  },
  "variables": {
    object
  },
  "event": {
    object (Event)
  }
  // End of mutually exclusive fields.
}
Campos
willContinue

boolean

Opcional. Uma flag para indicar se a mensagem atual é um fragmento de uma entrada maior na sessão de streaming bidirecional.

Quando definido como true, o agente adia o processamento até receber uma mensagem subsequente em que willContinue é false ou até que o sistema detecte um endpoint na entrada de áudio.

OBSERVAÇÃO: esse campo não se aplica a entradas de áudio e DTMF, porque elas são sempre processadas automaticamente com base no sinal de endpointing.

recordingControl

enum (SessionInput.RecordingControl)

Opcional. Se a conversa pode ser gravada e registrada a partir de agora.

Use essa opção quando o app, e não o agente, decidir o que pode ser mantido: por exemplo, quando o usuário final precisa consentir com a gravação antes que qualquer informação sobre a chamada seja armazenada.

O valor permanece em vigor até que o cliente envie um diferente. Portanto, ele só precisa ser enviado quando a resposta mudar. O que estiver em vigor quando uma rodada for concluída decide essa rodada, tanto se o áudio chega ao bucket de gravação quanto se a transcrição chega ao histórico de conversas, ao BigQuery e ao Cloud Logging. Ela abrange o lado do agente e do usuário final.

As curvas que terminam antes do cliente enviar isso pela primeira vez são registradas de acordo com as configurações de registro do app, como se o campo não existisse.

Se mais de uma entrada na mesma solicitação definir esse valor, a última vai prevalecer.

O tipo da entrada. Confira a seguir uma lista de campos mutuamente exclusivos. No máximo um dos campos será definido em uma resposta:
text

string

Opcional. Dados de texto do usuário final.

dtmf

string

Opcional. Dígitos DTMF do usuário final.

audio

string (bytes format)

Opcional. Dados de áudio do usuário final.

Uma string codificada em base64.

toolResponses

object (ToolResponses)

Opcional. Resultados da execução das chamadas de ferramenta do cliente.

image

object (Image)

Opcional. Dados de imagem do usuário final.

blob

object (Blob)

Opcional. Dados de blob do usuário final.

variables

object (Struct format)

Opcional. Variáveis contextuais para a sessão, identificadas por nome. Somente as variáveis declaradas no app serão usadas pelo agente do CES.

As variáveis não reconhecidas ainda serão enviadas ao [agente do Dialogflow][Agent.RemoteDialogflowAgent] como parâmetros de sessão adicionais.

event

object (Event)

Opcional. Entrada de evento.

Fim dos campos mutuamente exclusivos.

ToolResponses

Resultados da execução das chamadas de ferramenta solicitadas pelo cliente.

Representação JSON
{
  "toolResponses": [
    {
      object (ToolResponse)
    }
  ]
}
Campos
toolResponses[]

object (ToolResponse)

Opcional. A lista de resultados da execução da ferramenta.

Evento

Entrada de evento.

Representação JSON
{
  "event": string,
  "variables": {
    object
  }
}
Campos
event

string

Obrigatório. O nome do evento.

variables

object (Struct format)

Opcional. Variáveis adicionais associadas ao evento.

SessionInput.RecordingControl

O que o app decidiu pode ser gravado e registrado.

Esse tipo enumerado é extensível, e novos valores podem ser adicionados no futuro.

Tipos enumerados
RECORDING_CONTROL_UNSPECIFIED O app não está controlando a gravação. As configurações de registro do app decidem, como fazem para cada sessão que nunca define esse campo.
RECORDING_ENABLED A conversa pode ser gravada e registrada a partir de agora.
RECORDING_DISABLED A conversa não será mais gravada ou registrada.