正式なドキュメントは英語版であり、この日本語訳はAI支援翻訳により作成された参考用のものです。日本語訳の一部の内容は人間によるレビューがまだ行われていないため、翻訳のタイミングにより英語版との間に差異が生じることがあります。最新かつ正確な情報については、英語版をご参照ください。
ドキュメントに関する現在のご利用体験についてお聞かせください。アンケートにご協力ください。

AIイベントを監査

  • プラン: Premium、Ultimate
  • 提供形態: GitLab.com、GitLab Self-Managed、GitLab Dedicated

この機能はベータ版です。予告なく変更される場合があります。詳細については、GitLabテスト規約を参照してください。

統合された、閲覧可能なGitLab Duoのエージェントアクティビティの記録には、AI監査イベントレポートを使用します。エージェントセッションごとに、確認可能な包括的な監査アーティファクトが生成されます。

AI監査イベントはGitLab AIゲートウェイによって生成されます。エージェントセッション:

  • GitLab.comでは、GitLab.comでホストされているAIゲートウェイを経由し、AI監査イベントをGitLab.comに転送します。
  • GitLab Self-Managedでは、GitLab.comでホストされているAIゲートウェイ、またはセルフマネージドのAIゲートウェイを経由できます。独自のAIゲートウェイを管理している場合、AI監査イベントをGitLabインスタンスに転送するように設定する必要があります。そうしないと、ダッシュボードにはイベントが記録されません。

AI監査イベントを表示する

AI監査イベントは、ガバナンスページの監査イベントタブで利用できます。

前提条件:

  • トップレベルグループのオーナーロールを持っていること。

グループのAI監査イベントを表示するには:

  1. 上部のバーで検索または移動先を選択して、トップレベルグループを見つけます。
  2. 設定 > GitLab Duoを選択します。
  3. ガバナンスを変更を選択します。
  4. エージェントアーティファクトタブを選択します。

このタブには、エージェントセッションのリストが表示されます。各行には次の情報が表示されます:

  • エージェントの種類（ワークフロー定義）。
  • セッションが実行されたプロジェクト。
  • セッション内の監査イベント数。
  • セッションの開始時刻。

セッションをフィルタリングする

セッションリストをフィルタリングして、結果を絞り込むことができます:

  • プロジェクト: プロジェクトパスでフィルタリングするか、特定のプロジェクトを除外します。
  • 日付範囲: 特定の日付より後または前に作成されたセッションをフィルタリングします。
  • トリガー元: セッションをトリガーしたユーザーで絞り込むか、特定のユーザーを除外します。

セッションの詳細を表示する

セッション内のイベントを確認するには:

  1. セッションの行を選択して、セッションの詳細パネルを開きます。このパネルには、セッションのメタデータと監査イベントの時系列リストが表示されます。
  2. 個々のイベントを選択して、エンティティやターゲット情報を含む詳細全体を表示します。

AI監査イベントの保存を有効にする

AI監査イベントの保存はデフォルトでは無効になっています。エージェントセッションのデータがデータベースまたはClickHouseに書き込まれるようにするには、保存を明示的に有効にする必要があります。保存を無効にしても、AI監査イベントのリアルタイムストリーミングには影響しません。

この設定は、インスタンスからグループ、プロジェクトへとカスケードされます:

  • グループレベルで無効にしてロックすると、そのグループ内のプロジェクトでは設定をオーバーライドできません。
  • グループレベルで有効にしてロックすると、そのグループ内のすべてのプロジェクトで保存が有効になり、無効にすることはできません。

前提条件:

  • グループまたはプロジェクトのオーナーロールまたはセキュリティマネージャーロールが必要です。

グループで保存を有効にする

  1. 上部のバーで、検索または移動先を選択して、グループを見つけます。
  2. 設定 > GitLab Duoを選択します。
  3. 設定の変更を選択します。
  4. データとプライバシーセクションで、AI監査イベントを保存を選択します。
  5. 変更を保存を選択します。

プロジェクトで保存を有効にする

  1. 上部のバーで、検索または移動先を選択して、プロジェクトを見つけます。
  2. 設定 > 一般を選択します。
  3. GitLab Duoセクションを展開します。
  4. AI監査イベントを保存トグルをオンにします。
  5. 変更を保存を選択します。

親グループによって設定がロックされている場合、プロジェクトレベルでは制御が無効になり、変更できません。

複合IDによるイベント帰属

エージェントセッションが複合ID（エージェントセッションのデフォルトのIDです）で実行される場合、そのセッションのAI監査イベントはサービスアカウントに帰属されます。author_idフィールドにはサービスアカウントのユーザーIDが含まれ、サービスアカウントがイベント作成者として表示されます。

イベントのdetailsフィールドには、セッションを開始した人間のユーザーが記録されます:

フィールド説明
human_author_id人間のユーザーのユーザーID
human_author_name人間のユーザー名
human_author_username人間のユーザーのユーザー名

セッションが人間のユーザー自身のトークンで認証された場合、人間のユーザーがイベント作成者となり、human_author_*フィールドは追加されません。