Message

消息是客户端与服务器之间的一种通信单元。它与上下文相关联,还可以选择性地与任务相关联。由于服务器负责上下文定义,因此必须始终在其消息中提供 contextId。如果客户端知道要将消息关联到的上下文,可以选择性地提供 contextId。taskId 也是如此,只不过服务器会决定是否创建任务以及是否包含 taskId。

JSON 表示法
{
  "messageId": string,
  "contextId": string,
  "taskId": string,
  "role": enum (Role),
  "content": [
    {
      object (Part)
    }
  ],
  "metadata": {
    object
  },
  "extensions": [
    string
  ]
}
字段
messageId

string

消息的唯一标识符(例如 UUID)。此标识符是必需的,由消息创建者创建。

contextId

string

消息的上下文 ID。此参数为可选参数,如果设置,消息将与给定的上下文相关联。

taskId

string

相应消息的任务 ID。此参数为可选参数,如果设置,消息将与给定的任务相关联。

role

enum (Role)

消息的角色。

content[]

object (Part)

protolint:disable REPEATED_FIELD_NAMES_PLURALIZED Content 是消息内容的容器。

metadata

object (Struct format)

protolint:enable REPEATED_FIELD_NAMES_PLURALIZED 要随消息一起提供的任何可选元数据。

extensions[]

string

相应消息中存在或贡献的扩展程序的 URI。