スキーマ：: ACCOUNT_USAGE

CORTEX_AGENT_USAGE_HISTORY ビュー¶

CORTEX_AGENT_USAGE_HISTORYビューを使用して、Cortex Agentsの使用履歴をクエリできます。

注釈

このビューには、|sf-intelligence|から発信されたリクエストは含まれません。|sf-intelligence|から発信されたリクエストは、:doc:`SNOWFLAKE_INTELLIGENCE_USAGE_HISTORY </sql-reference/account-usage/snowflake_intelligence_usage_history_view>`ビューに記録されます。

ビュー内の情報には、ユーザーがCortex Agentとやり取りするたびに消費されるクレジット数が含まれます。1つのリクエストに対して、背後で動作するツール（例：Cortex AnalystやCortex Search）が、1回または複数回呼び出されます。ビューの各行はエージェントへの呼び出しを表し、呼び出しで集計されたトークンとクレジットの詳細、および詳細な詳細が表示されます。ビューには、ユーザーID、リクエストID、エージェントIDなどの関連するメタデータも含まれます。Cortexの請求について詳しくは、:ref:`label-cortex_agent_cost_considerations`を参照してください。

列¶

列名	データ型	説明
START_TIME	TIMESTAMP_LTZ	Cortex Agentメッセージリクエストを受信した開始時間。
END_TIME	TIMESTAMP_LTZ	Cortex Agentメッセージ応答が送信された終了時刻。
USER_ID	NUMBER	リクエストを行ったユーザーの一意の識別子。
USER_NAME	VARCHAR	リクエストを行ったユーザーの名前。
USER_TAGS	ARRAY	ユーザーに関連付けられたタグ。配列の各オブジェクトには、次の値のペアが含まれます。 `level`:タグの適用対象のレベル（例えば、"ACCOUNT"または"USER"）。 `tag_database`:タグの定義先のデータベース。 `tag_schema`:タグの定義先のスキーマ。 `tag_name`:タグの名前。 `tag_value`:タグの値。
REQUEST_ID	VARCHAR	リクエストに対する一意の識別子。
PARENT_REQUEST_ID	VARCHAR	該当する場合は、親リクエストの識別子。
AGENT_DATABASE_ID	NUMBER	エージェントデータベースの一意の識別子。
AGENT_DATABASE_NAME	VARCHAR	エージェントデータベースの名前。
AGENT_SCHEMA_ID	NUMBER	エージェントスキーマの一意の識別子。
AGENT_SCHEMA_NAME	VARCHAR	エージェントスキーマの名前。
AGENT_ID	NUMBER	エージェントの一意の識別子。
AGENT_NAME	VARCHAR	エージェントの名前。
AGENT_TAGS	ARRAY	エージェントに関連付けられたタグ。配列の各オブジェクトには、次の値のペアが含まれます。 `level`:タグの適用対象のレベル（例えば、"DATABASE"または"CORTEX_AGENT"）。 `tag_database`:タグの定義先のデータベース。 `tag_schema`:タグの定義先のスキーマ。 `tag_name`:タグの名前。 `tag_value`:タグの値。
TOKEN_CREDITS	NUMBER	リクエストに使用されたトークンクレジットの数。ユーザーレベルの予算に使用されます。
TOKENS	NUMBER	Cortex Agentの使用トークン合計。
TOKENS_GRANULAR	ARRAY	リクエスト、サービスタイプ（cortex_agents、cortex_analyst）、モデルごとのトークン使用量の詳細な内訳。モデルごとに、入力（input）、キャッシュ読み取り入力（cache_read_input）、キャッシュ書き込み入力（cache_write_input）、および出力（output）のトークン数が含まれます。価格データにモデルが存在しない場合は、「unknown」というモデル名が使用されます。配列の各オブジェクトには、次の値のペアが含まれます。 `request_id`:リクエストに対する一意の識別子。 `service_type`:「cortex_agents」や「cortex_analyst」など、サービスの種類。 `model`:リクエストに使用されたモデル名。 `input`:入力トークンの数。 `cache_read_input`:キャッシュ読み取り入力トークンの数。 `cache_write_input`:キャッシュ書き込み入力トークンの数。 `output`:出力トークンの数。 `start_time`:リクエストの開始時刻。
CREDITS_GRANULAR	ARRAY	リクエスト、サービスタイプ（cortex_agents、cortex_analyst）、モデルごとのクレジット使用量の詳細な内訳。モデルごとに、入力（input）、キャッシュ読み取り入力（cache_read_input）、キャッシュ書き込み入力（cache_write_input）、および出力（output）のクレジット消費量が含まれます。価格データにモデルが存在しない場合は、「unknown」というモデル名が使用されます。配列の各オブジェクトには、次の値のペアが含まれます。 `request_id`:リクエストに対する一意の識別子。 `service_type`:「cortex_agents」や「cortex_analyst」など、サービスの種類。 `model`:リクエストに使用されたモデル名。 `input`:入力トークンのクレジット消費量。 `cache_read_input`:キャッシュ読み取り入力トークンのクレジット消費量。 `cache_write_input`:キャッシュ書き込み入力トークンのクレジット消費量。 `output`:出力トークンのクレジット消費量。 `start_time`:リクエストの開始時刻。
METADATA	OBJECT	追加のメタデータ用に予約されています。現在は空です。

例¶

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"}}] | {}       |
+-------------------------------+-------------------------------+---------+-----------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+--------------------------------------+-------------------+-------------------+---------------------+-----------------+-------------------+----------+------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+---------------+--------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+----------+