AIエージェントの権限を選択する
APIトークンや接続されたアプリが保持できるすべての権限、その機能、含まれるプリセット、および付与可能なロール（オーナー、管理者、エディター、コンテンツクリエイター）について説明します。
更新日: 読了時間 4 分
すべてのAPIトークンと接続されたアプリには、エージェントがワークスペース内で何を行えるかを決定する一連の権限（機能）が設定されています。この記事では、各権限の内容、その機能、含まれるプリセット、および付与可能なロールを一覧で紹介します。
権限の仕組み
- エージェントは、トークンを作成した人物として動作し、その人物のロールが許可する範囲内で行動します。エージェントは、オーナーがアプリ内で実行できる以上のことはできず、オーナーが閲覧可能な録画、動画、コレクションのみを認識します。
- 付与できる権限はロールによって決まります。 トークンウィザードや接続画面では、ロールで付与できない権限はグレーアウトされ、「Your role can’t grant this.（あなたのロールでは付与できません）」と表示されます（公開権限の場合は「Only owners, admins and editors can grant publishing.（オーナー、管理者、エディターのみが公開権限を付与できます）」と表示されます）。これらの権限を含むプリセットは、「Your role can’t grant every ability in this preset.（あなたのロールではこのプリセット内のすべての機能を付与できません）」と表示され、グレーアウトされます。
- ロールはトークン作成時だけでなく、呼び出しのたびにチェックされます。 後からオーナーのロールが変更された場合、新しいロールで許可されていない権限を必要とする呼び出しは拒否され、トークンリストには ロールの上限を超えています と表示されます：「The owner’s role changed. Calls needing the struck-out abilities are refused.（オーナーのロールが変更されました。取り消し線が引かれた機能を必要とする呼び出しは拒否されます）」
- 各権限には種類があり、ウィザード内でバッジとして表示されます：読み取り、編集、公開、管理、または クレジットを消費します。
- エージェントは、その権限で許可されたツール（MCP）とエンドポイント（REST）のみを認識します。権限のないツールを呼び出すと、「This token lacks the … ability.（このトークンには…機能が不足しています）」というエラーが返されます。
プリセット
トークンウィザードの最初のステップ（用途は何ですか？）では、プリセットを選択できます。いずれかを選択するとその権限にチェックが入ります。次のステップで権限を変更することも可能で、その場合ウィザードには カスタマイズ済み と表示され、Reset to preset（プリセットにリセット）オプションが表示されます。
| プリセット | 画面上の説明 | 権限 |
|---|---|---|
| ライター | "Agents draft; a person reviews and publishes." | content:read, articles:write, changelog:write, media:write |
| パブリッシャー | "Trusted automation that may change what readers see." | help:read と insights:read を除くすべてのドキュメントサイト権限 |
| サポートアシスタント | "Answers from published docs. Nothing else." | help:read |
| 読み取り専用 | "Research, audits and translation checks." | content:read |
| アナリスト | "Reads content and reader signals to suggest fixes." | content:read, insights:read |
| プロデューサー | "Drafts content and starts paid work within spend caps." | ライター、および site-pages:write, library:read, videos:create, videos:export, materials:write, credits:spend, jobs:read |
| ワークスペースエージェント | "Everything an agent can do in this workspace, within spend caps." | help:read を除くすべての権限 |
プロデューサー と ワークスペースエージェント には credits:spend が含まれているため、ウィザードの 制限 ステップでクレジット消費上限の設定が求められます。エージェントの支出と承認を管理するを参照してください。
ライター、パブリッシャー、サポートアシスタント、読み取り専用、およびアナリストの各プリセットは、ドキュメントサイト用です。
動画の権限
| 権限 | 種類 | 機能 |
|---|---|---|
library:read |
読み取り | "Read recordings, videos, articles and transcripts the owner can see": ライブラリと録画のリスト表示、アイテム・トランスクリプト・記事の読み取り、埋め込みの取得。 |
videos:create |
編集 | "Quote and request videos, articles from recordings and translations": 引用の要求、録画からのハウツー動画・製品デモ・クリーンアップ・スタイル動画の作成、ソーシャルクリップの作成、録画からの記事作成、動画翻訳の要求。有料作業の開始には credits:spend も必要です。 |
videos:export |
編集 | "Export videos and get embeds": 1080p（デフォルト）、2K、または4K（すべて60fps）でのMP4レンダリングと、ダウンロードリンクの取得。エクスポートにクレジットは消費されません。 |
materials:write |
編集 | "Add images, videos and PDFs to the workspace uploads used for new videos". |
ワークスペースの権限
| 権限 | 種類 | 機能 |
|---|---|---|
credits:spend |
クレジットを消費します | "Spend credits on quoted work, within the token's caps". 有料作業を開始するために必要な2つ目のキーです（作業自体の権限、例：videos:create と併用）。 |
jobs:read |
読み取り | "See jobs started by the owner's other tokens". トークンは自身のジョブを常に認識しますが、これを追加するとオーナーの他のトークンによるジョブも認識可能になります。また、ジョブのキャンセルやワークスペースのクレジット残高の確認も可能です。 |
ドキュメントの権限
これらは ドキュメントサイト に適用されます。制限 → ドキュメントサイト の設定で、トークンは すべてのサイト（「新しいサイトを含む、ワークスペース内のすべてのドキュメントサイト」）または 選択されたサイト を対象とします。
| 権限 | 種類 | 機能 |
|---|---|---|
content:read |
読み取り | "Read sites, pages, articles (drafts too), revisions, changelog and site pages". サイト設定、外観、ナビゲーション、リダイレクトの読み取りも含まれます。 |
articles:write |
編集 | "Create draft articles and edit articles that are not live". 記事の翻訳（有料）には credits:spend も必要です。 |
structure:write |
編集 | "Create and edit sections, move, hide and rename pages". |
site-pages:write |
編集 | "Edit site pages such as home, contact and legal". AIによるサイトページの生成や翻訳（有料）には credits:spend も必要です。 |
changelog:write |
編集 | "Create and edit changelog entries as drafts". |
media:write |
編集 | "Upload images". |
site:publish |
公開 | "Publish: change what readers see, edit live content, mark pages ready". チェンジログの公開・削除、サイトのロールバックも含まれます。 |
insights:read |
読み取り | "Read site insights: search gaps, unanswered questions and page feedback". articles:write があれば、ギャップを「対応済み」としてマークできます。 |
site:configure |
管理 | "Change site settings, appearance and navigation", およびリダイレクトの追加。 |
sites:create |
管理 | "Create new doc sites". |
help:read |
読み取り | "Search published, public pages only (support assistant)". この権限のみを持つトークンは、他の情報を一切認識しません。 |
誰が何を付与できるか
| 権限 | オーナー | 管理者 | エディター | コンテンツクリエイター |
|---|---|---|---|---|
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 を付与できますが、承認が必要な有料作業は常にワークスペースオーナーまたは管理者が承認し、トークンのオーナー単独で承認することはできません。エージェントの支出と承認を管理するを参照してください。
まだエージェントが利用できない機能
エージェントはまだウェブサイトのリサーチや録画されたウォークスルーの実行、他のプラットフォームへの動画公開を行うことはできません。これらの権限は付与できません。