AgentFlow
Konfiguration

Routing

Kostenbewusstes Routing von Step-Klassen zu lokalen oder Cloud-Agents.

Routing

application/internal/routing/router.go ordnet jedem Schritt einen Agent und ein Modell über Schrittklassen wie summarize, implementation oder pre_review zu. Der Router liest routing aus config.yaml. Es gibt keine „Telefonate“ zu Anbietern, um Modelle zu „finden“ — models und agents in Ihrer YAML sind maßgeblich.

Konfiguration

Strategien bündeln Präferenzen: welche Klassen lokal bleiben, welche ein schnelles Cloud-Profil rechtfertigen, welche ein schwereres Profil, und wie viele Fehlversuche einen Fallback auslösen.

routing:
  default_strategy: cost_aware
  strategies:
    cost_aware:
      prefer_local_for: [summarize, classify, context_selection, pre_review, log_analysis]
      use_cloud_fast_for: [implementation_medium, review_medium, planning_complex]
      use_cloud_heavy_for: [architecture_critical, security_sensitive, large_refactor]
      local_failures_before_cloud: 1
      cloud_fast_failures_before_heavy: 1

Entscheidungsfluss

Das Diagramm entspricht der Reihenfolge im Code: lokale Präferenz zuerst, dann Cloud-Sperren, dann schwere gegenüber schnellen Cloud-Buckets, mit Fallbacks, wenn keine Liste exakt passt.

flowchart TD
  A[Step class] --> B{In prefer_local_for?}
  B -->|yes| C[default_enricher / ollama]
  B -->|no| D{no_cloud without allow_cloud?}
  D -->|yes| C
  D -->|no| E{In use_cloud_heavy_for?}
  E -->|yes| F[claude profile]
  E -->|no| G{In use_cloud_fast_for?}
  G -->|yes| H[default_agent / cursor]
  G -->|no| H

CLI-Overrides

Dieselbe Entscheidungslogik ohne YAML zu ändern: lokal erzwingen, wo die Strategie es erlaubt; Cloud nur mit ausdrücklicher Erlaubnis.

FlagWirkung
--prefer-localErzwingt den lokalen Pfad, wenn die Strategie passt
--no-cloudBlockiert Cloud, außer zusammen mit --allow-cloud
--allow-cloudExplizite Erlaubnis für Cloud-Routing

Verwandtes