Напишіть промпт, який змусить агента створити інструмент: 3 частини

Ви попросили агента «зробити інструмент» і отримали щось невиразне, що не підходить до вашого застосунку. Рішення не в довшому промпті, а в промпті з трьома конкретними частинами: де живе інструмент, що він робить і конкретні деталі, які мають виконуватися. Очікуйте також більше одного раунду: навіть DeepSeek каже, що деякі з її демонстраційних плагінів доопрацьовувалися протягом кількох раундів розмови.

Більшість промптів у колекції DeepSeek для демонстраційного відео Harness Creator Mode мають цю тричастинну форму. Сторінка (колекція промптів Creator Mode від DeepSeek, перевірено 3 листопада 2026 року, дати публікації на сторінці немає) містить сім плагінів: 3D-галерея відомих пам'яток, 3D-візуалізація Transformer, піксельний інтерфейс DSH, робоче середовище для дизайну постерів, робоче середовище для редагування відео, читач статей і статистика розмов. Щоб скористатися одним із них, ви вставляєте промпт у DeepSeek Harness і вибираєте опцію Creator Mode. Кожен промпт подано англійською та китайською.

Як виглядають три частини в реальному промпті#

Візьміть промпт для 3D-візуалізації Transformer із цієї сторінки. Він починається з «Create a DeepSeek Harness plugin with a left sidebar entry». Це частина перша: де живе інструмент. Далі описується функція: інтерактивна 3D-демонстраційна гра, яка пояснює обчислення Transformer. Частина друга. Завершується вона вимогою, яку легко забути й неприємно виправляти потім: заголовок панелі та панель інструментів не повинні перекривати рідні кнопки вікна macOS. Частина третя.

Інші промпти на сторінці мають ту саму форму, але з відмінностями. Точка входу різна: бічна панель ліворуч у трьох із них, місце, доступне з розмови, у двох, права бічна панель у читачі статей. Наприкінці вони стають конкретними: п'ять стилів, один із них піксельний, або типова назва сторінки «Everything is a plugin». Це шаблон, який варто копіювати, і різниця видно швидко:

Перша версія змушує агента здогадуватися про все. Куди він іде? Бічна панель, команда, окреме вікно? Що вважається «для моїх розмов»? Друга відповідає на ці питання ще до того, як агент має їх поставити.

Напишіть свій, частина за частиною#

Припустімо, ви хочете невелику панель, яка читає статтю і дозволяє ставити щодо неї запитання. Пройдіть частини по черзі.

Де вона живе. Одне речення, і назвіть точне місце: «плагін із записом у лівій бічній панелі», «кнопка на панелі інструментів», «сторінка, що відкривається з меню». Якщо ви це пропустите, агент вибере за вас.

Що вона робить. Опишіть, що ви бачите й натискаєте, а не як це побудовано. «Ви кидаєте PDF, ліворуч показується текст, праворуч — чат про нього». Пропустіть фреймворк, якщо у вас немає причини його називати.

Конкретні вимоги. Сюди йде те, що минулого разу пішло не так. Правила компонування, те, що не повинно перекриватися, мова, формат файлу, обмеження на кшталт «без мережевих викликів». Короткі рядки, які можна перевірити. Якщо ви не можете сказати, чи виконано вимогу, дивлячись на результат, переписуйте її, доки не зможете.

Разом:

Create a plugin with a left sidebar entry.
It is a paper reader: I open a PDF, the text is shown
on the left, and a chat about the paper is on the right.
Requirements:
- the panel title must not overlap the window buttons
- the chat answers only from the paper's text
- keep everything in one file

Надішліть це через API#

Creator Mode — це функція DeepSeek Harness; сам промпт є звичайним текстом, тож будь-що, що читає промпт, може його виконати, зокрема скрипт, який викликає API CheapTokens. Промпт нижче — це той самий, що вище, надісланий до DeepSeek-V4-Flash (повний ідентифікатор deepseek-ai/DeepSeek-V4-Flash-0731, контекст 380K, до 32 768 токенів в одній відповіді, що залишає місце для цілого плагіна в одній відповіді):

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.cheaptokens.dev/v1",
    api_key=os.environ["CHEAPTOKENS_API_KEY"],
)

prompt = """Create a plugin with a left sidebar entry.
It is a paper reader: I open a PDF, the text is shown
on the left, and a chat about the paper is on the right.
Requirements:
- the panel title must not overlap the window buttons
- the chat answers only from the paper's text
- keep everything in one file"""

resp = client.chat.completions.create(
    model="deepseek-ai/DeepSeek-V4-Flash-0731",
    messages=[{"role": "user", "content": prompt}],
    max_tokens=8000,
)
print(resp.choices[0].message.content)
print(resp.choices[0].finish_reason, resp.usage)

Ключ зберігається у змінній середовища, ніколи у файлі. Якщо finish_reason виводить length, плагін було обрізано через max_tokens: підвищте ліміт. Налаштування самого DeepSeek Harness із власним провайдером — окрема задача, описана в підключенні DeepSeek Harness до CheapTokens. Основи першого запиту — у документації CheapTokens.

Чому одного промпту рідко достатньо#

DeepSeek каже це прямо: деякі з демонстраційних плагінів доопрацьовувалися протягом кількох раундів розмови, тож один промпт може не відтворити відео точно. Уявіть, що ви даєте інструкції підряднику. Перший кресленик дає вам більшу частину кімнати, і ви проходите нею й кажете «двері відчиняються не в той бік».

І саме тут витрачаються гроші. Агент надсилає розмову заново з кожним раундом (той самий ефект, що й у чому довгий чат коштує дорожче), тож п'ятий раунд несе промпт, чотири попередні відповіді та весь код на цей момент.

Скільки коштує сесія збірки#

Ось припущена сесія, а не вимірювання: п'ять раундів, близько 12 000 токенів надіслано за раунд (промпт, історія, поточний код) і близько 6 000 токенів записано у відповідь. У таблиці нижче використано актуальні ціни CheapTokens для кожної моделі; стовпець OpenRouter потрібен для порівняння тієї самої сесії загалом, з підрахунком вхідних і вихідних токенів разом.

Для одного раунду DeepSeek-V4-Flash ті самі числа дають $0.00078. Якщо ваш плагін більший, історія зростає з кожним раундом, тож змініть два числа й перезапустіть оцінку. Більше про оцінку рахунків агентів — у як оцінити вартість AI-агента, а список моделей — на сторінці цін.

Перевірте перед надсиланням#

Напишіть перший промпт, прочитайте, що повернеться, і додайте кожне виправлення до наступної версії вимог. Після двох-трьох сесій у вас буде короткий список рядків, які ви вставляєте в кожен новий промпт, і перший раунд виходитиме ближчим до задуманого. Про базові звички будь-якого промпту дивіться як написати хороший промпт.