Task-Kommandos

ai-hub-cli task erstellt, lädt und steuert Tasks in AI Hub über die REST-API. Die Commands verwenden dieselbe Authentifizierung wie MCP (--url / AI_HUB_URL und --api-key / AI_HUB_API_KEY). Aus einer Hub-URL wie https://hub.example.com oder https://hub.example.com/api/mcp leitet die CLI automatisch die REST-Basis …/api ab.

Ein zentrales Konzept ist der Task-Kontext: Setze AI_HUB_TASK_ID oder übergib --task-id, dann verwenden zielbezogene Unterbefehle diese ID automatisch. task create erstellt in diesem Kontext standardmäßig einen Subtask, außer du setzt --subtask-of, gibst subtaskOf in --json-file an oder nutzt --no-parent.

Globale Task-Flags

Flag	Beschreibung
--task-id	Default-Task-UUID für Befehle mit optionalem Task-Argument; Standard aus AI_HUB_TASK_ID.
--full-json	Gibt die vollständige API-Antwort aus, inklusive null- und false-Feldern.

Task erstellen

ai-hub-cli task create \
  --name "Daten prüfen" \
  --description "CSV importieren und validieren" \
  --space-id 00000000-0000-0000-0000-000000000000 \
  --agent-id 11111111-1111-1111-1111-111111111111 \
  --priority 2 \
  --data '{"source":"upload.csv"}'

ai-hub-cli task create --json-file task.json
cat task.json | ai-hub-cli task create --json-file -

Flag	Beschreibung
--data	JSON-Objekt für data; der Task-Typ ist immer agent.
--json-file	Vollständiger JSON-Body als Datei oder - für stdin. Nicht mit anderen Create-Flags kombinieren.
--name	Anzeigename.
--title	Alias für --name; darf nicht von --name abweichen.
--description	Beschreibung.
--space-id	Space-UUID.
--agent-id	Agent-UUID.
--tool-id	Tool-ID.
--priority	Priorität 0 bis 4.
--max-retries	Maximale Wiederholungen; Standard 3.
--scheduled-for	Geplanter Startzeitpunkt als ISO-8601-Zeit.
--deadline	Deadline als ISO-8601-Zeit.
--subtask-of	Parent-Task-UUID(s); wiederholbar oder kommagetrennt. Überschreibt automatischen Parent.
--no-parent	Erstellt einen Top-Level-Task trotz --task-id oder AI_HUB_TASK_ID.
--blocks	Task-UUID(s), die durch diesen Task blockiert werden.
--blocked-by	Task-UUID(s), die vorher abgeschlossen sein müssen.

Task laden und Status steuern

ai-hub-cli task get <task-id>
ai-hub-cli task --task-id <task-id> start
ai-hub-cli task --task-id <task-id> pause
ai-hub-cli task --task-id <task-id> stop

Unterbefehl	Argumente	Beschreibung
get	[<task-id>]	Lädt einen Task. Ohne Argument wird --task-id bzw. AI_HUB_TASK_ID verwendet.
start	[<task-id>]	Markiert den Task als laufend.
pause	[<task-id>]	Pausiert einen laufenden Task.
stop	[<task-id>]	Ruft dieselbe API wie pause auf.

Abschließen, Fehler und Fortschritt

ai-hub-cli task complete <task-id> \
  --message "Fertig" \
  --result '{"rows":1200,"valid":1198}'

ai-hub-cli task fail <task-id> --message "Importdatei fehlt"
ai-hub-cli task progress <task-id> --percent 65 --message "Validierung läuft"

Unterbefehl	Flags	Beschreibung
complete	--result, --message	Schließt den Task erfolgreich ab. --result muss gültiges JSON sein.
fail	--message	Markiert den Task als fehlgeschlagen; --message ist Pflicht.
progress	--percent, --message	Meldet Fortschritt von 0 bis 100; --percent ist Pflicht.

Aktualisieren und Queues lesen

ai-hub-cli task update <task-id> --json-file update.json
ai-hub-cli task next --type agent --timeout-ms 30000
ai-hub-cli task list --limit 100
ai-hub-cli task list --parent-id <task-id>
ai-hub-cli task list --all
ai-hub-cli task upcoming --type agent

Unterbefehl	Flags	Beschreibung
update	--json-file	Ändert Felder eines Tasks per JSON-Body; Datei oder - für stdin.
next	--type, --timeout-ms	Wartet auf den nächsten Task und claimed ihn für den Worker. --type ist wiederholbar, --timeout-ms erlaubt 0 bis 120000.
list	--limit, --parent-id, --all	Listet Tasks. Standardmäßig werden bei gesetztem Kontext Subtasks dieses Tasks gefiltert.
upcoming	--type	Listet geplante Tasks, deren Zeitpunkt noch nicht erreicht ist.