Kategorien:

Zeichenfolgen- und Binärfunktionen (AI-Funktionen)

AI_COMPLETE (Einzelnes Bild)

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) für eine Texteingabeaufforderung unter Verwendung eines unterstützten Sprachmodells. Diese Variante der Funktion erweitert AI_COMPLETE mit Funktionen zum Verständnis von Dokumenten. Die Eingabeaufforderung kann auf Informationen oder Bilder verweisen, die in einer Datei gefunden werden, die ein Dokument enthält. Die Funktion unterstützt eine einzige Dokumenteingabe.

Syntax

Die Funktion hat zwei erforderliche Argumente und vier optionale Argumente. Die Funktion kann entweder mit der positionsbezogenen Syntax oder mit der Syntax benannter Argumente verwendet werden.

Verwenden von AI_COMPLETE mit einer einzigen Bildeingabe:

AI_COMPLETE(
    <model>, <predicate>, <file> [, <model_parameters> ] )

Argumente

model

Zeichenfolge, die das zu verwendende Modell angibt. Geben Sie eines der folgenden Modelle an:

  • claude-4-opus

  • claude-4-sonnet

  • claude-3-7-sonnet

  • claude-3-5-sonnet

  • llama4-maverick

  • llama4-scout

  • openai-o4-mini

  • openai-gpt-4.1

  • pixtral-large

Unterstützte Modelle können unterschiedliche Kosten haben.

predicate

Eine String-Eingabeaufforderung.

file

Ein FILE-Typobjekt, das ein Image repräsentiert.

model_parameters

Ein Objekt, das null oder mehr der folgenden Optionen enthält, die die Hyperparameter des Modells beeinflussen. Siehe LLM-Einstellungen.

  • temperature: Ein Wert von 0 bis 1 (einschließlich), der die Zufälligkeit der Ausgabe des Sprachmodells steuert. Eine höhere Modelltemperatur (z. B. 0,7) führt zu einer vielfältigeren und zufälligeren Ausgabe, während eine niedrigere Modelltemperatur (z. B. 0,2) die Ausgabe deterministischer und konzentrierter macht.

    Standardeinstellung: 0

  • top_p: Ein Wert von 0 bis 1 (einschließlich), der die Zufälligkeit und Diversität des Sprachmodells steuert und im Allgemeinen als Alternative zu temperature verwendet wird. Der Unterschied besteht darin, dass top_p die Menge der möglichen Token, die das Modell ausgibt, einschränkt, während temperature beeinflusst, welche Token bei jedem Schritt ausgewählt werden.

    Standardeinstellung: 0

  • max_tokens: Legt die maximale Anzahl der Ausgabe-Token in der Antwort fest. Kleine Werte können zu abgeschnittenen Antworten führen.

    Standardwert: 4.096 Maximal zulässiger Wert: 8.192

  • guardrails: Filtert potenziell unsichere und schädliche Antworten aus einem Sprachmodell unter Verwendung von Cortex Guard. Entweder TRUE oder FALSE. Der Standardwert ist FALSE.

Rückgabewerte

Gibt die Zeichenfolgenantwort des Sprachmodells zurück.

Beispiele

Die folgenden Beispiele demonstrieren die grundlegenden Möglichkeiten der Funktion COMPLETE mit Bildern.

Visuelle Beantwortung von Fragen

Ein Diagramm der Inflationsraten wird verwendet, um eine Frage zu den Daten zu beantworten.

Diagramm der Inflationsraten im Jahr 2023 mit Schätzungen für 2024

Vergleich zwischen den Inflationsraten im Jahr 2023 und 2024 (Statista))

SELECT AI_COMPLETE('claude-3-5-sonnet',
    'Which country will observe the largest inflation change in 2024 compared to 2023?',
    TO_FILE('@myimages', 'highest-inflation.png'));

Antwort:

Looking at the data, Venezuela will experience the largest change in inflation rates between 2023 and 2024.
The inflation rate in Venezuela is projected to decrease significantly from 337.46% in 2023 to 99.98% in 2024,
representing a reduction of approximately 237.48 percentage points. This is the most dramatic change among
all countries shown in the chart, even though Zimbabwe has higher absolute inflation rates.

Extraktion von Entitäten aus einem Bild

Dieses Beispiel extrahiert die Entitäten (Objekte) aus einem Bild und gibt die Ergebnisse im JSON-Format zurück.

Foto einer Küche nach der Umgestaltung 
SELECT AI_COMPLETE('claude-3-5-sonnet',
    'Extract the kitchen appliances identified in this image. Respond in JSON only with the identified appliances.',
    TO_FILE('@myimages', 'kitchen.png'));

Antwort:

{
    "appliances": [ "microwave","electric stove","oven","refrigerator" ]
}

Nutzungshinweise für die Bildverarbeitung

  • Es werden nur Text und Bilder unterstützt. Video- und Audiodateien werden nicht unterstützt.

  • Unterstützte Bildformate:

    • .jpg

    • .jpeg

    • .png

    • .gif

    • .webp

    • pixtral- und llama4-Modelle unterstützen auch .bmp.

  • Die maximale Bildgröße beträgt 10 MB für die meisten Modelle und 3,75 MB für claude-Modelle. claude-Modelle unterstützen keine Bilder mit Auflösungen über 8000 x 8000.

  • Für den Stagingbereich, der die Bilder enthält, muss die serverseitige Verschlüsselung aktiviert sein. Clientseitig verschlüsselte Stagingbereiche werden nicht unterstützt.

  • Die Funktion unterstützt keine benutzerdefinierten Netzwerkrichtlinien.

  • Bei Stagingbereichen wird die Groß-/Kleinschreibung nicht beachtet, bei Pfaden die Groß-/Kleinschreibung.