Escribe un prompt que haga que un agente construya una herramienta: 3 partes

Le pediste a un agente que "hiciera una herramienta" y obtuviste algo vago que no encaja con tu app. La solución no es un prompt más largo, sino un prompt con tres partes concretas: dónde vive la herramienta, qué hace y los detalles concretos que deben cumplirse. Además, cuenta con más de una ronda: incluso DeepSeek dice que algunos de sus plugins de demostración se refinaron a lo largo de varias rondas de conversación.

La mayoría de los prompts de la colección de DeepSeek para el vídeo de demostración de Harness Creator Mode muestran esa forma de tres partes. La página (colección de prompts de Creator Mode de DeepSeek, consultada el 3 de noviembre de 2026, sin fecha de publicación en la página) enumera siete plugins: una galería 3D de monumentos famosos, una visualización 3D de un Transformer, una interfaz DSH pixelada, un banco de trabajo de diseño de pósteres, un banco de trabajo de edición de vídeo, un lector de artículos y estadísticas de conversación. Para usar uno, pegas el prompt en DeepSeek Harness y seleccionas la opción Creator Mode. Cada prompt se ofrece en inglés y en chino.

Cómo se ven las tres partes en un prompt real#

Toma el prompt de visualización 3D de un Transformer de esa página. Empieza con "Create a DeepSeek Harness plugin with a left sidebar entry". Esa es la primera parte: dónde vive la herramienta. Luego describe la función: un juego de demostración 3D interactivo que explica el cálculo de un Transformer. Segunda parte. Termina con un requisito fácil de olvidar y molesto de corregir después: el título del panel y la barra de herramientas no deben solaparse con los botones nativos de la ventana de macOS. Tercera parte.

Los demás prompts de la página siguen la misma forma, con diferencias. El punto de entrada varía: una entrada en la barra lateral izquierda en tres de ellos, un punto al que se llega desde la conversación en dos, la barra lateral derecha en el lector de artículos. El final es donde se vuelven concretos: cinco estilos, uno de ellos pixelado, o un título de página predeterminado "Everything is a plugin". Ese es el patrón que merece la pena copiar, y la diferencia se nota rápido:

La primera versión deja al agente adivinando todo. ¿Dónde va? ¿Una barra lateral, un comando, una ventana aparte? ¿Qué cuenta como "para mis conversaciones"? La segunda responde a esas preguntas antes de que el agente tenga que hacerlas.

Escribe el tuyo, parte por parte#

Supón que quieres un panel pequeño que lea un artículo y te permita hacerle preguntas. Recorre las partes en orden.

Dónde vive. Una frase, y nombra el lugar exacto: "un plugin con una entrada en la barra lateral izquierda", "un botón en la barra de herramientas", "una página que se abre desde el menú". Si lo omites, el agente elige por ti.

Qué hace. Describe lo que ves y clicas, no cómo está construido. "Arrastras un PDF, el lado izquierdo muestra el texto, el lado derecho tiene un chat sobre él". Omite el framework salvo que tengas una razón para nombrar uno.

Requisitos concretos. Aquí es donde van las cosas que salieron mal la última vez. Reglas de diseño, cosas que no deben solaparse, un idioma, un formato de archivo, un límite como "sin llamadas de red". Líneas breves y verificables. Si no puedes saber si un requisito se cumplió mirando el resultado, reescríbelo hasta que puedas.

Todo junto:

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

Envíalo a través de la API#

Creator Mode es una función de DeepSeek Harness; el prompt en sí es texto plano, así que cualquier cosa que lea un prompt puede ejecutarlo, incluido un script que llame a la API de CheapTokens. El prompt de abajo es el de arriba, enviado a DeepSeek-V4-Flash (id completo deepseek-ai/DeepSeek-V4-Flash-0731, contexto de 380K, hasta 32.768 tokens en una respuesta, lo que deja espacio para un plugin entero en una sola respuesta):

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 clave va en una variable de entorno, nunca en el archivo. Si finish_reason imprime length, el plugin se cortó por max_tokens: sube el límite. Configurar DeepSeek Harness en sí con un proveedor personalizado es un trabajo aparte, cubierto en conectar DeepSeek Harness con CheapTokens. Lo básico de la primera petición está en la documentación de CheapTokens.

Por qué un solo prompt rara vez basta#

DeepSeek lo dice claramente: algunos de los plugins de demostración se refinaron a lo largo de varias rondas de conversación, así que un solo prompt puede no reproducir el vídeo exactamente. Piénsalo como dar instrucciones a un contratista. El primer plano te da la mayor parte de la habitación, y lo recorres y dices "la puerta abre hacia el lado equivocado".

Y ahí es donde se va el dinero. Un agente reenvía la conversación en cada ronda (el mismo efecto que en por qué un chat largo cuesta más), así que la quinta ronda lleva el prompt, cuatro respuestas anteriores y todo el código hasta el momento.

Cuánto cuesta una sesión de construcción#

Aquí hay una sesión supuesta, no una medición: cinco rondas, unos 12.000 tokens enviados por ronda (prompt, historial, código actual) y unos 6.000 tokens devueltos. La tabla de abajo usa los precios en vivo de CheapTokens para cada modelo; la columna de OpenRouter está para comparar la misma sesión en total, con entrada y salida contadas juntas.

Para una ronda de DeepSeek-V4-Flash los mismos números dan $0.00078. Si tu plugin es más grande, el historial crece en cada ronda, así que cambia los dos números y vuelve a ejecutar la estimación. Más sobre cómo estimar las facturas de agentes en cómo estimar el coste de un agente de IA, y la lista de modelos está en la página de precios.

Comprueba antes de enviar#

Escribe el primer prompt, lee lo que vuelve y pon cada corrección en la siguiente versión de los requisitos. Después de dos o tres sesiones tendrás una lista corta de líneas que pegas en cada nuevo prompt, y la primera ronda saldrá más cerca de lo que querías decir. Para los hábitos subyacentes de cualquier prompt, consulta cómo escribir un buen prompt.