為 AI 代理選擇權限
API 金鑰或已連接應用程式可擁有的每一項權限、其允許的操作、包含該權限的預設集，以及哪些角色（擁有者、管理員、編輯者、內容創作者）可以授予該權限。
更新於 閱讀時間 3 分鐘
每個 API 金鑰和已連接的應用程式都帶有一組權限（能力），決定了代理在你的工作區中可以執行哪些操作。本文列出了每一項權限、其允許的操作、包含該權限的預設集，以及哪些角色可以授予該權限。
權限運作方式
- 代理會以建立金鑰之人的身分行事，並受限於該人的角色權限。它絕不能執行超過其擁有者在應用程式中可執行的操作，且只能看到其擁有者能看到的錄製內容、影片和集合。
- 你的角色決定了你可以授予的權限。 在金鑰精靈和連接畫面上，若你的角色無法授予某項權限，該選項會變灰並顯示「你的角色無法授予此權限。」（或針對發布權限顯示「僅擁有者、管理員和編輯者可以授予發布權限。」）。若預設集包含這類權限，該預設集會變灰並顯示「你的角色無法授予此預設集中的所有能力。」
- 系統會在每次呼叫時檢查角色，而不僅僅是在建立金鑰時。 如果擁有者的角色後來發生變更，需要新角色不允許之權限的呼叫將會被拒絕，且金鑰清單中會顯示 超出角色權限：「擁有者的角色已變更。需要已刪除能力的呼叫將被拒絕。」
- 每項權限都有一個類型，在精靈中以徽章顯示：讀取、編輯、發布、管理 或 消耗點數。
- 代理只能看到其權限允許的工具 (MCP) 和端點 (REST)。呼叫其缺乏權限的項目會回傳「此金鑰缺乏 … 能力。」
預設集
金鑰精靈的第一步（它的用途是什麼？）提供了一些預設集。選擇其中一個會勾選其對應的權限；你可以在下一步更改其中任何一項，隨後精靈會顯示 已自訂 並提供 重設為 預設集 的選項。
| 預設集 | 螢幕上的說明 | 權限 |
|---|---|---|
| 撰寫者 | "代理草擬；由人員審核並發布。" | content:read, articles:write, changelog:write, media:write |
| 發佈者 | "受信任的自動化流程，可能會變更讀者看到的內容。" | 除 help:read 和 insights:read 外的所有文件網站權限 |
| 支援助理 | "來自已發布文件的回答。不執行其他操作。" | help:read |
| 唯讀 | "研究、審計和翻譯檢查。" | content:read |
| 分析師 | "讀取內容和讀者訊號以建議修正。" | content:read, insights:read |
| 製作人 | "草擬內容並在點數上限內啟動付費工作。" | 撰寫者，外加 site-pages:write, library:read, videos:create, videos:export, materials:write, credits:spend, jobs:read |
| 工作區代理 | "代理在此工作區中可執行的所有操作，在點數上限內。" | 除 help:read 外的所有權限 |
製作人 和 工作區代理 包含 credits:spend，因此精靈會在 限制 步驟中要求設定點數上限。請參閱 控制代理的點數消耗與核准。
「撰寫者」、「發佈者」、「支援助理」、「唯讀」和「分析師」預設集適用於文件網站。
影片權限
| 權限 | 類型 | 允許的操作 |
|---|---|---|
library:read |
讀取 | "讀取擁有者可見的錄製內容、影片、文章和逐字稿"：列出媒體庫和錄製內容、讀取項目及其逐字稿和文章，並取得嵌入碼。 |
videos:create |
編輯 | "引用並請求影片、來自錄製內容的文章和翻譯"：請求報價並要求從錄製內容製作教學、產品演示、清理與風格化影片、社群短片、來自錄製內容的文章以及影片翻譯。啟動付費工作也需要 credits:spend。 |
videos:export |
編輯 | "匯出影片並取得嵌入碼"：渲染 1080p（預設）、2K 或 4K 的 MP4，皆為 60 fps，並取得下載連結。匯出不消耗點數。 |
materials:write |
編輯 | "將圖片、影片和 PDF 新增至用於製作新影片的工作區上傳項目中"。 |
工作區權限
| 權限 | 類型 | 允許的操作 |
|---|---|---|
credits:spend |
消耗點數 | "在金鑰的上限內，為報價工作消耗點數"。這是繼該工作所需權限（例如 videos:create）之後，每項付費工作啟動所需的第二個關鍵權限。 |
jobs:read |
讀取 | "查看由擁有者其他金鑰啟動的工作"。金鑰始終能看到自己的工作；此權限可增加查看擁有者其他金鑰之工作的權限。同時允許代理取消工作並讀取工作區的點數餘額。 |
文件權限
這些權限適用於 文件網站。在 限制 → 文件網站 下，金鑰可涵蓋 所有網站（「此工作區中的每個文件網站，包含新網站。」）或 已選擇的網站。
| 權限 | 類型 | 允許的操作 |
|---|---|---|
content:read |
讀取 | "讀取網站、頁面、文章（含草稿）、修訂版本、更新日誌和網站頁面"。也包含網站設定、外觀、導覽和重新導向。 |
articles:write |
編輯 | "建立文章草稿並編輯非公開的文章"。翻譯文章（付費）也需要 credits:spend。 |
structure:write |
編輯 | "建立並編輯區段，移動、隱藏和重新命名頁面"。 |
site-pages:write |
編輯 | "編輯網站頁面，例如首頁、聯絡頁面和法律頁面"。使用 AI 生成或翻譯網站頁面（付費）也需要 credits:spend。 |
changelog:write |
編輯 | "建立並編輯更新日誌條目的草稿"。 |
media:write |
編輯 | "上傳圖片"。 |
site:publish |
發布 | "發布：變更讀者看到的內容、編輯即時內容、標記頁面為就緒"。也包含發布和刪除更新日誌條目以及將網站還原至先前版本。 |
insights:read |
讀取 | "讀取網站洞察：搜尋缺口、未回答的問題和頁面回饋"。配合 articles:write，它還可以將缺口標記為已處理。 |
site:configure |
管理 | "變更網站設定、外觀和導覽"，以及新增重新導向。 |
sites:create |
管理 | "建立新的文件網站"。 |
help:read |
讀取 | "僅搜尋已發布的公開頁面（支援助理）"。僅擁有此權限的金鑰無法看到其他任何內容。 |
誰可以授予什麼權限
| 權限 | 擁有者 | 管理員 | 編輯者 | 內容創作者 |
|---|---|---|---|---|
content:read, help:read, insights:read, jobs:read |
是 | 是 | 是 | 是 |
library:read |
是 | 是 | 是 | 是 |
articles:write, structure:write, site-pages:write, changelog:write, media:write |
是 | 是 | 是 | 是 |
videos:export |
是 | 是 | 是 | 是 |
videos:create, materials:write, credits:spend |
是 | 是 | 否 | 是 |
site:publish, site:configure |
是 | 是 | 是 | 否 |
sites:create |
是 | 是 | 否 | 否 |
內容創作者可以授予金鑰 credits:spend，但需要核准的付費工作始終由工作區擁有者或管理員核准，絕不會僅由金鑰的擁有者單獨核准。請參閱 控制代理的點數消耗與核准。
代理尚無法使用的功能
代理目前尚無法執行網站研究或錄製的操作導覽，也無法將影片發布到其他平台。這些權限目前無法授予。