Admin APIでカスタムエージェントを管理する

Enterpriseプランの管理者であれば、Admin APIを使用してワークスペース内のカスタムエージェントを管理できます。設定画面でエージェントを1つずつクリックする代わりに、チームでエージェントや使用状況の情報を独自のツールに取り込み、多数のエージェントに対して一度に同じルールを適用できます。Admin APIは、組織所有の管理トークンを使用するEnterprise組織の管理者のみが利用できます。

• ワークスペース内のカスタムエージェントをすべて表示する。各エージェントの作成者、アクティブかどうか、使用しているモデル、最終実行日時、アクセス権限など、すべてのエージェントのリストを取得します。

• カスタムエージェントへのアクセス権を持つユーザーを追跡する。エージェントの共有権限を更新します。

• クレジット使用量を追跡する。各エージェントが使用したクレジット数を確認し、クレジット使用量を一括で追跡します。

• クレジット制限を設定する。個別のエージェントに対してクレジット制限を設定または変更するか、すべてのカスタムエージェントに対するワークスペースのデフォルト値を設定します。

• エージェントを作成できるユーザーを選択する。ワークスペースのエージェント作成ポリシーを設定し、必要に応じてワークスペース全体のエージェントを一時停止します。

• エージェントの有効/無効を切り替える。 特定のエージェントの実行を停止しても設定は削除されず、後で再び有効にできます。

• エージェントを削除します。エージェントの利用を停止しますが、設定は保持されるため、必要に応じて復元できます。

• エンタープライズプランのワークスペースであること。

• Admin APIは、個人のインテグレーション・トークンではなく、組織が設定する組織レベルの管理者アクセス権を使用します。設定手順については、開発者向けドキュメント →をご覧ください。

Admin APIで行うすべての操作には、Notion内に対応するコントロールがあります。

• エージェントディレクトリ（設定 → Notion AI → エージェント）で、ワークスペース内のエージェントを表示および管理できます。

• Notionのクレジットダッシュボードで、エージェントのクレジット使用状況を確認できます。

• 作成コントロールで、エージェントを作成できるユーザーを設定します。

単発の変更には「設定」を使用してください。これらのタスクを自動化したい場合、多数のエージェントを一括管理したい場合、または使用状況データを独自のレポートツールに取り込みたい場合は、Admin APIを使用してください。

• クレジット使用量を内部レポートに取り込み、各チームがカスタムエージェントのコストを確認できるようにします。

• 複数のエージェントに同じ制限やルールを一度に適用します。

• 継続すべきエージェントの所有権を譲渡します。不要になったエージェントはオフにするか、削除してください。