SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场academy-skill

academy-skill

写作与研究

查看项目

更新于 10-15 17:06

技能介绍

用途

Binance Academy AI Skill 是一个意图驱动的教育内容检索技能，用于在 AI 对话中获取币安学院（Binance Academy）的官方教育内容，包括术语表（Glossary）、课程（Courses）、学习赚币（Learn & Earn）和文章（Articles）。它把检索结果整理为简洁的转述式回答，并附上 Academy 链接，同时明确声明内容不构成投资建议。

主要能力

该技能覆盖四类意图：

  1. 知识问答：回答“什么是 X”“X 为什么发生”“X 如何运作”等问题，使用 searchAll 并行检索。
  2. 风险教育：针对杠杆、借贷、全仓、诈骗、“20x 做多”“借钱交易”等话题，使用 searchAll 并附加风险警告块。
  3. 学习计划：响应用户“我想学 X”“X 学习路径”“帮我制定 X 计划”等请求，使用 getLearningPlan。
  4. 学习赚币：回答“哪些课程有奖励”“一文读懂 X”“什么是 X（代币代码）”等问题，使用 searchLearnEarn 或 searchAll。

不触发的情况包括：账户/登录问题、交易执行（如“现在买 1 BTC”）、价格查询（如“BTC 价格是多少”）以及闲聊。

使用方式

  1. 检测用户语言：默认简体中文为 zh，英文为 en，完整 35 种语言代码见 references/languages.md。
  2. 选择意图并调用脚本：所有示例使用 prod 环境（唯一支持的环境）。ACADEMY_SKILL_DIR 为该技能根目录，由运行时在技能加载时解析。

示例命令：

# 意图 1、2 — 知识问答 / 风险教育（推荐并行调度）
node "$ACADEMY_SKILL_DIR/scripts/academy-api.mjs" prod searchAll \
  '{"query":"gas fee","lang":"en","limit":3}'

# 意图 3 — 学习计划（使用干净的主题名词，而非完整句子）
node "$ACADEMY_SKILL_DIR/scripts/academy-api.mjs" prod getLearningPlan \
  '{"query":"DeFi","lang":"en","limit":3}'

# 意图 4 模式 A — 明确的奖励问题
node "$ACADEMY_SKILL_DIR/scripts/academy-api.mjs" prod searchLearnEarn \
  '{"query":"reward","lang":"en","limit":5}'

# 意图 4 模式 B — L&E 标题格式（searchAll 可捕获 L&E 并验证）
node "$ACADEMY_SKILL_DIR/scripts/academy-api.mjs" prod searchAll \
  '{"query":"What is Turtle (TURTLE)?","lang":"en","limit":3}'

searchAll 响应字段：使用 best.source（胜出的端点：glossary/learnEarn/resource/articles/null）、best.items[0]（格式化用的最佳命中）、best.matchTier（0–3 匹配质量档位，>=2 为良好匹配，<=1 为弱匹配需重试，-1 表示无命中）、glossary/learnEarn/resource 数组（用于生成“下一步”建议，无需额外 API 调用）、articlesLangFallback（仅当用户显式传入文章端点不支持的非空 lang 时为 true）。

查询策略（依语言而定）：

  • 英文及其他拉丁字母语言：先发送原始输入，仅在原始输入返回 matchTier <= 0 或 best.source == null 时提取干净关键词。
  • 中文及其他 CJK 语言：先提取关键词。CJK 原始句子几乎无法命中，默认在首次 searchAll 调用前提取主题名词并翻译为规范英文术语。
  • 例外：无疑问词的裸 CJK 概念名词（钱包、智能合约、工作量证明、区块链）可直接发送原始输入。
  • 风险教育类中文查询直接使用 references/query-extraction.md 中的风险教育术语映射。
  1. 格式化输出：直接输出 markdown，不使用 PRD 表格或 Response/Button/Next Step 标签。每次回复必须：用用户语言回答；包含至少一个来自 API 响应的 Academy URL（绝不虚构 URL）；转述而非粘贴；风险场景始终包含 ⚠️ 免责声明块。

输出模板

  • 意图 1 知识问答：术语链接 + 2–4 句转述定义 + 可选的下一步链接。
  • 意图 2 风险教育：风险模式 + 简要回答 + 风险引用 + 数值示例 + 更安全的下一步 + ⚠️ 免责声明。
  • 意图 3 学习计划：主题与难度 + 概述 + 按天分组的课程与模块 + 完整路径链接。天数分组：快速=1 天，默认=3 天，系统学习=5 天，证书=每课程一条目。
  • 意图 4 学习赚币：模式 A 为奖励课程列表，模式 B 为单课程详情（含活动日期与状态）。状态逻辑：hasReward=="1" && isRewardRunOut!="1" && now<activityEndDate → 🟢 Active；isRewardRunOut=="1" → 🔴 Fully distributed；now>activityEndDate → ⚪ Ended。
  • 无内容模板：当 best.source == null 时，提示 Academy 暂无相关内容，并给出相关术语、英文等价词、直接浏览 Academy 等建议。

适用场景

适用于在 AI 聊天中回答加密货币与区块链相关的教育性问题、提供风险教育、制定学习计划、查询学习赚币活动。不适用于账户问题、交易执行、价格查询和闲聊。

限制

  • 不提供投资建议，不承诺收益，不预测收益率或 ROI。
  • 风险内容必须引用 Academy 真实摘录或标题，不得编造风险陈述。
  • 风险场景必须包含强制免责声明。
  • 不得虚构 URL，仅使用 API 返回的 URL；URL 字段为空时省略链接。
  • 当最佳条目无可用 URL 时，按降级阶梯处理：使用 best.items[1..] 的次优条目、其他来源的顶部条目，或使用无内容模板。
  • 部分文章命中不在公开 v2 搜索索引中，约 27% 的 top-1 文章无 visitUrl。

参考资料（按需加载）

  • references/intent-routing.md：意图模糊时加载。
  • references/query-extraction.md：首次调用后 matchTier <= 0 时加载。
  • references/output-format.md：需要完整卡片模板时加载。
  • references/orchestration.md：意图 3 需要三步编排决策树时加载。
  • references/api-contract.md：需要全部 6 个端点的完整请求/响应模式时加载。
  • references/languages.md：需要完整 35 种语言代码或 41 种文章支持代码时加载。