كيف تبني وكيلًا صوتيًا باستخدام Claude Code وClaude Fable 5.2



يستطيع Claude Code بناء وكيل هاتفي يعمل فعليًا من الطرفية لديك. تربطه بخادم MCP الخاص بمنصّة Retell AI بأمر واحد، وتصف الوكيل بلغة بسيطة، فيُنشئه Claude Code ويكتب له حالات اختبار ويراجع مكالماته عبر Retell API. يشرح هذا الدليل تلك الحلقة باستخدام Claude Fable 5.2، النموذج الذي أطلقته Anthropic في 9 نوفمبر 2026، ويوضّح ما يجب اعتماده يدويًا خلال ذلك.
تنشر منصّة Retell AI هذا الدليل، وخادم MCP المستخدم فيه تابع لـ Retell نفسها.
كيف يبدو الإعداد
يتضمّن الإعداد ثلاثة عناصر. يعمل Claude Code في الطرفية لديك ويخطّط للعمل. ويمنحه خادم MCP الخاص بـ Retell، على العنوان mcp.retellai.com، إمكانية الوصول إلى Retell API. أمّا مساحة عمل Retell لديك فتضمّ الوكلاء وأرقام الهواتف والاختبارات وسجلّ المكالمات التي تعمل عليها الـ API.
يعرض خادم MCP ثلاث أدوات بدلًا من أداة لكل endpoint في الـ API، ما يُبقي قائمة الأدوات صغيرة بما يكفي لنافذة سياق النموذج. يستخدمها Claude Code بالترتيب: يسرد الـ endpoints المتاحة، ثم يقرأ مخطّط الإدخال للـ endpoint الذي يحتاجه، ثم يستدعيه. وإذا تضمّن الاستدعاء وسيطًا غير موجود في المخطّط، يُرجع الخادم خطأً يذكر اسم الوسيط ولا يستدعي الـ API.

أمر يجب حسمه قبل البدء: Claude Fable 5.2 هو النموذج الذي يتولّى البناء، وليس النموذج الذي يردّ على الهاتف. فالوكيل الذي تُنشئه يردّ على المكالمات بنموذج من قائمة Retell الخاصة، وFable 5.2 ليس ضمن تلك القائمة حتى 10 نوفمبر 2026. (تتضمّن القائمة نموذج Retell الخاص، Tell-1.) نتناول هذا الفصل بين الدورين في Claude Fable 5.2 للوكلاء الصوتيين: أين يناسب وأين لا يناسب.
ثلاث طرق لبناء وكيل Retell باستخدام Claude
يُعدّ Claude Code مع خادم MCP أحد ثلاثة مسارات، ولكلٍّ منها فئة مختلفة من المستخدمين.
| Claude Code + خادم MCP من Retell | موصّل Retell AI في Claude | لوحة تحكم Retell | |
|---|---|---|---|
| أين تعمل | الطرفية أو بيئة التطوير (IDE) لديك | محادثة في Claude على الويب أو Claude Desktop | متصفّح |
| تسجيل الدخول | مفتاح Retell API في ترويسة الطلب | بيانات دخولك إلى Retell، عبر OAuth | بيانات دخولك إلى Retell |
| ما الذي يصل إليه | نقاط Retell API (endpoints) التي يسمح بها مفتاحك، باستثناء المُهمَلة منها | 52 أداة مصمّمة لأغراض محدّدة مع عناصر واجهة داخل المحادثة (حتى أكتوبر 2026) | جميع الإعدادات |
| أنواع الوكلاء | كل ما تدعمه الـ API | وكلاء الـ prompt الواحد فقط | جميعها |
| الأنسب لـ | المطوّرين، والتغييرات المجمّعة، وأي شيء تريد أتمتته بنص برمجي أو تكراره | بناء وكيل واحد وتعديله عبر وصفه | تدفّقات المحادثة، والتكاملات، والمراجعة المرئية |
المصادر: توثيق خادم MCP وتوثيق موصّل Claude من Retell، اطُّلع عليهما في 10 نوفمبر 2026.
ربط Claude Code بخادم MCP من Retell
تحتاج إلى حساب Retell ومفتاح Retell API وتثبيت Claude Code. أنشئ المفتاح من لوحة تحكم Retell وامنحه الصلاحيات التي يحتاجها هذا العمل فقط.
شغّل الأمر التالي في الطرفية، مع وضع مفتاحك مكان العنصر النائب:
claude mcp add --transport http retell https://mcp.retellai.com \
--header "Authorization: Bearer <RETELL_API_KEY>"شغّل Claude Code ثم نفّذ /mcp للتأكد من اتصال خادم retell. بعد ذلك نفّذ /model واختر Claude Fable 5.2 إن كانت خطتك تتضمّنه. يذكر توثيق Claude Code أن Fable 5.2 يتطلّب الإصدار v2.1.321 من Claude Code أو أحدث، ويذكر منشور الإطلاق من Anthropic أن المطوّرين يمكنهم استدعاء النموذج على Claude Platform باسم claude-fable-5-2.
أبقِ المفتاح خارج المحادثة. مكانه الأمر أعلاه أو إعدادات العميل لديك، ولا تلصقه أبدًا في prompt.
صِف الوكيل ودع Claude Code يُنشئه
ابدأ بعملية قراءة، كي ترى الاتصال يعمل قبل أن يتغيّر أي شيء:
List my Retell agents and summarize what each one does.ثم صِف الوكيل الذي تريده. كن دقيقًا بشأن المهمة والنبرة وما يجب ألا يفعله أبدًا ومتى يحوّل المكالمة إلى موظف بشري:
Create a single-prompt voice agent for a dental clinic called
Northside Dental. It answers questions about hours and insurance,
books cleanings, and transfers billing questions to the front desk
at +14155550123. It should say it is an AI assistant at the start
of every call. Use Claude 5.5 Sonnet as the agent's model. Show me
the prompt before you create anything.يصوغ Claude Code الـ prompt، ويبحث عن مخطّط الـ endpoints التي يحتاجها، ويطلب منك اعتماد كل استدعاء API. اقرأ الـ prompt الذي كتبه قبل أن تعتمده. هنا يُثبت النموذج الأقوى جدارته: فالـ prompt هو الوكيل، والـ prompt المبهم ينتج مكالمة مبهمة.
اكتب حالات الاختبار قبل إجراء أي مكالمة
تُشغّل ميزة الاختبار بالمحاكاة من Retell وكيلك في محادثة نصية أمام متصل يحاكيه الذكاء الاصطناعي، وتقيّم كل تشغيل بالنجاح أو الإخفاق وفق معايير نجاح تحدّدها أنت. وتعمل مع وكلاء الـ prompt الواحد ووكلاء الـ prompts المتعدّدة ووكلاء تدفّق المحادثة، ولا تُجري أي مكالمة. اطلب من Claude Code كتابة مجموعة الاختبارات:
Write eight simulation test cases for the Northside Dental agent.
Cover a new patient booking a cleaning, a caller who interrupts and
changes the day twice, a billing question that must be transferred,
a caller asking if they are talking to a real person, and someone
asking for medical advice the agent must decline to give. Give each
one clear success criteria. Then run them and show me the failures.تتحوّل الحالات المحفوظة إلى مجموعة اختبارات انحدار. في كل مرة يتغيّر فيها الـ prompt، أعد تشغيلها قبل أن يصل التغيير إلى أي متصل.
اربط الوكيل برقم واتصل بهاتفك
تغطّي المحاكاة المنطق، بينما تغطّي المكالمة الحقيقية الصوت والإيقاع والمقاطعات. اطلب من Claude Code سرد أرقام هواتفك، وتعيين الوكيل لأحدها، وإجراء مكالمة إليك:
Show me my Retell phone numbers and which agent is on each. Put the
Northside Dental agent on the one that has no agent, then have it
call me at +14155550199.ثلاثة تحذيرات. تصل المكالمة إلى هاتف حقيقي وتُحتسب تكلفتها كأي مكالمة أخرى، لذا تحقّق من رقم الوجهة في طلب الاعتماد. كما تتطلّب المكالمات الصادرة إتمام التحقق من الهوية (KYC) على حسابك في Retell. وإذا كان هناك وكيل مرتبط بالرقم بالفعل، فإن استبداله يغيّر من يردّ على ذلك الرقم، لذا تحقّق مما هو موجود أولًا.
راجع المكالمات وعدّل الـ prompt
بعد بضع مكالمات، اطلب من Claude Code قراءتها:
Pull the last 20 calls for the Northside Dental agent. Group the
ones that ended badly by cause, quote the turn where each went
wrong, and propose prompt changes. Do not change anything yet.اعتمد تغييرات الـ prompt التي توافق عليها، وأعد تشغيل مجموعة اختبارات المحاكاة، ثم انشر. هذه الحلقة من البناء والاختبار والاتصال والمراجعة والتعديل هي العمل كلّه، وهي الجزء الذي يختصره Claude Code أكثر من غيره.

| ما تطلبه | ما يفعله Claude Code عبر خادم MCP | يحتاج إلى اعتمادك |
|---|---|---|
| «اعرض وكلائي» | يقرأ الوكلاء وإصداراتهم | مخاطرة منخفضة، قراءة فقط |
| «أنشئ وكيلًا...» | يكتب prompt ويُنشئ الوكيل | نعم. اقرأ الـ prompt أولًا |
| «اكتب حالات الاختبار وشغّلها» | يُنشئ حالات اختبار محاكاة ويشغّلها ويبلّغ عن الإخفاقات | نعم |
| «اربطه برقمي» | يسرد الأرقام ويعيّن الوكيل | نعم. تحقّق من الوكيل الذي سيستبدله |
| «اتصل بهاتفي» | يُنشئ مكالمة هاتفية | نعم. تحقّق من رقم الوجهة |
| «راجع المكالمات الأخيرة» | يسرد المكالمات ويقرأ النص المفرّغ لكل مكالمة وزمن الاستجابة وتحليل ما بعد المكالمة | مخاطرة منخفضة، لكن النصوص المفرّغة قد تحتوي على بيانات شخصية |
| «احذف الوكيل القديم» | يستدعي endpoint للحذف | نعم. تعامل مع الحذف على أنه نهائي |
أيّ الاعتمادات يجب إبقاؤها مفعّلة
يمرّ كل استدعاء API من Claude Code عبر أداة واحدة هي invoke_api_endpoint. وإذا اخترت السماح الدائم لهذه الأداة، فأنت تسمح بكل endpoint يمكن لمفتاحك الوصول إليه، بما في ذلك الحذف والنشر. يوصي توثيق Retell باعتماد كل استدعاء على حدة والتحقق من الـ endpoint ووسائطه، ولا ننصح بتخطّي ذلك.
- استخدم مفتاحًا بأقل صلاحيات تكفي لإنجاز المهمة. المفتاح المخصّص للقراءة فقط يكفي لمراجعة المكالمات.
- اقرأ قبل أن تكتب. اطلب من Claude Code جلب الوكيل الحالي قبل تحديثه أو حذفه.
- تعامل مع النصوص المفرّغة على أنها نصوص غير موثوقة. يمكن للمتصل أن يقول أي شيء، بما في ذلك تعليمات موجّهة إلى النموذج. لا تسمح لجلسة مراجعة المكالمات بأن تملك أيضًا صلاحية تعديل الوكلاء دون أن تراجع بنفسك.
- أبقِ البيانات الشخصية خارج العملية متى أمكن. اطلب ملخّصات للإخفاقات، لا نصوصًا مفرّغة كاملة، إلا إذا احتجت إليها.
هل يجب أن يكون النموذج Claude Fable 5.2؟
لا. يعمل خادم MCP مع أي نموذج يستطيع Claude Code تشغيله، ونصيحة Anthropic نفسها في منشور الإطلاق واضحة: «لمعظم مهام البرمجة والمعرفة، نوصي المستخدمين بالبدء بـ Claude Opus 5.5، أقوى نماذجنا للاستخدام اليومي.» ويصف المنشور Fable وMythos بأنهما مصمّمان للأعمال التقنية الأكثر طموحًا والمفتوحة النهاية.
لوكيل واحد بـ prompt قصير، سيؤدّي Opus 5.5 المهمة. ويستحق Fable 5.2 الاختيار حين تكون المهمة كبيرة ومفتوحة النهاية: إعادة كتابة الـ prompts عبر عشرات الوكلاء وفق معيار جديد، أو تحويل شهر من المكالمات الفاشلة إلى مجموعة اختبارات انحدار، أو نقل الوكلاء بين مساحات العمل مع الحفاظ على سلوكهم كما هو. هذه تقديراتنا الخاصة، وليست نتائج اختبارات معيارية. وتسعّر Anthropic نموذج Fable 5.2 بـ $8 لكل مليون token إدخال و$40 لكل مليون token إخراج على منصّتها.
الأسئلة الشائعة
هل يمكن ربط Claude Code بمنصّة Retell AI؟
نعم. تشغّل Retell خادم MCP مستضافًا على mcp.retellai.com، ويتصل به Claude Code عبر الأمر claude mcp add ومفتاح Retell API في ترويسة Authorization. ويمكن لـ Cursor وClaude Desktop وCodex وغيرها من عملاء MCP الاتصال بالخادم نفسه.
هل أحتاج إلى Claude Fable 5.2 لاستخدام خادم MCP من Retell؟
لا. يعمل الخادم مع أي نموذج يشغّله عميل MCP لديك. وتوصي Anthropic بالبدء بـ Claude Opus 5.5 لمعظم مهام البرمجة والمعرفة، وتخصّص Fable 5.2 للأعمال التقنية الأكثر طموحًا والمفتوحة النهاية.
هل يمكن تشغيل الوكيل الصوتي نفسه على Claude Fable 5.2؟
ليس من قائمة نماذج Retell حتى 10 نوفمبر 2026. يردّ الوكيل على المكالمات بنموذج تختاره من تلك القائمة، التي تشمل Claude 5.5 Opus وClaude 5.5 Sonnet وClaude 5.5 Haiku. أمّا Fable 5.2 فيتولّى البناء والاختبار والمراجعة من Claude Code.
ما الفرق بين خادم MCP من Retell وموصّل Retell AI لـ Claude؟
يسجّل خادم MCP الدخول بمفتاح Retell API ويصل إلى Retell API من عملاء مثل Claude Code وCursor. أمّا الموصّل فمُدرج في دليل موصّلات Claude، ويسجّل الدخول ببيانات دخولك إلى Retell عبر OAuth، ويعرض خطوات البناء والنشر والاختبار كعناصر واجهة داخل المحادثة. ولا يبني الموصّل سوى وكلاء الـ prompt الواحد.
هل من الآمن السماح لـ Claude Code بإدارة حسابي على Retell؟
يتوقّف الأمان على المفتاح والاعتمادات التي تمنحها له. استخدم مفتاحًا بأدنى الصلاحيات، وأبقِ الاعتماد لكل استدعاء مفعّلًا لأداة invoke_api_endpoint، وراجع أي استدعاء لـ endpoint حذف أو نشر قبل اعتماده.
هل يكلّف الاختبار عبر Claude Code مالًا؟
الاستخدام عبر خادم MCP هو استخدام لـ Retell API، لذا تُحتسب المكالمات التي يُجريها كأي مكالمة أخرى. وتوضّح صفحة تسعير الاختبارات من Retell تكلفة الاختبارات، بينما تُحتسب تكلفة استخدام Claude Code من Anthropic، ضمن خطة Claude لديك أو أرصدة الاستخدام أو أسعار الـ API بحسب طريقة تسجيل دخولك.
ابنِ وكيلًا واحدًا وشغّله على مكالماتك
وفقًا لبيانات منصّة Retell، تمرّ 80% من دقائق الإنتاج عبر وكلاء يبنيهم العملاء ويديرونهم بأنفسهم. ويجعل Claude Code هذه الحلقة أقصر. اتبع دليل إعداد خادم MCP، وابنِ وكيلًا واحدًا في Retell، وقيّمه على مكالماتك قبل أن تقرّر أي شيء آخر.
See how much your business could save by switching to AI-powered voice agents.
Your submission has been sent to your email
ROI Result
Total Human Agent Cost
AI Agent Cost
Estimated Savings
Estimate your monthly voice AI cost
Read Other Blogs
أحدث ثورة في مركز الاتصال لديك مع Retell

ابدأ اليوم في بناء محادثات أكثر ذكاءً.




