如何使用 Letta：構建有狀態 AI 代理的實用指南
如果你曾希望你的 AI 代理可以跨會話記住上下文、可靠地調度工具，並且不再依賴臨時拼湊的腳本，Letta 正是為此而生。以下是一份實用的逐步指南，幫助你設定 Letta、構建你的首個持久代理，並部署真正長效的工作流程。
值得一提的是：Letta 曾與 MemGPT 項目相關，後來演變成擁有 SDK 和視覺化代理開發環境（ADE）的完整平台。你可以找到入門教程和官方文檔，還有一個簡短的影片介紹如何創建持久代理，以及針對 ADE 的公告文，如果你偏好低代碼UI。想深入了解 Letta 中有狀態代理的概念背景，可以參考代理總覽。對於 MemGPT 更名為 Letta 及相關套件變更，好用的 Python 套件說明以及開源代碼庫提供了架構解析。
本指南採用實用且以解決方案為導向的風格：少廢話，多可複製粘貼的步驟，每一步都有明確決策。
什麼是 Letta（及其重要性）？
Letta 是一個構建有狀態 AI 代理的平台──可保存長期記憶、管理工具並在會話間持久狀態的代理。你得到的不是無狀態的聊天包裝器，而是一個結構化運行環境，代理可以：
- 使用結構化輸入（函數、API、webhooks）調用工具，並強制輸入格式。
- 支持雲端或本地運行，通過 SDK（Python/TypeScript）或低代碼視覺環境（ADE）操作。
這意味著你可以構建不會中途“忘記”項目的客服、研究助手、數據運營、產品運營或內部自動化代理。
快速決策樹：你該從哪裡開始？
- 我是偏好寫代碼的開發者 → 使用 SDK 快速入門（Python 或 TypeScript）。
- 我想先視覺化原型，再導出代碼 → 使用 ADE 和代理總覽。
- 我需要了解架構和歷史背景 → 瀏覽代碼庫/README 和套件說明。
設置：從零開始打造首個代理（代碼路線）
以下是使用 SDK（文檔中 Python 範例；TypeScript 類似）的最快路徑。
- 依照文檔安裝
letta套件。確保你的 API 金鑰或本地伺服器憑證透過環境變數（例如LETTA_API_KEY）配置完成。
- 定義代理的系統提示（角色）、記憶策略和工具列表。快速入門展示了最小可用範例。
- 啟用持久記憶並配置代理如何讀寫記憶庫。代理總覽介紹 Letta 如何存儲狀態以及代理如何在伺服器端持久化。
- 註冊帶有嚴格結構的函數。先從簡單工具如
search_docs(query)或create_ticket(data)開始，後續可擴展。
- 執行簡短任務（例如：“彙整此客戶對話並創建解決工單”）。檢查日誌和記憶軌跡以驗證行為。
- 可選本地運行環境供開發使用，或選擇託管架構用於測試/生產。隨時為代理配置與工具進行版本管理。
範例：最簡代理藍圖（類 Python 語法）
from letta import Client, Agent, Tool
client = Client(api_key=os.environ.
