Criar um agente no Agent Builder

Esta seção descreve como projetar um agente no Agent Builder.

Importante: a experiência do Agent Builder está programada para ser descontinuada a partir de 14 de junho de 2025. Até lá, você só pode projetar ou avaliar agentes existentes. Recomendamos que você migre seus agentes existentes e comece a usar agentes no Studio Web. Para obter detalhes, consulte Migrar agentes para o Studio Web.

Para criar novos agentes, consulte Criar um agente no Studio Web.

1. No UiPath® Automation Cloud^™, selecione Agentes na barra lateral de navegação esquerda. A área de trabalho Agentes é exibida.
2. Na lista de Agentes de pré-visualização, selecione um agente para abrir o Agent Builder.
3. O espaço de trabalho de Agentes inclui três abas: Design, Avaliações e Traces.
   • Use a aba Design para criar e definir os elementos principais do seu agente.Depois de definir os argumentos de entrada/saída, você pode usar esse espaço para visualizar as execuções de seu agente.
   • Use a aba Avaliações para criar avaliações e armazenar resultados. As avaliações medem objetivamente a saída do seu agente e avaliam se ela é consistente ou não com seus objetivos.
   • Use a aba Traces para registrar e representar todos os rastros de tempo de design e avaliação para este agente.É aqui que você pode ver todas as execuções do agente e os detalhes da execução.
4. Selecione o grande modelo de linguagem que você deseja usar com seu agente. Os modelos são provisionados por meio da AI Trust Layer da UiPath.
   1. Para definir configurações de modelo, selecione o ícone de configurações ao lado do campo Modelo. Aqui você pode configurar os campos Temperatura e Máximo de tokens por resposta.
      • A Temperatura determina o fator de criatividade da geração de LLM. Você pode definir um valor entre 0 (Exato) e 2 (Criativo).
      • Máximo de tokens por resposta refere-se ao número máximo de tokens a serem gerados com a resposta do agente.
5. Na guia Geral, edite o nome e a descrição do agente.

   O nome e a descrição do agente devem oferecer detalhes sobre o propósito do agente em linguagem simples. A descrição é usada para ajudar a identificar o agente no Studio.

6. Na aba Solicitação, adicione uma solicitação do sistema bem estruturado e uma solicitação do usuário para dar ao agente instruções sobre o que ele deve fazer e restrições que ele deve seguir.
7. Selecione Argumentos para acessar a janela Argumentos, onde você pode configurar os argumentos de entrada e saída usados em sua solicitação.
8. Na aba Ferramentas adicione quaisquer ferramentas que seu agente possa usar durante a execução. Pode ser um conjunto de atividades do Integration Service, processos publicados aos quais você tem acesso ou outros agentes.

   Cada ferramenta deve ter uma descrição detalhada que ajuda o agente a entender como e quando usar essa ferramenta.

9. Use a aba Contextos para adicionar o contexto necessário.

   Os índices da Contextualização dão a um agente acesso a bases de conhecimento com acesso controlado.Isso ajuda a fundamentar ações ou respostas do agente em seus dados empresariais.

10. Use a aba Escalonamentos para adicionar um humano ao processo e habilitar Memória do Agente.

    Adicionar uma etapa de escalonamento permite que seu agente envolva um ser humano para revisar, aprovar ou atualizar a saída durante a execução.

11. Na janela Playground, forneça dados de entrada para uma execução de teste e selecione Executar.

    Você deve testar seu agente para certificar-se de que ele esteja funcionando conforme o esperado.

12. Em seguida, acesse a aba Avaliações para revisar e medir seu agente.

    Uma avaliação é um par entre uma entrada e uma asserção feita na saída e pode ser usada para classificar seu agente durante uma execução de ponta a ponta.

13. Depois de executar as avaliações, use a guia Traces para revisar todos os logs de traces para o seu agente.
14. Depois de testar, avaliar e refinar seu agente, selecione Publicar para enviá-lo ao Orchestrator como um processo.
    • Selecione onde publicar:
      • Feed do Espaço de Trabalho Pessoal do Orchestrator - O processo é publicado no seu espaço de trabalho pessoal e só estará disponível para você.Essa é a seleção padrão.
      • Feed de Processos do Tenant no Orchestrator - O processo é publicado no feed global do tenant e estará disponível para todos os usuários atribuídos a pastas que utilizam o feed do tenant.
    • Selecione uma versão. Uma versão é gerada automaticamente começando com a 1.0.0 quando você publica pela primeira vez, e depois incrementada automaticamente toda vez que a republica.
    Importante: essa etapa é necessária para que o agente esteja disponível na atividade Run Job.

    Selecione Export para exibir e empacotar a definição do agente como um JSON.Você pode usar esse JSON extract para importar o agente em uma organização diferente.

15. Por fim, insira seu agente em uma automação usando a atividade Run Job no Studio. Para obter detalhes, consulte Execução do agente.

Execução do agente

Usar agentes como atividades significa que você pode incorporá-los a fluxos de trabalho para lidar com partes de processos determinísticos maiores, ter vários agentes atuando em série e iniciar a execução de agentes com base em triggers.

Para incorporar seu agente em um fluxo de trabalho, siga estas etapas:

1. Publique seu agente no Orchestrator.
2. No Studio, use a atividade Run Job para integrar seu agente a um fluxo de trabalho.

3. Sempre que você fizer alterações no seu agente, publique novamente o agente atualizado no Orchestrator e atualize o processo correspondente no Orchestrator.

   A atividade Run Job sempre executa a versão do agente atualmente configurado no Orchestrator. Isso garante que seu fluxo de trabalho use consistentemente a versão mais atualizada do seu agente.

Consulte o Guia de atividades do sistema para saber como configurar e usar a atividade Run Job em seus fluxos de trabalho do Studio.

Observação: a partir da versão 25.4.2 do UiPath.System.Activities, a execução de agentes e outros trabalhos do Orchestrator foi consolidada e aprimorada na atividade Run Job. Os fluxos de trabalho existentes que utilizam a atividade Run Agent continuam a operar sem alterações, garantindo uma transição suave. Ao adicionar nova funcionalidade de execução de agente aos seus fluxos de trabalho, o sistema sugere e implementa automaticamente a atividade Run Job, mesmo se você pesquisar por Run Agent.