В этом документе описывается режим работы агента в Gemini Code Assist.
Режим агента доступен в интегрированных средах разработки (IDE) VS Code и IntelliJ. Чтобы начать использовать режим агента, см. раздел «Использование режима агента Gemini Code Assist» .
В режиме агента вы можете выполнять любые из следующих действий и многое другое:
- Задавайте вопросы о своем коде.
- Используйте контекст и встроенные инструменты для улучшения генерируемого контента.
- Настройте серверы MCP для расширения возможностей агента.
- Получайте решения сложных задач, состоящих из нескольких этапов.
- Генерируйте код на основе проектной документации, описаний проблем и комментариев
TODO. - Управляйте поведением агента, комментируя, редактируя и утверждая планы и использование инструментов во время выполнения.
Как работает режим агента
В режиме агента ваш запрос отправляется в API Gemini со списком доступных инструментов . API Gemini обрабатывает запрос и возвращает ответ. Ответ может быть прямым ответом или запросом на использование доступного инструмента.
Когда запрашивается инструмент, агент готовится к его использованию и проверяет, разрешено ли ему использовать инструмент с явным разрешением или без него:
- Для запросов инструментов, изменяющих файловую систему или выполняющих операции изменения каких-либо ресурсов, Gemini запросит разрешение на выполнение операции, если только вы не настроили Gemini на постоянное разрешение работы инструмента или инструментов.
- Запросы на использование инструментов, предназначенные только для чтения, могут не запрашивать разрешения перед выполнением задачи.
При запросе разрешения на использование инструмента вы можете разрешить или запретить операцию. Агент также может предложить вам варианты, позволяющие всегда разрешать использование инструмента или сервера, или разрешать аналогичные операции. Для получения дополнительной информации см. раздел «Всегда разрешать действия агента» .
После получения разрешения на использование инструмента или его самостоятельного подтверждения, агент использует инструмент для выполнения необходимого действия, а результат этого действия отправляется обратно в API Gemini. Gemini обрабатывает результат действия инструмента и генерирует еще один ответ. Этот цикл действий и оценки продолжается до тех пор, пока задача не будет выполнена.
Для сложных задач Gemini может показать вам план высокого уровня на утверждение. Вы можете доработать план и задать вопросы в чате, прежде чем начать процесс. Как только вы будете удовлетворены планом, вы можете его утвердить. После утверждения плана агент начнет работу над первой задачей и будет запрашивать у вас уточнения или разрешения по мере необходимости в процессе выполнения плана.
Контекст режима агента
Контекст позволяет агенту генерировать более качественные ответы на заданный запрос. Контекст может быть получен из файлов в вашей IDE, файлов в локальных системных папках, ответов инструментов и сведений о вашем запросе.
В зависимости от вашей IDE и настроек агенту могут быть доступны различные контексты.
На следующих вкладках подробно описано, как собирается контекстная информация для различных IDE.
VS Code
В режиме агента Gemini Code Assist обычно доступны следующие методы получения контекста:
- Информация в вашей рабочей области IDE.
- Ответы от встроенных инструментов, таких как grep, терминал, чтение файла или запись файла.
- Ответы на поиск в Google.
- Содержимое с заданного URL-адреса, предоставленное в подсказке или с помощью инструмента.
- Контекстные файлы, которые вы создаете в формате Markdown.
ИнтеллиДж
В режиме агента Gemini Code Assist обычно доступны следующие методы получения контекста:
- Информация о вашем проекте в IDE, включая ваши файлы, индексированные символы и использование символов в вашем проекте.
- Ответы от встроенных инструментов, таких как grep, file read или file write.
- Система контроля версий IntelliJ.
- Настроенные серверы и инструменты MCP
- Контекстные файлы, которые вы создаете в формате Markdown.
Контекст, доступный агенту, можно увидеть в контекстном меню в области подсказок чата в режиме агента.
Инструменты
Инструменты — это широкая категория сервисов, которые агент может использовать для получения контекста и выполнения действий в ответ на ваш запрос. Инструменты позволяют агентам получать доступ к актуальной информации посредством вызова функций к конечным точкам API или к другим агентам. Инструменты могут предлагать только одну функцию или несколько связанных функций.
В качестве примеров инструментов можно привести встроенные средства, такие как grep и чтение или запись файлов, локальные или удаленные серверы протокола контекста модели (MCP) и их исполняемые функции, а также вызовы RESTful API.
Встроенные инструменты
В режиме агента Gemini имеет доступ к встроенным системным инструментам. Выберите свою IDE, чтобы просмотреть список встроенных инструментов, доступных Gemini в режиме агента.
VS Code
Все встроенные инструменты Gemini CLI доступны в режиме агента в Gemini Code Assist.
ИнтеллиДж
-
read_file - Извлекает текстовое содержимое файла, используя его абсолютный путь.
-
write_file - Записывает заданный текст в указанный файл, создавая файл, если он не существует.
-
analyze_current_file - Анализирует открытый файл в редакторе на наличие ошибок и предупреждений.
-
find_files - Находит абсолютный путь к файлу по имени файла или части пути.
-
grep - Находит все файлы в проекте, содержащие заданный текстовый шаблон или регулярное выражение.
-
list_files - Выводит список всех файлов и каталогов по заданному абсолютному пути.
-
resolve_symbol - Преобразует конкретную ссылку на символ в его исходное объявление.
-
find_usages - Выполняет поиск по всему проекту всех ссылок на заданное объявление символа.
-
git - Выполняет команду интерфейса командной строки Git (CLI) и возвращает результат.
-
list_vcs_roots - Возвращает все корневые каталоги системы контроля версий (VCS), такие как репозитории Git, в текущем проекте.
Ограничения
Некоторые функции стандартного чата Gemini Code Assist могут быть недоступны в режиме агента или работать иначе, чем в стандартном чате.
В режиме агента функция лекций недоступна. В режиме агента Gemini не цитирует источники , и вы не можете отключить подсказки кода, соответствующие цитируемым источникам .