إعداد وكيل API لـ MoltBot: دليل كامل في 3 خطوات للوصول إلى Claude Opus ونماذج لغة كبيرة متعددة

هل ترغب في ربط MoltBot بـ Claude Opus 4.5 أو غيره من نماذج اللغة الكبيرة، ولكنك لا تعرف كيفية تهيئة وكيل API؟ سيعلمك هذا المقال خطوة بخطوة كيفية إكمال تهيئة موفري خدمات متعددين (Multi-Provider Configuration) في MoltBot، مما يسمح لمساعدك الذكي بالوصول إلى خدمات نماذج متعددة في وقت واحد، وتحقيق التبديل الذكي والنسخ الاحتياطي للتعافي من الكوارث.

القيمة الجوهرية: بعد قراءة هذا المقال، ستتقن طريقة تهيئة models.providers في MoltBot، وتتعلم كيفية إعداد النموذج الأساسي، والنماذج الاحتياطية، والأسماء المستعارة للنماذج، لإنشاء مساعد ذكي مستقر وموثوق.

تكوين وكيل واجهة برمجة تطبيقات MoltBot: تحليل المفاهيم الأساسية

يدعم MoltBot الوصول إلى جميع خدمات نماذج اللغة الكبيرة الرائدة تقريبًا عبر واجهة برمجة تطبيقات متوافقة مع OpenAI. فهم المفاهيم الأساسية التالية هو مفتاح النجاح في عملية التكوين.

نظام ملفات تكوين MoltBot

الحقول الأساسية لتكوين الموفر (Provider) في MoltBot

يحتوي كل تكوين للموفر على الحقول الرئيسية التالية:

شرح أنواع بروتوكول واجهة برمجة التطبيقات

يدعم MoltBot بروتوكولين رئيسيين متوافقين مع OpenAI:

🎯 نصيحة التكوين: تستخدم معظم خدمات وكلاء واجهة برمجة التطبيقات (مثل APIYI apiyi.com) بروتوكول openai-completions. إذا كنت تستخدم LM Studio أو Ollama المنشور محليًا، فستحتاج إلى استخدام openai-responses.

تكوين موفرين متعددين في MoltBot: مثال كامل

فيما يلي مثال عملي لتكوين موفرين متعددين، يربط في نفس الوقت بين خدمتي APIYI وQwen Portal:

مثال كامل لملف التكوين

{
  "models": {
    "providers": {
      "qwen-portal": {
        "baseUrl": "https://portal.qwen.ai/v1",
        "apiKey": "${QWEN_API_KEY}",
        "api": "openai-completions",
        "models": [
          { "id": "coder-model", "name": "Qwen Coder", "contextWindow": 128000 },
          { "id": "vision-model", "name": "Qwen Vision", "contextWindow": 128000 }
        ]
      },
      "apiyi": {
        "baseUrl": "https://api.apiyi.com/v1",
        "apiKey": "${APIYI_API_KEY}",
        "api": "openai-completions",
        "models": [
          { "id": "claude-opus-4-5-20251101", "name": "Claude Opus 4.5", "contextWindow": 200000 },
          { "id": "claude-sonnet-4-20250514", "name": "Claude Sonnet 4", "contextWindow": 200000 },
          { "id": "gpt-4o", "name": "GPT-4o", "contextWindow": 128000 }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "apiyi/claude-opus-4-5-20251101",
        "fallbacks": ["qwen-portal/vision-model"]
      },
      "models": {
        "apiyi/claude-opus-4-5-20251101": { "alias": "opus" },
        "apiyi/claude-sonnet-4-20250514": { "alias": "sonnet" },
        "qwen-portal/coder-model": { "alias": "qwen" }
      }
    }
  },
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "${TELEGRAM_BOT_TOKEN}"
    }
  }
}

شرح تفصيلي لهيكل التكوين

1. قسم models.providers

هذا هو الجزء الأساسي لتعريف خدمات وكيل واجهة برمجة التطبيقات:

"providers": {
  "apiyi": {
    "baseUrl": "https://api.apiyi.com/v1",
    "apiKey": "${APIYI_API_KEY}",
    "api": "openai-completions",
    "models": [...]
  }
}

• معرف الموفر (apiyi): معرف خدمة مخصص يُستخدم عند الإشارة إليه لاحقًا.
• baseUrl: نقطة نهاية واجهة برمجة التطبيقات، ويجب أن تنتهي بـ /v1.
• apiKey: يدعم الإدخال المباشر للمفتاح أو استخدام متغيرات البيئة ${ENV_VAR}.
• models: قائمة النماذج التي يدعمها هذا الموفر.

2. قسم agents.defaults.model

يحدد النموذج الافتراضي المستخدم واستراتيجية التعافي من الكوارث (Failover):

"model": {
  "primary": "apiyi/claude-opus-4-5-20251101",
  "fallbacks": ["qwen-portal/vision-model"]
}

• primary: النموذج الأساسي، ويكون التنسيق هو provider-id/model-id.
• fallbacks: مصفوفة من النماذج الاحتياطية، حيث يتم التبديل إليها تلقائيًا في حال فشل النموذج الأساسي.

3. قسم agents.defaults.models

يحدد الأسماء المستعارة للنماذج لتسهيل التبديل السريع:

"models": {
  "apiyi/claude-opus-4-5-20251101": { "alias": "opus" },
  "qwen-portal/coder-model": { "alias": "qwen" }
}

بعد إعداد الأسماء المستعارة، يمكنك استخدام الأمر /model opus في المحادثة للتبديل السريع بين النماذج.

إعداد وكيل API لـ MoltBot: دليل خطوة بخطوة

الخطوة الأولى: الحصول على مفتاح API (API Key)

قبل البدء في الإعداد، تحتاج إلى تجهيز مفتاح API الخاص بك:

🚀 بداية سريعة: نوصي باستخدام APIYI (apiyi.com) كمزود خدمة أساسي (Provider)، حيث يتيح لك مفتاح API واحد استدعاء النماذج الرائدة مثل Claude وGPT وGemini دون الحاجة للتسجيل في منصات متعددة بشكل منفصل.

الخطوة الثانية: تعيين متغيرات البيئة

لدواعي الأمان، نوصي باستخدام متغيرات البيئة لتخزين مفاتيح API الخاصة بك:

# Linux/macOS - أضف إلى ملف ~/.bashrc أو ~/.zshrc
export APIYI_API_KEY="sk-your-apiyi-key"
export QWEN_API_KEY="your-qwen-key"
export TELEGRAM_BOT_TOKEN="your-telegram-token"

# تفعيل الإعدادات
source ~/.bashrc

# Windows PowerShell
$env:APIYI_API_KEY = "sk-your-apiyi-key"
$env:QWEN_API_KEY = "your-qwen-key"
$env:TELEGRAM_BOT_TOKEN = "your-telegram-token"

الخطوة الثالثة: تحرير ملف الإعدادات

افتح أو أنشئ ملف إعدادات MoltBot:

# فتح ملف الإعدادات
nano ~/.moltbot/moltbot.json

# أو باستخدام VS Code
code ~/.moltbot/moltbot.json

قم بلصق الإعدادات التالية في الملف:

{
  "models": {
    "providers": {
      "apiyi": {
        "baseUrl": "https://api.apiyi.com/v1",
        "apiKey": "${APIYI_API_KEY}",
        "api": "openai-completions",
        "models": [
          {
            "id": "claude-opus-4-5-20251101",
            "name": "Claude Opus 4.5",
            "contextWindow": 200000
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "apiyi/claude-opus-4-5-20251101"
      }
    }
  }
}

الخطوة الرابعة: التحقق من الإعدادات

أعد تشغيل MoltBot وتحقق مما إذا كانت الإعدادات قد دخلت حيز التنفيذ:

# إعادة تشغيل MoltBot
moltbot restart

# التحقق من إعدادات النماذج الحالية
moltbot models list

# اختبار استدعاء النموذج
moltbot chat "مرحباً، من فضلك أخبرني ما هو موديلك؟"

{
  "models": {
    "mode": "merge",
    "providers": {
      "apiyi": {
        "baseUrl": "https://api.apiyi.com/v1",
        "apiKey": "${APIYI_API_KEY}",
        "api": "openai-completions",
        "models": [
          {
            "id": "claude-opus-4-5-20251101",
            "name": "Claude Opus 4.5",
            "contextWindow": 200000,
            "maxTokens": 32000
          },
          {
            "id": "claude-sonnet-4-20250514",
            "name": "Claude Sonnet 4",
            "contextWindow": 200000,
            "maxTokens": 64000
          },
          {
            "id": "gpt-4o",
            "name": "GPT-4o",
            "contextWindow": 128000,
            "maxTokens": 16384
          },
          {
            "id": "gemini-2.5-pro",
            "name": "Gemini 2.5 Pro",
            "contextWindow": 1000000,
            "maxTokens": 65536
          }
        ]
      },
      "qwen-portal": {
        "baseUrl": "https://portal.qwen.ai/v1",
        "apiKey": "${QWEN_API_KEY}",
        "api": "openai-completions",
        "models": [
          {
            "id": "coder-model",
            "name": "Qwen Coder",
            "contextWindow": 128000
          },
          {
            "id": "vision-model",
            "name": "Qwen Vision",
            "contextWindow": 128000
          }
        ]
      },
      "local-ollama": {
        "baseUrl": "http://localhost:11434/v1",
        "apiKey": "ollama-local",
        "api": "openai-responses",
        "models": [
          {
            "id": "llama3.3:70b",
            "name": "Llama 3.3 70B",
            "contextWindow": 128000
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "apiyi/claude-opus-4-5-20251101",
        "fallbacks": [
          "apiyi/claude-sonnet-4-20250514",
          "qwen-portal/vision-model",
          "local-ollama/llama3.3:70b"
        ]
      },
      "models": {
        "apiyi/claude-opus-4-5-20251101": {
          "alias": "opus",
          "params": { "temperature": 0.7 }
        },
        "apiyi/claude-sonnet-4-20250514": {
          "alias": "sonnet",
          "params": { "temperature": 0.5 }
        },
        "apiyi/gpt-4o": {
          "alias": "gpt"
        },
        "qwen-portal/coder-model": {
          "alias": "qwen"
        },
        "local-ollama/llama3.3:70b": {
          "alias": "llama"
        }
      },
      "imageModel": "apiyi/gpt-4o"
    }
  },
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "${TELEGRAM_BOT_TOKEN}"
    },
    "discord": {
      "enabled": false,
      "token": "${DISCORD_BOT_TOKEN}"
    }
  }
}

💡 نصيحة للإعداد: استخدام "mode": "merge" يسمح لك بالاحتفاظ بإعدادات النماذج المدمجة في MoltBot مع إضافة مزودي الخدمة المخصصين لديك. بهذه الطريقة، حتى إذا كانت الخدمة المخصصة غير متوفرة، يمكن للنظام العودة إلى الإعدادات الافتراضية.

إعدادات نموذج MoltBot: تفاصيل المعلمات المتقدمة

الحقول الكاملة لإدخالات النموذج

إعداد معلمات النموذج (params)

يمكنك تعيين معلمات افتراضية لكل نموذج في agents.defaults.models:

"models": {
  "apiyi/claude-opus-4-5-20251101": {
    "alias": "opus",
    "params": {
      "temperature": 0.7,
      "maxTokens": 16000
    }
  }
}

⚠️ ملاحظة: temperature هي معلمة متقدمة. ما لم تكن على دراية بالإعدادات الافتراضية للنموذج وبحاجة فعلاً لتعديلها، نوصي بعدم تعيينها.

إعدادات تجاوز الفشل (Fallback) في MoltBot

تُعد آلية تجاوز الفشل (Fallback) ميزة هامة في MoltBot، حيث تضمن بقاء المساعد الذكي متاحاً للعمل دائماً.

آلية عمل الـ Fallback

طلب المستخدم
    ↓
النموذج الأساسي (primary)
    ↓ (في حال الفشل)
النموذج الاحتياطي 1 (fallbacks[0])
    ↓ (في حال الفشل)
النموذج الاحتياطي 2 (fallbacks[1])
    ↓ (في حال الفشل)
... الاستمرار في المحاولة

استراتيجيات تكوين الـ Fallback الموصى بها

الإعداد الموصى به:

"model": {
  "primary": "apiyi/claude-opus-4-5-20251101",
  "fallbacks": [
    "apiyi/claude-sonnet-4-20250514",
    "apiyi/gpt-4o",
    "qwen-portal/vision-model"
  ]
}

💰 تحسين التكلفة: عبر تكوين الـ Fallback من خلال APIYI (apiyi.com)، يمكنك التبديل تلقائياً بين عدة نماذج مع الاستفادة من نظام دفع موحد، مما يسهل إدارة التكاليف والتحكم بها.

تبديل النماذج في MoltBot: نصائح عملية

استخدام الأسماء المستعارة (Aliases) للتبديل السريع

بعد إعداد الأسماء المستعارة، يمكنك التبديل بين النماذج في أي وقت أثناء المحادثة:

أنت: /model opus
MoltBot: تم التبديل إلى Claude Opus 4.5

أنت: /model sonnet
MoltBot: تم التبديل إلى Claude Sonnet 4

أنت: /model qwen
MoltBot: تم التبديل إلى Qwen Coder

تخصيص نموذج لمهمة محددة

أنت: /model gpt ساعدني في تحليل هذه الصورة
MoltBot: [يتم تحليل الصورة باستخدام GPT-4o...]

أنت: /model opus اكتب لي مقالاً تقنياً عميقاً
MoltBot: [يتم الكتابة باستخدام Claude Opus...]

عرض حالة النموذج الحالي

# عرض القائمة عبر سطر الأوامر
moltbot models list

# التحقق أثناء المحادثة
أنت: /model
MoltBot: النموذج الحالي: apiyi/claude-opus-4-5-20251101 (الاسم المستعار: opus)

تكوين وكيل واجهة برمجة تطبيقات MoltBot: الأسئلة الشائعة

{
  "models": {
    "mode": "merge",
    "providers": {
      "local-ollama": {
        "baseUrl": "http://localhost:11434/v1",
        "apiKey": "ollama-local",
        "api": "openai-responses",
        "models": [...]
      },
      "apiyi": {
        "baseUrl": "https://api.apiyi.com/v1",
        "apiKey": "${APIYI_API_KEY}",
        "api": "openai-completions",
        "models": [...]
      }
    }
  }
}

"agents": {
  "defaults": {
    "model": {
      "primary": "apiyi/claude-opus-4-5-20251101"
    },
    "imageModel": "apiyi/gpt-4o",
    "models": {
      "apiyi/claude-opus-4-5-20251101": { "alias": "opus" },
      "apiyi/gpt-4o": { "alias": "vision" }
    }
  }
}