AutoGen 2.0 工作流与技能数据存储位置详解

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 实现路径重定向：

1. 在启动 AutoGen Studio 前，设置该环境变量指向您期望的根目录（如 D:\dev\autogen-workspace）；
2. 确保该目录下存在可写入的 .autogenstudio 子目录；
3. 启动后，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）。理解其位置、作用与管理方式，是保障开发连续性与工程可维护性的关键一步。