Ton équipe a probablement déjà un appel LLM en production. Un client HTTP, un prompt dans un service, un peu de JSON décodé à la main. Ça marche. Puis arrivent le deuxième fournisseur, le premier outil exposé au modèle, l’historique de conversation à persister, et le service « temporaire » devient une couche d’infrastructure que personne n’a conçue. Symfony AI promet de remplacer ça par des briques standard. Mais le monorepo est passé de la v0.1.0 (23 décembre 2025) à la v1.0.0-BETA1 (26 octobre 2026) en seize versions, et jusqu’ici chaque package était experimental, donc hors promesse de rétrocompatibilité.
Le vrai sujet n’est donc pas « est-ce que ça existe ? », mais « quelle partie peut porter du code que tu devras maintenir trois ans ». Symfony AI est un monorepo de quatre composants PHP (Platform, Agent, Store, Mate) et de deux bundles (AI Bundle, MCP Bundle) qui permettent d’appeler des LLM, de bâtir des agents et de faire du RAG dans une application Symfony. Ces six briques ne sont pas au même stade, et la roadmap officielle le montre sans détour. Cet article pose la carte, mesure l’écosystème et sépare ce qui se stabilise de ce qui bouge encore, pour décider composant par composant plutôt que de miser sur l’ensemble.
BETA1, pas 1.0 : ce que le statut promet vraiment
Au 2 novembre 2026, la dernière version publiée de symfony/ai est la v1.0.0-BETA1, taguée le 26 octobre 2026 après quinze versions 0.x. Une BETA n’est pas une version stable. Tant que la 1.0 n’est pas taguée, les paquets restent experimental et la promesse de rétrocompatibilité de Symfony ne s’applique pas. L’idée elle-même n’est pas neuve : elle remonte à l’annonce de l’initiative Symfony AI à l’été 2025.
L’équipe l’assume dans l’issue de suivi #1301 « Road to Symfony AI v1.0 ». Les releases sont volontairement découplées de symfony/symfony tant que des défauts de conception imposent des ruptures de BC. Quand tous les points de la liste seront traités, un gel des fonctionnalités d’environ quatre semaines stabilisera le code avant la 1.0. Aucune date n’est annoncée.
La carte : quatre composants, deux bundles
Avant de juger la maturité, il faut savoir ce que le monorepo contient réellement. Voici le rôle de chaque brique, puis leurs dépendances réelles.
- Platform (
symfony/ai-platform) : l’interface unifiée vers les modèles et leurs fournisseurs. Elle gère les messages, les capacités des modèles, les résultats, le streaming et les embeddings. C’est la fondation. - Agent (
symfony/ai-agent) : la construction d’agents au-dessus de Platform. On y trouve les tools, la boucle d’appels d’outils, la mémoire et, depuis la BETA1, les message stores. - Store (
symfony/ai-store) : l’abstraction de stockage de documents vectorisés pour le RAG, avec stores, loaders, transformers, indexers et retrievers. - Mate (
symfony/ai-mate) : une CLI de développement qui donne aux agents de code (Claude Code, Codex, Cursor…) des outils qui connaissent ton projet. - AI Bundle (
symfony/ai-bundle) : l’intégration Symfony de Platform, Agent et Store. Elle apporte la configuration YAML, l’autowiring, les commandes console et le profiler. - MCP Bundle (
symfony/mcp-bundle) : l’intégration du SDK officielmcp/sdk. Ton application peut être serveur MCP, client MCP, ou les deux, en STDIO ou en HTTP.
Pour voir Platform à l’œuvre, de l’appel unique à la bascule de fournisseur, lis Symfony AI Platform : une seule API pour tous tes LLM. Ici, on reste au niveau de la carte.
Les dépendances Composer du tag BETA1 sont plus simples qu’on ne l’imagine. symfony/ai-agent et symfony/ai-store requièrent chacun symfony/ai-platform en ^1.0 : Platform est le socle commun. L’AI Bundle ne requiert que Platform. Agent et Store sont donc à ajouter explicitement, selon ce que tu utilises, comme le fait la documentation officielle avec composer require symfony/ai-bundle symfony/ai-agent.
Mate ne dépend pas de Platform. Il demande les composants Config, Console et DependencyInjection, et accepte Symfony à partir de 5.4. Il fonctionne donc sur un projet qui n’utilise aucune IA générative dans son code métier. Le MCP Bundle est lui aussi indépendant : il dépend de mcp/sdk en ^0.9, un SDK séparé du monorepo et encore pré-1.0. Le pont entre les deux mondes est le paquet symfony/ai-mcp-tool, qui permet à un agent d’utiliser les outils d’un serveur MCP distant. Le protocole lui-même est résumé dans le point sur MCP en 2026.
Une précision sur Mate : ce n’est pas un serveur MCP de production. La documentation le décrit comme une CLI (vendor/bin/mate) que l’agent appelle comme n’importe quelle commande shell. Il lit le conteneur compilé, le profiler et les logs sur disque, sans booter l’application. Il répond donc même quand ton application ne démarre plus.
Maturité composant par composant : ce que dit la roadmap #1301
Une carte dit ce qui existe ; la roadmap dit ce que l’équipe elle-même considère comme non fini. Elle classe les points selon la méthode MoSCoW, et le libellé MUST signale un impact attendu sur l’API publique du composant. Ce sont ces points qui annoncent de futures ruptures, donc ceux qui comptent pour toi. Lecture d’après l’état de l’issue au 26 octobre 2026 :
- Platform : le plus avancé. Les quatre
MUSTsont cochés : catalogues de modèles dynamiques, cycle de vie des modèles, streaming du raisonnement, réponses multimodales (voix, image, vidéo). Restent desSHOULDetCOULD: capabilities dans le routage, renommage deModelClientenApiClient, options normalisées, hiérarchie d’exceptions. - Agent : le chantier ouvert. Trois
MUSTrestent décochés : une API d’agent repensée (nom, instruction, tools, entrée, options) au lieu d’un simple décorateur de Platform, des traces intégrées d’origine, et le repli de la gestion d’état dans Agent. Côté livré : prévention des boucles d’outils, agent client MCP, métadonnées d’effet des tools, cookbook human-in-the-loop. C’est ici que les ruptures de BC restent les plus probables. - Store : à mi-chemin.
StoreFactory, les clients scopés et le périmètre deStoreInterfacesont faits. DeuxMUSTrestent ouverts : des points d’extension de retrieval (requêtes multi-vecteurs, reranking) et le fonctionnement natif avec entités et repositories, que la BETA1 entame avec un store Doctrine ORM. - Mate : son
MUSTest coché. L’intégration par plugin Composer est livrée, et la BETA1 ajoute des formatters de profiler pour le routeur et la configuration. - AI Bundle : un seul point ouvert, un
SHOULDqui vise à découper le panneau du profiler par composant, avec une trace unifiée pour l’agent.
La roadmap place aussi hors du périmètre de la 1.0 l’évaluation d’agents, les protocoles A2A et AG-UI, l’intégration OpenTelemetry et le routage multi-plateformes. Si une observabilité standardisée conditionne ton adoption, elle n’arrivera pas avec la 1.0.
Un détail de lecture : dans l’issue, la ligne « replier l’état dans Agent et déprécier Chat » apparaît non cochée, alors que les notes de la BETA1 déplacent les message stores vers Agent (#2812) et suppriment le composant Chat (#2815). La liste est en retard sur le code. Fie-toi aux notes de release.
L’étendue de l’écosystème : bridges Platform et Store
Chaque fournisseur est un paquet Composer séparé, par exemple symfony/ai-open-ai-platform ou symfony/ai-postgres-store. Le dépôt compte plus de quarante bridges Platform et plus de vingt bridges Store. Les chiffres exacts varient de quelques unités selon qu’on compte les dossiers du tag ou les paquets publiés sur Packagist.
Côté Platform : OpenAI, Anthropic, Gemini, Vertex AI, Azure, Bedrock, Mistral, DeepSeek, Cohere, Perplexity, OpenRouter, Hugging Face, Ollama, LM Studio, Docker Model Runner, Scaleway, OVH, ainsi que Failover, Cache et Generic pour tout service compatible OpenAI. On y trouve aussi des bridges audio et vidéo (ElevenLabs, Deepgram, Cartesia, Decart, Higgsfield). Les options auto-hébergées ou européennes pèsent dans un arbitrage de souveraineté.
Côté Store : Postgres, MariaDB, SQLite, Doctrine, Redis, MongoDB, Elasticsearch, OpenSearch, Meilisearch, Typesense, Qdrant, Pinecone, Weaviate, Milvus, ChromaDb, ClickHouse, Neo4j, Supabase, Cloudflare, S3 Vectors, SurrealDb et d’autres. Tu peux donc faire du RAG sur le Postgres ou le MariaDB que tu opères déjà, sans nouvelle brique d’infrastructure.
Les chiffres impressionnent, mais un catalogue large ne prouve ni la profondeur des intégrations ni leur suivi dans le temps. Un bridge récent n’a pas la maturité du bridge OpenAI. Teste le tien avec ton modèle et les fonctionnalités dont tu as besoin (streaming, tool calling, sortie structurée) avant de t’y engager.
Installation et configuration minimale avec l’AI Bundle
Migration Symfony en vue ?
Bear Upgrade migre votre codebase 2,5× à 4,5× moins cher qu'une ESN, selon sa maturité.
Le bundle exige PHP 8.2 ou plus et Symfony ^7.3|^8.0. Il faut aussi le paquet Agent et le bridge du fournisseur choisi. Comme la BETA1 n’est pas stable, ton projet doit accepter ce niveau de stabilité dans Composer :
# Autoriser les versions beta, en préférant le stable pour le reste
composer config minimum-stability beta
composer config prefer-stable true
# Bundle + composant Agent + bridge du fournisseur (ici OpenAI)
composer require symfony/ai-bundle symfony/ai-agent symfony/ai-open-ai-platformLa configuration minimale tient en quelques lignes. Les clés platform, agent, model et tools viennent de la documentation du tag BETA1 :
# config/packages/ai.yaml
ai:
platform:
openai:
api_key: '%env(OPENAI_API_KEY)%'
agent:
default:
model: 'gpt-4o-mini'
tools: true # opt-in : injecte les services tagués ai.toolDeux points à retenir. D’abord, les tools sont opt-in : sans clé tools, ou avec false, null ou une liste vide, l’agent n’a aucun outil. Tu peux aussi lister les services explicitement plutôt que de passer true, ce qui est préférable dès qu’un outil écrit quelque chose. Ensuite, la BETA1 ajoute une option model_catalog par plateforme, pour fournir son propre catalogue de modèles, avec ou sans cache.
Côté PHP, tu injectes l’agent par son interface. Ce code reprend celui du démarrage rapide de la documentation :
<?php
declare(strict_types=1);
namespace App\Agent;
use Symfony\AI\Agent\AgentInterface;
use Symfony\AI\Platform\Message\Message;
use Symfony\AI\Platform\Message\MessageBag;
final readonly class ChatService
{
public function __construct(private AgentInterface $agent)
{
}
public function chat(string $userMessage): string
{
$messages = new MessageBag(
Message::forSystem('Tu es un assistant concis.'),
Message::ofUser($userMessage),
);
// call() renvoie un résultat ; getContent() en extrait le texte
return $this->agent->call($messages)->getContent();
}
}Pour le MCP, composer require symfony/mcp-bundle ajoute une section mcp (servers et clients) dans config/packages/mcp.yaml, plus une entrée de routage type: mcp. Mate, lui, s’installe en développement uniquement, avec composer require --dev symfony/ai-mate puis vendor/bin/mate init : la documentation précise qu’il ne doit pas être déployé en production.
Les pièges de la BETA1
Reste le critère que tout CTO regarde en premier : que se passe-t-il à la montée de version, quand on a seize releases en dix mois derrière soi ? La BETA1 apporte son lot de changements à connaître avant d’écrire la première ligne.
- Noms uniques. Les noms de stores doivent être uniques tous types confondus, de même que ceux des message stores. Chaque nom devient un alias d’autowiring, et les alias préfixés par le type ont disparu.
- Chat supprimé. Si tu utilisais le composant Chat en 0.x, les message stores vivent désormais dans Agent. Prévois la migration.
MessageBagimmuable. La BETA1 le rend immuable et sérialisable sans perte. Tout code qui le modifiait en place est à revoir.- Tool filesystem plus strict. Il refuse par défaut les extensions traitées par PHP, ce qui évite qu’un agent écrive du code exécutable.
- Doctrine. Pour les stores en base de données, exclus les tables de l’IA de la gestion de schéma Doctrine avec
schema_filtersousdoctrine.dbal. - Un SDK MCP lui aussi pré-1.0. Le MCP Bundle s’appuie sur
mcp/sdken^0.9: deux couches bougent en même temps.
Dans tous les cas, épingle les versions exactes. Avec une BETA et une roadmap qui annonce encore des MUST sur l’API d’Agent, une mise à jour automatique peut casser un build sans prévenir.
Qui devrait regarder Symfony AI maintenant
De là, la question se pose brique par brique plutôt qu’en bloc. À regarder dès maintenant :
- les équipes Symfony qui préparent un premier cas d’usage IA (assistant interne, extraction structurée, RAG sur une base existante) : un prototype ou un outil interne supporte le risque de rupture, et le coût de migration reste faible tant que l’intégration est mince et isolée derrière une interface à toi ;
- celles qui veulent éviter le verrouillage fournisseur et garder la possibilité de changer de modèle ou de passer sur un hébergement souverain ;
- toute équipe qui utilise des agents de code sur une grosse base Symfony : Mate se teste en développement seul, sans toucher à la production ;
- les contributeurs : le projet accepte les retours, et le gel des fonctionnalités n’a pas commencé.
À laisser mûrir :
- les systèmes critiques en production qui exigent une promesse de BC écrite ;
- les projets dont l’architecture dépend de l’API d’Agent, encore en refonte (
MUSTouvert) ; - les besoins d’observabilité normalisée (OpenTelemetry) ou d’évaluation d’agents, explicitement hors périmètre de la 1.0.
Pour le RAG, un premier pipeline existe déjà dans un pipeline RAG avec PgVector et Claude Sonnet 4, écrit sur une version antérieure : le principe tient, mais l’API a changé depuis.
Ce qu’il faut retenir
Retiens trois choses. Symfony AI n’est pas un bloc : on adopte des briques, pas un framework entier, et leur maturité diffère, avec une fondation Platform aboutie dans sa conception et une couche Agent encore en chantier. La BETA1 n’est pas la 1.0 : tant que les points de la #1301 ne sont pas traités puis gelés, la rupture de BC reste possible, et la suppression du composant Chat dans cette même BETA est là pour te le rappeler. Enfin, le catalogue de bridges est large, mais ce chiffre mesure le nombre d’intégrations, pas leur niveau de finition.
Action concrète pour cette semaine : liste les appels LLM de ton code, associe chacun à une brique de la carte (Platform pour l’appel, Store pour la recherche vectorielle, Agent pour les outils et la mémoire), puis note ce que tu couvrirais aujourd’hui et ce que tu laisserais derrière une interface à toi. Épingle la version exacte dans composer.json et relis les notes de release à chaque montée. La suite de cette série détaille les nouveautés de la 0.1 à la 1.0-BETA1, puis chaque brique en profondeur.
Avant de brancher quoi que ce soit de Symfony AI, vérifie aussi que ton socle suit : version de PHP, version de Symfony, dépendances à jour. C’est le prérequis le plus souvent négligé, et c’est un travail que je fais déjà sur des applications en production, détaillé sur la page Bear Upgrade.

Écrit par
Flavien Métivier
Expert PHP/Symfony indépendant depuis 2014, ancien CTO de Kartable et d'Extrabat. Plus de 80 projets menés, de l'audit à la migration.
Mon parcours