Microsoft Agent Framework

Az Agent Framework a képességek két elsődleges kategóriáját kínálja:

	Description
Ügynökök	Egyéni ügynökök, amelyek LLM-eket használnak bemenetek feldolgozására, eszközök és MCP-kiszolgálók hívására és válaszok létrehozására. Támogatja az Azure OpenAI-t, az OpenAI-t, az antropikust, az Ollama-t és egyebeket.
Munkafolyamatok	Gráfalapú munkafolyamatok, amelyek ügynököket és függvényeket kapcsolnak össze többlépéses feladatokhoz, típusbiztos útválasztással, ellenőrzőpontokkal és emberi beavatkozással.

A keretrendszer alapvető építőelemeket is kínál, beleértve a modellügyfeleket (csevegések befejezése és válaszok), az állapotkezelés ügynök munkamenetét, az ügynökmemória környezetszolgáltatóit, az ügynökműveletek elfogására szolgáló köztes szoftvereket és az eszközintegrációhoz szükséges MCP-ügyfeleket. Ezek az összetevők együttesen biztosítják az interaktív, robusztus és biztonságos AI-alkalmazások készítésének rugalmasságát és erejét.

Első lépések

dotnet add package Azure.AI.OpenAI --prerelease
dotnet add package Azure.Identity
dotnet add package Microsoft.Agents.AI.OpenAI --prerelease

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

AIAgent agent = new AzureOpenAIClient(
        new Uri(Environment.GetEnvironmentVariable("AZURE_OPENAI_ENDPOINT")!),
        new AzureCliCredential())
    .GetChatClient("gpt-4o-mini")
    .AsAIAgent(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 --pre

    credential = AzureCliCredential()
    client = AzureOpenAIResponsesClient(
        project_endpoint=os.environ["AZURE_AI_PROJECT_ENDPOINT"],
        deployment_name=os.environ["AZURE_OPENAI_RESPONSES_DEPLOYMENT_NAME"],
        credential=credential,
    )

    agent = client.as_agent(
        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}")

Ez az – egy ügynök, amely meghív egy LLM-et, és választ ad vissza. Innen hozzáadhat eszközöket, többfordulós beszélgetéseket, köztes szoftvereket és munkafolyamatokat az éles alkalmazások létrehozásához.

Első lépések – teljes oktatóanyag

Mikor érdemes ügynököket és munkafolyamatokat használni?

Használjon ügynököt amikor...	Akkor használjon munkafolyamatot, amikor…
A tevékenység nyitott vagy társalgási jellegű	A folyamat jól meghatározott lépéseket tartalmaz
Autonóm eszközök használatára és tervezésre van szüksége	Explicit vezérlésre van szüksége a végrehajtási sorrend felett
Elegendő egyetlen LLM-hívás (esetleg eszközökkel)	Több ügynöknek vagy függvénynek kell koordinálnia

Ha meg tud írni egy függvényt a feladat kezeléséhez, tegye azt AI-ügynök használata helyett.

Miért az Ügynök-keretrendszer?

Az Agent Framework egyesíti az AutoGen egyszerű ügynök-absztrakcióit a Szemantic Kernel vállalati funkcióival – munkamenet-alapú állapotkezelés, típusbiztonság, köztes szoftver, telemetria – és gráfalapú munkafolyamatokat ad hozzá explicit többügynök-vezényléshez.

A Szemantic Kernel és az AutoGen úttörőként használták az AI-ügynökök és a többügynökök vezénylésének fogalmait. Az Agent Framework az ugyanazok a csapatok által létrehozott közvetlen utód. Egyesíti az AutoGen egyszerű absztrakcióit az egy- és többügynök-mintákhoz a Szemantic Kernel nagyvállalati szintű funkcióival, például a munkamenet-alapú állapotkezeléssel, a típusbiztonsággal, a szűrőkkel, a telemetriával és a széles körű modell- és beágyazási támogatással. A kettő egyesítését követően az Agent Framework olyan munkafolyamatokat vezet be, amelyek explicit vezérlést biztosítanak a fejlesztőknek a többügynök-végrehajtási útvonalak felett, valamint egy robusztus állapotkezelő rendszert a hosszú ideig futó és az emberi környezetben futó forgatókönyvekhez. Röviden, az Agent Framework a szemantikus kernel és az AutoGen következő generációja.

Ha többet szeretne megtudni a szemantikus kernelről vagy az AutoGenről való migrálásról, tekintse meg az AutoGen szemantikai kernel- és migrálási útmutatójában található migrálási útmutatót.

Mind a Szemantic Kernel, mind az AutoGen jelentősen kihasználta a nyílt forráskódú közösség előnyeit, és ugyanez várható az Agent Framework esetében is. A Microsoft Agent Framework üdvözli a közreműködéseket, és folyamatosan fejleszti az új funkciókat és képességeket.

Megjegyzés:

A Microsoft Agent Framework jelenleg nyilvános előzetes verzióban érhető el. Küldjön visszajelzést vagy problémát a GitHub-adattárban.

Fontos

Ha a Microsoft Agent Framework használatával olyan alkalmazásokat hoz létre, amelyek külső kiszolgálókkal vagy ügynökökkel működnek, ezt saját felelősségére teheti meg. Javasoljuk, hogy tekintse át a külső kiszolgálókkal vagy ügynökökkel megosztott összes adatot, és hogy megismerje az adatok megőrzésére és elhelyezésére vonatkozó, harmadik féltől származó eljárásokat. Az Ön felelőssége annak kezelése, hogy az adatok a szervezet Azure-beli megfelelőségi és földrajzi határain kívülre kerülnek-e, valamint az ezzel kapcsolatos következményekkel.

Következő lépések

1. lépés: Az első ügynök

Mélyedjen el:

• Ügynökök áttekintése – architektúra, szolgáltatók, eszközök
• Munkafolyamatok áttekintése – szekvenciális, egyidejű, elágaztatási
• Integrációk – A2A, AG-UI, Azure Functions, M365