Sdílet prostřednictvím

Microsoft Agent Framework

Agent Framework nabízí dvě primární kategorie funkcí:

Description
Agenti Jednotliví agenti, kteří používají LLM ke zpracování vstupů, volání nástrojů a serverů MCP a generování odpovědí. Podporuje Microsoft Foundry, Anthropic, Azure OpenAI, OpenAI, Ollama a more.
Pracovní postupy Pracovní postupy založené na grafech, které propojují agenty a funkce pro vícekrokové úlohy se směrováním s typovou bezpečností, zajištěním kontrolních bodů a podporou pro zapojení člověka do procesu.

Architektura také poskytuje základní stavební bloky, včetně klientů modelu (dokončování chatu a odpovědí), relace agenta pro správu stavu, zprostředkovatele kontextu pro paměť agenta, middleware pro zachycení akcí agenta a klienty MCP pro integraci nástrojů. Tyto komponenty společně poskytují flexibilitu a výkon při vytváření interaktivních, robustních a bezpečných aplikací umělé inteligence.

Začínáme

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}")

Tak je to — agent, který volá LLM a vrátí odpověď. Odtud můžete přidávat nástroje, vícekrokové konverzace, middleware a pracovní postupy pro vytváření produkčních aplikací.

Poznámka:

Agent Framework nenačítá .env soubory automaticky. Pokud chcete použít .env soubor, zavolejte load_dotenv() na začátku aplikace nebo nastavte proměnné prostředí přímo v shellu nebo IDE.

Začínáme – úplný kurz

Kdy používat agenty vs. pracovní postupy

Použít agenta, když... Použijte pracovní postup, když…
Úkol je otevřený nebo konverzační. Proces má dobře definované kroky.
Potřebujete autonomní schopnost používat nástroje a plánovat. Potřebujete explicitní kontrolu nad pořadím provádění.
Stačí jedno volání LLM (pravděpodobně s nástroji). Musí koordinovat více agentů nebo funkcí.

Pokud můžete napsat funkci pro zpracování úlohy, udělejte to místo použití agenta AI.

Proč Agent Framework?

Agent Framework kombinuje jednoduché abstrakce agenta AutoGen s podnikovými funkcemi Sémantické jádro – správou stavu na základě relací, zabezpečením typů, middlewarem, telemetrií – a přidává pracovní postupy založené na grafech pro explicitní orchestraci s více agenty.

Sémantické jádro a AutoGen průkopnickým způsobem představily koncepty agentů AI a orchestrace s více agenty. Agent Framework je přímý následník vytvořený stejnými týmy. Kombinuje jednoduché abstrakce AutoGenu pro vzory s jedním a více agenty s funkcemi Sémantické jádro na podnikové úrovni, jako je správa stavu založená na relacích, bezpečnost typů, filtry, telemetrie a rozsáhlá podpora modelu a vkládání. Kromě sloučení těchto dvou představuje Agent Framework pracovní postupy, které vývojářům poskytují explicitní kontrolu nad cestami provádění více agentů a robustním systémem správy stavů pro dlouhotrvající scénáře a scénáře smyčky pro člověka. Stručně řečeno, Agent Framework je další generace Sémantické jádro i AutoGen.

Další informace o migraci z Sémantické jádro nebo AutoGenu najdete v průvodci Migration z Sémantické jádro a Průvodce migrací z AutoGen.

Sémantické jádro i AutoGen výrazně využily opensourcové komunity a totéž se očekává pro platformu Agent Framework. Microsoft Agent Framework vítá příspěvky a bude se neustále zlepšovat s novými funkcemi a možnostmi.

Důležité

Pokud používáte Microsoft Agent Framework k vytváření aplikací, které pracují se všemi servery třetích stran, agenty, kódem nebo modely bez Azure Direct ("Systémy třetích stran"), uděláte to na vlastní nebezpečí. Systémy třetích stran nejsou Microsoft Produkty podle Microsoft Podmínek produktu a řídí se vlastními licenčními podmínkami třetích stran. Zodpovídáte za veškeré využití a související náklady.

Doporučujeme zkontrolovat veškerá data sdílená se systémy třetích stran a přijímat je ze systémů třetích stran a seznámit se s postupy třetích stran pro zpracování, sdílení, uchovávání a umístění dat. Je vaší zodpovědností spravovat, zda budou vaše data přenášena mimo shodu s Azure a geografické hranice vaší organizace, včetně veškerých souvisejících důsledků, a zajistit, aby byla zřízena příslušná oprávnění, hranice a schválení.

Zodpovídáte za pečlivou kontrolu a testování aplikací, které vytváříte pomocí Microsoft Agent Framework v kontextu konkrétních případů použití, a za veškerá vhodná rozhodnutí a přizpůsobení. To zahrnuje implementaci vlastního zodpovědného zmírnění rizik umělé inteligence, jako jsou metaprompt, filtry obsahu nebo jiné bezpečnostní systémy, a zajištění toho, aby vaše aplikace splňovaly příslušné standardy kvality, spolehlivosti, zabezpečení a důvěryhodnosti. Viz také: Nejčastější dotazy k transparentnosti

Další kroky

Krok 1: Váš první agent

Jděte hlouběji:

  • Last updated on