Wat is de SDK voor Microsoft 365-agenten

De SDK voor Microsoft 365-agenten is een ontwikkelframework voor het bouwen van gespreksagenten. Gespreksagenten zijn software die berichten van gebruikers kan ontvangen, verwerken en erop kan reageren. U kunt het beschouwen als de loodgieterlaag tussen een gebruiker die een bericht verzendt (in Teams, een website, Slack of elders) en welke logica u hebt gebouwd om op dat bericht te reageren.

De SDK verwerkt de mechanismen voor het ontvangen en verzenden van berichten op verschillende oppervlakken, 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 en met 3.11

Drie problemen die de Agents SDK oplost

  • Uw agent moet op meer dan één plek werken. Gebruikers communiceren niet allemaal via hetzelfde kanaal. Sommige gebruiken Microsoft Teams, sommige gebruiken Microsoft 365 Copilot, sommige gebruiken een bedrijfswebsite en sommige gebruiken niet-Microsoft hulpprogramma's zoals Slack of Facebook Messenger. Zonder framework moet een ontwikkelaar afzonderlijke integratiecode schrijven voor elk van deze surfaces, elk met een eigen berichtindeling, verificatieschema en verbindingsprotocol.

    De SDK biedt een laag voor kanaalabstractie. U schrijft uw agentlogica eenmaal en de SDK vertaalt binnenkomende en uitgaande berichten naar en van de indeling die elk kanaal verwacht. Als u een nieuw kanaal toevoegt, hoeft u het kerngedrag van de agent niet opnieuw te schrijven.

  • U wilt niet zijn vergrendeld in één AI-service. De keuze welke AI-service een agent aandrijft, of dat nu Azure AI Foundry, OpenAI, Semantic Kernel of iets anders is, verandert vaak naarmate het landschap zich ontwikkelt en er verschillende gebruiksscenario's ontstaan. Een agentframework dat in een specifieke AI-provider wordt ingebouwd, dwingt ontwikkelaars om grote delen van hun code te herschrijven wanneer die keuze wordt gewijzigd.

    De SDK is standaard AI-agnostisch. Het biedt de scaffolding voor het ontvangen van berichten, het beheren van status en routeringsgebeurtenissen, maar maakt geen veronderstellingen over wat het antwoord genereert. Ontwikkelaars sluiten aan welke AI-services of orkestratiebibliotheken ze de voorkeur geven. De SDK komt niet in de weg van die keuze.

  • Het beheren van de conversatiestatus is moeilijk. Gesprekken zijn niet statusloos. Een gebruiker kan een vervolgvraag stellen, verwijzen naar iets dat twee keer geleden is gezegd, of een gesprek afbreken en later hervatten. Het beheren van deze context, inclusief het bijhouden van wat er is gebeurd, waar deze wordt opgeslagen en hoe deze tussen berichten stroomt, is tijdrovend en foutgevoelig om helemaal opnieuw te bouwen.

    De SDK biedt ingebouwd status- en opslagbeheer. Het introduceert het concept van een draai (één werkeenheid in een gesprek) en houdt de status over beurten bij zonder dat ontwikkelaars hun eigen persistentielaag hoeven te verbinden. Dit betekent minder standaardcode en minder fouten in gespreksstroomlogica.

Hoe het bij elkaar past

In de kern doet de SDK drie dingen wanneer er een bericht binnenkomt:

  1. Ontvangt het bericht van elk kanaal dat het heeft verzonden (Teams, webchat, Slack, enzovoort) en normaliseert het in een gemeenschappelijke indeling die een Activitywordt genoemd.

  2. Hiermee wordt de activiteit doorgestuurd naar de juiste handler in uw agentcode. Een berichtactiviteit activeert bijvoorbeeld één handler, een gebruiker die deelneemt aan een gesprek, activeert een andere.

  3. Stuurt het antwoord terug via hetzelfde kanaal, waarbij uw antwoord wordt omgezet in de indeling die het kanaal verwacht.

Ontwikkelaars schrijven handlers voor de activiteitstypen die ze belangrijk vindt. De SDK verwerkt alle andere zaken, waaronder verificatie, vertaling van berichtindeling en kanaalconnectiviteit.

Wat de Agents SDK niet is

De Agents SDK is geen AI-model, een indelingsengine of een opbouwfunctie zonder code. De Agents SDK bepaalt niet wat een agent zegt. Deze elementen zijn de taak van elke AI-service of bedrijfslogica die de ontwikkelaar integreert in de agent. De Agents SDK is het framework dat berichten betrouwbaar naar en vanuit die logica stuurt en ontvangt, door kanalen heen, met de gespreksstatus behouden.

Volgende stappen

  • Last updated on