本教學課程中使用的程式碼項目位於 https://github.com/microsoft/MicrosoftCloud。 專案的存放庫包含執行專案所需的用戶端和伺服器端程序代碼,可讓您探索與人工智慧(AI)、通訊和組織數據相關的整合功能。 此外,專案可作為資源,引導您將類似的功能併入您自己的應用程式。
在此練習中,您將會:
- 複製 GitHub 存放庫。
- 將 .env 檔案新增至專案並加以更新。
繼續之前,請確定您已安裝並設定所有必要條件,如本教學課程的必要 條件 一節中所述。
複製 GitHub 存放庫並建立 .env
檔案
執行下列命令,將 Microsoft Cloud GitHub 存放庫 複製到您的電腦。
git clone https://github.com/microsoft/MicrosoftCloud
在 Visual Studio Code 中開啟 MicrosoftCloud/samples/openai-acs-msgraph 資料夾。
備註
雖然我們將在本教學課程中使用 Visual Studio Code,但任何程式代碼編輯器都可以用來處理範例專案。
請注意下列資料夾與檔案:
- client:用戶端應用程式程序代碼。
- 伺服器:伺服器端 API 程式代碼。
- docker-compose.yml:用來執行本機 PostgreSQL 資料庫。
將專案根目錄中的 .env.example 重新命名為 .env。
開啟 .env 檔案,並花點時間查看包含的金鑰:
ENTRAID_CLIENT_ID= TEAM_ID= CHANNEL_ID= OPENAI_API_KEY= OPENAI_ENDPOINT= OPENAI_MODEL=gpt-4o OPENAI_API_VERSION=2024-05-01-preview POSTGRES_USER= POSTGRES_PASSWORD= ACS_CONNECTION_STRING= ACS_PHONE_NUMBER= ACS_EMAIL_ADDRESS= CUSTOMER_EMAIL_ADDRESS= CUSTOMER_PHONE_NUMBER= API_PORT=3000 AZURE_AI_SEARCH_ENDPOINT= AZURE_AI_SEARCH_KEY= AZURE_AI_SEARCH_INDEX=
更新 .env 中的下列值。 API 伺服器會使用這些值來連線到本機 PostgreSQL 資料庫。
POSTGRES_USER=web POSTGRES_PASSWORD=web-password
現在您已準備好專案,讓我們試用一些應用程式功能,並瞭解其建置方式。 選取下方的 [ 下一步] 按鈕,以繼續使用或跳至使用目錄的特定練習。