1. 先搞清楚 LangChain Agent、MCP 和 Skills 到底能幫你解決什么如果你正在用 Claude、GPT 這類大模型但總覺得它們像個“萬事通萬事松”——什么都知道一點(diǎn)但一到具體操作比如查數(shù)據(jù)庫、調(diào) API、操作本地文件就只會說“我無法直接操作”那你現(xiàn)在遇到的問題LangChain Agent 加上 MCP 和 Skills 這套組合就是目前最主流的工程化解決方案。簡單來說它的核心價值是讓大模型從一個“聊天顧問”變成一個能真正“動手執(zhí)行”的智能助手。你不再需要手動復(fù)制模型輸出的代碼或命令去執(zhí)行而是告訴 Agent 你的目標(biāo)它就能自主規(guī)劃、調(diào)用工具Skills、完成任務(wù)并把最終結(jié)果返回給你。這里涉及三個關(guān)鍵角色LangChain Agent 你可以把它理解為一個“大腦”或“調(diào)度中心”。它負(fù)責(zé)理解你的指令比如“幫我分析一下上個月的銷售數(shù)據(jù)”然后決定先做什么、后做什么調(diào)用哪個工具并解析工具返回的結(jié)果。MCP 全稱是 Model Context Protocol你可以把它看作一套“工具接入標(biāo)準(zhǔn)”或“通信協(xié)議”。它定義了工具Skills如何以一種統(tǒng)一、標(biāo)準(zhǔn)化的方式把自己“能干什么”、“需要什么參數(shù)”告訴給 Agent。有了 MCPAgent 就能動態(tài)發(fā)現(xiàn)和調(diào)用各種工具而無需為每個工具寫死代碼。Skills 這就是具體的“工具”或“技能”。一個 Skill 就是一個具體的能力比如“讀取數(shù)據(jù)庫”、“發(fā)送郵件”、“查詢天氣”、“操作 Excel 文件”。通過 MCP 協(xié)議這些 Skills 被封裝成 Agent 可以理解和調(diào)用的格式。所以當(dāng)有人討論“Claude 接入 Skills”、“Agent 開發(fā)”時他們本質(zhì)上是在做同一件事構(gòu)建一個能自動使用外部工具的大模型應(yīng)用。這對于需要將 AI 能力嵌入到具體工作流如數(shù)據(jù)分析、自動化辦公、智能客服的場景來說是效率提升的關(guān)鍵。2. 環(huán)境準(zhǔn)備與核心依賴別在第一步就卡住在開始寫代碼之前先把環(huán)境理順。很多“跑不起來”的問題都出在環(huán)境配置和依賴版本上。這里我按實際落地的順序帶你過一遍。2.1 基礎(chǔ) Python 環(huán)境與關(guān)鍵包首先你需要一個 Python 環(huán)境建議 3.8 以上。我強(qiáng)烈建議使用虛擬環(huán)境venv或conda來隔離項目依賴。核心的 Python 包主要有以下幾個pip install langchain langchain-communitylangchain是核心框架langchain-community包含了大量社區(qū)貢獻(xiàn)的工具、集成和工具。版本注意LangChain 迭代很快API 可能有變動。如果遇到某些類或函數(shù)找不到第一反應(yīng)是去查對應(yīng)版本的官方文檔而不是盲目搜索。這是新手最容易踩的坑。2.2 大模型 API 密鑰Agent 的“大腦”需要一個大模型來驅(qū)動。你需要準(zhǔn)備一個 LLM 提供商的 API Key。OpenAI / Azure OpenAI 最常用生態(tài)最成熟。你需要OPENAI_API_KEY。Anthropic Claude 在長上下文和復(fù)雜指令遵循上表現(xiàn)很好。你需要ANTHROPIC_API_KEY。其他如DeepSeek、智譜、月之暗面等國內(nèi)外的模型只要 LangChain 支持都可以。將 API Key 設(shè)置為環(huán)境變量這是最安全、最方便的做法# Linux/macOS export OPENAI_API_KEYyour-api-key-here # Windows (PowerShell) $env:OPENAI_API_KEYyour-api-key-here或者在代碼中通過os.environ[“OPENAI_API_KEY”] “your-key”設(shè)置不推薦用于生產(chǎn)環(huán)境。2.3 關(guān)于 MCP Server 和 Skills這是概念上最容易混淆的地方。MCP 是一個協(xié)議要實現(xiàn)它你需要一個MCP Server。這個 Server 負(fù)責(zé)管理一個或多個Skills并以標(biāo)準(zhǔn)格式向 Agent 暴露這些 Skills 的功能。目前你有幾種選擇來獲得 MCP Server 和 Skills使用現(xiàn)成的 MCP Server 一些項目或公司提供了開箱即用的 MCP Server里面集成了很多常用 Skills如文件操作、SQL查詢等。你需要運(yùn)行這個 Server。自己實現(xiàn) MCP Server 如果你有自定義的工具需要接入就需要按照 MCP 協(xié)議規(guī)范自己編寫 Server 端代碼。這涉及到定義工具Tools的 Schema名稱、描述、參數(shù)。使用 LangChain 內(nèi)置工具 對于快速驗證LangChain 的langchain.tools和langchain-community中已經(jīng)有很多預(yù)定義的工具如WikipediaQueryRun,ShellTool。你可以先用這些工具構(gòu)建一個簡單的 Agent理解流程再考慮接入更復(fù)雜的 MCP。對于初次嘗試我建議路線是先忽略“純 MCP”的實現(xiàn)復(fù)雜度直接用 LangChain 內(nèi)置工具跑通一個 Agent。這能讓你快速建立對 Agent 工作流的直覺。理解了 Agent 如何調(diào)用 Tools 之后再去研究 MCP Server 的部署和連接會順暢很多。3. 從零構(gòu)建你的第一個 LangChain Agent我們從一個最簡單的例子開始創(chuàng)建一個能使用搜索引擎和計算器的 Agent。這個例子不涉及 MCP Server但完整展示了 Agent 的核心工作流。3.1 定義工具Skills首先我們創(chuàng)建兩個工具一個用于網(wǎng)絡(luò)搜索一個用于數(shù)學(xué)計算。from langchain.tools import Tool, DuckDuckGoSearchRun from langchain.utilities import ArxivAPIWrapper import math # 工具1 網(wǎng)絡(luò)搜索使用 DuckDuckGo search DuckDuckGoSearchRun() search_tool Tool( nameWeb Search, funcsearch.run, descriptionUseful for when you need to answer questions about current events or general knowledge. Input should be a search query. ) # 工具2 計算器 def calculator_func(expression: str) - str: Evaluate a mathematical expression. Use only , -, *, /, **, ( ). try: # 警告直接使用 eval 有安全風(fēng)險僅用于演示。生產(chǎn)環(huán)境應(yīng)使用安全評估庫如 asteval。 result eval(expression, {__builtins__: None}, {math: math}) return str(result) except Exception as e: return fError evaluating expression: {e} calc_tool Tool( nameCalculator, funccalculator_func, descriptionUseful for performing arithmetic calculations. Input should be a valid mathematical expression as a string, e.g., 3 * 4 5. ) # 將工具放入列表 tools [search_tool, calc_tool]關(guān)鍵點(diǎn)每個Tool對象都必須有清晰的name、func執(zhí)行函數(shù)和description。description至關(guān)重要因為 Agent大模型就是靠閱讀這些描述來決定在什么情況下使用哪個工具。3.2 初始化大模型和 Agent接下來我們選擇一個 LLM并用它和工具列表來創(chuàng)建 Agent。from langchain_openai import ChatOpenAI from langchain.agents import create_react_agent, AgentExecutor from langchain import hub # 1. 初始化 LLM llm ChatOpenAI(modelgpt-4o, temperature0) # 使用 gpt-4o溫度設(shè)為0保證穩(wěn)定性 # 2. 獲取一個預(yù)設(shè)的提示詞模板。ReAct 是一個經(jīng)典的 Agent 推理框架。 prompt hub.pull(hwchase17/react) # 3. 創(chuàng)建 Agent agent create_react_agent(llm, tools, prompt) # 4. 創(chuàng)建 Agent 執(zhí)行器它負(fù)責(zé)運(yùn)行 Agent 的循環(huán)思考 - 選擇工具 - 執(zhí)行 - 觀察 - 再思考... agent_executor AgentExecutor(agentagent, toolstools, verboseTrue, handle_parsing_errorsTrue)verboseTrue會讓整個執(zhí)行過程打印出來非常適合調(diào)試和學(xué)習(xí)。handle_parsing_errorsTrue很重要當(dāng)模型輸出格式不符合 Agent 預(yù)期時它能防止程序直接崩潰而是嘗試讓模型重試。3.3 運(yùn)行并觀察 Agent 思考過程現(xiàn)在讓我們問一個需要結(jié)合搜索和計算的問題。question “What was the GDP of the United States in 2023? If it grew by 2.5% in 2024, what would the projected GDP be?” result agent_executor.invoke({input: question}) print(f\n最終答案: {result[output]})當(dāng)你運(yùn)行這段代碼時在控制臺會看到類似以下的輸出verboseTrue的效果 Entering new AgentExecutor chain... I need to find the US GDP for 2023 first, then calculate the projected GDP for 2024 with a 2.5% growth. Action: Web Search Action Input: “United States GDP 2023” Observation: [Search result: The GDP of the United States in 2023 was approximately $27.36 trillion.] Thought: Now I have the 2023 GDP. I need to calculate 2.5% of that and add it to get the 2024 projection. Action: Calculator Action Input: “27360 * 0.025” Observation: 684 Thought: So the growth is $684 billion. Now add it to the 2023 GDP. Action: Calculator Action Input: “27360 684” Observation: 28044 Thought: The projected GDP for 2024 would be approximately $28.044 trillion. Final Answer: The GDP of the United States in 2023 was about $27.36 trillion. With a 2.5% growth in 2024, the projected GDP would be approximately $28.044 trillion. Finished chain. 最終答案: The GDP of the United States in 2023 was about $27.36 trillion. With a 2.5% growth in 2024, the projected GDP would be approximately $28.044 trillion.這就是 Agent 的核心魔力它自動完成了“規(guī)劃-執(zhí)行-推理”的循環(huán)。你不需要告訴它先去搜索再去計算。你只給了最終目標(biāo)它自己拆解了步驟。4. 進(jìn)階接入真正的 MCP Server 與自定義 Skills當(dāng)你理解了基礎(chǔ) Agent 的工作流后就可以探索更工程化的 MCP 模式了。這里的核心變化是工具Skills不再直接寫在 Python 代碼里而是由一個獨(dú)立的 MCP Server 提供。4.1 理解 MCP 通信模型在 MCP 架構(gòu)下你的應(yīng)用Client通常是 LangChain Agent和工具提供方Server是分離的。它們通過標(biāo)準(zhǔn)化的 JSON-RPC 消息進(jìn)行通信。Client 初始化 連接到 MCP Server。Server 宣告 Server 向 Client 發(fā)送它提供的所有 Tools 的列表及其 Schema。Agent 工作 當(dāng) Agent 決定使用某個工具時Client 會向 Server 發(fā)送一個call_tool請求。Server 執(zhí)行 Server 執(zhí)行對應(yīng)的工具函數(shù)并將結(jié)果返回給 Client。Client 接收 Client 將結(jié)果交給 Agent 進(jìn)行下一步推理。這種分離的好處是解耦 Skill 的開發(fā)者后端和 Agent 的開發(fā)者前端/應(yīng)用層可以獨(dú)立工作。安全 敏感操作如數(shù)據(jù)庫訪問、服務(wù)器命令可以封裝在受控的 Server 環(huán)境中而不是在調(diào)用 LLM 的客戶端環(huán)境中。動態(tài)性 Server 可以隨時更新或添加新的 SkillsClient 無需修改代碼即可發(fā)現(xiàn)和使用。4.2 部署并連接一個簡單的 MCP Server假設(shè)我們已經(jīng)有一個運(yùn)行在http://localhost:8080的 MCP Server它提供了一個read_file的技能。我們需要讓 LangChain Agent 能調(diào)用它。LangChain 社區(qū)通常通過MCPClient來橋接。雖然 LangChain 核心庫對 MCP 的原生支持在演進(jìn)中但一個常見的實踐模式是將 MCP Server 提供的工具“轉(zhuǎn)換”為 LangChain 能識別的Tool對象。下面是一個概念性的代碼示例展示了如何連接并封裝 MCP 工具# 假設(shè)我們有一個能與 MCP Server 通信的客戶端類 # 注意以下是一個示意流程具體實現(xiàn)取決于你使用的 MCP 客戶端庫。 import requests import json class SimpleMCPClient: def __init__(self, server_urlhttp://localhost:8080): self.server_url server_url self.tools self._list_tools() def _list_tools(self): 向 MCP Server 請求可用的工具列表 response requests.post(f{self.server_url}/list_tools) # MCP 協(xié)議有標(biāo)準(zhǔn)端點(diǎn) return response.json() # 返回工具 schema 列表 def call_tool(self, tool_name, arguments): 調(diào)用指定的 MCP 工具 payload { jsonrpc: 2.0, method: call_tool, params: {name: tool_name, arguments: arguments}, id: 1 } response requests.post(f{self.server_url}/rpc, jsonpayload) result response.json() if error in result: raise Exception(fMCP Tool error: {result[error]}) return result[result] # 使用這個客戶端創(chuàng)建 LangChain Tool mcp_client SimpleMCPClient() def read_file_wrapper(file_path: str) - str: Wrapper function that calls the MCP servers read_file tool. return mcp_client.call_tool(read_file, {path: file_path}) mcp_file_tool Tool( nameread_file, funcread_file_wrapper, descriptionReads the contents of a file from the local filesystem. Input should be a valid file path string. ) # 現(xiàn)在你可以像使用普通工具一樣將 mcp_file_tool 加入到你的 Agent 工具列表中 tools.append(mcp_file_tool) # 然后用新的 tools 列表重新創(chuàng)建 agent_executor關(guān)鍵點(diǎn) 你需要一個實際的 MCP Server 在運(yùn)行。你可以尋找開源實現(xiàn)例如一些項目提供的示例 Server或者根據(jù) MCP 協(xié)議規(guī)范自己實現(xiàn)一個。連接的核心是將 MCP Server 的 RPC 調(diào)用封裝成 LangChainTool對象。4.3 開發(fā)一個自定義 SkillMCP Server 端如果你想自己提供 Skill就需要實現(xiàn) MCP Server。這通常涉及以下步驟以 Python 為例選擇 MCP SDK 使用官方或社區(qū)提供的 MCP SDK例如mcp-sdk-python來簡化協(xié)議通信。定義工具函數(shù) 編寫實際執(zhí)行操作的函數(shù)如數(shù)據(jù)庫查詢、調(diào)用外部 API。注冊工具 使用 SDK 將你的函數(shù)注冊為 MCP 工具并定義好輸入輸出的 JSON Schema。啟動 Server 啟動一個 HTTP 或 stdio 服務(wù)器等待 Client 連接。一個極簡的偽代碼示例# server.py (概念示例) from mcp_sdk import Server, Tool server Server(my-skills-server) server.tool( nameget_weather, descriptionGet current weather for a city., args_schema{“city”: {“type”: “string”, “description”: “City name”}} ) async def get_weather(city: str) - str: # 這里實現(xiàn)真正的天氣 API 調(diào)用 return f“The weather in {city} is sunny.” if __name__ __main__: server.run(transportstdio) # 或 “http”端口 8080運(yùn)行這個 Server 后任何兼容 MCP 的 Client包括未來可能直接支持 MCP 的 Claude Desktop 等應(yīng)用都能發(fā)現(xiàn)并調(diào)用get_weather這個技能。5. 生產(chǎn)環(huán)境實踐穩(wěn)定性、成本與調(diào)試當(dāng)你的 Agent 從 Demo 走向?qū)嶋H應(yīng)用時以下幾個點(diǎn)必須重點(diǎn)關(guān)注。5.1 控制成本與穩(wěn)定性Token 消耗Agent 的“思考”過程ReAct 格式會產(chǎn)生大量的 Token 消耗尤其是它反復(fù)輸出Thought、Action、Observation時。選擇性價比模型 對于工具調(diào)用邏輯簡單的任務(wù)可以考慮使用gpt-3.5-turbo而非gpt-4來驅(qū)動 Agent以大幅降低成本。復(fù)雜任務(wù)再切換回更強(qiáng)的模型。設(shè)置最大迭代次數(shù)AgentExecutor可以設(shè)置max_iterations和max_execution_time參數(shù)防止 Agent 陷入無限循環(huán)或處理過于復(fù)雜的任務(wù)。agent_executor AgentExecutor( agentagent, toolstools, verboseTrue, max_iterations10, early_stopping_methodgenerate, # 當(dāng)達(dá)到限制時讓模型直接給出最終答案 handle_parsing_errorsTrue )優(yōu)化工具描述 工具的description要精準(zhǔn)、簡潔。模糊的描述會導(dǎo)致模型錯誤調(diào)用或需要更多輪次來理解。5.2 錯誤處理與魯棒性工具調(diào)用失敗 網(wǎng)絡(luò)超時、API 限流、文件不存在等都會導(dǎo)致工具調(diào)用失敗。確保你的工具函數(shù)有良好的異常捕獲并返回對 Agent 友好的錯誤信息例如“Failed to fetch data: Network timeout”而不是讓程序崩潰。解析錯誤handle_parsing_errorsTrue是基礎(chǔ)。你還可以自定義一個output_parser來更優(yōu)雅地處理模型輸出格式不符合預(yù)期的情況。驗證輸入 在工具函數(shù)內(nèi)部對輸入?yún)?shù)進(jìn)行驗證。例如文件路徑工具要檢查路徑是否在允許的目錄內(nèi)防止路徑遍歷攻擊。5.3 調(diào)試與監(jiān)控充分利用verboseTrue 開發(fā)階段一定要打開這是理解 Agent 決策過程的最直接窗口。記錄日志 將AgentExecutor的運(yùn)行日志包括所有的 Thoughts, Actions, Observations結(jié)構(gòu)化的記錄到文件或日志系統(tǒng)便于事后分析。使用 LangSmith 如果你在開發(fā)嚴(yán)肅的應(yīng)用強(qiáng)烈建議集成 LangSmith。它能可視化追蹤每一次 Agent 運(yùn)行的完整鏈條精確看到每個步驟的輸入輸出、耗時和 Token 使用量是調(diào)試和優(yōu)化的神器。5.4 與 LangGraph 的區(qū)別與選擇搜索熱詞中出現(xiàn)了langgraph。簡單來說LangChain Agent 更適合單一目標(biāo)、線性或簡單分支的任務(wù)流程。你給一個指令它自動規(guī)劃執(zhí)行。LangGraph 是一個基于圖狀態(tài)機(jī)的框架用于構(gòu)建復(fù)雜、有狀態(tài)、多輪、循環(huán)或并行的工作流。例如一個客服機(jī)器人需要管理多輪對話狀態(tài)并根據(jù)不同狀態(tài)跳轉(zhuǎn)到不同的處理節(jié)點(diǎn)。如何選 如果你的任務(wù)主要是“調(diào)用工具完成一件事”用 Agent。如果你的任務(wù)涉及復(fù)雜的業(yè)務(wù)流程、狀態(tài)維護(hù)和節(jié)點(diǎn)路由比如一個涵蓋用戶查詢、數(shù)據(jù)庫檢索、生成報告、發(fā)送郵件、等待用戶反饋的完整自動化流程則應(yīng)該用 LangGraph。兩者可以結(jié)合例如在 LangGraph 的一個節(jié)點(diǎn)里運(yùn)行一個 Agent。6. 典型應(yīng)用場景與避坑指南最后結(jié)合常見搜索詞看看這套技術(shù)能用在哪兒以及有哪些“坑”。6.1 應(yīng)用場景智能數(shù)據(jù)分析助手 用戶用自然語言提問“上個月銷售額最高的產(chǎn)品是什么”Agent 自動調(diào)用“數(shù)據(jù)庫查詢”Skill 獲取數(shù)據(jù)再調(diào)用“圖表生成”Skill 畫出趨勢圖最后總結(jié)。自動化辦公 “將本周項目會議紀(jì)要的關(guān)鍵任務(wù)提取出來生成一個TODO列表發(fā)到我的郵箱?！?Agent 調(diào)用“讀取文檔”Skill - “文本摘要/提取”Skill - “發(fā)送郵件”Skill。內(nèi)部知識庫問答 結(jié)合 RAG檢索增強(qiáng)生成Agent 可以先調(diào)用“向量庫搜索”Skill 找到相關(guān)文檔片段再讓 LLM 生成精準(zhǔn)答案。代碼生成與操作 “在src/utils/目錄下幫我創(chuàng)建一個名為formatDate.js的函數(shù)文件內(nèi)容是按‘YYYY-MM-DD’格式化日期。” Agent 需要調(diào)用“文件系統(tǒng)操作”Skill。6.2 常見“坑”與解決方案坑1Agent 亂用或不用工具現(xiàn)象 模型要么不調(diào)用工具直接瞎猜要么調(diào)用錯誤的工具。排查檢查工具description是否清晰、無歧義。用人類能看懂的話描述工具的功能和適用場景。檢查給模型的系統(tǒng)提示詞prompt。hwchase17/react這個 prompt 是經(jīng)過優(yōu)化的。如果你自定義 prompt必須包含清晰的工具使用說明。嘗試換用更強(qiáng)的模型如從 gpt-3.5 切換到 gpt-4推理能力更強(qiáng)的模型在工具選擇上更準(zhǔn)確?？?任務(wù)陷入循環(huán)或超時現(xiàn)象 Agent 反復(fù)調(diào)用同一個工具或者一直在“思考”不出結(jié)果。排查首先設(shè)置max_iterations如5-10次。檢查工具返回的結(jié)果是否清晰。如果工具返回“未找到”或錯誤信息Agent 可能無法理解并陷入困惑。確保工具返回對后續(xù)決策有用的信息。在 prompt 中強(qiáng)調(diào)“如果你無法通過現(xiàn)有工具完成任務(wù)請直接告知用戶并停止嘗試”?？?處理復(fù)雜、多步驟任務(wù)效果差現(xiàn)象 任務(wù)稍微復(fù)雜點(diǎn)Agent 的規(guī)劃就亂了。解決方案 這可能是單一 Agent 的局限?？紤]使用Plan-and-Execute模式或LangGraph。即先用一個“規(guī)劃者”LLM 將大任務(wù)拆解成明確的子任務(wù)列表再由一個“執(zhí)行者”Agent 或工作流依次執(zhí)行每個子任務(wù)。這比讓一個 Agent 自己動態(tài)規(guī)劃要穩(wěn)定得多?？?MCP Server 連接或調(diào)用失敗現(xiàn)象 Client 無法連接到 Server或調(diào)用工具時超時。排查網(wǎng)絡(luò)與端口 確認(rèn) Server 進(jìn)程是否在運(yùn)行ps aux | grep mcp端口是否被占用或被防火墻攔截。協(xié)議兼容性 確認(rèn) Client 和 Server 使用的 MCP 協(xié)議版本是否兼容。查看 Server 日志。參數(shù)格式 確保調(diào)用工具時傳入的參數(shù)嚴(yán)格符合 Server 端定義的 JSON Schema。一個字段類型不匹配就可能導(dǎo)致調(diào)用失敗。最后的核心建議 不要一開始就追求接入復(fù)雜的 MCP 和一大堆 Skills。從最簡單的 LangChain Agent 兩個內(nèi)置工具開始徹底理解Thought - Action - Observation這個循環(huán)。然后嘗試為自己寫一個自定義的 Python Tool比如一個查詢數(shù)據(jù)庫的函數(shù)。當(dāng)你能熟練駕馭這個流程后再去研究如何將你的工具改造成 MCP Server或者如何連接別人提供的 MCP Server。這樣由簡入繁的路徑能幫你避開大部分概念和工程上的陷阱。