Regionalização e residência de dados

O Agent Assist oferece residência dos dados para manter os seus dados em repouso fisicamente numa região ou localização geográfica especificada. Quando especifica uma região, os seus dados em repouso não são armazenados fora dessa região. Os preços são iguais para todas as regiões.

A especificação de uma região é particularmente útil nos seguintes exemplos de utilização:

• O seu sistema tem requisitos regulamentares ou de políticas que regem a localização dos seus dados.
• As latências da rede podem ser melhoradas quando os dados estão na mesma região que os seus clientes. Por exemplo, se os clientes da Bélgica usarem europe-west1, podem esperar uma melhor latência.

Regiões disponíveis

Funcionalidades disponíveis para a publicação regional

Dados em repouso

Todos os dados de utilizadores programadores e utilizadores finais do Agent Assist estão incluídos nos dados em repouso. Por exemplo:

• Bases de conhecimentos e documentos de conhecimentos.
• Perfis de conversa.
• Históricos de conversas e mensagens.
• Participantes da conversão.
• Sugestões devolvidas pelo Agent Assist.
• Feedbacks.

Limitações

Aplicam-se as seguintes limitações:

• A consola do Agent Assist não suporta a regionalização. Só pode implementar a regionalização chamando a API diretamente.
• A preparação de modelos não suporta a regionalização. Os seus dados podem ser encaminhados para fora da região durante este processo.

• O Explorador de APIs, que se encontra em muitos documentos de referência REST, só suporta a região global para chamadas de API.

• A transcrição da CCAI só suporta dados multirregionais em utilização e dados em repouso (se não usar a funcionalidade de adaptação de voz) na UE, nos EUA e na América do Norte (Canadá).

• Apenas as seguintes regiões são suportadas para armazenamentos de dados, usadas pela funcionalidade de assistência de conhecimentos generativos (proativa): global, us multirregião e eu multirregião.

Especifique uma região através da API

Para usar a regionalização, tem de especificar uma região para cada pedido de API.

Campos obrigatórios:

• Indique o ID da região para o parâmetro de caminho de URL location.

• Para a região global, use dialogflow.googleapis.com para o nome do anfitrião. Para todas as outras regiões, use [region-id]-dialogflow.googleapis.com para o nome do anfitrião.

Por exemplo:

• dialogflow.googleapis.com/v2/projects/project_id/locations/global/knowledgeBases/knowledge_base_id

• us-central1-dialogflow.googleapis.com/v2/projects/project_id/locations/us-central1/knowledgeBases/knowledge_base_id

Para usar bibliotecas cliente, são necessários os seguintes passos:

• Defina o ponto final do serviço como: REGION_ID-dialogflow.googleapis.com.

• Defina o nome do recurso com a localização correta, por exemplo:

  projects/project_id/locations/region_id/knowledgeBases/knowledge_base_id
  

Credenciais

Recomendamos que use a variável de ambiente GOOGLE_APPLICATION_CREDENTIALS para fornecer credenciais às suas bibliotecas de cliente. Consulte as instruções de configuração do Dialogflow para mais informações sobre a definição desta variável.

Se, em alternativa, precisar de fornecer credenciais manuais no seu código, é necessário um passo adicional antes de poder chamar um ponto final regionalizado. Tem de definir o âmbito como https://www.googleapis.com/auth/cloud-platform quando gerar as suas credenciais de autenticação. O exemplo seguinte demonstra como o fazer em Java ao criar um objeto GoogleCredentials:

    GoogleCredentials.fromStream(new FileInputStream("credential_file"))
      .createScoped("https://www.googleapis.com/auth/cloud-platform")

Cloud Logging

Consulte a documentação do Cloud Logging para controlar a região onde os seus registos são armazenados.