csml-rpi/Foam-Agent

解決的問題

Foam-Agent 自動化了使用 OpenFOAM 進行計算流體力學（CFD）模擬的複雜工作流程。使用者僅需一個自然語言提示，即可啟動整個模擬過程，無需深入掌握網格生成、案例設定與錯誤修正等手動專業知識。

工作原理

該系統基於 LangGraph 建構的多代理框架，包含架構師、輸入撰寫器、執行器與審查員四個代理。這些代理以流水線方式協作，最多可進行 25 次迭代，自動檢測並修復模擬錯誤。為確保準確性，系統採用 RAG（檢索增強生成），利用從 OpenFOAM 教學範例建構的分層 FAISS 索引。核心功能以 MCP（模型上下文協議）工具形式公開，可與 Cursor 和 Claude Code 等 AI 驅動的 IDE 集成。

適用對象

專為需要執行 CFD 模擬但缺乏手動設定 OpenFOAM 複雜字典檔與環境所需專業知識的研究人員與工程師設計。

主要亮點

• 端對端自動化：涵蓋從網格生成（包括外部 Gmsh 檔案）到 HPC 作業提交，以及透過 PyVista 進行可視化。
• $\text{100%}$ 成功率：在 FoamBench 上使用 Claude Opus 4.6 實現。
• 自我修復工作流程：自動審查模擬錯誤，並在迴圈中應用修復。
• MCP 集成：可作為 Cursor、Windsurf 和 Claude Code 等代理工具的伺服器使用。