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

このページでは、エージェント アプリケーションと個々のツールをエクスポートおよびインポートする方法について説明します。

エージェントのエクスポートとインポート

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

  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

ツールのエクスポートとインポート

個々のツールをエクスポートおよびインポートできます。この機能により、[ツール] パネルに [インポート] と [エクスポート] の 2 つの新しいオプションが追加されます。

  • エクスポート: ツールのコンテンツを JSON ファイルとしてローカルマシンまたは Cloud Storage にダウンロードします。
  • インポート: ローカル JSON ファイルまたは Cloud Storage に保存された JSON ファイルを使用して、新しいツールを作成したり、既存のツールを更新したりします。

ツールをエクスポートする

ツールをエクスポートするには:

  1. Gemini Enterprise for CX コンソールを開き、プロジェクトとエージェントを選択します。
  2. [ツール] パネルを開きます。
  3. エクスポートするツールのコンテキスト メニューをクリックします。
  4. [Export] を選択します。
  5. ダイアログで、次のいずれかのオプションを選択します。
    • ダウンロード: JSON ファイルをローカルマシンに保存します。
    • Cloud Storage: 指定された Cloud Storage URI に JSON ファイルを保存します。

ツールをインポートする

ツールをインポートするワークフローは 2 つあります。

インポートして上書き

このオプションを使用して、既存のツールを変更します。インポートする JSON ファイルは、現在のツールと同じツールタイプに対応している必要があります。

  1. Gemini Enterprise for CX コンソールを開き、プロジェクトとエージェントを選択します。
  2. [ツール] パネルを開きます。
  3. 更新するツールのコンテキスト メニューをクリックします。
  4. [インポートして上書き] を選択します。
  5. ダイアログで、次のいずれかのオプションを選択します。
    • JSON をアップロード: ローカルマシンから JSON ファイルを選択します。
    • Cloud Storage: Cloud Storage 内の JSON ファイルの URI を入力します。

新規としてインポート

このオプションを使用して、新しいツールを作成します。

  1. Gemini Enterprise for CX コンソールを開き、プロジェクトとエージェントを選択します。
  2. [Create Tool] パネルを開きます。
  3. [新規としてインポート] を選択します。
  4. ダイアログで、次のいずれかのオプションを選択します。
    • JSON をアップロード: ローカルマシンから JSON ファイルを選択します。
    • Cloud Storage: Cloud Storage 内の JSON ファイルの URI を入力します。