Ao criar um agente, é preciso especificar uma região como local do agente. As solicitações enviadas ao seu agente são gerenciadas pelos serviços do Google nesta região. Para ter o melhor desempenho, escolha uma região próxima aos serviços e usuários finais.
Após a criação de um agente, o local não pode ser alterado. Para alterar o local de um agente, exporte e restaure para um novo agente com outro local.
Cada local tem configurações associadas que se aplicam ao seu projeto. Na maioria dos casos, você não precisa editar essas configurações de localização, e as configurações padrão funcionarão bem. Se o sistema exigir garantias de residência de dados (incomum) ou chaves de criptografia gerenciadas pelo cliente (incomum), leia mais sobre configurações de localização.
Regiões disponíveis
O Dialogflow CX é compatível com as seguintes regiões para a localização do agente:
| Grupos de países | Localização geográfica | ID da região |
|---|---|---|
| Américas | Iowa | us-central1 |
| Américas | Montreal | northamerica-northeast1 |
| Américas | Carolina do Sul | us-east1 |
| Europa | Bélgica | europe-west1 |
| Europa | Londres | europe-west2 |
| Ásia-Pacífico | Sydney | australia-southeast1 |
| Ásia-Pacífico | Tóquio | asia-northeast1 |
É possível ler mais sobre as regiões usadas pelo Google Cloud nas regiões do Google Cloud e nas regiões e regiões geográficas do Google Cloud.
Configurações de localização
Se o sistema exigir garantias de residência de dados (incomum) ou chaves de criptografia gerenciadas pelo cliente (incomum), você poderá usar a localização para configurar esses recursos.
As configurações de localização são compartilhadas pelo projeto, e cada local exclusivo tem as próprias configurações de localização. Quando as configurações de um local específico são definidas para um projeto, as configurações não podem ser alteradas para ele. Se você precisar alterar essas configurações, crie um novo projeto.
Se você criar um agente sem editar as configurações de localização, as definições padrão serão definidas para esse local e não poderão ser alteradas para o projeto. Além disso, após a criação de um agente, seu local não pode ser alterado. Para alterar o local de um agente, exporte e restaure para um novo agente com outro local.
As seguintes configurações de localização estão disponíveis:
- Criptografia: essa configuração controla se as chaves de criptografia gerenciadas pelo Google ou pelo cliente são usadas para proteger dados. O padrão é gerenciado pelo Google. É necessário solicitar acesso (entrando em contato com seu representante do Google) ao recurso de chaves de criptografia gerenciadas pelo cliente para alterar essa configuração.
- Compliance com residência de dados: controla se as garantias de residência de dados são necessárias para o local. Para regiões dos EUA, esta configuração assume o padrão false e pode ser alterada para true. Para outras regiões, a configuração é definida como verdadeira e não pode ser alterada. Há alguns recursos que ainda não foram implementados com uma garantia de residência de dados, então esses recursos estarão indisponíveis se você ativar essa configuração. Desativar a conformidade com a residência de dados permite esses recursos. A equipe do Dialogflow está trabalhando para adicionar o suporte à residência de dados para todos os recursos, portanto, essa configuração será removida no futuro.
É possível definir as configurações de localização de duas maneiras:
- Clique em Configurações de local na interface do seletor de agentes.
- Clique no botão Editar ao lado da lista suspensa Local ao criar um agente.
Garantias de residência de dados
Todos os dados em repouso e dados em uso do agente do Dialogflow CX podem residir apenas na região especificada, com as seguintes exceções:
| Tipo de dado | Residência de dados em repouso garantida | Residência de dados em uso garantida |
|---|---|---|
Identificadores de recursos (Agent.name, Flow.name, Page.name etc.) |
Não | Não |
Nomes de exibição de recursos (Agent.display_name, Flow.display_name, Page.display_name etc.) |
Não | Não |
Descrições dos recursos (Agent.description, Flow.description etc.) |
Não | Não |
| Dados de áudio da sessão do Voice | Sim | Não |
| Solicitações avançadas de LUA | Sim | Sim para us-central1, us-east1 e europe-west1. Não para outras regiões. |
| Solicitações de sentimento | O sentimento está disponível apenas para clientes us-central1 ou us-east1 que desativam Em conformidade com a residência de dados |
O sentimento está disponível apenas para clientes us-central1 ou us-east1 que desativam Em conformidade com a residência de dados |
| Correção ortográfica | A correção ortográfica só está disponível para clientes us-central1 ou us-east1 que desativam Em conformidade com a residência de dados |
A correção ortográfica só está disponível para clientes us-central1 ou us-east1 que desativam Em conformidade com a residência de dados |
Além disso, se você tomar alguma das medidas a seguir, os dados poderão entre regiões:
- Acessar o Console do Dialogflow ou a API de um local geográfico fora da região especificada.
- fornecer dados em um bucket do Cloud Storage que tenha uma região diferente do agente.
- Fornecer um serviço de webhook que tenha uma localização geográfica fora da região especificada.
Especifique uma região com a API
É preciso especificar uma região para todas as solicitações de API.
Para chamadas REST,
forneça o ID da região do parâmetro de caminho do URL location
e use [region-id]-dialogflow.googleapis.com como o nome do host.
Por exemplo: us-central1-dialogflow.googleapis.com/projects/{PROJECT_ID}/locations/us-central1/agents/{AGENT_ID}.
Para bibliotecas de cliente, consulte a documentação da biblioteca de cliente para ver uma opção de configuração de região.
Veja exemplos no guia de início rápido da API.