Catégories :: Fonctions système (Contrôle)

EXECUTE_AI_EVALUATION¶

Démarrer ou obtenir l’état d’une exécution d’évaluation d’un Cortex Agent.

Pour plus d’informations sur les évaluations de Cortex Agent, voir Évaluations Cortex Agent.

Voir aussi :: GET_AI_RECORD_TRACE (SNOWFLAKE.LOCAL), GET_AI_EVALUATION_DATA (SNOWFLAKE.LOCAL), GET_AI_OBSERVABILITY_LOGS (SNOWFLAKE.LOCAL)

Syntaxe¶

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

Arguments¶

evaluation_job

Une des valeurs suivantes :

« START » : Commence une évaluation

« STATUS » : Récupère l’état d’une évaluation.

run_parameters

Une valeur SQL OBJECT qui contient la clé suivante :

run_name : Le nom de l’exécution sur laquelle effectuer l’opération evaluation_job.

config_file_path

Chemin d’accès au fichier de zone de préparation pointant vers une configuration d’évaluation d’agent. Ce chemin ne peut pas être une URL signée. Pour la spécification YAML complète de la configuration, voir Spécification du YAML de l’évaluation de l’agent.

Renvoie¶

La valeur de retour de cette fonction dépend de evaluation_job :

« START » renvoie un message à chaîne unique, indiquant si l’exécution SQL a réussi ou échoué.

« STATUS » renvoie une table contenant des informations sur l’état actuel de l’exécution de l’évaluation.

La table renvoyée par la tâche d’évaluation « STATUS » comporte les colonnes suivantes :


Nom	Type	Description
RUN_NAME	VARCHAR	Nom de l’exécution de l’évaluation.
AGENT_NAME	VARCHAR	Nom (non qualifié) de l’agent faisant l’objet de l’évaluation.
AGENT_TYPE	VARCHAR	Type d’agent faisant l’objet de l’évaluation.
STATUS	VARCHAR	État actuel de l’exécution de l’évaluation.
STATUS_DETAILS	ARRAY	Un tableau de messages d’erreur qui se sont produits pendant cette exécution.

Les valeurs de la colonne STATUS peuvent être l’une des suivantes :

Statut de cycle¶
Statut	Description
CREATED	Le cycle a été créé mais n’a pas commencé.
INVOCATION_IN_PROGRESS	L’invocation du cycle est en train de générer la sortie et les traçages.
INVOCATION_COMPLETED	L’invocation du cycle s’est achevée avec la création de toutes les sorties et de tous les traçages.
INVOCATION_PARTIALLY_COMPLETED	L’invocation du cycle est partiellement terminée en raison d’échecs dans l’invocation de l’application et la génération de traçage.
COMPUTATION_IN_PROGRESS	Le calcul de la métrique est en cours.
COMPLETED	Le calcul de la métrique est terminé avec des sorties et des traçages détaillés.
PARTIALLY_COMPLETED	Le cycle est partiellement terminé en raison d’échecs lors du calcul de la métrique.
CANCELLED	Le cycle a été annulé.

Exigences en matière de contrôle d’accès¶

Pour connaître l’ensemble des exigences en matière de contrôle d’accès pour effectuer une évaluation Cortex Agent, voir Évaluations Cortex Agent — Exigences en matière de contrôle d’accès.

Exemples¶

L’exemple suivant démarre une exécution appelée run-1 à l’aide de la configuration d’évaluation de l’agent depuis @eval_db.eval_schema.metrics/agent_evaluation_config.yaml :

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

L’exemple suivant interroge l’état de l’exécution de l’évaluation run-1 à l’aide de la configuration de l’agent depuis @eval_db.eval_schema.metrics/agent_evaluation_config.yaml :

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