Quando crei un agente, devi specificare regione come località dell'agente. Le richieste inviate all'agente vengono gestite dai servizi Google in questa regione e gli agenti conversazionali (Dialogflow CX) mantengono 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ò cambiare. Per cambiare la località di un agente, devi esportare e ripristinare a 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 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 regionale per le diverse integrazioni di telefonia può variare. Controllo documentazione per ogni integrazione.
Il supporto delle entità di sistema varia a seconda del caso language. Per maggiori dettagli, consulta le limitazioni delle entità di sistema.
La Explorer API, presenti su molti documenti di riferimento REST, supporta solo la regione
globalper le chiamate API.
Aree geografiche disponibili
Gli agenti conversazionali (Dialogflow CX) supportano le seguenti regioni per la località dell'agente. Agenti di datastore supportare un sottoinsieme di queste regioni e gli ID regione utilizzati dai datastore differiscono leggermente dalle 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 dei paesi | 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 (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 | Più regioni globali (pubblicazione a livello globale, data-at-rest negli Stati Uniti) | global (opzione preferita) o nessuna regione (impostazione predefinita) ¶ |
global (più regioni) ¶ |
| Simbolo | Descrizione |
|---|---|
| * | Vertex AI non supporta la località multiregione "us". Di conseguenza, l'utilizzo delle funzionalità di IA generativa degli agenti conversazionali (Dialogflow CX) in "us" più regioni si baserà sui rispettivi endpoint esistenti degli Stati Uniti a regione singola. |
| ¶ | Le chiamate verso la regione global potrebbero avere una latenza più elevata se effettuate al di fuori 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 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 vengono condivise all'interno del progetto, e ciascuna località ha le proprie impostazioni di geolocalizzazione. Dopo aver configurato le impostazioni di un luogo specifico per un progetto, non è possibile modificare le impostazioni per quella località. Se devi modificare queste impostazioni, devi creare un nuovo progetto.
Se crei un agente senza modificare le impostazioni di geolocalizzazione, verranno configurate le impostazioni predefinite per quella località, e non possono 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 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. Devi richiedere l'accesso (contattando il tuo rappresentante di Google) al chiavi di crittografia gestite dal cliente per modificare questa impostazione.
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 all' Menu a discesa Località quando 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 regione multipla
us, utilizzausa-dialogflow.googleapis.comper il nome host. Per tutte le altre regioni, utilizza[region-id]-dialogflow.googleapis.comcome 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 documentazione relativa alla libreria 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.