教學課程：第 1 部分 - 使用提示流程 SDK 建置自訂聊天應用程式的資源
在本教學課程中，您會使用提示流程 SDK (和其他程式庫) 來為名為 Contoso Trek 的零售公司建置、設定、評估及部署聊天應用程式。 您的零售公司專門銷售戶外露營裝備和服裝。 聊天應用程式應該會回答您的產品和服務相關問題。 例如，聊天應用程式可以回答諸如「哪種帳篷最防水？」或「哪種睡袋最適合寒冷天氣？」等問題。
本教學課程是三部分教學課程的第一部分。 第一部分會說明 Azure 訂用帳戶的系統管理員如何建立及設定教學課程系列第二部分和第三部分所需的資源。 第二部分和第三部分會說明開發人員如何使用資源。 在許多組織中，可能會由同一個人承擔這兩種角色。 在這第一個部分中，您會了解如何：
- 建立 Azure AI Studio 中樞
- 建立專案
- 建立 Azure AI 搜尋索引
- 設定 Azure AI Studio 和 Azure AI 搜尋服務資源的存取
如果您已完成其他教學課程或快速入門，您可能已經建立了本教學課程所需的一些資源。 如果您已經完成的話，即可放心地跳過這裡的這些步驟。
本教學課程是三部分教學課程的第一部分。
必要條件
- 具有有效訂用帳戶的 Azure 帳戶。 如果您沒有帳戶，可免費建立帳戶。
重要
您必須具備在 Azure 訂用帳戶中新增角色指派的必要權限。 只允許特定 Azure 資源的擁有者透過角色指派授與權限。 您可能需要要求 Azure 訂用帳戶擁有者 (可能是您的 IT 系統管理員) 為您完成本教學課程。
Azure AI Studio 和 Azure 入 口網站
在本教學課程中，您會使用 Azure 資源來建置聊天應用程式。 您會同時使用 Azure AI Studio 和 Azure 入口網站來建立和設定這些資源。
- 身為系統管理員，您可以使用 Azure 入口網站來設定對資源的存取權。
- 身為開發人員，您可以使用 Azure AI Studio 將建置、評估及部署聊天應用程式所需的資源組合在一起。 您也可以在 AI Studio 中與您的模型和部署互動。
建立 Azure AI Studio 中樞
若要在 Azure AI Studio 中建立中樞，請遵循下列步驟：
移至 Azure AI Studio 的首頁，並以您的 Azure 帳戶登入。
從左窗格中選取 [所有中樞]，然後選取 [+ 新增中樞]。
在 [建立新的中樞] 對話方塊中，輸入中樞的名稱 (例如 contoso-hub)，然後選取 [下一步]。 將預設的 [連線 Azure AI 服務] 選項保留為選取狀態。 系統會為中樞建立新的 AI 服務連線。
檢閱資訊並選取 [建立]。
您可以在精靈中檢視中樞建立的進度。
建立專案
若要在 Azure AI Studio 中建立專案，請遵循下列步驟：
- 移至 Azure AI Studio 的 [首頁] 頁面。
- 選取 [+ 新增專案]。
- 輸入專案名稱。
- 選取您在上一個步驟中建立的中樞。
建立專案之後，您可以在左側瀏覽窗格中存取遊樂場、工具及其他資產。
建立 Azure AI 搜尋索引
此應用程式的目標是讓模型以您的自訂資料作為基礎來做出回應。 搜尋索引可用來根據使用者的問題擷取相關文件。
您需要 Azure AI 搜尋服務和連線，才能建立搜尋索引。
注意
建立 Azure AI 搜尋服務和後續的搜尋索引會有相關成本。 您可以在建立頁面上查看有關 Azure AI 搜尋服務之定價和定價層的詳細資料，先確認成本再建立資源。
建立 Azure AI 搜尋服務
如果您已經有 Azure AI 搜尋服務，即可跳到下一節。
否則，您可以使用 Azure 入口網站建立 Azure AI 搜尋服務。
- 在入口網站中建立 Azure AI 搜尋服務。
- 選取您的資源群組和執行個體詳細資料。 您可以在此頁面查看定價和定價層的詳細資料。
- 繼續執行精靈，然後選取 [檢閱 + 指派] 以建立資源。
- 確認 Azure AI 搜尋服務的詳細資料，包括預估成本。
- 選取 [建立] 以建立 Azure AI 搜尋服務。
將 Azure AI 搜尋服務連結到您的專案
如果您的專案中已經有 Azure AI 搜尋服務連線，您可以跳到設定 Azure AI 搜尋服務的存取權。
在 Azure AI Studio 中，檢查 Azure AI 搜尋服務已連線的資源。
- 在 AI Studio 中，移至您的專案，然後從左窗格選取 [設定]。
- 在 [已連線的資源] 區段中，查看您是否有類型為 Azure AI 搜尋服務的連線。
- 如果您有 Azure AI 搜尋服務連線，即可往前跳到設定資源的存取權。
- 否則，請選取 [新增連線]，然後選取 [Azure AI 搜尋服務]。
- 在選項中尋找您的 Azure AI 搜尋服務，然後選取 [新增連線]。
- 繼續執行精靈以建立連線。 如需有關新增連線的詳細資訊，請參閱此操作指南 (部分機器翻譯)。
設定資源的存取權
本節會說明如何設定您在上一節中建立之資源所需的各種存取控制。
建議您使用 Microsoft Entra ID，而不是使用 API 密鑰。 若要使用此驗證，您需要設定正確的存取控制，並為服務指派正確的角色。
設定 Azure AI 服務的存取權
從專案開始尋找 AI 服務資源：
- 在 AI Studio 中，移至您的專案，然後從左窗格選取 [設定]。
- 選取 [已連線的資源]。
- 在已連線的資源清單中選取 [AI 服務] 或 [Azure OpenAI] 名稱，即可開啟 [資源詳細資料] 頁面。 然後在 [連線詳細資料] 頁面中再次選取資源名稱，這會在 Azure 入口網站中開啟資源。
在 Azure 入口網站中指定存取控制：
- 從 Azure 入口網站的左側頁面，選取 [存取控制 (IAM)] > [+ 新增] > [新增角色指派]。
- 搜尋 [認知服務 OpenAI 使用者] 角色，然後加以選取。 然後選取下一步。
- 選取 [使用者、群組或服務主體]。 然後，選取 [選取成員]。
- 在開啟的 [選取成員] 窗格中，搜尋您要新增角色指派的使用者名稱。 選取使用者，然後選取 [選取]。
- 繼續執行精靈，然後選取 [檢閱 + 指派] 以新增角色指派。
設定 Azure AI 搜尋服務的存取權
現在返回 AI Studio [設定] > [已連線的資源]。 這次在已連線的資源清單中選取 [Azure AI 搜尋服務] 名稱，即可開啟 [資源詳細資料] 頁面。 然後在 [連線詳細資料] 頁面中再次選取資源名稱，這會在 Azure 入口網站中開啟資源。
若要為 Azure AI 搜尋服務啟用角色型存取控制，請遵循下列步驟：
在 Azure 入口網站的 Azure AI 搜尋服務上，從左窗格中選取 [設定] > [金鑰]。
選取 [兩者] 以確保 Azure AI 搜尋服務會同時啟用 API 金鑰和角色型存取控制。
警告
您可以在本機使用角色型存取控制，因為您稍後會在本教學課程系列中執行 az login。 但是當您在本教學課程的第 3 部分中部署應用程式時，部署會使用來自 Azure AI 搜尋服務的 API 金鑰進行驗證。 我們即將推出部署的 Microsoft Entra ID 驗證支援。 現在，您需要同時啟用金鑰和端點。
接下來，向使用者身分識別 (或將完成第二部分和第三部分的開發人員身分識別) 授與 Azure AI 搜尋服務的 [搜尋索引資料參與者] 和 [搜尋服務參與者] 角色。 這些角色可讓您將 Azure AI 搜尋服務稱為相關聯的使用者身分識別。
仍在 Azure AI 搜尋服務的 Azure 入口網站中，將 [搜尋索引資料參與者] 角色指派給 Azure AI 搜尋服務。 (下列步驟和您先前對 Azure OpenAI 服務執行的步驟相同。)
- 從 Azure 入口網站的左側頁面，選取 [存取控制 (IAM)] > [+ 新增] > [新增角色指派]。
- 搜尋「搜尋索引資料參與者」角色，然後加以選取。 然後選取下一步。
- 選取 [使用者、群組或服務主體]。 然後，選取 [選取成員]。
- 在開啟的 [選取成員] 窗格中，搜尋您要新增角色指派的使用者名稱。 選取使用者，然後選取 [選取]。
- 繼續執行精靈，然後選取 [檢閱 + 指派] 以新增角色指派。
重複這些步驟，即可將 [搜尋服務參與者] 角色也新增至 Azure AI 搜尋服務。
您現在已準備好將專案交給開發人員來建置聊天應用程式。 開發人員會使用提示流程 SDK 來為名為 Contoso Trek 的零售公司建置、設定、評估及部署聊天應用程式。
清除資源
為了避免產生不必要的 Azure 費用，如果您不再需要在本教學課程中建立的資源，則應加以刪除。 若要管理資源，您可以使用 Azure 入口網站。
但是，如果您要在本教學課程系列的下一個部分建置聊天應用程式，則請勿將其刪除。