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

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

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

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

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

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

قبل أن تبدأ

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

شغّل المرحلة 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↗