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。