Registrieren eines Bots bei Azure
GILT FÜR: SDK v4
Wenn Sie Ihren Bot derzeit nicht in Azure hosten, können Sie ihn trotzdem in Azure verfügbar machen und Azure nutzen, um Ihren Bot mit Kanälen zu verbinden. Geben Sie dazu in Azure die Webadresse ein, an der Ihr Bot gehostet wird.
In diesem Artikel wird gezeigt, wie Sie einen solchen Bot bei Azure KI Bot Service registrieren.
Wichtig
Sie müssen einen Bot nur registrieren, wenn er nicht in Azure gehostet wird. Bots, die mit der Azure CLI erstellt wurden, sind bereits beim Azure KI Bot Service registriert.
Ihre Bot-Identität kann in Azure auf verschiedene Arten verwaltet werden.
- Als eine benutzerseitig zugewiesene verwaltete Identität, damit Sie die Anmeldedaten des Bots nicht selbst verwalten müssen.
- Als einzelinstanzfähige Anwendung.
- Als mehrinstanzfähige Anwendung.
Unterstützung für die vom Benutzer zugewiesenen verwalteten Identitäts- und Einzelmandanten-App-Typen wurde dem Bot Framework SDK für C#, JavaScript und Python hinzugefügt. Diese App-Typen werden in den anderen Sprachen oder in Bot Framework Composer, Bot Framework Emulator oder ngrok nicht unterstützt.
App-Typ | Unterstützung |
---|---|
Benutzerseitig zugewiesene verwaltete Identität | Azure AI Bot Service und die C#-, JavaScript- und Python-SDKs |
Einzelinstanz | Azure AI Bot Service und die C#-, JavaScript- und Python-SDKs |
Mehrinstanz | Azure KI Bot Service, alle Bot Framework SDK-Sprachen, Composer, der Emulator und ngrok |
In diesem Artikel wird nicht beschrieben, wie der Bot zum Registrieren erstellt oder bereitgestellt wird. Weitere Informationen finden Sie unter:
- Die Kurzanleitung Erstellen eines Bots
- Das Tutorial Bereitstellen eines einfachen 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
bot
in 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 Sie zum Erstellen des Bots verwenden.
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 Blatt App Service für die Web-App Ihres Bots.
- Wählen Sie unter Einstellungen Identität aus:
- Wählen Sie auf dem Blatt Identität die Registerkarte vom Benutzer zugewiesen und wählen Sie Hinzufügen (+).
- Auf dem Blatt Benutzerseitig zugewiesene verwaltete Identität hinzufügen:
Wählen Sie Ihr Abonnement aus.
Wählen Sie für benutzerseitig zugewiesene verwaltete Identität 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.
So rufen Sie Ihre App- oder Mandanten-ID ab
So rufen Sie die App- oder Mandanten-ID Ihres Bots ab
- Öffnen Sie das Bot-Ressourcen-Blatt für Ihren Bot in Azure.
- Navigieren Sie zum Blatt Konfigurations. 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 blendet Ihren Botschlüssel aus. 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 Blatt Konfigurations.
- 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 auf dem Blatt, um einen neuen geheimen Client-Geheimnis zu erstellen und verwahren Sie den Wert an einem sicheren Ort.
Manuelle App-Registrierung
Eine manuelle Registrierung ist erforderlich, wenn:
- Sie keine Registrierungen in Ihrer Organisation vornehmen können und eine Drittpartei benötigen, um die App-ID für den Bot zu erstellen, den Sie entwickeln.
- Sie müssen Ihre eigene App-ID und Ihr Passwort manuell erstellen.
Aktualisieren des Bots
Informationen zum Aktualisieren der Konfigurationsdatei Ihres Bots, um die App-ID und das Kennwort einzuschließen, finden Sie unter Anwendungs-ID und Passwort in Konfigurieren von Bot-Registrierungseinstellungen.
Weitere Informationen
Weitere Informationen finden Sie in diesen Artikeln zu Azure-Anwendungen im Allgemeinen.
Betreff | Artikel |
---|---|
App-Registrierung | Schnellstart: Registrieren einer Anwendung bei Microsoft Identity Platform |
Verwaltete Identitäten | Was sind verwaltete Identitäten für Azure-Ressourcen? |
Apps mit nur einem Mandanten und mit mehreren Mandanten | Mandanten in Microsoft Entra ID |