Dostosowywanie Gemini za pomocą plików AGENTS.md

Przekaż Gemini w Android Studio dostosowane instrukcje, których ma przestrzegać, używając co najmniej 1 AGENTS.mdpliku. Pliki AGENTS.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:

1. Utwórz plik AGENTS.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 AGENTS.md. Więcej informacji znajdziesz w artykule Jak działają pliki AGENTS.md.

2. 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

3. Zapisz i zatwierdź plik w systemie kontroli wersji, aby udostępnić go zespołowi.

Zarządzanie plikami AGENTS.md jako kontekstem

Możesz zastosować lub usunąć pliki AGENTS.md jako kontekst dla konkretnego zapytania, korzystając z panelu Kontekst w oknie czatu. Opcje AGENTS.mdPliki obejmują wszystkie AGENTS.mdpliki w bieżącym katalogu i jego katalogach nadrzędnych.

.

Przykładowe instrukcje

Za pomocą pliku AGENTS.md możesz przekazywać 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
  • „Umieść całą logikę biznesową 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), obiektów ViewModel, zbierania stanu interfejsu z uwzględnieniem cyklu ż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 AGENTS.md na moduły

Możesz podzielić duże pliki AGENTS.md na mniejsze, które można ponownie wykorzystać w różnych kontekstach:

1. Wydziel zestaw instrukcji i zapisz go w innym pliku Markdown, np. style-guidance.md.

2. Odwołuj się do mniejszych plików Markdown w pliku AGENTS.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 AGENTS.md odwołuje się do 2 innych plików z instrukcjami:

# My AGENTS.md

You are an experienced Android app developer.

@./get-started.md

## Coding style

@./shared/style-guidance.md

Jak działają pliki AGENTS.md

Gemini automatycznie skanuje bieżący katalog i katalogi nadrzędne w poszukiwaniu plików AGENTS.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 AGENTS.mdplik w katalogu głównym projektu (jeśli taki istnieje).

Czym różnią się pliki AGENTS.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 AGENTS.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 AGENTS.md.

Czym różnią się pliki AGENTS.md od umiejętności?

Umiejętności to wiedza specjalistyczna na żądanie, która jest wywoływana, gdy Twoje żądanie pasuje do opisu umiejętności, a treść w AGENTS.md jest dodawana na początku każdego promptu. Zalecamy używanie umiejętności do wykonywania konkretnych zadań i plików AGENTS.md, aby wpływać na ogólne zachowanie agenta. Więcej informacji o umiejętnościach znajdziesz w artykule Wprowadzenie do umiejętności na Androidzie.