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) * |
| Símbolo | Descrição |
|---|---|
| * | 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. |
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 regiãoglobal, useglobal. - Para a região
global, usedialogflow.googleapis.comcomo o nome do host. Para todas as outras regiões, use[REGION_ID]-dialogflow.googleapis.comcomo 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 do REST,
só oferece suporte à região global para chamadas de API.