共用方式為


組織數據:建立 Microsoft Entra ID 應用程式註冊

將組織資料(電子郵件、檔案、聊天和行事曆事件)直接整合到您的自定義應用程式中,以提高用戶生產力。 藉由使用 Microsoft Graph API 和 Microsoft Entra ID,您可以順暢地擷取及顯示應用程式內的相關數據,減少使用者切換內容的需求。 無論是參考傳送給客戶的電子郵件、檢閱 Teams 訊息或存取檔案,使用者都可以快速找到所需的資訊,而不需要離開您的應用程式、簡化其決策程式。

在本練習中,您將會:

  • 建立Microsoft Entra ID 應用程式註冊,讓 Microsoft Graph 可以存取組織數據,並將其帶入應用程式。
  • 從 Microsoft Teams 中找出 teamchannel 標識碼,這些 Teams 需要將聊天訊息傳送至特定頻道。
  • 使用您Microsoft Entra ID 應用程式註冊的值更新專案的 .env 檔案。

Microsoft雲端案例概觀

建立Microsoft項目標識碼應用程式註冊

  1. 移至 Azure 入口網站 ,然後選取 [Microsoft Entra ID]。

  2. 選取 [管理 ] -->[應用程式註冊 ],然後選取 [+ 新增註冊]。

  3. 填寫新的應用程式註冊窗體詳細數據,如下所示,然後選取 [註冊]:

    • 名稱: microsoft-graph-app
    • 支援的帳戶類型: 任何組織目錄中的帳戶(任何Microsoft專案標識符租使用者 - 多租使用者)
    • 重新導向 URI:
      • 選取[單頁應用程式][SPA],然後在 [http://localhost:4200 字段中輸入
    • 選取 [註冊] 以建立應用程式註冊。

    Microsoft Entra ID 應用程式註冊表單

  1. 在資源功能表中選取 [ 概觀 ], Application (client) ID 並將值複製到剪貼簿。

    Microsoft Entra ID 應用程式用戶端識別碼

更新專案的 .env 檔案

  1. 在編輯器開啟 .env 檔案,並將值指派 Application (client) IDENTRAID_CLIENT_ID

    ENTRAID_CLIENT_ID=<APPLICATION_CLIENT_ID_VALUE>
    
  2. 如果您想要啟用將訊息從應用程式傳送至 Teams 頻道的能力,請使用您的 Microsoft 365 開發租使用者帳戶登入 Microsoft Teams (本教學課程的前置條件中提及)。

  3. 登入之後,請展開小組,並尋找您想要從應用程式傳送訊息的頻道。 例如,您可以選取 [公司 團隊] 和 [ 一般 ] 頻道(或您想要使用的任何小組/頻道)。

    取得 Teams 頻道的連結

  4. 在小組標頭中,按兩下三個點(...),然後選取 [取得小組的連結]。

  5. 在彈出視窗中顯示的連結中,小組標識碼是 之後 team/的字母和數位字串。 例如,在連結 “https://teams.microsoft.com/l/team/19%3ae9b9.../", 團隊標識符是 19%3ae9b9... 最多到下列 / 字元。

  6. 複製小組標識碼,並將它指派給 TEAM_ID.env 檔案。

  7. 在通道標頭中,按兩下三個點(...),然後選取 [ 取得通道的連結]。

  8. 在彈出視窗中顯示的連結中,通道標識碼是 後面 channel/字母和數位的字串。 例如,在連結 “https://teams.microsoft.com/l/channel/19%3aQK02.../", 信道標識符為 19%3aQK02... 最多到下列 / 字元。

  9. 複製通道標識碼,並將它指派給 CHANNEL_ID.env 檔案中。

  10. 繼續之前,請先儲存 env 檔案。

啟動/重新啟動應用程式和 API 伺服器

根據您完成的練習,執行下列 其中一 個步驟:

  • 如果您在先前的練習中啟動資料庫、API 伺服器和網頁伺服器,您必須停止 API 伺服器和 Web 伺服器,然後重新啟動它們以挑選 .env 檔案變更。 您可以讓資料庫保持執行狀態。

    找出執行 API 伺服器和網頁伺服器的終端機視窗,然後按 CTRL + C 以停止它們。 在每一個終端機視窗中輸入 npm start ,然後按 Enter 鍵,再次啟動它們。 繼續進行下一個練習。

  • 如果您尚未啟動資料庫、API 伺服器和網頁伺服器,請完成下列步驟:

    1. 在下列步驟中,您將在 Visual Studio Code 中建立三個終端機視窗。

      Visual Studio Code 中的三個終端機視窗

    2. 以滑鼠右鍵按兩下 Visual Studio Code 檔案清單中的 .env 檔案,然後選取 [ 在整合式終端機中開啟]。 在繼續之前,請確定您的終端機位於專案的根目錄 - openai-acs-msgraph

    3. 從下列 其中一個選項 中選擇,以啟動 PostgreSQL 資料庫:

      • 如果您已安裝並執行 Docker Desktop ,請在終端機視窗中執行 docker-compose up ,然後按 Enter

      • 如果您已安裝 Podman-compose 並執行 Podman, 請在終端機視窗中執行 podman-compose up ,然後按 Enter

      • 若要使用 Docker Desktop、Podman、nerdctl 或您已安裝的另一個容器運行時間直接執行 PostgreSQL 容器,請在終端機視窗中執行下列命令:

        • Mac、Linux 或 Windows 子系統 Linux 版 (WSL):

          [docker | podman | nerdctl] run --name postgresDb -e POSTGRES_USER=web -e POSTGRES_PASSWORD=web-password -e POSTGRES_DB=CustomersDB -v $(pwd)/data:/var/lib/postgresql/data -p 5432:5432 postgres
          
        • 使用 PowerShell 的 Windows:

          [docker | podman] run --name postgresDb -e POSTGRES_USER=web -e POSTGRES_PASSWORD=web-password -e POSTGRES_DB=CustomersDB -v ${PWD}/data:/var/lib/postgresql/data -p 5432:5432 postgres
          
    4. 資料庫容器啟動時,請按 + Visual Studio Code 終端機工具列 中的圖示來建立第二個終端機視窗。

      終端機工具列中的 Visual Studio Code + 圖示。

    5. cd 進入 伺服器/typescript 資料夾,然後執行下列命令來安裝相依性並啟動 API 伺服器。

      • npm install
      • npm start
    6. 在 Visual Studio Code +中再次按圖示,以建立第三個終端機視窗。

    7. cd 進入 客戶端 資料夾,然後執行下列命令來安裝相依性並啟動網頁伺服器。

      • npm install
      • npm start
    8. 瀏覽器將會啟動,而且系統會帶您前往 http://localhost:4200

      已啟用 Azure OpenAI 的應用程式螢幕快照

後續步驟