文档中心

数据智能体 DataAgent（私有化）

请输入

A2A

发起问答

A2A 发起流式问答：SendMessage

请求说明

项目	内容
请求方式	`POST`
请求地址	`https://${IDA_DOMAIN}/dataAgent/llm/openApi/v3/a2a//{AGENT_ID}/`
`method`	`SendMessage`
默认鉴权	`Authorization: Bearer ${JWT_TOKEN}`

鉴权

JWT_TOKEN 鉴权。

请求头

Authorization: Bearer ${JWT_TOKEN}
Content-Type: application/json

入参说明

顶层字段

字段路径	类型	是否必选	说明
`jsonrpc`	string	是	JSON-RPC 协议版本，固定传 `2.0`。
`id`	string / number	否	请求 ID，响应中会原样返回。建议在客户端侧保持唯一，便于排查问题。
`method`	string	是	方法名，固定传 `SendMessage`
`params`	object	是	方法参数对象。

params 字段

字段路径	类型	是否必选	说明
`params.message`	object	是	用户消息对象。
`params.metadata`	object	否	请求级扩展参数。若与 `params.message.metadata` 存在同名字段，以 `params.message.metadata` 为准。
`params.configuration`	object	否	发送配置，仅 `SendMessage` 使用。

params.message 字段

字段路径	类型	是否必选	说明
`params.message.messageId`	string	否	客户端生成的消息 ID。用于去重、日志定位等场景。
`params.message.contextId`	string	否	上下文 ID；传入时要求上下文存在且归属当前用户，填第一次返回的 result.task.contextId 用于关联上下文的。
`params.message.taskId`	string	否	父任务 ID；用于 A2A 调用链 fanout 统计。
`params.message.role`	string	否	消息角色，建议传 `ROLE_USER`。
`params.message.parts`	array	是	消息内容数组；至少包含一个非空 `text`。
`params.message.metadata`	object	否	消息级扩展参数，优先级高于 `params.metadata`。

params.message.parts 字段

字段路径	类型	是否必选	说明
`params.message.parts[].text`	string	是	用户输入内容；服务端取第一个非空 `text` 作为任务内容。
`params.message.parts[].mediaType`	string	否	内容类型，文本建议传 `text/plain`。

params.configuration 字段

字段路径	类型	是否必选	说明
`params.configuration.returnImmediately`	boolean	否	仅 `SendMessage` 生效。`true` 表示创建任务后立即返回；`false` 表示等待任务终态后返回。默认行为以服务端实现为准。

metadata 扩展字段

字段路径	类型	是否必选	说明
`metadata.fileList`	string[]	否	文件 storage key 列表，元素必须为字符串。获取见IDA-文件上传
`metadata.enableKnowledgeQA`	boolean	否	是否开启知识问答。
`metadata.enableWebSearch`	boolean	否	是否开启 Web 搜索。
`metadata.enableLarkQa`	boolean	否	是否开启飞书企业问答。
`metadata.sessionId`	int	否	关联会话id

参数示例

{
  "jsonrpc": "2.0",
  "id": "req-002",
  "method": "SendMessage",
  "params": {
    "message": {
      "messageId": "msg-002",
      "role": "ROLE_USER",
      "parts": [
        {
          "text": "生成一个销售数据的报告",
          "mediaType": "text/plain"
        }
      ],
      "metadata": {
         "enableKnowledgeQA": true,
        "enableWebSearch": true,
         "enableLarkQa": false,
        "fileList": [
          "agent-upload-20260818162752-726b0aa1e845402c8f3e3dec958c5837"
        ]
      }
    },
    "configuration": {
      "returnImmediately": true
    }
  }
}

请求示例

curl -N -X POST "https://${IDA_DOMAIN}/dataAgent/llm/openApi/v3/a2a/46/" \
   -H "Authorization: Bearer ${JWT_TOKEN}" \
   -H "Content-Type: application/json" \
   --data-raw '{"jsonrpc":"2.0","id":"req-002","method":"SendMessage","params":{"message":{"messageId":"msg-002","role":"ROLE_USER","parts":[{"text":"生成一个销售数据的报告","mediaType":"text/plain"}],"metadata":{"enableKnowledgeQA":true,"enableWebSearch":true,"enableLarkQa":false,"fileList":["agent-upload-20260821151800-0409f987276b4d53abff87ea0940d8e3"]}},"configuration":{"returnImmediately":true}}}'

返回参数

顶层字段

字段路径	类型	示例值	说明
jsonrpc	string	`2.0`	JSON-RPC 协议版本。
id	string	`req-002`	请求 ID，与请求体中的 `id` 对应。
result	object		请求成功后的业务结果。
result.task	object		查询到的 A2A 任务详情。

result.task 字段

字段路径	类型	示例值	说明
result.task.id	string	`fd3e486cad5e4ea7952cd1d42d776480`	A2A Task ID。
result.task.contextId	string	`baa30d46e9c44231b14f5f6911436c5c`	任务所属会话上下文 ID。
result.task.status	object	`{}`	任务状态信息。

返回示例

{
    "jsonrpc": "2.0",
    "id": "req-001",
    "result": {
        "task": {
            "id": "fd3e486cad5e4ea7952cd1d42d776480",
            "contextId": "baa30d46e9c44231b14f5f6911436c5c",
            "status": {}
        }
    }
}

最近更新时间：2026.09.04 10:25:42

这个页面对您有帮助吗？

有用

无用

数据智能体 DataAgent（私有化）

请求说明 #

鉴权

请求头 #

入参说明 #

顶层字段 #

params 字段 #

params.message 字段 #

params.message.parts 字段 #

params.configuration 字段 #

metadata 扩展字段 #

参数示例 #

请求示例 #

返回参数 #

顶层字段

result.task 字段

返回示例

请求说明

请求头

入参说明

顶层字段

params 字段

params.message 字段

params.message.parts 字段

params.configuration 字段

metadata 扩展字段

参数示例

请求示例

返回参数