CREATE EXTERNAL AGENT¶

Erstellt ein neues externes Agentenobjekt im aktuellen oder angegebenen Schema. Externe Agenten stehen für generative AI-Anwendungen in Snowflake zur Verwendung mit AI-Beobachtbarkeit. Das externe Agentenobjekt speichert Metadaten zu Anwendungen und Auswertungen (z. B. den Anwendungsnamen, den Versionsnamen oder den Ausführungsnamen) und regelt den Zugriff auf Ablaufverfolgungen und Auswertungsergebnisse.

Bemerkung

Externe Agentenobjekte werden in der Regel automatisch vom TruLens SDK erstellt, wenn Sie eine Anwendung registrieren oder eine Evaluierung ausführen. Im Allgemeinen ist es nicht erforderlich, sie manuell mit SQL zu erstellen. Weitere Informationen dazu finden Sie unter AI-Observability in Snowflake Cortex.

Siehe auch:: ALTER EXTERNAL AGENT, DROP EXTERNAL AGENT, SHOW EXTERNAL AGENTS, DESCRIBE EXTERNAL AGENT

Syntax¶

CREATE [ OR REPLACE ] EXTERNAL AGENT [ IF NOT EXISTS ] <name>
  [ WITH VERSION <version_name> ]
  [ COMMENT = '<comment>' ]

Erforderliche Parameter¶

name

Zeichenfolge, die den Bezeichner (d. h. den Namen) des externen Agenten angibt. Der Wert muss für das Schema, in dem der externe Agent erstellt wird, eindeutig sein.

Darüber hinaus muss der Bezeichner mit einem Buchstaben beginnen und darf keine Leer- oder Sonderzeichen enthalten, es sei denn, die gesamte Bezeichnerzeichenfolge wird in doppelte Anführungszeichen gesetzt (z. B. "My object"). Bei Bezeichnern, die in doppelte Anführungszeichen eingeschlossen sind, ist auch die Groß-/Kleinschreibung zu beachten.

Weitere Informationen dazu finden Sie unter Anforderungen an Bezeichner.

Optionale Parameter¶

WITH VERSION version_name: Gibt den Namen der ersten Version an, die für den externen Agenten erstellt werden soll. Versionen repräsentieren verschiedene Implementierungen der Anwendung, z. B. verschiedene Abrufe, Eingabeaufforderungen, LLMs oder Inferenzkonfigurationen.
COMMENT = comment: Zeichenfolge, die eine Beschreibung für den externen Agenten angibt.

Anforderungen an die Zugriffssteuerung¶

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


Berechtigung	Objekt	Anmerkungen
CREATE EXTERNAL AGENT	Schema	Erforderlich, um den externen Agenten in einem Schema zu erstellen.

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.

Nutzungshinweise¶

Die Klauseln OR REPLACE und IF NOT EXISTS schließen sich gegenseitig aus. Sie können nicht beide in der gleichen Anweisung verwendet werden.
CREATE OR REPLACE <Objekt>-Anweisungen sind atomar. Das heißt, wenn ein Objekt ersetzt wird, erfolgt das Löschen des alten Objekts und das Erstellen des neuen Objekts in einer einzigen Transaktion.

Externe Agentenobjekte teilen sich einen Namespace mit Modell-Objekten. Sie können keinen externen Agenten mit demselben Namen wie ein bestehendes Modell im selben Schema erstellen und umgekehrt. Wenn es zu einem Namenskonflikt kommt, müssen Sie das widersprüchliche Objekt umbenennen oder löschen.
Das TruLens SDK erstellt automatisch externe Agentenobjekte, wenn Sie TruApp() (oder die Framework-spezifischen Wrapper TruChain, TruGraph, TruLlama) aufrufen, um eine Anwendung für AI-Beobachtbarkeit zu registrieren. Durch das Ausführen einer Evaluierung kann auch ein externer Agent erstellt werden, wenn für den angegebenen Anwendungsnamen noch kein Agent vorhanden ist.
Metadaten:

Achtung

Kunden müssen sicherstellen, dass bei der Nutzung des Snowflake-Dienstes keine personenbezogenen Daten (außer für ein Objekt „User“), sensible Daten, exportkontrollierte Daten oder andere regulierte Daten als Metadaten eingegeben werden. Weitere Informationen dazu finden Sie unter Metadatenfelder in Snowflake.

Beispiele¶

Erstellen eines externen Agenten

CREATE EXTERNAL AGENT my_rag_app;

Erstellen eines externen Agenten mit einer Startversion:

CREATE EXTERNAL AGENT my_rag_app WITH VERSION "v1";

Erstellen eines externen Agenten nur, wenn er noch nicht existiert:

CREATE EXTERNAL AGENT IF NOT EXISTS my_rag_app WITH VERSION "v1";

Ersetzen eines vorhandenen externen Agenten:

CREATE OR REPLACE EXTERNAL AGENT my_rag_app WITH VERSION "v2";