Saltar al contenido
Capítulo 05 · 9 min

El prompt del brief, coste y resolución de problemas

El cableado está hecho; la calidad ahora vive casi por completo en el prompt. Un prompt flojo te da una lista de titulares, un servicio de recortes. Uno bueno filtra según tus criterios, elimina duplicados, ordena por importancia para ti y cita las fuentes. Este capítulo te da un prompt de partida, las palancas de coste y los modos de fallo que de verdad aparecen.

La diferencia entre un servicio de recortes y un briefing es el criterio: saber qué dejar fuera. El prompt es donde codificas ese criterio.

youintoThe brief promptTune + debugA useful brief
A clear prompt plus troubleshooting turns raw results into a useful brief.

El prompt de síntesis

Trata el prompt como un contrato: declara quién eres, qué conservar, qué descartar y la forma exacta de la salida. Cuanto más específica sea tu línea de "qué me importa", menos genérico será el brief. Parte de este y afínalo durante una semana:

textCopiar el prompt
You are my morning research analyst. Below are raw web search
results on the topics I track. Produce a 5-minute brief.

Who I am: [one line: your role and what you're trying to decide].
What matters: [2-4 concrete criteria, e.g. "funding rounds over $10M",
"shipping AI-security features", "regulatory moves in US/Canada"].

Rules:
- Keep only items that meet my criteria. Drop the rest, silently.
- Merge duplicates that cover the same event into one entry.
- Rank by importance to me, most important first.
- For each: one-line headline, two-sentence why-it-matters, and the
  source URL. No filler, no hedging, no "as an AI".
- If nothing meaningful happened, say so in one line. Don't pad.

Output: a markdown note titled "{{today}} Brief".

Las dos líneas que más trabajan son Who I am y What matters: convierten un resumidor en un filtro. "Drop the rest, silently" es lo que evita que el brief liste todo lo que encontró solo para parecer exhaustivo.

Coste: es más barato de lo que parece, pero vigila tres cosas

  • Brave: un brief al día queda muy dentro del plan gratuito (2.000/mes). Solo te acercas al límite si vigilas muchos temas o lo ejecutas varias veces al día.
  • Tokens de Claude: la entrada es tu prompt más los resultados de búsqueda; la salida es corta. Un brief diario con Sonnet es un coste pequeño. Usa Haiku para reducirlo más si la calidad aguanta.
  • Prompt caching: tus instrucciones (el contrato de arriba) son idénticas cada día y solo cambian los resultados. Marcar el bloque estable de instrucciones como cacheable cobra el prefijo repetido a una fracción de la tarifa de entrada, la mayor palanca si lo ejecutas a menudo o con muchos temas. (Consulta la documentación de caching de la API para los multiplicadores vigentes.)

Resolución de problemas: los fallos que de verdad ocurren

  • El brief se dispara a la hora equivocada. El Schedule Trigger usa la zona horaria de la instancia: configura `GENERIC_TIMEZONE` (autoalojado) o la zona horaria de Cloud, no solo la expresión cron.
  • El fichero nunca aparece en Obsidian. Casi siempre es un problema de ruta: el alcance del Filesystem MCP no incluye la carpeta, o un n8n en contenedor escribió dentro del contenedor. Revisa la ruta absoluta y cualquier montaje de volumen.
  • Brave devuelve errores o nada. Paquete equivocado (usa @brave/brave-search-mcp-server), falta la cabecera `X-Subscription-Token`, o pisaste el límite de 1 q/s al disparar consultas por tema seguidas; espácialas.
  • El brief es genérico / lo lista todo. Tu prompt es demasiado vago. Haz concreto el "What matters" y mantén el "drop the rest, silently".
  • La llamada a Claude falla. Revisa las cabeceras (`x-api-key`, `anthropic-version: 2023-06-01`) y que el ID de modelo esté vigente.

Adónde llevarlo después

  • Añade más fuentes junto a Brave (un nodo RSS, una API concreta) y fusiónalas antes del paso de síntesis.
  • Entrega el brief donde lo vayas a ver: añade un nodo de Slack o email después de la escritura para que también te espere en la bandeja de entrada.
  • Añade una segunda pasada que enlace el brief de hoy con el de ayer para que el agente siga historias en curso, no solo instantáneas.

Una línea por cada uno

  • La calidad vive en el prompt: declara quién eres, tus criterios concretos, "drop the rest silently", el orden y una forma de salida con fuentes.
  • Los costes son pequeños para un brief diario; usa prompt caching en las instrucciones estables si lo ejecutas a menudo o con muchos temas.
  • La mayoría de fallos son la zona horaria (hora equivocada), la ruta/alcance (el fichero no aparece), el paquete de Brave equivocado, el límite de 1 q/s o un prompt vago.
  • Amplía con más fuentes, entrega por Slack/email y seguimiento de historias día a día, pero afina el prompt antes de añadir nodos.
El prompt del brief, coste y resolución de problemas · Cours d'IA · SDEN