Skip to main content
Three steps to your first Pydantic AI trace. For tools, retries, streaming, and options, see the full guide.

Install

Instrument

instrument() must run before you construct an Agent. The capability is appended at construction, so an agent built earlier records nothing — with no error, because nothing went wrong. This is the most common cause of an empty trace with this adapter, and module-scope agents are where it bites: import failproofai_sdk and call instrument() before importing the module that builds them.

Check it arrived

Run it once, then open Observe → Sessions and select your environment. Your run appears as a reconstructed trace. If nothing arrives, confirm the machine is connected with failproofai config --status.

Full Pydantic AI guide

What gets recorded, tools and retries, streaming, span naming, options, and common problems.