Erstellung von CLIs für KI-Agenten: Designprinzipien von Googles gws CLI

Warum Agenten-zuerst-CLI-Design wichtig ist

Die Entwicklererfahrung (DX) für Menschen optimiert für Entdeckbarkeit und Verzeihlichkeit, während die Agenten-DX Vorhersagbarkeit und Verteidigung in der Tiefe erfordert. Der Artikel argumentiert, dass die Nachrüstung von Menschen-zuerst-CLIs für Agenten ineffektiv ist, und demonstriert dies anhand der gws CLI von Google für Google Workspace, die von Anfang an mit KI-Agenten als primären Nutzern entworfen wurde.

Wichtige Designprinzipien

Rohe JSON-Nutzlasten statt maßgeschneiderter Flags: Menschen bevorzugen einfache Flags wie --title "My Doc", aber Agenten arbeiten besser mit direkten JSON-Nutzlasten, die sich ohne Übersetzungsverlust auf API-Schemata abbilden.

Beispielvergleich:

Menschen-zuerst (10 Flags, flacher Namensraum):
my-cli spreadsheet create --title "Q1 Budget" --locale "en_US" --timezone "America/Denver" --sheet-title "January" --sheet-type GRID --frozen-rows 1 --frozen-cols 2 --row-count 100 --col-count 10 --hidden false

Agenten-zuerst (ein JSON-Flag):
gws sheets spreadsheets create --json '
{
  "properties": {"title": "Q1 Budget", "locale": "en_US", "timeZone": "America/Denver"},
  "sheets": [{"properties": {"title": "January", "sheetType": "GRID", "gridProperties": {"frozenRowCount": 1, "frozenColumnCount": 2, "rowCount": 100, "columnCount": 10}, "hidden": false}}]
}'

Die gws CLI verwendet --params und --json Flags für alle Eingaben und akzeptiert vollständige API-Nutzlasten direkt. Der empfohlene Ansatz ist, beide Pfade in derselben Binärdatei zu unterstützen, anstatt separate Tools zu pflegen.

Zusätzliche Überlegungen

Der Artikel skizziert mehrere weitere Designüberlegungen für Agenten-zuerst-CLIs:

• Schema-Introspektion: Selbstbeschreibende Schemata, die Agenten zur Laufzeit introspektieren können
• Kontextfenster-Disziplin: Verwaltung der Ausgabe, um innerhalb der Agenten-Kontextgrenzen zu passen
• Eingabe-Härtung: Schutz vor Agenten-Halluzinationen
• Agenten-Fähigkeiten: Bereitstellung von Fähigkeiten anstatt nur Befehlen
• Multi-Oberflächen-Unterstützung: Zusammenarbeit mit MCP, Erweiterungen und Umgebungsvariablen
• Sicherheitsbarrieren: Trockenlauf-Modi und Antwortbereinigung

CLIs werden zur reibungslosesten Schnittstelle für KI-Agenten, um mit externen Systemen zu interagieren, und erfordern deterministische, maschinenlesbare Ausgaben anstatt menschenorientierter Oberflächen.