exchange-rate

汇率

使用 QVeris 工具查询实时货币汇率并进行换算。

此技能的功能

Exchange Rate 提供：

1. 汇率查询——查询两种货币之间的当前汇率（例如 USD/EUR、CNY/JPY）。
2. 金额换算——按当前汇率将金额从一种货币换算为另一种货币。

通过 QVeris 支持外汇和常见法定货币对；当工具支持时，还可指定历史日期查询汇率或进行换算。

主要优势

• 仅使用 QVeris API：按功能搜索工具，然后执行；不使用硬编码的服务商列表。
• 一个服务商失败或不可用时，可回退到其他服务商（例如 Alpha Vantage、Twelve Data）。
• 与其他技能使用相同的凭据：仅需 QVERIS_API_KEY。
• 只读操作，不会产生副作用；适用于旅行、贸易和报告。

核心工作流

1. 解析用户意图：汇率查询（from_currency、to_currency）或金额换算（from_currency、to_currency、amount）。
2. 在 QVeris 中搜索工具，例如 “currency exchange rate real-time”、“currency conversion”。
3. 根据 success_rate、latency 和参数匹配度（汇率查询或金额换算）对结果排序。
4. 构建请求参数：汇率查询使用 from_currency/to_currency 或 symbol（例如 EUR/USD）；金额换算还需添加 amount。
5. 使用选定的工具执行请求，超时时间为 5s；如果失败，则尝试下一个候选工具。
6. 返回格式化的汇率和／或换算金额（Markdown 或 JSON）。

命令界面

主要脚本：scripts/exchange_rate.mjs

• 仅查询汇率：
  • node scripts/exchange_rate.mjs rate --from USD --to EUR
  • node scripts/exchange_rate.mjs rate --from CNY --to USD
• 换算金额：
  • node scripts/exchange_rate.mjs convert --from USD --to JPY --amount 1000
  • node scripts/exchange_rate.mjs convert --from EUR --to GBP --amount 500

可选参数：当工具支持时，使用 --date YYYY-MM-DD 查询历史汇率或进行历史换算；使用 --format json 输出机器可读的结果。

安全与免责声明

• 仅使用 QVERIS_API_KEY；不需要其他密钥。
• 仅通过 HTTPS 调用 QVeris；不安装软件包，也不执行任意命令。
• 输出仅供参考，不构成金融或合同建议。