# Failproof AI: Russian

> Trace agent behavior, find failures with audits, and prevent repeat failures with deployed policies.

## Russian

### Start

#### Start here

- [Сделайте своего агента безотказным](https://docs.befailproof.ai/ru/index.md): Наблюдаемость и контроль для каждого инструмента, который используют ваши агенты — CLI для кодирования, шлюзы чатов, самостоятельно размещённые ассистенты и ваши собственные инструментированные агенты.
- [Быстрый старт](https://docs.befailproof.ai/ru/start/quickstart.md): Захватите сессию агента, найдите сбой и начните его предотвращение.
- [Адаптеры агентов](https://docs.befailproof.ai/ru/reference/harnesses.md): Захватывайте сеансы и применяйте политики для всех 12 поддерживаемых адаптеров агентов.
- [Failproof Assistant](https://docs.befailproof.ai/ru/sessions/assistant.md): Анализируйте и управляйте Failproof AI на естественном языке: от вопросов и запросов до панелей управления и аудитов.
- [Запустите вашу первую проверку сбоев](https://docs.befailproof.ai/ru/start/first-audit.md): Создайте аудит из облачной панели управления или через CLI fp и проверьте его первые результаты.
- [Предотвратьте первый сбой с помощью политики](https://docs.befailproof.ai/ru/start/first-policy.md): Создайте версию политики, разверните её в режиме наблюдения, а затем включите её.
- [Выберите вашу конфигурацию](https://docs.befailproof.ai/ru/start/setup.md): Выберите локальное управление, Failproof AI Cloud или корпоративное развертывание.
- [Основные концепции](https://docs.befailproof.ai/ru/start/concepts.md): Небольшой набор концепций, используемых во всей системе Failproof AI.

##### Starter templates

- [Пользовательские агенты](https://docs.befailproof.ai/ru/start/quickstarts/custom-agents.md): Оберните вашего агента в три блока `with` и он начнет записывать данные.
- [LangChain и LangGraph](https://docs.befailproof.ai/ru/start/quickstarts/langchain.md): Установите, инструментируйте и получите свой первый трейс.
- [CrewAI](https://docs.befailproof.ai/ru/start/quickstarts/crewai.md): Установите, инструментируйте и получите первый трейс.
- [LlamaIndex](https://docs.befailproof.ai/ru/start/quickstarts/llamaindex.md): Установите, инструментируйте и посмотрите на первую трассировку.
- [Pydantic AI](https://docs.befailproof.ai/ru/start/quickstarts/pydantic-ai.md): Установите, инструментируйте и просмотрите вашу первую трассировку.

### Trace Agents

#### Understand every run

- [Сессии](https://docs.befailproof.ai/ru/sessions/overview.md): Начните с полной записи одного запуска агента.
- [Живые события](https://docs.befailproof.ai/ru/sessions/live-events.md): Наблюдайте за активностью агента в реальном времени во время выполнения сессии.
- [Прочитать трассу](https://docs.befailproof.ai/ru/sessions/read-a-trace.md): Найдите событие, которое изменило ход сеанса агента.
- [Модели](https://docs.befailproof.ai/ru/sessions/models.md): Сравнивайте задержку модели, токены, использование контекста и распределение трафика.
- [Hooks](https://docs.befailproof.ai/ru/sessions/hooks.md): Measure hook activity, triggers, and latency separately from policy outcomes.
- [Решения политик](https://docs.befailproof.ai/ru/sessions/policy-decisions.md): Посмотрите, какие политики были оценены, заблокированы, указаны или разрешены.
- [Tools](https://docs.befailproof.ai/ru/sessions/tools.md): Найдите медленные, неработающие или переиспользуемые инструменты в сеансах агента.
- [Ошибки](https://docs.befailproof.ai/ru/sessions/errors.md): Группируйте повторяющиеся ошибки и открывайте сеансы, в которых они произошли.
- [Метрики](https://docs.befailproof.ai/ru/sessions/metrics.md): Отображайте метрики величин, такие как задержка, стоимость и использование токенов.
- [Панели мониторинга](https://docs.befailproof.ai/ru/sessions/dashboards.md): Отслеживайте сигналы надёжности, важные для агента или рабочего процесса.
- [Запросы](https://docs.befailproof.ai/ru/sessions/queries.md): Изучите данные сессий, событий и оценок с помощью переиспользуемого SQL.

#### Plug in your agent

- [Инструментируйте ваш агент](https://docs.befailproof.ai/ru/start/integrations.md): Подключите любой поддерживаемый фреймворк агента к Failproof AI одним вызовом.
- [Пользовательские агенты](https://docs.befailproof.ai/ru/start/integrations/custom-agents.md): Инструментируйте агента, который вы написали сами, или фреймворк без адаптера.
- [LangChain и LangGraph](https://docs.befailproof.ai/ru/start/integrations/langchain.md): Инструментируйте графы, узлы, инструменты, ретриверы и вызовы моделей одним вызовом.
- [CrewAI](https://docs.befailproof.ai/ru/start/integrations/crewai.md): Оркестрируйте команды, потоки, агентов по ролям, инструменты, память и обратную связь от пользователей.
- [LlamaIndex](https://docs.befailproof.ai/ru/start/integrations/llamaindex.md): Инструментируйте workflows, steps, function agents и retrievers.
- [Pydantic AI](https://docs.befailproof.ai/ru/start/integrations/pydantic-ai.md): Инструментируйте типизированные агенты, инструменты, вызовы моделей и повторные попытки.

### Find failures

#### Evaluate agents

- [Оценка агентов](https://docs.befailproof.ai/ru/evaluations/overview.md): Оценивайте каждую завершённую сессию с помощью проверок на Python или LLM-судей в вашей инфраструктуре.
- [Написать оценку](https://docs.befailproof.ai/ru/evaluations/write.md): Опишите, что нужно измерить, и позвольте помощнику составить размещённую оценку на Python, или напишите код сами. Судьи на основе LLM работают в вашем воркере.
- [Протестировать оценку](https://docs.befailproof.ai/ru/evaluations/test.md): Запустите оценку для ваших реальных сессий перед развёртыванием. Ничего не сохраняется.
- [Развернуть и версионировать оценку](https://docs.befailproof.ai/ru/evaluations/deploy.md): Разверните неизменяемую версию, посмотрите, что активно, опубликуйте новые версии, откатитесь назад и оцените уже имеющиеся сессии.
- [Читать результаты оценок](https://docs.befailproof.ai/ru/sessions/evaluations.md): Визуализируйте оценки на графике во времени, сравнивайте агентов и окружения, узнайте, почему сессия получила низкий балл, и задайте вопросы ассистенту.

#### Find and manage failures

- [Аудиты](https://docs.befailproof.ai/ru/audits/overview.md): Проверьте определенную совокупность сессий на наличие сбоев, которые одни только трассировки не выявят.
- [Аудит истории локального агента](https://docs.befailproof.ai/ru/audits/local-audit.md): Проведите офлайн-сканирование поддерживаемых историй CLI агентов и проверьте рискованное или неэффективное поведение локально.
- [Настройка аудита](https://docs.befailproof.ai/ru/audits/setup.md): Определите цель аудита, популяцию сессий и контекст доказательств.
- [Контекст агента](https://docs.befailproof.ai/ru/audits/agent-contracts.md): Расскажите аудитам, что должен делать каждый агент, что он должен производить и чего никогда не делать.
- [Запуск и проверка аудита](https://docs.befailproof.ai/ru/audits/run.md): Запустите аудит, проверьте его покрытие и изучите полученные результаты.
- [Частота аудитов](https://docs.befailproof.ai/ru/audits/cadence.md): Выберите, когда выполняются периодические аудиты и сколько данных они проверяют.
- [Findings and issues](https://docs.befailproof.ai/ru/audits/findings-and-issues.md): Превратите доказательства аудита в собственную, отслеживаемую работу по устранению.
- [Оповещения](https://docs.befailproof.ai/ru/audits/alerts.md): Обнаруживайте повторяющиеся проблемы и направляйте инцидент нужным лицам.
- [Рецепты аудитов](https://docs.befailproof.ai/ru/audits/recipes.md): Начальные цели для типичных расследований сбоев агентов.

### Prevent failures

#### Prevent repeat failures

- [Политики](https://docs.befailproof.ai/ru/policies/overview.md): Отслеживайте, направляйте или блокируйте действия агента перед тем, как известный сбой повторится.

#### Get a policy

- [Написание политики](https://docs.befailproof.ai/ru/policies/editor.md): Позвольте Failproof AI создать проект политики на основе результатов аудита, или напишите исходный код сами, затем проверьте, протестируйте и опубликуйте его.
- [Использование пакета политик](https://docs.befailproof.ai/ru/policies/packs.md): Подключите пакет политик Failproof AI для вашего сценария использования или пакет сообщества из хаба политик и выберите, что он будет проверять.

#### Ship a policy

- [Протестировать политику](https://docs.befailproof.ai/ru/policies/test.md): Проверьте черновик на основе уже полученного трафика, убедитесь, что он блокирует то, что нужно, и пропускает то, что должно пройти, прежде чем машина будет его применять.
- [Развернуть политику](https://docs.befailproof.ai/ru/policies/deploy.md): Разместите протестированную версию политики на машинах в режиме наблюдения, включите её применение и убедитесь, что каждая машина получила обновление.
- [Версии и откат](https://docs.befailproof.ai/ru/policies/rollback.md): Каждая опубликованная версия неизменяема, поэтому откат неудачного развертывания выполняется путем переразвертывания последней рабочей версии.
- [Опубликовать пакет политик](https://docs.befailproof.ai/ru/policies/publish-a-pack.md): Выпустите свои политики как GitHub release, которые может установить кто угодно.
- [Поведение при отказах](https://docs.befailproof.ai/ru/policies/failure-behavior.md): Узнайте, что происходит, когда вычисление политики или локальный демон недоступны.

### Admin

#### Operate Failproof AI

- [Администрирование](https://docs.befailproof.ai/ru/admin/overview.md): Управляйте доступом, использованием, организациями и безопасностью отдельно от рабочего процесса надежности.
- [Использование](https://docs.befailproof.ai/ru/admin/usage.md): Просмотрите потребление организации и активное расчетное окно.
- [Ключи и разрешения](https://docs.befailproof.ai/ru/admin/keys-and-permissions.md): Создавайте API-ключи с ограниченной областью действия для машин, автоматизации и операторов.
- [Пользователи и организации](https://docs.befailproof.ai/ru/admin/users-and-organizations.md): Управляйте членством и держите данные и действия каждой организации в надлежащих границах.
- [Настройки и безопасность](https://docs.befailproof.ai/ru/admin/settings-and-security.md): Настройте операционные параметры и сделайте осознанный выбор относительно данных агентов.

### Integrations and reference

#### Connect your agents

- [Интеграции и справочник](https://docs.befailproof.ai/ru/reference/overview.md): Подключайте поддерживаемые оболочки агентов, SDK, CLI и HTTP API.
- [Адаптеры агентов](https://docs.befailproof.ai/ru/reference/harnesses.md): Захватывайте сеансы и применяйте политики для всех 12 поддерживаемых адаптеров агентов.
- [Пользовательские агенты](https://docs.befailproof.ai/ru/reference/custom-agents.md): Конфигурация, каталог событий, правила корреляции и доставка для failproofai-sdk.
- [Evaluator SDK](https://docs.befailproof.ai/ru/reference/evaluator-sdk.md): Запускайте собственного оценивающего worker для LLM судей и всего остального, что размещённый Python не может сделать.
- [Пользовательские политики](https://docs.befailproof.ai/ru/reference/policy-sdk.md): Разработайте, протестируйте и развертывайте политики на JavaScript или TypeScript для сбоев, специфичных для ваших агентов.
- [Самостоятельный хостинг Failproof AI Cloud](https://docs.befailproof.ai/ru/reference/self-hosting.md): Разверните плоскость управления Failproof AI в кластере Kubernetes, управляемом клиентом.

#### Reference

- [Failproof AI CLI](https://docs.befailproof.ai/ru/reference/failproof-cli.md): Установка хуков, управление локальными политиками, подключение облака и работа с локальным демоном.
- [Локальная панель управления](https://docs.befailproof.ai/ru/reference/local-dashboard.md): Просмотрите локальные проекты, сессии, активность политик, конфигурацию, аудиты и запланированные сканирования.
- [Локальная конфигурация](https://docs.befailproof.ai/ru/policies/local-configuration.md): Управляйте областью действия политик, параметрами, пользовательскими файлами и машинными настройками Failproof AI.
- [Failproof Cloud CLI](https://docs.befailproof.ai/ru/reference/cloud-cli.md): Полный справочник по запросам и администрированию Failproof AI Cloud с помощью fp.
- [HTTP API](https://docs.befailproof.ai/ru/reference/http-api.md): Аутентифицируйтесь в публичном API Failproof AI Cloud `/v1` и используйте сгенерированную справку по endpoint'ам.
- [События и конфигурация](https://docs.befailproof.ai/ru/reference/events-and-configuration.md): Справка по модели событий, окружениям, локальному хранилищу и границам конфигурации.
- [Устранение неполадок](https://docs.befailproof.ai/ru/reference/troubleshooting.md): Диагностика отсутствующих сеансов, отсутствующих политик, сбоев доставки и заблокированных действий агента.
