ИИ-функции

Mockarty интегрирует искусственный интеллект по всей платформе, чтобы помочь вам генерировать моки, писать тестовые скрипты, диагностировать ошибки, анализировать производительность и многое другое. Каждая ИИ-функция следует единому паттерну: кнопка действия, шестерёнка настроек для кастомизации и результаты, отображаемые в формате Markdown.

URL-адреса в примерах: Во всех примерах используется localhost:5770 как адрес Mockarty по умолчанию. Если ваш экземпляр работает на удалённом сервере, замените localhost:5770 на реальный адрес (например, https://mockarty.company.com или http://192.168.1.50:5770). Подробнее — в разделе Полезные функции и советы.

Что такое ИИ-агент? Зачем он нужен для тестирования?

ИИ-агент – это программный ассистент на основе большой языковой модели (LLM), который понимает инструкции на естественном языке и выполняет действия от вашего имени. Вместо того чтобы кликать по меню и заполнять формы, вы описываете, что вам нужно, обычным текстом, а агент разбирается, как это сделать.

В контексте тестирования и моков API, ИИ-агент может:

• Генерировать моки по описанию – «Создай мок для GET /api/users, возвращающий 10 пользователей с реалистичными именами и email» превращается в полностью настроенный мок за секунды.
• Диагностировать ошибки – вставьте ответ с ошибкой, и агент объяснит причину и предложит исправление.
• Писать тестовые скрипты – агент анализирует ваш запрос/ответ и автоматически пишет ассерты.
• Запускать сканирование безопасности – попросите агента профаззить эндпоинт, и он настроит и запустит тест безопасности.
• Запрашивать базы данных, вызывать API, отправлять уведомления – агент имеет доступ к более чем 90 встроенным инструментам, позволяющим взаимодействовать с реальными системами от вашего имени.

Вам не нужны знания ИИ или машинного обучения. Если вы можете описать, что вам нужно, в сообщении чата, агент поможет.

Быстрый старт: ваш первый мок с помощью ИИ

Выполните эти шаги, чтобы создать первый мок с помощью ИИ. Общее время: менее 2 минут.

Предварительные требования: Администратор должен настроить хотя бы один LLM-профиль (см. Начало работы).

1. Откройте конструктор моков – перейдите в раздел Mocks в боковом меню, затем нажмите Create Mock.
2. Нажмите кнопку «Generate Mock» – она расположена в панели инструментов над редактором мока.
3. Опишите, что вам нужно – например:

   Создай REST-мок для GET /api/products, возвращающий JSON-массив из 5 товаров. У каждого товара должны быть: id (число), name (реалистичное название товара), price (десятичное число от 10 до 500) и inStock (boolean).

4. Проверьте сгенерированный мок – ИИ заполняет маршрут, HTTP-метод, тело ответа с Faker-функциями и код 200.
5. Нажмите Save – ваш мок работает. Отправьте запрос на http://localhost:5770/stubs/sandbox/api/products, чтобы увидеть его в действии.

Вот и всё. Для доработки нажмите Improve Mock, чтобы добавить обработку ошибок, граничные случаи или дополнительные условия.

Содержание

• Что такое ИИ-агент?
• Быстрый старт: ваш первый мок с помощью ИИ
• Начало работы
• LLM-профили
• Выбор модели
• Справочник ИИ-кнопок
• Настройки ИИ (кнопка-шестерёнка)
• MCP Marketplace
  • Что такое MCP Marketplace?
  • Типы источников
  • Как инструменты создаются из API
  • Пользовательские заголовки и переопределение учётных данных
  • Жизненный цикл инструментов
• Система ИИ-агентов
  • Обзор
  • Виджет чата с агентом
  • Архитектура суб-агентов
  • Как работает маршрутизация агентов
  • Справочник встроенных инструментов
  • Параллельное выполнение инструментов
  • Хранилище учётных данных
  • Сессии и контекст
  • Задачи агента (фоновые операции)
  • Использование инструментов маркетплейса в чате агента
• Пользовательские агенты
  • Что такое пользовательские агенты?
  • Создание пользовательского агента
  • Привязка LLM-профиля
  • Ключевые слова маршрутизации
  • Белые списки инструментов
  • Привязка к Feature Key
  • Примеры пользовательских агентов
• Интеграция с маркетплейсом
• Протокол A2A (Agent-to-Agent)
• Руководство администратора
  • Настройка ИИ-функций
  • Настройка MCP Marketplace
  • Мониторинг через журнал аудита ИИ
  • Ограничения запросов и безопасность
• Уведомления
• Советы для лучших результатов
• Устранение неполадок

Начало работы

Для работы ИИ-функций требуется хотя бы один включённый LLM-профиль. Перейдите в Admin → AI & LLM → LLM Profiles, чтобы создать его. Mockarty поддерживает следующих LLM-провайдеров:

После настройки профиля ИИ-кнопки появляются по всей платформе.

LLM-профили

Каждый профиль определяет:

• Провайдер — какой LLM-сервис использовать
• Модель — модель по умолчанию (например, gpt-4o, claude-sonnet-4-20250514, qwen3:8b)
• API-ключ — учётные данные (не требуется для Ollama)
• Базовый URL — переопределение для self-hosted или пользовательских эндпоинтов
• Доступные модели — модели, которые пользователи могут выбирать в этом профиле
• Включён — переключатель активности профиля

Если включён только один профиль, он используется автоматически. Когда существует несколько профилей, пользователи выбирают нужный для каждой ИИ-функции.

Выбор подходящего профиля:

• Для быстрых операций (генерация скриптов, диагностика ошибок): используйте быструю модель, например gpt-4o-mini или claude-haiku
• Для сложного анализа (анализ производительности, аудит безопасности, генерация отчётов): используйте мощную модель, например gpt-4o или claude-sonnet
• Для экономии бюджета: используйте Ollama с локальной моделью
• Для экспериментов: OpenRouter предоставляет доступ ко многим моделям через один API-ключ

Выбор модели

Вы можете выбрать LLM-модель на двух уровнях:

Для каждой ИИ-функции

Каждая ИИ-кнопка (Generate Mock, Diagnose Error и др.) имеет иконку шестерёнки, позволяющую выбрать:

1. LLM-профиль — какого провайдера и какие учётные данные использовать
2. Модель — конкретную модель внутри профиля

Разные функции могут использовать разные модели. Например, быструю модель для генерации скриптов и мощную модель для анализа безопасности.

В чате агента

Виджет чата агента имеет селектор модели в заголовке. Вы можете переключать модели посреди разговора — новая модель применяется к последующим сообщениям, при этом контекст беседы сохраняется.

Привязка модели к пользовательскому агенту

Администраторы могут привязать конкретный LLM-профиль и переопределение модели к пользовательскому агенту. Когда сообщение маршрутизируется к такому агенту, его привязанная модель используется автоматически, независимо от выбора пользователя. См. Привязка LLM-профиля.

Справочник ИИ-кнопок

Конструктор моков

API Tester

Fuzzing

Рекордер

Производительность

Настройки ИИ (кнопка-шестерёнка)

Каждая ИИ-кнопка имеет иконку шестерёнки, которая открывает панель настроек с тремя элементами управления:

1. ИИ-профиль

Выберите, какой LLM-профиль использовать для конкретной операции. Разные профили могут иметь разные модели (быстрые vs. умные) или разные ценовые уровни.

Пример: Используйте быструю модель для генерации скриптов, но мощную модель для анализа безопасности.

2. Пользовательский промпт

Добавьте дополнительные инструкции для ИИ. Они добавляются к системному промпту и позволяют настроить поведение ИИ без изменения кода.

Практические примеры:

Пользовательский промпт сохраняется для каждой функции — ваш промпт для “Generate Script” не повлияет на “Diagnose Error”.

3. MCP-инструменты

Если ваш администратор настроил инструменты MCP Marketplace, вы можете выбрать, какие внешние инструменты ИИ может использовать во время операции. Когда инструменты выбраны:

1. Они отправляются в LLM вместе с вашим запросом
2. LLM может вызывать инструменты во время генерации (например, запрос к реальному API, получение актуальных данных)
3. Результаты инструментов передаются обратно в LLM для более точного ответа
4. Финальный ответ включает данные в реальном времени из инструментов

Пример: У вас есть OpenAPI-инструмент, указывающий на staging-сервер. При генерации мока ИИ может вызвать реальный API, чтобы понять структуру ответа, а затем создать мок, точно повторяющий реальное поведение.

Каждая функция хранит свои выборы инструментов независимо — инструменты, включённые для “Generate Mock”, не влияют на “Diagnose Error”.

MCP Marketplace

Что такое MCP Marketplace?

MCP Marketplace — это система интеграции инструментов, которая позволяет вашему администратору подключать внешние API, сервисы и ИИ-агентов к функциям искусственного интеллекта Mockarty. После подключения их возможности становятся инструментами, которые ИИ может вызывать во время любой операции.

Основная идея: Вместо того чтобы ИИ опирался только на собственные знания, он получает возможность вызывать реальные API, запрашивать базы данных, взаимодействовать с внешними сервисами и сотрудничать с другими ИИ-агентами — всё в рамках одной операции.

Пример рабочего процесса:

1. Администратор регистрирует OpenAPI-спецификацию вашего staging API в маркетплейсе
2. Каждый эндпоинт в спецификации становится доступным инструментом (например, GET /api/users → инструмент getUsers)
3. Когда вы просите ИИ «сгенерировать мок для API пользователей», он может вызвать реальный эндпоинт getUsers
4. ИИ видит реальную структуру ответа, типы полей и реалистичные данные
5. Он генерирует мок, точно отражающий ваш реальный API

Типы источников

Маркетплейс поддерживает шесть типов интеграции, каждый из которых преобразует свой протокол в инструменты, доступные для вызова ИИ:

Как инструменты создаются из API

OpenAPI (REST API)

Когда вы регистрируете URL OpenAPI/Swagger-спецификации, Mockarty:

1. Загружает и парсит спецификацию (JSON или YAML)
2. Преобразует каждый эндпоинт в инструмент:
   • Имя инструмента = operation ID или метод + путь (например, getUserById)
   • Описание = summary эндпоинта из спецификации
   • Входные параметры = path-параметры, query-параметры, заголовки, тело запроса — всё с типами из спецификации
   • Тег = первый OpenAPI-тег (для группировки)
3. Когда ИИ вызывает инструмент, Mockarty формирует реальный HTTP-запрос и выполняет его

Пример: Спецификация OpenAPI с GET /api/users/{id} становится инструментом getUserById с параметром id. ИИ вызывает его с {"id": "123"}, и Mockarty выполняет реальный HTTP-запрос, возвращая ответ ИИ.

WSDL (SOAP-сервисы)

Когда вы регистрируете URL WSDL, Mockarty:

1. Парсит документ WSDL
2. Извлекает все операции из типов портов
3. Создаёт инструменты с префиксом soap_ (например, soap_GetCustomerInfo)
4. Автоматически формирует SOAP XML-конверт при вызове инструмента ИИ

Это позволяет ИИ взаимодействовать с устаревшими SOAP-сервисами без знания XML или протокола SOAP — он просто передаёт JSON-параметры.

MCP-сервер

Серверы MCP (Model Context Protocol) — это специализированные провайдеры инструментов:

1. Mockarty подключается к серверу через JSON-RPC
2. Вызывает tools/list для обнаружения доступных инструментов
3. Каждый инструмент имеет имя, описание и JSON Schema входных данных
4. Вызовы инструментов проходят через tools/call по JSON-RPC

Stateful-сессии: MCP-серверы могут сохранять состояние между вызовами инструментов в рамках одного разговора. Например, MCP-сервер Playwright может открыть браузер в одном вызове и переходить по страницам в последующих — всё в рамках одной сессии чата.

A2A-агент

Интеграция Agent-to-Agent подключается к внешним ИИ-агентам:

1. Mockarty загружает карточку агента из /.well-known/agent.json
2. Навыки агента становятся доступными инструментами
3. Вызовы инструментов проксируются к внешнему агенту

Пользовательские заголовки и переопределение учётных данных

Многие внешние API требуют аутентификации. Mockarty обрабатывает это на двух уровнях:

Аутентификация на уровне сервера (устанавливается администратором):

Переопределение заголовков на уровне пользователя:

Каждый пользователь может переопределить заголовки аутентификации сервера для каждой функции. Это полезно, когда:

• Разным членам команды нужны разные учётные данные (например, dev vs. staging)
• Вы хотите тестировать на разных окружениях
• Инструменту нужны индивидуальные API-ключи для каждого пользователя

Как установить пользовательские заголовки:

1. Откройте шестерёнку настроек ИИ для любой функции
2. В секции MCP-инструментов раскройте область «Custom Headers» для нужного сервера
3. Добавьте или переопределите заголовки с помощью пар ключ-значение
4. Нажмите «Сохранить»

Ваши переопределения заголовков объединяются поверх заголовков сервера по умолчанию во время выполнения. Если вы установите Authorization: Bearer my-token, это заменит аутентификацию сервера по умолчанию только для ваших запросов.

Жизненный цикл инструментов

После регистрации сервера в маркетплейсе:

1. Обнаружение: Фоновый воркер обновляет списки инструментов периодически (по умолчанию: каждые 2 часа, настраивается для каждого сервера)
2. Проверка здоровья: Воркер также проверяет доступность сервера и обновляет статус (online, offline, error)
3. Кэширование: Обнаруженные инструменты сохраняются в базе данных для быстрой загрузки
4. Выбор: Пользователи выбирают, какие инструменты включить для каждой ИИ-функции через шестерёнку настроек
5. Выполнение: Когда ИИ вызывает инструмент, Mockarty маршрутизирует вызов через соответствующий адаптер
6. Результат: Результат инструмента возвращается ИИ для включения в финальный ответ

Администраторы могут запускать ручные проверки здоровья и обновления инструментов со страницы маркетплейса.

Система ИИ-агентов

Обзор

Система ИИ-агентов (ADK — Agent Development Kit) обеспечивает интеллектуальное многошаговое взаимодействие с ИИ. В отличие от одиночных ИИ-кнопок (которые выполняют одно действие и возвращают результат), система агентов может:

• Маршрутизировать ваш запрос к специализированному суб-агенту
• Выполнять несколько вызовов инструментов параллельно
• Поддерживать контекст разговора между сообщениями
• Запускать фоновые задачи асинхронно
• Использовать более 90 встроенных инструментов для CRUD моков, тестирования API, запросов к базам данных, отправки уведомлений и многого другого

Виджет чата с агентом

Плавающий виджет чата в правом нижнем углу соединяет вас с системой агентов.

Как это работает:

1. Напишите сообщение, описывающее, что вам нужно
2. Система маршрутизирует ваше сообщение к наиболее подходящему суб-агенту
3. Агент анализирует запрос и может вызвать инструменты (вы увидите вызовы инструментов в чате)
4. Если вызовы инструментов требуют одобрения, вам будет предложено подтвердить или отклонить
5. Агент возвращает ответ с учётом результатов инструментов
6. Контекст разговора сохраняется — последующие сообщения строятся на предыдущем контексте

Ключевые возможности:

• Потоковые ответы — вы видите процесс «размышления» ИИ в реальном времени
• Прозрачность вызовов инструментов — видите, какие инструменты вызываются и их результаты
• Одобрение инструментов — для инструментов, изменяющих данные, вы подтверждаете перед выполнением
• Сохранение сессий — закройте чат и вернитесь позже, контекст сохранён
• Множественные сессии — начинайте новые разговоры или продолжайте существующие

Архитектура суб-агентов

Система агентов использует мультиагентную архитектуру с 13 специализированными суб-агентами и оркестратором. Каждый суб-агент оптимизирован для конкретной предметной области и имеет доступ только к тем инструментам, которые относятся к его специализации.

Принцип работы

Когда вы отправляете сообщение, оркестратор маршрутизирует его к наиболее подходящему суб-агенту на основе ключевых слов. Каждый суб-агент имеет:

• Доменно-специфичный системный промпт, направляющий его поведение
• Отфильтрованный набор инструментов, содержащий только необходимые для работы инструменты
• Ключевые слова маршрутизации, определяющие, когда он активируется

Если ни один суб-агент не подходит, оркестратор обрабатывает запрос напрямую, имея доступ ко всем утилитным, базовым и уведомительным инструментам.

13 встроенных суб-агентов + оркестратор

Как работает маршрутизация агентов

Когда вы отправляете сообщение, система автоматически выбирает лучшего суб-агента на основе ключевых слов в сообщении:

Приоритет маршрутизации:

1. Пользовательские агенты (созданные администратором) проверяются первыми — их ключевые слова имеют приоритет
2. Встроенные суб-агенты проверяются в порядке, указанном выше
3. Если ни одно ключевое слово не совпало, запрос обрабатывает оркестратор напрямую

Справочник встроенных инструментов

Система агентов включает более 90 встроенных инструментов, организованных по категориям. Каждый суб-агент имеет доступ к подмножеству инструментов, относящихся к его области.

Инструменты управления моками (через MCP)

Инструменты управления хранилищами (через MCP)

Инструменты генерации кода (через MCP)

Инструменты шаблонов и файлов (через MCP)

Инструменты тестирования API

Инструменты фаззинга

Инструменты нагрузочного тестирования

Инструменты записи трафика

Инструменты контрактного тестирования

HTTP и клиентские инструменты API

Инструменты работы с базами данных

Веб- и контент-инструменты

Инструменты трансформации данных

Инструменты уведомлений

Инструменты управления сессиями

Параллельное выполнение инструментов

Система агентов выполняет несколько вызовов инструментов одновременно, когда LLM запрашивает несколько инструментов в одном ответном сообщении. Это значительно ускоряет сложные операции.

Как это работает:

1. LLM решает, что ему нужно вызвать несколько инструментов (например, list_mocks + list_collections + current_time)
2. Mockarty запускает все вызовы параллельно с помощью горутин
3. Результаты собираются конкурентно и возвращаются LLM вместе
4. LLM обрабатывает все результаты на следующем шаге

Пример: Когда вы спрашиваете «Покажи все моки и тестовые коллекции в неймспейсе payments», агент вызывает list_mocks и list_collections одновременно, а не последовательно, сокращая время ответа вдвое.

Встроенные инструменты (такие как form_update и проверки разрешений) обрабатываются синхронно до начала параллельного выполнения, гарантируя, что проверки безопасности никогда не пропускаются.

Хранилище учётных данных

Хранилище учётных данных (Credentials Store) позволяет передавать агенту API-ключи, строки подключения к базам данных, токены и другие секреты, не включая их в текст сообщений чата.

Ключевое свойство безопасности: Учётные данные хранятся только в localStorage вашего браузера. Они никогда не отправляются на сервер Mockarty для хранения — они включаются в запрос только тогда, когда агенту нужно использовать их для конкретного вызова инструмента.

Как использовать:

1. Нажмите иконку ключа в заголовке чата агента, чтобы открыть панель учётных данных
2. Добавьте записи в виде пар ключ-значение (например, POSTGRES_DSN → postgres://user:pass@host:5432/db)
3. Закройте панель — учётные данные сохраняются в браузере немедленно
4. В чате ссылайтесь на учётные данные по имени: «Сделай запрос к базе, используя мой POSTGRES_DSN»
5. Агент автоматически передаёт подходящие учётные данные инструментам, таким как sql_query, http_request, send_slack и др.

Распространённые имена учётных данных:

Примечание о конфиденциальности: Поскольку учётные данные хранятся в localStorage, они привязаны к конкретному браузеру и устройству. Очистка данных браузера удалит их. Другие пользователи не могут видеть ваши учётные данные.

Сессии и контекст

Сессии чата агента сохраняются в базе данных:

• Создание сессии: Новая сессия начинается при открытии чата или нажатии «Новый чат»
• История сообщений: До 100 предыдущих сообщений загружаются при повторном открытии сессии
• Контекстное окно: Активные разговоры обрезаются до 200 сообщений для предотвращения проблем с памятью
• Срок действия сессии: Сессии истекают после 24 часов неактивности (настраивается)
• Изоляция MCP-сессий: Каждая сессия чата получает свою MCP-сессию — stateful MCP-инструменты (например, Playwright) поддерживают состояние для каждого разговора

Задачи агента (фоновые операции)

Некоторые операции слишком длинны для ответа в чате. Задачи агента выполняются в фоновом режиме:

• Создаются через: Чат агента, ИИ-кнопки (для сложных операций) или протокол A2A
• Отслеживание прогресса: Пошаговый лог выполнения в реальном времени через SSE-стриминг
• Видимость вызовов инструментов: Видите, какие инструменты были вызваны и их результаты
• Отмена: Отменяйте выполняемые задачи в любой момент
• Редактирование и перезапуск: Отредактируйте любой шаг и перезапустите задачу с этой точки
• Экспорт: Скачайте полную историю выполнения в формате JSON
• Уведомления о завершении: Получайте уведомления через иконку колокольчика и (при настройке) email
• Ограничение параллелизма: Настраиваемое максимальное количество одновременных задач (по умолчанию: 3)

Задачи управляются через виджет чата агента. Нажмите вкладку Задачи (иконка буфера обмена) в плавающем чате, чтобы увидеть все ваши задачи. Бейдж появляется при завершении задач, пока вы работаете на других страницах.

Оверлей потока выполнения: Нажмите Просмотр потока на любой задаче, чтобы увидеть полную пошаговую трассу:

• Шаги группируются по связям родитель-потомок (вызовы инструментов связаны с их результатами)
• Параллельные вызовы визуально объединяются
• Каждый шаг показывает длительность, количество токенов, модель и имя агента
• Текст LLM (мысли, решения, ответы) рендерится как Markdown
• Ошибки показывают полное описание

Редактирование и перезапуск: Нажмите иконку карандаша на любом шаге для редактирования, затем нажмите Перезапуск с шага N для повторного выполнения с вашими изменениями.

Использование инструментов маркетплейса в чате агента

Когда инструменты маркетплейса настроены, они становятся доступны в чате агента:

1. Откройте шестерёнку настроек чата агента
2. Выберите, какие инструменты маркетплейса включить
3. Начните чат — агент теперь может использовать как встроенные, так и инструменты маркетплейса

Пример: С зарегистрированным staging API как источником OpenAPI, вы можете попросить:

«Вызови эндпоинт getUsers на staging, затем создай мок с такой же структурой ответа»

Агент:

1. Вызовет инструмент getUsers маркетплейса (реальный HTTP-запрос к staging)
2. Проанализирует структуру ответа
3. Использует встроенные инструменты для создания мока с соответствующими полями

Пользовательские агенты

Что такое пользовательские агенты?

Пользовательские агенты — это специалисты, создаваемые администратором, которые расширяют систему агентов. Хотя Mockarty поставляется с 13 встроенными суб-агентами и оркестратором, вашей организации могут потребоваться доменно-специфичные агенты с:

• Кастомными системными промптами, адаптированными к вашей области
• Конкретными белыми списками инструментов (только те инструменты, которые должен использовать этот агент)
• Ключевыми словами маршрутизации, соответствующими лексикону вашей команды
• Привязанными LLM-профилями и переопределениями модели
• Привязкой к Feature Key для настройки поведения ИИ-кнопок

Создание пользовательского агента

Администраторы создают пользовательских агентов в Admin → AI & LLM → Agent Settings.

Каждый пользовательский агент требует:

Привязка LLM-профиля

Пользовательские агенты могут быть привязаны к конкретному LLM-профилю и модели. Когда сообщение маршрутизируется к такому агенту:

1. Используется привязанный LLM-профиль вместо выбора пользователя по умолчанию
2. Если задано переопределение модели, используется эта конкретная модель внутри профиля
3. Это гарантирует, что агент всегда использует оптимальную модель для своей области

Варианты использования:

• Привязать агента аудита безопасности к мощной модели (например, claude-sonnet) для тщательного анализа
• Привязать простого FAQ-агента к быстрой модели (например, gpt-4o-mini) для снижения затрат
• Привязать агента генерации кода к модели, оптимизированной для кода

Ключевые слова маршрутизации

Ключевые слова определяют, когда система маршрутизирует сообщение чата к вашему пользовательскому агенту. Ключевые слова пользовательских агентов проверяются перед встроенными агентами, давая агентам, определённым администратором, приоритет.

Пример: Агент payment_specialist с ключевыми словами ["payment", "checkout", "billing", "invoice"] будет обрабатывать любое сообщение чата, содержащее эти слова — даже если встроенные агенты иначе бы совпали.

Советы по ключевым словам:

• Используйте доменно-специфичные термины, которые ваша команда реально использует
• Включайте синонимы (например, и «payment», и «billing»)
• Избегайте слишком общих слов (например, «test» перехватит слишком много запросов)
• Ключевые слова нечувствительны к регистру

Белые списки инструментов

По умолчанию агенты могут использовать все доступные инструменты. Белый список ограничивает агента только конкретными инструментами — полезно для:

• Безопасность: Агент только для анализа не должен модифицировать моки
• Фокус: Специалисту по мокам не нужны инструменты фаззинга
• Соответствие: Ограничение того, какие инструменты могут получить доступ к продуктивным данным

Выбирайте инструменты из списка встроенных инструментов и любых зарегистрированных инструментов маркетплейса.

Привязка к Feature Key

Пользовательский агент может быть привязан к Feature Key ИИ-кнопки. При привязке системный промпт агента добавляется к промпту кнопки по умолчанию, и применяется белый список инструментов агента.

Доступные Feature Key:

Пример: Привяжите payment_specialist к generate-mock → всякий раз, когда кто-то нажимает «Generate Mock», системный промпт специалиста по платежам добавляется, давая ИИ дополнительный контекст о платёжных API.

Примеры пользовательских агентов

Доменно-специфичный эксперт по мокам

Name: healthcare_mock_expert
Description: Создаёт HIPAA-совместимые моки медицинских API
System Prompt: |
  Вы специалист по медицинским API. При создании моков:
  - Никогда не используйте реальные данные пациентов — всегда используйте Faker-функции
  - Следуйте структуре ресурсов HL7 FHIR для медицинских эндпоинтов
  - Включайте правильные ответы об ошибках при сбоях аутентификации (401, 403)
  - Добавляйте заголовки X-Request-ID и X-Correlation-ID ко всем ответам
  - Используйте коды ICD-10 из допустимого диапазона для полей диагнозов
Keywords: [healthcare, patient, fhir, hl7, medical, hipaa, diagnosis]
Feature Key: generate-mock

Агент проверки безопасности

Name: security_reviewer
Description: Проверяет конфигурации API на проблемы безопасности
System Prompt: |
  Вы специалист по безопасности. При анализе:
  - Проверяйте отсутствие аутентификации на чувствительных эндпоинтах
  - Убеждайтесь, что настроено ограничение частоты запросов
  - Ищите утечки PII в ответах
  - Проверяйте конфигурацию CORS
  - Убеждайтесь в использовании TLS/HTTPS
  - Помечайте любые захардкоженные учётные данные или токены
Keywords: [security review, audit, compliance, pentest, owasp]
Tools: [browse_url, analyze_content, sql_query]
LLM Profile: claude-sonnet-profile

Агент интеграции CI/CD

Name: cicd_agent
Description: Генерирует конфигурации тестов для CI/CD пайплайнов
System Prompt: |
  Вы специалист по интеграции CI/CD. Помогайте пользователям:
  - Создавать тестовые коллекции, подходящие для выполнения в пайплайне
  - Генерировать скрипты нагрузочных тестов с CI-совместимыми порогами
  - Настраивать фаззинг с ограничением по времени
  - Форматировать результаты для парсеров JUnit/TAP
Keywords: [ci, cd, pipeline, jenkins, github actions, gitlab ci, deploy]
Tools: [build_api_collection, generate_test_script, configure_fuzzing]

Агент маршрутизации уведомлений

Name: alert_manager
Description: Маршрутизирует результаты тестов и оповещения в нужные каналы
System Prompt: |
  Вы специалист по маршрутизации оповещений. В зависимости от серьёзности и типа события:
  - Критические сбои → инцидент PagerDuty + Slack #incidents
  - Провалы тестовых наборов → канал Teams + email руководителю QA
  - Деградация производительности → Slack #performance + оповещение Opsgenie
  - Успешные деплои → Slack #releases + комментарий в Jira
  Всегда включайте: временную метку, окружение, краткое описание и ссылку на результаты.
Keywords: [alert, incident, notify team, send report, broadcast]
Tools: [send_slack, send_teams, send_pagerduty, send_opsgenie, send_email, send_jira_comment, current_time]

Интеграция с маркетплейсом

MCP Marketplace подключает внешние сервисы к системе агентов, давая им доступ к инструментам за пределами встроенного набора. В этом разделе описывается, как инструменты маркетплейса и агенты работают вместе.

Подключение внешних MCP-серверов

MCP-серверы (Model Context Protocol) — самый мощный тип интеграции. Они предоставляют пользовательские инструменты, которые агент может вызывать во время разговоров.

Популярные MCP-серверы:

• Playwright — автоматизация браузера (навигация, клики, скриншоты, заполнение форм)
• File System — чтение/запись файлов на сервере
• Database — запросы к внешним базам данных
• GitHub — управление репозиториями, задачами, PR
• Custom — создайте собственный MCP-сервер для любого API

Stateful-сессии: Каждый разговор в чате агента получает собственную MCP-сессию. Это означает, что MCP-сервер Playwright может открыть браузер в одном вызове, перейти на страницу в следующем и сделать скриншот в третьем — всё в рамках одного чата.

Подключение сервисов OpenAPI/gRPC/WSDL

Зарегистрируйте существующую документацию API, и агент получит возможность вызывать ваши реальные API:

1. OpenAPI — каждый эндпоинт становится вызываемым инструментом. Агент может тестировать реальные API, получать данные и проверять поведение.
2. gRPC — обнаруживает методы сервисов через gRPC server reflection. Вызовы инструментов проксируются как реальные gRPC-запросы к целевому серверу.
3. WSDL — каждая SOAP-операция становится инструментом с автоматическим построением XML-конверта.

Подключение A2A-агентов

Подключайте внешних ИИ-агентов, поддерживающих протокол Agent-to-Agent:

1. Зарегистрируйте базовый URL агента в маркетплейсе
2. Mockarty загрузит карточку агента из /.well-known/agent.json
3. Навыки внешнего агента станут инструментами, доступными в чате агента Mockarty

Это позволяет создавать мультиагентные процессы, где Mockarty делегирует задачи специализированным внешним агентам.

Выбор инструментов для каждой функции

Каждая ИИ-функция (и каждая сессия чата агента) поддерживает собственный выбор инструментов маркетплейса. Это предотвращает перегрузку инструментами — LLM видит только инструменты, релевантные текущей задаче.

Настройка выбора инструментов:

• ИИ-кнопки: нажмите иконку шестерёнки → секция MCP-инструментов
• Чат агента: нажмите иконку шестерёнки в заголовке чата

Протокол A2A (Agent-to-Agent)

Внешние ИИ-агенты могут взаимодействовать с Mockarty через протокол Agent-to-Agent:

Варианты использования:

• Внешний агент-оркестратор делегирует создание моков Mockarty
• CI/CD-агент просит Mockarty запустить тесты и сообщить результаты
• Мультиагентная система координирует тестирование между сервисами

Протокол A2A следует стандарту Google Agent-to-Agent, делая Mockarty совместимым с любой A2A-совместимой платформой агентов.

Руководство администратора

Настройка ИИ-функций

Шаг 1: Создайте LLM-профиль

1. Перейдите в Admin → AI & LLM → LLM Profiles
2. Нажмите Add Profile
3. Выберите провайдера (OpenAI, Anthropic и др.)
4. Введите API-ключ и выберите модель
5. Нажмите Save и убедитесь, что профиль Enabled

Шаг 2: (Необязательно) Зарегистрируйте инструменты маркетплейса

1. Перейдите в Admin → AI & LLM → MCP Marketplace
2. Нажмите Add Integration
3. Выберите тип источника и введите URL
4. Настройте аутентификацию при необходимости
5. Нажмите Save — инструменты будут обнаружены в течение 30 минут

Шаг 3: (Необязательно) Создайте пользовательских агентов

1. Перейдите в Admin → AI & LLM → Agent Settings
2. Нажмите Create Agent
3. Заполните имя, описание, системный промпт и необязательные ключевые слова/инструменты
4. По желанию привяжите LLM-профиль и переопределение модели
5. Нажмите Save

Настройка MCP Marketplace

Добавление OpenAPI-источника

1. Нажмите Add Integration → Source Type: OpenAPI
2. Введите URL вашей OpenAPI/Swagger-спецификации (JSON или YAML)
   • Пример: https://api.staging.example.com/swagger.json
3. Если API требует аутентификации, установите Auth Type:
   • Bearer: вставьте токен доступа
   • API Key: введите ключ и имя заголовка (например, X-API-Key)
   • Basic: введите логин и пароль
4. Нажмите Save
5. Нажмите иконку-штекер для проверки соединения — вы должны увидеть статус «online»
6. Нажмите иконку-список для просмотра обнаруженных инструментов

Добавление MCP-сервера

1. Нажмите Add Integration → Source Type: MCP Server
2. Введите эндпоинт MCP-сервера (например, http://localhost:3000/mcp)
3. Установите аутентификацию при необходимости
4. Нажмите Save

MCP-серверы поддерживают stateful-сессии — каждый разговор в чате агента получает свою сессию, позволяя инструментам вроде Playwright сохранять состояние браузера между вызовами.

Добавление WSDL (SOAP) источника

1. Нажмите Add Integration → Source Type: WSDL
2. Введите URL WSDL (например, https://legacy.example.com/service?wsdl)
3. Установите аутентификацию (многие SOAP-сервисы используют Basic auth)
4. Нажмите Save

Каждая SOAP-операция становится инструментом с префиксом soap_.

Обновление и проверка здоровья

• Авто-обновление: Фоновый воркер проверяет серверы каждые 30 минут. У каждого сервера свой интервал обновления (по умолчанию: 2 часа).
• Ручная проверка: Нажмите иконку-штекер на любом сервере для немедленной проверки.
• Индикаторы статуса: Зелёный = online, Красный = error (наведите для деталей), Серый = unknown.

Мониторинг через журнал аудита ИИ

Перейдите в Admin → AI & LLM → AI Audit Log.

Каждая ИИ-операция логируется:

• Временная метка — когда операция была выполнена
• Пользователь — кто инициировал
• Действие — какая ИИ-функция (generate_mock, diagnose_error и т.д.)
• Профиль — какой LLM-профиль был использован
• Длительность — время вызова LLM в миллисекундах
• Статус — success, error или rate_limited
• Токены — использование токенов (если сообщается провайдером)

Фильтрация по пользователю, типу действия, статусу и диапазону дат. Экспорт в CSV для отчётов соответствия.

Ограничения запросов и безопасность

Ограничения частоты ИИ-запросов:

• Каждый пользователь имеет дневной лимит вызовов ИИ (настраивается администратором)
• При достижении лимита ИИ-кнопки показывают ошибку ограничения частоты
• Журнал аудита отслеживает все вызовы для мониторинга

Меры безопасности:

• Инструмент browse_url блокирует приватные/внутренние IP-адреса (защита от SSRF)
• Инструмент sql_query работает только на чтение (SELECT/WITH) и блокирует чувствительные таблицы
• Инструмент db_list_tables работает только на чтение — модификация схемы невозможна
• Инструмент redis_command ограничен командами только на чтение
• Вызовы инструментов к серверам маркетплейса проверяют URL на SSRF
• Переопределения заголовков пользователей изолированы для каждого пользователя — учётные данные одного не утекают к другим
• MCP-сессии изолированы для каждого разговора
• Данные хранилища учётных данных остаются в localStorage браузера, никогда не сохраняются на сервере
• Все ИИ-запросы логируются в журнале аудита
• Белые списки инструментов пользовательских агентов обеспечивают принцип наименьших привилегий

Уведомления

ИИ-операции генерируют уведомления:

Иконка колокольчика в верхней навигации показывает количество непрочитанных уведомлений. Нажмите на неё, чтобы просмотреть, отклонить или перейти по ссылке уведомления.

Советы для лучших результатов

1. Будьте конкретны: «Сгенерируй мок для GET /api/users, который возвращает 10 пользователей с полями name, email и role» лучше, чем «создай мок пользователей»
2. Предоставляйте контекст: Используйте пользовательский промпт, чтобы рассказать ИИ о вашем домене, SLA или стандартах кодирования
3. Выбирайте правильную модель: Быстрые модели для простых задач, мощные модели для анализа
4. Итерируйте: Если первый результат не идеален, используйте «Improve Mock» или скорректируйте пользовательский промпт
5. Используйте MCP-инструменты: Когда доступны, включайте релевантные инструменты, чтобы ИИ мог получить доступ к реальным данным из ваших API
6. Проверяйте ИИ-триаж внимательно: Автоматическая сортировка — это отправная точка, всегда проверяйте критические аномалии вручную
7. Используйте пользовательские заголовки: Если инструментам нужны ваши учётные данные, установите их в шестерёнке настроек, а не включайте в промпты
8. Используйте хранилище учётных данных: Для подключений к базам данных, API-ключей и URL вебхуков — сохраните их однократно в панели Credentials и ссылайтесь по имени
9. Используйте чат агента для сложных задач: Многошаговые операции лучше работают через интерфейс чата, где агент может итерировать
10. Ограничивайте пользовательских агентов: Давайте агентам конкретные ключевые слова и белые списки инструментов, чтобы они оставались сфокусированными
11. Привязывайте модели к агентам: Используйте привязку LLM-профиля, чтобы каждый пользовательский агент использовал оптимальную модель для своей задачи
12. Попросите администратора добавить интеграции: Если ИИ не хватает контекста о ваших API, попросите администратора зарегистрировать их в MCP Marketplace

Устранение неполадок

«LLM not configured»

Нет включённых LLM-профилей. Попросите администратора создать профиль в Admin → AI & LLM → LLM Profiles.

«LLM profile not found»

Выбранный профиль был удалён или отключён. Нажмите кнопку-шестерёнку и выберите другой профиль.

ИИ отвечает медленно

• Попробуйте более быструю модель (переключитесь с GPT-4o на GPT-4o-mini)
• Сократите длину пользовательского промпта
• Отключите ненужные MCP-инструменты (каждый вызов инструмента добавляет задержку)
• Для чата агента: уменьшите количество включённых инструментов маркетплейса

MCP-инструменты не работают

• Проверьте, что сервер маркетплейса онлайн (Admin → AI & LLM → MCP Marketplace)
• Убедитесь, что инструмент включён на сервере
• Проверьте, что вы выбрали инструмент в настройках шестерёнки функции
• Если используете пользовательские заголовки, проверьте правильность учётных данных
• Проверьте логи сервера на ошибки аутентификации

Чат агента маршрутизирует некорректно

• Маршрутизация основана на ключевых словах — попробуйте перефразировать запрос с более чёткими ключевыми словами
• Ключевые слова пользовательских агентов имеют приоритет над встроенными
• Проверьте Admin → Agent Settings, чтобы увидеть, какие агенты и ключевые слова активны
• Используйте явные фразы, например «create a mock for…» для выбора агента mock_builder

Инструменты работы с базами данных возвращают ошибки

• Проверьте правильность строки подключения в хранилище учётных данных
• Убедитесь, что база данных доступна с сервера Mockarty
• SQL-инструменты поддерживают только запросы SELECT и WITH — UPDATE/INSERT/DELETE заблокированы
• Проверьте сетевые проблемы и настройки файрвола между Mockarty и базой данных

Инструменты уведомлений не работают

• Для email: проверьте настройку SMTP в Admin → Email Settings
• Для Slack/Teams/Discord: проверьте, что URL вебхука действителен и не истёк
• Для Telegram: проверьте правильность токена бота и chat_id
• Для PagerDuty/Opsgenie: проверьте API-ключ или routing key
• Проверьте хранилище учётных данных на опечатки в ключах или значениях

Вызовы инструментов отклоняются

• Некоторые инструменты требуют одобрения — вы увидите запрос на подтверждение/отклонение
• Инструменты только для чтения (browse, analyze, query) подтверждаются автоматически
• Инструменты, изменяющие данные (create, update, delete), могут требовать одобрения в зависимости от настроек администратора

ИИ-анализ не сохраняется

Для функций, которые сохраняют анализ (тестовые отчёты, аномалии фаззинга, результаты нагрузочного тестирования), анализ сохраняется автоматически. Обновите страницу, чтобы увидеть его в отчёте.

Пользовательские заголовки не применяются

• Переопределения заголовков действуют для каждой функции — проверьте, что вы установили их для правильной функции
• Переопределения заменяют значения по умолчанию сервера — если вы установите Authorization, это переопределит аутентификацию сервера
• Очистите переопределения, если хотите вернуться к настройкам сервера по умолчанию