agents
latest
false
重要 :
新发布内容的本地化可能需要 1-2 周的时间才能完成。
智能体用户指南
上次更新日期 2026年3月30日
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 进行身份验证。 - 您已在本地创建、初始化并测试编码智能体项目。请遵循框架的快速入门指南：
- 您可以通过打开或准备创建的解决方案来访问 Studio Web。
在 Studio Web 中创建编码智能体
- 转到 studio.uipath.com。
- 选择“新建”，然后选择“智能体”。
- 选择编码作为智能体类型。
结果： Studio Web 创建一个编码智能体 Shell 并打开“设置编码智能体”页面。
将本地项目连接到 Studio Web
在设置您的编码智能体页面上，Studio Web 会指导您将本地 Python 项目链接到智能体。
复制项目键
-
在设置编码智能体页面上，复制智能体项目密钥。Studio Web 自动为每个解决方案项目生成此密钥。
-
在本地项目中，打开
.env文件。 -
添加以下行，将
<project-id-from-studio>替换为您复制的密钥：UIPATH_PROJECT_ID=<project-id-from-studio>UIPATH_PROJECT_ID=<project-id-from-studio>
此密钥将您的本地项目链接到 Studio Web 中的智能体。
将项目推送到 Studio Web
-
在本地项目目录中打开终端。
-
运行以下命令：
uipath pushuipath push
结果： Studio Web 同步本地项目中的以下文件，并自动加载编码智能体内容：
- 源文件（例如
graph.py、entry-points.json） - 配置文件（
pyproject.toml、uipath.json） - 评估资产（评估程序、评估集）
- 元数据和绑定