API 文档
API 文档列出一个网站自己的功能,AI 可以直接调用,不用一页页点。
是什么
Cowork 会根据录制或钻探,为每个网站写一份 API 文档:按模块列出它的功能,每个功能标着 读取 或 写入。需要这个网站的数据时,AI 会先查这里,用你自己的登录调用对应的功能。所以它读取或导出数据又快又稳。
什么时候用
| 适合 | 更适合别的方式 |
|---|---|
| 定期从某个网站导出数据或出报表 | 只用一次的网站:让 AI 操作页面 |
| 批量读取记录 | 特别大量的导出:让 AI 写一个 爬取脚本,它基于 API 文档生成 |
| 每次写入都要确认的更新 |
怎么用
示例
text
从我们的订单系统导出上周所有订单和它们的状态,存为 orders-last-week.csv。AI 在 API 文档里找到列出订单的功能,用你的登录逐页调用,存好 CSV,不用打开页面。
限制与权限
- AI 用你在这个网站标签页里的登录来调用功能。
- 调用标着 写入 的功能(或还不确定是只读的功能)之前,会用审批卡片问你。
- 只有你能把功能标为 读取,AI 不能。
出错怎么办
| 看到什么 | 怎么处理 |
|---|---|
| 网站没有 API 文档 | 先录制或钻探 |
| 因为登录过期,功能调用失败 | 在这个网站的标签页里重新登录,再试一次 |
| AI 还是在点页面 | 确认它需要的功能在 API 文档里;没有的话,录制一遍这些步骤 |