汇率转换器 (Currency Converter)

1. 详细描述

该工具能够帮助用户查询两种不同货币之间的实时汇率，并根据用户提供的金额进行换算。它依赖于一个外部的汇率API来获取最新数据，确保转换结果的时效性和准确性。支持全球主要流通货币，如人民币(CNY)、美元(USD)、欧元(EUR)、日元(JPY)、英镑(GBP)等。

2. 使用场景 (When to use)

当用户明确表达以下意图时，应该调用此工具：

• 用户说：“100美元等于多少人民币？”
• 用户说：“查询一下欧元兑英镑的汇率。”
• 用户说：“帮我换算一下5000日元。”
• 用户说：“今天的美元对人民币汇率是多少？”

3. 如何使用 (How to use)

当用户指令匹配到上述场景时，请按以下步骤操作：

1. 解析参数：从用户消息中提取关键信息。

   • 金额：用户想要转换的数值（例如：100, 5000）。如果用户只问汇率没提金额，默认金额为1。
   • 原始货币：用户持有的货币（例如：美元、USD、日元）。需要识别常见的中英文名称和货币代码。
   • 目标货币：用户想要转换成的货币（例如：人民币、EUR）。如果用户只问一种货币对另一种，这两个参数都需要提取。

2. 标准化货币代码：将用户输入的中文或英文货币名称，转换为标准的三个字母货币代码（ISO 4217标准）。

   • 例如：“人民币” -> CNY, “美元” -> USD, “欧元” -> EUR, “日元” -> JPY, “英镑” -> GBP。

3. 执行脚本：调用后端的汇率转换脚本。

   • 命令格式：python3 currency_converter.py --amount {金额} --from {原始货币代码} --to {目标货币代码}
   • 示例：如果用户问“100美元等于多少人民币？”，则执行： python3 currency_converter.py --amount 100 --from USD --to CNY

4. 处理并返回结果：

   • 成功：脚本会返回一个包含转换结果和汇率的JSON。你需要将这个结果组织成一段自然、友好的语言回复用户。
     • 示例回复： “根据最新汇率，100 美元 (USD) 大约可以兑换 725.50 人民币 (CNY)。当前汇率为 1 USD = 7.2550 CNY。”
   • 失败：如果脚本返回错误信息，按照“边缘情况处理”部分来回复。

4. 边缘情况处理 (Edge cases)

在以下特殊情况下，请按提示回复用户，不要执行脚本或强行解释：

• 缺少货币参数：如果用户只说“帮我换算一下”，但没有指明是哪两种货币。
  • 回复： “请问您想换算哪两种货币呢？例如：‘100美元兑换人民币’。”
• 货币不支持：如果用户查询的货币不在我们支持列表中（脚本会返回特定错误码）。
  • 回复： “抱歉，暂时不支持您查询的货币（例如：{用户输入的货币}），请尝试查询美元、欧元、人民币等主流货币。”
• 网络或API错误：如果脚本因网络问题或外部API服务不可用而失败。
  • 回复： “哎呀，我现在无法连接到汇率数据服务，暂时无法进行实时换算。请稍后再试。”
• 无效的金额：如果用户输入的金额不是有效的正数。
  • 回复： “您输入的金额‘{用户输入}’好像不太对，请提供一个有效的数字，比如‘100’。”