Harness Router

Harness Router

Protocol Lattice · Coding · Produktivität

Harness Router wählt das nächste Tool in einem bestehenden Agenten-Harness, mit zwischengespeicherten Entscheidungen, Jev-Routing und optionalem MCTS. Die Ausführung bleibt in Ihrer Schleife.

Vorschau der Oberfläche von Harness Router

Über Harness Router

What Is Harness Router

Harness Router ist ein Open-Source-Paket für Python, das im Schleifenlauf eines KI-Agenten-Harness eine einzige Entscheidung trifft: Welches Tool soll jetzt laufen? Es bekommt das Ziel, die aktuelle Beobachtung, optional die letzte Aktion und die Liste der verfügbaren Tools. Zurück kommen ein Toolname, ein Konfidenzwert und ein Hinweis, ob die Wahl an den Planer zurückgehen soll.

Diese Trennung ist der Punkt. Das Harness baut Argumente, prüft Berechtigungen, holt Freigaben ein, wiederholt fehlgeschlagene Aufrufe und führt sie aus. Harness Router rührt nichts davon an. Er sitzt an einer Stelle im Zyklus, die der Host öffnet, etwa einem Prompt-Hook oder einem Rückruf nach dem Tool-Ergebnis, und gibt einen Hinweis in dem Moment, in dem der nächste Schritt gewählt wird. Protocol Lattice veröffentlicht das Projekt unter der MIT-Lizenz, der aktuelle Stand ist als Alpha gekennzeichnet.

Das Werkzeug ist bewusst klein geschnitten. Die Tool-Auswahl des Agenten wird schwieriger, je größer der Katalog wird, weil mehrere Tools zu derselben Beobachtung passen können. Ein Router, der ein Tool mit Konfidenzwert nennt, gibt dem Harness etwas Greifbares, das es annehmen oder verwerfen kann. Er schreibt keinen Code, startet keine Tests und entscheidet nicht, was fertig bedeutet.

Lesen Sie den Benchmark des Projekts, bevor Sie installieren. In der getesteten Codex-Integration stiegen Tokenverbrauch und Laufzeit, und die meisten Entscheidungen fielen an den Planer zurück. Routing ist kein automatischer Geschwindigkeitsgewinn, und die Entwickler sagen das selbst.

Getting Started

  1. Installieren Sie die CLI mit uv auf Python 3.11 oder neuer: uv tool install --force --with 'mcp>=2,<3' 'git+https://github.com/Protocol-Lattice/harness-router.git@main'. Das Paket stellt har, harness-router und harness-router-mcp bereit.
  2. Setzen Sie OPENROUTER_API_KEY in der Umgebung, in der der Harness-Prozess läuft. Das Standardmodell ist typesafe/jev-1.13, und ohne Schlüssel liefert der Aufruf einen Rückfall an den Planer.
  3. Starten Sie den Hook-Installer für Ihren Anbieter und kopieren Sie die beiden Adapterdateien, die er auslässt. Codex und Claude Code brauchen pre_decision.py und stop.py im Hook-Ordner, und der Installer legt vor jeder Änderung eine Sicherung an.
  4. Öffnen Sie eine neue Sitzung. Der Start-Hook erfasst den Tool-Katalog, die Rückrufe für Prompt und Ergebnis berechnen eine Wahl im Voraus, und der Validierungs-Hook prüft die gespeicherte Entscheidung ohne weitere Anfrage an das Modell.

Produktinformationen

Ein kurzer Überblick über Preise, unterstützte Plattformen und die Leistung von Harness Router.

Kostenloser TarifJa
Bezahlte Tarife$0 (MIT) plus Jev usage billed through OpenRouter
PlattformPython 3.11+ (CLI, MCP server, library); hook adapters for Codex, Claude Code, ohmypi, Antigravity, DeepSeek Harness
EntwicklerProtocol Lattice
KategorieCoding · Produktivität
VeröffentlichungsdatumSep 2026
Zuletzt aktualisiertSep 2026
Website-BesucheN/A
Globales Website-RankingN/A
API-VerfügbarkeitJa

Am besten für

Die Nutzer, Aufgaben und Szenarien, für die dieses Tool am besten passt.

Nutzer

  • Entwickler, die mit Codex oder Claude Code lange Aufgaben bearbeiten
  • Teams, deren MCP-Tool-Register über zwei Dutzend Einträge gewachsen ist
  • Alle, die ihre eigene Agentenschleife bauen

Aufgaben

  • Zwischen ähnlichen Lesetools wählen
  • Nach einem fehlgeschlagenen Test wieder auf Kurs kommen
  • Routing gegen einen normalen Planer vergleichen

Szenarien

  • Eine Debug-Sitzung mit wiederkehrenden Zuständen
  • Ein Tool-Katalog, der ständig wächst
  • Ein erster Versuch mit KI-Tool-Routing

Wichtigste Funktionen

Eine Entscheidung für das nächste Tool mit Konfidenzwert

Jeder Aufruf liefert Toolname, Kategorie, einen Konfidenzwert und einen Rückfall-Hinweis. Der Host vergleicht den Wert mit zwei Schwellen: 0,85, um eine Wahl direkt zu übernehmen, und 0,60, unterhalb derer die Anfrage an den Planer zurückgeht. Damit hat das Harness eine klare Regel, wann es dem Router trauen kann und wann nicht.

Drei Modi für unterschiedliches Vertrauen

Der Modus hybrid übernimmt sichere Wahlen und fällt bei Unsicherheit oder behandelten Anbieterfehlern auf den Planer zurück. jev_only akzeptiert alles über der Rückfallschwelle und lässt Fehler nach oben durch. planner_only überspringt den Modellaufruf ganz. Sie wechseln den Modus pro Anfrage, ohne den Code des Harness anzufassen.

Zwischengespeicherte Entscheidungen vor jedem Modellaufruf

Die Hook-Brücke baut einen Zustandsschlüssel aus Ziel, Beobachtung, letzter Aktion und einem kompakten Tool-Katalog. Ein passender Zustand nutzt die gespeicherte Wahl erneut, und der Standard-Cache hält 512 Einträge pro Sitzung für 300 Sekunden. Die Bibliothek pflegt zusätzlich einen kleineren Cache für sehr sichere Wahlen bei unverändertem Ziel und Tool-Set, den Sie mit obvious_cache_size=0 abschalten.

Jev-Routing über OpenRouter

Jev ist ein Entscheidungsmodell, kein Chatmodell. Es bekommt einen Zustand und eine geschlossene Liste von Optionen und gibt Wahrscheinlichkeiten statt Text zurück, was zu Klassifikationsaufgaben wie der Tool-Wahl passt. Standardmodell ist typesafe/jev-1.13, aufgerufen über OpenRouter mit Ihrem eigenen Schlüssel. Ab 24 Tools kann der Router zuerst eine Kategorie und dann ein Tool darin auswählen.

Optionale MCTS-Toolsuche

Die Monte-Carlo-Baumsuche hilft, wenn der beste erste Zug von den Folgen abhängt. Sie liefern einen Graphen aus vorhergesagten Zuständen und Übergängen, mit einem Simulationsbudget zwischen 1 und 4.096 und einer Tiefe bis 8. Die Suche arbeitet auf simulierten Ergebnissen, nie auf echten Tools, und gibt die erste Aktion samt Hauptvariante zurück. Ohne Simulator geht die Wahl an den Planer zurück.

Adapter für fünf Harnesses

Codex, Claude Code, ohmypi, Antigravity und DeepSeek Harness haben je einen Adapter, der auf die Rückrufe des jeweiligen Hosts zugeschnitten ist. Codex und Claude Code nutzen Session-Start, Prompt, Tool-Ergebnis und Validierung vor der Ausführung. ohmypi liest das laufende Register und tauscht das aktive Tool-Set. Antigravity verwendet Rückrufe für Aufruf und Ergebnis. Ein gemeinsamer Stop-Hook kann einen weiteren Schritt anfordern, solange eine frische, sichere Entscheidung vorliegt.

Vor- und Nachteile

Vorteile

  • MIT-Lizenz ohne Konto, Abo oder gehosteten Dienst in der Schleife, der vollständige Quellcode bleibt prüf- und änderbar.
  • Der Rückfall ist der Standardfall. Geringe Konfidenz, ein fehlender Schlüssel oder ein Anbieterfehler geben die Kontrolle an den Planer zurück, statt einen falschen Tool-Aufruf zu erzwingen.
  • Eine Entscheidungsschicht deckt fünf Harnesses sowie Python-API, CLI und MCP-Server ab, das erspart denselben Auswahlcode für jeden Host.
  • Der veröffentlichte Benchmark nennt ein negatives Ergebnis für eine Integration. Das ist selten genug, um der übrigen Dokumentation mehr Gewicht zu geben.
  • Cache und Kategorie-Routing zielen auf die zwei Fälle, in denen sich ein Router lohnt: wiederkehrende Zustände und über große Kataloge.

Nachteile

  • Im getesteten Codex-Aufbau erhöhte das Routing die Tokens des Hauptmodells um 105,9 Prozent und die mittlere Laufzeit von 115,8 auf 228,9 Sekunden, 54 von 58 Entscheidungen fielen an den Planer zurück. Messen Sie, bevor Sie es in einem laufenden Projekt aktivieren.
  • Jeder Aufruf schickt Ziel, Beobachtung und Tool-Beschreibungen an OpenRouter, und die Sitzungsdateien speichern diesen Text unter `.harness-router/`. Zugangsdaten und Geheimnisse gehören nicht in diese Eingaben.
  • Das Projekt ist Alpha, hat noch keine getaggten Releases, und der Hook-Installer verlangt für Codex und Claude Code weiterhin einen manuellen Kopierschritt.
  • MCTS funktioniert nur mit einem Simulator ohne Nebenwirkungen. Die meisten Teams werden Cache und Jev-Pfad nutzen und die Suchstufe nie anfassen.

Häufige Fragen

Er wählt das nächste Tool in der Schleife eines Agenten. Sie geben ein Ziel, die aktuelle Beobachtung und die verfügbaren Tools an, und er liefert einen Toolnamen mit Konfidenzwert oder einen Rückfall an den Planer. Das Harness baut weiterhin die Argumente und führt den Aufruf aus.