Microsoft Ügynök-keretrendszer

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 a Microsoft Foundry, Anthropic, Azure OpenAI, OpenAI, Ollama és több rendszert.
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 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.foundry import FoundryChatClient
    from azure.identity import AzureCliCredential

    credential = AzureCliCredential()
    client = FoundryChatClient(
        project_endpoint="https://your-foundry-service.services.ai.azure.com/api/projects/your-foundry-project",
        model="gpt-5.4-mini",
        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.

Megjegyzés:

Az Agent Framework nem tölti be automatikusan a .env fájlokat. Ahhoz, hogy egy fájlt használhasson, hívja meg .env az alkalmazás elején, vagy állítson be környezeti változókat közvetlenül a parancssorban vagy az IDE-ben.

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 Szemantikus 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.

Szemantikus kernel és AutoGen úttörője az AI-ügynökök és a többügynök-vezénylés fogalmainak. 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 Szemantikus 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.

A Szemantikus kernel vagy az AutoGen rendszerből való migrálásról további információkért lásd a Szemantikus kernel migrációs útmutatóját és az AutoGen migrációs útmutatóját.

Mind a Szemantikus 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. Microsoft Agent Framework üdvözli a közreműködéseket, és folyamatosan fejleszti az új funkciókat és képességeket.

Fontos

Ha Microsoft Agent Framework használatával olyan alkalmazásokat hoz létre, amelyek külső kiszolgálókkal, ügynökökkel, kóddal vagy nem Azure közvetlen modellekkel ("külső rendszerek") működnek, ezt saját felelősségére teheti meg. A harmadik féltől származó rendszerek nem Microsoft termékek a Microsoft termékfeltételek alapján, és saját, külső licencfeltételeik vonatkoznak magára. A használatért és a kapcsolódó költségekért Ön a felelős.

Javasoljuk, hogy tekintse át a külső rendszerekkel megosztott és fogadott összes adatot, és hogy megismerje az adatok kezelésével, megosztásával, megőrzésével és helyével kapcsolatos harmadik féltől származó eljárásokat. Az Ön felelőssége annak kezelése, hogy az adatok a szervezet Azure megfelelőségi és földrajzi határain, valamint a kapcsolódó következményeken kívül fognak-e áramlani, valamint hogy a megfelelő engedélyek, határok és jóváhagyások ki vannak-e építve.

Ön felelős azért, hogy gondosan áttekintse és tesztelje azokat az alkalmazásokat, amelyeket Microsoft Agent Framework használatával hoz létre az adott használati esetek kontextusában, és minden megfelelő döntést és testreszabást meghoz. Ez magában foglalja a saját felelős AI-kockázatcsökkentések, például metaprompt, tartalomszűrők vagy egyéb biztonsági rendszerek implementálását, valamint annak biztosítását, hogy az alkalmazások megfeleljenek a megfelelő minőségi, megbízhatósági, biztonsági és megbízhatósági szabványoknak. Lásd még: Átláthatóság – gyakori kérdések

Következő lépések

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

Mélyedjen el:

  • Last updated on