Schnellstart: Erstellen eines Agents und Chatten mit ihm in Teams

In dieser Schnellstartanleitung verwenden Sie Entwicklertools für die Befehlszeile, um einen neuen Teams-Agent zu erstellen. Am Ende unterhalten Sie sich mit Ihrem Agent in Teams, während der Code in Ihrer lokalen Entwicklungsumgebung ausgeführt wird. Sie können den Code und die Agent-Registrierung, die Sie in dieser Schnellstartanleitung erstellen, als Grundlage für einen Teams-Agenten mit vollem Funktionsumfang verwenden.

Voraussetzungen

Diese Schnellstartanleitung ist in zwei Abschnitte unterteilt. Im ersten führen Sie einen Agent in Microsoft 365 Agents Playground für lokale Tests aus. Für diesen Abschnitt benötigen Sie:

Im zweiten Abschnitt, in dem Sie Ihren Agent in Teams installieren und testen, benötigen Sie außerdem:

  • Einen Teams-Mandanten, in dem benutzerdefinierte App-Uploads zulässig sind, und ein Konto darin mit Berechtigungen zum Installieren benutzerdefinierter Apps (ein Administrator muss dies möglicherweise aktivieren)

Wenn Sie kein Konto haben oder sich über Ihre Berechtigungen nicht sicher sind, können Sie trotzdem beginnen. Der Schnellstart greift diese Anforderungen auf, wenn sie benötigt werden.

Erstellen Sie Code für eine Agent-Runtime, und probieren Sie ihn in Microsoft 365 aus Agents Playground

  1. Installieren Sie die Teams-Entwickler-CLI und Microsoft 365 Agents Playground.

    npm install -g @microsoft/teams.cli @microsoft/m365agentsplayground

  2. Erstelle teams project new den Code für eine neue Agent-Laufzeit aus einer Vorlage, und öffne ihn dann in Visual Studio Code.

    teams project new typescript echo-bot
cd echo-bot
code .

  3. Öffnen Sie src/index.tsin Visual Studio Code Suchen Sie die Zeile, die lautet, const app = new App(); und ändern Sie sie so, dass sie lautet:

    const app = new App({ skipAuth: true });

    Dies ist eine temporäre Änderung, um die Kommunikation mit Microsoft 365 Agents Playground zu ermöglichen.

  4. Starten Sie die Runtime des Agents. Sobald es ausgeführt wird, sehen Sie eine Bestätigung, dass es auf Port 3978 verfügbar ist.

    npm install
npm run dev

  5. Starten Sie Microsoft 365 Agents Playground in einem neuen Konsolenfenster.

    agentsplayground

    Dadurch wird Agents Playground mit der Laufzeit Ihres Agenten verbunden und die Benutzeroberfläche in einem neuen Browsertab geöffnet.

  6. Verwenden Sie das Feld "Verfassen", um Ihrem Agenten eine Nachricht zu senden, und sehen Sie, wie er im Chat antwortet. Ihr Agent ist lokal in Betrieb!

    Screenshot einer kurzen Agent-Interaktion im Microsoft 365 Agents Playground.

  7. Schließen Sie die Registerkarte Agents Playground in Ihrem Browser und verwenden Sie in beiden Konsolenfenstern STRG+C , um Agents Playground und Ihre Agent-Laufzeit zu beenden. Lassen Sie das Konsolenfenster geöffnet, das Sie zum Erstellen Ihres Agent-Laufzeitcodes verwendet haben, da Sie ihn bald wieder benötigen.

  8. Machen Sie in Visual Studio Code die in Schritt 3 vorgenommene Änderung rückgängig. Dadurch wird in den nächsten Schritten eine sichere Verbindung mit Teams sichergestellt.

    const app = new App();

Anmelden und Berechtigungen bestätigen

Wichtig

Für den nächsten Teil dieser Schnellstartanleitung muss Teams bei einem Microsoft 365-Geschäfts-, Schul- oder Unikonto mit Berechtigungen zum Installieren benutzerdefinierter Teams-Apps angemeldet sein. In diesem Schritt wird diese Berechtigung überprüft.

Wenn Sie kein Microsoft 365-Konto haben, können Sie mit den nächsten Schritten fortfahren, um mit der Arbeit an Ihrem Code fortzufahren und den Rest dieser Schnellstartanleitung später abzuschließen. Weitere Informationen zum Erhalten eines Entwickler-Sandbox-Abonnements, mit dem Sie Ihre App in Teams testen können, finden Sie im Microsoft 365 Developer Program .

Melden Sie sich über die Teams-Entwickler-CLI bei Ihrem Microsoft 365-Geschäfts-, Schul- oder Unikonto an.

teams login

Die CLI bestätigt die Berechtigungen Ihres Kontos zum Installieren benutzerdefinierter Apps ("Querladen") und überprüft, ob eine Installation der Azure-CLI vorhanden ist (für diesen Schnellstart nicht erforderlich).

✔ Logged in as user@contoso.com
✔ Sideloading: enabled

Azure CLI: installed, not logged in

Um mit diesem Schnellstart fortzufahren, muss das Querladen aktiviert sein. Wenn sie deaktiviert ist, muss der Microsoft 365-Administrator Ihrer organization sie für Ihr Konto aktivieren. Siehe Zulassen, dass Benutzer benutzerdefinierte Apps hochladen , für Administratoren Anweisungen zum Aktivieren dieser Berechtigung. In der Zwischenzeit können Sie mit den nächsten Schritten fortfahren, um mit der Arbeit am Code Ihres Agents fortzufahren.

Voraussetzungen

Diese Schnellstartanleitung ist in zwei Abschnitte unterteilt. Im ersten führen Sie einen Agent in Microsoft 365 Agents Playground für lokale Tests aus. Für diesen Abschnitt benötigen Sie:

Im zweiten Abschnitt, in dem Sie Ihren Agent in Teams installieren und testen, benötigen Sie außerdem:

  • Einen Teams-Mandanten, in dem benutzerdefinierte App-Uploads zulässig sind, und ein Konto darin mit Berechtigungen zum Installieren benutzerdefinierter Apps (ein Administrator muss dies möglicherweise aktivieren)

Wenn Sie kein Konto haben oder sich über Ihre Berechtigungen nicht sicher sind, können Sie trotzdem beginnen. Der Schnellstart greift diese Anforderungen auf, wenn sie benötigt werden.

Erstellen Sie Code für eine Agent-Runtime, und probieren Sie ihn in Microsoft 365 aus Agents Playground

  1. Installieren Sie die Teams-Entwickler-CLI und Microsoft 365 Agents Playground.

    npm install -g @microsoft/teams.cli @microsoft/m365agentsplayground

  2. Erstelle teams project new den Code für eine neue Agent-Laufzeit aus einer Vorlage, und öffne ihn dann in Visual Studio Code.

    teams project new python echo-bot
cd echo-bot
code .

  3. Öffnen Sie src/main.pyin Visual Studio Code Suchen Sie die Zeile, die lautet, app = App() und ändern Sie sie so, dass sie lautet:

    app = App(skip_auth=True)

    Dies ist eine temporäre Änderung, um die Kommunikation mit Microsoft 365 Agents Playground zu ermöglichen.

  4. Starten Sie die Runtime des Agents. Sobald es ausgeführt wird, sehen Sie eine Bestätigung, dass es auf Port 3978 ausgeführt wird.

    python -m venv .venv
source .venv/bin/activate
pip install -e .
python src/main.py

  5. Starten Sie Microsoft 365 Agents Playground in einem neuen Konsolenfenster.

    agentsplayground

    Dadurch wird Agents Playground mit Ihrem Agent verbunden und die Benutzeroberfläche in einem neuen Browser-Tab geöffnet.

  6. Verwenden Sie das Feld "Verfassen", um Ihrem Agenten eine Nachricht zu senden, und sehen Sie, wie er im Chat antwortet. Ihr Agent ist lokal in Betrieb!

    Screenshot einer kurzen Agent-Interaktion im Microsoft 365 Agents Playground.

  7. Schließen Sie die Registerkarte Agents Playground in Ihrem Browser und verwenden Sie in beiden Konsolenfenstern STRG+C , um Agents Playground und Ihre Agent-Laufzeit zu beenden. Lassen Sie das Konsolenfenster geöffnet, das Sie zum Erstellen Ihres Agent-Laufzeitcodes verwendet haben, da Sie ihn bald wieder benötigen.

  8. Machen Sie in Ihrem Editor die in Schritt 3 vorgenommene Änderung rückgängig. Dadurch wird in den nächsten Schritten eine sichere Verbindung mit Teams sichergestellt.

    app = App()

Anmelden und Berechtigungen bestätigen

Wichtig

Für den nächsten Teil dieser Schnellstartanleitung muss Teams bei einem Microsoft 365-Geschäfts-, Schul- oder Unikonto mit Berechtigungen zum Installieren benutzerdefinierter Teams-Apps angemeldet sein. In diesem Schritt wird diese Berechtigung überprüft.

Wenn Sie kein Microsoft 365-Konto haben, können Sie mit den nächsten Schritten fortfahren, um mit der Arbeit an Ihrem Code fortzufahren und den Rest dieser Schnellstartanleitung später abzuschließen. Weitere Informationen zum Erhalten eines Entwickler-Sandbox-Abonnements, mit dem Sie Ihre App in Teams testen können, finden Sie im Microsoft 365 Developer Program .

Melden Sie sich über die Teams-Entwickler-CLI bei Ihrem Microsoft 365-Geschäfts-, Schul- oder Unikonto an.

teams login

Die CLI bestätigt die Berechtigungen Ihres Kontos zum Installieren benutzerdefinierter Apps ("Querladen") und überprüft, ob eine Installation der Azure-CLI vorhanden ist (für diesen Schnellstart nicht erforderlich).

✔ Logged in as user@contoso.com
✔ Sideloading: enabled

Azure CLI: installed, not logged in

Um mit diesem Schnellstart fortzufahren, muss das Querladen aktiviert sein. Wenn sie deaktiviert ist, muss der Microsoft 365-Administrator Ihrer organization sie für Ihr Konto aktivieren. Siehe Zulassen, dass Benutzer benutzerdefinierte Apps hochladen , für Administratoren Anweisungen zum Aktivieren dieser Berechtigung. In der Zwischenzeit können Sie mit den nächsten Schritten fortfahren, um mit der Bearbeitung des Codes Ihres Agents fortzufahren

Voraussetzungen

  • Node.js 24 oder höher (Installationsprogramm-Download)
  • .NET 10 oder höher (Installationsprogramm-Download)
  • Einen Teams-Mandanten, in dem benutzerdefinierte App-Uploads zulässig sind, und ein Konto darin mit Berechtigungen zum Installieren benutzerdefinierter Apps (ein Administrator muss dies möglicherweise aktivieren)

Wenn Sie kein Microsoft 365-Geschäfts-, Schul- oder Unikonto haben, finden Sie im Microsoft 365-Entwicklerprogramm weitere Informationen zum Erwerben eines Entwickler-Sandbox-Abonnements, mit dem Sie Ihren Agent in Teams testen können.

Tools installieren, anmelden und Berechtigungen bestätigen

Installieren Sie die Microsoft Teams-Entwickler-CLI, und melden Sie sich mit Ihrem Microsoft 365-Geschäfts-, Schul- oder Unikonto an.

npm install -g @microsoft/teams.cli
teams login

Die CLI bestätigt Ihre Anmeldung, die Berechtigungen Ihres Kontos zum Installieren benutzerdefinierter Apps ("Querladen") und überprüft, ob eine Installation der Azure-CLI vorhanden ist (für diesen Schnellstart nicht erforderlich).

✔ Logged in as user@contoso.com
✔ Sideloading: enabled

Azure CLI: installed, not logged in

Um mit diesem Schnellstart fortzufahren, muss das Querladen aktiviert sein. Wenn sie deaktiviert ist, muss der Microsoft 365-Administrator Ihrer organization sie für Ihr Konto aktivieren. Siehe Zulassen, dass Benutzer benutzerdefinierte Apps hochladen , für Administratoren Anweisungen zum Aktivieren dieser Berechtigung.

Erstellen von Code für eine Agent-Laufzeit

  1. Wird verwendet teams project new , um den Code für eine neue Agent-Laufzeit aus einer Vorlage zu erstellen.

    teams project new csharp EchoBot
cd EchoBot/EchoBot

  2. Starten Sie die Runtime des Agents, um die Ausführung zu bestätigen. Sobald er ausgeführt wird, sehen Sie eine Bestätigung, dass er auf Port 3978 erreichbar ist.

    dotnet run

  3. Verwenden Sie im Konsolenfenster STRG+C , um Ihren Agent zu beenden. Lassen Sie das Konsolenfenster geöffnet. Sie werden es bald wieder benötigen.

Hosten eines Dev-Tunnels

Teams können nur mit einer Agent-Laufzeit kommunizieren, die über das öffentliche Internet erreichbar ist. In diesem Schritt verwenden Sie das Hilfsprogramm Microsoft Dev Tunnel, um einen Tunnel zu erstellen, der Ihre Agent-Laufzeit für das Internet verfügbar macht, während sie in Ihrer Entwicklungsumgebung ausgeführt wird.

  1. Installieren Sie dev tunnel in einem neuen Konsolenfenster.

    winget install Microsoft.devtunnel

  2. Melden Sie sich mit Ihrem Microsoft 365-Konto an, devtunnel und hosten Sie einen neuen Tunnel.

    devtunnel user login
devtunnel create --allow-anonymous
devtunnel port create -p 3978
devtunnel host

    Eine Ausgabe wie die folgende wird angezeigt:

    Connection to host tunnel relay restored.
Hosting port: 3978
Connect via browser: https://4r9dd5xj-3978.usw2.devtunnels.ms
Inspect network activity: https://4r9dd5xj-3978-inspect.usw2.devtunnels.ms

Ready to accept connections for tunnel: joyful-dog-xgz66vp.usw2

  3. Lassen Sie den Tunnel laufen. Notieren Sie sich die Connect via browser URL für den nächsten Schritt.

Hinweis

Der Entwicklungstunnel muss neu gestartet werden, wenn sich die Netzwerkverbindung Ihres Geräts ändert. Wenn Sie einen neuen Tunnel erstellen, unterscheidet sich seine URL von der von Ihnen registrierten – aktualisieren Sie den Messagingendpunkt Ihres Telefonberaters entsprechend, sonst empfängt der Agent keine Nachrichten mehr von Teams.

Registrieren, Installieren und Chatten in Teams

  1. Verwenden Sie das Konsolenfenster, das Sie zum Erstellen Ihres Agent-Laufzeitprojekts verwendet haben, teams app create um es bei der Teams-Plattform zu registrieren. Ersetzen Sie <tunnel-host> diese durch die vollständige Connect via browser URL des vorherigen Schritts. Mit diesem Befehl wird eine Konfigurationsdatei erstellt, die Ihre Agent-Laufzeit für die Kommunikation mit Teams benötigt. Daher ist es wichtig, sie aus dem Projektverzeichnis auszuführen.

    teams app create --endpoint <tunnel-host>/api/messages --name echo-bot --env .env

  1. Verwenden Sie das Konsolenfenster, das Sie zum Erstellen Ihres Agent-Laufzeitprojekts verwendet haben, teams app create um es bei der Teams-Plattform zu registrieren. Ersetzen Sie <tunnel-host> diese durch die vollständige Connect via browser URL des vorherigen Schritts. Mit diesem Befehl wird eine Konfigurationsdatei erstellt, die Ihre Agent-Laufzeit für die Kommunikation mit Teams benötigt. Daher ist es wichtig, sie aus dem Projektverzeichnis auszuführen.

    teams app create --endpoint <tunnel-host>/api/messages --name echo-bot --env appsettings.json

  1. Nach Abschluss des create Befehls wird ein Menü angezeigt. Wählen Sie "In Teams installieren " aus, um Teams zu öffnen und das Dialogfeld "Agent-Installationsprogramm" anzuzeigen.

    Screenshot des Dialogfelds

  1. Bevor Sie in Teams fortfahren, kehren Sie zum Konsolenfenster zurück, und wählen Sie im Entwickler-CLI-Menü von Teams Fertig aus, um es zu schließen. Verwenden Sie dann die Befehlszeile, um die Agent-Laufzeit erneut zu starten. Stellen Sie sicher, dass Port 3978 überwacht wird, bevor Sie fortfahren.

    npm run dev

  1. Bevor Sie in Teams fortfahren, kehren Sie zum Konsolenfenster zurück, und wählen Sie im Entwickler-CLI-Menü von Teams Fertig aus, um es zu schließen. Verwenden Sie dann die Befehlszeile, um die Agent-Laufzeit erneut zu starten. Stellen Sie sicher, dass Port 3978 überwacht wird, bevor Sie fortfahren.

    python src/main.py

  1. Bevor Sie in Teams fortfahren, kehren Sie zum Konsolenfenster zurück, und wählen Sie im Entwickler-CLI-Menü von Teams Fertig aus, um es zu schließen. Verwenden Sie dann die Befehlszeile, um die Agent-Laufzeit erneut zu starten. Stellen Sie sicher, dass Port 3978 überwacht wird, bevor Sie fortfahren.

    dotnet run

  1. Wechseln Sie zurück zu Teams, und wählen Sie im Installationsdialogfeld von Schritt 2 "Hinzufügen " aus, um den Agent zu installieren. Wählen Sie im angezeigten Dialogfeld Wie möchten Sie diese App heute verwenden? die Option "Öffnen " aus, um einen Einzelchat mit dem Agent zu eröffnen.

    Screenshot des Teams-Dialogfelds, in dem der Benutzer gefragt wird, wie er eine neu installierte App verwenden möchte.

  2. Chatten Sie mit Ihrem Agenten in Teams!

    Screenshot einer kurzen Chatinteraktion mit einem Mitarbeiter in Teams.

Nächste Schritte

Alles, was Sie in dieser Schnellstartanleitung erstellt haben, bleibt erhalten und kann als Grundlage für die Erstellung eines Agents verwendet werden. Solange Ihr Code und der Entwicklungstunnel in Ihrer Entwicklungsumgebung ausgeführt werden, kann Ihr Agent Nachrichten in Teams senden und empfangen.

Das gesamte Verhalten Ihres Agents ist im Laufzeitcode enthalten: Sie können die Runtime ändern und neu starten, um ihr Verhalten zu ändern, ohne sie erneut in Teams registrieren oder installieren zu müssen.

Lesen Sie die Dokumentation, um mehr über Features und bewährte Methoden für Agents in Teams zu erfahren.

  • Last updated on