Instrumenta tu agente - Failproof AI

Tu agente ya produce todo lo que vale la pena registrar: llamadas al modelo, 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, flows, agentes por rol, herramientas.

LlamaIndex

Workflows, pasos, agentes de función, retrievers.

Pydantic AI

Agentes tipados, capacidades, herramientas, reintentos.

Tres líneas, con cualquier 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 la llamada dentro de la sesión es diferente:

LangGraph
CrewAI
LlamaIndex
Pydantic AI
Custom agents

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

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

await agent.run("...")        # dentro de `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. Todos los adaptadores se incluyen en el paquete base, por lo que un proyecto que ya tiene 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 Set up capture.

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 mostrará muchos menos eventos de los que se emitieron.

A continuación

Cada quickstart anterior enlaza a su guía completa: qué se registra, opciones, streaming, nombres de spans y los problemas que la gente realmente encuentra. Están disponibles 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, con cualquier framework

​Verifica que llegó

​A continuación

Cómo funciona

Lee una traza

Encuentra tu primer fallo

Tres líneas, con cualquier framework

Verifica que llegó

A continuación