Routines and headless

Studieopmerkingen: Cloud Automatisering met Cloud Code

Kernconcept: Automatisering zonder handmatige tussenkomst

• Het doel is om taken die je handmatig uitvoert, te automatiseren via Cloud.
• Er zijn drie hoofdmodi voor automatisering: Routines, Headless Mode en Agent SDK.

**1. Routines (Voor herhalende taken)**

• Definitie: Een routine bundelt een prompt, de repository en de benodigde connectoren.
• Werking: De routine wordt uitgevoerd op de Anthropix infrastructuur (geen lokale machine nodig).
• Triggers: Kan worden getriggerd door een cron-schema, een HTTP POST naar een API-endpoint, of een GitHub-gebeurtenis (bijv. nieuwe pull request).
• Beperkingen:
• Routines zijn in een research preview; gedrag en limieten kunnen veranderen.
• Een terugkerend schema draait maximaal per uur.
• Elke run start met een verse clone van de default branch.
• Push-toestemming is standaard beperkt tot cloud/prefix branches (beveiligingsmaatregel).

**2. Headless Mode (Voor integratie in bestaande pipelines)**

• Doel: Gebruik Cloud Code vanuit je eigen scripts of applicaties wanneer volledige controle nodig is.
• Gebruik: Voer Cloud Code uit als een 'one-shot' commando zonder interactie.
• Vlag -P (alias): Voert Cloud Code uit als een eenmalig commando.
• Vlag --bear: Schakelt auto-discovery uit voor hooks, skills, plugins, MCP servers en de cloud MD file. Dit zorgt voor een snellere start en alleen de expliciet toegestane tools.

**3. Agent SDK (Voor integratie in eigen producten)**

• Doel: Een bibliotheek die Cloud Code in je eigen TypeScript- of Python-applicaties integreert.
• Functionaliteit: Biedt een query-functie en dezelfde primitieven als de schema.
• Toepassing: De schema matching object kan worden gebruikt om data direct in SQL te laden.

Data en Structuurbeheer

• JSON Schema: Je kunt een JSON schema koppelen aan het outputformaat.
• Beperking: Cloud beperkt de structuur van de output om overeen te komen met het opgegeven schema.
• Gestructureerde Output: Door het outputformaat op JSON te zetten, komt het schema-match object in het gestructureerde outputveld van de JSON-respons. Dit maakt het eenvoudig om de data te verwerken met commando's zoals jq.

Geavanceerde Automatisering

• Multi-step Automatisering: Gebruik de sessie-ID uit de JSON-output om de workflow te continueren. Eén script start het werk, een ander resumeert het later met de volledige context.

Samenvatting van Gebruiksscenario's

• Routines: Standaard voor herhalend werk op de Anthropix infrastructuur.
• Headless Mode: Wanneer de taak je eigen pipeline of script nodig heeft.
• Agent SDK: Wanneer het werk binnen je eigen product moet plaatsvinden.

Takeaways

• Cloud Automatisering wordt uitgevoerd via drie hoofdmodi: Routines (herhalend werk op Anthropix), Headless Mode (one-shot commando's in pipelines), en Agent SDK (integratie in eigen applicaties).
• Routines zijn ontworpen voor herhalende taken, getriggerd door schema's (cron, HTTP, GitHub) en draaien op de Anthropix infrastructuur.
• Headless Mode wordt gebruikt voor interactieloze, eenmalige uitvoering van Cloud Code binnen bestaande scripts, vaak met vlaggen zoals -P of --bear.
• JSON Schema wordt gebruikt om de output gestructureerd te maken, waardoor het schema-match object eenvoudig verwerkt kan worden met tools zoals jq.
• Multi-step Automatisering is mogelijk door het sessie-ID uit de JSON-output te gebruiken om een workflow later te continueren.