Freigeben über

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

  • Artikel

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.

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.

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 AI Bot Service, alle Bot Framework SDK-Sprachen, Composer, der Emulator und 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 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.

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 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:

  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.

      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.

Weitere Informationen

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 Version 4.15.0 oder höher, ist für benutzerseitig zugewiesene verwaltete Identität und mandantenfähige Bots erforderlich.

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.

  Mehrinstanzenfähiger Skill Single-Tenant-Skill Skill der benutzerseitig zugewiesenen verwalteten Identität
Mehrinstanzenfähige Verbraucher Unterstützt Nicht unterstützt Nicht unterstützt
Einzelinstanzenfähige Verbraucher Nicht unterstützt Unterstützt, wenn beide Apps zu demselben Mandanten gehören Unterstützt, wenn beide Apps zu demselben Mandanten gehören
Consumer einer benutzerseitig zugewiesenen 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.

Nächste Schritte