Skip to main content

Microsoft-Agent-Framework-Integration

Verwenden Sie das Copilot SDK als Agentanbieter innerhalb des Microsoft Agent Framework (MAF), um Multi-Agent-Workflows zusammen mit Azure OpenAI, Anthropic und anderen Anbietern zu verfassen.

Übersicht

Das Microsoft Agent Framework ist der einheitliche Nachfolger von Semantischer Kernel und AutoGen. Es bietet eine Standardschnittstelle zum Erstellen, Orchestrieren und Bereitstellen von KI-Agents. Mit dedizierten Integrationspaketen können Sie einen Copilot SDK-Client als erstklassigen MAF-Agent umschließen – austauschbar mit jedem anderen Agent-Anbieter im Framework.

KonzeptBeschreibung
Microsoft Agent FrameworkOpen-Source-Framework für die Einzel- und Multi-Agent-Orchestrierung in .NET und Python
AgentanbieterEin Back-End, das einen Agent unterstützt (Copilot, Azure OpenAI, Anthropic usw.)
OrchestratorEine MAF-Komponente, die Agenten in sequenziellen, gleichzeitigen oder Übergabeworkflows koordiniert
A2A-ProtokollVom Framework unterstützte Agent-zu-Agent-Kommunikationsstandard

Hinweis

MAF-Integrationspakete sind für .NET und Python verfügbar. Verwenden Sie für TypeScript, Go, Java und Rust das Copilot SDK direkt – die standardmäßigen SDK-APIs bieten bereits Toolaufrufe, Streaming und benutzerdefinierte Agents.

Voraussetzungen

Bevor Sie beginnen, stellen Sie sicher, dass Sie folgendes haben:

  • Ein funktionierendes Erstellen Sie Ihre erste Copilot-gestützte App in Ihrer Wahlsprache
  • Ein GitHub Copilot-Abonnement (Einzel-, Geschäfts- oder Unternehmensabonnement)
  • Die Copilot-CLI ist installiert oder über die im SDK gebündelte CLI verfügbar

Installation

Installieren Sie das Copilot SDK zusammen mit dem MAF-Integrationspaket für Ihre Sprache:

Codesprachen navigation

.NET
dotnet add package GitHub.Copilot.SDK
dotnet add package Microsoft.Agents.AI.GitHub.Copilot --prerelease

Grundlegende Nutzung

Schließen Sie den Copilot SDK-Client als MAF-Agent mit einem einzelnen Methodenaufruf um. Der resultierende Agent entspricht der Standardschnittstelle des Frameworks und kann überall verwendet werden, wo ein MAF-Agent erwartet wird.

Codesprachen navigation

.NET
using GitHub.Copilot;
using Microsoft.Agents.AI;

await using var copilotClient = new CopilotClient();
await copilotClient.StartAsync();

// Wrap as a MAF agent
AIAgent agent = copilotClient.AsAIAgent();

// Use the standard MAF interface
string response = await agent.RunAsync("Explain how dependency injection works in ASP.NET Core");
Console.WriteLine(response);

Hinzufügen von benutzerdefinierten Tools

Erweitern Sie Ihre Copilot-Agent mit benutzerdefinierten Funktionstools. Tools, die über das Standard-Copilot SDK definiert sind, sind automatisch verfügbar, wenn der Agent innerhalb von MAF ausgeführt wird.

Codesprachen navigation

.NET
using GitHub.Copilot;
using Microsoft.Extensions.AI;
using Microsoft.Agents.AI;

// Define a custom tool
AIFunction weatherTool = CopilotTool.DefineTool(
    (string location) => $"The weather in {location} is sunny with a high of 25°C.",
    factoryOptions: new AIFunctionFactoryOptions
    {
        Name = "GetWeather",
        Description = "Get the current weather for a given location.",
    }
);

await using var copilotClient = new CopilotClient();
await copilotClient.StartAsync();

// Create agent with tools
AIAgent agent = copilotClient.AsAIAgent(new AIAgentOptions
{
    Tools = new[] { weatherTool },
});

string response = await agent.RunAsync("What's the weather like in Seattle?");
Console.WriteLine(response);

Sie können auch die systemeigene Tooldefinition Copilot SDK zusammen mit MAF-Tools verwenden:

Codesprachen navigation

TypeScript
import { CopilotClient, DefineTool } from "@github/copilot-sdk";

const getWeather = DefineTool({
    name: "GetWeather",
    description: "Get the current weather for a given location.",
    parameters: { location: { type: "string", description: "City name" } },
    execute: async ({ location }) => `The weather in ${location} is sunny, 25°C.`,
});

const client = new CopilotClient();
const session = await client.createSession({
    model: "gpt-4.1",
    tools: [getWeather],
    onPermissionRequest: async () => ({ kind: "approve-once" }),
});

await session.sendAndWait({ prompt: "What's the weather like in Seattle?" });

Mehragenten-Workflows

Der Hauptvorteil der MAF-Integration besteht darin, Copilot gemeinsam mit anderen Agent-Anbietern in orchestrierten Workflows zu kombinieren. Verwenden Sie die integrierten Orchestratoren des Frameworks, um Pipelines zu erstellen, in denen verschiedene Agents unterschiedliche Schritte ausführen.

Sequenzieller Workflow

Führen Sie Agenten nacheinander aus, übergeben Sie die Ausgabe von einem an den nächsten:

Codesprachen navigation

.NET
using GitHub.Copilot;
using Microsoft.Agents.AI;
using Microsoft.Agents.AI.Orchestration;

await using var copilotClient = new CopilotClient();
await copilotClient.StartAsync();

// Copilot agent for code review
AIAgent reviewer = copilotClient.AsAIAgent(new AIAgentOptions
{
    Instructions = "You review code for bugs, security issues, and best practices. Be thorough.",
});

// Azure OpenAI agent for generating documentation
AIAgent documentor = AIAgent.FromOpenAI(new OpenAIAgentOptions
{
    Model = "gpt-4.1",
    Instructions = "You write clear, concise documentation for code changes.",
});

// Compose in a sequential pipeline
var pipeline = new SequentialOrchestrator(new[] { reviewer, documentor });

string result = await pipeline.RunAsync(
    "Review and document this pull request: added retry logic to the HTTP client"
);
Console.WriteLine(result);

Gleichzeitiger Workflow

Führen Sie mehrere Agents parallel aus, und aggregieren Sie ihre Ergebnisse:

Codesprachen navigation

.NET
using GitHub.Copilot;
using Microsoft.Agents.AI;
using Microsoft.Agents.AI.Orchestration;

await using var copilotClient = new CopilotClient();
await copilotClient.StartAsync();

AIAgent securityReviewer = copilotClient.AsAIAgent(new AIAgentOptions
{
    Instructions = "Focus exclusively on security vulnerabilities and risks.",
});

AIAgent performanceReviewer = copilotClient.AsAIAgent(new AIAgentOptions
{
    Instructions = "Focus exclusively on performance bottlenecks and optimization opportunities.",
});

// Run both reviews concurrently
var concurrent = new ConcurrentOrchestrator(new[] { securityReviewer, performanceReviewer });

string combinedResult = await concurrent.RunAsync(
    "Analyze this database query module for issues"
);
Console.WriteLine(combinedResult);

Antworten bei Streaming-Diensten

Beim Erstellen interaktiver Anwendungen sollten Antworten von Streaming-Agenten verwendet werden, um die Echtzeitausgabe anzuzeigen. Die MAF-Integration behält die Streamingfunktionen des Copilot SDK bei.

Codesprachen navigation

.NET
using GitHub.Copilot;
using Microsoft.Agents.AI;

await using var copilotClient = new CopilotClient();
await copilotClient.StartAsync();

AIAgent agent = copilotClient.AsAIAgent(new AIAgentOptions
{
    Streaming = true,
});

await foreach (var chunk in agent.RunStreamingAsync("Write a quicksort implementation in C#"))
{
    Console.Write(chunk);
}
Console.WriteLine();

Sie können auch direkt über das Copilot SDK ohne MAF streamen:

Codesprachen navigation

TypeScript
import { CopilotClient } from "@github/copilot-sdk";

const client = new CopilotClient();
const session = await client.createSession({
    model: "gpt-4.1",
    streaming: true,
    onPermissionRequest: async () => ({ kind: "approve-once" }),
});

session.on("assistant.message_delta", (event) => {
    process.stdout.write(event.data.delta ?? "");
});

await session.sendAndWait({ prompt: "Write a quicksort implementation in TypeScript" });

Konfigurationsreferenz

MAF-Agentoptionen

EigentumTypBeschreibung
Instructions / instructionsstringSystemaufforderung für den Agent
Tools / toolsAIFunction[] / listBenutzerdefinierte Funktionstools, die für den Agent verfügbar sind
Streaming / streamingboolStreamingantworten aktivieren
Model / modelstringÜberschreiben des Standardmodells

Copilot SDK-Optionen (übergeben)

Alle Standardoptionen Erstellen Sie Ihre erste Copilot-gestützte App stehen beim Erstellen des zugrunde liegenden Copilot Clients weiterhin zur Verfügung. Der MAF-Wrapper delegiert unter der Haube an das SDK:

SDK-FunktionMAF-Unterstützung
Benutzerdefinierte Tools (DefineTool / AIFunctionFactory)
✅ Mit MAF-Tools zusammengeführt
MCP-Server
✅ Konfiguriert auf dem SDK-Client
Benutzerdefinierte Agenten / Unteragenten
✅ Im Copilot-Agent verfügbar
Unendliche Sitzungen
✅ Konfiguriert auf dem SDK-Client
Modellauswahl
✅ Überschreibbar pro Agent oder pro Anruf
Streamen
✅ Vollständige Delta-Ereignisunterstützung

Bewährte Methoden

Auswählen der richtigen Integrationsebene

Verwenden Sie den MAF-Wrapper, wenn Sie Copilot in orchestrierten Workflows mit anderen Anbietern kombinieren möchten. Wenn Ihre Anwendung nur Copilot verwendet, ist das eigenständige SDK einfacher und bietet Ihnen die vollständige Kontrolle:

// Standalone SDK — full control, simpler setup
import { CopilotClient } from "@github/copilot-sdk";

const client = new CopilotClient();
const session = await client.createSession({
    model: "gpt-4.1",
    onPermissionRequest: async () => ({ kind: "approve-once" }),
});
const response = await session.sendAndWait({ prompt: "Explain this code" });

Agenten fokussiert halten

Geben Sie jedem Agent beim Erstellen von Workflows mit mehreren Agents eine bestimmte Rolle mit klaren Anweisungen. Überlappende Zuständigkeiten vermeiden:

// ❌ Too vague — overlapping roles
const agents = [
    { instructions: "Help with code" },
    { instructions: "Assist with programming" },
];

// ✅ Focused — clear separation of concerns
const agents = [
    { instructions: "Review code for security vulnerabilities. Flag SQL injection, XSS, and auth issues." },
    { instructions: "Optimize code performance. Focus on algorithmic complexity and memory usage." },
];

Handhabung von Fehlern auf der Orchestrierungsebene

Agentenaufrufe in die Fehlerbehandlung verpacken, insbesondere in Multi-Agent-Workflows, damit der Fehler eines Agenten nicht die gesamte Pipeline blockiert:

try
{
    string result = await pipeline.RunAsync("Analyze this module");
    Console.WriteLine(result);
}
catch (AgentException ex)
{
    Console.Error.WriteLine($"Agent {ex.AgentName} failed: {ex.Message}");
    // Fall back to single-agent mode or retry
}

Siehe auch