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の会話ログを表示するには、次の操作を実行します。
Snowsight にサインインします。
ナビゲーションメニューで AI & ML » Agents を選択します。
ログを表示するAgentを選択します。
Agentビューの Monitoring ページに移動します。
Agentに関連付けられたモニタリングログは、イベントテーブル SNOWFLAKE.LOCAL.AI_OBSERVABILITY_EVENTS に格納されます。このテーブルのエントリは変更できません。
AI_OBSERVABILITY_ADMIN アプリケーションロールを持つ管理者は、SNOWFLAKE.LOCAL.AI_OBSERVABILITY_EVENTS テーブルのエントリーを削除できます。
アクセス制御と権限¶
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 ROLE agent_monitoring_user_role TO USER some_user;