使用 Coding Agents 构建低代码智能体

首次登录后，无需使用浏览器，完全从编码智能体和终端中配置、评估和发布 UiPath 低代码智能体。

安装了 UiPath 技能的编码智能体可以完全从您的终端构建、配置、验证和发布 UiPath 低代码智能体——初始登录后无需使用浏览器。您描述要构建的智能体，编码智能体创建并迭代项目文件，将结果上传到 Studio Web。

有关设置（安装智能体、登录、安装技能），请参阅安装和设置。

先决条件

• 已为您的编码智能体安装的uipath-agents技能。请参阅安装和设置。
• 会话已登录 ( uip login )。

智能体可以执行的操作

每行都涵盖智能体生命周期的一个阶段。编码智能体会从已安装的技能中选取正确的uip agent命令 — 您需要说明结果，而不是命令。

区域	智能体可以执行的操作	询问示例
框架	使用完整目录结构创建新的智能体项目，包括agent.json 、输入/输出架构和默认评估集	“为社交媒体入站评论创建一个新的情感分析智能体。”
配置提示和架构	在以下位置编辑系统提示词、用户消息模板、输入/输出架构和 LLM 模型设置 agent.json	“更新系统提示词以处理发票数据，并向输出架构添加置信度字段。”
添加和管理工具	添加 RPA 流程、其他智能体、API 工作流、Maestro 流、Integration Service 连接器工具、上下文锚定和升级应用程序	“添加 SharePoint 搜索工具和 RPA 流程以进行文档验证。”
刷新并验证	运行uip agent refresh以写入工件并同步入口点架构，然后运行uip agent validate以检查 JSON 结构（只读）；自动修复错误	“验证智能体并修复所有错误。”
上传和下载	将本地项目上传到 Studio Web ( uip solution upload ) 或下载现有的 Studio Web 解决方案以在本地编辑 ( uip solution download )	“将智能体上传到 Studio Web，以便我进行审核。”
评估	创建评估集和测试用例，针对 Agent Runtime 运行，查看分数和执行追踪记录	“运行回归评估集，并显示哪些测试用例的分数低于 0.7。”
打包和部署	通过uip solution pack和uip solution publish打包并发布解决方案，将其部署为流程，然后启动作业	“将发票智能体部署到 Production 文件夹。”

构建循环

编码智能体在构建或迭代低代码智能体时遵循此循环：

“框架”>“配置”>“添加资源”>“刷新”>“验证”>“修复”>“上传”

1. 框架— 使用uip solution init创建解决方案，然后使用uip agent init搭建智能体框架。

2. 配置— 在agent.json中进行提示、架构和模型设置。

3. 添加资源— 在resources/<tool-name>/下为智能体所需的每个工具创建一个resource.json文件。

4. 刷新— 写入工件并使用uip agent refresh同步入口点架构。

5. 验证— 使用uip agent validate检查 JSON 结构（只读）。

6. 修复— 更正所有验证错误，然后返回到“刷新”。出现多个周期是正常现象。

7. 上传— 项目清理后，使用uip solution upload将其上传到 Studio Web。

结果：智能体项目现在在 Studio Web 中可见，可供审核、评估或部署。

智能体项目结构

当编码智能体运行uip solution init和uip agent init时，它会创建以下结构：

<AgentName>/
├── agent.json               # System prompt, user message template, LLM settings, input/output schemas
├── project.json             # Project metadata
├── entry-points.json        # Entry point definitions, kept in sync with agent.json schemas
├── bindings_v2.json         # Resource binding references
├── SolutionStorage.json     # Written after push — captures the Studio Web solution ID
│
├── resources/               # One directory per tool
│   └── <tool-name>/
│       └── resource.json    # Tool config: type, connector key, schema, connection ID
│
├── connections/             # Connection references for bound Integration Service tools
│
├── evals/                   # Evaluation configuration
│   ├── evaluators/          # Evaluator definitions (semantic similarity, trajectory by default)
│   └── eval-sets/           # Test case collections
│
└── userProfile/
    └── debug_overwrites.json  # Local connection overrides for debugging

工具类型

编码智能体通过直接在resources/<tool-name>/下创作resource.json文件来注册工具类型。每个文件中的type字段决定工具类型。Runtime 执行支持各不相同 — 某些类型可以注册以兼容 Studio Web，但尚未在智能体 runtime 上执行。

工具类型	resource.json 类型	在智能体 Runtime 执行
Integration Service 连接器	integration	是
Orchestrator 流程 (RPA)	process	是（非交互式）
子智能体	agent	是
API 工作流	api	仅限注册
Maestro 流程	processOrchestration	仅限注册
IXP（文档处理）	ixp	仅限注册

上下文锚定、升级应用程序和 MCP 服务器将作为单独的解决方案资源添加，而不是工具类型的resource.json文件。编码智能体创作编码，并使用uip solution resources refresh将其同步到项目中。

内部版本示例

打开您的编码智能体并描述所需的智能体。智能体将加载 UiPath 智能体技能，并处理其余部分。

问什么问题	构建内容
“为社交媒体入站评论创建一个新的情感分析智能体。”	具有自定义系统提示词和结构化输入/输出架构的独立智能体
“添加一个社交媒体管理器智能体，将该智能体委派给情感分析智能体，以处理一批入站评论。”	以情感分析智能体为工具的管理器智能体多智能体解决方案
“使用 AI 智能体构建流程，以起草专业电子邮件。”	具有连接到开始节点和结束节点的内联代理节点的流项目

评估您的智能体

编码智能体可以驱动完整的构建-评估-改进循环：

1. 在本地构建和配置智能体。
2. 上传到 Studio Web( uip solution upload ) — 评估在智能体 runtime 上运行，需要先上传项目。
3. 运行评估集并等待结果。
4. 查看每个测试用例的分数、执行追踪和失败消息。
5. 根据失败情况调整提示或配置。
6. 上传更新的智能体 ( uip solution upload )。
7. 重新运行评估集。

结果：评估运行成功完成，每个测试用例的分数可见，并明确指示哪些用例通过或失败。

示例询问：

• “创建一个名为回归测试的评估集，其中包含五个测试用例，涵盖主要发票输入场景。”
• “运行回归测试评估集并显示结果。”
• “第三个测试用例失败，轨迹分数低 — 请更新系统提示词，使工具选择更明确并重新运行。”

提供以下评估程序类型：

评估程序	它测量什么
语义相似度	在语义上比较预期输出与实际输出
轨迹	检查智能体是否遵循预期的工具使用和推理步骤
上下文精度	检索到的上下文与查询的相关性评分
保真度	对智能体响应是否基于提供的上下文进行评分

另请参阅

• Getting started with UiPath agents — hands-on lab for building and deploying a low-code agent from the CLI.
• 安装和设置— 安装智能体设置和技能。
• 使用 Coding Agents 构建编码智能体— 通过编码智能体终端构建基于 Python 的编码智能体。
• 技能概述— 推动此行为的技能模型。
• uip 智能体参考— 有关智能体生命周期、工具、评估、推送、拉取和部署的完整命令参考。