- Solicitação HTTP
- Parâmetros de caminho
- Corpo da solicitação
- Corpo da resposta
- Escopos de autorização
- Permissões do IAM
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 |
Obrigatório. O app para o qual o assistente será executado. Formato: |
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 |
Obrigatório. A sessão do assistente que será usada para executar o assistente. Formato: |
message |
Obrigatório. A mensagem a ser enviada ao agente assistente. |
attachedGcsUris[] |
Opcional. URIs do Cloud Storage para arquivos enviados pelo usuário durante essa rodada. Exemplo: "gs://cxas-transient-uploads/uuid/prd.pdf" |
contextToken |
Opcional. Token de contexto de integração opaco retornado por |
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 ( |
| Campos | |
|---|---|
eventId |
Identificador exclusivo do evento. |
eventTime |
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: |
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 |
Token de texto (para streaming de respostas do Gemini palavra por palavra) |
statusMessage |
Atualização de status simples |
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-platformhttps://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.