您是否曾為構建執行多項任務的 AI 代理而感到沮喪?LangGraph Studio 旨在解決這一難題,它提供了一種視覺化且互動的方式來設計、管理和除錯代理。這款桌面工具基於 LangGraph 框架構建,允許您使用簡單的拖放介面建立代理工作流。您可以在圖表中即時檢視每個步驟,暫停和檢查流程,甚至可以在代理執行時更新代理。LangGraph Studio 支援記憶體、規劃和工具使用,並可與 LangSmith 輕鬆整合,使構建複雜的代理變得更加輕鬆和易於管理。
LangGraph Studio
LangGraph Studio 是一個專業的整合開發環境 (IDE),可幫助您使用 LangGraph 框架構建、視覺化和除錯複雜的代理 AI 應用程式。與傳統 IDE 不同,它為我們提供了一種視覺化和互動式的方式來與 AI 代理協作。這些代理可以執行多步驟任務、使用不同的工具,並使用大型語言模型處理複雜任務。
核心功能和能力
讓我們來看看 LangGraph Studio 的一些功能和能力。
1. 視覺化圖形編輯器
視覺化圖形編輯器允許您使用簡單的流程圖介面建立代理工作流。只需拖放塊(也稱為節點)並用線(稱為邊)連線即可構建代理工作流,從而輕鬆理解任務之間的流程。當您更改程式碼或設定時,整個工作流將以即時視覺化的方式顯示,圖形會即時更新,讓您能夠看到所有元件是如何連線和協同工作的。
2. 即時除錯和互動
單步執行功能允許您在每個節點暫停流程,從而幫助您除錯代理。我們可以隨時檢查任何節點發生的情況,然後返回到之前的步驟,並使用“時間旅行”功能解決問題。使用中斷功能,我們可以在任何步驟之前或之後停止執行,更改代理狀態或響應,然後繼續使用新資料。這在我們想要測試不同的結果或嘗試新想法時非常有用。 Human-in-the-Loop 還允許我們在任何時候新增手動輸入或更新,這在工作流程中需要人工反饋時非常有用。
3. 互動式測試和迭代
即時測試讓我們可以直接在螢幕上執行代理,傳送問題或任務,並即時檢視答案。我們還可以以清晰的格式獲取輸出,例如結構化的 API 響應。使用“修改和重放”功能,我們可以在編輯器(例如 VS Code)中快速更改程式碼或提示,這些更改將立即顯示在 Studio 中。這意味著我們無需每次都重新開始。“分叉和編輯執行緒”功能允許我們更改正在執行的任務的狀態,並從該狀態建立新版本,以便我們嘗試不同的想法並測試最佳方案。
4. 協作與整合
在 LangGraph Studio 中,即時編輯和專案共享功能使團隊能夠共同進行代理設計和除錯。 LangSmith 整合使我們能夠在 Studio 內部實現高階可觀察性、追蹤、評估、快速工程和資料集管理。此外,LangGraph 還允許我們使用內建工具進行版本控制、文件編寫和專案組織。
5. 高階代理功能
藉助記憶體和狀態管理,我們可以構建能夠記住過去對話、規劃後續步驟並根據不斷變化的輸入做出明智決策的代理。助手和執行緒管理使我們能夠建立和處理多個助手和對話執行緒,這些助手和對話執行緒將跟蹤長期記憶並使用不同的資料集測試我們的代理。靈活的部署意味著我們可以輕鬆地在不同位置(例如雲端或邊緣裝置)打包和執行代理,並使其保持更新,而無需擔心平臺問題。
6. 適用於不同使用者的模式
LangGraph Studio 提供不同的模式,例如圖形模式,它為開發人員提供功能齊全的詳細檢視,公開執行路徑、節點遍歷和中間代理狀態。另一方面,聊天模式是一個簡化的介面,適用於商業使用者或測試特定聊天代理並關注整體代理行為和對話流程的使用者。
如何使用LangGraph Studio
LangGraph Studio 是一款桌面應用,目前僅適用於 Apple Silicon(搭載 M1、M2 或 M3 晶片的 MacBook)。如果您有相容裝置,請按照以下說明操作:
安裝LangGraph Studio
要開始使用 LangGraph Studio,請按照以下步驟操作:
- 下載:首先,訪問 GitHub 程式碼庫,下載適用於您作業系統的最新版本 LangGraph Studio。
- 安裝:下載完成後,執行安裝程式,然後按照螢幕上的說明完成安裝。
設定LangGraph Studio
現在,在您的專案中設定一個 LangGraph 應用。您可以克隆一個使用 requirements.txt 檔案作為依賴項的示例程式碼庫:
git clone https://github.com/langchain-ai/langgraph-example.git
接下來,您可以使用 OpenAI、Anthropic 和 Tavily 鍵建立和配置 .env 檔案:
cp .env.example .env echo "OPENAI_API_KEY=\"$OPENAI_API_KEY\"" > .env echo "ANTHROPIC_API_KEY=\"$ANTHROPIC_API_KEY\"" >> .env echo "TAVILY_API_KEY=\"$TAVILY_API_KEY\"" >> .env
因此,一旦您的專案設定完畢,您就可以開始使用 LangGraph Studio 了。
首次啟動 LangGraph Studio 桌面應用時,您需要透過 LangSmith 登入來驗證您的會話。
Source: LangGraph
接下來,您需要一個名為 langgraph.json 的檔案。該檔案會告訴 LangGraph Studio 您的代理程式在哪裡、需要哪些額外工具以及要使用哪些環境設定。您可以在 LangGraph Studio 中建立此檔案,也可以手動將其新增到資料夾中。如果您想了解如何操作,GitHub 上提供了一些示例資料夾。
Source: LangGraph
資料夾準備就緒並開啟後,LangGraph Studio 將設定執行代理程式所需的一切。之後,我們將能夠看到一個視覺化圖表,顯示代理程式的步驟,以及一個可以與代理程式互動的對話方塊。
Source: LangGraph UI
在使用代理程式時,我們將即時看到它一步步執行。它會顯示它正在使用哪些工具或功能,以及它是如何執行的。如果出現問題或代理程式開始執行我們不希望的操作,我們可以隨時暫停它。我們還可以開啟“除錯模式”,讓代理程式在每個步驟後停止,以便我們隨時檢查和修復問題。
使用LangGraph的優勢
使用 LangGraph 的優勢如下:
- 輕鬆設計複雜的工作流程:這款視覺化圖形編輯器非常實用,因為它可以幫助我們檢視和控制代理在節點和邊之間的流動方式,從而更輕鬆地構建和理解複雜的多步驟流程。
- 即時除錯和狀態控制:我們可以隨時暫停執行、檢查或更改代理狀態,然後繼續或重新執行步驟。這使得我們能夠更輕鬆地除錯和測試代理。
- 強大的靈活性和完全的控制力:作為一個底層框架,它支援迴圈和並行任務等高階流程。我們還可以決定代理的具體工作方式,包括工具呼叫和記憶體管理。
- 強大的生態系統和整合:LangGraph 與 LangChain 的工具(例如 LLM、資料庫、API)完美相容,並與 LangSmith 連線以進行跟蹤和除錯。我們還可以將代理部署到雲端或無伺服器環境中。
- 支援多智慧體協作:我們可以構建多個智慧體協同工作的系統,這對於起草、審閱、工具使用、檢索等工作非常有用。
LangGraph Studio的侷限性
以下是 LangGraph Studio 的一些侷限性:
- 僅支援 Mac(目前):LangGraph Studio 僅在 Apple Silicon Mac 上執行,這意味著如果您使用的是 Windows 或非 Mac 系統,則暫時無法使用它。
- 學習曲線陡峭且文件不清晰:它功能強大,但許多人發現很難學習,尤其是在剛開始的時候。文件和教程並不總是易於理解,初學者經常會遇到困難。
- 對於簡單的用例來說內容過多:如果您的智慧體工作流程非常簡單,LangGraph 可能會做得過頭。它需要大量的設定圖、狀態和邊,而一個簡單的指令碼或程式碼鏈就可以完成。
- 程式碼結構混亂且存在可維護性問題:使用者報告稱他們的智慧體邏輯可能難以管理。通常需要維護多層包裝器和顯式狀態定義。
- 執行時問題和幻覺迴圈:LangGraph 有時會建立奇怪的迴圈,導致代理無休止地自言自語。這會導致成本增加、執行時間延長,甚至幻覺強化。
小結
LangGraph Studio 是一款幫助您更輕鬆地構建 AI 代理的工具。它為您提供了一種視覺化的方式來設計和管理工作流程。現在,您可以即時除錯、管理記憶體並快速整合工具。這節省了編碼時間,讓您可以專注於代理的任務。雖然學習起來比較困難,但它的即時功能使開發更加順暢和輕鬆。無論您的代理是簡單還是複雜,LangGraph Studio 都能簡化流程。
評論留言