Symfony AI v0.2.0 正式发布！

概述

Symfony AI v0.2.0 版本已于 2026年1月10日 正式发布！

这是继 v0.1.0 之后的第一个重要更新版本，主要集中在 Mate（开发助手）、Platform（模型平台）、Store（向量存储）、Chat/Agent 等组件的改进、bug修复、新功能添加以及更好的兼容性。

主要亮点（Highlights）

• • Mate 组件大幅改进（CLI命令描述、SF5.4/SF6.4兼容性、调试命令、错误处理等）
• • 增加了更多平台支持和优化（Whisper verbose、Gemini 示例、OpenRouter streaming & 结构化输出、VertexAI API Key认证等）
• • 向量存储接口变更（StoreInterface::add() 参数调整）
• • 新增 FailoverPlatform（故障转移平台）
• • 修复了大量 CI、类型、依赖、CS 规范问题
• • Demo 和示例持续完善（bundle、chroma recipe、Google 最新模型等）

详细变更分类（部分重要条目）

新增功能

• • Mate：CLI 命令添加描述、debug:capabilities / debug:extensions 命令
• • Platform：Whisper 支持 verbose 输出、FailoverPlatform（故障转移）
• • OpenRouter：支持 streaming 和结构化输出
• • VertexAI：支持 API Key 认证
• • Chat：Message normalizer 支持 document
• • Store：force 选项描述更新
• • AI Bundle：允许通过 bundle 配置 platform（TransformersPhp 等）

改进 & 重构

• • Mate：使用 compiled container、支持 _composer_autoload_path、大量重构（ContainerFactory、ComposerExtensionDiscovery 等）
• • Store：add() 方法参数改为 VectorDocument|array（不再是 variadic）
• • Platform：StructuredOutput 更好的错误处理、ToolNormalizer 对 nullable 类型处理优化
• • 很多组件移除 variadic 参数、使用更现代的方式

兼容性 & 修复

• • 支持 Symfony 5.4 和 6.4（Mate）
• • 修复 Cloudflare 向量存储分页、keys 访问问题
• • Doctrine DBAL 4 兼容性修复（MariaDB/PostgreSQL store）
• • 移除冗余依赖、更新 doctor-rst、PHP-CS-Fixer 等工具链

其他

• • CI 流程改进、GitHub PR 自动关闭模板
• • Demo 应用添加 bundle & chroma recipe
• • 大量代码风格、静态分析、测试覆盖率提升

如果你正在使用 Symfony AI 做 Agent、RAG、聊天机器人等开发，建议尽快升级到 0.2.x 版本，能获得更好的稳定性、更多功能和未来的兼容性准备。

官方 Release 地址： https://github.com/symfony/ai/releases/tag/v0.2.0

Happy coding with Symfony AI! 🚀