Konfigurieren von BotregistrierungseinstellungenConfigure bot registration settings

gilt für: SDK v4APPLIES TO: SDK v4

Die Azure Bot-Ressourceneinstellungen, z. B. Anzeigename, Symbol und Beschreibung, können im Botprofilbereich angezeigt und geändert werden.The Azure Bot resource settings, such as display name, icon, and description, can be viewed and modified in the Bot profile pane. Die Azure Bot-Ressourceneinstellungen, z. B. Messagingendpunkt, Microsoft-App-ID und Application Insights, können im Bereich Konfiguration angezeigt und geändert werden.The Azure Bot resource settings, such as messaging endpoint, Microsoft app ID, and Application Insights, can be viewed and modified in the Configuration pane.

BotprofilBot profile

Botprofileinstellungen.

Im Folgenden finden Sie die Liste der Botprofilfelder:Below is the list of the Bot profile fields:

FeldField BESCHREIBUNGDescription
SymbolIcon Ein benutzerdefiniertes Symbol zum visuellen Identifizieren Ihres Bots in Kanälen und als Symbol für Ihren Bot in Microsoft Teams oder anderen Diensten.A custom icon to visually identify your bot in channels and as the icon for your bot in Microsoft Teams or other services.
Display nameDisplay name Der Name Ihres Bots in Kanälen und Verzeichnissen.The name of your bot in channels and directories. Sie können diesen Wert später ändern.You can change this value later.
BothandleBot handle Ein eindeutiger Bezeichner für Ihren Bot.A unique identifier for your bot. Dieser Wert kann nach dem Erstellen des Bots mit dem Botdienst nicht geändert werden.This value cannot be changed after creating your bot with the Bot Service.
BESCHREIBUNGDescription Eine Beschreibung Ihres Bots.A description of your bot. Einige Kanäle zeigen die Beschreibung an.Some channels display the description. Sie können diesen Wert später ändern.You can change this value later.

Klicken Sie unten auf dem Blatt auf Übernehmen, um die Änderungen zu speichern.To save your changes, select Apply at the bottom of the blade.

KonfigurationConfiguration

Botkonfigurationseinstellungen.

Im Folgenden finden Sie die Liste der Konfigurationsfelder:Below is the list of the Configuration fields:

FeldField BESCHREIBUNGDescription
Messaging-EndpunktMessaging endpoint Der Endpunkt für die Kommunikation mit Ihrem Bot.The endpoint to communicate with your bot.
Microsoft-App-IDMicrosoft App ID Eindeutiger Bezeichner für den Bot.Unique identifier for your bot. Dieser Wert kann nicht geändert werden.This value cannot be changed. Sie können ein neues Kennwort generieren, indem Sie auf den Link Verwalten klicken.You can generate a new password by clicking on the Manage link.
SchematransformationsversionSchema Transformation Version Die Botschematransformationsversion, die für diesen Bot verwendet werden soll.The bot schema transform version to use for this bot. Weitere Informationen finden Sie unter Verbinden eines Bots mit Kanälen.For more information, see Connect a bot to channels.
Application Insights-InstrumentierungsschlüsselApplication Insights Instrumentation key Eindeutiger Schlüssel für Bot-Telemetriedaten.Unique key for bot telemetry. Kopieren Sie Ihren Azure Application Insights-Schlüssel in dieses Feld, wenn Sie Telemetriedaten für diesen Bot empfangen möchten.Copy your Azure Application Insights Key to this field if you want to receive bot telemetry for this bot. Dieser Wert ist optional.This value is optional. Weitere Informationen zu diesem Feld finden Sie unter Application Insights-Schlüssel.For more details on this field, see Application Insights keys.
Application Insights-API-SchlüsselApplication Insights API key Eindeutiger Schlüssel für die Botanalyse.Unique key for bot analytics. Kopieren Sie Ihren Azure Application Insights-API-Schlüssel in dieses Feld, wenn Sie Analysen zu Ihrem Bot auf dem Dashboard anzeigen möchten.Copy your Azure Application Insights API Key to this field if you want to view analytics about your bot in the Dashboard. Dieser Wert ist optional.This value is optional. Weitere Informationen zu diesem Feld finden Sie unter Application Insights-Schlüssel.For more details on this field, see Application Insights keys.
Application Insights-Anwendungs-IDApplication Insights Application ID Eindeutige ID für bot analytics.Unique ID for bot analytics. Kopieren Sie Ihren Azure Application Insights-Anwendungsschlüssel in dieses Feld, wenn Sie Analysen zu Ihrem Bot auf dem Dashboard anzeigen möchten.Copy your Azure Insights Application ID Key to this field if you want to view analytics about your bot in the Dashboard. Dieser Wert ist optional.This value is optional. Weitere Informationen zu diesem Feld finden Sie unter Application Insights-Schlüssel.For more details on this field, see Application Insights keys.

Klicken Sie unten auf dem Blatt auf Übernehmen, um die Änderungen zu speichern.To save your changes, select Apply at the bottom of the blade.

Anwendungs-ID und KennwortApplication ID and password

Die Anwendungs-ID und das Kennwort der Azure Bot-Ressourcenanwendung werden den Variablen des Bots zugewiesen MicrosoftAppID und sind in Ihrer MicrosoftAppPassword Botprojektkonfigurationsdatei enthalten.The Azure Bot resource application ID and password are assigned to the bot's variables MicrosoftAppID and MicrosoftAppPassword contained in your bot project configuration file. Die Datei unterscheidet sich je nach Programmiersprache, die Sie zum Erstellen des Bots verwenden, wie in der folgenden Tabelle gezeigt.The file differs depending on the programming language you use to create the bot, as shown in the table below.

SpracheLanguage DateinameFile Name
C#C# appsettings.json
JavaJava application.properties
JavaScriptJavaScript .env
PythonPython config.py

Hinweis

Die Botressource verfügt über eine Anwendungs-ID, aber da ihr kein App Service zugeordnet ist, gibt es kein Kennwort.The bot resource has an application ID, but because there is no app service associated with it, there is no password. Führen Sie die Schritte im nächsten Abschnitt aus, um das Kennwort zu generieren.To generate the password follow the steps in the next section.

Registrierungskennwort abrufenGet registration password

Einer Azure Bot-Ressource sind eine Anwendungs-ID (App-ID) und ein Kennwort zugeordnet.An Azure Bot resource has an application ID (app ID) and a password associated with it. Der Azure Bot Service weist der Anwendung eine eindeutige Anwendungs-ID zu.The Azure Bot Service assigns a unique application ID to the application. Sie können das Kennwort mit den unten beschriebenen Schritten abrufen.You can obtain the password following the steps described below.

  1. Navigieren Sie in Ihrem Browser zum Azure-Portal.In your browser, navigate to the Azure portal.

  2. Klicken Sie in der Ressourcenliste auf den Namen der Registrierungsanwendung.In the resource list, click on the registration application name.

  3. Wechseln Sie im rechten Bereich zum Abschnitt BotVerwaltung, und klicken Sie auf Einstellungen.In the right panel go to the Bot Management section and click Settings. Die Seite Einstellungen der Registrierungsanwendung wird angezeigt.The registration application Settings page will display.

  4. Wählen Sie den Link Verwalten neben Microsoft-App-ID aus.Select the Manage link next to Microsoft App ID.

    Link zum Öffnen des Bereichs "Zertifikate und Geheimnisse"

  5. Klicken Sie im Bereich Zertifikate & auf die Schaltfläche Neuer geheimer Clientgeheimnis.In the Certificates & secrets pane, click the New client secret button.

    Geheimnisse der Botregistrierungs-App

  6. Fügen Sie die Beschreibung hinzu, wählen Sie die Ablaufzeit aus, und klicken Sie auf die Schaltfläche Hinzufügen.Add the description, select the expiration time, and click the Add button.

    Erstellen eines Kennworts für die Botregistrierung

    Dadurch wird ein neues Kennwort für Ihren Bot generiert.This will generate a new password for your bot. Kopieren Sie dieses Kennwort, und speichern Sie es in einer Datei.Copy this password and save it to a file. Dies ist die einzige Gelegenheit, bei der dieses Kennwort angezeigt wird.This is the only time you will see this password. Wenn Sie das Kennwort zu einem späteren Zeitpunkt benötigen und nicht vollständig gespeichert haben, müssen Sie den Vorgang zum Erstellen eines neuen Kennworts wiederholen.If you do not have the full password saved, you will need to repeat the process to create a new password should you need it later.

Zusätzliche InformationenAdditional Information

Sie können az bot update verwenden, um die Boteinstellungen über die Befehlszeile zu aktualisieren.You can use az bot update to update bot settings from the command line.