Appearance
安装、版本与模型配置
Deep Agents 发布速度较快。可靠的安装页不能只给一条“安装最新版”命令，还需要区分常规发行、 预发布、运行环境和单项能力的成熟度。
本教程的版本基线
| 发行线 | 版本 | 环境要求 | 用途 |
|---|---|---|---|
| Python 常规发行 | deepagents 0.6.12 | Python >=3.11,<4.0 | 本教程 Python 入门与核心代码 |
| Python 预发布 | 0.7.0a6 | 以对应 PyPI 元数据为准 | 只用于观察未来变化，不进入 quickstart |
| TypeScript latest | deepagents 1.10.7 | 官方未声明最低 Node.js 版本 | 本教程 TypeScript 核心代码 |
Python 包的 PyPI classifier 是
Development Status :: 4 - Beta。这里的“常规发行”表示 PyPI 默认安装线，不表示 API 已获得长期稳定承诺。
前端类比
这类似 npm 包同时存在 latest、next 和功能级实验标记。latest 说明包管理器默认选择哪个 版本，不等于每个导出都具有同样的稳定性。
Deep Agents 原生语义：Deep Agents 的核心 Harness、interpreter、profiles、async subagents 和托管运行时各有独立成熟度。版本号只确定代码集合，页面仍需要按能力标记 Beta、Preview 或 Private Beta。
准备运行环境
Python 可先确认版本：
bash
python --version输出必须满足 3.11 <= version < 4.0。TypeScript 包的官方文档和 package.json 没有给出最低 Node.js 版本，因此本教程不写一个猜测值；请使用团队当前受支持的现代 LTS，并在自己的 CI 中 固定和验证它。
安装核心 SDK
bash
python -m venv .venv
source .venv/bin/activate
pip install "deepagents==0.6.12"bash
npm install deepagents@1.10.7 langchain @langchain/core zodTypeScript 包还声明了 LangGraph、checkpoint、SDK 与 LangSmith peer dependencies。包管理器通常 会解析这些 peer 依赖；在 monorepo 中应检查最终只有兼容版本，避免多个 LangGraph 实例。
安装模型 Provider
model="provider:model-name" 是 LangChain 的模型初始化语法，不代表所有 provider 实现都打包在 deepagents 里。根据实际选择安装对应集成包，并以 provider 官方文档为准。
例如团队选择某个 provider 后，应把集成包和版本写入自己的应用依赖，再设置：
bash
export DEEPAGENTS_MODEL="provider:model-name"
export PROVIDER_API_KEY="replace-with-your-own-secret"bash
export DEEPAGENTS_MODEL="provider:model-name"
export PROVIDER_API_KEY="replace-with-your-own-secret"示例值只是变量形状，不应提交真实密钥。所选模型必须支持 tool calling；否则 planning、filesystem 和 subagents 等内置工具无法正常工作。
可选能力的安装
Interpreter 页面使用 QuickJS 时，Python 推荐通过官方 extra 安装：
bash
pip install "deepagents[quickjs]==0.6.12"不要为了体验实验能力把整个入门环境切换到 0.7.0a6。预发布功能应在独立虚拟环境中验证，并 同时阅读对应 release notes 与源码。
为什么示例固定版本
文档代码需要可追溯。固定 0.6.12 与 1.10.7 可以让读者知道示例核验的 API 集合；实际项目 升级时仍应：
- 查看 PyPI、npm 和 GitHub release/tag。
- 对照
create_deep_agent或CreateDeepAgentParams的参数变化。 - 单独检查 Beta/Preview 页面。
- 运行应用自己的单元测试、轨迹测试和安全测试。
常见安装误区
- 只安装 SDK 就期待模型可用：仍需要 provider 集成包和凭据。
- 把 Node.js 下限写成社区猜测：官方未声明时应记录未知并由项目 CI 决定。
- 用预发布版复制 quickstart：会让基础教程和常规发行 API 脱节。
- 把版本固定等同于安全固定：依赖漏洞、工具权限和 sandbox 仍需单独治理。