Parametri del playbook

I playbook possono accettare ed emettere informazioni contestuali utilizzando parametri definiti esplicitamente. I parametri vengono utilizzati per memorizzare informazioni su una conversazione, come le selezioni dell'utente, i risultati delle azioni e così via. Puoi passare i valori di questi parametri tra playbook e flow.

Dichiarazione del parametro

Puoi definire parametri di input e parametri di output.

Quando utilizzi la console di Agent Builder, puoi definire i parametri nella pagina di modifica dell'agente.

Quando utilizzi la console Dialogflow CX, i parametri vengono definiti per playbook utilizzando la scheda Parametri dopo aver creato un playbook.

I parametri hanno un nome, una descrizione e uno dei seguenti tipi:

• Stringa
• Numero
• Valore booleano
• Tipo di parametro specifico per lo strumento

Puoi anche specificare se un parametro è un elenco.

Parametri di input

I parametri di input consentono ai playbook di utilizzare i valori trasmessi da flussi e altri playbook. Ad esempio, un playbook potrebbe ricevere il nome preferito di un utente come parametro e utilizzarlo per ringraziarlo personalmente oppure potrebbe ricevere un identificatore dell'ordine come parametro e utilizzarlo per recuperare i dettagli dell'ordine utilizzando uno strumento.

I parametri di input sono definiti per playbook e i playbook non hanno la visibilità di altri tipi di parametri della console Dialogflow CX per impostazione predefinita. Quando un flusso 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 un parametro di sessione o di pagina presente prima della transizione.

Crea esempi per controllare l'impatto del valore parametro di input sulle azioni. Ad esempio, se un parametro di input deve influire sul modo in cui l'agente fa riferimento all'utente, crea esempi che definiscono un valore per il parametro e poi utilizza lo stesso valore nelle azioni di frase all'interno dell'esempio. Per maggiori dettagli, consulta la sezione sulla passaggio dei parametri.

Parametri di output

I parametri di output consentono ai playbook di emettere informazioni da utilizzare da altri flussi o playbook. Ad esempio, un playbook potrebbe raccogliere un numero d'ordine da un utente e emetterlo tramite un parametro di output oppure utilizzare uno 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 per ciascun parametro di output. Ad esempio, se un parametro di output che rappresenta un numero di conferma deve ricavare il proprio valore dall'output dell'utilizzo di uno strumento, crea esempi in cui l'output dell'utilizzo dello strumento corrisponde al valore del parametro di output del playbook.

Trasmissione dei parametri

A differenza dei flussi, i playbook non supportano l'inserimento di valori dei parametri con una sintassi specifica. I playbook si basano invece su istruzioni e esempi di prompt con pochi scatti per determinare come devono essere utilizzati i valori dei parametri e come devono essere stabiliti quando si specificano i valori dei parametri.

Prendi in considerazione un agente progettato per la vendita di biglietti per eventi con i seguenti playbook:

1. Un playbook denominato Ticket ordering che effettua ordini utilizzando uno strumento chiamato Ticket sales API.
   1. Questo playbook accetta un parametro di input di tipo number e nome event_id.
   2. Lo strumento Ticket sales API si aspetta una richiesta che includa un event_id.
2. Un playbook denominato Event selection che aiuta gli utenti a selezionare un evento e poi li indirizza a Ticket ordering con il parametro event_id per acquistare i biglietti.

In questo esempio, per assicurarti che event_id venga trasmesso in modo affidabile da Event selection a Ticket ordering e da Ticket ordering a Ticket sales API, sono necessari diversi esempi.

Il playbook Ticket ordering deve includere più esempi che:

• Il parametro di input event_id deve essere specificato 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 event_id realistico specificato nel parametro di input.

Il playbook Event selection deve includere più esempi che:

• Includi un'espressione dell'utente in cui l'utente seleziona un evento con alcuni parametri realisticievent_id, diversi in ogni esempio.
• Includi un'invocazione di playbook di Ticket ordering che imposta il parametro event_id su lo stesso event_id realistico deciso dall'utente.

Oltre ad aggiungere esempi, prova ad aggiungere istruzioni specifiche alle istruzioni, agli obiettivi o ai dettagli dello strumento per spiegare come utilizzare i parametri. Ad esempio, il playbook Ticket ordering include la seguente istruzione:

- Use parameter event_id to send a buy_tickets request with ${TOOL: Ticket sales API}

Con gli esempi e le istruzioni descritti, il playbook Event selection decide correttamente un event_id in base alla selezione dell'utente e lo trasmette come parametro di input denominato event_id al Ticket ordering playbook. Quindi, Ticket ordering passa lo stesso event_id nel corpo di una richiesta al Ticket sales API. I playbook si basano su esempi con valori parametro distinti per dedurre come devono essere utilizzati i parametri.