Korzystanie z trybu agenta Gemini Code Assist

VS Code

1. Aby otworzyć czat Gemini Code Assist, na pasku działań IDE kliknij spark Gemini Code Assist.
2. Kliknij przełącznik Agent, aby przejść do trybu agenta. Przełącznik jest podświetlony, gdy jest włączony tryb agenta, a szary, gdy jest włączony zwykły czat.
3. Na czacie Gemini Code Assist wpisz prompta.

Gemini odpowiada na Twój prompt lub prosi o pozwolenie na użycie narzędzia.

Aby zatrzymać agenta, kliknij stopZatrzymaj.

Aby użyć standardowego czatu Gemini Code Assist, kliknij addNowy czat, aby utworzyć nowy czat.

IntelliJ

1. Na pasku okna narzędzi kliknij spark Gemini. Może być konieczne zalogowanie się.
2. Kliknij kartę Agent.
3. Opisz zadanie, które ma wykonać agent.

4. Gdy agent będzie wykonywać kolejne czynności, aby zrealizować zadanie, będziesz mieć możliwość sprawdzenia i zatwierdzenia wszystkich zmian.

5. Opcjonalnie: aby automatycznie zatwierdzać zmiany, kliknij Ustawienia Opcje agenta i zaznacz pole wyboru obok opcji Automatycznie zatwierdzaj zmiany.

VS Code

Za pomocą ustawień coreTools i excludeTools możesz określić, do których narzędzi Gemini ma dostęp w trybie agenta.

coreTools

Umożliwia określenie listy narzędzi, które mają być dostępne dla modelu. Możesz też określić ograniczenia dotyczące konkretnych poleceń w przypadku narzędzi, które to obsługują. Na przykład dodanie do pliku JSON ustawień Gemini tego fragmentu kodu spowoduje, że będzie można wykonywać tylko polecenie ls -l"coreTools": ["ShellTool(ls -l)"].

excludeTools

Umożliwia określenie listy narzędzi, które nie mają być dostępne dla modelu. Możesz też określić ograniczenia dotyczące konkretnych poleceń w przypadku narzędzi, które to obsługują. Na przykład dodanie do pliku JSON ustawień Gemini tego kodu zablokuje użycie polecenia rm -rf:"excludeTools": ["ShellTool(rm -rf)"]

Narzędzie wymienione zarówno w sekcji excludeTools, jak i coreTools jest wykluczone.

Aby skonfigurować wbudowane narzędzia dostępne w trybie agenta:

1. Otwórz plik JSON z ustawieniami Gemini, który znajduje się w katalogu ~/.gemini/settings.json, gdzie ~ to katalog domowy.

2. Aby ograniczyć korzystanie z narzędzi agenta do listy zatwierdzonych narzędzi, dodaj do pliku JSON ustawień Gemini ten wiersz:

   "coreTools": ["TOOL_NAME_1,TOOL_NAME_2"]
   

   Zastąp TOOL_NAME_1 i TOOL_NAME_2 nazwami wbudowanych narzędzi, do których agent ma mieć dostęp.

   Możesz wymienić dowolną liczbę wbudowanych narzędzi. Domyślnie wszystkie wbudowane narzędzia są dostępne dla agenta.

3. Aby ograniczyć korzystanie z narzędzi agenta do określonych poleceń, dodaj do pliku JSON z ustawieniami Gemini ten wiersz:

   "coreTools": ["TOOL_NAME(COMMAND)"]
   

   Zastąp następujące elementy:

   • TOOL_NAME: nazwa wbudowanego narzędzia
   • COMMAND: nazwa wbudowanego polecenia narzędzia, z którego agent ma korzystać.

4. Aby wykluczyć narzędzie z użycia przez agenta, dodaj ten wiersz do pliku JSON ustawień Gemini:

   "excludeTools": ["TOOL_NAME_1,TOOL_NAME_2"]
   

   Zastąp TOOL_NAME_1 i TOOL_NAME_2 nazwami wbudowanych narzędzi, które chcesz wykluczyć z użycia przez agenta.

5. Aby wykluczyć polecenie narzędzia z użycia przez agenta, dodaj do pliku JSON ustawień Gemini ten wiersz:

   "excludeTools": ["TOOL_NAME(COMMAND)"]
   

   Zastąp następujące elementy:

   • TOOL_NAME: nazwa wbudowanego narzędzia
   • COMMAND: nazwa wbudowanego polecenia narzędzia, które chcesz wykluczyć z użycia przez agenta.

Więcej informacji o ustawieniach konfiguracji coreTools i excludeTools znajdziesz w dokumentacji konfiguracji interfejsu wiersza poleceń Gemini.

IntelliJ

Ta funkcja nie jest obsługiwana w Gemini Code Assist w IntelliJ ani w innych środowiskach IDE JetBrains.

VS Code

Aby udostępnić serwery MCP do użycia w trybie agenta, dodaj konfigurację każdego serwera w pliku JSON ustawień Gemini zgodnie z dokumentacją każdego serwera.

1. Zainstaluj wszystkie zależności wymagane przez dodawane serwery MCP.
2. Otwórz plik JSON z ustawieniami Gemini, który znajduje się w lokalizacji ~/.gemini/settings.json, gdzie ~ to Twój katalog domowy.

3. Skonfiguruj każdy lokalny lub zdalny serwer MCP w pliku JSON ustawień Gemini zgodnie z instrukcjami dotyczącymi każdego serwera.

   Poniższy przykładowy plik JSON z ustawieniami Gemini konfiguruje 2 zdalne serwery MCP Cloudflare, zdalny serwer MCP GitLab i lokalny serwer MCP GitHub do używania z Gemini Code Assist w VS Code.

   {
     "mcpServers": {
       "github": {
         "command": "npx",
         "args": ["-y", "@modelcontextprotocol/server-github"],
         "env": {
           "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_example_personal_access_token12345"
         }
       },
       "gitlab": {
         "command": "npx",
         "args": ["mcp-remote", "https://your-gitlab-instance.com/api/v4/mcp"]
       },
       "cloudflare-observability": {
         "command": "npx",
         "args": ["mcp-remote", "https://observability.mcp.cloudflare.com/sse"]
       },
       "cloudflare-bindings": {
         "command": "npx",
         "args": ["mcp-remote", "https://bindings.mcp.cloudflare.com/sse"]
       }
     }
   }
   

4. Otwórz paletę poleceń i wybierz Developer: Reload Window (Deweloper: przeładuj okno).

Skonfigurowane serwery MCP są dostępne dla agenta w trybie agenta.

IntelliJ

Aby udostępnić serwery MCP do użycia w trybie agenta, dodaj konfigurację każdego serwera w pliku mcp.json i umieść ten plik w katalogu konfiguracji IDE.mcp.json

1. Zainstaluj wszystkie zależności wymagane przez dodawane serwery MCP.
2. Utwórz plik o nazwie mcp.json w katalogu konfiguracji IDE.

3. Skonfiguruj każdy lokalny lub zdalny serwer MCP w pliku mcp.json zgodnie z instrukcjami dotyczącymi poszczególnych serwerów.

   Poniższy przykład pliku mcp.json konfiguruje 2 zdalne serwery MCP Cloudflare, zdalny serwer MCP GitLab i lokalny serwer MCP GitHub do używania z Gemini Code Assist w IntelliJ.

   {
     "mcpServers": {
       "github": {
         "command": "npx",
         "args": ["-y", "@modelcontextprotocol/server-github"],
         "env": {
           "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_example_personal_access_token12345"
         }
       },
       "gitlab": {
         "command": "npx",
         "args": ["mcp-remote", "https://your-gitlab-instance.com/api/v4/mcp"]
       },
       "cloudflare-observability": {
         "command": "npx",
         "args": ["mcp-remote", "https://observability.mcp.cloudflare.com/sse"]
       },
       "cloudflare-bindings": {
         "command": "npx",
         "args": ["mcp-remote", "https://bindings.mcp.cloudflare.com/sse"]
       }
     }
   }
   

Skonfigurowane serwery MCP są dostępne dla agenta w trybie agenta.

VS Code

Serwery MCP, które wymagają uwierzytelniania, możesz dodać do pliku JSON z ustawieniami Gemini.

Poniższy przykład pokazuje, jak określić osobisty token dostępu dla lokalnych i zdalnych serwerów MCP GitHub:

{
  "mcpServers": {
    "github-remote": {
      "httpUrl": "https://api.githubcopilot.com/mcp/",
      "headers": {
        "Authorization": "Bearer ACCESS_TOKEN"
      }
    },
    "github-local": {
      "command": "/Users/username/code/github-mcp-server/cmd/github-mcp-server/github-mcp-server",
      "args": ["stdio"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ACCESS_TOKEN"
      }
    }
  }
}

gdzie ACCESS_TOKEN to token dostępu użytkownika.

IntelliJ

Serwery MCP, które wymagają uwierzytelniania, możesz dodać do pliku mcp.json.

W tym przykładzie dodajemy osobisty token dostępu do serwera lokalnego GitHub:

{
  "mcpServers": {
    "github-local": {
      "command": "/Users/username/code/github-mcp-server/cmd/github-mcp-server/github-mcp-server",
      "args": ["stdio"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ACCESS_TOKEN"
      }
    }
  }
}

gdzie ACCESS_TOKEN to token dostępu użytkownika.

VS Code

1. Utwórz plik o nazwie GEMINI.md w lokalizacji, która odpowiada zakresowi, w jakim ma być stosowany kontekst. W tabeli poniżej znajdziesz szczegółowe informacje o lokalizacjach plików kontekstu w przypadku różnych zakresów:

   Zakres	Lokalizacja
   Wszystkie Twoje projekty	~/.gemini/GEMINI.md
   określonego projektu,	Katalog roboczy lub dowolny katalog nadrzędny aż do katalogu głównego projektu (oznaczonego folderem .git) lub katalogu domowego.
   Konkretny komponent, moduł lub podsekcja projektu	Podkatalogi katalogu roboczego.

   System pamięci agenta jest tworzony przez wczytywanie plików kontekstu z wielu lokalizacji. Kontekst z bardziej szczegółowych plików, np. dotyczących konkretnych komponentów lub modułów, zastępuje lub uzupełnia treści z bardziej ogólnych plików kontekstu, takich jak globalny plik kontekstu w ~/.gemini/GEMINI.md.

2. Napisz w Markdownie wszystkie reguły, informacje z przewodnika po stylu lub kontekst, których ma używać agent, i zapisz plik. Więcej informacji znajdziesz w przykładowym pliku kontekstu w GitHubie.

Agent uwzględnia informacje z pliku kontekstu wraz z promptami, które do niego wysyłasz.

IntelliJ

1. Utwórz w katalogu głównym projektu plik o nazwie GEMINI.md lub AGENT.md.

2. Napisz w Markdownie wszystkie reguły, informacje z przewodnika po stylu lub kontekst, których ma używać agent, i zapisz plik.

Agent uwzględnia informacje z pliku kontekstu wraz z promptami, które do niego wysyłasz. Możesz też dodać kontekst, ręcznie dołączając plik za pomocą składni @FILENAME, gdzie FILENAME to nazwa pliku z informacjami kontekstowymi, które chcesz uwzględnić.

VS Code

W trybie agenta możesz używać tych wbudowanych poleceń interfejsu wiersza poleceń Gemini:

• /tools: wyświetla listę narzędzi dostępnych w sesji trybu agenta.
• /mcp: wyświetla skonfigurowane serwery Model Context Protocol (MCP), ich stan połączenia, szczegóły serwera i dostępne narzędzia.

Więcej informacji o poleceniach interfejsu wiersza poleceń Gemini znajdziesz w artykułach Polecenia interfejsu wiersza poleceń Gemini i Niestandardowe polecenia Gemini. Pamiętaj, że w trybie agenta nie są dostępne wszystkie polecenia interfejsu wiersza poleceń Gemini.

IntelliJ

Ta funkcja nie jest obsługiwana w Gemini Code Assist w IntelliJ ani w innych środowiskach IDE JetBrains.

VS Code

Użyj trybu YOLO, aby automatycznie zezwalać na wszystkie działania agenta. Tryb Yolo można stosować tylko w zaufanym obszarze roboczym.

Aby skonfigurować tryb YOLO:

1. Otwórz plik JSON z ustawieniami użytkownika VS Code:

   1. Otwórz paletę poleceń (ctrl/command + Shift + P).
   2. Wybierz Ustawienia: otwórz ustawienia użytkownika (JSON).

2. Dodaj do pliku JSON ustawień użytkownika VS Code ten kod:

   //other settings...
   
   "geminicodeassist.agentYoloMode": true,
   //other settings...
   

3. Otwórz paletę poleceń i wybierz Developer: Reload Window (Deweloper: przeładuj okno).

Tryb agenta korzysta z trybu yolo i nie prosi o zezwolenie przed podjęciem działań, gdy wyślesz mu prompt. Gdy agent korzysta z ograniczonego obszaru roboczego, przed podjęciem działań wyświetla prośbę o potwierdzenie niezależnie od tego ustawienia.

IntelliJ

Aby automatycznie zatwierdzać zmiany, na karcie agenta Gemini Chat kliknij Ustawienia Opcje agenta, a następnie zaznacz pole wyboru obok opcji Automatyczne zatwierdzanie zmian.

Tryb agenta automatycznie zatwierdza wszystkie prośby i nie prosi o pozwolenie przed podjęciem działań, gdy wyślesz mu prompt.