使用 Google Antigravity 建構

1. 簡介

Google Antigravity (以下簡稱 Antigravity) 是 Google 的代理式 IDE。在「開始使用 Antigravity 程式碼研究室」中，您可以瞭解 Antigravity 的基本概念。在本程式碼研究室中，我們將使用 Antigravity 建構實際應用程式。我們將從簡單的網路研究，進展到產生完整堆疊應用程式和企業級單元測試。

需求條件：

已安裝及設定 Google Antigravity。
對 Google Antigravity 有基本瞭解。建議先完成「開始使用 Google Antigravity」程式碼實驗室。

2. 關於應用實例

您已對 Antigravity 有基本瞭解，現在來看看幾個使用案例，瞭解 AI 的運作方式。請注意，Antigravity 是以代理程式為優先的平台。也就是說，在大多數情況下，我們只是向 Agent 發出指令，然後 Agent 就會自行完成工作、視需要要求權限、產生構件，並在工作完成時通知我們。因此，我們無法在下列每個用途中，產生 Agent 對話的每個輸出內容。我們會分享操作說明和預期結果的幾張必要螢幕截圖，但您的結果可能略有不同。

我們將介紹的用途包括：自動執行外部網站的幾項工作、為專案產生及驗證單元測試案例，以及完整網站開發。開始導航

3. 新聞重點

這是簡單的用途，但您可以此為基礎，使用網頁瀏覽器造訪網站、擷取資訊、執行一些動作，然後將資料傳回給使用者。

在本例中，我們將前往 Google 新聞網站，並從中擷取一些資訊。但您可以輕鬆選擇網站進行實驗，並查看結果。

確認您位於 Agent Manager 中，並已選取 Playground，如下所示：

然後下達下列指令：

這會啟動 Agent 程序，並判斷是否需要啟動瀏覽器等。請密切注意「思考」程序，瞭解 Agent 的工作方式。如果一切順利，應該會啟動 Antigravity 瀏覽器並造訪網站，如下所示。網站周圍的藍色邊框表示 Agent 現在正在控制瀏覽器，並瀏覽網站以取得資訊。

完成工作後，您應該也會看到產生的構件，如下所示：

以下是 Agent 的執行範例：

請注意，左側是「思考過程」，您也可以捲動瀏覽各個重點，並查看播放內容和其他資料。

體驗功能

瞭解這點後，請選擇可用的網站，並讓 Agent 前往該網站取得/摘要一些資料。請考慮您知道有資訊主頁和圖表的網站，並要求選取幾個值。
請嘗試使用下列提示詞：Visit https://docs.cloud.google.com/release-notes and get me a summary of the release notes, categorized by product.

4. 使用 Python + Flask 生成動態網站

現在來產生完整的網頁應用程式。我們要建立的網頁應用程式是一個網站，提供為期一天的技術活動資訊，當天會有許多講者進行演講。

再次確認您位於 Agent Manager，並已選取 Playground。

輸入下列提示詞：

I would like to generate a website that is a 1-day technical conference informational site.

The website should have the following functionality:
        1. A home page that shows the current date, location, schedule and time table.
        2. The 1-day event is a list of 8 talks in total.
        3. Each talk has 1 or 2 max. speakers. 
        4. A talk has an ID, Title, Speakers, Category (1 or 2), Description and time of the talk.
        5. Each speaker has a First Name, Last Name and LinkedIn url.
        6. Allow for users to search by category, speaker, title.
        7. Give a lunch break of 60 minutes.
        8. Use dummy data for events and speakers, come up with a schedule, the event is about Google Cloud Technologies.
        9. Tech Stack: Python and Flask framework on server side. Front-end is basic HTML, CSS and JavaScript. 
        10. Test out the site on your own for all functionality and provide a detailed README on how to setup, run and make any further changes. 
11. Launch the web application for me to review.

你可以使用上述提示詞開始對話：

代理程式執行工作時，會繼續建立構件：

工作構件
實作構件
逐步操作構件

以下是 Agent 根據收到的工作，解讀出應執行的初始工作序列。執行作業的螢幕截圖範例如下：

然後點選「實作計畫」構件。螢幕截圖範例如下所示：

最後是「Walkthrough」構件。其中包含 Agent 執行的所有動作，如下所示：

請注意，伺服器已啟動並提供網址，點選該網址後即可存取應用程式，範例螢幕截圖如下所示：

如果切換至「編輯器」，您會發現畫面中包含產生 Python Flask 應用程式的資料夾。你也會發現右側標示了 Agent mode，你也可以在該處繼續對話。

現在，假設我們想在活動中新增更多演講。我們可以留在編輯器和代理程式面板中，提供類似 Add two more talks to the schedule 的指令。

這會導致 Agent 分析需求、更新工作、實作計畫，然後驗證更新的功能。以下是範例對話：

如有需要，可以切換回代理程式管理員。這個程序可協助您瞭解從代理商管理員轉移至編輯者、相應進行變更等程序。

體驗功能

在應用程式中新增其他功能。向代理提供詳細資料，並注意代理如何執行工作，例如先修改工作清單，然後修改實作計畫等。
要求 Agent 為應用程式產生 README 或更多說明文件。

5. 生成簡單的生產力應用程式

我們現在要產生簡單的 Pomodoro 計時器網頁應用程式。

確認您位於 Agent Manager，並已選取 Playground。輸入下列提示詞：

Create a productivity app that features a Pomodoro timer. Give a calm and aesthetic look to the application.

請注意，這項功能會先建立工作清單和實作計畫，然後再執行。請持續留意流程，系統可能會提示您進行審查。以下是執行範例。

在這種情況下，它也應該啟動 Antigravity 瀏覽器，自行進行測試，然後確認測試成功。其中一項生成的內容是媒體構件，內含驗證影片。這是查看測試內容的絕佳方式。我也建議進行一些樣式變更，因為這些變更並未生效，但系統能夠執行。

最終應用程式如下所示，看起來相當不錯。

我們可以在應用程式中加入好看的計時器圖片。我們只需要發出後續指示，如下所示：

Add an image to the application that displays a timer.

因此，代理程式會在「工作」構件中新增工作：

然後在執行工作時生成圖片：

最後，應用程式會顯示我們要求的圖片：

體驗功能

請注意，應用程式中沙漏圖示的背景並非透明。請代理程式將背景設為透明。
嘗試生成幾個應用程式變化版本。嘗試不同風格、圖片，要求變更等等。

6. 生成單元測試、模擬存根及驗證測試

我們將在此嘗試的最後一個用途，是為特定程式碼檔案生成單元測試，並讓 Agent 執行及驗證測試。

為此，我們將建立一個工作區，其中包含單一 Python 檔案，如下所示：

from typing import Dict

# --- Custom Exceptions ---
class InventoryShortageError(Exception):
    """Raised when there is not enough item stock."""
    pass

class PaymentFailedError(Exception):
    """Raised when the payment gateway rejects the transaction."""
    pass

class InvalidOrderError(Exception):
    """Raised when the order violates business rules."""
    pass

# --- External Service Interfaces (To be Mocked) ---
class InventoryService:
    def get_stock(self, product_id: str) -> int:
        """Connects to DB to check stock."""
        raise NotImplementedError("Real connection required")

    def decrement_stock(self, product_id: str, quantity: int):
        """Connects to DB to reduce stock."""
        raise NotImplementedError("Real connection required")

class PaymentGateway:
    def charge(self, amount: float, currency: str) -> bool:
        """Connects to Stripe/PayPal."""
        raise NotImplementedError("Real connection required")

# --- Main Business Logic ---
class Order:
    def __init__(self, 
                 inventory_service: InventoryService, 
                 payment_gateway: PaymentGateway,
                 customer_email: str,
                 is_vip: bool = False):
        
        self.inventory = inventory_service
        self.payment = payment_gateway
        self.customer_email = customer_email
        self.is_vip = is_vip
        self.items: Dict[str, Dict] = {} # {product_id: {'price': float, 'qty': int}}
        self.is_paid = False
        self.status = "DRAFT"

    def add_item(self, product_id: str, price: float, quantity: int = 1):
        """Adds items to the cart. Rejects invalid prices or quantities."""
        if price < 0:
            raise ValueError("Price cannot be negative")
        if quantity <= 0:
            raise ValueError("Quantity must be greater than zero")

        if product_id in self.items:
            self.items[product_id]['qty'] += quantity
        else:
            self.items[product_id] = {'price': price, 'qty': quantity}

    def remove_item(self, product_id: str):
        """Removes an item entirely from the cart."""
        if product_id in self.items:
            del self.items[product_id]

    @property
    def total_price(self) -> float:
        """Calculates raw total before discounts."""
        return sum(item['price'] * item['qty'] for item in self.items.values())

    def apply_discount(self) -> float:
        """
        Applies business logic:
        1. VIPs get flat 20% off.
        2. Regulars get 10% off if total > 100.
        3. No discount otherwise.
        """
        total = self.total_price
        
        if self.is_vip:
            return round(total * 0.8, 2)
        elif total > 100:
            return round(total * 0.9, 2)
        
        return round(total, 2)

    def checkout(self):
        """
        Orchestrates the checkout process:
        1. Validates cart is not empty.
        2. Checks stock for all items.
        3. Calculates final price.
        4. Charges payment.
        5. Updates inventory.
        """
        if not self.items:
            raise InvalidOrderError("Cannot checkout an empty cart")

        # 1. Check Inventory Logic
        for product_id, data in self.items.items():
            available_stock = self.inventory.get_stock(product_id)
            if available_stock < data['qty']:
                raise InventoryShortageError(f"Not enough stock for {product_id}")

        # 2. Calculate Final Price
        final_amount = self.apply_discount()

        # 3. Process Payment
        try:
            success = self.payment.charge(final_amount, "USD")
            if not success:
                raise PaymentFailedError("Transaction declined by gateway")
        except Exception as e:
            # Catching generic network errors from the gateway
            raise PaymentFailedError(f"Payment gateway error: {str(e)}")

        # 4. Decrement Stock (Only occurs if payment succeeded)
        for product_id, data in self.items.items():
            self.inventory.decrement_stock(product_id, data['qty'])

        self.is_paid = True
        self.status = "COMPLETED"
        
        return {"status": "success", "charged_amount": final_amount}