AI工程师手册示例5分钟用 Python 实现实时货币转换工具附完整代码【免费下载链接】ai-angineers-handbook项目地址: https://gitcode.com/gh_mirrors/ai/ai-angineers-handbook实时货币转换工具是 AI 工程师手册ai-angineers-handbook开源项目中最受欢迎的实战示例之一。这个项目专注于从零构建 AI AgentBuilding Agents from Scratch而本文的主角——一个基于 Python 的实时汇率换算工具——正是其中工具调用Tool Use部分的完整实现它通过免费汇率 API 获取最新数据仅需几行代码就能完成任意币种间的快速换算。更酷的是它还能让 AI 自动判断什么时候该调用货币转换工具。今天我们就用 5 分钟把它跑起来新手也能轻松上手为什么要动手做一个实时货币转换工具日常开发中汇率换算是一个高频又真实的需求跨境电商比价、出国旅行预算、外汇牌价监控……而市面上很多汇率接口要么收费、要么不稳定。AI 工程师手册项目的 tool_use 示例 恰好给出了一个轻量级方案——不依赖任何重量级框架用 Python 标准库加上一个免费接口就能实现实时货币转换工具的核心功能。整个项目代码结构非常清晰只有三个关键文件tools.py实时汇率换算工具本体tool_registry.py工具注册与参数解析main.pyAI Agent 主程序与决策流程5分钟快速上手环境搭建与依赖安装 ⚙️先克隆仓库拿到完整示例代码git clone https://gitcode.com/gh_mirrors/ai/ai-angineers-handbook然后进入 tool_use 目录安装依赖。项目推荐使用uv这个极快的 Python 包管理工具依赖清单就在 requirements.txt 里主要包括 openai、pydantic 等cd building_agents_from_scratch/tool_use uv pip install -r requirements.txt接着配置你的 OpenAI API Key用于让 AI 做工具调用决策export OPENAI_API_KEY你的密钥搞定环境搭建只需这两步剩下的交给代码。✅核心实现Python实时汇率换算代码完整版 接下来是重点——实时货币转换工具的完整代码。它封装在 tools.py 中利用免费的 open.er-api.com 汇率接口通过urllib请求 JSON 数据再按目标币种计算换算结果from tool_registry import tool import urllib.request import json tool() def convert_currency(amount: float, from_currency: str, to_currency: str) - str: 使用最新汇率进行货币换算 Parameters: - amount: 要换算的金额 - from_currency: 源币种代码如 USD - to_currency: 目标币种代码如 EUR try: url fhttps://open.er-api.com/v6/latest/{from_currency.upper()} with urllib.request.urlopen(url) as response: data json.loads(response.read()) if rates not in data: return Error: Could not fetch exchange rates rate data[rates].get(to_currency.upper()) if not rate: return fError: No rate found for {to_currency} converted amount * rate return f{amount} {from_currency.upper()} {converted:.2f} {to_currency.upper()} except Exception as e: return fError converting currency: {str(e)}这段 Python 代码逻辑非常直观请求接口 → 解析 JSON → 查汇率 → 计算并返回。整个实时货币转换工具只有 30 行左右却已经包含了错误处理、币种校验等健壮性细节非常适合初学者逐行阅读学习。巧妙注册让 AI 认识你的货币转换器 光有工具还不够关键是让 AI Agent 能认识并调用它。这里用到了 tool_registry.py 中的tool()装饰器——它会自动解析函数的文档字符串和类型注解生成工具的名称、描述和参数说明实现定义即注册agent Agent() agent.add_tool(convert_currency)这种设计的好处是以后想增加新工具比如天气查询、翻译只需写一个普通函数加上tool()AI 就能自动学会使用它扩展成本几乎为零。AI 自动决策何时该调用货币转换工具这就是项目最精彩的部分在 main.py 中Agent 会先生成一份包含工具清单的系统提示词LLM 阅读后自主决定需要换算时输出调用计划按顺序执行convert_currency无需工具时直接回答不浪费任何一次工具调用比如 Agent 的execute()方法会先plan()再执行工具最终把思考过程 执行计划 换算结果一并返回。整个决策逻辑都封装在 main.py 里值得反复阅读。运行效果演示一键启动 运行主程序看看实时货币转换工具的实际表现python3 src/main.py程序内置了两条测试问题其中一条是我要从塞尔维亚去日本旅行手上有 1500 当地货币能换多少日元Agent 会这样处理思考需要调用货币转换工具把 RSD 换成 JPY计划使用 convert_currency 工具完成换算✅结果返回 1500 塞尔维亚第纳尔 约 12000 日元另一条问题你好呀则会被识别为无需工具直接友好回复——这种该用才用的智能判断正是 AI Agent 工具调用的精髓所在。✨进阶玩法让货币转换工具更强大 跑通基础版之后你还可以按需扩展比如批量换算循环调用工具一次比较多个币种汇率历史汇率查询替换数据源增加走势分析能力可视化面板搭配 Gradio 或 Streamlit做成网页版实时货币转换工具更多工具组合把换算结果接入邮件、推送等通知渠道项目后续还会加入 Anthropic、Mistral 等更多模型提供方的支持扩展空间非常广阔。总结 通过 AI 工程师手册的这个示例我们用 5 分钟就完成了一个开箱即用的实时货币转换工具环境搭建只需两步核心代码只有 30 行还能让 AI 自主决策调用时机。无论你是 Python 新手还是想深入理解 AI Agent 工具调用机制这都是一个绝佳的起点。赶紧 clone 仓库动手试试吧【免费下载链接】ai-angineers-handbook项目地址: https://gitcode.com/gh_mirrors/ai/ai-angineers-handbook创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考