Os playbooks podem aceitar e emitir informações de contexto usando parâmetros explicitamente definidos. Os parâmetros são usados para armazenar informações sobre uma conversa, como seleções de usuários, resultados de ações e assim por diante. É possível passar os valores desses parâmetros entre manuais e fluxos do Dialogflow CX.
Declaração de parâmetro
Defina parâmetros de entrada e parâmetros de saída.
Ao usar os Agentes da Vertex AI, é possível definir parâmetros na página do editor do agente.
Ao usar o Dialogflow CX, são definidos por playbook usando o campo Parâmetros depois de criar um playbook.
Os parâmetros têm nome, descrição, e um dos seguintes tipos:
- String
- Número
- Booleano
- Tipo de parâmetro específico da ferramenta
Também é possível especificar se um parâmetro é uma lista.
Parâmetros de entrada
Os parâmetros de entrada permitem que os playbooks usem os valores transmitidos de fluxos e outros playbooks. Por exemplo, um playbook pode receber o nome preferido de um usuário como parâmetro e usá-lo para agradecer pessoalmente ao usuário, ou receber um identificador de pedido como parâmetro e usá-lo para recuperar detalhes de pedidos usando um ferramenta.
Os parâmetros de entrada são definidos por playbook, e eles não têm visibilidade de Outros tipos de parâmetros do Dialogflow CX por padrão. Quando um fluxo do Dialogflow CX faz a transição para um playbook, os parâmetros de página e sessão são propagados para o playbook se o playbook de destino tiver um parâmetro de entrada com o mesmo nome. Para comunicar informações de um fluxo para um playbook durante uma transição, definir parâmetros de entrada do playbook com o mesmo nome de uma sessão ou parâmetro de página presente antes da transição.
Crie exemplos para controlar como o valor do parâmetro de entrada afeta as ações. Por exemplo, se um parâmetro de entrada precisar afetar como o agente se refere ao usuário, crie exemplos que definam um valor para o parâmetro e depois use o mesmo valor em ações de fala no exemplo. Consulte transmitindo parâmetros para mais detalhes.
Parâmetros de saída
Os parâmetros de saída permitem que os playbooks emitem informações para ser usado por outros fluxos ou playbooks. Por exemplo, um playbook pode coletar um número de pedido do um usuário e o emite por um parâmetro de saída, ou um playbook, ferramenta de reservar um voo e emitir o número de confirmação por meio de um parâmetro de saída.
Criar exemplos para controlar como o playbook deve decidir o valor de cada parâmetro de saída. Por exemplo, se um parâmetro de saída que representa uma solicitação número deve derivar do valor da saída de um uso de ferramenta criar exemplos em que a saída da ferramenta use corresponde ao valor do parâmetro de saída do playbook.
Parâmetros de transmissão
Ao contrário dos fluxos, os playbooks não oferecem suporte à injeção de valores de parâmetro com uma sintaxe específica. Em vez disso, eles dependem de instruções exemplos de comandos few-shot para determinar como os valores de parâmetros devem ser usados e como os valores devem ser decidiu ao especificar os valores dos parâmetros.
Considere um agente projetado para a venda de ingressos de eventos com os seguintes manuais:
- Um playbook chamado
Ticket ordering
que faz pedidos usando uma ferramenta chamadoTicket sales API
.- Este playbook aceita um parâmetro de entrada com o tipo
number
e o nomeevent_id
. - A ferramenta
Ticket sales API
espera uma solicitação que inclua umevent_id
.
- Este playbook aceita um parâmetro de entrada com o tipo
- Um playbook chamado
Event selection
, que ajuda os usuários a selecionar um evento e encaminha os clientes paraTicket ordering
com o parâmetroevent_id
para comprar bilhetes.
Neste exemplo, para garantir que event_id
seja transmitido de maneira confiável da
Event selection
a Ticket ordering
e de Ticket ordering
a
Ticket sales API
, várias
exemplos
necessários.
O playbook Ticket ordering
precisa incluir vários exemplos que:
- especificar o parâmetro de entrada
event_id
com um valor realista, diferente; em cada exemplo. - Inclua uma ação de uso de ferramenta com um corpo de solicitação que inclua o mesmo
um valor
event_id
realista, conforme especificado no parâmetro de entrada.
O playbook Event selection
precisa incluir vários exemplos que:
- Incluir um enunciado em que o usuário seleciona um evento com alguma
event_id
, diferente em cada exemplo. - Inclua uma invocação de playbook de
Ticket ordering
, que define oevent_id
para o mesmoevent_id
realista, conforme decidido pelo
Além de adicionar exemplos, tente adicionar instruções específicas ao
instruções,
meta, ou
detalhes da ferramenta
que explica como os parâmetros devem ser usados. Por exemplo:
Ticket ordering
inclui a seguinte instrução:
- Use parameter event_id to send a buy_tickets request with ${TOOL: Ticket sales API}
Com as instruções e os exemplos descritos, a Event selection
playbook decide corretamente uma event_id
com base na seleção do usuário e
transmite-o como um parâmetro de entrada chamado event_id
para o
Ticket ordering playbook
Depois, Ticket ordering
transmite o mesmo event_id
no corpo de uma solicitação para Ticket sales API
. Os playbooks dependem de exemplos
com valores de parâmetro distintos para inferir como os parâmetros precisam ser usados.