undertheseanlp/underthesea

解決的問題

Underthesea 提供一個統一的工具包，專為建構 AI 代理與執行自然語言處理（NLP）而設計，特別針對越南語進行優化。它簡化了整合多個 LLM 提供方，以及實作複雜代理工作流程（如工具呼叫與多會話任務管理）的過程，無需依賴沉重的外部 SDK。

如何運作

此專案分為兩個主要元件：

1. 代理型 AI 工具包：一個輕量級框架，僅使用 Python 標準程式庫與 LLM API（OpenAI、Azure OpenAI、Anthropic 與 Google Gemini）通訊。包含工具呼叫迴圈、支援狀態持久化的長時間任務會話管理器，以及用於可觀測性的追蹤系統。也支援 A2A 協定，可透過 HTTP/SSE 將代理作為 JSON-RPC 服務公開。
2. 越南語 NLP 套件：一組專為處理越南語文字而設計的管道，包含詞語分割、詞性標記、命名實體辨識（NER）、情感分析與翻譯。

適用對象

需要越南語支援的 AI 應用開發者，或希望使用輕量、與提供方無關的框架，部署具備內建工具呼叫與追蹤功能的 AI 代理的開發者。

主要特色

• 零依賴代理核心：僅使用 urllib 與 json 與主要 LLM 提供方通訊。
• 內建工具：提供 12 個預設工具（如網頁搜尋、Python 執行、計算機），並支援輕鬆整合自訂工具。
• 完整的越南語 NLP：提供專用的分詞、聲調還原與依存句法分析功能。
• 支援 A2A 協定：可透過原始 ASGI 應用提供代理，並可選內建聊天 UI。
• 可觀測性：內建本地 JSON 檔案追蹤，並支援與 Langfuse 集成。