Get started
Installation
从私有 GitLab 安装 SDK，并准备本地运行环境。
安装方式
当前项目通过私有 GitLab 分发。业务项目推荐用 uv add 安装 Git 依赖：
uv add "we0agent @ git+ssh://git@gitlab.biubbmk.cn:2233/ai/we0-agent-sdk.git"如果需要固定到某个提交，使用 --rev：
uv add "we0agent @ git+ssh://git@gitlab.biubbmk.cn:2233/ai/we0-agent-sdk.git" --rev 8867cfc安装检查链路
验证权限
安装前先确认本机 SSH key 可以访问私有仓库：
git ls-remote ssh://git@gitlab.biubbmk.cn:2233/ai/we0-agent-sdk.git安装后确认可以导入：
from we0agent.agent.agent import We0AgentPython 和依赖
SDK 要求 Python >=3.12。核心依赖包括：
| 依赖 | 用途 |
|---|---|
langchain、langchain-core | 模型、消息、工具 schema 和流式事件基础。 |
langchain-openai | OpenAI provider。 |
langchain-anthropic | Anthropic provider。 |
langchain-google-genai | Google Gemini provider。 |
langchain-deepseek | DeepSeek provider。 |
sqlalchemy、aiosqlite | SQLite、Postgres 等 SQL 持久化。 |
pydantic | SDK 数据模型、工具参数 schema 和结构化输出 schema。 |
API key
本仓库示例和 provider 构造代码默认从环境变量读取 provider key：
export OPENAI_API_KEY="sk-..."
export ANTHROPIC_API_KEY="..."
export GOOGLE_API_KEY="..."
export DEEPSEEK_API_KEY="..."只需要设置你实际使用的 provider。
本仓库开发
在 SDK 仓库内运行示例：
uv sync示例运行命令见 Examples。
文档站点位于 docs-site/：
cd docs-site
npm install
npm run types:check
npm run build安装问题
常见错误和处理路径见 Troubleshooting: 安装失败。如果 uv add 失败，先不要排查 Python 代码，优先确认 git ls-remote 能否访问私有仓库。