Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
O Assistente do agente oferece
residência de dados
para manter seus dados em repouso
fisicamente em uma região ou local geográfico especificado. Quando você especifica
uma região, os dados em repouso não são armazenados fora dela. Os preços são os mesmos para todas as regiões.
Especificar uma região é ú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 (multirregião)
Américas
Carolina do Sul
us-east1
Américas
Oregon
us-west1
Américas
Montreal
northamerica-northeast1
global (multirregião)
Américas
Estados Unidos, multirregião
us *
us (multirregião) *
Europa
Bélgica
europe-west1
eu (multirregião)
Europa
Londres
europe-west2
Europa
Frankfurt
europe-west3
Europa
Eemshaven
europe-west4
eu (multirregião)
Europa
Zurique
europe-west6
eu (multirregião)
Ásia-Pacífico
Singapura
asia-southeast1
Ásia-Pacífico
Jacarta
asia-southeast2
global (multirregião)
Á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 (multirregião) ¶
Símbolo
Descrição
*
A Vertex AI não oferece suporte ao local de várias regiões "us". Como resultado, o uso dos recursos de IA generativa do Assistente pessoal na multirregião "us" vai depender dos respectivos 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 veiculação regional
ID da região
Resumo com seções personalizadas v4.0
Resumo com seções personalizadas v3.1/3.0
Análise de sentimento
Assistência de Knowledge Assist generativa (proativa)
Crie sua própria assistência (pré-lançamento)
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 Assistente estão incluídos nos dados em repouso.
Exemplo:
A Transcrição por IA de conversação só oferece suporte a dados em uso e em repouso em várias regiões (se não estiver usando o recurso de adaptação de voz) na UE, nos EUA e na América do Norte (Canadá).
Somente as seguintes regiões são compatíveis com os repositórios de dados usados pelo recurso de assistência de conhecimento generativo (proativo): global, us multirregião e eu multirregião.
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 para o
nome do host. Para todas as outras regiões, use [region-id]-dialogflow.googleapis.com
como o nome do host.
Recomendamos que você 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 como definir essa variável.
Se você precisar fornecer credenciais manuais no código, será necessário realizar uma etapa
extra antes de chamar um endpoint regionalizado. É necessário definir
o escopo como https://www.googleapis.com/auth/cloud-platform ao gerar
as credenciais de autenticação. O exemplo a seguir demonstra como fazer
isso em Java ao criar um objeto GoogleCredentials:
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-08-19 UTC."],[[["\u003cp\u003eAgent Assist offers data residency, ensuring your data-at-rest is stored within a specified geographical region you select.\u003c/p\u003e\n"],["\u003cp\u003eSpecifying a region can be crucial for systems with regulatory data location requirements or for improving network latency for customers in a specific area.\u003c/p\u003e\n"],["\u003cp\u003eData residency only applies to data-at-rest; it does not cover data-in-use or data-in-transit, so these will not be covered by this regionality.\u003c/p\u003e\n"],["\u003cp\u003eTo implement regionalization, you must specify a region ID in every API request and adjust the hostname accordingly, such as using \u003ccode\u003e[region-id]-dialogflow.googleapis.com\u003c/code\u003e instead of \u003ccode\u003edialogflow.googleapis.com\u003c/code\u003e for the global region.\u003c/p\u003e\n"],["\u003cp\u003eThe Agent Assist Console and Model training do not support regionalization, so it can only be done by calling the API directly, and model training may send data outside of the region.\u003c/p\u003e\n"]]],[],null,["# Regionalization and data residency\n\nAgent Assist provides\n[data residency](https://cloud.google.com/blog/products/identity-security/meet-data-residency-requirements-with-google-cloud)\nto keep your [data-at-rest](https://en.wikipedia.org/wiki/Data_at_rest)\nphysically within a specified geographical region or location. When you specify\na region, your data-at-rest is not stored outside that region. Pricing is the\nsame for all regions.\n\nSpecifying a region is particularly helpful in the following use cases:\n\n- Your system has regulatory or policy requirements that govern where your data must reside.\n- Your network latencies might be improved when the data is in the same region as your customers. For example, if Belgium customers use `europe-west1`, they can expect better latency.\n\n| **Important:** The [AI/ML data location](/terms/data-residency) (data residency for ML processing, or DRZ) commitment is only supported in locations in the US and EU. When requests are made to multi-region APIs, ML processing for generative models may occur in any of those regions. For non-AI/ML data (in use or transit) or data outside US and EU multi-regions, the DRZ commitment doesn't apply. For details, see the [Vertex AI documentation](/vertex-ai/generative-ai/docs/learn/locations).\n\nAvailable regions\n-----------------\n\nAvailable features for regional serving\n---------------------------------------\n\nData-at-rest\n------------\n\nAll Agent Assist developer user and end-user data is included in data-at-rest.\nFor example:\n\n- [Knowledge bases](/agent-assist/docs/knowledge-base) and [knowledge documents](/agent-assist/docs/knowledge-documents).\n- [Conversation profiles](/agent-assist/docs/basics#conversation_profiles).\n- [Conversation](/agent-assist/docs/basics#conversations) and message histories.\n- [Conversion participants](/agent-assist/docs/basics#participants).\n- Suggestions returned by Agent Assist.\n- [Feedbacks](/agent-assist/docs/feedback).\n\nLimitations\n-----------\n\nThe following limitations apply:\n\n- The **Agent Assist console** doesn't support regionalization. You can only implement regionalization by calling the API directly.\n- [Model training](/agent-assist/docs/model-training) does not support regionalization. Your data may get routed outside the region during this process.\n- [API Explorer](https://developers.google.com/explorer-help/), found on many\n [REST reference documents](/dialogflow/es/docs/reference/rest), only supports\n the `global` region for API calls.\n\n- [CCAI Transcription](/agent-assist/docs/transcription) only\n supports multi-region data in use and data at rest (if not using the Speech\n Adaptation feature) in EU, US, North America (Canada).\n\n- Only the following regions are supported for data stores, used by (Proactive) Generative Knowledge Assist feature: `global`, `us` multi-region, and `eu` multi-region.\n\nSpecify a region using the API\n------------------------------\n\nTo use regionalization you must specify a region for every API request.\n\nRequired fields:\n\n- Provide the region ID for the `location` URL path parameter.\n\n- For the `global` region, use `dialogflow.googleapis.com` for the\n hostname. For all other regions, use `[region-id]-dialogflow.googleapis.com`\n for the hostname.\n\nFor example:\n\n- `dialogflow.googleapis.com/v2/projects/project_id/locations/global/knowledgeBases/knowledge_base_id`\n\n- `us-central1-dialogflow.googleapis.com/v2/projects/project_id/locations/us-central1/knowledgeBases/knowledge_base_id`\n\nTo use [client libraries](/agent-assist/docs/reference-index), the following\nsteps are required:\n\n- Set the service endpoint to: `REGION_ID-dialogflow.googleapis.com`.\n- Set the resource name with the correct location, for example:\n\n projects/project_id/locations/region_id/knowledgeBases/knowledge_base_id\n\nCredentials\n-----------\n\nWe recommend that you use the \u003cvar translate=\"no\"\u003eGOOGLE_APPLICATION_CREDENTIALS\u003c/var\u003e\nenvironment variable to provide your client libraries with credentials.\nSee the [Dialogflow setup instructions](/dialogflow/es/docs/quick/setup#auth-env)\nfor more information about setting this variable.\n\nIf you instead need to provide manual credentials in your code, one additional\nstep is required before you can call a regionalized endpoint. You must set\nthe scope to https://www.googleapis.com/auth/cloud-platform when you generate\nyour authentication credentials. The following example demonstrates how to do\nthis in Java when creating a `GoogleCredentials` object: \n\n GoogleCredentials.fromStream(new FileInputStream(\"credential_file\"))\n .createScoped(\"https://www.googleapis.com/auth/cloud-platform\")\n\nCloud Logging\n-------------\n\nSee the [Cloud Logging documentation](/dialogflow/es/docs/logging) to control\nthe region where your logs are stored."]]
