Cortex Agentのリクエストのモニター

Cortex Agentは、監査とデバッグの目的で、すべての会話の詳細なトレースをログ記録します。モニタリングにより、Snowflake IntelligenceまたはAgent API を介してデプロイされたAgentの会話履歴にアクセスできます。会話履歴に加えて、エージェントの計画プロセス、ツールの選択、実行結果、最終的な応答生成の詳細なトレースを精査できます。

Cortex Agentログで収集される情報

Cortex Agentのログには以下の情報が含まれます。

  • スレッドに関連する会話履歴

  • 次を含むスパンによるエージェントの実行トレース。

    • LLM 計画

    • ツール実行（Cortex Search、Cortex Analyst、ウェブ検索）

    • LLM 応答生成

    • SQL 実行

    • チャート生成

  • 各スパンに関連付けられた入出力

  • 各エージェントの応答に対するユーザーのフィードバック

Cortex Agentログにアクセスする

Snowsight でCortex Agentの会話ログを表示するには、次の操作を実行します。

  1. Snowsight にサインインします。

  2. ナビゲーションメニューで AI & ML » Agents を選択します。

  3. ログを表示するAgentを選択します。

  4. Agentビューの Monitoring ページに移動します。

Agentに関連付けられたモニタリングログは、イベントテーブル SNOWFLAKE.LOCAL.AI_OBSERVABILITY_EVENTS に格納されます。このテーブルのエントリは変更できません。

AI_OBSERVABILITY_ADMIN アプリケーションロールを持つ管理者は、SNOWFLAKE.LOCAL.AI_OBSERVABILITY_EVENTS テーブルのエントリーを削除できます。

ユーザーから提供されたフィードバックを表示する

エージェントに関するユーザーフィードバックをプログラムで表示するには、次の SQL コマンドを実行します。

SELECT * FROM TABLE(SNOWFLAKE.LOCAL.GET_AI_OBSERVABILITY_EVENTS('<database_name>', '<schema_name>', '<agent_name>', 'CORTEX AGENT')) WHERE RECORD:name='CORTEX_AGENT_FEEDBACK';
Copy

結果のテーブルには、エージェント、フィードバックを提供したユーザー、ユーザーから提供されたフィードバック、フィードバックがポジティブなものかそうでないかを含む列が含まれます。

アクセス制御と権限

Cortex Agentのログを表示するには、ユーザーは以下の権限を持っている必要があります。

  • AGENT オブジェクトに対する OWNERSHIP または MONITOR 権限

  • CORTEX_USER データベースロール

  • AI_OBSERVABILITY_EVENTS_LOOKUP アプリケーションのロール

次の例では、ACCOUNTADMIN ロールを使用して、Cortex Agentログの表示に必要な権限を持つ新しいロール agent_monitoring_user_role を作成します。この新しいロールは、その後 some_user に割り当てられます。

USE ROLE ACCOUNTADMIN;
CREATE ROLE agent_monitoring_user_role;
GRANT MONITOR ON AGENT my_agent TO ROLE agent_monitoring_user_role;
GRANT DATABASE ROLE SNOWFLAKE.CORTEX_USER TO ROLE agent_monitoring_user_role;
GRANT APPLICATION ROLE SNOWFLAKE.AI_OBSERVABILITY_EVENTS_LOOKUP TO ROLE agent_monitoring_user_role;
GRANT APPLICATION ROLE SNOWFLAKE.AI_OBSERVABILITY_ADMIN_RL TO ROLE agent_monitoring_user_role;
GRANT ROLE agent_monitoring_user_role TO USER some_user;
Copy

将来のエージェントにモニタリングアクセス権を付与する

スキーマに将来作成されるエージェントに対してロールのモニタリングアクセス権を付与するには、以下の SQL コマンドを使用します。

GRANT MONITORING ON FUTURE AGENTS IN SCHEMA <database_name>.<schema_name> TO ROLE <role_name>;
Copy
言語: 日本語