將 AI 代理連接到您的文件網站
讓 Claude Code、Codex、ChatGPT 或您自己的指令碼來草擬、組織並發佈文件網站頁面。包含方案（Pro 及以上版本）、文件網站權限、網站範圍與發佈規則，並附有完整 AI 代理與 API 指南的連結。
諸如 Claude Code、Codex、Cursor、Claude 或 ChatGPT 等 AI 代理可以為您讀取並寫入文件網站：草擬文章、修正讀者評分較低的頁面、回答內容缺口、翻譯或發佈內容。本文涵蓋文件網站的特定事項。關於權杖、連接器、支出與錯誤的說明，請參閱 AI 代理與 API。
開始之前
- AI 代理與 API 適用於 Pro、商業 與 自訂 方案，包含 Claude 與 ChatGPT 的連接器。免費版與 Starter 版不包含此功能；若工作區移至這些方案，權杖與應用程式將停止運作。
- 代理會以建立其權杖或連接該權杖之人員的身分，並在該人員的角色權限內執行動作。它在網站上能執行的動作絕不會超過該人員的權限。
- API 呼叫不消耗點數。使用 AI 翻譯頁面與產生網站頁面會消耗點數，且僅限於使用可支出點數的權杖時才會發生。
連接代理
開啟工作區選單並選擇 AI 代理與 API，或在文件網站的 設定 選單中選擇 AI 代理與 API（這會開啟該網站的活動頁面）。
- 適用於 Claude Code、Codex、Cursor 或指令碼的 API 權杖：前往 權杖 → 新增權杖，接著依照四步驟精靈操作（用途、權限、限制、審閱）。選擇文件網站預設集（例如 撰寫者 或 發佈者），在 限制 → 文件網站 下選擇網站，並複製僅顯示一次的權杖。請參閱 建立 API 權杖。
- 適用於 Claude.ai 或 ChatGPT 的 連接器：將 已連接的應用程式 中的 連接器 URL 貼上至應用程式中，登入並選擇 網站 與 存取權限。請參閱 連接 AI 應用程式與代理。
文件網站預設集
| 預設集 | 螢幕顯示說明 | 用途 |
|---|---|---|
| 撰寫者 | "代理草擬；由人員審閱並發佈。" | 草擬文章與變更日誌項目、上傳圖片 |
| 發佈者 | "可變更讀者所見內容的受信任自動化工具。" | 文件網站的所有功能，包含發佈、設定與建立網站 |
| 支援助理 | "僅回答已發佈文件中的內容。" | 僅搜尋已發佈公開頁面的說明機器人 |
| 唯讀 | "研究、稽核與翻譯檢查。" | 讀取內容 |
| 分析師 | "讀取內容與讀者訊號以建議修正。" | 讀取內容與洞察分析 |
製作人 與 工作區代理 可新增影片與支出點數。關於每項權限以及誰能授予權限的資訊，請參閱：代理權限。
文件網站權限
| 權限 | 允許 |
|---|---|
content:read |
讀取網站、頁面、文章（含草稿）、修訂版本、變更日誌與網站頁面 |
articles:write |
建立文章草稿並編輯非公開的文章 |
structure:write |
建立與編輯區段；移動、隱藏與重新命名頁面 |
site-pages:write |
編輯網站頁面（如首頁、聯絡資訊與法律條款） |
changelog:write |
建立與編輯變更日誌項目草稿 |
media:write |
上傳圖片 |
site:publish |
發佈：變更讀者所見內容、編輯公開內容、標記頁面為就緒 |
insights:read |
讀取搜尋缺口、未回答的問題與頁面回饋 |
site:configure |
變更網站設定、外觀與導覽 |
sites:create |
建立新文件網站 |
help:read |
僅搜尋已發佈的公開頁面（適用於支援助理） |
任何成員皆可讀取。寫入與組織：擁有者、管理員、編輯者與內容創作者。發佈與網站設定：擁有者、管理員與編輯者（「僅擁有者、管理員與編輯者可授予發佈權限。」）。建立網站：擁有者與管理員。
權杖涵蓋的網站
在 限制 → 文件網站 下，選擇 所有網站（「此工作區中的每個文件網站，包含新建立的網站。」）或 已選擇的網站。權杖或已連接的應用程式僅能查看並變更其涵蓋範圍內的網站。若文章同時出現在範圍外的網站上，變更將會被拒絕：「此文章也顯示在該權杖無法變更的網站上。」
公開內容需要發佈權限
若沒有 site:publish，代理將無法變更讀者所見的內容。編輯已公開的文章將會被拒絕（「此內容已在公開網站上發佈，因此變更它需要 site:publish 權限。」），代理可以改為提交草稿以供審閱。您會收到通知：「agent 要求審閱 site 上的 page」：「未發佈任何內容。請閱讀該文章並在準備就緒後發佈。」
代理所做的每一項變更都會顯示在頁面歷史記錄中，標示為「代理 name (token)」。每個權杖每小時限制發佈 10 次。暫停的網站對代理而言為唯讀狀態：「此網站已暫停或離線，且為唯讀狀態。」
代理在網站上能做的事
列出網站並讀取頁面樹狀結構、搜尋與讀取頁面、預覽 Markdown、建立與更新文章、提交審閱、組織區段與頁面、編輯網站頁面與變更日誌、上傳圖片、讀取洞察分析並標記已涵蓋的缺口、變更設定、外觀、導覽與重新導向、建立網站、翻譯頁面、產生網站頁面、發佈與還原。每一項動作都需要對應的權限。