Häufig gestellte Fragen zu Azure Bot Framework

Dieser Artikel bietet Antworten auf häufig gestellte Fragen zu Azure.

GILT FÜR: SDK v4

Wie erstelle ich meine eigene App-Registrierung?

Sie können eine eigene App-Registrierung erstellen, wenn:

  • Sie Ihren Bot im Bot Framework-Portal erstellt haben.
  • Sie die App-Registrierung für einen Drittanbieter erstellt haben, der keinen Zugriff auf Azure hat.
  • Sie Ihre eigene App-ID (und Kennwort) manuell erstellen müssen.

Führen Sie die folgenden Schritte aus.

  1. Melden Sie sich bei Ihrem Azure-Konto an. Wenn Sie kein Azure-Konto haben, können Sie sich für ein kostenloses Konto registrieren.

  2. Wechseln Sie zum Blatt App-Registrierungen, und klicken Sie oben auf der Aktionsleiste auf Neue Registrierung.

    new registration

  3. Geben Sie in das Feld Name einen Anzeigenamen für die Anwendungsregistrierung ein, und wählen Sie die unterstützten Kontotypen aus.

    registration details

  4. Wählen Sie Registrieren aus.

    Nach kurzer Zeit sollte durch die neu erstellte App-Registrierung ein Blatt geöffnet werden. Kopieren Sie auf der Seite Übersicht die Anwendungs-ID (Client) und speichern Sie sie. Sie müssen es benötigen, um das zugehörige App-ID-Feld während der Boterstellung aufzufüllen, wie weiter unten in diesem Artikel erläutert.

    application id

Erstellen eines Bots über das Azure-Portal

Wenn Sie Ihren Bot im Azure-Portal mithilfe der Azure Bot-Ressource erstellen, müssen Sie einen geheimen Schlüssel (Client-Geheimnis) für ihre App-Registrierung generieren.

  1. Wählen Sie zertifikate und geheime Schlüssel in der linken Navigationsspalte des Bereichs Ihrer App-Registrierung aus.

  2. Wählen Sie in diesem Bereich auf der rechten Seite die Schaltfläche Neues Client-Geheimnis aus. Geben Sie im eingeblendeten Dialogfeld eine optionale Beschreibung für das Geheimnis ein und wählen Sie die Ablauffrist aus der Ablauffrist-Optionsfeldgruppe.

    new secret

  3. Wählen Sie Hinzufügen aus.

  4. Kopieren Sie den Wert des geheimen Schlüssels aus der Tabelle unter Client-Geheimnisse und speichern Sie ihn.

    copy secret

  5. Geben Sie während der Bot-Registrierung beim Erstellen der App-ID und des Kennworts die App-ID und das Geheimnis ein, das Sie in den richtigen Eingabefeldern gespeichert haben, wie in der Abbildung unten dargestellt.

    Hinweis

    Das Geheimnis ist nur auf diesem Blatt sichtbar und kann nach dem Verlassen dieser Seite nicht mehr abgerufen werden. Kopieren Sie es deshalb an einen sicheren Speicherort.

    new app id

Ein Beispiel für die Anwendung der oben genannten Schritte finden Sie unter Hinzufügen der Authentifizierung zu einem Bot.

Welche Dateien muss ich für die Bereitstellung zippen?

Sie müssen manuell ein Zip-Archiv mit allen Dateien im Projekt erstellen, wie im Schritt Zippen Sie das Codeverzeichnis manuell beschrieben. Stellen Sie sicher, dass Sie alle Dateien und Ordner im Projektordner Ihres Bots auswählen. Wenn Sie sich dann noch im Projektordner befinden, zippen Sie alle ausgewählten Dateien und Ordner, wie in der Abbildung unten dargestellt.

select all and zip

Welche Version von Azure CLI sollte ich zum Bereitstellen eines Bots verwenden?

Verwenden Sie die neueste Version der Azure-Befehlszeilenschnittstelle (CLI), andernfalls erhalten Sie veraltete Befehle. Weitere Informationen finden Sie unter Installieren der Azure CLI.

Was sollte ich tun, wenn ich Azure CLI-Veraltungsfehler erhalte?

Führen Sie ein Upgrade auf die neueste Version von Azure CLI durch. Für Azure CLI Version 2.2.0 oder höher müssen Sie die Befehle az deployment sub create und az deployment group create anstelle von az deployment create und az group deployment create verwenden

Änderungsprotokoll der Azure CLI-Befehle, die zum Bereitstellen eines Bots in Azure verwendet werden

Azure CLI-Version BEFEHL1 Befehl 2
Azure CLI, 2.2.0 und spätere Versionen az deployment group create az deployment sub create
Azure CLI, 2.1.0 und frühere Versionen az group deployment create az deployment create

Weitere Informationen finden Sie unter Azure CLI-Änderungsprotokoll.

Was sind die veralteten CLI-Befehle im Zusammenhang mit der „az-Bereitstellung“?

Die folgenden sind die az deployment veralteten Befehle:

Als veraltet markiert Ersetzt durch
az deployment <create/list show/delete/validate/export/cancel> az deployment **sub** <create/list/show/delete/validate/export/cancel>
az deployment operation <list/show> az deployment operation **sub** <list/show>
az group deployment <create/list/show/delete/validate/export/cancel> az deployment **group** <create/list/show/delete/validate/export/cancel>
az group deployment operation <list/show> az deployment operation **group** < list/show>

Wie weiß ich, ob die Azure CLI-Befehle veraltet sind?

Um zu wissen, ob ein Azure CLI-Befehl veraltet ist, führen Sie den Befehl mit der -h Option (Hilfe) aus, wie in der Abbildung unten dargestellt.

cli help

Azure CLI-Änderungsprotokoll

Weitere Informationen zum Azure CLI-Änderungsprotokoll.

Azure Resource Manager (ARM)

Es folgt eine konsolidierte Liste der Befehle, die dem aktuellen Azure CLI-Design entsprechen: az {command group} {?sub-command-group} {operation} {parameters}.

  • az resource: Beispiele für das Ressourcenmodul verbessert
  • az policy assignment list: Unterstützung für das Auflisten von Richtlinienzuweisungen im Verwaltungsgruppenbereich
  • az deployment group und az deployment operation group für Vorlagenbereitstellung in Ressourcengruppen hinzugefügt Dies ist ein Duplikat von az group deployment und az group deployment operation.
  • az deployment sub und az deployment operation sub für Vorlagenbereitstellung im Abonnementbereich hinzugefügt Dies ist ein Duplikat von az deployment und az deployment operation.
  • az deployment mg und az deployment operation mg für Vorlagenbereitstellung in Verwaltungsgruppen hinzufügen
  • ad deployment tenant und az deployment operation tenant für Vorlagenbereitstellung im Mandantenbereich hinzufügen
  • az policy assignment create: Beschreibung zu Parameter --location hinzufügen
  • az group deployment create: Parameter --aux-tenants zur mandantenübergreifenden Unterstützung hinzufügen

Was ist die Azure Bot-Ressource?

Die Azure Bot-Ressource ist ein Update aus der Registrierung von Web App Bot oder Bot-Kanälen, wodurch Entwickler einfacher mit dem Bot Framework Composer-Bot-Entwicklungstool beginnen können. Anstatt Ressourcen wie eine Web-App während der Bot-Erstellung zu erstellen, werden Ressourcen mithilfe von Bot Framework Composer erstellt, was mehr Flexibilität bei der Bereitstellung von Ressourcen bietet. Composer bietet einen visuellen Entwurfsbereich, der die Bot-Entwicklung vereinfacht.

Warum ist die Web App Bot- und Bot-Kanalregistrierung veraltet?

Funktionell nutzen Azure Bot, Web-App-Bot und Bot-Kanalregistrierung alle den Bot-Dienst auf die gleiche Weise–„unter der Haube“. Der Azure Bot-Pfad ist einfacher und für Entwickler konfigurierbarer. Altelemente werden aus dem Azure Marketplace entfernt, vorhandene Ressourcen werden jedoch weiterhin ausgeführt und unterstützt.

Funktioniert meine Web App Bot- oder Bot-Kanalregistrierung weiterhin und wie lange?

Ja, Ihre Web App Bot- oder Bot-Kanalregistrierungs-basierte Ressource wird weiterhin ausgeführt. Es gibt keine Pläne, die Unterstützung für vorhandene Botressourcen einzustellen.

Muss ich meinen vorhandenen Bot zum Azure Bot migrieren?

Nein, Sie müssen Ihren vorhandenen Bot nicht migrieren. sie wird weiterhin wie folgt ausgeführt.

Kann ich meine vorhandene Bot-Ressource zu Azure Bot migrieren?

Dies wird derzeit nicht unterstützt. Wenn Ihr Bot nicht in der Produktion verwendet wird, können Sie Ihre alte Botressource löschen und den Botnamen und die App-ID in einer neuen Bot-Ressource wiederverwenden (nach einiger Zeit, damit der alte Datensatz gelöscht wird). Der neue Azure Bot wurde entwickelt, um Ihren Bot mithilfe von Composer zu erstellen, und daher wären die Gewinne aus einer solchen Migration minimal.

Was ist der Unterschied zwischen dem Azure Bot und der Registrierung von Web App-Bot- oder Bot-Kanälen?

Der Bot-Dienst hinter Azure Bot- und Web App-Bot/Bot-Kanalregistrierung ist identisch; die Änderung besteht darin, wie die Ressourcen erstellt werden, die Sie in Ihrem Bot verwenden, z. B. Web-Apps, Sprachverständnis und vieles mehr. Anstatt von Vorlagen in Einheitsgröße, die vom Web App Bot verwendet werden, kann Bot Framework Composer verwendet werden, um Ressourcen für den Bot mit viel mehr Flexibilität zu erstellen als die zulässigen Web App Bot-Vorlagen. Bot-Kanalregistration und Azure Bot sind quasi dieselben Kapazitäten mit anderem Namen. Die UX unterscheidet sich im Azure-Portal geringfügig, um Kunden bei der Verbindung mit Bot Framework Composer zu helfen.