0Pricing
AI Prompt Engineering · Lección

Por qué es importante la especificidad

Cómo las instrucciones vagas producen resultados genéricos y cómo la precisión lo corrige.

Por qué es importante la especificidad es una lección gratuita de AI Prompt Engineering en CoddyKit. Esta es la lección 1 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.

El problema de la vaguedad

Cuando envía un prompt vago, la IA completa todos los detalles que faltan con su mejor suposición. Esas suposiciones se basan en la interpretación estadísticamente más común, no en su intención real.

El resultado es una respuesta genérica y fácil de olvidar que requiere una reescritura considerable. La especificidad es el factor individual más potente que tiene para mejorar la calidad de las respuestas de la IA.

Prompt vago: escriba sobre perros

Considere el prompt: «Escriba algo sobre perros».

El modelo debe adivinar: ¿qué formato?, ¿qué longitud?, ¿qué audiencia?, ¿qué enfoque? Como opción predeterminada, genera un párrafo neutro y poco concreto que podría encajar en una enciclopedia infantil.

Ahora compárelo con: «Escriba un pie de foto de 200 palabras para Instagram sobre el primer día en la playa de un cachorro de golden retriever. Tono: divertido y emotivo. Incluya 5 hashtags relevantes».

El segundo prompt no deja nada al azar.

import anthropic

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

vague = 'Write something about dogs.'
specific = (
    'Write a 200-word Instagram caption for a golden retriever puppy\'s '
    'first day at the beach. Tone: playful and emotional. '
    'End with 5 relevant hashtags.'
)

for label, prompt in [('VAGUE', vague), ('SPECIFIC', specific)]:
    response = client.messages.create(
        model='claude-opus-4-5',
        max_tokens=300,
        messages=[{'role': 'user', 'content': prompt}]
    )
    print(f'--- {label} ---')
    print(response.content[0].text)
    print()

Por qué se producen respuestas genéricas

El modelo se entrenó con miles de millones de ejemplos de texto. Cuando dice «escriba sobre X», genera el tipo de texto más común sobre X que vio durante el entrenamiento.

Este suele tener las siguientes características:

  • Tono enciclopédico
  • Longitud media
  • Cobertura superficial de todos los enfoques principales
  • Sin voz ni propósito distintivos

Sus restricciones específicas sustituyen estos valores predeterminados y orientan al modelo hacia su necesidad real.

import openai

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

# Default (vague) output
default_response = client.chat.completions.create(
    model='gpt-4o',
    messages=[{'role': 'user', 'content': 'Write about coffee.'}]
)
print('DEFAULT OUTPUT (first 200 chars):')
print(default_response.choices[0].message.content[:200])
print()

# Constrained output
constrained_response = client.chat.completions.create(
    model='gpt-4o',
    messages=[{
        'role': 'user',
        'content': (
            'Write a 100-word product description for a single-origin Ethiopian pour-over coffee. '
            'Target audience: specialty coffee enthusiasts. '
            'Tone: sophisticated, sensory. Mention flavor notes: jasmine, blueberry, dark chocolate.'
        )
    }]
)
print('CONSTRAINED OUTPUT:')
print(constrained_response.choices[0].message.content)

Las cinco dimensiones de la especificidad

Al escribir un prompt, especifique cinco dimensiones:

  1. Formato: párrafo, lista con viñetas, tabla, JSON, correo electrónico
  2. Longitud: número de palabras, número de oraciones, número de elementos
  3. Audiencia: quién leerá o utilizará esta respuesta
  4. Tono: formal, informal, técnico, persuasivo, empático
  5. Objetivo: qué se supone que debe lograr la respuesta

No siempre necesita las cinco, pero omitir cualquiera de ellas invita al modelo a hacer una suposición incorrecta.

import anthropic

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

# All 5 dimensions specified
response = client.messages.create(
    model='claude-opus-4-5',
    max_tokens=256,
    messages=[{
        'role': 'user',
        'content': (
            'Format: 3-bullet summary.\n'
            'Length: each bullet max 20 words.\n'
            'Audience: busy startup founders with no ML background.\n'
            'Tone: direct, no jargon.\n'
            'Goal: explain why fine-tuning an LLM is expensive.'
        )
    }]
)
print(response.content[0].text)

Vago frente a específico: solicitudes por correo electrónico

Veamos la redacción de correos electrónicos, una de las tareas más comunes para la IA.

Vago: «Escriba un correo electrónico para mi cliente».
El modelo no conoce al cliente, el tema, la relación, el objetivo ni el tono.

Específico: «Escriba un correo electrónico de 3 párrafos para un cliente B2B de SaaS (TechFlow Inc) que se retrasó 14 días en su pago. Tono: firme, pero cortés y profesional. Objetivo: solicitar el pago sin dañar la relación. Incluya una llamada a la acción específica con un plazo de 5 días».

import openai

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

specific_prompt = (
    'Write a 3-paragraph professional email to a B2B SaaS client (TechFlow Inc) '
    'who has a payment 14 days overdue. '
    'Tone: firm but courteous — preserve the business relationship. '
    'Include: acknowledgment of potential oversight, the overdue amount placeholder [AMOUNT], '
    'a payment link placeholder [LINK], and a 5-day deadline. '
    'Subject line included.'
)

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

Vago frente a específico: resumen

Incluso los resúmenes —que parecen sencillos— se benefician enormemente de la especificidad.

Vago: «Resuma este artículo»

Específico: «Resuma este artículo en exactamente 3 oraciones. Primera oración: hallazgo principal. Segunda oración: metodología utilizada. Tercera oración: implicación más significativa para los profesionales»

La versión con una estructura específica se puede utilizar de inmediato; la versión vaga requiere reformatearse.

import anthropic

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

article = (
    'Researchers at MIT have developed a new neural network architecture that achieves '
    '94% accuracy on medical image diagnosis, outperforming human radiologists by 7%. '
    'The model was trained on 2.4 million anonymized X-ray images and uses a novel '
    'attention mechanism that highlights regions of interest for clinician review. '
    'The team expects FDA clearance by Q3 2025 for use as a diagnostic aid, not replacement.'
)

specific_prompt = (
    f'Summarize the following article in exactly 3 sentences:\n'
    f'Sentence 1: main finding.\n'
    f'Sentence 2: methodology.\n'
    f'Sentence 3: key implication for clinicians.\n\n'
    f'Article:\n{article}'
)

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

Vago frente a específico: lluvia de ideas

Las instrucciones para generar lluvias de ideas son donde la vaguedad resulta más costosa: se obtiene una lista de ideas obvias y repetitivas.

Vago: «Deme ideas para mi aplicación»

Específico: «Deme 10 estrategias de monetización únicas para una aplicación de meditación B2C dirigida a profesionales urbanos de entre 25 y 35 años. Excluya los modelos de suscripción (ya tenemos uno). Exprese cada idea en una oración y ordénelas de mayor a menor riesgo»

import openai

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

specific_brainstorm = (
    'Generate 10 unique monetization strategies for a B2C meditation app '
    'targeting 25-35 year-old urban professionals. '
    'Exclude: subscription models (already implemented). '
    'Each strategy in one sentence. '
    'Order from most to least conventional. '
    'Label each with: CONVENTIONAL / EXPERIMENTAL / BOLD.'
)

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

Uso de ejemplos en los prompts

Una de las técnicas de especificidad más eficaces consiste en incluir directamente en el prompt ejemplos del resultado que desea (lo que se denomina prompting few-shot).

En lugar de describir el formato, muéstrelo. El modelo comprende de inmediato la estructura, la extensión y el tono a partir de un ejemplo real, a menudo con más claridad que mediante una descripción escrita.

import anthropic

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

example_prompt = '''
Generate 3 product taglines in this style:

Example 1: Notion — 'The all-in-one workspace where better thinking happens.'
Example 2: Figma — 'Design together. Ship faster.'
Example 3: Linear — 'The issue tracker you'll actually enjoy using.'

Product: A CLI tool that automatically writes Git commit messages by analyzing your diff.
Taglines:
'''

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

Especificar qué NO se debe hacer

Las restricciones negativas son tan eficaces como las positivas. Indicarle al modelo qué debe evitar ayuda a prevenir patrones no deseados habituales:

  • «No utilice viñetas»
  • «No empiece con la palabra Yo»
  • «No sugiera soluciones que requieran una tarjeta de crédito»
  • «No utilice la voz pasiva»

Combine instrucciones positivas con restricciones negativas para obtener el máximo control.

import openai

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

response = client.chat.completions.create(
    model='gpt-4o',
    messages=[
        {
            'role': 'system',
            'content': (
                'You are a copywriter. Rules:\n'
                '- NEVER start a sentence with "Additionally" or "Furthermore"\n'
                '- NEVER use the phrase "In conclusion"\n'
                '- NEVER use passive voice\n'
                '- NEVER use bullet points or lists'
            )
        },
        {
            'role': 'user',
            'content': 'Write a 100-word about us section for a craft bakery called Morning Light.'
        }
    ]
)
print(response.choices[0].message.content)

Especificidad iterativa

No tiene que escribir el prompt perfecto en el primer intento. El perfeccionamiento iterativo es una estrategia válida:

  1. Comience con un prompt moderadamente específico
  2. Identifique qué es incorrecto o qué falta en el resultado
  3. Añada restricciones para abordar esas carencias
  4. Repita el proceso hasta que el resultado cumpla sus estándares

Cada iteración le enseña qué restricciones necesita el modelo. Guarde sus mejores prompts como plantillas para utilizarlos en el futuro.

import anthropic

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

# Iteration 1: first attempt
v1 = 'Write a LinkedIn post about my new job.'

# Iteration 2: add specifics based on what was missing
v2 = (
    'Write a LinkedIn post (max 150 words) announcing I just joined Stripe as a Senior Engineer. '
    'Tone: genuine excitement, not bragging. '
    'Include: what drew me to the role, one thing I plan to focus on. '
    'No cliches like "excited to announce" or "humbled to share". '
    'End with a genuine question for my network.'
)

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

Creación de una lista de comprobación de especificidad

Antes de enviar cualquier prompt, repase mentalmente esta lista de comprobación:

  • ¿He especificado el formato de salida? (párrafo / lista / JSON / tabla)
  • ¿He especificado la extensión? (número de palabras / número de elementos)
  • ¿He especificado la audiencia? (quién leerá esto)
  • ¿He especificado el tono? (formal / informal / técnico)
  • ¿He especificado el objetivo? (para qué se utilizará este resultado)
  • ¿He incluido restricciones? (qué se debe evitar)
  • ¿Podría añadir un ejemplo para mostrar lo que quiero decir?
# Prompt template with all specificity dimensions filled
prompt_template = '''
Task: {task_description}
Format: {format}
Length: {length}
Audience: {audience}
Tone: {tone}
Goal: {goal}
Do NOT: {constraints}
Example of good output: {example}
'''

filled = prompt_template.format(
    task_description='Explain what an API is',
    format='3 short paragraphs, plain prose — no bullet points',
    length='150 words maximum',
    audience='Non-technical business stakeholders',
    tone='Friendly, analogy-based, jargon-free',
    goal='Prepare them for a meeting with the engineering team',
    constraints='Do not use the words "endpoint", "REST", or "HTTP"',
    example='An API is like a waiter in a restaurant — it takes your order...'
)
print(filled)

Comprobación de conocimientos

Un gerente de marketing le pide a la IA: «Escriba una publicación para redes sociales». La IA devuelve una publicación genérica de dos oraciones sobre la empresa. ¿Cuál es la MEJOR reformulación para obtener un resultado útil?

Por qué importa la especificidad: resumen

La especificidad es la base de la elaboración eficaz de prompts. Ideas clave:

  • Los prompts vagos producen resultados genéricos y estadísticamente promedio
  • Especifique el formato, la extensión, la audiencia, el tono y el objetivo en cada prompt
  • Utilice restricciones negativas para prevenir patrones no deseados
  • Incluya ejemplos del estilo de resultado que desea
  • Utilice el perfeccionamiento iterativo: ningún prompt tiene que ser perfecto en el primer intento
  • Guarde los prompts que dan buenos resultados como plantillas para reutilizarlos

Cuanto más específico sea, menos tiempo dedicará a reescribir el resultado.

Preguntas frecuentes

¿La lección «Por qué es importante la especificidad» es gratis?

Sí — el texto completo de «Por qué es importante la especificidad» 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 «Por qué es importante la especificidad»?

Cómo las instrucciones vagas producen resultados genéricos y cómo la precisión lo corrige. 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 1 de 4.

¿Cuánto tiempo toma la lección «Por qué es importante la especificidad»?

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