Agentic Chat

Agentic Chat ist Rankions natürlichsprachliche Schnittstelle zur ganzen Plattform. Statt zwischen 40+ Tools zu wechseln, schreibst du eine Frage. Der Master-Agent klärt bei Mehrdeutigkeit nach, baut einen strukturierten Plan, delegiert Steps an spezialisierte Subagents, ruft Tools auf, beobachtet Ergebnisse und liefert eine zusammengefasste Antwort. Alle Pläne sind persistiert und queryable, alle Tool-Calls werden mit Credits verrechnet wie sonst auch. Für Power-User, die ihre Plattform-Daten lieber per Frage statt per Klick erreichen.

Was es kann

• Brainstorm → Plan → Execute Pipeline — jede Anfrage durchläuft die gleiche Pipeline. Trivial = 1-Step-Plan, komplex = Multi-Step mit Subagents. 0 Approval-Gates.
• Klärungs-Fragen — bei Mehrdeutigkeit triggert der Agent clarify_intent mit 1–3 Fragen, statt zu raten.
• Subagent-Delegation — Steps werden an Analyze-, Research- oder Action-Subagents dispatched, die ihre eigenen Tool-Calls machen und per report_to_master zurückmelden.
• Tool-Calling — Zugriff auf alle Module: AI-Visibility scoren, Keywords recherchieren, Artikel generieren, Backlinks pullen, SERP-Position prüfen, Action-Items erstellen, E-Mails schicken, Bilder analysieren, eigene Daten queryen.
• Live-UI mit SSE — sticky Live-Pille während der Plan läuft, Permanent-Card im Stream nach Abschluss, opt-in Sidebar für Drill-Down jedes Steps inklusive Output-JSON und Tool-Calls.
• Persistent Plans — eigene Tabellen agentic_plans (1 Row/Plan) und agentic_plan_steps (N Rows/Plan), Plan-History pro Session, Smart-Retry mit Invalidation abhängiger Steps.
• Wiki-Integration — query_wiki-Tool durchsucht dieses Wiki und zitiert die Quellen.

Beispiel-Prompts

• „Welche meiner Keywords ranken nicht in Top 10?"
• „Schreib einen Artikel zu Stoßdämpfer wechseln und veröffentliche ihn auf Blog autohaus-mueller."
• „Wer wird in ChatGPT zum Thema vegane Sneaker zitiert, der nicht von uns ist?"
• „Welche Backlinks haben wir in den letzten 30 Tagen verloren und sind toxisch?"
• „Erstelle aus dem letzten Tracking-Run einen Reality-Check-PDF und schick ihn an info@firma.de."
• „Bau mir einen Cluster aus 50 Long-Tails zu crm software mit KD<35."

Wann nutzen

• Du kennst den Klick-Pfad in der UI nicht oder willst ihn umgehen.
• Du brauchst eine Antwort, die Daten aus 3+ Modulen kombiniert (z.B. Backlinks × Rank-Tracker × AVI).
• Du willst eine wiederholbare Mini-Pipeline ohne Code (Generate → Score → Publish).
• Du willst Plan-Telemetrie (welcher Step, welche Tools, welche Credits) als Audit-Trail.

Workflow

1. Session öffnen — UI unter /chat oder API. Optional gallery_image_id für visuelle Anfragen.
2. Fragen — POST /agentic/chat mit {message, session_id?}.
3. Klärung beantworten — wenn Agent nachfragt, antworte normal in der nächsten Message.
4. Plan beobachten — Live-Pille zeigt Steps + aktuellen Status. Sidebar für Drill-Down.
5. Resultat erhalten — Response enthält text, tool_calls[], iterations, credits_used, duration_ms, resumed.

Bei async-pulls (z.B. DataForSEO) wartet der Endpoint serverseitig per wait_for_final=true (default) bis zu ~480 s auf den finalen Resume-Turn — resumed: true heißt: der text ist die fertige Antwort, nicht der Wartehinweis.

API

Body von /agentic/chat:

{
  "message": "Welche Backlinks habe ich in 30 Tagen verloren?",
  "session_id": 1234
}

Credits & Limits

• Variabel. Credits hängen von den Tools ab, die der Agent aufruft (z.B. Keyword-Research = 5, Generate = 5, Image-Analyze = je nach Modus).
• Iterations-Cap: 150 Tool-Calls pro Turn (env-overridable).
• Wall-Clock-Cap: 25 Minuten pro Turn.
• No-Progress-Detector: 8 — bei Stillstand wechselt der Agent in einen tools-disabled Summarize-Call statt einer harten Fehlermeldung.
• PHP-FPM Hardlimit: 600 s synchronen Response. Setze Client-Timeout entsprechend.
• Triple-scoped: team_id + user_id + session_id gegen IDOR.

Verwandte Module

• AI-Visibility Tracking — der Agent kann Tracking-Runs starten und AVI-Werte interpretieren.
• Keyword Explorer & Research — Recherche-Tools sind direkt callable.
• AI Content Editor — Generate, Score, Optimize, Publish komplett orchestrierbar.
• Backlinks-Modul — Backlink-Pulls und Toxic-Detection per Frage.