Diese Seite ist eine Übersetzung der englischen Dokumentation. Befehle, Bezeichner und Beispiele bleiben unverändert. Runtime 7.24.4 · SDK 2.6.7. Englische Fassung

Ausführungsmodi (Lokal, Cloud, Hybrid, Council, Arena)

Status: Aktiv
Geltungsbereich: aktueller Stand
Zuletzt geprüft: 2026-09-12
Verantwortlich: ax-code runtime

AX Code kann Arbeit auf lokale Inferenz, gehostete oder CLI-Anbieter oder auf beides (Hybrid) legen und anspruchsvolle Arbeit auf mehrere verbundene Anbieter auffächern (Council-Prüfung und Arena Best-of-N). Diese Seite beschreibt das ausgelieferte Verhalten dieser Modi.

Maßgebliche Quelle

Wenn sich das Verhalten ändert, prüfen Sie es anhand von:

• packages/ax-code/src/mode/ — reine Richtlinie, Hybrid, Council-Aggregation, Arena-Rangfolge, Debatte, Budget, Speicher, Worktree-Richtlinie, Bewertung der Implement-Arena
• packages/ax-code/src/tool/council.ts — Council-Werkzeug für mehrere Anbieter
• packages/ax-code/src/tool/arena.ts und arena-implement.ts — Plan- und Implement-Arena
• packages/ax-code/src/session/prompt/prompt-routing.ts — hybride Platzierung, wenn modes.default den Wert hybrid hat
• packages/ax-code/src/config/schema-impl.ts — Konfigurationsschema modes
• packages/ax-code/src/command/template/{council,arena}.txt — /council und /arena stehen im voreingestellten Slash-Menü

Auswahl des Arbeitsmodus (Agent | Council | Arena)

TUI und Desktop bieten eine Steuerung des Arbeitsmodus für die Weiterleitung über mehrere Modelle. Voreinstellung ist Agent.

• Standarddarstellung in der TUI: Die Fußzeile zeigt keinen Agent-Chip. Ausführungsmodus und Sandbox bleiben sichtbar. /work-mode (Palette Arbeitsmodus wählen) öffnet eine ausdrückliche Auswahl: Agent, Council und Arena, jeweils mit Kosten und Semantik in der Zeile. Nicht verfügbare Ensemble-Zeilen sind deaktiviert und nennen den Grund.
• Darstellung des aktivierten Ensembles: Nachdem Sie Council oder Arena gewählt haben, erscheint ein Chip (Council · 2 oder ein hohler Arena (off), falls der Modus später nicht mehr verfügbar ist). Klicken Sie auf den Chip, um zu Agent zurückzukehren. Neue Chats setzen auf Agent zurück.
• Verfügbarkeit: Ein Modus ist verfügbar, wenn er in der Konfiguration aktiviert ist, mindestens zwei verbundene Anbieter ein wählbares Modell haben und die konfigurierte Mitgliederobergrenze nicht 1 ist. Chips und Auswahlzeilen aktualisieren sich unmittelbar, wenn sich Anbieter verbinden oder trennen.
• Hinweis vor dem Absenden (TUI): Über dem Prompt erscheint ein einzeiliger Hinweis, wenn Council oder Arena blockiert ist oder noch geprüft wird, sowie bei der ersten Verwendung eines verfügbaren Modus (z. B. Council mode · up to 2 reviewers · advisory · approval on first use). Nach einem erfolgreichen Absenden in diesem Modus bleibt der Chip der Status, und der Hinweis wird ausgeblendet. Ein Absenden, während der gewählte Modus nicht verfügbar ist, wird mit dem Grund blockiert — der Entwurf bleibt erhalten, und der Prompt wird niemals stillschweigend auf einen Lauf mit einem einzelnen Modell herabgestuft.
• Desktop: Chip in der Symbolleiste des Eingabebereichs (neben Manuell/Autonom).
• Ausdrückliche /council und /arena werden nie umgeschrieben und bleiben die Einstiegspunkte für einen einzelnen Aufruf.
• Spezialisierte Agenten (Architektur, Sicherheit, …) bleiben in der separaten Agentenauswahl.

Platzierungsmodi im Überblick

Schlüsselwort-Routing für Spezialisten und Komplexitätsstufen (siehe Automatische Weiterleitung) sind unabhängig von hybrider Platzierung und Ensemble-Modi.

Der Aufwand eines Modells bzw. die Denkstufe (Fast, Balanced, Deep, Max) ist ebenfalls unabhängig — es handelt sich um ein Reasoning-Budget je Modell, nicht um einen Arbeitsmodus. Siehe Modellaufwand.

Konfiguration

In ax-code.json:

{
  "modes": {
    "default": "hybrid",
    "hybrid": {
      "preferLocalWhenAvailable": true,
      "escalateOnHighComplexity": true,
      "localProviderID": "ax-engine"
    },
    "council": {
      "enabled": true,
      "maxMembers": 3,
      "timeoutMs": 180000,
      "debateRounds": 0
    },
    "arena": {
      "enabled": true,
      "maxContestants": 3,
      "strategy": "verify_first"
    },
    "budget": {
      "maxEstimatedUsd": 0.5,
      "estimatedUsdPerMember": 0.05
    }
  }
}

Hybride Platzierung

Wenn modes.default den Wert hybrid hat und Benutzer oder Agent kein Modell festgelegt haben:

1. Wenn der lokale Anbieter (Voreinstellung ax-engine) ein wählbares Modell hat → local bei niedriger oder mittlerer Komplexität bevorzugen.
2. Wenn die Komplexität hoch ist und escalateOnHighComplexity wahr ist → cloud.
3. Wenn der Datenschutz lokal erfordert und lokal verfügbar ist → local.
4. Wenn lokal nicht verfügbar ist → cloud.

Die Komplexität nutzt weiterhin den bestehenden Pfad über ein kleines, schnelles Modell für Nachrichten low, wenn die Komplexitätsweiterleitung von Auto-Route aktiviert ist (Automatische Weiterleitung). Hybrid ersetzt das Schlüsselwort-Routing für Spezialisten nicht.

Lokale Modelle und Hinweise zum Speicher: Modellauswahl für AX Engine. Anbieterliste: Unterstützte Anbieter.

Council (Konsensmodus)

Werkzeug: council
Slash: /council <question>

1. Wählt vielfältige verbundene Anbieter aus (Vielfalt der Familien — bei einem nicht erkannten Gateway für mehrere Modelle fällt die Familie auf die Modellkennung zurück; weiche Tendenz aus dem Ergebnisspeicher).
2. Fächert einen strukturierten Prüfungs- oder Entwurfs-Prompt parallel auf.
3. Aggregiert Befunde in die Stufen Konsens (einstimmig unter den erfolgreichen Mitgliedern bei Quorum — mindestens max(2, ⌈2/3 × attempted⌉) Erfolge), strikte Mehrheit (mehr als die Hälfte der versuchten Mitglieder), Minderheit (mindestens zwei) und Einzelfall. Befunde weisen die Unterstützung gegenüber den versuchten Mitgliedern aus (2/6), und Berichte mit geringer Abdeckung stellen klar, dass Konsenskennzeichnungen ein Quorum erfordern.
4. Optionale Debattenrunden: Zwischen den Runden wird eine anonyme Synthese (Chatham House) geteilt; keine Zuordnung zu Marken. Die Debatte ist auf drei Runden begrenzt und endet vorzeitig bei Konvergenz.
5. Liefert einen beratenden Markdown-Bericht. Dateien werden nicht bearbeitet.

Zum Start sind mindestens zwei aufgelöste Mitglieder erforderlich — bei weniger bricht eine Vorprüfung mit „unzureichende Mitglieder“ ab, bevor eine Genehmigungsabfrage oder ein Modellaufruf erfolgt (ausdrückliche Modellpaare am selben Gateway zählen als zwei). Aussagekräftige Konsensstufen brauchen weiterhin mindestens zwei erfolgreiche Mitglieder; andernfalls wird der Bericht als unvollständig gekennzeichnet.

Zulassung von Nachweisen. Mitglieder erhalten nur die mitgelieferte Frage und den Kontext. Sie erben nicht die aufrufende Sitzung und lesen keine Dateien aus Pfaden in der Aufgabenbeschreibung. Fügen Sie die Anforderungen, den relevanten Diff, die erforderlichen Originalausschnitte und die Prüfungsnachweise bei, die für den genannten Prüfungsumfang nötig sind.

Das optionale context wird unverändert bis zu 24.000 UTF-16-Codeeinheiten angenommen. Größerer Kontext liefert context_rejected, bevor die Mitglieder inferieren; AX Code kürzt ihn niemals stillschweigend. Teilen Sie die Prüfung in ausdrücklich abgegrenzte Anfragen auf oder entfernen Sie optionalen Hintergrund, während erforderliche Nachweise erhalten bleiben.

Vor jeder Runde prüft AX Code den gesamten Prompt gegen eine lokale Obergrenze von 128.000 Byte und gegen die bekannten Eingabe- und Kontextgrenzen jedes aufgelösten Mitglieds. Dabei werden die angeforderte Ausgabe, die Rückfallanweisung und 2.048 Tokens für Schema und Rahmen reserviert. Die Eingabegröße verwendet eine bewusst konservative Schätzung in UTF-8-Byte. Prompts, die noch passen würden, können abgelehnt werden; es handelt sich weder um eine exakte Tokenizer-Zählung noch um eine Garantie zur Serialisierung beim Anbieter. Unbekannte Modellgrenzen werden offengelegt und bleiben den lokalen Obergrenzen unterworfen. Passt eine Debattenrunde nicht, ist das Ergebnis unvollständig und behält den Bericht der zuletzt abgeschlossenen Runde.

contextAdmission zeichnet die lokale Schranke für die Kontextlänge, die gelieferte Größe und einen Inhaltsdigest auf; promptBudget prüft die vollständige Anfrage getrennt. Beides muss vor der Inferenz bestehen. Diese Felder sind unabhängig von successfulMembers und belegen weder semantische Vollständigkeit noch Aktualität der Quelle noch eine garantierte Prüfungsqualität.

Timeouts. Jedes Mitglied läuft unter modes.council.timeoutMs (Voreinstellung 180000 ms); Modelle, die eine Reasoning-Fähigkeit angeben, erhalten das modes.council.reasoningTimeoutScale-Fache dieses Budgets (Voreinstellung 3, also 540000 ms). Um einem bekannt langsamen Mitglied mehr Zeit zu geben, ohne die Wartezeit aller anderen zu verlängern, setzen Sie eine absolute Überschreibung modes.council.memberTimeoutMs mit dem Schlüssel "providerID" oder "providerID/modelID" — der genaue Modellschlüssel hat Vorrang vor dem anbieterweiten Schlüssel, und beide haben Vorrang vor der Berechnung aus Basis und Skalierung:

{
  "modes": {
    "council": {
      "memberTimeoutMs": { "deepseek/deepseek-v4-pro": 900000 }
    }
  }
}

ax-code.json ist eine geschützte Konfigurationsdatei — Agenten müssen den Benutzer bitten, sie zu ändern.

Optionale Spuren (standardmäßig aus). modes.council.chairman: true hängt nach der Aggregation (und etwaigen Debattenrunden) einen verblindeten Syntheseaufruf des Vorsitzes an: Der Vorsitz erhält nur anonymisierte Befunde (Stufen und Unterstützungszahlen, niemals Identitäten der Mitglieder) und liefert ein Urteil, empfohlene Maßnahmen und Anmerkungen zum Dissens. Die deterministische Stufung bleibt die primäre Ausgabe; ein Ausfall des Vorsitzes wird offengelegt und ist nicht fatal. modes.council.adaptive: true startet die Auffächerung mit zwei Mitgliedern und erweitert sie jeweils um eines bis maxMembers, solange die Abdeckung in Runde 1 unter dem Quorum liegt oder der Dissens erheblich ist; die Auslöser der Erweiterung sind im Harness einstellbare Konstanten.

Wann Sie ihn einsetzen

• Abwägungen zu Architektur, Sicherheit oder Entwurf
• Codeprüfung mit hohem Einsatz, bei der die Übereinstimmung mehrerer Modelle das Vertrauen erhöht
• Der Benutzer bittet um eine Prüfung mit mehreren Modellen oder um eine „Zweitmeinung“

Agentenablauf (wichtig)

Rufen Sie council früh auf, sobald die relevanten Nachweise vorliegen, mit einer ausdrücklich abgegrenzten Aufgabenbeschreibung context. Vermeiden Sie breite Erkundungen, die nichts mit dieser Prüfung zu tun haben; sammeln Sie die erforderlichen Originalnachweise, bevor Sie die Mitglieder um Codebefunde bitten. Wenn der Benutzer Council oder Arena verlangt hat, wird task_parallel abgelehnt, bis das Ensemble-Werkzeug die beabsichtigte primäre Aktion war.

Wann Sie ihn nicht einsetzen

• Triviale Fragen (Latenz/Kosten)
• Datenschutzsensibler Code, der die lokale Inferenz nicht verlassen darf
• Nur ein Anbieter ist verbunden

Arena (Best-of-N)

Werkzeug: arena
Slash: /arena <task>
Erfordert: modes.arena.enabled: true und mindestens zwei verschiedene wählbare Modelle auf verbundenen Anbietern (einschließlich eines gemeinsamen Gateways)

Zulassung von Nachweisen (gemeinsam mit Council). Das optionale context wird unverändert bis zu 24.000 UTF-16-Codeeinheiten angenommen. Größerer Kontext liefert context_rejected, bevor eine Genehmigungsabfrage, eine Worktree-Erstellung oder ein Modellaufruf erfolgt — AX Code kürzt ihn niemals stillschweigend. Teilen Sie die Aufgabe in ausdrücklich abgegrenzte Anfragen auf oder reduzieren Sie optionalen Hintergrund, während erforderliche Nachweise erhalten bleiben. Die Genehmigungsabfrage selbst erscheint erst, nachdem jede folgenlose Vorprüfung bestanden wurde (deaktiviert, Kontextzulassung, Git-Vorprüfung für Implement, Budget, Auflösung der Mitglieder).

mode: "plan" (Voreinstellung)

• Jeder Teilnehmer schlägt einen Ansatz, Schritte, Risiken und eine kalibrierte, selbst eingeschätzte Risikokennzahl vor (keine Schreibvorgänge im Arbeitsbereich).
• Bei mindestens zwei erfolgreichen Vorschlägen bewertet ein Aufruf eines verblindeten Bewertungsrichters (das erste aufgelöste Mitglied; Identitäten entfernt, Reihenfolge zufällig) jeden Vorschlag nach Anforderungsabdeckung, Machbarkeit, Prüfungsplan und Risikonachweisen (jeweils 0–10, Gleichstände erlaubt). Die Summe des Rasters (0–40) ist das primäre Rangsignal; das selbst eingeschätzte Risiko bleibt nur zur Anzeige. Bei Ausfall des Richters oder bei modes.arena.judge: false wird mit einem Hinweis auf die selbst eingeschätzte Bewertung zurückgefallen.
• Die Rangfolge setzt zuerst die Prüfungsstufe, dann die Richter- oder Risikokennzahl, dann die Vielfalt der Patch-Fingerabdrücke (niemals reine Beliebtheit). Rangfolgen im Planmodus sind beratend und keine Prüfung der Ausführung.
• Nur beratend.

mode: "implement"

• Erfordert einen primären Git-Worktree mit mindestens einem Commit und ohne uncommittete Änderungen, zeichnet dessen genauen Basis-Commit auf und erzeugt aus diesem Commit einen Git-Worktree je Teilnehmer.
• Führt in jedem Worktree einen Implement-Agenten aus.
• Sichert die verfolgten und nicht verfolgten Änderungen jedes Teilnehmers in einem dauerhaften Branch-Commit, einschließlich der vom Agenten selbst erzeugten Commits.
• Führt erkannte Projektprüfbefehle (Typprüfung / Test / Lint) erst aus, nachdem ein nicht leerer Patch erfasst wurde.
• Rangfolge standardmäßig nach Prüfung zuerst: Nur abgeschlossene, nicht leere Patches, die die Prüfung bestehen, können gewinnen; unter den bestandenen werden geringeres Risiko und vielfältige Patches bevorzugt.
• Kein automatisches Zusammenführen. Der Bericht enthält Worktree-Pfade, Branches und Commit-Bereiche, damit Sie diese prüfen, zusammenführen oder per Cherry-pick übernehmen.

Die Implement-Arena erfordert ein Git-Projekt.

Rangregel (an der Forschung ausgerichtet)

Für Code-Kandidaten: zuerst die Prüfung, dann die Vielfalt, Beliebtheit niemals allein.
Eine naive Mehrheitswahl über ähnliche falsche Patches ist ein Antimuster (Beliebtheitsfalle).

Slash-Befehle

Sicherheit und Kosten

• Sandbox / autonom gelten weiterhin für die Arbeit eines einzelnen Agenten (Sandbox-Modus, Autonom).
• Council und Plan-Arena schreiben keine Dateien.
• Schreibvorgänge der Implement-Arena sind in Worktrees isoliert; ein unsauberer primärer Worktree wird abgelehnt, damit uncommittete Eingaben nicht stillschweigend fehlen.
• Die Ensemble-Auffächerung vervielfacht Datenabfluss und Kosten beim Anbieter; nutzen Sie modes.budget und halten Sie maxMembers / maxContestants klein. Budgetschätzungen bepreisen den ungünstigsten Fall: Council mit 2 × (debateRounds + 1) Aufrufen je Mitglied (Schema-Rückfall plus Wiederholung), Plan-Arena mit 2 je Teilnehmer plus einem pauschalen Richteraufruf, Implement-Arena mit einer dokumentierten Schätzung von 12 Aufrufen je Trajektorie.
• Ein nur lokales Aufrufjournal des Ensembles (ensemble-calls.jsonl im globalen Zustandsverzeichnis, Obergrenze 2 MB) zeichnet Ergebnisse je Generation mit SHA-256-Hashes der Prompts auf — niemals Prompt-Inhalte, niemals Zugangsdaten, kein Datenabfluss. Deaktivieren Sie es mit modes.ensembleLedger: false.
• Übereinstimmung mehrerer Modelle ist ein Nachweis, kein Beweis — führen Sie Tests aus, bevor Sie ausliefern.

Verwandte Themen

• Automatische Weiterleitung — Schlüsselwörter für Spezialisten plus Komplexitätsstufe
• Unterstützte Anbieter — Cloud, CLI, AX Engine
• Modellauswahl für AX Engine — Wahl des lokalen Modells