EXECUTE_AI_EVALUATION¶

Cortex Agentの評価実行を開始するか、その実行ステータスを取得します。

Cortex Agentの評価について詳しくは、:doc:`/user-guide/snowflake-cortex/cortex-agents-evaluations`をご参照ください。

こちらもご参照ください。: GET_AI_RECORD_TRACE (SNOWFLAKE.LOCAL)、 GET_AI_EVALUATION_DATA (SNOWFLAKE.LOCAL)、 GET_AI_OBSERVABILITY_LOGS (SNOWFLAKE.LOCAL)

構文¶

EXECUTE_AI_EVALUATION( <evaluation_job> , <run_parameters> , <config_file_path> )

evaluation_job

次の値のいずれかです。

'START':評価を開始します

'STATUS':評価ステータスを取得します

run_parameters

次のキーを含むSQL:ref:`OBJECT<label-data_type_object>`の値：

run_name::samp:`{evaluation_job}`操作の対象となる実行の名前。

config_file_path

エージェント評価構成を指すステージファイルパス。このパスを署名付きURLにすることはできません。完全な構成YAML仕様については、:ref:`label-cortex_agent_evaluation_yaml_spec`を参照してください。

この関数の戻り値は:samp:`{evaluation_job}`によって異なります。

'START'は、SQLの実行が成功したか失敗したかを示す単一の文字列メッセージを返します。

'STATUS'は、評価実行の現在の状態に関する情報を含むテーブルを返します。

'STATUS'評価ジョブによって返されるテーブルには、次の列があります。

STATUS列の値は次のいずれかです。

実行ステータス¶
ステータス	説明
CREATED	ランは作成されましたが、開始されていません。
INVOCATION_IN_PROGRESS	ランの呼び出しは、出力とトレースを生成している最中です。
INVOCATION_COMPLETED	すべての出力とトレースが作成され、実行が完了しました。
INVOCATION_PARTIALLY_COMPLETED	アプリケーションの起動とトレース生成に失敗したため、ランの起動が部分的に完了しました。
COMPUTATION_IN_PROGRESS	メトリクスの計算が進行中です。
COMPLETED	メトリクスの計算は、詳細な出力とトレースで完了します。
PARTIALLY_COMPLETED	メトリクス計算中に失敗したため、実行は部分的に完了しました。
CANCELLED	ランは中止となりました。

Cortex Agent評価を行うための完全なアクセス制御要件については、:ref:`Cortex Agent評価 --- アクセス制御要件<label-agent_evaluation_access_control>`を参照してください。

次の例では、``@eval_db.eval_schema.metrics/agent_evaluation_config.yaml``のエージェント評価構成を使用して、``run-1``という実行を開始します。

CALL EXECUTE_AI_EVALUATION(
  'START',
  OBJECT_CONSTRUCT('run_name', 'run-1'),
  '@eval_db.eval_schema.metrics/agent_evaluation_config.yaml'
);

次の例では、``@eval_db.eval_schema.metrics/agent_evaluation_config.yaml``のエージェント構成を使用して評価実行``run-1``のステータスをクエリします。

CALL EXECUTE_AI_EVALUATION(
  'STATUS',
  OBJECT_CONSTRUCT('run_name', 'run-1'),
  '@eval_db.eval_schema.metrics/agent_evaluation_config.yaml'
);