Skip to content

設定開發環境

兩條路徑都會使用

不論你是自己部署 Azure 環境，還是使用別人已經部署好的環境 這一頁都會幫你完成本機端的開發環境和 .env 設定

Python 環境

如果你使用 Dev Container 或 Codespaces

這份 workshop 的 Dev Container 會在建立環境時自動安裝根目錄 requirements.txt 如果你是用 Dev Container 或 Codespaces 開啟專案，通常可以直接跳過下面的安裝步驟 只有在你是本機 Python 環境、或想重新安裝相依套件時，才需要手動執行

統一使用專案根目錄 .venv

本 repo 的 Python 環境統一放在專案根目錄 .venv 下列指令也都預設從專案根目錄執行

建立並啟用

python -m venv .venv

.venv\Scripts\activate

source .venv/bin/activate

安裝相依套件

pip install -r requirements.txt

驗證設定

python -c "import azure.ai.projects; print('Ready!')"

附錄資料設定

只有在你要執行附錄中的資料整合內容時，才需要做這一段。

建議先完成 Foundry 主線；如果目前只是要把 workshop 跑通，可以先跳過這裡，之後再回到 附錄延伸。

更新環境檔案

將 .env.example 複製為 .env：

cp .env.example .env

編輯專案根目錄的 .env：

# --- Active Scenario (preferred) ---
SCENARIO_KEY=default

# --- Data Folder (backward-compatible fallback) ---
DATA_FOLDER=data/default

如果你是第一次跑 workshop，建議先填 SCENARIO_KEY。附錄資料工作區相關設定，等你真的要跑附錄內容時再補即可。

跳過 Browser Automation 部署

.env 不控制 azd up 是否建立 Playwright Workspace。 如果你想在這次部署先跳過 Browser Automation，請在執行 azd up 前先跑：

azd env set AZURE_DEPLOY_BROWSER_AUTOMATION false

之後若要重新啟用，再改成 true 並重新部署即可。

AI 資料產生設定要不要先改？

第一次跑 workshop 時，這一段可以先不要改。

  • 先保留 .env.example 的預設值即可
  • 如果你之後要自訂產業與 use case，統一到 產生自訂資料 操作
  • DATA_SIZE 沒填時，預設會用 small

Azure 服務變數不需要手動抄寫

透過 azd up 建立的 Azure 服務變數，會自動從 .azure/<env>/.env 載入

PII demo 不再需要額外 Language key

12_demo_pii_redaction.py 直接用 AZURE_AI_ENDPOINT 和 DefaultAzureCredential 即可

Browser Automation 的手動交接

azd up 會用 best-effort 方式嘗試建立 Playwright Workspace；如果碰到 subscription quota 上限，主流程仍會完成。 Browser Automation 還需要你手動建立 Foundry connection。 等你真的要測 10_demo_browser_automation.py 時，再看 Browser Automation 補充設定 即可。

共用環境交接

如果這套環境是別人先幫你部署好的，請先拿到主線必要設定；附錄資料工作區設定可等你要做附錄資料路徑時再補。

檢查點

繼續之前，請確認：

  • azd up 已成功完成
  • Python 環境已啟用
  • 相依套件已安裝
  • 附錄資料工作區設定已備妥（只有要做附錄資料路徑時才需要）

準備就緒

請繼續至下一步實際看到成果

← 部署 Azure 資源 | 參與者執行與驗證 →