Magpie

اگر از Magpie استفاده می‌کنید — اپلیکیشن نوار منو با درگاه محلی که مدل‌های همهٔ ارائه‌دهندگان را در یک فهرست برای عامل‌های کدنویسی جمع می‌کند — و می‌خواهید مدل‌های Felo API Platform را هم به آن فهرست اضافه کنید، از این راهنما استفاده کنید. Magpie درگاهی روی 127.0.0.1:3425 اجرا می‌کند و پیکربندی هر عامل را طوری بازنویسی می‌کند که از آن درگاه عبور کند؛ بنابراین عامل هرگز به کلید یا نشانی Felo نیاز ندارد.

پیش از شروع

به یک کلید از Felo API Platform نیاز دارید. همین کلید برای پروتکل‌های مدل، کلاینت‌های عامل و APIهای 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 می‌رسند.

فیلدهای کلاینت

بررسی راه‌اندازی

magpie provider test felo

Magpie برای هر پروتکل یک درخواست کوچک می‌فرستد و تأخیر را گزارش می‌کند. سپس پرسش کوتاهی از عاملی با مدل felo/ بپرسید؛ اگر پاسخ آمد، مسیر عامل → درگاه Magpie → Felo درست کار می‌کند.

عیب‌یابی

گام‌های بعدی

• شروع کار
• مرجع LLM API
• مدل‌ها و قیمت‌ها
• عیب‌یابی