conflict-audit.latest模块 33Conflict audit report
读取最新的冲突审计:智能体在哪里发生争用、记录对其支持得如何,以及哪些资源已经可以从观察切换到强制执行。
conflict-audit.latest 返回确定性审计引擎生成的最新报告。报告仅由调用方提供的观察数据构建,每个数据集都附带完整性声明。它按影响和证据置信度对采用建议排序,没有模型参与。
conflict-audit.latest模块 33读取最新的冲突审计:智能体在哪里发生争用、记录对其支持得如何,以及哪些资源已经可以从观察切换到强制执行。
conflict-audit.latest 返回确定性审计引擎生成的最新报告。报告仅由调用方提供的观察数据构建,每个数据集都附带完整性声明。它按影响和证据置信度对采用建议排序,没有模型参与。
generate.current 从平台填充智能体、租约和账本事件,并把其他数据集声明为 unknown 或 incomplete,因此每个指标都显示 incomplete。要获得更完整的报告,请把您自己的观察数据连同完整性声明发送给 generate。
digestid 由它派生,因此相同的输入得到相同的报告。windowstart、end 和 durationMs。completenessPOST /api/v1/acp/conflict-audit/generate 接收一个时间窗口、一个 idempotencyKey、九个数据集各自的显式数组,以及各自的完整性声明。缺少任何一项会被拒绝;不做任何推断。
随后得出八个指标,从影子与已注册的比率,到争用资源热力图和证据覆盖率。除非它所用的每个数据集都被声明为 complete,否则指标显示 incomplete。
在共享的演示工作区中使用演示密钥运行:任何人都可以看到其中的内容,因此请勿发送任何私密信息。 conflict-audit.latest 文档
点击运行,将左侧的请求发送到共享演示工作区。
在共享的演示工作区中使用演示密钥运行:任何人都可以看到其中的内容,因此请勿发送任何私密信息。
一个符合 API 接受格式的请求,以及模块返回格式的示例响应。
GET /api/v1/acp/conflict-audit/latest Authorization: Bearer av_workspace_•••• → 200 { report }
热力图依据租约、队列、拒绝、冲突事件和发现为资源打分,排序后的建议会指出应优先提升的资源。
每份报告都有一个 digest,每条观察数据都带有其来源的证据引用,因此审阅者可以把一个数字追溯到来源。
evidenceCoverage 和 limitations 显示输入中有多少带有证据,以及哪些数据集被声明为不完整。
模块是对一件狭窄事情的强力保证。请仅在其确切范围内依赖它。
id 来自其内容的摘要。coordination.conflict.audit 不是这份报告。它列出仲裁案件和检测器目录。请通过 REST 读取报告。
generate 和 adoption.plan 需要 policies.propose。adoption.confirm 和 adoption.apply 需要 policies.approve。
使用工作区 API 密钥作为 Bearer 令牌进行认证。基础 URL 为 https://api.intramedial.com。
/api/v1/acp/conflict-audit/latest读取最新的报告。/api/v1/acp/conflict-audit/list列出所有报告,最新的在前。complete、incomplete 或 unknown,可附带说明和证据引用。metricsstatus 为 sufficient、incomplete 或 insufficient_data。recommendationsid、title、rationale、resourceUrns、channel(mandate 或 mcp)、impact、evidenceConfidence、rankScore 和 proposedAction。proposedActionfrom: observe、to: enforce、是否 gated,以及 gateReason。limitationscomplete 的数据集给出一句说明。receipt每个有争用的资源和每个归属缺口,都会得到一条从 observe 切换到 enforce 的建议,按影响乘以证据置信度排序。置信度低于 0.65 时为 gated。
GET /api/v1/acp/conflict-audit/latest 返回 { report },在任何报告出现之前则返回 404 not_found。list 返回所有报告,get 接收 reportId。
adoption.plan 把未受限的建议转为变更。adoption.confirm 需要理由和短语 ADOPT <workspaceId>,adoption.apply 需要 confirm 返回的一次性令牌。
{
"report": {
"v": "conflict-audit/1",
"id": "audit_3f9c1a7e5b2d4c60a81e",
"workspaceId": "ws_acme",
"digest": "3f9c1a7e5b2d4c60a81e…",
"generatedAt": "2026-11-01T09:00:00.000Z",
"window": {
"start": "2026-10-02T09:00:00.000Z",
"end": "2026-11-01T09:00:00.000Z",
"durationMs": 2592000000
},
"completeness": {
"leases": {
"status": "incomplete",
"note": "Active lease projection only.",
"evidenceRefs": []
}
},
"metrics": {
"evidenceCoverage": {
"status": "incomplete",
"coveredRecords": 12,
"totalRecords": 12,
"ratio": 1
}
},
"recommendations": [
{
"id": "rec_8d41c0e6a2b97f35c1d0",
"title": "Adopt conflict controls for urn:repo:payments/main",
"rationale": "Observed contention score 5 from leases, queues, admissions, ledger events, and findings.",
"resourceUrns": [
"urn:repo:payments/main"
],
"channel": "mandate",
"impact": 0.416667,
"evidenceConfidence": 0.4,
"rankScore": 0.166667,
"proposedAction": {
"from": "observe",
"to": "enforce",
"gated": true,
"gateReason": "evidence confidence is below the 0.65 enforcement threshold"
}
}
],
"limitations": [
"leases is declared incomplete; dependent metrics describe observations only."
],
"receipt": {
"…": "abridged"
}
}
}只有未受限的建议才会成为计划变更,应用一项变更需要输入一个短语和一个默认 10 分钟后过期的令牌。
arbitration.arbiter 中的仲裁 queue 路由读取。detection.run 中提交案件。limitations 会重复列出缺口。drills.counterfactual 中测试变更。generate.current 的报告涵盖准入、等待者或发现。它一个都没有提供。adoption.apply 调用绑定到该端点的采用服务,切换每个资源的授权或 MCP 模式。每个结果都会被记录,混合结果保持为 partial,不会重试。
报告的 receipt 由报告自己的内容生成。它不锚定在工作区账本中。
latest 返回 404 not_found。urn:<namespace>:<id> 的精确 URN。idempotencyKey 至多 128 个字符。generate.current 涵盖平台账本的最近 30 天以及一个时间点的集群视图。/api/v1/acp/conflict-audit/getreportId 读取一份报告。/api/v1/acp/conflict-audit/generate根据提供的观察数据构建报告。/api/v1/acp/conflict-audit/generate.current根据平台自己的集群和账本构建报告。/api/v1/acp/conflict-audit/adoption.plan根据未受限的建议规划变更。/api/v1/acp/conflict-audit/adoption.confirm用理由和输入的短语确认计划。/api/v1/acp/conflict-audit/adoption.apply用令牌应用已确认的计划。/api/v1/acp/conflict-audit/adoption.status读取计划及其结果。coordination.conflict.audit列出仲裁案件和检测器,而不是报告。arbitration.arbiter38