الجزء الثالث · بناء

ابنِ الوكيل على جهازك

يضم الجزء الثالث تسع مراحل TypeScript إرشادية (0–8)، بالإضافة إلى مشروع نقل في المرحلة 9. تجعل هذه الصفحة الأدوات المحلية تعمل، وتثبت المرحلة 0 دون اتصال، ثم تسلّمك إلى المستودع من دون ادعاء أن الموقع يستطيع رؤية تقدّمك.

شغّل المرحلة 0 دون اتصال أولًا→افتح دورة TypeScript↗عُد إلى مختبر المتصفح

منصة انطلاق، لا IDE على الإنترنت

تبقى شيفرتك ومفاتيح نماذجك ومخرجاتك وتقدّمك في نسختك المحلية. لا يشغّل هذا الموقع الثابت الدورة ولا يقرأ course/progress.json.

الدورة نفسها بالإنجليزية. الموقع متاح بتسع لغات، لكن أدلة المراحل وقائمة المقهى وحالات الاختبار العشرين غير مترجمة: ترجمة المُدخلات المقيسة تغيّر التمرين نفسه، وهو السبب ذاته الذي يُبقي حالات المختبر بالإنجليزية.

قبل أن تبدأ

يمكنك قراءة TypeScript أساسية وتحريرها: الدوال، والكائنات، والحلقات، وawait.
لديك Git وNode.js 24، وطرفية، ومحرّر شيفرة.
خصّص نحو أربع ساعات للمراحل الإرشادية التسع (0–8)؛ مشروع النقل في المرحلة 9 مفتوح النهاية، ويمكنك التوقّف والعودة لاحقًا.

أنهيت المختبر؟ ستكون المراحل 1–4 مراجعة — هذه المرة تكتب الشيفرة بنفسك.

شغّل المرحلة 0 دون اتصال أولًا

1. استنسخ وثبّت
استنسخ المستودع العام، وادخل إليه، وثبّت الاعتماديات المقفلة بدقة.
يجلب هذا الاستنساخ والتثبيت الموقع كاملًا — مئات الميغابايتات، لأن الدورة تتشارك بيان الموقع نفسه. أمّا الدورة فتستورد حزمة واحدة. امنحها بضع دقائق على اتصال بطيء.
```
git clone https://github.com/HUDongpin/agent-edu.git
cd agent-edu
npm ci
```
2. أجرِ تعديل المرحلة 0 الوحيد
افتح course/stage0-hello/run.ts واستبدل سلسلة QUESTION الفارغة بسؤال من عندك.
```
export const QUESTION = "What should I notice about an API?";
```
3. شغّله وافحصه بلا مفتاح
يستخدم وضع دون الاتصال بديلًا حتميًا مضمّنًا ومكتوبًا مسبقًا. وهو فحص أولي أكثر أمانًا: بلا طلب إلى مزوّد، ولا تسجيل خاص، ولا رسم رموز.
```
npm run course:offline
npx tsx course/stage0-hello/run.ts --offline
npx tsx course/check.ts 0 --offline
```

ينجح الفحص حين ترى

PASS  you asked the model something
PASS  an answer came back

  stage 0 complete.

اختر مزوّدًا حين تكون مستعدًا فقط

وضع دون اتصال مكتوب مسبقًا

لا يحتاج مفتاحًا ولا يرسل طلبًا مدفوعًا. يثبت مسار الشيفرة، لكنه لا يستطيع إظهار تباين النموذج.

--offline

DeepSeek

المزوّد الحي الافتراضي. تقرأ عملية الطرفية DEEPSEEK_API_KEY؛ وتترتب على المراحل الحية رسوم DeepSeek وتطبع إنفاقها المقاس.

export DEEPSEEK_API_KEY=your_key_here

Claude

مزوّد محلي اختياري للمقارنة. اضبط المفتاح وCAFE_PROVIDER. قد تكون أسعار Claude أعلى بكثير، لذا افحص التقدير المطبوع قبل التشغيل.

export ANTHROPIC_API_KEY=your_key_here
export CAFE_PROVIDER=anthropic

التكاليف لدى المزوّد

وضع دون الاتصال مجاني. تتغير المجاميع الحية حسب النموذج المختار والرموز والذاكرة المخبأة وأسعار المزوّد الحالية. اعتبر أي تقدير في الدورة مؤرخًا؛ ولوحة المزوّد هي سجل الفوترة.

التقدّم يخص هذه النسخة

يكتب فاحص الدورة course/progress.json محليًا. ولا يستطيع الموقع رؤية ذلك الملف، فلا يعرض للجزء الثالث نسبةً ولا حالة «متابعة» — لا شيء سوى الملاحظة التي تدوّنها لنفسك أدناه.

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

لا شيء هنا يفحص عملك. فإن كنت قد أنهيت المراحل، فبإمكانك تدوين ذلك لنفسك. تبقى الملاحظة في هذا المتصفح، ولا تُرسل إلى أي جهة، ويمكنك إزالتها متى شئت.

ما الذي ستخرج به

تطلب منك المرحلة 9 تجاوز المقهى وتوثيق وكيل في مجال تعرفه. ويتضمن التسليم القابل للمراجعة:

حدود المسألة وما يُسمح للنموذج أن يقرره؛
مُدخل إخفاق واقعيًا واحدًا يكسر القواعد البسيطة؛
مجموعة Eval صغيرة مع أدلة، لا مخرجات جيدة منتقاة فقط؛
بوابة مفروضة بالشيفرة قبل الإجراء الأكثر تعذرًا على التراجع؛
حدود الثقة مع المزوّد والأداة والمدخلات غير الموثوقة؛
مراجعة لاحقة قصيرة للإخفاقات والمفاضلات والاختبار التالي.

إذا كان الإعداد المحلي شاقًا جدًا

عُد إلى مختبر المتصفح وتدرّب أولًا على القواعد ← المُوجّه ← Eval. فهو يعلّم تسليم التحكّم نفسه من دون مطالبتك بتثبيت بيئة تطوير.

عُد إلى مختبر المتصفح افتح دورة TypeScript↗