Agentic Chat

Agentic Chat es la interfaz en lenguaje natural de Rankion para toda la plataforma. En lugar de cambiar entre 40+ herramientas, escribes una pregunta. El master agent aclara cuando hay ambigüedad, construye un plan estructurado, delega pasos en subagentes especializados, llama herramientas, observa resultados y entrega una respuesta resumida. Todos los planes son persistentes y consultables, todas las llamadas a herramientas se descuentan en créditos como siempre. Para power-users que prefieren acceder a sus datos por pregunta en lugar de por clic.

Qué puede hacer

• Pipeline Brainstorm → Plan → Execute — cada solicitud pasa por la misma pipeline. Trivial = plan de 1 paso, complejo = multi-step con subagentes. 0 approval gates.
• Preguntas de aclaración — ante ambigüedad, el agente dispara clarify_intent con 1–3 preguntas, en lugar de adivinar.
• Delegación a subagentes — los pasos se despachan a subagentes Analyze, Research o Action que hacen sus propias tool calls y reportan vía report_to_master.
• Tool-Calling — acceso a todos los módulos: puntuar AI-Visibility, investigar palabras clave, generar artículos, traer backlinks, comprobar posición SERP, crear action-items, enviar emails, analizar imágenes, consultar tus datos. Las consultas de datos solo leen los datos de tu propio equipo y nunca modifican nada.
• UI en vivo con SSE — píldora live sticky mientras corre el plan, tarjeta permanente en el stream tras finalizar, sidebar opt-in para drill-down de cada step incluido el output JSON y las tool calls.
• Planes persistentes — tablas propias agentic_plans (1 fila/plan) y agentic_plan_steps (N filas/plan), historial de planes por sesión, smart-retry con invalidación de pasos dependientes.
• Integración con la wiki — la herramienta query_wiki busca en esta wiki y cita las fuentes.
• Sugerencias que encajan con tus datos — las tarjetas encima del campo de entrada se basan en lo que tu equipo ya ha creado. Una sugerencia solo aparece cuando existen los datos para ella: «5 ideas de contenido para tu área temática más importante», por ejemplo, solo cuando ya tienes palabras clave o artículos — si no, verás una sugerencia inicial como «Crear primer proyecto». Así, ninguna sugerencia te cuesta créditos por una respuesta que, por falta de datos, no podría serlo.

Prompts de ejemplo

• «¿Qué palabras clave mías no están en Top 10?»
• «Escribe un artículo sobre cambiar amortiguadores y publícalo en el Blog autohaus-mueller.»
• «¿A quién cita ChatGPT sobre zapatillas veganas que no seamos nosotros?»
• «¿Qué backlinks hemos perdido en los últimos 30 días y son tóxicos?»
• «Genera un PDF Reality Check del último tracking-run y envíalo a info@firma.de.»
• «Construye un clúster de 50 long-tails sobre crm software con KD<35.»

Cuándo usarlo

• No conoces el camino de clic en la UI o quieres saltártelo.
• Necesitas una respuesta que combine datos de 3+ módulos (p.ej. Backlinks × Rank-Tracker × AVI).
• Quieres una mini-pipeline repetible sin código (Generate → Score → Publish).
• Quieres telemetría del plan (qué paso, qué tools, qué créditos) como audit trail.

Workflow

1. Abre la sesión — UI en /chat o vía API. Opcionalmente gallery_image_id para consultas visuales.
2. Pregunta — POST /agentic/chat con {message, session_id?}.
3. Responde a la aclaración — si el agente pregunta, contesta normal en el siguiente mensaje.
4. Observa el plan — la píldora live muestra steps + estado actual. Sidebar para drill-down.
5. Recibe el resultado — la response contiene text, tool_calls[], iterations, credits_used, duration_ms, resumed.

En async-pulls (p.ej. DataForSEO) el endpoint espera del lado del servidor mediante wait_for_final=true (default) hasta ~480 s al turn final de Resume — resumed: true significa: el text es la respuesta final, no el aviso de espera.

API

Body de /agentic/chat:

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

Créditos y límites

• Variable. Los créditos dependen de las herramientas que llame el agente (p.ej. Keyword-Research = 5, Generate = 5, Image-Analyze = según modo).
• Iteration cap: 150 tool calls por turn (configurable por env).
• Wall-clock cap: 25 minutos por turn.
• No-Progress-Detector: 8 — al detectar parálisis, el agente cambia a una llamada Summarize sin tools en lugar de un error duro.
• Hardlimit PHP-FPM: 600 s de respuesta síncrona. Ajusta el timeout del cliente en consecuencia.
• Triple-scoped: team_id + user_id + session_id contra IDOR.

Preguntar sobre un punto concreto de la respuesta

Las respuestas del chat suelen ser largas, y la pregunta de seguimiento normalmente se refiere solo a una frase de ella. En lugar de volver a escribirla, selecciónala: en cuanto seleccionas texto en un mensaje del chat, aparece junto a él un pequeño botón Preguntar a la IA.

Al hacer clic en él, el texto seleccionado se coloca como cita antes de tu borrador en el campo de entrada — como cita en formato Markdown, es decir, cada línea precedida de >. El cursor salta al final, y el campo de entrada te pide con «Tu pregunta sobre el texto seleccionado …» la pregunta propiamente dicha. La escribes a continuación y envías.

La cita es el contexto. Se envía como parte de tu mensaje, no como información adicional invisible — así que ves exactamente lo mismo que ve la IA, y en tu burbuja de mensaje la cita queda después visualmente separada.

Tres cosas sobre el botón:

• Solo aparece en un mensaje del chat. Si seleccionas texto en la cabecera o en el estado vacío, no pasa nada — es intencionado, si no estaría siempre en medio.
• Desaparece solo cuando haces clic al lado, quitas la selección, haces scroll o pulsas Escape.
• También es accesible sin ratón. Si seleccionas con Mayús y las teclas de flecha, el botón solo obtiene el foco cuando sueltas la tecla Mayús — mientras la mantienes pulsada, puedes seguir ampliando la selección. En móvil, el botón aparece debajo de la selección para que el dedo no lo tape.

Detener una solicitud en curso

Mientras se muestra «Rankion AI denkt nach…», aparece a su lado un botón Detener. Un clic termina la solicitud: la IA deja de trabajar y puedes preguntar algo nuevo de inmediato — no tienes que esperar a que el proceso anterior termine por sí solo.

Tres cosas que debes saber al respecto:

• Tras detener no se generan más costes. Lo que la IA ya había hecho hasta ese momento, sin embargo, ya ha ocurrido y sigue facturado — detener no devuelve los créditos ya consumidos. Cuanto antes detengas, menos se habrá consumido.
• Una respuesta ya iniciada permanece visible. Si la IA ya había escrito texto, este queda en el historial, marcado como incompleto. Así ves por qué pagaste y puedes construir sobre ello.
• Un plan de trabajo en curso se detiene junto con ella. Si la IA había planeado varios pasos para tu pregunta, estos también se cancelan — no sigue corriendo nada en segundo plano.

Detener también es posible a través de la interfaz: POST /v1/agentic/sessions/{session}/abort, sin coste en créditos.

Módulos relacionados

• AI-Visibility Tracking — el agente puede arrancar tracking-runs e interpretar valores AVI.
• Keyword Explorer & Research — herramientas de investigación directamente invocables.
• AI Content Editor — Generate, Score, Optimize y Publish completamente orquestables.
• Módulo de Backlinks — pulls de backlinks y detección de tóxicos por pregunta.