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.
GILT FÜR: SDK v4
Mit der Azure Bot-Ressource (Bot-Ressource) können Sie Ihren Bot bei Azure KI Bot Service registrieren und Ihren Bot mit Kanälen verbinden. Sie können Bots erstellen, verbinden und verwalten, um mit Ihren Benutzern überall zu interagieren, von Ihrer App oder Website bis hin zu Teams, Messengern und vielen anderen Kanälen.
Dieser Artikel beschreibt, wie Sie eine Bot-Ressource über das Azure-Portal erstellen.
- Informationen zum Erstellen eines Agents finden Sie in der Schnellstartanleitung: Erstellen und Testen eines einfachen Agent-Schnellstarts.
- Informationen zum Bereitstellen und Veröffentlichen eines Bots in Azure finden Sie unter Bereitstellen Ihres Bots in Azure.
Verwalten von Ressourcen
Wenn Sie eine Bot-Ressource erstellen, erstellt Azure zugeordnete Ressourcen. Einige der erstellten Ressourcen hängen davon ab, wie Sie die Identität Ihres Bots verwalten.
Die Identität Ihres Bots kann in Azure auf verschiedene Arten verwaltet werden:
- Als vom Benutzer zugewiesene verwaltete Identität müssen Sie anmeldeinformationen nicht manuell verwalten.
- Als Single-Tenant-Anwendung.
- Als mehrinstanzfähige Anwendung.
Hinweis
- Unterstützung für vom Benutzer zugewiesene verwaltete Identitäts- und Einzelmandanten-App-Typen ist im Bot Framework SDK für C#, JavaScript und Python verfügbar.
- Diese App-Typen werden in anderen SDK-Sprachen, Bot Framework Composer, Bot Framework Emulator oder Dev Tunnels nicht unterstützt .
Wichtig
- Die Erstellung von Bots mit mehreren Mandanten wird nach dem 31. Juli 2025 nicht mehr unterstützt.
- Vorhandene Mehrinstanzen-Bots funktionieren weiterhin, aber die erstellung eines neuen mehrinstanzenfähigen Bots wird nach diesem Datum nicht mehr unterstützt.
- Um eine fortgesetzte Unterstützung sicherzustellen, verwenden Sie in Zukunft eine Single-Tenant-Managed-Identity oder eine benutzerzugewiesene Managed Identity.
Unterstützte App-Typen
| App-Typ | Unterstützt in |
|---|---|
| Benutzerseitig zugewiesene verwaltete Identität | Azure KI Bot Service; C#-, JavaScript- und Python-SDKs |
| Einzelinstanz | Azure KI Bot Service; C#-, JavaScript- und Python-SDKs |
| Mehrere Mandanten (veraltet – endet am 31. Juli 2025) | Azure KI Bot Service; alle Bot Framework SDK-Sprachen; Komponist; Emulator; Dev Tunnels |
Voraussetzungen
- Wenn Sie kein Azure-Abonnement besitzen, können Sie ein kostenloses Konto erstellen, bevor Sie beginnen.
- Das Bot Framework SDK für C# oder JavaScript, Version 4.15.0 oder höher, für benutzerzugewiesene verwaltete Identitäten und Single-Tenant-Bots.
Erstellen der Ressource
Erstellen Sie die Azure Bot-Ressource, mit der Sie Ihren Bot beim Azure KI Bot Service registrieren können.
Tipp
Neue Web App-Bot- und Bot-Kanalregistrierungs-Ressourcen können nicht erstellt werden. Alle vorhandenen Ressourcen, die konfiguriert und bereitgestellt werden, funktionieren jedoch weiterhin. Bots, die aus einer VSIX- oder Yeoman-Vorlage aus der SDK-Version 4.14.1.2 oder höher erstellt wurden, enthalten ARM-Vorlagen, die eine Azure Bot-Ressource generieren.
Öffnen Sie das Azure-Portal.
Wählen Sie im rechten Bereich Ressource erstellen.
Geben Sie
botin das Suchfeld ein, und drücken Sie die Eingabetaste.Wählen Sie die Azure Bot-Karte.
Klicken Sie auf Erstellen.
Geben Sie Werte in die Pflichtfelder ein und überprüfen und aktualisieren Sie die Einstellungen.
Geben Sie Informationen unter Projektdetails an. Wählen Sie aus, ob Ihr Bot über einen globalen oder lokalen Datenspeicher verfügt. Derzeit steht die lokale Datenaufbewahrungsfunktion für Ressourcen in der Region "Westeuropa" und "Centralindia" zur Verfügung. Weitere Informationen finden Sie unter Regionalisierung bei Azure KI Bot Service.
Geben Sie Informationen unter der Microsoft App-ID an. Wählen Sie aus, wie Ihre Bot-Identität in Azure verwaltet wird und ob Sie eine neue Identität erstellen oder eine vorhandene verwenden möchten.
Klicken Sie auf Überprüfen + erstellen.
Wenn die Validierung erfolgreich war, wählen Sie Erstellen.
Wählen Sie nach Abschluss der Bereitstellung die Option Zu Ressource wechseln aus. Der Bot und die zugehörigen aufgelisteten Ressourcen sollten in der ausgewählten Ressourcengruppe aufgeführt sein.
Wenn Sie noch nicht über das Bot Framework SDK verfügen, wählen Sie Von GitHub herunterladen aus, um zu erfahren, wie Sie die Pakete für Ihre bevorzugte Sprache nutzen können.
Jetzt können Sie Ihren Bot mit dem Bot Framework SDK erstellen.
Tipp
Wenn Azure eine neue Einzel- oder mehrinstanzfähige Azure Bot-Ressource mit einer neuen App-ID erstellt, wird auch ein Passwort generiert.
Bot-Identitätsinformationen
Führen Sie die folgenden Schritte aus, um Identitätsinformationen zur Konfigurationsdatei Ihres Bots hinzuzufügen. Die Datei unterscheidet sich je nach programmiersprache, die zum Erstellen des Bots verwendet wird.
Wichtig
- Die Java-Version des Bot Framework SDK unterstützt nur mehrinstanzenfähige Bots.
- Die C#-, JavaScript- und Python-Versionen unterstützen alle drei Anwendungstypen zum Verwalten der Identität des Bots.
| Sprache | Dateiname | Hinweise |
|---|---|---|
| C# | appsettings.json | Unterstützt alle drei Anwendungstypen zum Verwalten der Identität Ihres Bots. |
| JavaScript | .env | Unterstützt alle drei Anwendungstypen zum Verwalten der Identität Ihres Bots. |
| Java | application.properties | Unterstützt nur mehrinstanzfähige Bots. |
| Python | config.py | Unterstützt alle drei Anwendungstypen zum Verwalten der Identität Ihres Bots. |
Welche Identitätsinformationen Sie hinzufügen müssen, hängt vom Anwendungstyp des Bots ab. Stellen Sie in der Konfigurationsdatei folgende Werte bereit.
Verfügbar für C#-, JavaScript- und Python-Bots.
| Eigenschaft | Wert |
|---|---|
MicrosoftAppType |
UserAssignedMSI |
MicrosoftAppId |
Die Client-ID einer benutzerseitig zugewiesenen verwalteten Identität. |
MicrosoftAppPassword |
Nicht zutreffend. Lassen Sie diesen Wert für einen Bot mit benutzerseitig zugewiesener verwalteter Identität leer. |
MicrosoftAppTenantId |
Die Instanz-ID der benutzerseitig zugewiesenen verwalteten Identität. |
So aktualisieren Sie Ihren App-Dienst
Wenn Sie über eine bestehende App Service-Ressource (Web-App) für Ihren Bot verfügen und Ihr Bot eine benutzerseitig zugewiesene verwaltete Identitäts-Anwendung ist, müssen Sie möglicherweise den App-Dienst Ihres Bots aktualisieren:
- Wechseln Sie zum App Service-Bereich Ihrer Bot-Web-App.
- Wählen Sie unter EinstellungenIdentität aus:
- Wählen Sie im Bereich Identität die Registerkarte Benutzerseitig zugewiesen aus, und wählen Sie dann Hinzufügen (+) aus.
- Im Bereich Benutzerzugewiesene verwaltete Identität hinzufügen:
Wählen Sie Ihr Abonnement aus.
Wählen Sie für die vom Benutzer zugewiesenen verwalteten Identitäten die verwaltete Identität für Ihren Bot aus. Wenn die verwaltete Identität automatisch für Sie generiert wurde, hat sie denselben Namen wie Ihr Bot.
Wählen Sie Hinzufügen aus, um diese Identität für Ihren Bot zu verwenden.
Abrufen Ihrer App- oder Mandanten-ID
So erhalten Sie die App- oder Mandanten-ID Ihres Bots:
- Öffnen Sie das Bot-Ressourcen-Blatt für Ihren Bot in Azure.
- Navigieren Sie zum Bereich Konfiguration des Bots. Von diesem Blatt aus können Sie die Microsoft App-ID oder die App-Mandanten-ID des Bots kopieren.
Um ein neues Kennwort zu generieren
Einzel- und Mehrinstanz-Bots verfügen über einen App-Geheimschlüssel oder ein Passwort, das Sie für einige Vorgänge benötigen. Azure KI Bot Service verbirgt das Bot-Geheimnis. Der Besitzer der App Service-Ressource des Bots kann jedoch ein neues Passwort generieren:
- Öffnen Sie das Bot-Ressourcen-Blatt für Ihren Bot in Azure.
- Navigieren Sie zum Bereich Konfiguration des Bots.
- Wählen Sie Verwalten neben der Microsoft App-ID aus, um zum Blatt Zertifikate + Geheimnisse für den App-Dienst zu wechseln.
- Folgen Sie den Anweisungen in dem Bereich, um ein neues Clientgeheimnis zu erstellen, und speichern Sie den Wert an einem sicheren Ort.
Weitere Informationen
- Informationen zur Identitätsverwaltung mit Microsoft Entra ID finden Sie unter Was ist Microsoft Entra ID?.
- Informationen über Azure App Service und App Service-Pläne finden Sie in der App Service-Übersicht.
- Informationen über Azure-Ressourcen und deren Verwaltung im Allgemeinen finden Sie in der Übersicht über den Azure Resource Manager.
Hinweis
Der Bot Framework Composer- und Bot Framework-Emulator unterstützt derzeit nur mehrinstanzenfähige Bots. Das Bot Framework SDK für C# oder JavaScript in Version 4.15.0 oder höher ist für vom Benutzer zugewiesene verwaltete Identitäten und Single-Tenant-Bots erforderlich.
Unterstützung für Skills
Einige Typen von Skillconsumern sind nicht in der Lage, einige Typen von Skill-Bots zu verwenden. In der folgenden Tabelle wird beschrieben, welche Kombinationen unterstützt werden.
| Mehrinstanzenfähiger Skill | Einzelmandanten-Funktion | Skill für die vom Benutzer zugewiesene verwaltete Identität | |
|---|---|---|---|
| Mehrinstanzenfähige Verbraucher | Unterstützt | Nicht unterstützt | Nicht unterstützt |
| Einzelmandanten-Consumer | Nicht unterstützt | Unterstützt, wenn beide Apps zu demselben Mandanten gehören | Unterstützt, wenn beide Apps zu demselben Mandanten gehören |
| Nutzer einer benutzerzugewiesenen verwalteten Identität | Nicht unterstützt | Unterstützt, wenn beide Apps zu demselben Mandanten gehören | Unterstützt, wenn beide Apps zu demselben Mandanten gehören |
Informationen zum Konfigurieren eines Skills oder Skillconsumers finden Sie unter Implementieren eines Skills oder Implementieren eines Skillconsumers.