REST Resource: projects.locations.conversations

資源：Conversation

對話訊息。

JSON 表示法 
{
  "name": string,
  "agents": [
    string
  ],
  "createTime": string,
  "lastUsedTime": string,
  "labels": {
    string: string,
    ...
  }
}
欄位
name

string

(選用步驟) ID。對話的不重複資源名稱。格式：projects/{project}/locations/{location}/conversations/{conversationId} {conversationId} 是資源 ID，長度不得超過 63 個字元，且必須符合 https://google.aip.dev/122#resource-id-segments 中說明的格式

範例：projects/1234567890/locations/us-central1/conversations/my-conversation。

建議在建立對話時略過設定這個欄位，因為系統會自動推斷並以 {parent}/conversations/{conversationId} 覆寫。
agents[]

string

這是必要旗標，對話中的服務專員。目前僅支援一個代理程式。這個欄位會重複，以便日後支援在對話中加入多位服務專員。格式：projects/{project}/locations/{location}/dataAgents/{agent}
createTime

string (Timestamp format)

僅供輸出。建立時間戳記。

使用 RFC 3339，產生的輸出內容一律會經過 Z 標準化，並使用 0、3、6 或 9 個小數位數。系統也接受「Z」以外的偏移量。例如："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
lastUsedTime

string (Timestamp format)

僅供輸出。上次使用對話的時間戳記。

使用 RFC 3339，產生的輸出內容一律會經過 Z 標準化，並使用 0、3、6 或 9 個小數位數。系統也接受「Z」以外的偏移量。例如："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
labels

map (key: string, value: string)

(選用步驟) 開放式和使用者定義的標籤，可由用戶端設定，用於標記對話 (例如，篩選特定平台/產品的對話)。

包含 "key": value 組合清單的物件。範例：{ "name": "wrench", "mass": "1.3kg", "count": "3" }。

方法

create

 建立新對話，保留對話記錄。

get

 使用對話 ID 和父項取得單一對話的詳細資料。

list

 列出指定上層的所有對話。