undertheseanlp/underthesea

这是什么？

核心功能

• 01无需安装 OpenAI、Anthropic 等官方 SDK，直接调用多家模型 API。
• 02支持工具调用、流式输出，并内置 12 种常用工具。
• 03通过多会话与结构化交接完成长时间运行的任务。
• 04自动在本地记录每次 Agent 调用的追踪信息，可选接入 Langfuse。
• 05基于 A2A 协议发布 Agent，并附带聊天界面。
• 06提供越南语分词、词性标注、命名实体识别和情感分析。

适用场景

• 构建可在 OpenAI、Claude、Gemini 之间切换的 Python Agent，无需额外 SDK。
• 为越南语文本做搜索、分类或信息抽取等预处理。
• 在开发阶段为 LLM Agent 调用添加追踪与可观测性。
• 把 Python Agent 以 A2A 服务形式发布，并配备简单的聊天界面。

快速上手

1. 1

   从 PyPI 安装该包

   pip install underthesea
2. 2

   为一个提供商设置 API 密钥（例如 OpenAI）

   export OPENAI_API_KEY=sk-...
3. 3

   使用自动检测的提供商创建智能体并发送消息

使用前须知

• !智能体功能需要来自 OpenAI、Azure OpenAI、Anthropic 或 Google Gemini 的 API 密钥。

收录于专题

标签

常见问题

underthesea 是什么？

Python 工具包，提供无外部依赖的多模型 LLM Agent 框架，以及越南语分词、命名实体识别、情感分析等 NLP 功能。 Underthesea 是一个 Python 包，主要包含两部分。第一部分是 Agent 工具包，仅使用 Python 标准库即可调用 OpenAI、Azure OpenAI、Anthropic Claude 和 Google Gemini，无需安装各家的 SDK。它支持工具调用、流式输出、带上下文交接的多会话运行、本地 JSON 追踪（可选接入 Langfuse），还能通过 A2A 协议对外提供服务，并内置聊天界面。

underthesea 可以免费使用吗？用的什么许可证？

underthesea 以 Apache-2.0 许可证开源。用于商业产品前，请先确认许可证条款。

underthesea 还在维护吗？

活跃维护中。underthesea 最近一次提交是在 2026年10月20日。

underthesea 适合用来做什么？

构建可在 OpenAI、Claude、Gemini 之间切换的 Python Agent，无需额外 SDK。 为越南语文本做搜索、分类或信息抽取等预处理。 在开发阶段为 LLM Agent 调用添加追踪与可观测性。 把 Python Agent 以 A2A 服务形式发布，并配备简单的聊天界面。

underthesea 怎么安装和运行？

从 PyPI 安装该包: pip install underthesea 为一个提供商设置 API 密钥（例如 OpenAI）: export OPENAI_API_KEY=sk-... 使用自动检测的提供商创建智能体并发送消息

在哪里获取 underthesea？

源代码和安装说明在 GitHub 上：https://github.com/undertheseanlp/underthesea