Adicionar um agente filho

Um agente filho é um agente leve que existe no contexto do seu agente principal. Agentes filhos permitem que você agrupe logicamente ferramentas, instruções e conhecimento em subagentes claramente definidos dentro de um agente maior. Eles são ideais para casos de uso únicos que respondem a uma única intenção ou completam uma única tarefa. Este artigo explica como criar e gerenciar um agente filho.

Criar um agente filho

1. Vá até a página Agentes do seu agente principal e selecione Adicionar um agente.

2. Selecione Novo agente filho.

3. Insira um nome distinto para seu novo agente filho.

4. Determine quando seu agente deve ser utilizado. Por padrão, os agentes respondem aos usuários ou gatilhos, com base na descrição deles.

   • Se você quiser usar o comportamento padrão (O agente escolhe - Com base na descrição), insira uma breve descrição do propósito do seu agente.
   • Caso contrário, expanda a lista em Quando isso será usado? e selecione o comportamento desejado. Para mais informações sobre os comportamentos com suporte, consulte Determinar quando usar seu agente.

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

   Importante

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

6. Como opção, adicione conhecimento e ferramentas que apenas esse agente filho possa usar:

   • Na seção Conhecimento, selecione Adicionar e prossiga da mesma forma que quando adiciona conhecimento ao seu agente principal.
   • Na seção Ferramentas, selecione Adicionar e prossiga da mesma forma que quando adiciona ferramentas ao seu agente principal.

7. Se você não quiser que esse agente esteja ativo ainda, desative o modo Ativado. Você pode tornar seu agente filho ativo posteriormente.

8. Selecione Salvar.

Gerenciar entradas e saídas

Por padrão, um agente filho recebe uma tarefa de linguagem natural para realizar do agente principal quando o agente a chama. Então, quando conclui sua tarefa, retorna um resumo em linguagem natural do que aconteceu durante sua execução. Em alguns casos, você pode querer especificar valores de entrada e saída mais explícitos para o agente.

Para gerenciar entradas

1. Vá aos detalhes do agente filho.

2. Role para baixo até a seção Entradas.

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

4. Selecione um Tipo de dados.

5. Como opção, selecione Tornar esta entrada necessária para exigir que a entrada tenha um valor antes que o agente possa ser chamado.

6. Selecione Salvar.

Para gerenciar a lista de saídas

1. Vá aos detalhes do agente filho.

2. Role para baixo até a seção Saídas.

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

4. Para adicionar uma saída, selecione Adicionar Saída. Defina um Nome de exibição e uma Descrição, que ajudam o agente a entender o propósito da saída para que ele possa preencher a entrada com um valor relevante ao retornar valores para o agente de chamada.

5. Selecione um Tipo de dados.

6. Selecione Salvar.

Na seção Saídas, você também pode escolher enviar uma mensagem ao usuário imediatamente após o término do seu agente filho. Para enviar a mensagem, altere a seleção Após a execução.

Determine quando usar seu agente

Por padrão, os agentes filhos respondem a uma consulta do usuário com base na descrição deles. Você também pode configurar agentes filhos para interceptar outros eventos e responder a eles em Quando isso será usado?.

Outros detalhes

Dependendo da sua escolha para Quando será usado?, mais propriedades podem estar disponíveis. As seguintes propriedades estão sempre disponíveis.

Condição

Especifique condições que devem ser atendidas para que o agente seja chamado. Por exemplo, você pode querer que o agente seja chamado apenas se o canal usado por um funcionário for o Microsoft Teams.

Se precisar de condições mais complexas, você poderá alternar para o editor de fórmulas Power Fx: selecione Construtor e Fórmula.

Prioridade

Mais de um agente pode ser disparado para uma única atividade de entrada, como uma mensagem. Por padrão, a opção que você seleciona para Quando será usada? determina a ordem em que os agentes disparam.

Os agentes filho e os tópicos compartilham o mesmo conjunto de gatilhos ou eventos aos quais podem responder. Se um agente e um tópico estiverem configurados para responder ao mesmo evento, como inatividade do usuário, use a propriedade de prioridade para determinar qual deles é o primeiro.

Ordem de execução:

1. Uma atividade ocorre
2. Uma mensagem é recebida / Ocorre um evento personalizado do cliente / A conversa é alterada / Ela é invocada
3. O agente escolhe

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

Você pode definir explicitamente a propriedade Priority. Um número menor indica uma prioridade mais alta.