材料搜索

这个 Server 面向材料研发和专利分析场景，提供两个只读查询工具：`search_material_evidence` 将结构化的合金成分、物质名称或材料属性归一化为标准实体，并结合搜索条件检索材料专利；`fetch_document_material_evidence` 从指定专利中获取合金成分、物质属性、原始测量值及可用的来源章节和原文片段。检索结果是候选专利，不代表已核实具体材料证据；证据记录的来源也可能缺失。AI 助手可先检索再按需提取；已知专利标识符时可直接提取，无需先搜索。

• 当需要根据合金成分范围、物质名称或材料属性，结合技术描述、关键词或专利筛选条件查找相关材料专利时 • 当需要按材料属性的数值条件筛选专利，例如检索涉及抗拉强度不低于指定值的材料时 • 当已有专利号、PatSnap 内部专利 ID（`patent_id`），或已取得检索结果，需要提取材料成分、属性测量值及其来源位置和原文片段时 • 当需要为现有技术调研、竞争专利分析、FTO 初步筛查或材料对比准备结构化证据时；不适用于材料领域之外的通用专利搜索、法律分析或专利权利要求解释

• 材料专利检索 `search_material_evidence`：必须同时提供 `query` 和 `search`。`query` 至少包含 1 项，最多包含 **10 个 `substance` / `property` 项（两类合计）加 1 个 `alloy_composition` 项**，总计最多 11 项，以 `entity_type` 区分 `alloy_composition`、`substance` 或 `property`；分别提供 `composition`（每个元素的 `chemical_symbol`、`min`、`max`）及 `composition_unit`（`wt` 质量百分比或 `at` 原子百分比）、`substance` 名称或 `property` 名称 • 合金成分数值直接使用百分数本身：**1.0 at% 传 1.0，不传 0.01**；精确含量将 `min` 和 `max` 设为同一数值。`composition` 至少包含一个元素 • 属性查询的 `measurement` 可省略或为 `null`，表示仅按属性 ID 检索，不限制单位或数值。提供 `measurement` 时必须有非空 `unit`，比较条件 `eq`、`ne`、`gt`、`gte`、`lt`、`lte` 均可选：`{"unit":"MPa"}` 表示属性加单位筛选，`{"gte":400,"unit":"MPa"}` 表示再增加数值下限。单位只能放在 `measurement.unit`，放在属性项同级会被拒绝 • 属性单位必须与服务端取得的标准单位完全一致；标准单位缺失或不一致时返回 `INVALID_INPUT`，不自动换算。不一致的错误会给出标准单位；重试前须正确换算数值，不能只替换单位名称，也不能擅自删除数值限制 • `search` 至少提供有效的 `semantic_query`、`keywords` 或 `filters` 之一，三者可组合使用：语义查询使用完整技术句子；关键词使用非空技术词，建议 3–8 个（非硬性最少数量）；筛选条件可指定公开号/申请号前缀、申请人、发明人、地区、IPC、法律状态、日期或最低被引次数等支持的字段。空筛选列表、仅有 `date_type` 而无日期边界均不构成有效的独立筛选入口。`limit` 默认 10、范围 **1–50**；`offset` 默认 0、最小为 0，且 `offset + limit` 不超过 1000；排序默认相关性，`sort="-publication"` 表示按公开日期降序 • 专利材料证据提取 `fetch_document_material_evidence`：提供 `documents`，包含 1 至 10 个专利标识符；每项仅需 `id` 和 `id_type`（`patent_number` 或 `patent_id`）。使用检索结果时，将 `patent_id` 填入 `id`，并设置 `id_type="patent_id"`；不使用旧 `document_id`，不添加 `document_type` • AI 助手需将用户需求整理为上述结构化参数；检索工具不负责从一句自由文本中抽取 `query`。无需传入 `search.enabled`、`search_strategy`、`domain`、`domain_filters`；搜索策略和材料过滤条件由服务端生成。连接鉴权由既有连接配置提供，不作为工具业务参数传入；所需下游数据服务须已配置

• 检索成功时返回 `status="success"`、`hints`、`data.total_hits`（总命中数）、`data.returned_count`（本次返回数量）、`data.docs[]` 和 `cost_estimate`。每条专利包含九个字段：`patent_id`、`patent_number`、`title`、`abstract`、`view_url`、`jurisdiction`、`assignees`、`publication_date`、`legal_status`；部分信息可能为空。`abstract` 为从 DaaS 获取的专利摘要前 200 个字符：服务端区域为 CN 时返回中文，其他区域仅返回英文；优先获取目标语言的原始摘要，缺失时尝试译文。无法取得有效摘要时返回 `null`，并在 `hints` 中提示，不影响检索成功及正常计费；`view_url` 保留下游完整链接，不承诺免登录访问。归一化结果用于内部检索，不再返回 `data.entities[]` • 证据提取返回 `summary`、`data.documents_processed`、`data.results[]`、`warnings` 和 `cost_estimate`；每项结果以 `patent_id` 标识，附带可用的 `patent_number` 和 `materials_data`。重复解析到同一 `patent_id` 的输入会去重；`documents_processed` 是结果文档数，可能包含没有材料数据的文档，不等于有材料数据的文档数 • `materials_data` 按 `entity_type` 区分：**`alloy_composition`** 的元素范围位于 `substance_composition[].measurement.min/max`，缺失或无效的上下界分别保留为 `null`，有效数值（包括 0）独立保留；来源为可空的 `source_section` 和可空字符串 `source_text`；**`substance_property`** 包含 `property_id`、`property_name`、`measurement` 和 `unit`，原始性能值位于 **`measurement.value_str`**。当前属性记录的 `min/max` 为 `null`，不代表没有测量值。另一类型的专用字段会省略；材料名称和 ID 也可能为空 • 属性来源为 `source_sections` 和 `source_text` 数组，两者分别按稳定顺序去重，**不能按数组下标一一配对**；当前缺少片段时返回 `source_text=[]`。章节和片段可独立缺失，返回性能值、章节或空 `warnings` 都不保证有可核验原文。顶层 `evidence` 和 `next_actions` 当前为空列表；`evidence=[]` 不代表没有材料数据，应检查记录级来源 • 部分未归一化条目通过 `hints` 提示，只有成功归一化的条目进入结构化材料筛选；即使搜索成功，也不能声称全部原始条件已执行。全部未归一化返回 `NOT_NORMALIZED`，下游检索失败或响应不合法返回 `SEARCH_FAILED`，检索完成但无文档返回 `NO_RESULTS`。这些错误使用 `status="error"`、`error` 和不计费的 `cost_estimate`；检索失败会保留下游错误信息和可用提示 • 证据提取中的部分文档不存在、无材料数据、属性来源未匹配或 Analytics 依赖失败可通过 `warnings` 提示。全部文档不存在返回 `DOCUMENT_NOT_FOUND`；整批无材料数据且存在已识别的 Analytics 依赖失败时返回 `DEPENDENCY_FAILED`，否则返回 `NO_RESULTS`，均不计费。若仍有材料数据则保留结果及警告，不将部分失败描述为完整提取 • 还可能返回 `INVALID_INPUT`、`INPUT_LIMIT_EXCEEDED`、`TIMEOUT`、`RATE_LIMITED`、`PERMISSION_DENIED` 或 `CONFIGURATION_ERROR` 等错误。工具声明的错误不计费；参数格式校验可能由 MCP 层提前拒绝，返回形式不一定包含 `cost_estimate`

• `search_material_evidence` 内部完成归一化和专利检索，不支持仅提供 `query` 的纯归一化调用。仅需候选专利时，不自动追加提取；已有专利标识符时直接调用 `fetch_document_material_evidence`。需要先找候选再核对证据的任务才按需串联两工具 • 最新搜索 docstring 声明：成功归一化的物质、属性条件、标准筛选条件以及每个标准筛选字段中的多个值之间采用严格 AND。匹配发生在文档级，不保证不同条件属于同一材料；每个属性条件中的属性、单位和数值约束须匹配同一条记录。数值范围比较可能命中重叠的存储区间，不保证整个区间都落在指定范围内 • **描述与请求格式待核实的差异**：当前请求构造中，SPUM 名称归一化的物质 ID 使用 `substance_ids.contains_all`，MACE 合金候选 ID 使用 `substance_ids.contains_any`，两组在文档级按 AND 组合；多个属性条件仍发送为 `material_properties.contains_any`，标准筛选值按原列表透传。因此不能仅凭最新 docstring 或操作符名称认定下游已执行严格 AND，也不再将多个属性条件直接描述为“任选其一”；实际组合语义需要下游实现或集成测试确认。调用方无法切换操作符，不支持同一材料绑定或 `contains_none` • 提取的性能值和单位保留原始表达，不自动换算；**提取的原始单位不一定是搜索要求的标准单位**。记录可能涉及工艺条件、样品尺寸或引用内容，不能一概认定为某一材料的实测性能。发现字段与原文不一致时，应保留返回值并说明差异，不补写或擅自纠正 • 合金成分的上下界独立解析：缺失、无法转换或非有限数值（如 NaN、Infinity）返回 `null`，不再默认补 0；有效边界（包括真实的 0）保留，一侧无效不影响另一侧。合金单位缺失时仍可能从同组元素或组成属性名称推定；引用前需核对可用原文，不将推定单位视为原文明礹 • 两个工具目前仅处理专利，不支持论文、DOI 或任意文本/文件的材料信息抽取。物质和属性名称支持中文或英文；未匹配时应说明未执行的条件，需要调整名称或翻译重试时应遵循用户要求，不能静默放宽筛选来获取命中 • 检索成功且返回至少一条有效专利时，每次收取 20 积分；证据提取中至少一篇专利返回非空材料数据时，每次收取 100 积分，与该次返回或提交的文档数量无关。部分成功仍按请求计费；工具声明的错误、全部未归一化、检索无结果或整批无材料数据时不计费。`cost_estimate.credits` 可保留标价，应结合 `chargeable` 判断是否计费；再次成功调用按新请求计费 • 返回内容用于支持材料和专利分析，不构成法律结论