Ao criar um agente, é preciso especificar uma região como local do agente. As solicitações enviadas ao seu agente são processadas pelos Serviços do Google nessa região, e os agentes de conversação (Dialogflow CX) mantêm os dados em repouso fisicamente dentro da região ou local geográfico. Para ter o melhor desempenho, escolha uma região próxima aos serviços e usuários finais.
Após a criação de um agente, o local não pode ser alterado. Para alterar o local de um agente, exporte e restaure para um novo agente com outro local.
Cada local tem configurações associadas que se aplicam ao seu projeto. Na maioria dos casos, você não precisa editar essas configurações de localização, e as configurações padrão funcionarão bem. Se o sistema exigir chaves de criptografia gerenciadas pelo cliente (geralmente exigidas por entidades governamentais ou setores regulamentados), leia mais sobre configurações de localização.
Limitações
Considere as seguintes limitações:
O suporte de região para diferentes integrações de telefonia pode variar. Consulte a documentação de cada integração.
O suporte a entidades do sistema é diferente para cada language. Consulte as limitações de entidade do sistema para mais detalhes.
O APIs Explorer, encontrado em muitos Documentos de referência da REST, oferece suporte apenas à região
globalpara chamadas de API.
Regiões disponíveis
Os agentes de conversação (Dialogflow CX) oferecem suporte às seguintes regiões para localização do agente. Agentes de repositório de dados oferecem suporte a um subconjunto dessas regiões e os IDs de região usados pelos repositórios de dados são um pouco diferentes das regiões do agente. Todas as regiões com um valor para a coluna "ID da região do repositório de dados" têm suporte de agentes do repositório de dados na Vertex AI para Conversação.
| Grupos de países | Localização geográfica | ID da região do agente | ID da região do repositório de dados |
|---|---|---|---|
| Américas | Iowa | us-central1 |
us (multirregional) |
| Américas | Montreal | northamerica-northeast1 |
|
| Américas | Carolina do Sul | us-east1 |
|
| Américas | Oregon | us-west1 |
|
| Américas | Estados Unidos, multirregião | us * |
us (multirregião) * |
| Europa | Bélgica | europe-west1 |
eu (multirregional) |
| Europa | Londres | europe-west2 |
|
| Europa | Frankfurt | europe-west3 |
|
| Ásia-Pacífico | Sydney | australia-southeast1 |
|
| Ásia-Pacífico | Tóquio | asia-northeast1 |
|
| Ásia-Pacífico | Mumbai | asia-south1 |
|
| Ásia-Pacífico | Singapura | asia-southeast1 |
|
| Global | Multirregião global (exibição global, dados em repouso nos Estados Unidos) | global (recomendado) ou nenhuma região (padrão) ¶ |
global (multirregião) ¶ |
| Símbolo | Descrição |
|---|---|
| * | A Vertex AI não suporta "nós" local multirregional. Como resultado, o uso dos recursos de IA generativa dos Agentes de conversa (Dialogflow CX) em "nós" multirregional vai depender dos respectivos 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 e mais próxima dos seus serviços e usuários finais. |
É possível ler mais sobre as regiões usadas pelo Google Cloud nas regiões do Google Cloud e nas regiões e regiões geográficas do Google Cloud.
Configurações de localização
Se o sistema exigir chaves de criptografia gerenciadas pelo cliente (geralmente exigidas por entidades governamentais ou setores regulamentados), será possível usar as configurações de localização para configurar esse recurso.
As configurações de localização são compartilhadas pelo projeto, e cada local exclusivo tem as próprias configurações de localização. Quando as configurações de um local específico são definidas para um projeto, as configurações não podem ser alteradas para ele. Se você precisar alterar essas configurações, crie um novo projeto.
Se você criar um agente sem editar as configurações de localização, as definições padrão serão definidas para esse local e não poderão ser alteradas para o projeto. Além disso, após a criação de um agente, seu local não pode ser alterado. Para alterar o local de um agente, exporte e restaure para um novo agente com outro local.
As seguintes configurações de localização estão disponíveis:
- Criptografia: essa configuração controla se as chaves de criptografia gerenciadas pelo Google ou pelo cliente são usadas para proteger dados. O padrão é gerenciado pelo Google. É necessário solicitar acesso (entrando em contato com seu representante do Google) ao recurso de chaves de criptografia gerenciadas pelo cliente para alterar essa configuração.
É possível definir as configurações de localização de duas maneiras:
- Clique em Configurações de local na interface do seletor de agentes.
- Clique no botão Editar ao lado da lista suspensa Local ao criar um agente.
Especifique uma região com a API
É preciso especificar uma região para todas as solicitações de API.
Para chamadas REST, siga estas etapas:
Forneça o ID da região para o parâmetro de caminho do URL
location.Para a multirregião
us, useusa-dialogflow.googleapis.comcomo o nome do host. Para todas as outras regiões, use[region-id]-dialogflow.googleapis.comcomo o nome do host.
Exemplo:
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}
Para bibliotecas de cliente, consulte a documentação da biblioteca de cliente para ver uma opção de configuração de região.
Veja exemplos no guia de início rápido da API.
Cloud Logging
Consulte o Guia do Cloud Logging para controlar a região em que os registros são armazenados.