了解 AI 代理人與 API
了解 Claude、ChatGPT、Claude Code、Codex 和 Cursor 等 AI 代理人能在你的 Clevera 工作區中執行哪些操作、連接方式、方案（Pro 及以上）、限制、角色、費用與安全性。
AI 代理人與 API 讓 Claude、ChatGPT、Claude Code、Codex 和 Cursor 等 AI 應用程式，以及你自己的指令碼，能在你的 Clevera 工作區中運作：尋找錄製內容、請求影片、社群短片與文章、匯出影片，以及處理文件網站。你可以精確決定每個代理人可以執行什麼操作、可以花費多少點數，以及何時需要由人員進行核准。
代理人可以做什麼
| 領域 | 代理人可以做什麼 |
|---|---|
| 影片 | 列出並讀取你的錄製內容、影片、文章與逐字稿；從錄製內容請求教學、產品展示、清理與風格化影片、社群短片、文章以及影片翻譯；匯出最高 4K 的 MP4；將圖片、影片與 PDF 新增至你的上傳內容。 |
| 文件網站 | 讀取、草擬、整理、翻譯並發布 文件網站 頁面與更新日誌，回答已發布頁面讀者的問題，讀取讀者洞察，以及變更網站設定或建立網站。 |
代理人目前尚無法執行網站研究或錄製導覽。
代理人負責發出請求；Clevera 自身的 AI 則負責製作影片或文章，方式與你在應用程式中啟動時相同。代理人看到的內容絕不會超過其擁有者所能看到的範圍：除非權杖擁有者擁有存取權，否則私人收藏中的錄製內容將保持隱藏。
連接方式
| 方式 | 對象 | 設定位置 |
|---|---|---|
| API 權杖 | Claude Code、Codex CLI、Cursor、任何 MCP 用戶端，以及你透過 REST API 執行的指令碼 | 權杖 → 新增權杖。請參閱 建立 API 權杖。 |
| 已連接的應用程式 | 作為自訂連接器的 Claude (claude.ai) 與 ChatGPT；無需權杖，直接登入即可 | 應用程式，使用來自 已連接的應用程式 的連接器 URL。請參閱 連接 AI 應用程式與代理人。 |
| REST API | 指令碼與後端服務 | API 權杖。請參閱 使用 REST API。 |
MCP 伺服器位於 https://app.clevera.ai/mcp，而 REST API 位於 https://app.clevera.ai/api/v1。
尋找頁面
開啟工作區選單並選擇 AI 代理人與 API。在文件網站上，它也位於 Docs 首頁以及網站的 設定 選單中。該頁面（「讓 Claude、Codex、ChatGPT 與你的指令碼在此工作區中運作。」）包含五個分頁，每個分頁都有各自的計數：
| 分頁 | 內容 |
|---|---|
| 權杖 | 你的 API 權杖；擁有者與管理員可以看到每個權杖。管理 API 權杖 |
| 已連接的應用程式 | 連接器 URL，以及人們連接的應用程式。連接 AI 應用程式與代理人 |
| 代理人請求 | 等待人員核准的付費工作（附帶計數徽章）以及歷史記錄。控制代理人支出與核准 |
| Webhook | 傳送至你自身系統的已簽署通知。設定 Webhook |
| 活動 | 代理人的操作記錄。讀取代理人活動 |
方案
AI 代理人與 API 適用於 Pro、商業 與 自訂 方案。這包含 API 權杖、Claude 與 ChatGPT 的連接器，以及 Webhook。
在免費與 Starter 方案中，頁面會顯示「AI 代理人與 API 包含在 Pro 方案中」：「升級以讓 Claude、ChatGPT 與你的指令碼在此工作區中運作。現有的權杖與應用程式將停止運作，直到升級為止；你仍可在此撤銷它們。」點擊 升級至 Pro。鎖定的控制項會顯示「API 與代理人存取權限適用於 Pro 及以上方案」、「Claude.ai 與 ChatGPT 連接器適用於 Pro 及以上方案」或「Webhook 適用於 Pro 及以上方案」。
| 限制 | Pro、商業、自訂 |
|---|---|
| 每個工作區的有效 API 權杖數 | 50 |
| 每人的已連接應用程式數 | 20 |
| 每個工作區的 Webhook 數 | 10 |
| 自動核准下方內容 上限 | Pro 與商業：500 點數。自訂：1,000 點數。 |
如果工作區離開 Pro 方案
不會刪除任何內容，但所有項目會暫停，直到你再次升級：
| 移至 Starter 或免費方案後 | |
|---|---|
| API 權杖 | 保持列出狀態並可撤銷。每次呼叫都會被拒絕：「代理人 API 不在此工作區的方案中。它適用於 Pro 及以上方案。」它們無法重新產生（重新產生密鑰 會開啟升級對話框）。 |
| 已連接的應用程式 | 保持列出狀態並可中斷連接。其呼叫會失敗；Claude 或 ChatGPT 可能只會顯示無法連接。 |
| Webhook | 保持列出狀態，但不會傳送任何內容。傳送測試事件 與 重新傳送 會顯示「Webhook 不在你的方案中」。 |
| 代理人請求 | 核准 會顯示「API 與代理人存取權限不在你的方案中」。拒絕 仍可運作。 |
| 新增權杖 | 「API 與代理人存取權限不在你的方案中」。 |
升級回 Pro 方案後，權杖、應用程式與 Webhook 將恢復運作。權杖仍會在原始日期到期。
誰可以做什麼
代理人的行為視同建立其權杖或連接該權杖的人員，且受限於該人員的角色權限。它能執行的操作絕不會超過該人員在應用程式中能執行的範圍，且每次呼叫都會檢查角色，因此角色變更會立即生效。
| 任務 | 擁有者 | 管理員 | 編輯者 | 內容創作者 |
|---|---|---|---|---|
| 為自己建立權杖並連接應用程式 | 是 | 是 | 是 | 是 |
| 查看並撤銷工作區中的每個權杖與應用程式 | 是 | 是 | 僅限自己的 | 僅限自己的 |
| 授權代理人請求影片並花費點數 | 是 | 是 | 否 | 是 |
| 授權代理人發布文件網站 | 是 | 是 | 是 | 否 |
| 核准代理人請求的付費工作 | 是 | 是 | 否 | 否 |
| 管理 Webhook | 是 | 是 | 否 | 否 |
完整清單請參閱 代理人權限。
費用說明
- API 與 MCP 呼叫是免費的：讀取、搜尋、引用與檢查工作狀態皆不消耗點數。影片匯出亦同。
- 使用 AI 的工作會消耗點數，與你在應用程式中啟動時相同：影片、社群短片、從錄製內容產生的文章、翻譯以及 AI 產生的網站頁面。
- 代理人僅能使用具有
credits:spend的權杖啟動付費工作。每次啟動都會先進行報價並對照權杖的支出上限進行檢查，除非該工作低於權杖的 自動核准下方內容 額度，否則需由人員核准。請參閱 控制代理人支出與核准。
Clevera 如何確保代理人安全
- 權杖皆會到期：7 天、30 天、90 天或 1 年後。沒有「永不過期」的選項。
- 密鑰僅顯示一次。 Clevera 僅儲存指紋並顯示最後四個字元。
- 最小存取權限。 每個權杖僅擁有你選擇的權限、文件網站與 IP 位址。
- 人員核准金錢支出。 代理人無法核准自己的支出；僅有工作區擁有者或管理員可以核准。
- 外洩權杖會被撤銷。 在公開 GitHub 儲存庫中發現的 Clevera 權杖會自動撤銷。
- 異常活動會被停止。 大量被拒絕的呼叫會導致權杖被撤銷；大量的變更或支出會導致權杖暫停，並通知擁有者。
- 所有操作皆會記錄 在 活動 中，並保留 13 個月。代理人的文件網站編輯也會顯示在頁面歷史記錄中，標示為「代理人 名稱 (權杖)」。