Dela via


Översikt över SDK för Microsoft 365-agenter

Med SDK för Microsoft 365-agenter kan du skapa agenter som kan distribueras till valfria kanaler, till exempel Microsoft 365 Copilot, Microsoft Teams, Web & Custom Apps med mera, med hjälp av byggnadsställningar för att hantera den kommunikation som krävs. Utvecklare kan använda de AI-tjänster de väljer och göra de agenter som de skapar tillgängliga med hjälp av kanalhanteringsfunktionerna i SDK:n.

Viktiga funktioner i SDK för agenter

Utvecklare behöver flexibiliteten att integrera agenter från alla leverantörer eller teknikstackar i sina företagssystem. SDK för agenter förenklar implementeringen av agentiska mönster med hjälp av den AI de väljer, så att de kan välja en eller flera tjänster, modeller eller agenter för att uppfylla sina specifika krav.

Använd SDK för agenter för att:

  1. Skapa snabbt en agentcontainer med tillstånd, lagring och möjlighet att hantera aktiviteter och händelser. Distribuera den här containern över valfri kanal, till exempel Microsoft 365 Copilot eller Microsoft Teams.
  2. Implementera agentiska mönster utan att begränsas till en specifik teknikstack. SDK för agenter är agnostisk när det gäller den AI du väljer.
  3. Anpassa din agent så att den överensstämmer med de specifika beteendena för klienter, till exempel Microsoft Teams.

Språk som stöds

SDK för agenter stöder:

  • C# med .NET 8.0 SDK
  • JavaScript med Node.js version 18 och senare
  • Python 3.9 till 3.11

Skapa en handläggare

Det är enkelt att hämta startexemplet i C#, JavaScript eller Python från Github

Så här skapar du en agent i C#:

builder.AddAgent( sp =>
{
    var agent = new AgentApplication(sp.GetRequiredService<AgentApplicationOptions>());
    agent.OnActivity(ActivityTypes.Message, async (turnContext, turnState, cancellationToken) =>
    {
        var text = turnContext.Activity.Text;
        await turnContext.SendActivityAsync(MessageFactory.Text($"Echo: {text}"), cancellationToken);
    });
});

Detta skapar en ny agent, lyssnar efter en meddelandetypsaktivitet och skickar tillbaka ett meddelande

Härifrån kan du lägga till dina valda anpassade AI-tjänster (till exempel Azure Foundry eller OpenAI-agenter) och Orchestration (till exempel semantisk kernel).

Viktiga termer

Några specifika begrepp som är viktiga för SDK:et är:

  • Vändning: En vändning är en arbetsenhet som utförs av agenten. Det kan vara ett enda meddelande eller en serie meddelanden. Utvecklare kommer att arbeta med "vändningar" och hantera data mellan dem
  • Aktivitet: En aktivitet är en eller flera typer av enheter som hanteras av agenten
  • Meddelanden: Ett meddelande är en typ av aktivitet som skickas till agenten. Det kan vara ett enda meddelande eller en serie meddelanden.

Get Started

Innan du kommer igång måste du ta hand om vissa förutsättningar. Förutsättningarna beror på vilket språk du använder för att utveckla ditt program.

Ladda ned och installera

Ladda ned de filer som behövs för att komma igång.

Klona agenternas GitHub-lagringsplats lokalt. Lagringsplatsen innehåller SDK-källbibliotek och exempel som hjälper dig att komma igång med att skapa program med hjälp av SDK. När du installerar exemplen installeras nödvändiga paket för SDK:t.

Nästa steg