---
title: "按材料查询公司映射证据"
description: "将同一文档中的公司业务事实归并展示，是 Agent 的推荐映射审计接口。"
pageClass: gendangzou-doc
---

# 按材料查询公司映射证据

`evidence.relation_materials.list`

将同一文档中的公司业务事实归并展示，是 Agent 的推荐映射审计接口。

## 调用契约

| 项目 | 值 |
| --- | --- |
| Method | `GET` |
| Path | `/api/gendangzou/company-sector-relations/{relation_id}/evidence-materials` |
| 业务域 | `evidence` |
| 数据更新 | 随完整数据版本发布 |

受控意图：`trace_company_relation`、`audit_company_mapping`

## 请求参数

| 参数 | 位置 | 类型 | 必填 | 约束与默认值 |
| --- | --- | --- | --- | --- |
| `relation_id` | path | string | 是 | 最短 8 字符；最长 128 字符 |
| `page` | query | integer | 否 | 从 1 开始的页码；默认 `1`；最小 1 |
| `page_size` | query | integer | 否 | 默认 `20`；最小 1；最大 100 |
| `snapshot_id` | query | string | 否 | 最短 8 字符；最长 128 字符 |
| `as_of` | query | string | 否 | 返回此日期或此前最近的完整快照；格式 `date` |
| `detail` | query | string | 否 | full 保留完整 Web 响应；compact 返回供 Agent 使用的稳定快照引用；默认 `full`；可选 `full`、`compact` |
| `include` | query | string | 否 | 逗号分隔的精简版本扩展：sector_dynamics、coverage；最长 80 字符 |

## 最小调用

```bash
curl --fail --silent --show-error \
  -H "Authorization: Bearer $MOBIUSQUANT_TOKEN" \
  "https://api.mobiusquant.ai/api/gendangzou/company-sector-relations/<relation_id>/evidence-materials?page_size=10&detail=compact"
```

将路径中的 `<...>` 替换为实际资源 ID。

## 响应

| 字段 | 类型 | 必有 | 含义 |
| --- | --- | --- | --- |
| `snapshot` | `SnapshotContext / SnapshotReference` | 是 | 本次查询实际使用的数据版本。 |
| `summary` | `RelationEvidenceMaterialSummary` | 是 | 当前查询的聚合统计。 |
| `items` | `array<RelationEvidenceMaterial>` | 是 | 当前查询返回的结果列表。 |
| `pagination` | `Pagination` | 是 | 分页位置、总数和总页数。 |

### `RelationEvidenceMaterialSummary`

| 字段 | 类型 | 必有 | 含义 |
| --- | --- | --- | --- |
| `material_count` | `integer` | 是 | - |
| `fact_count` | `integer` | 是 | 归并材料包含的公司业务事实数量。 |

### `RelationEvidenceMaterial`

| 字段 | 类型 | 必有 | 含义 |
| --- | --- | --- | --- |
| `material_key` | `string` | 是 | 归并材料的稳定标识。 |
| `material_id` | `string / null` | 否 | 归并后材料的主标识。 |
| `document_id` | `string / null` | 否 | 公司正式披露文档标识。 |
| `source_id` | `string` | 是 | 材料来源标识。 |
| `evidence_date` | `string` | 是 | 证据对应日期。 |
| `publish_date` | `string` | 否 | 原始公司材料发布日期。 |
| `report_period` | `string` | 否 | 公司正式披露材料对应的报告期。 |
| `document_type` | `string` | 否 | 财报、公告或问询回复等文档类型。 |
| `title` | `string` | 是 | 原始材料标题。 |
| `url` | `string` | 是 | 原始材料 URL。 |
| `fact_count` | `integer` | 是 | 归并材料包含的公司业务事实数量。 |
| `facts` | `array<RelationEvidenceFact>` | 否 | - |

### `RelationEvidenceFact`

| 字段 | 类型 | 必有 | 含义 |
| --- | --- | --- | --- |
| `evidence_id` | `string` | 是 | 可溯源证据标识。 |
| `fact_name` | `string` | 否 | 公司业务事实名称。 |
| `fact_summary` | `string` | 否 | 公司业务事实摘要。 |
| `fact_type` | `string` | 否 | 公司业务事实类型。 |
| `business_status` | `string` | 否 | 材料所述业务的当前状态。 |
| `evidence_level` | `string` | 否 | 公司事实证据强度等级。 |
| `participation_basis` | `string` | 否 | 公司参与该产业环节的材料依据。 |
| `participation_summary` | `string` | 否 | 公司在板块价值链中的参与方式。 |
| `relationship_logic` | `string` | 否 | - |
| `mapping_conclusion` | `string` | 否 | - |
| `boundary_note` | `string` | 否 | 关系成立范围及不能外推的边界。 |
| `viewpoint` | `string` | 否 | 系统从材料中抽取的产业观点。 |
| `quote` | `string` | 否 | 支撑观点或事实的原文摘录。 |
| `role` | `string` | 否 | - |
| `confidence` | `string / number / null` | 否 | 结果置信度；不能与关系分或热度分互换。 |
| `score` | `number / null` | 否 | 公司业务事实与板块定义的关系强度。 |
| `score_breakdown` | `object` | 否 | - |
| `mapping_explanation` | `MappingExplanation / null` | 否 | 公司业务事实、映射逻辑、边界和结论。 |
| `term_explanation` | `TermExplanation / null` | 否 | - |

### `MappingExplanation`

| 字段 | 类型 | 必有 | 含义 |
| --- | --- | --- | --- |
| `fact` | `string` | 否 | - |
| `logic` | `string` | 否 | - |
| `participation_summary` | `string` | 否 | 公司在板块价值链中的参与方式。 |
| `boundary_note` | `string` | 否 | 关系成立范围及不能外推的边界。 |
| `conclusion` | `string` | 否 | - |
| `participation_basis` | `string` | 否 | 公司参与该产业环节的材料依据。 |

### `TermExplanation`

| 字段 | 类型 | 必有 | 含义 |
| --- | --- | --- | --- |
| `canonical_name` | `string` | 是 | 术语规范名称。 |
| `category` | `string` | 是 | 对象或关系分类。 |
| `definition` | `string` | 是 | 板块定义。 |
| `source_title` | `string` | 是 | - |
| `source_url` | `string` | 是 | - |

## 调用要点

- Agent 建议使用 `detail=compact` 控制上下文体积。
- 分页从 `page_size=10` 开始，确认需要后再继续翻页。

## 关联能力

- [`evidence.relation.list`](/zh/gendangzou/capabilities/evidence.relation.list)
- [`company.by_sector.list`](/zh/gendangzou/capabilities/company.by_sector.list)

## 机器可读契约

- [完整能力清单](/zh/gendangzou/agent-manifest.json)
- [在线能力详情](https://api.mobiusquant.ai/api/gendangzou/capabilities/evidence.relation_materials.list)