Verwenden Sie das Azure-Portal, um eine Azure-Bot-Ressource zu erstellen

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 Bots finden Sie im Schnellstart zum Erstellen eines Bots mit dem Bot Framework SDK.
• 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.

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 Dev Tunnels nicht unterstützt.

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 benutzerseitig zugewiesene verwaltete Identität und mandantenfähige Bots.

Erstellen der Ressource

Erstellen Sie die Azure Bot-Ressource, mit der Sie Ihren Bot beim Azure KI Bot Service registrieren können.

1. Öffnen Sie das Azure-Portal.

2. Wählen Sie im rechten Bereich Ressource erstellen.

3. Geben Sie bot in das Suchfeld ein, und drücken Sie die Eingabetaste.

4. Wählen Sie die Azure Bot-Karte.

   

5. Klicken Sie auf Erstellen.

6. Geben Sie Werte in die Pflichtfelder ein und überprüfen und aktualisieren Sie die Einstellungen.

   1. 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.

      

   2. 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.

      

7. Klicken Sie auf Überprüfen + erstellen.

8. Wenn die Validierung erfolgreich war, wählen Sie Erstellen.

9. 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.

10. 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.

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.

Welche Identitätsinformationen Sie hinzufügen müssen, hängt vom Anwendungstyp des Bots ab. Stellen Sie in der Konfigurationsdatei folgende Werte bereit.

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:

1. Wechseln Sie zum Blatt App Service für die Web-App Ihres Bots.
2. Wählen Sie unter Einstellungen Identität aus:
3. Wählen Sie auf dem Blatt Identität die Registerkarte vom Benutzer zugewiesen und wählen Sie Hinzufügen (+).
4. Auf dem Blatt Benutzerseitig zugewiesene verwaltete Identität hinzufügen:

   1. Wählen Sie Ihr Abonnement aus.

   2. 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.

   3. 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

1. Öffnen Sie das Bot-Ressourcen-Blatt für Ihren Bot in Azure.
2. 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:

1. Öffnen Sie das Bot-Ressourcen-Blatt für Ihren Bot in Azure.
2. Navigieren Sie zum Blatt Konfigurations.
3. Wählen Sie Verwalten neben der Microsoft App-ID aus, um zum Blatt Zertifikate + Geheimnisse für den App-Dienst zu wechseln.
4. Folgen Sie den Anweisungen auf dem Blatt, um einen neuen geheimen Client-Geheimnis zu erstellen und verwahren 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.

Skill-Support

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.

Informationen zum Konfigurieren eines Skills oder Skillconsumers finden Sie unter Implementieren eines Skills oder Implementieren eines Skillconsumers.

Nächste Schritte

• Erstellen eines Bots mit Bot Framework Composer
• Erstellen eines Bots mit dem Bot Framework SDK