Версии агента, операции и интерфейс
Изменения версий, публикация и снятие публикации, операции, аудит и проверочный прогон интерфейса.
Эти проверки начинаются после основного маршрута: есть работающий поток и опубликованный тестовый агент. Изменения выполняются только для объектов своего прогона.
Ж-01. Изменение черновика не меняет опубликованную версию
- В Studio → проект → «Развертывания» откройте действия своего агента → «Детали». Запишите развернутую версию.
- Через «Тест» выполните контрольный запрос, запишите ответ.
- Откройте исходный поток. В системное сообщение модели добавьте:
Каждый ответ начинай с фразы «QA-ВЕРСИЯ-2».Убедитесь, что эта фраза не запрещена политикой. - Сохраните поток и проверьте его в чате редактора.
- Не отправляя публикацию, вызовите уже опубликованного агента в новом диалоге.
Ожидается: редактор использует новый черновик, опубликованный агент — прежнюю сохранённую версию. Контрольная фраза должна появиться сначала только в редакторе. Оцените несколько коротких ответов: одиночное непослушание модели не доказывает выбор неверной версии.
Ж-02. Обновить то же развертывание
- В изменённом потоке нажмите «Развернуть».
- В «Выбрать развертывание» выберите существующего тестового агента, а не создание нового.
- В окне обновления сверьте выбранную цель и новую «Версию потока».
- Подтвердите «Заменить vN на vM», где N — прежняя версия, M — новая.
- Дождитесь завершения обновления.
- В «Развертывания» → действия агента → «Детали» проверьте новое значение «Развернутая версия». Один статус Active недостаточен: во время обновления могла продолжать работать старая версия.
- В новом тестовом диалоге и по A2A отправьте короткий вопрос о связи.
- Сверьте ID агента и адрес вызова с исходными.
Ожидается: агент сохранил идентичность и адрес, выбранная версия изменилась, ответ соответствует новой инструкции. Ключ модели для опубликованного исполнения управляется платформой, а не ручным копированием пользовательского ключа в поток.
Ж-03. Неуспешная новая публикация не считается готовой
Условия: отдельный тестовый поток с воспроизводимо недопустимой для публикации конфигурацией, согласованной с ответственным за QA. Не портите рабочий поток для проверки общих ошибок.
- Запишите старую активную версию своего агента и её успешный ответ.
- Попробуйте опубликовать новую версию, которая нарушает согласованное условие публикации, например использует модель вне разрешённого списка.
- Запишите ошибку, ID операции и версию-кандидат, если она была создана.
- Проверьте, что неуспешная версия не объявлена выбранной и готовой.
- Вызовите прежнюю активную версию по стабильному адресу.
Ожидается: причина отказа читаема, неуспешная попытка не выдаётся за успешное развертывание. Если стадия обновления предполагает иной переходный режим по установленному контракту, фиксируйте его отдельно; не делайте вывод только по всплывающему сообщению.
Ж-04. Снять публикацию своего агента
- Убедитесь, что агент отвечает на свежий авторизованный запрос.
- Под пользователем с правом управления откройте Control Plane → «Агенты» → свой агент.
- Нажмите «Снять публикацию», заполните запрошенные поля и подтвердите действие.
- Дождитесь завершения операции и неактивной публикации.
- С корректным свежим токеном повторите A2A-вызов прежнего адреса.
- Обновите список развертываний Studio и карточку Control Plane.
Ожидается: публичный маршрут больше не обслуживает агента; после завершения снятия ожидается 404. Используйте действующий токен, чтобы не перепутать отсутствие маршрута с истечением доступа. История агента и его версий сохраняется. Публичного действия физического удаления идентичности агента в этом контракте нет.
Ж-05. Различить принятие команды, её исполнение и состояние платформы
- Создайте безопасное изменение собственного объекта: например, обновите описание тестовой политики или отправьте публикацию.
- Сразу откройте «Операции». Найдите операцию по времени и целевому объекту.
- Запишите её ID, действие, состояние и результат.
- Дождитесь завершения. При ошибке прочитайте причину, а не только цвет строки.
- Откройте сам объект и проверьте его фактическую ревизию или выбранную версию.
- На дашборде сравните время последней проверки. При необходимости запустите «Проверить состояние».
Ожидается: принятие запроса не равно готовности объекта. Завершённая операция описывает результат команды в тот момент; последующая проверка может обнаружить расхождение из-за более позднего изменения или сбоя. Успешная операция сама по себе не делает старые наблюдения свежими.
Если карточка объекта, операция и дашборд противоречат друг другу после новой завершённой проверки, запишите все три результата с временем и ревизией. Не закрывайте дефект объяснением «так устроена асинхронность», если расхождение сохраняется.
Ж-06. Проверить аудит управления
- Выполните одно безопасное изменение собственного тестового объекта и запишите время.
- Под пользователем с правом чтения аудита откройте «Аудит».
- Найдите запись по времени, объекту или доступным фильтрам.
- Сверьте действие, инициатора, объект и результат.
- Убедитесь, что запись не содержит полный секрет провайдера, виртуальный ключ или пользовательский токен.
Ожидается: действие управления можно связать с инициатором и объектом. Содержимое каждого сообщения агента и каждое решение Guardrails не обязаны быть строками этого журнала; для них используются отдельные технические наблюдения.
И-01. Боковое меню остаётся доступным на длинных страницах
- Откройте карточку агента с большим списком проверок, затем редактор Guardrails с несколькими правилами.
- Уменьшите высоту окна браузера и прокрутите содержимое до конца.
- Проверьте, что навигация и меню пользователя не уезжают вместе с основной страницей. При недостатке места внутри навигации допустима собственная прокрутка её списка.
- Вернитесь наверх, откройте другую страницу и повторите.
Ожидается: нижняя часть меню доступна, основная прокрутка не растягивает весь макет. На узком экране разрешена предусмотренная мобильная навигация; она не должна перекрывать обязательные действия.
И-02. Политики: три вкладки и отсутствие горизонтального переполнения
- Откройте «Политики» и последовательно выберите «Выдача ключей», «Публикация агентов», «Guardrails».
- Проверьте, что активная вкладка отличается цветом, а нижняя линия не становится толще из-за наложения рамок.
- Откройте список Guardrails, карточку и редактор с длинным описанием и регулярным выражением.
- Проверьте страницу при ширине около 1280, 1024 и 768 пикселей либо на доступных размерах окна.
- Убедитесь, что контент не уходит под меню, поля и кнопки доступны, а документ не получает горизонтальную прокрутку.
- Откройте окно редактирования правила и проверьте «Готово» и «Отмена» при небольшой высоте экрана.
Ожидается: вкладки не смещают содержимое по горизонтали; длинные строки переносятся или сокращаются в предназначенном для этого месте. Переполнение не должно прятать кнопку сохранения.
И-03. Заголовки, хлебные крошки и единый список
- Откройте списки провайдеров, моделей, агентов и Guardrails.
- Проверьте один основной заголовок страницы и отдельную навигационную цепочку, если есть вложенность.
- В начале цепочки должна быть иконка домика с доступным названием для средств чтения, без лишнего видимого слова «Обзор».
- В карточке объекта проверьте возврат к списку через хлебные крошки.
- Убедитесь, что Guardrails представлены таблицей, а не отдельной сеткой карточек.
- Проверьте отсутствие замоканного раздела пакетных операций в боковом меню.
Ожидается: цепочка помогает понять положение в разделе и не выглядит вторым одинаковым заголовком. Удалять навигацию только из-за повторяющегося имени раздела не требуется.
И-04. Дашборд объясняет результат без повторов
- Дождитесь новой завершённой проверки состояния.
- В благополучных карточках проверьте краткий статус, время и ссылку на соответствующий раздел.
- Убедитесь, что одно сообщение об успешном применении не повторено трижды разными фразами.
- При реальной проблеме проверьте, что есть конкретная область, понятная причина и действие для перехода к разбору.
- Проверьте, что «настройки применены» не описывается как гарантия качества или доступности ответов внешней модели.
Ожидается: администратор понимает, какая область требует внимания и где её открыть. Историческая неуспешная операция не должна сама по себе превращаться в доказательство текущего расхождения без актуальной проверки.

Пример компактного дашборда с временем проверки и переходами к объектам