大家好！歡迎回到我們「Build on Google AI」的 30 天工程挑戰。在前兩天，我們確立了架構與雲端部署的戰略。但在籌備 GDG Taipei 的技術工作坊時，我發現開發者最常卡關的往往不是 AI 模型本身，而是第一天的「環境建置」。為了落實真正的「研發與工程創新」，讓代理人 (Agent) 系統能在真實場景中穩定運作並具備可維護性，建立乾淨的開發環境與嚴謹的版本控制是不可或缺的基本功。

今天，我們將以 AI 領域中最主流的 Python 作為開發主力，帶大家一步步建立 Google ADK 專案，並設定好 GitHub 的版控與資安防線！

第一步：打造乾淨的 Python 隔離環境
在開始安裝任何套件之前，強烈建議建立並啟用 Python 的虛擬環境 (Virtual Environment)，以免不同專案間的套件版本互相衝突。請確認你的工作環境已經安裝了 Python 3.10 或更新的版本，以及用於安裝套件的 pip 工具。
打開終端機，執行以下指令來建立虛擬環境：

python3 -m venv .venv

接著，依據你的作業系統啟動虛擬環境：

• MacOS / Linux: 執行 source .venv/bin/activate 指令。
• Windows CMD: 執行 .venv\Scripts\activate.bat 指令。
• Windows PowerShell: 執行 .venv\Scripts\Activate.ps1 指令。

第二步：安裝 ADK 並一鍵初始化專案
環境準備好後，我們就可以正式引入 Google 官方的代理人開發利器。

• 列點1安裝核心套件
  透過 pip 安裝 ADK 核心套件：

pip install google-adk

2. 使用 CLI 建立專案
   ADK 提供了非常方便的命令列工具，只要執行以下指令，就能啟動一個全新的代理人專案：

adk create my_agent

3. 探索專案結構
   執行上述指令後，你會看到系統自動建立了 my_agent/ 資料夾，裡面包含了開發代理人所需的核心檔案：

• agent.py：這支檔案包含了代理人的主要控制程式碼。
• .env：用來存放 API 金鑰或專案 ID 的設定檔。
• init.py：將資料夾標記為標準模組的初始化檔案。

第三步：建立 GitHub 版控與守護資安底線
有了專案原始碼後，我們必須將它推送到 GitHub 進行版本控制。但在執行 git init 與 git commit 之前，有件攸關生死的資安防護必須先設定！

官方文件嚴正警告：使用者憑證、服務帳戶憑證與 API 金鑰屬於高度敏感資訊，絕對不可以將憑證檔案或金鑰直接提交 (commit) 到你的程式碼庫中。

為了避免將 .env 檔案與龐大的 .venv 虛擬環境誤推送到 GitHub，請務必在專案根目錄建立一個 .gitignore 檔案，並加入以下內容：

# Environments
.venv/
env/
venv/
__pycache__/

# Security & Credentials
.env
*.json

確認 .env 被正確忽略後，你就可以安心地執行 git add . 與 git commit -m "chore: init ADK project"，為我們的自動化戰情室立下第一個穩固的里程碑。

小結
今天我們以最標準的工程規範，完成了 Python 虛擬環境建置、ADK 專案初始化，並設立了 GitHub 的資安防線。這正是「研發與工程創新」精神的體現——不只要讓程式能動，還要讓它安全、可維護！