ym88659208ym87991671
Пользовательский опыт | Документация для разработчиков

Пользовательский опыт

Обновлено 23 марта 2026

Полезность

Агент должен приносить практическую пользу. Один из подходов к оценке эффективности агента — использование эвристических алгоритмов.

UX/UI адаптированность

  1. Отображение состояния агента

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

  1. Соответствие реальному миру

Агент использует общепринятую лексику и привычные визуальные элементы.

Например, команды:

  • Запустить агента;
  • Остановить;
  • Повторить;
  • Загрузить файл.

Например, элементы:

  • иконка скрепки — для загрузки файла;
  • иконка корзины — для удаления;
  • иконка круглой стрелки — для повторения и т. д.
  1. Последовательность и стандарты

Соблюден принцип единообразия: кнопки для одинаковых действий выглядят одинаково и находятся на одних и тех же местах на всех этапах пути пользователя. Путь пользователя соответствует привычным на рынке паттернам.

  1. Предотвращение ошибок

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

  1. Помощь пользователям в распознавании, диагностике и исправлении ошибок

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

  1. Подсказки пользователям

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

  1. Доступность интерфейса

При наличие виджетов все функциональные элементы интерфейса легко доступны, формат текста соответствует общепринятым практикам.

  1. Формирование доверия и прозрачность операций

Система объясняет свои действия, дает возможность контролировать автоматические решения. Используются проактивные подсказки, контекстная помощь.

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

Ничто не относящееся к процессу, не прерывает путь пользователя и не раздражает его.

  1. Этичность системы

Интерфейс не манипулирует пользователем, не использует «темные паттерны» (скрытые подписки, усложненную отмену действия и т.д.). Данные пользователя и его приватность защищены, пользователь информирован об этом.

Уникальность возможностей

Агент должен предлагать пользователю возможности, которые не предоставляет другой агент на маркетплейсе или ГигаЧат. Если агент не уникален, его публикация остается на усмотрение платформы, без объяснения причин отказа.

Корректный вызов и запуск агента

Агент должен корректно вызываться после запросов пользователя, которые соответствуют тематики агента. Агент не должен вызываться после запросов, которые не соответствуют его тематике.

Корректный ответ на валидные запросы

Агент правильно и понятно отвечает на запросы, соответствующие его возможностям. Агент отвечает отказом на вопрос, не связанный с его тематикой.

Прохождение сценариев разработчика

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

Статус

Пользователь должен видеть текущий статус процесса работы агента над задачей. Например: агент «думает», «действует», «ожидает уточнений» или «завершил задачу». Для длительных задач используйте индикатор прогресса (например, «Анализирую 3 документа... Документ 1/3»). В статусе используется прямая речь.

Требования к статусу:

  • Максимум — 40 знаков с пробелами.
  • Отсутствуют точки в конце.
  • Написан в настоящем времени, простым языком, избегая технических терминов (без «парсинга», «валидации» и прочего). Рассказывает не о том, что делает код, а о том, что происходит с задачей пользователя. Вместо «извлечение сущностей» — «выделяю главное», вместо «генерация артефакта» — «готовлю результат».

Примеры:

  • Читаю ваш запрос.
  • Загружаю файлы.
  • Составляю схему.
  • Сохраняю результат.

Описание сценариев и ограничений

Разработчик должен предоставить четкое описание всех сценариев работы агента и его ограничений в кабинете разработчика перед отправкой на модерацию.

Перечень возможных ошибок и способы решения

Заявка на модерацию должна содержать список типичных ошибок агента и инструкции по их решению.

Контактные данные поддержки

Заявка на модерацию должна содержать контакты команды поддержки с указанием среднего времени ответа.

Заметили ошибку?

Выделите текст и нажмите Ctrl + Enter, чтобы сообщить нам о ней

ПАО Сбербанк использует cookie для персонализации сервисов и удобства пользователей. Вы можете запретить сохранение cookie в настройках своего браузера.