ما الذي تفعله هذه المهارة

توفر هذه المهارة تطبيقاً متكاملاً لواجهة سطر أوامر Python وعميلاً برمجياً للتفاعل مع منصة Felo المفتوحة. تُبسّط عملية دمج قدرات الذكاء الاصطناعي المتقدمة من Felo، مع دعم كلٍّ من إكمالات المحادثة الأحادية وسير عمل بث Server-Sent Events (SSE) المعقدة.

لماذا تستخدم هذه المهارة

قد يكون تطبيق Felo API يدوياً أمراً صعباً، لا سيما عند التعامل مع مصافحة متعددة الخطوات مطلوبة لبث SuperAgent. تُغلّف هذه المهارة منطق إرسال طلبات POST إلى /v2/conversations وإدارة نافذة بث GET اللاحقة، مما يضمن تسليماً موثوقاً للنتائج التدريجية. كما تتولى المصادقة عبر متغيرات البيئة وتوفر أدوات تصحيح مدمجة لحمولات JSON وSSE، مما يوفر على المطورين ساعات من كتابة الكود النمطي.

الأدوات المدعومة

• Python 3.x
• Felo Open Platform API (v2)
• بروتوكولات SSE (Server-Sent Events) القياسية
• إعدادات Dotenv (ملف .env)

هيكل المخرجات

تُنتج المهارة استجابات منسّقة وواضحة للاستعلامات الأحادية، وبثاً فورياً في الطرفية للمهام الحوارية. صُمِّمت لتُستخدم سواء كأداة سطر أوامر مستقلة للاختبار أو كوحدة قابلة لإعادة الاستخدام ضمن وكلاء Python الخاصة بك.

## سير العمل 1. احصل على مفتاح API أولاً. - تشير الوثائق الرسمية إلى أن Chat API متاح مجاناً لفترة محدودة. - انتقل إلى `https://felo.ai` وأنشئ حساباً مجانياً إذا لزم الأمر. - بعد تسجيل الدخول، انقر على صورتك الرمزية، افتح `Settings`، ثم انتقل إلى تبويب `API Keys`. - انقر على `Create New Key`، ثم انسخ المفتاح المُنشأ واحفظه في مكان آمن. 2. عيّن `FELO_API_KEY`. - يُفضَّل استخدام متغيرات البيئة. - أو أنشئ ملف `.env` محلياً يحتوي على: ```bash FELO_API_KEY=your-felo-api-key