Esquema:

ACCOUNT_USAGE

Exibição SNOWFLAKE_INTELLIGENCE_USAGE_HISTORY

A exibição SNOWFLAKE_INTELLIGENCE_USAGE_HISTORY pode ser usada para consultar o histórico de uso de Snowflake Intelligence.

Nota

Esta exibição não inclui solicitações originadas de Cortex Agents. As solicitações originadas dos Cortex Agents são registradas na exibição CORTEX_AGENT_USAGE_HISTORY.

As informações na exibição incluem o número de créditos consumidos cada vez que um usuário interage com o Snowflake Intelligence. Uma solicitação resulta em uma ou mais chamadas para agentes subjacentes e quaisquer ferramentas, 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, o ID da solicitação, o ID do Snowflake Intelligence e o ID 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 Snowflake Intelligence foi recebida.

END_TIME

TIMESTAMP_LTZ

Hora de término em que a resposta da mensagem do Snowflake Intelligence 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.

SNOWFLAKE_INTELLIGENCE_ID

NUMBER

O identificador exclusivo da instância do Snowflake Intelligence.

SNOWFLAKE_INTELLIGENCE_NAME

VARCHAR

O nome da instância do Snowflake Intelligence.

SNOWFLAKE_INTELLIGENCE_TAGS

ARRAY

Tags associadas à instância do Snowflake Intelligence. Cada objeto na matriz contém os seguintes pares de valores:

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

  • 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.

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, «SCHEMA» 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 agente Snowflake Intelligent.

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 Snowflake Intelligence:

SELECT *
  FROM SNOWFLAKE.ACCOUNT_USAGE.SNOWFLAKE_INTELLIGENCE_USAGE_HISTORY;
Copy
+-------------------------------+-------------------------------+---------+-----------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+--------------------------------------+-------------------+---------------------------+-----------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------+---------------------+-----------------+-------------------+----------+------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+---------------+--------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+----------+
| START_TIME                    | END_TIME                      | USER_ID | USER_NAME | USER_TAGS                                                                                                                                                                                                                                                | REQUEST_ID                           | PARENT_REQUEST_ID | SNOWFLAKE_INTELLIGENCE_ID | SNOWFLAKE_INTELLIGENCE_NAME | SNOWFLAKE_INTELLIGENCE_TAGS                                                                                                                                                                                                                                        | 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"}] | 9a5bbdce-7427-4166-b839-de8adc81e5cf | NULL              | 123456                    | finance_analytics_si        | [{"level": "ACCOUNT", "tag_database": "SI", "tag_schema": "AGENTS", "tag_name": "cost-center", "tag_value": "finance"}, {"level": "SNOWFLAKE_INTELLIGENCE", "tag_database": "FINANCE", "tag_schema": "AGENTS", "tag_name": "cost-center", "tag_value": "finance"}] | 234               | finance             | 4231            | analytics         | 9234     | agent1     | [{"level": "SCHEMA", "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   | [{"9a5bbdce-7427-4166-b839-de8adc81e5cf": {"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"}}, {"28adaa9a-cbde-4293-bce2-157c807e0dd7": {"cortex_analyst": {"modelY": {"input": 100, "output": 200}, "modelZ": {"input": 100, "output": 200}}, "start_time": "2026-02-06 10:11:52.642 +0000"}}, {"1444950f-6f5b-493f-800c-f62bb307d21c": {"cortex_analyst": {"unknown": {"input": 100, "output": 200}}, "start_time": "2026-02-06 10:11:53.331 +0000"}}] | [{"9a5bbdce-7427-4166-b839-de8adc81e5cf": {"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"}}, {"28adaa9a-cbde-4293-bce2-157c807e0dd7": {"cortex_agent": {"modelY": {"input": 1, "output": 4}, "modelZ": {"input": 1, "output": 4}}, "start_time": "2026-02-06 10:11:52.642 +0000"}}, {"1444950f-6f5b-493f-800c-f62bb307d21c": {"cortex_analyst": {"unknown": {"input": 0, "output": 0}}, "start_time": "2026-02-06 10:11:53.331 +0000"}}] | {}       |
+-------------------------------+-------------------------------+---------+-----------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+--------------------------------------+-------------------+---------------------------+-----------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------+---------------------+-----------------+-------------------+----------+------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+---------------+--------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+----------+