Gemini Agents API

Агенты — это системы, использующие модели Gemini, набор инструментов и возможности логического мышления для выполнения сложных многоэтапных задач и достижения конкретных целей. В отличие от однократного вызова модели, агент может планировать и выполнять ряд действий, взаимодействовать с внешними системами и синтезировать информацию для выполнения запроса пользователя.

Просмотреть в формате Markdown Просмотреть спецификацию OpenAPI

CreateAgent

ссылка: https://generativelanguage.googleapis.com/v1beta/agents

Создает нового агента (типизированная версия для SDK).

Текст запроса

Тело запроса содержит данные следующей структуры:

agent_config AntigravityAgentConfig (необязательно)

Параметры конфигурации агента.

Настройки среды выполнения агента Antigravity. Обеспечивают управление средой выполнения агента и конфигурацией инструментов на стороне сервера.

Поля

max_total_tokens строка (необязательно)

Максимальное общее количество токенов для выполнения задания агентом.

строка модели (необязательно)

Модель, используемая для рассуждений агента.

тип объекта (необязательно)

Описание отсутствует.

Всегда устанавливайте режим "antigravity" .

base_agent строка (необязательно)

Базовый агент для расширения.

base_environment EnvironmentConfig или строка (необязательно)

Конфигурация среды для агента.

Настройки для пользовательской среды.

Поля

environment_id строка (необязательно)

Необязательный параметр. Идентификатор среды для взаимодействия. Если указан, запрос обновит существующую среду вместо создания новой.

network EnvironmentNetworkEgressAllowlist или enum (строка) (необязательно)

Настройка сети для данной среды.

Конфигурация исходящего сетевого трафика для песочницы. Принимает объект с массивом 'allowlist' для ограничения трафика или строку 'disabled' для отключения всего сетевого доступа. Полное исключение позволяет разрешить весь исходящий трафик без внедрения заголовков.

Возможные типы

объект

Настройки исходящей сети для песочницы. При указании ограничивает доступ песочницы к внешним доменам. Полное исключение позволяет разрешить весь исходящий трафик без внедрения заголовков.

Массив разрешенных записей (AllowlistEntry) (необязательно)

Список разрешенных исходящих доменов. Разрешены только запросы к перечисленным доменам. Используйте [{'domain': '*'}], чтобы разрешить все домены, но при этом добавить заголовки только к определенным из них.

Правило, содержащее один домен в списке разрешенных, с возможностью добавления заголовка.

Поля

строка домена (необязательно)

Домен, разрешающий исходящие запросы. Поддерживаются подстановочные знаки (например, '*.googleapis.com'). Используйте '*' для разрешения всех доменов.

преобразование массива (объекта) или объекта (необязательно)

Заголовки для добавления во все исходящие запросы, соответствующие этому домену. Принимает один словарь или список словарей. Исходящий прокси добавляет их автоматически.

нить

Отключает всю сеть.

Возможные значения

  • disabled

    Отключает всю сеть.

массив источников (Источник) (необязательно)

Описание отсутствует.

Источник, предназначенный для установки в окружающую среду.

Поля

строка содержимого (необязательно)

Встроенное содержимое, если `type` имеет значение `INLINE`.

строка кодировки (необязательно)

Дополнительная кодировка для встроенного контента (например, `base64`).

исходная строка (необязательно)

Источник среды. Для Cloud Storage это путь к Cloud Storage. Для GitHub это путь к GitHub.

Целевая строка (необязательно)

Где должен отображаться исходный код в окружающей среде.

тип перечисления (строка) (необязательно)

Описание отсутствует.

Возможные значения:

  • gcs

    Сегмент облачного хранилища.

  • inline

    Встроенный контент.

  • repository

    Универсальный репозиторий. Префикс протокола в URL-адресе источника идентифицирует поставщика (например, github://, gcs://).

  • skill_registry

    Ресурс навыков из службы регистрации навыков. Навык: projects/{project}/locations/{location}/skills/{skill} Ревизия навыка: projects/{project}/locations/{location}/skills/{skill}/revisions/{revision} Поддерживается подключение всех навыков в рамках проекта: projects/{project}/locations/{location}/skills.

тип объекта (необязательно)

Описание отсутствует.

Всегда устанавливайте значение "remote" .

строка описания (необязательно)

Описание агента для быстрого ознакомления и понимания разработчиками.

строка идентификатора (необязательно)

Уникальный идентификатор агента.

строка системной инструкции (необязательно)

Системная инструкция для агента.

массив инструментов (AgentTool) (необязательно)

Инструменты, доступные агенту.

Инструмент, который может использовать агент.

Возможные типы

Выполнение кода

Инструмент, который может использоваться моделью для выполнения кода.

тип объекта (обязательно)

Описание отсутствует.

Всегда устанавливайте значение "code_execution" .

Функция

Инструмент, который может быть использован моделью.

строка описания (необязательно)

Описание функции.

строковое имя (необязательно)

Название функции.

объект параметров (необязательно)

JSON-схема для параметров функции.

тип объекта (обязательно)

Описание отсутствует.

Всегда устанавливайте значение "function" .

GoogleПоиск

Инструмент, который модель может использовать для поиска в Google.

массив search_types (перечисление (строка)) (необязательно)

Типы поиска, которые необходимо включить.

Возможные значения:

  • web_search

    Включение этого поля активирует веб-поиск. Возвращаются только текстовые результаты.

  • image_search

    Установив это поле, можно включить поиск изображений. Возвращаются байты изображения.

  • enterprise_web_search

    Включение корпоративного веб-поиска.

тип объекта (обязательно)

Описание отсутствует.

Всегда устанавливайте значение "google_search" .

McpServer

MCPServer — это сервер, который может быть вызван моделью для выполнения действий.

массив allowed_tools (AllowedTools) (необязательно)

Разрешенные инструменты.

Настройки для разрешенных инструментов.

Поля

режим перечисления (строка) (необязательно)

Способ выбора инструмента.

Возможные значения:

  • auto

    Автоматический выбор инструмента.

  • any

    Любой выбор инструмента.

  • none

    Выбор инструментов отсутствует.

  • validated

    Выбор инструмента подтвержден.

массив инструментов (строка) (необязательно)

Названия разрешенных инструментов.

объект заголовков (необязательно)

Необязательно: поля для заголовков аутентификации, тайм-аутов и т. д., если необходимо.

строковое имя (необязательно)

Имя MCPServer.

тип объекта (обязательно)

Описание отсутствует.

Всегда устанавливайте значение "mcp_server" .

строка URL (необязательно)

Полный URL-адрес конечной точки MCPServer. Пример: "https://api.example.com/mcp"

UrlContext

Инструмент, который может использоваться моделью для получения контекста URL-адреса.

тип объекта (обязательно)

Описание отсутствует.

Всегда устанавливайте значение "url_context" .

Ответ

В случае успеха тело ответа содержит данные следующей структуры:

agent_config AntigravityAgentConfig (необязательно)

Параметры конфигурации агента.

Настройки среды выполнения агента Antigravity. Обеспечивают управление средой выполнения агента и конфигурацией инструментов на стороне сервера.

Поля

max_total_tokens строка (необязательно)

Максимальное общее количество токенов для выполнения задания агентом.

строка модели (необязательно)

Модель, используемая для рассуждений агента.

тип объекта (необязательно)

Описание отсутствует.

Всегда устанавливайте режим "antigravity" .

base_agent строка (необязательно)

Базовый агент для расширения.

base_environment EnvironmentConfig или строка (необязательно)

Конфигурация среды для агента.

Настройки для пользовательской среды.

Поля

environment_id строка (необязательно)

Необязательный параметр. Идентификатор среды для взаимодействия. Если указан, запрос обновит существующую среду вместо создания новой.

network EnvironmentNetworkEgressAllowlist или enum (строка) (необязательно)

Настройка сети для данной среды.

Конфигурация исходящего сетевого трафика для песочницы. Принимает объект с массивом 'allowlist' для ограничения трафика или строку 'disabled' для отключения всего сетевого доступа. Полное исключение позволяет разрешить весь исходящий трафик без внедрения заголовков.

Возможные типы

объект

Настройки исходящей сети для песочницы. При указании ограничивает доступ песочницы к внешним доменам. Полное исключение позволяет разрешить весь исходящий трафик без внедрения заголовков.

Массив разрешенных записей (AllowlistEntry) (необязательно)

Список разрешенных исходящих доменов. Разрешены только запросы к перечисленным доменам. Используйте [{'domain': '*'}], чтобы разрешить все домены, но при этом добавить заголовки только к определенным из них.

Правило, содержащее один домен в списке разрешенных, с возможностью добавления заголовка.

Поля

строка домена (необязательно)

Домен, разрешающий исходящие запросы. Поддерживаются подстановочные знаки (например, '*.googleapis.com'). Используйте '*' для разрешения всех доменов.

преобразование массива (объекта) или объекта (необязательно)

Заголовки для добавления во все исходящие запросы, соответствующие этому домену. Принимает один словарь или список словарей. Исходящий прокси добавляет их автоматически.

нить

Отключает всю сеть.

Возможные значения

  • disabled

    Отключает всю сеть.

массив источников (Источник) (необязательно)

Описание отсутствует.

Источник, предназначенный для установки в окружающую среду.

Поля

строка содержимого (необязательно)

Встроенное содержимое, если `type` имеет значение `INLINE`.

строка кодировки (необязательно)

Дополнительная кодировка для встроенного контента (например, `base64`).

исходная строка (необязательно)

Источник среды. Для Cloud Storage это путь к Cloud Storage. Для GitHub это путь к GitHub.

Целевая строка (необязательно)

Где должен отображаться исходный код в окружающей среде.

тип перечисления (строка) (необязательно)

Описание отсутствует.

Возможные значения:

  • gcs

    Сегмент облачного хранилища.

  • inline

    Встроенный контент.

  • repository

    Универсальный репозиторий. Префикс протокола в URL-адресе источника идентифицирует поставщика (например, github://, gcs://).

  • skill_registry

    Ресурс навыков из службы регистрации навыков. Навык: projects/{project}/locations/{location}/skills/{skill} Ревизия навыка: projects/{project}/locations/{location}/skills/{skill}/revisions/{revision} Поддерживается подключение всех навыков в рамках проекта: projects/{project}/locations/{location}/skills.

тип объекта (необязательно)

Описание отсутствует.

Всегда устанавливайте значение "remote" .

строка описания (необязательно)

Описание агента для быстрого ознакомления и понимания разработчиками.

строка идентификатора (необязательно)

Уникальный идентификатор агента.

строка системной инструкции (необязательно)

Системная инструкция для агента.

массив инструментов (AgentTool) (необязательно)

Инструменты, доступные агенту.

Инструмент, который может использовать агент.

Возможные типы

Выполнение кода

Инструмент, который может использоваться моделью для выполнения кода.

тип объекта (обязательно)

Описание отсутствует.

Всегда устанавливайте значение "code_execution" .

Функция

Инструмент, который может быть использован моделью.

строка описания (необязательно)

Описание функции.

строковое имя (необязательно)

Название функции.

объект параметров (необязательно)

JSON-схема для параметров функции.

тип объекта (обязательно)

Описание отсутствует.

Всегда устанавливайте значение "function" .

GoogleПоиск

Инструмент, который модель может использовать для поиска в Google.

массив search_types (перечисление (строка)) (необязательно)

Типы поиска, которые необходимо включить.

Возможные значения:

  • web_search

    Включение этого поля активирует веб-поиск. Возвращаются только текстовые результаты.

  • image_search

    Установив это поле, можно включить поиск изображений. Возвращаются байты изображения.

  • enterprise_web_search

    Включение корпоративного веб-поиска.

тип объекта (обязательно)

Описание отсутствует.

Всегда устанавливайте значение "google_search" .

McpServer

MCPServer — это сервер, который может быть вызван моделью для выполнения действий.

массив allowed_tools (AllowedTools) (необязательно)

Разрешенные инструменты.

Настройки для разрешенных инструментов.

Поля

режим перечисления (строка) (необязательно)

Способ выбора инструмента.

Возможные значения:

  • auto

    Автоматический выбор инструмента.

  • any

    Любой выбор инструмента.

  • none

    Выбор инструментов отсутствует.

  • validated

    Выбор инструмента подтвержден.

массив инструментов (строка) (необязательно)

Названия разрешенных инструментов.

объект заголовков (необязательно)

Необязательно: поля для заголовков аутентификации, тайм-аутов и т. д., если необходимо.

строковое имя (необязательно)

Имя MCPServer.

тип объекта (обязательно)

Описание отсутствует.

Всегда устанавливайте значение "mcp_server" .

строка URL (необязательно)

Полный URL-адрес конечной точки MCPServer. Пример: "https://api.example.com/mcp"

UrlContext

Инструмент, который может использоваться моделью для получения контекста URL-адреса.

тип объекта (обязательно)

Описание отсутствует.

Всегда устанавливайте значение "url_context" .

Создать агента

Пример ответа 

{
  "created": "2025-11-26T12:25:15Z",
  "display_name": "My Research Agent",
  "id": "ag_abc123",
  "object": "agent",
  "system_instruction": "You are a helpful research assistant.",
  "tools": [
    {
      "type": "google_search"
    }
  ],
  "updated": "2025-11-26T12:25:15Z"
}

Агент, располагающий источниками информации.

Пример ответа 

{
  "created": "2025-11-26T12:25:15Z",
  "id": "data-analyst-abc123",
  "object": "agent",
  "system_instruction": "You are a data analyst. Always include visualizations and export results as PDF.",
  "updated": "2025-11-26T12:25:15Z"
}

Агент ответвился от среды

Пример ответа 

{
  "created": "2025-11-26T12:25:15Z",
  "id": "my-data-analyst",
  "object": "agent",
  "system_instruction": "You are a data analyst. Use the template at /workspace/template.py for all reports.",
  "updated": "2025-11-26T12:25:15Z"
}

ListAgents

получить https://generativelanguage.googleapis.com/v1beta/agents

Список всех агентов.

Путь / Параметры запроса

page_size — целое число (необязательно)

Описание отсутствует.

строка page_token (необязательно)

Описание отсутствует.

родительская строка (необязательно)

Описание отсутствует.

Ответ

В случае успеха тело ответа содержит данные следующей структуры:

массив агентов ( Агент ) (необязательно)

Описание отсутствует.

строка next_page_token (необязательно)

Описание отсутствует.

Агенты по составлению списков

Пример ответа 

{
  "data": [
    {
      "created": "2025-11-26T12:25:15Z",
      "display_name": "My Research Agent",
      "id": "ag_abc123",
      "object": "agent",
      "system_instruction": "You are a helpful research assistant.",
      "updated": "2025-11-26T12:25:15Z"
    }
  ],
  "object": "list"
}

GetAgent

получить https://generativelanguage.googleapis.com/v1beta/agents/{id}

Получает конкретного агента.

Путь / Параметры запроса

строковый идентификатор (обязательно)

Описание отсутствует.

Ответ

В случае успеха тело ответа содержит данные следующей структуры:

agent_config AntigravityAgentConfig (необязательно)

Параметры конфигурации агента.

Настройки среды выполнения агента Antigravity. Обеспечивают управление средой выполнения агента и конфигурацией инструментов на стороне сервера.

Поля

max_total_tokens строка (необязательно)

Максимальное общее количество токенов для выполнения задания агентом.

строка модели (необязательно)

Модель, используемая для рассуждений агента.

тип объекта (необязательно)

Описание отсутствует.

Всегда устанавливайте режим "antigravity" .

base_agent строка (необязательно)

Базовый агент для расширения.

base_environment EnvironmentConfig или строка (необязательно)

Конфигурация среды для агента.

Настройки для пользовательской среды.

Поля

environment_id строка (необязательно)

Необязательный параметр. Идентификатор среды для взаимодействия. Если указан, запрос обновит существующую среду вместо создания новой.

network EnvironmentNetworkEgressAllowlist или enum (строка) (необязательно)

Настройка сети для данной среды.

Конфигурация исходящего сетевого трафика для песочницы. Принимает объект с массивом 'allowlist' для ограничения трафика или строку 'disabled' для отключения всего сетевого доступа. Полное исключение позволяет разрешить весь исходящий трафик без внедрения заголовков.

Возможные типы

объект

Настройки исходящей сети для песочницы. При указании ограничивает доступ песочницы к внешним доменам. Полное исключение позволяет разрешить весь исходящий трафик без внедрения заголовков.

Массив разрешенных записей (AllowlistEntry) (необязательно)

Список разрешенных исходящих доменов. Разрешены только запросы к перечисленным доменам. Используйте [{'domain': '*'}], чтобы разрешить все домены, но при этом добавить заголовки только к определенным из них.

Правило, содержащее один домен в списке разрешенных, с возможностью добавления заголовка.

Поля

строка домена (необязательно)

Домен, разрешающий исходящие запросы. Поддерживаются подстановочные знаки (например, '*.googleapis.com'). Используйте '*' для разрешения всех доменов.

преобразование массива (объекта) или объекта (необязательно)

Заголовки для добавления во все исходящие запросы, соответствующие этому домену. Принимает один словарь или список словарей. Исходящий прокси добавляет их автоматически.

нить

Отключает всю сеть.

Возможные значения

  • disabled

    Отключает всю сеть.

массив источников (Источник) (необязательно)

Описание отсутствует.

Источник, предназначенный для установки в окружающую среду.

Поля

строка содержимого (необязательно)

Встроенное содержимое, если `type` имеет значение `INLINE`.

строка кодировки (необязательно)

Дополнительная кодировка для встроенного контента (например, `base64`).

исходная строка (необязательно)

Источник среды. Для Cloud Storage это путь к Cloud Storage. Для GitHub это путь к GitHub.

Целевая строка (необязательно)

Где должен отображаться исходный код в окружающей среде.

тип перечисления (строка) (необязательно)

Описание отсутствует.

Возможные значения:

  • gcs

    Сегмент облачного хранилища.

  • inline

    Встроенный контент.

  • repository

    Универсальный репозиторий. Префикс протокола в URL-адресе источника идентифицирует поставщика (например, github://, gcs://).

  • skill_registry

    Ресурс навыков из службы регистрации навыков. Навык: projects/{project}/locations/{location}/skills/{skill} Ревизия навыка: projects/{project}/locations/{location}/skills/{skill}/revisions/{revision} Поддерживается подключение всех навыков в рамках проекта: projects/{project}/locations/{location}/skills.

тип объекта (необязательно)

Описание отсутствует.

Всегда устанавливайте значение "remote" .

строка описания (необязательно)

Описание агента для быстрого ознакомления и понимания разработчиками.

строка идентификатора (необязательно)

Уникальный идентификатор агента.

строка системной инструкции (необязательно)

Системная инструкция для агента.

массив инструментов (AgentTool) (необязательно)

Инструменты, доступные агенту.

Инструмент, который может использовать агент.

Возможные типы

Выполнение кода

Инструмент, который может использоваться моделью для выполнения кода.

тип объекта (обязательно)

Описание отсутствует.

Всегда устанавливайте значение "code_execution" .

Функция

Инструмент, который может быть использован моделью.

строка описания (необязательно)

Описание функции.

строковое имя (необязательно)

Название функции.

объект параметров (необязательно)

JSON-схема для параметров функции.

тип объекта (обязательно)

Описание отсутствует.

Всегда устанавливайте значение "function" .

GoogleПоиск

Инструмент, который модель может использовать для поиска в Google.

массив search_types (перечисление (строка)) (необязательно)

Типы поиска, которые необходимо включить.

Возможные значения:

  • web_search

    Включение этого поля активирует веб-поиск. Возвращаются только текстовые результаты.

  • image_search

    Установив это поле, можно включить поиск изображений. Возвращаются байты изображения.

  • enterprise_web_search

    Включение корпоративного веб-поиска.

тип объекта (обязательно)

Описание отсутствует.

Всегда устанавливайте значение "google_search" .

McpServer

MCPServer — это сервер, который может быть вызван моделью для выполнения действий.

массив allowed_tools (AllowedTools) (необязательно)

Разрешенные инструменты.

Настройки для разрешенных инструментов.

Поля

режим перечисления (строка) (необязательно)

Способ выбора инструмента.

Возможные значения:

  • auto

    Автоматический выбор инструмента.

  • any

    Любой выбор инструмента.

  • none

    Выбор инструментов отсутствует.

  • validated

    Выбор инструмента подтвержден.

массив инструментов (строка) (необязательно)

Названия разрешенных инструментов.

объект заголовков (необязательно)

Необязательно: поля для заголовков аутентификации, тайм-аутов и т. д., если необходимо.

строковое имя (необязательно)

Имя MCPServer.

тип объекта (обязательно)

Описание отсутствует.

Всегда устанавливайте значение "mcp_server" .

строка URL (необязательно)

Полный URL-адрес конечной точки MCPServer. Пример: "https://api.example.com/mcp"

UrlContext

Инструмент, который может использоваться моделью для получения контекста URL-адреса.

тип объекта (обязательно)

Описание отсутствует.

Всегда устанавливайте значение "url_context" .

Получить агента

Пример ответа 

{
  "created": "2025-11-26T12:25:15Z",
  "display_name": "My Research Agent",
  "id": "ag_abc123",
  "object": "agent",
  "system_instruction": "You are a helpful research assistant.",
  "tools": [
    {
      "type": "google_search"
    }
  ],
  "updated": "2025-11-26T12:25:15Z"
}

DeleteAgent

удалить https://generativelanguage.googleapis.com/v1beta/agents/{id}

Удаляет агента.

Путь / Параметры запроса

строковый идентификатор (обязательно)

Описание отсутствует.

Ответ

В случае успеха ответ будет пустым.

Удалить агента

Ресурсы

Агент

Определение агента для API CreateAgent. Это сообщение предназначено для парсинга JSON на основе аннотационного парсера. Новый формат: { "id": "customer-sentinel", "base_agent": "", "system_instruction": "...", "base_environment": { "type": "remote", "sources": [...] }, "tools": [ {"type": "code_execution"} ] }

Поля

agent_config AntigravityAgentConfig (необязательно)

Параметры конфигурации агента.

Настройки среды выполнения агента Antigravity. Обеспечивают управление средой выполнения агента и конфигурацией инструментов на стороне сервера.

Поля

max_total_tokens строка (необязательно)

Максимальное общее количество токенов для выполнения задания агентом.

строка модели (необязательно)

Модель, используемая для рассуждений агента.

тип объекта (необязательно)

Описание отсутствует.

Всегда устанавливайте режим "antigravity" .

base_agent строка (необязательно)

Базовый агент для расширения.

base_environment EnvironmentConfig или строка (необязательно)

Конфигурация среды для агента.

Настройки для пользовательской среды.

Поля

environment_id строка (необязательно)

Необязательный параметр. Идентификатор среды для взаимодействия. Если указан, запрос обновит существующую среду вместо создания новой.

network EnvironmentNetworkEgressAllowlist или enum (строка) (необязательно)

Настройка сети для данной среды.

Конфигурация исходящего сетевого трафика для песочницы. Принимает объект с массивом 'allowlist' для ограничения трафика или строку 'disabled' для отключения всего сетевого доступа. Полное исключение позволяет разрешить весь исходящий трафик без внедрения заголовков.

Возможные типы

объект

Настройки исходящей сети для песочницы. При указании ограничивает доступ песочницы к внешним доменам. Полное исключение позволяет разрешить весь исходящий трафик без внедрения заголовков.

Массив разрешенных записей (AllowlistEntry) (необязательно)

Список разрешенных исходящих доменов. Разрешены только запросы к перечисленным доменам. Используйте [{'domain': '*'}], чтобы разрешить все домены, но при этом добавить заголовки только к определенным из них.

Правило, содержащее один домен в списке разрешенных, с возможностью добавления заголовка.

Поля

строка домена (необязательно)

Домен, разрешающий исходящие запросы. Поддерживаются подстановочные знаки (например, '*.googleapis.com'). Используйте '*' для разрешения всех доменов.

преобразование массива (объекта) или объекта (необязательно)

Заголовки для добавления во все исходящие запросы, соответствующие этому домену. Принимает один словарь или список словарей. Исходящий прокси добавляет их автоматически.

нить

Отключает всю сеть.

Возможные значения

  • disabled

    Отключает всю сеть.

массив источников (Источник) (необязательно)

Описание отсутствует.

Источник, предназначенный для установки в окружающую среду.

Поля

строка содержимого (необязательно)

Встроенное содержимое, если `type` имеет значение `INLINE`.

строка кодировки (необязательно)

Дополнительная кодировка для встроенного контента (например, `base64`).

исходная строка (необязательно)

Источник среды. Для Cloud Storage это путь к Cloud Storage. Для GitHub это путь к GitHub.

Целевая строка (необязательно)

Где должен отображаться исходный код в окружающей среде.

тип перечисления (строка) (необязательно)

Описание отсутствует.

Возможные значения:

  • gcs

    Сегмент облачного хранилища.

  • inline

    Встроенный контент.

  • repository

    Универсальный репозиторий. Префикс протокола в URL-адресе источника идентифицирует поставщика (например, github://, gcs://).

  • skill_registry

    Ресурс навыков из службы регистрации навыков. Навык: projects/{project}/locations/{location}/skills/{skill} Ревизия навыка: projects/{project}/locations/{location}/skills/{skill}/revisions/{revision} Поддерживается подключение всех навыков в рамках проекта: projects/{project}/locations/{location}/skills.

тип объекта (необязательно)

Описание отсутствует.

Всегда устанавливайте значение "remote" .

строка описания (необязательно)

Описание агента для быстрого ознакомления и понимания разработчиками.

строка идентификатора (необязательно)

Уникальный идентификатор агента.

строка системной инструкции (необязательно)

Системная инструкция для агента.

массив инструментов (AgentTool) (необязательно)

Инструменты, доступные агенту.

Инструмент, который может использовать агент.

Возможные типы

Выполнение кода

Инструмент, который может использоваться моделью для выполнения кода.

тип объекта (обязательно)

Описание отсутствует.

Всегда устанавливайте значение "code_execution" .

Функция

Инструмент, который может быть использован моделью.

строка описания (необязательно)

Описание функции.

строковое имя (необязательно)

Название функции.

объект параметров (необязательно)

JSON-схема для параметров функции.

тип объекта (обязательно)

Описание отсутствует.

Всегда устанавливайте значение "function" .

GoogleПоиск

Инструмент, который модель может использовать для поиска в Google.

массив search_types (перечисление (строка)) (необязательно)

Типы поиска, которые необходимо включить.

Возможные значения:

  • web_search

    Включение этого поля активирует веб-поиск. Возвращаются только текстовые результаты.

  • image_search

    Установив это поле, можно включить поиск изображений. Возвращаются байты изображения.

  • enterprise_web_search

    Включение корпоративного веб-поиска.

тип объекта (обязательно)

Описание отсутствует.

Всегда устанавливайте значение "google_search" .

McpServer

MCPServer — это сервер, который может быть вызван моделью для выполнения действий.

массив allowed_tools (AllowedTools) (необязательно)

Разрешенные инструменты.

Настройки для разрешенных инструментов.

Поля

режим перечисления (строка) (необязательно)

Способ выбора инструмента.

Возможные значения:

  • auto

    Автоматический выбор инструмента.

  • any

    Любой выбор инструмента.

  • none

    Выбор инструментов отсутствует.

  • validated

    Выбор инструмента подтвержден.

массив инструментов (строка) (необязательно)

Названия разрешенных инструментов.

объект заголовков (необязательно)

Необязательно: поля для заголовков аутентификации, тайм-аутов и т. д., если необходимо.

строковое имя (необязательно)

Имя MCPServer.

тип объекта (обязательно)

Описание отсутствует.

Всегда устанавливайте значение "mcp_server" .

строка URL (необязательно)

Полный URL-адрес конечной точки MCPServer. Пример: "https://api.example.com/mcp"

UrlContext

Инструмент, который может использоваться моделью для получения контекста URL-адреса.

тип объекта (обязательно)

Описание отсутствует.

Всегда устанавливайте значение "url_context" .