Configurações de regionalização e localização

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:

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) ¶

É 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:

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, use usa-dialogflow.googleapis.com como o nome do host. Para todas as outras regiões, use [region-id]-dialogflow.googleapis.com como 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.