Instrumente seu agente - Failproof AI

Seu agente já produz tudo o que vale registrar — chamadas de modelo, chamadas de ferramentas, limites de nós, esperas humanas, falhas. O framework descarta tudo isso. O SDK preserva.

Agentes personalizados

Um agente que você mesmo escreveu, ou um que não está listado aqui.

LangChain e LangGraph

Grafos, nós, ferramentas, retrievers, modelos.

CrewAI

Crews, flows, agentes por papel, ferramentas.

LlamaIndex

Workflows, steps, agentes de função, retrievers.

Pydantic AI

Agentes tipados, capacidades, ferramentas, retentativas.

Três linhas, qualquer 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 os frameworks que você importou

with failproofai_sdk.session():
    ...                               # sua chamada de agente existente, sem alterações

Sem decoradores nas suas funções, sem callbacks passados às suas chamadas, sem IDs espalhados pelo seu código. Apenas a chamada dentro da sessão muda:

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)

O extra instala o framework. Todos os adaptadores são distribuídos no pacote base, portanto um projeto que já possui seu framework não precisa de nenhum extra.

Verifique se chegou

Execute uma sessão instrumentada e abra Observe → Sessions, selecionando seu ambiente. A execução aparece como um trace reconstruído. Se nada chegar, confirme se a máquina está conectada com failproofai config --status. Veja Configurar captura.

Não verifique o diretório de spool para confirmar a entrega. O daemon do Failproof coleta e exclui cada lote em milissegundos, portanto ler esse diretório compete com o coletor e exibe muito menos eventos do que foram emitidos.

Próximos passos

Cada quickstart acima leva ao seu guia completo — o que é registrado, opções, streaming, nomenclatura de spans e os problemas que as pessoas realmente encontram. Eles ficam em Trace Agents → Plug in your agent.

Como funciona

O modelo de dados, os IDs, os tipos de eventos e como os eventos chegam à Cloud.

Leia um trace

Siga a causalidade por uma sessão em vez de logs desconectados.

Encontre sua primeira falha

Audite as sessões que você acabou de capturar.

Agentes personalizados

LangChain e LangGraph

CrewAI

LlamaIndex

Pydantic AI

​Três linhas, qualquer framework

​Verifique se chegou

​Próximos passos

Como funciona

Leia um trace

Encontre sua primeira falha

Três linhas, qualquer framework

Verifique se chegou

Próximos passos