⚠️ This is an auto-generated translation. For the latest version, see the English README. Community corrections welcome!
🇺🇸 English | 🇨🇳 简体中文 | 🇯🇵 日本語 | 🇰🇷 한국어 | 🇪🇸 Español | 🇧🇷 Português | 🇩🇪 Deutsch | 🇫🇷 Français | 🇷🇺 Русский | 🇮🇳 हिन्दी | 🇹🇷 Türkçe | 🇻🇳 Tiếng Việt | 🇮🇹 Italiano | 🇸🇦 العربية | 🇮🇱 עברית
Переводы: 简体中文 · 日本語 · 한국어 · Español · Português · Deutsch · Français · Русский · हिन्दी · Türkçe · Tiếng Việt · Italiano · العربية · עברית
Наблюдаемость и управление для каждой системы, в которой работают ваши агенты. Где бы ни работал ваш агент — мы это видим и можем это запретить. Failproof AI интегрируется с 12 платформами для работы с агентами — средствами разработки кода, такими как Claude Code и Codex, шлюзами чата, такими как Hermes, и самостоятельно развёрнутыми помощниками, такими как OpenClaw — перехватывая каждый запуск и блокируя опасные вызовы инструментов перед их выполнением. 40 встроенных политик. Нулевая задержка. Работает локально.
Двенадцать платформ в двух классах — десять средств разработки кода и два шлюза чата и помощников (Hermes, OpenClaw). Одинаковые события, одинаковые политики, одинаковая история сессий, в какой бы платформе ни работал ваш агент.
Агенты, которые работают ни в одной из них, отправляют данные через Python SDK, что даёт вам трассировку, сессии и аудит. Управление там требует хука в вашей собственной среде выполнения — напишите нам и мы это реализуем.
{/* A 6-column table instead of inline runs: table columns never re-wrap,
so the grid stays 2×6 at any window width (scrolling on very narrow screens
instead of collapsing into ragged orphan rows). */}
|
|
|
|
|
|
|
|
|
|
|
|
npm install -g failproofai
failproofai policies --install # или просто запустите `failproofai` и подтвердите первичный запрос
failproofai40 встроенных политик активируются немедленно. Панель управления доступна на localhost:8020. Отключите первичный запрос с помощью FAILPROOFAI_NO_FIRST_RUN=1.
| Политика | Что она блокирует |
|---|---|
sanitize-api-keys |
Утечка API-ключей в контекст агента |
block-env-files |
Чтение файлов .env и других секретных файлов |
warn-repeated-tool-calls |
Агент, застревающий на одном и том же вызове |
block-sudo |
Повышение привилегий |
warn-destructive-sql |
DROP, TRUNCATE, неограниченные операции DELETE |
block-terraform / block-kubectl |
Непроверенные изменения инфраструктуры |
block-rm-rf |
Рекурсивное удаление файлов |
block-force-push / block-push-master |
git push --force, прямые пушы в main |
Первые пять применяются к любому агенту, который может вызывать инструменты. Последние три — фавориты разработчиков — средства разработки кода являются классом платформ, который мы покрываем наиболее глубоко.
Разместите файл в .failproofai/policies/ — он загружается автоматически без каких-либо флагов.
Добавьте его в репозиторий и вся команда получит его при следующем пуле.
import { customPolicies, deny, allow } from "failproofai";
customPolicies.add({
name: "no-production-writes",
match: { events: ["PreToolUse"] },
fn: async (ctx) => {
if (ctx.toolInput?.file_path?.includes("production"))
return deny("Writes to production paths are blocked.");
return allow();
},
});Три решения доступны для каждой политики:
| Решение | Эффект |
|---|---|
allow() |
Разрешить операцию |
deny(message) |
Заблокировать её — сообщение вернётся агенту |
instruct(message) |
Разрешить, но добавить контекст в следующий запрос агента |
→ Руководство по пользовательским политикам
Управление — это одна половина. Другая половина — видеть то, что на самом деле сделал агент.
Запустите failproofai без аргументов, и он будет обслуживать панель управления на localhost:8020,
читая историю запусков, уже находящуюся на вашей машине — без учётной записи, без регистрации, ничего не покидает вашу систему. Вы получите список сессий, последовательность вызовов модели, вызовы инструментов и решения хуков внутри каждого запуска, что было заблокировано и что политика сказала агенту, а также автономный аудит (failproofai audit), который сканирует вашу историю на предмет рискованных паттернов и предлагает политики для их остановки.
→ Локальная панель управления · Чтение трассировки · Локальный аудит
Failproof AI Observability — это хостированная часть одной и той же модели данных для команд, запускающих агентов на множестве систем: каждый запуск от каждой платформы в одном месте, граф выполнения с параллельными подагентами на отдельных дорожках, задержка p50/p95/p99 для моделей, инструментов и хуков, стоимость и отслеживание окна контекста для каждой модели, отслеживание ошибок, SQL над вашими собственными трассировками с общедоступными панелями управления, оценки, отмеченные вашим собственным сервисом, запланированные аудиты, которые превращают повторяющиеся сбои в доказательства, и оповещения, направленные в Slack, по электронной почте или на подписанный вебхук. Самостоятельное хостирование в вашем собственном кластере доступно в плане Enterprise.
→ Сессии · Аудиты · Запросить демонстрацию
| Начало | |
|---|---|
| Быстрый старт | Установка, подключение платформы, первый запуск |
| Концепции | Как работает система хуков |
| Поддерживаемые платформы | Все 12 и то, что каждая может управлять |
| Наблюдение | |
|---|---|
| Сессии | Следите за запуском: модели, инструменты, ошибки, задержка |
| Чтение трассировки | Что вам говорит граф выполнения |
| Аудиты | Найдите паттерны сбоев в множестве сессий |
| Локальная панель управления | localhost:8020, без необходимости учётной записи |
| Управление | |
|---|---|
| Встроенные политики | Все 40 политик с параметрами |
| Пользовательские политики | Напишите свои собственные |
| Конфигурация | Области конфигурации и правила объединения |
| Инструментируйте свой собственный агент | |
|---|---|
| Python SDK | Отправляйте запуски от агента без платформы |
| Policy SDK | Справочник allow / deny / instruct |
MIT с Commons Clause — бесплатно для внутреннего и личного использования; коммерческая перепродажа самого failproofai требует отдельного соглашения. Полный текст см. в LICENSE.
См. CONTRIBUTING.md. Новые политики, граничные случаи и переводы приветствуются.
Соберите проект перед началом. Сначала запустите
bun install && bun run build. Этот репозиторий запускает собственные хуки failproofai на себе, и они разрешают импортfailproofaiв скомпилированный пакетdist/— без сборки вы получите ошибки хукаCannot find package 'failproofai'. Пересоберите после измененияsrc/. Смотрите Build before the in-repo dev hooks will work.
Создано с ❤️ компанией befailproof.ai в Сан-Франциско и Бангалоре.