消息是客户端与服务器之间的一种通信单元。它与上下文相关联,还可以选择性地与任务相关联。由于服务器负责上下文定义,因此必须始终在其消息中提供 contextId。如果客户端知道要将消息关联到的上下文,可以选择性地提供 contextId。taskId 也是如此,只不过服务器会决定是否创建任务以及是否包含 taskId。
| JSON 表示法 |
|---|
{ "messageId": string, "contextId": string, "taskId": string, "role": enum ( |
| 字段 | |
|---|---|
messageId |
消息的唯一标识符(例如 UUID)。此标识符是必需的,由消息创建者创建。 |
contextId |
消息的上下文 ID。此参数为可选参数,如果设置,消息将与给定的上下文相关联。 |
taskId |
相应消息的任务 ID。此参数为可选参数,如果设置,消息将与给定的任务相关联。 |
role |
消息的角色。 |
content[] |
protolint:disable REPEATED_FIELD_NAMES_PLURALIZED Content 是消息内容的容器。 |
metadata |
protolint:enable REPEATED_FIELD_NAMES_PLURALIZED 要随消息一起提供的任何可选元数据。 |
extensions[] |
相应消息中存在或贡献的扩展程序的 URI。 |