O Google usa tecnologia de IA na tradução de conteúdos para seu idioma de preferência. As traduções com IA podem ter erros.

Configurar o gateway de agente para entrada do MCP do Workspace

Edições compatíveis com este recurso: Gemini Enterprise.

Você pode configurar um projeto na nuvem do Google Cloud para se conectar aos servidores MCP do Google Workspace usando um conector de dados e ativar o Gateway de Agente com o ponto de decisão de política (PDP) do Workspace para ter governança do Workspace neles.

Ao configurar o Gateway de Agente com a PDP do Workspace, os agentes de IA (como os do Gemini Enterprise) podem acessar dados de aplicativos do Workspace (como o Google Drive) e aplicar políticas de controle de acesso configuradas diretamente no Google Admin Console.

Pré-requisitos

Antes de configurar o Gateway de Agente, você precisa do seguinte:

Um projeto na nuvem do Google Cloud com o Gemini Enterprise.
Uma CLI gcloud autenticada com permissões para ativar APIs e gerenciar recursos de serviços de rede, segurança de rede e extensões de serviço no projeto do Google Cloud.
Privilégios de administrador do Google Workspace (privilégio de administrador de segurança).
Você aprendeu a configurar um gateway de agente no Google Cloud.

Etapa 1: criar ou selecionar um projeto do Google Cloud

No console do Google Cloud, crie um projeto ou selecione um para esta configuração e anote o ID dele (por exemplo, my-project-id).

Etapa 2: ativar as APIs de rede e segurança necessárias

Ative as APIs Network Services e Network Security no projeto do Google Cloud usando gcloud ou o console do Cloud:

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

Substitua PROJECT_ID pelo ID do projeto na nuvem do Google Cloud.

Etapa 3: ativar a API Agent Registry e o MCP

No console do Google Cloud, acesse APIs e serviços Biblioteca.
Pesquise e ative a API Agent Registry (agentregistry.googleapis.com).
Ative o MCP do Google Drive ou outros servidores MCP necessários para seu fluxo de trabalho. Para mais detalhes, acesse Registrar servidores MCP.

Importante:ao ativar servidores MCP com o Agent Gateway de inclusão, o Gemini Enterprise só encaminha o tráfego para o gateway de conectores de dados padrão, próprios (1P) e de terceiros (3P). Não é possível configurar um conector de dados personalizado com a governança de dados do Workspace.

Etapa 4: criar e importar recursos de Gateway de Agente e autorização

Configure o Gateway de Agente, a extensão de autorização (ponto de decisão da política do Workspace) e os recursos da política de autorização. É possível definir esses recursos de maneira declarativa usando arquivos de configuração YAML e importá-los com gcloud:

Crie o arquivo de configuração do Gateway de Agente (agent-gateway.yaml):
```
name: AGENT_GATEWAY_NAME
protocols:
- MCP
googleManaged:
  governedAccessPath: AGENT_TO_ANYWHERE
registries:
  - //agentregistry.googleapis.com/projects/PROJECT_ID/locations/global
```
Substitua AGENT_GATEWAY_NAME por um nome para o recurso do Agent Gateway (como ge-agent-gateway) e PROJECT_ID pelo ID do projeto do Google Cloud.
Crie o arquivo de configuração da extensão de autorização apontando para o ponto de decisão da política do espaço de trabalho (ws-pdp-authz-extension.yaml):
```
name: AUTHZ_EXT_NAME
service: workspacepolicyengine.pa.googleapis.com
failOpen: true
timeout: 5s
```
Substitua AUTHZ_EXT_NAME por um nome para a extensão de autorização (como ws-pdp-authz-ext).
Crie o arquivo de configuração da política de autorização (ws-pdp-authz-policy.yaml) para associar a extensão ao gateway:
```
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"
```
Substitua o seguinte:
- AUTHZ_POLICY_NAME: um nome para a política de autorização (como ws-pdp-authz-policy).
- PROJECT_ID: o ID do projeto do Google Cloud.
- LOCATION: a região da sua implantação (por exemplo, us-central1).
- AGENT_GATEWAY_NAME: O nome do Gateway de Agente da etapa 1.
- AUTHZ_EXT_NAME: o nome da extensão de autorização da etapa 2.

Importe os arquivos de configuração YAML usando 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

Etapa 5: verificar a configuração do Gateway de Agente e receber o nome do recurso

Liste os gateways do agente implantados para verificar se a importação foi bem-sucedida:

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

Descreva o recurso do Gateway de Agente:

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

Copie o nome completo do recurso do Gateway de Agente (formatado como projects/PROJECT_ID/locations/LOCATION/agentGateways/AGENT_GATEWAY_NAME, por exemplo, projects/my-project/locations/us-central1/agentGateways/ge-agent-gateway).

Etapa 6: conectar ao provedor de identidade do Google

No console do Gen App Builder Engines, navegue até Configurações Autenticação.
Conecte seu mecanismo ao provedor de identidade do Google.
Para mais documentação, acesse Controle de acesso à fonte de dados do Google Cloud.

Etapa 7: configurar o Gateway de Agente na instância do Gemini Enterprise

Na sua instância do Gemini Enterprise (GE), navegue até Repositórios de dados conectados.
Em Servidores MCP, selecione Configurar o Gateway de Agente.
Insira o nome completo do recurso do Gateway de Agente obtido na Etapa 5 (por exemplo, projects/PROJECT_ID/locations/us-central1/agentGateways/ge-agent-gateway).

Etapa 8: configurar os controles de acesso do agente do Workspace no Google Admin Console

Depois de configurar o Gateway de Agente e o ponto de decisão da política do Workspace, você pode gerenciar as políticas de acesso do agente diretamente no Google Admin Console:

No Google Admin Console, acesse Menu Agentes.
Na guia Configurações, configure a política de acesso padrão para todos os agentes do Gemini Enterprise. Para mais detalhes, acesse Controlar o acesso aos agentes do Gemini Enterprise.
Na guia Gerenciamento de agentes, adicione agentes específicos à sua lista de gerenciamento para configurar permissões de acesso individuais (confiável ou bloqueado). Para mais detalhes, acesse Gerenciar agentes do Gemini Enterprise para usuários do Workspace.

Configurar o gateway de agente para entrada do MCP do Workspace Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.