Intégration de Microsoft Agent Framework

Utilisez SDK Copilot un fournisseur d’agent à l’intérieur de Microsoft Agent Framework (MAF) pour composer des workflows multi-agents en même temps qu’Azure OpenAI, Anthropic et d’autres fournisseurs.

Aperçu

Microsoft Agent Framework est le successeur unifié du noyau sémantique et de l’autogen. Il fournit une interface standard pour la création, l’orchestration et le déploiement d’agents IA. Les packages d’intégration dédiés vous permettent d’encapsuler un SDK Copilot client en tant qu’agent MAF de première classe, interchangeable avec n’importe quel autre fournisseur d’agent dans l’infrastructure.

Concept	Description
Microsoft Agent Framework	Infrastructure open source pour l’orchestration à agent unique et multi-agent dans .NET et Python
Fournisseur d’agents	Back-end qui alimente un agent (Copilot, Azure OpenAI, Anthropic, etc.)
Un orchestrateur	Composant MAF qui coordonne les agents dans des flux de travail séquentiels, simultanés ou de transfert
Protocole A2A	Norme de communication agent-à-agent prise en charge par l’infrastructure

Prerequisites

Avant de commencer, assurez-vous d’avoir :

• Configuration opérationnelle SDK Copilot dans votre langue de choix. Consultez « Getting started avec le Kit de développement logiciel (SDK) Copilot ».
• Un GitHub Copilot abonnement (individuel, professionnel ou entreprise).

•         Copilot pour CLI installé ou disponible via l’interface CLI intégrée du SDK (Kit de développement logiciel).
  

Installation

Installez le SDK Copilot en même temps que le package d’intégration MAF :

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

Pour obtenir des exemples en Python, consultez l’article microsoft-agent-framework du github/copilot-sdk référentiel.

Utilisation de base

Encapsulez le SDK Copilot client en tant qu’agent MAF avec un seul appel de méthode. L’agent résultant est conforme à l’interface standard de l’infrastructure et peut être utilisé n’importe où un agent MAF est attendu.

using GitHub.Copilot.SDK;
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);

Pour obtenir des exemples en Python, consultez l’article microsoft-agent-framework du github/copilot-sdk référentiel.

Ajout d’outils personnalisés

Étendez votre Copilot agent avec des outils de fonction personnalisés. Les outils définis par le biais de la norme SDK Copilot sont automatiquement disponibles lorsque l’agent s’exécute dans MAF.

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

// Define a custom tool
AIFunction weatherTool = AIFunctionFactory.Create(
    (string location) => $"The weather in {location} is sunny with a high of 25°C.",
    "GetWeather",
    "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);

Vous pouvez également utiliser la définition de l'outil natif SDK Copilot avec les outils MAF :

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: "approved" }),
});

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

Pour obtenir des exemples en Python, consultez l’article microsoft-agent-framework du github/copilot-sdk référentiel.

Flux de travail multi-agent

Le principal avantage de l’intégration MAF est de composer Copilotaux côtés d’autres fournisseurs d’agents dans des flux de travail orchestrés. Utilisez les orchestrateurs intégrés de l’infrastructure pour créer des pipelines où différents agents gèrent différentes étapes.

Flux de travail séquentiel

Exécutez les agents les uns après les autres, en transmettant la sortie de l’un à l’autre :

using GitHub.Copilot.SDK;
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);

Pour obtenir des exemples en Python, consultez l’article microsoft-agent-framework du github/copilot-sdk référentiel.

Flux de travail simultané

Exécutez plusieurs agents en parallèle et agrègez leurs résultats :

using GitHub.Copilot.SDK;
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);

Réponses en streaming

Lors de la création d’applications interactives, diffusez les réponses de l’agent afin d'afficher les résultats en temps réel. L’intégration MAF préserve les SDK Copilotcapacités de streaming du.

using GitHub.Copilot.SDK;
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();

Vous pouvez également diffuser directement via le SDK Copilot sans MAF :

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

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

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

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

Pour obtenir des exemples en Python, consultez l’article microsoft-agent-framework du github/copilot-sdk référentiel.

Référence de configuration

Options de l’agent MAF

Propriété	Type	Description
Instructions	ficelle	Invite de commande du système pour l'agent
Tools	AIFunction[] ou liste	Outils de fonction personnalisés disponibles pour l’agent
Streaming	bool	Activer les réponses en streaming
Model	ficelle	Remplacer le modèle par défaut

Options du SDK Copilot (transmises telles quelles)

Toutes les options standard SessionConfig sont disponibles lors de la création du client sous-jacent Copilot . L’enveloppe MAF délègue au SDK en arrière-plan.

Fonctionnalité du Kit de développement logiciel (SDK	Prise en charge de MAF
Outils personnalisés (DefineTool et AIFunctionFactory)	Fusionné avec les outils MAF
Serveurs MCP	Configuré sur le client du Kit de développement logiciel (SDK)
Agents personnalisés et sous-agents	Disponible dans l’agent Copilot
Sessions infinies	Configuré sur le client du Kit de développement logiciel (SDK)
Sélection du modèle	Peut être remplacé par agent ou par appel
Diffusion en continu	Prise en charge complète des événements delta

Bonnes pratiques

Choisir le niveau d’intégration approprié

Utilisez le wrapper MAF lorsque vous devez composer Copilot avec d’autres fournisseurs dans des flux de travail orchestrés. Si votre application utilise Copilotuniquement , le KIT de développement logiciel (SDK) autonome est plus simple et vous offre un contrôle total :

// 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: "approved" }),
});
const response = await session.sendAndWait({ prompt: "Explain this code" });

Garder les agents concentrés

Lors de la création de flux de travail multi-agents, donnez à chaque agent un rôle spécifique avec des instructions claires. Évitez les responsabilités qui se chevauchent :

// 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." },
];

Gérer les erreurs au niveau de l’orchestration

Encapsulez les appels d’agent dans une gestion des erreurs, surtout dans les flux de travail multi-agents où l’échec d’un agent ne doit pas bloquer l’ensemble du pipeline :

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
}

Lectures complémentaires

•         [AUTOTITLE](/copilot/how-tos/copilot-sdk/sdk-getting-started)
  

•         [Documentation de Microsoft Agent Framework](https://learn.microsoft.com/en-us/agent-framework/agents/providers/github-copilot)
  

•         [Blog : Créer des agents IA avec le Kit de développement logiciel (SDK) GitHub Copilot et Microsoft Agent Framework](https://devblogs.microsoft.com/semantic-kernel/build-ai-agents-with-github-copilot-sdk-and-microsoft-agent-framework/)