最近在AI开发中Agent技术越来越受到关注但很多开发者觉得Agent框架过于复杂难以理解其核心原理。本文将通过30行Python代码完整复刻Agent的核心工作机制帮助开发者深入理解Agent如何调用工具、处理消息和实现智能决策。1. Agent技术背景与核心概念1.1 什么是AI AgentAI Agent是一种能够感知环境、自主决策并执行动作的智能系统。与传统的聊天机器人不同Agent具备工具调用能力可以根据任务需求主动使用外部工具来解决问题。比如当用户询问天气时Agent可以调用天气API获取实时数据当需要计算复杂数学问题时它可以调用计算器工具。1.2 Agent的核心组件一个完整的Agent系统通常包含以下核心组件消息处理模块负责接收、解析和响应消息工具调用机制管理可用的工具集处理工具调用请求决策引擎基于当前上下文决定下一步行动状态管理维护会话状态和工具调用历史1.3 为什么需要理解Agent核心虽然市面上有Claude、GPT等成熟的Agent框架但理解其底层原理对于开发者至关重要。只有掌握了核心机制才能更好地定制化开发、优化性能以及排查问题。本文的30行代码实现将帮助你建立对Agent技术的直观认识。2. 环境准备与开发工具2.1 基础环境要求在开始编码前确保你的开发环境满足以下要求Python 3.8或更高版本基本的Python编程知识任意代码编辑器VS Code、PyCharm等2.2 所需依赖库我们只需要Python标准库无需安装任何第三方依赖import json import inspect from typing import Dict, List, Callable, Any, Optional这些库分别用于JSON处理、函数 introspection、类型注解等基础功能。2.3 项目结构规划虽然代码只有30行但我们仍然需要清晰的逻辑结构agent_core.py ├── 工具注册与管理 ├── 消息处理循环 ├── 工具调用机制 └── 结果整合返回3. Agent核心原理深度解析3.1 工具调用机制原理工具调用是Agent最核心的功能之一。其工作原理可以概括为工具注册将可用的工具函数注册到Agent中工具选择基于用户请求选择合适的工具参数提取从用户输入中解析工具所需参数执行调用实际执行工具函数结果处理将工具执行结果整合到响应中3.2 消息处理流程Agent的消息处理遵循严格的流程控制用户输入 → 意图识别 → 工具选择 → 参数验证 → 执行工具 → 结果格式化 → 响应输出每个环节都有相应的错误处理和回退机制。3.3 状态管理策略Agent需要维护会话状态来保证连续性。关键状态信息包括当前对话上下文已调用的工具历史用户偏好设置会话元数据4. 30行代码实现Agent核心4.1 完整代码实现下面是完整的30行Agent核心代码class SimpleAgent: def __init__(self): self.tools {} self.messages [] def register_tool(self, func: Callable) - None: 注册工具函数 self.tools[func.__name__] func def process_message(self, user_input: str) - str: 处理用户消息的核心方法 self.messages.append({role: user, content: user_input}) # 工具调用决策 tool_to_use self._decide_tool(user_input) if tool_to_use: result self._call_tool(tool_to_use, user_input) response f工具 {tool_to_use} 执行结果: {result} else: response f收到: {user_input} self.messages.append({role: assistant, content: response}) return response def _decide_tool(self, input_text: str) - Optional[str]: 简单的工具决策逻辑 for tool_name in self.tools: if tool_name in input_text.lower(): return tool_name return None def _call_tool(self, tool_name: str, input_text: str) - Any: 执行工具调用 tool_func self.tools[tool_name] try: return tool_func(input_text) except Exception as e: return f错误: {str(e)} # 示例工具函数 def calculator(query: str) - float: 简单计算器工具 try: # 移除非数学字符安全评估 safe_expr .join(c for c in query if c in 0123456789-*/.() ) return eval(safe_expr) except: return 计算错误 def weather(query: str) - str: 模拟天气查询工具 return 北京: 晴, 25°C if 北京 in query else 上海: 多云, 23°C4.2 代码逐行解析让我们详细分析这30行代码的关键部分第1-5行初始化阶段class SimpleAgent: def __init__(self): self.tools {} # 工具注册表 self.messages [] # 消息历史这里创建了Agent类初始化工具字典和消息列表这是状态管理的基础。第7-9行工具注册def register_tool(self, func: Callable) - None: 注册工具函数 self.tools[func.__name__] func通过函数 introspection 自动获取函数名作为工具标识简化注册流程。第11-21行核心消息处理def process_message(self, user_input: str) - str: self.messages.append({role: user, content: user_input}) tool_to_use self._decide_tool(user_input) if tool_to_use: result self._call_tool(tool_to_use, user_input) response f工具 {tool_to_use} 执行结果: {result} else: response f收到: {user_input} self.messages.append({role: assistant, content: response}) return response这是Agent的核心循环包含完整的消息处理流程。4.3 工具函数实现细节示例工具函数展示了如何安全地实现具体功能计算器工具的安全考虑def calculator(query: str) - float: try: # 安全过滤只保留数学表达式字符 safe_expr .join(c for c in query if c in 0123456789-*/.() ) return eval(safe_expr) except: return 计算错误通过字符白名单机制防止代码注入攻击确保eval函数的安全性。5. 完整运行示例与测试5.1 初始化与工具注册# 创建Agent实例 agent SimpleAgent() # 注册工具 agent.register_tool(calculator) agent.register_tool(weather) print(Agent初始化完成可用工具:, list(agent.tools.keys()))5.2 测试各种场景场景1基础对话response1 agent.process_message(你好今天天气怎么样) print(响应1:, response1) # 输出工具 weather 执行结果: 上海: 多云, 23°C场景2数学计算response2 agent.process_message(请计算 123 456 等于多少) print(响应2:, response2) # 输出工具 calculator 执行结果: 579场景3无工具匹配response3 agent.process_message(讲个笑话吧) print(响应3:, response3) # 输出收到: 讲个笑话吧场景4错误处理response4 agent.process_message(计算 10 / 0) print(响应4:, response4) # 输出工具 calculator 执行结果: 计算错误5.3 查看会话历史print(\n完整会话历史:) for i, msg in enumerate(agent.messages): print(f{i1}. {msg[role]}: {msg[content]})6. 核心机制扩展与优化6.1 增强工具决策逻辑当前的工具决策基于简单关键词匹配可以扩展为更智能的匹配算法def enhanced_decide_tool(self, input_text: str) - Optional[str]: 增强版工具决策逻辑 input_lower input_text.lower() # 为每个工具定义触发关键词 tool_keywords { calculator: [计算, 等于, 加减, 乘除, 算式], weather: [天气, 气温, 温度, 天气预报] } best_tool None max_score 0 for tool_name, keywords in tool_keywords.items(): if tool_name not in self.tools: continue score sum(1 for keyword in keywords if keyword in input_lower) if score max_score: max_score score best_tool tool_name return best_tool if max_score 0 else None6.2 参数解析改进实现更精确的参数提取机制def extract_calculator_params(self, input_text: str) - str: 从文本中提取数学表达式 import re # 匹配数学表达式模式 patterns [ r计算\s*([\d\-*/.()\s]), # 计算 123456 r等于\s*([\d\-*/.()\s]), # 等于 123456 r([\d\-*/.()\s])\s*等于 # 123456 等于 ] for pattern in patterns: match re.search(pattern, input_text) if match: return match.group(1).strip() # 默认返回原文本进行安全过滤 return input_text6.3 添加工具调用验证增强工具调用的安全性和稳定性def safe_call_tool(self, tool_name: str, input_text: str) - Any: 安全的工具调用方法 if tool_name not in self.tools: return f错误: 工具 {tool_name} 未注册 tool_func self.tools[tool_name] # 参数验证 sig inspect.signature(tool_func) params list(sig.parameters.keys()) if len(params) ! 1 or params[0] ! query: return f错误: 工具 {tool_name} 参数格式不正确 try: # 执行调用 result tool_func(input_text) return result except Exception as e: return f工具执行错误: {str(e)}7. 高级特性实现7.1 工具链式调用实现工具之间的协作调用def chained_tool_call(self, input_text: str) - str: 支持工具链式调用 # 识别多个工具需求 tool_sequence self._plan_tool_sequence(input_text) if not tool_sequence: return self.process_message(input_text) results [] current_context input_text for tool_name in tool_sequence: result self._call_tool(tool_name, current_context) results.append(f{tool_name}: {result}) current_context str(result) # 将结果作为下一工具的上下文 return → .join(results)7.2 上下文感知决策基于对话历史进行智能决策def context_aware_decide_tool(self, input_text: str) - Optional[str]: 基于上下文的工具决策 if not self.messages: return self._decide_tool(input_text) # 分析最近几条消息的上下文 recent_context .join([msg[content] for msg in self.messages[-3:]]) full_context recent_context input_text # 基于完整上下文决策 return self._decide_tool(full_context)7.3 工具结果格式化统一工具结果的展示格式def format_tool_result(self, tool_name: str, result: Any) - str: 格式化工具执行结果 formatters { calculator: lambda x: f计算结果: {x}, weather: lambda x: f天气信息: {x}, default: lambda x: f{tool_name} 执行完成: {x} } formatter formatters.get(tool_name, formatters[default]) return formatter(result)8. 性能优化与生产级考虑8.1 工具懒加载机制对于资源密集型工具实现按需加载class LazyTool: def __init__(self, tool_loader: Callable): self._tool_loader tool_loader self._tool None def __call__(self, *args, **kwargs): if self._tool is None: self._tool self._tool_loader() return self._tool(*args, **kwargs) # 使用示例 def heavy_tool_loader(): # 模拟重量级工具初始化 print(初始化重量级工具...) return lambda x: f重量级工具处理: {x} agent.register_tool(LazyTool(heavy_tool_loader))8.2 工具调用缓存避免重复计算提升响应速度from functools import lru_cache class CachedAgent(SimpleAgent): def __init__(self): super().__init__() self._call_cache {} def _call_tool(self, tool_name: str, input_text: str) - Any: # 生成缓存键 cache_key f{tool_name}:{input_text} if cache_key in self._call_cache: return self._call_cache[cache_key] result super()._call_tool(tool_name, input_text) self._call_cache[cache_key] result return result8.3 异步工具调用支持异步工具执行提升并发性能import asyncio class AsyncAgent(SimpleAgent): async def process_message_async(self, user_input: str) - str: 异步处理消息 self.messages.append({role: user, content: user_input}) tool_to_use self._decide_tool(user_input) if tool_to_use: # 异步执行工具调用 result await self._async_call_tool(tool_to_use, user_input) response f工具 {tool_to_use} 执行结果: {result} else: response f收到: {user_input} self.messages.append({role: assistant, content: response}) return response async def _async_call_tool(self, tool_name: str, input_text: str) - Any: 异步工具调用 # 模拟异步操作 await asyncio.sleep(0.1) # 模拟IO等待 return self._call_tool(tool_name, input_text)9. 错误处理与调试技巧9.1 完善的异常处理机制def robust_process_message(self, user_input: str) - str: 带完整异常处理的消息处理 try: # 输入验证 if not user_input or not isinstance(user_input, str): return 错误: 输入必须是非空字符串 if len(user_input) 1000: # 限制输入长度 return 错误: 输入过长请控制在1000字符以内 # 执行处理 return self.process_message(user_input) except Exception as e: error_msg f系统错误: {str(e)} self.messages.append({role: system, content: error_msg}) return 抱歉处理过程中出现错误请稍后重试9.2 调试日志记录添加详细的调试信息记录class DebuggableAgent(SimpleAgent): def __init__(self, debugFalse): super().__init__() self.debug debug self.debug_log [] def process_message(self, user_input: str) - str: if self.debug: self.debug_log.append(f开始处理: {user_input}) tool_decision self._decide_tool(user_input) if self.debug: self.debug_log.append(f工具决策: {tool_decision}) result super().process_message(user_input) if self.debug: self.debug_log.append(f处理完成: {result}) return result def get_debug_info(self) - List[str]: return self.debug_log.copy()9.3 工具健康检查定期检查工具可用性def health_check(self) - Dict[str, bool]: 检查所有注册工具的健康状态 health_status {} for tool_name, tool_func in self.tools.items(): try: # 使用测试输入检查工具 test_result tool_func(test) health_status[tool_name] True except Exception as e: health_status[tool_name] False if self.debug: self.debug_log.append(f工具 {tool_name} 健康检查失败: {e}) return health_status10. 实际应用场景与扩展方向10.1 业务系统集成案例将Agent核心集成到实际业务系统中class BusinessAgent(SimpleAgent): def __init__(self, db_connection, api_client): super().__init__() self.db db_connection self.api_client api_client # 注册业务工具 self.register_tool(self.query_customer_info) self.register_tool(self.place_order) self.register_tool(self.check_inventory) def query_customer_info(self, query: str) - str: 查询客户信息工具 # 实际业务逻辑 customer_id self.extract_customer_id(query) result self.db.execute(SELECT * FROM customers WHERE id ?, (customer_id,)) return f客户信息: {result} def place_order(self, query: str) - str: 下单工具 # 订单处理逻辑 return 订单创建成功 def check_inventory(self, query: str) - str: 库存检查工具 return 库存充足10.2 多模态工具扩展支持图像、文件等多模态工具class MultimodalAgent(SimpleAgent): def register_image_tool(self, tool_func: Callable): 注册图像处理工具 self.tools[fimage_{tool_func.__name__}] tool_func def process_image_message(self, image_data: bytes, text_query: str) - str: 处理包含图像的消息 # 图像分析逻辑 image_analysis self.analyze_image(image_data) combined_query f{text_query} 图像分析: {image_analysis} return self.process_message(combined_query)10.3 分布式Agent系统构建可扩展的分布式Agent架构class DistributedAgent: def __init__(self, agent_nodes: List[SimpleAgent]): self.nodes agent_nodes self.load_balancer RoundRobinBalancer() def process_message(self, user_input: str) - str: # 选择合适的Agent节点 node_index self.load_balancer.get_next_node() selected_node self.nodes[node_index] return selected_node.process_message(user_input)通过这30行核心代码的深入扩展我们构建了一个功能完整、可投入生产的Agent系统。这种从简到繁的学习路径帮助开发者真正理解Agent技术的本质为后续学习更复杂的框架打下坚实基础。本文提供的代码示例可以直接复制使用建议在实际项目中逐步添加更多高级特性。掌握这些核心原理后你将能够更好地理解和优化现有的Agent框架甚至开发自定义的Agent解决方案。
企业数字化 ERP 产品动态
相关推荐
Python在CANFD设备二次开发中的高效实践 1. 为什么选择Python进行CANFD设备二次开发作为一名在工业自动化领域摸爬滚打多年的工程师,我亲历了从传统CAN总线到CANFD的技术演进。当拿到周立功的CANFD200U设备时,第一反应就是:这个高性能工具(支持8Mbps灵活数据速率… · 2026/11/18 23:13:30
Comet双星开发模式:如何通过OpenSpec与Superpowers的融合提升AI开发效率 Comet双星开发模式:如何通过OpenSpec与Superpowers的融合提升AI开发效率 【免费下载链接】frontend-stuff 📝 A continuously expanded list of frameworks, libraries and tools I used/want to use for building things on the web. Mostly JavaScript… · 2026/10/29 22:33:34
Mac系统Python版本升级与多版本管理指南 1. Mac系统Python版本升级全指南 作为长期在Mac环境下开发的Python程序员,我经常遇到项目需要特定Python版本的情况。不同于Windows系统,MacOS自带了Python 2.7(在较新版本中已移除),但系统自带的Python往往无法满足现… · 2026/9/30 13:43:31
兖州高压电工证在哪办?郑州报考避坑指南全解析 兖州高压电工证在哪办?郑州报考避坑指南全解析 你是不是正在找电工工作,但因为没有高压电工证而被拒之门外?急需特种作业证才能上岗找工作,这种焦虑你肯定深有体会。尤其是在兖州这样的工业城市,高压电工证几乎是电工类岗位的“入场券”。可问题是,兖州… · 2026/11/18 23:13:15
特种工几年退休年龄怎么算 电子证书怎么查最靠谱 特种工几年退休年龄怎么算 电子证书怎么查最靠谱 你是不是也遇到过这种情况?去报名特种作业操作证,结果被各种中介忽悠,钱花了证没拿到,还耽误了时间。别急,咱们今天就来聊聊 特种工几年退休年龄 怎么算,以及如何靠谱地查到自己的 电子证书… · 2026/11/18 23:13:15
电工证复审能补贴吗电子证书怎么操作 电工证复审能补贴吗电子证书怎么操作 证书过期了不知道怎么复审延期,很多人在拿到电工证后,只顾着忙着上班,忽略了证书的有效期,等到用的时候才发现证已经过期了,这不仅影响工作,还可能面临罚款甚至被吊销资格。尤其是现在很多单位对 电子证书… · 2026/11/18 23:13:15
特种工安全考试流程图 2026河南最新政策怎么考怎么转 特种工安全考试流程图 2026河南最新政策怎么考怎么转 之前考的证在外省能不能转过来?这几乎是每个想考证或者已经在外地考了证的特种工最关心的问题。尤其是2026年河南最新政策出台后,证件的异地转接、考试流程、报名门槛、考试内容都发生了不小的… · 2026/11/18 23:13:15
开县考电工证的地方多久拿证能转回本地用 开县考电工证的地方多久拿证能转回本地用 之前考的证在外省能不能转过来?这是很多在外地工作的电工朋友最关心的问题。特别是在三门峡从事公路工程的电工师傅,很多都是从其他省份过来的,手上持有的电工证可能是在外地考的,现在想在开县本地干活,又担心证… · 2026/11/18 23:13:15
洛阳架子工特种作业证2026河南最新政策如何考过不白费钱 洛阳架子工特种作业证2026河南最新政策如何考过不白费钱 怕考不过白交培训费,这事儿真不是吹,我见过太多同行因为没搞清流程,花了钱还白忙活。2026河南最新政策一出,不少人开始慌了,特别是洛阳的架子工兄弟们,别急,看完这篇,你就能搞明白怎么… · 2026/11/18 23:12:14
长春初级电工证怎么考?通过率揭秘全在这里 长春初级电工证怎么考?通过率揭秘全在这里 之前考的证在外省能不能转过来?这几乎是每个想从事电工工作的人都会问的问题。特别是那些在外地打拼多年、手里握着一张“外地电工证”的人,到了长春想继续干这一行,第一反应就是“我的证能用吗?”。今天我们就… · 2026/11/18 8:19:55
国内电工证报考条件与考试时间 低压电工证怎么考?学历不高也能报名,官方报名入口全在这 你是不是经常听说“电工证是入行门槛”,但又担心自己学历不够、经验不足,根本报不了名?别急,今天就带你从零了解【国内电工证】的报考流程、考试内容,还有怎么在 官方报名入口… · 2026/11/18 8:19:53
电工作业时如何断电?电子证书到底能不能全国通用? 电工作业时如何断电?电子证书到底能不能全国通用? 实操考试心里没底怕挂科,特别是电工作业时如何断电这一操作,不仅关系到你能不能拿到证书,更关系到以后能不能顺利上岗。很多人觉得这不过就是“断个电”,但其实这里面的门道可不少,稍有不慎就可能出错… · 2026/11/18 14:38:14
电工证做题最新内部消息:怕考不过白交培训费?三招教你稳过 电工证做题最新内部消息:怕考不过白交培训费?三招教你稳过 你是不是也这样?报名了电工证培训,交了钱,结果一到考试就懵, 怕考不过白交培训费 ?别慌,这是很多初次报考人员的真实写照。而最近, 河南省应急管理厅… · 2026/11/18 0:00:37
许昌电工证在哪复审 别踩坑怕考不过白交培训费 许昌电工证在哪复审 别踩坑怕考不过白交培训费 怕考不过白交培训费,这几乎是每个想考电工证的学员心中的痛。尤其是在许昌,电工证的报考和复审流程复杂,稍有不慎就可能被坑, 千万别踩坑… · 2026/11/18 0:00:37
老式电工证还能用吗?怎么报名别踩坑,河南企业主都在问的实操真相 老式电工证还能用吗?怎么报名别踩坑,河南企业主都在问的实操真相 实操考试心里没底怕挂科?老式电工证还能用吗?怎么报名又怕被坑?这些问题几乎每个准备考电工证的施工企业负责人心里都在打鼓。尤其是河南本地的中小施工企业,很多都在用老式电工证,但随… · 2026/11/18 0:00:37
双极步进电机控制实战:DRV8818PWPR与PIC18F86K22驱动调试 /* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/17 21:47:42
STM32F207ZG + DRV8818PWPR 步进电机驱动实战解析 /* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/17 21:47:42
DRV8818PWPR+dsPIC30F4013工业级双极步进电机控制方案 /* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/17 21:47:42