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

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

Retell
AI Voice Agent Platform
Published 
November 17, 2026
9
 min read
كيف تبني وكيلًا صوتيًا باستخدام Claude Code وClaude Fable 5.2
About this article
اربط Claude Code بخادم MCP الخاص بمنصّة Retell AI بأمر واحد، ثم دع Claude Fable 5.2 يبني وكيلًا هاتفيًا ويختبره ويراجعه من الطرفية لديك.
BACK TO BLOGS
See Retell AI in action
Start free
Back to top

يستطيع 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 Code إلى مساحة عمل Retell. على اليسار، يعمل Claude Code في الطرفية لديك بنموذج Claude Fable 5.2، فيقرأ طلبك المكتوب بلغة بسيطة، ويخطّط للـ endpoints التي يحتاجها من Retell، ويطلب منك اعتماد كل استدعاء. ويتصل عبر MCP فوق HTTP، مع مفتاح الـ API في ترويسة Authorization، بخادم MCP الخاص بـ Retell على mcp.retellai.com، الذي يضمّ ثلاث أدوات تُستخدم بالترتيب: list_api_endpoints تجد الـ endpoint المناسب للمهمة، وget_api_endpoint_schema تقرأ مخطّط الإدخال لذلك الـ endpoint، وinvoke_api_endpoint تتحقّق من الوسائط مقابل المخطّط ثم تستدعي Retell API. وتعمل Retell API على مساحة عمل Retell الخاصة بك: الوكلاء وأرقام الهواتف وقواعد المعرفة والأصوات والاختبارات والمكالمات. ويردّ الوكيل على المكالمات بنموذج من قائمة Retell، وليس بـ Fable 5.2.
يخطّط Claude Code للعمل، ويُجري خادم MCP الخاص بـ Retell كل استدعاء API بعد أن تعتمده. مخطّط من إعداد Retell AI، نوفمبر 2026، استنادًا إلى توثيق خادم MCP الخاص بـ Retell.

أمر يجب حسمه قبل البدء: 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 على وكيل Retell، وتتضمّن كل مرحلة مثالًا على الطلب، وما يفعله Claude Code، وما يجب التحقق منه. الأولى، بناء الوكيل: يكتب Claude Code الـ prompt ويُنشئ الوكيل؛ اقرأ الـ prompt قبل أن تعتمده. الثانية، الاختبار دون مكالمة: يُنشئ حالات اختبار محاكاة مُقيَّمة ويشغّلها كمحادثات نصية؛ تحقّق من أن معايير النجاح تطابق ما يهمّك. الثالثة، الاتصال بهاتفك: يعيّن الوكيل لرقم ويُجري مكالمة؛ تحقّق من رقم الوجهة ومن الوكيل الذي سيُستبدَل. الرابعة، مراجعة المكالمات: يقرأ المكالمات وتحليل ما بعد المكالمة ويصوغ التغييرات؛ اعتمد فقط التغييرات التي توافق عليها. ويعود سهم منقّط من المرحلة الرابعة إلى الأولى، مكتوب عليه: عدّل الـ prompt، وأعد تشغيل حالات الاختبار، وانشر.
حلقة البناء والاختبار والاتصال والمراجعة، مع ما يجب التحقق منه في كل مرحلة. مخطّط من إعداد Retell AI، نوفمبر 2026، استنادًا إلى توثيق خادم MCP والاختبار بالمحاكاة من Retell.
ما تطلبهما يفعله 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، وقيّمه على مكالماتك قبل أن تقرّر أي شيء آخر.

ROI Calculator
Estimate Your ROI from Automating Calls

See how much your business could save by switching to AI-powered voice agents.

All done! 
Your submission has been sent to your email
Oops! Something went wrong while submitting the form.
   1
   8
20
Oops! Something went wrong while submitting the form.

ROI Result

2,000

Total Human Agent Cost

$5,000
/month

AI Agent Cost

$3,000
/month

Estimated Savings

$2,000
/month

Estimate your monthly voice AI cost

$  0.11
Thank you! Your submission has been received!
Oops! Something went wrong while submitting the form.
Estimated monthly cost
$1,408
12,800 conversation minutes

أحدث ثورة في مركز الاتصال لديك مع Retell