Esta página foi traduzida pela API Cloud Translation.
Switch to English

Configurações de regionalização e localização

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:

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.