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 ed eseguire il ripristino 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 delle regioni per le diverse integrazioni di telefonia può variare. 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. 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 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 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 US o EU. 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 da paesi diversi dagli Stati Uniti. Se possibile, preferisci 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 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 in tutto il 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, per quella località verranno configurate le impostazioni predefinite, 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 ed eseguire il ripristino 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 del selettore 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:
Fornisci l'ID regione per il parametro di percorso dell'URL
location.Per la regione
global, utilizzadialogflow.googleapis.comcome nome host. Per tutte le altre regioni, utilizza[region-id]-dialogflow.googleapis.comcome nome host. Per la regione multiplaus, puoi anche utilizzare l'endpoint multiregionale Stati Uniti.
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.
Utilizza l'endpoint multiregionale Stati Uniti
Se i tuoi agenti si trovano nella regione us, puoi inviare richieste API all'endpoint multiregionale degli Stati Uniti, dialogflow.us.rep.googleapis.com. Un endpoint multiregionale termina TLS ed elabora le richieste all'interno della multi-regione, in modo che i dati delle richieste rimangano negli Stati Uniti durante il transito. L'utilizzo di questo endpoint non modifica la posizione in cui vengono archiviati i dati dell'agente. Per saperne di più, consulta Panoramica degli endpoint API regionali e multiregionali nella guida alla sicurezza di Google Cloud .
Per utilizzare l'endpoint multiregionale degli Stati Uniti, apporta le seguenti modifiche a ogni richiesta:
Utilizza
dialogflow.us.rep.googleapis.comper il nome host.Imposta il parametro di percorso dell'URL
locationsuus.
Ad esempio:
dialogflow.us.rep.googleapis.com/v3/projects/{PROJECT_ID}/locations/us/agents/{AGENT_ID}
Utilizza l'endpoint multiregionale degli Stati Uniti solo per le risorse nella località us.
Per le risorse in altre località, tra cui us-central1, us-east1 e us-west1, utilizza il nome host per quella località.
Per utilizzare l'endpoint multiregionale degli Stati Uniti con le librerie client, imposta l'opzione dell'endpoint API del client su dialogflow.us.rep.googleapis.com. Ad esempio, in Python, passa client_options={"api_endpoint": "dialogflow.us.rep.googleapis.com"} quando crei il client. Se utilizzi Terraform, imposta il campo dialogflow_cx_custom_endpoint del provider Google su https://dialogflow.us.rep.googleapis.com/v3/. Questa impostazione invia tutte le richieste Dialogflow CX del provider all'endpoint multiregionale degli Stati Uniti, quindi utilizzala solo per le risorse nella località us.
Per l'elenco degli endpoint di servizio regionali e multiregionali, consulta Endpoint di servizio regionali e multiregionali nella guida di Virtual Private Cloud.
Cloud Logging
Consulta la guida di Cloud Logging per controllare la regione in cui vengono archiviati i log.