تبقى الأوامر والشفرة بالإنجليزية في جميع اللغات. استبدل العناصر النائبة المكتوبة بالأحرف الكبيرة بقيم من حسابك والمهمة المدفوعة؛ ولا تضع مفاتيح حقيقية في دفاتر ملاحظات أو سجلات مشتركة.
رحلة التدريب
- الهدف حدّد المهمة ومعايير القبول
- المعلّم جهّز مواد مرجعية معتمدة
- المتعلّم درّب في بيئة التشغيل المختارة
- التقييم قارن بخط الأساس
- التسليم صدّر النموذج أو الموائم المستقل
الهدف: حدّد المهمة ومعايير القبول. المعلّم: جهّز مواد مرجعية معتمدة. المتعلّم: درّب في بيئة التشغيل المختارة. التقييم: قارن بخط الأساس. التسليم: صدّر النموذج أو الموائم المستقل
أين يجري العمل
- تطبيقك مفتاح API والهدف والمهمة المعتمدة
- FusionPointAI API الجلسة والوصول إلى المرجع والبيانات المعدّة
- بيئة التدريب SDK ونموذج المتعلّم وGPU
- الناتج المحلي حزمة النموذج وتقرير التقييم
تطبيقك: مفتاح API والهدف والمهمة المعتمدة. FusionPointAI API: الجلسة والوصول إلى المرجع والبيانات المعدّة. بيئة التدريب: SDK ونموذج المتعلّم وGPU. الناتج المحلي: حزمة النموذج وتقرير التقييم
من الهدف إلى نموذج مستقل
اختر خطة المزوّد والنموذج المرجعي، وحدد المهمة وأعدّ نموذج المتعلّم وبيئة التشغيل. يستطيع TrainingProject طلب مواد تدريب معتمدة من المعلّم، بينما تحمّل بيئة التشغيل المختارة نموذج المتعلّم وتحدّث أوزانه. الناتج نموذج مستقل أو موائم، وليس نسخة من أوزان المعلّم.
- ابدأ بهدف قابل للقياس مثل تصنيف المستندات الألمانية.
- افصل صلاحية الوصول إلى المعلّم ونموذج المتعلّم وبيئة التشغيل ومعايير التقييم.
- يظل TrainingClient متاحًا لسير عمل المهام والجلسات المدفوعة الحالية.
ثلاثة أجزاء وثلاث مسؤوليات
يتيح لك مفتاح API الوصول إلى الخدمة؛ لكنه ليس GPU. تنسّق API الجلسات والبيانات المهيأة والتقارير. وتوفّر بيئة التشغيل الذاكرة والتخزين والقدرة الحاسوبية. ينفّذ SDK التحسين محليًا ويجهّز الناتج. وقد تستضيفه FusionPointAI أو مركز البيانات لديك أو بيئة دفتر ملاحظات متوافقة.
- أبقِ بيانات الاعتماد خارج ملفات النماذج والحزم المُصدّرة.
- راجع الهدف ومواد التدريب التي تُرسل إلى المعلّم.
- تقرير اكتمال التدريب ليس شهادة مستقلة على جودة النموذج.
اختر مسار القراءة
يمكن للمستخدم الجديد قراءة Quickstart ثم Concepts وModels وDatasets وTraining وEvaluation بالترتيب. ويمكن لمن يدمجون النظام الانتقال مباشرةً إلى مرجعي API وPython. وعلى المشغّلين قراءة Recovery وRuntime deployment أيضًا.
- راجع الخطة قبل استخدام الحوسبة أو إرسال طلبات إلى المعلّم.
- احتفظ بخط أساس لم يُمسّ للمقارنة.
- لا تُصدّر إلا بعد مراجعة نتائج التدريب والتقييم.
مرجع API
| نقطة النهاية | الغرض والسلوك |
|---|---|
POST /api/v1/training/quotes
Authorization: Bearer ai:training |
تحقق من أهلية النموذج المرجعي والخطة والإعداد، ثم أعد معرّف UUID لعرض السعر والعملة والقيمتين fixed_total وexpires_at. استخدم الخطة المعتمدة وإعدادات المتعلّم المؤهلة، لا أسعارًا يحددها العميل من تلقاء نفسه.
|
GET /api/v1/training/jobs
Authorization: Bearer ai:training |
اعرض مهام العميل المصادَق عليه. افحص القائمة المعادة ومعرّفات الموارد بدل تخمين المعرّفات الرقمية. |
POST /api/v1/training/jobs
Authorization: Bearer ai:training |
أنشئ مهمة مملوكة للحساب انطلاقًا من معرّف UUID صالح لعرض السعر. تتضمن الاستجابة معرّف المهمة وحالتها ورقم الفاتورة والطوابع الزمنية؛ وإنشاء المهمة لا يثبت إتمام الدفع. |
GET /api/v1/training/jobs/{job}
Authorization: Bearer ai:training |
اقرأ مهمة واحدة مملوكة باستخدام معرّف UUID الخاص بها، بما يشمل التقدم المباشر وحالة التسليم. |
GET /api/v1/training/jobs/{job}/artifacts/{file}
Authorization: Bearer ai:training |
نزّل ملفًا منشورًا تابعًا لهذه المهمة المملوكة. لا يُرفع ملف ZIP المحلي لـ SDK تلقائيًا ولا يتاح عبر هذا المسار. |
POST /api/v1/training/sessions
Authorization: Bearer ai:training |
يتضمن متن الطلب معرّف UUID للمهمة وruntime وقيمة موجبة اختيارية لـreference_model_id. أعد الجلسة الجديدة أو المعاد استخدامها؛ ولا يُسمح بتغيير المرجع إلا قبل بدء الإعداد.
|
GET /api/v1/training/sessions/{session}
Authorization: Bearer ai:training |
اقرأ الجلسة المملوكة وإعداداتها ومجموعات بياناتها وتقريرها وحالتها. قراءة الحالة لا تبدأ التدريب. |
POST /api/v1/training/sessions/{session}/prepare
Authorization: Bearer ai:training |
أرسل كائن JSON فارغًا لطلب دفعة إعداد محدودة. كرر الطلب ما دام التقدم مستمرًا حتى الجاهزية، مع الالتزام بالحد المخصص للطلبات. |
GET /api/v1/training/sessions/{session}/datasets/{split}
Authorization: Bearer ai:training |
نزّل train أو validation بصيغة application/x-ndjson. تحقق من عدد البايتات وبصمة SHA-256 وعدد الصفوف بمقارنتها بملف بيان الجلسة.
|
POST /api/v1/training/sessions/{session}/events
Authorization: Bearer ai:training |
أبلغ عن حالة التشغيل الفعلية وstep وtotal_steps ومقاييس loss وeval_loss الاختيارية. استخدم قيم الحالة ورموز الخطأ المدعومة فقط.
|
POST /api/v1/training/sessions/{session}/complete
Authorization: Bearer ai:training |
أرسل artifact_name وتقرير التدريب الحقيقي كاملًا. تتحقق الخدمة من طريقة التدريب ومراجعة النموذج الأساسي وتغيّر الأوزان وبصمة الملف الناتج ومعايير التقييم.
|
POST /api/v1/training/sessions/{session}/cancel
Authorization: Bearer ai:training |
أرسل كائن JSON فارغًا لإلغاء حالة خدمة مؤهلة. أوقف عملية GPU المنفصلة بنفسك عند الحاجة؛ فهذا ليس إيقافًا مؤقتًا واستئنافًا. |
POST /api/v1/training/projects/authorize
Authorization: Bearer ai:training |
أرسل POST إلى /api/v1/training/projects/authorize مع provider وreference_model_id موجب. يعيد التحقق من صلاحية الحساب الموثّق للوصول إلى مرجع التدريب المدفوع، ويعيد المهمة المملوكة للحساب وgrant وprovider والنموذج المرجعي ووقت الانتهاء. لا ينشئ فاتورة ولا يغيّر دفعة.
|
POST /api/v1/training/projects/teacher
Authorization: Bearer ai:training |
أرسل POST إلى /api/v1/training/projects/teacher مع provider وreference_model_id وaction (curriculum أو lessons) وobjective وtopic اختياري وcount (من 1 إلى 4) وحتى ثمانية approved_examples (بحد أقصى 2,000 حرف لكل منها). يعيد موضوعات أو صفوف نصوص الدروس والموضوعات. أرسل مواد تدريب معتمدة فقط، ولا ترسل بيانات validation أو الاختبار النهائي.
|
الأسئلة الشائعة
هل يكفي هدف واحد لبدء سير العمل التلقائي؟
يمكنه بدء الإعداد. لكن التدريب الفعلي لا يبدأ إلا بعد استيفاء الأذونات المطلوبة والبيانات المعتمدة ونموذج الطالب المتوافق وعرض السعر الدقيق والدفع ومتطلبات التنفيذ.
هل أتسلّم الأوزان الأصلية للنموذج المرجعي؟
لا يعني ذلك نقلها تلقائيًا. يُدرّب نموذج العميل بصورة مستقلة، ويحدد عرض السعر المعتمد المُسلَّم وترخيصه.
هل سيكون الأداء مطابقًا للنموذج المرجعي؟
لا يوجد ضمان غير مشروط بذلك. تُقيّم أهداف القدرات المتفق عليها باستخدام معايير قياس موثقة، وتُبلَّغ النتائج المقاسة.
هل يلزمني شراء الاستضافة؟
لا، إذا كان المُسلَّم المعتمد نموذجًا قابلًا للتنزيل. وتُسعّر عمليات النشر المستضافة المدعومة بصورة منفصلة عن مشروع التدريب ذي التكلفة لمرة واحدة.
ماذا يحدث لإتاحة API المشمولة بعد ذلك؟
تنتهي عند نهاية فترة التدريب المسجلة. ويمكنك بعد ذلك اختيار اشتراك Unlimited API منفصل ومتاح.
هل تشمل خطة التدريب لدى المزوّد أكثر من نموذج مرجعي واحد؟
نعم. تشمل الخطة الواحدة جميع النماذج المرجعية المتاحة لدى المزوّد خلال مدة الدفع. يمكنك اختيار نموذج الجلسة أو تغييره قبل بدء إعداد مجموعة البيانات من دون اشتراك إضافي. ينتهي الوصول عند انتهاء صلاحيته ويمكن إلغاؤه قبل ذلك.