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 mantiene i dati at-rest fisicamente all'interno della regione o della località geografica. Per ottenere prestazioni ottimali, dovresti scegliere una regione vicina ai tuoi servizi e agli utenti finali.
Una volta creato un agente, la sua località non può cambiare. Per modificare la località di un agente, devi eseguire l'esportazione e il ripristino in un nuovo agente con una località diversa.
A ogni località sono associate delle impostazioni che si applicano all'intero progetto. Nella maggior parte dei casi non è necessario modificare queste impostazioni di geolocalizzazione e le impostazioni predefinite andranno 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 regionale per le diverse integrazioni di telefonia può variare. Controlla la documentazione per ogni integrazione.
Il supporto delle entità di sistema varia in base a ogni lingua. Per maggiori dettagli, consulta le limitazioni delle entità di sistema.
Explorer API, disponibile in molti documenti di riferimento REST, supporta solo la regione
global
per le chiamate API.
Aree geografiche disponibili
Dialogflow CX supporta le seguenti regioni per la località dell'agente. Gli agenti del datastore supportano un sottoinsieme di queste regioni e gli ID regione utilizzati dai datastore sono leggermente diversi da quelli delle regioni dell'agente. Tutte le regioni con un valore per la colonna ID regione del datastore sono supportate dagli agenti del datastore in Vertex AI Conversation.
Raggruppamento per paese | Posizione geografica | ID regione agente | ID regione 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 (più regioni) | 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 | Più regioni globali (pubblicazione a livello globale, data-at-rest negli Stati Uniti) | global (preferita) o nessuna regione (predefinita) ¶ |
global (più regioni) ¶ |
Simbolo | Descrizione |
---|---|
* | Vertex AI non supporta la località multiregionale "us". Di conseguenza, l'utilizzo delle funzionalità di IA generativa di Dialogflow CX in "noi" multiregionali si baserà sui rispettivi endpoint a regione singola degli Stati Uniti esistenti. |
¶ | Le chiamate verso la regione global potrebbero avere una latenza più elevata se effettuate al di fuori degli Stati Uniti. Preferisci una regione più specifica e più vicina ai tuoi servizi e utenti finali, se possibile. |
Per scoprire di più sulle regioni utilizzate da Google Cloud, consulta Regioni di Google Cloud e Area geografica 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 sono condivise all'interno del progetto e ogni località ha le proprie impostazioni di geolocalizzazione. Dopo aver configurato le impostazioni di un progetto per una località specifica, non è possibile modificare quelle per quella località. Se devi modificare queste impostazioni, devi creare un nuovo progetto.
Se crei un agente senza modificare le impostazioni di località, verranno configurate le impostazioni predefinite per quella località e non potranno essere modificate per il progetto. Inoltre, una volta creato un agente, la sua località non può cambiare. Per modificare la località di un agente, devi eseguire l'esportazione e il ripristino in un nuovo agente con una località diversa.
Sono disponibili le seguenti impostazioni di geolocalizzazione:
- Crittografia: questa impostazione controlla se le chiavi di crittografia gestite da Google o dal cliente vengono utilizzate per proteggere i dati. L'impostazione predefinita è gestita 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 località nell'interfaccia del selettore agente.
- Fai clic sul pulsante Modifica accanto al menu a discesa Località durante la creazione di 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 località multiregionale
us
, utilizzausa-dialogflow.googleapis.com
come nome host. Per tutte le altre regioni, utilizza[region-id]-dialogflow.googleapis.com
come nome host.
Ad esempio:
usa-dialogflow.googleapis.com/projects/{PROJECT_ID}/locations/us/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 trovare un'opzione di configurazione per regione.
Puoi trovare esempi nella guida rapida delle API.
Cloud Logging
Consulta la guida di Cloud Logging per controllare la regione in cui sono archiviati i log.