Export und Import

Auf dieser Seite wird beschrieben, wie Sie Agentenanwendungen und einzelne Tools exportieren und importieren.

Agent exportieren und importieren

Sie können Agentenanwendungen exportieren und importieren:

  1. Öffnen Sie die CX Agent Studio Console.
  2. Wählen Sie Ihr Projekt aus. Die Liste der Agentenanwendungen für Ihr Projekt wird angezeigt.
  3. Klicken Sie auf das Kontextmenü für Ihre Anwendung und wählen Sie „Importieren“ oder „Exportieren“ aus.

Umgebungsdatei

Wenn Sie eine Agentenanwendung exportieren, ist im Stammverzeichnis des heruntergeladenen Archivs eine Datei mit dem Namen environment.json enthalten. 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 bietet folgende Vorteile:

  • Verbesserte Portabilität:Sie können Agentenanwendungen zwischen verschiedenen Projekten oder Umgebungen (z. B. von der Entwicklung zur Produktion) übertragen, indem Sie eine einzelne Datei ändern.
  • Zentrale Konfiguration:Alle wichtigen externen Abhängigkeiten sind an einem Ort aufgeführt, was die Verwaltung vereinfacht und einen klaren Überblick bietet.
  • Weniger Fehler:Das Risiko von Fehlern ist geringer als bei der manuellen Bearbeitung von Einstellungen in mehreren Ressourcendateien.
  • Automatisierungsfreundlich:Mit dem JSON-Format können Sie Konfigurationen programmatisch mithilfe von Skripts als Teil einer CI/CD-Pipeline aktualisieren.

So aktualisieren Sie umgebungsspezifische Einstellungen:

  1. Exportieren:Laden Sie die exportierte Agentenanwendung herunter und extrahieren Sie sie.
  2. Ändern:Öffnen Sie die Datei environment.json im Stammverzeichnis. Ändern Sie die Werte für die Abhängigkeiten so, dass sie den Einstellungen Ihrer Zielumgebung entsprechen.
  3. Importieren:Komprimieren Sie das gesamte Verzeichnis einschließlich der geänderten Datei environment.json 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 Agentenanwendung exportieren, identifiziert das System umgebungsspezifische Felder in den Ressourcen der Anwendung. Anstatt diese Werte fest zu codieren, werden sie extrahiert und in die Datei environment.json eingefügt. Die Werte sind nach Ressourcentyp und -name organisiert. In den ursprünglichen Ressourcendateien werden diese extrahierten Werte durch die Platzhaltervariable $env_var ersetzt.

Wenn Sie die Agentenanwendung importieren, liest das System die Datei environment.json. Die Platzhalter $env_var werden in den Ressourcenmanifesten gesucht und durch die entsprechenden Werte aus der Datei environment.json ersetzt. Dadurch 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

Tool exportieren und importieren

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

  • Exportieren:Laden Sie den Inhalt des Tools als JSON-Datei auf Ihren lokalen Computer oder in Cloud Storage herunter.
  • Importieren:Verwenden Sie lokale JSON-Dateien oder JSON-Dateien, die in Cloud Storage gespeichert sind, um neue Tools zu erstellen oder vorhandene Tools zu aktualisieren.

Tool exportieren

So exportieren Sie ein Tool:

  1. Öffnen Sie die CX Agent Studio Console und wählen Sie Ihr Projekt und Ihren Agenten aus.
  2. Öffnen Sie den Bereich Tool.
  3. Klicken Sie auf das Kontextmenü für das Tool, 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 Möglichkeiten, ein Tool zu importieren:

Importieren und überschreiben

Verwenden Sie diese Option, um ein vorhandenes Tool zu ändern. Die importierte JSON-Datei muss dem gleichen Tooltyp wie das aktuelle Tool entsprechen.

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

Als neu importieren

Verwenden Sie diese Option, um ein neues Tool zu erstellen.

  1. Öffnen Sie die CX Agent Studio 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 von Ihrem lokalen Computer aus.
    • Cloud Storage:Geben Sie den URI einer JSON-Datei in Cloud Storage ein.