ym88659208ym87991671
Редакционная политика | Документация для разработчиков

Редакционная политика

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

Название

Название — это короткое имя, по которому агента можно найти в списке агентов на маркетплейсе.

Требования:

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

Короткое описание

Короткое описание размещается под названием агента и объясняет его основную функцию.

Требования:

  • До 60 знаков с пробелами.
  • Без точки в конце.
  • Используются глаголы в 3-м лице. Например, «создает», «анализирует», «находит», «управляет».
  • Не используются местоимения «я/мы/ты» и общие формулировки. Например: «предназначен для…».

Примеры

  • Находит книги под настроение и помогает с покупкой.
  • Создает карту идей по данным из чата.
  • Анализирует таблицы и строит графики.

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

Задача агентаПодходящие глаголы (3-е лицо)
Действие, созданиесоздает, собирает, генерирует, оформляет
Анализанализирует, считает, сравнивает, проверяет
Поиск, подборищет, находит, подбирает, предлагает
Управлениеуправляет, планирует, бронирует, организует
Поддержкаподсказывает, напоминает, объясняет

Глагол «помогает» допустим только там, где другая формулировка звучит искусственно. В остальных случаях выбирайте более точное слово из списка.

Расширенное описание

Расширенное описание открывается при нажатии на карточку агента и подробно раскрывает его возможности.

Требования

  • До 300 знаков с пробелами.
  • Не дублирует подзаголовок: пользователь получает только новую информацию.
  • Указывает область знаний. Вместо «знает все о кино» — «составляет подборки фильмов по жанрам, актерам и рейтингу».

Для блока «Вот что у меня можно спросить» дайте 3 примера целевых, полностью рабочих промптов. Пользователь наверняка скопирует один из них, чтобы проверить агента.

Пример заполнения

Описание: проверяет сайты, заполняет заявки, планирует покупки и ищет скидки.

Вот что у меня можно спросить:

  • Какой курс юаня сегодня?
  • Найди книгу «Чистый код» на Ozon.
  • Положи молоко в корзину «Самоката».

Категория

Категория агенты должна отражать возможности агента и соответствовать требованиям.

Статус

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

Текст ошибок

Текст ошибок — это текст, который видит пользователь, если что-то пошло не так.

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

Требования:

  • До 120 знаков с пробелами.
  • Без точки в конце.
  • Объясняет причину ошибки и предлагает решение, если это возможно.

Примеры

БылоСтало
Вы ввели неверные данныеНе могу распознать данные. Введите их в формате [пример], чтобы я смог прочитать
Вы прислали пустой файлВ файле нет текста. Пожалуйста, проверьте еще раз или пришлите другой
Ошибка 500: Сервер не отвечаетСейчас не могу ответить из-за высокой нагрузки. Пожалуйста, повторите запрос через пару минут
Неверный формат входных данныхПришлите файл в формате pdf или txt — с ними я работаю лучше всего

Отсутствие орфографических ошибок

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

Отсутствие нецензурной и стилистически сниженной лексики

В ответах агента не должно быть ненормативной лексики, оскорблений и грубого стиля речи.

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

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

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