با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
Gemini در Android Studio's Agent Mode برای انجام وظایف توسعه پیچیده و چند مرحله ای طراحی شده است که فراتر از آن چیزی است که فقط با چت با Gemini می توانید تجربه کنید. میتوانید یک هدف سطح بالا را توصیف کنید، و عامل یک طرح ایجاد و اجرا میکند، ابزارهای لازم را فراخوانی میکند، تغییراتی را در چندین فایل ایجاد میکند و به طور مکرر باگها را برطرف میکند. این گردش کار با کمک عامل به شما امکان می دهد با چالش های پیچیده مقابله کنید و روند توسعه خود را تسریع کنید.
شکل 1: Gemini در حالت عامل اندروید استودیو.
شروع کنید
برای شروع به کار در Agent Mode در Android Studio، مراحل زیر را دنبال کنید:
روی Gemini کلیک کنید در نوار پنجره ابزار در صورت نیاز وارد سیستم شوید و وارد شوید.
تب Agent را انتخاب کنید.
وظیفه ای را که می خواهید نماینده انجام دهد را شرح دهید.
در حالی که عامل برای انجام وظیفه کار می کند، هرگونه تغییر را بررسی و تأیید کنید.
شکل 2: حالت عامل منتظر می ماند تا شما یک تغییر را بپذیرید یا رد کنید.
اختیاری: برای تأیید خودکار تغییرات، گزینههای عامل را انتخاب کنید > تأیید خودکار تغییرات
شکل 3: تأیید خودکار تغییرات پیشنهاد شده توسط نماینده.
موارد استفاده کنید
در اینجا چند نمونه از موارد استفاده وجود دارد که نماینده می تواند در مورد آنها به شما کمک کند:
رفع خطاهای ساخت وقتی از عامل میخواهید با استفاده از اعلانی مانند «اصلاح خطاهای ساخت در پروژه من»، یک خطای ساخت را برطرف کند، یک اصلاح توصیهشده را اعمال میکند، پروژه را برای تأیید راهحل میسازد و تا زمانی که مشکل برطرف شود، تکرار میکند.
شکل 4: عامل پروژه شما را می سازد و در صورت وجود خطا ارزیابی می کند.
عناصر UI را اضافه یا به روز کنید. عامل می تواند عناصر UI را اضافه یا به روز کند. به عنوان مثال، از عامل بخواهید که "موضوع تیره را به صورت پیش فرض در تنظیمات برگزیده کاربر قرار دهید" و فایل های مربوطه را جستجو می کند و تغییراتی را برای انجام کار پیشنهاد می کند. میتوانید بلافاصله پیشنمایش بهروزرسانیهای رابط کاربری را در پنجره ابزارهای در حال اجرا مشاهده کنید.
شکل 5: عاملی که عناصر رابط کاربری را به روز می کند.
داده های ساختگی تولید کنید. هنگام نمونهسازی و آزمایش برنامهتان، میتوانید از نماینده بخواهید به جای ایجاد دستی، دادههای ساختگی تولید کند. برای مثال، وقتی از شما خواسته میشود «دو جلسه دیگر به دادههای جعلی اضافه کنید»، عامل فایل مربوطه را پیدا کرده و دو رویداد دیگر را به فهرست mockSessions اضافه میکند.
شکل 6: عاملی که داده های ساختگی تولید می کند.
چند دستور دیگر برای امتحان:
"نوشتن تست های واحد برای <class> در <module>"
"ایجاد اسناد برای فایل باز"
"عنوان برنامه را از <نام فعلی> به <نام جدید> تغییر دهید"
"حل استثنای اشاره گر تهی"
"کد من را با انتقال <composable name> composable به یک فایل جدید اصلاح کنید. بررسی کنید که همه واردها به روز شده باشند"
"یک دکمه جدید به صفحه اصلی برنامه به نام "دنبال کردن" اضافه کنید که شما را به لیستی از موضوعات می برد."
"در composable <composable name>، padding modifier <modifier name> را کاهش دهید"
"ایجاد دکمه اشتراک گذاری برای اشتراک گذاری در رسانه های اجتماعی"
نحوه کار نماینده
در حالت عامل، درخواست شما به همراه فهرستی از ابزارهای موجود به Gemini API ارسال میشود. میتوانید ابزارها را بهعنوان مهارت در نظر بگیرید: این ابزارها شامل توانایی جستجوی فایلها، خواندن فایلها، جستجوی متن درون فایلها، استفاده از هر سرور MCP که پیکربندی کردهاید و موارد دیگر است.
هنگامی که به عامل وظیفه ای می دهید، برنامه ای ایجاد می کند و تعیین می کند که کدام ابزار مورد نیاز است. برخی از این ابزارها ممکن است به شما نیاز داشته باشند تا قبل از اینکه نماینده بتواند از آنها استفاده کند، مجوز بدهید. پس از اعطای مجوز، عامل از ابزار برای انجام اقدامات لازم استفاده می کند و نتیجه را به API Gemini ارسال می کند. جمینی نتیجه عمل را پردازش می کند و پاسخ دیگری ایجاد می کند. این چرخه عمل و ارزیابی تا تکمیل کار ادامه می یابد.
محتوا و نمونه کدها در این صفحه مشمول پروانههای توصیفشده در پروانه محتوا هستند. جاوا و OpenJDK علامتهای تجاری یا علامتهای تجاری ثبتشده Oracle و/یا وابستههای آن هستند.
تاریخ آخرین بهروزرسانی 2025-09-03 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","easyToUnderstand","thumb-up"],["مشکلم را برطرف کرد","solvedMyProblem","thumb-up"],["غیره","otherUp","thumb-up"]],[["اطلاعاتی که نیاز دارم وجود ندارد","missingTheInformationINeed","thumb-down"],["بیشازحد پیچیده/ مراحل بسیار زیاد","tooComplicatedTooManySteps","thumb-down"],["قدیمی","outOfDate","thumb-down"],["مشکل ترجمه","translationIssue","thumb-down"],["مشکل کد / نمونهها","samplesCodeIssue","thumb-down"],["غیره","otherDown","thumb-down"]],["تاریخ آخرین بهروزرسانی 2025-09-03 بهوقت ساعت هماهنگ جهانی."],[],[],null,["Gemini in Android Studio's Agent Mode is designed to handle complex, multi-stage\ndevelopment tasks that go beyond what you can experience by just chatting with\nGemini. You can describe a high-level goal, and the agent creates and\nexecutes a plan, invoking the necessary [tools](#how-it-works), making changes\nacross multiple files, and iteratively fixing bugs. This agent-assisted workflow\nlets you tackle intricate challenges, accelerating your development\nprocess.\n**Figure 1:** Gemini in Android Studio's Agent Mode.\n\nGet started\n\nTo get started in Agent Mode in Android Studio, follow these steps:\n\n1. Click **Gemini** in the tool window bar. Sign in and onboard if you need to.\n2. Select the **Agent** tab.\n3. Describe the task you want the agent to perform.\n4. Review and approve any changes as the agent works to accomplish the task.\n\n**Figure 2:** Agent Mode waits for you to accept or reject a change.\n\n1. Optional: To automatically approve changes, select **Agent options\n \\\u003e Auto-approve changes**.\n\n**Figure 3:** Auto-approve changes suggested by the agent.\n\nUse cases\n\nHere are some examples of use cases that the agent can help you with:\n\n- **Fix build errors.** When you ask the agent to fix a build error using a prompt like \"Fix build errors in my project,\" it applies a recommended fix, builds the project to verify the solution, and iterates until the issue is resolved.\n\n**Figure 4:** The agent builds your project and assesses if there are errors.\n\n- **Add or update UI elements.** The agent can add or update UI elements. For example, ask the agent to \"Make dark theme the default in user preferences\" and it searches for the relevant files and suggests changes to accomplish the task. You can immediately preview the UI updates in the **Running devices** tool window.\n\n**Figure 5:** The agent updating UI elements.\n\n- **Generate mock data.** When prototyping and testing your app, you can ask the agent to generate mock data instead of manually creating it. For example, when prompted to \"Add two more sessions to the fake data,\" the agent finds the relevant file and adds two more events to the `mockSessions` list.\n\n**Figure 6:** The agent generating mock data.\n\nSome other prompts to try:\n\n- \"Write unit tests for \\\u003cclass\\\u003e in \\\u003cmodule\\\u003e\"\n- \"Generate documentation for the open file\"\n- \"Change the app title from \\\u003ccurrent name\\\u003e to \\\u003cnew name\\\u003e\"\n- \"Resolve the null pointer exception\"\n- \"Refactor my code by moving the \\\u003ccomposable name\\\u003e composable to a new file. Verify that all imports are updated\"\n- \"Add a new button to the app's home screen called 'Follow' that takes you to a list of topics\"\n- \"In the \\\u003ccomposable name\\\u003e composable, reduce the padding of the \\\u003cmodifier name\\\u003e modifier\"\n- \"Create a share button to share to social media\"\n\nHow the agent works\n\nIn Agent Mode, your prompt is sent to the Gemini API with a list of *tools* that\nare available. You can think of tools as skills: they include the ability to\nsearch for files, read files, search the text within files, use any\n[MCP servers](/studio/gemini/add-mcp-server) you have configured, and more.\n\nWhen you give the agent a task, it creates a plan and determines which\ntools are needed. Some of these tools might need you to grant permission before\nthe agent can use them. Once you grant permission, the agent uses the tool to\nperform the necessary action and sends the result back to the Gemini API. Gemini\nprocesses the result of the action and generates another response. This cycle of\naction and evaluation continues until the task is complete."]]