Impostazioni di regionalizzazione e località

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

Una volta creato un agente, la sua posizione non può essere modificata. Per modificare la posizione di un agente, devi esportare e ripristinare un nuovo agente con una posizione diversa.

Ogni località ha impostazioni associate che vengono applicate al tuo progetto. Nella maggior parte dei casi, non è necessario modificare queste impostazioni di geolocalizzazione e le impostazioni predefinite funzioneranno correttamente. 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 localizzazione.

Limitazioni

Si applicano le seguenti limitazioni:

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

• Il supporto delle entità di sistema varia in base alla lingua. Per maggiori dettagli, consulta la sezione Limitazioni delle entità di sistema.

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

Regioni disponibili

Importante: l'impegno "Posizione dei dati AI/ML" (residenza dei dati per l'elaborazione ML) è supportato solo nelle località all'interno di Stati Uniti e UE. L'elaborazione ML per i modelli generativi può avvenire in qualsiasi località delle multi-regioni quando vengono effettuate richieste alle API regionali incluse in una multi-regione. Per maggiori dettagli, consulta la documentazione di Vertex AI.

Dialogflow CX supporta le seguenti regioni per la posizione dell'agente. Gli agenti datastore sono supportati anche nelle regioni elencate nella tabella seguente, ma gli ID regione utilizzati dai datastore differiscono leggermente dalle regioni degli agenti (come elencato). Tutte le regioni con un valore inserito nella colonna ID regione datastore sono supportate dagli agenti datastore in Vertex AI Conversation.

Raggruppamento di paesi	Posizione geografica	ID regione agente	ID regione datastore
Americhe	Iowa	us-central1	us (multi-regione)
Americhe	Montréal	northamerica-northeast1	global (multi-regione)
Americhe	Carolina del Sud	us-east1	us (multi-regione)
Americhe	Oregon	us-west1	us (multi-regione)
Americhe	Stati Uniti (multi-regione)	us *	us (multi-regione)
Europa	Belgio	europe-west1	eu (multi-regione)
Europa	Londra	europe-west2	eu (multi-regione)
Europa	Francoforte	europe-west3	eu (multi-regione)
Europa	Paesi Bassi	europe-west4	eu (multi-regione)
Europa	Zurigo	europe-west6	eu (multi-regione)
Asia Pacifico	Sydney	australia-southeast1	global (multi-regione)
Asia Pacifico	Tokyo	asia-northeast1	global (multi-regione)
Asia Pacifico	Mumbai	asia-south1	global (multi-regione)
Asia Pacifico	Singapore	asia-southeast1	global (multi-regione)
Asia Pacifico	Giacarta	asia-southeast2	global (multi-regione)
Globale	Più regioni globali (servizio globale, dati at-rest negli Stati Uniti)	global (preferito) o nessuna regione (predefinita) ¶	global (più regioni) ¶

Simbolo	Descrizione
*	Vertex AI non supporta la località multiregionale "us". Di conseguenza, l'utilizzo delle funzionalità di AI generativa di Dialogflow CX nella multiregione "us" si baserà sugli endpoint esistenti delle singole regioni degli Stati Uniti.
¶	Le chiamate alla regione global potrebbero avere una latenza maggiore se effettuate al di fuori degli Stati Uniti. Se possibile, preferisci una regione più specifica e vicina ai tuoi servizi e utenti finali.

Puoi scoprire di più sulle regioni utilizzate da Google Cloud in Regioni Google Cloud e Aree geografiche 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 localizzazione per configurare questa funzionalità.

Le impostazioni della posizione sono condivise nel progetto e ogni posizione unica ha le proprie impostazioni.

Una volta configurate le impostazioni per una località specifica per un progetto, viene creata una risorsa dialogflow.googleapis.com/LocationSettings immutabile e le impostazioni non possono essere modificate per quella località. Se devi modificare queste impostazioni o eliminare la risorsa, devi creare un nuovo progetto.

Se devi consentire agli sviluppatori della tua organizzazione di configurare gli agenti solo in località specifiche, puoi configurare una policy dell'organizzazione che includa un vincolo sulle località delle risorse.

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

Sono disponibili le seguenti impostazioni di geolocalizzazione:

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

Puoi configurare le impostazioni di geolocalizzazione in due modi:

• Fai clic su Impostazioni di localizzazione dall'interfaccia di selezione dell'agente.
• Fai clic sul pulsante Modifica accanto al menu a discesa Posizione quando crei un agente.

Nota: al momento non puoi aggiornare le impostazioni di geolocalizzazione con l'API.

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 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 all'API.

Attenzione:come descritto nella documentazione di configurazione, devi utilizzare la variabile di ambiente GOOGLE_APPLICATION_CREDENTIALS per fornire le credenziali alle librerie client. Tuttavia, se devi fornire manualmente un file delle credenziali nel codice, devi eseguire un passaggio aggiuntivo quando chiami un endpoint regionalizzato. Imposta l'ambito su https://www.googleapis.com/auth/cloud-platform quando generi le credenziali di autenticazione. Ad esempio, questo viene eseguito in Java quando viene creato un oggetto GoogleCredentials:

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

Cloud Logging

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