dx-devops-test-pipeline-configure

配置 DevOps Center 流水线测试基础设施

设置并配置 DevOps Center 流水线的测试基础设施。此技能处理三个密切相关的“配置流水线”操作，它们共享相同的组织上下文、前置条件和实体范围（流水线级别）。请选择与用户意图相符的模式。

API 版本： 所有 DevOps 测试系统调用均使用 Salesforce API v67.0（最低要求）。

重要： 所有 DevOps Center 数据（流水线、阶段、提供方、套件、门禁）都存储在 Salesforce 组织中，而非本地仓库。切勿在文件系统中搜索流水线配置。始终使用 sf data query 或 sf api request rest 查询组织。

---

第 1 步 — 始终先运行前置检查

在进行任何查询或系统调用之前，先运行 references/prerequisite-checks.md 中的前置检查。若任何检查失败，请向用户说明通俗易懂的错误信息并停止操作——切勿写入未经验证的环境。

• 模式 A 和 B（配置／同步提供方）： 运行前置检查 1–4（组织登录、Agentforce DX 插件、DevOps Center 组织授权、已确定流水线）。无需运行前置检查 5（阶段）——提供方在流水线级别配置。
• 模式 C（质量门禁）： 运行前置检查 1–4 以及前置检查 5（阶段）。前置检查 5 仅提供 DevopsPipelineStage——目标 DevopsTestSuiteStage 记录 ID 会在模式 C 的第 0 步中单独解析（触发器 → 套件阶段行）。

保留已解析的 doce-org-alias、pipelineId，以及（模式 C 中的）stageId／testSuiteStageId。

---

第 2 步 — 选择模式

如果用户想要……	模式	遵循
启用／设置／添加尚未配置的提供方	A — 配置测试提供方	references/configuring-test-provider.md
重新同步／刷新已配置的提供方，以导入新套件	B — 同步已配置的提供方	references/syncing-test-providers.md
在某个阶段设置／配置质量门禁、覆盖率阈值或测试基准	C — 配置质量门禁	references/configuring-quality-gate.md

区分 A 和 B（关键判断）： 首先获取流水线的提供方（GET .../testProviders?status=all）——两种模式都从这里开始。然后：

• 提供方为可用（未配置）→ 模式 A（配置）。
• 提供方为已配置，但套件已过期／缺失 → 模式 B（同步）。
• 提供方为已配置，且用户在将套件分配给阶段时看不到套件 → 这是阶段分配缺漏，而非配置缺漏。请转至 dx-devops-test-suite-assignments-configure。

切勿对已配置的提供方调用配置端点的 POST 请求——这会创建重复的 DevopsPipelineTestProvider 记录。请参阅 references/gotchas.md。

---

第 3 步 — 确认关卡（所有模式均必需）

每种模式都会修改组织状态，且必须在任何写入操作前显示确认关卡。各模式的参考文件中包含相应的确切确认措辞（模式 C 还要求在确认关卡前强制显示影响预览）。在用户明确同意之前，不得调用任何写入 API。若用户拒绝，请停止操作，不进行写入。

---

第 4 步 — 执行并报告

遵循所选参考文件中的具体 API 调用、成功消息和错误处理方式：

• references/configuring-test-provider.md — 模式 A
• references/syncing-test-providers.md — 模式 B
• references/configuring-quality-gate.md — 模式 C
• references/error-handling.md — 汇总所有模式的状态代码 → 通俗易懂的错误信息表
• references/gotchas.md — 重复提供方陷阱、API 名称差异、触发器类型规则

切勿向用户暴露原始 API 错误、堆栈跟踪或 JSON 负载——始终将其转换为通俗易懂的说明。

---

相关技能

• dx-devops-test-suite-assignments-configure — 配置或同步提供方后，将其套件分配或映射到某个阶段；还会推荐适合某次提交运行的套件。
• dx-devops-test-suite-run — 运行套件，或在修复达到阈值后重新触发质量门禁。
• dx-devops-test-failures-analyze — 说明某次运行中的失败，并可选择创建修复工作项。