Regionalização e residência de dados

O Dialogflow oferece residência de dados para manter os dados em repouso fisicamente em um local ou região geográfica. Quando uma região é especificada, os dados em repouso não são replicados fora da região. O preço é o mesmo para todas as regiões.

As regiões são usadas pelos seguintes motivos:

• Seu sistema pode ter requisitos regulatórios ou de políticas que regem o local dos dados.
• Suas latências de rede podem ser melhoradas quando os dados estão na mesma região que seus clientes. Por exemplo, se os clientes do Reino Unido usarem europe-west2, eles poderão esperar uma latência melhor.

Observação: a regionalização do Dialogflow e a residência de dados não se aplicam a dados em uso (em inglês) ou dados em trânsito.

Dados em repouso

Todos os dados do usuário e do usuário final do Dialogflow estão incluídos nos dados em repouso (em inglês). Exemplo:

• Todos os recursos do agente definidos com console ou API (intents, entidades etc.)
• Todas as configurações do agente definidas com o console ou a API
• Histórico de consultas
• Resultados da validação
• Tarefas de criação de modelos
• Tarefas de treinamento
• Tarefas de operação de longa duração

Regiões disponíveis

O Dialogflow oferece as seguintes regiões:

Grupos de países	Localização geográfica	ID da região
Europa	Bélgica	europe-west1
Europa	Londres	europe-west2
Ásia-Pacífico	Sydney	australia-southeast1
Ásia-Pacífico	Tóquio	asia-northeast1
Global	O serviço do Dialogflow é global, mas os dados em repouso ficam armazenados nos EUA	global (recomendado) ou nenhuma região (padrão) *

Símbolo	Descrição
*	As chamadas para a região global podem ter uma latência maior quando feitas 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.

Observação: o endpoint us-dialogflow.googleapis.com e o recurso locations/us local que serviu como alias para os recursos da região global são descontinuado desde 21 de maio de 2024. Para especificar a região global corretamente, consulte as notas da versão.

Selecione uma região com o console

A área superior esquerda do Console do Dialogflow ES tem uma lista suspensa para a seleção de região. Cada agente tem uma região imutável especificada na criação. Ao selecionar uma região no console, é possível listar ou criar agentes somente para a região selecionada. A região padrão é global.

Observação: é possível criar um agente por região para um projeto do Google Cloud.

Selecionar uma região com a API

Se o agente foi criado em uma região não padrão, é preciso especificá-la ao chamar a API para solicitações de tempo de design ou tempo de execução.

Para fornecer uma região, ofereça um parâmetro location às solicitações de API. Para chamadas REST, siga estas orientações:

• Forneça o parâmetro de caminho do URL location. Para a multirregião global, use global.
• Para a região global, use 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.

Exemplos:

• https://dialogflow.googleapis.com/v2/projects/PROJECT/locations/global/agents/
• https://asia-northeast1-dialogflow.googleapis.com/v2/projects/PROJECT/locations/asia-northeast1/agents/

Para bibliotecas de cliente, consulte a documentação da biblioteca de cliente. Você precisa fazer o seguinte:

• Defina o endpoint do serviço do Dialogflow como uma das seguintes opções:

  dialogflow.googleapis.com:443
  REGION_ID-dialogflow.googleapis.com:443
  

• Defina o nome da sessão como:

  projects/PROJECT_ID/locations/REGION_ID/agent/sessions/SESSION_ID
  

Cuidado: conforme descrito na documentação de configuração, use a variável de ambiente GOOGLE_APPLICATION_CREDENTIALS para fornecer credenciais às suas bibliotecas de cliente. No entanto, se você precisar fornecer manualmente um arquivo de credenciais no código, deverá realizar uma etapa extra ao chamar um endpoint regionalizado. Defina o escopo como https://www.googleapis.com/auth/cloud-platform ao gerar suas credenciais de autenticação. Por exemplo, isso é feito em Java ao criar um objeto GoogleCredentials:

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

Cloud Logging

Consulte o Guia do Cloud Logging para controlar a região em que os registros são armazenados.

Limitações

Quando uma região não padrão é selecionada no Console do Dialogflow, os seguintes recursos não estão disponíveis:

• Integrações
• Conectores de conhecimento
• Prebuilt Agents
• Small Talk
• Ferramenta de treinamento

O APIs Explorer, encontrado em muitos Documentos de referência da REST, oferece suporte apenas à região global para chamadas de API.