エクスポートとインポート

エージェント アプリケーションをエクスポートおよびインポートできます。

  1. Gemini Enterprise for CX コンソールを開きます。
  2. プロジェクトを選択します。 プロジェクトのエージェント アプリケーションのリストが表示されます。
  3. アプリケーションのコンテキスト メニューをクリックし、インポートまたはエクスポートを選択します。

環境ファイル

エージェント アプリケーションをエクスポートすると、ダウンロードしたアーカイブのルート ディレクトリに environment.json という名前のファイルが含まれます。このファイルは、Cloud Storage バケット、サービス エンドポイント、データストア URI など、アプリケーションの環境固有の設定を管理するのに役立ちます。

このファイルをエクスポートとインポートに使用すると、次のようなメリットがあります。

  • 移植性の向上: 単一のファイルを変更することで、異なるプロジェクトまたは環境（開発から本番環境など）間でエージェント アプリケーションを転送できます。
  • 一元化された構成: すべての主要な外部依存関係が 1 か所にリスト表示されるため、管理が簡素化され、概要を明確に把握できます。
  • ミスの削減: 複数のリソース ファイルにわたって設定を手動で編集する場合と比較して、ミスのリスクを最小限に抑えます。
  • 自動化に適している: JSON 形式を使用すると、CI/CD パイプラインの一部としてスクリプトを使用して構成をプログラムで更新できます。

環境固有の設定を更新するには:

  1. エクスポート: エクスポートされたエージェント アプリケーションをダウンロードして抽出します。
  2. 変更: ルート ディレクトリにある environment.json ファイルを開きます。依存関係の値を変更して、ターゲット環境の設定と一致させます。
  3. インポート: 変更した environment.json ファイルを含むディレクトリ全体を新しい ZIP アーカイブに圧縮します。この新しいアーカイブをターゲット環境にインポートします。システムは、environment.json から更新された値を適用します。

環境ファイルの詳細

environment.json ファイルは、さまざまな環境（開発、テスト、本番環境など）間で変更される可能性のある外部依存関係の中央マニフェストとして機能します。

エージェント アプリケーションをエクスポートすると、システムはアプリケーションのリソース内の環境固有のフィールドを識別します。システムはこれらの値をハードコードするのではなく、抽出して environment.json ファイルに配置します。値はリソースタイプと名前で整理されます。元のリソース マニフェスト ファイルでは、これらの抽出された値はプレースホルダ変数 $env_var に置き換えられます。

エージェント アプリケーションをインポートすると、システムは environment.json ファイルを読み取ります。リソース マニフェスト内の $env_var プレースホルダを見つけ、environment.json ファイルの対応する値に置き換えます。このプロセスでは、新しい環境用にアプリケーションを構成します。

次のフィールドは environment.json ファイルで管理されます。

  • 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（OpenApiToolset.open_api_schema から自動的に抽出）
  • ServiceAccountAuthConfig.service_account
  • VertexAiRagRetrievalTool.RagResource.rag_corpus
  • VertexAiRagRetrievalTool.RagResource.rag_file_ids