Parâmetros

Visualização

Este produto ou recurso está sujeito aos "Termos das ofertas pré-GA" na seção "Termos de Serviço gerais" dos Termos específicos do serviço. Os produtos e recursos pré-GA estão disponíveis "no estado em que se encontram" e podem ter suporte limitado. Para mais informações, consulte as descrições da fase de lançamento.

Importante: os manuais do Dialogflow CX são chamados de agentes ao usar Agentes da Vertex AI. Para evitar confusão, neste documento, usamos o termo playbook.

Importante: manuais do Dialogflow CX e transmite parâmetros entre Os fluxos e playbooks do Dialogflow CX estão documentados aqui, mas que têm acesso restrito no momento. A transmissão de parâmetros entre agentes da Vertex AI Agents está disponível publicamente.

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.

Observação :o playbook padrão não aceita parâmetros de entrada. O playbook padrão serve como ponto de entrada para conversas do usuário, Por isso, ele não pode receber parâmetros de entrada.

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:

1. Um playbook chamado Ticket ordering que faz pedidos usando uma ferramenta chamado Ticket sales API.
   1. Este playbook aceita um parâmetro de entrada com o tipo number e o nome event_id.
   2. A ferramenta Ticket sales API espera uma solicitação que inclua um event_id.
2. Um playbook chamado Event selection, que ajuda os usuários a selecionar um evento e encaminha os clientes para Ticket ordering com o parâmetro event_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 o event_id para o mesmo event_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.