에이전트를 만들 때 리전을 에이전트의 위치로 지정해야 합니다. 에이전트로 전송된 요청은 이 리전의 Google 서비스로 처리되며 대화형 에이전트(Dialogflow CX)가 저장 데이터를 실제로 지리적인 리전 또는 위치 내에 유지합니다. 최상의 성능을 위해서는 서비스 및 최종 사용자와 가까운 리전을 선택해야 합니다.
에이전트를 만든 후에는 위치를 변경할 수 없습니다. 에이전트 위치를 변경하려면 다른 위치의 새 에이전트로 내보내기 및 복원해야 합니다.
각 위치에는 프로젝트 전체에 적용되는 관련 설정이 있습니다. 대부분의 경우 이러한 위치 설정을 수정할 필요가 없으며 기본 설정이 적합합니다. 시스템에 고객 관리 암호화 키(주로 정부 기관 또는 규제가 적용되는 업계에 필요)가 필요한 경우 위치 설정에 대해 자세히 알아보세요.
제한사항
다음과 같은 제한사항이 적용됩니다.
다양한 전화 통합에 대한 리전 지원은 다를 수 있습니다. 각 통합 문서를 확인하세요.
시스템 항목 지원은 언어마다 다릅니다. 자세한 내용은 시스템 항목 제한사항을 참조하세요.
많은 REST 참조 문서에 있는 API 탐색기는 API 호출에
global리전만 지원합니다.
사용 가능한 리전
대화형 에이전트(Dialogflow CX)는 에이전트 위치에 대해 다음 리전을 지원합니다. 데이터 스토어 에이전트는 이러한 리전의 하위 집합을 지원하며 데이터 스토어에서 사용되는 리전 ID는 에이전트 리전과 약간 다릅니다. 데이터 스토어 리전 ID 열 값이 있는 모든 리전이 Vertex AI Conversation의 데이터 스토어 에이전트에서 지원됩니다.
| 국가 그룹 | 지리적 위치 | 에이전트 리전 ID | 데이터 스토어 리전 ID |
|---|---|---|---|
| 미주 | 아이오와 | us-central1 |
us(멀티 리전) |
| 미주 | 몬트리올 | northamerica-northeast1 |
|
| 미주 | 사우스캐롤라이나 | us-east1 |
|
| 미주 | Oregon | us-west1 |
|
| 미주 | 미국 멀티 리전 | us * |
us(멀티 리전)* |
| 유럽 | 벨기에 | europe-west1 |
eu(멀티 리전) |
| 유럽 | 런던 | europe-west2 |
|
| 유럽 | 프랑크푸르트 | europe-west3 |
|
| 아시아 태평양 | 시드니 | australia-southeast1 |
|
| 아시아 태평양 | 도쿄 | asia-northeast1 |
|
| 아시아 태평양 | 뭄바이 | asia-south1 |
|
| 아시아 태평양 | 싱가포르 | asia-southeast1 |
|
| 전역 | 전역 멀티 리전(전역 제공, 미국 내 저장 데이터) | global(권장) 또는 리전 없음(기본값)¶ |
global(멀티 리전)¶ |
| 기호 | 설명 |
|---|---|
| * | Vertex AI는 'us' 멀티 리전 위치를 지원하지 않습니다. 따라서 'us' 멀티 리전에서 대화형 에이전트(Dialogflow CX)의 생성형 AI 기능을 사용할 때는 해당하는 기존 미국 단일 리전 엔드포인트에 의존합니다. |
| ¶ | global 리전 호출은 미국 외부에서 호출할 때 지연 시간이 높을 수 있습니다. 가능한 경우 해당 서비스 및 최종 사용자에게 가까운 특정 리전을 참조하세요. |
Google Cloud에서 사용하는 리전에 대한 자세한 내용은 Google Cloud 리전 및 Google Cloud 지역 및 리전을 참조하세요.
위치 설정
시스템에 고객 관리 암호화 키(정부 기관 또는 규정이 적용되는 업계에 필요)가 필요한 경우 위치 설정을 사용하여 이 기능을 구성할 수 있습니다.
위치 설정은 프로젝트 전체에 공유되고 고유한 위치마다 고유한 위치 설정이 있습니다. 프로젝트에 특정 위치에 대한 설정을 구성한 후에는 해당 위치의 설정을 변경할 수 없습니다. 설정을 변경해야 하는 경우 새 프로젝트를 만들어야 합니다.
위치 설정을 수정하지 않고 에이전트를 만들면 해당 위치에 기본 설정이 구성되어 해당 프로젝트의 설정을 변경할 수 없습니다. 또한 에이전트를 만든 후에는 위치를 변경할 수 없습니다. 에이전트 위치를 변경하려면 다른 위치의 새 에이전트로 내보내기 및 복원해야 합니다.
다음과 같은 위치 설정을 사용할 수 있습니다.
- 암호화: 이 설정은 Google 관리 또는 고객 관리 암호화 키를 사용하여 데이터를 보호하는지 여부를 제어합니다. 기본값은 Google 관리입니다. 이 설정을 변경하려면 Google 담당자에게 문의하여 고객 관리 암호화 키 기능에 대한 액세스를 요청해야 합니다.
위치 설정은 다음 두 가지 방법으로 구성할 수 있습니다.
- 에이전트 선택기 인터페이스에서 위치 설정을 클릭합니다.
- 에이전트를 만들 때 위치 드롭다운 옆에 있는 수정 버튼을 클릭합니다.
API로 리전 지정
모든 API 요청에 리전을 지정해야 합니다.
REST 호출의 경우 다음을 모두 수행해야 합니다.
locationURL 경로 매개변수의 리전 ID를 제공합니다.us멀티 리전의 경우 호스트 이름으로usa-dialogflow.googleapis.com을 사용합니다. 다른 모든 리전의 경우 호스트 이름으로[region-id]-dialogflow.googleapis.com을 사용합니다.
예를 들면 다음과 같습니다.
usa-dialogflow.googleapis.com/projects/{PROJECT_ID}/locations/us/agents/{AGENT_ID}us-central1-dialogflow.googleapis.com/projects/{PROJECT_ID}/locations/us-central1/agents/{AGENT_ID}
클라이언트 라이브러리의 경우 클라이언트 라이브러리 문서에서 리전 구성 옵션을 참조하세요.
예시는 API 빠른 시작을 참조하세요.
Cloud Logging
로그가 저장되는 리전을 제어하는 방법은 Cloud Logging 가이드를 참조하세요.