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.
--offlineConstruire 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.
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.
Avant de commencer
- Vous savez lire et modifier du TypeScript simple : fonctions, objets, boucles et await.
- Vous disposez de Git, de Node.js 20.9 ou plus récent, d'un terminal et d'un éditeur de code.
- Prévoyez deux à trois heures pour les neuf étapes guidées (0 à 8) ; le projet de transfert de l'étape 9 est ouvert, et vous pouvez revenir plus tard.
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.
git clone https://github.com/HUDongpin/agent-edu.git cd agent-edu npm ci2. 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
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_hereClaude
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=anthropicLes 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 n'affiche ni pourcentage, ni état Reprendre ou Terminé pour la partie 3, car il ne peut pas observer ce fichier.
npx tsx course/report.ts
# reads course/progress.json in this cloneCe 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.