إطار عمل وكيل Microsoft

يجمع إطار عمل العامل بين أربعة مجالات أساسية:

	Description
الوكلاء	العوامل الفردية التي تستخدم LLMs لمعالجة المدخلات وأدوات الاتصال وخوادم MCP وإنشاء الاستجابات. يدعم Microsoft Foundry Anthropic Azure OpenAI وOpenAI وOllama والمزيد.
عامل Harness	عامل ذو آراء مع قدرات مضمنة بالبطاريات للمهام الطويلة متعددة الخطوات - التخطيط وتعقب المهام، وضغط السياق، والوصول إلى الملفات والذاكرة، وعدم الموافقة على الأداة مرة أخرى، وإمكانية الملاحظة.
مهام سير العمل	مهام سير العمل الوظيفية والمستندة إلى الرسم البياني التي تربط الوكلاء والوظائف من خلال مسارات التنفيذ الصريحة.
عمليات التكامل	الاتصالات بموفري النماذج وخدمات الوكلاء والأدوات وموفري السياق والبرامج الوسيطة وخدمات التقييم وأطر عمل واجهة المستخدم، التي ينظمها الموفر والمكون.

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

Important

إطار عمل العامل ل Go في المعاينة العامة. العوامل التعريفية و RAG وCodeAct ومهام سير العمل الوظيفية غير متوفرة بعد. مشاكل الملفات على GitHub (https://github.com/microsoft/agent-framework-go/issues).

Get started

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

using System;
using Azure.AI.Projects;
using Azure.Identity;
using Microsoft.Agents.AI;

AIAgent agent = new AIProjectClient(
        new Uri("https://your-foundry-service.services.ai.azure.com/api/projects/your-foundry-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?"));

pip install agent-framework

from agent_framework import Agent
from agent_framework.foundry import FoundryChatClient
from azure.identity import AzureCliCredential

agent = Agent(
    client=FoundryChatClient(
        project_endpoint="https://your-foundry-service.services.ai.azure.com/api/projects/your-foundry-project",
        model="gpt-5.4-mini",
        credential=AzureCliCredential(),
    ),
    name="HelloAgent",
    instructions="You are a friendly assistant. Keep your answers brief.",
)

# Non-streaming: get the complete response at once
result = await agent.run("What is the largest city in France?")
print(f"Agent: {result}")

go get github.com/microsoft/agent-framework-go

package main

import (
    "context"
    "fmt"
    "os"

    "github.com/microsoft/agent-framework-go/agent"
    "github.com/microsoft/agent-framework-go/provider/foundryprovider"

    "github.com/Azure/azure-sdk-for-go/sdk/azidentity"
)

func main() {
    endpoint := os.Getenv("FOUNDRY_PROJECT_ENDPOINT")
    model := os.Getenv("FOUNDRY_MODEL")

    token, err := azidentity.NewDefaultAzureCredential(nil)
    if err != nil {
        panic(err)
    }

    a := foundryprovider.NewAgent(
        endpoint,
        token,
        foundryprovider.ModelDeployment(model),
        foundryprovider.AgentConfig{
            Instructions: "You are a friendly assistant. Keep your answers brief.",
            Config: agent.Config{
                Name: "HelloAgent",
            },
        },
    )

    resp, err := a.RunText(context.Background(), "What is the largest city in France?").Collect()
    fmt.Println(resp, err)
}

هذا كل شيء - عامل يستدعي LLM ويعيد استجابة. من هنا يمكنك إضافة أدواتومحادثات متعددة الأدواروالبرامج الوسيطةومهام سير العمل لإنشاء تطبيقات الإنتاج.

Note

لا يقوم إطار عمل العامل بتحميل .env الملفات تلقائيا. لاستخدام .env ملف، قم باستدعاء load_dotenv() في بداية التطبيق الخاص بك، أو قم بتعيين متغيرات البيئة مباشرة في shell أو IDE.

بدء الاستخدام — البرنامج التعليمي الكامل

متى تستخدم العوامل مقابل مهام سير العمل

استخدام عامل عندما...	استخدام سير عمل عندما...
المهمة مفتوحة أو محادثة	تحتوي العملية على خطوات محددة جيدا
تحتاج إلى استخدام وتخطيط أداة مستقلة	تحتاج إلى تحكم صريح في أمر التنفيذ
يكفي استدعاء LLM واحد (ربما مع الأدوات)	يجب تنسيق عوامل أو وظائف متعددة

إذا كان بإمكانك كتابة دالة للتعامل مع المهمة، فقم بذلك بدلا من استخدام عامل الذكاء الاصطناعي.

لماذا إطار عمل العامل؟

يجمع إطار عمل العامل بين تجريدات عامل AutoGen البسيطة وميزات المؤسسة نواة دلالية - إدارة الحالة المستندة إلى الجلسة، وسلامة النوع، والبرامج الوسيطة، وبيانات تتبع الاستخدام - ويضيف مهام سير العمل المستندة إلى الرسم البياني للتنسيق الصريح متعدد العوامل.

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

لمعرفة المزيد حول الترحيل من نواة دلالية أو AutoGen، راجع دليل الترحيل من نواة دلاليةودليل الترحيل من AutoGen.

استفاد كل من نواة دلالية و AutoGen بشكل كبير من مجتمع المصدر المفتوح، ومن المتوقع أن يكون نفس الشيء لإطار عمل العامل. ترحب Microsoft Agent Framework بالمساهمات وستستمر في التحسين باستخدام الميزات والقدرات الجديدة.

Important

إذا كنت تستخدم Microsoft Agent Framework لإنشاء تطبيقات تعمل مع أي خوادم أو عوامل أو تعليمات برمجية أو نماذج مباشرة غير Azure ("أنظمة الجهات الخارجية")، فإنك تفعل ذلك على مسؤوليتك الخاصة. أنظمة الطرف الثالث هي منتجات غير تابعة ل Microsoft بموجب شروط منتجات Microsoft وتخضع لشروط ترخيص طرف ثالث خاصة بها. أنت مسؤول عن أي تكاليف استخدام وتكاليف مرتبطة.

نوصي بمراجعة جميع البيانات التي تتم مشاركتها وتلقيها من أنظمة الجهات الخارجية والإدراك بممارسات الجهات الخارجية للتعامل مع البيانات ومشاركتها والاحتفاظ بها وموقعها. تقع على عاتقك مسؤولية إدارة ما إذا كانت بياناتك ستتدفق خارج حدود التوافق Azure والجغرافية لمؤسستك وأي آثار ذات صلة، وتوفير الأذونات والحدود والموافقات المناسبة.

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

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

الخطوة 1: الوكيل الأول

انتقل إلى أبعد من ذلك:

• العوامل - وقت التشغيل والتنفيذ وأنواع الوكلاء والمحادثات والبرامج الوسيطة والسلامة
• Agent Harness — البنية وتكوين القدرة والتخصيص للعمل طويل الأمد
• مهام سير العمل - واجهات برمجة التطبيقات الوظيفية والرسم البياني والتنفيذ والحالة والتكوين المتقدم
• عمليات التكامل - موفرو ومكونات النماذج وخدمات الوكيل والأدوات والسياق والبرامج الوسيطة والتقييم وواجهة المستخدم