Agentes codificados no Studio Web

Defina o comportamento dos agentes no Python e gerencie-o por meio do Studio Web para orquestração, avaliação e observabilidade no Automation Suite.

Observação:

Os agentes codificados no Studio Web estão em Visualização.

Os agentes codificados permitem que você defina o comportamento do agente diretamente em Python, enquanto ainda se beneficiam da orquestração, avaliação e observabilidade da UiPath. O Studio Web atua como o plano de controle, enquanto seu Ambiente de Desenvolvimento Integrado (IDE) permanece como o ambiente de desenvolvimento principal.

Após conectar seu projeto local, o Studio Web fornece acesso a:

• Definição — Uma visualização de alto nível dos pontos de entrada e configuração do agente.
• Código de origem — Uma visualização SomenteLeitura de arquivos sincronizados. Seu IDE permanece como a origem autorizada.
• Conjuntos de avaliações — Casos de teste para validar o comportamento do agente.
• Avaliadores — Avaliadores baseados em saída e trajetória que operam durante execuções de avaliações

No Studio Web, você pode executar Debug ou Debug passo a passo, executar avaliações no espaço Avaliações e publicar o agente para uso em produção. Agentes publicados emitem traces visíveis no espaço Traces de agente e podem ser gerenciados a partir da página Gerenciamento de agentes da UiPath.

Pré-requisitos

• Você tem Python 3.11 ou superior e pip ou uv instalado.
• Você criou, inicializou e testou seu projeto de agente codificado localmente. Siga o guia de início rápido para seu framework:
  • SDK Python Core
  • LangChain (LangGraph)
  • LLamaIndex
  • Agentes OpenAI
• Você tem acesso ao Studio Web com uma solução aberta ou pronta para criar.

Criar um agente codificado no Studio Web

1. Acesse studio.uipath.com.
2. Selecione Criar novo e, em seguida, selecione Agente.
3. Selecione Codificado como o tipo de agente.

Resultado: o Studio Web cria um shell de agente codificado e abre a página Configurar seu agente codificado.

Conectar seu projeto local ao Studio Web

Na página Configurar seu agente codificado, o Studio Web orienta você na vinculação do seu projeto Python local ao agente.

Copiar a chave do projeto

1. Na página Configurar seu agente codificado, copie a chave do Projeto do agente.O Studio Web gera essa chave automaticamente para cada projeto de solução.

2. Em seu projeto local, abra o arquivo .env.

3. Adicione a seguinte linha, substituindo <project-id-from-studio> pela chave que você copiou:

   UIPATH_PROJECT_ID=<project-id-from-studio>
   

Essa chave vincula seu projeto local ao agente no Studio Web.

Enviar seu projeto para o Studio Web

1. Abra um terminal em seu diretório de projeto local.

2. Execute o seguinte comando:

   uipath push
   

Resultado: o Studio Web sincroniza os seguintes arquivos de seu projeto local e carrega automaticamente o conteúdo do agente codificado:

• Arquivos de origem (por exemplo, graph.py, entry-points.json)
• Arquivos de configuração (pyproject.toml, uipath.json)
• Ativos de avaliação (avaliadores, conjuntos de avaliação)
• Metadados e vinculações