
autogen studio 2.0 将所有自定义技能、智能体(agents)和工作流(workflows)统一持久化保存在本地 `database.sqlite` 文件中,该文件默认位于用户主目录下的 `.autogenstudio` 隐蔽文件夹内,支持手动备份与路径迁移。
在 Windows 系统中使用 Microconda 运行 AutoGen Studio 2.0 时,您的全部开发成果——包括创建的技能(skills)、配置的智能体(agents)以及编排的工作流(workflows)——并不分散在多个 JSON 或 Python 文件中,而是集中存储于一个轻量级 SQLite 数据库文件:database.sqlite。
该数据库文件默认路径为:
%USERPROFILE%\.autogenstudio\database.sqlite
例如:
C:\Users\YourName\.autogenstudio\database.sqlite
✅ 为什么是 SQLite?
AutoGen Studio 采用嵌入式 SQLite 作为默认后端,兼顾轻量性、跨平台兼容性与事务安全性,避免依赖外部数据库服务,也便于单文件备份与迁移。
✅ 如何备份?
只需定期复制整个 .autogenstudio 文件夹(含 database.sqlite 及其可能存在的 logs/、files/ 等辅助目录),即可完整保存您的开发状态:
# 示例:使用 PowerShell 快速压缩备份(运行前请替换 YourName) Compress-Archive -Path "$env:USERPROFILE\.autogenstudio" -DestinationPath "autogen-backup-$(Get-Date -Format 'yyyyMMdd-HHmm').zip"
✅ 能否自定义存储路径?
当前 AutoGen Studio 2.0 未提供图形界面或命令行参数直接指定数据库路径,但可通过环境变量 AUTOGENSTUDIO_HOME 实现路径重定向:
- 在启动 AutoGen Studio 前,设置该环境变量指向您期望的根目录(如 D:\dev\autogen-workspace);
- 确保该目录下存在可写入的 .autogenstudio 子目录;
- 启动后,database.sqlite 将自动创建于该自定义路径中。
# PowerShell 设置示例 $env:AUTOGENSTUDIO_HOME="D:\dev\autogen-workspace" autogenstudio start
⚠️ 重要注意事项:
- 删除 database.sqlite 文件等同于执行「工厂重置」:所有 agent 配置、skill 定义、workflow 图谱及对话历史将不可恢复地清除;
- 不建议直接编辑该 SQLite 文件——结构由 AutoGen Studio 内部管理,手动修改可能导致数据损坏;
- 若需版本化管理(如 Git),建议仅将导出的 Skill YAML/JSON 模板、Agent 配置片段或 Workflow DSL 脚本纳入仓库,而非 database.sqlite(二进制文件无法 diff,且含敏感上下文);
- 视频教程(youtu.be/X6pP9zyfkyY?t=353)中演示的重置操作,正是基于删除此文件实现的全量清理。
总之,database.sqlite 是您 AutoGen Studio 项目数据的唯一事实来源(single source of truth)。理解其位置、作用与管理方式,是保障开发连续性与工程可维护性的关键一步。










