Esquema:

ACCOUNT_USAGE

Exibição CORTEX_AGENT_USAGE_HISTORY

A exibição CORTEX_AGENT_USAGE_HISTORY pode ser utilizada para consultar o histórico de uso dos Cortex Agents.

Nota

Essa exibição não inclui solicitações originadas do Snowflake Intelligence. As solicitações originadas do Snowflake Intelligence são registradas na exibição SNOWFLAKE_INTELLIGENCE_USAGE_HISTORY.

As informações na exibição incluem o número de créditos consumidos cada vez que um usuário interage com os Cortex Agents. Uma solicitação resulta em uma ou mais chamadas para ferramentas subjacentes, por exemplo, Cortex Analyst e Cortex Search. Cada linha na exibição representa uma chamada para o agente e fornece detalhes sobre os tokens e créditos agregados na chamada, bem como detalhes granulares. A exibição também inclui metadados relevantes, como o ID do usuário, da solicitação e do agente. Para obter mais informações sobre o faturamento do Cortex, consulte Considerações sobre custo.

Colunas

Nome da coluna

Tipo de dados

Descrição

START_TIME

TIMESTAMP_LTZ

Hora de início em que a solicitação de mensagem do Cortex Agent foi recebida.

END_TIME

TIMESTAMP_LTZ

Hora de término em que a resposta da mensagem do Cortex Agent foi enviada.

USER_ID

NUMBER

O identificador exclusivo do usuário que fez a solicitação.

USER_NAME

VARCHAR

O nome do usuário que fez a solicitação.

USER_TAGS

ARRAY

Tags associadas ao usuário. Cada objeto na matriz contém os seguintes pares de valores:

  • level: O nível em que a tag é aplicada (por exemplo, «ACCOUNT» ou «USER»).

  • tag_database: O banco de dados onde a tag está definida.

  • tag_schema: O esquema onde a tag está definida.

  • tag_name: O nome da tag.

  • tag_value: O valor da tag.

REQUEST_ID

VARCHAR

O identificador único da solicitação.

PARENT_REQUEST_ID

VARCHAR

O identificador da solicitação pai, se aplicável.

AGENT_DATABASE_ID

NUMBER

O identificador exclusivo do banco de dados do agente.

AGENT_DATABASE_NAME

VARCHAR

O nome do banco de dados do agente.

AGENT_SCHEMA_ID

NUMBER

O identificador exclusivo do esquema do agente.

AGENT_SCHEMA_NAME

VARCHAR

O nome do esquema do agente.

AGENT_ID

NUMBER

O identificador exclusivo do agente.

AGENT_NAME

VARCHAR

O nome do agente.

AGENT_TAGS

ARRAY

Tags associadas ao Agent. Cada objeto na matriz contém os seguintes pares de valores:

  • level: O nível em que a tag é aplicada (por exemplo, «DATABASE» ou «CORTEX_AGENT»).

  • tag_database: O banco de dados onde a tag está definida.

  • tag_schema: O esquema onde a tag está definida.

  • tag_name: O nome da tag.

  • tag_value: O valor da tag.

TOKEN_CREDITS

NUMBER

O número de créditos de token utilizados ​​para a solicitação. Utilizado para orçamento em nível de usuário.

TOKENS

NUMBER

Soma dos tokens utilizados ​​pelo Cortex Agent.

TOKENS_GRANULAR

ARRAY

Detalhamento granular do uso de tokens por solicitação, tipo de serviço (cortex_agents, cortex_analyst) e modelo. Inclui contagens de tokens de entrada, cache_read_input, cache_write_input e saída por modelo. O nome do modelo «desconhecido» é utilizado quando um modelo não está presente nos dados de preços. Cada objeto na matriz contém os seguintes pares de valores:

  • request_id: O identificador único da solicitação.

  • service_type: o tipo de serviço, como «cortex_agents» ou «cortex_analyst».

  • model: o nome do modelo utilizado para a solicitação.

  • input: número de tokens de entrada.

  • cache_read_input: número de tokens de entrada de leitura de cache.

  • cache_write_input: número de tokens de entrada de gravação de cache.

  • output: número de tokens de saída.

  • start_time: a hora de início da solicitação.

CREDITS_GRANULAR

ARRAY

Detalhamento granular do uso de créditos por solicitação, tipo de serviço (cortex_agents, cortex_analyst) e modelo. Inclui valores de crédito de entrada, cache_read_input, cache_write_input e saída por modelo. O nome do modelo «desconhecido» é utilizado quando um modelo não está presente nos dados de preços. Cada objeto na matriz contém os seguintes pares de valores:

  • request_id: O identificador único da solicitação.

  • service_type: o tipo de serviço, como «cortex_agents» ou «cortex_analyst».

  • model: o nome do modelo utilizado para a solicitação.

  • input: valor de crédito para tokens de entrada.

  • cache_read_input: valor de crédito para tokens de entrada de leitura de cache.

  • cache_write_input: valor de crédito para tokens de entrada de gravação de cache.

  • output: valor de crédito para tokens de saída.

  • start_time: a hora de início da solicitação.

METADATA

OBJECT

Reservado para metadados adicionais. Atualmente vazio.

Exemplos

Recupere o histórico de uso do 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"}}] | {}       |
+-------------------------------+-------------------------------+---------+-----------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+--------------------------------------+-------------------+-------------------+---------------------+-----------------+-------------------+----------+------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+---------------+--------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+----------+