Agent Assist는 데이터 상주 를 제공하여 지정된 지리적 리전 또는 위치 내에서 실제로 저장 데이터 를 유지합니다. 리전을 지정하면 저장 데이터가 해당 리전 외부에 저장되지 않습니다. 가격은 모든 리전에서 동일합니다.
리전 지정은 다음과 같은 사용 사례에서 특히 유용합니다.
- 시스템에 데이터 저장 위치를 제어하는 규정 또는 정책 요구사항이 있습니다.
- 데이터가 고객과 동일한 리전에 있으면 네트워크 지연 시간이 향상될 수 있습니다. 예를 들어 벨기에 고객이
europe-west1을 사용하는 경우 지연 시간이 더 짧을 것으로 예상할 수 있습니다.
사용 가능한 리전
| 국가 그룹 | 지리적 위치 | 리전 ID | 데이터 스토어 지역 ID |
|---|---|---|---|
| 미주 | 아이오와 | us-central1 |
us(멀티 리전) |
| 미주 | 사우스캐롤라이나 | us-east1 |
|
| 미주 | 오리건 | us-west1 |
|
| 미주 | 몬트리올 | northamerica-northeast1 |
global (멀티 리전) |
| 미주 | 미국 멀티 리전 | us * |
us(멀티 리전)* |
| 유럽 | 벨기에 | europe-west1 |
eu(멀티 리전) |
| 유럽 | 런던 | europe-west2 |
|
| 유럽 | 프랑크푸르트 | europe-west3 |
|
| 유럽 | 엠스하벤 | europe-west4 |
eu (멀티 리전) |
| 유럽 | 취리히 | europe-west6 |
eu (멀티 리전) |
| 아시아 태평양 | 싱가포르 | asia-southeast1 |
|
| 아시아 태평양 | 자카르타 | asia-southeast2 |
global (멀티 리전) |
| 아시아 태평양 | 도쿄 | asia-northeast1 |
|
| 아시아 태평양 | 뭄바이 | asia-south1 |
|
| 아시아 태평양 | 시드니 | australia-southeast1 |
|
| 전역 | 전역 멀티 리전(전역 제공, 미국 내 저장 데이터) | global(권장) 또는 리전 없음(기본값)¶ |
global(멀티 리전)¶ |
| 기호 | 설명 |
|---|---|
| * | Vertex AI는 'us' 멀티 리전 위치를 지원하지 않습니다. 따라서 'us' 멀티 리전에서 Agent Assist의 생성형 AI 기능을 사용할 때는 해당하는 기존 미국 단일 리전 엔드포인트에 의존합니다. |
| ¶ | global 리전에 대한 호출은 미국 외부에서 호출될 때 지연 시간이 더 길 수 있습니다. 가능한 경우 해당 서비스 및 사용자에게 가까운 특정 리전을 참조하세요. |
리전 제공에 사용 가능한 기능
| 지역 ID | 커스텀 섹션을 사용한 Summarization v6.0/5.0/4.0 | Summarization 자동 평가 (프리뷰) | 감정 분석 (v3) | (능동적) 생성형 기술 지원 | 나만의 지원 빌드 (프리뷰) | AI 코치 |
|---|---|---|---|---|---|---|
us-central1 |
✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
us-east1 |
✓ | ✓ | ✓ | ✓ | ✓ | |
us-west1 |
✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
us |
✓ | ✓ | ✓ | ✓ | ✓ | |
northamerica-northeast1 |
✓ | ✓ | ✓ | ✓ | ✓ | |
europe-west1 |
✓ | ✓ | ✓ | ✓ | ✓ | |
europe-west2 |
✓ | ✓ | ✓ | ✓ | ✓ | |
europe-west3 |
✓ | ✓ | ✓ | ✓ | ✓ | |
europe-west4 |
✓ | ✓ | ✓ | ✓ | ✓ | |
europe-west6 |
✓ | ✓ | ✓ | ✓ | ✓ | |
asia-southeast1 |
✓ | ✓ | ✓ | ✓ | ✓ | |
asia-southeast2 |
✓ | ✓ | ✓ | ✓ | ✓ | |
asia-northeast1 |
✓ | ✓ | ✓ | ✓ | ✓ | |
asia-south1 |
✓ | ✓ | ✓ | ✓ | ✓ | |
australia-southeast1 |
✓ | ✓ | ✓ | ✓ | ✓ | |
global |
✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
저장 데이터
모든 Agent Assist 개발자 사용자 및 최종 사용자 데이터는 저장 데이터에 포함됩니다. 예를 들면 다음과 같습니다.
제한사항
다음과 같은 제한사항이 적용됩니다.
- Agent Assist 콘솔 은 리전화를 지원하지 않습니다. API를 직접 호출하여 리전화를 구현할 수만 있습니다.
- 모델 학습은 리전화를 지원하지 않습니다. 이 프로세스 중에 데이터가 리전 외부로 라우팅될 수 있습니다.
API 탐색기는 많은 REST 참조 문서에 있으며 API 호출에
global리전만 지원합니다.CCAI Transcription은 음성 적응 기능을 사용하지 않는 경우 EU, 미국, 북미(캐나다)에서 사용 중 데이터와 저장 데이터만 지원합니다.
(능동적) 생성형 기술 지원 기능에서 사용하는 데이터 스토어의 경우
global,us멀티 리전,eu멀티 리전만 지원됩니다.
API를 사용하여 리전 지정
리전화를 사용하려면 모든 API 요청에 리전을 지정해야 합니다.
필수 필드:
locationURL 경로 파라미터의 지역 ID를 제공합니다.global리전의 경우 호스트 이름에dialogflow.googleapis.com을 사용합니다. 다른 모든 리전의 경우 호스트 이름에[region-id]-dialogflow.googleapis.com을 사용합니다.
예를 들면 다음과 같습니다.
dialogflow.googleapis.com/v2/projects/project_id/locations/global/knowledgeBases/knowledge_base_idus-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 문서를 참조하세요.