Чтобы переводить контент на ваш предпочитаемый язык, Google использует технологии на основе искусственного интеллекта. Переводы от ИИ могут содержать ошибки.

Как настроить Agent Gateway для входящего трафика Workspace MCP

Эта функция доступна в версии Gemini Enterprise.

Вы можете настроить облачный проект Google Cloud для подключения к серверам MCP Google Workspace через коннектор данных и включить шлюз агента с согласием с точкой принятия решений (PDP) Workspace, чтобы управлять этими серверами с помощью правил Workspace.

Настройка шлюза агента с помощью Workspace PDP позволяет ИИ-агентам (например, агентам Gemini Enterprise) получать доступ к данным приложений Workspace (например, Google Диска) с соблюдением правил контроля доступа, настроенных непосредственно в консоли администратора Google.

Требования

Прежде чем настраивать шлюз агента, вам потребуется:

Облачный проект Google Cloud с Gemini Enterprise.
Аутентифицированный gcloud CLI с разрешениями на включение API и управление ресурсами Network Services, Network Security и Service Extensions в вашем облачном проекте Google Cloud.
Права администратора Google Workspace (права администратора по вопросам безопасности).
Проверили, как настроить шлюз агента в Google Cloud.

Шаг 1. Создайте или выберите проект Google Cloud

В консоли Google Cloud создайте новый проект Google Cloud или выберите существующий, а затем запишите идентификатор проекта (например, my-project-id).

Шаг 2. Включите необходимые API для сети и безопасности

Включите API сетевых сервисов и сетевой безопасности в своем облачном проекте Google Cloud, используя gcloud или Cloud Console:

gcloud services enable networkservices.googleapis.com \
                       networksecurity.googleapis.com \
                       --project=PROJECT_ID

Замените PROJECT_ID идентификатором проекта Google Cloud.

Шаг 3. Включите Agent Registry API и MCP

В консоли Google Cloud выберите API и сервисы Библиотека.
Найдите и включите Agent Registry API (agentregistry.googleapis.com).
Включите Google Диск MCP или другие MCP-серверы, необходимые для вашего рабочего процесса. Подробнее о регистрации серверов MCP…

Важно! Если вы включите MCP-серверы с необязательным шлюзом агента, Gemini Enterprise будет направлять трафик на шлюз только для стандартных коннекторов собственных и сторонних данных. Настройка собственного коннектора данных не поддерживается при управлении данными Workspace.

Шаг 4. Создайте и импортируйте ресурсы шлюза агента и авторизации

Настройте шлюз агента, расширение авторизации (точку принятия решений о правилах Workspace) и ресурсы правил авторизации. Вы можете декларативно определить эти ресурсы с помощью файлов конфигурации YAML и импортировать их с помощью gcloud:

Создайте файл конфигурации шлюза агента (agent-gateway.yaml):
```
name: AGENT_GATEWAY_NAME
protocols:
- MCP
googleManaged:
  governedAccessPath: AGENT_TO_ANYWHERE
registries:
  - //agentregistry.googleapis.com/projects/PROJECT_ID/locations/global
```
Замените AGENT_GATEWAY_NAME названием ресурса шлюза агента (например, ge-agent-gateway), а PROJECT_ID – идентификатором проекта Google Cloud.
Создайте файл конфигурации расширения авторизации, указывающий на точку принятия решений Workspace (ws-pdp-authz-extension.yaml):
```
name: AUTHZ_EXT_NAME
service: workspacepolicyengine.pa.googleapis.com
failOpen: true
timeout: 5s
```
Замените AUTHZ_EXT_NAME названием расширения для авторизации, например ws-pdp-authz-ext.
Создайте файл конфигурации правил авторизации (ws-pdp-authz-policy.yaml), чтобы связать расширение со шлюзом:
```
name: AUTHZ_POLICY_NAME
target:
  resources:
  - "projects/PROJECT_ID/locations/LOCATION/agentGateways/AGENT_GATEWAY_NAME"
policyProfile: CONTENT_AUTHZ
action: CUSTOM
customProvider:
  authzExtension:
    resources:
    - "projects/PROJECT_ID/locations/LOCATION/authzExtensions/AUTHZ_EXT_NAME"
```
Замените следующее:
- AUTHZ_POLICY_NAME – название правила авторизации (например, ws-pdp-authz-policy).
- PROJECT_ID – идентификатор проекта Google Cloud.
- LOCATION – регион для развертывания (например, us-central1).
- AGENT_GATEWAY_NAME – название шлюза агента, указанное на шаге 1.
- AUTHZ_EXT_NAME – название расширения для авторизации, указанное на шаге 2.

Импортируйте файлы конфигурации YAML, используя gcloud:

# Import the Agent Gateway
gcloud beta network-services agent-gateways import AGENT_GATEWAY_NAME \
  --source=agent-gateway.yaml \
  --location=LOCATION \
  --project=PROJECT_ID

# Import the Authorization Extension
gcloud beta service-extensions authz-extensions import AUTHZ_EXT_NAME \
  --source=ws-pdp-authz-extension.yaml \
  --location=LOCATION \
  --project=PROJECT_ID

# Import the Authorization Policy
gcloud beta network-security authz-policies import AUTHZ_POLICY_NAME \
  --source=ws-pdp-authz-policy.yaml \
  --location=LOCATION \
  --project=PROJECT_ID

Шаг 5. Проверьте настройки шлюза агента и получите название ресурса

Чтобы проверить, успешно ли выполнен импорт, перечислите развернутые шлюзы агентов:
```
gcloud beta network-services agent-gateways list --location=LOCATION --project=PROJECT_ID
```

Опишите ресурс шлюза агента:

gcloud beta network-services agent-gateways describe AGENT_GATEWAY_NAME --location=LOCATION --project=PROJECT_ID

Скопируйте полное название ресурса Agent Gateway (в формате projects/PROJECT_ID/locations/LOCATION/agentGateways/AGENT_GATEWAY_NAME, например projects/my-project/locations/us-central1/agentGateways/ge-agent-gateway).

Шаг 6. Подключитесь к Google Identity Provider

В консоли Gen App Builder Engines выберите Settings (Настройки) Authentication (Аутентификация).
Подключите поисковую систему к поставщику Google Identity.
Дополнительную информацию можно найти в статье Контроль доступа к источникам данных Google Cloud.

Шаг 7. Настройте шлюз агента в экземпляре Gemini Enterprise

В экземпляре Gemini Enterprise перейдите в раздел Подключенные хранилища данных.
В разделе Серверы MCP выберите Настроить Agent Gateway.
Введите полное название ресурса Agent Gateway, полученное на шаге 5 (например, projects/PROJECT_ID/locations/us-central1/agentGateways/ge-agent-gateway).

Шаг 8. Настройте управление доступом агента Workspace в консоли администратора Google

После настройки шлюза агента и точки принятия решений Workspace вы можете управлять правилами доступа агента непосредственно из консоли администратора Google:

В консоли администратора Google нажмите на значок меню Агенты.
На вкладке Настройки задайте правила доступа по умолчанию для всех агентов Gemini Enterprise. Подробнее о том, как управлять доступом к агентам Gemini Enterprise…
На вкладке Управление агентами добавьте в список агентов, для которых нужно настроить отдельные разрешения на доступ ("Надежное" или "Заблокировано"). Подробнее о том, как управлять агентами Gemini Enterprise для пользователей Workspace…

Как настроить Agent Gateway для входящего трафика Workspace MCP Оптимизируйте свои подборки Сохраняйте и классифицируйте контент в соответствии со своими настройками.