Kommentar
Åtkomst till den här sidan kräver auktorisering. Du kan prova att logga in eller ändra kataloger.
Åtkomst till den här sidan kräver auktorisering. Du kan prova att ändra kataloger.
SDK för Microsoft 365-agenter är ett ramverk för att utveckla konversationsagenter. Konversationsagenter är programvara som kan ta emot meddelanden från användare, bearbeta dem och svara. Tänk på det som infrastrukturen mellan att en användare skickar ett meddelande (oavsett om det är i Teams, på en webbplats, i Slack eller någon annanstans) och den logik du har byggt för att svara på det meddelandet.
SDK:n hanterar mekaniken för att ta emot och skicka meddelanden över olika plattformar, så att utvecklare kan fokusera på vad agenten faktiskt gör snarare än på lågnivåkommunikationsprotokoll.
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 använder version 3.9 till 3.11
Tre problem som Agents SDK löser
Din agent behöver arbeta på mer än ett ställe. Alla användare kommunicerar inte via samma kanal. Vissa använder Microsoft Teams, vissa använder Microsoft 365 Copilot, vissa använder företagets webbplats och vissa använder icke-Microsoft-verktyg som Slack eller Facebook Messenger. Utan ett ramverk måste en utvecklare skriva separat integrationskod för varje gränssnitt. Varje gränssnitt har sitt eget meddelandeformat, autentiseringsschema och anslutningsprotokoll.
SDK:n erbjuder ett kanalabstraktionslager. Du skriver din agentlogik en gång, och SDK:n översätter inkommande och utgående meddelanden till och från det format som varje kanal förväntar sig. Att lägga till en ny kanal kräver inte att agentens kärnbeteende skrivs om.
Du vill inte vara låst till en AI-tjänst. Valet av vilken AI-tjänst som driver en agent, vare sig det är Azure AI Foundry, OpenAI, Semantic Kernel eller något helt annat, skiftar ofta i takt med att teknologilandskapet förändras och nya användningsområden uppstår. Ett agentramverk som bygger in en specifik AI-leverantör tvingar utvecklare att skriva om stora delar av sin kod när det valet ändras.
SDK:n är AI-agnostisk av design. Det ger ramverket för att ta emot meddelanden, hantera tillstånd och routa händelser, men gör inga antaganden om vad som genererar svaret. Utvecklare kopplar in vilka AI-tjänster eller orkestreringsbibliotek de föredrar. SDK:t kommer inte i vägen för det valet.
Att hantera samtalstillstånd är svårt. Konversationer är inte tillståndslösa. En användare kan ställa en följdfråga, hänvisa till något som sades för två rundor sedan, eller avbryta en konversation och återuppta den senare. Att hantera den kontexten, inklusive att spåra vad som hände, var det lagras och hur det flyter mellan meddelanden, är tidskrävande och felkänsligt att bygga från grunden.
SDK:n tillhandahåller inbyggd tillstånds- och lagringshantering. Det introducerar begreppet omgång (en enda arbetsenhet i en konversation) och spårar tillstånd över omgångar utan att utvecklare behöver bygga in ett eget lagringslager. Detta innebär mindre standardkod och färre buggar i konversationsflödeslogiken.
Hur det hänger ihop
I grunden gör SDK:n tre saker när ett meddelande anländer:
Tar emot meddelandet från den kanal som skickade det (Teams, webbchatt, Slack och så vidare) och normaliserar det till ett gemensamt format som kallas
Activity.Dirigerar aktiviteten till rätt hanterare i din agentkod. Till exempel utlöser en meddelandeaktivitet en hanterare, medan en användare som ansluter till en konversation utlöser en annan.
Skickar tillbaka svaret via samma kanal och översätter ditt svar tillbaka till det format som kanalen förväntar sig.
Utvecklare skriver hanterare för de aktivitetstyper de vill hantera. SDK:n hanterar allt annat, inklusive autentisering, omvandling av meddelandeformat och kanaluppkoppling.
Vad Agents SDK inte är
Agents SDK är inte en AI-modell, en orkestreringsmotor eller ett no-code-verktyg. Agents SDK styr inte vad en agent säger. Dessa element hanteras av den AI-tjänst eller affärslogik som utvecklaren integrerar i agenten. Agents SDK är det ramverk som hämtar meddelanden till och från den logiken på ett tillförlitligt sätt, över kanaler, med konversationstillståndet intakt.
Nästa steg
- Lär dig om Aktivitetsprotokollet
- Lär dig mer om AgentApplication
- Snabbstart: Skapa och testa en grundläggande agent