Wie viele parallele Tool-Aufrufe in DeepSeek Harness 2026?

Ein einzelner Agent startet Code-Suche, Tests und Build gleichzeitig, doch danach sind Arbeitsbaum, Prozesse und Fehlermeldungen nicht mehr eindeutig zuzuordnen.

Schnellste Lösung: Setzen Sie maxParallelToolCalls zunächst auf den seriellen Zustand 1, klassifizieren Sie jedes Tool nach Lesen, Schreiben und externen Nebenwirkungen und erhöhen Sie die Parallelität erst nach einem reproduzierbaren Test für Isolation, Ressourcen, Abbruch und Protokolle. Die offizielle Konfigurationsdokumentation beschreibt 1 als seriellen Betrieb, nennt aber keinen universell passenden Wert für jedes Plugin oder jeden Mac. Offizieller Konfigurationskatalog

Diese Anleitung ist für Sie relevant, wenn Sie als Agent-Entwickler mehrere Werkzeuge innerhalb eines Arbeitsschritts koordinieren, als Plattformingenieur gemeinsame Ausführungsgrenzen definieren oder als technischer Einkäufer entscheiden müssen, ob ein zusätzlicher Mac sinnvoller ist als eine höhere Parallelität auf derselben Umgebung.

Zeitplan und Wochenentscheidung

Am ersten Tag erfassen Sie die tatsächlichen Tool-Nebenwirkungen. Am zweiten Tag prüfen Sie Arbeitsbereich und Artefakte. Am dritten Tag messen Sie Ressourcen- und Abbruchverhalten. Erst danach vergleichen Sie seriellen Betrieb, begrenzte Parallelität und getrennte Umgebungen.

Ihre Empfehlung für diese Woche lautet daher nicht „so viele Aufrufe wie die Maschine Kerne hat“, sondern:

1. Seriellen Basistest ausführen: gleicher Prompt, gleiche Dateien, gleiche Test- und Build-Aufgabe.
2. Nur unabhängige Lesevorgänge parallel freigeben: etwa Dateisuche, Statusabfrage oder statische Analyse ohne Schreibpfad.
3. Schreibende und externe Werkzeuge zunächst als Barriere behandeln: insbesondere Build, Migration, Paketinstallation, Git-Operationen, Deployment und API-Aktionen.
4. Nur bei bestandener Abnahme den Wert schrittweise erhöhen: und jede Änderung mit demselben Basistest erneut prüfen.
5. Bei gemeinsamer Verantwortung oder dauerhafter Auslastung die Umgebung teilen: statt einen einzelnen Agenten immer weiter zu beschleunigen.

DeepSeek Harness befindet sich laut offizieller Projektseite in einer Developer Preview mit möglichen kompatibilitätsbrechenden Änderungen. Prüfen Sie deshalb vor jeder Messreihe die konkret eingesetzte Version und den tatsächlich geladenen Konfigurationsbaum. Offizielle Projektseite

Nebenwirkungsprofil der Werkzeuge

Der Name eines Werkzeugs sagt wenig über sein Risiko aus. Ein scheinbar harmloser Befehl kann Dateien erzeugen, Cache-Verzeichnisse verändern, Sperren halten oder Daten nach außen senden. Entscheidend ist die Ausführungspipeline: DeepSeek Harness führt Werkzeuge über die Phasen tools/pre-execute, tools/execute und tools/post-execute und erzeugt anschließend ein Tool-Ergebnis. Diese Lebensdauer ist die belastbare Grundlage für Ihre Einstufung. Dokumentation zur Tool-Ausführungspipeline

Erstellen Sie für jedes Tool eine kleine Inventarliste:

Welche Werkzeuge dürfen in der ersten Runde gleichzeitig laufen? Nur solche, deren Leseobjekte sich nicht verändern und deren Ausführung weder den gemeinsamen Arbeitsbaum noch einen externen Dienst beeinflusst. Zwei unterschiedliche Befehle sind nicht automatisch unabhängig. grep und ein Testlauf können beispielsweise beide denselben Cache, dieselbe generierte Datei oder dieselbe temporäre Datenbank berühren.

Für jedes Tool sollten Sie nicht nur den Namen, sondern auch Pfad, Prozessstart, Umgebungsvariablen, Credential-Zugriff, temporäre Dateien und externe Ziele dokumentieren. Das ist besonders wichtig, wenn Sie MCP-ähnliche Werkzeuge, Shell-Aufrufe oder eigene Plugins einsetzen. Die offizielle Architektur beschreibt Tool-Registry und geschützte Ausführung als austauschbare Bestandteile des Plugin-Baums; dadurch kann sich das tatsächliche Verhalten zwischen Profilen unterscheiden. Architektur-Dokumentation

Arbeitsbereich und Artefaktzuordnung

Kann DeepSeek Harness mehrere Werkzeuge parallel ausführen, ohne dass sie dieselbe Datei ändern? Nur dann, wenn Sie es nachweisen können. Die Modellantwort, die mehrere Tool-Aufrufe enthält, beweist lediglich, dass mehrere Aufrufe angefordert wurden. Sie beweist nicht, dass die darunterliegenden Werkzeuge konfliktfrei, atomar oder voneinander isoliert ausgeführt werden.

Prüfen Sie deshalb mindestens diese Objekte:

• Git-Arbeitsbaum und Branch-Zustand;
• Quellverzeichnisse und generierte Dateien;
• Build- und Testverzeichnisse;
• Paketmanager- und Compiler-Sperren;
• temporäre Dateien und lokale Datenbanken;
• Socket-, Port- und Prozessbindungen;
• Logs, Ergebnisdateien und Exit-Status;
• Arbeitsbereichsrechte und Credential-Dateien.

Führen Sie den Test zuerst mit einem absichtlich unveränderten Repository aus. Speichern Sie vor Beginn den Git-Status, die Liste geänderter Dateien und die relevanten Verzeichnisinhalte. Nach dem Lauf wiederholen Sie dieselbe Erfassung. Bei jedem Ergebnis muss sichtbar sein, welches Tool die Datei oder das Artefakt erzeugt hat.

Benötigen parallele Build-Aufgaben getrennte Arbeitsbereiche? Wenn beide Aufgaben in denselben Quell-, Build- oder Cache-Pfad schreiben, sollten Sie von getrennten Arbeitsbereichen ausgehen. Unterschiedliche Kommandozeilen reichen nicht aus. Zwei Build-Aufrufe können dieselben Zwischenprodukte überschreiben; zwei Tests können dieselbe Datenbank leeren; zwei Git-Schritte können dieselbe Indexdatei verändern.

Eine robuste Trennung kann aus separaten Verzeichnissen, Git-Worktrees, eigenen temporären Verzeichnissen, getrennten Cache-Pfaden und individuellen Portbereichen bestehen. Wenn das Werkzeug diese Pfade nicht kontrolliert oder implizit aus dem aktuellen Arbeitsverzeichnis ableitet, bleibt der serielle Betrieb die sichere Voreinstellung. Die Architektur beschreibt den Arbeitsbereich als Teil der Agent-Konfiguration und weist darauf hin, dass lokale Shell- und Subprozessanbieter in einer gemeinsamen Ausführungswelt liegen können.

Ressourcenprofil und Mac-Kapazität

Die richtige Mac-Parallelität lässt sich nicht aus der Kernzahl ableiten, weil ein Agent-Schritt mehrere Lastarten gleichzeitig erzeugen kann. Ein paralleler Build beansprucht CPU und temporären Speicher; Tests starten möglicherweise weitere Prozesse; eine Language-Server-Instanz hält Dateien und Indexdaten offen; Shell-Aufrufe können zusätzlich Netzwerk, Dateihandles und Pipes belegen.

Messen Sie während des seriellen und begrenzt parallelen Laufs mindestens:

• CPU-Auslastung und Dauer der anhaltenden Sättigung;
• belegten Arbeitsspeicher und Swap-Aktivität;
• Dateihandles und Prozessanzahl;
• temporären Speicher und freien Speicherplatz;
• I/O-Wartezeit sowie Lese- und Schreibvolumen;
• offene Netzwerkverbindungen und Fehlerraten;
• Dauer bis zum vollständigen Aufräumen nach dem Lauf.

Die offizielle Konfiguration enthält für lokale Bash-Ausführung unter anderem ein Arbeitsverzeichnis, Vordergrund-Timeouts, maximale Ausgabegrößen und eine Gnadenfrist für die Beendigung von Prozessen. Diese Parameter zeigen, dass Tool-Ausführung nicht nur eine Frage der Modellantwort ist, sondern auch eine Frage der Prozess- und Speicherverwaltung.

Ein sinnvoller Kapazitätstest besteht aus drei identischen Durchläufen:

1. Ein Werkzeug oder eine Werkzeugkette seriell.
2. Zwei nachweislich unabhängige Werkzeuge parallel.
3. Die für Ihr Szenario geplante begrenzte Parallelität.

Vergleichen Sie nicht nur die Gesamtzeit. Ein schnellerer Durchlauf ist wertlos, wenn der Mac währenddessen dauerhaft auslagert, Prozesse beendet oder Artefakte unvollständig hinterlässt. Als Abbruchsignal gelten anhaltende CPU- oder I/O-Sättigung, deutlich zunehmender Swap, wiederholte Prozessabbrüche, temporärer Speicher ohne ausreichende Reserve sowie eine steigende Zahl nicht reproduzierbarer Testfehler.

Wie entscheiden Sie nach einem Paralleltest zwischen Erweiterung und Rückkehr zur Seriell-Ausführung?

• Wenn die Ergebnisse korrekt, vollständig und rückverfolgbar sind und die Ressourcen nach jedem Lauf sauber zurückkehren, erhöhen Sie die Grenze nur für dieselbe Tool-Klasse.
• Wenn die Auslastung zwar hoch, aber stabil ist und keine Artefakte konkurrieren, halten Sie die aktuelle Grenze zunächst über mehrere Wiederholungen.
• Wenn Ressourcen dauerhaft gesättigt bleiben oder Prozesse beendet werden, reduzieren Sie maxParallelToolCalls.
• Wenn nur ein bestimmter Tool-Typ Konflikte erzeugt, trennen Sie dessen Ausführung vom restlichen Agent-Schritt.
• Wenn mehrere unabhängige Verantwortungsbereiche dauerhaft Last erzeugen, planen Sie zusätzliche Mac-Umgebungen statt einen gemeinsamen Prozess weiter zu überladen.

Abbruch, Timeout und Wiederherstellung

Parallelität ist erst dann betriebsfähig, wenn ein Fehler begrenzt bleibt. Prüfen Sie nicht nur, ob der sichtbare Tool-Aufruf mit einem Fehler zurückkehrt. Sie müssen auch feststellen, ob gestartete Unterprozesse, Hintergrundjobs, Pipes, temporäre Dateien und halbfertige Arbeitsstände weiterlaufen.

Der offizielle Ablauf unterscheidet zwischen dem Modellschritt, Tool-Aufrufen, Tool-Ergebnissen und dem Ende des Schritts. Zusätzlich gibt es dokumentierte Ereignisse für Abbruch und Fehlerwiederherstellung. Dokumentation zu Abbruch und Fehlerwiederherstellung

Führen Sie diese fünf Tests durch:

1. Ein einzelnes Tool schlägt fehl: Prüfen Sie, ob andere parallele Werkzeuge beendet, fortgesetzt oder fälschlich als erfolgreich markiert werden.
2. Der Benutzer bricht den Schritt ab: Beobachten Sie Vordergrundprozess, Unterprozesse und offene Pipes.
3. Ein Timeout tritt ein: Kontrollieren Sie, ob die Beendigung eskaliert und ob ein Restprozess bestehen bleibt.
4. Ein Schreibvorgang endet halb fertig: Prüfen Sie temporäre Dateien, Lock-Dateien und Git-Status.
5. Der Agent wird fortgesetzt: Starten Sie denselben Arbeitslauf erneut und prüfen Sie, ob er den Zwischenstand korrekt erkennt oder beschädigte Artefakte wiederverwendet.

Für lokale Bash-Aufrufe nennt der Konfigurationskatalog eine maximale Timer-Verzögerung von 2.147.483.647 Millisekunden, also ungefähr 24,9 Tage. Das ist eine technische Obergrenze des Timers, keine sinnvolle Agent-Empfehlung. Ebenso sollte die konfigurierte Gnadenfrist nicht mit einer Garantie verwechselt werden, dass jeder Nachprozess sofort endet.

Hinweis: Wenn ein sichtbarer Tool-Aufruf beendet ist, gilt der Test erst dann als sauber, wenn auch die von ihm gestarteten Prozesse und temporären Artefakte geprüft wurden.

Protokollqualität und Beweiskette

Ein Paralleltest ohne eindeutige Zuordnung ist kein bestandener Test. Mehrere Ergebnisse müssen dem ursprünglichen Aufruf, dem Start- und Endzustand sowie dem erzeugten Artefakt zugeordnet werden können.

Das offizielle Modell beschreibt Session-Ereignisse als dauerhafte Fakten im Log. Dazu gehören unter anderem step/*, tool/* und Nachrichtenereignisse; der Session-Log dient außerdem als Grundlage für Wiederaufnahme, Forks, Transkripte und Telemetrie.

Sie sollten deshalb pro Tool-Aufruf mindestens folgende Nachweise speichern:

• eine eigene Aufgabenkennung;
• Tool-Name und normalisierte Argumente;
• Arbeitsverzeichnis und relevante Umgebungskennung;
• Startzeitpunkt und Endzeitpunkt;
• Zustand: angenommen, gestartet, beendet, fehlgeschlagen oder abgebrochen;
• Exit-Code oder Fehlerklasse, sofern vom Tool geliefert;
• erzeugte, veränderte und entfernte Artefakte;
• Unterprozessstatus;
• Verweis auf den zugehörigen Agent-Schritt.

Erfinden Sie keine zusätzlichen Logfelder, die Ihre eingesetzte Version nicht tatsächlich erzeugt. Wenn eine Information nicht vorhanden ist, markieren Sie sie als nicht verfügbar und ergänzen Sie sie außerhalb des Harness-Logs durch einen überprüfbaren Wrapper. Das ist besser als eine scheinbar vollständige, aber unzuverlässige Telemetrie.

Abnahmeschritte für Ihre Testumgebung

1. Version festhalten: Speichern Sie Commit, Paketversion, Profil und Patch-Dateien. Die Projektseite weist ausdrücklich auf schnelle Entwicklung und mögliche Breaking Changes hin.
2. Aktive Konfiguration ausgeben: Verwenden Sie den dokumentierten Konfigurationsdump, damit Sie nicht eine ungenutzte oder überschattete Einstellung testen.
3. Werkzeugregister inventarisieren: Erfassen Sie Lese-, Schreib- und externe Ziele jedes Tools.
4. Seriellen Referenzlauf ausführen: Sichern Sie Ausgangszustand, Ergebnis, Laufzeit, Ressourcenprofil und Logs.
5. Konflikttest durchführen: Starten Sie bewusst zwei Werkzeuge mit möglichem Zugriff auf denselben Pfad, jedoch zunächst in einer isolierten Testkopie.
6. Unabhängige Paralleltests ausführen: Verwenden Sie nur Werkzeuge, deren Ausgabepfade getrennt und nachprüfbar sind.
7. Abbruch testen: Brechen Sie einmal während des Vordergrundaufrufs und einmal während eines Unterprozesses ab.
8. Wiederaufnahme prüfen: Starten Sie den Agenten erneut und kontrollieren Sie, ob der Zustand eindeutig ist.
9. Ressourcenlimit beobachten: Protokollieren Sie CPU, Arbeitsspeicher, Swap, I/O, Handles, Prozesse und temporären Speicher.
10. Entscheidung dokumentieren: Halten Sie fest, welche Tool-Klassen parallel zugelassen, seriell gehalten oder auf getrennte Umgebungen verteilt werden.

Entscheidungsregeln für maxParallelToolCalls

Verwenden Sie die folgende Verzweigung als Abnahme- und Betriebsregel:

• Wenn ein Tool ausschließlich liest, keine gemeinsamen Caches verändert, keine externen Aktionen ausführt und seine Ergebnisse eindeutig protokolliert werden, dann darf es in eine begrenzte Parallelgruppe aufgenommen werden.
• Wenn zwei Werkzeuge denselben Arbeitsbereich, Build-Pfad, Lock-Zustand oder temporären Speicher nutzen, dann bleiben sie seriell, auch wenn ihre Befehle unterschiedlich heißen.
• Wenn Schreibvorgänge in getrennten Worktrees oder klar getrennten Ausgabeordnern stattfinden, dann testen Sie begrenzte Parallelität, aber nur mit einem Wiederherstellungs- und Abbruchtest.
• Wenn ein externes Tool einen Remote-Zustand, ein Ticket, ein Deployment oder eine kostenpflichtige API-Aktion verändert, dann behandeln Sie den Aufruf als kontrollierte Barriere.
• Wenn ein Abbruch sichtbare Aufrufe beendet, aber Unterprozesse oder halbfertige Artefakte hinterlässt, dann reduzieren Sie die Parallelität oder isolieren Sie die Aufgabe.
• Wenn die Logs keine eindeutige Zuordnung von Aufruf, Ergebnis, Fehler und Artefakt ermöglichen, dann besteht die Abnahme unabhängig von einer möglichen Zeitersparnis nicht.
• Wenn mehrere Aufgaben dauerhaft eigene Ressourcen und Verantwortlichkeiten benötigen, dann teilen Sie Workspaces oder Mac-Umgebungen auf, statt nur den Grenzwert zu erhöhen.

Bewertung der drei Betriebsmodelle

Wenn Sie Ihre bestehende Arbeitsumgebung noch nicht vermessen haben, starten Sie nicht mit einer pauschalen Mac-Auswahl. Prüfen Sie zuerst die verfügbaren Mac-Knoten von VPSMAC und ordnen Sie die Entscheidung Ihrem realen Agent-Lastprofil zu. Für Teams mit mehreren Projekten ist außerdem der Vergleich verschiedener M4-Knoten-Konfigurationen erst dann sinnvoll, wenn klar ist, ob die Engstelle CPU, Arbeitsspeicher, temporärer Speicher, Dateikonflikt oder Prozessisolierung lautet.

Fazit für Mac-Betrieb und Kapazitätsplanung

Die Frage „Wie viele parallele Tool-Aufrufe?“ wird bei DeepSeek Harness nicht durch die Hardware allein beantwortet. maxParallelToolCalls ist eine Ausführungsgrenze für parallel sichere Aufrufe; die offizielle Dokumentation definiert 1 als seriellen Zustand und überlässt die weitere Kapazitätsentscheidung Ihrer konkreten Tool- und Umgebungskombination.

Wenn Sie derzeit nur eine gemeinsame lokale Umgebung verwenden, bleiben drei typische Nachteile: Schreibkonflikte sind schwer vorherzusagen, ein überlasteter Prozess kann mehrere Aufgaben gleichzeitig beeinträchtigen und gemeinsame Credentials oder temporäre Dateien erschweren die forensische Zuordnung. Eine höhere Parallelitätszahl beseitigt keine dieser Grenzen.

Für kurzfristige Benchmarks, Plugin-Tests und kontrollierte Agent-Läufe ist es deshalb oft sinnvoller, eine zusätzliche Mac-Umgebung zeitweise zu mieten, anstatt den einzigen Arbeitsbereich aggressiver zu parallelisieren. VPSMAC passt dann besser, wenn Sie getrennte Testläufe, eigene Workspaces oder eine reproduzierbare Vergleichsumgebung benötigen. Für dauerhaft gleichmäßige Hochlast, zwingende physische Schnittstellen oder langfristige Nutzung sollten Sie dagegen den Kauf und die eigene Administration eines Mac weiterhin gegenrechnen. Beginnen Sie mit Ihrem seriellen Referenzlauf, testen Sie danach begrenzte Parallelität und erweitern Sie erst dann die Mac-Kapazität, wenn die Messdaten eine Trennung tatsächlich rechtfertigen.