Configurer le Prompt-Monitoring

Dans chaque projet AI-Visibility apparaissent souvent des centaines de prompts. Tous ne sont pas d'importance égale — et vous ne voulez pas tous les envoyer quotidiennement à quatre fournisseurs LLM. Avec le Prompt-Monitoring, vous choisissez explicitement quels prompts entrent dans le prochain run de tracking, et vous voyez immédiatement ce que cela vous coûte par mois.

Qu'est-ce que le Prompt-Monitoring ?

Chaque prompt du projet a un monitor_status (active, paused, excluded). Seuls les prompts avec le statut active sont inclus dans le run de tracking nocturne — tous les autres restent dans la base de données mais ne sont plus réinterrogés auprès des fournisseurs LLM. Les données historiques sont conservées dans tous les cas.

En plus, Rankion fournit pour chaque prompt :

• monthly_search_volume — volume de recherche via DataForSeo (rafraîchissement quotidien)
• priority_score — log(volume + 1) * intent_weight avec intent_weight dérivé de commercial_intent (high=1.0, medium=0.7, low=0.4)
• funnel_stage — dérivé de prompt_category (Achat / Comparaison / Décision / Notoriété)

Où trouver la sélection ?

Dans le détail du projet (/ai-visibility/{id}), en haut à droite, vous trouvez le bouton « Monitoring ». Lien direct :

/ai-visibility/{trackingProject}/monitoring

Comprendre l'aperçu du coût

En haut, en position fixe, s'affiche : « X sur Y prompts sélectionnés — ≈ €Z/mois ». L'estimation suit :

monthly_call_count = active_prompts × providers_per_run × runs_per_month
monthly_cost_eur   = monthly_call_count × avg_cost_per_call_cents / 100

Valeurs par défaut de config/tracking.php : 4 fournisseurs, 30 runs/mois, 0,5 ct par appel. Pour 50 prompts, cela donne ≈ €30/mois.

Dès que vous modifiez les filtres ou mettez en pause/activez des prompts, l'aperçu se recalcule en direct — sans que rien ne soit encore enregistré.

Activer le Top-N par priorité

Cliquez sur « Activer le Top 50 par priorité » dans la barre d'outils de traitement en masse. Cela positionne les 50 valeurs de priority_score les plus élevées sur active et toutes les autres visibles sur paused. N'oubliez pas d'enregistrer — jusque-là, ce ne sont que des overrides locaux.

Mettre en pause des prompts individuels

Chaque ligne du tableau est cliquable — un clic bascule entre active et paused. Le statut effectif se reflète immédiatement dans l'aperçu du coût.

Que se passe-t-il avec les prompts en pause ?

• Ils n'entrent pas dans le prochain run de tracking.
• Les données LlmResult existantes restent inchangées — les tendances et insights continuent d'afficher toutes les valeurs historiques.
• Vous pouvez les réactiver à tout moment via la même page.

Compatibilité ascendante

Tant que vous n'avez rien sélectionné dans le projet (monitor_user_decided = false pour tous les prompts), le run de tracking fonctionne comme avant : tous les prompts is_active=true sont surveillés. Ce n'est qu'après le premier enregistrement que la logique de sous-ensemble entre en jeu.

Référence API

L'UI utilise ces 4 endpoints — également disponibles directement :

• GET /api/v1/tracking-projects/{id}/prompts/cost-preview
• PATCH /api/v1/tracking-projects/{id}/prompts/{promptId}/monitor
• POST /api/v1/tracking-projects/{id}/prompts/bulk-monitor
• POST /api/v1/tracking-projects/{id}/prompts/refresh-volumes

De plus, l'outil AI-Agent preview_monitoring_cost est appelable dans le chat agentic : « Combien coûterait la surveillance de tous les prompts avec la persona X ? »