使用 Coding Agents 构建编码智能体

完全使用编码智能体和终端编写、打包基于 Python 的编码智能体并将其发布到 UiPath Orchestrator。

安装了uipath-agents技能的编码智能体可以完全通过您的终端构建、编写、打包基于 Python 的智能体并将其发布到 UiPath Orchestrator。编码智能体是使用 LangGraph、LlamaIndex 或 OpenAI 智能体构建的标准 Python 项目，智能体部署后，UiPath 将处理编排、计划、升级和监管。

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

有关uip codedagent命令的完整参考，请参阅UiPath CLI 指南。

先决条件

• 已为您的编码智能体安装的uipath-agents技能。请参阅安装和设置。
• 会话已登录 ( uip login )。
• Python 3.11 或更高版本。
• ug 包管理器。

智能体可以执行的操作

区域	智能体可以执行的操作	询问示例
初始化项目	使用uv创建一个新的 Python 项目，添加您选择的 UiPath SDK 包，然后运行uip codedagent setup和uip codedagent new以构建项目结构	“初始化一个名为发票处理程序的新编码智能体项目。”
编写智能体逻辑	使用 LangGraph、LlamaIndex 或 OpenAI 智能体编写并迭代 Python 智能体代码	“添加一个调用 UiPath 上下文锚定索引的工具，以查看公司策略。”
配置	运行uip codedagent init ，以将 Python 项目连接到 UiPath 的编排层	“为 UiPath Orchestrator 配置智能体。”
包	运行uip codedagent pack ，将智能体捆绑为可部署的工件	“打包智能体。”
发布	运行uip codedagent publish ，将包上传到 Orchestrator 并自动创建流程	“将智能体发布到我的个人工作区。”
与 Studio Web 同步	运行uip codedagent push以将本地文件上传到远程 Studio Web 项目，或uip codedagent pull ，以将远程项目的所有文件下载到本地工作区	“将本地更改推送到 Studio Web。”

构建循环

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

“初始化”>“写入”>“评估”>“打包”>“与 Studio Web 同步（可选）”>“发布”>“设置环境变量”>“运行”

1. 初始化— 创建一个新的 Python 项目，添加 UiPath SDK，并构建项目结构：

   mkdir my-agent && cd my-agent
   uv init
   uv add uipath-langchain   # or uipath-llamaindex / uipath-openai-agents
   uip codedagent setup
   uip codedagent new my-agent
   uip login
   uip codedagent init
   

2. 写入— 命令编码智能体编写和编辑 Python 智能体逻辑。编码智能体是标准 Python，不限于 UiPath 专属功能。

3. 评估— 发布前测试智能体：

   • 分析— 要求编码智能体设置测试集，运行测试集，然后解释测试集分数。

   • 迭代— 优化提示或逻辑，直到结果看起来正确为止。

4. 打包— 使用uip codedagent pack将智能体打包，以创建可部署的工件。

5. 与 Studio Web 同步（可选） — 如果要在 Studio Web 中进行进一步更改：

   • 推送— 运行uip codedagent push ，以将本地文件上传到远程 Studio Web 项目。
   • 拉取— 运行uip codedagent pull ，以将所有文件从远程 Studio Web 项目下载到本地工作区。

6. 发布— 使用uip codedagent publish --my-workspace将包上传到 Orchestrator 来发布智能体。首次发布时，系统会在您的个人工作区中自动创建流程。

7. 设置环境变量— 在 Orchestrator 中，打开流程配置并添加所需的任何环境变量（API 密钥、连接字符串）。

8. 运行— 开始作业。

结果：智能体被部署到 Orchestrator 并作为流程运行。UiPath 处理计划、重试和日志记录。

SDK 包

选择与您的智能体框架匹配的包：

包	框架
uipath-langchain	LangChain / LangGraph
uipath-llamaindex	LLamaIndex
uipath-openai-agents	OpenAI 智能体

所有三个包都通过框架原生抽象公开了相同的 UiPath 功能（上下文锚定、人机回圈升级、护栏、作业附件）。

内部版本示例

打开您的编码智能体并描述您要构建的智能体。由于编码智能体是标准 Python，因此对您的要求没有限制 — UiPath SDK 在此基础上添加编排、监管和平台集成。

问什么问题	构建内容
“创建一个编码智能体，用于研究主题并生成摘要报告。”	调用 LLM 的研究智能体
“构建一个编码智能体，以分析作为输入给定的 CSV 文件。”	已连接智能体，以接收作业附件作为输入
“创建一个编码智能体，使其使用 UiPath 上下文锚定索引来查看公司政策。”	针对 UiPath 上下文锚定索引的 RAG（检索增强生成）管道

示例

以下存储库包含参考实现：

• UiPath LangChain 示例— 20 多个示例，涵盖防护机制、人机回圈、分布式智能体和对话智能体。
• LlamaIndex 示例— LlamaIndex 的 UiPath 集成模式。
• OpenAI 智能体示例— 适用于 OpenAI 智能体的 UiPath 集成模式。

另请参阅

• 安装和设置— 安装智能体设置和技能。
• 使用 Coding Agents 构建低代码智能体— 使用编码智能体构建 Agent Builder 智能体。
• UiPath Python SDK 文档— 适用于编码智能体的完整 SDK 参考。