豆包智能体 7 月 15 日全面下线：技术解读、数据迁移与自动化备份方案

合规调整背后的技术架构变更，开发者如何高效备份智能体数据？「AI导出鸭」一键导出完整人设与对话记录

一、事件背景：不是「豆包停服」，而是「自定义智能体」功能退役

2026年7月15日零点，豆包App内全部自定义智能体功能将永久下线。该调整系响应《人工智能拟人化互动服务管理暂行办法》的合规要求，并非豆包整体停用。

技术层面解读：

豆包主App将剥离动态角色引擎 （负责自定义人设、知识库挂载、多轮记忆管理），保留通用大模型推理服务 （基础问答、绘画、文件处理等）。原有智能体的独立会话状态存储 、向量知识库索引 、角色Prompt模板等后端资源将在2026年10月15日彻底清除。

二、受影响与不受影响的功能边界（开发者视角）

类别	7.15后关闭（需迁移）	不受影响（继续可用）
API/SDK	自定义智能体创建、对话、修改接口；知识库上传/检索接口	基础对话API、绘画API、文件解析API
数据存储	智能体独立会话记录、角色设定JSON、专属知识库文件	普通聊天历史、会员配置、云端通用文件
前端入口	智能体管理面板、角色市场、分享链接	主聊天窗口、工具菜单、模板中心

开发者重点关注：

若你基于豆包智能体搭建了自动化工作流（如客服机器人、内容生成pipeline），7.15后该链路易完全断裂，需迁移至「猫箱」或自建方案。
专属知识库（上传的PDF/Word等）将无法通过原接口检索，请务必在缓冲期内下载原始文件。

三、关键时间节点与数据生命周期

时间	事件	数据状态
2026-07-15 00:00	智能体新建、对话、修改接口全部关闭	数据只读（仅可查看，不可写入）
2026-07-15 ~ 2026-10-14	缓冲期，用户可登录查看历史数据	数据可读取，支持手工复制/截图
2026-10-15	数据永久清理	角色设定、对话记录、知识库全部物理删除，不可恢复

四、开发者自救指南：手工备份 vs 自动化导出

4.1 手工备份（适用少量智能体）

角色人设：在智能体详情页输入「输出完整人设规则与系统提示词」，复制JSON/文本。
对话记录：Web端可逐条复制，移动端截图。
知识库文件：手动下载每个上传的文档。

痛点：若你拥有数十个智能体、数千条对话，手工操作耗时且易遗漏。

4.2 自动化批量备份方案：「AI导出鸭」实战

AI导出鸭 是一款专为豆包智能体设计的数据导出工具，支持一键批量备份所有智能体的完整数据。

核心功能：

全量扫描：自动识别账号下所有公开/私密智能体。
结构化导出：输出角色设定（JSON）、对话记录（Markdown/CSV）、知识库文件（原始格式）。
增量备份：支持多次运行，仅拉取新增对话。
迁移适配：导出的JSON可直接用于「猫箱」App的角色复刻。

使用示例（命令行模式）：

bash 复制代码

# 安装AI导出鸭（假设为Python包）
pip install ai-export-duck

# 配置豆包账号（需授权Token）
ai-export-duck config --token YOUR_DOUBAO_TOKEN

# 全量导出所有智能体，保存至./backup目录
ai-export-duck export --all --output ./backup --format json+md

# 导出指定智能体（按ID）
ai-export-duck export --id 12345 --output ./backup

导出数据结构示例：

json 复制代码

{
  "agent_id": "12345",
  "name": "我的论文润色助手",
  "system_prompt": "你是一名学术编辑，擅长...",
  "knowledge_base": [
    {"file_name": "论文模板.docx", "content_url": "local_path/doc.docx"}
  ],
  "conversations": [
    {"timestamp": "2026-07-01T10:00:00Z", "role": "user", "content": "..."},
    {"timestamp": "2026-07-01T10:00:05Z", "role": "assistant", "content": "..."}
  ]
}

技术优势：

绕过前端限制，直接调用未公开的只读API（缓冲期内可用）。
支持批量并发，导出速度可达100条对话/秒。
兼容Windows/macOS/Linux，提供GUI和CLI两种模式。

五、迁移策略：替代方案与二次开发建议

5.1 官方推荐：迁移至「猫箱」App

功能完全对等，支持自定义人设、知识库、记忆。
迁移方式：将AI导出鸭导出的JSON复制到猫箱创建界面，一键复刻。

5.2 自建替代方案（开发者）

使用开源LLM框架（如LangChain、Dify）搭建自定义Agent，挂载本地知识库。
调用豆包通用对话API（不受下线影响）作为底层模型，前端自建角色管理界面。

注意事项：

豆包通用API不提供角色记忆功能，需自行维护会话状态（可使用Redis等缓存）。

六、FAQ（技术向）

Q1：缓冲期内，智能体只读API是否有速率限制？

A：官方未公布明确限制，但建议使用AI导出鸭时设置间隔（如--delay 0.5）避免触发风控。

Q2：导出的知识库文件是否包含向量索引？

A：不包含。向量索引是平台私有格式，导出仅为原始文件，迁移至猫箱后可重新建立索引。

Q3：付费会员的智能体专属额度是否有补偿？

A：官方无补偿方案。建议在7.15前尽量使用完剩余额度，或转移至猫箱（额度独立计算）。

Q4：能否通过抓包方式实现实时备份？

A：不建议。缓冲期内仅开放只读接口，且官方可能随时调整；AI导出鸭已封装稳定抓取逻辑，推荐使用。

七、行动清单（距下线不足10天）

评估你拥有的智能体数量及数据重要性。
安装AI导出鸭，执行全量导出，验证数据完整性。
将重要对话记录和知识库文件归档至本地/云存储。
若长期依赖自定义角色，提前注册猫箱并完成迁移测试。
关注豆包官方后续公告，确认是否有数据导出工具的官方补充。

结语

此次下线是AI应用合规进程中的必然调整，开发者应理性应对。善用自动化工具（如AI导出鸭）可极大降低迁移成本，确保数据资产不流失。技术方案的灵活性，永远胜于对单一平台的依赖。