I playbook possono accettare ed emettere informazioni di contesto utilizzando parametri definiti in modo esplicito. I parametri vengono utilizzati per memorizzare le informazioni relative a una conversazione, ad esempio: selezioni dell'utente, risultati delle azioni e così via. Puoi trasferire i valori di questi parametri tra playbook e flussi Dialogflow CX.
Dichiarazione relativa ai parametri
Puoi definire parametri di input e parametri di output.
Quando si utilizzano gli agenti Vertex AI, puoi definire i parametri nella pagina dell'editor degli agenti.
Quando usi Dialogflow CX, i parametri sono definiti per playbook utilizzando la sezione Parametri una volta creato un playbook.
I parametri hanno un nome, una descrizione e uno dei seguenti tipi:
- Stringa
- Numero
- Booleano
- Tipo di parametro specifico dello strumento
Puoi anche specificare se un parametro è un elenco.
Parametri di input
I parametri di input consentono ai playbook di utilizzare i valori passati dai flussi e da altri playbook. Ad esempio, un playbook potrebbe ricevere il nome preferito di un utente parametro da usare per ringraziare personalmente l'utente, o potrebbe ricevere un identificatore dell'ordine come parametro e utilizzala per recuperare i dettagli dell'ordine strumento.
I parametri di input sono definiti per ogni playbook e i playbook non hanno visibilità di altri tipi di parametri di Dialogflow CX per impostazione predefinita. Quando un flusso Dialogflow CX passa a un playbook, i parametri di pagina e sessione vengono propagati al playbook se il playbook di destinazione ha un parametro di input con lo stesso nome. Per comunicare informazioni da un flusso a un playbook durante una transizione, definisci i parametri di input del playbook con lo stesso nome di una sessione o parametro di pagina presente prima della transizione.
Crea esempi per controllare in che modo il valore parametro di input dovrebbe influire sulle azioni. Ad esempio, se un parametro di input deve influire sul modo in cui l'agente fa riferimento all'utente, crea esempi che definiscano un valore per il parametro e poi utilizza lo stesso valore nelle azioni di enunciato nell'esempio. Consulta passare parametri per maggiori dettagli.
Parametri di output
I parametri di output consentono ai playbook di emettere informazioni da usare in altri flussi o playbook. Ad esempio, un playbook potrebbe raccogliere un numero d'ordine un utente e la emettono tramite un parametro di output, o un playbook potrebbe utilizzare strumento per prenotare un volo ed emettere il numero di conferma tramite un parametro di output.
Crea esempi per controllare in che modo il playbook deve decidere il valore di ogni parametro di output. Ad esempio, se un parametro di output che rappresenta una conferma deve ricavare il suo valore dall'output dell'uso di uno strumento, creare esempi in cui l'output dello strumento use corrisponde al valore del parametro di output del playbook.
Passaggio dei parametri
I playbook, a differenza dei flussi, non supportano l'inserimento di valori dei parametri con una particolare sintassi. I playbook si basano invece su istruzioni e esempi di prompt few-shot per determinare come utilizzare i valori dei parametri viene deciso quando specifichi i valori parametro.
Prendi in considerazione un agente progettato per la vendita di biglietti per eventi con i seguenti playbook:
- Un playbook chiamato
Ticket ordering
che effettua gli ordini utilizzando uno strumento denominatoTicket sales API
.- Questo playbook accetta un parametro di input di tipo
number
e nomeevent_id
. - Lo strumento
Ticket sales API
prevede una richiesta che include unevent_id
.
- Questo playbook accetta un parametro di input di tipo
- Un playbook chiamato
Event selection
che aiuta gli utenti a selezionare un evento e poi lo indirizza aTicket ordering
con parametroevent_id
per l'acquisto ticket di assistenza.
In questo esempio, per garantire che event_id
venga trasmesso in modo affidabile
Da Event selection
a Ticket ordering
e da Ticket ordering
a
Ticket sales API
, diversi
esempi
sono necessarie.
Il playbook Ticket ordering
deve includere vari esempi, tra cui:
- Hanno specificato il parametro di input
event_id
con un valore realistico, diverso in ogni esempio. - Includi un'azione di utilizzo dello strumento con un corpo della richiesta che includa lo stesso
valore realistico di
event_id
come specificato nel parametro di input.
Il playbook Event selection
deve includere vari esempi, tra cui:
- Includi un'espressione che l'utente seleziona un evento con alcune
event_id
, diversi in ogni esempio. - Includi la chiamata di
Ticket ordering
a un playbook che imposti il valoreevent_id
in modo che lo stesso valore dievent_id
realistico venga deciso selezione.
Oltre ad aggiungere esempi, prova ad aggiungere istruzioni specifiche alla
istruzioni,
goal oppure
dettagli strumento
che spiega come devono essere usati i parametri. Ad esempio:
il playbook Ticket ordering
include le seguenti istruzioni:
- Use parameter event_id to send a buy_tickets request with ${TOOL: Ticket sales API}
Con gli esempi e le istruzioni descritti, Event selection
playbook decide correttamente un event_id
in base alla selezione dell'utente; e
lo passa come parametro di input denominato event_id
Ticket ordering playbook
. Poi, Ticket ordering
supera lo stesso event_id
nel corpo di una richiesta inviata a Ticket sales API
. I playbook dipendono da esempi
con valori parametro distinti per aiutarli a dedurre come devono essere utilizzati.