Method: projects.locations.apps.chatAiAssistant

Executa o Arc, o assistente de IA, para a sessão especificada.

Solicitação HTTP

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

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
app

string

Obrigatório. O app para o qual o assistente será executado. Formato: projects/{project}/locations/{location}/apps/{app}

Corpo da solicitação

O corpo da solicitação contém dados com a seguinte estrutura:

Representação JSON
{
  "assistantSession": string,
  "message": string,
  "attachedGcsUris": [
    string
  ],
  "contextToken": string
}
Campos
assistantSession

string

Obrigatório. A sessão do assistente que será usada para executar o assistente. Formato: projects/{project}/locations/{location}/apps/{app}/assistantSessions/{assistantSession}

message

string

Obrigatório. A mensagem a ser enviada ao agente assistente.

attachedGcsUris[]

string

Opcional. URIs do Cloud Storage para arquivos enviados pelo usuário durante essa rodada. Exemplo: "gs://cxas-transient-uploads/uuid/prd.pdf"

contextToken

string

Opcional. Token de contexto de integração opaco retornado por SessionService.GenerateOnboardingSuggestions. Quando definido e ainda atualizado, o servidor reutiliza o snapshot de integração calculado para o estado zero em vez de recalcular para a primeira rodada de conversa.

Corpo da resposta

Mensagem de resposta para AssistantService.ChatAiAssistant.

Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:

Representação JSON
{
  "eventId": string,
  "eventTime": string,
  "uiEvent": {
    object (UiEvent)
  },

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "textChunk": string,
  "statusMessage": string,
  "sessionCheckpoint": {
    object (SessionCheckpoint)
  }
  // End of mutually exclusive fields.
}
Campos
eventId

string

Identificador exclusivo do evento.

eventTime

string (Timestamp format)

Carimbo de data/hora de quando o evento ocorreu.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de Z, outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".

uiEvent

object (UiEvent)

Opcional. Payload do evento UI.

O payload do evento. Confira a seguir uma lista de campos mutuamente exclusivos. No máximo um dos campos será definido em uma resposta:
textChunk

string

Token de texto (para streaming de respostas do Gemini palavra por palavra)

statusMessage

string

Atualização de status simples

sessionCheckpoint

object (SessionCheckpoint)

Evento de recapitulação de checkpoint/compactação da sessão que contém a intenção do usuário e o resumo contínuo.

Fim dos campos mutuamente exclusivos.

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

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

Para mais informações, consulte Authentication Overview.

Permissões do IAM

Requer a seguinte permissão do IAM no recurso app:

  • ces.apps.update

Para mais informações, consulte a documentação do IAM.