Работа в песочнице промптов

Обновлено 11 июля 2025

В личном кабинете Studio вы можете проверить, как ваши промпты работают с различными моделями и их параметрами. Это позволит отладить промпт перед его использованием в приложении.

Для отладки промптов используйте раздел Playground (песочницу) в личном кабинете.

Чтобы открыть песочницу:

1. Авторизуйтесь в Studio .
2. Откройте проект GigaChat API.
3. В левой панели выберите раздел Playground.

Откроется интерфейс песочницы.

При работе с промптами в разделе Playground расходуются ваши токены.

Подготовка промпта

Чтобы подготовить промпт:

1. Нажмите кнопку Создать и укажите название промпта в поле Новый промпт.

   Понятное название поможет быстро найти промпт среди сохраненных в вашей библиотеке.

2. Укажите системный промпт. Для этого:

   1. Нажмите Системная инструкция.

   2. Установите флажок Указать системную инструкцию.

   3. В открывшемся поле укажите системный промпт.

      Системный промпт — описание поведения модели, которое она будет придерживаться при генерации ответов. Подробное руководство по составлению системных промптов — в разделе Основы промпт-инжиниринга.

      Вы можете доработать промпт с помощью GigaChat, для этого нажмите кнопку Улучшить. Промпт будет дополнен уточнениями и сохранится автоматически.

      Пример улучшения системного промпта

      Исходный промпт:

      Ты — профессиональный переводчик на английский язык. Переведи точно сообщение пользователя.

      После улучшения:

      ### Роль:
      Ты – профессиональный переводчик с русского языка на английский.
      
      ### Задача:
      Перевести сообщение пользователя на английский язык с максимальной точностью, учитывая контекст, стиль и смысл оригинального текста.
      
      #### Инструкции:
      1. Внимательно прочитай оригинальное сообщение.
      2. Определите контекст и стилистику текста (неформальный, официальный, технический и т.д.).
      3. Переводи с сохранением оригинальной идеи и тона.
      4. При необходимости адаптируйте фразы так, чтобы они звучали естественно на английском языке.
      5. Следи за грамматикой, орфографией и пунктуацией.
      
      #### Формат ответа:
      Отправляй переведенный текст без дополнительных комментариев.
      
      #### Пример:
      *Оригинал:* Привет! Как твои дела сегодня?
      *Перевод:* Hi! How are you doing today?
      
      #### Примечание:
      Если возникают трудности с переводом какого-либо термина или выражения, используй справочные материалы или словари.

3. Если нужно, добавьте в контекст несколько сообщений с разными ролями с помощью кнопки +. Модель будет учитывать предварительно переданные сообщения при генерации ответа.

   Добавить несколько сообщений можно только до запуска диалога.

Добавление файлов

При генерации ответов модели могут использовать текстовые файлы и изображения.

Чтобы использовать файлы для генерации, предварительно загрузите их в хранилище с помощью кнопки Добавить файл.

Хранилище поддерживает файлы:

• текстовые документы форматов txt, doc, docx, pdf, epub, ppt, pptx;
• изображения в форматах jpg, png, tiff и bmp;
• аудиофайлы в форматах mp4, mp3, m4a, wav, weba, ogg, opus.

На размеры файлов действуют ограничения:

• максимальный размер одного аудиофайла в запросе — 35 Мб;
• максимальный размер одного изображения в запросе — 15 Мб;
• максимальный размер одного текстового файла в запросе — 40 Мб.

Чтобы добавить файл в контекст разговора:

1. Нажмите кнопку Добавить файл, чтобы открыть хранилище файлов.

2. Нажмите Загрузить файлы, чтобы выбрать и загрузить файлы с вашего локального компьютера.

   Файлы будут загружены в хранилище

3. Выберите файлы, которые нужно добавить в контекст, и нажмите Добавить.

Настройка среды

В разделе Настройки вы можете подготовить среду, в которой должен работать промпт.

Для этого:

1. В блоке Основные, в раскрывающемся списке Модель выберите модель, которая будет обрабатывать запросы.

   Подробное описание моделей — в разделе Модели GigaChat.

2. В блоке Дополнительные задайте параметры выбранной модели.

   В процессе настройки вы можете:

   • изменить температуру;

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

     Значение по умолчанию зависит от выбранной модели и может изменяться в диапазоне от 0 до 2 включительно.

   • Задать параметр top_p;

     Параметр используется как альтернатива температуре (поле temperature). Задает вероятностную массу токенов, которые должна учитывать модель. Так, если передать значение 0.1, модель будет учитывать только токены, чья вероятностная масса входит в верхние 10%.

     Значение по умолчанию зависит от выбранной модели (поле model) и может изменяться с обновлениями модели.

     Значение изменяется в диапазоне от 0.01 до 1 включительно.

   • ограничить максимальное число токенов в ответе модели;

   • отключить фильтр безопасности. Отключение фильтра позволит проверять запросы, которые содержат тематические ограничения. Использовать параметры могут только юридические лица. Более подробную информацию вы можете получить по почте.

3. Чтобы вернуть настройки по умолчанию, нажмите Сбросить.

Проверка промпта

После создания промпта и подготовки среды, напишите сообщение для модели и нажмите Отправить и запустить (или Запустить, если вы подготовили историю сообщений при создании промпта).

После запуска модель вернет результат генерации с учетом системного промпта и переданной истории сообщений.

Если результат работы промпта вас устроил:

• нажмите Сохранить промпт, чтобы сохранить подготовленный промпт в библиотеке. Сохранение также выполняется автоматически, если вы не работаете с промптом в течение одной минуты.

• нажмите Добавить в избранное, чтобы отображать лучшие промпты в начале списка, в библиотеке.

• нажмите Код, чтобы просмотреть код запроса с промптом на одном из доступных языков: Python, Go, JavaScript, Ruby, C#, PHP, Java, Powershell.

  Некоторые примеры кода на Python и JavaScript используют библиотеки GigaChain.

Чтобы посмотреть расход токенов на отправленные сообщения, нажмите кнопку Обновить рядом с полем Токены в блоке Основные.

Вы можете в любой момент менять любые сообщения в диалоге с моделью. Для этого выберите сообщение, которое нужно изменить, нажмите кнопку Редактировать и укажите нужный текст.

Экспорт и импорт промптов

Вы можете сохранять промпты в формате JSON и загружать готовые промпты в песочницу.

Для экспорта:

1. Нажмите кнопку ....

2. В раскрывающемся списке выберите пункт Экспорт/Импорт.

3. В открывшемся окне нажмите Скачать промпт.

   Промпт со всеми настройками будет сохранен на ваш компьютер в формате JSON. Пример экспортированного промпта:

   {
    "title": "Новый промпт",
    "useSystem": true,
    "system": "### Роль для модели\nТы помощник, способный давать ясные и полезные ответы на запросы пользователей. Однако иногда пользователи предоставляют недостаточно информации для понимания того, чего они хотят достичь. Когда такое происходит, твоя роль заключается в том, чтобы задавать дополнительные вопросы и получать необходимую информацию прежде чем отвечать на основной вопрос.\n\n### Задача\nПользователь предоставил запрос \"Ты пёс\". Это предложение само по себе недостаточно информативно для того, чтобы определить конкретную задачу или проблему, требующую решения. Ты должен задать уточняющие вопросы, чтобы лучше понять намерения пользователя и только потом создавать полноценный system prompt.\n\n#### Инструкция\n1. Определите цель сообщения (\"Ты пёс\"). Является ли это приветствием, вопросом, утверждением или другим типом высказывания?\n2. Поинтересуйтесь, какое поведение или реакцию от вас ожидает пользователь после этого заявления.\n3. Получив дополнительную информацию, используйте ее для корректировки своего поведения и подготовки подходящего ответа.\n\n#### Формат ответа\nИспользуйте вежливый тон и задавайте открытые вопросы, позволяющие пользователю предоставить больше информации.\n\n*Пример диалога:*\nВход: \"Ты пёс\"\nВыход: \nПривет! Интересно, что ты имел в виду, говоря \"Ты пёс\"? Хочешь пошутить, спросить что-то или просто сообщить мне о своем настроении? Дай немного больше информации, пожалуйста!\n\n#### Примечания\nЕсли пользователь продолжит предоставлять недостаточную информацию, продолжай мягко запрашивать подробности до тех пор, пока не сможешь четко понять задачу.\n\n## Критерии качества\n- Ясность вопросов для дополнительного выяснения\n- Использование открытых вопросов для получения необходимой информации\n- Способность адаптироваться к полученным данным и корректировать свое поведение соответственно\n- Полезность и практичность полученных дополнительных данных для дальнейшей работы",
    "messages": [
        {
            "created_at": 1752060702,
            "role": "user",
            "content": "Привет!\nКак дела?"
        },
        {
            "role": "assistant",
            "created_at": 1752061073,
            "content": "Привет! У меня всё отлично, спасибо, что спросил. А у тебя как настроение? Что планируешь делать сегодня?"
        }
    ],
    "censor": true,
    "model": "GigaChat-2-Max",
    "useTemperature": false,
    "useTopP": false,
    "useMaxTokens": false
   }

Для импорта:

1. Нажмите кнопку ....

2. Перетащите готовый промпт в формате JSON в специальную область на экране.

   После загрузки промпт можно редактировать и использовать в песочнице.