Method: projects.locations.apps.chatAiAssistant

Führt Arc, den KI-Assistenten, für die angegebene Assistentensitzung aus.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
app

string

Erforderlich. Die App, für die der Assistent ausgeführt werden soll. Format: projects/{project}/locations/{location}/apps/{app}

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{
  "assistantSession": string,
  "message": string,
  "attachedGcsUris": [
    string
  ],
  "contextToken": string
}
Felder
assistantSession

string

Erforderlich. Die Assistentensitzung, die zum Ausführen des Assistenten verwendet werden soll. Format: projects/{project}/locations/{location}/apps/{app}/assistantSessions/{assistantSession}
message

string

Erforderlich. Die Nachricht, die an den Assistant-Agenten gesendet werden soll.
attachedGcsUris[]

string

Optional. Cloud Storage-URIs für Dateien, die vom Nutzer während dieser Runde hochgeladen wurden. Beispiel: „gs://cxas-transient-uploads/uuid/prd.pdf“
contextToken

string

Optional. Undurchsichtiges Onboarding-Kontext-Token, das von SessionService.GenerateOnboardingSuggestions zurückgegeben wird. Wenn diese Option festgelegt und noch aktuell ist, verwendet der Server den für den Nullzustand berechneten Onboarding-Snapshot wieder, anstatt ihn für die erste Unterhaltungsrunde neu zu berechnen.

Antworttext

Antwortnachricht für AssistantService.ChatAiAssistant.

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung 
{
  "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.
}
Felder
eventId

string

Eindeutige Kennung für das Ereignis.
eventTime

string (Timestamp format)

Zeitstempel des Ereignisses.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".
uiEvent

object (UiEvent)

Optional. Nutzlast des UI-Ereignisses.
Die Ereignisnutzlast. Im Folgenden finden Sie eine Liste von Feldern, die sich gegenseitig ausschließen. In einer Antwort wird höchstens eines der Felder festgelegt:
textChunk

string

Text-Token (für das wortweise Streamen von Gemini-Antworten)
statusMessage

string

Einfache Statusaktualisierung
sessionCheckpoint

object (SessionCheckpoint)

Ereignis für Sitzungsprüfpunkt/Zusammenfassung, das die Nutzerabsicht und eine fortlaufende Zusammenfassung enthält.
Ende der sich gegenseitig ausschließenden Felder.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

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

Weitere Informationen finden Sie unter Authentication Overview.

IAM-Berechtigungen

Erfordert die folgende IAM-Berechtigung für die Ressource app:

  • ces.apps.update

Weitere Informationen finden Sie in der IAM-Dokumentation.