Freigeben von Cortex Agenten

Als Anbietender können Sie einen bestehenden Cortex Agenten für andere Organisationen auf Snowflake freigeben, sodass Sie die Benutzerbasis Ihres Agenten erweitern und seinen Wert auch anderen Snowflake-Kunden zur Verfügung stellen können. Sie können Ihre Cortex Agenten entweder auf dem Snowflake Marketplace oder für angegebene Konten freigeben. Weitere Informationen zu Anbietenden auf dem Snowflake Marketplace finden Sie unter Freigabeangebote als Anbieter verwenden.

Als Verbrauchender eines freigegebenen Cortex Agent erhalten Sie Zugriff auf eine einfach zu bedienende Oberfläche, um Erkenntnisse aus freigegebenen strukturierten oder unstrukturierten Daten zu erhalten. Weitere Informationen zum Verbrauch von Cortex Agenten finden Sie unter Freigabeangebote als Verbraucher verwenden und Verwenden und verwalten Sie Snowflake Native Apps als Verbraucher.

Anforderungen

Das Freigeben eines Cortex Agenten erfordert Folgendes:

  • Freigeben aller verknüpften Objekte wie semantische Ansichten oder Cortex Search Services. Weitere Informationen dazu finden Sie unter Freigaben erstellen und konfigurieren und Freigeben von semantischen Ansichten.

  • Freigegebene verknüpfte Objekte müssen sich in derselben Datenbank befinden wie Ihr freigegebener Cortex Agent.

  • Es können nur Agenten freigegeben werden, die die folgenden Tooltypen verwenden: semantische Ansichten, Cortex Search Services und Funktionen. Agenten, die andere Tooltypen verwenden, wie z. B. Prozeduren, Fähigkeiten oder MCP-Konnektoren, können nicht freigegeben werden.

Festlegen eines Cortex Agenten als freigegeben

Sie können Ihre Cortex Agenten als Anbietender auf dem Snowflake Marketplace über Provider Studio freigeben.

Sie können einen Agenten auch als für eine SQL-Anweisung freigegeben festlegen. Das folgende Beispiel fügt den Agenten my_agent zur Freigabe``my_share`` hinzu:

GRANT USAGE ON AGENT my_agent TO SHARE my_share;

Wenn Ihr Agent verknüpfte Objekte wie semantische Ansichten, Cortex Search Services oder Funktionen verwendet, müssen Sie diese Objekte ebenfalls der Freigabe zuweisen:

GRANT USAGE ON AGENT my_agent TO SHARE my_share;
GRANT SELECT, REFERENCES ON SEMANTIC VIEW my_sv TO SHARE my_share;
GRANT USAGE ON CORTEX SEARCH SERVICE my_css TO SHARE my_share;
GRANT USAGE ON FUNCTION my_function TO SHARE my_share;

Wenn Sie einen Agenten zu einer bestehenden Freigabe hinzufügen, erhält die verbrauchende Person, die die Freigabe installiert hat, eine E-Mail-Benachrichtigung, in der sie aufgefordert wird, den Agenten zu testen.

Identifizieren freigegebener Agenten in Snowsight

Wählen Sie im Navigationsmenü die Option AI & ML » Agents aus. Die Spalte Source zeigt an, ob jeder Agent Local oder Shared ist. Verwenden Sie diese Spalte, um schnell zwischen Agenten, die in Ihrem Konto erstellt wurden, und Agenten zu unterscheiden, die von einem anderen Konto aus für Sie freigegeben wurden.

Verbrauchen eines freigegebenen Cortex Agents

Wenn Sie ein Freigabeangebot erhalten, das einen freigegebenen Cortex Agenten enthält, können Sie den Agenten zu Snowflake Intelligence hinzufügen. Um dies zu tun, lassen Sie beim Abrufen des Freigabeangebots den Schalter Add to Snowflake Intelligence aktiviert. Damit steht der freigegebene Agent als Datenquelle innerhalb von Snowflake Intelligence zur Verfügung.

Der Schalter „Add to Snowflake Intelligence“ ist aktiviert, wenn ein Freigabeangebot abgerufen wird.

Warehouse-Auswahl

Standardmäßig wird ein freigegebener Agent mit Ihrem Standard-Warehouse ausgeführt. Sie können ein kundenspezifisches Warehouse für die Ausführung von Abfragen und Tools angeben, um Computeressourcen und -kosten zu kontrollieren.

So konfigurieren Sie ein kundenspezifisches Warehouse für einen freigegebenen Agenten:

  1. Melden Sie sich bei Snowsight an.

  2. Wählen Sie im Navigationsmenü die Option AI & ML » Agents aus.

  3. Wählen Sie einen freigegebenen Agenten aus. Sie können freigegebene Agenten anhand der Spalte Source identifizieren.

  4. Wählen Sie Menü „More options“ (…) ‣ Configure warehouses for tools

  5. Wählen Sie Custom und ein Warehouse und dann Save aus.

Nachdem Sie ein kundenspezifisches Warehouse konfiguriert haben, verwendet der freigegebene Agent das angegebene Warehouse, um Abfragen zu durchführen und Tools auszuführen.

Replikation

Freigegebene Cortex Agenten unterstützen die Replikation. Bei der automatischen Ausführung von Freigabeangeboten werden Agenten in andere Regionen repliziert, sodass Verbrauchende in anderen Regionen auf den gemeinsamen Agenten zugreifen können.

Einschränkungen

Die folgenden Beschränkungen gelten für freigegebene Cortex Agenten:

  • Eine SQL-Tabellenfunktion kann freigegeben werden, eine benutzerdefinierte Python-Tabellenfunktion jedoch nicht.

  • Wenn Sie einen freigegebenen Agenten aktualisieren, um neue Tools zu nutzen (z. B. semantische Ansichten, Cortex Search Services oder Funktionen), müssen Sie diese neuen Tools ebenfalls der Freigabe zuweisen. Neue Tools werden nicht automatisch hinzugefügt.

Hinweise zu Kosten

Zusätzlich zu den Kosten, die dem Anbietenden des freigegebenen Cortex Agenten gezahlt werden müssen, wird den Verbrauchenden Folgendes in Rechnung gestellt:

  • Eingabe- und Ausgabe-Token, die vom Aufruf des freigegebenen Agenten durch den Verbrauchenden verwendet werden.

  • Nutzung des Warehouses des Verbrauchenden für die Ausführung von SQL-Abfragen und Tools.

Weitere Informationen zu den Kosten, die an Anbietende gezahlt werden müssen, finden Sie unter Für Freigabeangebote bezahlen. Weitere Informationen zu den Snowflake-Kosten finden Sie in der ` Snowflake Service Consumption Table`_.