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 le migliori prestazioni, devi scegliere una regione vicina ai tuoi servizi e utenti finali.
Una volta creato un agente, la sua località non può essere modificata. Per modificare la località di un agente, devi esportare e ripristinare un nuovo agente con una località diversa.
A ogni località sono associate impostazioni che si applicano 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 geolocalizzazione.
Limitazioni
Si applicano le seguenti limitazioni:
Il supporto nelle diverse aree geografiche per integrazioni di telefonia può variare. Consulta la documentazione per ogni integrazione.
Il supporto delle entità di sistema varia a seconda della lingua. Per i 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 dei datastore supportano un sottoinsieme di queste regioni e gli ID regione utilizzati dai datastore sono leggermente diversi dalle 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 di 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 (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 a livello globale (servizio globale, dati at-rest negli Stati Uniti) | global (preferito) o nessuna regione (impostazione predefinita) ¶ |
global (più regioni) ¶ |
Simbolo | Descrizione |
---|---|
* | Vertex AI non supporta la località con più regioni "us". Di conseguenza, l'utilizzo delle funzionalità di IA generativa di Dialogflow CX in più regioni "us" si baserà sui rispettivi endpoint esistenti delle singole regioni degli Stati Uniti. |
¶ | Le chiamate verso la regione global potrebbero avere una latenza maggiore se vengono chiamate al di fuori degli Stati Uniti. Se possibile, preferisci una regione più specifica più vicina ai tuoi servizi e ai tuoi utenti finali. |
Per saperne di più sulle regioni utilizzate da Google Cloud, consulta le regioni di Google Cloud e le aree geografiche e le 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 nell'intero progetto e ogni sede univoca ha le proprie impostazioni. Una volta configurate le impostazioni di una località specifica per un progetto, 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 della 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ò essere modificata. Per modificare la località di un agente, devi esportare e ripristinare un nuovo agente con una località diversa.
Sono disponibili le seguenti impostazioni di geolocalizzazione:
- Crittografia: questa impostazione consente di stabilire se utilizzare le chiavi di crittografia gestite da Google o dal cliente 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 di geolocalizzazione dall'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
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 relativa alla libreria client per un'opzione di configurazione per la regione.
Puoi trovare esempi nella guida rapida delle API.
Cloud Logging
Consulta la guida a Cloud Logging per controllare la regione in cui sono archiviati i log.