Method: projects.locations.apps.chatAiAssistant

Esegue Arc, l'assistente AI, per la sessione dell'assistente specificata.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri di percorso

Parametri
app

string

Obbligatorio. L'app per cui eseguire l'assistente. Formato: projects/{project}/locations/{location}/apps/{app}

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "assistantSession": string,
  "message": string,
  "attachedGcsUris": [
    string
  ],
  "contextToken": string
}
Campi
assistantSession

string

Obbligatorio. La sessione dell'assistente da utilizzare per eseguire l'assistente. Formato: projects/{project}/locations/{location}/apps/{app}/assistantSessions/{assistantSession}
message

string

Obbligatorio. Il messaggio da inviare all'agente assistente.
attachedGcsUris[]

string

Facoltativo. URI Cloud Storage per i file caricati dall'utente durante questo turno. Esempio: "gs://cxas-transient-uploads/uuid/prd.pdf"
contextToken

string

Facoltativo. Token di contesto di onboarding opaco restituito da SessionService.GenerateOnboardingSuggestions. Se impostato e ancora aggiornato, il server riutilizza lo snapshot di onboarding calcolato per lo stato zero anziché ricalcolarlo per il primo turno di conversazione.

Corpo della risposta

Messaggio di risposta per AssistantService.ChatAiAssistant.

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione 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.
}
Campi
eventId

string

Identificatore univoco dell'evento.
eventTime

string (Timestamp format)

Timestamp di quando si è verificato l'evento.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
uiEvent

object (UiEvent)

Facoltativo. Payload dell'evento UI.
Il payload dell'evento. Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi:
textChunk

string

Token di testo (per lo streaming delle risposte di Gemini parola per parola)
statusMessage

string

Aggiornamento dello stato semplice
sessionCheckpoint

object (SessionCheckpoint)

Evento di riepilogo del checkpoint/della compattazione della sessione contenente l'user intent e il riepilogo continuo.
Fine dei campi che si escludono a vicenda.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

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

Per saperne di più, consulta la Authentication Overview.

Autorizzazioni IAM

Richiede la seguente autorizzazione IAM per la risorsa app:

  • ces.apps.update

Per saperne di più, consulta la documentazione di IAM.