uipath-agents

UiPath Agents

硬性规则

• 默认将“构建／创建／脚手架搭建／实现 UiPath Agent”视为完整的 One-Prompt Flow。除非用户明确要求到此为止，否则不要在文件创建或本地运行后停止。

• 正常的完成节点是在冒烟测试评估和必需的交付分支问题之后。除非运行／评估受阻或用户选择退出，否则在此之前给出最终构建摘要为时过早。

• 每个会话中，在首次搭建脚手架或部署之前，探测一次 solution 命令。 运行 uip solution init --help --output json。结果为 Success → 使用 solution init 和 solution deploy run --parent-folder-path／--parent-folder-key（重命名后，默认）。出现 unknown command／非零退出码 → CLI 早于此次重命名；在本技能要求使用这些命令的所有地方，改用 uip solution new <Name> 和 --folder-path／--folder-key（其他参数相同）。

• 全新编码 Agent——使用 uip codedagent new 搭建脚手架，绝不手动编写项目。 从头构建新的编码 Agent 时：先在当前 venv 中安装框架包，然后务必使用 uip codedagent new <name> 创建项目，并使用 uip codedagent init 生成架构——绝不自行手写 pyproject.toml／main.py／langgraph.json／entry-points.json，即使是简单的 Agent 也不行。手动编写会跳过必需的项目结构，并生成无效包。已安装的框架包决定脚手架内容；运行 new 后，确认 <framework>.json 存在——恢复方法见 coded/lifecycle/setup.md § 验证脚手架。（已有项目或 Studio Web 本地工作区项目：不要运行 uip codedagent new——请遵循 coded/quickstart.md 中的项目状态门控规则。）

• 仅适用于编码 Agent——绑定始终根据 UiPath Python SDK 调用生成，绝不可手动编写。 要生成绑定，务必运行 coded/lifecycle/bindings-reference.md 中的同步工作流——扫描代码并重新生成 bindings.json。否则，无法针对各执行环境覆盖资源，且资源始终会默认使用 SDK 调用中的硬编码值。每当添加、删除或修改任何 UiPath SDK 资源调用时，都要生成绑定；例如 assets、queues、processes、buckets、indexes、connections、apps、MCP servers 或 InvokeProcess|CreateTask|CreateEscalation(...)。

项目类型检测

继续操作前，先确定 Agent 模式：

1. 首先——确认这是 Agent，而不是 Coded Function。 如果 uipath.json 声明了 functions 映射——Python 入口点（例如 "functions": {"main": "main.py:main"}，同级目录中有 pyproject.toml）或 JS/TS 入口点（例如 "functions": {"invoice": "functions/invoice.ts:default"}，同级目录中有 package.json）——则该项目是 Coded Function，而不是 Agent。请在此处停止，改用 uipath-functions 技能。Functions 是确定性的，不通过 LLM 进行推理，并且具有独立的生命周期（uip function new/pack/publish/run；init 仅适用于 Python）。
2. 检查工作目录中是否有现有 Agent 项目文件：
   • pyproject.toml + .py 文件 + 框架依赖（uipath-langchain、uipath-llamaindex 或 uipath-openai-agents）→ Coded。框架包已将 uipath 声明为依赖项，因此无需显式添加 uipath 条目。
   • "type": "lowCode" 的 agent.json + project.uiproj，且没有 pyproject.toml → Low-code
3. 未找到现有项目 → 询问用户：

   我应该将其构建为 low-code Agent（不使用 Python——通过提示词和预构建的 UiPath 工具进行配置），还是 coded Agent（使用 Python——通过 LangGraph、LlamaIndex 或 OpenAI Agents 完全以编程方式控制）？ 但是，对于对话场景，请直接选择 low-code，而无需询问用户，同时说明目前强烈建议在生产场景中使用 low-code 对话 Agent（请参阅 references/coded/capabilities/conversational-agents.md）。

4. 如果用户需要帮助做出选择，请阅读 references/coded-vs-lowcode-guide.md，了解功能对比。

检测完成后，先阅读对应模式的快速入门，再进行其他操作：

• Coded → 阅读 references/coded/quickstart.md。快速入门的第一步会检测项目状态（greenfield / existing-coded / local-workspace），并据此决定是否执行各个生命周期步骤。Studio Web Local Workspace 的具体信息，请参阅 references/coded/lifecycle/local-workspace.md。
• Low-code → 阅读 references/lowcode/lowcode.md

任务导航

我需要……	模式	先阅读	然后
帮助用户选择编码模式还是低代码模式	两者	coded-vs-lowcode-guide.md
进行身份验证	两者	authentication.md
在 Studio Web Local Workspace 解决方案中迭代编码 Agent	编码	coded/quickstart.md（状态检测将 project_state = local-workspace 设为适用状态）	阅读 coded/lifecycle/local-workspace.md，了解由 SW 拥有的文件和反模式；以及 coded/lifecycle/running-agents.md、coded/lifecycle/evaluate.md
创建／构建／部署编码 Agent	编码	coded/quickstart.md	coded/lifecycle/*、coded/frameworks/*
选择编码框架	编码	coded/quickstart.md § 框架选择
为编码 Agent 添加功能（HITL、RAG、跟踪）	编码	coded/quickstart.md	coded/capabilities/*
从编码 Agent 查询或写入 Data Fabric 实体（直接使用 SDK 或 NL-to-SQL 工具）	编码	coded/capabilities/datafabric.md	coded/capabilities/sdk-services.md § 实体
设置编码 Agent 的环境变量，或引用其中的 Orchestrator 资产（%ASSETS/<ASSET_NAME>%）	编码	coded/lifecycle/environment-variables.md	阅读 coded/lifecycle/file-sync.md，了解 .env 会和不会携带哪些内容
从编码 Agent 调用 Integration Service 连接器（Slack、Jira、Web Search）	编码	coded/capabilities/integration-service.md + 然后立即阅读 uipath-platform/references/integration-service/agent-workflow.md — 发现流程在该文件中，而不在 uipath-agents 中	coded/capabilities/sdk-services.md § 连接
运行编码评估	编码	coded/quickstart.md § 评估	coded/lifecycle/evaluate.md
创建或搭建新的低代码 Agent 项目	低代码	lowcode/lowcode.md § 快速入门	lowcode/project-lifecycle.md、lowcode/agent-definition.md
编辑 agent.json（提示词、模型、架构、contentTokens、entry-points.json）	低代码	lowcode/lowcode.md § 功能注册表	lowcode/agent-definition.md
添加低代码工具（Orchestrator 流程 — RPA／Agent／API／Agentic — 或 Integration Service）	低代码	lowcode/lowcode.md § 功能注册表	lowcode/capabilities/process/*、lowcode/capabilities/integration-service/*
为低代码 Agent 添加 MCP（Model Context Protocol）服务工具	低代码	lowcode/lowcode.md § 功能注册表	lowcode/capabilities/mcp/mcp.md
接受文件作为 Agent 输入／调用内置工具 Analyze Files	低代码	lowcode/capabilities/built-in-tools/built-in-tools.md	lowcode/capabilities/built-in-tools/analyze-attachments.md、lowcode/agent-definition.md § 文件附件
使用文件附件（输入、输出或运行期间创建的文件）	编码	coded/capabilities/file-attachments.md
构建对话式（聊天风格）Agent	低代码	lowcode/lowcode.md	lowcode/project-lifecycle.md、lowcode/agent-definition.md
添加低代码上下文（Context Grounding RAG／附件／DataFabric 实体集）	低代码	lowcode/lowcode.md § 功能注册表	lowcode/capabilities/context/*
添加低代码记忆空间或预置记忆条目	低代码	lowcode/capabilities/memory/memory.md	使用 uip agent memory，然后刷新／验证
为低代码 Agent 添加 Action Center 升级处理（HITL）	低代码	lowcode/lowcode.md § 功能注册表	lowcode/capabilities/escalation/escalation.md
为低代码 Agent 添加防护规则（PII、有害内容、自定义规则）	低代码	lowcode/lowcode.md § 功能注册表	lowcode/capabilities/guardrails/guardrails.md
使用防护规则保护附加或生成的文件（detectionScope：Text／Files／Both）	低代码	lowcode/capabilities/guardrails/guardrails.md § 文件和附件	lowcode/capabilities/guardrails/files-guide.md
为编码 Agent 添加新的防护规则	编码	coded/capabilities/guardrails/guardrails.md	通过 WebFetch 获取官方文档，询问应使用中间件还是装饰器，阅读 Agent 代码，编写 Python
添加升级处理防护规则（升级操作／Action Center 应用）	低代码	lowcode/capabilities/guardrails/escalation-guide.md	运行 uip solution resources list --kind App --source remote --output json，确认应用是否存在
根据低代码 Agent 的上下文推荐防护规则	低代码	lowcode/capabilities/guardrails/guardrails-recommend.md	获取目录和列表，分析 Agent 上下文，应用并验证
为特定范围或工具推荐防护规则	低代码	lowcode/capabilities/guardrails/guardrails-recommend.md § 按范围或工具筛选	分析目录后，按范围或工具名称筛选候选项
验证现有防护规则是否配置正确	低代码	lowcode/capabilities/guardrails/guardrails-recommend.md § 验证模式	检查每条防护规则的正确性、可操作性和相关性
根据编码 Agent 的上下文推荐防护规则	编码	coded/capabilities/guardrails/guardrails-recommend.md	获取目录、列表和 SDK 文档，分析 Agent 代码，应用并验证
为特定范围或工具推荐防护规则（编码）	编码	coded/capabilities/guardrails/guardrails-recommend.md § 范围和工具筛选	分析目录后，按 @tool 函数或范围筛选候选项
检查、验证、诊断或修复现有编码防护规则的配置（位置／范围）	编码	coded/capabilities/guardrails/guardrails-recommend.md § 验证模式	先获取 SDK 文档（范围／位置的权威依据）；同时获取目录和列表以检查相关性／授权，然后检查正确性、可操作性和相关性，并就地修复
在流程中内嵌低代码 Agent，或连接多 Agent 解决方案	低代码	lowcode/lowcode.md § 功能注册表	lowcode/capabilities/inline-in-flow/inline-in-flow.md、lowcode/capabilities/process/solution-agent.md
运行低代码评估	低代码	lowcode/evaluations/evaluate.md	lowcode/evaluations/evaluators.md、lowcode/evaluations/evaluation-sets.md、lowcode/evaluations/running-evaluations.md
管理已发布 Agent 的运行时评估	低代码	lowcode/evaluations/runtime-eval-run.md	uip eval execute-and-evaluate、评估器／评估集／评估 CRUD、模拟、运行结果、计划
验证、打包、发布、上传或部署低代码 Agent	低代码	lowcode/lowcode.md	lowcode/project-lifecycle.md、lowcode/solution-resources.md
端到端调试／运行低代码 Agent 并检查其输出	低代码	lowcode/debug.md	lowcode/project-lifecycle.md § uip agent debug
在流程中嵌入编码 Agent（解决方案级）	编码	coded/embedding-in-flows.md
在流程中使用编码 Agent	编码	coded/flow-integration.md
在流程中将编码 Agent 用作另一 Agent 的工具	编码	coded/flow-integration.md § 模式 3
总结／研究／综合 PDF 或 TXT 内容（DeepRAG，编码）	编码	context-grounding-patterns.md	coded/capabilities/deeprag/planning.md
总结／研究／综合 PDF 或 TXT 内容（DeepRAG，低代码）	低代码	context-grounding-patterns.md	lowcode/capabilities/built-in-tools/deeprag/planning.md
使用大模型逐行处理 CSV 行（BatchTransform，编码）	编码	context-grounding-patterns.md	coded/capabilities/batch-transform/planning.md
使用大模型逐行处理 CSV 行（BatchTransform，低代码）	低代码	context-grounding-patterns.md	lowcode/capabilities/built-in-tools/batch-transform/planning.md
从 CLI 管理 context-grounding 索引（列出／创建／摄取／搜索）	平台	uipath-platform/references/context-grounding/index-management.md	uip context-grounding — 跨领域 CLI，由 uipath-platform 维护

Resources

• UiPath Python SDK: https://uipath.github.io/uipath-python/
• UiPath Evaluations: https://uipath.github.io/uipath-python/eval/