Partie 3 · Construire

Construire l'agent sur votre propre machine

La partie 3 comprend neuf étapes guidées en TypeScript (0 à 8), plus un projet de transfert à l'étape 9. Cette page prépare les outils locaux, vérifie l'étape 0 hors ligne, puis vous conduit au dépôt sans prétendre que le site peut voir votre progression.

Commencez par exécuter l'étape 0 hors ligne→Ouvrir le cours TypeScript↗Retourner à l'Atelier dans le navigateur

Un point de départ, pas un IDE en ligne

Votre code, vos clés de modèle, vos sorties et votre progression restent dans votre clone local. Ce site statique n'exécute pas le cours et ne lit pas course/progress.json.

Le cours lui-même est en anglais. Le site existe en neuf langues, mais les guides d'étape, la carte du café et les vingt cas de test ne sont pas traduits : traduire les entrées mesurées changerait l'exercice, pour la même raison que les cas de l'Atelier restent en anglais.

Avant de commencer

Vous savez lire et modifier du TypeScript simple : fonctions, objets, boucles et await.
Vous disposez de Git, de Node.js 24, d'un terminal et d'un éditeur de code.
Prévoyez environ quatre heures pour les neuf étapes guidées (0 à 8) ; le projet de transfert de l'étape 9 est à conclusion libre, et vous pouvez revenir plus tard.

L'Atelier est déjà fait ? Les étapes 1 à 4 seront une révision — cette fois, c'est vous qui écrivez le code.

Commencez par exécuter l'étape 0 hors ligne

1. Cloner et installer
Clonez le dépôt public, ouvrez-le et installez exactement les dépendances verrouillées.
Ce clone et cette installation récupèrent tout le site — plusieurs centaines de mégaoctets, parce que le cours partage le manifeste du site. Le cours lui-même importe un seul paquet. Comptez quelques minutes sur une connexion lente.
```
git clone https://github.com/HUDongpin/agent-edu.git
cd agent-edu
npm ci
```
2. Effectuer l'unique modification de l'étape 0
Ouvrez course/stage0-hello/run.ts et remplacez la chaîne QUESTION vide par votre propre question.
```
export const QUESTION = "What should I notice about an API?";
```
3. Exécuter et vérifier sans clé
Le mode hors ligne utilise un substitut déterministe fourni. C'est la vérification préalable la plus sûre : aucune requête au fournisseur, aucun enregistrement privé et aucuns frais de jetons.
```
npm run course:offline
npx tsx course/stage0-hello/run.ts --offline
npx tsx course/check.ts 0 --offline
```

La vérification réussit lorsque vous voyez

PASS  you asked the model something
PASS  an answer came back

  stage 0 complete.

Choisissez un fournisseur seulement lorsque vous êtes prêt

Mode hors ligne scénarisé

Ne nécessite aucune clé et n'effectue aucune requête payante. Il vérifie le chemin du code, mais ne peut pas montrer la variation du modèle.

--offline

DeepSeek

Le fournisseur en direct par défaut. Le processus de votre terminal lit DEEPSEEK_API_KEY ; les étapes en direct entraînent des frais DeepSeek et affichent la dépense mesurée.

export DEEPSEEK_API_KEY=your_key_here

Claude

Un fournisseur local facultatif pour comparer. Définissez la clé et CAFE_PROVIDER. Les tarifs de Claude peuvent être bien plus élevés : examinez donc l'estimation affichée avant l'exécution.

export ANTHROPIC_API_KEY=your_key_here
export CAFE_PROVIDER=anthropic

Les coûts relèvent du fournisseur

Le mode hors ligne est gratuit. Les totaux en direct varient selon le modèle choisi, les jetons, le cache et les tarifs actuels du fournisseur. Considérez toute estimation du cours comme datée ; le tableau de bord du fournisseur constitue le relevé de facturation.

La progression appartient à ce clone

Le vérificateur du cours écrit localement course/progress.json. Le site ne peut pas observer ce fichier : il n'affiche donc ni pourcentage, ni état Reprendre pour la partie 3, mais seulement la note que vous prenez vous-même ci-dessous.

npx tsx course/report.ts
# reads course/progress.json in this clone

Rien ici ne vérifie votre travail. Si vous avez terminé les étapes, vous pouvez le noter pour vous-même. Cette note reste dans ce navigateur, n'est envoyée nulle part, et vous pouvez la retirer à tout moment.

Ce que vous en retirerez

L'étape 9 vous demande de dépasser le cadre du café et de documenter un agent dans un domaine que vous connaissez. Une remise vérifiable comprend :

la frontière du problème et ce que le modèle est autorisé à décider ;
une entrée d'échec réaliste qui met en défaut les règles simples ;
un petit jeu d'évaluation avec des preuves, pas seulement de bonnes sorties sélectionnées ;
une barrière imposée par le code avant l'action la plus irréversible ;
les frontières liées au fournisseur, aux outils et aux entrées non fiables ;
une courte rétrospective sur les échecs, les compromis et le prochain test.

Si la configuration locale est trop difficile

Revenez à l'Atelier du navigateur et pratiquez d'abord règles → prompt → évaluation. Il enseigne le même transfert de contrôle sans vous demander d'installer un environnement de développement.

Retourner à l'Atelier dans le navigateur Ouvrir le cours TypeScript↗