Atelier

Lesson 3 — Construire pas à pas

Les signaux structurés et le rapport hebdomadaire

6 min read

This content is not translated yet. Showing the original version.

Les signaux structurés et le rapport hebdomadaire

1. Un outil qui refuse les signaux sans preuve

files/veille.py
def enregistrer_signal(concurrent: str, categorie: Literal["prix", "lancement", "recrutement", "partenariat", "autre"],
                       resume: str, date_signal: str, source_ids: list[int], tool_context: ToolContext) -> dict:
    """Enregistre un signal concurrentiel vérifiable.

    Args:
        concurrent: nom de l'entreprise concernée.
        categorie: prix, lancement, recrutement, partenariat ou autre.
        resume: le fait en une phrase.
        date_signal: date du fait, AAAA-MM-JJ (ou AAAA-MM si le jour est inconnu).
        source_ids: identifiants des sources (champ "sources" renvoyé par chercheur_web).
    """
    connues = {s["id"] for s in tool_context.state.get("sources", [])}
    if not source_ids or not set(source_ids) <= connues:
        return {"erreur": f"source_ids doit citer des sources existantes parmi {sorted(connues)}"}
    signaux = list(tool_context.state.get("signaux", []))
    signaux.append({"concurrent": concurrent, "categorie": categorie, "resume": resume,
                    "date": date_signal, "sources": sorted(set(source_ids))})
    tool_context.state["signaux"] = signaux
    return {"ok": True, "nb_signaux": len(signaux)}
  • Le type Literal[...] devient une énumération dans la déclaration de l'outil : le modèle ne peut proposer qu'une des cinq catégories.
  • La vérification set(source_ids) <= connues (inclusion d'ensembles) refuse tout identifiant inventé. L'erreur renvoyée liste les identifiants valides : le modèle peut se corriger au tour suivant.
  • Les signaux et les sources vivent dans l'état de session (signaux, sources), pas dans le texte de la conversation : le rapport les relira tels quels.

Le modèle appelle enregistrer_signal avec source_ids=[2, 42] alors que seules les sources 1 à 19 existent. Que se passe-t-il ?

2. L'instruction du veilleur

files/veille.py
instruction="""Tu es analyste de veille concurrentielle. Pour CHAQUE concurrent de la demande :
1. Appelle chercheur_web avec une requête précise (nom + actualités + période demandée).
2. Pour chaque fait sur les prix, un lancement, des recrutements ou un partenariat, appelle
   enregistrer_signal en citant les sources de CE fait (champ faits_sources). Ignore les faits sans source.
Quand tout est enregistré, réponds par une synthèse de 3 à 5 phrases : tendances communes
et ce qu'il faudrait surveiller. Pas de liste de liens : le rapport les ajoute.""",

La demande elle-même est construite par le code à partir de concurrents.json et de la date du jour :

files/veille.py
demande = (f"Secteur : {config['secteur']}. Concurrents : {', '.join(config['concurrents'])}. "
           f"Période : les {config.get('jours', 7)} jours précédant le {jour.isoformat()}.")

3. Le rapport, écrit par du code

files/veille.py
def rediger_rapport(synthese: str, signaux: list[dict], sources: list[dict], jour: date) -> str:
    annee, semaine, _ = jour.isocalendar()
    lignes = [f"# Veille concurrentielle - semaine {semaine} ({annee})", "",
              f"_Généré le {jour.isoformat()} par un agent : à relire avant diffusion._", "",
              "## Synthèse", "", synthese.strip(), ""]
    for cat in CATEGORIES:
        du_type = sorted((s for s in signaux if s["categorie"] == cat), key=lambda s: s["date"], reverse=True)
        if du_type:
            lignes += [f"## {cat.capitalize()}", "", "| Date | Concurrent | Signal | Sources |", "|---|---|---|---|"]
            lignes += [f"| {s['date']} | {s['concurrent']} | {s['resume']} | "
                       f"{' '.join(f'[{i}]' for i in s['sources'])} |" for s in du_type]
            lignes.append("")
    cites = sorted({i for s in signaux for i in s["sources"]})
    lignes += ["## Sources", ""] + [f"{s['id']}. [{s['titre']}]({s['url']})" for s in sources if s["id"] in cites]
    return "\n".join(lignes) + "\n"
flowchart TB
  E["État de session : signaux + sources"] --> R["rediger_rapport"]
  Y["Synthèse (texte final du veilleur)"] --> R
  D["Date du jour : semaine ISO"] --> R
  R --> M["veille-2026-S42.md : Synthèse, Prix, Lancement, Recrutement, Partenariat, Autre, Sources"]
Partie du rapportProduite parGarantie
Synthèsele modèleà relire : c'est une interprétation
Tableaux de signauxle code, depuis l'étatchaque ligne a au moins une source vérifiée
Liste des sourcesle code, depuis les métadonnéesURL réellement consultées
Nom du fichierle code (semaine ISO)un fichier par semaine, S42 pour la semaine 42

La semaine ISO (norme ISO 8601) commence le lundi ; la semaine 1 est celle qui contient le premier jeudi de l'année. date(2026, 10, 15).isocalendar() donne la semaine 42.

Un signal mentionne une source que le modèle a citée mais qui n'apparaît dans aucun autre signal. Figure-t-elle dans la section Sources ?

Exercice : signaler les nouveautés

Modifiez la chaîne pour ne garder que les signaux absents du rapport de la semaine précédente (même concurrent, même résumé). Où placer ce filtre ?

Voir la solution

Dans le code, pas dans l'agent : ajoutez à lancer_veille un paramètre deja_vus: str = "" (le texte du rapport précédent) et filtrez juste avant rediger_rapport :

signaux = [s for s in etat.get("signaux", []) if s["resume"] not in deja_vus]
return rediger_rapport(synthese, signaux, etat.get("sources", []), jour), etat

Dans le bloc __main__, lisez le rapport de la semaine précédente :

annee, semaine, _ = jour.isocalendar()
precedent = ICI / "rapports" / f"veille-{annee}-S{semaine - 1:02d}.md"
deja_vus = precedent.read_text(encoding="utf-8") if precedent.exists() else ""
rapport, _ = asyncio.run(lancer_veille(config, jour, deja_vus=deja_vus))

Comparer des résumés en texte libre reste fragile (le modèle reformule d'une semaine à l'autre). Plus robuste : sauvegarder les signaux en JSON chaque semaine et comparer (concurrent, categorie, date), ou demander au modèle de juger la similarité. Attention au passage d'année (semaine 1 : la précédente est la 52 ou 53 de l'année d'avant).

Résultat obtenu

Extrait du rapport réel veille-2026-S42.md produit le 2026-10-15 (sortie brute de l'agent, non vérifiée signal par signal) :

# Veille concurrentielle - semaine 42 (2026)

_Généré le 2026-10-15 par un agent : à relire avant diffusion._

## Lancement

| Date | Concurrent | Signal | Sources |
|---|---|---|---|
| 2026-10-13 | Scaleway | Scaleway ouvre une nouvelle GPU Zone à Copenhague équipée de processeurs Nvidia B300 [...] | [4] [5] |

## Partenariat

| Date | Concurrent | Signal | Sources |
|---|---|---|---|
| 2026-10-13 | Scaleway | Scaleway s'associe à AMD pour déployer en Suède son premier supercalculateur d'IA [...] | [1] [2] [3] |

10 signaux enregistrés, 19 sources collectées, 13 citées.

Je sais faire

  • Écrire un outil qui valide les références avant d'enregistrer
  • Contraindre un paramètre d'outil avec Literal
  • Générer un rapport Markdown déterministe depuis l'état de session
  • Nommer les rapports par semaine ISO
Next