리전화 및 위치 설정

에이전트를 만들 때 리전을 에이전트의 위치로 지정해야 합니다. 에이전트에 전송된 요청은 이 리전의 Google 서비스에서 처리됩니다. 최상의 성능을 위해서는 서비스 및 최종 사용자와 가까운 리전을 선택해야 합니다.

에이전트를 만든 후에는 위치를 변경할 수 없습니다. 에이전트 위치를 변경하려면 다른 위치의 새 에이전트로 내보내기 및 복원해야 합니다.

각 위치에는 프로젝트 전체에 적용되는 관련 설정이 있습니다. 대부분의 경우 이러한 위치 설정을 수정할 필요가 없으며 기본 설정이 적합합니다. 시스템에 데이터 상주 보증(일반적이지 않음) 또는 고객 관리 암호화 키(일반적이지 않음)가 필요한 경우 위치 설정에 관한 자세한 내용을 참조하세요.

사용 가능한 리전

Dialogflow CX는 에이전트 위치에 대해 다음과 같은 리전을 지원합니다.

국가 그룹 지리적 위치 리전 ID
미주 아이오와 us-central1
미주 몬트리올 northamerica-northeast1
미주 사우스캐롤라이나 us-east1
유럽 벨기에 europe-west1
유럽 런던 europe-west2
아시아 태평양 시드니 australia-southeast1
아시아 태평양 도쿄 asia-northeast1

Google Cloud에서 사용하는 리전에 대한 자세한 내용은 Google Cloud 리전Google Cloud 위치 및 리전을 참조하세요.

위치 설정

시스템에 데이터 상주 보증(일반적이지 않음) 또는 고객 관리 암호화 키(일반적이지 않음)가 필요한 경우 위치 설정을 사용하여 이러한 기능을 구성할 수 있습니다.

위치 설정은 프로젝트 전체에 공유되고 고유한 위치마다 고유한 위치 설정이 있습니다. 프로젝트에 특정 위치에 대한 설정을 구성한 후에는 해당 위치의 설정을 변경할 수 없습니다. 설정을 변경해야 하는 경우 새 프로젝트를 만들어야 합니다.

위치 설정을 수정하지 않고 에이전트를 만들면 해당 위치에 기본 설정이 구성되어 해당 프로젝트의 설정을 변경할 수 없습니다. 또한 에이전트를 만든 후에는 위치를 변경할 수 없습니다. 에이전트 위치를 변경하려면 다른 위치의 새 에이전트로 내보내기 및 복원해야 합니다.

다음과 같은 위치 설정을 사용할 수 있습니다.

  • 암호화: 이 설정은 Google 관리 또는 고객 관리 암호화 키를 사용하여 데이터를 보호하는지 여부를 제어합니다. 기본값은 Google 관리입니다. 이 설정을 변경하려면 Google 담당자에게 문의하여 고객 관리 암호화 키 기능에 대한 액세스를 요청해야 합니다.
  • 데이터 상주 규정 준수: 해당 위치에 데이터 상주 보증이 필요한지 여부를 제어합니다. 미국 리전의 경우 이 설정이 기본적으로 false로 설정되며 true로 변경할 수 있습니다. 다른 리전의 경우 설정이 true로 설정되며 변경할 수 없습니다. 데이터 상주 보증의 일부 기능이 아직 구현되지 않았기 때문에 이 설정을 사용 설정하면 이러한 기능을 사용할 수 없습니다. 데이터 상주 규정 준수를 사용 중지하면 이러한 기능을 사용할 수 있습니다. Dialogflow 팀은 모든 기능에 대한 데이터 상주 지원을 추가하기 위해 노력하고 있으므로 향후 이 설정은 삭제될 예정입니다.

위치 설정은 다음 두 가지 방법으로 구성할 수 있습니다.

데이터 상주 보증

모든 Dialogflow CX 에이전트 저장 데이터사용 중 데이터는 지정된 리전에만 저장됩니다. 단, 다음은 제외됩니다.

데이터 유형 저장 데이터 상주 보증 사용 중 데이터 상주 보증
리소스 식별자(Agent.name, Flow.name, Page.name 등) 없음 없음
리소스 표시 이름(Agent.display_name, Flow.display_name, Page.display_name 등) 없음 없음
리소스 설명(Agent.description, Flow.description 등) 없음 없음
음성 세션 오디오 데이터 없음
고급 NLU 요청 us-central1, us-east1의 경우 예. 다른 리전의 경우 아니요.
감정 요청 감정은 데이터 상주 규정 준수를 사용 중지한 us-central1 또는 us-east1 고객만 사용할 수 있습니다. 감정은 데이터 상주 규정 준수를 사용 중지한 us-central1 또는 us-east1 고객만 사용할 수 있습니다.
철자 오류 수정 맞춤법 교정 기능은 데이터 상주 규정 준수를 사용 중지한 us-central1 또는 us-east1 고객만 사용할 수 있습니다. 맞춤법 교정 기능은 데이터 상주 규정 준수를 사용 중지한 us-central1 또는 us-east1 고객만 사용할 수 있습니다.

또한 다음 작업 중 하나를 수행하면 데이터가 여러 리전 간에 이동할 수 있습니다.

  • 지정된 리전 외부의 지리적 위치에서 Dialogflow 콘솔 또는 API에 액세스
  • 리전이 에이전트와 다른 Cloud Storage 버킷에 데이터 제공
  • 지리적 위치가 지정된 리전 외부인 웹훅 서비스 제공

API로 리전 지정

모든 API 요청에 리전을 지정해야 합니다.

REST 호출의 경우 location URL 경로 매개변수의 리전 ID를 제공하고 호스트 이름으로 [region-id]-dialogflow.googleapis.com을 사용합니다. 예를 들면 us-central1-dialogflow.googleapis.com/projects/{PROJECT_ID}/locations/us-central1/agents/{AGENT_ID}입니다.

클라이언트 라이브러리의 경우 클라이언트 라이브러리 문서에서 리전 구성 옵션을 참조하세요.

예시는 API 빠른 시작을 참조하세요.