Kategorien:: Tabellenfunktionen (Cortex Agents)

GET_AI_OBSERVABILITY_LOGS (SNOWFLAKE.LOCAL)¶

Ruft Protokolldaten zu einem AI-Beobachtbarkeitsereignis ab, wie z. B. eine Warnung oder ein Fehler, für einen Cortex Agent oder eine externe Agenten-Anwendung (siehe Befehle für externe Agenten).

Rufen Sie diese Funktion auf, um Informationen darüber abzurufen, welche Ereignisse während eines Evaluierungslaufs aufgetreten sind. Weitere Informationen dazu finden Sie unter Cortex Agent-Evaluierungen und Observability-Daten.

Siehe auch:: GET_AI_OBSERVABILITY_EVENTS (SNOWFLAKE.LOCAL) , GET_AI_RECORD_TRACE (SNOWFLAKE.LOCAL) , GET_AI_EVALUATION_DATA (SNOWFLAKE.LOCAL) , EXECUTE_AI_EVALUATION

Syntax¶

SNOWFLAKE.LOCAL.GET_AI_OBSERVABILITY_LOGS( <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, für den ein Datensatz abgerufen werden soll.
agent_type: Die Zeichenfolge für den Agententyp. Verwenden Sie CORTEX AGENT für eine Cortex Agent-Bewertung oder EXTERNAL AGENT für ein externes -Agentenobjekt (siehe Befehle für externe Agenten). Dieser Wert unterscheidet nicht zwischen Groß- und Kleinschreibung.

Rückgabewerte¶

Weitere Informationen zu den in enthaltenen Informationen finden Sie unter AI-Beobachtbarkeitsereignisse, siehe:ref:label-ai_observability_data.

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

Die vollständigen Berechtigungen für die Zugangssteuerung, die für Cortex Agent-Evaluierungen erforderlich sind, finden Sie unter Cortex Agent-Evaluierungen – Anforderungen für Zugangssteuerung. Informationen zu External Agent-Objekten finden Sie unter Observability-Daten.

Beispiele¶

Im folgenden Beispiel wird auf Fehler und Warnungen für eine Ausführung namens run-1 geprüft, wo der Agent evaluated_agent heißt und im Schema eval_db.eval_schema gespeichert ist:

SELECT * FROM TABLE(SNOWFLAKE.LOCAL.GET_AI_OBSERVABILITY_LOGS(
  'eval_db',
  'eval_schema',
  'evaluated_agent',
  'CORTEX AGENT')
)
  WHERE TRUE
    AND (record:"severity_text"='ERROR' or record:"severity_text"='WARN')
    AND record_attributes:"snow.ai.observability.run.name"='run-1';