Instrumentez votre agent

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.

Agents personnalisés

Un agent que vous avez écrit vous-même, ou un agent qui ne figure pas dans cette liste.

LangChain et LangGraph

Graphes, nœuds, outils, retrievers, modèles.

CrewAI

Crews, flows, agents par rôle, outils.

LlamaIndex

Workflows, étapes, agents de fonction, retrievers.

Pydantic AI

Agents typés, capacités, outils, tentatives.

Trois lignes, quel que soit le framework

pip install 'failproofai-sdk[langgraph]'

pip install 'failproofai-sdk[crewai]'

pip install 'failproofai-sdk[llamaindex]'

pip install 'failproofai-sdk[pydantic-ai]'

pip install failproofai-sdk

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 :

LangGraph
CrewAI
LlamaIndex
Pydantic AI
Custom agents

graph.invoke({"messages": [HumanMessage("...")]})

Crew(agents=[analyst, writer], tasks=[gather, summarise]).kickoff()

await agent.run("...")        # sous `async with failproofai_sdk.session():`

agent.run_sync("...")

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.

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.

Comment ça fonctionne

Le modèle de données, les identifiants, les types d’événements, et comment les événements atteignent le Cloud.

Lire une trace

Suivez la causalité à travers une session plutôt que des logs déconnectés.

Trouver votre premier échec

Auditez les sessions que vous venez de capturer.

Agents personnalisés

LangChain et LangGraph

CrewAI

LlamaIndex

Pydantic AI

​Trois lignes, quel que soit le framework

​Vérifier que les données sont bien reçues

​Étape suivante

Comment ça fonctionne

Lire une trace

Trouver votre premier échec

Trois lignes, quel que soit le framework

Vérifier que les données sont bien reçues

Étape suivante