1GET /v2/a2a/${appId}/.well-known/agent.json HTTP/1.1
2HOST: qianfan.baidubce.com
3Authorization: authorization string

1curl --location 'https://appbuilder.baidu.com/v2/a2a/${appId}/.well-known/agent.json' \
2--header 'X-Appbuilder-Authorization: Bearer <AppBuilder API Key>'

1{
2  "version": "1.0.0",
3  "description": "1",
4  "skills": [
5    {
6      "name": "网页探索Agent",
7      "description": " 具备问题分析、信息检索、操作浏览器和获取网页内容的能力。可模拟人类自主操作网页，完成自动点击、输入、选择等操作，更好支持内容检索与获取，帮助轻松完成网页浏览、信息查询、内容筛选等任务。",
8      "id": "9f301aed00c1402d8f2cc8faa6a8c91e",
9      "tags": []
10    },
11    {
12      "name": "代码编写Agent",
13      "description": " 具备问题分析、生成和运行代码的能力。支持生成并运行Python代码来解决用户数据处理和分析、数据可视化、数学计算等方面的需求。支持文件格式包含：xlsx、csv、jsonl、json、docx和pdf。",
14      "id": "0e31d072c92347728ae9e2ef204c0ac0",
15      "tags": []
16    },
17    {
18      "name": "报告撰写Agent",
19      "description": " 具备专业化、结构化报告输出能力。可基于用户需求或各类输入信息完成报告的框架搭建、内容组织、逻辑梳理与格式化呈现。支持内容输出为HTML及Markdown的文件格式。",
20      "id": "c46edaee42f44c31afa94c75a56727c1",
21      "tags": []
22    }
23  ],
24  "protocolVersion": "0.2.6",
25  "url": "http://demo.com",
26  "provider": {
27    "organization": "baiduqianfan",
28    "url": "https://console.bce.baidu.com/ai_apaas/appCenter"
29  },
30  "capabilities": {
31    "streaming": true
32  },
33  "securitySchemes": {
34    "apiKeyAuth": {
35      "description": "API Key认证鉴权",
36      "in": "header",
37      "name": "Authorization",
38      "type": "apiKey"
39    }
40  },
41  "security": [
42    {
43      "apiKeyAuth": []
44    }
45  ],
46  "defaultInputModes": [
47    "text/plain"
48  ],
49  "defaultOutputModes": [
50    "text/plain"
51  ],
52  "name": "我的Agent应用"
53}

1{
2    "code": "NotFoundResource",
3    "message": "A2AServerNotPublishedYet",
4    "request_id": "uuid"
5}

1POST /a2a/${appId} HTTP/1.1
2HOST: qianfan.baidubce.com
3Authorization: authorization string
4Content-Type: application/json
5
6{
7  "id": "uuid",
8  "jsonrpc": "2.0",
9  "method": "message/stream",
10  "params": {
11    "message": {
12      "kind": "message",
13      "parts": [
14        {
15          "kind": "text",
16          "text": "今天天气",
17          "metadata": {}
18        }
19      ],
20      "role": "user"
21    }
22  }
23}

1curl --location 'http://appbuilder.baidu.com/a2a/${appId}' \
2--header 'Authorization: Bearer <AppBuilder API Key>' \
3--header 'Content-Type: application/json' \
4--data '{
5  "id": "uuid",
6  "jsonrpc": "2.0",
7  "method": "message/stream",
8  "params": {
9    "message": {
10      "kind": "message",
11      "parts": [
12        {
13          "kind": "text",
14          "text": "今天天气"
15        }
16      ],
17      "role": "user"
18    }
19  }
20}'

1data: {
2    "jsonrpc": "2.0",
3    "result": {
4        "taskId": "taskid-1",
5        "contextId": "contextid-1",
6        "kind": "artifact-update",
7        "artifact": {
8            "artifactId": "artifactid-1",
9            "name": "/thought/plan",
10            "parts": [],
11            "metadata": {
12                "event": {
13                    "create": "",
14                    "id": "eventid-1",
15                    "name": "/thought/plan",
16                    "status": "preparing"
17                },
18                "is_end": false,
19                "is_event_done": false,
20                "metrics": {
21                    "begin_time_stamp": null,
22                    "current_time_stamp": null
23                },
24                "name": "",
25                "render": {
26                    "component_detail": {
27                        "is_workflow": false,
28                        "name": "",
29                        "thought": ""
30                    }
31                },
32                "text_raw": {
33                    "info": ""
34                },
35                "type": "text",
36                "visible_scope": "all"
37            }
38        },
39        "append": true,
40        "lastChunk": false,
41        "metadata": {
42            "conversation_id": "conversationid-1",
43            "end_user_id": "",
44            "is_completion": false,
45            "message_id": "msgid-1",
46            "role": "tool",
47            "status": "preparing",
48            "trace_id": "traceid-1",
49            "user_id": "userid-1"
50        }
51    },
52    "id": "id-1"
53}
54
55data: {
56    "jsonrpc": "2.0",
57    "result": {
58        "taskId": "taskid-1",
59        "contextId": "contextid-1",
60        "kind": "artifact-update",
61        "artifact": {
62            "artifactId": "artifactid-1",
63            "name": "/thought/plan",
64            "parts": [
65                {
66                    "kind": "text",
67                    "text": "已经完成任务"
68                }
69            ],
70            "metadata": {
71                "event": {
72                    "create": "",
73                    "id": "eventid-1",
74                    "name": "/thought/plan",
75                    "status": "running"
76                },
77                "is_end": false,
78                "is_event_done": false,
79                "metrics": {
80                    "begin_time_stamp": null,
81                    "current_time_stamp": null
82                },
83                "name": "",
84                "render": {
85                    "component_detail": {
86                        "is_workflow": false,
87                        "name": "",
88                        "thought": ""
89                    }
90                },
91                "type": "text",
92                "visible_scope": "all"
93            }
94        },
95        "append": true,
96        "lastChunk": false,
97        "metadata": {
98            "conversation_id": "conversationid-1",
99            "end_user_id": "",
100            "is_completion": false,
101            "message_id": "msgid-1",
102            "role": "tool",
103            "status": "running",
104            "trace_id": "traceid-1",
105            "user_id": "userid-1"
106        }
107    },
108    "id": "id-2"
109}
110
111data: {
112    "jsonrpc": "2.0",
113    "result": {
114        "taskId": "taskid-1",
115        "contextId": "contextid-1",
116        "kind": "status-update",
117        "status": {
118            "state": "completed",
119            "timestamp": "2025-08-27T08:20:43.604369041+08:00"
120        },
121        "final": true
122    },
123    "id": "id-3"
124}

1{
2    "jsonrpc": "2.0",
3    "error": {
4        "code": -32700,
5        "message": "Server received JSON that was not well-formed."
6    }
7    "id": "id-4"
8}