الشروع في استخدام Microsoft Agent Framework: دليل خطوة بخطوة

By Mirko Peters · 2026-08-13

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

Automatically translated with AI from the original post. Read the English original

مرحبًا بكم مجددًا في مدونة البودكاست! إن كنتم تتابعون حلقاتنا الأخيرة، فأنتم تعلمون أن عالم الذكاء الاصطناعي يتحول بسرعة من واجهات الدردشة البسيطة إلى أنظمة متطورة ومستقلة. لم نعد نكتفي بطلب تنفيذ موجه واحد من النموذج؛ بل نقوم اليوم بتنسيق فرق من العمال الرقميين القادرين على الاستدلال والتخطيط وتنفيذ مهام متعددة الخطوات. ولسد الفجوة بين هندسة الموجهات التجريبية والنشر على مستوى المؤسسات، قدّمت Microsoft مجموعة أدوات تُحدث تحولًا حقيقيًا. في هذا المنشور، سنتعمق في التعامل العملي مع هذه التقنية، بدءًا من الإعداد الأولي وصولًا إلى تشغيل أول سير عمل مستقل لكم.

قبل أن ننتقل إلى الشرح التقني، إن أردتم فهمًا أساسيًا للمفاهيم الكامنة وراء ذلك، فلا تفوّتوا الاستماع إلى حلقة البودكاست المخصصة لذلك، Microsoft Agent Framework - Simply Explained. تشرح تلك الحلقة الموقع الذي تندرج فيه هذه الأدوات ضمن منظومة Microsoft الأوسع، مما يمنحكم السياق الاستراتيجي قبل كتابة أول أسطر الشيفرة البرمجية.

مقدمة إلى Microsoft Agent Framework

إن Microsoft Agent Framework بنية مفتوحة متعددة اللغات، مصممة خصيصًا لإنشاء وكلاء ذكاء اصطناعي جاهزين للإنتاج وسير عمل تعاونية تضم عدة وكلاء. وعلى خلاف تطبيقات الدردشة التقليدية التي تعتمد بالكامل على ديناميكية الأسئلة والأجوبة الخطية، تمكّن هذه البنية المطورين من بناء مكونات تشغيلية طويلة الأمد. تستخدم هذه المكونات نماذج اللغة الكبيرة (LLMs) لتفسير مدخلات المستخدمين، واستدعاء الأدوات الخارجية، والحفاظ على حالات الجلسات المستمرة، وتوليد استجابات دقيقة للغاية.

يحلّ الإطار في جوهره تحديًا معماريًا رئيسيًا: كيفية جعل عدة كيانات ذكاء اصطناعي تعمل معًا بسلاسة. فمن خلال التنسيق المعياري، وسير العمل الحتمي، ودعم Model Context Protocol (MCP)، يستطيع المطورون بناء أنظمة يتعاون فيها وكلاء متخصصون، مثل باحث ومحلل ومدير مشروع. وسواء كنتم تبنون روبوتات دعم العملاء، أو مساعدات التطوير الآلية، أو محركات عمليات الأعمال المعقدة، فإن امتلاك إطار منظم وذي حالة أمر أساسي للحفاظ على موثوقية تطبيقاتكم وأمانها وقابليتها للتوسع.

الخطوة 1: إعداد المستودع

تبدأ كل رحلة برمجية ناجحة ببيئة عمل نظيفة وإعدادات بيئة صحيحة. ولبدء أول مشروع لكم باستخدام Microsoft Agent Framework، تتمثل خطوتكم الأولى في إعداد مستودع التطوير المحلي.

أولًا، ستحتاجون إلى استنساخ المستودع التعليمي الرسمي المتوفر في أدلة البدء. افتحوا الطرفية أو واجهة سطر الأوامر، ثم اسحبوا الشيفرة المصدرية. بعد استنساخ المستودع، تكون أولويتكم الفورية التحقق من بيئة البرمجة لديكم. تدعم الإطار لغتي Python وNET. بشكل أساسي، لذا يجب التأكد من تشغيل إصدار متوافق من بيئة التشغيل التي اخترتموها، وغالبًا ما يكون Python 3.10 أو أحدث لمطوري Python، أو أحدث إصدار من .NET SDK لمطوري المؤسسات.

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

الخطوة 2: إعداد Azure AI Foundry

بمجرد أن يصبح المستودع المحلي جاهزًا وقيد التشغيل، تحتاجون إلى ربط بيئتكم المحلية بالبنية التحتية السحابية التي ستشغّل محركات الاستدلال الخاصة بالوكلاء. وهنا يأتي دور Azure AI Foundry.

سجّلوا الدخول إلى بوابة Azure الخاصة بكم، وانتقلوا إلى Azure AI Foundry. ستحتاجون هنا إلى إنشاء مورد جديد ومساحة مشروع مخصصة لسير عمل الوكيل. يساعدكم تنظيم عملكم ضمن مشروع محدد على إدارة الأذونات، وتتبع استهلاك الرموز، ومراقبة مسارات تنفيذ الوكيل بفعالية.

بعد إنشاء المشروع، يجب عليكم نشر النماذج المطلوبة والخدمات الأساسية اللازمة. وبحسب حالة الاستخدام، ستحتاجون إلى توفير نماذج لغوية كبيرة قوية (LLMs)، مثل نماذج GPT المتقدمة، قادرة على التعامل مع مهام الاستدلال المعقدة وإدارة الحالة واستدعاء الأدوات. كما ينبغي عليكم تهيئة Azure Search Service ضمن هذه البيئة. فهذه الخدمة تشكل العمود الفقري لقدرات استرجاع البيانات لدى الوكيل، إذ تتيح له تحليل بيانات المؤسسة بأمان، وإعادة السياق ذي الصلة إلى جلسة الوكيل.

الخطوة 3: ربط Bing Search للتأريض (Grounding)

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

في هذه الخطوة من إعداد المشروع، ستربطون Bing Search بمشروع Azure AI Foundry. فمن خلال دمج Bing Search API كمورد أداة، تمنحون وكلاءكم القدرة على الاستعلام عن الويب ديناميكياً عندما يتطلب طلب المستخدم معلومات فورية.

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

اختبار مسار عمل الوكيل الأول

بعد تهيئة المستودع ونشر Azure AI Foundry وربط تأريض Bing Search، أصبحتم جاهزين أخيراً لبناء مسار عمل الوكيل الأول واختباره.

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

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

الخطوات التالية والمصادر الإضافية

تهانينا! فبإعداد المستودع، وتهيئة Azure AI Foundry، ودمج تأريض Bing Search، قطعتم خطواتكم الأولى المهمة في تطوير الذكاء الاصطناعي على مستوى المؤسسات باستخدام Microsoft Agent Framework. لكن هذه مجرد البداية.

وأثناء استمراركم في هذه الرحلة، جرّبوا أنماط التنسيق متعددة الوكلاء. حاولوا إدخال وكيل ثانٍ إلى مسار العمل، مثل وكيل مراجعة يتحقق من مخرجات وكيل الباحث الرئيسي قبل تسليم الاستجابة النهائية للمستخدم. تعمّقوا في الوثائق الرسمية من Microsoft لاستكشاف بروتوكولات الاتصال بين الوكلاء (A2A) وبروتوكول سياق النموذج (MCP) لتوسيع قدرات وكلائكم أكثر.

ولتعميق فهمكم، وضمان بناء أنظمة آمنة ومتوافقة وعالية الإنتاجية، استمعوا إلى الشرح الصوتي الكامل لهذا الموضوع عبر زيارة الحلقة الصوتية على Microsoft Agent Framework - Simply Explained. برمجة سعيدة، ونراكم في الحلقة القادمة!