Registrieren eines Bots bei Azure

  • Artikel

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 benutzerseitig zugewiesene verwaltete Identität und Einzelinstanz-App-Typen wurde dem Bot Framework SDK für C# und JavaScript in Version 4.15.0 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 KI Bot Service und die C#- und JavaScript-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:

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.

  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.

    Azure Bot-Ressource auswählen

  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.

      Die Projektdetailseinstellungen für eine Azure Bot-Ressource

    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.

      Die Microsoft-App-ID-Einstellungen für eine Azure Bot-Ressource

  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.

    Erstellen eines Bots im SDK

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 Python-Version des Bot Framework SDK unterstützt Mehrinstanzen- und Einzelmandanten-Bots. Die C#- und JavaScript-Versionen unterstützen alle drei Anwendungstypen zum Verwalten der Bot-Identität.

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 Mehrinstanzen- und Einzelmandanten-Bots. Geben Sie die Eigenschaften als Argumente für die os.environ.get Methodenaufrufe an.

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

Nur für C#- und JavaScript-Bots verfügbar.

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:

  1. Wechseln Sie zum Blatt App Service für die Web-App Ihres Bots.
  2. Wählen Sie unter EinstellungenIdentitä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.

      Das Blatt

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.

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

Nächste Schritte

Verwalten eines Bots