REST Resource: projects.locations.conversations

资源：对话

对话的消息。

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

string

可选。标识符。对话的唯一资源名称。 格式：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 规范化（即转换为 UTC 零时区格式并在末尾附加 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 规范化（即转换为 UTC 零时区格式并在末尾附加 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

 列出给定父级的所有对话。