Freigeben über


Übersicht über das Microsoft 365 Agents SDK

Mit dem Microsoft 365 Agents SDK können Sie Agents erstellen, die für Kanäle Ihrer Wahl bereitgestellt werden können, z. B. Microsoft 365 Copilot, Microsoft Teams, Web & Custom Apps und vieles mehr, mit Gerüst für die verarbeitung der erforderlichen Kommunikation. Entwickler können die KI-Dienste ihrer Wahl verwenden und die Agents, die sie erstellen, mithilfe der Kanalverwaltungsfunktionen des SDK verfügbar machen.

Wichtige Features des Agents SDK

Entwickler benötigen die Flexibilität, Agents von jedem Anbieter oder Technologiestapel in ihre Unternehmenssysteme zu integrieren. Das Agents SDK vereinfacht die Implementierung von agentischen Mustern mithilfe der KI ihrer Wahl, sodass sie einen oder mehrere Dienste, Modelle oder Agents auswählen können, um ihre spezifischen Anforderungen zu erfüllen.

Verwenden Sie das Agents SDK für Folgendes:

  1. Erstellen Sie schnell einen Agent "Container" mit Status, Speicher und der Möglichkeit, Aktivitäten und Ereignisse zu verwalten. Stellen Sie diesen Container über einen beliebigen Kanal bereit, z. B. Microsoft 365 Copilot oder Microsoft Teams.
  2. Implementieren Sie agentische Muster, ohne auf einen bestimmten Technologiestapel beschränkt zu sein. Das Agents SDK ist in Bezug auf die von Ihnen ausgewählte KI agnostisch.
  3. Passen Sie Ihren Agent an die spezifischen Verhaltensweisen von Clients, z. B. Microsoft Teams, an.

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 3.9 bis 3.11

Einen Agent erstellen

Es ist einfach, das Startbeispiel in C#, JavaScript oder Python von Github abzurufen.

So erstellen Sie einen Agent in C#:

builder.AddAgent( sp =>
{
    var agent = new AgentApplication(sp.GetRequiredService<AgentApplicationOptions>());
    agent.OnActivity(ActivityTypes.Message, async (turnContext, turnState, cancellationToken) =>
    {
        var text = turnContext.Activity.Text;
        await turnContext.SendActivityAsync(MessageFactory.Text($"Echo: {text}"), cancellationToken);
    });
});

Dadurch wird ein neuer Agent erstellt, eine Nachrichtentypaktivität überwacht und eine Nachricht zurücksendet.

Von hier aus können Sie Ihre ausgewählten benutzerdefinierten AI-Dienste (z. B. Azure Foundry- oder OpenAI-Agents) und Orchestration (z. B. Semantic Kernel) hinzufügen.

Wichtige Begriffe

Einige spezifische Konzepte, die für das SDK wichtig sind, sind:

  • Turn: Eine Drehung ist eine Arbeitseinheit, die vom Agenten durchgeführt wird. Dabei kann es sich um eine einzelne Nachricht oder eine Reihe von Nachrichten sein. Entwickler arbeiten mit "Turns" und verwalten die Daten zwischen ihnen.
  • Aktivität: Eine Aktivität ist eine oder mehrere Arten von Einheiten, die vom Agent verwaltet werden.
  • Nachrichten: Eine Nachricht ist eine Art von Aktivität, die an den Agent gesendet wird. Dabei kann es sich um eine einzelne Nachricht oder eine Reihe von Nachrichten sein.

Erste Schritte

Bevor Sie beginnen, müssen Sie sich um einige Voraussetzungen kümmern. Die Voraussetzungen hängen von der Sprache ab, die Sie zum Entwickeln Ihrer Anwendung verwenden.

Herunterladen und Installieren

Laden Sie die dateien herunter, die für die ersten Schritte erforderlich sind.

Klonen Sie das GitHub-Repository für Agents lokal. Das Repository enthält SDK-Quellbibliotheken und Beispiele, die Ihnen bei den ersten Schritten beim Erstellen von Anwendungen mit dem SDK helfen. Installieren der Beispiele installiert erforderliche Pakete für das SDK.

Nächste Schritte