KI-Analyse9 Min. Lesezeit

TanStack AI 1.0 erleichtert den Modellwechsel und macht die Verantwortung der Anwendung deutlicher

TanStack AI 1.0 stabilisiert den Kern, während das Agenten-Harness experimentell bleibt. Ein praktischer Blick auf Anbieterwechsel, drei Anwendungsszenarien und die sorgfältige Migration von 0.x.

K
Ken Jo

Erklärende Grafik: TanStack AI 1.0 erleichtert den Modellwechsel und macht die Verantwortung der Anwendung deutlicher

Eigene redaktionelle Grafik von Ken Jo auf Grundlage der unten aufgeführten Quellen.

Ein Modellwechsel sollte eine Produktentscheidung sein. In einer Anwendung mit angesammelten anbieterspezifischen Nachrichtenformaten, Browserzuständen und Tool-Callbacks kann daraus jedoch ein Migrationsprojekt werden, bevor jemand die neuen Antworten vergleicht.

TanStack AI 1.0, angekündigt am 23. Oktober 2026, macht an dieser Grenze eine konkrete Zusage: stabile Kern-APIs, 23 Anbieteradapter und Unterstützung mehrerer UI-Frameworks. Das neue Agenten-Harness bleibt experimentell. Wer heute eine Entwicklungsgrundlage wählt, sollte diese Unterscheidung ernster nehmen als die Versionsnummer. TanStacks Ankündigung.

TanStack entwickelt Open-Source-Bibliotheken für Anwendungsentwickler. Diese Veröffentlichung betrifft die Software zwischen KI-Modell und Produkt: Antwortstreams, Tools, Oberflächen und Anwendungszustand. Wir betrachten das Portabilitätsversprechen, seinen Nutzen in drei gewöhnlichen Projekten und die Vorbereitung einer bestehenden 0.x-Anwendung auf das Upgrade.

Offizielles AG-UI-Beispiel von TanStack mit React-Chatoberfläche und Python-Backend.

Offizielles TanStack-AG-UI-Beispiel, © 2025 Tanner Linsley, MIT-Lizenz. Das Bild zeigt die Beispieloberfläche des Projekts und dessen ausgewähltes Modell, keinen für diesen Artikel durchgeführten Lauf.

Eine gemeinsame Schnittstelle verkleinert den Anbieterwechsel

Ein Adapter übersetzt zwischen den Erwartungen der Anwendung und der API eines Anbieters. Entwickler erhalten einen einheitlichen Einstiegspunkt, um eine Modellantwort anzufordern und zu verarbeiten. Die Anwendung kann Gesprächsanzeige und Geschäftsregeln behalten und den anbieterseitigen Teil austauschen.

Diese Schicht ähnelt einer Vermittlungszentrale. Sie schafft verständliche Verbindungen, ohne alle Systeme am anderen Ende gleichzumachen. Das ist nützlich, weil sich Modelle, Hosting und Produktanforderungen unabhängig voneinander weiterentwickeln.

Die Ankündigung vom 23. Oktober nennt 23 Adapter sowie eine OpenAI-kompatible Option für Dienste mit diesem API-Format. Sie trennt außerdem den stabilen Kern von experimentellen Harness-Paketen. Das sind Zusagen zu Kompatibilität und Wartung, keine Garantie, dass jeder Anbieter jede Modellfunktion unterstützt. Umfang der Veröffentlichung.

Die unmittelbare Frage lautet deshalb: Welche Teile der aktuellen Anwendung überstehen einen Anbieterwechsel? Eine Antwortdarstellung lässt sich womöglich leicht übernehmen. Ein Ablauf, der auf Dateikennungen eines Anbieters, ungewöhnlichem Toolverhalten oder modellspezifischen Ausgabeannahmen beruht, kann weiterhin gezielte Änderungen erfordern.

Wir halten dies für die richtige Fortschrittseinheit. Portabilität ist wertvoll, wenn sie den erneut zu prüfenden Produktcode reduziert. Die Anzahl unterstützter Anbieter ist weniger aussagekräftig als der erfolgreiche Austausch genau jener Abhängigkeit, die ein reales Produkt ändern muss.

Was Erfolg bedeutet, entscheidet weiterhin die Anwendung

Eine gemeinsame API macht Entscheidungen zweier Modelle nicht gleichwertig. Eines hält strukturierte Ausgabevorgaben besser ein; ein anderes reagiert anders auf lange Gespräche oder mehrdeutige Toolergebnisse. Ein Adapter vereinheitlicht den Transport einer Anfrage, beweist aber nicht, dass ihre Antwort die Produktanforderungen erfüllt.

Daraus folgt eine konkrete Testregel: Anbieterintegration und akzeptables Produktverhalten getrennt prüfen. Eine korrekt abgeschlossene Anfrage bestätigt einen Vertrag. Eine richtige Antwort, die passende Toolwahl und eine verständliche Oberfläche bestätigen weitere.

Ein Supportassistent könnte beispielsweise ein Tool zum Abrufen einer Bestellung und eines zum Vorbereiten eines Erstattungsantrags haben. Beide Anbieter können diese auf Protokollebene korrekt aufrufen. Entscheidend ist, ob jedes Modell die richtige Aktion auswählt, dieselben Berechtigungen beachtet und das Ergebnis zutreffend beschreibt.

Verwenden Sie vor dem Wechsel einen kleinen, benannten Evaluationssatz. Er sollte unvollständige Anfragen, ungewöhnliche Eingaben, ein nicht verfügbares Tool und ein nach einem früheren Gesprächsschritt fortgesetztes Gespräch enthalten. Das ist ein vorgeschlagenes Entwicklungsverfahren, kein TanStack-Benchmark. Es macht die eigene Erfolgsdefinition wiederholbar.

Diagramm mit gemeinsamer Oberfläche und Geschäftsregeln, getrennt von Anbieteradaptern und Modellverhalten.

Ein Adapter kann den Verbindungsvertrag erhalten. Anwendungsspezifische Evaluationen zeigen, ob das Verhalten auf der anderen Seite weiterhin akzeptabel ist.

Drei Projekte zeigen verschiedene Formen von Portabilität

Betrachten wir zunächst eine bestehende Kundensupport-Anwendung. Konten, Berechtigungen und Gesprächsverläufe sind bereits vorhanden. Antwortstreams sollten in dieses Produkt passen, ohne Navigation oder Datenverantwortung zu ersetzen. Eine gemeinsame KI-Schicht ist attraktiv, wenn das Team bestehende Strukturen behalten und dahinter verschiedene Anbieter prüfen kann.

Beginnen Sie in diesem beispielhaften Projekt mit einer ausschließlich lesenden Hilfesuche. Prüfen Sie, ob Antworten die bereitgestellten Materialien zitieren und ob ein Abbruch einen nachvollziehbaren Gesprächszustand hinterlässt. Fügen Sie Aktionen erst hinzu, wenn die Oberfläche Vorschläge klar von abgeschlossenen Vorgängen unterscheidet. Bei einem späteren Modellwechsel sollten dieselben Prüfungen gelten.

Das zweite Szenario ist ein internes Schreibwerkzeug. Nutzer sollen einen Absatz markieren, eine Überarbeitung anfordern und sie mit dem Original vergleichen. Die Oberfläche ist ein Editor statt eines üblichen Chatfensters. Eine Integration ohne vorgegebene Oberfläche hilft, weil das Produkt selbst bestimmen muss, wo generierter Text erscheint und wann jemand ihn übernimmt.

Hier muss Portabilität die Arbeit der Nutzer bewahren. Überschreiben Sie einen Ausgangsabsatz nicht allein deshalb, weil ein Stream abgeschlossen wurde. Halten Sie den Vorschlag separat, ermöglichen Sie seine Prüfung und definieren Sie, wie abgebrochene oder fehlgeschlagene Generierungen verworfen werden. Dafür bleibt die Anwendung verantwortlich, unabhängig vom verwendeten SDK.

Das dritte Szenario betrifft ein Team mit einem vorhandenen Backend in einer anderen Sprache. TanStacks offizielles AG-UI-Beispiel verbindet einen React-Client per Server-Sent Events mit sechs möglichen Backendsprachen. Laut README sprechen diese Server das Übertragungsprotokoll, ohne serverseitige TanStack-Pakete zu benötigen. Offizielles mehrsprachiges Beispiel.

Damit wird Portabilität greifbar. Ein Team kann eine Browseroberfläche bewerten, ohne sofort ein funktionierendes Backend neu zu schreiben. Es muss weiterhin erwartete Ereignisse korrekt implementieren, den Endpunkt schützen und den Gesprächszustand eigenen Nutzern zuordnen. Ein kompatibles Protokoll zu demonstrieren ist der Anfang dieser Arbeit.

ProjektWas die gemeinsame Schicht erhalten kannWas die Anwendung prüfen muss
SupportassistentGesprächsanzeige und Grenze zur AnbieterintegrationQuellenrichtigkeit, erlaubte Toolaktionen und Fehlerbehebung
SchreiboberflächeStreamingmechanik im vorhandenen EditorOriginalerhalt, Übernahme, Abbruch und Überarbeitungsqualität
Bestehendes Backend ohne JavaScriptClient für ein gemeinsames EreignisprotokollEreignisfolge, Authentifizierung, Gesprächszuordnung und Speicherung

Diese Szenarien zeigen, weshalb es um mehr als den Vergleich von Chatbibliotheken geht. Entscheidend ist, wie viel vom Produkt schlüssig bleibt, wenn sich eine Komponente ändert. Selbst beim gleichen Modell sind für verschiedene Teams unterschiedliche Grenzen wichtig.

Stabiler Kern und experimentelles Harness brauchen getrennte Entscheidungen

Die Veröffentlichung macht die 1.0-Zusage für den Kern ausdrücklich, während das neue Agenten-Harness bei experimentellen 0.x-APIs bleibt. Dokumentieren Sie das als zwei verschiedene Abhängigkeitsentscheidungen. Beide zu installieren erweitert die Stabilitätszusage des Kerns nicht auf das Harness. Ankündigung vom 23. Oktober.

Bei begrenzten Funktionen ist ein einfacher Lebenszyklus oft leichter zu verstehen: Eine Anfrage trifft ein, das Modell arbeitet und die Anwendung verarbeitet das Ergebnis. Länger laufende Agenten werfen weitere Fragen auf: gleichzeitige Nachrichten, Wiederherstellung, gespeicherter Zustand und Aktionen über die Browserverbindung hinaus. Ein Harness bietet einen Ort, diese Themen zu ordnen.

Die Einstufung als experimentell ist eine Wartungsinformation, kein Grund, jeden Versuch zu vermeiden. Trennen Sie die Evaluation vom kritischen Produktpfad, benennen Sie Verantwortliche und planen Sie API-Änderungen ein. Ein Prototyp kann zeigen, ob die länger dauernde Interaktion nützt, bevor das Team ihren Betrieb übernimmt.

Wenn zunächst nur eine Streamingantwort in einer bestehenden Ansicht gebraucht wird, beginnen Sie dort. Ergänzen Sie Orchestrierung, sobald der Nutzerablauf sie verlangt. Eine reichhaltigere Abstraktion sollte ein konkretes Lebenszyklusproblem lösen und keine Voraussetzung für jede kleine KI-Funktion werden.

Mit einer kleinen, vollständigen Interaktion beginnen

Der aktuelle Schnellstart verbindet Serverroute, Anbieterzugangsdaten und eine frameworkspezifische Oberfläche. Das React-Beispiel nutzt einen serverseitigen Modellaufruf und SSE sowie eine explizite Gesprächskennung. Den API-Schlüssel hält die Dokumentation aus dem Browser heraus. Schnellstart, geprüft am 27. Oktober 2026.

Führen Sie für eine erste Evaluation die folgenden Schritte in einem separaten Entwicklungszweig aus. Ziel ist eine Interaktion, die das Team von der Anfrage bis zum Ergebnis untersuchen kann. Um die Eignung zu beurteilen, muss keine unbeteiligte Infrastruktur migriert werden.

  1. Wählen Sie eine bestehende Ansicht und eine begrenzte Aufgabe. Eine rein lesende Frage zu bereitgestellten Hilfematerialien lässt sich leichter prüfen als ein Ablauf, der sofort Kundendaten verändert.
  2. Installieren Sie die stabilen Pakete dieser Oberfläche gemeinsam. Für den dokumentierten React/OpenAI-Einstieg verwenden Sie npm i @tanstack/ai@^1 @tanstack/ai-react@^1 @tanstack/ai-openai@^1. Committen Sie die Lockdatei, damit die geprüften Versionen erkennbar bleiben.
  3. Implementieren Sie die Servergrenze nach dem aktuellen Schnellstart. Zugangsdaten bleiben in der Serverumgebung. Ordnen Sie die Anfrage einem authentifizierten Nutzer und einer von der Anwendung verantworteten Gesprächskennung zu.
  4. Zeigen Sie Streaming, Abschluss und Abbruch sichtbar an. Nutzer müssen erkennen, ob eine Antwort noch eintrifft, fertig ist oder unterbrochen wurde. Bei Fehlern bleibt ihre Eingabe erhalten.
  5. Prüfen Sie dieselbe Aufgabe mit einem zweiten unterstützten Anbieter. Quellenmaterial und Evaluationsfälle bleiben unverändert. Erfassen Sie Verhaltensunterschiede getrennt von Integrationsänderungen.
  6. Bewerten Sie das Ergebnis als Produktfunktion. Prüfen Sie sichtbares Verhalten, gespeicherte Daten und Fehler mit Interventionsbedarf, bevor Sie die Integration ausweiten.

Das Verfahren ist bewusst klein und wiederholbar. Eine erfolgreiche Antwort ist ermutigend; ein verständlicher Fehler ist ebenso aufschlussreich. Eine nützliche Abstraktion erleichtert die Wartung beider Wege.

Ein Upgrade von 0.x umfasst auch Daten

Der Migrationsleitfaden entfernt bereits in 0.x abgekündigte APIs und beschreibt koordinierte Paketupdates. Gespeicherte Chats, Läufe und Dateien nennt er als eigenständige Migrationsaufgabe. Eine erfolgreiche Typprüfung belegt deshalb nur einen Teil der Upgradebereitschaft. Leitfaden für 1.0, geprüft am 27. Oktober.

Das übersieht man leicht, wenn die Anwendung in einer frischen Browsersitzung gesund erscheint. Ein neues Gespräch kann funktionieren, während ein altes einen Zustand enthält, den der neue Client nicht fortsetzen kann. Die Migration muss repräsentative gespeicherte Datensätze und nicht nur neue Anfragen berücksichtigen.

Der Leitfaden unterscheidet das Umbenennen einer Eigenschaft vom Bereitstellen ihres richtigen Werts. Eine explizite threadId braucht ein echtes Zuständigkeitsmodell. Eine automatisierte Änderung kann nicht entscheiden, wie Route oder Datenbank Gespräche identifizieren. Ebenso darf eine ähnlich benannte body-Option in einem anderen API-Bereich nicht durch pauschales Ersetzen verändert werden.

Nutzen Sie den dokumentierten Codemod zunächst im Vorschaumodus, prüfen Sie den Diff und aktualisieren Sie stabile Client- und Serverpakete gemeinsam. Befolgen Sie dann die Schritte für gespeicherte Daten in einer Testumgebung, bevor Sie ausrollen. Experimentelle Harness-Pakete bleiben auf ihrer dokumentierten Veröffentlichungslinie; nicht jedes verwandte Paket hat dieselbe Hauptversion.

Diagramm mit Codemigration, Prüfungen gespeicherter Daten und wiederholten Nutzerabläufen vor Freigabe des Upgrades.

Das Upgrade ist abgeschlossen, wenn bestehende Gespräche und die Oberfläche ebenso funktionieren wie der neu kompilierte Code.

Definieren Sie die Freigabe über sichtbares Nutzerverhalten. Öffnen und ergänzen Sie ein altes Gespräch, brechen Sie eine andere Antwort ab und prüfen Sie einen erlaubten sowie einen verweigerten Toolablauf. Berechtigungsentscheidungen müssen weiterhin zum richtigen Nutzer gehören. So werden die Migrationsfolgen überprüfbar, ohne die SDK-Version zum Qualitätswert zu machen.

Portabilität ist eine gepflegte Fähigkeit zur Veränderung

TanStack AI 1.0 zeigt eine nützliche Richtung für Teams, die Modelle und Oberflächen bewusst wählen wollen. Am überzeugendsten ist die Einführung bei einer Anwendung mit einer klaren Grenze, die die Bibliothek vereinfachen kann. Weniger überzeugend ist die Erwartung, ein Adapter werde sämtliche Verhaltensunterschiede beseitigen.

Der praktische Test kommt bei der zweiten Veränderung: einem anderen Anbieter, einem fortgesetzten Gespräch, einem geänderten Toolvertrag oder einem alten Datensatz im neuen Client. Bleiben diese Veränderungen beobachtbar, wird Portabilität zur betrieblichen Fähigkeit statt zum Versprechen im Architekturdokument.

Quellen

Eine Empfehlung von Telli.sh

Bewahren Sie Anfragen, Quellenmaterial und Entscheidungen hinter einer KI-Integration in einer durchsuchbaren Sammlung auf. Erstellen Sie ein Telli.sh-Konto, um Projektnotizen und Prüfmaterial zu organisieren.


← Zurück zum Blog