Routines and headless

🤖 Cloud Code Automatisierung: Schlüsselkonzepte

💡 Grundprinzip

• Ziel: Manuelle Aufgaben durch automatisierte Cloud-Prozesse ersetzen.
• Kernidee: Ein gespeicherter Prompt wird mit Repositories und Connectors gebündelt und auf der Anthropix-Infrastruktur ausgeführt.

⚙️ Routinen (Routines)

• Definition: Ein Bundle aus Prompt, Repository und notwendigen Connectors.
• Ausführung: Läuft auf der verwalteten Anthropix-Infrastruktur (keine lokale Maschine nötig).
• Trigger: Cron-Zeitpläne, HTTP-POST an API-Endpunkte oder GitHub-Ereignisse (z. B. neuer Pull Request).
• Anwendungsfall: Wiederkehrende, repetitive Aufgaben (z. B. tägliche Abhängigkeitsprüfung, PR-Triage).
• Einschränkungen:
• Status als Forschungs-Preview (Verhalten und Limits können sich ändern).
• Maximal eine Ausführung pro Stunde.
• Startet immer mit einem frischen Klon des Standard-Branches.
• Schreibzugriff ist standardmäßig auf cloud/prefix-Branches beschränkt (Sicherheitsmaßnahme).

🛠️ Modus-Optionen

Headless Mode (-P Flag)

• Zweck: Wenn die Aufgabe in bestehende Pipelines oder Skripte integriert werden muss.
• Funktion: Führt Cloud Code als einmaligen Befehl (one-shot command) aus, ohne interaktive Umgebung.
• I/O: Liest Standard-Input und schreibt Standard-Output (funktioniert wie jedes Shell-Tool).

Bare Mode (--bear)

• Zweck: Für CI/CD-Umgebungen, die reproduzierbare Ergebnisse benötigen.
• Funktion: Überspringt die automatische Entdeckung von Hooks, Skills, Plugins, MCP-Servern und MD-Dateien.
• Vorteil: Schnelleres Startverhalten; nur explizit zugelassene Tools werden verwendet.

📊 Strukturierte Ausgabe und Datenverarbeitung

• Schema-Matching: JSON-Schema mit dem Output Format JSON verknüpfen.
• Funktion: Cloud erzwingt, dass die Ausgabe dem definierten Schema entspricht.
• Nutzung: Das strukturierte Objekt kann über Befehle wie JQ in Datenbanken oder andere Skripte gepiped werden.
• Multi-Step-Automation: Durch Speicherung der Session-ID aus der JSON-Ausgabe kann ein Prozess fortgesetzt werden, um den Kontext zu erhalten.

💻 Agent SDK

• Zweck: Integration von Cloud Code in eigene Anwendungen (z. B. in TypeScript oder Python).
• Funktion: Bietet eine Bibliothek, die Cloud Code in benutzerdefinierte Produkte einbettet.
• Funktionen: Bietet eine Query-Funktion und die gleichen Primitiven wie das Schema.
• SQL-Integration: Das Schema-Matching-Objekt kann direkt in SQL-Abfragen verwendet werden.

🎯 Zusammenfassung der Anwendungsfälle

• Routinen: Standard für wiederkehrende, automatisierte Arbeit (auf Anthropix gehostet).
• Headless Mode: Wenn die Aufgabe in eine bestehende Pipeline integriert werden muss.
• Bare Mode: Wenn in CI/CD-Umgebungen konsistente Ergebnisse erforderlich sind.
• Agent SDK: Wenn die Arbeit direkt in das eigene Produkt eingebettet werden soll.

Takeaways

• Routinen sind das Kernkonzept der Automatisierung: Ein Bundle aus Prompt, Repository und Connectors, das auf der Anthropix-Infrastruktur läuft und durch Trigger (Cron, API, GitHub-Ereignisse) gestartet wird.
• Headless Mode (-P) wird für einmalige Befehle in bestehende Pipelines genutzt, während Bare Mode (--bear) für CI/CD-Umgebungen optimiert ist, indem er Hooks und Plugins überspringt.
• Schema-Matching erzwingt, dass die Cloud-Ausgabe einem definierten JSON-Schema entspricht, was die Weiterverarbeitung des strukturierten Objekts (z. B. mit JQ) ermöglicht.
• Das Agent SDK ermöglicht die direkte Einbettung von Cloud Code in eigene Anwendungen (z. B. in Python oder TypeScript) und bietet Funktionen wie Query und SQL-Integration.