A2A 接口使用 JSON-RPC 2.0。请求 Header 需携带:
Authorization: Bearer 您的密钥
https://api.map.baidu.com/api_aic/v1/a2a/.well-known/agent-card.json
Authorization: Bearer 您的密钥
返回示例:
{"capabilities": {"streaming": true},"defaultInputModes": ["text/plain"],"defaultOutputModes": ["text/plain","application/json"],"description": "为用户提供检索、路线规划以及出游攻略规划相关的能力","name": "百度地图智能助手agent","protocolVersion": "","skills": [{"id": "poi-search","name": "地点搜索","description": "搜索地点、餐厅、景点、酒店等 POI 信息","examples": ["附近有什么好吃的","找一家咖啡厅","天安门在哪里","北京好玩的景点"],"tags": ["地点","搜索","位置","餐厅","酒店","景点","POI"]},{"id": "navigate-route","name": "导航算路","description": "根据起终点信息获取路线信息,支持沿途搜","examples": ["开车去天安门","步行去颐和园","骑车去北京大学","开车去天安门顺路买个包"],"tags": ["导航","算路","路线","驾车","步行","骑行","沿途搜"]},{"id": "travel-plan","name": "出游攻略规划","description": "根据用户要求制定出游攻略","examples": ["北京三日游攻略","给我一份青岛4日游攻略"],"tags": ["旅游","出游","攻略","行程","规划"]}],"url": "https://api.map.baidu.com/api_aic/v1","version": "1.0.0"}
method 取值为 message/stream(流式)或 message/send(同步)。
请求示例:
{"jsonrpc": "2.0","method": "message/stream","params": {"message": {"role": "user","parts": [{"kind": "text","text": "附近的肯德基"}],"metadata": {"loc_lng": 116.27988,"loc_lat": 40.050675,"coord_type": "bd09ll","ret_coord_type": "bd09ll"}}},"id": 2}
流式返回阶段示例:
// 提交{"jsonrpc": "2.0","id": 2,"result": {"kind": "status-update","contextId": "019b4f8e-c790-793f-96aa-ac08036a9033","final": false,"status": {"state": "submitted", "timestamp": "2025-12-24T16:51:55+08:00"},"taskId": "019b4f8e-c790-7814-bf56-a0ee8975765c"}}// 开始执行{"jsonrpc": "2.0","id": 2,"result": {"kind": "status-update","contextId": "019b4f8e-c790-793f-96aa-ac08036a9033","final": false,"status": {"state": "working", "timestamp": "2025-12-24T16:51:55+08:00"},"taskId": "019b4f8e-c790-7814-bf56-a0ee8975765c"}}// 流式输出{"jsonrpc": "2.0","id": 2,"result": {"kind": "artifact-update","append": true,"artifact": {"artifactId": "019b35f5-a2ff-78e8-b368-be47fee56f32","parts": [{"kind": "text","text": "为您找到以下结果","metadata": {"answer_type": "gptmodel_poi","query": "附近的肯德基","poi_data": {},"session_id": "789908443015323648"}}]},"contextId": "019b35f5-a0b2-7f20-8643-28de6f0ac895","taskId": "019b35f5-a0b2-7be5-a770-fd3384d40dc7"}}// 结束{"jsonrpc": "2.0","id": 2,"result": {"kind": "status-update","contextId": "019b4f8e-c790-793f-96aa-ac08036a9033","final": true,"status": {"state": "completed", "timestamp": "2025-12-24T16:52:08+08:00"},"taskId": "019b4f8e-c790-7814-bf56-a0ee8975765c"}}
method 取值为 tasks/get(查询任务)或 tasks/cancel(取消任务)。
请求示例:
{"jsonrpc": "2.0","id": 1,"method": "tasks/get","params": {"id": "019b4f7b-fe56-7283-9631-6b8d66c0263e"}}
返回示例:
{"jsonrpc": "2.0","id": 1,"result": {"kind": "task","id": "019b4f8e-c790-7814-bf56-a0ee8975765c","artifacts": [{"artifactId": "019b4f8e-dce7-7b3a-be86-36e73dcb4c86","parts": [{"kind": "text","text": "为您找到以下结果","metadata": {"answer_type": "gptmodel_flow","query": "介绍一下李白","session_id": "791709759785926656"}}]}],"status": {"state": "completed","timestamp": "2025-12-24T16:52:08+08:00"}}}
业务错误码与「同步对话」一致。
上一篇
下一篇