بناء وكيل ذكاء اصطناعي بـ Claude على VPS

ما الذي يعنيه بناء وكيل مع Claude

بناء وكيل مع Claude يعني استخدام Claude بوصفه جوهر الاستدلال، بينما توجد الحلقة والأدوات والبيانات على خادمك أنت. Claude يقرر ما ينبغي فعله؛ وVPS الخاص بك ينفّذه. ترسل إلى Claude المهمة والحالة الراهنة، فيرد إما بإجابة وإما بطلب استخدام إحدى أدواتك، فيشغّل كودك تلك الأداة ويعيد النتيجة إليه، وتستمر الحلقة حتى تنتهي المهمة. الذكاء هنا خدمة تستدعيها عبر الإنترنت؛ أما كل ما حولها فملكك أنت.

هذا الفصل هو مكمن الجاذبية. تحصل على استدلال بمستوى الطليعة دون أن تُشغّل نموذجًا بنفسك، وتحتفظ بالسيطرة الكاملة على ما يستطيع الوكيل لمسه، لأن الأدوات تعمل على عتاد تملكه أنت. وإذا كنت قد بنيت بالفعل أول برنامج لك مع Claude، فإن دليل أول تطبيق Claude على VPS يغطي الأساس الذي يبني هذا الدليل عليه.

Claude هو العقل: Messages API

كل استدعاء لـ Claude يمر عبر نقطة نهاية واحدة، هي Messages API. ترسل المحادثة كما جرت حتى الآن مع قائمة الأدوات التي يجوز للوكيل استخدامها؛ فيرد Claude برسالته التالية. وتلك الرسالة إما إجابة نهائية وإما طلب استدعاء أداة. وفي مسار «ابنِه بنفسك» لا توجد «API مستقلة للوكيل»: فاستخدام الأدوات ليس سوى ميزة في نقطة النهاية الواحدة هذه، والحلقة المحيطة بها من مسؤوليتك أنت.

Claude عديم الحالة بين الاستدعاءات، أي أنه لا يتذكر شيئًا من تلقاء نفسه. كل طلب يحمل المحادثة بأكملها. كودك هو من يحتفظ بالسجل ويرسله في كل جولة. وهذا ليس قيدًا بقدر ما هو خيار تصميمي: فبما أن الحالة توجد على خادمك، فأنت من يقرر بالضبط ما يراه Claude، ولا شيء من تفاصيل المهمة يُخزَّن في مكان لا تتحكم فيه.

استخدام الأدوات هو حلقة الوكيل

حلقة الوكيل مع Claude بسيطة الوصف. ترسل طلبًا يتضمن أدواتك. يقرأ Claude المهمة، وإن احتاج إلى التصرف، يردّ بطلب استخدام أداة يسمّي فيه أداة معينة ويملأ مدخلاتها. يشغّل كودك تلك الأداة، ثم يرسل النتيجة إلى Claude في الطلب التالي. يقرأ Claude النتيجة ثم إما يطلب أداة أخرى وإما يكتب ردّه النهائي. وحين يتوقف عن طلب الأدوات، تكون المهمة قد انتهت.

تستطيع كتابة هذه الحلقة يدويًا في بضعة أسطر، وكثيرون يفعلون ذلك فعلًا، لأنها سهلة الرؤية وسهلة التحكم. كما توفر الـ SDKs الرسمية مُشغِّل أدوات يدير الحلقة نيابةً عنك: تزوّده بدوال الأدوات، ويتولى الـ SDK تبادل الرسائل بين استدعاء Claude وتشغيل أدواتك وإعادة تغذية النتائج حتى ينتهي Claude. وفي الحالتين الشكل واحد؛ فالمُشغِّل يوفّر عليك فقط عناء كتابة الحلقة بنفسك.

ثلاث طرق للبناء، وأيها يناسب VPS

هناك ثلاث طرق لبناء وكيل Claude، وتختلف فيما بينها بمقدار الآلية التي تشغّلها أنت بنفسك.

الأولى هي كودك الخاص الذي يستدعي Claude API بأدواتك أنت. تكتب الحلقة بنفسك، أو تستخدم مُشغِّل الأدوات الخاص بالـ SDK، وتستضيف كل ذلك على VPS الخاص بك. هذا هو الخيار الشائع، لأنه يمنحك سيطرة كاملة على الأدوات والبيانات والأمان، ويعمل كبرنامج عادي على خادمك. ومعظم هذا الدليل يفترض هذا المسار.

والثانية هي Claude Agent SDK. وهي Claude Code، وكيل البرمجة، مُغلَّفة كمكتبة تبني عليها. تأتي بحلقة وكيل كاملة وأدوات مدمجة لقراءة الملفات وكتابتها، وتشغيل أوامر shell، والبحث، فلا تحتاج إلى تجميع كل ذلك من الصفر. وهي أيضًا تعمل على خادمك أنت، ما يجعلها مناسبة تمامًا لـ VPS حين تريد وكيلًا قادرًا على التعامل مع الملفات وأوامر shell دون أن تبني الهيكل بنفسك. أي وكيل يقرأ ملفات وينفّذ أوامر shell يحتاج إلى احتواء قبل أن يعمل دون مراقبة، وتشغيل Claude Code بأمان على خادم يغطي نظام الأذونات، والبيئة المعزولة، وخيارات العزل.

والثالثة هي Managed Agents، حيث تُشغّل Anthropic الحلقة وتستضيف بيئة معزولة تُنفَّذ فيها أدوات الوكيل. هذا هو الخيار الذي لا يتطلب تدخلًا: العمل التشغيلي المطلوب منك أقل بكثير، لكن مساحة عمل الوكيل توجد على بنية Anthropic التحتية لا على VPS الخاص بك. الجأ إليه حين تريد أقل قدر من العمل التشغيلي ولا تحتاج إلى أن تعمل الأدوات على جهازك أنت. أما الطريقتان الأخريان فخادمك هو موطن الوكيل فيهما، وهذا هو موضوع بقية هذا الدليل.

ربط الأدوات عبر MCP

أيًّا كان المسار الذي تختاره، سترغب في ربط الوكيل بأنظمة حقيقية، وModel Context Protocol هو الطريقة الأنسب لفعل ذلك. MCP معيار مفتوح لعرض الأدوات والبيانات على وكيل. فبدلًا من كتابة تكامل يدوي لكل خدمة على حدة، توجّه Claude إلى خادم MCP يعرض بالفعل تلك القدرات كأدوات. ويمكنك تشغيل خوادم MCP كخدمات صغيرة على VPS نفسه، لكل منها فقط الصلاحية التي تحتاج إليها، وهو ما أتناوله في تشغيل خوادم MCP على VPS.

اختيار نموذج

يتوفر Claude في عدة نماذج، واختيار واحد منها مفاضلة بين القدرة والسرعة والتكلفة. وقت كتابة هذه السطور، الخيارات الشائعة هي Claude Opus 4.8 (claude-opus-4-8)، الخيار الافتراضي القادر على الاستدلال الصعب وعمليات تشغيل الوكيل الطويلة؛ وClaude Sonnet 5 (claude-sonnet-5)، خيار متوازن أرخص وأسرع مع بقائه قريبًا من Opus في مهام كثيرة؛ وClaude Haiku 4.5 (claude-haiku-4-5)، الأسرع والأرخص، للخطوات البسيطة عالية الحجم. وفوق هذه جميعًا يأتي Claude Fable 5 (claude-fable-5)، النموذج الأقدر، للأعمال الأكثر تطلبًا. استخدم معرّف النموذج بالضبط في كودك، دون إضافة تاريخ إليه.

من الأنماط العملية أن تمزج بينها. اترك نموذجًا أرخص يتولى استدعاءات الأدوات الروتينية، ونموذجًا أقوى يتولى القرارات الصعبة. وبما أن النموذج ليس سوى سلسلة نصية في طلبك، فتبديله تغيير من سطر واحد، فابدأ بخيار افتراضي قادر ثم انزل إلى خيار أخف حين تكون السرعة أو التكلفة أهم من أعلى درجة ممكنة من الجودة.

شغّله كخدمة مُحصَّنة على VPS الخاص بك

الوكيل لا يكون مفيدًا إلا إذا ظل يعمل، ولا يكون آمنًا إلا إذا كان محتوًى. وعلى VPS يأتي هذان الأمران من تشغيل الوكيل كخدمة نظام مُحصَّنة بدلًا من برنامج تشغّله يدويًا في طرفية. بوصفه خدمة، فإنه يبدأ عند الإقلاع، ويعيد التشغيل إذا تعطّل، ويسجّل في الـ journal. وبتحصينه، يعمل تحت مستخدم عادي لا يملك من الصلاحيات سوى ما يحتاج إليه، فيصبح لأي خلل أو تعليمة سيئة سقفٌ لا يتجاوزه.

والقاعدة الأهم على الإطلاق هي إبقاء مفتاح Claude API على جانب الخادم. فالمفتاح هو ما يدفع ثمن كل استدعاء ويخوّله، لذا مكانه ملف لا يقرؤه سوى مستخدم الوكيل، يُحمَّل إلى الخدمة كمتغير بيئة، ولا يوضع أبدًا في الكود، ولا في مستودع، ولا في أي مكان يستطيع متصفح الوصول إليه. ولّد هنا وحدة خدمة كاملة ومُحصَّنة لوكيلك:

ثم أكمل تحصين الخادم نفسه. اجعل SSH يعمل بالمفاتيح فقط، وأحكم إغلاق الحساب الذي تدير منه الخادم، كما في تحصين SSH على خادم VPS. وإذا كنت تفضّل تشغيل الوكيل من جلسة تفاعلية أثناء بنائه، فإن تشغيل Claude Code على خادم VPS مع tmux رفيق جيد لذلك. وإذا أردت المفاهيم التي تقوم عليها كل هذه الأمور، دون ربطها بنموذج بعينه، فإن الدليل الشقيق حول بناء وكيل ذكاء اصطناعي خاص بك على خادم VPS يرسي الأسس.

وإذا كان ما تريده مساعد برمجة في الطرفية، فإن تشغيل وكيل ذكاء اصطناعي للبرمجة على VPS يغطي Aider وGoose.

FAQ

ما نموذج Claude الذي ينبغي استخدامه لبناء وكيل؟

ابدأ بـ Claude Opus 4.8 (claude-opus-4-8)، الخيار الافتراضي القادر، واضبط الأمر انطلاقًا منه. Claude Sonnet 5 (claude-sonnet-5) أرخص وأسرع لمعظم الأعمال، وClaude Haiku 4.5 (claude-haiku-4-5) هو الأنسب للخطوات البسيطة عالية الحجم، وClaude Fable 5 (claude-fable-5) هو الأقدر للمهام الأصعب. ومن الأنماط الشائعة استخدام نموذج أرخص للخطوات الروتينية ونموذج أقوى للقرارات الصعبة، بما أن التبديل تغيير من سطر واحد.

هل أُشغّل الوكيل كله على VPS الخاص بي، أم تُشغّله Anthropic؟

الأمر يعتمد على النهج المتبع. إذا كتبت حلقتك الخاصة باستخدام Claude API، أو استخدمت Claude Agent SDK، فإن الوكيل يعمل بأكمله على VPS الخاص بك ولا يخرج إلى Anthropic سوى استدعاءات النموذج. أما إذا استخدمت Managed Agents، فإن Anthropic تُشغّل الحلقة وتستضيف البيئة المعزولة التي تُنفَّذ فيها الأدوات، فيوجد جزء أقل منه على خادمك. وللحصول على وكيل يعمل على جهازك أنت، استخدم أحد النهجين الأولين.

ما الفرق بين Claude API وClaude Agent SDK؟

Claude API هي نقطة نهاية Messages الخام: ترسل محادثة وأدوات، وتكتب حلقة الوكيل حولها، أو تستخدم مُشغِّل الأدوات الخاص بالـ SDK لتشغيلها. أما Claude Agent SDK فمكتبة أعلى مستوى، وهي Claude Code مُغلَّفة لتبني عليها، تأتي بحلقة كاملة وأدوات مدمجة للملفات وshell والبحث. استخدم الـ API حين تريد تعريف كل شيء بنفسك، واستخدم الـ Agent SDK حين تريد وكيلًا قادرًا دون تجميع الهيكل بنفسك.

كيف أحافظ على أمان مفتاح Claude API على الخادم؟

أبقه على جانب الخادم وبعيدًا عن كودك. خزّنه في ملف لا يقرؤه سوى الحساب الذي يعمل الوكيل تحته، وحمّله إلى الخدمة كمتغير بيئة، ولا تودعه أبدًا في مستودع ولا تعرّضه لمتصفح. وبما أن كل طلب إلى Claude ينطلق من خادمك، فإن المفتاح لا يحتاج أبدًا إلى الوصول إلى جهاز المستخدم، وهذا ما يجعل تأمين وكيل يعمل على خادم أسهل من تأمين وكيل مدمج داخل تطبيق عميل.

هل أحتاج إلى استضافة نموذج ذاتيًا لبناء وكيل مع Claude؟

لا. فالنموذج في حالة Claude خدمة مستضافة تستدعيها عبر الـ API، فلا شيء يحتاج إلى العمل على GPU. VPS الخاص بك يُشغّل حلقة الوكيل والأدوات والبيانات، بينما يقع الاستدلال على جانب Anthropic. وهذا ما يتيح لخادم متواضع أن يُشغّل وكيلًا قادرًا. وإذا أردت بدلًا من ذلك نموذجًا محليًا بالكامل، فذلك هو المسار المستضاف ذاتيًا الذي يغطيه الدليل المرافق حول بناء وكيل ذكاء اصطناعي خاص بك.