SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场linkfox-eureka-description-translated

linkfox-eureka-description-translated

写作与研究

查看项目

更新于 10-15 08:50

技能介绍

用途

本技能用于通过 Eureka 专利数据平台获取“翻译后”的专利说明书（description，也称 specification）文本。可按专利ID或公开号查询，支持中文、英文、日文三种目标语言。适用于需要某件专利说明书多语言版本的场景。

主要能力

  • 翻译语言：支持 en（英文，默认）、cn（中文）、jp（日文）。
  • 标识方式：可通过 patentId 或 patentNumber 查询，二者至少提供一个；同时提供时 patentId 优先。
  • 批量查询：多个值以逗号分隔，单次最多 100 件。
  • 同族替代：当原文说明书不可用时，可通过 replaceByRelated = 1 启用同族专利说明书替代；默认 0（不启用）。返回中的 pnRelated 字段仅在发生替代时出现。

使用方式

资料给出的调用方式如下：

  • API 端点：POST /tool-eureka/descriptionDataTranslated（完整参数/响应/错误码见 references/api.md）。
  • Python 脚本：python scripts/eureka_description_translated.py '<JSON 参数>' [--inline]。

脚本默认行为：

  • 始终将完整响应写入 <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-eureka-description-translated-<timestamp>.json；禁止写入 /tmp，当前目录不可写则报错。
  • 响应体 ≤ 8 KB：落盘后将完整 JSON 打印到 stdout。
  • 响应体 > 8 KB：落盘后 stdout 只输出摘要（顶层字段、常见计数如 total/costToken、最大列表字段的长度 + 前 3 条样本）。
  • 加 --inline 强制全量打印到 stdout（同样落盘）。

参数：

  • patentId（字符串，条件必填）：专利ID，最多 100 个，逗号分隔。
  • patentNumber（字符串，条件必填）：公开（公告）号，最多 100 个，逗号分隔。
  • lang（字符串，可选）：目标翻译语言，en/cn/jp，默认 en。
  • replaceByRelated（整数，可选）：原文缺失时是否用同族替代，1=是，0=否（默认）。

响应字段：total（返回记录数）、data（专利对象数组）、data[].patentId（内部专利ID）、data[].pn（公开号）、data[].description（翻译后的说明书文本）、data[].pnRelated（替代同族专利公开号，仅在替代时出现）、costToken（本次消耗的 Token）。

资料提供的调用示例：

  • 按公开号取英文说明书：patentNumber = "US10123456B2", lang = "en"
  • 按专利ID取中文说明书：patentId = "abc123def", lang = "cn"
  • 批量并启用同族替代：patentNumber = "US10123456B2,EP3456789A1,CN112345678A", lang = "en", replaceByRelated = 1
  • 日文翻译：patentNumber = "JP2021012345A", lang = "jp"
  • 中文并启用同族替代：patentNumber = "US10123456B2", lang = "cn", replaceByRelated = 1

认证与积分问题处理（资料说明）：

  • 未配置 API Key（环境变量 LINKFOX_AGENT_API_KEY 或 LINKFOXAGENT_API_KEY 未配置）、响应 401/402、响应提示积分或余额不足（含“积分余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值”等）时，优先采用 skill 内的 onboarding.md 引导解决；找不到 onboarding.md 则加载 /linkfox-onboarding 这个 skill；如未安装，下载 https://agent-files.linkfox.com/skills/linkfox-onboarding/release.zip，解压后安装，需用户授权时须先询问授权。兜底方案为提示用户依据 https://skill.linkfox.com/linkfoxskills/guide.htm 获取 API Key，或去 https://os.linkfox.com/ 补充积分。
  • 成本约束：本工具会消耗积分；同一会话同一参数组合默认只调用一次，脚本带 24h 本地缓存。失败/空结果不得自动换关键词、翻页或改邮编连续试探；需要继续检索时先向用户说明会产生额外消耗。

积分消耗规则（资料说明）：按动态规则计费，消耗积分 = 81 × max(返回条数, 1)；属于倍数动态计算，可能一次性消耗大量积分，须提醒用户并由用户决定是否继续。

显示与反馈：对长说明书可展示摘要或首段并告知全文可获取；发生同族替代时明确告知并显示 pnRelated；批量结果按结构化列表分隔展示；查询失败时根据响应说明原因并建议核对 ID 或公开号；不得虚构或改写专利文本，只展示 API 返回内容。当技能描述与实际行为不符、结果不符用户意图、用户表达不满或赞扬、或认为可改进时，按 references/api.md 调用反馈 API，且不打断用户流程。

适用场景

资料列出的适用场景包括：单件专利说明书翻译（如“Translate this patent description to English”）、指定语言翻译（如“I need the Chinese version of patent US10123456”）、批量说明书获取、说明书查询（如“What does patent CN112345678A describe?”）、日文全文翻译、以及原位缺失时的同族回退（如“The description is missing, can you try a family member?”）。

限制

  • 必须提供专利ID或公开号，无法按关键词检索。
  • 仅支持中文、英文、日文三种翻译语言。
  • 仅返回说明书/正文文本，不含标题、摘要、权利要求。
  • 同族替代需显式设置 replaceByRelated = 1。
  • 单次最多 100 件。
  • 若用户仅提出“专利全文”未指明范围，需先确认是说明书、权利要求还是摘要；超过 100 件需分批。
  • 不适用场景：按关键词/主题的专利检索与发现、权利要求分析或权利要求对照表生成、专利法律状态或审查历史、专利引用或参考分析、专利组合分析或统计。

更多跨境电商品类相关技能可访问 LinkFox Skills。