第六章：Multi-Backend Configuration
Chapter 6: Multi-Backend Configuration
从交响乐团到变形金刚：如何让代理适应不同环境？
在上一章任务工作流编排，我们学会了如何像指挥家一样协调任务。但就像变形金刚能切换不同形态应对环境变化一样，你的AI代理也需要能灵活切换存储、数据库和部署环境。本章将教你如何用多后端配置让代理像变形金刚一样“一机多用”！
核心使命：让代理适应不同场景
想象你开发了一个文件管理助手：
- 开发阶段：希望文件保存在本地硬盘方便调试
- 测试阶段：需要把数据备份到云端S3存储桶
- 生产环境：必须连接企业内部数据库
多后端配置就是这个“变形开关”：
✅ 通过简单配置切换存储类型（本地/S3/GCS）
✅ 改变数据库连接方式（SQLite/MySQL）
✅ 切换部署环境（开发/测试/生产）
核心概念拆解：变形金刚的三块“能量模块”
1. 配置文件：变形指令手册
就像变形金刚的指令手册，config.yaml记录了不同环境的配置：
# 示例配置文件
storage:backend: "local" # 可选值："local", "S3", "GCS"root_path: "/data" # 文件存储根目录database:type: "sqlite" # 可选值："sqlite", "mysql"connection: "db.sqlite" # SQLite文件路径/MySQL连接串environment: "dev" # 环境标识：dev/test/prod
2. 环境变量：实时切换开关
通过设置环境变量覆盖配置文件：
# 切换到S3存储的示例命令
export STORAGE_BACKEND="S3"
export AWS_ACCESS_KEY="your_key"
3. 抽象层：通用接口适配器
# 文件存储抽象类（来自03章）
class FileStorage(ABC):@abstractmethoddef read_file(self, path: str) -> str:pass
实战演练：让代理在云端与本地间变形
场景：开发时用本地存储，测试时用S3
目标：
- 在开发环境保存文件到本地
- 在测试环境自动切换到S3存储
步骤1：编写配置文件
# config.yaml
storage:backend: "{{env STORAGE_BACKEND}}"root_path: "/data"
步骤2：设置环境变量
# 开发环境：使用本地存储
export STORAGE_BACKEND="local"# 测试环境：使用S3
export STORAGE_BACKEND="S3"
export AWS_ACCESS_KEY="AKIAXXXXXXXXXXX"
export AWS_SECRET_KEY="XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
步骤3：启动代理
./run agent start MyFileManager
预期结果：
- 开发模式：文件保存在本地
/data目录 - 测试模式：文件自动上传到S3存储桶
内部运作：变形的魔法过程
以切换存储后端为例，流程如下：
关键代码片段（来自file_storage/__init__.py）
def get_storage(backend: str, **kwargs) -> FileStorage:match backend:case "local":from .local import LocalFileStoragereturn LocalFileStorage(...) # 使用本地配置case "S3":from .s3 import S3FileStoragereturn S3FileStorage(...) # 使用AWS密钥
深度解析：如何优雅切换数据库
以切换数据库为例：
# 配置文件示例
database:type: "{{env DB_TYPE}}"mysql: host: "localhost"port: 3306
通过以下方式实现：
# 数据库适配器示例
def get_database():config = load_config()match config["type"]:case "sqlite":return SQLiteDB(":memory:")case "mysql":return MySQLDB(config["mysql"]["host"], ...)
总结与展望
通过本章，你已掌握：
✅ 如何通过配置文件和环境变量切换后端
✅ 理解抽象层如何隔离具体实现
✅ 让代理像变形金刚一样灵活应对不同环境
下一章我们将学习如何保护代理的数据安全——工作区安全，教你为代理设置“安全防护罩”！