核心用法
百度地图Agent Plan Skill提供6大核心能力，专为LLM Agent场景原生设计：
1. 语义化AI地点检索（Place）
通过自然语言理解用户需求，支持"北京可带宠物的咖啡馆""离我最近的五星级酒店"等复杂语义查询，自动保留"评分最高""3公里内"等约束条件，无需压缩为关键词。
2. 语义化AI路线规划（Direction）
支持驾车、步行、骑行、公交四种交通方式，可智能识别"打车"→"驾车"的语义转换。独特支持沿途搜索POI（如"顺路买杯咖啡"），并具备起终点/途经点消歧机制，返回候选列表供用户确认。
3. 地理编码与逆地理编码
地址↔坐标双向转换，支持行政区划提示减少歧义，坐标精度要求小数点后6位。
4. 天气查询（Weather）
支持按坐标或行政区查询实时天气。
5. 地图可视化（MapRender）
当用户明确表达"在地图上查看"时，生成并自动打开浏览器展示交互式地图。
---
显著优点
- 零门槛接入：无需注册百度地图开发者账号，直接通过Agent Plan申请SK即可使用
- LLM原生设计：API参数接受完整自然语言（
user_raw_request），无需传统POI ID或精确坐标，降低Agent开发复杂度 - 智能消歧：自动处理同名地点、模糊地址、沿途搜索歧义，返回候选列表引导用户确认
- 安全架构：纯Markdown文档型Skill，无代码执行风险；凭证通过环境变量管理，HTTPS全链路加密
- 国内数据优势：百度地图在国内POI覆盖、实时路况、公交数据方面具有本土化优势
---
潜在缺点与局限性
| 局限项 | 说明 |
|--------|------|
| **交通方式限制** | 仅支持驾车/步行/骑行/公交，地铁、打车、网约车等需改写为"驾车" |
| **坐标精度敏感** | 经纬度要求保留6位小数，禁止推测/编造，否则可能导致定位偏差 |
| **Token消耗风险** | 文档明确警告"相同参数重复请求会造成巨额token消耗"，需Agent层实现缓存机制 |
| **浏览器依赖** | MapRender功能依赖系统open/xdg-open/start命令，无头环境可能失效 |
| **数据出境** | 位置数据需发送至百度服务器，存在隐私合规考量 |
---
适合人群
- 智能助手开发者：需快速为Agent添加地图能力的团队
- 本地化服务Bot：面向中国用户的餐饮、出行、生活服务类Agent
- 企业自动化工具：需批量地址解析、路线规划的业务场景
- 隐私可控场景：能接受位置数据上传至百度地图官方服务的企业用户
---
常规风险
1. 凭证泄露：BAIDU_MAP_AUTH_TOKEN需妥善保管，避免提交至代码仓库或日志
2. 重复调用成本：无缓存机制可能导致API配额快速耗尽
3. 位置隐私：用户精确坐标、家庭/公司地址等敏感信息外发
4. 消歧流程中断：当返回gptmodel_poi_clarify类型时，需Agent正确实现"展示候选→引导选择→重新规划"的交互闭环，否则用户体验断裂