Umgebungen im Microsoft 365 Agents Toolkit

Das Erstellen eines Agents oder einer App mit dem Microsoft 365 Agents Toolkit (früher Teams Toolkit) bedeutet häufig, dass dasselbe Projekt in verschiedenen Zielen wie lokal, dev oder einem Playground ausgeführt wird. Umgebungen halten jedes Ziel getrennt, während Sie die gleiche Projektstruktur und die gleichen Lebenszyklusbefehle wiederverwenden. Das Agents-Toolkit speichert umgebungsspezifische Einstellungsdateien in .env.<environment-name> . Jede Datei erfasst die Variablen und Ausgaben für dieses Ziel, sodass Sie ohne erneute Konfiguration von Ressourcen jedes Mal bereitstellen, bereitstellen und veröffentlichen können.

In diesem Artikel erfahren Sie, wie diese Umgebungsdateien funktionieren, wie sich lokale und Remoteumgebungen unterscheiden, wie Sie neue Umgebungen für Ihren Agent oder Ihr App-Projekt hinzufügen und wie Sie eine bestimmte Umgebung für Ihren Workflow als Ziel verwenden.

Verwenden von Umgebungsdateien mit dem Agents-Toolkit

Agents Toolkit folgt einem Standardbenennungsmuster für Umgebungsdateien, z .env.{environment-name}. B. . Wenn Sie Lebenszyklusbefehle wie Bereitstellen, Bereitstellen oder Veröffentlichen ausführen, müssen Sie einen Umgebungsnamen angeben. Dieser Name muss mit dem {environment-name} in der entsprechenden Umgebungsdatei verwendeten übereinstimmen.

Speicherort der Umgebungsdatei

Standardmäßig lädt das Agents Toolkit keine Umgebungsvariablen und führt einfach Aktionen aus, wobei Ausgaben in ./env/.env.devgespeichert werden. Wenn Sie keinen angeben environmentFolderPath, liest er keine Variablen aus einer ENV-Datei und geht davon aus, dass die Umgebung auf devfestgelegt ist, wobei ausgaben an ./env/.env.devweitergeleitet werden.

Lokale Umgebungen

Das Erstellen eines Microsoft Teams-Agents oder einer Microsoft Teams-App umfasst sowohl Cloudressourcen als auch lokale Ressourcen. Cloudressourcen umfassen App-Registrierungen und den Teams-Client, während Agent- oder App-Logik lokal ausgeführt werden kann, um Entwicklung und Tests zu beschleunigen. Alle Agents Toolkit-Vorlagen enthalten eine vorkonfigurierte local Umgebung mit ./env/.env.local - und ./env/.env.local.user -Dateien. Mit diesem Setup können Sie Ihren Agent oder Ihre App auf einem lokalen Webserver ausführen und mit Haltepunkten in Visual Studio Code (für JavaScript, TypeScript oder Python-Agent oder -App) oder Visual Studio (für CSharp-Agent oder -App) debuggen.

Um zwischen einer lokalen Umgebung und allen anderen Umgebungen zu unterscheiden, können Sie eine separate Projektdatei mit dem Namen m365agents.local.yml im selben Verzeichnis wie m365agents.ymlerstellen.

Manuelles Erstellen einer neuen Umgebung in Visual Studio Code

Jedes Projekt kann über eine lokale Umgebung und mehrere Remoteumgebungen verfügen. Nachdem Sie ein Projekt erstellt haben, konfiguriert das Agents Toolkit die folgenden Standardumgebungen:

• Lokale Umgebung zur Darstellung der Umgebungskonfiguration des lokalen Computers.
• Entwicklungsumgebung zur Darstellung der Remote- oder Cloudumgebungskonfiguration.

So erstellen Sie eine neue Umgebung:

1. Öffnen Sie Ihren Teams-Agent- oder App-Projektarbeitsbereich in Visual Studio Code.

2. Wählen Sie auf der Aktivitätsleiste von Visual Studio Code das Symbol Microsoft 365 Agents Toolkit aus.

3. Wählen Sie das + Symbol im Abschnitt UMGEBUNG aus.

   

4. Geben Sie einen Namen für die Umgebung ein, und drücken Sie die EINGABETASTE.

   

Ziel einer Umgebung für Remotebuild

Wenn Sie mit mehreren Umgebungen arbeiten, müssen Sie eine Zielumgebung auswählen, um Ihren Agent oder Ihre App in Microsoft Teams zu erstellen, zu debuggen und eine Vorschau anzuzeigen. Sie können die Zielumgebung direkt aus den Buildeinstellungen auswählen.

Auswählen einer Umgebung

So richten Sie dev oder eine andere benutzerdefinierte Umgebung ein:

1. Wählen Sie im Abschnitt Lebenszyklus des Agents-Toolkits die Option Bereitstellen für Ihren Agent oder Ihre App aus.

   

2. Wenn Sie dazu aufgefordert werden, wählen Sie eine der verfügbaren Umgebungen aus (z. B dev . oder eine benutzerdefinierte Umgebung).

   

Das Agents Toolkit stellt den Agent oder die App für die ausgewählte Umgebung bereit. Sie können jetzt Ihren Agent oder Ihre App in der ausgewählten Umgebung erstellen.

Erstellen in der ausgewählten Umgebung

Nachdem die Umgebung ausgewählt wurde, stellt das Agents Toolkit den Agent oder die App für diese Umgebung bereit. Sie können ihren Agent oder Ihre App jetzt in der ausgewählten Umgebung erstellen, debuggen und ausführen.

1. Wählen Sie auf der Randleiste von Visual Studio Code das Symbol Ausführen und Debuggen aus.

2. Wählen Sie die Option zum Debuggen und zum Anzeigen einer Vorschau des Remote-Agents oder der App in Microsoft Teams aus.

   

Das Agents-Toolkit erstellt den Agent oder die App in der Umgebung, für die Sie bereitgestellt haben. Der Agent oder die App steht zum Anzeigen und Testen in Teams zur Verfügung.

Siehe auch

• Übersicht über das Microsoft 365-Agents-Toolkit
• App-Manifestschema für Teams
• Hinzufügen weiterer Cloudressourcen
• Zusammenarbeit mit anderen Entwicklern am Teams-Projekt
• Testen des App-Verhaltens in einer anderen Umgebung