SuperAPI AI 工具集

linkfox-zhihuiya-abstract-data-translated

写作与研究

查看项目

更新于 10-15 09:05

技能介绍

用途

本技能用于从智慧芽(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 自动检测并报告反馈,不打断用户流程。