Referenz

Diese Seite enthält Referenzinformationen zur Verwendung von Snowflake Intelligence. Es werden die folgenden Konzepte behandelt:

  • REST API-Endpunkte undSQL-Befehle zum Erstellen, Verwalten und Interagieren mit Cortex Agents

  • Die unterstützten AI-Modelle und deren regionale Verfügbarkeit

  • Rechtliche Hinweise zur Verwendung von Modellen und zur Klassifizierung von Daten

SQL-Befehle und API-Referenz

Snowflake bietet die folgenden programmgesteuerten Methoden zur Erstellung und Interaktion mit Cortex Agents zur Verwendung mit Snowflake Intelligence:

Cortex Agent-Objekt REST API

Die Cortex Agent-Objekt RESTAPI bietet einen umfassenden Satz von Endpunkten für die Erstellung vonAI-gestützten Anwendungen, die in Snowflake Intelligence integriert sind. Sie können die REST API verwenden, um Agentenobjekte zu verwalten und Interaktionen mit Ihren Daten zu orchestrieren.

Vorgänge zur Agentenverwaltung

Die Agentenobjekt REST API unterstützt die folgenden Vorgänge zur Verwaltung von Cortex Agent-Objekten:

Operation

Endpunkt

Beschreibung

Erstellen

POST /api/v2/databases/{database}/schemas/{schema}/agents

Erstellt einen neuen Cortex Agent mit den angegebenen Attributen und angegebener Tool-Konfiguration.

Beschreiben

GET /api/v2/databases/{database}/schemas/{schema}/agents/{name}

Ruft die Konfiguration und die Metadaten für einen vorhandenen Agenten ab.

Update

PUT /api/v2/databases/{database}/schemas/{schema}/agents/{name}

Ändert die Konfiguration, die Tools oder die Anweisungen eines vorhandenen Agenten.

List

GET /api/v2/databases/{database}/schemas/{schema}/agents

Listet alle Agenten in einer bestimmten Datenbank und einem bestimmten Schema mit Filteroptionen auf.

Delete

DELETE /api/v2/databases/{database}/schemas/{schema}/agents/{name}

Entfernt einen Agenten aus Ihrem Konto.

Detaillierte API-Spezifikationen einschließlich Anforderungsparameter, Antwortschemas und Beispiele finden Sie unter Cortex Agents REST API.

Agenten-SQL-Befehle

Snowflake bietet SQL-Befehle zur Erstellung und Verwaltung von Cortex Agent-Objekten für die Verwendung mit Snowflake Intelligence.

Befehle zur Verwaltung von Agenten

Die folgenden SQL-Befehle sind für die Verwaltung von Cortex Agents verfügbar:

Befehl

Beschreibung

CREATE AGENT

Erstellt einen neuen Cortex Agent oder ersetzt einen bestehenden durch angegebene Attribute, Profileinstellungen und eine YAML-Spezifikation.

DESCRIBE AGENT

Ruft die vollständige Konfiguration, Spezifikation und Metadaten für einen vorhandenen Agenten ab.

SHOW AGENTS

Listet alle Cortex Agents auf, für die Sie Zugriffsrechte haben, mit Filter- und Paginierungsoptionen.

DROP AGENT

Entfernt einen Agenten aus dem aktuellen oder angegebenen Schema.

Detaillierte Informationen zu SQL-Syntax, -Parametern und Beispiele finden Sie unter Cortex Agent-Befehle.

Unterstützte Modelle und Regionen

Snowflake Intelligence unterstützt die in Modelle aufgeführten Modelle. Sie können diese Modelle verwenden, solange das Konto Zugriff auf diese hat. Weitere Informationen dazu finden Sie unter Zugriff auf das Modell kontrollieren.

Wenn Sie einen Agenten erstellen, empfehlen wir die Auswahl von Auto für das Modell. Mit dieser Option wählt Snowflake Intelligence automatisch das beste Modell für Ihr Konto aus, und verbessert sich automatisch, sobald neue Modelle verfügbar sind.

Die aufgeführten Modelle sind zwar möglicherweise nicht in allen Regionen verfügbar, Sie können Snowflake Intelligence jedoch in jeder Cloud oder Region im Rahmen der regionenübergreifenden Inferenz von Cortex verwenden. Dazu gehören Clouds und Regionen, in denen die Modelle nicht verfügbar sind. Weitere Informationen zur Konfiguration der regionenübergreifenden Inferenz von Cortex finden Sie unter Regionenübergreifende Inferenz.

  • AWS US – In AWS bieten Versionen ab Claude 4 die höchste Qualität und die beste Geschwindigkeitsleistung. Wir empfehlen Ihnen, die regionsübergreifende Inferenz von Cortex für aws_us einzurichten, um Claude 4 zu verwenden und die beste Leistung zu erzielen. Ohne die regionenübergreifende Inferenz von Cortex sind Sie auf die Verwendung von Claude 3.5 in aws_us beschränkt.

  • Azure US – Wenn Sie Snowflake Intelligence in East US verwenden, können Sie GPT 4.1 und höher ohne die regionenübergreifende Inferenz von Cortex verwenden. Andere Kombinationen von Regionen und Modellen erfordern die Einrichtung der regionenübergreifenden Inferenz von Cortex für azure_us.

  • AWS EU – Sie können Claude 4 und höher in dieser Region verwenden, solange Sie die regionenübergreifende Inferenz von Cortex für aws_eu konfigurieren.

  • AWS APJ – Sie können Claude 4 und höher in dieser Region verwenden, solange Sie die regionenübergreifende Inferenz von Cortex für aws_apj konfigurieren.