دليل المطور إلى Microsoft Agent Framework 1.0

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

في الثالث من أبريل 2026، أطلقت مايكروسوفت الإصدار 1.0 من Agent Framework لكل من .NET وبايثون، وانتهى ذلك الخيار المحرج. الإطار هو الوريث المباشر لكليهما، بناه الفريقان ذاتهما، وهو يدمج تجريدات AutoGen داخل الأسس المؤسسية لـ Semantic Kernel — ثم يضيف محرك تدفقات رسومي لم يكن موجودًا في أيٍّ منهما.

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

ما هو Agent Framework 1.0

ينظّم الإطار نفسه في ثلاث طبقات من القدرات، وفهم هذا التقسيم هو أسرع طريق للتوجّه داخله.

الوكلاء (Agents) هي وحدات فردية تعتمد على نماذج اللغة، تعالج المدخلات وتستدعي الأدوات وخوادم MCP وتعيد الاستجابات. دعم النماذج واسع عن قصد: Microsoft Foundry وAzure OpenAI وOpenAI وAnthropic Claude وAmazon Bedrock وGoogle Gemini وOllama، جميعها تعمل عبر التجريد نفسه. وهذا مهم لكل من يبني استراتيجية تعدد نماذج مع بدائل احتياطية بدل رهن المنتج على مزوّد واحد.

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

التدفقات (Workflows) هي تركيبات رسومية تربط الوكلاء والدوال العادية في عمليات حتمية قابلة للتكرار، مع توجيه آمن الأنواع، ونقاط حفظ، ودعم التدخل البشري.

وتحت هذه الطبقات الثلاث توجد اللبنات المشتركة: عملاء النماذج، جلسة الوكيل لإدارة الحالة، مزوّدو السياق للذاكرة، الوسيط (middleware) لاعتراض إجراءات الوكيل، وعملاء MCP لتكامل الأدوات.

البداية العملية

التثبيت سطر واحد في أيٍّ من اللغتين.

لبايثون:

pip install agent-framework

from agent_framework.foundry import FoundryChatClient
from azure.identity import AzureCliCredential
 
credential = AzureCliCredential()
client = FoundryChatClient(
    project_endpoint="https://your-service.services.ai.azure.com/api/projects/your-project",
    model="gpt-5.4-mini",
    credential=credential,
)
 
agent = client.as_agent(
    name="HelloAgent",
    instructions="You are a friendly assistant. Keep your answers brief.",
)
 
result = await agent.run("What is the largest city in France?")
print(f"Agent: {result}")

نقطة مهمة تستحق الانتباه مبكرًا: لا يحمّل Agent Framework ملفات .env تلقائيًا في بايثون. استدعِ load_dotenv() بنفسك أو اضبط متغيرات البيئة في الطرفية.

لـ .NET:

dotnet add package Microsoft.Agents.AI.Foundry --prerelease

using Azure.AI.Projects;
using Azure.Identity;
using Microsoft.Agents.AI;
 
AIAgent agent = new AIProjectClient(
        new Uri("https://your-service.services.ai.azure.com/api/projects/your-project"),
        new AzureCliCredential())
    .AsAIAgent(
        model: "gpt-5.4-mini",
        instructions: "You are a friendly assistant. Keep your answers brief.");
 
Console.WriteLine(await agent.RunAsync("What is the largest city in France?"));

توجد حزمة Go في معاينة عامة عبر github.com/microsoft/agent-framework-go، لكن الوكلاء التصريحيين وRAG وCodeAct والتدفقات الوظيفية غير متاحة بعد. تعامل مع Go كخيار تجريبي حاليًا.

الوكلاء مقابل التدفقات: القرار الأهم

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

وما عدا ذلك، التقسيم واضح:

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

أنماط التنسيق

يوفّر الإصدار 1.0 خمسة أنماط تنسيق مستقرة:

• التسلسلي — يعمل الوكلاء بالترتيب، كلٌّ يستهلك مخرجات سابقه
• المتزامن — ينتشر الوكلاء بالتوازي ثم تتجمّع النتائج
• التسليم (Handoff) — ينقل وكيل التحكم إلى متخصص بناءً على السياق
• المحادثة الجماعية — يتداول عدة وكلاء في محادثة مشتركة
• Magentic-One — نمط يقوده مخطِّط للمهام المفتوحة متعددة الخطوات

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

نقاط الحفظ: الميزة الأقل تقديرًا

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

هذا يحوّل مشكلتين صعبتين إلى مجرد إعدادات:

التعافي من الأعطال. تدفق معالجة مستندات طويل يفشل عند الخطوة 7 من 12 يستأنف من الخطوة 7 لا من الأولى. على النماذج المكلفة هذا توفير مباشر في التكلفة، لا في زمن الاستجابة فقط.

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

لأي تدفق خاضع للتنظيم — اعتماد الفواتير، مراجعة العقود، التسويات المالية — هذه هي الميزة التي تجعل الأتمتة بالوكلاء قابلة للدفاع عنها أمام المدققين.

MCP وA2A: قابلية التشغيل البيني بلا احتكار

تكاملان بروتوكوليان يحددان موقع Agent Framework داخل منظومة أوسع.

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

A2A (من وكيل إلى وكيل) يتيح التعاون عبر بيئات التشغيل المختلفة، فينسّق وكلاؤك مع وكلاء يعملون في أطر أخرى عبر رسائل منظمة يحكمها البروتوكول. يستطيع وكيل Agent Framework تسليم عمل إلى وكيل LangGraph أو مشارك في بروتوكول A2A من جوجل دون محوّل مخصص. لاحظ أن دعم A2A الكامل كان لا يزال قيد الوصول عند إعلان 1.0 — تحقق من حالته الحالية قبل بناء تصميمك عليه.

معًا، يهم هذان البروتوكولان أكثر من أي ميزة منفردة. فهما يعنيان أن تبنّي Agent Framework لا يستلزم إعادة كتابة أدواتك ولا رهن أسطول وكلائك بالكامل على مزوّد واحد.

الوسيط والذاكرة والإعداد التصريحي

ثلاث قدرات موجّهة للإنتاج تكمل الإصدار.

خطافات الوسيط (Middleware) تعترض سلوك الوكيل وتوسّعه — سلامة المحتوى، التسجيل، بوابات الامتثال. هذه هي نقطة التوسعة لمن يحتاج سجل تدقيق لكل استدعاء أداة، وهو عمليًا كل من ينشر وكلاء في القطاع المالي أو الصحي أو الحكومي.

ذاكرة الوكيل تعتمد بنية قابلة للتوصيل تغطي تاريخ المحادثة والحالة الدائمة والاسترجاع المتجهي. لست مقيدًا بخلفية ذاكرة واحدة.

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

هل ينبغي أن تهاجر؟

إن كنت على Semantic Kernel أو AutoGen، فالجواب في النهاية نعم. نشرت مايكروسوفت أدلة هجرة مخصصة لكليهما تتضمن تحليل الكود وخططًا خطوة بخطوة. والإطار موضوع صراحةً كالجيل التالي لكلا المشروعين، وهذا يخبرك أين تتجه الاستثمارات.

التسلسل العملي الذي نوصي به:

1. ابدأ بالعمل الجديد. ابنِ وكيلك القادم على Agent Framework بدل تعديل نظام يعمل بالفعل.
2. هاجر مشاريع AutoGen قبل مشاريع Semantic Kernel. تجريدات AutoGen تنطبق بشكل أقرب على نموذج الوكيل الجديد.
3. احجز التدفقات للعمليات التي تفهمها مسبقًا. لا تستخدم المحرك الرسومي لاكتشاف عملية أعمالك، بل لترميز عملية رسمتها بالفعل.
4. فعّل الوسيط والقياس عن بُعد من اليوم الأول. إضافة المراقبة لاحقًا على نظام وكلاء حيّ أصعب بكثير من البدء بها.

تحذير من ملاحظات الإصدار يستحق التكرار: إن ربطت Agent Framework بخوادم أو وكلاء أو نماذج من أطراف ثالثة خارج Azure، فهي تخضع لشروط ترخيصها الخاصة وأنت مسؤول عن البيانات التي تتدفق إليها. وللفرق في منطقة الشرق الأوسط وشمال إفريقيا العاملة تحت متطلبات إقامة البيانات، يجب مراجعة هذا الحد صراحةً قبل ربط أي شيء خارج نطاق الامتثال لديك.

الصورة الأكبر

Agent Framework 1.0 ليس فكرة جديدة — إنه توحيد. الإشارة اللافتة أن أطر الوكلاء في الصناعة تتقارب نحو الشكل ذاته: وكلاء ذوو أنواع صريحة، تدفقات رسومية، MCP للأدوات، A2A للتشغيل البيني، ونقاط حفظ للاستدامة. وصل LangGraph إلى ذلك من اتجاه، وAgent Framework من آخر، ومعسكر التنفيذ الدائم من ثالث.

هذا التقارب خبر جيد. فهو يعني أن الأنماط المعمارية التي تتعلمها اليوم قابلة للنقل، وأن الأدوات التي تبنيها على MCP ستظل تعمل بينما تتبدل طبقة الأطر تحتها.

للفرق المستثمرة أصلًا في .NET أو Azure، Agent Framework 1.0 هو الخيار الافتراضي البديهي. ولغيرهم، يستحق الدراسة بوصفه أوضح بيان حتى الآن عن الشكل الذي يفترض أن تبدو عليه منصة وكلاء إنتاجية.

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