百度地图开放平台

所有文档

AI向导

更新时间: 2026/09/10 14:35
A2A协议格式

A2A 接口使用 JSON-RPC 2.0。请求 Header 需携带:
Authorization: Bearer 您的密钥

Agent Card
API服务地址

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"
}
message 方法

method 取值为 message/stream(流式)或 message/send(同步)。

参数名称含义类型是否必填说明

jsonrpc

JSON-RPC 版本

string

标准值 2.0

method

方法名

string

message/stream 或 message/send

id

请求标识

int

用于关联请求和响应

params.message.role

角色

string

固定 user

params.message.parts[].kind

内容类型

string

固定 text

params.message.parts[].text

query 文本

string

长度不超过 200

params.message.contextId

上下文 ID

string

传入上一轮 contextId 可续接多轮,有轮次与时间限制

params.message.metadata

业务参数

object

至少包含 loc_lng、loc_lat,其余对齐流式对话请求体

请求示例:

{
"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
}
参数名称类型含义是否必定返回说明

result.kind

string

结果类型

status-update / artifact-update

result.append

boolean

是否追加

true 追加,false 覆盖

result.artifact.parts[].kind

string

内容类型

text

result.artifact.parts[].text

string

文本

result.artifact.parts[].metadata

object

地图业务数据

结构参考流式对话

result.contextId

string

上下文 ID

result.taskId

string

任务 ID

result.status.state

string

状态

submitted / working / completed / canceled

result.status.timestamp

string

时间戳

流式返回阶段示例:

// 提交
{
"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"
}
}
task 方法

method 取值为 tasks/get(查询任务)或 tasks/cancel(取消任务)。

参数名称含义类型是否必填说明

jsonrpc

JSON-RPC 版本

string

2.0

method

方法名

string

tasks/get 或 tasks/cancel

id

请求标识

int

params.id

任务 ID

string

即 message 返回的 taskId

请求示例:

{
"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"
}
}
}
参数名称类型含义是否必定返回说明

result.kind

string

结果类型

task

result.artifacts

array

产物列表

result.artifacts[].parts[].metadata

object

地图业务数据

参考流式对话

result.history

object

任务创建历史

结构参考 message 请求体

result.status.state

string

状态

submitted / working / completed / canceled

服务状态码

业务错误码与「同步对话」一致。

上一篇

OpenAI协议格式

下一篇

更新日志
本篇文章对您是否有帮助?