Używanie czatu z agentem jako programisty pracującego w parze

VS Code

1. Skonfiguruj wersję Gemini Code Assist, której chcesz używać w IDE:
   • Gemini Code Assist dla użytkowników indywidualnych
   • Gemini Code Assist Standard lub Enterprise

IntelliJ

Skonfiguruj wersję Gemini Code Assist, której chcesz używać w IDE:

• Gemini Code Assist dla użytkowników indywidualnych
• Gemini Code Assist Standard lub Enterprise

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 wyróżniony, gdy jest włączony tryb agenta, a szary, gdy jest włączony zwykły czat.
3. Wpisz prompta na czacie Gemini Code Assist.

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.

Tryb agenta Gemini Code Assist jest obsługiwany przez interfejs wiersza poleceń Gemini.

IntelliJ

1. Na pasku okna narzędzi kliknij spark Gemini. W razie potrzeby zaloguj się.
2. Kliknij kartę Agent.
3. Opisz zadanie, które ma wykonać agent.

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

5. Opcjonalnie: aby automatycznie zatwierdzać zmiany, wybierz 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 je obsługują. Na przykład dodanie do pliku JSON ustawień Gemini tego kodu spowoduje, że będzie można wykonać 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 je 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, wykonaj te czynności:

1. Otwórz plik JSON z ustawieniami Gemini, który znajduje się w katalogu ~/.gemini/settings.json, gdzie ~ to Twój 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 ustawień 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órych nie chcesz udostępniać agentowi.

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 przypadku Gemini Code Assist w IntelliJ ani innych środowisk IDE JetBrains.

VS Code

Aby określić, które serwery są dostępne w trybie agenta, dodaj je do pliku JSON ustawień Gemini zgodnie z dokumentacją serwera.

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

3. Dodaj lokalne lub zdalne serwery MCP do pliku JSON ustawień Gemini zgodnie z instrukcjami serwera.

   W tym przykładzie dodajemy 2 zdalne serwery Cloudflare MCP i instalujemy serwery GitHub i GitLab na komputerze lokalnym.

   {
     "mcpServers": {
       "github": {
         "command": "npx",
         "args": ["-y", "@modelcontextprotocol/server-github"],
         "env": {
           "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_example_personal_access_token12345"
         }
       },
       "gitlab": {
         "command": "npx",
         "args": ["-y", "@modelcontextprotocol/server-gitlab"]
       },
       "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 kliknij Developer: Reload Window (Deweloper: ponownie załaduj okno).

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

IntelliJ

Aby określić, które serwery są dostępne w trybie agenta, dodaj je do mcp.jsonpliku i umieść go w katalogu konfiguracji IDE.

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

3. Dodaj lokalne lub zdalne serwery MCP do pliku JSON ustawień Gemini zgodnie z instrukcjami serwera.

   W tym przykładzie dodajemy zdalny serwer Cloudflare MCP i instalujemy serwery GitHub i GitLab na komputerze lokalnym.

   {
     "mcpServers": {
       "github": {
         "command": "npx",
         "args": ["-y", "@modelcontextprotocol/server-github"],
         "env": {
           "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_example_personal_access_token12345"
         }
       },
       "gitlab": {
         "command": "npx",
         "args": ["-y", "@modelcontextprotocol/server-gitlab"]
       },
       "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

W przypadku serwerów MCP, które wymagają uwierzytelniania, możesz dodać je do pliku JSON ustawień 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 dowolne katalogi nadrzędne 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. plików dotyczących konkretnych komponentów lub modułów, zastępuje lub uzupełnia treść z bardziej ogólnych plików kontekstu, np. globalnego pliku 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 na 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 poleceń interfejsu Gemini CLI:

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

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

IntelliJ

Ta funkcja nie jest obsługiwana w przypadku Gemini Code Assist w IntelliJ ani innych środowisk 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 kliknij Developer: Reload Window (Deweloper: ponownie załaduj okno).

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

IntelliJ

Aby automatycznie zatwierdzać zmiany, na karcie agenta Gemini Chat wybierz 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.