# API 文档

API 文档列出一个网站自己的功能，AI 可以直接调用，不用一页页点。

## 是什么

Cowork 会根据录制或钻探，为每个网站写一份 API 文档：按模块列出它的功能，每个功能标着 **读取** 或 **写入**。需要这个网站的数据时，AI 会先查这里，用你自己的登录调用对应的功能。所以它读取或导出数据又快又稳。

## 什么时候用

| 适合 | 更适合别的方式 |
|---|---|
| 定期从某个网站导出数据或出报表 | 只用一次的网站：让 AI 操作页面 |
| 批量读取记录 | 特别大量的导出：让 AI 写一个 [爬取脚本](https://docs.micromeet.ai/zh/capture/crawl-scripts.md)，它基于 API 文档生成 |
| 每次写入都要确认的更新 | |

## 怎么用

1. 先录制或钻探这个网站，让 Cowork 学会它的功能。见 [录制网页操作](https://docs.micromeet.ai/zh/capture/recording.md) 和 [钻探](https://docs.micromeet.ai/zh/capture/drill.md)。
2. 打开 **设置 › 录制 › API 文档**，选择网站。功能按模块分组。
3. 看每个功能标的是 **读取** 还是 **写入**。不想让 AI 用的功能，点 **删除**。
4. 在对话里提要求。合适时 AI 会自己用 API 文档。

## 示例

```text
从我们的订单系统导出上周所有订单和它们的状态，存为 orders-last-week.csv。
```

AI 在 API 文档里找到列出订单的功能，用你的登录逐页调用，存好 CSV，不用打开页面。

## 限制与权限

- AI 用你在这个网站标签页里的登录来调用功能。
- 调用标着 **写入** 的功能（或还不确定是只读的功能）之前，会用审批卡片问你。
- 只有你能把功能标为 **读取**，AI 不能。

## 出错怎么办

| 看到什么 | 怎么处理 |
|---|---|
| 网站没有 API 文档 | 先录制或钻探 |
| 因为登录过期，功能调用失败 | 在这个网站的标签页里重新登录，再试一次 |
| AI 还是在点页面 | 确认它需要的功能在 API 文档里；没有的话，录制一遍这些步骤 |

## 相关

- [录制网页操作](https://docs.micromeet.ai/zh/capture/recording.md): Cowork 怎么学会一个网站
- [爬取脚本](https://docs.micromeet.ai/zh/capture/crawl-scripts.md): 取大量数据
- [AI 什么时候问你](https://docs.micromeet.ai/zh/getting-started/workspaces-and-approvals.md#ai-什么时候问你): 哪些操作要等你同意