Тема
Витрина наблюдений
При выборе наблюдения интерфейс показывает его резолюцию и все связанные HTTP-запросы. В карточке доступны вкладки:
- «Комментарий» — отдельные поля тегов и пользовательского комментария;
- «Результат» — типизированное представление результата; для API это отдельный редактор API и параметров;
- «Связи с запросами» — связанные примеры создания, изменения, удаления, чтения и проверки данных, источники данных, допустимые значения аргументов и места использования API в исходниках;
- «Описание» — встроенное описание смысла выбранного типа наблюдения.
На вкладке связей через контекстное меню можно вставить ранее скопированный запрос, выбрать смысл связи и указать строку для поиска в ответе и форматируемый комментарий. Выбор связи показывает соответствующий HTTP-обмен и комментарий в области просмотра под таблицей; двойной щелчок позволяет изменить поля, а контекстное меню — изменить или удалить связь. Эти действия применяются сразу. Обычные связанные запросы наблюдения остаются в HTTP-вкладках и управляются отдельно.
Изменения статуса, цвета, тегов, комментария и редактируемого результата сохраняются при переключении записи/вкладки и перед выполнением контекстных операций.
Результат вручную созданного наблюдения можно редактировать, в том числе у типа «Заголовок». Для автоматически созданного наблюдения возможность редактирования определяется его типом.
| Действие | Что происходит |
|---|---|
| «Состояние» | Устанавливает выбранное состояние сразу для одного или нескольких наблюдений. |
| «Раскрашивание» | Устанавливает независимую цветовую маркировку. |
| Теги → Добавить | Предлагает множественный выбор из TAGS, добавляет выбранные #TAG без повторов. Показывается только при непустом списке TAGS. |
| Теги → Удалить | Удаляет выбранные метки из поля тегов. Показывается только при непустом списке TAGS. |
| Скопировать связанные запросы | Помещает основной и все дополнительные request ID выбранных наблюдений во внутренний буфер. |
| «Вставить ссылки» | Прикрепляет запросы из внутреннего буфера к выбранным наблюдениям. Действие появляется только при непустом буфере. |
Закрыть x у HTTP-вкладки | После подтверждения удаляет связь этого запроса с наблюдением; сам сохраненный HTTP-обмен не удаляется. |
| Закрыть вкладки справа | Массово удаляет связи с запросами правее выбранной HTTP-вкладки. |
| «Выгрузить ответ в файл» | Сохраняет body основного запроса выбранного наблюдения в локальный файл. |
| Сравнить | Для двух выбранных наблюдений открывает сравнение их основных запросов и результатов выделения строк. |
| «Трансформировать» | Меняет тип выбранного наблюдения на месте, если исходный и целевой типы используют одинаковое представление результата. Например, строковый технический результат можно превратить в более предметное строковое наблюдение без повторного извлечения данных. Совместимость означает именно возможность безопасно перенести уже зафиксированный результат; произвольные типы с разной структурой преобразовать нельзя. |
| «Объединить» | Для двух и более наблюдений одного совместимого типа с коллекционным результатом создает одно агрегированное наблюдение. Действие подходит для сведения нескольких частей анализа в единый результат; одиночные и структурно несовместимые наблюдения объединить нельзя. |
| Дублировать | Создает отдельную копию результата для независимой дальнейшей резолюции. |
| Автотестирование | Генерирует применимые тесты над выбранными наблюдениями и открывает их в очереди. |
| «Анализ с использованием ИИ» | Создает подходящие AI-задачи для выбранных типов наблюдений. Пункт показывается только для поддерживаемых целей. |
| «Импорт API» | Загружает операции OpenAPI из YAML/JSON как ручные API-наблюдения. Доступен даже без выбранной строки. |
| Сбросить результат | После подтверждения сбрасывает статус, теги, цвет, комментарий и уровень доступа ИИ. Сам результат сохраняется. |
| Удалить | После подтверждения запрашивает удаление результата. Удаление доступно в рамках прав на проект и тип наблюдения независимо от происхождения записи. |
При экспорте наблюдений можно ограничить длину структурированного поля Result и добавить response_context: фрагменты исходного ответа вокруг совпадений результата. Для контекста задаются количество символов до и после совпадения и максимальное число фрагментов.
