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

SYSTEM$CREATE_EVALUATION_DATASET¶

Crée un ensemble de données Snowflake pour les évaluations Cortex Agent à partir d’une table existante. Le nouvel ensemble de données est enregistré dans la même base de données et le même schéma que ceux indiqués dans l’argument de nom de l’ensemble de données.

Utilisez cette fonction lorsque vous souhaitez créer un ensemble de données d’évaluation avec SQL (par exemple, en suivant le guide Premiers pas avec les évaluations Cortex Agent). Vous pouvez également créer un ensemble de données à partir d’une table dans Snowsight lorsque vous démarrez une évaluation, ou définir un bloc dataset dans votre fichier YAML d’évaluation. Pour connaître les exigences relatives aux tables et aux colonnes pour les données d’évaluation, voir Format de l’ensemble de données.

Voir aussi :: EXECUTE_AI_EVALUATION, GET_AI_EVALUATION_DATA (SNOWFLAKE.LOCAL)

Syntaxe¶

CALL SYSTEM$CREATE_EVALUATION_DATASET(
  '<agent_dataset_type>' ,
  '<source_table_name>' ,
  '<dataset_name>' ,
  <column_mapping>
);

Arguments¶

'agent_dataset_type'

Le type d’ensemble de données pour les évaluations Cortex Agent. Utilisez la chaîne Cortex Agent. La valeur est insensible à la casse.

'source_table_name'

Nom complet de la table source qui contient les entrées d’évaluation et les colonnes de valeurs de référence (par exemple, MY_DB.MY_SCHEMA.MY_EVAL_TABLE).

'dataset_name'

Nom complet de l’ensemble de données créé par Snowflake (par exemple, MY_DB.MY_SCHEMA.MY_EVAL_DATASET). L’ensemble de données est créé dans la base de données et le schéma que vous spécifiez.

column_mapping

Un OBJECT SQL qui associe les champs d’évaluation aux noms des colonnes source. Comprend :

query_text : Le nom de la colonne qui contient la requête d’entrée (VARCHAR).
ground_truth : Le nom de la colonne VARIANT qui contient les valeurs de référence JSON pour chaque ligne.

Les clés de cet objet correspondent aux clés column_mapping de la section dataset de la spécification YAML Agent Evaluation.

Renvoie¶

Un message de chaîne indiquant si l’ensemble de données a été créé avec succès.

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

Vous avez besoin d’autorisations pour créer un ensemble de données à partir d’une table d’entrée, dont CREATE DATASET ON SCHEMA pour le schéma dans lequel l’ensemble de données est créé.

Exemples¶

L’exemple suivant crée l’ensemble de données MARKETING_CAMPAIGNS_DB.AGENTS.MARKETING_CAMPAIGN_EVALSET de la table MARKETING_CAMPAIGNS_DB.AGENTS.EVALS_TABLE, à l’aide de INPUT_QUERY en tant que colonne de requête et GROUND_TRUTH_DATA en tant que colonne de valeurs de référence :

CALL SYSTEM$CREATE_EVALUATION_DATASET(
  'Cortex Agent',
  'MARKETING_CAMPAIGNS_DB.AGENTS.EVALS_TABLE',
  'MARKETING_CAMPAIGNS_DB.AGENTS.MARKETING_CAMPAIGN_EVALSET',
  OBJECT_CONSTRUCT(
    'query_text', 'INPUT_QUERY',
    'ground_truth', 'GROUND_TRUTH_DATA'
  )
);

Confirmez l’existence de l’ensemble de données :

SHOW DATASETS IN SCHEMA MARKETING_CAMPAIGNS_DB.AGENTS;