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) são compatíveis com as seguintes regiões para a localização do agente. Os agentes de armazenamento de dados também são aceitos nas regiões listadas na tabela a seguir, mas os IDs de região usados pelos armazenamentos de dados são um pouco diferentes das regiões de agentes (como listado). Todas as regiões com um valor inserido na coluna ID da região do repositório de dados são compatíveis com os agentes do repositório de dados na Vertex AI Conversation.

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 global (multirregião)
Américas Carolina do Sul us-east1 us (multirregião)
Américas Oregon us-west1 us (multirregião)
Américas Estados Unidos, multirregião us * us (multirregião)
Europa Bélgica europe-west1 eu (multirregião)
Europa Londres europe-west2 eu (multirregião)
Europa Frankfurt europe-west3 eu (multirregião)
Europa Países Baixos europe-west4 eu (multirregião)
Europa Zurique europe-west6 eu (multirregião)
Ásia-Pacífico Sydney australia-southeast1 global (multirregião)
Ásia-Pacífico Tóquio asia-northeast1 global (multirregião)
Ásia-Pacífico Mumbai asia-south1 global (multirregião)
Ásia-Pacífico Singapura asia-southeast1 global (multirregião)
Ásia-Pacífico Jacarta asia-southeast2 global (multirregião)
Global Multirregional global (disponibilizaçã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 oferece suporte ao local de várias regiões "us". Como resultado, o uso dos recursos de IA generativa dos agentes de conversação (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 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 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, um recurso dialogflow.googleapis.com/LocationSettings imutável é criado, e as configurações não podem ser alteradas para esse local. Se você precisar mudar essas configurações ou excluir o recurso, crie um novo projeto.

Se você precisar permitir que os desenvolvedores da sua organização configurem agentes apenas em locais específicos, configure uma política da organização que inclua uma restrição de locais de recursos.

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

Exemplo:

  • dialogflow.googleapis.com/projects/{PROJECT_ID}/locations/global/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.

Anterior
Autenticação TLS mútua
Próxima
Certificados de CA personalizados