> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.screeb.app/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Comment connecter votre Agent IA à Screeb

## 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 ?