[PHP] Symfony AI v0.2.0发布：全面升级开发助手Mate与模型平台功能

概述

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 进行 AI Agent 或 RAG 聊天机器人等应用开发，建议尽快升级到 v0.2.x 版本，以获得更佳的稳定性、更丰富的功能支持，并为未来的框架升级做好准备。

你可以在 GitHub 上查看完整的官方 Release 说明和代码变更： https://github.com/symfony/ai/releases/tag/v0.2.0

Happy coding with Symfony AI! 🚀

想要了解更多前沿的 AI 开发实践和开源项目动态，欢迎关注 云栈社区 的相关技术讨论。