> ## Documentation Index
> Fetch the complete documentation index at: https://docs.befailproof.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Instrumentez votre agent
> Connectez n'importe quel framework d'agent supporté à Failproof AI en un seul appel.
Votre agent produit déjà tout ce qui mérite d'être enregistré — appels de modèle, appels d'outils, limites de nœuds, attentes humaines, échecs. Le framework les jette. Le SDK les conserve.
Un agent que vous avez écrit vous-même, ou un agent qui ne figure pas dans cette liste.
Graphes, nœuds, outils, retrievers, modèles.
Crews, flows, agents par rôle, outils.
Workflows, étapes, agents de fonction, retrievers.
Agents typés, capacités, outils, tentatives.
## Trois lignes, quel que soit le framework
```bash LangGraph theme={null}
pip install 'failproofai-sdk[langgraph]'
```
```bash CrewAI theme={null}
pip install 'failproofai-sdk[crewai]'
```
```bash LlamaIndex theme={null}
pip install 'failproofai-sdk[llamaindex]'
```
```bash Pydantic AI theme={null}
pip install 'failproofai-sdk[pydantic-ai]'
```
```bash Custom agents theme={null}
pip install failproofai-sdk
```
```python theme={null}
import failproofai_sdk
failproofai_sdk.configure(environment="production")
failproofai_sdk.instrument() # détecte les frameworks que vous avez importés
with failproofai_sdk.session():
... # votre appel d'agent existant, inchangé
```
Pas de décorateurs sur vos fonctions, pas de callback passé à vos appels, pas d'identifiants propagés dans votre code. Seul l'appel à l'intérieur de la session diffère :
```python theme={null}
graph.invoke({"messages": [HumanMessage("...")]})
```
```python theme={null}
Crew(agents=[analyst, writer], tasks=[gather, summarise]).kickoff()
```
```python theme={null}
await agent.run("...") # sous `async with failproofai_sdk.session():`
```
```python theme={null}
agent.run_sync("...")
```
```python theme={null}
with failproofai_sdk.agent("planner"):
with failproofai_sdk.tool_call("search", input={"q": q}) as t:
t.output = search(q)
```
L'installation supplémentaire ajoute le **framework**. Chaque adaptateur est inclus dans le wheel de base, donc un projet qui dispose déjà de son framework n'a besoin d'aucune installation supplémentaire.
## Vérifier que les données sont bien reçues
Exécutez une session instrumentée, puis ouvrez **Observe → Sessions** et sélectionnez votre environnement. L'exécution apparaît sous forme de trace reconstruite.
Si rien n'arrive, vérifiez que la machine est connectée avec `failproofai config --status`. Consultez [Configurer la capture](/fr/start/setup).
Ne vérifiez pas le répertoire spool pour confirmer la livraison. Le daemon Failproof collecte et supprime chaque lot en quelques millisecondes, donc lire ce répertoire entre en compétition avec le collecteur et affiche bien moins d'événements que ce qui a été émis.
## Étape suivante
Chaque démarrage rapide ci-dessus renvoie à son guide complet — ce qui est enregistré, les options, le streaming, le nommage des spans, et les problèmes que les gens rencontrent réellement. Ils se trouvent sous **Trace Agents → Plug in your agent**.
Le modèle de données, les identifiants, les types d'événements, et comment les événements atteignent le Cloud.
Suivez la causalité à travers une session plutôt que des logs déconnectés.
Auditez les sessions que vous venez de capturer.