agents
latest
false
重要 :
新发布内容的本地化可能需要 1-2 周的时间才能完成。
智能体用户指南
上次更新日期 2026年5月21日
备注：
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 中已有低代码智能体，则可以将其克隆为编码智能体，无需从头开始。克隆后会生成即用型 Python 项目，您可以继续在 IDE 中进行开发。
有关详细信息，请参阅“将低代码智能体克隆为编码智能体”。
将您的本地项目连接到 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） - 评估资产（评估器、评估集）
- 元数据和绑定