Kategorien:

Zeichenfolgen- und Binärfunktionen (AI-Funktionen), Dateifunktionen (AI-Funktionen)

AI_COMPLETE

Bemerkung

AI_COMPLETE ist die aktualisierte Version von COMPLETE (SNOWFLAKE.CORTEX). Die neueste Funktionalität finden Sie unter AI_COMPLETE.

Generiert eine Antwort (Vervollständigung) aus Text oder einem Bild unter Verwendung eines unterstützten Sprachmodells. Sie können Folgendes bereitstellen:

  • Einen Text-Prompt, um eine Antwort des Modells zu erzeugen. Weitere Informationen dazu finden Sie unter AI_COMPLETE (Einzelne Zeichenfolge).

  • Ein einzelnes Bild und einen Text-Prompt, um eine Antwort auf der Grundlage des Bildes und des Prompts zu erzeugen. Weitere Informationen dazu finden Sie unter AI_COMPLETE (Einzelnes Bild).

  • Ein Prompt-Objekt, das mehrere Bilder und Text unterstützen kann. Weitere Informationen dazu finden Sie unter AI_COMPLETE (Prompt-Objekt).

Syntax

Die Syntax für die Funktion hängt von der Art der Eingabe ab, die Sie bereitstellen. Informationen zur Syntax finden Sie in den folgenden Abschnitten:

Alle Syntaxvarianten akzeptieren das optionale BOOLEAN-Argument return_error_details als endgültigen Parameter. Wenn sie auf TRUE gesetzt ist, gibt die Funktion ein OBJECT zurück, das den Wert und die Fehlermeldung enthält. Je nachdem, ob die Funktion erfolgreich war oder fehlgeschlagen ist, ist einer dieser beiden NULL. Siehe Fehlerverhalten für Details.

Fehlerverhalten

Wenn AI_COMPLETE die Eingabe nicht verarbeiten kann, gibt die Funktion standardmäßig NULL zurück. Wenn die Abfrage mehrere Zeilen verarbeitet, geben Zeilen mit Fehlern NULL zurück, verhindern aber nicht, dass die Abfrage abgeschlossen wird.

Der Rückgabewert hängt bei einem Fehler vom return_error_details-Argument ab. Die folgende Tabelle zeigt den Rückgabewert in Abhängigkeit von dem return_error_details-Argument:

return_error_details

Rückgabewert

Beschreibung
FALSE

Nicht übergeben

NULL

TRUE

OBJECT mit value- und error-Feldern
value: Die Vervollständigungsantwort (gleicher Typ wie der normale Rückgabewert) oderNULL, wenn ein Fehler aufgetreten ist.

error: Ein VARCHAR -Wert, der bei Auftreten eines Fehlers die Fehlermeldung enthält, oder NULL, wenn die Funktion erfolgreich war.

Weitere Informationen zur Fehlerbehandlung für AI-Funktionen finden Sie unter Snowflake Cortex AI Function: Multirow error handling improvements.

Anforderungen an die Zugriffssteuerung

Benutzer müssen eine Rolle verwenden, der die Datenbankrolle SNOWFLAKE.CORTEX_USER zugewiesen wurde: Weitere Informationen zu dieser Berechtigung finden Sie unter Cortex LLM-Berechtigungen.