国家标准

概览

中国国家标准目录：该用哪部国标、什么状态、正文是否公开。只有目录，没有正文。

状态: live
文档 id: std_code 如 GB/T 42729-2023
引用格式: [GB/T 42729-2023]
更新于: 2026-10

常用调用

找标准POST /v1/standards/search {"query": "锂离子电池安全", "filters": {"state": "现行"}}

读一条目录GET /v1/standards/read/GB%2FT%2042729-2023 → 标准号里有斜杠，记得 urlencode

细则

只有目录元数据：条文正文要去 openstd 官网（brief 里的 fulltext 表示官网有没有在线全文）。
英文标题和标签是模型只凭中文标题生成的，没有正文依据，别当权威译名。
现行 48,406 条、废止 28,535 条——按 state=现行过滤再引用。
检索库里没有正文：level=full 暂不可用（条文正文不公开在本库，去 openstd 官网（openstd.samr.gov.cn））。

检索

POST/v1/standards/search

混合检索，每条命中一张卡片。2 credits。免费样例：锂离子电池安全。

过滤字段

字段	类型 · op	含义
nature	keyword · eq any强制性 · 推荐性 · 指导性技术文件	性质
state	keyword · eq any现行 · 即将实施 · 废止 · 暂不实施	状态
std_prefix	keyword · eq anyGB · GB/T · GB/Z	标准号前缀
ics	keyword · eq any	ICS 一级分类号（见 facets；13 环保安全、35 信息技术、77 冶金…）
is_mandatory	bool · eq	是否强制性
issue_year	integer · eq range	发布年份区间
act_year	integer · eq range	实施年份区间

还有 1 个，照样能用

字段	类型 · op	含义
tags	keyword · eq any	主题标签（模型生成）

参数

参数	类型	说明
query 必填	string	1–1000 字符。也可以是最多 5 条的数组（批量，hits 变 results[]）。
top_k	integer= 10	1–100。
fields	brief · head= brief	head 多扣 1 credit，每条附 head 视图。
filters	json	过滤 DSL 对象（见快速开始）；可用字段见上表。
mode	hybrid · dense · bm25= hybrid	检索模式。不传就用第一个。
offset	integer= 0	翻页。

示例

{ "domain": "standards", "query": "…", "hits": [ { "id": "GB/T 42729-2023", "score": 0.83, "brief": { … } } ], "total": null, "coverage": …, "warnings": [],
  "meta": { "request_id": "req_…", "credits": { "charged": 2, "balance": 1998, "pool": "allowance" }, "latency_ms": 41, "cached": false } }

用了未声明的过滤字段返回 400，不会静默忽略。过滤条件是 AND；可用 _or / _not。

读

GET/v1/standards/read/{std_code}

三档深浅，不传就是 detail。免费样例：GB/T 42729-2023。

三档

深浅	credits	返回
brief	1	卡片：做取舍够用的字段（检索结果里那张）
detail （默认）	2	全部结构化字段（规则字段 + 模型字段，模型字段在 _enrich.fields 里列名）
full	5	全文（建设中：条文正文不公开在本库，去 openstd 官网（openstd.samr.gov.cn））

参数

参数	类型	说明
std_code (path) 必填	string	文档 id（std_code）。
level	brief · detail · full= detail	读多深。
format	json · md · html= json	响应形态。

示例

{ "domain": "standards", "id": "GB/T 42729-2023", "level": "detail", "view": "head", "data": { … } | "text": "…", "token_count": 1834, "meta": { … } }

旧写法 GET /v1/standards/doc/{id}?view=… 仍然可用。

批量读

POST/v1/standards/read

最多 50 个 id，同一档。查不到的 id 返回 error: "not_found"，不扣费。

参数

参数	类型	说明
ids 必填	string[]	文档 id 列表。
level	brief · detail · full= detail	所有 id 共用的档。

示例

{ "domain": "standards", "level": "detail", "docs": [ { "id": "…", "data": { … } }, { "id": "…", "error": "not_found" } ], "meta": { … } }

Facets

GET/v1/standards/facets?field={field}

某个过滤字段的合法值，agent 不用猜；预聚合字段带计数，声明的枚举没有。免费、不需要 key。

参数

参数	类型	说明
field 必填	nature · state · std_prefix · ics	有 facets 的过滤字段。
limit	integer= 50	最多返回多少个值。

示例

{ "domain": "standards", "field": "…", "values": [ { "value": "…", "count": 3120 } ], "meta": { … } }

问registered key+ /stream

POST/v1/standards/ask

本域的 agentic 问答，但先看清边界：**只有目录元数据，没有条文正文**。能回答「有哪些标准、什么分类、现行还是废止、什么时候实施」；回答不了「某条怎么规定的」——问到正文时会说明并给出去 openstd 官网的指引。引用写成 [standards: <标题>]。effort low / medium / high 对应 50 / 100 / 200 credits。加 /stream 走 NDJSON，第一个事件一定是 billing。首个 answer_delta 之前失败会退款。

参数

参数	类型	说明
query 必填	string	1–2000 字符。问得具体；要数字就直接问数字。
effort	low · medium · high= low	检索轮数，也决定价格：50 / 100 / 200 credits。套餐限制最高档。
verbose	bool= false	返回工具调用轨迹（流式时多 tool_call / tool_result / thinking 事件）。
top_k	integer= 10	预取候选数。
stream_answer	bool= true	仅流式：false 时只发一个 answer 事件。
max_rounds	integer	0–8，覆盖 effort 预设。
force_answer_after	number	秒；强制切入作答阶段。
max_answer_tokens	integer= 4096	触顶时置 answer_truncated。
language	string	回答语言，默认跟随 query。

示例

{ "answer": "… [GB/T 42729-2023] …", "sources": [ … ], "stats": { "rounds": 1, "elapsed_s": 6.2, "answer_truncated": false }, "coverage"?: { … }, "meta": { "credits": { "charged": 50, … } } }

引用是真的——answer 里的每个 id 都存在于本垂域（格式 [GB/T 42729-2023]）。sources 是召回集，不是引用列表。answer_truncated 表示不完整。