> ## Documentation Index
> Fetch the complete documentation index at: https://poehali.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Инженерия запросов

> Как составлять эффективные промпты

## Основы составления запросов

Умение правильно составлять запросы (промпты) к ИИ — ключевой навык для эффективной работы с платформой.

<Note>
  Промпт — это ваш запрос к искусственному интеллекту. От качества и точности запроса напрямую зависит результат, который вы получите.
</Note>

<AccordionGroup>
  <Accordion title="Базовые принципы эффективных запросов">
    * **Конкретность** — описывайте желаемый результат максимально точно
    * **Полнота** — указывайте все важные детали и контекст
    * **Структурированность** — выделяйте ключевые моменты, используйте списки
    * **Ясность** — избегайте двусмысленных формулировок

    <Tip>
      **Сравнение запросов:**

      ❌ **Неэффективно**: "Сделай сайт."\
      ✅ **Эффективно**: "Создай лендинг для кофейни с разделами: меню, локации, контакты и форма бронирования столика."

      ❌ **Неэффективно**: "Это не работает, почини!"\
      ✅ **Эффективно**: "На странице контактов не отправляется форма обратной связи. Проверь код отправки формы."
    </Tip>
  </Accordion>

  <Accordion title="Структура эффективного запроса">
    <Steps>
      <Step title="Контекст">
        Объясните, что вы хотите создать и для какой цели.

        <Tip>
          Я хочу создать сайт для своей фотостудии, чтобы привлекать новых клиентов.
        </Tip>
      </Step>

      <Step title="Конкретные требования">
        Перечислите необходимые функции и элементы.

        <Tip>
          Сайт должен включать: галерею работ, информацию об услугах с ценами, контактную форму и возможность записи на фотосессию.
        </Tip>
      </Step>

      <Step title="Стилистические предпочтения">
        Опишите, как должен выглядеть результат.

        <Tip>
          Стиль минималистичный, с черно-белой цветовой схемой и акцентами бирюзового цвета.
        </Tip>
      </Step>

      <Step title="Ограничения">
        Укажите, что следует учесть или избежать.

        <Tip>
          Сайт должен хорошо работать на мобильных устройствах. Не нужны анимации, чтобы фотографии загружались быстрее.
        </Tip>
      </Step>
    </Steps>
  </Accordion>

  <Accordion title="Техники улучшения запросов">
    <Steps>
      <Step title="Использование примеров">
        Приведите примеры желаемого результата для большей ясности.

        <Tip>
          Мне нужен сайт в стиле минимализм, как современные лендинги для IT-продуктов, с преобладанием белого цвета и синими акцентами.
        </Tip>
      </Step>

      <Step title="Поэтапный подход">
        Разбивайте сложные задачи на последовательные шаги.

        <Tip>
          Сначала создай главную страницу. После утверждения дизайна перейдем к странице каталога.
        </Tip>
      </Step>

      <Step title="Обратная связь">
        Оценивайте полученные результаты и корректируйте запросы.

        <Tip>
          В целом нравится, но увеличь размер шрифта заголовков и добавь больше пространства между секциями.
        </Tip>
      </Step>
    </Steps>
  </Accordion>

  <Accordion title="Запросы для сложных проектов">
    <Steps>
      <Step title="Начинайте с общего плана">
        Сначала определите основную структуру и функциональность.

        <Tip>
          Давай спланируем структуру сервиса аренды недвижимости.
          Какие основные разделы и функции должны быть на сайте?
        </Tip>
      </Step>

      <Step title="Переходите к деталям">
        После определения общей структуры, прорабатывайте ключевые компоненты.

        <Tip>
          Теперь детально проработаем страницу объявления. Она должна включать:

          * Фотогалерею
          * Характеристики объекта
          * Карту с расположением
          * Информацию о владельце
          * Возможность бронирования
        </Tip>
      </Step>

      <Step title="Уточняйте конкретные элементы">
        Детализируйте отдельные элементы интерфейса и функционала.

        <Tip>
          Доработай форму бронирования. Добавь выбор даты заезда/выезда,
          количество гостей и поле для сообщения владельцу.
        </Tip>
      </Step>
    </Steps>

    [//]: # "<Note>"

    [//]: # "**Важно!** При работе над сложными проектами сохраняйте промежуточные результаты через функцию истории версий."

    [//]: # "</Note>"
  </Accordion>
</AccordionGroup>

## Улучшение проекта

<AccordionGroup>
  <Accordion title="Исправление ошибок">
    ### Техники эффективной отладки

    <Steps>
      <Step title="Уточняйте проблему">
        Точно опишите, что именно не работает и в каком контексте.

        <Tip>
          На странице контактов не работает отправка формы.
          Проверь, правильно ли настроен обработчик события отправки.
        </Tip>
      </Step>

      <Step title="Спрашивайте о решениях">
        Ищите альтернативные подходы к реализации функционала.

        <Tip>
          Какие есть альтернативные способы реализации слайдера изображений
          без использования тяжелых библиотек?
        </Tip>
      </Step>

      <Step title="Используйте пошаговый подход">
        Разбивайте сложные проблемы на простые шаги.

        <Tip>
          Давай решать эту проблему постепенно:

          1. Сначала проверим правильность HTML-структуры
          2. Затем проверим стили CSS
          3. И наконец посмотрим JavaScript-функционал
        </Tip>
      </Step>
    </Steps>

    <Note>
      **Совет:** После исправления ошибки попросите ИИ объяснить, что было не так, чтобы в будущем вы могли избежать подобных проблем.
    </Note>
  </Accordion>

  <Accordion title="Оптимизация и улучшение">
    ### Шаблоны запросов для оптимизации

    * **Улучшение производительности**

          <Tip>
            Проанализируй код на наличие проблем с производительностью.
            Обрати внимание на:

            * Неоптимальные запросы к данным
            * Избыточные перерисовки компонентов
            * Тяжелые ресурсы (изображения, скрипты)
          </Tip>

    * **Улучшение пользовательского опыта**

          <Tip>
            Оцени пользовательский интерфейс с точки зрения удобства
            использования. Предложи улучшения для:

            * Навигации по сайту
            * Форм ввода данных
            * Мобильной версии
          </Tip>

    * **Улучшение кода**
          <Tip>
            Выполни рефакторинг этого компонента для улучшения
            читаемости и поддерживаемости. Соблюдай принципы
            чистого кода и следуй современным стандартам.
          </Tip>
  </Accordion>

  <Accordion title="Когда запрос не даёт желаемого результата">
    Если вы не получаете желаемый результат, попробуйте следующие стратегии:

    <Steps>
      <Step title="Уточните запрос">
        Добавьте больше деталей и контекста, используйте более конкретные формулировки.

        <Tip>
          Вместо "Сделай красивый сайт" используйте "Создай одностраничный сайт для кофейни с разделами меню, о нас и контакты, в теплых коричневых тонах".
        </Tip>
      </Step>

      <Step title="Дробите сложные запросы">
        Разбейте сложный запрос на несколько простых шагов.

        <Tip>
          Давай создадим сайт по частям. Сначала спроектируем главную страницу, затем добавим функционал каталога товаров, и в конце настроим корзину и оформление заказа.
        </Tip>
      </Step>

      <Step title="Используйте визуальные примеры">
        Прикрепите изображения для наглядного пояснения ваших идей.

        <Tip>
          Я прикрепляю фотографию интерьера, который мне нравится. Используй похожий стиль для дизайна веб-страницы.
        </Tip>
      </Step>
    </Steps>

    <Note>
      **Помните:** Искусственный интеллект — это инструмент, который учится понимать вас лучше с каждым взаимодействием. Чем больше вы с ним работаете, тем лучше он адаптируется к вашему стилю и требованиям.
    </Note>
  </Accordion>
</AccordionGroup>

## Примеры хороших запросов

<CodeGroup>
  ```prompt Запрос для нового проекта theme={null}
  Создай одностраничный сайт для кофейни "Утренний Аромат" со следующими разделами:

  1. Главный экран с приветствием и фотографией интерьера
  2. О нас - краткая история кофейни (основана в 2018 году, специализируется на спешиалти кофе)
  3. Меню - разделы: кофе, чай, десерты, завтраки
  4. Контакты и карта расположения (адрес: ул. Пушкина, 15)

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

  ```prompt Доработка существующего проекта theme={null}
  На текущем сайте нашего книжного магазина нужно доработать функционал корзины:

  1. Добавить возможность применения промокодов со скидкой
  2. Реализовать расчет стоимости доставки в зависимости от региона
  3. Добавить опцию "Купить в один клик" на странице товара

  Важно сохранить существующий дизайн и стилистику сайта.
  Текущая корзина использует локальное хранилище для хранения товаров.
  ```

  ```prompt Исправление ошибки theme={null}
  На странице каталога товаров не работает фильтрация по цене.
  При перемещении ползунка цены товары не фильтруются.

  Вот что я уже проверил:
  - Значения цены корректно отображаются при перемещении ползунка
  - В консоли нет ошибок JavaScript
  - Фильтрация по другим параметрам (категория, бренд) работает нормально

  Помоги найти и исправить проблему с фильтрацией по цене.
  ```
</CodeGroup>

## Советы

* **Будьте точными** — чем точнее запрос, тем точнее результат

* **Используйте списки** — это помогает ИИ лучше организовать ответ

* **Давайте обратную связь** — оценивайте результаты и уточняйте детали

* **Пробуйте разные подходы** — экспериментируйте с формулировками запросов