約 3 分で読めます

Compliance APIで個人指示を棚卸しする設計

組織の統制ポリシーを整備しても、社員が claude.ai の個人設定や Cowork のグローバル指示に書いたテキストは、管理者から見えない領域でした。全社テンプレートの外側で、各自が出力形式や行動ルールをエージェントに常時指示している可能性があります。2026年10月15日、Compliance API にこの領域を読み取る user_preferences エンドポイントが追加されました(ベータ、Claude Enterprise 向け)。

本記事はAIエージェントガバナンスのピラーコンテンツと連動しています。同じ Compliance API のローカルセッション監査はCompliance APIでローカルAIエージェントを監査するを参照してください。

user_preferences は何を返すのか

user_preferences は、全メンバーの個人指示と Cowork のグローバル指示を返すベータ APIです。

エンドポイントは GET /v1/compliance/organizations/{org_uuid}/user_preferences です。レスポンスの各行は次の3要素で構成されます。

  • conversation_preferences: 個人設定の「Instructions for Claude」。未設定・削除済みなら null
  • cowork_global_instructions: Cowork(デスクトップエージェント)の「Global instructions」。未設定なら null
  • user: メンバーの id と email_address

公式ドキュメントによれば、どちらもアカウント単位の設定で、メンバーが所属する全組織で同じテキストが返ります。複数組織に所属する社員の設定は、組織ごとの別管理にはなりません。

取得時に押さえるべき仕様は何か

既定では設定済みメンバーのみ返り、limit は最大100件、user_ids は1回10名までです。

  • include_unset=true を付けると、未設定者も null 付きで全員返ります。既定は設定済みのみです。
  • limit は既定20・最大100です。page は不透明トークンとして扱い、中身を解釈しません。
  • 1ページが limit 未満、または空でも最終ページとは限りません。サーバーが1リクエストの処理量を制限するためです。next_page が null になるまで辿ります。
  • 並び順は組織参加順(古い順)です。user_ids で対象を最大10名に絞れます。

空ページで巡回を止める実装は、取得漏れの原因になります。

必要な権限とキー管理はどう設計するか

読み取りには Compliance Access Key と read:compliance_user_data が必要です。

公式の権限表では、read:compliance_user_data が user preferences の読み取りを含みます。Admin API キー(sk-ant-admin01-)は Activity Feed しか呼べず、他のエンドポイントは 403 になります。

設計上の要点は3つです。

  1. 同じスコープでチャット・ファイル・セッション転写も読めるため、キーは強い権限を持ちます。公式も、本番DB資格情報と同等に扱うよう警告しています。
  2. スコープは作成後に変更できません。読み取り専用の棚卸し用キーを別に発行します。
  3. 削除権限(delete:compliance_user_data)とはキーを分けます。ローテーションは「新規作成→切替→旧キー削除」の順で、猶予期間はありません。

取得したテキストをどう棚卸しするか

個人指示は組織ポリシーの外側にあるため、日次で取得し、差分とリスク観点で点検します。

取得そのものより、点検ルールの設計が成果を分けます。以下は公式仕様に基づく設計案です。

  • 日次スナップショットと差分検知: ユーザーID単位でテキストのハッシュを保存し、変更時のみ内容を再点検します。
  • 点検観点: 外部URLへの送信指示、承認手順の省略を促す指示、機密区分の取り扱いに反する記述を、ルールとレビューで確認します。
  • 本人への是正フロー: 違反を自動削除する手段はこのAPIにありません。是正は本人への通知と、全社推奨テンプレートの提示で行います。
  • 扱う個人データ: 返るのはメールアドレス付きの本文です。閲覧者、保管期間、監査証跡を事前に決め、社内の労務・プライバシー部門と合意します。

個人指示は社員の私的な好みも含みます。「全文の常時監視」ではなく、リスク観点のルール検知と例外レビューに絞ると、現場の反発も抑えられます。

規模別の留意点(SMB / エンタープライズ)

大規模組織では、親組織キーと子組織キーのどちらで取得するかが運用負荷を左右します。

親組織の Primary owner が作るキーは配下の全組織を、組織オーナーのキーは自組織のみを対象にします。数千人規模では、棚卸し用キーを親組織スコープで1本に集約する案と、事業部ごとに分ける案を比較してください。前者は運用が軽く、後者は漏洩時の影響範囲を絞れます。小規模なら、ベータ機能の変更に備え、取得スクリプトを薄く保てば十分です。

参考

まとめ

user_preferences により、個人指示という統制の盲点を API で棚卸しできるようになりました。スコープ分離したキーで日次取得し、差分とリスク観点で点検する運用が出発点です。ベータ機能のため、仕様変更は公式ドキュメントで継続確認してください。大規模なマルチチーム環境での統制設計は、Kuuの大規模AI変革プログラム(RDE)までご相談ください。

関連記事

Security posture逸脱をSIEMで検知する設計Compliance APIでローカルAIエージェントを監査するClaude全端末サインアウトAPIが止める範囲と残す範囲Claude Admin APIでメンバーのライフサイクルを自動化する