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 集成。