Method: projects.locations.apps.chatAiAssistant

Menjalankan Arc, asisten AI, untuk sesi asisten yang ditentukan.

Permintaan HTTP

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

URL menggunakan sintaks gRPC Transcoding.

Parameter jalur

Parameter
app

string

Wajib. Aplikasi yang akan menjalankan asisten. Format: projects/{project}/locations/{location}/apps/{app}

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON 
{
  "assistantSession": string,
  "message": string,
  "attachedGcsUris": [
    string
  ],
  "contextToken": string
}
Kolom
assistantSession

string

Wajib. Sesi asisten yang akan digunakan untuk menjalankan asisten. Format: projects/{project}/locations/{location}/apps/{app}/assistantSessions/{assistantSession}
message

string

Wajib. Pesan yang akan dikirim ke agen asisten.
attachedGcsUris[]

string

Opsional. Cloud Storage URI untuk file yang diupload oleh pengguna selama giliran ini. Contoh: "gs://cxas-transient-uploads/uuid/prd.pdf"
contextToken

string

Opsional. Token konteks orientasi buram yang ditampilkan oleh SessionService.GenerateOnboardingSuggestions. Jika ditetapkan dan masih baru, server akan menggunakan kembali snapshot orientasi yang dihitung untuk status nol, bukan menghitung ulang untuk giliran percakapan pertama.

Isi respons

Pesan respons untuk AssistantService.ChatAiAssistant.

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi 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.
}
Kolom
eventId

string

ID unik untuk peristiwa.
eventTime

string (Timestamp format)

Stempel waktu saat peristiwa terjadi.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
uiEvent

object (UiEvent)

Opsional. Payload peristiwa UI.
Payload peristiwa. Berikut adalah daftar kolom yang sama-sama bersifat eksklusif. Maksimal satu kolom akan ditetapkan dalam respons:
textChunk

string

Token Teks (untuk men-streaming respons Gemini kata demi kata)
statusMessage

string

Pembaruan status sederhana
sessionCheckpoint

object (SessionCheckpoint)

Peristiwa checkpoint/ringkasan pemadatan sesi yang berisi niat pengguna dan ringkasan berkelanjutan.
Akhir kolom yang saling eksklusif.

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat Authentication Overview.

Izin IAM

Memerlukan izin IAM berikut pada resource app:

  • ces.apps.update

Untuk mengetahui informasi selengkapnya, baca dokumentasi IAM.