最近在尝试将大模型能力集成到实际业务中时发现单纯依靠大模型的对话能力Chat远远不够。当需要它执行一个复杂任务比如“分析上周销售数据并生成报告然后邮件发送给相关同事”时直接提问往往得到的是笼统的步骤描述而非可执行的动作。这正是Agent智能体和Skill技能要解决的核心问题让大模型不仅能“思考”还能“动手”。本文将从零开始手把手带你构建一个具备实用技能的AI智能体。我们将以“天气查询邮件发送”的连贯任务为例完整拆解从核心概念、环境搭建、工具Tool定义、工作流Workflow编排到多智能体Multi-Agent协作的全过程。无论你是想入门AI应用开发还是希望将现有服务AI化这篇保姆级教程都能提供可直接复现的代码和清晰的架构思路。1. 智能体Agent与技能Skill核心概念解析在深入代码之前我们必须厘清几个容易混淆但至关重要的概念。这决定了我们后续设计的系统是否清晰、可扩展。1.1 什么是智能体Agent你可以将Agent理解为一个“具备自主性的AI程序”。它不仅仅是调用一次API而是一个持续运行的实体其核心能力包括感知Perception接收来自用户、环境或其他Agent的输入指令、数据、事件。规划Planning根据目标拆解任务步骤形成执行计划。行动Action调用具体的工具Tools或技能Skills来执行计划中的步骤。反思Reflection评估行动结果判断目标是否达成必要时调整计划。一个简单的对话机器人只问答不算严格意义上的Agent。一个能根据你“订一张明天北京到上海的最便宜机票”的指令自动去查询航班、比价、填写表单的AI才是一个初级Agent。1.2 技能Skill与工具Tool的关系这是最容易混淆的一对概念很多框架和文章混用它们但理解其差异对设计架构至关重要。工具Tool最底层的原子操作。它是一个具体的、可执行的函数或API接口有明确的输入和输出。例如get_current_weather(location: str) - str 获取天气。send_email(to: str, subject: str, body: str) - bool 发送邮件。query_database(sql: str) - List[Dict] 查询数据库。工具本身不包含“何时使用”、“为何使用”的逻辑它只是功能的封装。技能Skill一个或多个工具的组合并附带了使用这些工具的“逻辑”或“策略”。技能是面向任务的。它告诉Agent“为了完成某个任务Task你应该按什么顺序、在什么条件下、使用哪些工具Tools”。例如“天气报告技能”可能包含1. 调用get_current_weather工具2. 将返回的原始数据格式化成人类可读的报告文本。这个“格式化”的逻辑就是技能的一部分。再如“邮件通知技能”可能包含1. 接收主题和正文2. 调用send_email工具。它可能还包含确定收件人列表的逻辑。简单比喻工具是“锤子”、“锯子”。技能是“制作一把椅子”它需要规划先锯木头用锯子工具再钉接用锤子工具。1.3 工作流Workflow与多智能体Multi-Agent当单个任务变得复杂时我们需要更高层级的抽象来管理。工作流Workflow 定义了多个技能或步骤的执行顺序、分支和循环。它是一个流程图确保任务按照既定流程推进。例如“每日报告生成工作流”1. 触发每天上午9点2. 执行“数据收集技能”3. 执行“数据分析技能”4. 执行“报告生成技能”5. 执行“邮件发送技能”。多智能体Multi-Agent 由多个各司其职的Agent组成的系统。每个Agent专注于某一类任务如“数据查询Agent”、“文案撰写Agent”、“审核Agent”它们通过通信如消息队列、直接调用进行协作共同完成一个宏大目标。Multi-Agent系统更强调Agent间的协作、协商与竞争机制。在我们的实战中将首先构建一个单一智能体它拥有多个技能这些技能由底层工具支撑。然后我们会设计一个简单的工作流来串联这些技能。这构成了一个完整且可扩展的Agent系统基础。2. 环境准备与项目初始化我们选择LangChain和LangGraph作为开发框架因为它们提供了构建Agent和Workflow最直观、最流行的抽象。大模型服务使用OpenAI API也可替换为国内兼容API。2.1 环境与版本说明操作系统 Windows 10/11, macOS 或 Linux (Ubuntu 20.04) 均可。Python版本 3.8。核心库langchain 智能体与链的核心框架。langchain-openai OpenAI模型集成。langchain-community 社区工具集成可选用于一些预设工具。langgraph 用于构建有状态、多步骤的工作流图。python-dotenv 管理环境变量如API密钥。其他工具库用于示例工具requests 模拟天气API调用。smtplibemail 模拟邮件发送。请注意 LangChain版本迭代较快本文代码基于langchain0.1.0,langgraph0.0.50的较新语法编写。如果你的环境存在差异请参考官方文档调整导入方式。2.2 创建项目并安装依赖创建项目目录mkdir ai-agent-tutorial cd ai-agent-tutorial创建虚拟环境强烈推荐python -m venv venv # 激活环境 # Windows: venv\Scripts\activate # macOS/Linux: source venv/bin/activate创建依赖文件requirements.txtlangchain0.1.0 langchain-openai0.0.5 langgraph0.0.50 python-dotenv1.0.0 requests2.31.0smtplib和email是Python标准库无需安装安装依赖pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple准备环境变量 在项目根目录创建.env文件存放你的OpenAI API密钥。# .env OPENAI_API_KEYsk-your-actual-openai-api-key-here重要 请勿将真实的.env文件提交到Git等版本控制系统。应在.gitignore中添加.env。3. 基础构建从工具Tool到技能Skill我们将创建两个基础工具模拟天气查询和模拟邮件发送然后将它们封装成技能。3.1 创建模拟工具在项目根目录创建tools.py文件。# tools.py import json import smtplib from email.mime.text import MIMEText from email.header import Header from typing import Dict, Any import requests class WeatherTool: 模拟天气查询工具 name get_current_weather description 获取指定城市的当前天气信息。输入应为城市名称例如北京。 classmethod def run(cls, location: str) - str: 模拟调用天气API。 在实际应用中这里应替换为真实的天气API调用如和风天气、OpenWeatherMap等。 # 模拟API返回数据 mock_data { location: location, temperature: 22, unit: celsius, condition: 晴朗, humidity: 65, wind_speed: 10 } # 将字典转换为格式化的JSON字符串便于大模型理解和技能后续处理 return json.dumps(mock_data, ensure_asciiFalse, indent2) class EmailTool: 模拟邮件发送工具 name send_email description 发送一封电子邮件。输入应为包含to收件人、subject主题、body正文的JSON字符串。 classmethod def run(cls, to: str, subject: str, body: str) - str: 模拟发送邮件。 在实际应用中需要配置真实的SMTP服务器信息。 # 这里仅模拟发送过程打印日志 print(f[模拟邮件发送]) print(f收件人: {to}) print(f主题: {subject}) print(f正文:\n{body}) print(- * 40) # 模拟成功发送 return json.dumps({status: success, message: f邮件已成功发送至 {to}})关键点解释每个工具类都有明确的name和description。description至关重要它是大模型决定是否以及如何调用该工具的主要依据必须清晰、准确。run方法是工具的执行体参数和返回值应尽量简单、结构化。返回字符串是为了兼容大模型的文本处理方式。当前是模拟实现。在生产环境中WeatherTool.run应发起真实的HTTP请求并处理响应EmailTool.run应配置SMTP并实际发送邮件。3.2 将工具封装为技能Skill技能是增加了业务逻辑的“工具包”。创建skills.py文件。# skills.py import json from tools import WeatherTool, EmailTool class WeatherReportSkill: 天气报告技能获取天气并生成友好报告 name weather_report description 为用户生成一份指定城市的友好天气报告。输入是城市名称。 classmethod def execute(cls, city: str) - str: 执行技能1. 调用工具获取数据2. 格式化数据为报告。 # 1. 调用底层工具 raw_weather_data WeatherTool.run(city) weather_dict json.loads(raw_weather_data) # 2. 技能特有的逻辑格式化报告 report f 【{weather_dict[location]} 天气报告】 当前天气{weather_dict[condition]} 温度{weather_dict[temperature]}°{weather_dict[unit].upper()} 湿度{weather_dict[humidity]}% 风速{weather_dict[wind_speed]} km/h --- 温馨提示天气不错适合外出。 return report class EmailNotificationSkill: 邮件通知技能发送通知邮件 name email_notification description 发送一封通知邮件。需要提供收件人、主题和正文。 classmethod def execute(cls, to: str, subject: str, body: str) - str: 执行技能调用邮件发送工具。 此处可以添加更多逻辑如从数据库获取收件人列表、渲染邮件模板等。 result EmailTool.run(toto, subjectsubject, bodybody) return result技能与工具的区别在此体现WeatherReportSkill不仅调用了WeatherTool还添加了数据格式化和生成温馨提示的逻辑。这是面向用户的、增值的一层。EmailNotificationSkill目前直接代理了工具但预留了添加模板渲染、收件人组管理等逻辑的空间。4. 构建单一智能体Agent现在我们将创建一个能够理解用户意图、并自动选择和执行上述技能的智能体。我们将使用LangChain的create_react_agent范式它基于“Reasoning and Acting (ReAct)”思想。创建single_agent.py文件。# single_agent.py import os from dotenv import load_dotenv from langchain_openai import ChatOpenAI from langchain.agents import create_react_agent, AgentExecutor from langchain.tools import Tool from langchain import hub # 用于拉取预定义的提示词模板 # 导入我们自定义的技能 from skills import WeatherReportSkill, EmailNotificationSkill # 1. 加载环境变量 load_dotenv() # 2. 初始化大语言模型 llm ChatOpenAI( modelgpt-3.5-turbo, # 或 gpt-4 temperature0, # 降低随机性使Agent行为更确定 api_keyos.getenv(OPENAI_API_KEY) ) # 3. 将技能包装成LangChain可识别的Tool对象 # LangChain的Tool需要是一个可调用的对象这里我们用lambda包装技能的execute方法 tools [ Tool( nameWeatherReportSkill.name, funclambda city: WeatherReportSkill.execute(city), descriptionWeatherReportSkill.description ), Tool( nameEmailNotificationSkill.name, funclambda input_str: EmailNotificationSkill.execute(**json.loads(input_str)), descriptionEmailNotificationSkill.description 输入必须是JSON字符串包含to,subject,body三个键。 ), ] # 4. 从LangChain Hub拉取一个优秀的ReAct提示词模板 # 你也可以自定义这个提示词hub里的是经过社区验证的 prompt hub.pull(hwchase17/react) # 5. 创建ReAct Agent agent create_react_agent(llm, tools, prompt) # 6. 创建Agent执行器它负责管理Agent与工具的交互循环 agent_executor AgentExecutor( agentagent, toolstools, verboseTrue, # 开启详细日志方便观察Agent的思考过程 handle_parsing_errorsTrue # 处理解析错误 ) # 7. 测试智能体 if __name__ __main__: print( 测试单一智能体 ) # 测试场景1查询天气 query1 今天北京的天气怎么样 print(f用户: {query1}) result1 agent_executor.invoke({input: query1}) print(f智能体: {result1[output]}\n) # 测试场景2发送邮件注意需要以JSON格式描述请求 query2 请给 aliceexample.com 发送一封邮件主题是“项目会议提醒”正文是“明天的项目会议改到下午3点请准时参加。” print(f用户: {query2}) # 注意我们的工具期望JSON字符串但Agent在ReAct提示词引导下可能会尝试理解自然语言并构造输入。 # 更稳健的做法是定义更严格的工具描述或使用更结构化的输入方式。 result2 agent_executor.invoke({input: query2}) print(f智能体: {result2[output]})运行与观察 在终端执行python single_agent.py。你会看到类似以下的详细输出verboseTrue的效果 测试单一智能体 用户: 今天北京的天气怎么样 Entering new AgentExecutor chain... 我需要找到北京的天气信息。我可以使用天气报告技能。 行动: weather_report 行动输入: 北京 观察: 【北京 天气报告】 当前天气晴朗 温度22°CELSIUS 湿度65% 风速10 km/h --- 温馨提示天气不错适合外出。 思考: 我已经获得了北京的天气报告可以回答用户了。 最终答案: 今天北京天气晴朗温度22摄氏度湿度65%风速10公里/小时。天气不错适合外出。 Finished chain. 智能体: 今天北京天气晴朗温度22摄氏度湿度65%风速10公里/小时。天气不错适合外出。关键点解释ReAct模式 日志清晰展示了Agent的“思考-行动-观察”循环。它先“思考”需要调用哪个工具weather_report然后执行“行动”并得到“观察”结果最后综合信息给出“最终答案”。工具封装 我们将自定义技能包装成了LangChain的Tool对象使其能够被Agent框架识别和调用。提示词工程hub.pull(“hwchase17/react”)拉取了一个预先设计好的、用于ReAct Agent的提示词模板它教导LLM如何按步骤推理和行动。这是Agent能正确工作的关键。5. 编排工作流Workflow与引入状态管理单一Agent可以处理简单指令但复杂任务通常涉及多个步骤且有状态依赖如上一步的输出是下一步的输入。这时就需要工作流引擎。我们将使用LangGraph来构建一个“获取天气并邮件通知”的工作流。创建workflow_agent.py文件。# workflow_agent.py import os from typing import TypedDict, Annotated, Sequence import operator from dotenv import load_dotenv from langchain_openai import ChatOpenAI from langgraph.graph import StateGraph, END from langgraph.graph.message import add_messages from langgraph.prebuilt import ToolExecutor, ToolInvocation from langchain.tools import Tool from langchain_community.tools.tavily_search import TavilySearchResults import json # 导入自定义技能 from skills import WeatherReportSkill, EmailNotificationSkill # 1. 定义工作流的状态State # State是一个共享的内存在不同节点间传递信息 class AgentState(TypedDict): messages: Annotated[Sequence, add_messages] # 消息序列记录对话和结果 city: str # 用户输入的城市 weather_report: str # 生成的天气报告 email_to: str # 收件人邮箱 # 2. 初始化模型和工具 load_dotenv() llm ChatOpenAI(modelgpt-3.5-turbo, temperature0, api_keyos.getenv(OPENAI_API_KEY)) # 定义工作流中可用的工具同样是包装我们的技能 workflow_tools [ Tool( nameWeatherReportSkill.name, funclambda city: WeatherReportSkill.execute(city), descriptionWeatherReportSkill.description ), Tool( nameEmailNotificationSkill.name, funclambda input_str: EmailNotificationSkill.execute(**json.loads(input_str)), descriptionEmailNotificationSkill.description 输入必须是JSON字符串包含to,subject,body三个键。 ), ] tool_executor ToolExecutor(workflow_tools) # 3. 定义工作流的各个节点Node # 节点本质上是处理State的函数 def handle_user_input(state: AgentState): 节点1处理用户初始输入提取参数 # 这里简化处理假设用户消息是“给{aliceexample.com}发送{北京}的天气报告” # 在实际应用中这里可以接入一个NLU模型来解析意图和槽位。 user_input state[“messages”][-1].content # 获取最新用户消息 # 简单解析示例非常脆弱仅用于演示 if “发送” in user_input and “天气” in user_input: # 提取邮箱和城市实际应用请用正则或更可靠的方法 parts user_input.split(“发送”) email_part parts[0].replace(“给”, “”).strip() city_part parts[1].split(“的”)[0].strip() return {“city”: city_part, “email_to”: email_part, “weather_report”: None} else: # 如果无法解析则默认值或进入错误处理节点 return {“city”: “北京”, “email_to”: “adminexample.com”, “weather_report”: None} def generate_weather_report(state: AgentState): 节点2生成天气报告 city state[“city”] report WeatherReportSkill.execute(city) return {“weather_report”: report} def send_weather_email(state: AgentState): 节点3发送包含天气报告的邮件 report state[“weather_report”] to_email state[“email_to”] subject f“【天气简报】{state[‘city’]}的天气情况” body f“您好\n\n这是您请求的天气报告\n\n{report}\n\n祝您有美好的一天” # 调用邮件通知技能 input_json json.dumps({“to”: to_email, “subject”: subject, “body”: body}) result EmailNotificationSkill.execute(**json.loads(input_json)) # 将结果添加到消息历史中 return {“messages”: [{role: “assistant”, “content”: f“已发送天气报告邮件至 {to_email}。邮件发送结果{result}”}]} def route_after_weather(state: AgentState): 路由函数决定生成天气报告后是发送邮件还是结束 # 这里可以根据业务逻辑决定例如检查email_to是否有效 if state.get(“email_to”) and “” in state[“email_to”]: return “send_email” # 前往发送邮件节点 else: return END # 直接结束 # 4. 构建工作流图Graph workflow StateGraph(AgentState) # 添加节点 workflow.add_node(“process_input”, handle_user_input) workflow.add_node(“get_weather”, generate_weather_report) workflow.add_node(“send_email”, send_weather_email) # 设置入口点 workflow.set_entry_point(“process_input”) # 添加边定义执行顺序 workflow.add_edge(“process_input”, “get_weather”) # 从get_weather节点后根据条件路由 workflow.add_conditional_edges( “get_weather”, route_after_weather, { “send_email”: “send_email”, END: END } ) workflow.add_edge(“send_email”, END) # 编译工作流 app workflow.compile() # 5. 运行工作流 if __name__ “__main__”: print(“ 运行工作流获取天气并邮件通知 ”) # 初始化状态 initial_state: AgentState { “messages”: [{“role”: “user”, “content”: “给aliceexample.com发送北京的天气报告”}], “city”: “”, “weather_report”: None, “email_to”: “” } # 执行工作流 final_state app.invoke(initial_state) print(“\n工作流执行完成。最终状态:”) print(f“城市: {final_state[‘city’]}”) print(f“收件人: {final_state[‘email_to’]}”) print(f“天气报告: {final_state[‘weather_report’][:100]}...”) # 打印前100字符 print(f“最后一条消息: {final_state[‘messages’][-1][‘content’]}”)关键点解释状态StateAgentState定义了工作流共享的数据结构。所有节点都读取和写入这个状态。节点Node 每个节点是一个函数负责一项具体工作如解析输入、生成报告、发送邮件。节点之间通过状态传递信息。图GraphStateGraph将节点和边执行顺序组织起来。add_conditional_edges允许实现分支逻辑如判断是否需要发邮件。与单一Agent的区别 这里的工作流是预定义的、确定性强的。用户说“发送A的天气给B”工作流就按固定步骤执行。而之前的单一Agent需要动态规划每一步灵活性高但可能出错。两者适用于不同场景工作流适合流程固定的任务单一Agent适合开放域对话和规划。6. 迈向多智能体Multi-Agent系统当系统复杂度进一步提升单个Agent职责过重时可以拆分为多个协同工作的Agent。例如调度AgentPlanner 理解用户目标将其分解为子任务并分配给其他Agent。执行AgentExecutor 专门负责调用工具执行具体任务如天气查询Agent、邮件发送Agent。审核AgentReviewer 检查执行结果的质量和安全性。Multi-Agent系统的核心是Agent间的通信协议。它们可以通过共享状态如黑板模型、消息队列如RabbitMQ或直接函数调用来协作。LangGraph同样可以用于编排多个Agent之间的交互。下面是一个高度简化的多Agent协作概念示例在同一个LangGraph中定义不同职责的节点# multi_agent_concept.py (概念代码非完整运行) from langgraph.graph import StateGraph, END from typing import TypedDict, List import json class MultiAgentState(TypedDict): user_query: str plan: List[str] # 由Planner生成的计划步骤 current_step: int step_results: dict # 存储每一步的结果 final_answer: str def planner_agent(state: MultiAgentState): 规划Agent分析用户请求生成执行计划 query state[“user_query”] # 这里可以调用一个大模型分析query并生成JSON格式的计划 # 例如{“steps”: [“get_weather”, “format_report”, “send_email”]} plan [“get_weather”, “format_report”, “send_email”] return {“plan”: plan, “current_step”: 0} def router_agent(state: MultiAgentState): 路由Agent根据当前步骤决定下一个执行哪个Agent plan state[“plan”] current_step state[“current_step”] if current_step len(plan): return “synthesizer” # 所有步骤完成进入汇总Agent next_step_name plan[current_step] return next_step_name # 返回下一个执行节点的名称 def weather_agent(state: MultiAgentState): 专属天气Agent # ... 调用天气工具 ... result “晴朗22度” step_results state.get(“step_results”, {}) step_results[“weather”] result return {“step_results”: step_results, “current_step”: state[“current_step”] 1} def synthesizer_agent(state: MultiAgentState): 汇总Agent收集所有结果生成最终回复 results state[“step_results”] final_answer f”根据执行结果天气是{results.get(‘weather’)}, … 生成最终回复。” return {“final_answer”: final_answer} # 构建图 workflow StateGraph(MultiAgentState) workflow.add_node(“planner”, planner_agent) workflow.add_node(“get_weather”, weather_agent) workflow.add_node(“synthesizer”, synthesizer_agent) workflow.set_entry_point(“planner”) # 设置动态路由planner之后由router决定下一步 workflow.add_conditional_edges(“planner”, router_agent, {“get_weather”: “get_weather”, …}) workflow.add_conditional_edges(“get_weather”, router_agent, {“synthesizer”: “synthesizer”, …}) workflow.add_edge(“synthesizer”, END)这个架构更复杂但带来了更好的模块化、可维护性和能力复用一个训练有素的邮件Agent可以被多个工作流使用。7. 常见问题、排查与优化实践在实际开发中你会遇到各种问题。以下是一些典型场景及解决思路。7.1 Agent不调用工具或调用错误工具问题现象 Agent直接用自己的知识回答或者说“我没有这个功能”而不去调用你定义的工具。可能原因与解决工具描述description不清晰 这是最常见的原因。描述必须精确说明工具的用途、输入格式和输出。使用关键词例如“获取天气”、“查询”、“搜索”。提示词Prompt不合适 ReAct提示词模板如hwchase17/react通常工作良好。如果自定义提示词务必明确指示LLM“你可以使用以下工具”并列出工具描述。模型能力不足gpt-3.5-turbo在复杂工具调用上可能不如gpt-4。如果关键业务场景考虑升级模型。工具名称name歧义 工具名应简洁且唯一避免与常见词汇冲突。7.2 工具调用参数解析错误问题现象 Agent决定调用工具但传入的参数格式错误如不是JSON字符串导致工具执行失败。可能原因与解决在工具描述中明确输入格式 如“输入必须是一个城市名称字符串”或“输入必须是包含’city’键的JSON对象”。使用Pydantic工具 LangChain提供了tool装饰器可以基于Python函数和类型注解自动生成更规范的描述能显著提升参数解析准确率。from langchain.tools import tool tool def get_weather(city: str) - str: “”“获取指定城市的天气。”“” # … 实现 …在后置处理中验证和清洗 在工具的run方法或技能的execute方法开头对输入参数进行校验和类型转换。7.3 工作流状态管理混乱问题现象 在多步骤工作流中数据传递丢失或状态被意外覆盖。最佳实践设计清晰的状态模式 像示例中一样使用TypedDict明确定义状态结构。确保每个节点只读写它负责的部分。保持节点函数纯净 节点函数应仅依赖于输入状态和传入参数避免使用全局变量以保证可预测性和可测试性。利用LangGraph的检查点Checkpoint功能 对于长周期工作流可以利用Checkpoint实现持久化和恢复避免进程重启导致状态丢失。7.4 性能与成本优化控制LLM调用次数 Agent的每一步“思考”都可能调用一次LLM成本高昂。优化提示词 让Agent的思考更精准减少无效轮次。设置最大迭代次数 在AgentExecutor中设置max_iterations参数防止陷入死循环。对简单任务使用预定义工作流 如果能用确定性的工作流解决就不要用需要动态规划的通用Agent。异步执行 对于IO密集型工具如网络请求使用异步版本async/await或LangChain的异步API来提升并发性能。缓存 对结果变化不频繁的工具调用如天气查询可缓存几分钟使用LangChain的Cache组件或外部缓存如Redis来减少重复调用和成本。8. 生产环境工程化建议要将原型转化为可用的生产服务还需考虑以下方面配置管理 将API密钥、模型参数、工具端点等配置外置使用环境变量或配置中心如Apollo管理。日志与监控 记录详细的运行日志包括Agent的思考过程、工具调用输入输出、耗时、错误信息。集成监控告警如Prometheus, Sentry。错误处理与重试 为工具调用和LLM调用添加完善的错误处理网络超时、API限流、无效响应和指数退避重试机制。安全性工具权限 不是所有Agent都应能调用所有工具。实现基于角色或上下文的工具权限控制。输入输出过滤 对用户输入和工具返回内容进行安全检查防止Prompt注入、敏感信息泄露。访问控制 对Agent服务API本身实施认证和鉴权。可测试性 为每个工具、技能、Agent节点编写单元测试。使用Mock对象模拟LLM和外部API调用确保核心逻辑正确。版本化 对工具、技能、Agent定义、工作流图进行版本控制。便于回滚和灰度发布。构建AI Agent系统是一个迭代过程。从定义一个清晰的工具开始逐步组合成技能用单一Agent验证可行性再用工作流固化成功流程最终在复杂场景中探索多智能体协作。
最近在尝试将大模型能力集成到实际业务中时发现单纯依靠大模型的对话能力Chat远远不够。当需要它执行一个复杂任务比如“分析上周销售数据并生成报告然后邮件发送给相关同事”时直接提问往往得到的是笼统的步骤描述而非可执行的动作。这正是Agent智能体和Skill技能要解决的核心问题让大模型不仅能“思考”还能“动手”。本文将从零开始手把手带你构建一个具备实用技能的AI智能体。我们将以“天气查询邮件发送”的连贯任务为例完整拆解从核心概念、环境搭建、工具Tool定义、工作流Workflow编排到多智能体Multi-Agent协作的全过程。无论你是想入门AI应用开发还是希望将现有服务AI化这篇保姆级教程都能提供可直接复现的代码和清晰的架构思路。1. 智能体Agent与技能Skill核心概念解析在深入代码之前我们必须厘清几个容易混淆但至关重要的概念。这决定了我们后续设计的系统是否清晰、可扩展。1.1 什么是智能体Agent你可以将Agent理解为一个“具备自主性的AI程序”。它不仅仅是调用一次API而是一个持续运行的实体其核心能力包括感知Perception接收来自用户、环境或其他Agent的输入指令、数据、事件。规划Planning根据目标拆解任务步骤形成执行计划。行动Action调用具体的工具Tools或技能Skills来执行计划中的步骤。反思Reflection评估行动结果判断目标是否达成必要时调整计划。一个简单的对话机器人只问答不算严格意义上的Agent。一个能根据你“订一张明天北京到上海的最便宜机票”的指令自动去查询航班、比价、填写表单的AI才是一个初级Agent。1.2 技能Skill与工具Tool的关系这是最容易混淆的一对概念很多框架和文章混用它们但理解其差异对设计架构至关重要。工具Tool最底层的原子操作。它是一个具体的、可执行的函数或API接口有明确的输入和输出。例如get_current_weather(location: str) - str 获取天气。send_email(to: str, subject: str, body: str) - bool 发送邮件。query_database(sql: str) - List[Dict] 查询数据库。工具本身不包含“何时使用”、“为何使用”的逻辑它只是功能的封装。技能Skill一个或多个工具的组合并附带了使用这些工具的“逻辑”或“策略”。技能是面向任务的。它告诉Agent“为了完成某个任务Task你应该按什么顺序、在什么条件下、使用哪些工具Tools”。例如“天气报告技能”可能包含1. 调用get_current_weather工具2. 将返回的原始数据格式化成人类可读的报告文本。这个“格式化”的逻辑就是技能的一部分。再如“邮件通知技能”可能包含1. 接收主题和正文2. 调用send_email工具。它可能还包含确定收件人列表的逻辑。简单比喻工具是“锤子”、“锯子”。技能是“制作一把椅子”它需要规划先锯木头用锯子工具再钉接用锤子工具。1.3 工作流Workflow与多智能体Multi-Agent当单个任务变得复杂时我们需要更高层级的抽象来管理。工作流Workflow 定义了多个技能或步骤的执行顺序、分支和循环。它是一个流程图确保任务按照既定流程推进。例如“每日报告生成工作流”1. 触发每天上午9点2. 执行“数据收集技能”3. 执行“数据分析技能”4. 执行“报告生成技能”5. 执行“邮件发送技能”。多智能体Multi-Agent 由多个各司其职的Agent组成的系统。每个Agent专注于某一类任务如“数据查询Agent”、“文案撰写Agent”、“审核Agent”它们通过通信如消息队列、直接调用进行协作共同完成一个宏大目标。Multi-Agent系统更强调Agent间的协作、协商与竞争机制。在我们的实战中将首先构建一个单一智能体它拥有多个技能这些技能由底层工具支撑。然后我们会设计一个简单的工作流来串联这些技能。这构成了一个完整且可扩展的Agent系统基础。2. 环境准备与项目初始化我们选择LangChain和LangGraph作为开发框架因为它们提供了构建Agent和Workflow最直观、最流行的抽象。大模型服务使用OpenAI API也可替换为国内兼容API。2.1 环境与版本说明操作系统 Windows 10/11, macOS 或 Linux (Ubuntu 20.04) 均可。Python版本 3.8。核心库langchain 智能体与链的核心框架。langchain-openai OpenAI模型集成。langchain-community 社区工具集成可选用于一些预设工具。langgraph 用于构建有状态、多步骤的工作流图。python-dotenv 管理环境变量如API密钥。其他工具库用于示例工具requests 模拟天气API调用。smtplibemail 模拟邮件发送。请注意 LangChain版本迭代较快本文代码基于langchain0.1.0,langgraph0.0.50的较新语法编写。如果你的环境存在差异请参考官方文档调整导入方式。2.2 创建项目并安装依赖创建项目目录mkdir ai-agent-tutorial cd ai-agent-tutorial创建虚拟环境强烈推荐python -m venv venv # 激活环境 # Windows: venv\Scripts\activate # macOS/Linux: source venv/bin/activate创建依赖文件requirements.txtlangchain0.1.0 langchain-openai0.0.5 langgraph0.0.50 python-dotenv1.0.0 requests2.31.0smtplib和email是Python标准库无需安装安装依赖pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple准备环境变量 在项目根目录创建.env文件存放你的OpenAI API密钥。# .env OPENAI_API_KEYsk-your-actual-openai-api-key-here重要 请勿将真实的.env文件提交到Git等版本控制系统。应在.gitignore中添加.env。3. 基础构建从工具Tool到技能Skill我们将创建两个基础工具模拟天气查询和模拟邮件发送然后将它们封装成技能。3.1 创建模拟工具在项目根目录创建tools.py文件。# tools.py import json import smtplib from email.mime.text import MIMEText from email.header import Header from typing import Dict, Any import requests class WeatherTool: 模拟天气查询工具 name get_current_weather description 获取指定城市的当前天气信息。输入应为城市名称例如北京。 classmethod def run(cls, location: str) - str: 模拟调用天气API。 在实际应用中这里应替换为真实的天气API调用如和风天气、OpenWeatherMap等。 # 模拟API返回数据 mock_data { location: location, temperature: 22, unit: celsius, condition: 晴朗, humidity: 65, wind_speed: 10 } # 将字典转换为格式化的JSON字符串便于大模型理解和技能后续处理 return json.dumps(mock_data, ensure_asciiFalse, indent2) class EmailTool: 模拟邮件发送工具 name send_email description 发送一封电子邮件。输入应为包含to收件人、subject主题、body正文的JSON字符串。 classmethod def run(cls, to: str, subject: str, body: str) - str: 模拟发送邮件。 在实际应用中需要配置真实的SMTP服务器信息。 # 这里仅模拟发送过程打印日志 print(f[模拟邮件发送]) print(f收件人: {to}) print(f主题: {subject}) print(f正文:\n{body}) print(- * 40) # 模拟成功发送 return json.dumps({status: success, message: f邮件已成功发送至 {to}})关键点解释每个工具类都有明确的name和description。description至关重要它是大模型决定是否以及如何调用该工具的主要依据必须清晰、准确。run方法是工具的执行体参数和返回值应尽量简单、结构化。返回字符串是为了兼容大模型的文本处理方式。当前是模拟实现。在生产环境中WeatherTool.run应发起真实的HTTP请求并处理响应EmailTool.run应配置SMTP并实际发送邮件。3.2 将工具封装为技能Skill技能是增加了业务逻辑的“工具包”。创建skills.py文件。# skills.py import json from tools import WeatherTool, EmailTool class WeatherReportSkill: 天气报告技能获取天气并生成友好报告 name weather_report description 为用户生成一份指定城市的友好天气报告。输入是城市名称。 classmethod def execute(cls, city: str) - str: 执行技能1. 调用工具获取数据2. 格式化数据为报告。 # 1. 调用底层工具 raw_weather_data WeatherTool.run(city) weather_dict json.loads(raw_weather_data) # 2. 技能特有的逻辑格式化报告 report f 【{weather_dict[location]} 天气报告】 当前天气{weather_dict[condition]} 温度{weather_dict[temperature]}°{weather_dict[unit].upper()} 湿度{weather_dict[humidity]}% 风速{weather_dict[wind_speed]} km/h --- 温馨提示天气不错适合外出。 return report class EmailNotificationSkill: 邮件通知技能发送通知邮件 name email_notification description 发送一封通知邮件。需要提供收件人、主题和正文。 classmethod def execute(cls, to: str, subject: str, body: str) - str: 执行技能调用邮件发送工具。 此处可以添加更多逻辑如从数据库获取收件人列表、渲染邮件模板等。 result EmailTool.run(toto, subjectsubject, bodybody) return result技能与工具的区别在此体现WeatherReportSkill不仅调用了WeatherTool还添加了数据格式化和生成温馨提示的逻辑。这是面向用户的、增值的一层。EmailNotificationSkill目前直接代理了工具但预留了添加模板渲染、收件人组管理等逻辑的空间。4. 构建单一智能体Agent现在我们将创建一个能够理解用户意图、并自动选择和执行上述技能的智能体。我们将使用LangChain的create_react_agent范式它基于“Reasoning and Acting (ReAct)”思想。创建single_agent.py文件。# single_agent.py import os from dotenv import load_dotenv from langchain_openai import ChatOpenAI from langchain.agents import create_react_agent, AgentExecutor from langchain.tools import Tool from langchain import hub # 用于拉取预定义的提示词模板 # 导入我们自定义的技能 from skills import WeatherReportSkill, EmailNotificationSkill # 1. 加载环境变量 load_dotenv() # 2. 初始化大语言模型 llm ChatOpenAI( modelgpt-3.5-turbo, # 或 gpt-4 temperature0, # 降低随机性使Agent行为更确定 api_keyos.getenv(OPENAI_API_KEY) ) # 3. 将技能包装成LangChain可识别的Tool对象 # LangChain的Tool需要是一个可调用的对象这里我们用lambda包装技能的execute方法 tools [ Tool( nameWeatherReportSkill.name, funclambda city: WeatherReportSkill.execute(city), descriptionWeatherReportSkill.description ), Tool( nameEmailNotificationSkill.name, funclambda input_str: EmailNotificationSkill.execute(**json.loads(input_str)), descriptionEmailNotificationSkill.description 输入必须是JSON字符串包含to,subject,body三个键。 ), ] # 4. 从LangChain Hub拉取一个优秀的ReAct提示词模板 # 你也可以自定义这个提示词hub里的是经过社区验证的 prompt hub.pull(hwchase17/react) # 5. 创建ReAct Agent agent create_react_agent(llm, tools, prompt) # 6. 创建Agent执行器它负责管理Agent与工具的交互循环 agent_executor AgentExecutor( agentagent, toolstools, verboseTrue, # 开启详细日志方便观察Agent的思考过程 handle_parsing_errorsTrue # 处理解析错误 ) # 7. 测试智能体 if __name__ __main__: print( 测试单一智能体 ) # 测试场景1查询天气 query1 今天北京的天气怎么样 print(f用户: {query1}) result1 agent_executor.invoke({input: query1}) print(f智能体: {result1[output]}\n) # 测试场景2发送邮件注意需要以JSON格式描述请求 query2 请给 aliceexample.com 发送一封邮件主题是“项目会议提醒”正文是“明天的项目会议改到下午3点请准时参加。” print(f用户: {query2}) # 注意我们的工具期望JSON字符串但Agent在ReAct提示词引导下可能会尝试理解自然语言并构造输入。 # 更稳健的做法是定义更严格的工具描述或使用更结构化的输入方式。 result2 agent_executor.invoke({input: query2}) print(f智能体: {result2[output]})运行与观察 在终端执行python single_agent.py。你会看到类似以下的详细输出verboseTrue的效果 测试单一智能体 用户: 今天北京的天气怎么样 Entering new AgentExecutor chain... 我需要找到北京的天气信息。我可以使用天气报告技能。 行动: weather_report 行动输入: 北京 观察: 【北京 天气报告】 当前天气晴朗 温度22°CELSIUS 湿度65% 风速10 km/h --- 温馨提示天气不错适合外出。 思考: 我已经获得了北京的天气报告可以回答用户了。 最终答案: 今天北京天气晴朗温度22摄氏度湿度65%风速10公里/小时。天气不错适合外出。 Finished chain. 智能体: 今天北京天气晴朗温度22摄氏度湿度65%风速10公里/小时。天气不错适合外出。关键点解释ReAct模式 日志清晰展示了Agent的“思考-行动-观察”循环。它先“思考”需要调用哪个工具weather_report然后执行“行动”并得到“观察”结果最后综合信息给出“最终答案”。工具封装 我们将自定义技能包装成了LangChain的Tool对象使其能够被Agent框架识别和调用。提示词工程hub.pull(“hwchase17/react”)拉取了一个预先设计好的、用于ReAct Agent的提示词模板它教导LLM如何按步骤推理和行动。这是Agent能正确工作的关键。5. 编排工作流Workflow与引入状态管理单一Agent可以处理简单指令但复杂任务通常涉及多个步骤且有状态依赖如上一步的输出是下一步的输入。这时就需要工作流引擎。我们将使用LangGraph来构建一个“获取天气并邮件通知”的工作流。创建workflow_agent.py文件。# workflow_agent.py import os from typing import TypedDict, Annotated, Sequence import operator from dotenv import load_dotenv from langchain_openai import ChatOpenAI from langgraph.graph import StateGraph, END from langgraph.graph.message import add_messages from langgraph.prebuilt import ToolExecutor, ToolInvocation from langchain.tools import Tool from langchain_community.tools.tavily_search import TavilySearchResults import json # 导入自定义技能 from skills import WeatherReportSkill, EmailNotificationSkill # 1. 定义工作流的状态State # State是一个共享的内存在不同节点间传递信息 class AgentState(TypedDict): messages: Annotated[Sequence, add_messages] # 消息序列记录对话和结果 city: str # 用户输入的城市 weather_report: str # 生成的天气报告 email_to: str # 收件人邮箱 # 2. 初始化模型和工具 load_dotenv() llm ChatOpenAI(modelgpt-3.5-turbo, temperature0, api_keyos.getenv(OPENAI_API_KEY)) # 定义工作流中可用的工具同样是包装我们的技能 workflow_tools [ Tool( nameWeatherReportSkill.name, funclambda city: WeatherReportSkill.execute(city), descriptionWeatherReportSkill.description ), Tool( nameEmailNotificationSkill.name, funclambda input_str: EmailNotificationSkill.execute(**json.loads(input_str)), descriptionEmailNotificationSkill.description 输入必须是JSON字符串包含to,subject,body三个键。 ), ] tool_executor ToolExecutor(workflow_tools) # 3. 定义工作流的各个节点Node # 节点本质上是处理State的函数 def handle_user_input(state: AgentState): 节点1处理用户初始输入提取参数 # 这里简化处理假设用户消息是“给{aliceexample.com}发送{北京}的天气报告” # 在实际应用中这里可以接入一个NLU模型来解析意图和槽位。 user_input state[“messages”][-1].content # 获取最新用户消息 # 简单解析示例非常脆弱仅用于演示 if “发送” in user_input and “天气” in user_input: # 提取邮箱和城市实际应用请用正则或更可靠的方法 parts user_input.split(“发送”) email_part parts[0].replace(“给”, “”).strip() city_part parts[1].split(“的”)[0].strip() return {“city”: city_part, “email_to”: email_part, “weather_report”: None} else: # 如果无法解析则默认值或进入错误处理节点 return {“city”: “北京”, “email_to”: “adminexample.com”, “weather_report”: None} def generate_weather_report(state: AgentState): 节点2生成天气报告 city state[“city”] report WeatherReportSkill.execute(city) return {“weather_report”: report} def send_weather_email(state: AgentState): 节点3发送包含天气报告的邮件 report state[“weather_report”] to_email state[“email_to”] subject f“【天气简报】{state[‘city’]}的天气情况” body f“您好\n\n这是您请求的天气报告\n\n{report}\n\n祝您有美好的一天” # 调用邮件通知技能 input_json json.dumps({“to”: to_email, “subject”: subject, “body”: body}) result EmailNotificationSkill.execute(**json.loads(input_json)) # 将结果添加到消息历史中 return {“messages”: [{role: “assistant”, “content”: f“已发送天气报告邮件至 {to_email}。邮件发送结果{result}”}]} def route_after_weather(state: AgentState): 路由函数决定生成天气报告后是发送邮件还是结束 # 这里可以根据业务逻辑决定例如检查email_to是否有效 if state.get(“email_to”) and “” in state[“email_to”]: return “send_email” # 前往发送邮件节点 else: return END # 直接结束 # 4. 构建工作流图Graph workflow StateGraph(AgentState) # 添加节点 workflow.add_node(“process_input”, handle_user_input) workflow.add_node(“get_weather”, generate_weather_report) workflow.add_node(“send_email”, send_weather_email) # 设置入口点 workflow.set_entry_point(“process_input”) # 添加边定义执行顺序 workflow.add_edge(“process_input”, “get_weather”) # 从get_weather节点后根据条件路由 workflow.add_conditional_edges( “get_weather”, route_after_weather, { “send_email”: “send_email”, END: END } ) workflow.add_edge(“send_email”, END) # 编译工作流 app workflow.compile() # 5. 运行工作流 if __name__ “__main__”: print(“ 运行工作流获取天气并邮件通知 ”) # 初始化状态 initial_state: AgentState { “messages”: [{“role”: “user”, “content”: “给aliceexample.com发送北京的天气报告”}], “city”: “”, “weather_report”: None, “email_to”: “” } # 执行工作流 final_state app.invoke(initial_state) print(“\n工作流执行完成。最终状态:”) print(f“城市: {final_state[‘city’]}”) print(f“收件人: {final_state[‘email_to’]}”) print(f“天气报告: {final_state[‘weather_report’][:100]}...”) # 打印前100字符 print(f“最后一条消息: {final_state[‘messages’][-1][‘content’]}”)关键点解释状态StateAgentState定义了工作流共享的数据结构。所有节点都读取和写入这个状态。节点Node 每个节点是一个函数负责一项具体工作如解析输入、生成报告、发送邮件。节点之间通过状态传递信息。图GraphStateGraph将节点和边执行顺序组织起来。add_conditional_edges允许实现分支逻辑如判断是否需要发邮件。与单一Agent的区别 这里的工作流是预定义的、确定性强的。用户说“发送A的天气给B”工作流就按固定步骤执行。而之前的单一Agent需要动态规划每一步灵活性高但可能出错。两者适用于不同场景工作流适合流程固定的任务单一Agent适合开放域对话和规划。6. 迈向多智能体Multi-Agent系统当系统复杂度进一步提升单个Agent职责过重时可以拆分为多个协同工作的Agent。例如调度AgentPlanner 理解用户目标将其分解为子任务并分配给其他Agent。执行AgentExecutor 专门负责调用工具执行具体任务如天气查询Agent、邮件发送Agent。审核AgentReviewer 检查执行结果的质量和安全性。Multi-Agent系统的核心是Agent间的通信协议。它们可以通过共享状态如黑板模型、消息队列如RabbitMQ或直接函数调用来协作。LangGraph同样可以用于编排多个Agent之间的交互。下面是一个高度简化的多Agent协作概念示例在同一个LangGraph中定义不同职责的节点# multi_agent_concept.py (概念代码非完整运行) from langgraph.graph import StateGraph, END from typing import TypedDict, List import json class MultiAgentState(TypedDict): user_query: str plan: List[str] # 由Planner生成的计划步骤 current_step: int step_results: dict # 存储每一步的结果 final_answer: str def planner_agent(state: MultiAgentState): 规划Agent分析用户请求生成执行计划 query state[“user_query”] # 这里可以调用一个大模型分析query并生成JSON格式的计划 # 例如{“steps”: [“get_weather”, “format_report”, “send_email”]} plan [“get_weather”, “format_report”, “send_email”] return {“plan”: plan, “current_step”: 0} def router_agent(state: MultiAgentState): 路由Agent根据当前步骤决定下一个执行哪个Agent plan state[“plan”] current_step state[“current_step”] if current_step len(plan): return “synthesizer” # 所有步骤完成进入汇总Agent next_step_name plan[current_step] return next_step_name # 返回下一个执行节点的名称 def weather_agent(state: MultiAgentState): 专属天气Agent # ... 调用天气工具 ... result “晴朗22度” step_results state.get(“step_results”, {}) step_results[“weather”] result return {“step_results”: step_results, “current_step”: state[“current_step”] 1} def synthesizer_agent(state: MultiAgentState): 汇总Agent收集所有结果生成最终回复 results state[“step_results”] final_answer f”根据执行结果天气是{results.get(‘weather’)}, … 生成最终回复。” return {“final_answer”: final_answer} # 构建图 workflow StateGraph(MultiAgentState) workflow.add_node(“planner”, planner_agent) workflow.add_node(“get_weather”, weather_agent) workflow.add_node(“synthesizer”, synthesizer_agent) workflow.set_entry_point(“planner”) # 设置动态路由planner之后由router决定下一步 workflow.add_conditional_edges(“planner”, router_agent, {“get_weather”: “get_weather”, …}) workflow.add_conditional_edges(“get_weather”, router_agent, {“synthesizer”: “synthesizer”, …}) workflow.add_edge(“synthesizer”, END)这个架构更复杂但带来了更好的模块化、可维护性和能力复用一个训练有素的邮件Agent可以被多个工作流使用。7. 常见问题、排查与优化实践在实际开发中你会遇到各种问题。以下是一些典型场景及解决思路。7.1 Agent不调用工具或调用错误工具问题现象 Agent直接用自己的知识回答或者说“我没有这个功能”而不去调用你定义的工具。可能原因与解决工具描述description不清晰 这是最常见的原因。描述必须精确说明工具的用途、输入格式和输出。使用关键词例如“获取天气”、“查询”、“搜索”。提示词Prompt不合适 ReAct提示词模板如hwchase17/react通常工作良好。如果自定义提示词务必明确指示LLM“你可以使用以下工具”并列出工具描述。模型能力不足gpt-3.5-turbo在复杂工具调用上可能不如gpt-4。如果关键业务场景考虑升级模型。工具名称name歧义 工具名应简洁且唯一避免与常见词汇冲突。7.2 工具调用参数解析错误问题现象 Agent决定调用工具但传入的参数格式错误如不是JSON字符串导致工具执行失败。可能原因与解决在工具描述中明确输入格式 如“输入必须是一个城市名称字符串”或“输入必须是包含’city’键的JSON对象”。使用Pydantic工具 LangChain提供了tool装饰器可以基于Python函数和类型注解自动生成更规范的描述能显著提升参数解析准确率。from langchain.tools import tool tool def get_weather(city: str) - str: “”“获取指定城市的天气。”“” # … 实现 …在后置处理中验证和清洗 在工具的run方法或技能的execute方法开头对输入参数进行校验和类型转换。7.3 工作流状态管理混乱问题现象 在多步骤工作流中数据传递丢失或状态被意外覆盖。最佳实践设计清晰的状态模式 像示例中一样使用TypedDict明确定义状态结构。确保每个节点只读写它负责的部分。保持节点函数纯净 节点函数应仅依赖于输入状态和传入参数避免使用全局变量以保证可预测性和可测试性。利用LangGraph的检查点Checkpoint功能 对于长周期工作流可以利用Checkpoint实现持久化和恢复避免进程重启导致状态丢失。7.4 性能与成本优化控制LLM调用次数 Agent的每一步“思考”都可能调用一次LLM成本高昂。优化提示词 让Agent的思考更精准减少无效轮次。设置最大迭代次数 在AgentExecutor中设置max_iterations参数防止陷入死循环。对简单任务使用预定义工作流 如果能用确定性的工作流解决就不要用需要动态规划的通用Agent。异步执行 对于IO密集型工具如网络请求使用异步版本async/await或LangChain的异步API来提升并发性能。缓存 对结果变化不频繁的工具调用如天气查询可缓存几分钟使用LangChain的Cache组件或外部缓存如Redis来减少重复调用和成本。8. 生产环境工程化建议要将原型转化为可用的生产服务还需考虑以下方面配置管理 将API密钥、模型参数、工具端点等配置外置使用环境变量或配置中心如Apollo管理。日志与监控 记录详细的运行日志包括Agent的思考过程、工具调用输入输出、耗时、错误信息。集成监控告警如Prometheus, Sentry。错误处理与重试 为工具调用和LLM调用添加完善的错误处理网络超时、API限流、无效响应和指数退避重试机制。安全性工具权限 不是所有Agent都应能调用所有工具。实现基于角色或上下文的工具权限控制。输入输出过滤 对用户输入和工具返回内容进行安全检查防止Prompt注入、敏感信息泄露。访问控制 对Agent服务API本身实施认证和鉴权。可测试性 为每个工具、技能、Agent节点编写单元测试。使用Mock对象模拟LLM和外部API调用确保核心逻辑正确。版本化 对工具、技能、Agent定义、工作流图进行版本控制。便于回滚和灰度发布。构建AI Agent系统是一个迭代过程。从定义一个清晰的工具开始逐步组合成技能用单一Agent验证可行性再用工作流固化成功流程最终在复杂场景中探索多智能体协作。
