# AgentInspect: локальная отладка и проверка траекторий для TypeScript-агентов

- Site: VeraPoint News
- Section: Инструменты
- Date: 2026-09-06
- Canonical: https://verapointmedia.com/tools/rajudandigam-agent-inspect/
- Markdown: https://verapointmedia.com/tools/rajudandigam-agent-inspect.md
- Summary: AgentInspect — это инструмент для локальной отладки и тестирования траекторий работы TypeScript AI-агентов, который позволяет просматривать цепочки выполнения, выявлять ошибки в CI и создавать безопасные автономные отчеты. Если вы столкнулись с тем, что агент ведет себя непредсказуемо, а стандартные логи не дают понима
- Target queries: AI tools; AI agents; rajudandigam-agent-inspect
- Tags: #ai #technology
- Image: https://verapointmedia.com/static/content-assets/tools/rajudandigam-agent-inspect/cover.webp

## Sources

- https://github.com/rajudandigam/agent-inspect

---

## Где взять

[rajudandigam/agent-inspect — открыть на GitHub](https://github.com/rajudandigam/agent-inspect)

Открытая лицензия: MIT · 505 stars.

AgentInspect — это инструмент для локальной отладки и тестирования траекторий работы TypeScript AI-агентов, который позволяет просматривать цепочки выполнения, выявлять ошибки в CI и создавать безопасные автономные отчеты. Если вы столкнулись с тем, что агент ведет себя непредсказуемо, а стандартные логи не дают понимания, где именно произошел сбой, этот инструмент поможет восстановить последовательность действий без передачи данных на сторонние серверы.

### Что можно собрать

Инструмент решает проблему «фрагментарности» логов. Агентская работа редко ограничивается одним вызовом функции: она включает планирование, поиск данных, вызовы инструментов и работу с моделями. AgentInspect сохраняет весь процесс как локальный файл в формате JSONL (строчный JSON), превращая его в читаемое дерево выполнения. Вы можете использовать его для трех задач:

*   **Отладка:** просмотр вложенных шагов, вызовов LLM, метаданных токенов и причин сбоев.
*   **Предотвращение ошибок:** настройка детерминированных проверок в CI (непрерывной интеграции), которые завершаются с ошибкой, если агент выбрал неверный путь.
*   **Обмен данными:** создание проверенных офлайн-артефактов, которыми можно поделиться для анализа инцидентов или передачи задач, не раскрывая лишних данных.

### Как начать

Для начала работы достаточно установить пакет через npm:

```bash
npm install agent-inspect
```

После установки команда `npx agent-inspect init --yes` создаст демонстрационные примеры в вашем проекте. Вы можете запустить демо-агента, а затем просмотреть результат с помощью команд `view`, `check` или `report`, указывая директорию с логами (по умолчанию `.agent-inspect`). Инструмент поддерживает интеграцию с популярными стеками, такими как LangChain, LangGraph и AI SDK, через дополнительные пакеты.

### Кому это подходит

AgentInspect предназначен для разработчиков, работающих с TypeScript-агентами, которым важна приватность и локальный контроль над данными. Он не заменяет полноценные системы мониторинга (APM) или платформы для оценки промптов, но отлично дополняет их на этапе разработки и тестирования «на ноутбуке» или в CI-контуре. Инструмент работает локально, не требует создания учетных записей и по умолчанию использует только метаданные, что делает его удобным для команд, работающих с чувствительной информацией.

### Границы применимости

Важно понимать, что AgentInspect — это не система для записи «цепочки мыслей» (chain-of-thought) в реальном времени и не замена облачным дашбордам для мониторинга продакшн-флотов. Функции «безопасного обмена» (verify-safe) являются попыткой локальной оценки и не гарантируют полноценную сертификацию безопасности или соответствие комплаенсу. Перед передачей артефактов коллегам рекомендуется всегда проверять их содержимое вручную.

### Вердикт

Стоит попробовать, если вам нужно быстро отладить локальный запуск агента или автоматизировать проверку его логики в CI без отправки данных в облако.

Лучше выбрать другой путь, если вам требуется полноценная система мониторинга для отслеживания работы сотен агентов в продакшене или готовая платформа для управления наборами данных и оценки качества ответов LLM.

## Похожие материалы

- [Как отличить рабочий AI-инструмент от красивой демки](https://verapointmedia.com/guides/kak-otlichit-rabochiy-ai-instrument-ot-krasivoy-demki/)
- [Что такое AI-агент простыми словами](https://verapointmedia.com/guides/chto-takoe-ai-agent-prostymi-slovami/)