Le prompt du brief, coûts et dépannage

“La différence entre une revue de presse et un briefing, c'est le jugement : savoir quoi laisser de côté. Le prompt est l'endroit où vous encodez ce jugement.”

Le prompt de synthèse

Traitez le prompt comme un contrat : dites qui vous êtes, quoi garder, quoi écarter, et la forme exacte de la sortie. Plus votre ligne « ce qui compte pour moi » est précise, moins le brief est générique. Partez de ceci et resserrez-le sur une semaine :

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

Les deux lignes qui font le plus de travail sont Who I am et What matters : elles transforment un résumeur en filtre. « Drop the rest, silently » est ce qui empêche le brief de lister tout ce qu'il a trouvé juste pour paraître exhaustif.

Coût : c'est moins cher qu'il n'y paraît, mais surveillez trois choses

• Brave : un brief par jour reste très loin de la limite du plan gratuit (2 000/mois). Vous ne vous en approchez que si vous surveillez beaucoup de sujets ou lancez plusieurs exécutions par jour.
• Tokens Claude : l'entrée est votre prompt plus les résultats de recherche ; la sortie est courte. Un brief quotidien avec Sonnet coûte peu. Utilisez Haiku pour réduire encore si la qualité tient.
• Prompt caching : vos instructions (le contrat ci-dessus) sont identiques chaque jour, seuls les résultats changent. Marquer le bloc d'instructions stable comme cachable facture le préfixe répété à une fraction du tarif d'entrée : c'est le plus gros levier si vous exécutez souvent ou sur de nombreux sujets. (Voir la doc de caching de l'API pour les multiplicateurs actuels.)

Dépannage : les pannes qui arrivent vraiment

• Le brief part à la mauvaise heure. Le Schedule Trigger utilise le fuseau de l'instance : réglez `GENERIC_TIMEZONE` (auto-hébergé) ou le fuseau du Cloud, pas seulement l'expression cron.
• Le fichier n'apparaît jamais dans Obsidian. Presque toujours un problème de chemin : le périmètre du Filesystem MCP n'inclut pas le dossier, ou un n8n conteneurisé a écrit dans le conteneur. Vérifiez le chemin absolu et tout montage de volume.
• Brave renvoie des erreurs ou rien. Mauvais package (utilisez @brave/brave-search-mcp-server), en-tête `X-Subscription-Token` manquant, ou vous avez déclenché la limite de 1 req/s en enchaînant les requêtes par sujet ; espacez-les.
• Le brief est générique / liste tout. Votre prompt est trop vague. Rendez « What matters » concret et gardez « drop the rest, silently ».
• L'appel à Claude échoue. Vérifiez les en-têtes (`x-api-key`, `anthropic-version: 2023-06-01`) et que l'identifiant de modèle est à jour.

Pour aller plus loin

• Ajoutez d'autres sources à côté de Brave (un nœud RSS, une API spécifique) et fusionnez-les avant l'étape de synthèse.
• Livrez le brief là où vous le verrez : ajoutez un nœud Slack ou email après l'écriture pour qu'il vous attende aussi dans votre boîte.
• Ajoutez une seconde passe qui relie le brief du jour à celui de la veille, pour que l'agent suive les histoires en cours, pas seulement des instantanés.