currency-converter

# 汇率转换器 (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’。”