Schnellstart: Einrichten und Ausführen des Python Agent Framework-Beispiel-Agents

Von Bedeutung

Sie müssen Teil des Frontier-Vorschauversionsprogramms sein, um Vorabzugriff auf Microsoft Agent 365 zu erhalten. Frontier verbindet Sie direkt mit den neuesten KI-Innovationen von Microsoft. Frontier-Vorschauversionen unterliegen den bestehenden Vorschauversionsbedingungen Ihrer Kundenvereinbarungen. Da sich diese Funktionen noch in der Entwicklung befinden, können sich ihre Verfügbarkeit und Merkmale im Laufe der Zeit ändern.

In dieser Schnellstartanleitung erfahren Sie, wie Sie einen funktionierenden Python Agent-Framework-Agent mit Agent 365 für Tools, Benachrichtigungen, Observability und Testen des Agents mithilfe von Agents Playground und Teams einrichten.

Voraussetzungen

Wenn Sie Visual Studio Code verwenden möchten, müssen Sie .NET installiert haben. (.NET 8.0 wird empfohlen.)
Python 3.11+ installiert
UV-Paket-Manager ist installiert. Installieren Sie dies in einem Terminal mithilfe von pip install uv.
Microsoft Agents Toolkit/Agent Framework-Abhängigkeiten

Das in der exemplarischen Vorgehensweise verwendete Beispiel basiert auf den Agent Framework-Bibliotheken, die über das Microsoft 365 Agents Toolkit oder ATK bereitgestellt werden. Sie werden automatisch installiert, wenn Sie die Agents Toolkit-Erweiterung in VS Code verwenden, um das Beispiel zu erstellen. Alternativ können Sie das Paket auch manuell mit dem folgenden Befehl installieren:
```
uv pip install -e . --prerelease=allow
```
Zugriff auf GitHub
Ein vorhandenes KI-Agent-Projekt. Dieser Schnellstart verwendet ein Agent 365-Beispiel aus dem Microsoft 365 Agent Toolkit, das in VS Code auch als ATK bekannt ist.
A365 CLI
Agent-Identitätsauthentifizierung

Einrichten des Agent-Frameworks + Python Beispiel aus dem Microsoft 365 Agents Toolkit

Um alles vorbereiten zu können, installieren Sie das Microsoft 365 Agents Toolkit in VS Code, öffnen den Beispielkatalog und erstellen ein Gerüst für das Agent-Framework + Python Beispiel lokal, damit Sie es später konfigurieren und ausführen können. Die folgenden Screenshots zeigen, was erwartungsgemäß angezeigt werden sollte.

Öffnen Sie Visual Studio Code, öffnen Sie dann Extensions Panel Ctrl+Shift+X.
Geben Sie in der Suchleiste Agents Toolkit ein.
Sie sollten das Ergebnis wie hier im Screenshot dargestellt sehen.
Wählen Sie Microsoft 365 Agents Toolkit aus.
Wählen Sie Installieren aus.

VS Code zeigt die Detailansicht der Erweiterung an, ähnlich wie folgt:
Nach der Installation wird das Symbol M365 Agents Toolkit in der linken Navigationsleiste angezeigt.
Wählen Sie es aus, um den Willkommensbildschirm zu öffnen.

Nun sollten Optionen wie Deklarativen Agent erstellen, Neuen Agent/App erstellen und Beispiele anzeigen angezeigt werden, wie hier dargestellt:
Wählen Sie Beispiele anzeigen aus.
Scrollen Sie in der Beispielliste, um das Agent Framework + Python Agent-Beispiel zu finden.
Wählen Sie es aus.

Es werden zwei Optionen angezeigt: "Erstellen" (lokal ein Gerüst erstellen) oder "Auf GitHub anzeigen".
Wählen Sie Erstellen.
Wenn Sie dazu aufgefordert werden, wählen Sie einen Ordner auf Ihrem Computer aus, in dem das Beispiel generiert werden soll. Beispiel: C:\A365-python-sample

Das Toolkit erstellt ein Gerüst für das Agent-Framework + Python Beispiel in einem Unterordner (z. B. sample_agent) und öffnet es dann automatisch in VS Code.

Nach Abschluss des Gerüsts verfügen Sie jetzt über ein voll funktionsfähiges Agent-Framework + Python Agent-Projekt auf Ihrem Computer.
Installieren der erforderlichen Agent 365-Pakete

Öffnen Sie vor dem Ausführen des Beispiels pyproject.toml in Ihrem Projekt, und vergewissern Sie sich, dass alle erforderlichen Agent 365- und Agent-Framework-Abhängigkeiten aufgelistet sind. Das vom Microsoft 365 Agents Toolkit generierte Beispiel enthält bereits diese Einträge.

Sobald du die pyproject.toml überprüft hast, installiere alles, indem du diesen Befehl ausführst:
```
uv pip install -e . --prerelease=allow
```
Dadurch werden alle Agent 365 SDK-Bibliotheken, Agent-Framework-Abhängigkeiten, Hostingkomponenten und alle anderen im Beispiel definierten Abhängigkeiten abgerufen.
Bitte überprüfen Sie nach der Installation, ob das Projekt erstellt und ausgeführt wird, indem Sie den Entwicklungsserver mit dem folgenden Befehl starten:
```
uv run python start_with_generic_host.py
```

Hinzufügen von Microsoft 365-Tools (MCP-Server)

Sie können MCP-Server mithilfe der A365-Entwicklungsbefehle in der CLI erkunden und verwalten.

Beim Arbeiten mit MCP-Servern können Sie Folgendes tun:

Ermitteln, welche MCP-Server zur Verwendung verfügbar sind
Einen oder mehrere MCP-Server zur Konfiguration Ihres Agents hinzufügen
Die derzeit konfigurierten MCP-Server überprüfen
MCP-Server entfernen, die Sie nicht mehr benötigen

Nachdem MCP-Server hinzugefügt wurden, wird das Toolmanifest Ihres Agents erweitert, um Einträge wie folgt einzuschließen:

{
   "mcpServers": [
      {
         "mcpServerName": "mcp_MailTools",
         "mcpServerUniqueName": "mcp_MailTools",
         "scope": "McpServers.Mail.All",
         "audience": "api://00001111-aaaa-2222-bbbb-3333cccc4444"
      }
   ]
}

Erfahren Sie, wie Sie Tools hinzufügen und verwalten

Benachrichtigungsabonnement und -verwaltung

Der Beispiel-Agent abonniert alle Agent 365 SDK-Benachrichtigungen mithilfe von onAgentNotification("*") und leitet sie an einen einzelnen Handler weiter. Dieser Handler ermöglicht es dem Agent, auf Hintergrund- oder Systemereignisse zu reagieren, nicht nur auf direkte Benutzernachrichten.

Erfahren Sie, wie Sie Agents benachrichtigen

Der folgende Code zeigt, wie die Benachrichtigung in der Datei agent.py konfiguriert ist.

if notification_type == NotificationTypes.EMAIL_NOTIFICATION: 
if not hasattr(notification_activity, "email") or not notification_activity.email: return "I could not find the email notification details."
email = notification_activity.email
email_body = getattr(email, "html_body", "") or getattr(email, "body", "")

message = (
    "You have received the following email. "
    "Please follow any instructions in it. "
    f"{email_body}"
)

result = await self.agent.run(message)
return self._extract_result(result) or "Email notification processed."

Beobachtbarkeit

Dieser Codeausschnitt zeigt die minimalen Änderungen, die erforderlich sind, um Beobachtbarkeit im Beispiel zu ermöglichen. Das Agent-365-Observability-SDK wird initialisiert und umschließt jeden Agent-Aufruf in einem InferenceScope, sodass Eingaben, Ausgaben und Metadaten automatisch erfasst werden können.

Der folgende Code zeigt ein optimiertes Beispiel für Beobachtbarkeit in der Datei agent.py.

def _enable_agentframework_instrumentation(self): 
"""Enable Agent Framework instrumentation.""" 
try: 
AgentFrameworkInstrumentor().instrument() 
logger.info("✅ Instrumentation enabled")
 except Exception as e: 
logger.warning(f"⚠️ Instrumentation failed: {e}")

Dieser Code ist das vollständige Einblick-Setup, das für das Python + Agent-Framework-Beispiel erforderlich ist. Weitere Informationen zur Beobachtbarkeit

Ihren Agent testen

Legen Sie die erforderlichen Umgebungsvariablen fest, wählen Sie einen Authentifizierungsmodus aus, und starten Sie den Agent lokal. Sie können alles end-to-End mit Agents Playground testen, ohne einen Microsoft 365 Mandanten zu benötigen, es sei denn, Sie möchten den Agent veröffentlichen und in Apps wie Teams oder Outlook verwenden.

Übersicht über Testschritte

Fügen Sie Ihre API-Schlüssel und die Modelleinstellungen zu einer .env-Datei hinzu, damit das Beispiel mit einem LLM sprechen kann.
Wählen Sie Ihren Authentifizierungsmodus aus. Für die lokale Entwicklung unterstützt das Beispiel die agentische Authentifizierung mithilfe von Werten, die aus Ihrem Agent-Blueprint erstellt wurden.
Starten Sie den Agenten lokal, wodurch er für Tools wie den Agents Playground zugänglich wird.
Verwenden Sie Agents Playground, um Meldungen, Tools und Benachrichtigungen zu testen, ohne einen Mandanten einzurichten oder etwas bereitzustellen.
Wenn Sie für das reale Verhalten bereit sind, veröffentlichen Sie einen Microsoft 365 Mandanten, und testen Sie den Agent in Teams, Outlook oder anderen Microsoft 365 Oberflächen.

Weitere Informationen zum Testen

Ihren Agenten veröffentlichen

Wenn Ihr Agent für tatsächliche Microsoft 365-Erlebnisse wie Teams-Diagramme, Outlook-Nachrichten oder Word @mentions bereit ist, veröffentlichen Sie ihn in einem Microsoft 365-Mandanten. Der CLI-Befehl publish Agent 365 übernimmt die Verpackung: Er aktualisiert dein Manifest, bündelt alles und lädt den Agenten ins Microsoft-Verwaltungszentrum hoch.

Überprüfen Sie während der Veröffentlichung den Namen, die Beschreibung, die Symbole und die Version des Agents und passen Sie diese an, bevor Sie den Upload abschließen. Nach der Veröffentlichung ist Ihr Agent innerhalb des Mandanten auffindbar und installierbar.

Von Bedeutung

Nach der Veröffentlichung deines Agenten musst du den Agenten-Blueprint im Developer Portal konfigurieren, bevor du Instanzen erstellst. Lernen Sie, wie Sie den Agenten-Blueprint im Developer Portal konfigurieren

Hier können Sie veröffentlichte Agenten anzeigen: https://admin.cloud.microsoft/#/agents/all

Erfahren Sie mehr über den vollständigen Workflow und Schritt-für-Schritt-Anleitungen

Feedback

War diese Seite hilfreich?

Last updated on 2026-03-10