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 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 KI Bot Service und die C#- und JavaScript-SDKs
Mehrinstanz	Azure KI Bot Service, alle Bot Framework SDK-Sprachen, Composer, der Emulator und ngrok

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.

   

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.

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- und Python-Versionen des Bot Framework SDK unterstützen nur mehrinstanzfähige 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 nur mehrinstanzfähige Bots. Geben Sie die Identitätseigenschaften 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.

Benutzerseitig zugewiesene verwaltete Identität

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.

Einzelinstanz

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

Eigenschaft	Wert
MicrosoftAppType	SingleTenant
MicrosoftAppId	Die App-ID des Bots.
MicrosoftAppPassword	App-Passwort des Bots.
MicrosoftAppTenantId	Die Instanz-ID des Bots.

Mehrinstanz

Verfügbar für Bots in allen Programmiersprachen: C#, JavaScript, Java und Python.

Eigenschaft	Wert
MicrosoftAppType	MultiTenant
MicrosoftAppId	Die App-ID des Bots.
MicrosoftAppPassword	App-Passwort des Bots.
MicrosoftAppTenantId	Nicht zutreffend. Lassen Sie diesen Wert für einen mehrinstanzfähigen Bot leer.

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.

      

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.

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

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