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

Quando cria um agente, tem de especificar uma região como a localização do agente. Os pedidos enviados para o seu agente são processados pelos serviços Google nesta região e os agentes conversacionais (Dialogflow CX) mantêm os dados em repouso fisicamente na região ou localização geográfica. Para conseguir o melhor desempenho, deve escolher uma região perto dos seus serviços e utilizadores finais.

Depois de criar um agente, não é possível alterar a respetiva localização. Para alterar a localização de um agente, tem de exportar e restaurar para um novo agente com uma localização diferente.

Cada localização tem definições associadas que se aplicam a todo o projeto. Na maioria dos casos, não precisa de editar estas definições de localização, e as predefinições funcionam bem. Se o seu sistema exigir chaves de encriptação geridas pelo cliente (frequentemente exigidas por entidades governamentais ou setores regulamentados), leia mais acerca das definições de localização.

Limitações

Aplicam-se as seguintes limitações:

• O apoio técnico de diferentes integrações de telefonia pode variar consoante a região. Consulte a documentação de cada integração.

• O suporte de entidades do sistema difere para cada idioma. Consulte as limitações das entidades do sistema para ver detalhes.

• O APIs Explorer, disponível em muitos documentos de referência REST, só suporta a região global para chamadas API.

Regiões disponíveis

Importante: O compromisso "Localização dos dados de IA/ML" (residência de dados para processamento de ML) só é suportado nas localizações nos EUA e na UE. O processamento de ML para modelos generativos pode ocorrer em qualquer localização nas várias regiões quando são feitos pedidos às APIs regionais incluídas numa região. Para mais detalhes, consulte a documentação da Vertex AI.

Os agentes de conversação (Dialogflow CX) suportam as seguintes regiões para a localização do agente. Os agentes de armazenamento de dados também são suportados nas regiões indicadas na tabela seguinte, mas os IDs das regiões usados pelos armazenamentos de dados diferem ligeiramente das regiões dos agentes (conforme indicado). Todas as regiões com um valor introduzido na coluna ID da região do arquivo de dados são suportadas por agentes de arquivos de dados no Vertex AI Conversation.

Agrupamento de países	Localização geográfica	ID da região do agente	ID da região do armazenamento de dados
Américas	Iowa	us-central1	us (multirregião)
Américas	Montréal	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 (várias regiões)	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	Multirregião global (publicação global, dados em repouso nos Estados Unidos)	global (preferencial) ou nenhuma região (predefinição) ¶	global (multirregião) ¶

Símbolo	Descrição
*	O Vertex AI não suporta a localização multirregional "us". Como resultado, a utilização das funcionalidades de IA generativa dos agentes conversacionais (Dialogflow CX) na multirregião "us" vai depender dos pontos finais de região única dos EUA existentes respetivos.
¶	As chamadas para a região global podem ter uma latência mais elevada quando são feitas a partir de fora dos EUA. Se possível, prefira uma região mais específica e mais próxima dos seus serviços e utilizadores finais.

Pode ler mais acerca das regiões usadas pelo Google Cloud em Regiões do Google Cloud e Geografia e regiões do Google Cloud.

Definições de localização

Se o seu sistema exigir chaves de encriptação geridas pelo cliente (frequentemente exigidas por entidades governamentais ou setores regulamentados), pode usar as definições de localização para configurar esta funcionalidade.

As definições de localização são partilhadas no projeto, e cada localização única tem as suas próprias definições de localização.

Depois de configurar as definições de uma localização específica para um projeto, é criado um recurso dialogflow.googleapis.com/LocationSettings imutável, e as definições não podem ser alteradas para essa localização. Se precisar de alterar estas definições ou eliminar o recurso, tem de criar um novo projeto.

Se precisar de permitir que os programadores da sua organização configurem agentes apenas em localizações específicas, pode configurar uma política da organização que inclua uma restrição de localizações de recursos.

Se criar um agente sem editar as definições de localização, as predefinições são configuradas para essa localização, e não podem ser alteradas para o projeto. Além disso, depois de criar um agente, não é possível alterar a respetiva localização. Para alterar a localização de um agente, tem de exportar e restaurar para um novo agente com uma localização diferente.

Estão disponíveis as seguintes definições de localização:

• Encriptação: Esta definição controla se são usadas chaves de encriptação geridas pela Google ou pelo cliente para proteger os dados. A predefinição é gerida pela Google. Tem de pedir acesso (contactando o seu representante da Google) à funcionalidade de chaves de encriptação geridas pelo cliente para alterar esta definição.

Pode configurar as definições de localização de duas formas:

• Clique em Definições de localização na interface do seletor de agentes.
• Clique no botão Editar junto ao menu pendente Localização quando criar um agente.

Nota: atualmente, não pode atualizar as definições de localização com a API.

Especifique uma região com a API

Tem de especificar uma região para todos os pedidos de API.

Para chamadas REST, tem de fazer o seguinte:

• Indique o ID da região para o parâmetro de caminho de URL location.

• Para a região global, use dialogflow.googleapis.com para o nome do anfitrião. Para todas as outras regiões, use [region-id]-dialogflow.googleapis.com para o nome do anfitrião.

Por 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 cliente, consulte a documentação da biblioteca cliente para ver uma opção de configuração da região.

Pode encontrar exemplos no guia de início rápido da API.

Aviso: conforme descrito na documentação de configuração, deve usar a variável de ambiente GOOGLE_APPLICATION_CREDENTIALS para fornecer credenciais às suas bibliotecas de cliente. No entanto, se precisar de fornecer manualmente um ficheiro de credenciais no seu código, tem de seguir um passo adicional quando chamar um ponto final regionalizado. Defina o âmbito como https://www.googleapis.com/auth/cloud-platform ao gerar as suas credenciais de autenticação. Por exemplo, isto é feito em Java quando cria um objeto GoogleCredentials:

GoogleCredentials.fromStream(new FileInputStream("credential_file"))
  .createScoped("https://www.googleapis.com/auth/cloud-platform")
  

Cloud Logging

Consulte o guia de registos na nuvem para controlar a região na qual os registos são armazenados.