Agentic Chat

Agentic Chat est l'interface en langage naturel de Rankion vers toute la plateforme. Au lieu de basculer entre 40+ outils, tu écris une question. L'agent maître clarifie en cas d'ambiguïté, construit un plan structuré, délègue les étapes à des sous-agents spécialisés, appelle des outils, observe les résultats et livre une réponse synthétisée. Tous les plans sont persistés et interrogeables, tous les appels d'outils sont facturés en crédits comme partout ailleurs. Pour les power users qui préfèrent atteindre leurs données plateforme par question plutôt que par clic.

Ce qu'il peut faire

• Pipeline Brainstorm → Plan → Execute — chaque requête passe par la même pipeline. Trivial = plan à 1 étape, complexe = multi-étapes avec sous-agents. 0 approval-gate.
• Questions de clarification — en cas d'ambiguïté, l'agent déclenche clarify_intent avec 1 à 3 questions, plutôt que de deviner.
• Délégation à sous-agents — les étapes sont dispatchées à des sous-agents Analyze, Research ou Action, qui font leurs propres appels d'outils et reportent via report_to_master.
• Tool-calling — accès à tous les modules : scorer l'AI-Visibility, rechercher des mots-clés, générer des articles, pull de backlinks, vérifier la position SERP, créer des action-items, envoyer des e-mails, analyser des images, interroger ses propres données.
• UI live avec SSE — pastille live sticky pendant l'exécution du plan, carte permanente dans le stream après l'achèvement, sidebar opt-in pour le drill-down de chaque étape avec output JSON et tool calls.
• Plans persistants — tables propres agentic_plans (1 ligne/plan) et agentic_plan_steps (N lignes/plan), historique des plans par session, smart-retry avec invalidation des étapes dépendantes.
• Intégration Wiki — l'outil query_wiki parcourt ce wiki et cite les sources.

Exemples de prompts

• « Quels de mes mots-clés ne rankent pas dans le top 10 ? »
• « Écris un article sur changer un amortisseur et publie-le sur le blog autohaus-mueller. »
• « Qui est cité dans ChatGPT sur le sujet baskets véganes qui n'est pas nous ? »
• « Quels backlinks avons-nous perdus ces 30 derniers jours et sont toxiques ? »
• « Crée un PDF Reality-Check à partir du dernier tracking-run et envoie-le à info@firma.de. »
• « Construis-moi un cluster de 50 long-tails sur crm software avec KD<35. »

Quand l'utiliser

• Tu ne connais pas le chemin de clic dans l'UI ou tu veux le contourner.
• Tu as besoin d'une réponse qui combine des données de 3+ modules (ex. backlinks × rank-tracker × AVI).
• Tu veux une mini-pipeline répétable sans code (Generate → Score → Publish).
• Tu veux une télémétrie de plan (quelle étape, quels outils, quels crédits) comme audit-trail.

Workflow

1. Ouvrir une session — UI sous /chat ou API. Optionnel gallery_image_id pour les requêtes visuelles.
2. Demander — POST /agentic/chat avec {message, session_id?}.
3. Répondre à la clarification — si l'agent demande, réponds normalement dans le message suivant.
4. Observer le plan — la pastille live affiche les étapes + le statut courant. Sidebar pour le drill-down.
5. Recevoir le résultat — la réponse contient text, tool_calls[], iterations, credits_used, duration_ms, resumed.

Pour les pulls async (par ex. DataForSEO), l'endpoint attend côté serveur via wait_for_final=true (par défaut) jusqu'à ~480 s le tour final de resume — resumed: true signifie : le text est la réponse finale, pas l'indication d'attente.

API

Body de /agentic/chat :

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

Crédits et limites

• Variable. Les crédits dépendent des outils que l'agent appelle (par ex. Keyword Research = 5, Generate = 5, Image Analyze = selon le mode).
• Cap d'itérations : 150 tool-calls par tour (overridable via env).
• Cap wall-clock : 25 minutes par tour.
• No-progress detector : 8 — en cas de stagnation, l'agent passe à un summarize-call tools-disabled au lieu d'une erreur dure.
• Hardlimit PHP-FPM : 600 s de réponse synchrone. Configure le client timeout en conséquence.
• Triple-scoped : team_id + user_id + session_id contre IDOR.

Modules associés

• AI-Visibility Tracking — l'agent peut lancer des tracking-runs et interpréter les valeurs AVI.
• Keyword Explorer & Research — les outils de recherche sont directement appelables.
• AI Content Editor — Generate, Score, Optimize, Publish entièrement orchestrables.
• Module Backlinks — pulls de backlinks et détection de toxicité par question.