在 LangGraph 中基于結(jié)構(gòu)化數(shù)據(jù)源構(gòu)建。

在 LangGraph 中構(gòu)建不同的 agent 系統(tǒng) | Image by author

如果你不是會員但想閱讀原文，請點(diǎn)擊這里。

如果你剛開始搭建不同的 agentic 系統(tǒng)，一個(gè)有趣的切入點(diǎn)是比較單智能體工作流與多智能體工作流，或者說更靈活的系統(tǒng)與更可控的系統(tǒng)之間的差異。

本文將幫助你理解什么是 Agentic AI，以及如何用 LangGraph 和 LangSmith Studio 構(gòu)建 agentic 系統(tǒng)。

我們會用兩種不同的架構(gòu)構(gòu)建一個(gè) researcher，以便對比結(jié)果、判斷哪種做得更好。

本文涉及的資源在這里(https://github.com/ilsilfverskiold/Awesome-LLM-Resources-List/tree/main/guides/langgraph)。運(yùn)行基本都是免費(fèi)的，除了會用到一些 OpenAI tokens。

使用場景

為了構(gòu)建一個(gè)具體的東西，我們會搭建一個(gè) tech 研究 agent，它能找出昨天或過去一周的趨勢，再判斷什么值得報(bào)道。

在匯總與收集研究這種任務(wù)上，Agentic AI 非常能打。

本文會用一個(gè) API 來匯總科技圈大家在討論和分享的內(nèi)容，然后讓 agentic 系統(tǒng)基于我們的用戶畫像判斷重要性并為我們做摘要。

數(shù)據(jù)源提供了結(jié)構(gòu)化數(shù)據(jù)，agentic 系統(tǒng)可以據(jù)此工作

這個(gè) agent 不會在正文里添加引用，我們關(guān)注的是在只設(shè)置單智能體與設(shè)置多個(gè)協(xié)同智能體兩種情況下，它分別能覆蓋到多少信息。

因此本文的重點(diǎn)更在 agentic 的構(gòu)建，而不是數(shù)據(jù)源本身。

我們的多智能體系統(tǒng)在 LangSmith Studio 中的樣子，運(yùn)行需要幾分鐘 | Image by author

我們先用一個(gè)簡單的 agent（能訪問不同的 API endpoints）搭建系統(tǒng)，然后再擴(kuò)展為多團(tuán)隊(duì)、更多工具的系統(tǒng)，看質(zhì)量差異。

開始之前，我會先給入門者做個(gè)簡短復(fù)習(xí)。如果你對 agentic 系統(tǒng)很熟，可以跳過前面的一些部分。

Agentic AI 與 LLMs

Agentic AI 是用自然語言來編程。與其寫死板、顯式的代碼，不如用自然語言指令讓大語言模型（LLMs）負(fù)責(zé)路由數(shù)據(jù)并調(diào)用動(dòng)作，實(shí)現(xiàn)自動(dòng)化。

在工作流里使用自然語言并不新鮮，我們已經(jīng)用了多年的 NLP 來抽取和處理數(shù)據(jù)。

新的是我們現(xiàn)在能給語言模型更多自由度，讓它們處理歧義并做出動(dòng)態(tài)決策。

圖片

但 LLMs 能理解復(fù)雜語言，并不意味著它們天然會校驗(yàn)事實(shí)或保證數(shù)據(jù)完整性。

我更把它們看作一個(gè)溝通層（至少目前如此），位于結(jié)構(gòu)化系統(tǒng)與既有數(shù)據(jù)源之上。

圖片

我通常這樣向非技術(shù)同事解釋：它們有點(diǎn)像我們。沒有干凈、結(jié)構(gòu)化的數(shù)據(jù)，我們也會開始“編”。LLMs 也是一樣。

所以，就像我們一樣，它們會盡力而為。如果想要更好的輸出，就要為它們構(gòu)建能提供可靠數(shù)據(jù)或可操作系統(tǒng)的環(huán)境。

因此，在 Agentic 系統(tǒng)中，我們會為它們接入不同的數(shù)據(jù)源、工具和系統(tǒng)。

當(dāng)然，就算我們_可以_在更多地方使用更大的模型，也不代表我們總是_應(yīng)該_這么做。LLMs 在理解細(xì)膩?zhàn)匀徽Z言時(shí)大放異彩，比如客服、研究或 human-in-the-loop 協(xié)作。

但對于結(jié)構(gòu)化任務(wù)（例如提取數(shù)字并發(fā)送到某處），你應(yīng)該優(yōu)先使用傳統(tǒng)方法與自動(dòng)化。

LLMs 并不比計(jì)算器更擅長算術(shù)。所以，不是讓 LLM 直接算，而是給 LLM 一個(gè)計(jì)算器的調(diào)用能力。

因此，只要_可以_用程序化的方式構(gòu)建工作流的部分，通常都更優(yōu)。

盡管如此，LLMs 擅長適應(yīng)現(xiàn)實(shí)世界的“臟輸入”和理解模糊指令，把兩者結(jié)合起來是構(gòu)建系統(tǒng)的好方法。

如果你還很新手，并且仍有些困惑，可以去看看我其他更詳細(xì)的內(nèi)容。等我們動(dòng)手搭建時(shí)，可能會更清晰。

Agentic 框架與 LangGraph

很多人第一次做 agent 就直接上 CrewAI 或 AutoGen，但我們有很多選擇。

我之前在這里寫過一些綜述，閱讀量超過 10 萬，想要總覽可以先看。

LangGraph 技術(shù)性更強(qiáng)，也更復(fù)雜，它是基于 LangChain 的圖式框架。很多開發(fā)者都偏愛它，所以至少做點(diǎn)東西是值得的。

我現(xiàn)在更喜歡無框架的做法，但會借鑒各框架里學(xué)到的好東西，所以學(xué)習(xí)它們?nèi)匀挥袃r(jià)值。

不過 LangGraph 有不少抽象層，你可能會想重構(gòu)部分以便更好地控制與理解。

這里我不詳細(xì)展開 LangGraph，所以我單獨(dú)做了一個(gè)簡短指南給需要復(fù)習(xí)的人。

在這個(gè)用例里，你可以不寫代碼就跑起來工作流，但如果你來此是為了學(xué)習(xí)，也可以順便理解 LangGraph 的工作方式。

單智能體 vs 多智能體系統(tǒng)

在開工之前，先說說單智能體與多智能體的差異。

如果你圍繞一個(gè) LLM 并給它一堆 tools來構(gòu)建系統(tǒng)，你就是在做單智能體工作流。它很快，而且如果你是 agentic AI 新手，你可能覺得模型“應(yīng)該能自己搞定”。

圖片

但說到底，這些工作流也是一種系統(tǒng)設(shè)計(jì)。

就像任何軟件項(xiàng)目一樣，你需要規(guī)劃流程、定義步驟、組織邏輯，并決定每一部分如何行為。

圖片

這就是多智能體工作流的用武之地。

并不是所有多智能體都是層級式或線性的，有些是協(xié)作式的。協(xié)作式工作流也更偏靈活，我覺得在當(dāng)下能力水平下，這類工作流相對更難駕馭。

不過，協(xié)作式工作流同樣會把不同功能拆解為獨(dú)立模塊。

當(dāng)你只是試驗(yàn)時(shí)，協(xié)作式工作流非常合適，但它不一定能提供完成實(shí)際任務(wù)所需的精確度。

在本文要搭的工作流中，我已經(jīng)知道該如何使用這些 APIs，因此我需要引導(dǎo)系統(tǒng)以正確方式使用它們。

我們會對比一個(gè)單智能體的設(shè)置與一個(gè)層級式多智能體系統(tǒng)：由一個(gè) lead agent 把任務(wù)分發(fā)給一個(gè)小團(tuán)隊(duì)，讓你看看它們在實(shí)踐中的行為差異。

構(gòu)建單智能體

構(gòu)建單智能體時(shí)，我們用一個(gè) LLM 和一個(gè) system prompt，然后給它若干 tools 的訪問權(quán)。

智能體會基于用戶的問題自行決定該用哪個(gè) tool、何時(shí)用。

圖片

單智能體的挑戰(zhàn)在于“可控性”。

不論 system prompt 多么詳細(xì)，模型都可能不按我們要求執(zhí)行（更受控的環(huán)境也可能如此）。如果我們給太多 tools 或選項(xiàng)，它很可能不會全部使用，甚至用錯(cuò)。

你能寫進(jìn)指令里讓它“照做”的空間是有限的。

為說明這一點(diǎn)，我們會構(gòu)建一個(gè) tech news agent，它能訪問多個(gè)自定義數(shù)據(jù)的 API endpoints，并且 tools 中有多種可選參數(shù)。

由智能體決定使用多少工具、如何組織最終摘要。

提醒一下，我是用 LangGraph 來構(gòu)建這些工作流的。這里不會深講 LangGraph，如果你想學(xué)基礎(chǔ)以便修改代碼，看這里（這份指南寫于 2025 年 4 月）。

你可以在這里找到單智能體工作流。要運(yùn)行它，你需要 LangSmith 的賬號（可訪問 LangSmith Studio）以及安裝了 Python 3。

有了賬號后，把單智能體工作流 clone 到你的電腦。

目錄結(jié)構(gòu)如下：

single-agent-workflow/
├─ my_agent/
│  ├─ agent.py
│  ├─ requirements.txt
│  ├─ utils/
│     ├─ nodes.py
│     ├─ state.py
│     └─ tools.py
├─ README.md  
├─ langgraph.json

創(chuàng)建一個(gè) .env 文件并添加 Google API key。這個(gè)單智能體我們會用 Gemini。

GOOGLE_API_KEY=KEY_HERE

然后創(chuàng)建環(huán)境：

python3.11 -m venv venv_py311

source venv_py311/bin/activate

安裝 LangGraph CLI：

pip install -U "langgraph-cli[inmem]"

requirements 在 my_agent 文件夾下，也需要安裝：

pip install -r my_agent/requirements.txt

安裝完成后，你可以在 LangSmith Studio 打開這個(gè)單智能體工作流：

langgraph dev

這會自動(dòng)打開 LangSmith Studio（之前叫 LangGraph Studio）。

圖片

這里還需要?jiǎng)?chuàng)建一個(gè) assistant，默認(rèn)是 Anthropic，而我們這個(gè) agent 使用 Gemini。

點(diǎn)擊左下角按鈕管理 assistants。

請確保創(chuàng)建一個(gè)模型為“gemini”的新 assistant，并點(diǎn)擊“create new assistant” | Image by author

請確保創(chuàng)建一個(gè)模型為“gemini”的新 assistant，并點(diǎn)擊“create new assistant” | Image by author

會彈出上圖類似的 modal。把模型設(shè)為“gemini”，然后點(diǎn)擊“Create New Assistant”。

回到主界面后，你可以設(shè)置起始消息。

比如告訴它你的身份、希望獲取每日/每周/每月的信息（見下例）。

{"messages": ["I'm a tech investor, give me what's up in tech for the last week"]}

在 LangSmith Studio 里會像這樣顯示：

圖片

點(diǎn)擊提交，結(jié)果會很快，因?yàn)槲覀兪菃沃悄荏w。

它會先在 3 個(gè)不同類別下檢查一些 trending keywords，然后對其中幾個(gè)關(guān)鍵詞再看大家都在說什么。

如果你想了解這些 tools 是如何創(chuàng)建的，去看看代碼即可，本質(zhì)上就是調(diào)用一個(gè) API。

圖片

最終結(jié)果類似這樣（當(dāng)然取決于你運(yùn)行的時(shí)間，信息每天都會變化）：

Here's a summary of the trending tech topics from the past week:

Companies:
Apple: Apple is facing scrutiny over its App Store practices, including a UK monopoly case and concerns about attention to detail. There are also reports of reduced iPhone Air production and its potential move to include ads in the Maps app.
Meta: Meta is undergoing layoffs in its AI division, which has generated negative sentiment. There is also discussion around a mod that disables the recording light on Meta's Ray-Ban glasses, raising privacy concerns.
GM: GM's decision to ditch Apple CarPlay and Android Auto in future vehicles has sparked controversy and negative reactions from users.
Samsung: Samsung is planning to introduce ads on its smart fridges, drawing criticism. There's also news about the upcoming Galaxy XR event and a new chief design officer.
[...]

如果你不想自己運(yùn)行 agent 又想看完整結(jié)果，點(diǎn)這里。結(jié)果還可以，但你會發(fā)現(xiàn)它挖掘得不夠深。

當(dāng)然我們可以繼續(xù)追問它，但你可以想象，如果任務(wù)再復(fù)雜一些，它就會在工作流里開始走捷徑。

關(guān)鍵在于：agent 系統(tǒng)不會“自動(dòng)照著我們腦海中的方式思考”，我們必須對它進(jìn)行編排，讓它按我們的意愿工作。

只要有人在環(huán)，比如做問答，這沒問題。

在這個(gè)場景里，如果人類問一個(gè)問題、agent 去取回對應(yīng)信息，那會很好用。

但如果是深度研究，我們需要更復(fù)雜一點(diǎn)的系統(tǒng)。可以用工作流式（每個(gè)環(huán)節(jié)做一件事），也可以嘗試構(gòu)建一個(gè)層級式系統(tǒng)，讓一個(gè) agent（或團(tuán)隊(duì)）對某一件事負(fù)責(zé)。

測試多智能體工作流

搭建多智能體系統(tǒng)要比給單智能體配幾樣工具難多了。

你需要在此之前仔細(xì)思考系統(tǒng)架構(gòu)，以及數(shù)據(jù)如何在 agents 之間流動(dòng)。

這里我搭的多智能體工作流使用兩個(gè)團(tuán)隊(duì)（research team 和 editing team），每個(gè)團(tuán)隊(duì)下有若干 agents。

我們多智能體系統(tǒng)中的團(tuán)隊(duì)/agents 架構(gòu)示意 | Image by author

每個(gè) agent 只能訪問特定的一小組 tools（不宜過多），并有清晰的指令。

這種對每個(gè) agent 的職責(zé)收斂，對于較低級別的 LLMs（例如 Gemini Flash 2.0）非常有益；不過我仍然喜歡用更強(qiáng)的 LLM 來做 summarizing（這里我們用 GPT-5 作為 summarizer agent）。

我們引入了一些新工具，比如一個(gè) research pad，充當(dāng)共享空間（一個(gè)團(tuán)隊(duì)寫入發(fā)現(xiàn)，另一個(gè)團(tuán)隊(duì)讀取）。最后一個(gè) LLM 會讀取所有已研究與編輯的內(nèi)容來生成摘要。

另一種替代 research pad 的方式是在 state 中存儲數(shù)據(jù)到 scratchpad，為每個(gè)團(tuán)隊(duì)或 agent 隔離短期記憶。但這也意味著需要仔細(xì)思考每個(gè) agent 的記憶應(yīng)包含什么。

我還決定把 tools 再豐富一些，以便在前期就提供更充實(shí)的數(shù)據(jù)，這樣 agents 就不必對每個(gè)關(guān)鍵詞逐個(gè)拉取來源。在這里我之所以這么做，是因?yàn)榭梢杂贸Ｒ?guī)編程邏輯來搞定。

要點(diǎn)：如果能用常規(guī)編程邏輯，就用它。

工作流在這里為你準(zhǔn)備好了。加載之前，請?jiān)?nbsp;.env 文件中同時(shí)添加你的 OpenAI 與 Google API keys。

GOOGLE_API_KEY=KEY_HERE
OPENAI_API_KEY=KEY_HERE
ANTHROPIC_API_KEY=KEY_HERE

只有在你要嘗試更換 agents 時(shí)才需要設(shè)置 Anthropic key（但如果不設(shè)可能會報(bào)錯(cuò)；遇到報(bào)錯(cuò)就新建一個(gè)只包含 Gemini 的 assistant）。

剩下步驟與單智能體類似：創(chuàng)建環(huán)境、安裝依賴并打開工作流。

langgraph dev

打開后你會看到它看起來比單智能體復(fù)雜多了。

圖片

在這個(gè)工作流中，routes（edges）是動(dòng)態(tài)設(shè)置的，而不是像單智能體那樣手動(dòng)設(shè)定。如果你去看代碼，會顯得更復(fù)雜。

運(yùn)行時(shí)同樣需要像上次那樣給一個(gè)消息。

我這次把 prompt 寫得更詳細(xì)了一點(diǎn)，這算是有點(diǎn)“作弊”，你可以試試更簡單的。

{"messages": ["{"messages": ["I'm an investor and I'm interested in getting an update for what has happened within the week in tech, and what people are talking about (this means categories like companies, people, websites and subjects are interesting). Please also track these specific keywords: AI, Google, Microsoft, and Large Language Models"]}"]}

最好還是用你之前的設(shè)置，這樣才能有可比性，但隨你。

一旦開始運(yùn)行會花挺久，你可以先離開，幾分鐘后再回來。

圖片

trending keywords agent 可用的 tools 比單智能體要復(fù)雜，因此返回更慢。

總體而言，這類系統(tǒng)需要時(shí)間來收集與處理信息，這點(diǎn)我們需要習(xí)慣。

稍后你可以在根目錄下的“notes”文件夾看到它收集的筆記。示例見這里。

最終的摘要大致如下：

FINAL RESEARCH SUMMARY
Tech Research Summary

Weekly Tech Investor Brief (week ending Oct 28, 2025)

Key Happenings
Oct 27: ICE signed a $5.7M contract for AI-powered social media surveillance (Reddit: r/technology)
Oct 27: "Windows 10 deadline boosts Mac sales" thread trended, highlighting OS/device churn (Hacker News)
Oct 26: Microsoft 365 Copilot arbitrary data exfiltration via Mermaid diagrams disclosed (Hacker News)
Oct 26: "It's insulting to read AI-generated blog posts" topped HN, reflecting AI content fatigue (Hacker News)
[...]

Why It Matters

AI demand is moving from hype to operational scrutiny. Government adoption (e.g., ICE's Oct 27 contract) signals durable budgets for AI monitoring and analytics, but also heightens regulatory and civil liberties overhang—an opening for compliant AI, privacy-tech, and auditing vendors. Enterprise posts on Microsoft 365 Copilot exfiltration and Teams attendance monitoring underscore a near-term buyer focus on security, governance, and employee trust, not just raw AI features.
Platform competition intensified. Google's Oct 23 Earth AI updates and Google AI Studio "vibe coding" push indicate a bid to reduce time-to-production for AI apps, a likely driver of cloud/TPSU demand and developer lock-in. Meanwhile, community gravitation to open and self-hosted stacks (ComfyUI momentum; S3-compatible storage chatter) reflects a cost-control and control-residency theme—relevant for hybrid vendors and open-core plays.
Consumer backlash is shaping product roadmaps. GM's removal of CarPlay/Android Auto is trending because it challenges perceived table-stakes features, risking brand equity and sales. Apple's reported ads in Maps and YouTube's deepfake measures reflect a broader tension between monetization, safety, and user experience—areas where differentiated policy and design can become competitive moats.
[...]

如果你不想自己運(yùn)行也想看完整內(nèi)容，可以點(diǎn)這里。

新聞內(nèi)容當(dāng)然會因運(yùn)行時(shí)間不同而變化。我是在 10 月 28 日運(yùn)行的，所以示例報(bào)告對應(yīng)這一天。

關(guān)于結(jié)果，就留給你自己判斷：更復(fù)雜的系統(tǒng) vs 簡單系統(tǒng)，在過程控制與輸出質(zhì)量上的差異。

一些收尾說明

我這里用的是一個(gè)不錯(cuò)的數(shù)據(jù)源。沒有這一點(diǎn)，你就需要加很多錯(cuò)誤處理，這會讓一切更慢。

干凈、結(jié)構(gòu)化的數(shù)據(jù)是關(guān)鍵。沒有它，LLM 發(fā)揮不出水平。即便數(shù)據(jù)靠譜，也不完美。你仍需打磨 agents，確保它們按預(yù)期行事。

你可能已經(jīng)注意到，這個(gè)系統(tǒng)是可用的，但還沒到“完美”。還有不少地方要改進(jìn)：把用戶查詢解析得更結(jié)構(gòu)化、為 agents 加護(hù)欄讓它們總是使用自己的 tools，以及優(yōu)化摘要的有效性，確保研究文檔言簡意賅。

我們需要更好的錯(cuò)誤處理，或許還要加入“長期”記憶，以更好理解用戶真正需要什么。State（短期記憶）在你優(yōu)化性能與成本時(shí)尤其重要。

現(xiàn)在我們只是把每條消息都塞進(jìn) state 并讓所有 agents 都能訪問，這不理想。理想情況下應(yīng)該按團(tuán)隊(duì)分離 state。在這個(gè)案例里我還沒做這件事，但你可以嘗試在 state schema 中引入 scratchpad 來隔離每個(gè)團(tuán)隊(duì)所知。