- 入门指南
- Studio Web 中的 UiPath 智能体
- UiPath 编码智能体
- Build with Coding Agents
UiPath™ 编码智能体是在开发者首选集成开发环境 (IDE) 中通过直接代码开发构建的智能体。它们使开发者能够完全控制智能体逻辑、行为以及与外部系统的集成。
编码智能体的工作方式
使用 UiPath SDK，您可以打包此代码，并将其作为标准 .nupkg 包部署到 Orchestrator 中您选择的包订阅源中。之后可以用它在一个或多个文件夹中创建流程。
编码智能体部署为 Orchestrator 文件夹中的 UiPath 流程。集成到平台后，它将遵循与标准流程相同的监管原则。这样可以在文件夹中进行有组织的部署，这意味着您可以计划、触发并监控智能体的执行，同时将其集成到更广泛的自动化工作流中。
您还可以将编码式智能体项目连接到 Studio Web，Studio Web 作为一个控制平面，与您的 IDE 一起用于调试、评估和发布。有关更多信息，请参阅“Studio Web 中的编码式智能体”。
下图显示了在 UiPath Platform 中创建、部署和执行编码智能体的流程。
该流程包括：
- 在 IDE 中定义智能体逻辑。
- 与 UiPath 建立安全连接。
- 将智能体部署到 Orchestrator。
- 在 UiPath 生态系统中执行智能体。
支持的 SDK 语言和框架
UiPath SDK 库及其支持的语言和框架正在不断扩展。我们支持：
| 语言/框架 | 存储库 | 功能 |
|---|---|---|
| Python（版本 3.11、3.12、3.13） | uipath-python | Python SDK，使用 CLI 创建、打包智能体并将其部署到 UiPath Cloud Platform。 它还支持与 UiPath Platform 资源（如流程、资产、存储桶、上下文锚定、数据服务、作业等）进行编程交互。 |
| 将 Python 与 LangGraph 配合使用 | uipath-python 扩展：uipath-langchain-python | 使用 Python SDK，开发者可以构建 LangGraph 智能体并将其部署到 UiPath Cloud Platform。 此包提供与 UiPath Platform 服务的编程交互，并通过 Action Center 提供人机回圈。 |
| LLamaIndex | uipath-llamaindex-python | 使用 Python SDK，开发者可以构建 LlamaIndex 智能体并将其部署到 UiPath Platform。 此包提供与 UiPath Cloud Platform 服务的编程交互，并通过 Action Center 集成提供人机回圈 (HITL)。 |
| OpenAI 智能体 | uipath-openai-agents | 使用 Python SDK，开发者可以构建 OpenAI 智能体并将其部署到 UiPath Cloud Platform。此包提供与 UiPath Cloud Platform 服务的编程交互。 |
有关 UiPath SDK 更新的最新信息，请参阅“发布策略”。
编码智能体功能
通过 SDK 集成 UiPath 资源
UiPath SDK 提供了直接在代码中调用其他 UiPath 资源并与之交互的逻辑，从而与现有 UiPath 功能无缝集成。例如，您可以：
- 使用 UiPath 资产安全存储和管理敏感数据。
- 访问和操作存储在 UiPath 存储桶中的数据。
- 建立并管理与各种系统和服务的连接。
- 在编码智能体中触发其他 UiPath 流程并与之交互。
有关可以在编码智能体中使用的 UiPath 资源的详细信息，请参阅《SDK 文档》。
有关更多示例和实施模式，请查看我们 GitHub 存储库中的示例项目 （Python、 LlamaIndex）。
编码智能体中的人机回圈
您可以在智能体中定义中断点，以请求人工输入。触发中断时，智能体将暂停执行，请求分配的用户进行输入。人工输入后，执行将会恢复。 定义中断点的方式因智能体语言而异：
-
某些框架（如 LangGraph）提供原生中断模式，允许人工介入智能体的执行。
-
使用 UiPath SDK，您可以加入 UiPath 任务作为中断逻辑。触发中断时，执行将暂停，并在 Action Center 中创建任务。
- 用户可以通过 Action 应用查看智能体进度，提供反馈，或对生成的任务做出决策并进行操作。
- 人工干预完成后，智能体会从中断点恢复执行。
配置编码智能体的环境变量
您可以使用机密资产配置项目的环境变量，免除了直接修改代码的必要。
利用 Orchestrator 支持与外部凭据存储（如 CyberArk）集成以获取凭据资产，您可以链接到 CyberArk 存储并配置环境变量，以便您的智能体使用该机密资产。在运行时，Orchestrator 会通过资产从 CyberArk 中安全检索密钥，并将其作为环境变量提供给您的智能体。
在 Orchestrator 中导航到您的智能体流程，定义和管理 API 密钥、runtime 参数以及您的智能体代码所需的其他配置值。有关详细信息，请参阅“启动智能体作业”。
利用 LangSmith 启用追踪和调试
配置标准 LangSmith 环境变量（例如 LANGCHAIN_TRACING_V2、LANGCHAIN_API_KEY、LANGCHAIN_PROJECT），可在 LangSmith 中启用智能体执行的详细追踪记录。
每次运行 UiPath 智能体，此集成都可以在您的 LangSmith 帐户中提供全面追踪。这使您能够分析智能体的推理、执行路径，并确定需要调试和性能优化的区域。