跳到主要内容

MessageIn

终端用户的一条消息:这一轮的文字,以及可选的媒体。

textText必填

终端用户在这一轮说的话。

可能的取值: 非空 and <= 32000 个字符

attachments object[]可为 null

这一轮要附带的媒体(最多 10 项)。null 或空列表表示不附带媒体。

可能的取值: <= 10

  • Array [
  • file_idstring<uuid>可为 null

    通过 POST /v1/files 创建、归自己所有的文件的 ID。file_id 和 file_data 必须且只能提供一个。

    file_dataFile Data可为 null

    Base64 编码的文件内容(可以带 data:…;base64, 前缀,前缀会被忽略)。file_id 和 file_data 必须且只能提供一个。

  • ]
  • a2ui_action object

    当用户通过操作 a2ui 界面(点按钮、提交表单)发出这条消息时设置:渲染器给出的 a2ui action 消息,保持原样。text 仍然是用户看到自己发出的内容,例如按钮上的文字。只有 a2ui 会话接受这个字段。

    anyOf

    来自 a2ui 界面的界面操作:渲染器给出的 a2ui action 消息,保持原样。

    versionVersion必填

    a2ui 协议版本:v1.0。

    常量值: v1.0
    action object必填

    用户在 a2ui 界面上的操作,按渲染器报告的原样。

    nameName必填

    组件 action.event 的 name。

    可能的取值: <= 64 个字符, 取值须匹配正则表达式 ^[^\x00-\x1f\x7f\u0085\u2028\u2029]+$

    surfaceIdSurfaceid必填

    组件所在界面的 surfaceId。

    可能的取值: <= 200 个字符, 取值须匹配正则表达式 ^[^\x00-\x1f\x7f\u0085\u2028\u2029]+$

    sourceComponentIdSourcecomponentid必填

    用户操作的组件的 id。

    可能的取值: <= 200 个字符, 取值须匹配正则表达式 ^[^\x00-\x1f\x7f\u0085\u2028\u2029]+$

    timestampTimestamp可为 null

    用户操作的时间(ISO 8601),按渲染器报告的原样。

    可能的取值: <= 64 个字符

    contextobject

    组件 action.event 的 context,其中的数据绑定已解析:即用户选择或输入的值。以 JSON 计最多 4000 个字符,最多嵌套 8 层。

    userMessageUsermessage可为 null

    组件的 action.event.userMessage。会被接受但不使用:text 才是用户说的话。

    可能的取值: <= 2000 个字符

    metadataobject可为 null

    渲染器附带的客户端元数据。会被接受但不使用;大小限制与 context 相同。

    streamStream

    设为 true 则直接在这个请求上接收任务:响应是这个任务自己的帧组成的流,与会话事件流发送的一样,从第一帧到结束帧——或者和所有事件流一样,最长 10 分钟。

    默认值: false
    MessageIn
    {
    "text": "What should I pack for three days in Lisbon in March?"
    }