Pi 1.5.0 verlagert die Prüfung von Tool-Argumenten auf pi-schema und ändert damit, wie Tools geprüft werden
Pi 1.5.0 validiert Tool-Argumente mit pi-schema. Einige Funktionen, die nur TypeBox kennt, greifen bei Tool-Argumenten daher nicht mehr.
Mit Pi 1.5.0, dem neuen Release des Coding-Agenten Pi, wandert die Validierung von Tool-Argumenten in das Paket @earendil-works/pi-schema. Damit ändert sich, welche Schema-Funktionen bei Tool-Argumenten greifen. Laut Release gelten TypeBox-Funktionen außerhalb von JSON Schema für Tool-Argumente nicht mehr: Type.Refine(), Type.BigInt(), Type.Undefined(), Codecs und Formate über Format.Set(). Wer sich im Parameter-Schema eines Tools darauf verlassen hat, wird feststellen, dass Pi sie dort nicht mehr durchsetzt. Die Release Notes führen das unter Breaking Changes und verweisen für Details auf Tool parameter schemas and TypeBox.
Für reines JSON Schema wirkt die Änderung in die umgekehrte Richtung. Tools, die in JSON Schema geschrieben sind, einschließlich MCP-Tools, erhalten nun dieselbe Typumwandlung, die TypeBox-Tools bereits hatten. Die Notes nennen zwei Beispiele: Ein numerischer String wird in eine Zahl umgewandelt, ein Einzelwert wird in ein Array verpackt. Der Validator von Pi behandelt beide Arten von Tools nun gleich, der Schema-Stil entscheidet also nicht mehr darüber, wie Argumente umgewandelt werden.
Auch der Wortlaut der Validierungsfehler ändert sich, und das ist für das Modell relevant. Scheitert die Prüfung der Argumente, sieht das Modell nun die Meldungen von pi-schema, die jedes Problem nach Pfad auflisten, etwa „- path: missing“ und „- limit: expected number, got string“. Frühere Versionen meldeten die Formulierungen von TypeBox, etwa „must have required properties path“ und „must be number“.
Laut Release funktionieren Erweiterungen mit ihren bestehenden Imports weiter. Erweiterungen können Type, Static und TSchema weiterhin aus @earendil-works/pi-ai importieren, und Pi bildet diese Imports auf den Compat-Einstiegspunkt von pi-ai samt dem mitgelieferten TypeBox ab. Den Notes zufolge exportiert pi-ai selbst TypeBox nicht mehr weiter, und sein StringEnum erzeugt nach wie vor ein TypeBox-TUnsafe<T>. Die eingebauten Tool-Factories wie createReadTool() liefern TypeBoxAgentTool<typeof schema> zurück, womit ihre Parameter für TypeBox typisiert bleiben. Offen lassen die Notes, ob Erweiterungen, die in eigenen Tools reine TypeBox-Funktionen nutzen, beim Laden scheitern oder diese Funktionen einfach nicht mehr durchsetzen. Der Auszug enthält auch nicht die verlinkte Schema-Dokumentation, die das klären würde.
Was sich ändert
Art: Inkompatible Änderung · Betrifft: Pi 1.5.0, @earendil-works/pi-schema
Warum es wichtig ist
Entwickler mit eigenen Tools, die auf TypeBox-spezifische Validierung angewiesen sind, erleben unter Umständen eine andere Behandlung der Argumente und andere Fehlertexte. Argumente von MCP-Tools werden nun umgewandelt, wodurch sich ändern kann, welche Werte diese Tools erhalten.
Was Sie tun können
Prüfen Sie vor dem Upgrade auf Pi 1.5.0 die Parameter-Schemas Ihrer eigenen Tools auf Funktionen, die nur TypeBox unterstützt.
Originalquelle
Wo wir es gesehen haben
Pi releases
KI hat diese Zusammenfassung aus den genannten Quellen geschrieben und ins Deutsche übersetzt. Niemand hat sie vor der Veröffentlichung einzeln geprüft. Bitte prüfen Sie die Originalquelle, bevor Sie sich darauf verlassen. So funktioniert es