Agentes codificados no Studio Web (visualização)

Observação:

Os agentes codificados no Studio Web estão em Pré-visualização.

Agentes codificados permitem que você defina o comportamento do agente diretamente no Python e ainda se beneficie da orquestração, avaliação e capacidade de observação da UiPath. O Studio Web atua como o plano de controle, enquanto seu Ambiente de desenvolvimento integrado (IDE) permanece o ambiente de desenvolvimento principal.

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

• Definição — Uma visualização de alto nível dos pontos de entrada e da configuração do agente.
• Código-fonte — Uma visualização somente de leitura de arquivos sincronizados. Seu IDE continua sendo a origem autorizada.
• Conjuntos de avaliação — Casos de teste para validar o comportamento do agente.
• Avaliadores — Avaliadores baseados em saída e trajetória usados durante as execuções de avaliação.

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

Pré-requisitos

• Você tem o Python 3.11 ou superior e pip ou uv instalado.
• Você se autentique com a UiPath Automation Cloud executando uipath auth no seu diretório de projeto.
• Você criou, inicializou e testou seu projeto de agente codificado localmente. Siga o guia de início rápido para sua estrutura:
  • SDK do Python principal
  • 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 .

Conecte seu projeto local ao Studio Web

Na página Configurar seu agente codificado , o Studio Web orienta você a vincular seu projeto local do Python ao agente.

Copie 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.

Envie seu projeto ao Studio Web

1. Abra um terminal no 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 associações