Integrations - Failproof AI

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.

Agenti personalizzati

Un agente che hai scritto tu stesso, o uno non elencato qui.

LangChain e LangGraph

Grafi, nodi, strumenti, retriever, modelli.

CrewAI

Crew, flussi, agenti per ruolo, strumenti.

LlamaIndex

Workflow, step, agenti di funzione, retriever.

Pydantic AI

Agenti tipizzati, capacità, strumenti, nuovi tentativi.

Tre righe, qualsiasi 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()          # 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:

LangGraph
CrewAI
LlamaIndex
Pydantic AI
Agenti personalizzati

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

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

await agent.run("...")        # under `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)

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.

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.

Come funziona

Il modello di dati, gli id, i tipi di evento e come gli eventi raggiungono Cloud.

Leggi una traccia

Segui la causalità attraverso una sessione invece di log disconnessi.

Trova il tuo primo errore

Controlla le sessioni che hai appena catturato.

​title: “Strumenta il tuo agente” sidebarTitle: “Framework” description: “Collega qualsiasi framework di agenti supportato a Failproof AI con una sola chiamata.” icon: “plug”

Agenti personalizzati

LangChain e LangGraph

CrewAI

LlamaIndex

Pydantic AI

​Tre righe, qualsiasi framework

​Verifica l’arrivo

​Prossimo

Come funziona

Leggi una traccia

Trova il tuo primo errore

title: “Strumenta il tuo agente” sidebarTitle: “Framework” description: “Collega qualsiasi framework di agenti supportato a Failproof AI con una sola chiamata.” icon: “plug”

Tre righe, qualsiasi framework

Verifica l’arrivo

Prossimo