Export und Import

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