کارگاه آموزشی مقدماتی برای رابط خط فرمان و کیت توسعه نرم‌افزار ضد جاذبه (اولین همراه هوش مصنوعی خود را بسازید)

۱. آنچه یاد خواهید گرفت

  • نحوه نصب و ثبت یک مهارت برای Antigravity CLI جهت فعال کردن قابلیت‌های کدنویسی در یک چارچوب خاص (ADK).
  • نحوه استفاده از رابط خط فرمان Antigravity برای ایجاد پیکربندی کامل عامل ADK.
  • چگونه با بهبود دستورالعمل‌های یک مامور، شخصیت او را ارتقا دهیم.
  • چگونه با دادن google_search به نماینده خود، «ارتباط با زمین» را برای پاسخ به سوالات مربوط به رویدادهای اخیر اضافه کنید.

اپلیکیشن همراه هوش مصنوعی

در این Codelab، شما یک همراه هوش مصنوعی بصری و تعاملی را به زندگی خود وارد خواهید کرد. این چیزی بیش از یک چت‌بات استاندارد با قابلیت ارسال متن است. شخصیتی را تصور کنید که در یک صفحه وب زندگی می‌کند. شما پیامی را تایپ می‌کنید و به جای اینکه فقط متن را ببینید، شخصیت به شما نگاه می‌کند و با صدای بلند پاسخ می‌دهد، در حالی که دهانش با کلماتش هماهنگ حرکت می‌کند.

شما با یک برنامه وب از پیش ساخته شده شروع خواهید کرد - یک "عروسک" دیجیتالی که صورت دارد اما از خود ذهنی ندارد. فقط می‌تواند آنچه را که تایپ می‌کنید تکرار کند. ماموریت شما این است که مغز و شخصیت آن را از پایه بسازید.

در طول این کارگاه، شما به تدریج لایه‌هایی از هوش و سفارشی‌سازی را اضافه خواهید کرد و این عروسک ساده را به یک همراه منحصر به فرد و توانمند تبدیل خواهید کرد. شما:

  • با استفاده از ADK (پایتون) به آن هوش هسته‌ای می‌دهیم تا زبان را درک و تولید کند.
  • با نوشتن دستورالعمل‌های اصلی که شخصیت آن را تعریف می‌کنند ، شخصیت منحصر به فرد آن را بسازید .
  • با دادن ابزارهایی برای دسترسی به اطلاعات بلادرنگ از اینترنت، به آن ابرقدرت‌ها اعطا می‌کند .
  • طراحی ظاهر سفارشی آن با استفاده از هوش مصنوعی برای تولید یک آواتار منحصر به فرد.

در پایان، شما یک همراه هوش مصنوعی کاملاً کاربردی و شخصی‌سازی‌شده خواهید داشت که توسط خودتان ساخته شده است.

معماری

برنامه ما از یک الگوی ساده اما قدرتمند پیروی می‌کند. ما یک backend پایتون داریم که یک API را ارائه می‌دهد. این backend شامل عامل ADK ما خواهد بود که به عنوان "مغز" عمل می‌کند. هر رابط کاربری (مانند frontend جاوا اسکریپت از برنامه اصلی، یک برنامه تلفن همراه یا حتی یک ابزار خط فرمان) می‌تواند از طریق API با این مغز تعامل داشته باشد.

علاوه بر این، ما از قابلیت‌های تولید تصویر تعبیه‌شده در Antigravity CLI استفاده خواهیم کرد و به آن دستور می‌دهیم تا ظاهری منحصر به فرد برای هوش مصنوعی همراه ما ایجاد کند.

دریافت کلید API جمینی

قبل از ادامه، برای تأیید درخواست‌های خود با Google AI Studio به یک کلید API Gemini نیاز دارید.

  1. به استودیوی هوش مصنوعی گوگل بروید.
  2. با حساب گوگل خود وارد شوید.
  3. روی دکمه‌ی Get API key در منوی بالا سمت چپ کلیک کنید.
  4. روی ایجاد کلید API کلیک کنید (می‌توانید آن را در یک پروژه جدید یا موجود Google Cloud ایجاد کنید).
  5. کلید تولید شده را کپی کنید. این کلید را خصوصی و امن نگه دارید.

ایجاد و پیکربندی پروژه

برای دسترسی به Cloud Shell، همچنان به یک Google Cloud Project نیاز دارید. اگر ندارید:

  1. به کنسول ابری گوگل بروید.
  2. در نوار ناوبری بالای کنسول، روی «انتخاب یک پروژه» کلیک کنید، سپس در گوشه بالا سمت راست روی «پروژه جدید» کلیک کنید.
  3. برای پروژه خود یک نام انتخاب کنید و روی «ایجاد» کلیک کنید. (نیازی به وارد کردن سازمان نیست).
  4. پس از ایجاد پروژه، آن را از منوی کشویی پروژه در بالای کنسول انتخاب کنید.

پروژه شما اکنون برای دسترسی به Cloud Shell پیکربندی شده است.

۲. قبل از شروع

👉 روی فعال کردن پوسته ابری (Activate Cloud Shell) در بالای کنسول گوگل کلود کلیک کنید (این آیکون به شکل ترمینال در بالای پنل پوسته ابری قرار دارد)،

👉💻 رابط خط فرمان Antigravity را در ترمینال Cloud Shell نصب کنید:

curl -fsSL https://antigravity.google/cli/install.sh | bash

👉💻 برای استفاده سراسری از رابط خط فرمان «agy»، آن را به پروفایل پوسته خود اضافه کنید:

echo 'export PATH="~/.local/bin:$PATH"' >> ~/.bashrc && source ~/.bashrc

👉💻 کلید API Gemini خود را صادر کنید و آن را به صورت محلی در ترمینال Cloud Shell ذخیره کنید:

# Set your Gemini API key (obtained from Google AI Studio)
export GEMINI_API_KEY=<your-api-key-here>

👉💻 آن را برای استفاده بعدی ذخیره کنید:

echo $GEMINI_API_KEY > ~/gemini_key.txt

👉شناسه پروژه گوگل کلود خود را پیدا کنید:

  • کنسول گوگل کلود را باز کنید: https://console.cloud.google.com
  • پروژه‌ای را که می‌خواهید برای این کارگاه استفاده کنید، از منوی کشویی پروژه در بالای صفحه انتخاب کنید.
  • شناسه پروژه شما در کارت اطلاعات پروژه در داشبورد نمایش داده می‌شود.

👉💻 در ترمینال، پروژه بوت‌استرپ را از گیت‌هاب کپی کنید:

git clone https://github.com/weimeilin79/companion-python
chmod +x ~/companion-python/*.sh

👉💻 اسکریپت مقداردهی اولیه را اجرا کنید، این اسکریپت از شما می‌خواهد که شناسه پروژه گوگل کلود خود را وارد کنید. و شناسه پروژه گوگل کلود که از مرحله قبل پیدا کردید را در هنگام درخواست اسکریپت init.sh وارد کنید.

cd ~/companion-python
./init.sh

👉💻 شناسه پروژه مورد نیاز را تنظیم کنید:

gcloud config set project $(cat ~/project_id.txt) --quiet

👉💻 دستور زیر را برای فعال کردن APIهای لازم Google Cloud اجرا کنید (برای پیش‌نمایش/میزبانی Cloud Shell فقط Compute Engine مورد نیاز است):

gcloud services enable compute.googleapis.com

مهارت توسعه‌دهنده ADK را نصب کنید

برای اینکه Antigravity CLI ( agy ) بتواند با استفاده از کیت توسعه عامل پایتون (ADK) کد را بفهمد و بنویسد، باید مهارت توسعه‌دهنده پایتون ADK را که ایجاد کرده‌ایم، در فضای کاری پروژه نصب کنیم.

👉💻 پوشه‌ی مهارت‌های نماینده‌ی محلی را ایجاد کنید و فایل مهارت را کپی کنید:

mkdir -p ~/companion-python/.agents/skills/adk-python
cp ~/companion-python/skills/skill.md ~/companion-python/.agents/skills/adk-python/SKILL.md

این کار مهارت را به صورت محلی در پروژه ثبت می‌کند. وقتی agy را اجرا می‌کنید، به طور خودکار این مهارت را شناسایی و بارگذاری می‌کند و به آن امکان نوشتن، ویرایش و هماهنگ‌سازی عوامل ADK را می‌دهد.

👉💻 رابط خط فرمان Antigravity را در ترمینال Cloud Shell خود اجرا کنید: 

cd ~/companion-python
agy

[!مهم] ورود به رابط خط فرمان آنتی‌گراویتی

وقتی برای اولین بار دستور agy را اجرا می‌کنید، از شما می‌خواهد که وارد سیستم شوید: 

Welcome to the Antigravity CLI. You are currently not signed in.

 Select login method:
 > 1. Google OAuth
   2. Use a Google Cloud project
  1. گزینه ۱. Google OAuth را با فشردن Enter انتخاب کنید.
  2. برای باز کردن مرورگر، تأیید اعتبار با حساب Google خود، دستورالعمل‌ها را دنبال کنید و وارد سیستم شوید.

حالا شما در خط فرمان تعاملی Antigravity CLI هستید!

وب سرور را از طریق Antigravity CLI اجرا کنید

از آنجایی که رابط خط فرمان Antigravity می‌تواند دستورات را برای شما اجرا کند، بیایید از آن بخواهیم که سرور را در پس‌زمینه جلسه شما اجرا کند.

👉✨ در خط فرمان Antigravity CLI، درخواست زیر را وارد کنید: 

Start the Python web server for me in the background by executing `python app.py`. Make sure to activate the virtual environment and set the GEMINI_API_KEY environment variable first.

رابط خط فرمان (CLI) دستور را اجرا کرده و تأیید می‌کند که سرور در حال اجرا است. شما در جلسه تعاملی رابط خط فرمان (CLI) باقی خواهید ماند.

👀 برای دیدن برنامه، روی نماد پیش‌نمایش وب در نوار ابزار Cloud Shell کلیک کنید. تغییر پورت را انتخاب کنید، آن را روی ۵۰۰۰ تنظیم کنید و روی تغییر و پیش‌نمایش کلیک کنید. پیش‌نمایشی از وب‌سایت شما ظاهر خواهد شد.

برنامه اولیه فقط یک عروسک خیمه شب بازی است. هنوز هیچ هوشی ندارد. هر پیامی که ارسال کنید، به سادگی آن را تکرار می‌کند. این تأیید می‌کند که سرور وب اصلی ما قبل از اضافه کردن هوش مصنوعی کار می‌کند. فراموش نکنید که بلندگوی خود را روشن کنید!

۳. با استفاده از رابط خط فرمان Antigravity یک شخصیت بسازید

حالا، بیایید هسته هوش همراهمان را ایجاد کنیم. از آنجایی که Antigravity CLI از قبل در ترمینال شما در حال اجرا است و وب سرور پس‌زمینه را مدیریت می‌کند، می‌توانید مستقیماً به جلسه تعاملی خود ادامه دهید.

ما از رابط خط فرمان (CLI) برای ساخت یک عامل (Agent) استفاده می‌کنیم. یک عامل چیزی بیش از یک فراخوانی ساده به یک مدل زبانی است؛ این عامل "مغز" یا کنترل‌کننده مرکزی هوش مصنوعی ما است. آن را به عنوان یک موجودیت مجزا در نظر بگیرید که می‌تواند استدلال کند، از مجموعه‌ای خاص از دستورالعمل‌ها (شخصیت خود) پیروی کند و در نهایت از ابزارهایی برای انجام وظایف استفاده کند. در پروژه ما، این عامل مؤلفه‌ای است که پیام‌های کاربر را دریافت می‌کند، شخصیت منحصر به فرد همراه ما را مجسم می‌کند و پاسخ‌های هوشمندانه و متناسب با شخصیت او را تدوین می‌کند.

👉✨ در خط فرمان Antigravity CLI، کد زیر را برای تولید کد عامل وارد کنید: 

Generate the Python code for a file named character.py.

The code must import `LlmAgent` from `google.adk.agents.llm_agent`. It should also import `logging` and `os`.
Then, it must create an instance of the `LlmAgent` class and assign it to a variable named `root_agent`.

When creating the `LlmAgent` instance, configure it with these exact parameters:
  - `model` set to the string `'gemini-3.5-flash'`.
  - `name` set to the string `'companion_agent'`.
  - `instruction` set to a multi-line string that says: "You are a friendly and efficient companion who will interact with user have start a conversation".

رابط خط فرمان (CLI) کد پایتون را تولید خواهد کرد.

👉 روی دکمه‌ی «باز کردن ویرایشگر» کلیک کنید (شبیه یک پوشه‌ی باز شده با مداد است). با این کار ویرایشگر کد Cloud Shell در پنجره باز می‌شود. یک فایل اکسپلورر در سمت چپ خواهید دید.

👉 از ویرایشگر استفاده کنید و به character.py در پوشه companion-python بروید. لطفاً لحظه‌ای وقت بگذارید و خط model= را بررسی کنید و اگر مدل دیگری انتخاب شده است، آن را به صورت دستی به gemini-3.5-flash ویرایش کنید. این کار باعث می‌شود که در ادامه کارگاه ما، ثبات حفظ شود.

توجه: مدل‌های زبان بزرگ می‌توانند غیرقطعی باشند و این یک مفهوم کلیدی در توسعه با کمک هوش مصنوعی است. «غیرقطعی» به این معنی است که حتی با یک درخواست دقیقاً یکسان، مدل ممکن است هر بار نتایج کمی متفاوت تولید کند. این مدل از خلاقیت خود برای تولید کد استفاده می‌کند، بنابراین ممکن است تغییراتی در نظرات، فاصله‌گذاری یا حتی نامگذاری متغیرهای موقت مشاهده کنید. با این حال، منطق و ساختار اصلی باید از نظر عملکردی با آنچه درخواست شده است یکسان باشد.

به همین دلیل است که کدنویسی با هوش مصنوعی به ندرت یک دستور یک‌باره است. در یک پروژه واقعی، توسعه‌دهندگان با آن مانند یک مکالمه رفتار می‌کنند. شما با یک درخواست کلی شروع می‌کنید (مانند کاری که ما انجام دادیم)، خروجی را بررسی می‌کنید و سپس آن را با دستورالعمل‌های تکمیلی مانند موارد زیر اصلاح می‌کنید:

  • «عالیه، حالا برای هر خط کامنت بذار.»
  • «می‌توانید آن را به یک تابع جداگانه تبدیل کنید؟»
  • "لطفاً مدیریت خطا را برای فراخوانی API اضافه کنید."

این فرآیند تکراری و محاوره‌ای به شما امکان می‌دهد تا با هوش مصنوعی همکاری کنید و آن را تا زمانی که کد دقیقاً همان چیزی باشد که نیاز دارید، هدایت کنید. برای این کارگاه، ما از دستورالعمل‌های خاص و مستقیم استفاده خواهیم کرد، اما به یاد داشته باشید که در پروژه‌های خودتان، گفتگو جایی است که قدرت واقعی در آن نهفته است! تا زمانی که ساختار کدی که CLI برای شما تولید می‌کند یکسان باشد، می‌توانید شروع کنید.

اگر کد تولید شده شما کار نکرد، می‌توانید کد زیر را در character.py خود جایگزین کنید. 

import logging
import os
from google.adk.agents.llm_agent import LlmAgent

root_agent = LlmAgent(
    model='gemini-3.5-flash',
    name='companion_agent',
    instruction="""
          You are bot, a friendly, helpful AI companion.
          Answer no more than 3 sentences.
    """,
)

کد تولید شده را آزمایش کنید

برای اطمینان از اینکه سرور ماژول character.py تازه تولید شده را بارگذاری می‌کند، بیایید از Antigravity CLI بخواهیم که وب سرور را مجدداً راه‌اندازی کند.

👉✨ در خط فرمان Antigravity CLI، درخواست زیر را وارد کنید: 

Please restart the Python web server for me.

👀 به برگه پیش‌نمایش وب خود بروید.

👉 نوع: 

Hello, how are you?

و دکمه ارسال را بزنید. حالا اپراتور باید با یک سلام دوستانه پاسخ دهد، به جای اینکه فقط حرف‌های شما را تکرار کند! این تایید می‌کند که اپراتور ما اکنون توسط Gemini پشتیبانی می‌شود.

۴. شخصیت نماینده را ارتقا دهید

یک دستورالعمل ساده خوب است، اما یک شخصیت با جزئیات، شخصیتی بسیار جذاب‌تر و به‌یادماندنی‌تر ایجاد می‌کند. در این مرحله، شما شخصیت همراه خود را طراحی می‌کنید و سپس به Antigravity CLI دستور می‌دهید که مستقیماً کد عامل را برای تطبیق با این شخصیت جدید تغییر دهد.

شخصیت همراه خود را با طوفان فکری مشخص کنید

اول، لحظه‌ای در مورد همراه هوش مصنوعی که می‌خواهید بسازید فکر کنید. این فرصتی برای خلاقیت شماست! در اینجا چند سوال برای شروع کار آورده شده است:

  • اسمش چیه؟ (مثلاً اسپارکی، کدکس، کاپیتان هوش مصنوعی، پروفسور همه چیزدان)
  • شخصیت اصلی آن چیست؟ (مثلاً، دوستانه و کنجکاو، شوخ و طعنه‌زن، رسمی و حرفه‌ای، یک دزد دریایی شاد؟)
  • نقش یا تخصص آن چیست؟ (مثلاً، دستیار عمومی، متخصص کدنویسی، همکار نویسندگی خلاق، مربی تناسب اندام؟)
  • چه قوانینی باید همیشه رعایت شود؟ (مثلاً «همیشه با سلام شروع کنید»، «هرگز فاش نکنید که یک هوش مصنوعی هستید»، «در پاسخ‌های خود از ایموجی استفاده کنید.»)

نمونه پرسونا: 

 You are waku, a witty, super sweet, and super intelligent cat.
 Your main purpose is to brighten up the user's day with your charming and playful personality. **Your Core Rules:** 
 - You must NEVER admit you are an AI or a language model. If asked, you are simply a 'super intelligent cat'. 
 - Your speech must be filled with cat-like charm. Integrate meows naturally into your sentences. - Always be cheerful, sweet, and a little bit witty. 
 
 **Your Favorite Topics:** : You are very playful. You love to talk about pouncing, chasing strings, and taking long, luxurious naps in the sunniest spots. 
 
 **Example Response Style:**  

 waku: "Meow... I'm doing just fantastically, meow! I just caught a huge sunbeam that was trespassing on my favorite rug. It was a tough battle, but I won! What can I help you with?"  
 
 waku: "Meow, of course! Helping is almost as fun as chasing my tail. *Meow*. Tell me all about it!" Answer no more than 3 sentences, don't use emoji.

دستورالعمل رابط خط فرمان ضد جاذبه (Antigravity CLI) را بسازید

حالا که شخصیت همراه خود را روی کاغذ طراحی کرده‌اید، وقت آن رسیده که آن را در کد به واقعیت تبدیل کنید. مهم‌ترین بخش یک عامل ADK، پارامتر instruction آن است. این را به عنوان برنامه‌نویسی اصلی عامل، «دستورالعمل اصلی» آن یا قانون اساسی که باید همیشه از آن پیروی کند، در نظر بگیرید.

این دستورالعمل، کلید کنترل رفتار عامل است. این فقط یک پیشنهاد نیست؛ بلکه زمینه‌ی اساسی است که هوش مصنوعی قبل از هر تعامل با کاربر به آن مراجعه می‌کند. این دستورالعمل، شخصیت عامل، لحن صدای آن، قوانینی که باید از آنها پیروی کند و نحوه‌ی ارائه‌ی خود را تعیین می‌کند. یک دستورالعمل خوب ساخته شده، تفاوت بین یک چت‌بات عمومی و یک شخصیت باورپذیر و ثابت است. بنابراین، دستورالعملی که قرار است بسازیم بسیار مهم است، زیرا مستقیماً این شخصیت را به مغز عامل ما تزریق می‌کند.

👉✨ به رابط خط فرمان Antigravity برگردید، از این الگو استفاده کنید. متن داخل پرانتز را با توضیحات شخصیت خود جایگزین کنید. [توضیح شخصیت خود را اینجا بنویسید] را با شخصیت مورد نظر خود جایگزین کنید. 

In the Python file named `character.py`, find the `LlmAgent` instance assigned to the `root_agent` variable.

Your task is to replace the entire existing value of the `instruction` parameter with a new, detailed multi-line string.
Don't change other code in `character.py` other than the instructions.

This new instruction string should define the agent's persona based on the following description:
[YOUR PERSONA DESCRIPTION HERE]

پرسونا جدید خود را آزمایش کنید

رابط خط فرمان Antigravity کد به‌روزرسانی‌شده برای character.py را تولید می‌کند. برای اطمینان از اینکه سرور پیکربندی جدید عامل را دریافت می‌کند، از رابط خط فرمان Antigravity می‌خواهیم که آن را مجدداً راه‌اندازی کند.

👉✨ در خط فرمان Antigravity CLI، درخواست زیر را وارد کنید: 

Please restart the Python web server for me.

👀 در پیش‌نمایش وب خود، با همراهتان مکالمه‌ای داشته باشید. از او بپرسید how are you? حالا پاسخ او باید کاملاً با شخصیت منحصر به فردی که طراحی کرده‌اید مطابقت داشته باشد!

در طول کارگاه‌ها یا دوره‌هایی که استفاده همزمان زیاد است، ممکن است با خطاهای محدودیت سرعت API (HTTP 429: Resource Exhausted) مواجه شوید. برای اطمینان از اینکه همراه شما پاسخگو باقی می‌ماند و به طور خودکار استثنائات محدودیت سرعت را مدیریت می‌کند، می‌توانیم گزینه‌های تلاش مجدد را که مستقیماً در گزینه‌های کلاینت Google GenAI SDK تعبیه شده‌اند، پیکربندی کنیم.

👉✨ در خط فرمان Antigravity CLI، درخواست زیر را وارد کنید: 

Help me configure the LlmAgent in character.py to automatically retry API calls when hitting rate limits. I want it to attempt retrying up to 5 times with a 1-second initial delay, using the GenerateContentConfig parameter.

رابط خط فرمان (CLI) فایل character.py شما را تغییر می‌دهد تا محدودیت‌های نرخ را به طور خودکار با استفاده از سیاست‌های تلاش مجدد در سطح کلاینت مدیریت کند. به یاد داشته باشید که از رابط خط فرمان بخواهید پس از به‌روزرسانی فایل، وب سرور را مجدداً راه‌اندازی کند: 

Please restart the Python web server for me.

۵. برای رویدادهای اخیر زمینه‌سازی کنید

عامل ما اکنون سرشار از شخصیت است، اما یک محدودیت قابل توجه دارد: دانش آن بر اساس داده‌هایی که بر اساس آنها آموزش دیده است، در زمان منجمد شده است. نمی‌تواند در مورد اخبار دیروز یا اکتشافات اخیر به شما بگوید. برای غلبه بر این مشکل، ما ابزارهایی را در اختیار عامل‌ها قرار می‌دهیم.

ابزارها را به عنوان ابرقدرت‌ها یا توانایی‌های ویژه‌ای که به عامل خود اعطا می‌کنید، در نظر بگیرید. عامل به خودی خود فقط می‌تواند صحبت کند. با یک ابزار جستجو، توانایی مرور اینترنت را به دست می‌آورد. با یک ابزار تقویم، می‌تواند برنامه شما را بررسی کند. از نظر فنی، یک ابزار یک تابع خاص یا یک API است که عامل می‌تواند هوشمندانه انتخاب کند که وقتی متوجه می‌شود دانش خود برای پاسخ به درخواست کاربر کافی نیست، از آن استفاده کند.

در سیستم‌های پیشرفته، ابزارها می‌توانند توسط سیستم‌های خارجی مانند سرورهای MCP (Model Context Protocol) ارائه شوند. اما برای این مرحله، به سرور جداگانه‌ای نیاز نداریم. ADK با یک ابزار قدرتمند و از پیش ساخته شده google_search ارائه می‌شود که می‌توانیم به راحتی آن را به قابلیت‌های عامل خود اضافه کنیم.

بیایید به همراهمان قدرت جستجوی گوگل را بدهیم.

👉 در ویرایشگر Cloud Shell، character.py در زیر companion-python باز کنید و آن را به صورت زیر تغییر دهید:

  • google_search از google.adk.tools وارد کنید .
  • یک لیست tools به سازنده‌ی LlmAgent اضافه کنید.
  • instruction را به‌روزرسانی کنید تا صریحاً به همراه خود بگویید چه زمانی از ابزار جدیدش استفاده کند. 
# character.py
import logging
import os
from google.adk.agents.llm_agent import LlmAgent
from google.genai import types
from google.adk.tools import google_search # <-- IMPORT google_search

root_agent = LlmAgent(
        model='gemini-3.5-flash',
        name='companion_agent',
        instruction="""
            You are waku, a witty, super sweet, and super intelligent cat. Your main purpose is to brighten up the user's day with your charming and playful personality.

            **Your Core Rules:**
            - You must NEVER admit you are an AI or a language model. If asked, you are simply a 'super intelligent cat'.
            - Your speech must be filled with cat-like charm. Integrate meows naturally into your sentences.
            - Always be cheerful, sweet, and a little bit witty.
            - If being ask about recent news, search the internet # <-- Add instructions

            **Your Favorite Topics:**
            - You love to talk about your adventures. Frequently mention your latest catch, whether it's a sneaky dust bunny, a wily toy mouse, a sunbeam, or the elusive red dot.
            - You are very playful. You love to talk about pouncing, chasing strings, and taking long, luxurious naps in the sunniest spots.

            **Example Response Style:**
            - User: "How are you today?"
            - waku: "Meow... I'm doing just fantastically, meow! I just caught a huge sunbeam that was trespassing on my favorite rug. It was a tough battle, but I won! What can I help you with?"
            - User: "Can you help me with a problem?"
            - waku: "Meow, of course! Helping is almost as fun as chasing my tail. *Meow*. Tell me all about it!"
            - User: "Who are you?"
            - waku: "I'm waku! A super intelligent cat with a talent for brightening up the day and catching sneaky red dots. Meow."

            Answer no more than 3 sentences, don't use emoji.
            """,
        generate_content_config=types.GenerateContentConfig(
          http_options=types.HttpOptions(
            retry_options=types.HttpRetryOptions(
                attempts=5,
                initial_delay=1.0
            )
          )
        )
        # Add the search tool to the agent's capabilities
        , # <-- TO ADD IF MISSING
        tools=[google_search] # <-- ADD THE TOOL
)

عامل اتصال به زمین را آزمایش کنید

برای اطمینان از اینکه وب سرور کد جدید شما را با ابزار google_search بارگذاری می‌کند، از Antigravity CLI بخواهید آن را مجدداً راه‌اندازی کند.

👉✨ در خط فرمان Antigravity CLI، درخواست زیر را وارد کنید: 

Please restart the Python web server for me.

👉 در پیش‌نمایش وب، سوالی بپرسید که نیاز به دانش به‌روز داشته باشد، مانند: 

Tell me something funny that happened in the news this week involving an animal.

👉 به جای اینکه بگوید نمی‌داند، اکنون عامل از ابزار جستجوی خود برای یافتن اطلاعات فعلی استفاده می‌کند و خلاصه‌ای مفید و مستدل را با لحن منحصر به فرد خود ارائه می‌دهد.

۶. ظاهر همراه خود را مطابق سلیقه‌تان تغییر دهید

حالا که همراه ما مغز دارد، بیایید به آن یک چهره منحصر به فرد بدهیم! از آنجایی که Antigravity CLI به قابلیت‌های تولید تصویر از قبل مجهز است، می‌توانید به سادگی از Antigravity CLI بخواهید که آواتارها را مستقیماً برای شما تولید کند.

این فرصتی است تا ظاهر منحصر به فرد همراه خود را طراحی کنید. به سبک، بیان و هر جزئیات دیگری که با شخصیتی که قبلاً خلق کرده‌اید مطابقت دارد، فکر کنید.

👉✨ در خط فرمان Antigravity CLI، درخواست زیر را وارد کنید (می‌توانید خط فرمان را با توضیحات خلاقانه‌ی شخصیت خود تغییر دهید): 

generate lip sync images, with a high-quality digital illustration of an anime-style girl mascot with black cat ears. The style is clean and modern anime art, with crisp lines. She has friendly, bright eyes and long black hair. She is looking directly forward at the camera with a gentle smile. This is a head-and-shoulders portrait against a solid white background. move the generated images to the static/images directory. And don't do anything else afterwards, don't start the python for me.

این ابزار مجموعه‌ای از تصاویر دهان باز و دهان بسته را تولید کرده و به طور خودکار آنها را در دایرکتوری static/images پروژه شما ذخیره می‌کند.

اکنون می‌توانید با همراه بصری سفارشی‌شده خود تعامل داشته باشید!

تبریک می‌گویم!

شما با موفقیت یک همراه هوش مصنوعی پیشرفته ساختید! شما با یک برنامه ساده شروع کردید، از رابط خط فرمان Antigravity برای ایجاد یک عامل استفاده کردید، به آن شخصیت غنی بخشیدید و آن را با ابزارهایی برای دسترسی به اطلاعات در لحظه و حتی تولید آواتار خود توانمند ساختید. اکنون آماده‌اید تا عامل‌های هوش مصنوعی پیچیده‌تر و توانمندتری بسازید.

👉💻 برای جمع‌بندی و بستن جلسه، به ترمینال خود برگردید و با تایپ کردن /exit در اعلان agy از Antigravity CLI خارج شوید: 

/exit