Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Podaj Gemini w Android Studio niestandardowe instrukcje, których ma przestrzegać, używając co najmniej 1 AGENT.mdpliku. Pliki AGENT.md są umieszczane obok innych plików w bazie kodu, więc można je łatwo zarejestrować w systemie kontroli wersji (VCS) i udostępnić całemu zespołowi instrukcje dotyczące projektu, reguły stylu kodowania i inne wskazówki.
Aby zacząć go używać, wykonaj te czynności:
Utwórz plik AGENT.md w dowolnym miejscu w systemie plików projektu. Gdy przesyłasz zapytanie, Gemini skanuje bieżący katalog i wszystkie katalogi nadrzędne w poszukiwaniu plików AGENT.md. Więcej informacji znajdziesz w artykule Jak działają pliki AGENT.md.
Dodaj instrukcje. Napisz instrukcje w języku Markdown. Aby zwiększyć czytelność, używaj nagłówków i wypunktowań dla różnych reguł.
Zobacz przykładowe instrukcje
Zapisz i zatwierdź plik w systemie kontroli wersji, aby udostępnić go zespołowi.
Zarządzanie plikami AGENT.md jako kontekstem
Możesz zastosować lub usunąć pliki AGENT.md jako kontekst dla konkretnego zapytania, korzystając z panelu Kontekst w oknie czatu. Opcje AGENT.mdPliki obejmują wszystkie AGENT.mdpliki w bieżącym katalogu i jego katalogach nadrzędnych.
Rysunek 1. zarządzać plikami AGENT.md jako kontekstem;
Przykładowe instrukcje
Za pomocą pliku AGENT.md możesz przekazać agentowi instrukcje. Poniżej znajdziesz kilka przykładów, ale podane przez Ciebie instrukcje powinny być dostosowane do Twojego projektu.
„Główna aktywność to /path/to/MainActivity.kt”.
„Kod umożliwiający przechodzenie między ekranami to:
path/to/navigation/UiNavigation.kt”
„Kod obsługujący żądania HTTP znajduje się w lokalizacji <path>”.
Architektura projektu
„Całą logikę biznesową umieszczaj w klasach ViewModel”.
„Zawsze postępuj zgodnie z oficjalnymi zaleceniami dotyczącymi architektury, w tym z zaleceniami dotyczącymi stosowania architektury warstwowej. Używaj jednokierunkowego przepływu danych (UDF), ViewModeli, zbierania stanu interfejsu użytkownika uwzględniającego cykl życia i innych zaleceń”.
Preferowane biblioteki: „Używaj biblioteki <nazwa biblioteki> do nawigacji”.
Określanie nazw zastępczych dla popularnych usług API lub terminologii wewnętrznej: „Podstawowa usługa backendu jest nazywana „PhotoSift-API””.
Przewodniki po stylu firmy: „Wszystkie nowe komponenty interfejsu muszą być tworzone za pomocą Jetpack Compose. Nie proponuj układów opartych na XML-u”.
Podziel pliki AGENT.md na moduły
Duże pliki AGENT.md możesz podzielić na mniejsze, które można ponownie wykorzystać w różnych kontekstach:
wydzielić zestaw instrukcji i zapisać go w innym pliku Markdown, np. style-guidance.md;
Odwołuj się do mniejszych plików Markdown w pliku AGENT.md, używając symbolu @
i ścieżki do pliku, który chcesz zaimportować. Obsługiwane są te formaty ścieżek:
Ścieżki względne:
@./file.md – importowanie z tego samego katalogu
@../file.md – importowanie z katalogu nadrzędnego
@./subdirectory/file.md – importowanie z podkatalogu;
Ścieżki bezwzględne: @/absolute/path/to/file.md
Na przykład ten plik AGENT.md odwołuje się do 2 innych plików z instrukcjami:
# My AGENT.md
You are an experienced Android app developer.
@./get-started.md
## Coding style
@./shared/style-guidance.md
Jak działają pliki AGENT.md
Gemini automatycznie skanuje bieżący katalog i katalogi nadrzędne w poszukiwaniu plików AGENT.md i dodaje ich zawartość na początku każdego prompta jako wstęp. Jeśli w momencie przesyłania zapytania nie masz otwartego pliku, domyślnie uwzględniany jest AGENT.mdplik w katalogu głównym projektu (jeśli taki istnieje).
Czym różnią się pliki AGENT.md od reguł?
Reguły umożliwiają też określanie instrukcji i preferencji, które mają zastosowanie do wszystkich promptów. Reguły są jednak zdefiniowane w pliku IntelliJ/.idea/project.prompts.xml, a pliki AGENT.md są zapisywane obok kodu źródłowego i nie są powiązane z żadnym konkretnym środowiskiem IDE. Jeśli jednym z głównych celów jest udostępnienie instrukcji zespołowi, zalecamy używanie plików AGENT.md.
Treść strony i umieszczone na niej fragmenty kodu podlegają licencjom opisanym w Licencji na treści. Java i OpenJDK są znakami towarowymi lub zastrzeżonymi znakami towarowymi należącymi do firmy Oracle lub jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2025-08-22 UTC.
[[["Łatwo zrozumieć","easyToUnderstand","thumb-up"],["Rozwiązało to mój problem","solvedMyProblem","thumb-up"],["Inne","otherUp","thumb-up"]],[["Brak potrzebnych mi informacji","missingTheInformationINeed","thumb-down"],["Zbyt skomplikowane / zbyt wiele czynności do wykonania","tooComplicatedTooManySteps","thumb-down"],["Nieaktualne treści","outOfDate","thumb-down"],["Problem z tłumaczeniem","translationIssue","thumb-down"],["Problem z przykładami/kodem","samplesCodeIssue","thumb-down"],["Inne","otherDown","thumb-down"]],["Ostatnia aktualizacja: 2025-08-22 UTC."],[],[],null,["# Customize Gemini using AGENT.md files\n\nGive Gemini in Android Studio customized instructions to follow using one or\nmore `AGENT.md` files. `AGENT.md` files are placed alongside the other files in\nyour codebase, so it's straightforward to check them in to your version control\nsystem (VCS) and share project-specific instructions, coding style rules, and\nother guidance with your entire team.\n\nTo get started, follow these steps:\n\n1. Create an `AGENT.md` file anywhere in your project's file system. Gemini\n scans the current directory and all parent directories for `AGENT.md` files when\n you submit a query. For more details, see [How `AGENT.md` files work](#how-agent-files-work).\n\n | **Tip:** Use multiple instruction files across different directories for more granular control over different parts of your codebase. For example, you can have a global `AGENT.md` file at the project root and more specific `AGENT.md` files in subdirectories for different modules.\n2. Add your instructions. Write your instructions using Markdown. For\n readability, consider using headings and bullet points for different rules.\n [See example instructions](#example-instructions).\n\n3. Save and commit the file to your VCS to share it with your team.\n\nManage `AGENT.md` files as context\n----------------------------------\n\nYou can apply or remove `AGENT.md` files as context for a particular query\nusing the **Context** drawer in the chat panel. The **`AGENT.md` Files** options\nincludes all `AGENT.md` files in the current directory and its parent\ndirectories.\n**Figure 1.** Manage `AGENT.md` files as context.\n\nExample instructions\n--------------------\n\nYou can use the `AGENT.md` file to give instructions to the agent. The following\nare some examples, but the instructions that you provide should be specific to\nyour project.\n\n- \"The main activity is `/path/to/MainActivity.kt`.\"\n- \"The code to support navigating between screens is `path/to/navigation/UiNavigation.kt`\"\n- \"The code handling HTTP requests is at `\u003cpath\u003e`.\"\n- Project architecture\n - \"Place all business logic in ViewModels.\"\n - \"Always follow official architecture recommendations, including use of a layered architecture. Use a unidirectional data flow (UDF), ViewModels, lifecycle-aware UI state collection, and other recommendations.\"\n- Preferred libraries: \"Use the \\\u003clibrary name\\\u003e library for navigation.\"\n- Defining placeholder names for common API services or internal terminology: \"The primary backend service is referred to as 'PhotoSift-API'.\"\n- Company style guides: \"All new UI components must be built with Jetpack Compose. Don't suggest XML-based layouts.\"\n\nModularize your `AGENT.md` files\n--------------------------------\n\nYou can break down large `AGENT.md` files into smaller files that can be reused\nin different contexts:\n\n1. Separate out a set of instructions and save them in another Markdown file,\n such as `style-guidance.md`.\n\n2. Reference the smaller Markdown files in an `AGENT.md` file by using the `@`\n symbol followed by the path to the file you want to import. The following path\n formats are supported:\n\n - Relative paths:\n - `@./file.md` - Import from the same directory\n - `@../file.md` - Import from the parent directory\n - `@./subdirectory/file.md` - Import from a subdirectory\n - Absolute paths: `@/absolute/path/to/file.md`\n\nFor example, the following `AGENT.md` file references two other instruction\nfiles: \n\n # My AGENT.md\n\n You are an experienced Android app developer.\n\n @./get-started.md\n\n ## Coding style\n\n @./shared/style-guidance.md\n\nHow `AGENT.md` files work\n-------------------------\n\nGemini automatically scans the current directory and parent directories for\n`AGENT.md` files and adds their content to the beginning of every prompt as a\npreamble. If you don't have a file open when you submit a query, then the\n`AGENT.md` file at the project root (if there is one) is included by default.\n| **Note:** If you have a `GEMINI.md` file and `AGENT.md` file in the same directory, the `GEMINI.md` file takes precedence.\n\nWhat's the difference between `AGENT.md` files and Rules?\n---------------------------------------------------------\n\n[Rules](/studio/gemini/rules) also let you define instructions and preferences\nthat apply to all prompts. However, rules are defined in the IntelliJ file\n`/.idea/project.prompts.xml`, whereas `AGENT.md` files are saved next to your\nsource code and are IDE-neutral. We recommend using `AGENT.md` files if one of\nthe primary purposes is to share the instructions with your team.\n| **Note:** Gemini combines rules and instructions in `AGENT.md` files when processing your query."]]
