0Pricing
AI Prompt Engineering · Lección

Añadir detalles concretos

Números, nombres, formatos y ejemplos que orientan los resultados de la IA.

Añadir detalles concretos es una lección gratuita de AI Prompt Engineering en CoddyKit. Esta es la lección 3 de 4. Puedes leer la lección completa abajo gratuitamente — luego la practicas en el navegador con un editor de código integrado y un tutor de IA 24/7. Forma parte de la ruta de aprendizaje de AI Prompt Engineering, y tu progreso se sincroniza en la web y la app de CoddyKit. El curso de AI Prompt Engineering incluye 4 lecciones en total.

Los detalles concretos son puntos de referencia

Los detalles concretos son datos específicos, medibles y verificables. Fijan el resultado del modelo a su situación real, en lugar de permitir una interpretación genérica.

Sin puntos de referencia, el modelo genera contenido para el usuario promedio imaginario. Con puntos de referencia, genera contenido para usted.

El número de palabras como restricción concreta

El número de palabras es uno de los detalles concretos más sencillos y eficaces que puede añadir. Compare:

  • Vago: «Escriba una descripción breve»
  • Concreto: «Escriba una descripción de 75 palabras»

El modelo contará los tokens y procurará alcanzar su objetivo. Si se desvía ligeramente, puede pedirle que vuelva a contarlos con exactitud. El número de palabras elimina categorías completas de reescritura.

import anthropic

client = anthropic.Anthropic(api_key='sk-ant-your-key-here')

response = client.messages.create(
    model='claude-opus-4-5',
    max_tokens=200,
    messages=[{
        'role': 'user',
        'content': (
            'Write a product description for a noise-cancelling travel pillow in exactly 60 words. '
            'After the description, output the word count in parentheses on a new line.'
        )
    }]
)
print(response.content[0].text)

La audiencia objetivo como detalle concreto

Indicar una audiencia específica y concreta cambia drásticamente el vocabulario, los ejemplos y la profundidad del resultado.

  • Vago: «Explique las redes neuronales»
  • Concreto: «Explique las redes neuronales a un gerente de marketing de una empresa de la lista Fortune 500 que no tiene conocimientos de programación, pero entiende las tablas dinámicas de Excel»

El segundo prompt proporciona al modelo una imagen mental de un lector real y le permite ajustar perfectamente la complejidad.

import openai

client = openai.OpenAI(api_key='sk-your-key-here')

concrete_audience_prompt = (
    'Explain what a REST API is.\n\n'
    'Audience: a non-technical product manager who uses Salesforce daily '
    'and understands the concept of a form submission on a website. '
    'They will use this explanation to brief their engineering team tomorrow. '
    'Use one real-world analogy. Max 100 words.'
)

response = client.chat.completions.create(
    model='gpt-4o',
    messages=[{'role': 'user', 'content': concrete_audience_prompt}]
)
print(response.choices[0].message.content)

Entidades con nombre en lugar de generalizaciones

El uso de entidades con nombre —nombres reales de productos, empresas, personas y tecnologías, además de fechas— obliga al modelo a abandonar el terreno genérico.

  • Vago: «Escriba un análisis de la competencia»
  • Concreto: «Escriba un análisis de la competencia entre Notion, Obsidian y Roam Research para un usuario avanzado que gestiona un equipo remoto de 10 personas, escribe a diario y necesita acceso sin conexión»

Las entidades con nombre vinculan el modelo al conocimiento del mundo real que adquirió durante su entrenamiento.

import anthropic

client = anthropic.Anthropic(api_key='sk-ant-your-key-here')

response = client.messages.create(
    model='claude-opus-4-5',
    max_tokens=400,
    messages=[{
        'role': 'user',
        'content': (
            'Compare FastAPI vs Flask vs Django REST Framework '
            'for building a production API that will serve a React frontend. '
            'Context: 2-person startup team, Python 3.11, needs async support, '
            'expects < 50 ms response time, and will deploy on AWS Lambda. '
            'Format: 3-column markdown table with rows: setup complexity, '
            'async support, performance, learning curve, community size.'
        )
    }]
)
print(response.content[0].text)

Restricciones cuantitativas

Los números no son ambiguos. Siempre que tenga un requisito numérico, inclúyalo en el prompt:

  • Enumere exactamente N elementos (no «unos pocos» ni «varios»)
  • Número máximo o mínimo de palabras o caracteres
  • Porcentajes o proporciones específicos («70 % práctico, 30 % teórico»)
  • Restricciones de tiempo («explíquelo como si tuviera 3 minutos para leerlo»)
  • Objetivos de rendimiento («sugiera enfoques que logren una complejidad temporal O(n)»)
import openai

client = openai.OpenAI(api_key='sk-your-key-here')

response = client.chat.completions.create(
    model='gpt-4o',
    messages=[{
        'role': 'user',
        'content': (
            'Generate exactly 8 onboarding email subject lines for a B2B SaaS product. '
            'Requirements:\n'
            '- Exactly 8 lines, no more, no fewer\n'
            '- Each subject line between 40 and 60 characters\n'
            '- 4 must emphasize value, 4 must create urgency\n'
            '- Label each line: [VALUE] or [URGENCY]\n'
            '- No emojis\n'
            '- No duplicate words across all 8 lines'
        )
    }]
)
print(response.choices[0].message.content)

Contextualización basada en plazos y tiempo

Proporcionar un contexto temporal cambia la profundidad y el enfoque de los resultados. Indique al modelo cuándo se utilizará este contenido y las restricciones que eso implica:

  • «Este correo electrónico se enviará en 2 horas; manténgalo breve»
  • «Esto es para una presentación ante el consejo del lunes; utilice un lenguaje dirigido a ejecutivos»
  • «Esta explicación debe funcionar en una reunión diaria de 5 minutos»
  • «Escriba esto para un equipo que dispone de 10 minutos para revisarlo antes de la llamada con el cliente»
import anthropic

client = anthropic.Anthropic(api_key='sk-ant-your-key-here')

response = client.messages.create(
    model='claude-opus-4-5',
    max_tokens=256,
    messages=[{
        'role': 'user',
        'content': (
            'Write a project status update for our AI chatbot project. '
            'This will be read aloud at a 5-minute Monday morning stand-up. '
            'The audience has zero technical background. '
            'Talking time: max 2 minutes (approximately 300 words). '
            'Cover: what we shipped last week, one current blocker, one upcoming milestone. '
            'Tone: confident and factual. No jargon.'
        )
    }]
)
print(response.content[0].text)

Ejemplos específicos en el prompt

Incluir ejemplos específicos de lo que desea o de lo que no desea es una de las técnicas más eficaces. Los ejemplos enseñan simultáneamente el formato, la voz y el estilo.

Puede incluir:

  • Un ejemplo de la salida ideal (one-shot)
  • Varios ejemplos con etiquetas (few-shot)
  • Un ejemplo de lo que salió mal anteriormente (ejemplo negativo)
import openai

client = openai.OpenAI(api_key='sk-your-key-here')

prompt = '''
Write 3 feature announcement tweets for a new developer tool.

Here is an example of the style I want:
"We just shipped inline type errors in the editor. No more tab-switching to find 
what broke. Your flow stays unbroken. Try it now: [link]"

Characteristics of this style:
- Opens with what shipped, not with excitement words
- Describes the user benefit in the second sentence
- Ends with a CTA
- No hashtags. No emojis. Under 200 characters.

New feature: autocomplete that learns from your codebase.
'''

response = client.chat.completions.create(
    model='gpt-4o',
    messages=[{'role': 'user', 'content': prompt}]
)
print(response.choices[0].message.content)

Vocabulario específico del dominio

Incluir términos específicos del dominio indica al modelo el nivel de especialización que se espera en la salida.

  • «Explique el caching» → respuesta genérica
  • «Explique la política de expulsión LRU de Redis para un ingeniero de backend que está migrando de Memcached a Redis 7.x» → respuesta de nivel experto y centrada en el dominio

Utilice en el prompt el vocabulario de su campo y el modelo lo reflejará en la salida.

import anthropic

client = anthropic.Anthropic(api_key='sk-ant-your-key-here')

# Generic prompt vs domain-vocabulary prompt
generic = 'Explain caching strategies.'

domain_anchored = (
    'Compare write-through, write-behind, and cache-aside patterns '
    'for a microservices architecture using Redis 7.x as the cache layer and '
    'PostgreSQL 15 as the source of truth. '
    'Focus on consistency guarantees, latency tradeoffs, and failure modes. '
    'Audience: senior backend engineers familiar with CAP theorem.'
)

response = client.messages.create(
    model='claude-opus-4-5',
    max_tokens=400,
    messages=[{'role': 'user', 'content': domain_anchored}]
)
print(response.content[0].text)

Restricciones sobre lo que se debe excluir

Las restricciones negativas concretas (exclusiones) impiden que el modelo recurra a respuestas predecibles y genéricas:

  • «No sugiera soluciones que requieran una clave de API de pago»
  • «No mencione a competidores por su nombre»
  • «No utilice las palabras apalancamiento ni sinergia»
  • «No incluya contenido teórico; solo contenido práctico»
  • «Excluya los enfoques que requieran más de 5 minutos para implementarse»

Cada regla de exclusión mejora la precisión de la salida al eliminar una posibilidad más de generar contenido genérico.

import openai

client = openai.OpenAI(api_key='sk-your-key-here')

response = client.chat.completions.create(
    model='gpt-4o',
    messages=[{
        'role': 'user',
        'content': (
            'Suggest 5 ways to speed up a slow Python script. '
            'EXCLUDE:\n'
            '- Suggestions requiring third-party libraries (stdlib only)\n'
            '- Suggestions about hardware upgrades\n'
            '- Rewrites of the entire script\n'
            '- Suggestions that take more than 30 minutes to implement\n'
            'Each suggestion: one sentence describing what to do, one sentence on expected speedup.'
        )
    }]
)
print(response.choices[0].message.content)

Cómo integrarlo todo

Construyamos paso a paso un prompt completamente concreto. Partamos de: «Escriba una descripción de puesto».

  1. Añada el puesto: «Para un ingeniero sénior de machine learning»
  2. Añada una entidad con nombre: «en una startup de IA de Serie B en Londres»
  3. Añada el recuento de palabras: «de 350 a 400 palabras»
  4. Añada la audiencia: «para candidatos con más de 5 años de experiencia»
  5. Añada la estructura: «Formato: introducción, responsabilidades (8 viñetas), requisitos (5 viñetas), aspectos deseables (3 viñetas)»
  6. Añada la exclusión: «Sin clichés como “ritmo acelerado” o “apasionado”»
import anthropic

client = anthropic.Anthropic(api_key='sk-ant-your-key-here')

concrete_prompt = (
    'Write a job description for a Senior ML Engineer position '
    'at a Series B AI startup in London. '
    'Target candidate: 5+ years ML experience, strong Python, familiar with LLMs. '
    'Length: 350-400 words. '
    'Structure:\n'
    '1. 3-sentence company intro (no fluff — focus on product and mission)\n'
    '2. Responsibilities: exactly 8 bullet points\n'
    '3. Requirements: exactly 5 bullet points\n'
    '4. Nice-to-haves: exactly 3 bullet points\n'
    'EXCLUDE: phrases like "fast-paced", "passionate", "ninja", "rockstar", "self-starter".'
)

response = client.messages.create(
    model='claude-opus-4-5',
    max_tokens=600,
    messages=[{'role': 'user', 'content': concrete_prompt}]
)
print(response.content[0].text)

El hábito de enriquecer el prompt

Desarrolle el hábito de enriquecer cada prompt antes de enviarlo. Realice esta rápida revisión mental:

  1. ¿Puedo sustituir alguna palabra vaga por un número?
  2. ¿Puedo mencionar una herramienta, tecnología o persona específica?
  3. ¿Puedo describir la audiencia con mayor precisión?
  4. ¿Puedo añadir un ejemplo de lo que deseo?
  5. ¿Puedo añadir al menos una restricción de «no incluir»?
  6. ¿Puedo especificar el formato de salida con mayor precisión?

Incluso dos o tres mejoras enriquecedoras aumentan considerablemente la calidad de la salida.

# Prompt enrichment in code form: before/after comparison
before = 'Give me ideas for my presentation.'

after = (
    'Generate 6 opening hook ideas for a 15-minute conference talk '
    'titled "Why Your AI Prompts Are Failing You" at PyCon 2025. '
    'Audience: Python developers, mostly backend, some ML experience. '
    'Each hook: 2 sentences max. '
    'Mix: 2 provocative statistics, 2 counterintuitive questions, 2 short stories. '
    'EXCLUDE: "Did you know..." openers and rhetorical questions about the future of AI.'
)

print('BEFORE:', before)
print()
print('AFTER:', after)

Comprobación de conocimientos

Un fundador de una startup envía este prompt: «Ayúdeme a escribir contenido de marketing». ¿Qué prompt revisado utiliza los detalles concretos más eficaces?

Añadir detalles concretos: resumen

Los detalles concretos transforman los prompts vagos en instrucciones precisas. Utilice estas técnicas de contextualización:

  • Recuento de palabras: sustituya «corto/largo» por números exactos
  • Entidades con nombre: productos, herramientas, empresas y personas específicas
  • Audiencia: puesto, nivel de experiencia y conocimientos previos
  • Restricciones cuantitativas: exactamente N elementos, N % de cada tipo
  • Vocabulario del dominio: utilice los términos propios del campo para indicar la profundidad esperada
  • Ejemplos: muestre cómo es una buena salida
  • Exclusiones: indique qué debe evitar el modelo

Preguntas frecuentes

¿La lección «Añadir detalles concretos» es gratis?

Sí — el texto completo de «Añadir detalles concretos» es gratis para leer aquí en la web. Para practicarla de forma interactiva (editor de código integrado y tutor de IA 24/7) y desbloquear el resto del curso de AI Prompt Engineering, actualiza a CoddyKit PRO. El curso de AI Prompt Engineering incluye 4 lecciones en total.

¿Qué aprenderé en «Añadir detalles concretos»?

Números, nombres, formatos y ejemplos que orientan los resultados de la IA. Practicas AI Prompt Engineering con código real que ejecutas directamente en el navegador, y un tutor de IA 24/7 responde tus preguntas mientras trabajas en la lección.

¿Necesito experiencia previa para empezar AI Prompt Engineering?

No se requiere experiencia previa. AI Prompt Engineering en CoddyKit está estructurado para principiantes hasta estudiantes avanzados, así que puedes empezar aquí o desde el inicio y avanzar a tu ritmo. Esta es la lección 3 de 4.

¿Cuánto tiempo toma la lección «Añadir detalles concretos»?

La mayoría de las lecciones de CoddyKit toman alrededor de 5–10 minutos. Cada una es compacta e interactiva, así que avanzas constantemente y retomas exactamente por donde dejaste en la web y la app.

¿Puedo escribir y ejecutar código en esta lección de AI Prompt Engineering?

Sí. Cada lección de AI Prompt Engineering incluye un editor de código integrado, así que escribes y ejecutas código real directamente en tu navegador y obtienes retroalimentación instantánea de IA — sin configuración local necesaria.

Todas las lecciones de este curso

  1. Por qué es importante la especificidad
  2. Eliminar la ambigüedad de las instrucciones
  3. Añadir detalles concretos
  4. Comparación entre instrucciones vagas y específicas
← Volver a AI Prompt Engineering