Vertex AI-Erweiterungen erstellen

Diese Seite gilt für Apigee und Apigee Hybrid.

In diesem Thema wird erläutert, wie Sie Vertex AI-Erweiterungen im API-Hub erstellen.

Was ist eine Vertex AI-Erweiterung?

Mit Vertex AI-Erweiterungen können LLMs über APIs eine Verbindung zu realen Daten und Aktionen herstellen. Erweiterungen verarbeiten Nutzerabfragen und kommunizieren mit Large Language Models (LLMs), um Vorgänge im Namen einer Anwendung wie einer Chat-Anwendung auszuführen.

Angenommen, Sie erstellen eine Vertex AI-Erweiterung für eine Autovermietungs-API und diese Erweiterung ist mit einer Chatanwendung verknüpft. Wenn ein Nutzer die Anwendung fragt, ein Auto zu mieten, versteht die generative KI den Kontext der Frage und ruft die Erweiterungs-API auf, um ein Auto zu mieten.

Vertex-Erweiterungen.
Abbildung 1. Vertex AI-Erweiterung, die mit einer Kundenservice-Chat-App verbunden ist.

Weitere Informationen zu Vertex AI-Erweiterungen finden Sie unter Erweiterungen – Übersicht.

API-Hub optimiert das Erstellen von Vertex AI-Erweiterungen

Der API-Hub optimiert das Erstellen einer Vertex AI-Erweiterung mithilfe vorhandener API-Hub-Metadaten. Die Schlüsseldaten, die vom API-Hub zum Erstellen einer Erweiterung verwendet werden, sind eine API-Spezifikation und ein Deployment, die praktisch bereits vom API-Hub validiert wurden. Die Spezifikation liefert die API-Vorgänge für die Erweiterung und das Deployment stellt den Serverendpunkt der API bereit.

Vertex AI-Erweiterung erstellen

So erstellen Sie eine Vertex AI-Erweiterung im API-Hub:

Console

So erstellen Sie eine Erweiterung:

  1. Rufen Sie in der Google Cloud Console im Apigee API-Hub die Seite APIs auf.

    Zum API-Hub
  2. Suchen Sie die API, der Sie eine Erweiterung hinzufügen möchten. Verwenden Sie Filter, um Suchbegriffe anzugeben, um die Liste der APIs zu filtern. Verwenden Sie bei Bedarf Search, um eine API zu finden.
  3. Klicken Sie auf eine API, um die zugehörige Detailseite anzusehen.
  4. Klicken Sie auf Vertex-Erweiterung erstellen.
  5. Geben Sie im Formular Vertex-Erweiterung erstellen die Erweiterungsdetails an:
    • Erweiterungsname: (Erforderlich) Sie müssen einen Erweiterungsnamen angeben.
    • Beschreibung: (Erforderlich) Fügen Sie eine Beschreibung der Erweiterung hinzu.
    • Version: (Erforderlich) Wählen Sie eine API-Version aus.
    • Spezifikationsdatei: (Erforderlich) Wenn eine Spezifikation mit der API-Version verknüpft ist, wird sie automatisch in dieses Feld eingefügt. Siehe API-Spezifikationen verwalten.
    • Deployment: (Erforderlich) Wenn ein Deployment mit der API-Version verknüpft ist, wird es automatisch in dieses Feld eingetragen. Siehe Bereitstellungen verwalten.
  6. Klicken Sie auf Erweiterung erstellen. Wenn Sie die Erweiterung der Standardversion hinzufügen, wird die Erweiterung auf der Seite "API-Details" im Abschnitt "Erweiterungen" angezeigt. Wenn du die Erweiterung einer anderen Version hinzugefügt hast, musst du die Detailseite der Version aufrufen, um die Erweiterung dort zu sehen.

Vertex AI-Erweiterungen auflisten

In diesem Abschnitt wird erläutert, wie Sie Vertex-Erweiterungen auflisten.

Console

So rufen Sie alle Versionen auf, die mit einer registrierten API in der Console verknüpft sind:

  1. Rufen Sie in der Google Cloud Console die Seite API-Hub auf.

    Zum API-Hub
  2. Klicken Sie auf APIs.
  3. Suchen Sie die API, die Sie untersuchen möchten. Verwenden Sie Filter, um Suchbegriffe anzugeben, um die Liste der APIs zu filtern. Verwenden Sie bei Bedarf Search, um eine API zu finden.
  4. API auswählen.
  5. Alle Erweiterungen, die der Standardversion hinzugefügt wurden, werden auf der Detailseite der API im Abschnitt „Erweiterungen“ aufgeführt. Wenn eine Erweiterung zu einer anderen Version hinzugefügt wurde, musst du die Detailseite der Version aufrufen, um die Erweiterung dort zu sehen.

Details zur Vertex AI-Erweiterung abrufen

In diesem Abschnitt wird erläutert, wie Sie die Details zu einer Vertex AI-Erweiterung abrufen.

Console

So rufen Sie die Erweiterungsdetails von Vertex AI in der Console auf:

  1. Rufen Sie in der Google Cloud Console die Seite API-Hub auf.

    Zum API-Hub
  2. Klicken Sie auf APIs.
  3. Suchen Sie die API, die Sie untersuchen möchten. Verwenden Sie Filter, um Suchbegriffe anzugeben, um die Liste der APIs zu filtern. Verwenden Sie bei Bedarf Search, um eine API zu finden.
  4. API auswählen.
  5. Alle Erweiterungen, die der Standardversion hinzugefügt wurden, werden auf der Detailseite der API im Abschnitt „Erweiterungen“ aufgeführt. Wenn eine Erweiterung zu einer anderen Version hinzugefügt wurde, musst du die Detailseite der Version aufrufen, um die Erweiterung dort zu sehen. Klicken Sie in der Tabelle Vertex-Erweiterungen auf eine Erweiterung, um die zugehörige Detailseite aufzurufen.

Vertex AI-Erweiterung löschen

In diesem Abschnitt wird erläutert, wie Sie eine Vertex-Erweiterung löschen.

Console

So löschen Sie eine Erweiterung:

  1. Rufen Sie in der Google Cloud Console die Seite API-Hub auf.

    Zum API-Hub
  2. Klicken Sie auf APIs.
  3. Suchen Sie die API mit der Erweiterung, die Sie löschen möchten. Verwenden Sie Filter, um Suchbegriffe anzugeben, um die Liste der APIs zu filtern. Verwenden Sie bei Bedarf Search, um eine API zu finden.
  4. API auswählen.
  5. Suchen Sie die Erweiterung, die Sie löschen möchten. Alle Erweiterungen, die der Standardversion hinzugefügt wurden, werden auf der Detailseite der API im Abschnitt „Erweiterungen“ aufgeführt. Wenn eine Erweiterung zu einer anderen Version hinzugefügt wurde, musst du die Detailseite der Version aufrufen, um die Erweiterung dort zu sehen.
  6. Klicken Sie im Menü Aktionen (die rechte Seite der Zeile mit der Erweiterung) auf Löschen.