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 tópicos.

Se o seu agente usar orquestração generativa, pode preencher automaticamente os campos de entrada antes de executar um tópico, usando o contexto da conversa, ou gerar perguntas para fazer ao utilizador de modo a obter esses valores. Este comportamento é semelhante ao funcionamento do preenchimento generativo de slots 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.

As entradas e saídas de tópicos podem partilhar valores com outros tópicos e ferramentas no mesmo plano gerado.

Adicionar entradas e saídas

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

No painel de detalhes do Tópico, pode selecionar o separador Entradas ou Saídas e depois 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 seu agente usa IA generativa para decidir como responder aos usuários, mais propriedades estão disponíveis para variáveis de entrada. Especificamente, Como é que o agente vai preencher esta entrada? Determina como o agente preenche esta 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 utilizador ou a conversa anterior. Se não for encontrado um valor apropriado, o agente gera uma pergunta para pedir esse valor ao utilizador. 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 um valor literal, uma variável existente ou uma fórmula 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 para entradas para controlar o comportamento do agente ao solicitar um valor ou validar uma resposta do usuário.

Uma destas definições, Deve indicar ao utilizador, só está disponível 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. Esta propriedade está selecionada por predefinição.