聊天接口：http+json 非流式

开发中

POST

/nb/a2a/{endpoint_id}/message:send

最后修改时间：2026-09-23 01:32:19

A2A 协议的 HTTP+JSON 非流式聊天接口，请求体为 A2A Message 结构
message.parts[0].text 作为发给 Agent 的问题；可选 history（历史消息列表）与 correlationId
endpoint_id 不存在返回 404；Agent 未启用返回 503
执行过程中的内部错误不返回 HTTP 错误，而是以 200 响应返回，message.parts 中携带以 "Error:" 开头的文本

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Path 参数

Body 参数application/json必填

示例

{
    "message": {
      "role": "ROLE_USER",
      "parts": [{"type": "text", "text": "Hello, what is the weather today in shanghai?"}]
    },
    "metadata": {}
  }

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'http://localhost:5013/api/nb/a2a//message:send' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "message": {
      "role": "ROLE_USER",
      "parts": [{"type": "text", "text": "Hello, what is the weather today in shanghai?"}]
    },
    "metadata": {}
  }'

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{}

修改于 2026-09-23 01:32:19

获取A2A Agent卡片

聊天接口：http+json 流式