Konfigurieren von Bot-Registrierungseinstellungen
GILT FÜR: SDK v4
Die Azure Bot-Ressourceneinstellungen, z. B. Anzeigename, Symbol und Beschreibung, können im Bot-Profilbereich angezeigt und geändert werden. Die Azure Bot-Ressourceneinstellungen wie Messaging-Endpunkt, Microsoft-App-ID und Application Insights können im Konfigurationsbereich angezeigt und geändert werden.
Botprofil
Nachfolgend finden Sie die Liste der Bot-Profilfelder :
| Feld | Beschreibung |
|---|---|
| Symbol | Ein individuelles Symbol, das Ihren Bot in Kanälen und in Microsoft Teams oder anderen Diensten identifiziert. |
| Anzeigename | Der Name Ihres Bots in Kanälen und Verzeichnissen. Sie können diesen Wert später ändern. |
| Bothandle | Eindeutiger Bezeichner für den Bot. Dieser Wert kann nach dem Erstellen des Bots mit dem Botdienst nicht geändert werden. |
| Beschreibung | Eine Beschreibung Ihres Bots. Einige Kanäle zeigen die Beschreibung an. Sie können diesen Wert später ändern. |
Wählen Sie unten auf dem Blatt Anwenden, um die Änderungen zu speichern.
Konfiguration
Nachfolgend finden Sie die Liste der Konfigurationsfelder:
| Feld | Beschreibung |
|---|---|
| Endpunkt Messaging | Der Endpunkt für die Kommunikation mit Ihrem Bot. |
| Microsoft-App-ID | Eindeutiger Bezeichner für den Bot. Dieser Wert kann nicht geändert werden. Sie können ein neues Kennwort generieren, indem Sie auf den Link Verwalten klicken. |
| Schema-Transformationsversion | Die Bot-Schematransformationsversion, die für diesen Bot verwendet werden soll. Mehr Informationen: Verbinden Sie einen Bot mit Kanälen. |
| Application Insights-Instrumentierungsschlüssel | Eindeutiger Schlüssel für Bot-Telemetriedaten. Kopieren Sie Ihren Azure Application Insights-Schlüssel in dieses Feld, wenn Sie Telemetriedaten für diesen Bot empfangen möchten. Dieser Wert ist optional. Weitere Informationen zu diesem Feld finden Sie unter Application Insights-Schlüssel. |
| Application Insights-API-Schlüssel | Eindeutiger Schlüssel für die Botanalyse. Kopieren Sie Ihren Azure Application Insights-API-Schlüssel in dieses Feld, wenn Sie Analysen zu Ihrem Bot auf dem Dashboard anzeigen möchten. Dieser Wert ist optional. Weitere Informationen zu diesem Feld finden Sie unter Application Insights-Schlüssel. |
| Application Insights-Anwendungs-ID | Eindeutige ID für die Bot-Analyse. Kopieren Sie Ihren Azure Application Insights-Anwendungsschlüssel in dieses Feld, wenn Sie Analysen zu Ihrem Bot auf dem Dashboard anzeigen möchten. Dieser Wert ist optional. Weitere Informationen zu diesem Feld finden Sie unter Application Insights-Schlüssel. |
Wählen Sie unten auf dem Blatt Anwenden, um die Änderungen zu speichern.
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. |
Zusätzliche Informationen
Sie können az bot update verwenden, um die Boteinstellungen über die Befehlszeile zu aktualisieren.