aimock CLI
aimock, CLI тестовых API, проверяет локальные файлы с подготовленными ответами до запуска сервера и обращения к приложению.
- 1 005 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Режим записи может отправлять запросы настоящим API и тратить средства
- Фикстуры и журналы могут сохранять личные данные и содержимое запросов
- Неверный базовый адрес SDK может направить тестовый запрос в настоящий API
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/aimockОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Режим записи может отправлять запросы настоящим API и тратить средства
- Фикстуры и журналы могут сохранять личные данные и содержимое запросов
- Неверный базовый адрес SDK может направить тестовый запрос в настоящий API
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
aimock, CLI тестовых API, имитирует ответы сервисов для тестирования ИИ-приложения. Локальный сервер отдает клиенту подготовленные данные через совместимый API. Вы задаете потоковый ответ, вызов инструмента или последовательность ходов разговора. Фикстуры — файлы, в которых вы описываете запросы и нужные ответы. Набор поддерживает API моделей и MCP. Через тот же порт можно имитировать поиск и векторное хранилище. Для существующей интеграции можно записать настоящее обращение и затем воспроизводить ответ. Чтобы проверить сбой, задайте ошибку, задержку или разрыв потока. Журнал показывает запросы клиента и ответы тестового сервера.
Для кого. QA-инженерам ИИ-приложений, которые проверяют обработку ответов моделей и внешних инструментов на заданных тестовых данных.
Подходит, если
- Тест получает одинаковую последовательность ответов модели при каждом запуске.
- Разработчик проверяет повтор запроса после ошибки частоты или обрыва потока.
- Агентный процесс обращается к MCP-инструментам с подготовленными тестовыми ответами.
- Записанное настоящее обращение воспроизводят без нового запроса поставщику.
Не подходит, если
- Нужно измерить качество ответов настоящей модели на новых задачах
- Нужно измерить реальные задержки и скорость ответа поставщика модели
- Записываемые запросы содержат рабочие секреты, которые нельзя сохранять в тестовых данных
Пример запроса к агенту
Подготовь фикстуру для успешного ответа и ошибки 429, затем проверь, как мой клиент повторяет запрос и показывает сообщение пользователю.Ограничения
Локальный базовый адрес нужно задать до создания SDK-клиента: уже созданный клиент может продолжить отправку запросов настоящему API. Режим записи обращается к внешним сервисам и расходует их бюджет, хотя обычный режим читает готовые фикстуры. Записи сохраняют запросы и ответы; очистка известных секретов не заменяет проверку файлов перед коммитом. Поддерживаемые форматы и настроенная скорость повтора не воспроизводят все свойства сервиса или точное время появления каждого токена.
Как отключить. Остановите локальный сервер и верните приложению нужный базовый адрес API. Удалите пакет через `npm uninstall @copilotkit/aimock`. Сохраненные фикстуры и журналы проверьте отдельно: удаление зависимости их не очищает.
Частые вопросы
Как установить aimock?
Выполните `npm install @copilotkit/aimock` в проекте. Консольный запуск полного набора использует `npx @copilotkit/aimock --config aimock.json`; сначала создайте этот файл конфигурации.
Что такое фикстура?
Файл с условиями запроса и подготовленным ответом. Он может описывать несколько ходов разговора, ответы инструментов и ожидаемые ошибки.
Можно ли проверить фикстуры без сервера?
Да. Команда `npx @copilotkit/aimock validate ./fixtures/` проверяет локальные файлы выбранного каталога. Она не запускает сервер и не проверяет сетевые источники фикстур. Замените путь каталогом своих тестовых данных.
Чем отличаются команды `llmock` и `aimock`?
Команда `llmock` оставлена для совместимости и поддерживает более узкий набор флагов. Для конфигурации всего набора, преобразования и проверки фикстур используется `aimock`.
Есть ли подсказки для агента?
Да. Скилл `write-fixtures` помогает писать тестовые данные под поддерживаемые протоколы. Он находится рядом с CLI и использует те же форматы.
Какая лицензия у aimock?
MIT.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыPrism — CLI для тестов по OpenAPI: клиент получает ответы из описания API, пока команда еще пишет серверную часть.
CLI для тестирования и ред-тиминга LLM-приложений: сравнение моделей, автоматические проверки в CI и поиск уязвимостей
MCP-сервер: агент шлет GET, POST, PUT, DELETE и PATCH на ваш REST API и получает код, заголовки и тело ответа
MCP-сервер, агент и скиллы для сквозных UI-тестов: агент управляет компьютером через компьютерное зрение на облачных машинах
CLI генерирует API-тесты по схеме и дает агенту воспроизводимые ошибки ответов и последовательностей операций.
MCP Interviewer проверяет MCP-сервер до подключения агента: лимиты провайдеров, тесты инструментов и отчет в Markdown.
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| aimock (эта карточка) | да | 1 005 | |
| Мок-сервер API Т-Банка для разработки | нет | 0 | имитирует банковский API для тестов; aimock готовит подмены моделей, MCP и агентских протоколов |
| Dev Proxy skill | нет | 842 | Скилл помогает агенту настроить Dev Proxy для проверки ошибок API, ограничений запросов и задержек в тестируемом приложении. |
Коротко о README
В тесте Node.js класс `LLMock` из `@copilotkit/aimock` задает ответы и запускает сервер из кода. Отдельная команда в терминале для такого теста не нужна.