গুগল অ্যান্টিগ্র্যাভিটি দিয়ে নির্মাণ

1. ভূমিকা

গুগল অ্যান্টিগ্র্যাভিটি (ডকুমেন্টের বাকি অংশে অ্যান্টিগ্র্যাভিটি নামে পরিচিত) হল গুগলের একটি এজেন্টিক আইডিই। অ্যান্টিগ্র্যাভিটি কোডল্যাব দিয়ে শুরু করার মাধ্যমে, আপনি অ্যান্টিগ্র্যাভিটির মূল বিষয়গুলি শিখতে পারবেন। এই কোডল্যাবে, আমরা বাস্তব অ্যাপ্লিকেশন তৈরি করতে অ্যান্টিগ্র্যাভিটি ব্যবহার করব। আমরা সাধারণ ওয়েব গবেষণা থেকে ফুল-স্ট্যাক অ্যাপ্লিকেশন এবং এন্টারপ্রাইজ-গ্রেড ইউনিট পরীক্ষা তৈরির দিকে এগিয়ে যাব।

পূর্বশর্ত:

2. ব্যবহারের ক্ষেত্রে সম্পর্কে

যেহেতু আপনার অ্যান্টিগ্র্যাভিটি সম্পর্কে প্রাথমিক ধারণা আছে, তাই আসুন এটি কীভাবে কার্যকর হয় তা দেখার জন্য কয়েকটি ব্যবহারের ক্ষেত্রে ডুব দেই। মনে রাখবেন যে অ্যান্টিগ্র্যাভিটি হল একটি এজেন্ট-প্রথম প্ল্যাটফর্ম। এর অর্থ হল বেশিরভাগ ক্ষেত্রে, আমরা কেবল এজেন্টকে একটি নির্দেশনা দিচ্ছি এবং এজেন্ট তারপর নিজে থেকেই কাজ করে, প্রয়োজনে অনুমতি চায়, শিল্পকর্ম তৈরি করে এবং তারপর কাজটি সম্পন্ন হলে আমাদের অবহিত করে। এর ফলে, আমরা নিম্নলিখিত প্রতিটি ব্যবহারের ক্ষেত্রে এজেন্ট কথোপকথনের প্রতিটি আউটপুট তৈরি করতে পারছি না। আমরা প্রত্যাশিত ফলাফলের নির্দেশাবলী এবং কয়েকটি প্রয়োজনীয় স্ক্রিনশট শেয়ার করব তবে আপনার ফলাফল কিছুটা ভিন্ন হতে পারে।

আমরা যে ব্যবহারের ক্ষেত্রে আলোচনা করব তার মধ্যে রয়েছে বহিরাগত সাইটগুলির সাথে কয়েকটি কাজ স্বয়ংক্রিয় করা থেকে শুরু করে একটি প্রকল্পের জন্য ইউনিট টেস্ট কেস তৈরি এবং যাচাই করা, একটি সম্পূর্ণ ওয়েবসাইট ডেভেলপমেন্ট। চলুন শুরু করা যাক।

৩. সংবাদ হাইলাইটস

এটি একটি সহজ ব্যবহারের ক্ষেত্রে কিন্তু এটি এমন একটি ভিত্তি হতে পারে যার মাধ্যমে আপনি ওয়েব ব্রাউজার ব্যবহার করে ওয়েবসাইটগুলি পরিদর্শন করতে, তথ্য আহরণ করতে, কিছু কাজ করতে এবং তারপর ব্যবহারকারীকে ডেটা ফেরত দিতে পারেন।

এই ক্ষেত্রে, আমরা গুগল নিউজ সাইটটি পরিদর্শন করব এবং সেখান থেকে কিছু তথ্য সংগ্রহ করব। তবে আপনি সহজেই আপনার পছন্দের একটি সাইট নিয়ে পরীক্ষা-নিরীক্ষা করতে পারেন এবং দেখতে পারেন এটি কেমন হয়।

নিশ্চিত করুন যে আপনি Agent Manager আছেন এবং নীচে দেখানো Playground নির্বাচন করেছেন:

অনুসরণ

তারপর নিম্নলিখিত নির্দেশ দিন:

8513d489eea0b014.png সম্পর্কে

এটি এজেন্ট প্রক্রিয়া শুরু করবে এবং এটি নির্ধারণ করবে যে এটিকে ব্রাউজার চালু করতে হবে, ইত্যাদি। আপনার চিন্তাভাবনা প্রক্রিয়ার দিকে মনোযোগ দেওয়া উচিত এবং এজেন্ট কীভাবে তার কাজ করে তা দেখা উচিত। যদি সবকিছু ঠিকঠাক থাকে, তাহলে এটি অ্যান্টিগ্রাভিটি ব্রাউজার চালু করবে এবং নীচে দেখানো সাইটটি পরিদর্শন করবে। সাইটের চারপাশে নীল সীমানা দেখায় যে এজেন্ট এখন ব্রাউজারটি নিয়ন্ত্রণ করছে এবং তথ্য পেতে সাইটটি নেভিগেট করছে।

9d594588f2ffe6bc.png সম্পর্কে

একবার এটির কাজ শেষ হয়ে গেলে, আপনি নীচে দেখানো হিসাবে আর্টিফ্যাক্টগুলি তৈরি হতেও দেখতে পাবেন:

dc6cf4e7d8425df8.png সম্পর্কে

এজেন্ট কর্তৃক একটি নমুনা সম্পাদন নীচে দেখানো হয়েছে:

fb7397cd2cce0682.png সম্পর্কে

লক্ষ্য করুন যে বাম দিকে, আমাদের চিন্তা প্রক্রিয়া আছে, আপনি পয়েন্টগুলি স্ক্রোল করে প্লেব্যাক এবং অন্যান্য ডেটা দেখতে পারেন।

চেষ্টা করে দেখার মতো জিনিস

  • একবার আপনি এটি বুঝতে পারলে, এমন একটি ওয়েবসাইট বেছে নিন যা উপলব্ধ এবং আপনি চান যে এজেন্ট সেখানে গিয়ে কিছু তথ্য সংগ্রহ/সংক্ষেপে প্রকাশ করুক। এমন একটি ওয়েবসাইট বিবেচনা করুন যেখানে ড্যাশবোর্ড এবং চার্ট রয়েছে এবং এটিকে কয়েকটি মান বেছে নিতে বলুন।
  • নিম্নলিখিত প্রম্পটটি চেষ্টা করে দেখুন: Visit https://docs.cloud.google.com/release-notes and get me a summary of the release notes, categorized by product.

৪. পাইথন + ফ্লাস্ক দিয়ে একটি ডায়নামিক ওয়েবসাইট তৈরি করুন

এবার একটি সম্পূর্ণ ওয়েব অ্যাপ্লিকেশন তৈরি করা যাক। আমরা যে ওয়েব অ্যাপ্লিকেশনটি তৈরি করতে যাচ্ছি তা এমন একটি সাইট যা ১ দিনের টেকনিক্যাল ইভেন্টের তথ্য প্রদান করে, যেখানে দিনভর একাধিক বক্তা আলোচনা করেন।

আবারও, নিশ্চিত করুন যে আপনি 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.

উপরের প্রম্পটটি দিয়ে আপনি কথোপকথন শুরু করতে পারেন:

এজেন্ট যখন তার কাজ শেষ করবে, তখন সে শিল্পকর্ম তৈরিতে এগিয়ে যাবে:

  • টাস্ক আর্টিফ্যাক্ট
  • বাস্তবায়ন শিল্পকর্ম
  • ওয়াকথ্রু আর্টিফ্যাক্ট

নিচে দেওয়া টাস্ক আর্টিফ্যাক্টটি ছিল এজেন্ট কর্তৃক প্রদত্ত টাস্কের উপর ভিত্তি করে করণীয় কাজের প্রাথমিক ক্রম। এক্সিকিউশনের একটি নমুনা স্ক্রিনশট নীচে দেখানো হল:

c95d82e1c040698f.png সম্পর্কে

এরপর আপনি "ইমপ্লিমেন্টেশন প্ল্যান" আর্টিফ্যাক্টে ক্লিক করতে পারেন। একটি নমুনা স্ক্রিনশট নীচে দেখানো হয়েছে:

632169a236bc62cc.png সম্পর্কে

এবং অবশেষে, আপনার কাছে ওয়াকথ্রু আর্টিফ্যাক্ট আছে। এতে এজেন্ট যা যা করেছে তা নীচে দেখানো হয়েছে:

e3f6152d6f54d4f9.png সম্পর্কে

লক্ষ্য করুন যে এটি সার্ভারটি চালু করেছে এবং আমাকে URL দিয়েছে, যেটিতে আমি ক্লিক করলে আমার কাছে অ্যাপ্লিকেশনটি আছে, একটি নমুনা স্ক্রিনশট নীচে দেখানো হয়েছে:

abf879f2ce53d055.png সম্পর্কে

যদি আমি Editor এ স্যুইচ করি, তাহলে স্ক্রিনে লক্ষ্য করুন যে এতে সেই ফোল্ডারটি রয়েছে যেখানে Python Flask অ্যাপ্লিকেশন তৈরি করা হয়েছে। আপনি আরও লক্ষ্য করবেন যে Agent mode ডানদিকে ট্যাগ করা হয়েছে এবং আপনি সেখানেও কথোপকথন চালিয়ে যেতে পারেন।

অনুসরণ

এখন, ধরা যাক আমরা ইভেন্টে আরও কিছু আলোচনা যোগ করতে চাই। আমরা সম্পাদক এবং এজেন্ট প্যানেলে থাকতে পারি, Add two more talks to the schedule মতো একটি নির্দেশনা দিতে পারি।

এর ফলে এজেন্ট প্রয়োজনীয়তা বিশ্লেষণ করবে, কার্য, বাস্তবায়ন পরিকল্পনা আপডেট করবে এবং তারপর আপডেট করা কার্যকারিতাও যাচাই করবে। একটি নমুনা কথোপকথন নীচে দেখানো হয়েছে:

ba8455e6f68973e9.png সম্পর্কে

আপনি চাইলে এজেন্ট ম্যানেজারে ফিরে যেতে পারেন। এই প্রক্রিয়াটি আপনাকে এজেন্ট ম্যানেজার থেকে এডিটরে স্থানান্তর, সেই অনুযায়ী পরিবর্তন করা ইত্যাদি প্রক্রিয়া বুঝতে সাহায্য করবে।

চেষ্টা করে দেখার মতো জিনিস

  • অ্যাপ্লিকেশনটিতে আপনার পছন্দের অতিরিক্ত কার্যকারিতা যোগ করুন। এজেন্টকে বিস্তারিত তথ্য প্রদান করুন এবং লক্ষ্য করুন যে এটি কীভাবে কাজটি সম্পন্ন করে, প্রথমে টাস্ক তালিকা পরিবর্তন করুন, তারপর বাস্তবায়ন পরিকল্পনা ইত্যাদি।
  • আবেদনের জন্য এজেন্টকে একটি README বা আরও ডকুমেন্টেশন তৈরি করতে বলুন।

৫. একটি সহজ উৎপাদনশীলতা অ্যাপ তৈরি করুন

আমরা এখন একটি সহজ Pomodoro টাইমার ওয়েব অ্যাপ্লিকেশন তৈরি করতে যাচ্ছি।

নিশ্চিত করুন যে আপনি Agent Manager আছেন এবং Playground নির্বাচন করেছেন। নিম্নলিখিত প্রম্পটটি দিন:

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

লক্ষ্য করুন কিভাবে এটি কার্য তালিকা তৈরি করে, বাস্তবায়ন পরিকল্পনা তৈরি করে এবং তারপর তা করে। প্রবাহের দিকে মনোযোগ দিন, এমন পরিস্থিতিতে এটি আপনাকে পর্যালোচনার জন্য অনুরোধ করতে পারে। একটি নমুনা রান নীচে দেখানো হয়েছে।

5be0a668e5a67d85.png সম্পর্কে

এই ক্ষেত্রে, এটির অ্যান্টিগ্র্যাভিটি ব্রাউজারটিও চালু করা উচিত, নিজস্ব পরীক্ষা করা উচিত এবং তারপর নিশ্চিত করা উচিত যে পরীক্ষাগুলি সফল হয়েছে। এটি যে জিনিসগুলি তৈরি করেছে তার মধ্যে একটি হল একটি মিডিয়া আর্টিফ্যাক্ট যাতে এর যাচাইকরণের ভিডিও রয়েছে। এটি কী পরীক্ষা করেছে তা দেখার জন্য এটি একটি দুর্দান্ত উপায়। আমি কিছু স্টাইল পরিবর্তনের পরামর্শও দিয়েছিলাম কারণ এটি কার্যকর হয়নি এবং এটি তা করতে সক্ষম হয়েছিল।

শেষ অ্যাপটি দেখতে নিচের অ্যাপটির মতো ছিল এবং এটি বেশ ভালো দেখাচ্ছে।

c9ab6bca97a51a8c.png সম্পর্কে

আমরা অ্যাপ্লিকেশনটিতে একটি সুন্দর টাইমার ইমেজ যোগ করতে পারি। আমাদের যা করতে হবে তা হল নীচের দেওয়া একটি ফলো-আপ নির্দেশনা জারি করা:

Add an image to the application that displays a timer.

এর ফলে এজেন্ট টাস্ক আর্টিফ্যাক্টে একটি নতুন টাস্ক যোগ করেছে:

498dd946d4e9ae55.png সম্পর্কে

এরপর এটি তার কাজটি সম্পন্ন করার সময় একটি চিত্র তৈরি করে:

c291da9bdb37ff96.png সম্পর্কে

অবশেষে, অ্যাপটিতে আমাদের অনুরোধ অনুযায়ী ছবিটি এসেছে:

de8f418ba8e4600d.png

চেষ্টা করে দেখার মতো জিনিস

  • লক্ষ্য করুন অ্যাপ্লিকেশনটিতে বালিঘড়ি আইকনের পটভূমি স্বচ্ছ নয়। এজেন্টকে এটি স্বচ্ছ করতে বলার চেষ্টা করুন।
  • আপনি যে অ্যাপ্লিকেশন তৈরি করতে চান তার কয়েকটি ভিন্নতা ব্যবহার করে দেখুন। স্টাইল, ছবি, পরিবর্তনের জন্য জিজ্ঞাসা ইত্যাদি নিয়ে খেলুন।

৬. ইউনিট টেস্ট, মক স্টাব তৈরি করুন এবং পরীক্ষা যাচাই করুন

আমরা এখানে যে চূড়ান্ত ব্যবহারের চেষ্টা করব তা হল আমাদের কাছে থাকা একটি নির্দিষ্ট কোড ফাইলের জন্য ইউনিট পরীক্ষা তৈরি করা এবং এজেন্টের জন্য পরীক্ষাগুলি সম্পাদন এবং যাচাই করা।

এর জন্য, আমাদের এমন একটি ওয়ার্কস্পেস থাকবে যেখানে নীচে দেখানো একটি পাইথন ফাইল থাকবে:

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}

নিশ্চিত করুন যে উপরের পাইথন ফাইলটি স্থানীয়ভাবে একটি ফোল্ডারে আছে এবং আপনি এটি অ্যান্টিগ্র্যাভিটিতে একটি ওয়ার্কস্পেস হিসাবে লোড করছেন।

এটি একটি সহজ অর্ডার পরিষেবা যার checkout ফাংশনে নিম্নলিখিত মূল কার্যকারিতা রয়েছে:

  1. কার্ট খালি নেই তা যাচাই করে।
  2. সমস্ত আইটেমের স্টক পরীক্ষা করুন।
  3. চূড়ান্ত মূল্য গণনা করে।
  4. চার্জ পরিশোধ।
  5. ইনভেন্টরি আপডেট করে।

আমরা এজেন্টকে ইউনিট টেস্ট কেস তৈরি, মক ইমপ্লিমেন্টেশন প্রদান এবং পরীক্ষাগুলি সফল করার জন্য কার্যকর করার কাজটি অর্পণ করতে যাচ্ছি।

আমরা আমাদের নির্দিষ্ট ওয়ার্কস্পেস ফোল্ডারটি খুলব এবং আপনি লক্ষ্য করবেন যে আমরা এখন ফাইলটি উল্লেখ করার জন্য @ চিহ্নটিও ব্যবহার করতে পারি। উদাহরণস্বরূপ, আমরা নিম্নলিখিতগুলি করতে পারি:

8368856e51a7561a.png সম্পর্কে

এই ফাইলটি কী তার কিছু ব্যাখ্যা এখানে দেওয়া হল:

b69c217d3372d802.png সম্পর্কে

আমরা প্রম্পটের মাধ্যমে এটিকে আরও ভালো ভিজ্যুয়ালাইজেশন তৈরি করতে বলতে পারি:

Can you visually show this class for better understanding

da5bd701323818d4.png সম্পর্কে

আমাদের পরবর্তী পদক্ষেপ হল ইউনিট পরীক্ষা তৈরি করা এবং এজেন্টকে এটি পরীক্ষা করতে বলা। আমি নিম্নলিখিত প্রম্পট দিচ্ছি:

generate unit tests for this module and test it out with mock implementations.

এটি নিম্নলিখিত টাস্ক আর্টিফ্যাক্ট তৈরি করেছে এবং তার কাজটি চালিয়ে গেছে।

21425379db336dc6.png সম্পর্কে

আপনি এটি পরিচালিত পরীক্ষাগুলির বিবরণও দেখতে পারেন:

48f3320cd76b5cd8.png সম্পর্কে

এটি যে ফাইলগুলি তৈরি করেছিল তার মধ্যে একটি ছিল টেস্ট ফাইল। যার একটি স্ক্রিনশট নীচে দেখানো হয়েছে:

f962061f115c040f.png সম্পর্কে

চেষ্টা করে দেখার মতো জিনিস

আপনার নিজস্ব কোড নিন এবং দেখুন এজেন্টকে আপনি কী করতে বলতে পারেন, আরও কার্যকারিতা যোগ করা থেকে শুরু করে আপনার কোডের অংশগুলি রিফ্যাক্টর করা পর্যন্ত।

৭. অভিনন্দন

অভিনন্দন! আপনি গুগল অ্যান্টিগ্র্যাভিটি সফলভাবে ব্যবহার করেছেন:

  • ওয়েবে স্বাধীনভাবে গবেষণা করুন।
  • ফুল-স্ট্যাক ওয়েব অ্যাপ্লিকেশন তৈরি এবং পুনরাবৃত্তি করুন।
  • সম্পদ তৈরি করুন এবং UI এর নান্দনিকতা উন্নত করুন।
  • মক ব্যবহার করে জটিল ইউনিট পরীক্ষা লিখুন এবং যাচাই করুন।

তুমি এখন অ্যান্টিগ্র্যাভিটিকে তোমার নিজস্ব প্রকল্পের ভারী দায়িত্ব সামলাতে দিতে প্রস্তুত।

রেফারেন্স ডক্স