简介
使用 UiPath CLI 和编码智能体技能构建、评估和发布编码 LangGraph 智能体。
在本实验室中,您将安装 UiPath CLI 和 Coding Agent 技能,然后使用 Coding Agent 构建、运行和评估 LangGraph 智能体。您将执行以下操作:
- 安装 UiPath CLI 和编码智能体技能。
- 构建一个本地项目,并在技能指导下构建 LangGraph 智能体。
- 向智能体添加实时外部查找工具。
- 在本地运行和评估智能体。
- 将项目连接到 UiPath Studio Web 并推送第一个版本。
最后,您将在 UiPath 技能的指导下,通过编码智能体构建一个可用的 LangGraph 智能体,并将评估追踪记录上传到 Studio Web。
可以通过三种方法创建 UiPath 智能体。这使用 LangGraph SDK;您还可以使用低代码 Agent Builder和UiPath CLI创建智能体。
预计时间: 45–60 分钟
您要构建的内容
本实验室将引导您为一个虚拟的风险家行会构建一个任务接收分类器:一个编码的 LangGraph 智能体,用于读取任务描述并将其分类为四个难度级别之一。
它作为简单的单节点分类器开始,因此焦点保持在 CLI 工作流上,而不是域逻辑。然后,您给它一个工具,以便它可以在最终确定层级之前,根据实时外部 API 检查答案,而不是仅根据感知来猜测。
以下是您正在构建的内容的完整设计:
| 组件 | 详细信息 |
|---|---|
输入: description | string;传入的任务说明 |
输出: tier | 严格限制为 Literal"Trivial"、 、"Standard" 或"Heroic""Legendary" 的 类型,而非纯字符串,因此模型无法发出词汇表外层级 |
输出: reasoning | string;智能体对其所选层级的解释 |
工具: get_challenge_rating | LangGraph 工具,仅在任务命名或暗示特定生物时调用,该工具从Open5e 系统参考文档 (SRD) API中查找其挑战评分,并在推理中引用该评分 |
为什么要添加工具?在 UiPath 上运行 LangGraph 智能体而非低代码智能体的一个重要原因是复杂的 Python 逻辑,该逻辑可以调用外部系统,而不仅仅是对文本进行分类。此实验室中的工具步骤演示了以下内容:智能体在运行时决定任务是否需要验证、调用实时 API 并对结果进行推理。
先决条件
- CLI 版本- 针对 UiPath CLI v1.201.0(已在步骤 1 中安装)进行验证。不同版本的行为可能有所不同;报告与
uip feedback send的偏差。 - UiPath 帐户- 开始之前,请注册或登录UiPath Automation Cloud 。
- Node.js 18+ - 安装 UiPath CLI 所必需的。检查
node --version。如有需要,请从nodejs.org下载。 - VS Code与编码智能体(Claude Code、Copilot 或 Cursor)一起使用。实验室说明使用 Claude Code,但任何受支持的编码智能体都可以使用。
- Bash 终端- 此实验室中的命令使用 Bash 语法。在 VS Code 中,打开一个新终端,然后选择Git Bash (或等效选项)作为终端类型。PowerShell 和 CMD 语法不同,可能会导致意外错误。
- ug - 快速的 Python 包管理器。使用以下命令安装:
或参阅ug 安装文档以了解其他选项。
pip install uvpip install uv - 管理员权限- 安装全局 npm 包和 Python 依赖项需要管理员/提升权限。如果您使用的是受到限制的工作笔记本电脑,请在开始之前确认您可以安装软件包,或提前与 IT 团队联系。
本实验无需具备 UiPath 知识,但具备 UiPath 知识将使其运行速度更快。
此实验室中的 2 名“智能体”。“编码智能体”是 UiPath 的术语,指的是部署在平台上的 Python 智能体;本实验室将使用 LangGraph SDK 构建一个示例。实验室说明中还会引用您的“编码智能体”(Claude Code、Copilot、Cursor),以帮助您编写 Python 代码。
当说明显示“询问您的编码智能体”时,指您的集成开发环境 (IDE) 助手;当他们说“运行智能体”时或“您的 LangGraph 智能体”它们是指正在构建的 UiPath 智能体。