Об этом проекте

Peaky Peek (agent_debugger) — это локальная консоль аудита и доверия с открытым исходным кодом, предназначенная специально для отладки ИИ-агентов. В отличие от традиционных инструментов наблюдаемости, таких как LangSmith, OpenTelemetry или Sentry, Peaky Peek сосредоточен на ответе на вопрос, который действительно важен для операторов: можно ли доверять тому, что сделал этот агент? Инструмент фиксирует полную причинно-следственную цепочку каждого действия агента и представляет каждый запуск как запись аудита, отвечающую на пять ключевых вопросов: что произошло, почему, с какими доказательствами, с каким результатом и где произошёл сбой. Каждое утверждение классифицируется детерминированно как проверенное, частично проверенное, опровергнутое, неподтверждённое, непроверенное или устаревшее, а каждая сессия получает объяснимую оценку доверия и карточку вердикта с именованным статусом (действовать, сначала проверить или не действовать). Ключевые возможности включают: - Консоль аудита и доверия агента с детерминированными карточками вердиктов, объяснимыми оценками доверия, описаниями сбоев, значками проверки и сигналами риска - Визуализацию дерева решений для навигации по рассуждениям агента в виде интерактивного дерева - Воспроизведение контрольных точек для перемещения по выполнению агента с воспроизведением с учётом контрольных точек - Поиск трасс для поиска конкретных событий во всех сессиях - Кластеризацию сбоев и координацию нескольких агентов для адаптивного анализа похожих сбоев - Сравнение сессий для параллельного сравнения двух запусков агента Интеграция доступна тремя способами: простой декоратор (@trace), менеджер контекста (trace_session) и автопатчинг с нулевой конфигурацией, который работает с PydanticAI, LangChain, OpenAI SDK, CrewAI, AutoGen, LlamaIndex и Anthropic без изменения кода. Архитектура состоит из уровня SDK для инструментирования, уровня интеллекта для обнаружения и воспроизведения, сервера FastAPI с хранилищем SQLite и интерфейса React/TypeScript с девятью специализированными панелями. Проект лицензирован по MIT, требует Python 3.10+ и доступен через pip как peaky-peek-server. Функции конфиденциальности включают локальную работу без внешней телеметрии, опциональный конвейер редактирования, аутентификацию по API-ключам с хешированием bcrypt и хранилище SQLite без зависимости от облака.