AI Hubの活動を監視する
AI Hubは、各アカウントのアクティビティを記録します。具体的には、各エージェントの実行とその終了方法、ガードレールがコンテンツをブロックするたびに、データソースからの各取得、およびエージェント定義への各変更を記録します。 すべての記録にはタイムスタンプが付与され、記録をトリガーしたユーザーと、その記録が属するアカウント名が記録されるため、誰がいつ何をしたかを追跡できます。
AI Hub はこれらのレコードを Liferay の 監査フレームワークに書き込み、インスタンスの監査対象アクティビティの残りの部分と一緒に保存します。
AIハブ監査イベント
AI Hubは、監査フレームワークに以下のイベントタイプを出力します。
| イベントタイプ | ログに記録された場合 |
|---|---|
AI_HUB_AGENT_INSTANCE_COMPLETE | エージェントの実行が正常に完了しました。 |
AI_HUB_AGENT_INSTANCE_COMPLETE_EXCEPTIONALLY | エージェントの実行が失敗しました。 |
AI_HUB_AGENT_INSTANCE_COMPLETE_PARTIALLY | 言語モデルまたはAIの意思決定ステップは、応答と、その応答に含まれるトークン数を返します。 |
AI_HUB_AGENT_INSTANCE_START | エージェントの実行が開始されます。 |
AI_HUB_GUARDRAIL_VIOLATION | ガードレール は、入力または出力コンテンツをブロックします。 |
AI_HUB_RAG_CONTENT_RETRIEVE | エージェントは、リクエストに応答しながら、 データソース にクエリを実行します。 |
AI_HUB_WORKFLOW_DEFINITION_ADD | エージェント定義が作成されます。 |
AI_HUB_WORKFLOW_DEFINITION_DELETE | エージェント定義が削除されました。 |
AI_HUB_ワークフロー定義の更新 | エージェント定義が更新されました。 |
各イベントレコードには、イベントをトリガーしたユーザー、発生日時、所属するアカウント、およびイベント固有の詳細情報が記録されます。 AI Hubはアカウント識別子をレコード自体に保存しており、それによってアカウントごとのアクセスが可能になる。
監査イベントへのアクセス
監査イベントへのアクセス範囲は、ユーザーの役割によって異なります。
- インスタンス管理者(管理者ロールを持つユーザー)および分析管理者ロールを持つユーザーは、インスタンス内の任意のアカウントのイベントを読み取ることができます。
- アカウント管理者権限を持つユーザーは、そのアカウントのイベントのみを閲覧できます。 管理していないアカウントを指定するリクエストはエラーを返します。
AI Hub イベントのすべてのリクエストでは、 accountIds パラメーターに少なくとも 1 つのアカウントを指定する必要があります。 accountIds を省略すると、アカウント管理者ロールを持つユーザーに対してエラーが返されます。たとえば、管理者の場合、アカウントに関連付けられていないイベントのみが返されるため、結果に AI Hub イベントは表示されません。
REST API を介して AI Hub イベントを照会する
AI Hub イベントを取得するには、Audit REST API (/o/audit/v1.0) を使用します。 Liferayのメールアドレスとパスワードで認証してください。
curl -u [userEmail]:[password] \
"https://[hostname]/o/audit/v1.0/audit-events?accountIds=[accountId]&eventType=[eventType]"
[accountId] をアカウントのエントリ ID に、 [eventType] を上記の AI Hub イベントタイプの文字列のいずれかに置き換えてください。 複数のアカウント ID でフィルタリングするには、 accountIds パラメーターを繰り返します: accountIds=[id1]&accountIds=[id2]。
eventType パラメータは、指定した値を含む任意のイベントタイプに一致するため、 eventType=AI_HUB は、すべての AI Hub タイプのイベントを一度に返します。 同じ理由で、 eventType=AI_HUB_AGENT_INSTANCE_COMPLETE も AI_HUB_AGENT_INSTANCE_COMPLETE_EXCEPTIONALLY および AI_HUB_AGENT_INSTANCE_COMPLETE_PARTIALLY と一致します。
アカウントのエントリIDは、インスタンス管理者から入手するか、「コントロールパネル」→「アカウント」で該当するアカウントを検索して確認してください。
結果をフィルタリングおよび並べ替えるには、以下のクエリパラメータを使用してください。
| パラメータ | 説明 |
|---|---|
アカウントID | 指定されたアカウントのイベントを返します。 複数のアカウントを指定する場合は、パラメータを繰り返してください。 |
イベントタイプ | この値を含む型のイベントを返します。 このパラメータは1つの値を受け入れます。 |
開始日 | この日付以降に作成されたイベントを返します。 ISO 8601形式を使用してください。 |
終了日 | この日付より前に作成されたイベントを返します。 ISO 8601形式を使用してください。 |
選別 | 結果を accountId、 contextName、 dateCreated、または eventType で並べ替えます。 デフォルトでは、最新のイベントが最初に表示されます。 |
ページ | 表示する結果ページの番号を指定します。 |
ページサイズ | 各ページに含まれるイベントの数を指定します。 |
エンドポイントは、 個のアイテム 配列を含む JSON オブジェクトを返します。 各項目には、 eventType、 dateCreated、 creator、および accountId、さらに entityType および entityId が含まれており、これらによって関連するエージェント実行またはエージェント定義が識別されます。イベント固有のデータは additionalInfo にあります。 AI Hub は additionalInfo 内の各文字列値を 200 文字に切り詰めるため、長い値は一部のみ保存されます。