Gerenciar entradas e saídas de tópicos

Os Tópicos podem ter parâmetros de entrada e saída. Quando um tópico redireciona para outro tópico, você pode usar esses parâmetros para passar informações entre os tópicos.

Se o seu agente usar orquestração gerativa, ele poderá preencher as entradas, antes de rodar o tópico, usando o contexto da conversa ou gerar perguntas para perguntar os valores aos usuários. Esse comportamento é semelhante à maneira como o preenchimento de slot generativo para ações funciona.

Ao usar a orquestração generativa, um agente pode usar saídas de tópico para gerar uma resposta contextual. Nesses casos, você não precisa configurar uma mensagem literal de dentro do próprio tópico.

As entradas e saídas do tópico podem compartilhar valores com outros tópicos e ações no mesmo plano gerado.

Adicionar entradas e saídas

Para adicionar entradas ou saídas de um tópico, selecione os Detalhes na barra de navegação na parte superior da tela de criação. Você também pode selecionar Detalhes no menu de contexto para um tópico na página de listagem Tópicos.

Depois que o painel Detalhes for mostrado, você poderá navegar até as guias Entradas ou Saídas e criar novas variáveis de entrada ou saída selecionando Criar uma nova variável.

Para cada parâmetro de entrada e saída, você deve inserir um nome, selecionar um tipo de dados e inserir uma descrição para a variável correspondente.

Se o agente usar IA generativa para decidir como responder aos usuários, mais propriedades estarão disponíveis para variáveis de entrada. Especificamente Como o agente preencherá essa entrada? determina como o agente preenche essa variável com um valor antes de executar o tópico. Por padrão, cada entrada é definida como Preencher dinamicamente com a melhor opção. O agente tenta preencher o valor do contexto disponível, como extrair um valor da mensagem do usuário ou de uma conversa anterior. Se nenhum valor indicado for encontrado, uma pergunta será gerada para solicitar um valor ao usuário. Você pode optar por substituir uma entrada por um valor, em vez de perguntar ao usuário. Para substituir um parâmetro de entrada, selecione Definir como um valor, em Como o agente preencherá essa entrada?, e insira o valor desejado. Esse valor pode ser literal, uma variável existente ou uma fórmula do Power Fx.

Para garantir que seu agente capture o tipo correto de valor para a entrada, você também deve especificar um tipo de entidade em Identificar como.

Configurações adicionais pode ser configurado para entradas que controlam o comportamento do agente ao solicitar um valor ou validar uma resposta do usuário.

Uma dessas propriedades, Deve solicitar ao usuário, só está disponível para entradas de tópico. Ele determina se o agente deve tentar preencher a variável com um valor antes de executar o tópico. Essa propriedade permanece habilitada por padrão.