> For the complete documentation index, see [llms.txt](https://docs.nocodecloud.ru/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.nocodecloud.ru/ai/idealnyi-prompt-dlya-ii-agenta.md).

# Идеальный промпт для ИИ Агента

Оптимальная длина промпта**Prompt (промпт)** для ИИ-агента — это **задание или инструкция**, которую мы формулируем для модели, чтобы она выдала нужный результат.

По сути, это язык общения человека с искусственным интеллектом.

\| Оптимальная длина промпта  | <p>500-1500 токенов (2000-6000 символов) - золотая середина для большинства задач <br>До 3000 токенов (12000 символов) - для сложных задач <br>Свыше 5000 токенов - высокий риск галлюцинаций<br></p><p>Пример: запрос на написание эссе по философии лучше сделать длиннее, чем запрос «сгенерируй шутку про кота».</p>                                                                                                                                                                                                                                                   |
\| -------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
\| Красные флаги              | <p></p><ul><li>Слишком общие инструкции → модель выдаст случайный или банальный ответ.</li><li>Противоречивые требования → результат будет непредсказуемым.</li><li>Множественные задачи в одном промпте → модель может «запутаться».</li><li>Отсутствие примеров → выше шанс, что ответ не совпадёт с ожиданиями.</li></ul><p>Пример плохого промпта: «Сделай сайт, но чтобы он был красивым и простым». Пример улучшенного: «Сделай одностраничный сайт-визитку на HTML с блоками: о компании, услуги, контакты. Используй минимализм (белый фон, синие заголовки)».</p> |
\| Оптимальный формат промпта | <p>Markdown помогает структурировать текст: заголовки, списки, выделения, кодовые блоки.<br>Это улучшает читаемость и точность интерпретации.</p>                                                                                                                                                                                                                                                                                                                                                                                                                          |

## Основные параметры

### Оптимальная длина промпта

500-1500 токенов (2000-6000 символов) - золотая середина для большинства задач\
До 3000 токенов (12000 символов) - для сложных задач\
Свыше 5000 токенов - высокий риск галлюцинаций

Пример: запрос на написание эссе по философии лучше сделать длиннее, чем запрос «сгенерируй шутку про кота».

### Красные флаги

* Слишком общие инструкции → модель выдаст случайный или банальный ответ.
* Противоречивые требования → результат будет непредсказуемым.
* Множественные задачи в одном промпте → модель может «запутаться».
* Отсутствие примеров → выше шанс, что ответ не совпадёт с ожиданиями.

Пример плохого промпта: «Сделай сайт, но чтобы он был красивым и простым». Пример улучшенного: «Сделай одностраничный сайт-визитку на HTML с блоками: о компании, услуги, контакты. Используй минимализм (белый фон, синие заголовки)».

### Оптимальный формат промпта

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

## Структура идеального промпта для ИИ-агента в n8n

<table><thead><tr><th width="232.76171875">Раздел</th><th>Описание / Что писать</th></tr></thead><tbody><tr><td>Заголовок задачи</td><td>Краткое название, чтобы сразу понять о чём речь</td></tr><tr><td>Роль</td><td>Кто выполняет задачу и для кого.<br>Пример: <em>«Ты технический писатель, который пишет инструкции для новичков в IT»</em></td></tr><tr><td>Контекст</td><td>Почему важна задача, цель или проблема.<br>Пример: <em>«Пользователь не умеет настраивать VPN, нужно объяснить простыми словами»</em></td></tr><tr><td>Задача</td><td>Что требуется сделать — максимально чётко, но кратко (1–2 предложения)</td></tr><tr><td>Входные данные</td><td><p>– [Переменная 1]</p><p>– [Переменная 2]</p><p> <em>(подставляются из n8n, напр. <code>{{$json["topic"]}}</code>)</em></p></td></tr><tr><td>Формат ответа</td><td>Markdown / JSON / Таблица / Чек-лист</td></tr><tr><td>Стиль</td><td>Дружелюбный, простой (без жаргона)или сухой, деловой — в зависимости от задачи</td></tr><tr><td>Требования</td><td><p>– Язык: русский / английский</p><p>– Добавить примеры кода / ссылки на документацию / best practices</p></td></tr><tr><td>Примеры плохого и хорошего ответа</td><td>Плохо: <em>«Просто подключите сервис»</em><br>Хорошо: <em>«1. Перейдите в настройки → 2. Введите токен → 3. Нажмите „Сохранить“»</em></td></tr><tr><td>Финальный чек-лист</td><td><p>– Все переменные и данные учтены?</p><p>– Примеры кода присутствуют?</p><p>– Оформлено в Markdown?</p></td></tr><tr><td>Запрещено</td><td>Что нельзя делать: придумывать факты, добавлять рекламу и т.п.</td></tr><tr><td>Дополнительные ресурсы</td><td>Ссылки на документацию, гайды, полезные материалы</td></tr><tr><td>Ошибки и их решения (опционально)</td><td>Частые проблемы и варианты их решения</td></tr></tbody></table>

## Создаём идеальный промпт с помощью ИИ

1. Находим доступную модель ИИ, в примере будем использовать [ChatGPT](https://chatgpt.com/)

   <figure><img src="/files/ZwYnZYxyyNBUf4Zb0Q5g" alt=""><figcaption></figcaption></figure>
2. Описываем свой workflow в n8n. Для лучшего понимания загружаем скриншот/json файл нашего workflow (можно воспользоваться [инструкцией](https://docs.nocodecloud.ru/n8n/import-i-eksport-shablonov)).
3. Отправляем ему структуру идеального промпта.

   <figure><img src="/files/jVMEWZnzei2FMxIEu695" alt=""><figcaption></figcaption></figure>
4. Просим его помочь составить идеальный промпт. Пример:

   *<mark style="color:$info;">Помоги мне составить идеальный промпт для моего ИИ Агента в n8n.</mark>*

   *<mark style="color:$info;">Я пришлю тебе скриншот/файл рабочего процесса и скриншот/файл с примерами идеальных промптов для ИИ агентов в n8n, чтобы ты понял контекст и структуру задачи.</mark>*

   *<mark style="color:$info;">Твоя задача — задать мне несколько уточняющих вопросов, чтобы точно понять, какую задачу должен решать мой ИИ агент и как он должен работать.</mark>*

   *<mark style="color:$info;">После этого, используя свои знания и полученную информацию, подготовь для меня оптимальный промпт для ИИ агента.</mark>*

   <figure><img src="/files/uFsxmFRTWrYYVf1qGzSm" alt=""><figcaption></figcaption></figure>
5. Он присылает следующий ответ:

   <figure><img src="/files/Rb46iYr9E1RqTCiXpCeg" alt=""><figcaption></figcaption></figure>
6. Отвечаем ему в следующем формате:

   <figure><img src="/files/WiHdDydmkWxj5DBs242Q" alt=""><figcaption></figcaption></figure>
7. Получаем результат:

   <figure><img src="/files/HgAY36N4wofmPo6HsBmv" alt=""><figcaption></figcaption></figure>
8. Просим его перевести наш промпт на английский язык, чтобы модель ИИ могла точнее интерпретировать задачу.

   <figure><img src="/files/6VzUAbo34EWkJMMgFaN8" alt=""><figcaption></figcaption></figure>
9. Следующим шагом нам нужно будет занести наш промпт в ноду **AI Agent** в n8n.

   <figure><img src="/files/3F8qyZR6MhoixNPzij8R" alt=""><figcaption></figcaption></figure>
10. Готово! Осталось сохранить и активировать наш workflow, и наш ИИ-ассистент готов.

    <figure><img src="/files/7ZHfYeLjFiQUWn3txPRU" alt=""><figcaption></figcaption></figure>

## Процесс тестирования

**Результат:** С первого ответа становится понятно, что промпт настроен корректно - бот представляется и уточняет, что готов помочь в создании инструкции.

<figure><img src="/files/frUcB3TujAQ5wJClxhPk" alt=""><figcaption></figcaption></figure>

**Просим написать инструкцию:**

<figure><img src="/files/4uqIa6MlecZ8Xet1TgNm" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/BECTeppdjbLfnz8l0oeS" alt=""><figcaption></figcaption></figure>

Бот с обновлённым промптом успешно выполнил задачу: он подробно расписал пошаговые действия, добавил необходимые ссылки и в целом отлично справился с инструкцией.
