Skip to content

Executive Summary

本子场景确保主 Agent 在任务完成后能触发插件工作流、校验通知与对账结果,并在失败时立即补救或升级告警。目标指标:闭环通过率 ≥98%,补救流程 <2 分钟拉起,交付报告与审计记录覆盖 100%。

Scope & Guardrails

  • In Scope:工作流触发、回调/轮询、闭环规则、对账验证、通知、补救、报告生成、指标与告警。
  • Out of Scope:插件内部节点实现、财务结算系统的深度逻辑。
  • Environment & Flagsworkflow-trigger-kitclosure-verificationtelemetry-unified-sink;依赖插件工作流回调、通知渠道、审计仓库。

Participants & Responsibilities

ScopeRepositoryLayer责任与交付物Owners
workflow-triggerpowerxops调用插件工作流、参数映射、幂等键Agent Platform Guild
closure-validatorpowerxops校验通知、对账、回执与必达节点Ops Reliability Center
remediation-orchestratorpowerxops补救脚本、人工审批、升级告警Ops Reliability Center
reportingpowerxops交付报告、审计与用户通知Agent Platform Guild

End-to-End Flow

  1. Stage 1 – Workflow Trigger:主 Agent 根据策略触发插件或外部工作流,带入交付参数与回调配置。
  2. Stage 2 – Status Collection:插件节点执行审批/写库/通知并通过回调或轮询返回状态。
  3. Stage 3 – Closure Validation:校验必达节点、通知回执与对账一致性,判断成功或失败等级。
  4. Stage 4 – Remediation & Reporting:失败触发补救或人工审批,成功则生成交付报告并更新监控。

Key Interactions & Contracts

  • APIs / EventsPOST /internal/agent/workflow/triggerPOST /plugins/{pluginId}/workflowEVENT plugin.workflow.completedEVENT agent.workflow.closure.failedPOST /notifications/agent-deliveryPOST /audit/agent-closure-report
  • Configs / Schemasconfig/agent/workflow_templates/*.yamlconfig/agent/closure_rules.yamldocs/standards/powerx-plugin/contract/agent_contract.md
  • Security / Compliance:签名回调、通知审计、对账数据脱敏、补救审批留痕。

Usecase Links

  • UC-AGENT-EXEC-CLOSURE-001 — 插件工作流闭环验证。

Acceptance Criteria

  1. 闭环通过率 ≥98%,所有通知/对账节点提供回执。
  2. 失败 2 分钟内触发补救或人工审批,并在 Ops 面板产生高优先级告警。
  3. 交付报告与审计日志涵盖执行结果、补救动作、用户通知记录。

Telemetry & Ops

  • 指标:plugin.workflow.closure_rateagent.workflow.remediation_totalagent.workflow.callback_latencyagent.workflow.audit_delay
  • 告警阈值:闭环失败连续 3 次、补救耗时 >5 分钟、审计写入失败。
  • 观测:Grafana「Agent Closure」、Ops 闭环看板、scripts/ops/closure-validation.mjs

Open Issues & Follow-ups

风险/事项影响范围负责人ETA
插件回调协议不统一,造成校验困难多插件闭环可靠性Plugin Guild2025-03-12
对账逻辑未与财务系统对齐误报/漏报Ops Reliability Center2025-03-20

Appendix

  • docs/scenarios/agent-orchestration/SCN-AGENT-TASK-EXEC-001.md
  • docs/meta/scenarios/powerx/agent-and-automation/agent-orchestration/agent-task-execution/primary.md
  • docs/standards/powerx-plugin/contract/agent_contract.md

基于 Apache 2.0 许可发布