> ## 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.
# Инструментируй свой агент
> Подключи любой поддерживаемый фреймворк агента к Failproof AI одним вызовом.
Твой агент уже производит всё, что стоит записывать — вызовы модели, вызовы инструментов, границы узлов, ожидания пользователя, ошибки. Фреймворк выбрасывает это. SDK сохраняет.
Агент, который ты написал сам, или один из тех, что здесь не перечислены.
Графы, узлы, инструменты, ретриверы, модели.
Команды, потоки, агенты по ролям, инструменты.
Рабочие процессы, шаги, функциональные агенты, ретриверы.
Типизированные агенты, возможности, инструменты, повторы.
## Три строки, любой фреймворк
```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 Custom agents theme={null}
pip install failproofai-sdk
```
```python theme={null}
import failproofai_sdk
failproofai_sdk.configure(environment="production")
failproofai_sdk.instrument() # обнаруживает импортированные фреймворки
with failproofai_sdk.session():
... # твой существующий вызов агента, без изменений
```
Без декораторов на функциях, без коллбэка, передаваемого вызовам, без идентификаторов, пропущенных через твой код. Только вызов внутри сессии отличается:
```python theme={null}
graph.invoke({"messages": [HumanMessage("...")]})
```
```python theme={null}
Crew(agents=[analyst, writer], tasks=[gather, summarise]).kickoff()
```
```python theme={null}
await agent.run("...") # под `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)
```
Дополнительная установка — это **фреймворк**. Каждый адаптер поставляется в базовом пакете, поэтому проект, который уже имеет свой фреймворк, не нуждается ни в чём дополнительном.
## Проверь доставку
Запусти одну инструментированную сессию, затем открой **Observe → Sessions** и выбери твоё окружение. Запуск появится как восстановленная трасса.
Если ничего не поступило, проверь, подключена ли машина командой `failproofai config --status`. Смотри [Настройка захвата](/ru/start/setup).
Не проверяй директорию спула для подтверждения доставки. Daemon Failproof собирает и удаляет каждый пакет в течение миллисекунд, поэтому чтение спула гонится с коллектором и показывает гораздо меньше событий, чем было испущено.
## Дальше
Каждый быстрый старт выше ссылается на его полное руководство — что записывается, опции, потоковая передача, именование спанов и проблемы, с которыми люди на самом деле сталкиваются. Они находятся в разделе **Trace Agents → Plug in your agent**.
Модель данных, идентификаторы, типы событий и как события достигают Cloud.
Проследи причинность через сессию вместо разрозненных логов.
Проверь сессии, которые ты только что захватил.