关于编码智能体

UiPath™ 编码智能体是在开发者首选集成开发环境 (IDE) 中通过直接代码开发构建的智能体。它们使开发者能够完全控制智能体逻辑、行为以及与外部系统的集成。

使用 UiPath SDK，您可以打包此代码，并将其作为标准 .nupkg 包部署到 Orchestrator 中您选择的包订阅源中。之后可以用它在一个或多个文件夹中创建流程。

编码智能体部署为 Orchestrator 文件夹中的 UiPath 流程。集成到平台后，它将遵循与标准流程相同的监管原则。这样可以在文件夹中进行有组织的部署，这意味着您可以计划、触发并监控智能体的执行，同时将其集成到更广泛的自动化工作流中。

下图显示了在 UiPath Platform 中创建、部署和执行编码智能体的流程。

图 1. 流程包括：1) 在 IDE 中定义智能体逻辑，2) 建立到 UiPath 的安全连接，3) 将智能体部署到 Orchestrator，以及 4) 在 UiPath 生态系统中执行智能体。

支持的 SDK 语言和框架

UiPath SDK 库及其支持的语言和框架正在不断扩展。我们目前支持：

语言/框架	存储库	功能
Python	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)。

有关 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 帐户中提供全面追踪。这使您能够分析智能体的推理、执行路径，并确定需要调试和性能优化的区域。