Instrumenter votre agent

Votre agent produit déjà tout ce qui mérite d’être enregistré — appels au modèle, appels d’outils, limites de nœuds, attentes humaines, échecs. Le framework jette tout ça. Le SDK le conserve.

Agents personnalisés

Un agent que vous avez écrit vous-même, ou un agent non répertorié ici.

LangChain et LangGraph

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

CrewAI

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

LlamaIndex

Workflows, étapes, agents fonctionnels, 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é

Aucun décorateur sur vos fonctions, aucun callback passé à vos appels, aucun identifiant propagé 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 installe le framework. Chaque adaptateur est inclus dans le package de base, donc un projet qui possède déjà son framework n’a besoin d’aucun supplément.

Vérifier que les données sont bien arrivées

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 de spool pour confirmer la livraison. Le daemon Failproof collecte et supprime chaque lot en quelques millisecondes, donc le lire entre en concurrence avec le collecteur et affiche bien moins d’événements que ce qui a été émis.

Étapes suivantes

Chaque guide de 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.

Fonctionnement

Le modèle de données, les identifiants, les types d’événements et la façon dont 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 arrivées

​Étapes suivantes

Fonctionnement

Lire une trace

Trouver votre premier échec

Trois lignes, quel que soit le framework

Vérifier que les données sont bien arrivées

Étapes suivantes