Definir gatilhos do tópico

Para agentes que usam orquestração generativa, o gatilho de tópico padrão é Por agente. Ele é ativado quando o agente determina que o nome e a descrição do tópico especificados no nó do Gatilho correspondem à mensagem recebida do usuário.

Para agentes que usam orquestração clássica, o gatilho de tópico padrão é Frases. É ativado quando uma ou mais frases de gatilho especificadas correspondem exatamente à mensagem recebida de um usuário. Existem outros tipos de gatilho disponíveis que determinam quando um tópico deve ser executado.

Pré-requisitos

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

Tipo de gatilho

Os gatilhos possibilitam que seu agente intercepte e manipule diferentes eventos ou atividades de entrada de diferentes tipos. Os tipos de gatilho a seguir determinam quando um tópico deve ser desencadeado.

Dica

Quando um usuário envia uma mensagem a um agente, o conteúdo é um tipo de mensagem do tipo atividade. Os agentes podem receber atividades de outros tipos, dependendo do que acontece no chat ou em outros eventos.

Por exemplo, o Microsoft Teams envia atividades ocultas do tipo invocar, que significa uma ação do usuário, como interagir com uma Extensão de Mensagem.

Tipo	Description
Por agente	Disponível para agentes que usam orquestração generativa. É acionado quando o agente determina que o nome e a descrição do tópico especificados no nó do Gatilho correspondem à mensagem recebida do usuário.
Frases	Disponível para agentes que usam orquestração clássica. É acionado quando uma ou mais frases de gatilho correspondem à mensagem recebida de um usuário.
Mensagem recebida	É acionado quando uma atividade do tipo mensagem, o tipo mais comum de atividade, é recebida. Recebido quando um usuário digita ou diz algo ao agente.
Evento recebido	Acionado quando uma atividade do tipo evento é recebida. Por padrão, todas as atividades do evento são respondidas. Use a propriedade Event name nas propriedades do gatilho para filtrar um evento específico.
Atividade recebida	É acionada quando uma atividade de qualquer tipo é recebida. Opcionalmente, você pode definir a propriedade Tipo de atividade nas propriedades do gatilho para filtrar um tipo de atividade específico.
Atualização da conversa recebida	Acionado quando uma atividade do tipo conversationUpdate é recebida. Por exemplo, o Teams envia uma atividade desse tipo quando um usuário entra em uma conversa.
Invocação recebida	Acionado quando uma atividade do tipo Invocação é recebida. Mais comumente recebido do canal do Teams, por exemplo, quando o usuário interage com uma extensão de Mensagem ou Pesquisa no Teams.
No redirecionamento	É acionado quando o tópico é chamado explicitamente por outro tópico. Defina o tempo de inatividade desejado usando a propriedade Inactivity duration nas propriedades do gatilho.
Inatividade	É acionado quando um usuário não interage com o agente após um período de tempo configurado.
Plano concluído	Disponível para agentes que usam orquestração generativa. É acionado quando o agente termina de executar todas as etapas planejadas para responder a uma consulta do usuário ou a um gatilho autônomo.
Resposta gerada por IA	Disponível para agentes que usam orquestração generativa. É acionado quando o agente gera uma resposta para um usuário após chamar um ou mais tópicos, ações ou fontes de conhecimento. Use a variável de sistema Response.FormattedText para ver a resposta gerada. Defina a variável ContinueResponse como falsa se quiser impedir que a resposta de orquestração seja enviada (por exemplo, se você modificar a mensagem e enviar sua própria mensagem usando um nó de mensagem).

Alterar o gatilho de um tópico

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

2. Passe o mouse sobre a caixa do nó Gatilho e selecione o ícone Alterar gatilho .

   

3. Selecione o tipo de gatilho apropriado para seu tópico.

   • Para o gatilho Por agente, descreva quando o agente deve usar este tópico.
   • Para o gatilho Frases, insira as frases de gatilho desejadas.

4. Selecione Editar na caixa do gatilho. O painel de propriedades do tipo de gatilho especificado é exibido.

5. Defina as propriedades aplicáveis para o gatilho:

   • Tipo de atividade
   • Condição
   • Prioridade

Condição do gatilho

Especifique as condições que devem ser atendidas para que o gatilho seja acionado. Por exemplo, talvez você queira que o gatilho seja acionado somente se o canal usado por um funcionário for Microsoft Teams.

Se você precisar de condições mais complexas, você pode alternar para o editor de fórmula do Power Fx: selecione Builder e, em seguida, selecione Fórmula.

Prioridade de gatilho

Mais de um gatilho pode ser disparado para uma única atividade recebida, como uma mensagem. O tipo de gatilho determina a ordem em que os gatilhos são desencadeados.

Ordem de execução:

1. Atividade recebida
2. Mensagem / Evento / Atualização da conversa / Atualização da conversa
3. Por agente / Frases

Se houver mais de um gatilho qualificado do mesmo tipo, os gatilhos serão executados na ordem de criação (os mais antigos primeiro).

Você pode definir a propriedade Priority para determinar explicitamente a ordem de execução.