使用 UiPath for Coding Agents 运行

安装了 UiPath 技能的编码智能体可以通过自然语言询问，在 UiPath 上驱动大多数操作任务，包括文件夹、作业、队列、资产、审核日志、连接等。它会在您登录的会话中运行uip ，并根据您提供的上下文确定范围。此页面涵盖请求内容、预期请求以及边界信息。

有关设置（安装智能体、登录、安装技能）的信息，请参阅将 UiPath CLI 与 Coding Agents 一起使用。

先决条件

1. 已为您的智能体安装 UiPath 技能。有关每个智能体安装命令的信息，请参阅将 UiPath CLI 与 Coding Agent 一起使用。
2. 会话已登录 ( uip login )。
3. 访问您想要处理的操作作用域的文件夹 — 智能体将继承您的权限。

智能体可以执行的操作

每行分组一个操作子域。智能体会从已安装的技能中选取正确的uip or 、 uip resource 、 uip solution或uip is命令 — 您声明的是结果，而不是命令。

区域	智能体可以执行的操作	询问示例
文件夹和访问权限	列出、创建、嵌套、移动、删除文件夹；分配用户和角色	“将[e-mail]以 Automation User 身份添加到 Finance 部门”
用户、角色、权限	检查角色授权，创建/编辑/删除角色，列出权限，查看谁有权访问什么	“ [e-mail]有权访问并使用什么角色？”
许可证	检查用户和机器人之间的分配情况	“向 Prod-worker-01 添加 2 个 Unattended runtime 许可证”
计算机和 runtime	列出计算机，检查文件夹中可用的运行时	“生产环境中当前有哪些 Runtime 可用？”
会话	列出处于活跃状态的机器人会话，查看每个机器人所在的计算机，断开卡住的会话	“显示生产环境中所有正在运行的无人值守会话及其活跃时间”
流程和包	上传包，列出版本，创建或更新流程版本；管理包订阅源	“将 2.3.0 版 InvoiceBot 发布到 Finance”
Solutions (解决方案)	发布、上传、部署、激活；列出跨租户和文件夹的已部署版本	“将 v1.4 发票处理解决方案部署到临时租户中的会计功能”
作业	启动、停止、监控、获取执行日志和附件，按状态分组	“列出昨天以来生产中每个发生故障的作业，并显示其错误消息”
资产	跨文件夹列出资产，获取、创建、更新、删除资产	“将文件夹 A 中的所有资产复制到文件夹 B”
凭据存储	列出、创建、更新、删除保险库集成；轮换引用的凭据	“生产中的哪些资产仍在引用旧的 CyberArk 存储？”
队列和队列项目	检查队列深度、推送项目、批量更新状态	“哪些队列目前的新项目超过 100 个？”
存储桶和文件	创建存储桶，上传、下载、列出、删除文件	“从存储桶报告中下载/在过去 7 天内修改的每个文件”
库	发布、列出版本，管理版本	“在租户订阅源中显示 Gmail.Utilities 库的所有版本”
触发器	创建时间、队列和事件触发器；管理日历；列出运行；检查历史记录	“显示 HR 入职解决方案最近 10 次运行的触发器”
Webhooks	创建、列出、测试	“列出所有处于活动状态的 Webhook 及其侦听的事件”
Integration Service 连接	列出、测试、刷新 OAuth 令牌，排除 OAuth 令牌故障；检查连接运行状况	“测试生产中的每个 Salesforce 连接，并报告失败的连接”
审核日志	按用户、组件、操作、日期范围筛选	“谁上个月删除了 Finance 文件夹？”

读取与写入

智能体将操作分为两级处理：

• 读取操作— list 、 get 、 logs 、 audit-logs及类似操作。智能体根据自己的判断来运行这些流程。
• 写入操作— 任何创建、更新或删除的操作。智能体应在运行前与您确认。

询问很复杂时，预先说明您的期望。例如： “清理未使用的流程包，但先显示列表。”

授权和作用域

智能体充当已登录的uip会话 — 它会完全继承您的权限。如果您可以使用您的帐户在 UiPath 用户界面中执行某些操作，则智能体也可以执行此操作；如果您不能，则智能体也不能。

智能体还支持文件夹上下文。操作范围仅限于特定文件夹，除非您说“跨所有文件夹”或类似的内容。如果在对话中更改文件夹，请重述范围。

对于服务身份工作（CI/CD、计划的审核），请让智能体对外部应用程序会话运行 — 请参阅身份验证中的流程 2。

常见的多步骤模式

这些是编码智能体能够节省最多时间的模式 — 多步骤请求，否则将意味着手动链接多个 CLI 调用。

对出现故障的作业进行分类

对过去 24 小时内 Production 中每个出现故障的作业进行分类。按错误消息分组并显示前 5 个根本原因。

智能体列出按状态和时间筛选的作业，提取每个作业的日志，按错误签名分组，并显示排名摘要。然后，您可以决定重试哪个部分。

在租户之间提升

“将发票处理解决方案从开发租户提升到临时租户。将其部署在 Accounting 文件夹下。

智能体从开发租户拉取解决方案，将会话切换到临时租户，并将其部署到“Accounting”文件夹中。它会在执行每次租户切换前进行确认。

将用户分配到文件夹

“分配[e-mail]以 Automation User 身份添加到 Accounting 文件夹，并分配 VM 计算机。

代理将用户分配到具有“自动化用户”角色的文件夹中，然后将 VM 计算机分配到同一文件夹，以便用户可以对其运行无人值守作业。

审核角色授权

“审核分配给外部用户（拥有我们域之外的 @ 的任何人）的所有角色，并报告他们可以编辑的文件夹。”

智能体列出用户，按域进行筛选，根据文件夹展开每个用户的角色授予，并显示结构化报告。

另请参阅

• 将 UiPath CLI 与编码智能体结合使用— 智能体设置和技能安装。
• 技能— 驱动此行为的技能模型。
• 身份验证— 会话流程，包括外部Apps。
• uip 或参考— 文件夹、用户、角色、许可证、作业、计算机、会话、审核日志、凭据存储。
• UIP 资源引用— 资产、队列、存储桶、库、触发器、Webhook。
• uip 解决方案参考— 打包、发布、部署、激活。
• uip 为参考— Integration Service 连接、连接器、活动。