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 usar IA generativa para decidir como responder a usuários, o copiloto poderá preencher automaticamente entradas, antes de executar o tópico, usando o contexto da conversa ou gerar perguntas para coletar valores da resposta do usuário. Esse comportamento é semelhante à maneira como o preenchimento de slot generativo para ações funciona.

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 copiloto usar IA generativa para decidir como responder a usuários, mais propriedades estarão disponíveis para variáveis de entrada. Mais especificamente, Como o copiloto vai preencher esta entrada? determina como o copiloto 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 copiloto tenta popular o valor pelo contexto disponível, como a extração de 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 copiloto vai preencher esta 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 o copiloto capture o tipo correto de valor para a entrada, você também deve especificar um tipo de entidade em Identificar como.

Captura de tela do painel Detalhes com uma nova variável de entrada sendo adicionada

Existem várias configurações adicionais que podem ser definidas para entradas capazes de controlar o comportamento do copiloto ao solicitar um valor ou validar a resposta de um usuário.

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