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. Les requêtes de données lisent uniquement les données de ton équipe et ne modifient jamais rien.
• 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.
• Des suggestions adaptées à tes données — les tuiles au-dessus du champ de saisie s’appuient sur ce que ton équipe a déjà créé. Une suggestion n’apparaît que si les données existent pour elle : « 5 idées de contenu pour ta thématique principale », par exemple, seulement une fois que tu as des mots-clés ou des articles — sinon, tu verras une suggestion de démarrage comme « Créer le premier projet ». Ainsi, aucune suggestion ne te coûte jamais de crédits pour une réponse qui, faute de données, ne pourrait pas en être une.

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.

Poser une question sur un passage précis de la réponse

Les réponses du chat sont souvent longues, et la question de suivi ne porte généralement que sur une phrase précise. Plutôt que de la retaper, tu la sélectionnes : dès que tu sélectionnes du texte dans un message du chat, un petit bouton Demander à l’IA apparaît à côté.

Un clic dessus place le texte sélectionné comme citation avant ton brouillon dans le champ de saisie — comme une citation Markdown, donc chaque ligne précédée d'un >. Le curseur saute à la fin, et le champ de saisie te demande avec « Question sur le texte sélectionné … » la question proprement dite. Tu l'écris à la suite et tu envoies.

La citation, c'est le contexte. Elle est envoyée comme partie de ton message, pas comme information invisible en plus — tu vois donc exactement ce que voit l'IA, et dans ta bulle de message, la citation reste ensuite visuellement détachée.

Trois choses à savoir sur ce bouton :

• Il n'apparaît que dans un message du chat. Si tu sélectionnes du texte dans l'en-tête ou dans l'état vide, rien ne se passe — c'est voulu, sinon il gênerait partout.
• Il disparaît de lui-même quand tu cliques à côté, annules la sélection, fais défiler ou appuies sur Échap.
• Il est aussi accessible sans souris. Si tu sélectionnes avec Maj et les flèches, le bouton ne prend le focus que lorsque tu relâches la touche Maj — tant que tu la maintiens, tu peux continuer à étendre la sélection. Sur mobile, le bouton apparaît sous la sélection pour que ton doigt ne le cache pas.

Arrêter une demande en cours

Tant que « Rankion AI denkt nach… » s'affiche, un bouton Arrêter apparaît à côté. Un clic met fin à la demande : l'IA cesse de travailler, et tu peux immédiatement poser une nouvelle question — tu n'as pas besoin d'attendre que l'ancien passage se termine de lui-même.

Trois choses à savoir à ce sujet :

• Après l'arrêt, plus aucun coût n'est généré. Ce que l'IA avait déjà fait jusque-là est en revanche déjà arrivé et reste facturé — un arrêt ne rembourse pas les crédits déjà consommés. Plus tôt tu arrêtes, moins il en a été consommé.
• Une réponse déjà commencée reste affichée. Si l'IA avait déjà écrit du texte, il reste dans l'historique, marqué comme incomplet. Tu vois donc ce que tu as payé et peux t'appuyer dessus.
• Un plan de travail en cours est arrêté avec elle. Si l'IA avait prévu plusieurs étapes pour ta question, celles-ci sont également annulées — rien ne continue de tourner en arrière-plan.

L'arrêt est aussi accessible via l'API : POST /v1/agentic/sessions/{session}/abort, sans coût en crédits.

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.