Partilhar via

Adicionar um agente subordinado

Um agente subordinado é um agente simples que existe no contexto do seu agente principal. Os agentes subordinados permitem agrupar logicamente ferramentas, instruções e conhecimento em subagentes claramente definidos dentro de um agente maior. São ideais para casos de utilização única que respondem a uma única intenção ou completam uma única tarefa. Este artigo explica como criar e gerir um agente subordinado.

Criar um agente subordinado

  1. Aceda à página Agentes do seu agente principal e selecione Adicionar agente.

  2. Selecione Novo agente subordinado.

  3. Introduza um nome distinto para o seu novo agente subordinado.

  4. Determine quando é que o agente deve ser utilizado. Por predefinição, os agentes respondem a utilizadores ou acionadores, com base na sua descrição.

    • Se quiser utilizar o comportamento predefinido (O agente escolhe - Com base na descrição), introduza uma breve descrição do propósito do seu agente.
    • Caso contrário, expanda a lista em Quando é que isto será utilizado? e selecione o comportamento pretendido. Para obter mais informações sobre os comportamentos suportados, consulte Determinar quando utilizar o seu agente.

  5. Introduza instruções claras que quer que o seu agente siga quando for invocado. Para referenciar ferramentas, variáveis ou adicionar fórmulas de Power Fx nas suas instruções, introduza uma barra (/) e selecione a opção pretendida no menu que aparece.

    Importante

    Ao referenciar ferramentas existentes nas suas instruções, decida se a ferramenta deve ser acessível diretamente pelo seu agente principal ou apenas quando explicitamente chamada nas instruções. Limitar a utilização de uma ferramenta a referências explícitas de instruções ajuda a evitar confusões quando existem ferramentas ou agentes semelhantes. Por exemplo, se tiver um agente “Verificar saldo de conta” e uma ferramenta semelhante “Obter saldo de conta”, restrinja a ferramenta a ser chamada apenas pelo agente para evitar sobreposições. Para restringir uma ferramenta a estar disponível apenas quando referenciada por outro agente, limpe a propriedade Permitir que o agente decida dinamicamente quando utilizar esta ferramenta na secção Detalhes adicionais da página de detalhes da ferramenta.

  6. Opcionalmente, adicione conhecimento e ferramentas que só este agente subordinado possa utilizar:

    • Na secção Conhecimento, selecione Adicionar e proceda de forma idêntica a quando adiciona conhecimento ao seu agente principal.
    • Na secção Ferramentas, selecione Adicionar e proceda de forma idêntica a quando adiciona ferramentas ao seu agente principal.

  7. Se ainda não quiser que este agente esteja ativo, desative a opção Ativado. Pode tornar o seu agente subordinado ativo mais tarde.

  8. Selecione Guardar.

Gerir entradas e saídas

Por predefinição, um agente subordinado recebe do agente principal uma tarefa de linguagem natural a realizar quando este o chama. Depois, quando termina a sua tarefa, devolve um resumo em linguagem natural do que aconteceu durante a execução. Em alguns casos, pode ser necessário especificar valores de entrada e saída mais explícitos para o agente.

Para gerir entradas

  1. Aceda aos detalhes do agente subordinado.

  2. Desloque-se para baixo para a secção Entradas.

  3. Para adicionar uma entrada, selecione Adicionar Entrada. Defina um Nome a apresentar e uma Descrição, que ajudam o agente a compreender o propósito da entrada para que possa preencher a entrada com um valor relevante ao chamar este agente.

  4. Selecionar um Tipo de dados.

  5. Opcionalmente, selecione Tornar esta entrada obrigatória para exigir que a entrada tenha um valor antes de o agente poder ser chamado.

  6. Selecione Guardar.

Nota

Pode, opcionalmente, expandir a secção Avançado e configurar outras definições para a entrada, incluindo a opção Deve pedir ao utilizador. Se a definição estiver ativada, o agente pede explicitamente ao utilizador final um valor para a entrada, caso não seja possível encontrar um no contexto disponível. Consulte mais detalhes sobre as outras definições para entradas.

Para gerir a lista de saídas

  1. Aceda aos detalhes do agente subordinado.

  2. Desloque-se para baixo para a secção Saídas.

  3. Para ver a lista atual de saídas, expanda a secção Avançado dentro da secção Saídas.

  4. Para adicionar uma saída, selecione Adicionar Saída. Defina um Nome a apresentar e uma Descrição, que ajudam o agente a compreender o propósito da saída para que possa preenchê-la com um valor relevante quando devolver valores ao agente chamador.

  5. Selecionar um Tipo de dados.

  6. Selecione Guardar.

Na secção Saídas, também pode optar por enviar uma mensagem ao utilizador imediatamente após o seu agente subordinado terminar. Para enviar a mensagem, altere a seleção Após a execução.

Determinar quando deve utilizar o seu agente

Por predefinição, os agentes subordinados respondem a uma consulta do utilizador com base na sua descrição. Também pode configurar agentes subordinados para intercetarem outros eventos e responderem aos mesmos em Quando é que isto será utilizado?.

Evento Descrição
É recebida uma mensagem É chamado quando uma atividade de mensagem — o tipo mais comum de atividade — é recebida. Recebido quando um utilizador escreve ou diz algo ao agente. Por predefinição, o agente responde a quaisquer mensagens. Para limitar a resposta do agente a um tipo específico de mensagem, utilize a lista Tipo de atividade em Detalhes adicionais.
Ocorre um evento de cliente personalizado É chamado quando é recebida uma atividade de evento. Por predefinição, o agente responde a qualquer evento. Para limitar a resposta do agente a um evento específico, utilize a propriedade Nome do evento em Detalhes adicionais.
Ocorre uma atividade Chamado quando uma atividade de qualquer tipo é recebida. Para limitar a resposta do agente a um tipo específico de atividade, utilize a lista Tipo de atividade em Detalhes adicionais.
A conversação muda É chamado 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 É chamado quando é recebida uma atividade de invocação. 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 É chamado quando o agente é chamado explicitamente a partir de um tópico.
O utilizador está inativo há algum tempo É chamado quando o utilizador não interagiu com o agente principal após um período de tempo configurado. Selecione o limiar de inatividade pretendido na lista Duração da inatividade em Detalhes adicionais.
Um plano está concluído É chamado quando o agente principal 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 É chamado quando o agente principal 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).

Outros detalhes

Dependendo da sua seleção para Quando é que isto será utilizado?, poderão estar disponíveis mais propriedades. As seguintes propriedades estão sempre disponíveis.

Condição

Especifique as condições que têm de ser cumpridas para que o agente seja chamado. Por exemplo, pode querer que o agente seja chamado apenas se o canal utilizado por um colaborador for o Microsoft Teams.

Captura de ecrã de uma condição para limitar o âmbito de um agente subordinado ao canal do 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.

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

Prioridade

Mais de um agente pode ser acionado para uma única atividade recebida, como uma mensagem. Por predefinição, a opção que selecionar para Quando é que isto será utilizado? determina a ordem em que os agentes são acionados.

Os agentes subordinados e os tópicos partilham o mesmo conjunto de acionadores ou eventos aos quais podem responder. Se um agente e um tópico estiverem configurados para responder ao mesmo evento, como inatividade do utilizador, utilize a propriedade de prioridade para determinar qual é acionado primeiro.

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

Se vários agentes ou tópicos tiverem de ser chamados com base no mesmo tipo de evento, são chamados pela ordem de criação (o mais antigo primeiro).

Pode definir explicitamente a propriedade Prioridade. Um número mais baixo indica uma prioridade mais elevada.

  • Last updated on