Quando crei un agente, devi specificare una regione come posizione dell'agente. Le richieste inviate all'agente vengono gestite dai servizi Google in questa regione e Conversational Agents (Dialogflow CX) mantiene 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, l'agente non può essere spostato. 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 al progetto. Nella maggior parte dei casi, non è necessario modificare queste impostazioni di geolocalizzazione, poiché quelle 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 geolocalizzazione.
Limitazioni
Si applicano le seguenti limitazioni:
Il supporto delle regioni per le diverse integrazioni di telefonia può variare. Controlla la documentazione per ogni integrazione.
Il supporto delle entità di sistema varia in base alla lingua. Per maggiori dettagli, consulta le limitazioni delle entità di sistema.
L'Explorer API, presente in molti documenti di riferimento REST, supporta solo la regione
globalper le chiamate API.
Aree geografiche disponibili
Conversational Agents (Dialogflow CX) supporta le seguenti regioni per la posizione dell'agente. Gli agenti dei datastore supportano un sottoinsieme di queste regioni e gli ID regione utilizzati dai datastore sono leggermente diversi da quelli delle 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 dei 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 (multiregione) | 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 | Multiregione globale (pubblicazione a livello globale, dati at-rest negli Stati Uniti) | global (opzione preferita) o nessuna regione (impostazione predefinita) ¶ |
global (più regioni) ¶ |
| Simbolo | Descrizione |
|---|---|
| * | Vertex AI non supporta la località multiregionale "us". Di conseguenza, l'utilizzo delle funzionalità di AI generativa di Agenti conversazionali (Dialogflow CX) nella regione multipla "us" si baserà sui rispettivi endpoint esistenti per una singola regione degli Stati Uniti. |
| ¶ | Le chiamate alla regione global potrebbero avere una latenza più elevata se effettuate da paesi diversi dagli 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 di Google Cloud e Geografia 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. Una volta configurate le impostazioni per una località specifica per un progetto, le impostazioni 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 di geolocalizzazione, le impostazioni predefinite verranno configurate per quella località e non potranno essere modificate per il progetto. Inoltre, una volta creato, l'agente non può essere spostato. 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 geolocalizzazione:
- Crittografia: questa impostazione controlla se per proteggere i dati vengono utilizzate chiavi di crittografia gestite da Google o gestite dal cliente. Il valore predefinito è Gestito da Google. Per modificare questa impostazione, devi richiedere l'accesso (contatta il tuo rappresentante di Google) alla funzionalità delle chiavi di crittografia gestite dal cliente.
Puoi configurare le impostazioni di geolocalizzazione in due modi:
- Fai clic su Impostazioni posizione nell'interfaccia di selezione dell'agente.
- 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 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 delle librerie 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.