Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
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. Existem outros tipos de acionadores que determinam quando um tópico deve ser executado.
Pré-requisitos
Esteja familiarizado 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 | Descrição |
|---|---|
| O agente escolhe | Disponível para agentes que utilizam orquestração generativa. É acionado quando o agente determina que o nome do tópico e a descrição especificada no nó Acionador correspondem à mensagem recebida do utilizador. |
| O utilizador diz uma expressão | Disponível para agentes que utilizam orquestração clássica. É acionado quando uma ou mais expressões acionadoras correspondem à mensagem a receber de um utilizador. |
| É recebida uma mensagem | É 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 | É acionado quando uma atividade de qualquer tipo é 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. |
| 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 do sistema para ver a resposta gerada. Defina a variável ContinueResponse como falso se pretender impedir que a resposta de orquestração seja enviada (ou seja, se modificar a mensagem e enviar a sua própria mensagem utilizando um nó de Mensagem). |
Alterar o acionador de um tópico
Vá para a página Tópicos do seu agente e abra o tópico pretendido.
Faça pairar o cursor sobre o nó Acionador e selecione o ícone Alterar acionador.
Selecione o tipo de acionador adequado ao seu tópico.
- Para o acionador O agente escolhe, descreva quando o seu agente deve usar este tópico.
- Para o acionador Utilizador diz uma expressão, introduza as expressões acionadoras pretendidas.
Selecione Editar na caixa do acionador. É apresentado o painel de propriedades para o tipo de acionador especificado.
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 acionador seja acionado apenas se o canal usado por um funcionário for o Microsoft Teams.
Se precisar de condições mais complexas, pode mudar para o editor de fórmulas Power Fx : selecione Construtor e depois selecione Fórmula.
Prioridade do acionador
Mais do que um acionador pode acionar para uma única atividade de entrada, como uma mensagem. O tipo de acionador determina a ordem de acionamento dos acionadores.
Ordem de execução:
- Ocorre uma atividade
- É recebida uma mensagem / Ocorre um evento de cliente personalizado / A conversação muda / É invocado
- 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.