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

Оптимальная длина промпта**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>

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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.nocodecloud.ru/ai/idealnyi-prompt-dlya-ii-agenta.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.