Symfony AI 0.15: Aktueller Stand, Versionen und was Sie für produktive Projekte beachten sollten

Stand: 09.11.2026, Symfony AI v0.15 released, 1.0.0-BETA1 seit 26.10.2026 verfügbar, stabiler Stand weiterhin 0.x (experimentell), kein Termin für 1.0.0 final

Versionsstand der Symfony-AI-Pakete

Symfony AI wird als Monorepo entwickelt und in einzelne Pakete gesplittet. Diese Pakete haben nicht immer denselben Versionsstand. Zum Redaktionszeitpunkt ergibt sich folgendes Bild:

Mit 0.15 stehen GitHub-Release und die Pakete auf Packagist wieder auf derselben Nummer. Die Datumsangabe weicht um einen Tag ab, weil Packagist den Zeitpunkt des Tags in UTC zeigt und die Release-Notes erst am Folgetag erschienen. Für Ihr Projekt zählt der Stand, den Composer tatsächlich auflöst, nicht die Nummer auf der Release-Seite.

# Welche Symfony-AI-Pakete sind installiert und in welcher Version?
composer show "symfony/ai-*"

# Welche Versionen stehen zur Verfügung?
composer outdated "symfony/ai-*"

Die Bausteine im Überblick

Symfony AI besteht aus mehreren Komponenten, die sich einzeln einsetzen lassen. Die Platform-Komponente bildet die Abstraktion über die verschiedenen Modellanbieter. Die Agent-Komponente baut darauf auf und ergänzt Tool-Aufrufe sowie die Verarbeitung von Nachrichtenverläufen. Die Store-Komponente kümmert sich um Vektorspeicher für Retrieval-Szenarien. Die Chat-Komponente verwaltet in 0.15 noch Gesprächsverläufe, mit 1.0.0-BETA1 wird sie abgelöst (siehe unten). Über das AI Bundle und das MCP Bundle werden die Komponenten in eine Symfony-Anwendung integriert.

Das folgende Beispiel zeigt das Grundprinzip eines Agent-Aufrufs. Es ist als Illustration gedacht: Konstruktor-Signaturen und Klassennamen haben sich in der 0.x-Phase mehrfach geändert. Prüfen Sie die Dokumentation zu genau der Version, die Sie installiert haben.

use Symfony\AI\Agent\Agent;
use Symfony\AI\Platform\Message\Message;
use Symfony\AI\Platform\Message\MessageBag;

// $platform kommt aus der Bundle-Konfiguration oder einer Factory des Anbieters.
// Wie das Modell übergeben wird, unterscheidet sich je nach 0.x-Version.
$agent = new Agent($platform, $model);

$messages = new MessageBag(
    Message::forSystem('Du fasst Support-Tickets in zwei Sätzen zusammen.'),
    Message::ofUser($ticketText),
);

$result = $agent->call($messages);
echo $result->getContent();

Im Alltag empfiehlt es sich, solche Aufrufe hinter einem eigenen, schmalen Service zu kapseln. Ändert sich die API in der nächsten Minor-Version, passen Sie dann eine Stelle an und nicht jeden Controller.

Neu in 0.15 (Status: released)

Fehler, bei denen sich ein neuer Versuch lohnt, implementieren jetzt das RetryableExceptionInterface, darunter ServerException und RateLimitExceededException. Das macht die Failover-Logik präziser, weil sie zwischen vorübergehenden und dauerhaften Fehlern unterscheiden kann.

Modelle von Hugging Face werden über die Hub API aufgelöst. Die Decision-Typen liegen in einer eigenen Decision-Bridge, und Ollama unterstützt Decision-Modelle. asObject() nimmt optional einen Klassennamen an, damit PHPStan und Psalm den Rückgabetyp kennen. Die Perplexity-Anbindung nutzt statt Sonar Chat Completions jetzt die Agent API.

Breaking Change für Tests: InMemoryPlatform ist entfernt, Ersatz ist MockPlatformFactory. Wer in Tests mit der InMemoryPlatform gearbeitet hat, muss diese beim Update auf 0.15 umstellen.

1.0.0-BETA1 (Status: Beta)

Seit dem 26.10.2026 gibt es auf Packagist eine erste 1.0.0-BETA1 für symfony/ai-agent, ai-platform, ai-store und ai-bundle. symfony/ai-chat ist noch nicht dabei. Für produktive Projekte empfehle ich, auf ~0.15.0 zu bleiben und die Beta in einem eigenen Branch zu testen.

Der wichtigste Satz der Ankündigung vom 26.10.2026 betrifft die Abwärtskompatibilität: „The backward compatibility promise starts at 1.0.0 final, not at this tag.“ Das BC-Versprechen gilt also erst ab 1.0.0 final, nicht für die Beta. Symfony nutzt die Beta-Phase ausdrücklich als letztes Fenster für Änderungen, die sich als nötig erweisen. Laut Ankündigung steht der Funktionsumfang für 1.0 fest, ab jetzt geht es um Korrekturen statt um Umbauten.

Parallel läuft vom 26.10. bis 22.11.2026 der Symfony AI & MCP Hackathon. Er findet online statt und soll mit Symfony AI und dem offiziellen PHP MCP SDK aufdecken, was vor 1.0 noch nicht stimmt. Einen Termin für 1.0.0 final nennt Symfony nicht. Seit BETA1 ist laut GitHub-Release-Liste kein weiteres Release erschienen (Stand 09.11.2026).

Umbau in 1.0.0-BETA1: Chat geht in Agent auf

Die Release Notes von 1.0.0-BETA1 enthalten einen Umbau, der bestehende Projekte mit Gesprächsverläufen betrifft. Mit PR #2812 („Move the message store bridges to the Agent component and deprecate Chat“) wandern die Message-Store-Bridges in die Agent-Komponente, die Chat-Komponente wird deprecated. PR #2815 („Remove the Chat component“) entfernt sie anschließend samt der chat-Option im AI Bundle und der Profiler-Integration. Beide Änderungen sind laut PR als BC-Break in der UPGRADE.md dokumentiert.

Für Projekte auf 0.15 ändert sich dadurch nichts, solange Sie nicht auf die Beta wechseln. Wer symfony/ai-chat einsetzt, sollte den Wechsel auf 1.0 aber als eigene Aufgabe einplanen und die Upgrade-Hinweise vorab lesen.

Der Weg bis 0.15

Symfony AI hat sich seit dem Start in kurzen Abständen weiterentwickelt. Die folgenden Stationen habe ich in früheren Beiträgen behandelt, die jetzt in diesem Artikel aufgehen.

Frühe Versionen: Platform-Bridges und Failover (Status: released, überholt)

Die ersten 0.x-Versionen erschienen zusammen mit Symfony UX 2.32 und legten die Grundlage für die Anbindung mehrerer Modellanbieter über Platform-Bridges. Mit 0.2 kam ein Failover-Mechanismus hinzu, der bei Ausfall eines Anbieters auf einen anderen umschaltet. In 0.3 folgten unter anderem eine DeepSeek-Anbindung und ein Cache-Layer für Antworten. Diese Versionen sind heute nur noch historisch relevant.

MCP Bundle und lokale Modelle (Status: released)

Mit Version 0.5 kamen das MCP Bundle und ein Ollama-Tool dazu. Darüber lassen sich Symfony-Anwendungen als MCP-Server bereitstellen und lokal betriebene Modelle anbinden. Für Projekte, die aus Datenschutzgründen keine externen Modelle nutzen dürfen, ist die Ollama-Anbindung der interessantere Teil.

0.6: Vergleich mit Neuron AI und AI Mate (Status: released, überholt)

Zum Stand von 0.6 hatte ich Symfony AI mit Neuron AI 3.3 verglichen. Parallel erschien AI Mate 0.6.0 zusammen mit den Symfony UX Skills. Der damalige Vergleich ist durch die weitere Entwicklung beider Projekte inzwischen überholt, die Grundfrage bleibt aber dieselbe: Symfony AI integriert sich tiefer in das Framework, Neuron AI ist framework-unabhängiger.

0.8: Breitere Anbieterunterstützung (Status: released, überholt)

Version 0.8 baute die Failover-Logik über eine deutlich größere Zahl von Modellanbietern aus. Wer damals auf 0.8 gesetzt hat, sollte prüfen, welche Konfigurationsoptionen sich bis 0.15 verändert haben.

Was sich seit dem letzten Update geändert hat

1. Update 09.11.2026: Seit 1.0.0-BETA1 vom 26.10.2026 ist kein weiteres Release erschienen. Der Stand bleibt BETA1, der Hackathon läuft bis 22.11.2026.
2. Neu ist der Abschnitt zum Umbau in BETA1: Die Message-Store-Bridges wandern in die Agent-Komponente, die Chat-Komponente wird deprecated und entfernt (PR #2812 und #2815).
3. Unverändert: Ein Termin für 1.0.0 final ist nicht angekündigt.

Einordnung für bestehende Projekte

Die entscheidende Eigenschaft von Symfony AI ist im Moment die 0.x-Versionierung. Nach den Regeln der semantischen Versionierung können zwischen 0.14 und 0.15 Breaking Changes liegen, ohne dass das als Regelverstoß gilt. Für Ihr Projekt folgen daraus drei praktische Regeln.

Pinnen Sie die Versionen in der composer.json auf eine konkrete Minor-Version statt auf einen offenen Bereich. Kapseln Sie die Symfony-AI-Aufrufe hinter eigenen Interfaces, damit ein Upgrade lokal bleibt. Und sichern Sie die KI-Funktionen mit Tests ab, die auch ohne echten Modellaufruf laufen, etwa über die MockPlatformFactory oder eigene Fakes.

{
    "require": {
        "symfony/ai-agent": "~0.15.0",
        "symfony/ai-platform": "~0.15.0"
    }
}

Die Tilde mit drei Stellen erlaubt nur Patch-Updates innerhalb der Minor-Version. Ein Wechsel auf 0.16 oder 1.0 passiert dann nur, wenn Sie ihn bewusst anstoßen.

Wie Symfony AI mit KI-Assistenten im Entwicklungsalltag zusammenspielt, beschreibe ich im Artikel zu Symfony Mate und Laufzeit-Kontext für KI-Assistenten. Welche Rolle die gewählte Symfony-Version dabei spielt und wie oft ein Team realistisch upgraden kann, behandelt der Artikel Symfony LTS oder aktuelle Version.

Dieser Artikel wird mit dem stabilen 1.0-Release aktualisiert.

Dennis Schwenker-Sanders ist PHP- und Symfony-Entwickler und begleitet die Integration von KI-Funktionen in Symfony-Anwendungen für Agenturen und Entwicklerteams im DACH-Raum.