Zum Hauptinhalt springen

​
Überblick

Das Nudgen CLI wurde mit einem AI-First-Ansatz entwickelt. Während es Menschen ein ansprechendes TUI (Terminal User Interface) bietet, ist jeder Befehl auch für die Maschine-zu-Maschine-Kommunikation optimiert.

​
Agentische Muster (Agentic Patterns)

Wenn ein KI-Agent (wie Claude, GPT oder ein spezialisierter Automatisierungs-Agent) das CLI nutzt, sollte er diese Muster befolgen:
  1. JSON-Ausgabe: Hängen Sie --json an jeden Befehl an, um maschinenlesbare Daten zu erhalten.
  2. Kontextbewusstsein: Prüfen Sie stets den Team-Kontext, bevor Sie Operationen durchführen.
  3. Nicht-interaktiv: Verwenden Sie Flags, um interaktive TUI-Abfragen zu umgehen.

​
JSON-Automatisierung

Jeder Listen- und Status-Befehl unterstützt das Flag --json. Dies gibt eine saubere JSON-Struktur anstelle einer formatierten Tabelle zurück. 
# Alle Kampagnen als JSON abrufen
nudgen campaigns list --json

# Kontakte im aktuellen Team abrufen
nudgen contacts list --json

​
Multi-Tenant-Workflow für Agenten

Da Nudgen mehrere Teams unterstützt, muss ein Agent sicherstellen, dass er im richtigen Team agiert, bevor er Ressourcen erstellt oder aktualisiert. Empfohlener Workflow:
  1. Aktuelles Team prüfen: 
    nudgen teams current --json
  2. Team wechseln (falls nötig): Wenn die id aus dem vorherigen Schritt nicht zum Ziel-Team passt, wechseln Sie: 
    nudgen teams switch <target-team-id>
  3. Daten-Befehl ausführen: Fahren Sie mit campaigns, contacts oder brand Befehlen fort.

​
Best Practices für Agenten-Entwickler

  • Fehlerbehandlung: Überwachen Sie den Exit-Code von CLI-Befehlen. Ein Exit-Code ungleich Null deutet auf einen Fehler hin (Validierung, Netzwerk oder Authentifizierung).
  • Ratenbegrenzung (Rate Limiting): Das CLI kommuniziert mit der Nudgen-API. Stellen Sie sicher, dass Ihre Agenten-Skripte potenzielle Zeitüberschreitungen oder Ratenbegrenzungen abfangen.
  • Stiller Modus (Silent Mode): Wenn ein Befehl für bestimmte Abfragen kein spezifisches Flag unterstützt, stellen Sie sicher, dass Ihr Agent die stdout/stderr-Streams verarbeiten kann, ohne in einer TUI-Schleife hängen zu bleiben.