Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
De SDK voor Microsoft 365-agenten is een ontwikkelingsframework voor het bouwen van gespreksagenten. Gespreksagenten bestaan uit software die berichten van gebruikers kan ontvangen, deze berichten kan verwerken en erop kan reageren. Zie het als de verbindingslaag tussen een gebruiker die een bericht verstuurt (via bijvoorbeeld Teams, een website, Slack of een ander kanaal) en de logica die u hebt gebouwd om op dat bericht te reageren.
De SDK verzorgt de mechanismen voor het ontvangen en verzenden van berichten via verschillende kanalen, zodat ontwikkelaars zich kunnen richten op wat de agent daadwerkelijk doet in plaats van op communicatieprotocollen op laag niveau.
Ondersteunde talen
De SDK voor agenten biedt ondersteuning voor:
- C# met behulp van de .NET 8.0-SDK
- JavaScript met Node.js versie 18 en hoger
- Python met versie 3.9 tot 3.11
Drie problemen die de SDK voor agenten oplost
Uw agent moet op meer dan één plek werken. Gebruikers communiceren niet allemaal via hetzelfde kanaal. Sommigen gebruiken Microsoft Teams, sommigen gebruiken Microsoft 365 Copilot, sommigen gebruiken een bedrijfswebsite en sommigen gebruiken niet-Microsoft-tools, zoals Slack of Facebook Messenger. Zonder een framework moet een ontwikkelaar aparte integratiecode schrijven voor elk van die oppervlakken (kanalen), elk met zijn eigen berichtformaat, verificatieschema en verbindingsprotocol.
De SDK biedt een abstractielaag voor kanalen. U schrijft uw agentlogica eenmalig en de SDK vertaalt inkomende en uitgaande berichten naar en van het formaat dat elk kanaal verwacht. Een nieuw kanaal toevoegen vereist niet dat u het kerngedrag van de agent herschrijft.
U wilt niet vastzitten aan één AI-service. De keuze voor de AI-service die een agent aandrijft – of dat nu Azure AI Foundry, OpenAI, Semantic Kernel of iets heel anders is – verandert vaak naarmate het landschap zich ontwikkelt en er nieuwe gebruiksscenario's ontstaan. Een agentframework dat een specifieke AI-provider integreert, dwingt ontwikkelaars om grote delen van hun code te herschrijven wanneer die keuze verandert.
De SDK is ontworpen om AI-agnostisch te zijn. De SDK biedt de basisstructuur voor het ontvangen van berichten, het beheren van de status en het routeren van gebeurtenissen, maar doet geen aannames over wat het antwoord genereert. Ontwikkelaars voegen de AI-services of orkestratiebibliotheken in die ze prefereren. De SDK staat die keuze niet in de weg.
Het beheren van de gespreksstatus is moeilijk. Gesprekken zijn niet stateless. Een gebruiker kan een vervolgvraag stellen, verwijzen naar iets dat twee beurten geleden is gezegd of een gesprek afbreken en later weer oppakken. Het beheren van die context, inclusief het bijhouden van wat er is gebeurd, waar het is opgeslagen en hoe het tussen berichten verloopt, is omslachtig en foutgevoelig wanneer u dit vanaf nul moet bouwen.
De SDK biedt ingebouwd status- en opslagbeheer. Het introduceert het concept van een beurt (een afzonderlijke werkeenheid in een gesprek) en houdt de status tussen beurten bij, zonder dat ontwikkelaars zelf een persistentielaag hoeven te implementeren. Dit betekent minder boilerplate-code en minder fouten in de gespreksstroomlogica.
Hoe dit samenhangt
In de kern doet de SDK drie dingen wanneer een bericht binnenkomt:
De SDK ontvangt het bericht van het kanaal dat het heeft verzonden (Teams, webchat, Slack, enzovoort) en zet het om naar een gemeenschappelijk formaat, dat een
Activitywordt genoemd.Routeer de activiteit naar de juiste handler in uw agentcode. Bijvoorbeeld een berichtactiviteit triggert één handler, een gebruiker die aan een gesprek deelneemt triggert een andere handler.
De SDK stuurt het antwoord terug via hetzelfde kanaal, waardoor uw antwoord weer wordt vertaald naar het formaat dat dat kanaal verwacht.
Ontwikkelaars schrijven handlers voor de activiteitstypen waarin zij geïnteresseerd zijn. De SDK verzorgt de rest, waaronder verificatie, berichtformaatvertaling en kanaalconnectiviteit.
Wat de SDK voor agenten niet is
De SDK voor agenten is geen AI-model, een orkestratie-engine of een no-code-builder. De SDK voor agenten bepaalt niet wat een agent zegt. Deze elementen zijn de taak van welke AI-service of bedrijfslogica de ontwikkelaar ook in de agent inschakelt. De SDK voor agents is het framework waarin berichten betrouwbaar van en naar die logica worden verzonden, via verschillende kanalen, waarbij de status van het gesprek behouden blijft..
Volgende stappen
- Meer informatie: Activiteitsprotocol
- Meer informatie over AgentApplication
- Snelstart: Een basisagent maken en testen