AI Agents
استخدام SeedRouter من وكلاء الذكاء الاصطناعي
اربط وكلاء البرمجة ومساعدي الذكاء الاصطناعي بـSeedRouter عبر خادم MCP أو مهارة الوكيل أو واجهة HTTP API، وتعرّف على الحدود التي ينبغي أن يراعيها الوكيل.
يمكن للوكيل استخدام SeedRouter بثلاث طرق. تشترك جميعها في مفتاح API والرصيد والنماذج والحدود نفسها، وتُحتسب رسومها بالطريقة نفسها.
| الطريقة | الأنسب لـ | الإعداد |
|---|---|---|
| خادم MCP | Claude Code وCursor وCodex وVS Code وعملاء MCP الآخرين | أضف https://api.seedrouter.ai/v1/mcp مع مفتاح API في ترويسة Bearer |
| مهارة الوكيل | الوكلاء الذين يحمّلون Agent Skills | يوجد فهرس المهارات في /.well-known/agent-skills/index.json |
| واجهة HTTP API | شفرتك الخاصة، أو وكيل يكتب الشفرة نيابة عنك | البدء السريع |
لتشغيل الوكيل نفسه باستخدام نماذج النصوص في SeedRouter بدلًا من ذلك، راجع وكلاء البرمجة على SeedRouter.
اضبط مفتاحك مرة واحدة
أنشئ مفتاحًا من صفحة مفاتيح API وصدّره، حتى يتمكن الوكيل من قراءته دون أن يُحفظ في ملفات مشروعك:
export SEEDROUTER_API_KEY=YOUR_API_KEYتتضمن صفحة مفاتيح API أيضًا زر الاتصال عبر MCP الذي يعرض إعدادات جاهزة لكل عميل MCP.
ما يفعله الوكيل على SeedRouter
- البحث عن نموذج: باستخدام
list_modelsعبر MCP، أو قائمة النماذج في/llms.txt. لكل نموذج له صفحة تعريفية ملخّص نصي فيhttps://seedrouter.ai/models/<slug>/llms.txtيتضمن معاملاته وأسعاره وأمثلته. - قراءة مخطط المدخلات: باستخدام
get_model_schemaعبر MCP، أو صفحة وثائق النموذج. - استخدام روابط وسائط عامة: لا تقبل نقاط نهاية الإنشاء الصور والفيديوهات والملفات الصوتية المرجعية إلا كروابط
http(s)عامة. تُرفض المدخلات بصيغة Base64، لذا استضف الملفات المحلية أولًا في مكان يمكن الوصول إليه. - التحقق من السعر: يعيد
get_pricingعبر MCP أسعار النموذج الحالية بالدولار الأمريكي قبل إرسال أي شيء. - الإرسال والانتظار: استدعِ
submit_taskثمget_taskمعwait_seconds: 50حتى تكتمل المهمة. وعبر HTTP، أرسل إلى نقطة نهاية النموذج واستعلم عبرGET /v1/tasks/{id}كل ثلاث ثوانٍ تقريبًا.
لا تُحتسب رسوم على المهام الفاشلة. ولا يمكن تكرار الإرسال دون أثر إضافي: فإعادة طلب لم تتلقَّ استجابته تنشئ مهمة ثانية وتخصم تكلفتها، لذا تحقق من سجل المهام أو الرصيد أولًا.
الحدود التي ينبغي مراعاتها
| الحد | القيمة الافتراضية | الاستجابة عند تجاوزه |
|---|---|---|
| مهام الصور والفيديو قيد التنفيذ في الوقت نفسه، لكل حساب | 50 | HTTP 429، الرمز 30002 |
قد تُرفض الطلبات أيضًا عند تجاوز معدل الطلبات المسموح به، وتُعاد عندها استجابة HTTP 429 كذلك. عند تلقي HTTP 429، انتظر المدة المحددة في Retry-After إن وُجدت؛ وإلا فزِد مدة الانتظار أُسّيًا بين المحاولات، مع بعض العشوائية وحد أقصى للانتظار. اتخذ القرار بناءً على رمز الحالة بدلًا من تحليل أجسام الأخطاء، لأن نقاط نهاية النصوص تجيب بصيغة الأخطاء الخاصة ببروتوكولها. ينبغي للعملية الدفعية الاحتفاظ بطابور وإرسال مهام جديدة مع اكتمال المهام قيد التنفيذ، بدلًا من إرسال كل شيء دفعة واحدة. تواصل مع [email protected] إذا كنت تحتاج إلى حد أعلى.
نقاط الدخول القابلة للقراءة آليًا
| الرابط | ماهيته |
|---|---|
/llms.txt | فهرس النماذج والوثائق والأدلة الموجّهة لنماذج اللغة |
/models/<slug>/llms.txt | معاملات نموذج واحد وأسعاره وأمثلته |
/docs/<page>.md | أي صفحة وثائق بصيغة Markdown، مثل /docs/api/overview.md |
/.well-known/agent-skills/index.json | فهرس مهارات الوكلاء |
/.well-known/api-catalog | دليل واجهات API (RFC 9727) |
https://api.seedrouter.ai/v1/mcp | خادم MCP |