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 (preferencial) ou nenhuma região (padrão) *

Selecione uma região com o console

A área superior esquerda do console do Dialogflow ES tem um menu suspenso para 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 região global, use global.
  • Para a região global, use dialogflow.googleapis.com para o nome do host. Para todas as outras regiões, use [REGION_ID]-dialogflow.googleapis.com para 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 de 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 REST, só aceita a região global para chamadas de API.