Инструментируйте ваш агент

Ваш агент уже генерирует всё, что стоит записывать — вызовы модели, вызовы инструментов, границы узлов, ожидания человека, ошибки. Фреймворк это выбрасывает. SDK это сохраняет.

Пользовательские агенты

Агент, который вы написали сами, или его нет в списке ниже.

LangChain и LangGraph

Графы, узлы, инструменты, retriever’ы, модели.

CrewAI

Crews, flows, агенты по ролям, инструменты.

LlamaIndex

Workflows, steps, function agents, retriever’ы.

Pydantic AI

Типизированные агенты, capabilities, инструменты, retries.

Три строки, для любого фреймворка

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()          # определяет импортированные вами фреймворки

with failproofai_sdk.session():
    ...                               # ваш существующий вызов агента, без изменений

Никаких декораторов на ваших функциях, никаких callback’ов, передаваемых вашим вызовам, никаких id’ов, пронизывающих ваш код. Отличается только вызов внутри session:

LangGraph
CrewAI
LlamaIndex
Pydantic AI
Custom agents

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

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

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

Дополнительная установка нужна для фреймворка. Каждый адаптер поставляется в базовом пакете, поэтому проекту, который уже имеет свой фреймворк, не нужна никаких дополнительных установок.

Проверьте доставку

Запустите одну инструментированную сессию, затем откройте Observe → Sessions и выберите вашу среду. Запуск появится как восстановленная трассировка. Если ничего не приходит, проверьте подключение машины с помощью failproofai config --status. Смотрите Set up capture.

Не проверяйте директорию spool для подтверждения доставки. Daemon Failproof собирает и удаляет каждый пакет за миллисекунды, поэтому чтение директории может конкурировать с сборщиком и показывать намного меньше событий, чем было выпущено.

Каждый quickstart выше ведёт на его полное руководство — что записывается, опции, streaming, именование span’ов и проблемы, которые действительно встречаются. Они находятся под Trace Agents → Plug in your agent.

Как это работает

Модель данных, id’ы, типы событий и как события доходят до Cloud.

Прочитайте трассировку

Следите за причинно-следственной связью на всей сессии вместо разрозненных логов.

Найдите вашу первую ошибку

Проверьте сессии, которые вы только что захватили.

Start here

Инструментируйте ваш агент

Пользовательские агенты

LangChain и LangGraph

CrewAI

LlamaIndex

Pydantic AI

Три строки, для любого фреймворка

Проверьте доставку

Далее

Как это работает

Прочитайте трассировку

Найдите вашу первую ошибку

Пользовательские агенты

LangChain и LangGraph

CrewAI

LlamaIndex

Pydantic AI

​Три строки, для любого фреймворка

​Проверьте доставку

​Далее

Как это работает

Прочитайте трассировку

Найдите вашу первую ошибку

Три строки, для любого фреймворка

Проверьте доставку

Далее