رسمي · مهارة وكيل سيناريوv1.0.0

حوّل وثائق API إلى دورة بدء سريع تنتهي عند أول استدعاء ناجح.

يترك المطورون واجهات برمجة التطبيقات (APIs) التي لا تُعيد نتيجة ناجحة في المرة الأولى بسرعة. حوّل وثائق API الخاصة بك وأدلّة SDK إلى دورة تفاعلية رقمية للبدء السريع للمطورين تأخذهم من بيانات الاعتماد إلى أول استدعاء ناجح لـ API — مع الحفاظ على الكود كما هو مذكور في وثائقك دون أي ابتكار. ومُوسومة بالإصدار وقابلة للأسئلة، بحيث تجيب الدورة التفاعلية عن الأسئلة اللاحقة التي لا تستطيع وثائقك الإجابة عنها.

استخدمه لـ: بدء سريع للمطورين؛ API درس تدريبي؛ SDK درس تدريبي؛ أول استدعاء ناجح لـ API

تثبيت المهارةجميع مهارات الوكلاء

عقد عام

نسخة المهارة
v1.0.0
التفويض
browser OAuth
التنفيذ
signed personwise CLI

تثبيت

أمر واحد. بدون حزم خاصة.

المهارة عامة وخفيفة الوزن ومُرقَّمة في GitHub. وتبقى محرك الدورات، وأذونات الوصول، والقواعد التجارية على PersonWise.

أمر واحد
$ npx skills add personwiseai/skills --skill personwise-developer-quickstart

تعمل نفس حزمة المهارة في مضيفي مهارات الوكلاء المتوافقة. وهي تتصل بنفس PersonWise من وكلاء API دون الحاجة إلى سير عمل مخصص للمضيف.

افحص المصدر العام في personwiseai/skills

سير العمل العام

دورة إنشاء الدورات الكاملة.

تنسِّق المهارة كامل عملية التأليف، بينما يعرِّف CLI الموقَّع ووكلاء API العمليات الموثوقة.

  1. 01

    إنشاء دورة من موضوع أو مواد

    عيِّن المتعلم، والنتيجة المتوقعة، وحدّ المصدر، واللغة، والطول، وبنيّة الدورة.

  2. 02

    راجع كل مرحلة من مراحل التأليف

    افحص المخططات، ونص الصفحات الظاهرة، والسرد الصوتي، والتوجيه البصري قبل التقدُّم.

  3. 03

    حسِّن دون إعادة البدء من الصفر

    حدِّث صفحات محددة، أو السرد الصوتي، أو خيارات المقدِّم، أو التخطيط، أو الصور المولَّدة.

  4. 04

    استأنف واكمل بأمان

    استمر في التشغيل المستدام، واستعد من الأعطال المدعومة، وأنهِ سير عمل نشر الدورات الاعتيادي.

اتصال OAuth واحد لكل مهارة PersonWise.

لا يطلب منك PersonWise أبدًا لصق مفتاح API أو رمز وصول. ويحتفظ الوكيل بحالتِه ومخزن اعتماداته الخاصة؛ فتختار منظمة واحدة وتُصرِّح مرة واحدة بسير عمل إنشاء الدورات الاعتيادي بالكامل.

  1. 01ثبِّت المهارة في مضيف وكيل متوافق.
  2. 02اطلب منه إنشاء دورة PersonWise أو العمل عليها. ويكتشف الوكيل وكيل API المحلي للسوق ويفتح تفويض PersonWise.
  3. 03سجِّل الدخول إلى PersonWise ، وراجع طلب الوصول بدقة، ثم وافق. ويستأنف الوكيل تلقائيًّا.

موارد وكيل API PersonWise

https://personwise.ai/api/agent

يجب أن يبدأ التفويض عبر OAuth داخل الوكيل حتى تعود عملية التفويض إلى نفس العميل. ولا تلصق أبدًا رمز تفويض أو رمز وصول في الدردشة.

التنفيذ المشترك

مهارات عديدة. وكيل واحد API طوال الوقت.

يُضيّق كل سيناريو مهارةٍ من سير العمل المتعلق بوظيفة محددة. وتشترك جميعها في نفس CLI ، والوكيل API ، ونموذج التفويض، وعقد قدرات إنشاء الدورات.

الموارد ذات الصلة

هل لا تزال تُقارن بين النهج المختلفة؟ إليك قراءتين موثوقتين حول مكان انطباق محرك الدورات.