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 conserva i dati at-rest fisicamente all'interno della regione o località geografica. Per ottenere le migliori prestazioni, devi scegliere una regione vicina ai tuoi servizi e agli 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 in un nuovo agente con una località diversa.
A ogni località sono associate impostazioni che si applicano a tutto il progetto. Nella maggior parte dei casi, non è necessario modificare queste impostazioni di localizzazione e le impostazioni predefinite funzioneranno 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 localizzazione.
Limitazioni
Si applicano le seguenti limitazioni:
Il supporto per le diverse integrazioni di telefonia può variare in base alla regione. Consulta la documentazione di ogni integrazione.
Il supporto delle entità di sistema varia in base alla 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.
Regioni disponibili
Dialogflow CX supporta le seguenti regioni per la località 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 del datastore sono supportate dagli agenti del datastore in Vertex AI Agents.
| Raggruppamento per paese | Posizione geografica | ID regione dell'agente | ID regione del datastore |
|---|---|---|---|
| Americhe | Iowa | us-central1 |
us (multiregionale) |
| Americhe | Montréal | northamerica-northeast1 |
global (multiregionale) |
| Americhe | Carolina del Sud | us-east1 |
us (multiregionale) |
| Americhe | Oregon | us-west1 |
us (multiregionale) |
| Americhe | Stati Uniti (multiregionale) | us * |
us (multiregionale) |
| Europa | Belgio | europe-west1 |
eu (multiregionale) |
| Europa | Londra | europe-west2 |
eu (multiregionale) |
| Europa | Francoforte | europe-west3 |
eu (multiregionale) |
| Europa | Paesi Bassi | europe-west4 |
eu (multiregionale) |
| Europa | Zurigo | europe-west6 |
eu (multiregionale) |
| Asia Pacifico | Sydney | australia-southeast1 |
global (multiregionale) |
| Asia Pacifico | Tokyo | asia-northeast1 |
global (multiregionale) |
| Asia Pacifico | Mumbai | asia-south1 |
global (multiregionale) |
| Asia Pacifico | Singapore | asia-southeast1 |
global (multiregionale) |
| Asia Pacifico | Giacarta | asia-southeast2 |
global (multiregionale) |
| Globale | Multiregione globale (pubblicazione globale, dati at-rest negli Stati Uniti) | global (preferita) o nessuna regione (predefinita) ¶ |
global (multiregionale) ¶ |
| Simbolo | Descrizione |
|---|---|
| * | Per i modelli Gemini 2.x, Vertex AI non supporta le località multiregionali us o eu. Di conseguenza, l'utilizzo delle funzionalità di AI generativa di Dialogflow CX nelle multi-regioni us o eu si basa sui rispettivi endpoint esistenti per le singole regioni degli Stati Uniti o dell'UE. Per Gemini 3 e modelli successivi (come gemini-3.1-flash-lite), le località multi-regione us e eu sono supportate e utilizzate per le regioni degli Stati Uniti e dell'Europa. Per saperne di più, consulta Quote di IA generativa. |
| ¶ | Le chiamate alla regione global potrebbero avere una latenza maggiore se effettuate dall'esterno degli Stati Uniti. Se possibile, preferisci una regione più specifica, più vicina ai tuoi servizi e agli 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 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
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 per le località delle risorse.
Se crei un agente senza modificare le impostazioni di localizzazione, verranno configurate le impostazioni predefinite per quella località, che non possono 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 in un nuovo agente con una località diversa.
Sono disponibili le seguenti impostazioni di localizzazione:
- Crittografia: questa impostazione controlla se per proteggere i dati vengono utilizzate chiavi di crittografia gestite da Google o chiavi di crittografia gestite dal cliente. 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 nell'interfaccia di selezione degli agenti.
- Fai clic sul pulsante Modifica accanto al menu a discesa Località quando crei 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:
Specifica l'ID regione per il parametro di percorso dell'URL
location.Per la regione
global, utilizzadialogflow.googleapis.comper il nome host. Per tutte le altre regioni, utilizza[region-id]-dialogflow.googleapis.comcome 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 all'API.
Cloud Logging
Consulta la guida di Cloud Logging per controllare la regione in cui vengono archiviati i log.