إعداد أدوات AI

Magpie

اضبط Magpie كبوابة للوصول إلى نماذج Felo API Platform حتى تقدّمها بوابته المحلية إلى Codex وClaude Code وغيرهما من الوكلاء.

استخدم هذا الدليل إذا كنت تستخدم Magpie — تطبيق شريط القوائم ذا البوابة المحلية الذي يجمع نماذج كل المزوّدين في قائمة واحدة لوكلاء البرمجة — وتريد إضافة نماذج Felo API Platform إلى تلك القائمة. يشغّل Magpie بوابة على 127.0.0.1:3425 ويعيد كتابة إعدادات كل وكيل ليمرّ عبرها، فلا يحتاج الوكيل أبدًا إلى مفتاح Felo أو عنوانه.

قبل أن تبدأ

تحتاج إلى مفتاح واحد من Felo API Platform. المفتاح نفسه يعمل مع بروتوكولات النماذج وعملاء الوكلاء وواجهات Search وWeb Fetch وPPT وMindmap وLiveDocs وX Search وYouTube Subtitling وLanding Page وSuperAgent.

export FELO_API_KEY="YOUR_API_KEY"

ثبّت Magpie إن لم يكن مثبتًا:

curl -fsSL https://usemagpie.ai/install.sh | sh

إضافة Felo كمزوّد

مفتاح Felo واحد يخدم Chat Completions وResponses وAnthropic Messages. أعطِ Magpie كل العناوين التي يمكنه استخدامها:

magpie provider add felo \
  url=https://openapi.felo.ai/api/v1 \
  responses=https://openapi.felo.ai/api/v1 \
  anthropic=https://openapi.felo.ai/api \
  key="$FELO_API_KEY"

في التطبيق، يقبل Providers → Add provider البيانات نفسها: الاسم felo والمفتاح وقاعدة OpenAI المتوافقة https://openapi.felo.ai/api/v1. أما المزوّد المتوافق مع Anthropic فيستخدم https://openapi.felo.ai/api.

بمجرد حفظ المفتاح، يطلب Magpie قائمة النماذج من Felo. تظهر في منتقي كل وكيل بصيغة felo/<model-id>.

magpie provider models felo   # إعادة جلب قائمة Felo
magpie models                 # ما يمكن للوكلاء اختياره، بما في ذلك felo/<model>

اختيار نموذج Felo داخل وكيل

magpie claude felo/claude-sonnet-5-5
magpie codex felo/gpt-5.6-sol

يمكنك الاختيار من صفحة Agents أيضًا. ولأن Felo يوفّر البروتوكولات الثلاثة كلها، يبقى كل وكيل على بروتوكوله — Claude Code على Anthropic Messages وCodex على Responses — وكلاهما يصل إلى Felo.

حقول العميل

الحقل	القيمة
اسم المزوّد / المعرّف	`felo`
قاعدة OpenAI Chat Completions	`https://openapi.felo.ai/api/v1`
قاعدة OpenAI Responses	`https://openapi.felo.ai/api/v1`
قاعدة Anthropic Messages	`https://openapi.felo.ai/api`
مفتاح API	`FELO_API_KEY` الخاص بك
النموذج	`felo/claude-sonnet-5-5`

التحقق من الإعداد

magpie provider test felo

يرسل Magpie طلبًا صغيرًا لكل بروتوكول ويبلغ عن زمن الاستجابة. بعد ذلك اطرح سؤالًا قصيرًا على وكيل محدد بنموذج felo/؛ فوصول الرد يعني أن المسار وكيل → بوابة Magpie → Felo يعمل.

استكشاف الأخطاء وإصلاحها

المشكلة	ما يجب فحصه
لا تظهر نماذج تحت `felo`	تحقّق من المفتاح ثم شغّل `magpie provider models felo`
`Model not found`	اكتب `felo/<model-id>` تمامًا كما يعرضه `magpie models`
فشل المصادقة	أعد إدخال المفتاح عبر `magpie provider key felo <key>`
فشل نداءات Anthropic	يجب أن تكون القاعدة `https://openapi.felo.ai/api` بدون `/v1`
يتجاهل Codex النموذج	أعد تشغيل Codex؛ فهو يقرأ قائمة النماذج عند البدء