undertheseanlp/underthesea

Underthesea - AI Assistant

What it solves

Underthesea 是一個綜合工具組，將 Agentic AI 框架與針對越南語的專門自然語言處理（NLP）工具結合。它允許開發者建立能與多個 LLM 供應商互動、使用外部工具，並以高精度處理越南語文字的 AI 代理。

How it works

此工具組分為兩個主要元件：

  1. Agentic AI Framework：一個輕量系統，用於建立直接與 LLM API（OpenAI、Azure OpenAI、Anthropic Claude 與 Google Gemini）通訊的 AI 代理，只使用 Python 標準函式庫。它包含工具呼叫迴圈、串流功能，以及長時間任務的會話管理系統。
  2. Vietnamese NLP Suite：一系列針對越南語文字的專門管線，包含斷詞、命名實體辨識（NER）、情感分析與依存句法分析。

此外，還提供 A2A（Agent-to-Agent）伺服器實作，透過 JSON‑RPC over HTTP/SSE 暴露代理，並附帶捆綁的聊天 UI。

Who it’s for

需要同時具備通用代理功能與深度、語言特定的越南語處理能力的 AI 應用開發者。

Highlights

  • Multi-Provider Support：原生整合 OpenAI、Azure、Anthropic 與 Gemini。
  • Zero External Dependencies for Agents：使用 urllib 與 json 進行 API 通訊，減少套件負擔。
  • Built-in Tools：內建 12 種預設工具，如計算機、網路搜尋、Wikipedia 與 Python 執行。
  • Observability：內建本地追蹤（儲存為 JSON）並支援 Langfuse。
  • Vietnamese NLP Pipeline：為越南語提供完整的斷詞、詞性標註、NER 與情感分析工具。
  • A2A Protocol：可輕鬆將代理部署為 ASGI 應用，並具可發現的 AgentCard。