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.

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

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.

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
    

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:

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