Schéma :

ACCOUNT_USAGE

Vue CORTEX_AGENT_USAGE_HISTORY

La vue CORTEX_AGENT_USAGE_HISTORY peut être utilisée pour interroger l’historique de l’utilisation des Agents Cortex.

Note

Cette vue ne comprend pas les requêtes provenant de Snowflake Intelligence. Les requêtes provenant de Snowflake Intelligence sont enregistrées dans la vue SNOWFLAKE_INTELLIGENCE_USAGE_HISTORY.

Les informations de la vue incluent le nombre de crédits consommés chaque fois qu’un utilisateur interagit avec les Agents Cortex. Une requête entraîne un ou plusieurs appels aux outils sous-jacents, par exemple, Cortex Analyst et Cortex Search. Chaque ligne de la vue représente un appel à l’agent et fournit des détails sur les jetons et les crédits agrégés dans l’appel, ainsi que des détails granulaires. La vue comprend également des métadonnées pertinentes, comme l’ID utilisateur, l’ID de requête et l’ID d’agent. Pour plus d’informations sur la facturation Cortex, consultez Considérations relatives aux clients.

Colonnes

Nom de la colonne

Type de données

Description

START_TIME

TIMESTAMP_LTZ

Heure de début : moment où la demande de message de l’Agent Cortex a été reçue.

END_TIME

TIMESTAMP_LTZ

Heure de fin : moment où la réponse au message de l’Agent Cortex a été envoyée.

USER_ID

NUMBER

Identificateur unique de l’utilisateur qui a fait la demande.

USER_NAME

VARCHAR

Nom de l’utilisateur qui a fait la demande.

USER_TAGS

ARRAY

Balises associées à l’utilisateur. Chaque objet du tableau contient les paires de valeurs suivantes :

  • level : Niveau auquel la balise est appliquée (par exemple « ACCOUNT » ou « USER »).

  • tag_database : Base de données où la balise est définie.

  • tag_schema : Schéma où la balise est définie.

  • tag_name : Nom de la balise.

  • tag_value : La valeur de la balise.

REQUEST_ID

VARCHAR

L’identificateur unique de la demande.

PARENT_REQUEST_ID

VARCHAR

Identificateur de la requête parente, le cas échéant.

AGENT_DATABASE_ID

NUMBER

Identificateur unique de la base de données de l’agent.

AGENT_DATABASE_NAME

VARCHAR

Nom de la base de données de l’agent.

AGENT_SCHEMA_ID

NUMBER

Identificateur unique du schéma de l’agent.

AGENT_SCHEMA_NAME

VARCHAR

Nom du schéma de l’agent.

AGENT_ID

NUMBER

Identificateur unique de l’agent.

AGENT_NAME

VARCHAR

Nom de l’agent.

AGENT_TAGS

ARRAY

Balises associées à l’agent. Chaque objet du tableau contient les paires de valeurs suivantes :

  • level : Niveau auquel la balise est appliquée (par exemple « DATABASE » ou « CORTEX_AGENT »).

  • tag_database : Base de données où la balise est définie.

  • tag_schema : Schéma où la balise est définie.

  • tag_name : Nom de la balise.

  • tag_value : La valeur de la balise.

TOKEN_CREDITS

NUMBER

Nombre de crédits de jetons utilisés pour la demande. Utilisé pour la budgétisation au niveau de l’utilisateur.

TOKENS

NUMBER

Somme des jetons utilisés par Cortex Agent.

TOKENS_GRANULAR

ARRAY

Répartition granulaire de l’utilisation des jetons par requête, type de service (cortex_agents, cortex_analyst) et modèle. Inclut le nombre de jetons d’entrée, cache_read_input, cache_write_input et de sortie par modèle. Le nom de modèle « inconnu » est utilisé lorsqu’un modèle n’est pas présent dans les données de tarification. Chaque objet du tableau contient les paires de valeurs suivantes :

  • request_id : L’identificateur unique de la demande.

  • service_type : Type de service, tel que « cortex_agents » ou « cortex_analyst ».

  • model : Nom du modèle utilisé pour la requête.

  • input : Nombre de jetons d’entrée.

  • cache_read_input : Nombre de jetons d’entrée de lecture du cache.

  • cache_write_input : Nombre de jetons d’entrée d’écriture du cache.

  • output : Nombre de jetons de sortie.

  • start_time : Heure de début de la requête.

CREDITS_GRANULAR

ARRAY

Répartition granulaire de l’utilisation du crédit par requête, type de service (cortex_agents, cortex_analyst) et modèle. Inclut les valeurs de crédit d’entrée, cache_read_input, cache_write_input et de sortie par modèle. Le nom de modèle « inconnu » est utilisé lorsqu’un modèle n’est pas présent dans les données de tarification. Chaque objet du tableau contient les paires de valeurs suivantes :

  • request_id : L’identificateur unique de la demande.

  • service_type : Type de service, tel que « cortex_agents » ou « cortex_analyst ».

  • model : Nom du modèle utilisé pour la requête.

  • input : Valeur de crédit pour les jetons d’entrée.

  • cache_read_input : Valeur de crédit pour les jetons d’entrée de lecture du cache.

  • cache_write_input : Valeur de crédit pour les jetons d’entrée d’écriture du cache.

  • output : Valeur de crédit pour les jetons de sortie.

  • start_time : Heure de début de la requête.

METADATA

OBJECT

Réservé pour des métadonnées supplémentaires. Actuellement vide.

Exemples

Récupérer l’historique d’utilisation de Cortex Agent :

SELECT *
  FROM SNOWFLAKE.ACCOUNT_USAGE.CORTEX_AGENT_USAGE_HISTORY;
Copy
+-------------------------------+-------------------------------+---------+-----------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+--------------------------------------+-------------------+-------------------+---------------------+-----------------+-------------------+----------+------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+---------------+--------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+----------+
| START_TIME                    | END_TIME                      | USER_ID | USER_NAME | USER_TAGS                                                                                                                                                                                                                                                | REQUEST_ID                           | PARENT_REQUEST_ID | AGENT_DATABASE_ID | AGENT_DATABASE_NAME | AGENT_SCHEMA_ID | AGENT_SCHEMA_NAME | AGENT_ID | AGENT_NAME | AGENT_TAGS                                                                                                                                                                                                                                                | TOKEN_CREDITS | TOKENS | TOKENS_GRANULAR                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | CREDITS_GRANULAR                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | METADATA |
|-------------------------------+-------------------------------+---------+-----------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+--------------------------------------+-------------------+-------------------+---------------------+-----------------+-------------------+----------+------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+---------------+--------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+----------|
| 2026-02-06 10:11:51.642 +0000 | 2026-02-06 10:11:55.932 +0000 | 42563   | JKOWAL    | [{"level": "ACCOUNT", "tag_database": "SI", "tag_schema": "AGENTS", "tag_name": "cost-center", "tag_value": "engineering"}, {"level": "USER", "tag_database": "FINANCE", "tag_schema": "AGENTS", "tag_name": "cost-center", "tag_value": "engineering"}] | 5caf3de3-86b2-4896-b706-9f2d7629d337 | NULL              | 234               | finance             | 4231            | analytics         | 9234     | agent1     | [{"level": "DATABASE", "tag_database": "SI", "tag_schema": "AGENTS", "tag_name": "cost-center", "tag_value": "finance"}, {"level": "CORTEX_AGENT", "tag_database": "FINANCE", "tag_schema": "AGENTS", "tag_name": "cost-center", "tag_value": "finance"}] | 20.000000000  | 1900   | [{"5caf3de3-86b2-4896-b706-9f2d7629d337": {"cortex_agents": {"modelX": {"input": 100, "cache_read_input": 300, "cache_write_input": 400, "output": 200}}, "start_time": "2026-02-06 10:11:51.642 +0000"}}, {"a98b2946-4a7d-4028-9b19-1dab89fbf6c7": {"cortex_analyst": {"modelY": {"input": 100, "output": 200}, "modelZ": {"input": 100, "output": 200}}, "start_time": "2026-02-06 10:11:52.313 +0000"}}, {"996abb8b-678a-440d-9061-d186b6acc91b": {"cortex_analyst": {"unknown": {"input": 100, "output": 200}}, "start_time": "2026-02-06 10:11:53.112 +0000"}}] | [{"5caf3de3-86b2-4896-b706-9f2d7629d337": {"cortex_agents": {"modelX": {"input": 1, "cache_read_input": 2, "cache_write_input": 3, "output": 4}}, "start_time": "2026-02-06 10:11:51.642 +0000"}}, {"a98b2946-4a7d-4028-9b19-1dab89fbf6c7": {"cortex_analyst": {"modelY": {"input": 1, "output": 4}, "modelZ": {"input": 1, "output": 4}}, "start_time": "2026-02-06 10:11:52.313 +0000"}}, {"996abb8b-678a-440d-9061-d186b6acc91b": {"cortex_analyst": {"unknown": {"input": 0, "output": 0}}, "start_time": "2026-02-06 10:11:53.112 +0000"}}] | {}       |
+-------------------------------+-------------------------------+---------+-----------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+--------------------------------------+-------------------+-------------------+---------------------+-----------------+-------------------+----------+------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+---------------+--------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+----------+