O Agent Assist oferece residência de dados para manter os dados em repouso fisicamente em um local ou região geográfica especificada. Quando você especifica uma região, os dados em repouso não são armazenados fora dela. O preço é o mesmo para todas as regiões.
Especificar uma região é particularmente útil nos seguintes casos de uso:
- Seu sistema tem requisitos regulatórios ou de política que regem o local dos dados.
- Suas latências de rede podem ser melhoradas quando os dados estão na mesma região que seus clientes. Por exemplo, se os clientes da Bélgica usarem
europe-west1, eles poderão esperar uma latência melhor.
Regiões disponíveis
| Grupos de países | Localização geográfica | ID da região | ID da região do repositório de dados |
|---|---|---|---|
| Américas | Iowa | us-central1 |
us (multirregional) |
| Américas | Carolina do Sul | us-east1 |
|
| Américas | Oregon | us-west1 |
|
| Américas | Montreal | northamerica-northeast1 |
global (multirregional) |
| Américas | Estados Unidos (multirregional) | us * |
us (multirregional) * |
| Europa | Bélgica | europe-west1 |
eu (multirregional) |
| Europa | Londres | europe-west2 |
|
| Europa | Frankfurt | europe-west3 |
|
| Europa | Eemshaven | europe-west4 |
eu (multirregional) |
| Europa | Zurique | europe-west6 |
eu (multirregional) |
| Ásia-Pacífico | Singapura | asia-southeast1 |
|
| Ásia-Pacífico | Jacarta | asia-southeast2 |
global (multirregional) |
| Ásia-Pacífico | Tóquio | asia-northeast1 |
|
| Ásia-Pacífico | Mumbai | asia-south1 |
|
| Ásia-Pacífico | Sydney | australia-southeast1 |
|
| Global | Multirregional global (disponibilização global, dados em repouso nos Estados Unidos) | global (recomendado) ou nenhuma região (padrão) ¶ |
global (multirregional) ¶ |
| Símbolo | Descrição |
|---|---|
| * | A Vertex AI não oferece suporte ao local multirregional "us". Como resultado, o uso dos recursos de IA generativa do Assistente de agente na multirregião "us" vai depender dos endpoints de região única dos EUA. |
| ¶ | As chamadas para a região global podem ter uma latência maior quando chamadas de fora dos EUA. Se possível, prefira uma região mais específica mais próxima dos seus serviços e usuários. |
Recursos disponíveis para disponibilização regional
| ID da região | Resumo com seções personalizadas v5.0/4.0 | Avaliação automática de resumo (pré-lançamento) | Análise de sentimento (v3) | Assistência de conhecimento generativo (proativa) | Criar seu próprio assistente (pré-lançamento) | Coach de IA |
|---|---|---|---|---|---|---|
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 |
✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
Dados em repouso
Todos os dados do usuário desenvolvedor e do usuário final do Agent Assist estão incluídos nos dados em repouso. Exemplo:
- Bases de conhecimento e documentos de conhecimento.
- Perfis de conversa.
- Históricos de conversas e mensagens.
- Participantes da conversão.
- Sugestões retornadas pelo Agent Assist.
- Feedbacks.
Limitações
Considere as seguintes limitações:
- O console do Agent Assist não oferece suporte à regionalização. Só é possível implementar a regionalização chamando a API diretamente.
- O treinamento de modelo não oferece suporte à regionalização. Seus dados podem ser encaminhados para fora da região durante esse processo.
O APIs Explorer, encontrado em muitos documentos de referência da API REST, só oferece suporte à região
globalpara chamadas de API.A transcrição de CCAI só oferece suporte a dados multirregionais em uso e dados em repouso (se não estiver usando o recurso de adaptação de fala) na UE, nos EUA e na América do Norte (Canadá).
Somente as seguintes regiões são aceitas para repositórios de dados, usados pelo recurso de assistência de conhecimento generativo (proativo):
global, multirregionaluse multirregionaleu.
Especificar uma região usando a API
Para usar a regionalização, é necessário especificar uma região para cada solicitação de API.
Campos obrigatórios:
Forneça o ID da região para o parâmetro de caminho do URL
location.Para a região
global, usedialogflow.googleapis.comcomo o nome do host. Para todas as outras regiões, use[region-id]-dialogflow.googleapis.comcomo o nome do host.
Exemplo:
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
Para usar bibliotecas de cliente, as seguintes etapas são necessárias:
- Defina o endpoint do serviço como:
REGION_ID-dialogflow.googleapis.com. Defina o nome do recurso com o local correto, por exemplo:
projects/project_id/locations/region_id/knowledgeBases/knowledge_base_id
Credenciais
Recomendamos que você use a GOOGLE_APPLICATION_CREDENTIALS variável de ambiente para fornecer credenciais às suas bibliotecas de cliente. Consulte as instruções de configuração do Dialogflow para mais informações sobre como definir essa variável.
Se você precisar fornecer credenciais manuais no código, uma etapa extra será necessária antes de chamar um endpoint regionalizado. Defina o escopo como https://www.googleapis.com/auth/cloud-platform ao gerar suas credenciais de autenticação. O exemplo a seguir demonstra como fazer isso em Java ao criar um objeto GoogleCredentials:
GoogleCredentials.fromStream(new FileInputStream("credential_file"))
.createScoped("https://www.googleapis.com/auth/cloud-platform")
Cloud Logging
Consulte a documentação do Cloud Logging para controlar a região em que os registros são armazenados.