Instrumente seu agente - Failproof AI

Seu agente já produz tudo que vale a pena registrar — chamadas de modelo, chamadas de ferramenta, 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, fluxos, agentes por papel, ferramentas.

LlamaIndex

Workflows, etapas, function agents, 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 para suas chamadas, sem IDs espalhados pelo seu código. Apenas a chamada dentro da sessão é 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)

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

Verifique se chegou

Execute uma sessão instrumentada e, em seguida, abra Observe → Sessions e selecione seu ambiente. A execução aparece como um trace reconstruído. Se nada chegar, confirme que a máquina está conectada com failproofai config --status. Consulte 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, então 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

Acompanhe a causalidade ao longo de 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