Il prompt del brief, costi e risoluzione dei problemi

“La differenza tra una rassegna stampa e un briefing è il giudizio: sapere cosa lasciare fuori. Il prompt è dove codifichi quel giudizio.”

Il prompt di sintesi

Tratta il prompt come un contratto: dichiara chi sei, cosa tenere, cosa scartare, e la forma esatta dell'output. Più la tua riga "cosa conta per me" è specifica, meno generico sarà il brief. Parti da questo e affinalo nel corso di una settimana:

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".

Le due righe che lavorano di più sono Who I am e What matters: trasformano un riassuntore in un filtro. "Drop the rest, silently" è ciò che impedisce al brief di elencare tutto quello che ha trovato solo per sembrare esaustivo.

Costi: è più economico di quanto sembri, ma sorveglia tre cose

• Brave: un brief al giorno è ben dentro il piano gratuito (2.000/mese). Ti avvicini al limite solo se segui molti argomenti o esegui più volte al giorno.
• Token Claude: l'input è il tuo prompt più i risultati di ricerca; l'output è breve. Un brief quotidiano con Sonnet è un costo piccolo. Usa Haiku per ridurlo ulteriormente se la qualità regge.
• Prompt caching: le tue istruzioni (il contratto qui sopra) sono identiche ogni giorno mentre cambiano solo i risultati. Marcare come cacheable il blocco stabile di istruzioni fa pagare il prefisso ripetuto a una frazione della tariffa di input, la leva singola più grande se lo esegui spesso o su molti argomenti. (Vedi la documentazione del caching dell'API per i moltiplicatori attuali.)

Risoluzione dei problemi: i fallimenti che accadono davvero

• Il brief scatta all'ora sbagliata. Lo Schedule Trigger usa il fuso orario dell'istanza: imposta `GENERIC_TIMEZONE` (self-host) o il fuso orario del Cloud, non solo l'espressione cron.
• Il file non compare mai in Obsidian. Quasi sempre un problema di percorso: l'ambito del Filesystem MCP non include la cartella, o un n8n containerizzato ha scritto dentro il container. Controlla il percorso assoluto e ogni montaggio di volume.
• Brave restituisce errori o niente. Pacchetto sbagliato (usa @brave/brave-search-mcp-server), header `X-Subscription-Token` mancante, o hai superato il limite di 1 q/s lanciando le query sugli argomenti una dietro l'altra; distanziale.
• Il brief è generico / elenca tutto. Il tuo prompt è troppo vago. Rendi "What matters" concreto e mantieni "drop the rest, silently".
• La chiamata a Claude fallisce. Controlla gli header (`x-api-key`, `anthropic-version: 2023-06-01`) e che l'ID del modello sia attuale.

Dove portarlo dopo

• Aggiungi altre fonti accanto a Brave (un nodo RSS, una API specifica) e uniscile prima del passaggio di sintesi.
• Consegna il brief dove lo vedrai: aggiungi un nodo Slack o email dopo la scrittura, così ti aspetta anche nella posta in arrivo.
• Aggiungi un secondo passaggio che collega il brief di oggi a quello di ieri, così l'agente segue le storie in corso, non solo istantanee.