設定 Bot 註冊設定
適用於： SDK v4
您可以在 [Bot 配置檔] 窗格中檢視和修改 Azure Bot 資源設定，例如顯示名稱、圖示和描述。 您可以在 [組態] 窗格中檢視和修改 Azure Bot 資源設定，例如傳訊端點、Microsoft 應用程式識別碼和 Application Insights。
Bot 設定檔
以下是 Bot 設定檔欄位的清單：
| 欄位 | 描述 |
|---|---|
| Icon | 自定義圖示，以可視化方式識別頻道中的 Bot，以及 Microsoft Teams 或其他服務中 Bot 的圖示。 |
| Display name | 通道和目錄中 Bot 的名稱。 您稍後可以變更此值。 |
| Bot 控制代碼 | Bot 的唯一標識碼。 使用 Bot 服務建立 Bot 之後，就無法變更此值。 |
| 描述 | Bot 的描述。 某些通道會顯示描述。 您稍後可以變更此值。 |
若要儲存變更，請選取 刀鋒視窗底部的 [套用 ]。
組態
以下是 [組態] 欄位的清單：
| 欄位 | 描述 |
|---|---|
| 訊息中心端點 | 與 Bot 通訊的端點。 |
| Microsoft 應用程式識別碼 | Bot 的唯一標識碼。 此值無法變更。 您可以按下 [ 管理 ] 連結來產生新的密碼。 |
| 架構轉換版本 | 要用於此 Bot 的 Bot 架構轉換版本。 如需詳細資訊，請參閱將 Bot 連線 至通道。 |
| Application Insights 檢測密鑰 | Bot 遙測的唯一密鑰。 如果您想要接收此 Bot 的 Bot 遙測，請將您的 Azure 應用程式 Insights 金鑰複製到此欄位。 此為選用值。 如需此欄位的詳細資訊，請參閱 Application Insights 金鑰。 |
| Application Insights API 金鑰 | Bot 分析的唯一金鑰。 如果您想要在儀錶板中檢視 Bot 的相關分析，請將您的 Azure 應用程式 Insights API 金鑰複製到此字段。 此為選用值。 如需此欄位的詳細資訊，請參閱 Application Insights 金鑰。 |
| Application Insights 應用程式識別碼 | Bot 分析的唯一標識碼。 如果您想要在儀錶板中檢視 Bot 的相關分析，請將 Azure Insights 應用程式識別碼密鑰複製到此字段。 此為選用值。 如需此欄位的詳細資訊，請參閱 Application Insights 金鑰。 |
若要儲存變更，請選取 刀鋒視窗底部的 [套用 ]。
Bot 身分識別資訊
請遵循下列步驟，將身分識別資訊新增至 Bot 的組態檔。 檔案會根據您用來建立 Bot 的程式設計語言而有所不同。
重要
Bot Framework SDK 的 Java 版本僅支援多租使用者 Bot。 Bot Framework SDK 的 Python 版本支援多租使用者和單一租使用者 Bot。 C# 和 JavaScript 版本支援這三種應用程式類型來管理 Bot 的身分識別。
| 語言 | 檔案名稱 | 備註 |
|---|---|---|
| C# | appsettings.json | 支援這三種應用程式類型來管理 Bot 的身分識別。 |
| JavaScript | .env | 支援這三種應用程式類型來管理 Bot 的身分識別。 |
| Java | application.properties | 僅支援多租使用者 Bot。 |
| Python | config.py | 支援多租使用者和單一租使用者 Bot。 提供屬性做為方法呼叫的 os.environ.get 自變數。 |
您需要新增的身分識別資訊取決於 Bot 的應用程式類型。 在您的組態檔中提供下列值。
僅適用於 C# 和 JavaScript Bot。
| 屬性 | 值 |
|---|---|
MicrosoftAppType |
UserAssignedMSI |
MicrosoftAppId |
使用者指派受控識別的用戶端標識碼。 |
MicrosoftAppPassword |
不適用。 針對使用者指派的受控識別 Bot，將此保留空白。 |
MicrosoftAppTenantId |
使用者指派受控識別的租用戶標識碼。 |
其他資訊
您可以使用 az bot update ，從命令行更新 Bot 設定。