Puoi creare più versioni dei flussi di agenti e dei playbook (noti anche come agenti Vertex AI) e eseguirne il deployment in ambienti di pubblicazione separati.
Quando modifichi un flusso o un playbook, stai modificando la bozza. Puoi salvare la bozza come versione in qualsiasi momento. Una versione è un'istantanea immutabile dei dati del flusso o del playbook e dei dati degli agenti associati. Per i flussi, sono inclusi intent, entità, webhook, pagine e gruppi di route. Per i playbook, sono inclusi solo esempi.
Quando salvi una bozza, ne viene eseguito il deployment nell'ambiente predefinito. Quando crei versioni specifiche, puoi eseguirne il deployment in ambienti personalizzati. Puoi creare una varietà di ambienti personalizzati come:
- test
- sviluppo
- produzione
Inoltre, puoi creare webhook specifici per l'ambiente, in modo da isolare l'ambiente di produzione dagli ambienti di sviluppo e test.
Best practice per il traffico di produzione
Usa sempre le versioni per il traffico di produzione
Una bozza viene aggiornata ogni volta che uno sviluppatore del tuo team apporta una modifica. È possibile interrompere una bozza involontariamente, soprattutto se più persone hanno accesso in scrittura all'agente. Inoltre, una bozza modificata di recente potrebbe non essere coerente con il modello addestrato, poiché l'addestramento potrebbe avere un ritardo o richiedere l'esecuzione manuale.
Devi utilizzare sempre le versioni per il traffico di produzione. Le bozze delle risorse devono essere testate prima di promuoverle nelle versioni di produzione e potrai tornare a una versione precedente se vengono rilevati problemi.
Utilizza sempre webhook specifici per l'ambiente
Quando aggiorni l'agente, spesso ci sono aggiornamenti interdipendenti al codice webhook. Durante lo sviluppo e il test di queste modifiche, devi:
- Per testare gli aggiornamenti dell'agente rispetto agli aggiornamenti del codice del webhook.
- Per evitare il deployment del codice webhook in produzione fino al completamento del test.
Utilizzo Webcam specifici per ambiente raggiunge entrambi gli obiettivi.
Considera i possibili errori dell'agente durante la modifica delle versioni
Se modifichi una versione nell'ambiente di produzione mentre le sessioni sono attive, potresti causare errori dell'agente per alcune sessioni attive. Questi errori possono verificarsi se le versioni precedente e nuova non sono coerenti tra loro in modo da interrompere lo stato della sessione. Per questo motivo, dovresti pianificare di cambiare versione tempi di inattività o al di fuori delle ore di punta.
Caricare una versione del flusso in bozza
In qualsiasi momento, puoi caricare una versione del flusso in bozza, quindi è modificabile e utilizzato dall'ambiente predefinito. Questa funzionalità non è ancora disponibile per i playbook.
Caricamento di una versione del flusso nella bozza in corso... aggiornano più risorse di un agente, incluse le risorse a livello di agente, come intent ed entità. Quando carichi una versione da mettere in bozza con la console o l'API, puoi scegliere se le risorse a livello di agente devono essere sovrascritte.
Gestisci versioni
Per gestire le tue versioni:
Console
Per elencare le versioni correnti di un flusso:
- Apri la console Dialogflow CX.
- Scegli il tuo progetto Google Cloud.
- Seleziona l'agente.
- Fai clic sulla scheda Risorse condivise.
- Fai clic su Versioni.
- Sono elencati i flussi degli agenti. Seleziona un'opzione.
- Le versioni sono elencate per il flusso selezionato.
Per elencare le versioni correnti di un playbook:
- Apri la console Dialogflow CX.
- Scegli il tuo progetto Google Cloud.
- Seleziona il tuo agente.
- Seleziona il playbook
- Fai clic su Cronologia delle versioni.
- Fai clic su Visualizza cronologia delle versioni.
- Le versioni sono elencate per il playbook selezionato.
Per ogni risorsa vengono visualizzate le seguenti informazioni:
- Nome visualizzato: il nome visualizzato della versione.
- ID versione: l'ID della versione.
- Tipo NLU: il parametro Tipo NLU per la versione del flusso.
- Timestamp della creazione: la data e l'ora in cui è stata creata la versione.
- Stato: lo stato dell'addestramento. Una versione del flusso non è pronta per l'uso finché lo stato non è contrassegnato come Pronto.
Per creare una nuova versione, fai clic sul pulsante Crea e fornisci la Nome visualizzato e Descrizione della versione.
Per caricare una versione specifica del flusso come flusso di bozza:
- Tieni il puntatore sopra una riga della versione.
- Fai clic sul pulsante dell'opzione more_vert.
- Fai clic sull'opzione Carica in bozza.
- È disponibile un'opzione per sovrascrivere i dati a livello di agente durante il caricamento.
Per eliminare una specifica versione del flusso:
- Tieni premuto il puntatore sopra una riga della versione.
- Fai clic sull'opzione Pulsante more_vert.
- Fai clic sull'opzione Elimina versione.
API
Vedi i metodi per il tipo Version.
Seleziona un protocollo e una versione per il riferimento alla versione:
| Protocollo | V3 | V3beta1 |
|---|---|---|
| REST | Risorsa versione | Risorsa versione |
| RPC | Interfaccia della versione | Interfaccia della versione |
| C++ | VersionsClient | Non disponibile |
| C# | VersionsClient | Non disponibile |
| Vai | VersionsClient | Non disponibile |
| Java | VersionsClient | VersionsClient |
| Node.js | VersionsClient | VersionsClient |
| PHP | Non disponibile | Non disponibile |
| Python | VersionsClient | VersionsClient |
| Ruby | Non disponibile | Non disponibile |
Confrontare le versioni del flusso
Dopo aver creato le versioni del flusso, puoi utilizzare lo strumento Confronta versioni per visualizzare un confronto affiancato tra le versioni del flusso o la versione di bozza. Questa funzionalità non è disponibile per i playbook. Per confrontare le versioni:
Console
- Tieni il puntatore sopra una riga della versione.
- Fai clic sull'opzione Pulsante more_vert.
- Fai clic sull'opzione Confronta versioni.
- Seleziona un'altra versione del flusso o un flusso di bozza per il confronto.
- Viene mostrato un confronto fianco a fianco.
API
Consulta il metodo compareVersions per il tipo Version.
Seleziona un protocollo e una versione per il riferimento alla versione:
| Protocollo | V3 | V3beta1 |
|---|---|---|
| REST | Risorsa versione | Risorsa versione |
| RPC | Interfaccia della versione | Interfaccia della versione |
| C++ | VersionsClient | Non disponibile |
| C# | VersionsClient | Non disponibile |
| Vai | VersionsClient | Non disponibile |
| Java | VersionsClient | VersionsClient |
| Node.js | VersionsClient | VersionsClient |
| PHP | Non disponibile | Non disponibile |
| Python | VersionsClient | VersionsClient |
| Ruby | Non disponibile | Non disponibile |
Gestisci gli ambienti
Per gestire gli ambienti degli agenti:
Console
Per elencare gli ambienti attuali di un agente:
- Apri la console Dialogflow CX.
- Scegli il tuo progetto Google Cloud.
- Seleziona l'agente.
- Fai clic sulla scheda Risorse condivise.
- Fai clic su Ambienti.
- Vengono elencati gli ambienti dell'agente.
Per creare un nuovo ambiente, fai clic sul pulsante Crea e fornisci le informazioni.
Per selezionare le versioni del flusso e dei playbook e configurare un ambiente, fare clic su un ambiente e fornire informazioni.
Per visualizzare la cronologia delle modifiche di un ambiente: fai clic sulla cronologia history nella parte destra di un ambiente nell'elenco.
Per copiare un nome risorsa di ambiente che includa l'ID ambiente, fai clic sulla copia content_copy nella parte destra di un ambiente nell'elenco.
Per eliminare un ambiente, fai clic sul pulsante di eliminazione delete vicino al lato destro di un ambiente nell'elenco.
API
Consulta i metodi per il tipo Environment.
Seleziona un protocollo e una versione per il riferimento Ambiente:
| Protocollo | V3 | V3beta1 |
|---|---|---|
| REST | Risorsa ambiente | Risorsa ambiente |
| RPC | Interfaccia dell'ambiente | Interfaccia dell'ambiente |
| C++ | EnvironmentsClient | Non disponibile |
| C# | EnvironmentsClient | Non disponibile |
| Vai | EnvironmentsClient | Non disponibile |
| Java | EnvironmentsClient | EnvironmentsClient |
| Node.js | EnvironmentsClient | EnvironmentsClient |
| PHP | Non disponibile | Non disponibile |
| Python | EnvironmentsClient | EnvironmentsClient |
| Ruby | Non disponibile | Non disponibile |
Specificare l'ambiente per le chiamate di sessione
Se utilizzi simulatore console o l'API, puoi specificare un ambiente quando effettui chiamate a sessione di runtime. Se un ambiente non è specificato, viene usato l'ambiente predefinito.
Console
Quando utilizzi il simulatore della console, seleziona l'opzione Testa l'agente nell'ambiente, quindi seleziona un ambiente.
API
Per specificare un ambiente per detectIntent, streamingDetectIntent,
matchIntent e chiamate REST dell'entità sessione;
modifica l'URL inserendo environments/environment-id
tra i parametri di percorso agent e sessions.
Ad esempio, il seguente URL utilizza 6db409d7-57ac-41d7-83bd-89b8768e2745
ID ambiente:
https://dialogflow.googleapis.com/v3/projects/my-project-id/locations/us/agents/my-agent-id/environments/6db409d7-57ac-41d7-83bd-89b8768e2745/sessions/my-session-id:detectIntent
Specifica le versioni del flusso per le chiamate di sessione
Utilizzando il simulatore della console o l'API, puoi specificare un insieme di versioni del flusso quando effettui chiamate alla sessione di runtime. Le versioni del flusso selezionate non devono essere necessariamente a cui si fa riferimento in qualsiasi ambiente.
Console
Quando utilizzi il simulatore della console, seleziona l'opzione Testa l'agente con versioni specifiche del flusso, quindi seleziona le versioni del flusso.
API
Per specificare le versioni del flusso per detectIntent, streamingDetectIntent,
matchIntent e chiamate REST dell'entità sessione;
forniscono le versioni scelte del flusso in query_parameters.flow_versions
campo della richiesta.