Microsoft Agent Framework 1.0: خرج من preview — متى تتبنّاه ومتى تفضّل LangGraph

المشكلة باختصار

قبل إبريل 2026 كان لازم تختار: Semantic Kernel لو عايز connectors ناضجة، AutoGen لو عايز multi-agent orchestration، LangGraph لو شغّال Python بس. كل مشروع كان بيبني طبقة دمج يدوية فوقهم. النسخة 1.0 بتدمج SK كأساس، وبتبني فوقه workflow engine مبني على graph مستلهَم من AutoGen، ضمن SDK واحد يدعم .NET 8+ و Python 3.10+.

إيه اللي تغير فعلاً في 1.0

الإعلان الرسمي من فريق Microsoft Agent Framework حدد 3 نقاط غير قابلة للتفاوض للإنتاج:

• APIs مستقرة: breaking changes هتتبع SemVer، ومفيش حذف APIs بدون deprecation period.
• Long-term support: نفس عقد الدعم اللي بتاخده مع .NET LTS، يعني patches أمنية مضمونة.
• Connectors جاهزة: Azure OpenAI, OpenAI, Anthropic Claude, Amazon Bedrock, Google Gemini, Ollama — كلها first-party.

فيه كمان 5 أنماط orchestration مبنية جاهزة: sequential, concurrent, handoff, group chat, و Magentic-One (نمط البحث متعدد الخطوات اللي خرج من Microsoft Research).

كود حقيقي: agent بسيط بـ tool واحد

المثال ده هو أقل كود ممكن تبدأ بيه في Python. بيبني agent يستخدم OpenAI مع function calling لحساب مجموع:

from agent_framework import ChatAgent, tool
from agent_framework.openai import OpenAIChatClient

@tool
def add_numbers(a: float, b: float) -> float:
    """Return the sum of two numbers."""
    return a + b

agent = ChatAgent(
    name="Calc",
    client=OpenAIChatClient(model="gpt-4.1"),
    instructions="You answer math questions by calling tools.",
    tools=[add_numbers],
)

result = agent.run("احسب 137 + 265")
print(result.content)

في C# نفس الفكرة بـ 12 سطر تقريبًا باستخدام Microsoft.Agents.AI namespace. اللي كان يتاخد يوم في Semantic Kernel الأول، بقى خمس دقائق.

متى تكسب فعلاً من التحويل

استخدم Agent Framework 1.0 لو ظروفك بتطابق على الأقل تلاتة من الخمسة دول:

1. عندك أكتر من agent بيتبادلوا context (مثل agent بيحلل data + agent بيكتب report).
2. بتحتاج تبدّل بين providers (Azure OpenAI في production، Ollama محليًا) بدون rewrite.
3. الـ stack بتاعك .NET أساسًا، ومفيش حل ناضج بخلاف ده.
4. بتحتاج MCP tools جاهزة من غير ما تبني adapter لكل واحدة.
5. فريق enterprise عايز SLA على الـ SDK نفسه.

الـ trade-off هنا: بتكسب orchestration و observability جاهزين، بتخسر حوالي 40–60MB RAM لكل agent بسبب الـ runtime overhead، وبتتقيد بنمط الـ graph اللي Microsoft اختاره. لو حجمك أقل من 100 agent invocation/دقيقة، الفرق ده غير محسوس.

مقارنة سريعة مع البدائل

فيه تلاتة بدائل جادّة لازم تفاضل بينهم قبل ما تختار:

• LangGraph: أقوى في تعريف graph complex، بس Python-only. لو فريقك C# ده خروج.
• Semantic Kernel لوحده: لسه بيتطوّر كطبقة أساس لـ Agent Framework، فـ مفيش سبب تستخدمه مباشرة في مشروع جديد.
• AutoGen القديم (0.2): Microsoft وضّحت إن Agent Framework هو الخليفة الرسمي. لو عندك كود قديم على AutoGen 0.2، متستعجلش بالـ migration — استنى 3 شهور على الأقل عشان tooling الترحيل ينضج.

القرار المبني على الأرقام: لو بتبني من الصفر في أبريل 2026 وعندك أي جانب .NET في الـ stack، Agent Framework 1.0 هو الخيار الافتراضي. غير كده LangGraph لسه أقوى في الـ Python-only scenarios المعقدة.

متى لا تستخدم Agent Framework 1.0

متحطّش نفسك في الـ framework ده لو:

• بتعمل single-call prompt بدون tools — استخدم SDK الخام لـ OpenAI/Anthropic مباشرة، هيكون أبسط وأسرع.
• عندك < 50K request في الشهر ومفيش multi-agent — الـ abstraction overhead مش مبرّر.
• بتشغّل على edge devices بذاكرة محدودة (مثل Raspberry Pi) — الـ runtime تقيل عليها.
• بتحتاج custom orchestration logic مش موجود في الـ 5 patterns الجاهزة، ومش عايز تتعلم الـ graph engine.

الخطوة التالية

لو قرّرت تجرّب: افتح مشروع جديد، ثبّت pip install agent-framework أو dotnet add package Microsoft.Agents.AI، واكتب نفس الـ tool اللي فوق. لو الـ agent رد صح في المحاولة الأولى، ابني فوقه. لو لأ، المشكلة غالبًا في الـ model provider configuration مش في الـ framework.

المصادر

• إعلان Microsoft الرسمي على devblogs: Microsoft Agent Framework Version 1.0 (3 أبريل 2026).
• Visual Studio Magazine: "Microsoft Ships Production-Ready Agent Framework 1.0 for .NET and Python" (6 أبريل 2026).
• Techstrong.ai: "Microsoft Ships Agent Framework 1.0: A Production-Ready Foundation for Multi-Agent AI".
• Microsoft Learn: Agent Framework Overview documentation.
• devblogs.microsoft.com/semantic-kernel: مقال "Semantic Kernel and Microsoft Agent Framework" اللي يوضّح علاقة SK بـ Agent Framework.