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 seu agente usa orquestração generativa, ele pode preencher automaticamente as entradas antes de executar um tópico, usando contexto de conversa ou gerar perguntas para perguntar ao usuário sobre os valores. Esse comportamento é semelhante à forma como o preenchimento generativo de slots funciona para ferramentas.

Agentes que utilizam orquestração generativa podem gerar uma resposta contextual como resultado do tópico. Nesses casos, você não precisa configurar uma mensagem literal de dentro do próprio tópico.

Entradas e saídas de tópicos podem compartilhar valores com outros tópicos e ferramentas no mesmo plano gerado.

Adicionar entradas e saídas

Para adicionar entradas ou saídas para um tópico, selecione Detalhes na barra de ferramentas no topo da tela de autoria. Alternativamente, selecione Detalhes no menu de contexto de um tema na página da lista de Tópicos .

No painel de detalhes do Tópico , você pode selecionar a aba Entradas ou Saídas e, em seguida, selecionar Criar uma nova variável para criar novas variáveis de entrada ou saída.

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 obter o valor a partir do contexto disponível, como a mensagem do usuário ou conversa anterior. Se nenhum valor apropriado for encontrado, o agente gera uma pergunta para fazer ao usuário sobre um valor. 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 podem ser configuradas das entradas que controlam o comportamento do agente ao solicitar um valor ou validar uma resposta do usuário.

Uma dessas configurações, Deve solicitar o usuário, está disponível apenas para entradas de tópicos. Ele determina se o agente deve tentar preencher a variável com um valor antes de executar o tópico. Essa propriedade é selecionada por padrão.