underthesea

环境要求

• Python 环境（README 使用 pip 安装）
• 可访问 PyPI 的网络
• 可选：Langfuse 账号/服务（仅在需要追踪 Agent 时）
• 可选：OpenAI、Azure OpenAI、Anthropic Claude 或 Google Gemini 的 API 凭证（Agent 调用 LLM 时使

安装与启动步骤

1. 1安装 underthesea

   README 给出的唯一安装方式：用 pip 从 PyPI 安装依赖包，建议在虚拟环境中执行以免污染全局环境。

   pip install underthesea

   复制

2. 2安装可选追踪依赖

   如需用 Langfuse 追踪 Agent 调用，README 注明需额外安装 langfuse 包；不需要追踪可跳过此步。

   pip install langfuse

   复制

3. 3准备 LLM 提供方凭证

   Agent 支持 OpenAI、Azure OpenAI、Anthropic Claude、Google Gemini 四类提供方，使用前需按所选提供方准备好对应的 API 凭证。

4. 4按 Quick Start 使用 Age

   参照 README 的 Quick Start 创建 Agent 对象，传入 name、tools，需要追踪时再传 tracer；未安装 langfuse 则不要传 tracer。

5. 5浏览器内试用

   README 提供官方 Colab 笔记本链接，不想本地安装时可直接在浏览器中打开并运行示例。

如何确认成功

执行 pip install underthesea 无报错即安装完成；可尝试导入并创建 Agent 对象，能正常实例化说明可用。

常见问题

注意事项

• Agent 能力自 v9.3.0 起提供，老版本需先升级。
• 本教程只覆盖 README 中明确写出的 pip 安装与 Agent 用法，未给出端口、配置文件等生产部署细节。
• 调用云端 LLM 会产生费用，请自行管理 API 密钥，避免写入代码仓库。
• Langfuse 追踪器属于可选依赖，不安装不影响基础分词等 NLP 功能。