statelyai/agent

解決的問題

透過將控制流程邏輯從 LLM 移出至確定性狀態機，防止 AI 代理執行無效動作。這確保代理保持可預測、可檢查與可恢復，同時 LLM 僅限於從機器當前狀態定義的合法事件集合中選擇。

如何運作

Stately Agent 將模型請求與決策整合至 XState。狀態機定義合法的轉移與守衛；LLM 提出一個事件，機器判斷該事件是否允許。系統將機器邏輯與執行環境（主機）分離，表示相同的代理機器可於本地使用腳本執行器進行測試，或在生產環境中使用 Vercel AI SDK 等提供者運行，而無需變更機器定義。

適用對象

需要嚴格控制代理行為、實現決定性工作流程，並能輕鬆測試、視覺化與持久化代理狀態的 AI 代理開發者。

特色

• 決定性控制流程：狀態機擁有邏輯，使無效操作成為不可能。
• 模型無關：機器從不直接與模型通訊，允許開發者輕鬆更換 LLM 提供者或執行器。
• 內建模式：包含常見代理架構（如 ReAct、反思、計畫-執行、RAG）的可執行範例。
• 原生 XState 集成：利用 XState 的快照、版本控制與代理狀態遷移功能。