/pattern/codeact/

01 · Single AgentCode-as-ActionProgrammatic ActionExecutable Reasoning

CodeAct.
In Code denken. Ausführen. Beobachten. Wiederholen.

Der Agent verwendet ausführbaren Code statt reinem Text als primäres Medium für Aktionen und Schlussfolgerungen — er schreibt Code, führt ihn in einer Sandbox aus, beobachtet das typisierte Ergebnis und iteriert, sodass eine Berechnung ausgeführt statt in Prosa angenähert wird.

Wann man dazu greift

  • Berechnungen, Datentransformationen oder komplexe Tool-Aufrufe präzise ausführbar sein müssen.
  • Das Ergebnis reproduzierbar sein soll.
  • Mehrstufige Logik sich als ein Programm sauberer komponieren lässt denn als Kette einzelner Tool-Aufrufe.

Wann es nach hinten losgeht

  • Code-Ausführung nicht sicher in einer Sandbox isoliert werden kann.
  • Die Aufgabe rein sprachlicher Natur ist.
  • Der Overhead einer Code-Laufzeit einen einzelnen direkten Tool-Aufruf überwiegt.

Die Abwägung

Maximale Präzision und Reproduzierbarkeit stehen einem hohen Sandbox-, Sicherheits- und Laufzeit-Overhead gegenüber.

Das mentale Modell

Eine Schleife, die du auf eine Serviette zeichnen kannst.

Denken, Code emittieren, in einer Sandbox ausführen, das typisierte Ergebnis beobachten — und zurück zum Denken. Code ist die Aktion.

ThinkEmit CodeExecuteObserve
Fallstricke

Zwei Wege, wie dieses Pattern Probleme verursachen kann.

Sandbox-Ausbrüche über Datei- oder Netzwerkzugriff

Der emittierte Code liest sensible Dateien oder öffnet ausgehende Verbindungen trotz Sandbox.

Lösung · Eine gehärtete Sandbox mit strikten seccomp-Richtlinien, ohne Netzwerk und mit schreibgeschütztem Dateisystem verwenden.

Der Agent behandelt Ausführungsfehler als Erfolgssignale

Ein fehlgeschlagener Tool-Aufruf gibt stderr zurück, aber der Agent interpretiert es als gültige Beobachtung und fährt mit korruptem Zustand fort.

Lösung · Exit-Codes immer prüfen. Exit-Codes ungleich null als Fehler behandeln und zu einem Fehlerbehandlungsknoten weiterleiten.

Framework-Unterstützung

Wo CodeAct nativ ist.

OpenAI Agents SDKCode InterpreterNativ
AutoGen / AG2Executor-AgentenNativ
Microsoft Agent FrameworkCode-AusführungNativ
LangGraphCode-Node + SandboxNativ
Google ADKCode-ExecutorNativ

Suche

Patterns, Frameworks und Seiten durchsuchen.