내보내기 및 가져오기

이 페이지에서는 에이전트 애플리케이션과 개별 도구를 내보내고 가져오는 방법을 설명합니다.

에이전트 내보내기 및 가져오기

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

  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

도구 내보내기 및 가져오기

개별 도구를 내보내고 가져올 수 있습니다. 이 기능은 도구 패널에 가져오기 및 내보내기라는 두 가지 새로운 옵션을 제공합니다.

  • 내보내기: 도구의 콘텐츠를 JSON 파일로 로컬 머신 또는 Cloud Storage에 다운로드합니다.
  • 가져오기: 로컬 JSON 파일 또는 Cloud Storage에 저장된 JSON 파일을 사용하여 새 도구를 만들거나 기존 도구를 업데이트합니다.

도구 내보내기

도구를 내보내려면 다음 단계를 따르세요.

  1. Gemini Enterprise for CX 콘솔을 열고 프로젝트와 에이전트를 선택합니다.
  2. 도구 패널을 엽니다.
  3. 내보낼 도구의 컨텍스트 메뉴를 클릭합니다.
  4. 내보내기를 선택합니다.
  5. 대화상자에서 다음 옵션 중 하나를 선택합니다.
    • 다운로드: JSON 파일을 로컬 머신에 저장합니다.
    • Cloud Storage: 지정된 Cloud Storage URI에 JSON 파일을 저장합니다.

도구 가져오기

도구를 가져오는 워크플로는 두 가지가 있습니다.

가져와서 덮어쓰기

이 옵션을 사용하여 기존 도구를 수정합니다. 가져온 JSON 파일은 현재 도구와 동일한 도구 유형에 해당해야 합니다.

  1. Gemini Enterprise for CX 콘솔을 열고 프로젝트와 에이전트를 선택합니다.
  2. 도구 패널을 엽니다.
  3. 업데이트할 도구의 컨텍스트 메뉴를 클릭합니다.
  4. 가져와서 덮어쓰기를 선택합니다.
  5. 대화상자에서 다음 옵션 중 하나를 선택합니다.
    • JSON 업로드: 로컬 머신에서 JSON 파일을 선택합니다.
    • Cloud Storage: Cloud Storage에 있는 JSON 파일의 URI를 입력합니다.

새 항목으로 가져오기

이 옵션을 사용하여 새 도구를 만듭니다.

  1. Gemini Enterprise for CX 콘솔을 열고 프로젝트와 에이전트를 선택합니다.
  2. 만들기 도구 패널을 엽니다.
  3. 새 항목으로 가져오기를 선택합니다.
  4. 대화상자에서 다음 옵션 중 하나를 선택합니다.
    • JSON 업로드: 로컬 머신에서 JSON 파일을 선택합니다.
    • Cloud Storage: Cloud Storage에 있는 JSON 파일의 URI를 입력합니다.