Instrumenta tu agente - Failproof AI

Tu agente ya produce todo lo que vale la pena registrar: llamadas a modelos, llamadas a herramientas, límites de nodos, esperas humanas y fallos. El framework lo descarta. El SDK lo conserva.

Agentes personalizados

Un agente que escribiste tú mismo, o uno que no aparece aquí.

LangChain y LangGraph

Grafos, nodos, herramientas, retrievers, modelos.

CrewAI

Crews, flujos, agentes por rol, herramientas.

LlamaIndex

Workflows, pasos, agentes de funciones, retrievers.

Pydantic AI

Agentes tipados, capacidades, herramientas, reintentos.

Tres líneas, cualquiera que sea el 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()          # detecta los frameworks que importaste

with failproofai_sdk.session():
    ...                               # tu llamada al agente existente, sin cambios

Sin decoradores en tus funciones, sin callbacks pasados a tus llamadas, sin ids propagados por tu código. Solo difiere la llamada dentro de la sesión:

LangGraph
CrewAI
LlamaIndex
Pydantic AI
Custom agents

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

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

await agent.run("...")        # bajo `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)

El extra instala el framework. Cada adaptador viene incluido en el paquete base, por lo que un proyecto que ya tenga su framework no necesita ningún extra en absoluto.

Verifica que llegó

Ejecuta una sesión instrumentada y luego abre Observe → Sessions y selecciona tu entorno. La ejecución aparece como una traza reconstruida. Si no llega nada, confirma que la máquina está conectada con failproofai config --status. Consulta Configurar la captura.

No compruebes el directorio de spool para confirmar la entrega. El daemon de Failproof recopila y elimina cada lote en cuestión de milisegundos, por lo que leerlo compite con el recolector y muestra muchos menos eventos de los que se emitieron.

Siguientes pasos

Cada quickstart de arriba enlaza a su guía completa: qué se registra, opciones, streaming, nombres de spans y los problemas que la gente realmente encuentra. Se encuentran en Trace Agents → Plug in your agent.

Cómo funciona

El modelo de datos, los ids, los tipos de eventos y cómo los eventos llegan a Cloud.

Lee una traza

Sigue la causalidad a través de una sesión en lugar de logs desconectados.

Encuentra tu primer fallo

Audita las sesiones que acabas de capturar.

Agentes personalizados

LangChain y LangGraph

CrewAI

LlamaIndex

Pydantic AI

​Tres líneas, cualquiera que sea el framework

​Verifica que llegó

​Siguientes pasos

Cómo funciona

Lee una traza

Encuentra tu primer fallo

Tres líneas, cualquiera que sea el framework

Verifica que llegó

Siguientes pasos