技能使用指南

外汇（外汇技能Skill）Skill 是什么？能帮 AI 查实时汇率并换算金额吗？

外汇技能Skill 是一套面向 AI Agent 的 Vercel AI SDK Tool 集合，提供 rateLookup 汇率表查询与 convertCurrency 金额换算两大能力，让 AI 在对话中直接给出可复核的实时汇率结果。本文详解安装思路、参数用法、竞品对比与典型场景，帮你快速接入并提升开发效率。

外汇技能Skill外汇
8 个章节 约 15 分钟阅读 AI 智能生成

外汇技能Skill：让 AI Agent 一句话完成实时汇率查询与金额换算

  • 一句话定位：这是一套封装了实时外汇数据的 Vercel AI SDK Tool 集合，让 AI Agent 在对话中直接「查汇率、算金额」，不必依赖模型记忆去猜数字。
  • 两大核心能力：rateLookup 用于查询某个基准货币的完整汇率表，convertCurrency 用于完成 A 货币到 B 货币的金额换算，并返回可直接复述的自然语言摘要。
  • 工程规范清晰：参数定义、触发规则、错误处理、结果呈现都有明确约定，接入成本低，行为可预期。
  • 关键差异点：它解决的是「精准数值」问题，而非「泛泛而谈」。凡是涉及报价单、预算、跨境结算的场景，都不应该靠大模型估算。
  • 适合谁用：正在构建 AI Agent、智能客服、财务助手、旅行规划工具的开发者和效率工具用户。

该技能叫什么？如何一键安装 AI 技能提升开发效率？

技能中文名：外汇技能Skill 技能英文名：外汇 技能ID：14233

从技能详情给出的定义来看，它本质上是一套「面向 AI Agent 的货币转换技能」，对外以标准 Vercel AI SDK Tool 的形式提供，能力统一由 src/ai/tools/currency.ts 暴露，导出对象名为 currencyTools。

它解决什么问题？

大语言模型在被问到「今天 1 美元等于多少人民币」时，最常见的回答方式是「根据训练数据」或直接给出一个看似合理但已经过期的数字。这在闲聊里无伤大雅，一旦进入真实业务——跨境报价、旅行预算、报销核算、财务报表——就会变成硬伤。

外汇技能Skill 把「查汇率」和「换算金额」这两件事从「模型记忆」切换为「工具调用」，让 AI 在需要精确数字时去问实时外汇接口，而不是凭印象作答。

一键安装的思路与步骤

由于技能详情中并未提供具体的安装命令或下载地址，以下按标准 AI 技能接入流程描述，具体命令、仓库地址与配置项以官方说明为准：

  1. 确认安装前提：项目中已使用 Vercel AI SDK 作为 Agent 的工具框架；运行环境可访问外部外汇数据接口（技能描述中提到的是 Frankfurter API）；准备好可用的货币代码输入（ISO 4217 三位字母代码）。
  2. 获取技能：通过官方提供的技能市场、插件市场或技能包渠道找到「外汇技能Skill」（技能ID：14233），按官方指引完成添加。
  3. 接入工具对象：把技能提供的 currencyTools 注册进 Agent 的 tools 列表，使 rateLookup 与 convertCurrency 出现在可调用工具集合中。若为自建项目，通常是确认 src/ai/tools/currency.ts 已被正确引用。
  4. 验证是否生效：向 Agent 提一个最典型的问题——「帮我查一下 1 USD 等于多少 CNY？」如果 Agent 正确调用 convertCurrency 并返回带 summary 的结果（形如 100 USD ≈ 712.34 CNY），说明接入成功。也可以再试一次「给我一张以 CNY 为基准的汇率表」，验证 rateLookup 是否正常。
  5. 补充提示词约束：如果希望 Agent 更「主动」地使用它，可在系统提示中明确写入触发规则，例如「涉及金额与货币代码并要求换算时，必须调用外汇工具，不得估算」。

这种「工具即技能」的方式，正是 AI 技能提升开发效率的核心逻辑：不必为每个业务能力从零写接口、写校验、写错误处理，只要把标准化的 Tool 挂到 Agent 上，能力即可复用。

该技能的主要功能和特点

核心功能一：rateLookup —— 基准货币汇率表查询

  • 传入一个基准货币代码（如 USD、EUR、CNY），返回一整张汇率表。
  • 返回结构包含：base（实际基准货币代码）、date（汇率日期，由接口返回）、currencies（按代码排序的 { code, rate } 列表）。
  • 适合「一次性看多个币种」的需求，例如做汇率看板、多币种报价对比。

核心功能二：convertCurrency —— 金额换算

  • 传入 from、to、amount 三个参数，完成一次精确换算。
  • 返回内容更丰富：源货币、目标货币、金额、rate（含 fromRate 与 toRate）、result（换算结果数值），以及 summary（人类可读描述，如 "100 USD ≈ 712.34 CNY"）。
  • summary 字段是一个很实用的设计：它可以直接作为回答的骨架，减少 Agent 组织语言时的出错概率。

差异化特点

  • 数据来源明确：技能描述中直接标注了数据来自 Frankfurter API，属于实时外汇接口，而非模型内置知识。
  • 遵循 Vercel AI SDK 规范：Tool 的参数（parameters）与描述（description）都按标准规范书写，模型能准确理解何时该调用、怎么传参。
  • 自带触发规则：技能内置了「何时应该调用」「何时不应调用」的判断逻辑，避免在聊宏观经济、汇率走势时误触发，减少无谓调用。
  • 有明确的错误处理约定：遇到「不支持的货币代码」要指出是哪一位代码无效并建议改用常见币种；遇到网络或第三方接口故障，要如实说明「当前汇率服务不可用」，而不是编造数字。
  • 结果呈现有规范：建议汇率与金额保留 2–4 位小数，并在回答中标明货币代码，避免「元」到底是人民币还是美元这类歧义。

和普通「在代码里自己写个汇率查询函数」相比，它强在面向 Agent 设计：工具描述、触发条件、参数校验、错误兜底、输出格式全都替你想好了。

如何使用该技能？

以下按「开发者接入 + 日常调用」两个层面给出分步骤指南。

第一步：确认调用入口

技能的所有能力都从 currencyTools 这一个导出对象获取，内部包含 rateLookup 与 convertCurrency 两个 Tool。接入时把它们注册进 Agent 的工具集合即可。具体注册写法参照官方文档，以官方说明为准。

第二步：选择合适的 Tool

这是技能说明里反复强调的一点：

  • 用户要的是「一整张多币种汇率表」→ 用 rateLookup
  • 用户只关心「A 币种换 B 币种这一次换算」→ 用 convertCurrency

第三步：构造正确的参数

  • 货币代码统一使用三位大写字母（ISO 4217），如 USD、CNY、EUR。
  • 如果用户输入的是小写或符号（如 $、€），先在自然语言层面判断含义，再映射成标准代码。
  • 金额必须为正数；用户没有给出金额时，不要盲目调用 convertCurrency。

第四步：发起调用并查看返回

输入示例一（单次换算）：

工具：convertCurrency
参数：{ from: "USD", to: "CNY", amount: 1 }

返回的关键字段包括 result（换算结果）、rate（双向汇率）、summary（如「1 USD ≈ 7.12 CNY」）。

输入示例二（汇率表查询）：

工具：rateLookup
参数：{ baseCurrency: "CNY" }

返回一张以人民币为基准的币种列表，可按需以表格或列表形式呈现部分结果。

输入示例三（大额换算）：

工具：convertCurrency
参数：{ from: "EUR", to: "USD", amount: 500 }

对应技能详情中的示例场景「我有 500 EUR，大概能换多少美元？」。

第五步：组织自然语言回答

直接以 summary 为骨架，补充语气和必要解释，数值保留 2–4 位小数，并注明货币代码。

第六步：处理异常

  • 接口返回「不支持的货币代码」→ 明确告知用户是哪一个代码无效，建议改用常见币种。
  • 网络错误或第三方接口故障 → 明确说明当前汇率服务不可用，不要给出猜测数字。

同类型竞品对比分析

方案名称 定位 核心功能 安装/使用门槛 适用场景 优势与不足
外汇技能Skill（本技能） 面向 AI Agent 的标准 Vercel AI SDK Tool 集合 rateLookup 查汇率表、convertCurrency 换算金额，自带触发规则与错误处理约定 需已使用 Vercel AI SDK；按官方指引接入 currencyTools，具体步骤以官方说明为准 AI 客服、财务助手、旅行规划、跨境报价类 Agent 优势：Agent 原生可用、输出结构化且带 summary、行为规范清晰；不足：能力聚焦汇率与换算，不含历史走势、图表分析等扩展功能
大模型内置知识直接回答 不接工具，让模型凭训练数据作答 任意币种都能「说一个数」 零门槛 纯闲聊、粗略了解量级 优势：无需接入；不足：数字可能过期、无法追溯来源，涉及报价与预算时风险高
自研汇率查询函数 开发者自己写接口调用 + 参数校验 + 格式化 功能可完全自定义 需自行对接第三方汇率服务、处理鉴权与异常、编写工具描述 有特殊数据源要求或需要深度定制的项目 优势：灵活可控；不足：开发与维护成本高，工具描述写得不好还会导致模型调用不准
表格软件汇率函数（如表格中的汇率公式/插件） 面向人工操作的表格工具 在单元格内取汇率并计算 需要手动配置数据源与刷新 手工做预算表、对账表 优势：可视化直观、适合人工核对；不足：无法被 AI Agent 在对话中自动调用，交互链路长

从对比可以看出，本技能的生态位非常明确：它是给「AI Agent」用的，不是给「人」用的。比起让模型猜，它更准；比起自己造轮子，它更快。

该技能的典型应用场景与实际体验情况

场景一：跨境电商与外贸报价

角色：外贸业务员 / 报价系统。 痛点：给海外客户报价时，需要把人民币成本换算成美元或欧元报价，手动查汇率既慢又容易抄错。 使用方式：在报价助手对话中直接说「这批货成本 8600 元人民币，按今天的汇率折成美元是多少」，Agent 调用 convertCurrency 并返回带 summary 的结果，业务员确认后填入报价单。

场景二：旅行预算规划

角色：自由行游客。 痛点：出行前要做多币种预算，还要在现场快速判断「这个东西贵不贵」。 使用方式：先问「给我一张以 CNY 为基准的常见货币汇率表」拿到全局参考，旅途中再问「120 欧元大概多少人民币」。技能说明中提到的「用 rateLookup 呈现表格」正好对应这种先看全局、再看单点的使用节奏。

场景三：财务与报销核算

角色：财务人员 / 报销审核。 痛点：海外发票金额需要统一折算成人民币入账，要求数字精确、可解释。 使用方式：批量提出换算请求，Agent 逐条调用 convertCurrency，返回结果包含 rate 与 result，便于在单据上标注换算依据与汇率日期。

场景四：AI 产品中的多币种展示

角色：独立开发者。 痛点：产品面向全球用户，需要按用户所在币种展示价格。 使用方式：把 currencyTools 接入自有 Agent，由模型根据用户提问自动决定是展示多币种表还是单次换算，减少前端硬编码的汇率常量。

实际体验情况

  • 上手难度：低。两个 Tool、五个参数，几乎没有学习成本；真正需要花心思的是「触发规则」和「提示词约束」，让 Agent 知道什么时候该用。
  • 效果表现：返回结构清晰，尤其是 summary 字段，让模型不用自己拼接数字和币种，回答一致性明显更好。
  • 注意事项：一是不要在没有金额的情况下调用 convertCurrency；二是货币代码必须标准化，用户说「美金」「欧元」时要正确映射成 USD、EUR；三是务必保留错误兜底逻辑，宁可承认「服务不可用」，也不要让模型编一个数字出来。

该技能能为用户带来的价值

第一，把「猜」变成「查」。 汇率是一个对时效极其敏感的数值，模型记忆天生不适合承担这类任务。引入工具调用后，AI 回答的可信度从「听起来对」升级为「有来源、有日期、可复核」。

第二，显著缩短开发链路。 从「对接第三方汇率接口 → 写参数校验 → 写错误处理 → 写工具描述 → 调试模型调用准确性」这一整条链路，被压缩成「注册 currencyTools」。对独立开发者和中小团队来说，这是实打实的工期节省。

第三，降低 AI 应用的门槛。 技能自带触发规则、参数规范、结果呈现建议，即使是不熟悉 Tool Calling 细节的产品同学，也能理解它的边界并设计出合理的产品交互。

第四，减少业务风险。 报价单少算一个零、报销单汇率抄错一位，损失往往远超开发成本。技能明确要求「不支持的币种要说清楚是哪个」「服务不可用要如实说明」，这类规范本身就是风险控制。

长期价值在于可组合性：外汇能力只是 Agent 工具箱里的一格。当查询、换算、报表、邮件生成等技能都被标准化后，Agent 的能力扩展会变成「装配」而不是「重写」。

常见问题 FAQ

Q1：这个技能怎么安装？需要什么前提？

A：它是一套 Vercel AI SDK Tool 集合，能力由 src/ai/tools/currency.ts 导出为 currencyTools。接入的前提是项目已使用 Vercel AI SDK，并且运行环境可以访问外部外汇数据接口。具体的安装命令、获取渠道与配置方式，技能详情中未给出，请以官方说明为准。接入后可用「1 USD 等于多少 CNY」这类问题验证是否生效。

Q2：这个技能收费吗？

A：技能详情中未提及任何价格信息。其数据来源标注为 Frankfurter API，第三方接口自身的调用限制或费用政策需另行查阅该服务的官方说明。本技能是否收费，请以官方说明为准。

Q3：它和直接让大模型回答汇率有什么区别？

A：最大区别是数据来源。直接回答依赖模型训练时的知识，可能过期且无法追溯；本技能通过实时外汇接口获取数据，返回结果带有汇率日期与具体数值，可复核、可引用。凡是需要精确到 2 位以上小数的金额对比、预算或报价，都应该走工具调用。

Q4：什么情况下不应该用它？

A：技能说明了三类不触发的情况：一是用户只是在讨论宏观经济或汇率走势、不需要具体数值；二是用户明确表示「不用太精确、大概估算就行」；三是用户在询问历史汇率走势（本技能提供的是最新汇率表与实时换算，并非历史曲线数据）。此外，用户没有给出金额时也不应调用 convertCurrency。

Q5：它适合谁用？和竞品怎么选？

A：最适合正在构建 AI Agent 的开发者，以及需要 AI 在对话中完成精确货币换算的产品团队，典型如跨境报价、旅行预算、财务核算、多币种展示。选择逻辑很简单：如果你需要「AI 在对话里自动查、自动算」，选本技能；如果你只是人工做一张预算表，表格软件的汇率函数更顺手；如果你有特殊数据源要求，自研函数更灵活但成本更高。