Écrire un prompt qui fait construire un outil à un agent : 3 parties

Vous avez demandé à un agent de « créer un outil », et vous avez obtenu quelque chose de vague qui ne correspond pas à votre application. La solution n'est pas un prompt plus long, c'est un prompt en trois parties précises : où vit l'outil, ce qu'il fait, et les détails concrets qui doivent être respectés. Attendez-vous aussi à plus d'un tour : même DeepSeek indique que certains de ses plugins de démonstration ont été affinés sur plusieurs tours de conversation.

La plupart des prompts de la collection DeepSeek pour la vidéo de démonstration du mode Creator présentent cette structure en trois parties. La page (collection de prompts du mode Creator de DeepSeek, consultée le 3 novembre 2026, aucune date de publication sur la page) liste sept plugins : une galerie 3D de monuments célèbres, une visualisation 3D de Transformer, une interface DSH pixelisée, un atelier de conception d'affiches, un atelier de montage vidéo, un lecteur d'articles et des statistiques de conversation. Pour en utiliser un, vous collez le prompt dans DeepSeek Harness et sélectionnez l'option Creator Mode. Chaque prompt est fourni en anglais et en chinois.

À quoi ressemblent les trois parties dans un vrai prompt#

Prenez le prompt de visualisation 3D de Transformer de cette page. Il commence par « Create a DeepSeek Harness plugin with a left sidebar entry ». C'est la première partie : où vit l'outil. Ensuite, il décrit la fonction : un jeu de démonstration 3D interactif qui explique le calcul de Transformer. Deuxième partie. Il se termine par une exigence facile à oublier et pénible à corriger plus tard : le titre du panneau et la barre d'outils ne doivent pas chevaucher les boutons natifs de la fenêtre macOS. Troisième partie.

Les autres prompts de la page suivent la même structure, avec des différences. Le point d'entrée varie : une entrée dans la barre latérale gauche dans trois d'entre eux, un emplacement accessible depuis la conversation dans deux, la barre latérale droite dans le lecteur d'articles. La fin est ce qui les rend concrets : cinq styles, dont un pixelisé, ou un titre de page par défaut « Everything is a plugin ». C'est le schéma à copier, et la différence se voit vite :

La première version laisse l'agent deviner tout. Où va-t-il ? Une barre latérale, une commande, une fenêtre séparée ? Qu'est-ce qui compte comme « pour mes conversations » ? La seconde répond à ces questions avant que l'agent ait à les poser.

Écrivez le vôtre, une partie à la fois#

Supposez que vous voulez un petit panneau qui lit un article et vous permet de poser des questions à son sujet. Parcourez les parties dans l'ordre.

Où il vit. Une phrase, et nommez l'endroit exact : « un plugin avec une entrée dans la barre latérale gauche », « un bouton dans la barre d'outils », « une page ouverte depuis le menu ». Si vous l'omettez, l'agent choisit pour vous.

Ce qu'il fait. Décrivez ce que vous voyez et cliquez, pas comment c'est construit. « Vous déposez un PDF, la gauche affiche le texte, la droite propose un chat à son sujet. » Omettez le framework sauf si vous avez une raison d'en nommer un.

Exigences concrètes. C'est là que vont les choses qui ont mal tourné la dernière fois. Règles de mise en page, éléments qui ne doivent pas se chevaucher, une langue, un format de fichier, une limite comme « aucun appel réseau ». Des lignes courtes et vérifiables. Si vous ne pouvez pas dire si une exigence a été respectée en regardant le résultat, réécrivez-la jusqu'à pouvoir le faire.

Assemblé :

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

Envoyez-le via l'API#

Creator Mode est une fonctionnalité de DeepSeek Harness ; le prompt lui-même est du texte brut, donc tout ce qui lit un prompt peut l'exécuter, y compris un script qui appelle l'API CheapTokens. Le prompt ci-dessous est celui ci-dessus, envoyé à DeepSeek-V4-Flash (id complet deepseek-ai/DeepSeek-V4-Flash-0731, contexte de 380K, jusqu'à 32 768 tokens en une réponse, ce qui laisse la place à un plugin entier en une seule réponse) :

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)

La clé va dans une variable d'environnement, jamais dans le fichier. Si finish_reason affiche length, le plugin a été coupé par max_tokens : augmentez la limite. Configurer DeepSeek Harness lui-même avec un fournisseur personnalisé est une tâche distincte, traitée dans connecter DeepSeek Harness à CheapTokens. Les bases de la première requête sont dans la documentation CheapTokens.

Pourquoi un seul prompt suffit rarement#

DeepSeek le dit clairement : certains des plugins de démonstration ont été affinés sur plusieurs tours de conversation, donc un seul prompt peut ne pas reproduire la vidéo exactement. Voyez cela comme un briefing à un entrepreneur. Le premier dessin vous donne l'essentiel de la pièce, puis vous la parcourez et dites « la porte s'ouvre dans le mauvais sens ».

Et c'est là que part l'argent. Un agent renvoie la conversation à chaque tour (le même effet que dans pourquoi un long chat coûte plus cher), donc le cinquième tour transporte le prompt, quatre réponses précédentes et tout le code produit jusqu'ici.

Combien coûte une session de construction#

Voici une session supposée, pas une mesure : cinq tours, environ 12 000 tokens envoyés par tour (prompt, historique, code actuel) et environ 6 000 tokens renvoyés. Le tableau ci-dessous utilise les prix CheapTokens en direct pour chaque modèle ; la colonne OpenRouter est là pour comparer la même session au total, entrée et sortie comptées ensemble.

Pour un tour DeepSeek-V4-Flash, les mêmes chiffres donnent $0.00078. Si votre plugin est plus gros, l'historique grandit à chaque tour, donc changez les deux nombres et relancez l'estimation. Plus sur l'estimation des factures d'agents dans comment estimer le coût d'un agent IA, et la liste des modèles est sur la page de tarifs.

Vérifiez avant d'envoyer#

Écrivez le premier prompt, lisez ce qui revient, et mettez chaque correction dans la version suivante des exigences. Après deux ou trois sessions, vous aurez une courte liste de lignes à coller dans chaque nouveau prompt, et le premier tour se rapprochera de ce que vous vouliez. Pour les habitudes de fond de tout prompt, voir comment écrire un bon prompt.