Vercels fx-Adapter führt das Harness der AI SDK jetzt auf dem Host aus statt in der Sandbox

27. Oktober 2026Quelle: Vercel

Vercel hat den fx-Adapter für den HarnessAgent der AI SDK neu geschrieben: Das Harness und die Modellanfragen laufen nun im selben Prozess wie die Anwendung. Die im Harness integrierten Dateisystem- und Shell-Operationen bleiben laut Vercel weiterhin in der Sandbox isoliert.

Das Wichtigste in Kürze

Der fx-Adapter für den HarnessAgent der AI SDK führt das Harness und die Modellanfragen nun im selben Prozess wie die Anwendung aus.
Die integrierten Dateisystem- und Shell-Operationen bleiben in der Sandbox isoliert.
Der Adapter benötigt weder fx in der Sandbox noch eine Sandbox-Bridge oder einen freigegebenen Sandbox-Port, und die Modell-Zugangsdaten bleiben auf dem Host.
Zu den neuen Funktionen zählen die Filterung integrierter Tools, Steering mitten im Turn, Structured Output und Bilder als Tool-Ergebnisse über toModelOutput().
Sitzungen lassen sich speichern und in einem neuen Host-Prozess fortsetzen; für den Adapter muss @ai-sdk/harness-fx aktualisiert werden.

Harness und Modellanfragen wandern auf den Host

Nach dem neuen Design teilen sich das Harness und die Modellanfragen einen Prozess mit Ihrer Anwendung. Die integrierten Dateisystem- und Shell-Operationen bleiben in der Sandbox isoliert. Die Trennung verläuft damit zwischen der Orchestrierung auf dem Host und der Ausführung der Tools in der Sandbox.

Der Adapter basiert auf libfx, der TypeScript-Bibliothek für fx. Laut Vercel entfallen dadurch mehrere Einrichtungsschritte, die der bisherige Ansatz erforderte. Der Adapter muss fx nicht mehr in der Sandbox installieren, keine Sandbox-Bridge betreiben und keinen Sandbox-Port freigeben.

Auch der Ort der Modell-Zugangsdaten ändert sich. Sie bleiben jetzt auf dem Host und werden nicht mehr in die Sandbox weitergereicht. Für Teams, die von Agenten erzeugte Befehle in einer isolierten Umgebung ausführen, heißt das: Die Sandbox muss die Schlüssel für den Modellaufruf nicht mehr vorhalten.

Neue Funktionen im Rewrite

Neben der Architekturänderung bringt der Rewrite nach Angaben von Vercel mehrere neue Funktionen:

Filterung integrierter Tools: Entwickler können festlegen, welche integrierten Tools der Agent nutzen darf.
Steering mitten im Turn: Neue Anweisungen lassen sich senden, während ein Turn noch läuft.
Structured Output: Der Agent kann Antworten erzeugen, die einem Schema entsprechen.
Bilder als Tool-Ergebnisse: Bilder können über toModelOutput() an das Modell zurückgegeben werden.

Sitzungen lassen sich zudem speichern und in einem neuen Host-Prozess fortsetzen. Da das Harness nun im Anwendungsprozess lebt, ist eine Sitzung nicht mehr an die Lebensdauer eines einzelnen Host-Prozesses gebunden.

So gelangen Sie an den Adapter und was er bedeutet

Um den neuen Adapter zu nutzen, müssen Entwickler @ai-sdk/harness-fx auf die neueste Version aktualisieren. Weitere Details nennt Vercel in der Dokumentation zum fx-Harness.

Die Änderungen betreffen vor allem Entwickler, die Agenten mit dem HarnessAgent der AI SDK bauen und mit fx betreiben. Weniger bewegliche Teile in der Sandbox, also keine Bridge und kein freigegebener Port, vereinfachen das in der Ankündigung beschriebene Setup. Dass die Modell-Zugangsdaten auf dem Host bleiben, verringert die Zugriffsmöglichkeiten der Sandbox. Die zusätzlichen Steuerungsmöglichkeiten wie Tool-Filterung und Steering mitten im Turn geben Entwicklern mehr Einfluss darauf, was der Agent tun darf und wie er sich während der Arbeit lenken lässt.

Die Quelle nennt weder Leistungszahlen noch Details dazu, wie bestehende Setups über die Aktualisierung des Pakets hinaus migriert werden sollten. Teams mit laufenden Deployments sollten daher die Dokumentation konsultieren.