🚀 快速入門

這份指南將引導您快速設定您的首個代理程式專案。

想零設定？ 👉 在 Firebase Studio 試用 或在 Cloud Shell 試用

前置條件

Python 3.10+ | Google Cloud SDK 安裝指南 | Terraform 安裝指南 | uv (自動安裝) 手動安裝指南

1. 安裝入門套件

# 建立並啟用 Python 虛擬環境 (建議)
python -m venv .venv
source .venv/bin/activate  # 在 Windows 上: .venv\Scripts\activate

# 安裝套件
pip install agent-starter-pack

請參閱 安裝指南 以了解其他安裝方法。

2. 建立您的代理程式專案

執行 create 命令並依照提示操作：

agent-starter-pack create my-awesome-agent

此命令會：

• 讓您選擇代理程式範本 (例如：adk_base、agentic_rag)。
• 讓您選擇部署目標 (例如：cloud_run、agent_engine)。
• 產生完整的專案結構 (後端、選用前端、部署基礎設施)。

範例：

# 建立用於 Cloud Run 的 RAG 代理程式 (依照提示選擇選項)
agent-starter-pack create my-rag-agent

# 直接建立用於 Agent Engine 的基礎 ADK 代理程式
agent-starter-pack create my-adk-agent -a adk_base -d agent_engine

3. 探索並在本地執行

cd my-awesome-agent && make install && make playground

在您的新專案目錄 (my-awesome-agent) 中，您會找到：

• app/: 後端代理程式程式碼。
• deployment/: Terraform 基礎設施程式碼。
• tests/: 代理程式的單元和整合測試。
• notebooks/: 用於開始評估的 Jupyter notebooks。
• frontend/: (如適用) 用於與代理程式互動的網頁使用者介面。
• README.md：專案專屬的本地執行和部署說明。 ➡️ 依照您新專案的 README.md 中的說明，在本地執行。

後續步驟

您已準備就緒！請參閱 開發指南 以了解擴充、自訂及部署代理程式的詳細說明。

• 新增資料 (RAG)： 為知識型代理程式設定 資料擷取。
• 監控效能： 探索用於生產監控的 可觀測性 功能。
• 部署至正式環境： 依照 部署指南 將代理程式部署至 Google Cloud。