Требования к текстам для агента

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

Тексты агента в карточке — единственный интерфейс, по которому пользователи судят о его пользе до начала диалога. Этот руководство поможет создать емкое имя, четко сформулировать задачу и настроить понятные сообщения об ошибках. Следуйте этим стандартам, чтобы вашего агента легко находили в каталоге, а пользователи сразу понимали сценарии его использования.

Какие тексты агента необходимы для UI

Поле	Описание
Название	Уникальное имя агента (до 20 знаков), которое пользователь видит в общем списке. Служит главным идентификатором
Короткое описание	Подзаголовок в карточке (до 60 знаков). Кратко отвечает на вопрос «Какую задачу решает агент?»
Расширенное описание	Детальный текст (до 300 знаков, включая промпты), который открывается по клику. Объясняет возможности и содержит примеры промптов
Промпты	Прописанные отдельно промпты — примеры запросов пользователя, которые точно сработают
Фразы состояний	Статусы загрузки (до 40 знаков). Сообщения от первого лица, которые показывают, что агент занят работой над задачей
Сообщения об ошибках	Текст (до 120 знаков), который видит пользователь, если сценарий прервался. Объясняет причину и предлагает решение

Название

Что это: короткое имя, по которому агента найдут в списке.

Формат: до 20 знаков с пробелами, только на русском языке. Используйте существительное в единственном числе с заглавной буквы. Без точек, эмодзи и лишних слов, например: «бот», «агент», «AI», «ассистент», «помощник», «умный».

Когда выбираете название, определите тип агента: роль (консультант) или инструмент.

• Для ролей: «Психолог», «Аналитик», «Турист».
• Для инструментов: «Календарь», «Карта идей», «Запись на услуги».

Перед созданием проверьте, не занято ли имя другими агентами.

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

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

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

Примеры

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

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

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

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

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

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

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

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

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

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

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

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

Фразы состояний и статусы

Что это: прямая речь агента во время работы над задачей.

Формат: до 40 знаков с пробелами, без точки в конце. Пишите в настоящем времени и простым языком, избегая технических терминов — как сказали бы другу, без «парсинга» и «валидации». Важно рассказывать не о том, что делает код, а о том, что происходит с задачей пользователя. Вместо «извлечение сущностей» — «выделяю главное», вместо «генерация артефакта» — «готовлю результат».

Примеры

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

Сообщения об ошибках

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

Формат: до 120 знаков с пробелами, без точки в конце. Ваша задача — объяснить причину ошибки и предложить решение, если это возможно. То есть скажите пользователю, что ему сделать, чтобы исправить ситуацию.

Примеры

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