Impostazioni di regionalizzazione e località

Quando crei un agente, devi specificare una regione come posizione dell'agente. Le richieste inviate all'agente vengono gestite dai servizi Google in questa regione e Conversational Agents (Dialogflow CX) mantiene i dati at-rest fisicamente all'interno della regione o località geografica. Per ottenere le migliori prestazioni, devi scegliere una regione vicina ai tuoi servizi e agli utenti finali.

Una volta creato, l'agente non può essere spostato. Per modificare la località di un agente, devi esportare e ripristinare in un nuovo agente con una località diversa.

A ogni località sono associate impostazioni che si applicano al progetto. Nella maggior parte dei casi, non è necessario modificare queste impostazioni di geolocalizzazione, poiché quelle predefinite funzioneranno bene. Se il tuo sistema richiede chiavi di crittografia gestite dal cliente (spesso richieste da enti governativi o settori regolamentati), scopri di più sulle impostazioni di geolocalizzazione.

Limitazioni

Si applicano le seguenti limitazioni:

• Il supporto delle regioni per le diverse integrazioni di telefonia può variare. Controlla la documentazione per ogni integrazione.

• Il supporto delle entità di sistema varia in base alla lingua. Per maggiori dettagli, consulta le limitazioni delle entità di sistema.

• L'Explorer API, presente in molti documenti di riferimento REST, supporta solo la regione global per le chiamate API.

Aree geografiche disponibili

Conversational Agents (Dialogflow CX) supporta le seguenti regioni per la posizione dell'agente. Gli agenti dei datastore supportano un sottoinsieme di queste regioni e gli ID regione utilizzati dai datastore sono leggermente diversi da quelli delle regioni degli agenti. Tutte le regioni con un valore per la colonna ID regione del datastore sono supportate dagli agenti del datastore in Vertex AI Conversation.

Raggruppamento dei paesi	Posizione geografica	ID regione agente	ID regione del datastore
Americhe	Iowa	us-central1	us (più regioni)
Americhe	Montréal	northamerica-northeast1
Americhe	Carolina del Sud	us-east1
Americhe	Oregon	us-west1
Americhe	Stati Uniti (multiregione)	us *	us (più regioni) *
Europa	Belgio	europe-west1	eu (più regioni)
Europa	Londra	europe-west2
Europa	Francoforte	europe-west3
Asia Pacifico	Sydney	australia-southeast1
Asia Pacifico	Tokyo	asia-northeast1
Asia Pacifico	Mumbai	asia-south1
Asia Pacifico	Singapore	asia-southeast1
Globale	Multiregione globale (pubblicazione a livello globale, dati at-rest negli Stati Uniti)	global (opzione preferita) o nessuna regione (impostazione predefinita) ¶	global (più regioni) ¶

Simbolo	Descrizione
*	Vertex AI non supporta la località multiregionale "us". Di conseguenza, l'utilizzo delle funzionalità di IA generativa degli agenti di conversazione (Dialogflow CX) nella regione multipla "us" si baserà sui rispettivi endpoint esistenti per una singola regione degli Stati Uniti.
¶	Le chiamate alla regione global potrebbero avere una latenza più elevata se effettuate da paesi diversi dagli Stati Uniti. Se possibile, preferisci una regione più specifica più vicina ai tuoi servizi e agli utenti finali.

Puoi scoprire di più sulle regioni utilizzate da Google Cloud in Regioni di Google Cloud e Geografia e regioni di Google Cloud.

Geolocalizzazione

Se il tuo sistema richiede chiavi di crittografia gestite dal cliente (spesso richieste da enti governativi o settori regolamentati), puoi utilizzare le impostazioni di geolocalizzazione per configurare questa funzionalità.

Le impostazioni di geolocalizzazione vengono condivise all'interno del progetto e ogni posizione univoca ha le proprie impostazioni di geolocalizzazione. Una volta configurate le impostazioni per una località specifica per un progetto, le impostazioni non possono essere modificate per quella località. Se devi modificare queste impostazioni, devi creare un nuovo progetto.

Se crei un agente senza modificare le impostazioni di geolocalizzazione, le impostazioni predefinite verranno configurate per quella località e non potranno essere modificate per il progetto. Inoltre, una volta creato, l'agente non può essere spostato. Per modificare la località di un agente, devi esportare e ripristinare in un nuovo agente con una località diversa.

Sono disponibili le seguenti impostazioni di geolocalizzazione:

• Crittografia: questa impostazione controlla se per proteggere i dati vengono utilizzate chiavi di crittografia gestite da Google o gestite dal cliente. Il valore predefinito è Gestito da Google. Per modificare questa impostazione, devi richiedere l'accesso (contatta il tuo rappresentante di Google) alla funzionalità delle chiavi di crittografia gestite dal cliente.

Puoi configurare le impostazioni di geolocalizzazione in due modi:

• Fai clic su Impostazioni posizione nell'interfaccia di selezione dell'agente.
• Fai clic sul pulsante Modifica accanto al menu a discesa Località quando crei un agente.

Specifica una regione con l'API

Devi specificare una regione per tutte le richieste API.

Per le chiamate REST, devi eseguire entrambe le seguenti operazioni:

• Fornisci l'ID regione per il parametro del percorso dell'URL location.

• Per la regione global, utilizza dialogflow.googleapis.com per il nome host. Per tutte le altre regioni, utilizza [region-id]-dialogflow.googleapis.com per il nome host.

Ad esempio:

• dialogflow.googleapis.com/projects/{PROJECT_ID}/locations/global/agents/{AGENT_ID}

• us-central1-dialogflow.googleapis.com/projects/{PROJECT_ID}/locations/us-central1/agents/{AGENT_ID}

Per le librerie client, consulta la documentazione delle librerie client per un'opzione di configurazione della regione.

Puoi trovare esempi nella guida rapida dell'API.

Cloud Logging

Consulta la guida di Cloud Logging per controllare la regione in cui vengono archiviati i log.