Definir acionadores de tópico

Note

Este artigo descreve as funcionalidades usadas em agentes ou fluxos de agentes alimentados pelo arnês padrão.

Para agentes que usam orquestração generativa, o acionador de tópicos predefinido é O agente escolhe. Ativa-se quando o agente determina que o nome do tópico e a descrição especificada no nó Acionador correspondem à mensagem recebida do utilizador.

Para agentes que usam orquestração clássica, o acionador de tópicos predefinido é Utilizador diz uma frase. Ativa-se quando uma ou mais das expressões acionadoras especificadas correspondem de perto a uma mensagem recebida de um utilizador. Saiba mais em Desenhar frases de disparo eficazes. Existem outros tipos de acionadores que determinam quando um tópico deve ser executado.

Pré-requisitos

Familiarize-se com a criação e edição de tópicos.

Tipos de acionador

Os acionadores permitem ao seu agente intercetar e processar diferentes eventos ou atividades de diferentes tipos. Os seguintes tipos de acionadores determinam quando um tópico deve ser acionado.

Sugestão

Quando um utilizador envia uma mensagem a um agente, o payload é uma mensagem do tipo atividade. Os agentes podem receber atividades de outros tipos, dependendo do que acontece no chat ou noutros eventos.

Por exemplo, o Microsoft Teams envia atividades ocultas de invocação, que representam uma ação do utilizador, como interagir com uma extensão de mensagem.

Tipo Description
O agente escolhe Disponível para agentes que utilizam orquestração generativa. Dispara quando o agente determina que o nome e a descrição do tópico especificados no nó Trigger correspondem à mensagem recebida pelo utilizador.
O utilizador diz uma expressão Disponível para agentes que utilizam orquestração clássica. Ativa-se quando uma ou mais frases de gatilho coincidem com a mensagem recebida de um utilizador.
Uma mensagem é recebida É acionado quando uma atividade de mensagem, o tipo mais comum de atividade, é recebida. Recebido quando um utilizador escreve ou diz algo ao agente.
Ocorre um evento de cliente personalizado É acionado quando uma atividade de evento é recebida. Por predefinição, todas as atividades do evento são respondidas. Use a propriedade do Nome do evento dentro das propriedades do acionador para filtrar por um evento específico.
Ocorre uma atividade Aciona quando qualquer tipo de atividade é recebida. Pode opcionalmente definir a propriedade do tipo de atividade nas propriedades do acionador para filtrar por um tipo específico de atividade.
A conversação muda É acionado quando é recebida uma atividade de atualização de conversação. Por exemplo, o Teams envia uma atividade deste tipo quando um utilizador entra numa conversação.
É invocado É acionado quando uma atividade de invocação é recebida. Mais frequentemente recebido através do canal Teams — por exemplo, quando o utilizador interage com uma mensagem ou extensão de pesquisa no Teams.
É redirecionado para É acionado quando o tópico é explicitamente chamado por outro tópico. Defina o tempo de inatividade desejado usando a propriedade de Duração de inatividade nas propriedades do acionador.
O utilizador está inativo há algum tempo É acionado quando o utilizador não interagiu com o agente após um período de tempo configurado. Saiba mais em Gatilho da Inatividade.
Um plano está concluído Disponível para agentes que utilizam orquestração generativa. É acionado quando o agente termina de executar todos os passos planeados para responder a uma consulta do utilizador ou a um acionador autónomo.
Uma resposta gerada por IA está prestes a ser enviada Disponível para agentes que utilizam orquestração generativa. É acionado quando o agente gera uma resposta para um utilizador depois de chamar um ou mais tópicos, ferramentas ou fontes de conhecimento. Use a Response.FormattedText variável de sistema para ver a resposta gerada. Defina a variável ContinueResponse para falso se pretender impedir que a resposta de orquestração seja enviada (ou seja, caso modifique a mensagem e envie a sua própria utilizando um nó Mensagem).

Alterar o acionador de um tópico

  1. Vá para a página Tópicos do seu agente e abra o tópico pretendido.

  2. Passe o cursor sobre o nó Acionador e selecione o botão Alterar acionador.

    Captura de ecrã que mostra a localização do ícone 'Alterar acionador' num nó de Acionador.

  3. Selecione o tipo de acionador adequado ao seu tópico.

    • Para o gatilho O agente escolhe, descreva quando o seu agente deve utilizar este tópico.
    • Para o gatilho Utilizador diz uma expressão, introduza as expressões de gatilho pretendidas.

  4. Selecione Editar na caixa do acionador. É apresentado o painel de propriedades para o tipo de acionador especificado.

  5. Defina as propriedades aplicáveis ao seu acionador:

Condição do acionador

Especifique as condições que devem ser cumpridas para que o acionador seja acionado. Por exemplo, pode querer que o disparador funcione apenas se o canal utilizado por um funcionário for o Microsoft Teams.

Captura de ecrã de uma condição de gatilho.

Se precisares de condições mais complexas, muda para o editor de fórmulas Power Fx : seleciona Builder e depois seleciona Formula.

Captura de ecrã que mostra a opção de ir ao editor de fórmulas.

Prioridade do gatilho

Mais de um acionador pode ser ativado por uma única atividade de entrada, como uma mensagem. O tipo de acionador determina a ordem na qual os acionadores disparam.

Ordem de execução:

  1. Ocorre uma atividade
  2. É recebida uma mensagem / Ocorre um evento de cliente personalizado / A conversação muda / É invocado
  3. O agente escolhe / O utilizador diz uma expressão

Se houver mais do que um acionador qualificado do mesmo tipo, o sistema executa os acionadores pela ordem de criação (o mais antigo primeiro).

Pode definir a propriedade Prioridade para determinar explicitamente a ordem de execução.

  • Last updated on