Erste Schritte mit AI Ops

Diese Anleitung bringt einen Subaccount in etwa 15 Minuten von "AI Ops ist aus" zu "die Nachfragekarte zeigt Live-Prognosen". Sie benötigen die Levy-Admin-Rolle und einen Subaccount mit mindestens 14 Tagen Fahrthistorie.

1. Prüfen, ob der Subaccount qualifiziert ist

AI Ops braucht Fahrthistorie zum Lernen. Brandneue Subaccounts mit weniger als 14 Tagen Fahrten fallen auf eine globale "Stadt-Dichte-Stufen"-Baseline zurück, und das Empfehlungssystem bleibt verborgen, bis 30 Tage verfügbar sind.

Prüfen Sie die Fahrtenzahl unter Dashboard > Rides und filtern Sie nach dem Subaccount. Wenn Sie weniger als zwei Wochen Daten haben, warten Sie noch — die Prognosen wären unsicher und das Empfehlungssystem würde nichts erzeugen.

2. Feature-Flag aktivieren

AI Ops wird durch ai_ops_enabled und ai_ops_tier auf dem Subaccount gesteuert. Um Phase 1 (nur Nachfragekarte) zu aktivieren:

• ai_ops_enabled → true
• ai_ops_tier → starter

Für das Empfehlungssystem setzen Sie ai_ops_tier auf pro. Für Techniker-Routen auf enterprise.

Sie können auch zwei zugehörige Einstellungen feinjustieren:

• tech_cost_per_mile_usd — wird vom Empfehlungssystem beim Abzug der Technikerkosten vom erwarteten Mehrertrag verwendet. Standardwert: 0.50.
• rebalance_battery_floor — minimaler Ladezustand, den ein Fahrzeug haben muss, um Rebalance-Kandidat zu sein. Standardwert: 30 (Prozent).

Siehe Feature-Flags und Stufen für die vollständige Referenz.

3. Einmaligen Backfill ausführen

Prognosen laufen stündlich per Cron, aber das Dashboard soll am ersten Tag nicht leer sein. Der interne Backfill-Endpunkt baut zwei Wochen Features und den ersten Satz Prognosen in einem einzigen Aufruf:

curl -X POST "https://fleets.levyelectric.com/api/internal/forecast/backfill" \
  -H "Authorization: Bearer $AI_OPS_INTERNAL_TOKEN" \
  -d '{"subaccountId":"<uuid>"}'

Das dauert typischerweise 30-90 Sekunden je nach Fahrtvolumen. Sobald der Aufruf zurückkehrt, hat die Heat-Maps-Seite etwas anzuzeigen.

4. Nachfragekarte prüfen

Öffnen Sie Dashboard > Analytics > Heat Maps für den Subaccount. Sie sollten sehen:

• Eine Karte zentriert auf Ihrem Servicegebiet, mit überlagerten H3-Hex-Polygonen.
• Drei Layer-Schalter: Predicted demand, Actual history, Unmet demand.
• Eine Horizont-Auswahl: 1h, 4h, 24h.
• Einen Zeitregler von -7 Tagen bis +24 Stunden.
• Zusammenfassungskacheln mit der vorhergesagten Gesamtfahrtzahl und der nachfragestärksten Hex-Zelle.

Wenn die Karte leer ist, siehe Fehlerbehebung.

5. Einen Zyklus warten und dann Empfehlungen prüfen

Wenn Sie ai_ops_tier auf pro oder höher gesetzt haben, läuft das Empfehlungssystem zur Minute 25 jeder Stunde. Warten Sie einen vollen Zyklus ab und öffnen Sie dann Dashboard > Operations > Rebalance. Sie sollten ein sortiertes Karten-Grid mit empfohlenen Bewegungen sehen.

6. Techniker-Routen aktivieren (nur Enterprise)

Mit ai_ops_tier='enterprise' läuft der Routen-Solver alle 30 Minuten während der Betriebszeiten (06:00-22:00 Ortszeit). Routen werden Technikern zugewiesen, die die Service-Tech-Rolle haben. Der Techniker sieht seine Route in der operator-app unter dem Route-Tab.

Pushen Sie das operator-app-OTA-Update, falls Ihre Techniker noch keinen Route-Screen haben:

cd operator-app
eas update --branch production --message "feat: enable AI Ops Route screen"

Was im Hintergrund läuft

Die Crons laufen automatisch. Nach dem Backfill müssen Sie sie nicht manuell triggern.

Nächste Schritte

• Nachfragekarte — vollständige Anleitung zur Heat-Maps-Seite.
• Rebalance-Empfehlungen — Karten lesen und umsetzen.
• Fehlerbehebung — häufige Einrichtungsprobleme.