Construção de um agente no Studio Web.

Esta seção orienta você sobre como criar um agente no Studio Web. Depois de estar familiarizado com o básico, confira as Melhores práticas.

Explorando o espaço de trabalho do agente

Use a tela principal do designer do Studio Web para projetar seu agente e os painéis esquerdo e direito para explorar a estrutura e os recursos do agente.

O painel do lado esquerdo mostra a estrutura do agente e inclui:

• O Explorador de Projeto – Organizar e criar seu agente. Defina solicitações, ferramentas, contexto, escalonamentos e mais.
• O Gerenciador de dados – Defina argumentos de entrada e saída.
• O painel Erros – Consulte problemas de tempo de design, configurações interrompidas ou execuções de teste com falha.

O painel do lado direito inclui:

• O painel Propriedades, dividido entre:

  • A aba Propriedades – Defina configurações nos níveis de agente e de componente.
  • A aba Dev – Execute entradas de teste, depuração e inspecione rastreamentos em tempo de design.
• Pontuação do agente (Prévia) – Veja a prontidão do seu agente com base nos resultados de avaliação e abrangência de testes.
• O painel Executar saída – Rever resultados das execuções de testes mais recentes.
• Autopilot (Prévia) – Obtenha sugestões impulsionadas por IA para refinar as solicitações, as ferramentas e a configuração do agente.

Criando o agente

1. Acesse studio.uipath.com.
2. Selecione o botão Criar Novo e, em seguida, selecione Agente.
3. A nova solução abre, com o painel designer de Agente exibido.

   [Pré-visualização] A caixa de mensagem do Agent Autopilot é exibida, onde você pode descrever em linguagem natural o agente que deseja criar. Seja o mais específico possível para que o Autopilot possa gerar um agente de forma eficiente.

Configurando o agente

1. No painel Explorador de projetos à esquerda, acesse a Definição do agente, Conjuntos de avaliação e Avaliadores.
   Figura 1. O Agente dentro de uma Solução
   

   

   
   
   1. O painel Definição é onde você projeta e define os elementos principais de um agente. A definição contém as seguintes seções: Geral, Ferramentas, Contextos e Escalonamentos.
      • Use a seção Geral para definir as solicitações para o seu agente.
      • Use a seção Ferramentas para conectar ferramentas de runtime, como conectores do Integration Service ou automações publicadas.
      • Use a seção Contextos para vincular fontes de conhecimento usando índices de Contextualização para dar ao seu agente acesso a dados relevantes.
      • Use a seção Escalonamentos para configurar retrocessos com intervenções humanas e habilitar a memória do agente para persistir nas interações e ajudar a calibrar futuros escalonamentos de agente.
   2. O painel Conjuntos de avaliação é onde você cria avaliações e armazena resultados. As avaliações medem objetivamente a saída do seu agente e avaliam se ela é consistente ou não com seus objetivos. Para obter detalhes, consulte Avaliações.
   3. O painel Avaliadores é onde você cria e gerencia os avaliadores usados em avaliações.
2. Primeiro, selecione seu agente no Explorador de Projetos. Clique com o botão direito do mouse para selecionar Renomear e dê a seu agente um nome exclusivo. O nome do agente ajuda a identificar o agente entre os projetos.
3. Em seguida, acesse o painel Propriedades no menu do lado direito para selecionar o grande modelo de linguagem que você deseja usar com seu agente.
   1. Selecionar um modelo na lista suspensa disponível. Os modelos são provisionados por meio do UiPath AI Trust Layer. Selecione Usar modelo personalizado para trazer seu próprio modelo ou sua própria assinatura. Para obter detalhes, consulte Configuração de LLMs.
   2. 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 (Preciso) e 1 (Creativo).
   • Máximo de tokens por resposta refere-se ao número máximo de tokens a serem gerados com a resposta do agente.
   Figura 2. Definição das configurações do modelo
   

   

   
   
4. No painel Definição do agente, forneça a seu agente um prompt do sistema e um prompt do usuário. Adicione um prompt bem estruturado para instruir o agente sobre o que ele deve fazer e as restrições que deve seguir. Para obter detalhes, consulte Solicitações.
5. Use o painel do Gerenciador de dados para definir os argumentos de entrada e saída do agente usados nas solicitações.
   Figura 3. Argumentos de entrada no painel Data Manager
   

   

   
   
6. Na seção Ferramentas , selecione Adicionar ferramenta para adicionar quaisquer ferramentas que seu agente possa usar durante a execução.Essas podem ser um conjunto de atividades do Integration Service, agentes existentes e automações publicadas às quais você tem acesso. Cada ferramenta deve ter uma descrição detalhada que ajuda o agente a entender como e quando usar essa ferramenta. Para obter detalhes, consulte Ferramentas.
7. (Opcional) Na seção Contextos, selecione Adicionar contexto para dar ao agente acesso aos índices de contextualização. Escolha um índice existente disponível em seu ambiente ou selecione Criar novo para criar um novo índice diretamente no Orchestrator. Para obter detalhes, consulte Contextos.
8. (Opcional) Na seção Escalonamentos, selecione Adicionar escalonamento para adicionar um human-in-the-loop por meio de um aplicativo de escalonamento e habilitar a memória do agente. Adicionar um escalonamento permite que seu agente envolva um ser humano para revisar, aprovar ou atualizar a saída enquanto ela está em execução. Para obter detalhes, consulte Escalonamentos e Memória do agente.

Testar o agente

Agora é hora de testar seu agente e ver como você pode melhorar o agente.

1. Navegue até a barra de ferramentas acima do designer do Studio Web.
2. Selecione a seta ao lado do ambiente de depuração.
3. Selecione Configuração de debug.
4. Na janela Configuração de depuração , confirme os recursos usados na solução e a entrada de exemplo.
5. Selecione Salvar e Executar.

Você pode usar a saída do Teste para refinar o design do agente.

Avaliando o agente

Em seguida, acesse os painéis de Conjuntos de Avaliação e Avaliadores para revisar e medir seu agente.

1. No painel Conjuntos de avaliação:
   • Renomeie o conjunto de avaliação padrão e adicione casos de teste com resultados esperados.
2. No painel Avaliadores, adicione avaliadores para validar a saída do agente.

Cada avaliação vincula uma entrada conhecida a uma asserção sobre a saída.

Para obter detalhes, consulte Avaliações.

Cálculo da pontuação do agente [Pré-visualização]

Selecionar Abrir pontuação de saúde no painel do lado direito para calcular a pontuação do agente. Consulte a Pontuação do agente para saber como ela é calculada.

Usar o Autopilot para melhorar seu agente [Prévia]

Selecionar Abrir o Autopilot no painel do lado direito para receber sugestões sobre como melhorar solicitações, ferramentas e outros componentes. Tais melhorias promovem uma Pontuação de Agente mais alta e tornam seu agente pronto para implantação.

Publicação e implantação do agente

Depois de testar, avaliar e refinar seu agente, chegou o momento de publicá-lo.Essa etapa é necessária para que o agente esteja disponível na atividade Run Job.

1. Selecione Publicar para publicar o agente no Orchestrator como um processo. Selecione onde deseja publicar:
   1. Feed do espaço de trabalho pessoal do Orchestrator – O processo é publicado no seu espaço de trabalho pessoal e estará disponível apenas para você. Essa é a seleção padrão.
   2. Fluxo de processos do tenant do Orchestrator – O processo é publicado no feed global do tenant e está disponível para todos os usuários em pastas elegíveis.
2. 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.
3. Opcionalmente, você pode selecionar Submeter como um modelo para disponibilizar o agente como um modelo em sua organização, ou Compartilhar para compartilhá-lo com usuários em sua organização.

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.