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:
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 a seconda della lingua. Per maggiori dettagli, consulta le limitazioni delle entità di sistema.
Explorer API, disponibile in molti documenti di riferimento REST, supporta solo la regione
globalper le chiamate API.
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) ¶ |
| Simbolo | Descrizione |
|---|---|
| * | Vertex AI non supporta la località multi-regione "us". Di conseguenza, l'utilizzo delle funzionalità di AI generativa di Dialogflow CX nella multi-regione "us" si baserà sui rispettivi endpoint a regione singola esistenti negli Stati Uniti. |
| ¶ | Le chiamate alla regione global potrebbero avere una latenza maggiore se effettuate al di fuori degli Stati Uniti. Se possibile, scegli una regione più specifica e 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.
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:
- Fai clic su Impostazioni di localizzazione dall' interfaccia del selettore dell'agente.
- Fai clic sul pulsante Modifica accanto al menu a discesa Località quando crei un agente.
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, utilizzadialogflow.googleapis.comper il nome host. Per tutte le altre regioni, utilizza[region-id]-dialogflow.googleapis.comper 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.