# API 文件

API 文件列出一個網站自己的功能，AI 可以直接呼叫，不用一頁頁點。

## 是什麼

Cowork 會根據錄製或鑽探，為每個網站寫一份 API 文件：按模組列出它的功能，每個功能標著 **讀取** 或 **寫入**。需要這個網站的資料時，AI 會先查這裡，用你自己的登入呼叫對應的功能。所以它讀取或匯出資料又快又穩。

## 什麼時候用

| 適合 | 更適合別的方式 |
|---|---|
| 定期從某個網站匯出資料或出報表 | 只用一次的網站：讓 AI 操作頁面 |
| 批次讀取記錄 | 特別大量的匯出：讓 AI 寫一個 [爬取腳本](https://docs.micromeet.ai/zh-tw/capture/crawl-scripts.md)，它基於 API 文件生成 |
| 每次寫入都要確認的更新 | |

## 怎麼用

1. 先錄製或鑽探這個網站，讓 Cowork 學會它的功能。見 [錄製網頁操作](https://docs.micromeet.ai/zh-tw/capture/recording.md) 和 [鑽探](https://docs.micromeet.ai/zh-tw/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-tw/capture/recording.md): Cowork 怎麼學會一個網站
- [爬取腳本](https://docs.micromeet.ai/zh-tw/capture/crawl-scripts.md): 取大量資料
- [AI 什麼時候問你](https://docs.micromeet.ai/zh-tw/getting-started/workspaces-and-approvals.md#ai-什麼時候問你): 哪些操作要等你同意