> ## 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.
# Integrations
title: "Strumenta il tuo agente"
sidebarTitle: "Framework"
description: "Collega qualsiasi framework di agenti supportato a Failproof AI con una sola chiamata."
icon: "plug"
------------
Il tuo agente produce già tutto ciò che vale la pena registrare — chiamate di modello, chiamate di strumenti, limiti dei nodi, attese umane, errori. Il framework lo butta via. L'SDK lo conserva.
Un agente che hai scritto tu stesso, o uno non elencato qui.
Grafi, nodi, strumenti, retriever, modelli.
Crew, flussi, agenti per ruolo, strumenti.
Workflow, step, agenti di funzione, retriever.
Agenti tipizzati, capacità, strumenti, nuovi tentativi.
## Tre righe, qualsiasi 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 Agenti personalizzati theme={null}
pip install failproofai-sdk
```
```python theme={null}
import failproofai_sdk
failproofai_sdk.configure(environment="production")
failproofai_sdk.instrument() # rileva i framework che hai importato
with failproofai_sdk.session():
... # la tua chiamata di agente esistente, invariata
```
Nessun decoratore sulle tue funzioni, nessun callback passato alle tue chiamate, nessun id thread nel tuo codice. Solo la chiamata all'interno della sessione differisce:
```python theme={null}
graph.invoke({"messages": [HumanMessage("...")]})
```
```python theme={null}
Crew(agents=[analyst, writer], tasks=[gather, summarise]).kickoff()
```
```python theme={null}
await agent.run("...") # under `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)
```
L'extra installa il **framework**. Ogni adapter è incluso nella wheel di base, quindi un progetto che ha già il suo framework non necessita di extra.
## Verifica l'arrivo
Esegui una sessione strumentata, quindi apri **Observe → Sessions** e seleziona il tuo ambiente. L'esecuzione appare come una traccia ricostruita.
Se nulla arriva, conferma che la macchina è connessa con `failproofai config --status`. Vedi [Configura la cattura](/it/start/setup).
Non controllare la directory di spool per confermare la consegna. Il daemon Failproof raccoglie ed elimina ogni batch entro millisecondi, quindi leggerlo gara con il collettore e mostra molti meno eventi di quelli emessi.
## Prossimo
Ogni quickstart sopra rimanda alla sua guida completa — cosa viene registrato, opzioni, streaming, denominazione span e i problemi che le persone effettivamente riscontrano. Vivono sotto **Trace Agents → Plug in your agent**.
Il modello di dati, gli id, i tipi di evento e come gli eventi raggiungono Cloud.
Segui la causalità attraverso una sessione invece di log disconnessi.
Controlla le sessioni che hai appena catturato.