生成 Message
物件串流,回答資料相關問題。
HTTP 要求
POST https://geminidataanalytics.googleapis.com/v1alpha/{parent=projects/*/locations/*}:chat
這個網址使用 gRPC 轉碼語法。
路徑參數
參數 | |
---|---|
parent |
這是必要旗標,即時通訊要求的父項值。圖案: |
要求主體
要求主體包含下列結構的資料:
JSON 表示法 |
---|
{ "project": string, "messages": [ { object ( |
欄位 | |
---|---|
project |
(選用步驟) 用於配額和帳單的 Google Cloud 專案。 |
messages[] |
這是必要旗標,目前對話的內容。 |
聯集欄位 context_provider 。即時通訊要求的 Context Provider。可以是 inline_context (要求中提供的內嵌背景資訊)、data_agent (資料代理程式資源的參照),或是 conversation_reference (使用 conversation_id 和 agent_id 參照持續進行的對話和背景資訊)。context_provider 只能是下列其中一項: |
|
inlineContext |
(選用步驟) 即時通訊要求的內嵌情境。您可以透過內嵌傳遞所有內容,以無狀態方式進行對話 (不含受管理對話的持續性,也不含代理程式)。 |
conversationReference |
(選用步驟) 參照持續進行的對話和代理程式背景資訊。使用這項功能與服務專員進行即時通訊,並管理對話保留時間。 |
dataAgentContext |
(選用步驟) 即時通訊要求的背景資訊。使用這項功能與 Agent 無狀態地對話,不必管理對話的持續性。 |
回應主體
如果成功,回應主體會包含 Message
例項的串流。
授權範圍
需要下列 OAuth 範圍:
https://www.googleapis.com/auth/cloud-platform
詳情請參閱Authentication Overview。
ConversationReference
參照持續進行的對話和代理程式背景資訊。
JSON 表示法 |
---|
{
"conversation": string,
"dataAgentContext": {
object ( |
欄位 | |
---|---|
conversation |
這是必要旗標,對話資源名稱。格式: |
dataAgentContext |
這是必要旗標,使用資料代理程式的即時通訊要求背景資訊。 |
DataAgentContext
使用資料代理程式的即時通訊要求背景資訊。
JSON 表示法 |
---|
{ "dataAgent": string, "credentials": { object ( |
欄位 | |
---|---|
dataAgent |
這是必要旗標,資料代理程式資源的名稱。 |
credentials |
(選用步驟) 呼叫 Looker 資料來源時要使用的憑證。 目前支援 OAuth 權杖和 API 金鑰型憑證,詳情請參閱「使用 SDK 進行驗證」。 |
contextVersion |
(選用步驟) DCS 要使用的內容版本 (例如 STAGING、PUBLISHED) |
ContextVersion
DCS 支援的脈絡版本清單。情境有兩個版本。這是為了維護資料代理程式的版本管理。
列舉 | |
---|---|
CONTEXT_VERSION_UNSPECIFIED |
未指定或無法辨識。 |
STAGING |
使用這個版本時,DCS 會將最新的暫存環境用於資料代理程式。 |
PUBLISHED |
使用這個版本時,DCS 會將最新發布的內容用於資料代理程式。 |