SuperAPI AI 工具集

linkfox-eureka-abstract-translated

写作与研究

查看项目

更新于 10-15 09:11

技能介绍

用途

本技能用于从 Eureka 专利数据平台获取专利标题和摘要的翻译版本,支持中文、英文、日文三种目标语言。适用于需要快速了解某件或多件专利大致内容的场景,例如专利摘要翻译、专利标题翻译、查询其他语言的专利内容,或通过专利 ID / 公开号定位特定专利的摘要与标题。

主要能力

  • 按专利 ID(patentId)或公开号(patentNumber)查询专利的翻译标题与摘要。
  • 支持批量查询:多个标识用逗号分隔,单次最多 100 件专利。
  • 支持目标语言选择:en(英文,默认)、cn(中文)、jp(日文)。
  • 同族专利回退:当原始专利无摘要时,可通过 replaceByRelated=1 使用同族专利摘要替代,并在返回结果中给出替代同族专利的公开号(pnRelated)。
  • 返回字段包括:total(返回记录数)、data 数组(含 patentId、pn、title、abstractText、pnRelated)、costToken(本次请求消耗的 token)。

使用方式

参数说明:

  • patentId:字符串,与 patentNumber 至少提供一个。内部专利 ID,多个用逗号分隔,最多 100 件。
  • patentNumber:字符串,与 patentId 至少提供一个。公开(公告)号,多个用逗号分隔,最多 100 件。
  • replaceByRelated:整数,可选。原始摘要不可用时是否用同族专利摘要替代,1=是,0=否,默认 0。
  • lang:字符串,可选。目标翻译语言,en=英文(默认),cn=中文,jp=日文。

关键规则:

  • 必须提供 patentId 或 patentNumber 中至少一个;若两者都提供,patentId 优先。
  • 支持批量查询,逗号分隔,单次上限 100 件。
  • 用户未指定语言时默认使用 en。
  • 仅当用户明确希望原始摘要缺失时用同族专利替代,才设置 replaceByRelated=1。

调用方式:

  • API 端点:POST /tool-eureka/abstractDataTranslated(完整参数/响应/错误码见 references/api.md)。
  • Python 脚本:python scripts/eureka_abstract_translated.py '<JSON 参数>' [--inline]。

输出策略(脚本默认行为):

  • 始终将完整响应写入 <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-eureka-abstract-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 进入上下文。

使用示例:

  1. 按公开号翻译单件专利摘要为英文:patentNumber = "US20200012345A1",lang = "en"。
  2. 批量翻译为中文:patentNumber = "CN112345678A,US20200067890A1",lang = "cn"。
  3. 按专利 ID 查询并启用同族回退:patentId = "12345678",lang = "jp",replaceByRelated = 1。
  4. 按专利 ID 批量查询:patentId = "111111,222222,333333",lang = "en"。
  5. 翻译为中文并启用同族回退:patentNumber = "CN112345678A",lang = "cn",replaceByRelated = 1。

展示规则:

  • 以结构化表格展示专利号、标题、摘要。
  • 在输出头部标明翻译语言。
  • 若结果中出现 pnRelated,需明确告知用户摘要来自同族专利并展示替代公开号。
  • 长摘要完整展示,不截断。
  • 查询失败或无结果时,说明可能原因(如专利号无效、数据库中未找到)并建议修正。

适用场景

  • 单件专利摘要翻译。
  • 查询某专利大致内容(摘要)。
  • 获取某专利的中文/日文版本。
  • 按公开号查询摘要。
  • 批量翻译多件专利。
  • 原始摘要缺失时尝试同族专利摘要。

限制

  • 必须提供专利 ID 或公开号,无法按关键词检索。
  • 仅支持中文(cn)、英文(en)、日文(jp)三种翻译语言。
  • 不提供全文检索,仅返回标题和摘要,不含权利要求或说明书。
  • 同族专利替代为可选项,仅在 replaceByRelated=1 时提供。
  • 单次请求最多 100 件专利,超过需分批。
  • 不适用于:专利全文/权利要求/说明书获取、按关键词/分类/申请人检索、专利法律状态/引用分析/全景报告、专利估值或侵权分析。
  • 边界情况:用户仅要求“专利内容”而未指明部分时,默认按摘要翻译处理并告知权利要求/说明书相关工具;用户提供超过 100 件专利时需分批。

认证与积分

  • 未配置 API Key(环境变量 LINKFOX_AGENT_API_KEY 或 LINKFOXAGENT_API_KEY 未设置)、响应 401 或 402、或提示积分/余额不足时,优先采用技能内的 onboarding.md 引导解决;如无该文件,则加载 /linkfox-onboarding 技能按其引导处理(未安装可下载 https://agent-files.linkfox.com/skills/linkfox-onboarding/release.zip 解压安装,需用户授权时先询问)。兜底方案:提示用户依据 https://skill.linkfox.com/linkfoxskills/guide.htm 获取 API Key,或前往 https://os.linkfox.com/ 补充积分。
  • 积分消耗规则:按动态规则计费,消耗积分 = 81 × max(返回条数, 1)。该服务按倍数动态计算,可能一次性消耗大量积分,必须提醒用户并由用户决定是否继续。
  • 成本约束:本工具会消耗积分;同一会话同一参数组合默认只调用一次,脚本带 24h 本地缓存。失败/空结果不得自动换关键词、翻页或改邮编连续试探;需要继续检索时先向用户说明会产生额外消耗。