Conecte-se ao Studio Web

Conecte seu projeto local do LangGraph ao UiPath Studio Web e envie sua primeira versão.

Com os resultados da avaliação local confirmados, você está pronto para conectar o projeto ao Studio Web.

Etapa 9 - Conecte-se ao Studio Web

Seu agente é criado e avaliado localmente. Agora conecte-a ao Studio Web para ter o histórico de versões, rastreamentos de avaliação e a capacidade de testar na interface gráfica da nuvem.

Você tem três opções:

Opção	O que acontece
R: Você o configurou no Studio Web	Abra o Studio Web, crie um projeto de agente codificado, copie o ID do projeto. Você cola em .env e envia por push a partir da CLI.
B: pacotes e uploads de CLI	A CLI empacota o agente e o publica em seu feed do espaço de trabalho pessoal sem a configuração do Studio Web. Consulte os documentos da solução uip para obter a referência de comando.
C: somente servidor de desenvolvimento local	uip codedagent dev para uma interface de usuário da web local. Nada é publicado na nuvem.

Para este laboratório, use a Opção A: ela mostra o modelo de conexão subjacente a todas as três opções.

Opção A - Conectar por meio do Studio Web

1. Faça logon no UiPath Automation Cloud e abra o Studio Web na navegação lateral.

2. Selecione Criar novo e selecione Agente. Escolha Codificado como o tipo de agente e, em seguida, selecione Iniciar do zero.

3. O Studio Web exibe um painel de Configuração do seu agente codificado . Em Sincronizar do seu IDE no Studio Web, seu UIPATH_PROJECT_ID aparece com um botão de cópia. Copie este valor.

4. Abra o arquivo .env na raiz do seu projeto e adicione o ID do projeto:

   UIPATH_PROJECT_ID=your-project-id-here
   

   Observação:

   Apenas o ID do projeto vai em .env. uip login armazena seu token de autenticação globalmente; você não precisa de UIPATH_URL ou UIPATH_ACCESS_TOKEN em .env. Se você já usou o SDK Python da UiPath antes e está acostumado a executar uipath auth para preencher esses campos, essa etapa não é mais necessária.

5. Adicione .env a .gitignore para evitar confirmá-la:

   echo ".env" >> .gitignore
   

6. Envie seu agente para o Studio Web:

   uip codedagent push
   

   Um push bem-sucedido retorna a confirmação e incrementa a versão 0.0.1. Abra seu projeto no Studio Web; a definição do agente, seus conjuntos de avaliação e a versão 0.0.1 aparecem no histórico de versões.

---

Etapa 10 — Iterar e melhorar (opcional)

Com avaliações implementadas e Studio Web conectado, você pode iterar em seu agente e observar o efeito nas pontuações:

1. Revise os resultados da avaliação em eval-results.json ou no Studio Web.
2. Peça ao seu agente de codificação para melhorar o agente com base no feedback da avaliação.
3. Execute novamente avaliações para verificar melhorias.
4. Envie a versão atualizada para o Studio Web.

uip codedagent eval agent evaluations/eval-sets/smoke-test.json --workers 3

uip codedagent push

Cada push incrementa a versão no Studio Web, dando a você um histórico completo de como o agente evoluiu.

---

O que você construiu

Você criou um agente do LangGraph no UiPath usando a CLI e as habilidades do agente de codificação:

• Estruture um projeto Python local com a estrutura LangGraph correta usando uip codedagent new.
• Usou seu agente de codificação para criar a lógica do agente, guiado por habilidades da UiPath, não por prompts detalhados.
• Executou o agente localmente e verificava saídas antes de tocar na nuvem.
• Criou um conjunto de avaliação e atribuiu uma pontuação ao agente localmente.
• Conectada ao Studio Web, a primeira versão com histórico de avaliação completa foi enviada.

O que vem em seguida

• Agentes de amostra do UiPath LangGraph – exemplos de trabalho, incluindo a classificação de tíquetes com intervenção humana, RAG, supervisores de vários agentes e integração de MCP.
• Documentos do SDK Python da UiPath – referência completa para comandos CLI, padrões de agentes e APIs do SDK.
• Guia de estrutura de avaliação - como criar, executar e interpretar conjuntos de avaliação.
• Documentos do LangGraph - a estrutura de orquestração usada neste laboratório.
• UiPath Community - Fóruns, instruções e debate para desenvolvedores.