Kategorien:: Tabellenfunktionen (Cortex Agents)

GET_AI_OBSERVABILITY_EVENTS (SNOWFLAKE.LOCAL)¶

Rückgabe von AI-Beobachtbarkeitsereignissen von der AI_OBSERVABILITY_EVENTS-Tabelle im Schema LOCAL. Übergeben Sie CORTEX AGENT als agent_type für einen Cortex Agent oder EXTERNAL AGENT für ein externes Agentenobjekt, das mit AI-Beobachtbarkeit verwendet wird (siehe:doc:/sql-reference/commands-external-agent). Jede Zeile verwendet das Spaltenlayout der Ereignistabelle (einschließlich RECORD, RECORD_ATTRIBUTES, VALUE und Ablaufverfolgungsfelder). Ereignisse können Konversationsaktivitäten, Bereiche (Spans) (Planung, Tools, Antwortgenerierung), Protokolle, Benutzerfeedback und andere Telemetriedaten repräsentieren, die für den Agenten oder die Anwendung geschrieben wurden.

Snowsight-Workflows und Beispiele zum Filtern von Ereignissen (einschließlich Feedback) finden Sie unter Cortex Agent-Anfragen überwachen. Informationen, wie AI-Beobachtbarkeit Daten in der Ereignistabelle speichert, finden Sie unter Observability-Daten.

Siehe auch:: GET_AI_OBSERVABILITY_LOGS (SNOWFLAKE.LOCAL), GET_AI_RECORD_TRACE (SNOWFLAKE.LOCAL), GET_AI_EVALUATION_DATA (SNOWFLAKE.LOCAL)

Syntax¶

SNOWFLAKE.LOCAL.GET_AI_OBSERVABILITY_EVENTS( <database>, <schema>, <agent_name>, <agent_type> )

Argumente¶

database: Name der Datenbank, die den Agenten enthält.
schema: Name des Schemas, das den Agenten enthält.
agent_name: Name des Agenten, dessen Beobachtbarkeitsereignisse Sie abrufen möchten.
agent_type: Die Zeichenfolge für den Agententyp. Verwenden Sie CORTEX AGENT für einen Cortex Agent (siehe Cortex Agent-Anfragen überwachen) oder EXTERNAL AGENT für ein externes Agentenobjekt (siehe:doc:/sql-reference/commands-external-agent). Dieser Wert unterscheidet nicht zwischen Groß- und Kleinschreibung.

Rückgabewerte¶

Eine Tabelle mit Beobachtbarkeitsereignissen. Die Spaltendefinitionen folgen dem Schema der Ereignistabelle. Filtern und projizieren Sie mit Standard-SQL (zum Beispiel auf RECORD:name, RECORD_ATTRIBUTES oder Schweregradfelder innerhalb von RECORD), um auf bestimmte Arten von Ereignissen einzuschränken.

Anforderungen an die Zugriffssteuerung¶

Eine Rolle, die zur Ausführung dieser Operation verwendet wird, muss mindestens die folgenden Berechtigungen haben:


Berechtigung	Objekt	Anmerkungen
CORTEX_USER	Datenbankrolle
USAGE	Cortex Agent oder External Agent	Erforderlich für das Objekt, das von `agent_name` identifiziert wird. Für `EXTERNAL AGENT` auf dem External Agent ist USAGE ausreichend, um diese Funktion aufzurufen (MONITOR wird hier nicht angewendet).
MONITOR	Cortex Agent	Erforderlich auf dem Cortex Agent, der durch `agent_name` identifiziert wird, wenn `agent_type` den Wert `CORTEX AGENT` hat. Gilt nicht, wenn `agent_type` `EXTERNAL AGENT` ist.

Für das Ausführen von Operationen für ein Objekt in einem Schema ist mindestens eine Berechtigung für die übergeordnete Datenbank und mindestens eine Berechtigung für das übergeordnete Schema erforderlich.

Eine Anleitung zum Erstellen einer kundenspezifischen Rolle mit einer bestimmten Gruppe von Berechtigungen finden Sie unter Erstellen von kundenspezifischen Rollen.

Allgemeine Informationen zu Rollen und Berechtigungen zur Durchführung von SQL-Aktionen auf sicherungsfähigen Objekten finden Sie unter Übersicht zur Zugriffssteuerung.

Wenn agent_type EXTERNAL AGENT ist, wird nur USAGE in diesem Objekt benötigt, um die Funktion aufzurufen. OWNERSHIP auf dem External Agent ist erforderlich, um das Objekt zu ändern oder mit ALTER EXTERNAL AGENT oder DROP EXTERNAL AGENT zu entfernen.

Für die typische Einrichtung der Cortex Agent-Überwachung (einschließlich Zuweisungen für zukünftige Agenten) siehe Cortex Agent-Anfragen überwachen. Für den Zugriff von External Agents auf Beobachtbarkeitsdaten siehe Observability-Daten.

Beispiele¶

Geben Sie Beobachtbarkeitsereignisse für einen Agenten zurück:

SELECT *
  FROM TABLE(SNOWFLAKE.LOCAL.GET_AI_OBSERVABILITY_EVENTS(
    'my_database',
    'my_schema',
    'my_agent',
    'CORTEX AGENT'
  ));

Um nur Feedback-Ereignisse von Benutzern aufzulisten, filtern Sie nach dem Ereignisnamen (siehe Von Benutzenden bereitgestelltes Feedback anzeigen):

SELECT *
  FROM TABLE(SNOWFLAKE.LOCAL.GET_AI_OBSERVABILITY_EVENTS(
    'my_database',
    'my_schema',
    'my_agent',
    'CORTEX AGENT'
  ))
  WHERE RECORD:name = 'CORTEX_AGENT_FEEDBACK';

Die gleiche Funktion funktioniert für eine extern instrumentierte Anwendung mit Übergabe von EXTERNAL AGENT als agent_type und dem Objektnamen des externen Agenten in agent_name (siehe Observability-Daten).