agenttypen voor Microsoft Agent Framework

Alle agents zijn afgeleid van een algemene basisklasse, AIAgentdie een consistente interface biedt voor alle agenttypen. Hiermee kunt u algemene, agentagnostische functionaliteit op een hoger niveau bouwen, zoals coördinaties met meerdere agenten.

Alle agents zijn afgeleid van een algemene basisklasse, Agentdie een consistente interface biedt voor alle agenttypen. Hiermee kunt u algemene, agentagnostische functionaliteit op een hoger niveau bouwen, zoals coördinaties met meerdere agenten.

Eenvoudige agents op basis van inferentieservices

Met Agent Framework kunt u eenvoudig eenvoudige agents maken op basis van veel verschillende deductieservices. Elke deductieservice die een Microsoft.Extensions.AI.IChatClient-implementatie biedt, kan worden gebruikt om deze agents te bouwen. De Microsoft.Agents.AI.ChatClientAgent is de agentklasse die wordt gebruikt om een agent te bieden voor elke IChatClient-implementatie.

Deze agents bieden ondersteuning voor een breed scala aan functionaliteit:

1. Functie aanroepen.
2. Gesprekken met meerdere beurten waarbij het beheer van de chatgeschiedenis lokaal of door de service wordt verzorgd.
3. Door aangepaste service geleverde hulpprogramma's (bijvoorbeeld MCP, code-uitvoering).
4. Gestructureerde uitvoer.

Als u een van deze agents wilt maken, maakt u gewoon een ChatClientAgent met behulp van de IChatClient implementatie van uw keuze.

using Microsoft.Agents.AI;

var agent = new ChatClientAgent(chatClient, instructions: "You are a helpful assistant");

Om het maken van deze agents nog eenvoudiger te maken, biedt Agent Framework helpers voor veel populaire services. Zie de documentatie voor elke service voor meer informatie.

Complexe aangepaste agents

Het is ook mogelijk om agents volledig op maat te maken, in plaats van slechts als wrappers rond een IChatClient. Het agentframework biedt het AIAgent basistype. Dit basistype is de kernabstractie voor alle agents, die, wanneer subklassen worden gebruikt, volledige controle over het gedrag en de mogelijkheden van de agent mogelijk maakt.

Voor meer informatie, zie de documentatie voor aangepaste agenten.

Proxy's voor externe agents

Agent Framework biedt kant-en-klare AIAgent implementaties voor algemene service-gehoste agentprotocollen, zoals A2A. Op deze manier kunt u eenvoudig verbinding maken met externe agents en deze gebruiken vanuit uw toepassing.

Zie de documentatie voor elk type agent voor meer informatie:

Referentie voor Azure- en OpenAI SDK-opties

Wanneer u Foundry gebruikt, Azure OpenAI-, OpenAI-services of Antropische services, hebt u verschillende SDK-opties om verbinding te maken met deze services. In sommige gevallen is het mogelijk om meerdere SDK's te gebruiken om verbinding te maken met dezelfde service of om dezelfde SDK te gebruiken om verbinding te maken met verschillende services. Hier volgt een lijst met de verschillende opties die beschikbaar zijn met de URL die u moet gebruiken bij het maken van verbinding met elke url. Zorg ervoor dat u <resource> en <project> vervangt met uw werkelijke resource- en projectnamen.

1. Upgrading from Azure OpenAI to Foundry
2. U wordt aangeraden de OpenAI SDK te gebruiken.
3. Hoewel het raadzaam is om de OpenAI SDK te gebruiken voor toegang tot Foundry-modellen, ondersteunen Foundry-modellen modellen van veel verschillende leveranciers, niet alleen OpenAI. Al deze modellen worden ondersteund via de OpenAI SDK.

De OpenAI SDK gebruiken

Zoals wordt weergegeven in de bovenstaande tabel, kan de OpenAI SDK worden gebruikt om verbinding te maken met meerdere services. Afhankelijk van de service waarmee u verbinding maakt, moet u mogelijk een aangepaste URL instellen bij het maken van de OpenAIClient. U kunt ook verschillende verificatiemechanismen gebruiken, afhankelijk van de service.

Als een aangepaste URL is vereist (zie de bovenstaande tabel), kunt u deze instellen via de OpenAIClientOptions.

var clientOptions = new OpenAIClientOptions() { Endpoint = new Uri(serviceUrl) };

Het is mogelijk om een API-sleutel te gebruiken bij het maken van de client.

OpenAIClient client = new OpenAIClient(new ApiKeyCredential(apiKey), clientOptions);

Wanneer u een Azure Service gebruikt, is het ook mogelijk om Azure referenties te gebruiken in plaats van een API-sleutel.

OpenAIClient client = new OpenAIClient(new BearerTokenPolicy(new DefaultAzureCredential(), "https://ai.azure.com/.default"), clientOptions)

Zodra u de OpenAIClient hebt gemaakt, kunt u een subclient ophalen voor de specifieke service die u wilt gebruiken en vervolgens een AIAgent daarvan maken.

AIAgent agent = client
    .AsAIAgent(model: model, instructions: "You are good at telling jokes.", name: "Joker");

De AZURE AI Projects SDK gebruiken

Deze SDK kan worden gebruikt om verbinding te maken met Foundry-services. U moet de juiste eindpunt-URL voor het project opgeven bij het maken van de AIProjectClient. Zie de bovenstaande tabel voor de juiste URL die u wilt gebruiken.

AIAgent agent = new AIProjectClient(
    new Uri(serviceUrl),
    new DefaultAzureCredential())
     .AsAIAgent(
         model: deploymentName,
         instructions: "You are good at telling jokes.",
         name: "Joker");

De AZURE AI Projects SDK gebruiken met Foundry Agents

Deze SDK wordt gebruikt voor zowel Responses API gebaseerde agents als voor versioned Foundry Agents. Zie de bovenstaande tabel voor de juiste URL die u wilt gebruiken.

var aiProjectClient = new AIProjectClient(new Uri(serviceUrl), new DefaultAzureCredential());
AIAgent agent = aiProjectClient.AsAIAgent(
    model: deploymentName,
    instructions: "You are good at telling jokes.",
    name: "Joker");

De Foundry Antropic SDK gebruiken

De resource is de naam van het subdomein/voornaam die vóór .services.ai.azure.com in de eindpunt-URI wordt weergegeven.

Bijvoorbeeld: https://(resource name).services.ai.azure.com/anthropic/v1/chat/completions

var client = new AnthropicFoundryClient(new AnthropicFoundryApiKeyCredentials(apiKey, resource));
AIAgent agent = client.AsAIAgent(
    model: deploymentName,
    instructions: "Joker",
    name: "You are good at telling jokes.");

Anthropic SDK gebruiken

var client = new AnthropicClient() { ApiKey = apiKey };
AIAgent agent = client.AsAIAgent(
    model: deploymentName,
    instructions: "Joker",
    name: "You are good at telling jokes.");

Eenvoudige agents op basis van inferentieservices

Met Agent Framework kunt u eenvoudig eenvoudige agents maken op basis van veel verschillende deductieservices. Elke deductieservice die een implementatie van een chatclient biedt, kan worden gebruikt om deze agents te bouwen. Dit kan worden gedaan met behulp van het SupportsChatGetResponse protocol, waarmee een standaard wordt gedefinieerd voor de methoden die een client moet ondersteunen voor gebruik met de standaardklasse Agent .

Deze agents bieden ondersteuning voor een breed scala aan functionaliteit:

1. Functie oproepen
2. Gesprekken met meer gespreksrondes met lokaal beheer van chatgeschiedenis of door de service geboden beheer van chatgeschiedenis
3. Door aangepaste service geleverde hulpprogramma's (bijvoorbeeld MCP, code-uitvoering)
4. Gestructureerde uitvoer
5. Streamingantwoorden

Als u een van deze agents wilt maken, maakt u eenvoudigweg een Agent door gebruik te maken van de implementatie van de chatclient van uw keuze.

import os
from agent_framework import Agent
from agent_framework.foundry import FoundryChatClient
from azure.identity.aio import DefaultAzureCredential

agent = Agent(
    client=FoundryChatClient(
        credential=DefaultAzureCredential(),
        project_endpoint=os.getenv("FOUNDRY_PROJECT_ENDPOINT"),
        model=os.getenv("FOUNDRY_MODEL"),
    ),
    instructions="You are a helpful assistant",
)
response = await agent.run("Hello!")

U kunt ook de gemaksmethode op de chatclient gebruiken:

from agent_framework.foundry import FoundryChatClient
from azure.identity.aio import DefaultAzureCredential

agent = FoundryChatClient(
    credential=DefaultAzureCredential(),
    project_endpoint=os.getenv("FOUNDRY_PROJECT_ENDPOINT"),
    model=os.getenv("FOUNDRY_MODEL"),
).as_agent(
    instructions="You are a helpful assistant"
)

Zie de secties over agentspecifieke documentatie hieronder voor gedetailleerde voorbeelden.

Ondersteunde chatproviders

Aangepaste opslag van chatgeschiedenis wordt ondersteund wanneer de sessiegebaseerde gespreksstatus wordt ondersteund.

Streamingreacties

Agents ondersteunen zowel reguliere als streamingreacties:

# Regular response (wait for complete result)
response = await agent.run("What's the weather like in Seattle?")
print(response.text)

# Streaming response (get results as they are generated)
async for chunk in agent.run("What's the weather like in Portland?", stream=True):
    if chunk.text:
        print(chunk.text, end="", flush=True)

Zie voor streamingvoorbeelden:

• Voorbeelden van foundrystreaming
• Voorbeelden van het streamen van Azure OpenAI Chat Completion
• Azure Voorbeelden van streaming van OpenAI-antwoorden
• OpenAI Chat Completion streamvoorbeelden
• Voorbeelden van streaming van OpenAI-antwoorden

Zie Agents uitvoeren voor meer aanroeppatronen.

Functiehulpmiddelen

U kunt functiehulpprogramma's aan agents bieden voor verbeterde mogelijkheden:

import os
from typing import Annotated
from azure.identity.aio import DefaultAzureCredential
from agent_framework.foundry import FoundryChatClient

def get_weather(location: Annotated[str, "The location to get the weather for."]) -> str:
    """Get the weather for a given location."""
    return f"The weather in {location} is sunny with a high of 25°C."

async with DefaultAzureCredential() as credential:
    agent = FoundryChatClient(
        credential=credential,
        project_endpoint=os.getenv("FOUNDRY_PROJECT_ENDPOINT"),
        model=os.getenv("FOUNDRY_MODEL"),
    ).as_agent(
        instructions="You are a helpful weather assistant.",
        tools=get_weather,
    )
    response = await agent.run("What's the weather in Seattle?")

Zie Tools overzicht voor hulpprogramma's en hulpprogrammapatronen.

Aangepaste agenten

Zie Aangepaste agents voor volledig aangepaste implementaties (bijvoorbeeld deterministische agents of door API ondersteunde agents). Op deze pagina wordt het implementeren SupportsAgentRun of uitbreiden BaseAgentbeschreven, inclusief streaming-updates met AgentResponseUpdate.

Andere agenttypen

Agent Framework bevat ook agents met protocolsteun, zoals: