내보내기 및 가져오기

에이전트 애플리케이션을 내보내고 가져올 수 있습니다.

  1. Gemini Enterprise for CX 콘솔을 엽니다.
  2. 프로젝트를 선택합니다. 프로젝트의 에이전트 애플리케이션 목록이 표시됩니다.
  3. 애플리케이션의 컨텍스트 메뉴를 클릭한 다음 가져오기 또는 내보내기를 선택합니다.

환경 파일

에이전트 애플리케이션을 내보내면 environment.json라는 파일이 다운로드된 보관 파일의 루트 디렉터리에 포함됩니다. 이 파일은 Cloud Storage 버킷, 서비스 엔드포인트, 데이터 스토어 URI와 같은 애플리케이션의 환경별 설정을 관리하는 데 도움이 됩니다.

내보내기 및 가져오기에 이 파일을 사용하면 다음과 같은 이점이 있습니다.

  • 향상된 이식성: 단일 파일을 수정하여 서로 다른 프로젝트 또는 환경 (예: 개발에서 프로덕션) 간에 에이전트 애플리케이션을 전송합니다.
  • 중앙 집중식 구성: 모든 주요 외부 종속 항목이 한곳에 나열되어 관리 작업을 간소화하고 명확한 개요를 제공합니다.
  • 오류 감소: 여러 리소스 파일에서 설정을 수동으로 수정하는 것에 비해 실수 위험을 최소화합니다.
  • 자동화 친화적: 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