UiPath Documentation
getting-started
latest
false
Getting started developer guide
  • Overview
    • Overview
  • Getting Started with UiPath Agents
  • Getting Started with UiPath Agents using LangGraph
    • Introduction
    • Set up your environment
    • Build the agent
    • Evaluate the agent
    • Connect to Studio Web
  • Building a Low-Code Agent in Studio Web
  • Adding Tools to Your UiPath Agent

Connect to Studio Web

Connect your local LangGraph project to UiPath Studio Web and push your first version.

With local evaluation results confirmed, you are ready to connect the project to Studio Web.

Step 9 - Connect to Studio Web

Your agent is built and evaluated locally. Now connect it to Studio Web so you get version history, evaluation traces, and the ability to test in the cloud UI.

You have three options:

OptionWhat happens
A: You set it up in Studio WebOpen Studio Web, create a Coded Agent project, copy the project ID. You paste it into .env and push from the CLI.
B: CLI packages and uploadsCLI packages the agent and publishes it to your personal workspace feed without Studio Web setup. See the uip solution docs for the command reference.
C: Local dev server onlyRun uip codedagent dev for a local web UI. Nothing is published to the cloud.

For this lab, use Option A: it shows the connection model that underlies all three options.

Option A - Connect via Studio Web

  1. Log in to UiPath Automation Cloud and open Studio Web from the side navigation.

  2. Select Create New and select Agent. Choose Coded as the agent type, then select Start Fresh.

  3. Studio Web displays a Setup your coded agent panel. Under Sync from your IDE into Studio Web, your UIPATH_PROJECT_ID appears with a copy button. Copy this value.

  4. Open the .env file in your project root and add the project ID:

    UIPATH_PROJECT_ID=your-project-id-here
    UIPATH_PROJECT_ID=your-project-id-here
    
    Note:

    Only the project ID goes in .env. uip login stores your auth token globally; you do not need UIPATH_URL or UIPATH_ACCESS_TOKEN in .env. If you have used the UiPath Python SDK before and are used to running uipath auth to populate those fields, that step is no longer needed.

  5. Add .env to .gitignore to avoid committing it:

    echo ".env" >> .gitignore
    echo ".env" >> .gitignore
    
  6. Push your agent to Studio Web:

    uip codedagent push
    uip codedagent push
    

    A successful push returns confirmation and increments the version to 0.0.1. Open your project in Studio Web; the agent definition, your evaluation sets, and version 0.0.1 appear in the version history.


Step 10 - Iterate and improve (optional)

With evaluations in place and Studio Web connected, you can iterate on your agent and observe the effect on scores:

  1. Review evaluation results in eval-results.json or in Studio Web.
  2. Ask your coding agent to improve the agent based on the evaluation feedback.
  3. Re-run evaluations to verify improvements.
  4. Push the updated version to Studio Web.
uip codedagent eval agent evaluations/eval-sets/smoke-test.json --workers 3
uip codedagent eval agent evaluations/eval-sets/smoke-test.json --workers 3
uip codedagent push
uip codedagent push

Each push increments the version in Studio Web, giving you a full history of how the agent evolved.


What you built

You have built a LangGraph agent on UiPath using the CLI and coding agent skills:

  • Scaffolded a local Python project with the correct LangGraph structure using uip codedagent new.
  • Used your coding agent to build the agent logic, guided by UiPath skills, not detailed prompts.
  • Ran the agent locally and verified outputs before touching the cloud.
  • Created an evaluation set and scored the agent locally.
  • Connected to Studio Web and pushed the first version with full evaluation history.

What's next

  • Step 9 - Connect to Studio Web
  • Option A - Connect via Studio Web
  • Step 10 - Iterate and improve (optional)
  • What you built
  • What's next

Was this page helpful?

Connect

Need help? Support

Want to learn? UiPath Academy

Have questions? UiPath Forum

Stay updated