Schema:

ACCOUNT_USAGE

Ansicht CORTEX_AGENT_USAGE_HISTORY

Die Ansicht CORTEX_AGENT_USAGE_HISTORY kann verwendet werden, um den Nutzungsverlauf von Cortex Agents abzufragen.

Bemerkung

Diese Ansicht enthält keine Anforderungen, die von Snowflake Intelligence stammen. Anforderungen, die von Snowflake Intelligence stammen, werden in der SNOWFLAKE_INTELLIGENCE_USAGE_HISTORY-Ansicht erfasst.

Die in der Ansicht enthaltenen Informationen umfassen die Anzahl der Credits, die bei jeder Benutzerinteraktion mit Cortex Agents verbraucht werden. Eine Anforderung führt zu einem oder mehreren Aufrufen der zugrunde liegenden Tools, z. B. Cortex Analyst und Cortex Search. Jede Zeile in der Ansicht stellt einen Aufruf an den Agenten dar und enthält Details zu den aggregierten Token und Credits des Aufrufs sowie detaillierte Details. Die Ansicht enthält auch relevante Metadaten, wie z. B. die Benutzer-ID, Anforderungs-ID und Agenten-ID. Weitere Informationen zur Cortex-Abrechnung finden Sie unter Hinweise zu Kosten.

Spalten

Spaltenname

Datentyp

Beschreibung

START_TIME

TIMESTAMP_LTZ

Startzeit, zu der die Cortex Agent-Nachrichtenanforderung empfangen wurde.

END_TIME

TIMESTAMP_LTZ

Endzeit, zu der die Cortex Agent-Nachrichtenantwort gesendet wurde.

USER_ID

NUMBER

Der eindeutige Bezeichner des Benutzenden, der die Anforderung gestellt hat.

USER_NAME

VARCHAR

Der Name des Benutzenden, der die Anforderung gestellt hat.

USER_TAGS

ARRAY

Tags, die dem Benutzenden zugeordnet sind. Jedes Objekt im Array enthält die folgenden Wert-Paare:

  • level: Die Ebene, auf der das Tag angewendet wird (z. B. „ACCOUNT“ oder „USER“).

  • tag_database: Die Datenbank, in der das Tag definiert ist.

  • tag_schema: Das Schema, in dem das Tag definiert ist.

  • tag_name: Der Name des Tags.

  • tag_value: Der Wert des Tags.

REQUEST_ID

VARCHAR

Der eindeutige Bezeichner der Anforderung.

PARENT_REQUEST_ID

VARCHAR

Der Bezeichner der übergeordneten Anforderung, falls zutreffend.

AGENT_DATABASE_ID

NUMBER

Der eindeutige Bezeichner der Agentendatenbank.

AGENT_DATABASE_NAME

VARCHAR

Der Name der Agentendatenbank.

AGENT_SCHEMA_ID

NUMBER

Der eindeutige Bezeichner des Agentenschemas.

AGENT_SCHEMA_NAME

VARCHAR

Der Name des Agentenschemas.

AGENT_ID

NUMBER

Der eindeutige Bezeichner des Agenten.

AGENT_NAME

VARCHAR

Der Name des Agenten.

AGENT_TAGS

ARRAY

Tags, die dem Agenten zugeordnet sind. Jedes Objekt im Array enthält die folgenden Wert-Paare:

  • level: Die Ebene, auf der das Tag angewendet wird (z. B. „DATABASE“ oder „CORTEX_AGENT“).

  • tag_database: Die Datenbank, in der das Tag definiert ist.

  • tag_schema: Das Schema, in dem das Tag definiert ist.

  • tag_name: Der Name des Tags.

  • tag_value: Der Wert des Tags.

TOKEN_CREDITS

NUMBER

Die Anzahl der für die Anforderung verwendeten Token-Credits. Wird für die Budgetierung auf Benutzerebene verwendet.

TOKENS

NUMBER

Summe der vom Cortex Agent verwendeten Token.

TOKENS_GRANULAR

ARRAY

Detaillierte Aufschlüsselung der Token-Nutzung nach Anfrage, Diensttyp (cortex_agents, cortex_analyst) und Modell. Beinhaltet die Zählungen für Eingabe, cache_read_input, cache_write_input und Ausgabe-Token pro Modell. Der „unbekannte“ Modellname wird verwendet, wenn ein Modell nicht in den Preisdaten vorhanden ist. Jedes Objekt im Array enthält die folgenden Wert-Paare:

  • request_id: Der eindeutige Bezeichner der Anforderung.

  • service_type: Der Diensttyp, z. B. „cortex_agents“ oder „cortex_analyst“.

  • model: Der für die Anforderung verwendete Modellname.

  • input: Anzahl der Eingabe-Token.

  • cache_read_input: Anzahl der Eingabe-Token für den Lesecache.

  • cache_write_input: Anzahl der Eingabe-Token für den Schreibcache.

  • output: Anzahl der Ausgabe-Token.

  • start_time: Die Startzeit der Anforderung.

CREDITS_GRANULAR

ARRAY

Detaillierte Aufschlüsselung der Credit-Nutzung nach Anfrage, Diensttyp (cortex_agents, cortex_analyst) und Modell. Beinhaltet die Werte für Eingabe, cache_read_input, cache_write_input und Ausgabe von Credits pro Modell. Der „unbekannte“ Modellname wird verwendet, wenn ein Modell nicht in den Preisdaten vorhanden ist. Jedes Objekt im Array enthält die folgenden Wert-Paare:

  • request_id: Der eindeutige Bezeichner der Anforderung.

  • service_type: Der Diensttyp, z. B. „cortex_agents“ oder „cortex_analyst“.

  • model: Der für die Anforderung verwendete Modellname.

  • input: Credit-Wert für Eingabe-Token.

  • cache_read_input: Credit-Wert für Eingabe-Token im Lesecache.

  • cache_write_input: Credit-Wert für Eingabe-Token im Schreibcache.

  • output: Credit-Wert für Ausgabe-Token.

  • start_time: Die Startzeit der Anforderung.

METADATA

OBJECT

Reserviert für zusätzliche Metadaten. Derzeit leer.

Beispiele

Abrufen des Cortex Agent-Nutzungsverlaufs:

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