Construção de um agente no Studio Web.

Esta seção orienta você sobre como criar um agente no Studio Web. Para criar agentes confiáveis de nível de produção, recomendamos enfaticamente que você 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.

Criando o agente

1. Acesse studio.uipath.com.
2. Selecione o botão Criar Novo e, em seguida, selecione Agente.
3. Selecione o tipo de agente:
   • Autônomo: crie um agente que aja de forma independente para concluir uma determinada tarefa.
   • De conversação (visualização): crie um Assistant que interaja com os usuários por meio de diálogo em tempo real.
4. Se você quiser criar seu agente do zero, selecione Iniciar do zero.
5. Se você quiser gerar seu agente usando o Autopilot (Visualização), descreva o agente que você deseja criar na caixa de mensagem disponível e, em seguida, selecione Gerar agente. Seja o mais específico possível para que o Autopilot possa gerar um agente de forma eficiente.
6. A nova solução abre, com o painel designer de Agente exibido.

7. Ao configurar seu agente, você pode escolher entre dois modos de design: a visualização de Formulário tradicional e a visualização de Fluxo (Pré-visualização). Ambos os modos compartilham a mesma definição de agente subjacente e permanecem totalmente sincronizados, então você pode alternar entre eles a qualquer momento sem perder dados.

   Use a visualização do formulário para uma experiência de configuração estruturada e passo a passo, ou mude para a visualização do fluxo para um layout visual baseado em nós que permite que você veja como os componentes do seu agente se conectam e interagem.

Configurando o agente

Ao configurar seu agente, você pode escolher entre dois modos de design: a visualização de Formulário tradicional e a visualização de Fluxo (Pré-visualização). Ambos os modos compartilham a mesma definição de agente subjacente e permanecem totalmente sincronizados, então você pode alternar entre eles a qualquer momento sem perder dados.

Use a visualização do formulário para uma experiência de configuração estruturada e passo a passo, ou mude para a visualização do fluxo para um layout visual baseado em nós que permite que você veja como os componentes do seu agente se conectam e interagem.

Criar um agente usando a visualização do formulário (Padrão)

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. Para obter detalhes, consulte Configuração de LLMs.
   2. Configure a Temperatura e o máx. tokens por campos de resposta . Essas configurações podem ser controladas por uma política de governança do Automation Ops. Para obter detalhes, consulte Configurações das políticas do Studio Web.
   • 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.

Criar um agente usando a visualização Fluxo (Pré-visualização)

1. Abra seu projeto do agente no Studio Web.
2. No canto superior direito da tela de tempo de design, selecione a opção Fluxo (Pré-visualização) na alternância de modo de criação.

   • A tela Fluxo é aberta, exibindo a estrutura do agente como nós.

   • Você pode voltar para a exibição do formulário a qualquer momento. Todas as alterações são salvas e traduzidas automaticamente entre os dois modos.

3. Comece com o nó do LLM.
   • Selecione-o para abrir o painel Propriedades à direita e, em seguida, escolha e configure seu modelo.
     • Selecionar um modelo na lista suspensa disponível. Os modelos são provisionados por meio da AI Trust Layer da UiPath . Para saber como usar um modelo personalizado, consulte Configuração de LLMs.
     • Configure a Temperatura e o máx. tokens por campos de resposta . Essas configurações podem ser controladas por uma política de governança do Automation Ops. Para obter detalhes, consulte Configurações das políticas do Studio Web.
       • 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.
   • Depois que um modelo for selecionado, o nó será atualizado com o ícone da família de modelos correspondente e o destaque desaparecerá.
4. Configure o nó Agente.
   • O nó Agente é criado por padrão ao lado do nó LLM.
   • Abra a seção Solicitação à direita para definir seu sistema e prompts do usuário. Para agentes de conversa, essa seção é simplificada e apenas o prompt do sistema é mostrado.
   • Abra a seção Esquema à esquerda para definir os argumentos de entrada e saída no painel do Data Manager .
5. Adicione contexto, ferramentas e escalonamentos. Após concluir os nós de LLM e Agente, três novos tipos de nó ficam disponíveis:
   • Contexto: selecione um índice de Contextualização e ajuste seus parâmetros de pesquisa.
   • Ferramentas: abra a paleta de comando, pesquise uma ferramenta implantada e adicione-a à sua tela. Você pode configurar ainda mais cada ferramenta depois de adicionada.
   • Escalonamentos: adicione um nó com intervenção humana que se conecta à experiência de configuração de escalonamento existente.
6. Acesse opções adicionais selecionando o menu ⋮ (Mais ações) em um nó de ferramenta. As seguintes ações estão disponíveis:
   • Adicionar ponto de interrupção – Insere um ponto de interrupção no nó da ferramenta. Quando o agente é depurado, a execução é pausada pouco antes que essa ferramenta seja executada, permitindo que você inspecione suas entradas, saídas e dados de trace. Os pontos de interrupção são úteis para verificar a lógica da ferramenta e depurar erros durante o teste de tempo de design.
   • Adicionar diretriz – Abre a janela Configuração da diretriz , onde você pode definir regras que restringem ou monitoram como a ferramenta é usada no runtime.
   • Desabilitar – Desabilita temporariamente o nó da ferramenta selecionada da execução do agente. As ferramentas desabilitadas permanecem na tela, mas são ignoradas durante o runtime e a depuração, permitindo que você teste ou refine o comportamento do agente sem remover permanentemente a ferramenta.
     
     

     

     
     
7. Depure seu agente.
   • Selecione Depurar para executar seu agente no período de design.
   • À medida que o agente é executado, os nós aparecem em sequência para mostrar o fluxo de execução.
   • Se você executar simulações, os nós aparecem em uma cor diferente para indicar dados simulados ou chamadas de ferramentas.
   • Para agentes de conversa, uma janela de chat persistente permite que você teste as trocas; cada mensagem dispara uma execução de depuração que exibe os destaques nos nós conectados.
   • Você também pode definir pontos de interrupção em nós específicos para pausar a execução e inspecionar entradas, saídas e dados de rastreamento.
8. Salve e publique suas alterações.
   • Todas as atualizações na exibição Fluxo são armazenadas automaticamente e permanecem sincronizadas com a exibição Formulário.
   • Quando estiver pronto, publique o agente para disponibilizá-lo para testes e implantação.

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 e, em seguida, selecione Configuração de depuração.
3. Na janela Configuração de depuração , confirme os recursos usados na solução e a entrada de exemplo.
4. Selecione Salvar e Executar.
5. Use 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 os 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 e Configuração de simulações em 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.