Gemini API für Funktionsaufrufe verwenden


Mithilfe von Funktionsaufrufen können Sie einfacher strukturierte Datenausgaben aus generativen Modellen abrufen. Sie können diese Ausgaben dann verwenden, um andere APIs aufzurufen und die relevanten Antwortdaten an das Modell zurückzugeben. Mit anderen Worten, Funktionsaufrufe helfen generative Modelle mit externen Systemen verbinden, damit die generierten Inhalte aktuelle und korrekte Informationen enthält.

Sie können Gemini-Modellen Funktionsbeschreibungen zur Verfügung stellen. Dies sind Funktionen, die Sie in der Sprache Ihrer App schreiben (d. h. sie sind Cloud Functions. Das Modell kann Sie auffordern, eine Funktion aufzurufen und das Ergebnis, damit das Modell Ihre Abfrage verarbeiten kann.

Sie können Weitere Informationen zu Funktionsaufrufen in der Dokumentation zu Google Cloud.

Hinweis

Falls noch nicht geschehen, füllen Sie das Startleitfaden für die Vertex AI in Firebase SDKs. Prüfen Sie, ob Sie alle folgenden Schritte ausgeführt haben:

  1. Ein neues oder vorhandenes Firebase-Projekt einrichten und das Blaze-Preismodell und Aktivierung der erforderlichen APIs.

  2. Verbinden Sie Ihre App mit Firebase. Dazu müssen Sie Ihre App registrieren und die Firebase-Konfiguration hinzufügen.

  3. Fügen Sie das SDK hinzu und initialisieren Sie den Vertex AI-Dienst und das generative Modell in Ihrer App.

Nachdem Sie Ihre App mit Firebase verbunden, das SDK hinzugefügt und die Vertex AI-Dienst und das generative Modell, können Sie die Gemini API aufrufen.

Funktionsaufruf einrichten

In dieser Anleitung interagiert das Modell mit einer hypothetischen Währungsumtausch-API, die die folgenden Parameter unterstützt:

Parameter Typ Erforderlich Beschreibung
currencyFrom String Ja Währung, die umgerechnet werden soll
currencyTo String Ja Währung, in die umgerechnet werden soll

Beispiel für eine API-Anfrage

{
  "currencyFrom": "USD",
  "currencyTo": "SEK"
}

Beispiel für eine API-Antwort

{
  "base": "USD",
  "rates": {"SEK": 10.99}
}

Schritt 1: Funktion zum Senden der API-Anfrage erstellen

Sofern noch nicht geschehen, erstellen Sie zunächst die Funktion, die ein API-Anfrage.

Zu Demonstrationszwecken in dieser Anleitung, anstatt eine tatsächliche API zu senden erhalten Sie hartcodierte Werte im selben Format wie ein die API zurückgibt.

Schritt 2: Funktionsdeklaration erstellen

Erstellen Sie die Funktionsdeklaration, die Sie an das generative Modell übergeben (nächster Schritt dieser Anleitung).

Geben Sie in den Beschreibungen der Funktionen und Parameter so viele Details wie möglich an. Das generative Modell bestimmt anhand dieser Informationen, welche Funktion ausgewählt werden soll und wie Werte für die Parameter im Funktionsaufruf bereitgestellt werden.

Schritt 3: Funktionsdeklaration bei der Modellinitialisierung angeben

Geben Sie die Funktionsdeklaration an, wenn Sie das generative Modell initialisieren, indem Sie den Parameter tools des Modells festlegen:

Informationen zur Auswahl eines Gemini-Modells und optional einen Standort die für Ihren Anwendungsfall und Ihre App geeignet sind.

Schritt 4: Funktionsaufruf generieren

Jetzt können Sie das Modell mit der definierten Funktion auffordern.

Wir empfehlen, Funktionsaufrufe über die Chatoberfläche zu verwenden, da Funktionsaufrufe passen gut in die Multi-Turn-Struktur des Chats.

Was können Sie sonst noch tun?

Weitere Gemini API-Funktionen ausprobieren

Informationen zum Steuern der Inhaltsgenerierung

Sie können auch mit Prompts und Modellkonfigurationen experimentieren, indem Sie Vertex AI Studio

Weitere Informationen zu den Gemini-Modellen

Hier finden Sie Informationen zu den Modellen, die für verschiedene Anwendungsfälle verfügbar sind, sowie zu ihren Kontingenten und Preisen.


Feedback geben zu Ihren Erfahrungen mit Vertex AI in Firebase