Impostazioni di regionalizzazione e località

Quando crei un agente, devi specificare una regione come località 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 località geografica. Per ottenere prestazioni ottimali, devi scegliere una regione vicina ai tuoi servizi e agli utenti finali.

Una volta creata, la località di un agente non può essere modificata. Per modificare la località di un agente, devi esportarlo e ripristinarlo in un nuovo agente con una località diversa.

Ogni località ha impostazioni associate che si applicano al tuo progetto. Nella maggior parte dei casi, non è necessario modificare queste impostazioni di localizzazione 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:

Aree geografiche disponibili

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

Raggruppamento 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 Multi-regione globale (servizio globale, dati at-rest negli Stati Uniti) global (opzione preferita) o nessuna regione (impostazione predefinita) ¶ global (multi-regione) ¶

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

Impostazioni di localizzazione

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 di localizzazione sono condivise nel progetto e ogni località univoca ha le proprie impostazioni di localizzazione.

Una volta configurate le impostazioni per una località specifica per un progetto, viene creata una risorsa dialogflow.googleapis.com/LocationSettings non modificabile 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 delle località delle risorse.

Se crei un agente senza modificare le impostazioni di localizzazione, verranno configurate le impostazioni predefinite per quella località e non potranno essere modificate per il progetto. Inoltre, una volta creata, la località di un agente non può essere modificata. Per modificare la località di un agente, devi esportarlo e ripristinarlo in un nuovo agente con una località diversa.

Sono disponibili le seguenti impostazioni di localizzazione:

  • 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 alla funzionalità delle chiavi di crittografia gestite dal cliente (contattando il tuo rappresentante di Google).

Puoi configurare le impostazioni di localizzazione in due modi:

Specificare 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 della libreria 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.