Comment connecter votre Agent IA à Screeb

Si vous avez lu les autres guides AI Experience, vous savez déjà ce que Screeb AI peut faire remonter une fois votre agent connecté : Agent Analysis, Topics, scoring TRUE, et plus. Cet article couvre la configuration elle-même : enregistrer votre agent dans Screeb et lui faire envoyer sa première conversation trackée.

Étape 1 : Enregistrez votre Agent dans Screeb

Avant d'envoyer la moindre donnée, créez une fiche agent dans Screeb. Allez dans votre liste AI Agents, cliquez sur Add an Agent, et donnez-lui un id, un nom, et une courte description de ce qu'il fait.
Cet id est celui que vous référencerez depuis votre code en tant que agent_id.

Étape 2 : Trackez la Conversation depuis votre Code

Screeb utilise le même tracking d'événements que partout ailleurs dans votre produit, avec deux événements dédiés :

screeb_copilot_user_prompt, déclenché chaque fois qu'un utilisateur envoie un message à votre agent, avec prompt, conversation_id, session_id, et agent_id.
screeb_copilot_response, déclenché chaque fois que votre agent répond, avec response, conversation_id, session_id, et agent_id.

Exemple (SDK JS) :
js

$screeb("event.copilot", "screeb_copilot_user_prompt", {
  prompt: "Comment puis-je exporter mes données ?",
  conversation_id: "conv_123",
  session_id: "sess_456",
  agent_id: "agent_789",
});

Les deux événements d'un même échange doivent partager le même conversation_id et session_id : c'est ce qui permet à Screeb de reconstruire la conversation complète plutôt que de traiter chaque message indépendamment.

Étape 3 : Trackez la Conversion et la Satisfaction (Optionnel)

Deux événements supplémentaires affinent encore l'analyse :

screeb_copilot_conversion, déclenché quand l'interaction mène à un résultat réel (un achat, une inscription, une tâche complétée).
screeb_copilot_satisfaction, déclenché quand l'utilisateur note l'interaction, avec rating et rating_scale.

Ils ne sont pas nécessaires pour démarrer, mais ce sont eux qui relient une conversation à un impact business réel dans Agent Analysis et le scoring TRUE, plutôt que juste au contenu de la conversation.

Étape 4 : Vérifiez que ça remonte

Une fois en ligne, les conversations commencent à apparaître dans Agent Analysis, Topics, et les autres dashboards AI XP, généralement en quelques minutes.
Si rien n'apparaît après quelques minutes, vérifiez d'abord que les deux événements obligatoires se déclenchent avec des identifiants correspondants avant de supposer un problème plus profond.

Checklist rapide

Ai-je créé l'agent dans la liste AI Agents et noté son agent_id ?
Les deux événements obligatoires (user_prompt, response) se déclenchent-ils avec des conversation_id et session_id correspondants ?
Ai-je ajouté les événements conversion et satisfaction si pertinents pour mon cas d'usage ?
Ai-je confirmé que les données apparaissent dans Agent Analysis quelques minutes après la mise en ligne ?

Mis à jour le : 14/08/2026

Cet article a-t-il répondu à vos questions ?

Merci !