> ## Documentation Index
> Fetch the complete documentation index at: https://docs.befailproof.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Instrumente seu agente
> Conecte qualquer framework de agente compatível ao Failproof AI com uma única chamada.
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.
Um agente que você mesmo escreveu, ou um que não está listado aqui.
Grafos, nós, ferramentas, retrievers, modelos.
Crews, fluxos, agentes por papel, ferramentas.
Workflows, etapas, function agents, retrievers.
Agentes tipados, capacidades, ferramentas, retentativas.
## Três linhas, qualquer framework
```bash LangGraph theme={null}
pip install 'failproofai-sdk[langgraph]'
```
```bash CrewAI theme={null}
pip install 'failproofai-sdk[crewai]'
```
```bash LlamaIndex theme={null}
pip install 'failproofai-sdk[llamaindex]'
```
```bash Pydantic AI theme={null}
pip install 'failproofai-sdk[pydantic-ai]'
```
```bash Custom agents theme={null}
pip install failproofai-sdk
```
```python theme={null}
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:
```python theme={null}
graph.invoke({"messages": [HumanMessage("...")]})
```
```python theme={null}
Crew(agents=[analyst, writer], tasks=[gather, summarise]).kickoff()
```
```python theme={null}
await agent.run("...") # dentro de `async with failproofai_sdk.session():`
```
```python theme={null}
agent.run_sync("...")
```
```python theme={null}
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](/pt-br/start/setup).
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**.
O modelo de dados, os IDs, os tipos de eventos e como os eventos chegam à Cloud.
Acompanhe a causalidade ao longo de uma sessão em vez de logs desconectados.
Audite as sessões que você acabou de capturar.