Agentic Chat

Agentic Chat is Rankion's natural-language interface to the entire platform. Instead of switching between 40+ tools, you write a question. The master agent asks for clarification when ambiguous, builds a structured plan, delegates steps to specialized subagents, calls tools, observes results, and returns a summarized answer. All plans are persisted and queryable, and all tool calls are billed in credits the same way they would be otherwise. For power users who'd rather reach platform data by question than by click.

What it can do

• Brainstorm → Plan → Execute pipeline — every request runs through the same pipeline. Trivial = 1-step plan, complex = multi-step with subagents. Zero approval gates.
• Clarification questions — when ambiguous, the agent triggers clarify_intent with 1–3 questions instead of guessing.
• Subagent delegation — steps are dispatched to Analyze, Research, or Action subagents that run their own tool calls and report back via report_to_master.
• Tool calling — access to all modules: score AI visibility, research keywords, generate articles, pull backlinks, check SERP positions, create action items, send emails, analyze images, query your own data.
• Live UI with SSE — sticky live pill while the plan runs, permanent card in the stream after it finishes, opt-in sidebar for drill-down on every step including output JSON and tool calls.
• Persistent plans — dedicated tables agentic_plans (1 row/plan) and agentic_plan_steps (N rows/plan), plan history per session, smart retry with invalidation of dependent steps.
• Wiki integration — the query_wiki tool searches this wiki and cites sources.

Example prompts

• "Which of my keywords don't rank in the top 10?"
• "Write an article about replacing shock absorbers and publish it to blog autohaus-mueller."
• "Who is cited in ChatGPT for vegan sneakers that isn't us?"
• "Which backlinks did we lose in the last 30 days and are toxic?"
• "Create a Reality Check PDF from the latest tracking run and email it to info@firma.de."
• "Build me a cluster of 50 long-tails for crm software with KD<35."

When to use

• You don't know the click path in the UI or want to skip it.
• You need an answer that combines data from 3+ modules (e.g. backlinks × Rank Tracker × AVI).
• You want a repeatable mini-pipeline without code (Generate → Score → Publish).
• You want plan telemetry (which step, which tools, which credits) as an audit trail.

Workflow

1. Open a session — UI at /chat or via API. Optional gallery_image_id for visual queries.
2. Ask — POST /agentic/chat with {message, session_id?}.
3. Answer clarifications — when the agent asks back, just reply normally in the next message.
4. Watch the plan — the live pill shows steps + current status. Sidebar for drill-down.
5. Get the result — the response contains text, tool_calls[], iterations, credits_used, duration_ms, resumed.

For async pulls (e.g. DataForSEO), the endpoint waits server-side via wait_for_final=true (default) for up to ~480 s for the final resume turn — resumed: true means the text is the finished answer, not the wait notice.

API

Body of /agentic/chat:

{
  "message": "Which backlinks did I lose in 30 days?",
  "session_id": 1234
}

Credits & Limits

• Variable. Credits depend on the tools the agent calls (e.g. Keyword Research = 5, Generate = 5, Image Analyze = depends on mode).
• Iterations cap: 150 tool calls per turn (env-overridable).
• Wall-clock cap: 25 minutes per turn.
• No-progress detector: 8 — on stall, the agent switches to a tools-disabled summarize call instead of a hard error.
• PHP-FPM hard limit: 600 s synchronous response. Set the client timeout accordingly.
• Triple-scoped: team_id + user_id + session_id against IDOR.

Related modules

• AI Visibility Tracking — the agent can start tracking runs and interpret AVI values.
• Keyword Explorer & Research — research tools are directly callable.
• AI Content Editor — Generate, Score, Optimize, Publish fully orchestratable.
• Backlinks Module — backlink pulls and toxic detection by question.