Regionalização e residência de dados

O Agent Assist oferece residência de dados para manter os dados em repouso fisicamente em um local ou região geográfica especificada. Quando você especifica uma região, os dados em repouso não são armazenados fora dela. O preço é o mesmo para todas as regiões.

A especificação de uma região é particularmente útil nos seguintes casos de uso:

  • Seu sistema tem 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 da Bélgica usarem europe-west1, eles poderão esperar uma latência melhor.

Regiões disponíveis

Grupos de países Localização geográfica ID da região ID da região do repositório de dados
Américas Iowa us-central1 us (multirregional)
Américas Carolina do Sul us-east1
Américas Oregon us-west1
Américas Montreal northamerica-northeast1 global (multirregional)
Américas Estados Unidos (multirregional) us * us (multirregional) *
Europa Bélgica europe-west1 eu (multirregional)
Europa Londres europe-west2
Europa Frankfurt europe-west3
Europa Eemshaven europe-west4 eu (multirregional)
Europa Zurique europe-west6 eu (multirregional)
Ásia-Pacífico Singapura asia-southeast1
Ásia-Pacífico Jacarta asia-southeast2 global (multirregional)
Ásia-Pacífico Tóquio asia-northeast1
Ásia-Pacífico Mumbai asia-south1
Ásia-Pacífico Sydney australia-southeast1
Global Multirregional global (disponibilização global, dados em repouso nos Estados Unidos) global (recomendado) ou nenhuma região (padrão) ¶ global (multirregional) ¶
Símbolo Descrição
* A Vertex AI não oferece suporte ao local multirregional "us". Como resultado, o uso dos recursos de IA generativa do Agent Assist na multirregião "us" vai depender dos endpoints de região única dos EUA.
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.

Recursos disponíveis para disponibilização regional

ID da região Resumo com seções personalizadas v6.0/5.0/4.0 Avaliação automática de resumo Análise de sentimento (v3) Assistência de conhecimento generativo (proativa) Criar sua própria assistência (pré-lançamento) coach de IA
us-central1 ✓ ✓ ✓ ✓ ✓ ✓
us-east1 ✓ ✓ ✓ ✓ ✓ ✓
us-west1 ✓ ✓ ✓ ✓ ✓ ✓
us ✓ ✓ ✓ ✓ ✓
northamerica-northeast1 ✓ ✓ ✓ ✓ ✓ ✓
europe-west1 ✓ ✓ ✓ ✓ ✓ ✓
europe-west2 ✓ ✓ ✓ ✓ ✓ ✓
europe-west3 ✓ ✓ ✓ ✓ ✓ ✓
europe-west4 ✓ ✓ ✓ ✓ ✓ ✓
europe-west6 ✓ ✓ ✓ ✓ ✓
asia-southeast1 ✓ ✓ ✓ ✓ ✓ ✓
asia-southeast2 ✓ ✓ ✓ ✓ ✓
asia-northeast1 ✓ ✓ ✓ ✓ ✓ ✓
asia-south1 ✓ ✓ ✓ ✓ ✓ ✓
australia-southeast1 ✓ ✓ ✓ ✓ ✓ ✓
global ✓ ✓ ✓ ✓ ✓ ✓

Dados em repouso

Todos os dados do usuário e do usuário final do desenvolvedor do Agent Assist estão incluídos nos dados em repouso. Exemplo:

Limitações

Considere as seguintes limitações:

  • O console do Agent Assist não oferece suporte à regionalização. Só é possível implementar a regionalização chamando a API diretamente.
  • O treinamento de modelos não oferece suporte à regionalização. Seus dados podem ser roteados para fora da região durante esse processo.

  • O APIs Explorer, encontrado em muitos documentos de referência da API REST, só oferece suporte à região global para chamadas de API.

  • A transcrição de CCAI só oferece suporte a dados multirregionais em uso e dados em repouso (se o recurso de adaptação de voz não for usado) na UE, nos EUA e na América do Norte (Canadá).

  • Somente as seguintes regiões são aceitas para repositórios de dados, usados pelo recurso de assistência de conhecimento generativo (proativa): global, multirregional us e multirregional eu.

  • O embasamento com a Pesquisa Google (GWGS, na sigla em inglês) não oferece suporte à residência de dados (DRZ). Quando ativado, esse controle não se aplica a solicitações de pesquisa. Para mais informações, consulte Controles de segurança da plataforma de agentes do Gemini Enterprise.

Especificar uma região usando a API

Para usar a regionalização, é necessário especificar uma região para cada solicitação de API.

Campos obrigatórios:

  • Forneça o ID da região para o parâmetro de caminho do URL location.

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

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 de cliente, as seguintes etapas são necessárias:

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

  • Defina o nome do recurso com o local correto, por exemplo:

    projects/project_id/locations/region_id/knowledgeBases/knowledge_base_id

Credenciais

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

Se você precisar fornecer credenciais manuais no código, uma etapa extra será necessária antes de chamar um endpoint regionalizado. É necessário definir o escopo como https://www.googleapis.com/auth/cloud-platform ao gerar suas credenciais de autenticação. O exemplo a seguir demonstra como fazer isso 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 em que os registros são armazenados.