Export und Import

Auf dieser Seite wird beschrieben, wie Sie Agent-Anwendungen und einzelne Tools exportieren und importieren.

Agent exportieren und importieren

Sie können Agent-Anwendungen exportieren und importieren:

  1. Öffnen Sie die Gemini Enterprise for CX-Konsole.
  2. Wählen Sie Ihr Projekt aus. Die Liste der Agent-Anwendungen für Ihr Projekt wird angezeigt.
  3. Klicken Sie auf das Kontextmenü für Ihre Anwendung und wählen Sie dann „Importieren“ oder „Exportieren“ aus.

Umgebungsdatei

Wenn Sie eine Agent-Anwendung exportieren, wird eine Datei mit dem Namen environment.json in das Stammverzeichnis des heruntergeladenen Archivs aufgenommen. Mit dieser Datei können Sie umgebungsspezifische Einstellungen für Ihre Anwendung verwalten, z. B. Cloud Storage-Buckets, Dienstendpunkte und Datenspeicher-URIs.

Die Verwendung dieser Datei für Exporte und Importe hat folgende Vorteile:

  • Verbesserte Portabilität:Agent-Anwendungen können durch Ändern einer einzelnen Datei zwischen verschiedenen Projekten oder Umgebungen (z. B. von der Entwicklung zur Produktion) übertragen werden.
  • Zentrale Konfiguration:Alle wichtigen externen Abhängigkeiten sind an einem Ort aufgeführt. Das vereinfacht die Verwaltung und bietet einen klaren Überblick.
  • Weniger Fehler:Das Risiko von Fehlern wird im Vergleich zur manuellen Bearbeitung von Einstellungen in mehreren Ressourcendateien minimiert.
  • Automatisierungsfreundlich:Das JSON-Format ermöglicht es Ihnen, Konfigurationen programmatisch mithilfe von Scripts als Teil einer CI/CD-Pipeline zu aktualisieren.

So aktualisieren Sie umgebungsspezifische Einstellungen:

  1. Exportieren:Laden Sie die exportierte Agent-Anwendung herunter und extrahieren Sie sie.
  2. Ändern:Öffnen Sie die Datei environment.json im Stammverzeichnis. Passen Sie die Werte für die Abhängigkeiten an die Einstellungen Ihrer Zielumgebung an.
  3. Importieren:Komprimieren Sie das gesamte Verzeichnis, einschließlich der geänderten environment.json-Datei, in ein neues ZIP-Archiv. Importieren Sie dieses neue Archiv in die Zielumgebung. Das System wendet die aktualisierten Werte aus environment.json an.

Details zur Umgebungsdatei

Die Datei environment.json dient als zentrales Manifest für externe Abhängigkeiten, die sich zwischen verschiedenen Umgebungen (z. B. Entwicklung, Test und Produktion) ändern können.

Wenn Sie eine Agent-Anwendung exportieren, identifiziert das System umgebungsspezifische Felder in den Ressourcen der Anwendung. Anstatt diese Werte fest zu codieren, werden sie vom System extrahiert und in der Datei environment.json platziert. Die Werte sind nach Ressourcentyp und -name organisiert. In den ursprünglichen Ressourcenmanifestdateien werden diese extrahierten Werte durch die Platzhaltervariable $env_var ersetzt.

Wenn Sie die Agent-Anwendung importieren, liest das System die Datei environment.json. Es werden die $env_var-Platzhalter in den Ressourcenmanifesten gesucht und durch die entsprechenden Werte aus der Datei environment.json ersetzt. Bei diesem Vorgang wird die Anwendung für die neue Umgebung konfiguriert.

Die folgenden Felder werden in der Datei environment.json verwaltet:

  • ApiKeyConfig.key_name
  • ApiKeyConfig.api_key_secret_version
  • AudioRecordingConfig.gcs_bucket
  • BoostSpecs.data_stores
  • ConnectorTool.connection
  • DataStore.name
  • EngineSource.engine
  • FileSearchTool.file_corpus
  • OAuthConfig.client_secret_version
  • OAuthConfig.token_endpoint
  • OpenApiToolset.url (automatisch aus OpenApiToolset.open_api_schema extrahiert)
  • ServiceAccountAuthConfig.service_account
  • VertexAiRagRetrievalTool.RagResource.rag_corpus
  • VertexAiRagRetrievalTool.RagResource.rag_file_ids

Tools exportieren und importieren

Sie können einzelne Tools exportieren und importieren. Diese Funktion bietet zwei neue Optionen im Toolbereich: Importieren und Exportieren.

  • Exportieren:Laden Sie den Inhalt des Tools als JSON-Datei auf Ihren lokalen Computer oder in Cloud Storage herunter.
  • Importieren:Sie können lokale JSON-Dateien oder in Cloud Storage gespeicherte JSON-Dateien verwenden, um neue Tools zu erstellen oder vorhandene Tools zu aktualisieren.

Tool exportieren

So exportieren Sie ein Tool:

  1. Öffnen Sie die Gemini Enterprise for CX Console und wählen Sie Ihr Projekt und Ihren Agenten aus.
  2. Öffnen Sie den Bereich Tool.
  3. Klicken Sie auf das Kontextmenü des Tools, das Sie exportieren möchten.
  4. Wählen Sie Exportieren aus.
  5. Wählen Sie im Dialogfeld eine der folgenden Optionen aus:
    • Herunterladen:Speichert die JSON-Datei auf Ihrem lokalen Computer.
    • Cloud Storage:Speichert die JSON-Datei unter einem angegebenen Cloud Storage-URI.

Tool importieren

Es gibt zwei Arbeitsabläufe zum Importieren eines Tools:

Importieren und überschreiben

Mit dieser Option können Sie ein vorhandenes Tool ändern. Die importierte JSON-Datei muss dem gleichen Tooltyp wie das aktuelle Tool entsprechen.

  1. Öffnen Sie die Gemini Enterprise for CX Console und wählen Sie Ihr Projekt und Ihren Agenten aus.
  2. Öffnen Sie den Bereich Tool.
  3. Klicken Sie auf das Kontextmenü des Tools, das Sie aktualisieren möchten.
  4. Wählen Sie Importieren, um zu überschreiben aus.
  5. Wählen Sie im Dialogfeld eine der folgenden Optionen aus:
    • JSON hochladen:Wählen Sie eine JSON-Datei auf Ihrem lokalen Computer aus.
    • Cloud Storage:Geben Sie den URI einer JSON-Datei in Cloud Storage ein.

Als neu importieren

Mit dieser Option können Sie ein neues Tool erstellen.

  1. Öffnen Sie die Gemini Enterprise for CX Console und wählen Sie Ihr Projekt und Ihren Agenten aus.
  2. Öffnen Sie den Bereich Tool erstellen.
  3. Wählen Sie Als neu importieren aus.
  4. Wählen Sie im Dialogfeld eine der folgenden Optionen aus:
    • JSON hochladen:Wählen Sie eine JSON-Datei auf Ihrem lokalen Computer aus.
    • Cloud Storage:Geben Sie den URI einer JSON-Datei in Cloud Storage ein.