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 o Dialogflow mantém os dados em repouso fisicamente dentro da região ou local geográficos. 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 idioma. Consulte as limitações de entidades do sistema para mais detalhes.
O APIs Explorer, encontrado em muitos documentos de referência REST, só é compatível com a região
globaldas chamadas de API.
Regiões disponíveis
O Dialogflow CX oferece suporte às regiões a seguir para o local do agente. Os agentes de repositório de dados são compatíveis com um subconjunto dessas regiões, e os IDs de região usados por armazenamentos 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" são compatíveis com os agentes de 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 (multirregião) |
| Américas | Montreal | northamerica-northeast1 |
|
| Américas | Carolina do Sul | us-east1 |
|
| Américas | Oregon | us-west1 |
|
| Américas | Multirregião dos Estados Unidos | us * |
us (multirregional) * |
| Europa | Bélgica | europe-west1 |
eu (multirregião) |
| 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 (veiculação global, dados em repouso nos Estados Unidos) | global (preferido) 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 Dialogflow CX na multirregião "us" vai depender dos respectivos endpoints de região única dos EUA. |
| ¶ | As chamadas para a região global podem ter maior latência quando feitas de fora dos EUA. Se possível, 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.comt/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.
Geração de registros do Cloud
Consulte o Guia do Cloud Logging para controlar a região em que os registros são armazenados.