يتوفر مصحح أخطاء وكيل الذكاء الاصطناعي (AI Agent Debugger) من Apidog في أحدث إصدار من عميل Apidog عبر جميع الخطط، بما في ذلك الخطة المجانية. يتيح لك المصحح تشغيل وكلاء الذكاء الاصطناعي مقابل نماذج OpenAI و Anthropic، وربط خوادم MCP، وفحص كل استدعاء للنموذج واستدعاء للأداة في لوحة التتبع (Traces panel)، وتتبع التكلفة لكل عملية تشغيل.
تغطي هذه المقالة من يمكنه استخدام مصحح أخطاء وكيل الذكاء الاصطناعي، وما يدعمه، وما لا يدعمه، وكيفية تمكينه، وما الذي يظل كما هو في مشاريع Apidog الحالية الخاصة بك.
ما هو متاح
يأتي مصحح أخطاء وكيل الذكاء الاصطناعي مدمجًا في عميل Apidog القياسي. لا يوجد ترخيص منفصل، ولا خطة إضافية، ولا رسوم لكل مقعد.
- تتضمن خطط Free و Basic و Professional و Enterprise جميعًا مصحح أخطاء وكيل الذكاء الاصطناعي.
- يتم تمكين الميزة افتراضيًا؛ لا يوجد شيء لتبديله.
- يجب أن تكون على أحدث إصدار من عميل Apidog. لا تحتوي العملاء الأقدم على علامة تبويب مصحح أخطاء وكيل الذكاء الاصطناعي.
مزودو النماذج المدعومون
| المزود | الحالة | النماذج |
|---|---|---|
| OpenAI | مدعوم | GPT-5.5، GPT-5.5 Instant، o-series، وأي نموذج في حساب OpenAI |
| Anthropic | مدعوم | Claude 4.7 Sonnet, Claude 4.7 Opus, Claude 4.7 Haiku |
| نقاط نهاية مخصصة متوافقة مع OpenAI | مدعومة عبر تجاوز عنوان URL الأساسي | أي مزود يقدم واجهة برمجة تطبيقات متوافقة مع OpenAI |
| مزودون آخرون (Google, Mistral, xAI) | على خريطة الطريق | ليسوا حاليًا من الدرجة الأولى |
طرق اتصال خادم MCP
يتحدث المصحح بروتوكول Model Context Protocol بشكل أصلي. يتم دعم ثلاثة أنواع من النقل:
- STDIO. عملية فرعية محلية. الأفضل لخوادم MCP قيد التطوير النشط.
- HTTP Streamable. خوادم MCP المستضافة التي يمكن الوصول إليها عبر HTTP.
- SSE. أحداث الخادم المرسلة (Server-Sent Events) القديمة. لا تزال شائعة؛ مدعومة للتوافق مع الإصدارات السابقة.
يغطي المصادقة لخوادم MCP نمطين: الرؤوس القياسية (مفتاح API) و OAuth 2.0 (تبادل رمزي كامل).
ما يغطيه المصحح
يلتقط المصحح سلسلة التنفيذ الكاملة لتشغيل الوكيل:
- استدعاءات النموذج مع حمولات الطلب والاستجابة الكاملة.
- تتبعات تفكير النموذج، عندما يكشفها النموذج (سلسلة OpenAI o-series، التفكير الموسع في Anthropic).
- استدعاءات الأدوات مع قيم المعلمات وبيانات الإرجاع.
- حركة مرور خادم MCP، مدرجة في لوحة التتبعات (Traces panel) مثل أي استدعاء أداة آخر.
- الأدوات المدمجة:
bash،web_fetch،read،edit،write،grep،glob،kill_shell. - مقاييس الأداء لكل عملية تشغيل: وقت الاستجابة، الرموز المدخلة، الرموز المخرجة، التكلفة المقدرة.
- المهارات (Skills): حزم محفوظة من موجه النظام + قائمة الأدوات + المعلمات لإعادة تشغيل السيناريو.
ما لا يغطيه المصحح
- إمكانية المراقبة في الإنتاج. استخدم أداة مراقبة مخصصة لتسجيل حركة المرور على المدى الطويل.
- اختبار الانحدار التلقائي. لشبكات المطالبات مقابل التجهيزات، استخدم إطار عمل مثل Promptfoo.
- حركة مرور بروتوكول Agent-to-Agent (A2A). لـ A2A، استخدم مصحح أخطاء A2A المنفصل من Apidog.
- التحقق من صحة خادم MCP بمعزل عن غيره. لاختبار أدوات وموارد خادم MCP واحد بدون حلقة وكيل، استخدم تدفق اختبار خادم MCP الخاص بـ Apidog.
كيفية تمكينه
- حدث Apidog إلى أحدث إصدار.
- افتح Apidog وانقر على AI Agent Debugger في شريط التبويبات العلوي.
- حدد مزود نموذج ونموذج.
- تأكد من عنوان URL الأساسي (يتم تعبئته تلقائيًا من المزود) أو قم بتجاوزه لنقطة نهاية مخصصة.
- الصق مفتاح API الخاص بك.
- انقر فوق Run على سلسلة فارغة لتأكيد الاتصال.
لا يتطلب أي تكوين على مستوى المشروع. يعمل المصحح في مساحة العمل الخاصة به.
ما الذي يبقى كما هو
- مشاريع Apidog الحالية، وتعريفات واجهة برمجة التطبيقات (API)، ومجموعات الاختبار لا تتأثر.
- يستمر تدفق اختبار خادم MCP ومصحح أخطاء A2A في العمل بالتوازي.
- تصحيح أخطاء نقاط نهاية واجهة برمجة التطبيقات، وخوادم Mock، وتحرير OpenAPI لا يتغير.
- الفواتير ومستويات الخطط لا تتغير؛ لا يستهلك مصحح أخطاء وكيل الذكاء الاصطناعي أي رصيد جديد.
تدفع مقابل استدعاءات API للنموذج الأساسية وفقًا لما يتم تحرير فاتورته لحساب OpenAI أو Anthropic الخاص بك. لا يفرض Apidog أي رسوم إضافية على الاستخدام.
لمسؤولي الفرق والمؤسسات
- يتم تمكين مصحح أخطاء وكيل الذكاء الاصطناعي لكل مستخدم. يستخدم كل عضو مفتاح API الخاص بالمزود الخاص به.
- يتم تخزين مفاتيح API المدخلة في المصحح محليًا على عميل كل مستخدم. لا يتم نقلها إلى خوادم Apidog.
- يمكن لمالكي مساحة العمل إدارة نقاط نهاية خادم MCP المشتركة مركزيًا من خلال متغيرات بيئة Apidog القياسية.
- تتبع ضوابط المراجعة والوصول لخوادم MCP نموذج المصادقة الخاص بخادم MCP (الرؤوس أو OAuth 2.0).
القيود المعروفة
- توسيع المزودين بما يتجاوز OpenAI و Anthropic هو على خريطة الطريق؛ استخدم تجاوز عنوان URL الأساسي للمزودين المتوافقين مع OpenAI في هذه الأثناء.
- مشاركة التتبع محلية فقط. لمشاركة التتبع، انسخ JSON للعرض الأولي (Raw view) أو التقط لقطة شاشة للوحة.
- تقدير التكلفة هو تقريب محلي يعتمد على تسعيرة النموذج المنشورة؛ ارجع إلى لوحة معلومات استخدام مزودك للفواتير.