Studio Web 中的编码智能体（预览版）

备注：

Studio Web 中的编码智能体处于预览阶段。

借助编码智能体，您将能够直接在 Python 中定义智能体行为，同时仍可从 UiPath 编排、评估和可观察性中获益。Studio Web 充当控制平面，而您的集成开发环境 (IDE) 仍然是主开发环境。

连接本地项目后，Studio Web 提供以下访问权限：

• 定义 — 智能体入口点和配置的高级视图。
• 源代码 — 同步文件的只读视图。您的 IDE 仍为权威来源。
• 评估集 — 用于验证智能体行为的测试用例。
• 评估器 — 在评估运行期间使用的基于输出和轨迹的评估器。

在 Studio Web 中，您可以运行“调试”或“分步调试”，在评估空间中执行评估，并发布智能体以供生产使用。已发布的智能体会发出在“智能体追踪”空间中可见的追踪数据，并可通过“管理 UiPath 智能体”页面进行管理。

先决条件

• 您已安装 Python 3.11 或更高版本，并已安装 pip 或 uv。
• 您已通过在项目目录中运行 uipath auth，在 UiPath Automation Cloud 中完成了身份验证。
• 您已在本地创建、初始化并测试了编码智能体项目。按照框架的快速入门指南进行操作：
  • Core Python SDK
  • LangChain (LangGraph)
  • LLamaIndex
  • OpenAI 智能体
• 您已具备 Studio Web 的访问权限，并且已打开一个解决方案或已准备好创建解决方案。

在 Studio Web 中创建编码智能体

1. 转到 studio.uipath.com。
2. 选择“新建”，然后选择“智能体”。
3. 选择编码作为智能体类型。

结果：Studio Web 创建一个编码智能体 shell，并打开设置编码智能体页面。

将您的本地项目连接到 Studio Web

在设置编码智能体页面上，Studio Web 会指导您将本地 Python 项目链接到智能体。

复制项目密钥

1. 在设置编码智能体页面上，复制智能体项目密钥。Studio Web 会自动为每个解决方案项目生成此密钥。

2. 在您的本地项目中，打开 .env 文件。

3. 添加以下行，将 <project-id-from-studio> 替换为您复制的密钥：

   UIPATH_PROJECT_ID=<project-id-from-studio>
   

此密钥会将您的本地项目链接到 Studio Web 中的智能体。

将您的项目推送到 Studio Web

1. 在您的本地项目目录中打开终端。

2. 运行以下命令：

   uipath push
   

结果：Studio Web 从您的本地项目同步以下文件，并自动加载编码智能体内容：

• 源文件（例如 graph.py、entry-points.json）
• 配置文件（pyproject.toml、uipath.json）
• 评估资产（评估器、评估集）
• 元数据和绑定