Merk
Tilgang til denne siden krever autorisasjon. Du kan prøve å logge på eller endre kataloger.
Tilgang til denne siden krever autorisasjon. Du kan prøve å endre kataloger.
Den SDK for Microsoft 365-agenter er et utviklingsrammeverk for bygging av samtaleagenter. Samtaleagenter er programvare som kan motta meldinger fra brukere, behandle dem og svare. Tenk på det som vvslaget mellom en bruker som sender en melding (enten i Teams, et nettsted, Slack eller andre steder) og hvilken logikk du bygget for å svare på meldingen.
SDK håndterer mekanikken ved å motta og sende meldinger på tvers av forskjellige overflater, slik at utviklere kan fokusere på hva agenten faktisk gjør i stedet for på kommunikasjonsprotokoller på lavt nivå.
Språk som støttes
Agents SDK støtter:
- C# ved hjelp av .NET 8.0 SDK
- JavaScript bruker Node.js versjon 18 og nyere
- Python bruker versjon 3.9 til 3.11
Tre problemer agentene SDK løser
Agenten din må jobbe på mer enn ett sted. Brukere kommuniserer ikke alle gjennom samme kanal. Noen bruker Microsoft Teams, noen bruker Microsoft 365 Copilot, noen bruker et firmanettsted, og noen bruker ikke-Microsoft verktøy som Slack eller Facebook Messenger. Uten et rammeverk må en utvikler skrive separat integreringskode for hver av disse overflatene, hver med sitt eget meldingsformat, godkjenningsskjema og tilkoblingsprotokoll.
SDK gir et kanalabstraksjonslag. Du skriver agentlogikken én gang, og SDK oversetter innkommende og utgående meldinger til og fra formatet hver kanal forventer. Hvis du legger til en ny kanal, må du ikke skrive om agentens kjernevirkemåte.
Du vil ikke låses inn i én AI-tjeneste. Valget av hvilken AI-tjeneste som driver en agent, enten det er Azure AI Foundry, OpenAI, Semantic Kernel eller noe helt annet, endres ofte etter hvert som landskapet utvikler seg og etter hvert som ulike brukstilfeller oppstår. Et agentrammeverk som bakes i en bestemt AI-leverandør tvinger utviklere til å omskrive store deler av koden når dette valget endres.
SDK er AI-agnostisk etter design. Det gir stillaset for å motta meldinger, administrere tilstand og rutinghendelser, men gjør ingen antagelser om hva som genererer svaret. Utviklere kobler til ai-tjenester eller orkestreringsbiblioteker de foretrekker. SDK kommer ikke i veien for det valget.
Det er vanskelig å håndtere samtaletilstand. Samtaler er ikke tilstandsløse. En bruker kan stille et oppfølgingsspørsmål, referere til noe som ble sagt for to svinger siden, eller forlate en samtale og gjenoppta den senere. Administrasjon av denne konteksten, inkludert sporing av hva som skjedde, hvor den er lagret, og hvordan den flyter mellom meldinger, er kjedelig og feilutsatt å bygge fra grunnen av.
SDK gir innebygd tilstands- og lagringsadministrasjon. Det introduserer konseptet med en tur (en enkelt enhet i en samtale) og sporer tilstand på tvers av turer uten at utviklere må koble opp sitt eget vedvarende lag. Dette betyr mindre standardkode og færre feil i samtaleflytlogikken.
Slik passer det sammen
I kjernen gjør SDK tre ting når en melding kommer:
Mottar meldingen fra kanalen som ble sendt (Teams, nettchat, Slack og så videre) og normaliserer den til et vanlig format som kalles et
Activity.Ruter aktiviteten til relevant håndterer i agentkoden. En meldingsaktivitet utløser for eksempel én behandler, en bruker som blir med i en samtale utløser en annen.
Sender svaret tilbake gjennom samme kanal, og oversetter svaret tilbake til formatet som kanalen forventer.
Utviklere skriver behandlere for aktivitetstypene de bryr seg om. SDK håndterer alt annet, inkludert godkjenning, oversettelse av meldingsformat og kanaltilkobling.
Hva Agents SDK ikke er
Agents SDK er ikke en AI-modell, en orkestreringsmotor eller en kodebeskytter. Agentenes SDK bestemmer ikke hva en agent sier. Disse elementene er jobben til ai-tjenesten eller forretningslogikken utvikleren sender inn i agenten. Agents SDK er rammeverket som får meldinger til og fra den logikken pålitelig, på tvers av kanaler, med samtaletilstand intakt.
Neste trinn
- Finn ut mer om Aktivitetsprotokoll
- Finn ut mer om AgentApplication
- Hurtigstart: Opprette og teste en grunnleggende agent