Was ist das Microsoft 365 Agents SDK

Das Microsoft 365 Agents SDK ist ein Entwicklungsframework zum Erstellen von Unterhaltungsagenten. Konversationsagenten sind Software, die Nachrichten von Benutzern empfangen, sie verarbeiten und beantworten können. Stellen Sie sich dies als Vermittlungsebene zwischen einem Benutzer vor, der eine Nachricht sendet (sei es in Teams, auf einer Website, in Slack oder anderswo) und der Logik, die Sie für die Beantwortung dieser Nachricht erstellt haben.

Das SDK behandelt die Mechanismen des Empfangens und Sendens von Nachrichten über verschiedene Oberflächen hinweg, sodass Entwickler sich darauf konzentrieren können, was der Agent tatsächlich tut, anstatt auf Kommunikationsprotokolle auf niedriger Ebene.

Unterstützte Sprachen

Das Agents SDK unterstützt Folgendes:

  • C# mit dem .NET 8.0 SDK
  • JavaScript mit Node.js Version 18 und höher
  • Python mit Version 3.9 bis 3.11

Drei Probleme, die das Agents SDK löst

  • Ihr Agent muss an mehreren Stellen arbeiten. Benutzer kommunizieren nicht alle über denselben Kanal. Einige verwenden Microsoft Teams, einige verwenden Microsoft 365 Copilot, einige verwenden eine Unternehmenswebsite und einige verwenden nicht-Microsoft Tools wie Slack oder Facebook Messenger. Ohne Ein Framework muss ein Entwickler separater Integrationscode für jede dieser Oberflächen schreiben, jedes mit einem eigenen Nachrichtenformat, Authentifizierungsschema und Verbindungsprotokoll.

    Das SDK stellt eine Kanalstraktionsebene bereit. Sie schreiben Ihre Agent-Logik einmal, und das SDK übersetzt eingehende und ausgehende Nachrichten in das format, das jeder Kanal erwartet. Das Hinzufügen eines neuen Kanals erfordert keine Neuschreibung des Kernverhaltens des Agents.

  • Sie möchten nicht in einen KI-Dienst gesperrt werden. Die Entscheidung, welcher KI-Dienst einen Agenten betreibt, sei es Azure AI Foundry , OpenAI, Semantischer Kernel oder ein ganz anderer, ändert sich häufig, während sich das Umfeld entwickelt und neue Anwendungsfälle auftauchen. Ein Agent-Framework, das in einem bestimmten KI-Anbieter backt, zwingt Entwickler, große Teile ihres Codes neu zu schreiben, wenn sich diese Auswahl ändert.

    Das SDK ist AI-agnostisch im Design. Es stellt das Gerüst für den Empfang von Nachrichten, das Verwalten von Status- und Routingereignissen bereit, nimmt jedoch keine Annahmen darüber ab, was die Antwort generiert. Entwickler schließen alle KI-Dienste oder Orchestrierungsbibliotheken an, die sie bevorzugen. Das SDK steht dieser Entscheidung nicht im Weg.

  • Die Behandlung des Gesprächsstatus ist schwierig. Unterhaltungen sind nicht zustandslos. Ein Benutzer kann eine Nachverfolgungsfrage stellen, sich auf etwas beziehen, das vor zwei Jahren gesagt wurde, oder eine Unterhaltung aufgeben und später fortsetzen. Die Verwaltung dieses Kontexts, einschließlich der Nachverfolgung, der Speicherung und des Datenflusses zwischen den Nachrichten, ist mühsam und fehleranfällig, wenn man alles von Grund auf neu erstellt.

    Das SDK bietet integrierte Zustands- und Speicherverwaltung. Es führt das Konzept eines Turns (einer einzelnen Arbeitseinheit in einem Gespräch) ein und verfolgt den Zustand über mehrere Dialogphasen hinweg, ohne dass Entwickler ihre eigene Persistenzschicht implementieren müssen. Dies bedeutet weniger Standard-Code und weniger Fehler in der Konversationsflusslogik.

Wie es zusammenpasst

Im Kern erledigt das SDK drei Dinge, wenn eine Nachricht eintrifft:

  1. Empfängt die Nachricht von dem Kanal, der sie gesendet hat (Teams, Webchat, Slack usw.) und normalisiert sie in ein einheitliches Format, genannt Activity.

  2. Leitet die Aktivität an den entsprechenden Handler im Agentcode weiter. Beispielsweise löst eine Nachrichtenaktivität einen Handler aus, ein Benutzer, der einer Unterhaltung beitritt, löst einen anderen aus.

  3. Sendet die Antwort zurück über denselben Kanal und übersetzt Ihre Antwort wieder in das erwartete Format.

Entwickler schreiben Handler für die Aktivitätstypen, die sie interessieren. Das SDK behandelt alles andere, einschließlich Authentifizierung, Nachrichtenformatübersetzung und Kanalkonnektivität.

Was das Agents SDK nicht ist

Das Agents SDK ist kein KI-Modell, kein Orchestrierungsmodul oder kein Code-Generator. Das Agents SDK entscheidet nicht, was ein Agent sagt. Diese Elemente sind Aufgabe von KI-Diensten oder Geschäftslogik, die der Entwickler in den Agent integriert. Das Agents SDK ist das Framework, das Nachrichten zuverlässig zu und von dieser Logik über verschiedene Kanäle hinweg überträgt, wobei der Konversationsstatus intakt bleibt.

Nächste Schritte

  • Last updated on