Редакционная политика
Название
Название — это короткое имя, по которому агента можно найти в списке агентов на маркетплейсе.
Требования:
- до 20 знаков с пробелами;
- только на русском языке;
- начинается с заглавной буквы;
- не содержит точку в конце и эмодзи, если только это не является частью названия бренда;
- не содержит слов-описаний «агентности» («бот», «агент», «ИИ», «ассистент», «помощник», «умный»);
- не совпадает с названиями уже существующих на маркетплейсе агентов;
- не содержит общих фраз или понятий (пластиковые окна, товары для детей и т. п.).
Короткое описание
Короткое описание размещается под названием агента и объясняет его основную функцию.
Требования:
- До 60 знаков с пробелами.
- Без точки в конце.
- Используются глаголы в 3-м лице. Например, «создает», «анализирует», «находит», «управляет».
- Не используются местоимения «я/мы/ты» и общие формулировки. Например: «предназначен для…».
Примеры
- Находит книги под настроение и помогает с покупкой.
- Создает карту идей по данным из чата.
- Анализирует таблицы и строит графики.
Рекомендация: чтобы описания в каталоге не звучали одинаково, выбирайте слова, которые точнее всего отражают суть вашего сценария. Список ниже поможет начать:
| Задача агента | Подходящие глаголы (3-е лицо) |
|---|---|
| Действие, создание | создает, собирает, генерирует, оформляет |
| Анализ | анализирует, считает, сравнивает, проверяет |
| Поиск, подбор | ищет, находит, подбирает, предлагает |
| Управление | управляет, планирует, бронирует, организует |
| Поддержка | подсказывает, напоминает, объясняет |
Глагол «помогает» допустим только там, где другая формулировка звучит искусственно. В остальных случаях выбирайте более точное слово из спи ска.
Расширенное описание
Расширенное описание открывается при нажатии на карточку агента и подробно раскрывает его возможности.
Требования
- До 300 знаков с пробелами.
- Не дублирует подзаголовок: пользователь получает только новую информацию.
- Указывает область знаний. Вместо «знает все о кино» — «составляет подборки фильмов по жанрам, актерам и рейтингу».
Для блока «Вот что у меня можно спросить» дайте 3 примера целевых, полностью рабочих промптов. Пользователь наверняка скопирует один из них, чтобы проверить агента.
Пример заполнения
Описание: проверяет сайты, заполняет заявки, планирует покупки и ищет скидки.
Вот что у меня можно спросить:
- Какой курс юаня сегодня?
- Найди книгу «Чистый код» на Ozon.
- Положи молоко в корзину «Самоката».
Категория
Категория агенты должна отражать возможности агента и соответствовать требованиям.
Статус
Пользователь должен видеть текущий статус процесса работы агента над задачей. Например: агент «думает», «действует», «ожидает уточнений» или «завершил задачу». Для длительных задач используйте индикатор прогресса (например, «Анализирую 3 документа... Документ 1/3»).
Текст ошибок
Текст ошибок — это текст, который видит пользователь, если что-то пошло не так.
Агент должен давать понятные сообщения об ошибках. Не «Ошибка 500», а «Не могу подключиться к вашему календарю. Проверьте настройки доступа или попробуйте позже». Ошибки не должны вводить в заблуждение пользователя, подробнее — в таблице с примерами ниже. Текст ошибок должен быть уникальным и отражать суть проблемы. Должны прилагаться условия воспроизведения багов.
Требования:
- До 120 знаков с пробелами.
- Без точки в конце.
- Объясняет причину ошибки и предлагает решение, если это возможно.
Примеры
| Было | Стало |
|---|---|
| Вы ввели неверные данные | Не могу распознать данные. Введите их в формате [пример], чтобы я смог прочитать |
| Вы прислали пустой файл | В файле нет текста. Пожалуйста, проверьте еще раз или пришлите другой |
| Ошибка 500: Сервер не отвечает | Сейчас не могу ответить из-за высокой нагрузки. Пожалуйста, повторите запрос через пару минут |
| Неверный формат входных данных | Пришлите файл в формате pdf или txt — с ними я работаю лучше всего |
Отсутствие орфографических ошибок
В ответах агента должны отсутствовать орфографические и пунктуационные ошибки.
Отсутствие нецензурной и стилистически сниженной лексики
В ответах агента не должно быть ненормативной лексики, оскорблений и грубого стиля речи.