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

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

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

Агент, который ты написал сам, или один из тех, что здесь не перечислены.

LangChain и LangGraph

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

CrewAI

Команды, потоки, агенты по ролям, инструменты.

LlamaIndex

Рабочие процессы, шаги, функциональные агенты, ретриверы.

Pydantic AI

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

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

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():
    ...                               # твой существующий вызов агента, без изменений

Без декораторов на функциях, без коллбэка, передаваемого вызовам, без идентификаторов, пропущенных через твой код. Только вызов внутри сессии отличается:

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. Смотри Настройка захвата.

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

Дальше

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

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

Модель данных, идентификаторы, типы событий и как события достигают Cloud.

Прочитай трассу

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

Найди первый отказ

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

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

LangChain и LangGraph

CrewAI

LlamaIndex

Pydantic AI

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

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

​Дальше

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

Прочитай трассу

Найди первый отказ

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

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

Дальше