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 Configuração de implantação – Defina a configuração específica do ambiente para publicar e executar o agente.

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.

O painel inferior torna as avaliações uma parte fundamental da experiência de projeto, mantendo o histórico, resultados e traços ao vivo, todos em um único lugar. As abas disponíveis dependem do tipo de agente que você está criando:

• Para agentes autônomos, o painel inferior inclui:

  • Trilha de execução – Mostra detalhes do rastreamento da execução atual. Quando você executa seu agente, esta aba abre-se automaticamente para que você possa seguir os traços ao vivo em tempo real.

  • Histórico – Exibe todas as suas execuções de agentes com rastreamentos e detalhes de execução. A partir daqui, você pode adicionar execuções diretamente a conjuntos de avaliação.

  • Avaliações – Lista todos os seus conjuntos de avaliação, mostrando pontuações recentes. Expandir um conjunto para ver suas avaliações, exibir detalhes ou executar testes individualmente ou como um conjunto completo.

• Para agentes de conversação, o painel inferior inclui:

  • Chat – Substitui a aba Trilha de execução. Fornece uma Janela de chat interativa para testar conversas com seu agente, ao mesmo tempo em que exibe a trilha de execução para cada troca.

  • Histórico – Exibe todas as suas execuções de conversação com rastreamentos e detalhes de execução. A partir daqui, você pode adicionar execuções diretamente a conjuntos de avaliação.

  • Avaliações – Lista todos os seus conjuntos de avaliação, mostrando pontuações recentes. Expandir um conjunto para ver suas avaliações, exibir detalhes ou executar testes individualmente ou como um conjunto completo.

Figura 1. O espaço de trabalho dos agentes

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 2. 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 3. Configuração das definiçõ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 4. Argumentos de entrada no painel do Gerenciador de dados
   

   

   
   
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.

Uso de modelos de agente

Você pode iniciar sua jornada com agentes com um conjunto de modelos de agentes, disponíveis na página Agentes no Automation Cloud^TM e no UiPath® Marketplace.

Um modelo de agente vem pré-configurado para tarefas específicas. Requer uma configuração mínima para ser executável no Studio, e você pode modificá-la e adaptá-la às suas necessidades específicas. Um modelo de agente tem:

• Componentes predefinidos – Comandos do sistema, ferramentas de atividades com descrições, conjuntos de avaliação iniciais.
  • Os componentes são genéricos, não específicos da empresa ou da organização.
  • Os componentes estão prontamente disponíveis na definição do agente. Alguns componentes (como atividades como ferramentas) podem precisar de configuração adicional, como criar as conexões necessárias no Integration Service.
• Componentes que exigem configuração adicional – Índices de Contextualização, automações e processos como ferramentas, escalonamentos personalizados e todas as descrições afiliadas (instruções para o agente).
  • Esses componentes são específicos da organização e do tenant.

Para começar a usar modelos de agente do UiPath Marketplace, siga as seguintes etapas:

1. Na página Agentes no Automation Cloud, acesse a guia Modelos e selecione qualquer modelo.

   Você é redirecionado para o modelo do Marketplace.

2. Selecione Baixar.
3. Na janela Baixar um modelo de agente, selecione Baixar Solução.
   Um arquivo .uis contendo a definição do agente é baixado na sua máquina.
4. Os modelos de agente também incluem Extras, um pacote separado contendo ativos para seu agente (automações, escalonamentos personalizados). Selecione Baixar Extras.
   Um arquivo .zip é baixado para a sua máquina.
5. No Studio Web, importe o arquivo .uis de definição do agente conforme descrito em Como importar um projeto baixado do Studio Web.
6. Em seguida, acesse Soluções. Para obter detalhes, consulte Como acessar a IU de Soluções.
7. Carregue o arquivo .zip conforme explicado em Como transportar um pacote de solução e, em seguida, implante a solução. Para obter detalhes, consulte Implantação da solução.
8. Agora, você pode acessar seu modelo de agente a partir do Studio Web e adicionar quaisquer ferramentas implantadas no seu tenant.