跳至文档正文
文档目录 · Evidence

Developers / Robotics World

Evidence 与来源

追溯机器人规格、部件主张和产业关系的来源,区分事实、主体声明、观点、审核状态与证据缺口。

Reality · 证据支持的是具体主张

产品页、公告、论文或新闻是 Source;其中可定位的摘录、表格或观察才是 Evidence。判断“某机器人使用某部件”时,来源必须直接支持型号、部件和关系,不能只凭双方出现在同一文章。

Model · 保留声明者、时间和审核状态

知识语义协议 区分 factual_claimsubject_claimopinion,以及 pending/approved/rejected。已审核的厂商声明仍可能是 attributed_claim;它不是独立验证过的交付结果。commercialIntent 单独暴露,不能直接改变事实审核结论。

同字段的不同值可能是来源冲突,也可能属于不同配置、测试条件或时间。先保留双方来源与适用时间,再判断;不凭更新时间较新或 confidence 更高就覆盖另一主张。

Interface · 各域能读到哪些证据

入口证据字段当前限制
/api/robots/{id}provenance.officialProductUrlofficialRepoUrlrelatedNewsspecEvidencespecEvidence 是规范化规格的 key/value/valueText/unit/source/confidence/recordUpdatedAt,尚无每条规格的外部 URL
/api/companies/{name}/relationships每条关系的 sourceUrlevidence 和方向缺来源时不能编造补齐,也不能让其他边的证据代为证明
/api/parts/{id}每条 spec 的 evidence.uri/quote/locator/capturedAt/kind、审核与主张类型返回的候选规格需按各自状态解释
/api/world/graph · /api/world/timelineevidenceCount/evidenceKinds/commercialIntents;graph 关系带 sourceUrl数量和类别不是完整证据包
/api/world/state · /api/world/state/historyevidenceRefssourceEventId引用 ID 不代表存在可公开读取的任意 /evidence/{id} 接口
/api/world/events/{key}展会窗口的 evidencequote/locator/sourceUrl/sourceTitle窗口证据与其中每一项声明的支持关系需具体核对

source: auto_calibrated 是内部规格处理来源标记,不是外部权威来源。置信度与处理链信息帮助追踪记录,但不能替代官方规格原文。

公开接口目前没有统一的 Evidence 按 ID 详情入口。沿响应提供的真实 URL 阅读原文;只返回 ID 或计数时,应明确标注“证据引用已知,详细内容未由本接口提供”。

Agent behavior · 引用时带上限制

描述结果时保留实体规范身份、主张、来源 URL、适用时间与审核状态。事实、引用某主体的说法和自身分析分开表达;来源无法访问时不能声称已复核。

发现冲突可按 贡献协议 提交 report_conflict 材料,前提是该提交在用户授权范围内;待审回执不是裁决结果。通用边界见 Agent Guide

实现依据:emibot-rs/src/routes/robots.rsemibot-rs/src/routes/parts.rsemibot-rs/src/routes/world_read_model.rsemibot-rs/src/routes/exhibitions.rsemibot-rs/src/routes/world_model.rs