用途
本技能用于从智慧芽(PatSnap)专利数据库获取专利标题和摘要的翻译版本,支持中文、英文、日文三种目标语言。适用于专利摘要翻译、专利标题翻译、按专利ID或公开号查询特定专利的翻译内容等场景。
主要能力
- 按专利ID(patentId,智慧芽内部标识)或公开号(patentNumber,如 US20200012345A1、CN112345678A)查询专利标题与摘要的翻译版本。
- 支持批量查询:多个标识用逗号分隔,patentId 与 patentNumber 最大长度均为 60,000 字符。
- 目标语言可选:en(英文,默认)、cn(中文)、jp(日文)。
- 同族专利回退:当原专利无摘要时,可通过 replaceByRelated=1 使用同族专利摘要替代(默认 0,不启用)。
- 若同时提供 patentId 与 patentNumber,patentId 优先。
使用方式
参数
- patentId(string):智慧芽内部专利ID,与 patentNumber 至少提供一个,多个用逗号分隔。
- patentNumber(string):公开(公告)号,与 patentId 至少提供一个,多个用逗号分隔。
- replaceByRelated(integer):原专利无摘要时是否用同族专利摘要替代,1=是,0=否,默认 0。
- lang(string):目标翻译语言,en=英文(默认)、cn=中文、jp=日文。
调用方式
- API 端点:POST /zhihuiya/abstractDataTranslated(完整参数、响应与错误码见 references/api.md)。
- Python 脚本:python scripts/zhihuiya_abstract_translated.py '<JSON 参数>' [--inline]。
响应字段
- total:返回的专利记录数。
- data:专利对象数组,包含 patentId(智慧芽内部专利ID)、pn(公开号)、title(翻译后标题)、abstractText(翻译后摘要)、pnRelated(替代同族专利公开号,仅在使用同族替代时出现)。
- costToken:本次请求消耗的 token。
输出策略(脚本默认行为)
- 始终将完整响应写入 <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-zhihuiya-abstract-data-translated-<timestamp>.json;<cwd> 为脚本执行时的工作目录,<session> 取自环境变量 SESSION_ID;禁止写入 /tmp,当前目录不可写则报错。
- 响应体 ≤ 8 KB:落盘后将完整 JSON 打印到 stdout。
- 响应体 > 8 KB:落盘后 stdout 只输出摘要(顶层字段、常见计数如 total/costToken、最大列表字段的长度 + 前 3 条样本)。
- 加 --inline 强制全量打印到 stdout(同样落盘)。
- 读数据建议:先看摘要判断是否足够;需要具体字段时优先用 jq 或 ConvertFrom-Json 从保存的 json 文件按需抽取,避免整份 JSON 进入上下文。
展示规则
- 以结构化表格展示专利号、标题和摘要。
- 在输出头部标明翻译语言。
- 若结果中出现 pnRelated,需明确告知用户摘要来自同族专利并展示替代公开号。
- 长摘要完整展示,不截断。
- 如实报告错误;空翻译结果仅表示未返回所请求的翻译,不代表专利不存在或所有同语言请求均不受支持。如需原始摘要,可使用 /zhihuiya/simpleBibliography 并核实返回的专利与文本语言。保持用户请求的目标语言,不静默切换语言或替换同族专利。
- 不对专利内容添加主观解读或法律分析。
适用场景
- 单件专利摘要翻译(如“翻译这件专利的摘要”)。
- 按公开号查询专利摘要(如“查一下公开号 XX 的摘要”)。
- 指定语言翻译(如“获取这件专利的中文/日文版本”)。
- 批量翻译多件专利。
- 原摘要缺失时使用同族专利摘要回退。
限制
- 必须提供专利ID或公开号,无法进行关键词检索。
- 仅支持中文(cn)、英文(en)、日文(jp)三种翻译语言。
- 不提供全文检索,仅返回标题和摘要,不含权利要求或说明书。
- 同族专利替代仅在显式设置 replaceByRelated=1 时提供。
- 不适用于:专利全文/权利要求/说明书获取、按关键词/分类/申请人检索、法律状态、引用分析或专利地图报告、专利估值或侵权分析。
认证与算力
- 需配置环境变量 LINKFOX_AGENT_API_KEY 或 LINKFOXAGENT_API_KEY。
- 出现 401 或 402 状态码,或提示算力/余额不足(如“算力余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值”等)时,按 references/onboarding.md 引导解决。
算力消耗规则
- 按动态规则计费:消耗算力 = 81 × 返回 data 条数,每条为 1 条专利摘要翻译结果。
- 本技能按倍数动态计算,可能一次性消耗大量算力,必须提醒用户并由用户决定是否继续。
- 同一会话同一参数组合默认只调用一次,脚本带 24h 本地缓存;失败或空结果不得自动换关键词、翻页或改邮编连续试探;需要继续检索时先向用户说明会产生额外消耗。
反馈
当技能描述与实际行为不符、结果与用户意图不符、用户表达不满或赞扬,或有可改进之处时,通过 Feedback API 自动检测并报告反馈,不打断用户流程。