mcpField
U
uipath-platform

uipath-platform

github.com/uipath云与 DevOps17584 次安装今天更新
代码仓库

关于 uipath-platform

此技能指导编码 Agent 使用 `uip` 命令行执行 UiPath 平台操作。它优先采用 CLI 命令,并将根因诊断请求交给故障排查技能。

主要功能

  1. 01UiPath CLI 命令指导
  2. 02操作任务分流
  3. 03Orchestrator 与资源工作流
  4. 04Integration Service 管理
  5. 05Data Fabric 与 LLM Gateway 指导

适用场景

  1. 01检查或更改 UiPath 资源
  2. 02设置 `uip` 命令行
  3. 03管理连接与平台数据
  4. 04应用修复前移交诊断

MCP 相关

该技能在 CLI 工具部分提及 `uip mcp serve`,但未说明 MCP 接口或其提供的能力。

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/uipath/skills --skill uipath-platform

安装后在 Claude Code 中输入/uipath-platform确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

references/context-grounding/
index-management.md
references/data-fabric/
bulk-import.md
choice-sets.md
data-fabric.md
entity-schema.md
federated-entity-creation.md
file-attachments.md
filter-platform-contract.md
local-entities.md
records-query.md
references/guardrails/
byo-configurations.md
references/integration-service/
activities.md
activity-generation.md
agent-workflow.md
connections.md
connectors.md
http-request.md
references/integration-service/activity-generation/
example-action.js.txt
example-list-action.js.txt
gotchas.md
lookup-fields.md
minimal-metadata-design.md
runtime.md
slack.md
standard-resource-contract.md
standard-resource.md
vendor-api.md
references/integration-service/connector-overrides/
README.md
uipath-microsoft-teams.md
uipath-salesforce-slack.md

详细介绍

UiPath Platform — uip CLI 助手

通过 uip CLI 端到端使用 UiPath Cloud / Orchestrator / Studio Web / Integration Service 的综合指南。关于 uip solution 生命周期,请加载 uipath-solution;关于 PDD/SDD 设计与任务规划,请加载 uipath-planner。

开始平台操作前先判断意图

运行任何命令前,先对请求的结果进行分类:

  1. 因果性结果 → 立即移交。 用户想要解释、诊断或查明现有异常行为的根本原因 → 在运行任何操作前,使用 Skill 工具调用 uipath-troubleshoot(名称必须与可用技能列表中的名称完全一致)。不要预先获取作业/日志/跟踪信息——证据收集由 troubleshoot 负责。仅仅用文字告诉用户使用 troubleshoot,不能代替调用 Skill。
  2. 操作性结果 → 留在此处。 在没有因果性问题的情况下检查当前状态、执行 CRUD 或生命周期操作、应用输入前验证输入,或执行已经诊断出的平台修复。
  3. 混合请求 → 先排查。 移交诊断;只有在确认修复方案后,才回到此处执行应用修复的平台变更。
  4. 无法使用同类技能 → 妥善处理。 说明无法执行移交;提供重试调查所需的实体、范围和时间窗口。不要自行臆测仅凭平台信息得出的根本原因。

使用 CLI。不要自行编写 REST 请求。

始终优先使用 uip CLI 命令。 CLI 端到端覆盖身份验证、Orchestrator(文件夹、流程、作业、机器、用户、角色、会话、日历、设置、审计日志、凭据存储、源、附件)、资源(资产、队列、队列项、存储桶、桶文件、库、Webhook、触发器)、Integration Service(连接器、连接、活动、IS 触发器)、跟踪和许可。

手动编写 HTTP 请求——读取 ~/.uipath/.auth 并向 /odata/... 或 /orchestrator_/... 发送 POST 请求——几乎总会遗漏 CLI 正确处理的内容:X-UIPATH-OrganizationUnitId 文件夹标头、OData 筛选器格式(Key eq '...',并转义单引号)、分页封装、重试语义、验证错误格式,或 Result/Code/Data 输出约定。只有在 references/uip-commands.md 中搜索过对应任务,并确认没有 uip 命令支持后,才使用原始 REST 请求。 CLI 是事实来源。

如果你正准备使用 curl 请求 https://cloud.uipath.com/...,请停下来。先搜索命令索引。以下是一些经常被忽略的例子:

  • “将文件上传到存储桶” → uip or bucket-files upload(而不是一套 PUT /buckets/.../signedUrl 操作)
  • “创建资产” → uip or assets create(而不是 POST /odata/Assets)
  • “为流程启动作业” → uip or jobs start <process-key>(而不是 POST /odata/Jobs/UiPath.Server.Configuration.OData.StartJobs)
  • “配置 Integration Service 连接” → uip is connections create <connector-key>(而不是手动实现 OAuth 流程)
  • “将文件附加到 Data Fabric 记录” → uip df files upload <entity-id> <record-id> <field-name> --file <path>(而不是通过文件值执行 records insert / records update——平台会静默剥离 FILE 列并返回 Success,参见 references/data-fabric/data-fabric.md 规则 6)

为新设备初始化 CLI

当 uip --version 失败、缺少 Node/npm,或编码 Agent 需要准备好用于 UiPath 工作的工作站时,请使用官方安装脚本,而不是自行重建包管理器逻辑。这些脚本具有幂等性,可以安全地重复运行。

macOS/Linux:

curl -fsSL https://download.uipath.com/uipath-cli/install.sh | bash

Windows PowerShell:

irm https://download.uipath.com/uipath-cli/install.ps1 | iex

安装脚本会:

  • 确保安装 Node.js >= 20 和 npm。
  • 从公共 npm 安装 @uipath/cli。
  • 运行 uip skills install --no-interactive,以便已安装的 AI 编码 Agent(Claude Code、Codex、Gemini CLI、Cursor 等)使用 UiPath 技能。
  • 尽力安装 .NET SDK 8.0 和 Python 3.11-3.14,以支持 RPA、编码 Agent 和工具工作流。

对于 CI 或不需要 Agent 技能和运行时的纯 CLI 设备,请显式跳过这些内容:

curl -fsSL https://download.uipath.com/uipath-cli/install.sh | bash -s -- --skip-skills --skip-runtimes
iwr https://download.uipath.com/uipath-cli/install.ps1 -OutFile install.ps1
./install.ps1 -SkipSkills -SkipRuntimes

可用标志:macOS/Linux 上的 --skip-node、--skip-skills、--skip-dotnet、--skip-python、--skip-runtimes、--dry-run;Windows 上的 -SkipNode、-SkipSkills、-SkipDotnet、-SkipPython、-SkipRuntimes、-DryRun。对应的环境变量为 UIP_SKIP_NODE、UIP_SKIP_SKILLS、UIP_SKIP_DOTNET、UIP_SKIP_PYTHON、UIP_SKIP_RUNTIMES 和 UIP_DRY_RUN。

何时使用此技能

在编写任何与 UiPath 通信的代码之前加载此技能。具体触发条件:

  • CLI 引导 / 工作站设置:新机器、缺少 uip、缺少 Node/npm、缺少 Python 或 .NET SDK,或需要为 LLM 编码 Agent 安装 UiPath 技能

  • 身份验证与租户:登录、登出、切换租户、通过 --profile <name> 指定具名登录配置文件、~/.uipath/.auth、OAuth 令牌、组织

  • Orchestrator 核心:文件夹(list/get/create/edit/move/delete/runtimes)、流程/版本、作业(start/stop/logs/traces/healing-data)、包(upload/download/versions)、机器、用户 / 角色 / 会话(包括 DirectoryUser/DirectoryGroup/DirectoryRobot/DirectoryExternalApplication)、许可证、日历、设置、审计日志、凭据存储、源、附件

  • 资源(Orchestrator 作用域):资产(文本/整数/布尔值/凭据)、队列 + 队列项目、存储桶 + 桶文件(upload/download/get-download-url/get-upload-url)、库(.nupkg)、Webhooks(HMAC 签名)、触发器(时间/队列/API)

  • Integration Service:连接器、连接(OAuth 流程)、活动、IS 触发器、Agent 工作流引用解析

  • **Data Fabric **:UiPath 的结构化、类型化数据存储。 **⛔ 停止 — 在执行任何 uip df 命令之前,先阅读 references/data-fabric/data-fabric.md。该参考文档包含关键规则(文件夹作用域提示词流程、不可逆操作门槛、复杂字段配置)、请求正文架构、各类型运算符矩阵,以及主题文件链接:entity-schema.md、federated-entity-creation.md(联合 / 虚拟数据对象 / 零拷贝实体 — 由连接器或其他实体提供支持)、records-query.md、filter-platform-contract.md、choice-sets.md、file-attachments.md、bulk-import.md、local-entities.md。功能:

    • 实体 — 带类型化列的架构、各类型约束(lengthLimit、minValue / maxValue、decimalPrecision)、选项集 / 关系 / 文件字段,以及 addFields / updateFields / removeFields 演进操作。
    • 本地实体 — uip df entities <verb> --local 会将实体写入磁盘上的解决方案,而不是租户;部署时它会成为真实实体。无需登录。仅当用户明确要求实体位于解决方案中或随解决方案发布时才使用;默认使用租户。字段类型与租户实体相同,但不包括选项集和关系。请参阅 local-entities.md。
    • 记录 — 插入 / 更新 / 删除 / 列出 / 获取 / 使用 query 进行查询,支持服务器端筛选、排序、分页、分组和聚合(COUNT、SUM、AVG、MIN、MAX)。
      • DF 筛选条件正文使用 filterGroup.queryFilters[] — 完整结构见 records-query.md。
    • 文件 — 通过 files upload / download / delete 在 FILE 类型字段中存储二进制附件(记录级写入会静默移除 FILE 值;必须使用专用动词)。
    • 选项集 — 供 CHOICE_SET_SINGLE / CHOICE_SET_MULTIPLE 字段使用的共享枚举;值使用不可变整数 NumberId,而不是标签。
    • 文件夹作用域 — 租户级或文件夹作用域;每次写入均使用 --folder-key <GUID>,entities list / choice-sets list 使用 --include-folders。
    • CSV 批量导入 — uip df records import <entity-id> --file <path.csv> --output json。仅支持基本字段类型;复杂字段(CHOICE_SET、RELATIONSHIP、FILE、AUTO_NUMBER)以及包含换行符或双引号的文本,需要使用 records insert --file <json>。 对于 .flow 中的查询 / 创建 / 更新 / 删除 / 按 ID 获取连接器节点,请交由 uipath-maestro-flow 处理——该技能负责流内节点 JSON、bindings_v2.json 和连接资源布局。
  • LLM Gateway — BYO 产品配置:uip llm-configuration byo-connections(list / get / create / update / delete / list-product-configs)。将租户拥有的 OpenAI / Azure OpenAI / AWS Bedrock / Google Vertex / Anthropic / OpenAI-compatible 密钥注册到 UiPath 产品功能(agents、agenthub、jarvis、IXP、agent builder、ECS)。支持两种输入形式:单映射(适用于 AnyModelWithOwnAdditions 功能)和重复使用的 --mapping(AllModels / AnyModel 必需)。必须进行服务器端验证。

  • LLM Gateway — 诊断故障 BYO 配置:使用 byo-connections get <id> --force-refresh 重新探测底层 IS 连接;使用幂等的 update 强制进行新的服务器端探测;使用 list --include-connection-details 列出租户配置,并筛选 connectionState != Enabled;使用 list-product-configs 检查目录是否存在偏差;使用 uip traces spans get <trace-id> 交叉核对跟踪证据。Gateway 不会通过 CLI 提供逐请求调用日志——诊断只能依据当前状态和跟踪证据。请参阅 references/llmgateway/byo-connections.md § Diagnostics。如需了解可能覆盖路由的租户级 AI Trust Layer 策略,请参阅 uipath-governance。

  • AI Trust Layer — BYO guardrail(BYOG)配置:uip guardrails byo-configurations(list / list-validators / probe / create / update / delete)——管理租户注册的外部护栏验证器提供方(例如 Azure AI Content Safety、Databricks AI Guardrails),每个提供方都由一个 Integration Service 连接提供支持。ValidatorName 在租户范围内唯一,也是 Agent 唯一引用的值(ByoValidator(<ValidatorName>)——连接由服务器端解析)。创建前,请运行 list(确认名称可用)和 uip is connections list(获取 --connection-id);create 始终会在服务器端探测连接 / 验证器组合,若探测失败则中止,且没有跳过标志;当 --connection-id 更改时,update 会重新探测。probe 和 list-validators 可测试组合但不会保存任何内容;update 会合并所提供的字段,并可切换 --enabled / --disabled;delete 需要 --force;没有 get 动词。请参阅 references/guardrails/byo-configurations.md。如需了解如何针对这些配置之一编写护栏(低代码或编码方式),请参阅 uipath-agents。

  • Traces:uip traces spans get <trace-id>(LLM / Agent 执行可观测性)

  • 上下文 grounding:用于语义搜索 / RAG 的知识索引——uip context-grounding(从存储桶或连接执行 list / create,使用 / ingest / retrieve 轮询摄取状态,或执行 / search / delete)。Agent 和流会将这些索引用作工具。请参阅 references/context-grounding/index-management.md。

  • 平台许可:租户许可证分配、用户 / 群组套餐分配、消耗量报告(uip platform tenants licenses、users licenses、groups rules、licenses consumables get——唯一的消耗量动词;summary / daily / folders 是 --mode 值)

  • CLI 工具本身:uip tools list/search/install、uip mcp serve

对于 uip solution 生命周期(init / pack / publish / deploy / activate / upload)以及构建和部署 UiPath 解决方案的 CI/CD 流水线,请加载 uipath-solution。

身份验证令牌位置

默认登录会将凭据存储在 ~/.uipath/.auth:

UIPATH_URL=https://cloud.uipath.com
UIPATH_ORGANIZATION_NAME=my_org
UIPATH_TENANT_NAME=my_tenant
UIPATH_ACCESS_TOKEN=eyJ...
UIPATH_ORGANIZATION_ID=...
UIPATH_TENANT_ID=...

命名配置文件会将凭据存储在 ~/.uipath/profiles/<name>/.auth。当用户要求在同一台机器上保留多个 UiPath 登录时,请使用命名配置文件:

uip login --profile dev --output json
uip login status --profile dev --output json
uip login which --profile dev --output json

规则:

  • --profile <name> 是全局选项。对于每个需要使用该登录的 uip 命令,都要传入此选项,例如 uip --profile dev or folders list --output json。
  • default 表示内置的未配置配置文件登录,对应 ~/.uipath/.auth。
  • 配置文件名称只能包含字母、数字、.、_ 和 -。切勿使用 ../prod 这样的路径。
  • --profile 和身份验证命令的 --file <folder> 不能同时使用。二选一即可。
  • 缺少命名配置文件时,不会回退到 ~/.uipath/.auth 或 Robot 凭据。请告知用户运行 uip login --profile <name>。

当 CLI 命令无法满足某个用例时,这些令牌可用于直接调用 Orchestrator REST API。如果当前使用的是命名配置文件,请通过 uip login which --profile <name> --output json 读取路径,而不要假定路径是 ~/.uipath/.auth。

快速入门

步骤 0 — 确保 CLI 已安装

先检查:

uip --version

如果缺少此命令,请使用新机器的 CLI 引导安装程序中的官方安装程序;如果安装程序添加了 PATH 条目,请随后打开新的 shell。

步骤 1 — 身份验证

与 Orchestrator、解决方案或 Integration Service 交互之前,用户必须先登录。

务必先检查——大多数会话已经完成身份验证:

uip login status --output json

如果显示 Logged in,则跳过此步骤的其余部分。没有 --check 标志;用于验证的子命令是 status。

如果用户指定了配置文件,请明确检查该配置文件:

uip login status --profile dev --output json

交互式登录(浏览器 OAuth2): uip login 会在用户的机器上打开浏览器窗口,并一直阻塞,直到用户完成登录。**切勿通过你自己的 shell 工具运行交互式登录,无论是否使用 --no-browser。**由 Agent 运行时,必须登录的人只会看到转圈提示:打印出的 URL 和阻塞等待都显示在你的工具输出中,而不是用户面前。--no-browser 并不意味着该命令可以由 Agent 运行——它适用于由自动化程序自行打开 URL 的场景;命令仍会一直阻塞,直到收到登录回调,而且通过复制粘贴转发打印出的 URL 很容易出错(如果复制内容被自动换行或截断,身份服务器会拒绝该 URL,并在浏览器端显示含义不明的错误)。因此,请用户在自己的终端中直接运行该命令——在 Claude Code 中,命令前加 ! 即可在会话中运行:

! uip login

用户表示完成后,请使用 uip login status --output json 进行确认。如果重试时遇到 EADDRINUSE / "Port 8104 is already in use",说明先前中止的尝试仍占用着回调端口;该端口会在 5 分钟内自动释放,用户也可以结束残留的 uip login 进程。

命名配置文件的交互式登录:

uip login --profile dev --output json

自定义 authority(Automation Suite、专用主机或其他非默认主机)的登录:

uip login --authority "<AUTHORITY_URL>" --it --output json

对于非交互式(CI/CD)场景,请使用从环境变量读取的客户端凭据,并采用 CLI 的 env.<NAME> 语法。切勿要求用户将密钥粘贴到聊天中或放在命令行上:

uip login --client-id env.UIPATH_CLIENT_ID --client-secret env.UIPATH_CLIENT_SECRET --tenant "<TENANT>" --output json
步骤 2 — 选择租户

列出可用租户并设置当前租户:

uip login tenant list --output json
uip login tenant set "<TENANT_NAME>" --output json
步骤 3 — 浏览 Orchestrator

列出文件夹,以便了解情况:

uip or folders list --output json
步骤 4 — 使用 Orchestrator 资源

从下方的任务导航表中选择适当的操作。对于 uip solution 操作,请加载 uipath-solution。

任务导航

我需要……请阅读这些内容
进行身份验证 / 管理租户references/uip-commands.md
设置文件夹、用户、机器references/orchestrator/setup-environment.md
运行和监控作业references/orchestrator/run-jobs.md
管理会话和运行时references/orchestrator/manage-sessions.md
租户设置、日历、审计日志references/orchestrator/tenant-admin.md
了解 Orchestrator 概念references/orchestrator/orchestrator.md
管理资产references/orchestrator/manage-assets.md
使用队列和队列项references/orchestrator/process-queues.md
设置或读取流程或队列的 Business ROIreferences/orchestrator/business-roi.md
使用存储桶和文件references/orchestrator/work-with-storage.md
设置触发器和 Webhookreferences/orchestrator/triggers-and-webhooks.md
轮询作业 / 队列项、导出日志、处理 429,或检查字段大小上限references/orchestrator/api-limits.md
开发 / 打包 / 发布 / 部署 / 激活解决方案;设置 CI/CD/uipath:uipath-solution
对已发布的 Agent 运行运行时评估/uipath:uipath-agents
调试 LLM/Agent 跟踪(跨度)references/traces/traces.md
为跟踪添加反馈注释references/traces/feedback.md
使用 Integration Servicereferences/integration-service/integration-service.md
使用 Data Fabric — 实体、记录、文件、选项集references/data-fabric/data-fabric.md
构建实体架构 / 添加字段 / 复杂字段类型references/data-fabric/entity-schema.md
从连接器或其他实体创建 / 更新联邦实体(又称虚拟数据对象 / 零拷贝)references/data-fabric/federated-entity-creation.md
将实体创作到解决方案中(entities … --local)references/data-fabric/local-entities.md
查询记录 — 筛选器、分页、聚合、选项 / 关系语义references/data-fabric/records-query.md
各字段类型的筛选运算符支持矩阵references/data-fabric/filter-platform-contract.md
管理选项集和选项集值references/data-fabric/choice-sets.md
上传 / 下载 / 删除记录中的文件附件references/data-fabric/file-attachments.md
从 CSV 批量导入记录references/data-fabric/bulk-import.md
配置 BYO LLM 密钥(OpenAI / Azure OpenAI / Bedrock / Vertex / Anthropic)references/llmgateway/byo-connections.md
诊断 / 审计 / 重新探测 BYO LLM 配置references/llmgateway/byo-connections.md#diagnostics
管理 BYO 护栏(BYOG)配置(列出 / 创建 / 更新 / 删除)references/guardrails/byo-configurations.md
测试连接能否为 BYOG 验证器提供服务(探测 / 列出验证器)references/guardrails/byo-configurations.md#validation-mandatory-before-save
诊断 BYO 护栏问题(连接失效、配置已禁用)references/guardrails/byo-configurations.md#diagnostics
为租户分配许可证references/licensing/tenant-allocations.md
分配用户 / 组许可证包references/licensing/user-licenses-allocations.md
报告许可证消耗情况references/licensing/consumables-report.md
了解许可证概念references/licensing/licensing.md
诊断许可证相关问题references/licensing/diagnose/CAPABILITY.md
完整的 CLI 命令参考references/uip-commands.md
在新机器上引导配置 uip、Node、Python、.NET 和 Agent 技能新机器的 CLI 引导配置
构建 / 运行 / 验证代码化工作流/uipath:uipath-rpa

解析 UiPath Studio

某些操作(创建项目、验证、运行工作流、打包)需要 UiPath Studio。需要 Studio 时:

  1. 先检查是否有正在运行的实例:

    uip rpa instances list --output json
    
  2. 如果没有实例正在运行,请尝试标准安装位置:

    uip rpa studio start --output json
    
  3. 如果失败(版本太旧、未找到等),请询问用户 Studio 构建版本所在的位置。 不要搜索整个文件系统。常见位置包括:

    • C:\Program Files\UiPath\Studio
    • 开发构建目录(例如,dev4/Studio/Output/bin/Debug)
    • 自定义安装路径
  4. 获得路径后,显式传入:

    uip rpa studio start --studio-dir "<STUDIO_DIR>" --output json
    

切勿花时间自动搜索 Studio。 如果默认位置不可用,请立即询问——用户知道其构建版本所在的位置。

核心概念

UiPath 平台层级
Organization
  └── Tenant(s)
        └── Folder(s)              ← Orchestrator folders (logical containers)
              ├── Processes         ← Published automation packages
              ├── Assets            ← Key-value configuration (Text, Bool, Integer, Credential, Secret)
              ├── Queues            ← Work item queues for distributed processing
              ├── Jobs              ← Running/completed process executions
              ├── Triggers          ← Event-based or queue-based job triggers
              ├── Schedules         ← Time-based job scheduling (cron)
              ├── Storage Buckets   ← File storage for automation data
              ├── Machines          ← Robot execution environments
              └── Robots            ← Attended/Unattended execution agents
Robot 类型
类型描述使用场景
有人值守与人类用户一起运行,通过 UiPath Assistant 触发前台任务、用户辅助自动化
无人值守在虚拟环境中自主运行,由 Orchestrator 管理后台任务、计划处理、全天候运行
文件夹类型
类型描述
标准用于组织自动化的默认文件夹
个人特定用户的工作区
虚拟不进行物理隔离的逻辑分组
解决方案通过解决方案部署创建的文件夹
DebugSolution解决方案文件夹的调试变体
资产类型
类型描述
文本纯文本值
布尔值布尔值(true/false)
整数数值型整数值
凭据用户名 + 密码对
机密加密的机密值
DBConnectionString数据库连接字符串
HttpConnectionStringHTTP 连接字符串
WindowsCredentialWindows 凭据对

CLI 概览

UiPath CLI(uip)是一个用于与 UiPath 平台交互的统一命令行工具:

命令组前缀描述状态
身份验证login, logoutOAuth2、客户端凭据、PAT、租户管理可用
Orchestratoror文件夹、作业、流程、发布版本可用
资源resource资产、队列、队列项、存储桶、存储桶文件可用
Integration Serviceis连接器、连接、活动、资源可用
Data Fabricdf实体、记录、文件、选项集(@uipath/data-fabric-tool)可用
工具toolsCLI 工具扩展管理可用
MCPmcp模型上下文协议服务可用
编码 AgentcodedagentPython Agent 生命周期(设置、执行)可用
RPArpaRPA 工作流管理(创建、编译、验证、执行)可用
全局选项

每条 uip 命令都接受以下选项:

选项描述默认值
--output <format>输出格式:table、json、yaml、plaintable(交互模式),json(非交互模式)
--output-filter <expression>用于筛选 JSON 输出的 JMESPath 表达式--
--profile <name>使用来自 ~/.uipath/profiles/<name>/.auth 的命名身份验证配置文件内置默认登录
--verbose启用详细/调试日志关闭
--help / -h显示命令帮助--
--version / -v显示 CLI 版本--

以编程方式调用 uip 命令时,始终使用 --output json。JSON 格式精简且可供机器读取。

要缩小 list 结果范围,请使用对应名词自己的筛选标志(--state Faulted、--type Text、--status New、--name、--process-name、--search)。后端会在发送结果前进行筛选;分页仍然准确。各名词对应的标志见:references/uip-commands.md。切勿先列出所有内容再手动筛选。

使用 --output-filter(JMESPath)重塑输出,或筛选没有服务器端标志的字段——例如,--output-filter "[].{id: Id, name: Name}",或按派生/计算值筛选。若服务器已提供该属性的筛选方式,则不要使用此选项。两种情况可能导致筛选器悄无声息地返回空结果,因为 JMESPath 在两种情况下都只会报告未匹配,不会报错。表达式会针对 Data 载荷求值,因此应从 Data 内部开始,且绝不能写出 Data:写 [].Key,不要写 Data[].Key,后者会在 Data 内查找名为 Data 的键。字段查找区分大小写,CLI 会在筛选前将键转换为 PascalCase:应匹配 DisplayName,而非 displayName;除非命令属于少数保留原始大小写的命令(maestro flow registry get、api-workflow registry、对话命令)。

部署说明

  • 启动作业需要运行时。 如果遇到错误 2818“no runtimes configured”,则目标文件夹需要分配有 Unattended/Development 运行时的计算机模板。
  • 对于 uip solution pack / publish / deploy / activate 工作流,请加载 uipath-solution。 此技能负责这些工作流所依赖的身份验证和 Orchestrator 接口;solution 技能负责生命周期命令。
  • 回退方案:直接调用 REST API。 当 CLI 工具不支持某项操作时,请使用 Orchestrator REST API,并从 ~/.uipath/.auth 获取访问令牌。请参阅 references/orchestrator/orchestrator.md - REST API。
  • Orchestrator 会对某些端点按租户进行速率限制。 已筛选的 jobs list / queue-items list 调用有每分钟配额,jobs logs / audit-logs list 中的 --export 每天限额为 100 次。CLI 不会重试 429 错误(ErrorCode: rate_limited)。在编写针对这些命令的轮询器、循环或脚本之前,请阅读 references/orchestrator/api-limits.md。

参考资料

  • CLI 命令参考 — 所有 uip 命令及其工作流链接

  • Orchestrator — 概念、文件夹、作业、进程、机器、用户

  • 资源 — 资产、队列、存储桶、触发器、库、Webhook

  • Orchestrator API 限制 — 每个租户的速率限制、导出配额、429 处理、字段大小上限

  • 解决方案 — 解决方案生命周期(uip solution init/pack/publish/deploy/activate)

  • 规划器 — PDD/SDD 设计 + 多技能任务规划(流程 → 解决方案设计文档 → 任务列表)

  • 追踪 — Spans — LLM 执行追踪可观测性

  • 追踪 — 反馈 — 为追踪添加情绪标注和评论

  • Integration Service — 连接器、连接、活动、资源

  • Data Fabric — 实体架构、记录 CRUD、查询筛选器和聚合、选项集、文件附件、CSV 批量导入、文件夹范围、本地实体

  • LLM Gateway — BYO 连接 — 为 UiPath 产品注册租户自有的 LLM 密钥

  • Guardrails — BYOG 配置 — 管理租户注册的自带护栏(BYOG)配置,并诊断其底层 Integration Service 连接

  • 许可 — 租户分配、用户/群组套餐、消耗品报告、诊断

  • 编码工作流 — 构建编码自动化项目

遇到问题? 如果某项操作未按预期运行,请使用 /uipath-feedback 发送报告。

评论

支持 Markdown