지역화 및 데이터 보존

Agent Assist는 지정된 지리적 리전 또는 위치 내에 실제로 저장 데이터를 유지하기 위해 데이터 보존을 제공합니다. 리전을 지정하면 저장 데이터가 해당 리전 외부에 저장되지 않습니다. 가격은 모든 리전에서 동일합니다.

지역을 지정하는 것은 다음과 같은 사용 사례에서 특히 유용합니다.

  • 시스템에 데이터 저장 위치를 제어하는 규정 또는 정책 요구사항이 있습니다.
  • 데이터가 고객과 동일한 리전에 있으면 네트워크 지연 시간이 향상될 수 있습니다. 예를 들어 벨기에 고객이 europe-west1를 사용하면 지연 시간이 더 좋아질 수 있습니다.

사용 가능한 리전

국가 그룹 지리적 위치 리전 ID 데이터 스토어 리전 ID
미주 아이오와 us-central1 us(멀티 리전)
미주 사우스캐롤라이나 us-east1
미주 오리건 us-west1
미주 몬트리올 northamerica-northeast1
미주 미국 멀티 리전 us * us(멀티 리전)*
유럽 벨기에 europe-west1 eu(멀티 리전)
유럽 런던 europe-west2
유럽 프랑크푸르트 europe-west3
아시아 태평양 싱가포르 asia-southeast1
아시아 태평양 도쿄 asia-northeast1
아시아 태평양 뭄바이 asia-south1
아시아 태평양 시드니 australia-southeast1
전역 전역 멀티 리전(전역 제공, 미국 내 저장 데이터) global(권장) 또는 리전 없음(기본값)¶ global(멀티 리전)¶
기호 설명
* Vertex AI는 'us' 멀티 리전 위치를 지원하지 않습니다. 따라서 'us' 멀티 리전에서 Agent Assist의 생성형 AI 기능을 사용할 때는 해당하는 기존 미국 단일 리전 엔드포인트에 의존합니다.
global 리전 호출은 미국 외부에서 호출할 때 지연 시간이 높을 수 있습니다. 가능한 경우 해당 서비스 및 사용자에게 가까운 특정 리전을 참조하세요.

지역별 게재에 사용할 수 있는 기능

리전 ID 맞춤 섹션 v3.1/3.0을 사용한 요약 맞춤 섹션 v2.1을 사용한 요약 맞춤 섹션 v2.0/1.0을 사용한 요약 감정 분석 (사전 예방적) 생성형 지식 지원
us-central1 ✓ ✓ ✓ ✓ ✓
us-east1 ✓ ✓ ✓ ✓ ✓
us-west1 ✓ ✓ ✓ ✓ ✓
us ✓ ✓ ✓ ✓
northamerica-northeast1 ✓ ✓ ✓ ✓
europe-west1 ✓ ✓ ✓ ✓
europe-west2 ✓ ✓ ✓ ✓
europe-west3 ✓ ✓ ✓ ✓
asia-southeast1 ✓ ✓ ✓ ✓
asia-northeast1 ✓ ✓ ✓ ✓
asia-south1 ✓ ✓ ✓
australia-southeast1 ✓ ✓ ✓ ✓
global ✓ ✓ ✓ ✓ ✓

저장 데이터

모든 Agent Assist 개발자 사용자 및 최종 사용자 데이터는 저장 데이터에 포함됩니다. 예를 들면 다음과 같습니다.

제한사항

다음과 같은 제한사항이 적용됩니다.

  • Agent Assist Console은 아직 지역화를 지원하지 않습니다. API를 직접 호출하여만 지역화를 구현할 수 있습니다.
  • 모델 학습은 지역화를 지원하지 않습니다. 이 과정에서 데이터가 리전 외부로 라우팅될 수 있습니다.

  • 많은 REST 참조 문서에 있는 API 탐색기는 API 호출에 global 리전만 지원합니다.

  • CCAI 스크립트는 현재 EU, 미국, 북미 (캐나다)에서 사용 중인 멀티 리전 데이터와 보관 중인 데이터 (음성 적응 기능을 사용하지 않는 경우)만 지원합니다.

  • (사전 예방적) 생성형 지식 지원 기능에서 사용하는 데이터 스토어의 경우 global, us 멀티 리전, eu 멀티 리전의 리전만 지원됩니다.

API를 사용하여 리전 지정

지역화를 사용하려면 모든 API 요청에 리전을 지정해야 합니다.

필수 필드:

  • location URL 경로 매개변수의 리전 ID를 제공합니다.

  • global 리전의 경우 호스트 이름에 dialogflow.googleapis.com을 사용합니다. 다른 모든 지역의 경우 호스트 이름에 [region-id]-dialogflow.googleapis.com을 사용합니다.

예를 들면 다음과 같습니다.

  • dialogflow.googleapis.com/v2/projects/project_id/locations/global/knowledgeBases/knowledge_base_id

  • us-central1-dialogflow.googleapis.com/v2/projects/project_id/locations/us-central1/knowledgeBases/knowledge_base_id

클라이언트 라이브러리를 사용하려면 다음 단계가 필요합니다.

  • 서비스 엔드포인트를 REGION_ID-dialogflow.googleapis.com로 설정합니다.

  • 올바른 위치를 사용하여 리소스 이름을 설정합니다(예:

    projects/project_id/locations/region_id/knowledgeBases/knowledge_base_id

사용자 인증 정보

GOOGLE_APPLICATION_CREDENTIALS 환경 변수를 사용하여 클라이언트 라이브러리에 사용자 인증 정보를 제공하는 것이 좋습니다. 이 변수 설정에 관한 자세한 내용은 Dialogflow 설정 안내를 참고하세요.

대신 코드에서 사용자 인증 정보를 수동으로 제공해야 하는 경우 리전화된 엔드포인트를 호출하기 전에 한 가지 추가 단계가 필요합니다. 인증 사용자 인증 정보를 생성할 때 범위를 https://www.googleapis.com/auth/cloud-platform으로 설정해야 합니다. 다음 예는 GoogleCredentials 객체를 만들 때 Java에서 이를 실행하는 방법을 보여줍니다.

    GoogleCredentials.fromStream(new FileInputStream("credential_file"))
      .createScoped("https://www.googleapis.com/auth/cloud-platform")

Cloud Logging

로그가 저장되는 리전을 제어하려면 Cloud Logging 문서를 참고하세요.