docs(studio-web): document coded function integration [PRODEV-605] (#1675)

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>

Author: alexandra-c

packages/uipath/docs/FAQ.md

@@ -1,6 +1,6 @@
 # Frequently Asked Questions (FAQ)
 
-### Q: Why am I getting a "Failed to prepare environment" error when deploying my python agent to UiPath Cloud Platform?
+### Q: Why am I getting a "Failed to prepare environment" error when deploying my Python project to UiPath Cloud Platform?
 
 #### Error Message
 
@@ -30,7 +30,7 @@
 
 #### Description
 
-This error might occur when deploying coded-agents to UiPath Cloud Platform, even though the same project might work correctly in your local environment. The issue is often related to how Python packages are discovered and distributed during the cloud deployment process.
+This error might occur when deploying coded functions or coded agents to UiPath Cloud Platform, even though the same project might work correctly in your local environment. The issue is often related to how Python packages are discovered and distributed during the cloud deployment process.
 
 #### Common Causes
 
@@ -283,7 +283,7 @@ If you encounter SSL certificate errors:
    ////
 
 
-### Q: Why are my agent runs hanging on UiPath Cloud Platform?
+### Q: Why are my job runs hanging on UiPath Cloud Platform?
 
 #### Error Message
 
@@ -298,7 +298,7 @@ You may see errors like these in the logs panel:
 
 #### Description
 
-If your Python agent runs are hanging or not completing when deployed to UiPath Cloud Platform's serverless environment, this may be caused by a library incompatibility issue from an outdated version of the UiPath Python library.
+If your Python job runs are hanging or not completing when deployed to UiPath Cloud Platform's serverless environment, this may be caused by a library incompatibility issue from an outdated version of the UiPath Python library.
 
 #### Solution
 

packages/uipath/docs/cli/index.md

@@ -1,5 +1,7 @@
 # CLI Reference
 
+The following commands apply to both **coded functions** and **coded agents**. The entry point name (`main`, `agent`, or any key you define in `uipath.json`) is the first argument to `run`, `debug`, `eval`, and `invoke`.
+
 ::: mkdocs-click
     :module: uipath._cli
     :command: auth
@@ -132,7 +134,7 @@ For step-by-step debugging with breakpoints and variable inspection (supported f
 ```console
 # Install debugpy package
 uv pip install debugpy
-# Run agent with debugging enabled
+# Run with debugging enabled
 uipath run [ENTRYPOINT] [INPUT] --debug
 ```
 For vscode:
@@ -154,19 +156,19 @@ Depending on the shell you are using, it may be necessary to escape the input js
 
 /// tab | Bash/ZSH
 ```console
-uipath run agent '{"topic": "UiPath"}'
+uipath run main '{"message": "hello"}'
 ```
 ///
 
 /// tab | Windows CMD
 ```console
-uipath run agent "{""topic"": ""UiPath""}"
+uipath run main "{""message"": ""hello""}"
 ```
 ///
 
 /// tab | Windows PowerShell
 ```console
-uipath run agent '{\"topic\":\"uipath\"}'
+uipath run main '{\"message\":\"hello\"}'
 ```
 ///
 
@@ -312,7 +314,7 @@ Selected feed: Orchestrator Tenant Processes Feed
 <!-- termynal -->
 
 ```shell
-> uipath invoke agent '{"topic": "UiPath"}'
+> uipath invoke main '{"message": "hello"}'
 ⠴ Loading configuration ...
 ⠴ Starting job ...
 ✨ Job started successfully!
@@ -380,7 +382,7 @@ File 'uipath.json' is up to date
     :depth: 1
     :style: table
 
-Runs your agent under the debug runtime, with a debug bridge attached. Locally, the bridge is the interactive **console** (read commands from stdin, stop at breakpoints). In the cloud, the bridge is **SignalR** (driven by Studio Web / Orchestrator). The `--attach` flag lets you override that default, including `none` for executors that need the debug command's surrounding behavior (bindings fetch, state streaming) but cannot speak the interactive debug protocol.
+Runs your project under the debug runtime, with a debug bridge attached. Locally, the bridge is the interactive **console** (read commands from stdin, stop at breakpoints). In the cloud, the bridge is **SignalR** (driven by Studio Web / Orchestrator). The `--attach` flag lets you override that default, including `none` for executors that need the debug command's surrounding behavior (bindings fetch, state streaming) but cannot speak the interactive debug protocol.
 
 ### Attach modes
 
@@ -427,7 +429,7 @@ Next: analyze_sentiment
     :depth: 1
     :style: table
 
-Runs an evaluation set against your agent. Entry point and eval set are auto-discovered from the project if not passed explicitly. Evaluations run in parallel (see `--workers`) and, unless `--no-report` is passed, results are reported back to Studio Web when `UIPATH_PROJECT_ID` is set.
+Runs an evaluation set against your project. Entry point and eval set are auto-discovered from the project if not passed explicitly. Evaluations run in parallel (see `--workers`) and, unless `--no-report` is passed, results are reported back to Studio Web when `UIPATH_PROJECT_ID` is set.
 
 ### Common flags
 

packages/uipath/docs/core/agents.md

@@ -0,0 +1,245 @@
+# Python Coded Agents
+
+A coded agent is Python code that uses an LLM reasoning loop to make decisions, call tools, and produce a result. You write the agent logic using a framework of your choice — the `uipath` SDK provides the platform layer: authentication, assets, buckets, connections, tracing, and human-in-the-loop. Package it with the CLI and deploy it as an Orchestrator job.
+
+Use a coded agent when your automation needs multi-step reasoning, dynamic tool selection, or LLM-driven decisions. Use a [coded function](./functions.md) when your logic is deterministic and no LLM is required.
+
+---
+
+## Architecture
+
+Every coded agent is built from two layers:
+
+| Layer | Package | Responsibility |
+|-------|---------|---------------|
+| **Platform** | `uipath` | Auth, assets, buckets, connections, tracing, human-in-the-loop, CLI, packaging |
+| **Framework** | one extension (see below) | LLM calls, tool routing, agent loop, memory |
+
+The `uipath` package is always required. Add one framework extension on top:
+
+| Framework | Package | Best for |
+|-----------|---------|---------|
+| LangChain / LangGraph | `uipath-langchain` | Graph-based agents, complex multi-step flows |
+| LlamaIndex | `uipath-llamaindex` | RAG-heavy agents, document reasoning |
+| OpenAI Agents SDK | `uipath-openai-agents` | OpenAI-native tool use, handoffs |
+| PydanticAI | `uipath-pydantic-ai` | Type-safe agents with Pydantic models |
+| Google ADK | `uipath-google-adk` | Gemini models, Google ecosystem |
+| UiPath Agent Framework | `uipath-agent-framework` | UiPath-native agent primitives |
+
+---
+
+## Quickstart
+
+The example below uses LangChain. Swap `uipath-langchain` for the framework of your choice.
+
+//// tab | uv
+
+<!-- termynal -->
+
+```shell
+> mkdir my-agent && cd my-agent
+> uv init . --python 3.11
+> uv add uipath uipath-langchain
+
+> uipath auth
+⠋ Authenticating with UiPath ...
+✓  Authentication successful.
+
+> uipath new agent
+✓  Created new agent project.
+
+> uipath init
+⠋ Initializing UiPath project ...
+✓  Created 'entry-points.json' file.
+✓  Created 'bindings.json' file.
+
+> uipath run agent '{"message": "hello"}'
+```
+
+////
+
+//// tab | pip
+
+<!-- termynal -->
+
+```shell
+> mkdir my-agent && cd my-agent
+> python -m venv .venv
+> source .venv/bin/activate
+> pip install uipath uipath-langchain
+
+> uipath auth
+⠋ Authenticating with UiPath ...
+✓  Authentication successful.
+
+> uipath new agent
+✓  Created new agent project.
+
+> uipath init
+⠋ Initializing UiPath project ...
+✓  Created 'entry-points.json' file.
+✓  Created 'bindings.json' file.
+
+> uipath run agent '{"message": "hello"}'
+```
+
+////
+
+---
+
+## Project Structure
+
+```
+my-agent/
+├── main.py            # agent logic
+├── pyproject.toml     # project metadata and dependencies
+├── uipath.json        # entry point declarations
+├── entry-points.json  # generated — I/O JSON Schema
+└── bindings.json      # generated — resource binding overrides
+```
+
+### `uipath.json`
+
+```json
+{
+  "agents": {
+    "agent": "main.py:agent"
+  }
+}
+```
+
+### `pyproject.toml`
+
+```toml
+[project]
+name = "my-agent"
+version = "0.1.0"
+description = "..."
+authors = [{ name = "Your Name", email = "you@example.com" }]
+requires-python = ">=3.11"
+dependencies = ["uipath>=2.0", "uipath-langchain>=2.0"]
+
+[tool.uipath]
+type = "agent"
+```
+
+`[tool.uipath] type = "agent"` is required — it identifies the project as an agent to the runtime and packaging tools.
+
+---
+
+## Input & Output
+
+Define `Input` and `Output` as Python dataclasses, the same way as [coded functions](./functions.md#input--output):
+
+```python
+from dataclasses import dataclass
+
+
+@dataclass
+class Input:
+    message: str
+
+
+@dataclass
+class Output:
+    response: str
+
+
+def agent(input: Input) -> Output:
+    ...
+```
+
+---
+
+## Platform Services
+
+The `uipath` SDK gives your agent access to Orchestrator resources at runtime — credentials are injected automatically when running as a job.
+
+```python
+from uipath.platform import UiPath
+
+sdk = UiPath()
+```
+
+The full set of Orchestrator services is available to agents:
+
+- **Assets** — read credentials and configuration: [Assets reference](./assets.md)
+- **Buckets** — download and upload files: [Buckets reference](./buckets.md)
+- **Connections** — Integration Service connections for ERP and SaaS: [Connections reference](./connections.md)
+- **Context Grounding** — semantic search over enterprise data: [Context Grounding reference](./context_grounding.md)
+
+---
+
+## Tracing
+
+Apply `@traced` to custom steps inside your agent to make them visible in the Orchestrator job trace view and Maestro dashboards. Do **not** trace the entry point — the runtime wraps it automatically.
+
+```python
+from uipath.tracing import traced
+
+
+@traced(name="lookup_vendor", run_type="uipath")
+def lookup_vendor(vendor_id: str) -> dict:
+    ...
+```
+
+See [Tracing](./traced.md) for the full decorator reference.
+
+---
+
+## Framework Guides
+
+Each framework extension has its own getting started guide and sample agents:
+
+| Framework | Guide | Samples |
+|-----------|-------|---------|
+| LangChain / LangGraph | [Get Started](../langchain/quick_start.md) | [Samples](https://github.com/UiPath/uipath-langchain-python/tree/main/samples) |
+| LlamaIndex | [Get Started](../llamaindex/quick_start.md) | [Samples](https://github.com/UiPath/uipath-integrations-python/tree/main/packages/uipath-llamaindex/samples) |
+| OpenAI Agents SDK | [Get Started](../openai-agents/quick_start.md) | [Samples](https://github.com/UiPath/uipath-integrations-python/tree/main/packages/uipath-openai-agents/samples) |
+| PydanticAI | [README](https://github.com/UiPath/uipath-integrations-python/blob/main/packages/uipath-pydantic-ai/README.md) | [Samples](https://github.com/UiPath/uipath-integrations-python/tree/main/packages/uipath-pydantic-ai/samples) |
+| Google ADK | [README](https://github.com/UiPath/uipath-integrations-python/blob/main/packages/uipath-google-adk/README.md) | [Samples](https://github.com/UiPath/uipath-integrations-python/tree/main/packages/uipath-google-adk/samples) |
+| UiPath Agent Framework | [README](https://github.com/UiPath/uipath-integrations-python/blob/main/packages/uipath-agent-framework/README.md) | [Samples](https://github.com/UiPath/uipath-integrations-python/tree/main/packages/uipath-agent-framework/samples) |
+
+
+---
+
+## Pack & Publish
+
+The same CLI workflow applies as for coded functions:
+
+<!-- termynal -->
+
+```shell
+> uipath pack
+⠋ Packaging project ...
+Name       : my-agent
+Version    : 0.1.0
+Description: Add your description here
+Authors    : Your Name
+✓  Project successfully packaged.
+
+> uipath publish
+⠋ Fetching available package feeds...
+Select feed number: 0
+✓  Package published successfully!
+```
+
+After publishing, the agent registers as an Orchestrator Process and can be invoked from Maestro, the Orchestrator API, or the CLI.
+
+See [CLI Reference](../cli/index.md) for full `pack`, `publish`, and `invoke` options.
+
+---
+
+## Studio Web Integration
+
+Connect your agent to a Studio Web solution for cloud debugging, evaluation, and solution packaging.
+
+See [Studio Web Integration](./studio_web.md) for setup and sync details.
+
+---
+
+## Evaluations
+
+Coded agents support evaluations in Studio Web and locally via `uipath eval`. Evaluators cover LLM output quality, tool call correctness, and trajectory analysis.
+
+See the [Evaluations documentation](../eval/index.md) for available evaluators and how to define evaluation sets.

packages/uipath/docs/core/assets/maestro_execution_trace_light.png

@@ -17,12 +17,12 @@ UIPATH_FOLDER_PATH=/default/path
 export UIPATH_FOLDER_PATH=/system/path
 ```
 /// warning
-When deploying your agent to production, ensure that all required environment variables (such as API keys and custom configurations) are properly configured in your process settings. This step is crucial for the successful operation of your published package.
+When deploying your project to production, ensure that all required environment variables (such as API keys and custom configurations) are properly configured in your process settings. This step is crucial for the successful operation of your published package.
 ///
 
 ## Design
 
-Create a `.env` file in your project's root directory to manage environment variables locally. When using the `uipath auth` or `uipath new my-agent` commands, this file is automatically created.
+Create a `.env` file in your project's root directory to manage environment variables locally. When using the `uipath auth` or `uipath new` commands, this file is automatically created.
 
 The `uipath auth` command automatically populates this file with essential variables: