Method: projects.locations.chat

Menjawab pertanyaan data dengan membuat aliran objek Message.

Permintaan HTTP

POST https://geminidataanalytics.googleapis.com/v1beta/{parent=projects/*/locations/*}:chat

URL menggunakan sintaks gRPC Transcoding.

Parameter jalur

Parameter
parent

string

Wajib diisi. Nilai induk untuk permintaan chat. Pola: projects/{project}/locations/{location}

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON 
{
  "project": string,
  "messages": [
    {
      object (Message)
    }
  ],
  "credentials": {
    object (Credentials)
  },
  "thinkingMode": enum (ThinkingMode),

  // Union field context_provider can be only one of the following:
  "inlineContext": {
    object (Context)
  },
  "conversationReference": {
    object (ConversationReference)
  },
  "dataAgentContext": {
    object (DataAgentContext)
  },
  "clientManagedResourceContext": {
    object (ClientManagedResourceContext)
  }
  // End of list of possible types for union field context_provider.
}
Kolom
project
(deprecated)

string

Opsional. Project Google Cloud yang akan digunakan untuk kuota dan penagihan.
messages[]

object (Message)

Wajib diisi. Konten percakapan saat ini.
credentials

object (Credentials)

Opsional. Kredensial yang akan digunakan saat memanggil sumber data yang ditentukan dalam konteks.

Kolom ini dapat digunakan untuk memberikan kredensial bagi berbagai sumber data. Misalnya, saat terhubung ke Looker, saat ini kredensial berbasis token OAuth dan kunci API didukung, seperti yang dijelaskan dalam Autentikasi dengan SDK.
thinkingMode

enum (ThinkingMode)

Opsional. Mode berpikir yang akan digunakan untuk loop agen. Nilai defaultnya adalah THINKING_MODE_UNSPECIFIED jika tidak ditentukan.
Kolom union context_provider. Penyedia Konteks untuk permintaan chat. Dapat berupa - inline_context, yang merupakan konteks yang disediakan secara inline dalam permintaan. data_agent, yang merupakan referensi ke resource agen data. conversation_reference, yang merupakan referensi ke percakapan dan konteks yang dipertahankan menggunakan conversation_id dan agent_id. context_provider hanya dapat berupa salah satu dari berikut:
inlineContext

object (Context)

Opsional. Konteks inline untuk permintaan chat. Gunakan ini untuk melakukan chat tanpa status (tanpa persistensi percakapan terkelola dan tanpa Agen) dengan meneruskan semua konteks secara inline.
conversationReference

object (ConversationReference)

Opsional. Referensi ke percakapan dan konteks agen yang dipertahankan. Gunakan ini untuk melakukan chat dengan Agen menggunakan persistensi percakapan terkelola.
dataAgentContext

object (DataAgentContext)

Opsional. Konteks untuk permintaan chat. Gunakan ini untuk melakukan chat dengan Agen tanpa status, tanpa persistensi percakapan terkelola.
clientManagedResourceContext

object (ClientManagedResourceContext)

Opsional. Konteks dengan resource terkelola klien. Beberapa klien mungkin tidak menggunakan resource terkelola GDA, termasuk percakapan dan agen. Sebagai gantinya, mereka membuat dan mengelola resource percakapan dan agen mereka sendiri.

Isi respons

Jika berhasil, isi respons akan berisi aliran instance Message.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat Authentication Overview.

ConversationReference

Referensi ke percakapan dan konteks agen yang dipertahankan.

Representasi JSON 
{
  "conversation": string,
  "dataAgentContext": {
    object (DataAgentContext)
  }
}
Kolom
conversation

string

Wajib diisi. Nama resource percakapan. Format: projects/{project}/locations/{location}/conversations/{conversationId}
dataAgentContext

object (DataAgentContext)

Wajib diisi. Konteks untuk permintaan chat menggunakan agen data.

DataAgentContext

Konteks untuk permintaan chat menggunakan agen data.

Representasi JSON 
{
  "dataAgent": string,
  "credentials": {
    object (Credentials)
  },
  "contextVersion": enum (ContextVersion)
}
Kolom
dataAgent

string

Wajib diisi. Nama resource agen data.
credentials

object (Credentials)

Opsional. Kredensial yang akan digunakan saat memanggil sumber data Looker.

Saat ini mendukung kredensial berbasis token OAuth dan kunci API, seperti yang dijelaskan dalam Autentikasi dengan SDK.
contextVersion

enum (ContextVersion)

Opsional. Versi konteks yang akan digunakan oleh DCS (misalnya, STAGING, PUBLISHED)

ContextVersion

Daftar versi konteks yang didukung oleh DCS. Ada dua versi konteks. Hal ini untuk mempertahankan pembuatan versi untuk agen data.

Enum
CONTEXT_VERSION_UNSPECIFIED Tidak ditentukan atau tidak dikenali.
STAGING Dengan menggunakan versi ini, DCS akan menggunakan konteks staging terbaru untuk agen data.
PUBLISHED Dengan menggunakan versi ini, DCS akan menggunakan konteks publikasi terbaru untuk agen data.

ClientManagedResourceContext

Konteks dengan resource terkelola klien. Beberapa klien mungkin tidak menggunakan resource terkelola GDA, termasuk percakapan dan agen. Sebagai gantinya, mereka membuat dan mengelola resource percakapan dan agen mereka sendiri.

Representasi JSON 
{
  "inlineContext": {
    object (Context)
  },
  "conversationId": string,
  "agentId": string
}
Kolom
inlineContext

object (Context)

Wajib diisi. Konteks untuk permintaan chat. Gunakan ini untuk melakukan chat tanpa persistensi percakapan dan agen terkelola GDA API dengan meneruskan semua konteks secara inline.
conversationId

string

Opsional. ID percakapan terkelola klien.
agentId

string

Opsional. ID agen terkelola klien.

ThinkingMode

Mode berpikir untuk agen.

Enum
THINKING_MODE_UNSPECIFIED Mode berpikir tidak ditentukan, agen akan menggunakan mode THINKING secara default.
FAST Mode cepat, menjawab dengan cepat.
THINKING Mode berpikir, memecahkan masalah yang kompleks.