baidu-ai-map

Files (7)

• .DS_Store
• SETUP_TOKEN.md
• SKILL.md
• _meta.json
• get-token.ps1
• get-token.sh
• run.py

SKILL.md (first lines)

# 百度地图服务 Agent Plan

提供大模型友好调用的地图工具skills/baidu-ai-map/SKILL.md，支持语义化 AI 搜索、语义化 AI 路线规划、地理编码与逆地理编码、天气查询。

## 🔧 环境与认证

### ⚡ 强制初始化（每次加载 Skill 必须执行）

**进入本 Skill 后，在执行任何用户操作之前，必须先完成 Token 获取。不得跳过此步骤。**

#### 执行步骤

1. **调用 Token 获取脚本**（根据当前操作系统，`SKILL_DIR` 为本 skill 根目录）：
   - macOS/Linux：
     ```bash
     TOKEN=$(bash "${SKILL_DIR}/get-token.sh")
     ```
   - Windows：
     ```powershell
     $token = & "${SKILL_DIR}\get-token.ps1"
     ```

2. **将获取到的 token 用于后续 API 调用**，作为 `Authorization: Bearer ${TOKEN}` header 传入。

3. **仅当脚本执行失败（exit code ≠ 0）时**，提示用户手动配置 Token。

#### 🚫 禁止行为

- ❌ **禁止**跳过脚本直接询问用户手动输入 token（除非脚本失败）
- ❌ **禁止**使用之前会话中缓存的 token 值
- ❌ **禁止**将 token 明文输出到终端

### Token 使用方式

| 通道 | 使用方式 |
|------|----------|
| REST API | HTTP 请求头 `Authorization: Bearer ${TOKEN}` |

> ⚠️ Token 有效期 **永久 (permanent)**，每次调用脚本都会获取最新有效 token。若 API 返回 401 错误，重新执行脚本获取新 token。

## 使用准则

### 准则 1：API 端点

所有能力统一使用：

> **Base URL**: `https://api.map.baidu.com/`

### 准则 2：SK 凭证安全处理

SK（Service Key）是调用所有 API 的必须凭证：

- 通过 `get-token.sh` / `get-token.ps1` 从凭证托管服务动态获取
- **禁止**直接使用环境变量 `BAIDU_MAP_AUTH_TOKEN`（QClaw 连接器模式下由凭证托管服务管理）

### 准则 3：统一鉴权方式（Header 传入）

调用所有 API 时，统一通过 Header 传入：

- `Authorization: Bearer ${TOKEN}`

示例：

```bash
TOKEN=$(bash "${SKILL_DIR}/get-token.sh")
curl --get "https://api.map.baidu.com/agent_plan/v1/place" \
  -H "Authorization: Bearer ${TOKEN}" \
  --data-urlencode "user_raw_request=帮我找北京可带宠物的咖啡馆" \
  --data-urlencode "region=北京市"
```

## 全局参数与行为约束

1. `user_raw_request` 必须是完整的用户需求，不可压缩为关键词。
2. `user_raw_request` 出现"我附近"等非明确地点时，可根据上下文为用户推理为具体地点名称，但不可对坐标进行推理。
3. `user_raw_request` 需保留定语/约束词，例如"评分最高""最近""最便宜""3公里内"。
4. 不得编造坐标；`center` / `location` / `refer_pois` 仅可来自用户明确提供或可信来源，当无可靠坐标时，必须先向用户澄清或先调用 `geocoding` / `place` 等工具获取。
5. 统一使用 Header 鉴权：`Authorization: Bearer ${TOKEN}`。
6. 经纬度至少保留小数点后 6 位。
7. 所有工具返回坐标类型统一为 `gcj02`。
8. 相同参数请求避免重复发起，否则会造成百度地图 Agent Plan 巨额的token消耗。

## 工具详解

### 1. Place（语义化AI地点检索）

#### API

`GET /agent_plan/v1/place`

#### 参数输入（给模型）

Required:
- `user_raw_request`: 用户原始需求，原样完整传入，不可压缩为关键词；保留约束词（如"评分最高""最近""3公里内"）
- `region`: 城市或区域限制

Optional:
- `center`: 检索中心点和排序参考点（`lat,lng`，gcj02）
- `sort`: `distance` 或 `relevance`（默认 `relevance`）

Rules:
- `sort=distance` 时，`center` 必传
- `center` 只能来自用户明确提供或可信来源，禁止推测/编造，可通过 `geocoding` / `place` 等工具获取
- 经纬度至少保留小数点后 6 位

#### 鉴权

- GET：Header `Authorization: Bearer ${TOKEN}`

#### 示例

```bash
TOKEN=$(bash "${SKILL_DIR}/get-token.sh")
# 1) 帮我查一下八达岭长城附近的五星级酒店
curl --get "https://api.map.baidu.com/agent_plan/v1/place" \
  -H "Authorization: Bearer ${TOKEN}" \
  --data-urlencode "user_raw_request=帮我查一下八达岭长城附近的五星级酒店" \
  --data-urlencode "region=延庆区" \
  --data-urlencode "sort=relevance"

From bobo070314/openclaw-config, MIT.

More from bobo070314/openclaw-config