Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Registerkarten sind Teams-bezogene Webseiten, die in Microsoft Teams eingebettet sind und eine gute Möglichkeit sind, mit der Entwicklung für Teams zu beginnen. Sie können sie als Teil eines Kanals innerhalb eines Teams, eines Gruppenchats oder einer persönlichen App für einen einzelnen Benutzer hinzufügen.
In diesem Tutorial lernst du Folgendes:
-
Einrichten eines neuen Projekts mit dem Microsoft 365 Agents Toolkit (früher bekannt als Teams Toolkit).
- Erstellen einer Registerkarten-App
-
Die Struktur der App
- Der Tab-Teil mit JavaScript unter Verwendung von React
- Die restlichen Features mit Node.js
- Bereitstellen Ihrer App
Diese schrittweise Anleitung hilft Ihnen beim Erstellen von Registerkarten mit Agents Toolkit. Nach Abschluss dieses Leitfadens wird die folgende Ausgabe angezeigt:
Voraussetzungen
Stellen Sie sicher, dass Sie die folgenden Tools zum Erstellen und Bereitstellen Ihrer Apps installieren.
| Installieren | Zum Benutzen... | |
|---|---|---|
| Required | ||
| Visual Studio Code | Build-Umgebungen für JavaScript, TypeScript oder SharePoint-Framework (SPFx). Verwenden Sie die neueste Version. | |
| Microsoft 365 Agents Toolkit | Microsoft Visual Studio Code-Erweiterung, die ein Projektgerüst für Ihre App erstellt. Verwenden Sie die neueste Version. | |
| Node.js | Back-End-JavaScript-Laufzeitumgebung. Weitere Informationen finden Sie in Node.js Versionskompatibilitätstabelle für den Projekttyp. | |
| Microsoft Teams | Microsoft Teams für die Zusammenarbeit mit allen Personen, mit denen Sie zusammenarbeiten, über Apps für Chats, Besprechungen und Anrufe – alles an einem Ort. | |
| Microsoft Edge (empfohlen) oder Google Chrome | Ein Browser mit Entwicklertools. | |
| Optional | ||
| Azure-Tools für Visual Studio Code und Azure CLI | Azure-Tools für den Zugriff auf gespeicherte Daten oder für die Bereitstellung eines cloudbasierten Back-Ends für Ihre Teams-App in Azure. | |
| React Developer Tools für Chrome ODER React Developer Tools für Microsoft Edge | Eine Browser-DevTools-Erweiterung für die Open-Source-JavaScript-Bibliothek React. | |
| Microsoft Graph-Tester | Microsoft Graph Explorer, ein browserbasiertes Tool, mit dem Sie eine Abfrage aus Microsoft Graph-Daten ausführen können. | |
| Entwicklerportal für Teams | Webbasiertes Portal zum Konfigurieren, Verwalten und Veröffentlichen Ihrer Teams-App, einschließlich für Ihre organization oder den Microsoft Teams Store. |
Tipp
Wenn Sie mit Microsoft Graph-Daten arbeiten, sollten Sie den Microsoft Graph-Explorer kennenlernen und mit einem Lesezeichen versehen. Mit diesem browserbasierten Tool können Sie Microsoft Graph außerhalb einer App abfragen.
Vorbereiten der Entwicklungsumgebung
Nachdem Sie die erforderlichen Tools installiert haben, richten Sie die Entwicklungsumgebung ein.
Microsoft 365 Agents Toolkit installieren
Microsoft 365 Agents Toolkit (früher als Teams Toolkit bezeichnet) hilft dabei, den Entwicklungsprozess mit Tools zum Bereitstellen und Bereitstellen von Cloudressourcen für Ihre App und zur Veröffentlichung im Teams Store zu vereinfachen.
Sie können Agents Toolkit mit Visual Studio Code oder eine Befehlszeilenschnittstelle namens Microsoft 365 Agents Toolkit CLI (früher als TeamsFx CLI bezeichnet) verwenden.
Öffne Visual Studio Code und wähle Erweiterungen aus (STRG+UMSCHALT+X oderErweiterungenanzeigen>).
Geben Sie im Suchfeld "Microsoft 365 Agents Toolkit" ein.
Wählen Sie Installieren aus.
Das Symbol Microsoft 365 Agents Toolkit
wird in der Aktivitätsleiste von Visual Studio Code angezeigt.
Sie können Agents Toolkit auch aus dem Visual Studio Code Marketplace installieren.
Einrichten Ihres Teams-Entwicklungsmandanten
Ein Mandant ist ein Raum oder Container für Ihre organization in Teams, in dem Sie chatten, Dateien freigeben und Besprechungen abhalten. In diesen Bereich laden Sie auch Ihre App hoch und testen sie. Lassen Sie uns überprüfen, ob Sie bereit sind, mit dem Mandanten zu entwickeln.
Option zum Hochladen einer App überprüfen
Nachdem Sie Ihre benutzerdefinierte App erstellt haben, müssen Sie Ihre App mit der Option "Benutzerdefinierte App hochladen " in Teams hochladen. Melden Sie sich bei Ihrem Microsoft 365-Konto an, um zu überprüfen, ob diese Option aktiviert ist.
Mithilfe der folgenden Schritte können Sie überprüfen, ob Sie Apps in Teams hochladen können:
Wählen Sie im Teams-Client das Symbol "Apps " aus.
Wählen Sie Verwalten Ihrer Apps aus.
Wählen Sie App hochladen aus.
Suchen Sie nach der Option zum Hochladen einer benutzerdefinierten App. Wenn die Option angezeigt wird, können Sie benutzerdefinierte Apps hochladen.
Hinweis
Wenn Sie die Option zum Hochladen einer benutzerdefinierten App nicht finden, wenden Sie sich an Ihren Teams-Administrator.
Erstellen eines kostenlosen Teams-Entwicklermandanten (optional)
Wenn Sie kein Teams-Entwicklerkonto haben, treten Sie dem Microsoft 365-Entwicklerprogramm bei.
Gehen Sie zu Microsoft 365-Entwicklerprogramm.
Wählen Sie "Jetzt teilnehmen" aus, und folgen Sie den Anweisungen auf dem Bildschirm.
Wählen Sie auf dem Willkommensbildschirm E5-Abonnement einrichten aus.
Einrichten Ihres Administratorkontos. Nach Abschluss des Vorgangs wird der folgende Bildschirm angezeigt:
Melden Sie sich mit dem soeben eingerichteten Administratorkonto bei Teams an. Stellen Sie sicher, dass die Option "Benutzerdefinierte App hochladen " in Teams vorhanden ist.
Kostenloses Azure-Konto erhalten
Wenn Sie Ihre App hosten oder auf Ressourcen in Azure zugreifen möchten, benötigen Sie ein Azure-Abonnement. Erstellen Sie ein kostenloses Konto , bevor Sie beginnen.
Jetzt verfügen Sie über alle Tools, um Ihr Konto einzurichten. Als Nächstes richten wir deine Entwicklungsumgebung ein und beginnen mit dem Erstellen! Wählen Sie zuerst die App aus, die Sie erstellen möchten.
Erstellen eines Projektarbeitsbereichs für Ihre Registerkarten-App
Beginnen Sie mit der Entwicklung von Microsoft Teams-Apps, indem Sie Ihre erste App erstellen. Diese App verwendet die Registerkartenfunktion.
Erstellen Ihres Tabprojektarbeitsbereichs
Wenn die Voraussetzungen gegeben sind, kann es losgehen!
Hinweis
Die gezeigte Visual Studio Code-Benutzeroberfläche stammt vom Mac. Die Version und Umgebung von Agents Toolkit können je nach Betriebssystem unterschiedlich sein.
Öffnen Sie Visual Studio Code.
Wählen Sie das Symbol Microsoft 365 Agents Toolkit
in der Aktivitätsleiste von Visual Studio Code aus.Wählen Sie "Neue Agent-/App-Teams-App> erstellen" aus.
Andere Teams-Funktionen auswählen
Wählen Sie in diesem Beispiel Tab als App-Funktion aus.
Wähle Standardordner aus, um den Projektstammordner am Standardspeicherort zu speichern.
Führen Sie die Schritte aus, um den Standardspeicherort zu ändern:
Wählen Sie "Durchsuchen" aus.
Wählen Sie den Speicherort für den Projektarbeitsbereich aus.
Wählen Sie den ausgewählten Ordner aus.
Geben Sie einen geeigneten Namen für Ihre App ein, und wählen Sie dann die EINGABETASTE aus.
Die Teams-Registerkarten-App ist in wenigen Sekunden erstellt.
Nachdem Ihre App erstellt wurde, zeigt Agents Toolkit die folgende Meldung an:
Sie können Lokales Debuggen auswählen, um eine Vorschau Ihres Projekts anzuzeigen.
Eine kurze Zusammenfassung der Erstellung einer Teams-App.
Sehen Sie sich diese kurze Zusammenfassung zum Erstellen einer Teams-App an.
Machen Sie eine Tour durch den Quellcode der Registerkarte App
Agents Toolkit bietet alle Komponenten zum Erstellen einer App. Nach dem Erstellen des Projekts kannst du die Projektordner und -dateien im EXPLORER im Visual Studio Code anzeigen.
Obwohl es Ihnen freisteht, ein beliebiges UI-Framework zu wählen (oder keines zu verwenden), bietet dieser Beispielvorlagencode ein Gerüst mit React-Komponenten.
Neben anderen Elementen in dieser Verzeichnisstruktur verwaltet das Toolkit:
| Ordner | Inhalt |
|---|---|
.vscode |
VSCode-Dateien für das Debuggen |
appPackage |
Vorlagen für das Anwendungsmanifest |
env |
Umgebungsdateien |
infra |
Vorlagen für die Bereitstellung von Azure-Ressourcen |
src |
Den Quellcode der Anwendung |
Die folgenden Dateien können angepasst werden und veranschaulichen eine Beispielimplementierung, um Ihnen den Einstieg zu erleichtern.
| File | Inhalt |
|---|---|
index.html |
HTML-Datei gespeichert werden. |
src/Tab/App.css |
CSS-Datei für die App. |
src/Tab/App.tsx |
Quelldatei für Registerkarten. Es ruft das SDK auf teamsjs , um den Kontext abzurufen, auf welcher Microsoft 365-Anwendung Ihre App ausgeführt wird. |
src/index.ts |
Starten der App mit dem Microsoft Teams SDK. |
vite.config.js |
Konfiguration für das Vite-Build-Tool. |
nodemon.json |
Konfiguration für Nodemon zum Überwachen und Neustarten des Servers. |
Im Folgenden sind spezifische Projektdateien für das Microsoft 365 Agents Toolkit aufgeführt. Sie können eine vollständige Anleitung auf GitHub besuchen , um zu verstehen, wie das Microsoft 365 Agents-Toolkit funktioniert.
| File | Inhalt |
|---|---|
m365agents.yml |
Dies ist die Hauptprojektdatei des Microsoft 365 Agents-Toolkits. Die Projektdatei definiert zwei grundlegende Dinge: Eigenschaften und Konfiguration Phasendefinitionen. |
m365agents.local.yml |
Dies setzt Aktionen außer Kraft m365agents.yml , die lokale Ausführung und Debugging ermöglichen. |
Erstellen und Ausführen Ihrer ersten Registerkarten-App
Nachdem Sie Ihren Projektarbeitsbereich mit Agents Toolkit eingerichtet haben, erstellen Sie Ihr Registerkartenprojekt. Sie müssen sich bei Ihrem Microsoft 365-Konto anmelden.
Anmelden bei Ihrem Microsoft 365-Konto
Melden Sie sich mit Ihrem Microsoft 365-Konto bei Teams an. Wenn Sie einen Microsoft 365-Entwicklerprogrammmandanten verwenden, ist das Administratorkonto, das Sie bei der Registrierung einrichten, Ihr Microsoft 365-Konto.
- Öffnen Sie Visual Studio Code.
- Wählen Sie auf der Randleiste das Symbol Microsoft 365 Agents Toolkit
aus. - Wählen Sie "Bei M365 anmelden" mit Ihren Anmeldeinformationen aus. Ihr Standardwebbrowser wird geöffnet, damit Sie sich beim Konto anmelden können.
- Schließen Sie den Browser, wenn Sie dazu aufgefordert werden, und kehren Sie zu Visual Studio Code zurück.
- Zurück zum Agents-Toolkit in Visual Studio Code.
Im Abschnitt KONTEN der Randleiste wird der Name Ihres Microsoft 365-Kontos angezeigt. Wenn der benutzerdefinierte App-Upload für Ihr Microsoft 365-Konto aktiviert ist, zeigt das Agents-Toolkit den benutzerdefinierten App-Upload aktiviert an.
Jetzt können Sie die App erstellen und in der lokalen Umgebung ausführen!
Erstellen und lokales Ausführen der App in Visual Studio Code
So erstellen Sie Ihre App und führen sie lokal aus:
Wählen Sie in Visual Studio Code F5 aus, um die Anwendung im Debugmodus auszuführen.
Erfahren Sie, was geschieht, wenn Sie Ihre App lokal im Debugger ausführen.
Falls Sie sich fragen, wenn Sie die Taste F5 drücken, Agents Toolkit:
- Überprüft die folgenden Voraussetzungen:
- Sie sind mit einem Microsoft 365-Konto angemeldet.
- Der benutzerdefinierte App-Upload ist für Ihr Microsoft 365-Konto aktiviert.
- Unterstützte Node.js-Version ist installiert.
- Das Entwicklungszertifikat für localhost ist installiert.
- Port ist für die Registerkarten-App verfügbar.
Hinweis
Wenn Agents Toolkit eine bestimmte Voraussetzung nicht überprüfen kann, werden Sie aufgefordert, dies zu überprüfen.
- Installiert NPM-Pakete.
- Registriert die App bei Microsoft Entra ID und konfiguriert die App.
- Registriert die App im Teams-Entwicklerportal und konfiguriert die App.
- Startet die Registerkarten-App.
- Startet Teams in einem Webbrowser und lädt die Registerkarten-App hoch.
Hinweis
Wenn Sie die App zum ersten Mal ausführen, werden alle Abhängigkeiten heruntergeladen, und die App wird erstellt. Nach Abschluss des Builds wird ein Browserfenster geöffnet. Dieser Vorgang kann 3 bis 5 Minuten in Anspruch nehmen.
Das Toolkit fordert Sie bei Bedarf auf, ein lokales Zertifikat zu installieren. Mit diesem Zertifikat kann Microsoft Teams Ihre Anwendung von https://localhost laden.
Wählen Sie Ja aus, wenn das folgende Dialogfenster angezeigt wird:
Je nach Betriebssystem können Sie auch "Weiter" auswählen:
Der Teams-Webclient wird in einem Browserfenster geöffnet.
Hinweis
Wenn Sie vom Toolkit nicht aufgefordert werden, ein Zertifikat zu installieren, müssen Sie das Zertifikat manuell installieren. Weitere Informationen finden Sie unter Hinzufügen eines manuellen Zertifikats.
- Melden Sie sich mit Ihrem Microsoft 365-Konto an, wenn Sie dazu aufgefordert werden.
- Wählen Sie "Hinzufügen" aus, wenn Sie aufgefordert werden, die benutzerdefinierte App in Teams auf Ihrem lokalen Computer hochzuladen.
- Herzlichen Glückwunsch, Ihre erste App wird in Teams ausgeführt!
Hinweis
Wenn Sie Ihre App auf Outlook und Microsoft 365 erweitern möchten, können Sie Ihre App mit Outlook und Microsoft 365 über das Dropdownmenü AUSFÜHREN UND DEBUGGEN in Visual Studio Code debuggen.
Sie können das SSO-Feature hinzufügen, um die Benutzerdetails abzurufen. Sie können normale Debugaktivitäten, z. B. das Setzen von Haltepunkten, wie jede andere Webanwendung ausführen. Die App unterstützt Hot Reloading. Wenn Sie eine Datei innerhalb des Projekts ändern, wird die Seite neu geladen.
Erfahren Sie, wie Sie Probleme beheben können, wenn Ihre App nicht lokal ausgeführt wird.
Um Ihre App erfolgreich in Teams auszuführen, stellen Sie sicher, dass Sie den benutzerdefinierten App-Upload in Ihrem Teams-Konto aktiviert haben. Weitere Informationen zum Hochladen benutzerdefinierter Apps finden Sie im Abschnitt "Voraussetzungen".
Bereitstellen Ihrer ersten Teams-App
Sie haben gelernt, die Teams-App mit der Registerkarten-App zu erstellen, zu erstellen und auszuführen. Der letzte Schritt besteht darin, Ihre App in Azure bereitzustellen.
Stellen wir die erste App mit Registerkartenfunktion in Azure mithilfe des Agents Toolkit bereit.
Anmelden bei Ihrem Azure-Konto
Verwenden Sie dieses Konto für den Zugriff auf das Microsoft Azure-Portal und zum Bereitstellen neuer Cloudressourcen zur Unterstützung Ihrer App.
- Öffnen Sie Visual Studio Code.
- Öffnen Sie den Projektordner, in dem Sie die Registerkarten-App erstellt haben.
- Wählen Sie auf der Randleiste das Symbol Microsoft 365 Agents Toolkit
aus. - Wählen Sie Bei Azure anmelden mit Ihren Anmeldeinformationen aus.
Tipp
Wenn Sie die AZURE ACCOUNT-Erweiterung installiert haben und dasselbe Konto verwenden, können Sie diesen Schritt überspringen. Verwenden Sie dasselbe Konto wie in anderen Erweiterungen.
Ihr Standardwebbrowser wird geöffnet, damit Sie sich beim Konto anmelden können.
- Schließen Sie den Browser, wenn Sie dazu aufgefordert werden, und kehren Sie zu Visual Studio Code zurück.
Im Abschnitt "KONTEN " der Randleiste werden die beiden Konten separat angezeigt. Außerdem wird die Anzahl der nutzbaren Azure-Abonnements aufgeführt, die Ihnen zur Verfügung stehen. Stellen Sie sicher, dass Sie über mindestens ein nutzbares Azure-Abonnement verfügen. Wenn nicht, melden Sie sich ab und verwenden Sie ein anderes Konto.
Herzlichen Glückwunsch, Sie haben eine Teams-App erstellt! Nun erfahren Sie, wie Sie eine der Apps mithilfe des Agents-Toolkits in Azure bereitstellen.
Bereitstellen Ihrer App in Azure
Die Bereitstellung besteht aus zwei Schritten. Zunächst werden die erforderlichen Cloud-Ressourcen erstellt (auch als Bereitstellung bezeichnet). Anschließend wird der Code Ihrer App in die erstellten Cloudressourcen kopiert. Für dieses Tutorial stellen Sie die Registerkarten-App bereit.
Was ist der Unterschied zwischen Bereitstellen und Bereitstellen?
Im Bereitstellungsschritt werden Ressourcen in Azure und Microsoft 365 für Ihre App erstellt, aber kein Code (HTML, CSS, JavaScript usw.) wird in die Ressourcen kopiert. Im Bereitstellungsschritt wird der Code für Ihre App in die Ressourcen kopiert, die Sie während des Bereitstellungsschritts erstellt haben. Es kommt häufig vor, dass mehrere Stellen bereitgestellt werden, ohne dass neue Ressourcen bereitgestellt werden. Da der Bereitstellungsschritt einige Zeit in Anspruch nehmen kann, ist er vom Bereitstellungsschritt getrennt.
Wählen Sie das Symbol Microsoft 365 Agents Toolkit
in der Visual Studio Code-Randleiste aus.
Wählen Sie "Bereitstellen" aus.
Wählen Sie eine der Mitglieder des vorhandenen Abonnements aus.
Wählen Sie eine Ressourcengruppe aus, die für die Azure-Ressourcen verwendet werden soll.
Hinweis
- Ihre App wird mithilfe von Azure-Ressourcen gehostet.
- Weitere Informationen finden Sie unter Erstellen einer Ressourcengruppe.
Ein Dialogfeld warnt Sie, dass beim Ausführen von Ressourcen in Azure Kosten anfallen können.
Wählen Sie "Bereitstellen" aus.
Beim Bereitstellungsprozess werden Ressourcen in der Azure-Cloud erstellt. Dies kann einige Zeit dauern. Sie können den Fortschritt überwachen, indem Sie die Dialogfelder in der unteren rechten Ecke beobachten. Nach ein paar Minuten sehen Sie den folgenden Hinweis:
Sie können sich die bereitgestellten Ressourcen anzeigen lassen. Für dieses Tutorial müssen Sie keine Ressourcen anzeigen.
Die bereitgestellte Ressource wird im Abschnitt ENVIRONMENT angezeigt.
Wählen Sie nach Abschluss der Bereitstellung im Bereich "LEBENSZYKLUS" die Option "Bereitstellen" aus.
Wie bei der Bereitstellung nimmt die Bereitstellung einige Zeit in Anspruch. Sie können den Prozess überwachen, indem Sie die Dialogfelder in der unteren rechten Ecke beobachten. Nach ein paar Minuten wird ein Hinweis zum Abschluss angezeigt.
Jetzt können Sie denselben Prozess verwenden, um Ihre Bot- und Nachrichtenerweiterungs-Apps in Azure bereitzustellen.
Hinweis
Ihre App wird mithilfe von Azure-Ressourcen gehostet.
Ausführen der bereitgestellten App
Gehen Sie nach Abschluss der Bereitstellungs- und Bereitstellungsschritte folgendermaßen vor:
Öffnen Sie den Debugbereich (STRG+UMSCHALT+D / ⌘⇧-D oder Ausführung anzeigen>) in Visual Studio Code.
Wählen Sie "Remote starten (Edge)" aus der Dropdownliste der Startkonfiguration aus.
Wählen Sie Debuggen starten (F5) aus, um Ihre App aus Azure zu starten.
Wählen Sie "Hinzufügen" aus, wenn Sie aufgefordert werden, die App in Teams hochzuladen.
Herzlichen Glückwunsch, Ihre erste Registerkarten-App wird in Ihrer Azure-Umgebung ausgeführt!
Erfahren Sie, was geschieht, wenn Sie Ihre App in Azure bereitstellen.
Vor der Bereitstellung wurde die Anwendung lokal ausgeführt:
- Das Back-End unter Verwendung von Azure Functions Core Tools ausgeführt.
- Der HTTP-Endpunkt der Anwendung, an dem Microsoft Teams die Anwendung lädt, wird lokal ausgeführt.
Die Bereitstellung erfolgt in zwei Schritten. Sie stellen die Ressourcen in einem aktiven Azure-Abonnement bereit und stellen dann den Back-End- und Front-End-Code für die Anwendung in Azure bereit oder laden ihn hoch.
- Wenn das Back-End konfiguriert ist, verwendet es verschiedene Azure-Dienste, einschließlich Azure App Service und Azure Storage.
- Die Front-End-Anwendung wird in einem Azure Storage-Konto bereitgestellt, das für statisches Webhosting konfiguriert ist.
Glückwünsche
Du hast es geschafft!
Sie haben eine Registerkarten-App erstellt.
Nachdem Sie nun wissen, wie Sie eine einfache App erstellen, können Sie mit dem Erstellen komplexerer Apps fortfahren. Befolgen Sie die Verfahren zum Erstellen und Bereitstellen der App. Ihre App verfügt dann über mehrere Funktionen.
Sie haben das Tutorial zum Erstellen einer Registerkarten-App mit JavaScript abgeschlossen.