Lección 01

Qué es un prompt (y por qué casi nadie lo entiende)

Antes de optimizar nada, entendamos qué pasa de verdad cuando le hablas a un modelo. Sin metáforas vagas, con la mecánica real.

La frase que cambia todo

Un LLM no entiende tu pregunta. Predice el siguiente token (≈ trozo de palabra) más probable, dado los anteriores. Es una calculadora de probabilidades sobre texto.

Cuando entiendas esto literalmente, vas a empezar a hacer mejores prompts. Porque el truco no es “hablarle bonito”, es construir un contexto que haga inevitable la respuesta que quieres.

El mejor prompt no es el que pide más. Es el que deja menos espacio a la ambigüedad.

Anatomía de una petición a la API

Mira la llamada mínima a Claude:

import Anthropic from "@anthropic-ai/sdk";

const client = new Anthropic();

const res = await client.messages.create({
  model: "claude-opus-4-7",
  max_tokens: 1024,
  messages: [
    { role: "user", content: "Explica qué es un LLM en una frase." },
  ],
});

console.log(res.content[0].text);

Tres piezas, sólo tres:

1. model — qué cerebro vas a usar. Más grande ≠ siempre mejor.
2. messages — el historial. Cada mensaje tiene role (user o assistant) y content.
3. max_tokens — el techo de respuesta. Si lo pones bajo, te corta.

Tu primer experimento

Cambia la pregunta tres veces y observa cómo varía la salida.

const prompts = [
  "Explica qué es un LLM.",
  "Explica qué es un LLM como si yo tuviera 10 años.",
  "Explica qué es un LLM en exactamente 12 palabras, sin metáforas.",
];

for (const p of prompts) {
  const res = await client.messages.create({
    model: "claude-haiku-4-5",
    max_tokens: 200,
    messages: [{ role: "user", content: p }],
  });
  console.log("→", p);
  console.log(res.content[0].text);
  console.log("---");
}

El modelo es el mismo. La diferencia entre las tres respuestas es todo el valor que vas a aprender a controlar en este curso.

Errores típicos del principiante

• “Hazlo bien” → ¿bien para quién? Sé concreto sobre el público y formato.
• “Sé creativo” → ya lo es; lo que necesitas es restringir, no liberar.
• Mensajes de 800 palabras → más texto ≠ mejor respuesta. Más texto = más coste y más ruido.

Reto de esta lección

Reescribe este prompt malo para que devuelva exactamente lo que pide:

Dame ideas de negocio

Pista: especifica sector, presupuesto, número de ideas y formato de salida. En la siguiente lección verás la anatomía completa de un buen prompt.