إعداد Agent Gateway لعمليات نقل البيانات الواردة في Workspace MCP

الإصدارات المتوافقة مع هذه الميزة: Gemini Enterprise.

يمكنك ضبط أحد مشاريع Google Cloud للربط بخوادم Google Workspace MCP من خلال أداة ربط البيانات وتفعيل "بوابة الوكيل" التي تتطلّب الموافقة باستخدام "نقطة اتخاذ القرار" (PDP) في سياسة Workspace لإدارة Workspace عليها.

يتيح إعداد "بوابة الوكيل" باستخدام Workspace PDP لوكلاء الذكاء الاصطناعي (مثل وكلاء Gemini Enterprise) الوصول إلى بيانات تطبيقات Workspace (مثل Google Drive) مع فرض سياسات التحكّم في الوصول التي تم إعدادها مباشرةً في "وحدة تحكّم المشرف في Google".

المتطلّبات الأساسية

قبل إعداد Agent Gateway، يجب توفُّر ما يلي:

  • مشروع على Google Cloud يتضمّن Gemini Enterprise
  • gcloud واجهة سطر أوامر مصادَق عليها لديها أذونات لتفعيل واجهات برمجة التطبيقات وإدارة موارد "خدمات الشبكة" و"أمان الشبكة" و"إضافات الخدمة" في مشروعك على Google Cloud
  • امتيازات مشرف Google Workspace (امتيازات مشرف الأمان)
  • راجعتُ كيفية إعداد Agent Gateway في Google Cloud.

الخطوة 1: إنشاء مشروع على Google Cloud أو اختياره

  1. في Google Cloud Console، أنشِئ مشروعًا جديدًا على Google Cloud أو اختَر مشروعًا حاليًا لهذا الإعداد، واحتفِظ برقم تعريف مشروعك (على سبيل المثال، my-project-id).

الخطوة 2: تفعيل واجهات برمجة التطبيقات المطلوبة في "الشبكة والأمان"

فعِّل واجهتَي Network Services API وNetwork Security 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 وبروتوكول سياق النموذج (MCP)

  1. في Google Cloud Console، انتقِل إلى واجهات برمجة التطبيقات والخدمات ثم المكتبة.
  2. ابحث عن Agent Registry API (agentregistry.googleapis.com) وفعِّله.
  3. فعِّل Google Drive MCP أو خوادم MCP الأخرى اللازمة لسير عملك. لمعرفة التفاصيل، يُرجى الانتقال إلى تسجيل خوادم MCP.

ملاحظة مهمة: عند تفعيل خوادم MCP باستخدام Agent Gateway التي تتطلّب الموافقة، لا يوجّه Gemini Enterprise الزيارات إلا إلى البوابة لموصلات البيانات العادية والتابعة للطرف الأول (1P) والتابعة لجهة خارجية (3P). لا تتوفّر إمكانية إعداد أداة ربط بيانات مخصّصة باستخدام ميزة "إدارة بيانات Workspace".

الخطوة 4: إنشاء موارد Agent Gateway والتفويض واستيرادها

اضبط "بوابة الوكيل" و"إضافة التفويض" (نقطة اتخاذ قرار سياسة Workspace) وموارد "سياسة التفويض". يمكنك تحديد هذه الموارد بشكل تعريفي باستخدام ملفات إعداد YAML واستيرادها باستخدام gcloud:

  1. أنشئ ملف إعدادات Agent Gateway (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 باسم لمورد Agent Gateway (مثل ge-agent-gateway) وPROJECT_ID برقم تعريف مشروعك على Google Cloud.

  2. أنشئ ملف إعداد "إضافة التفويض" الذي يشير إلى "نقطة اتخاذ القرار بشأن سياسات 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).

  3. أنشئ ملف إعداد "سياسة التفويض" (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.

  4. استورِد ملفات إعداد 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: التحقّق من إعداد Agent Gateway والحصول على اسم المورد

  1. أدرِج بوابات الوكيل التي تم نشرها للتحقّق من نجاح عملية الاستيراد:

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

  2. يُرجى وصف مورد "بوابة الوكيل":

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

  3. انسخ اسم مورد Agent Gateway الكامل (بالتنسيق projects/PROJECT_ID/locations/LOCATION/agentGateways/AGENT_GATEWAY_NAME، مثلاً projects/my-project/locations/us-central1/agentGateways/ge-agent-gateway).

الخطوة 6: الربط بموفِّر الهوية من Google

  1. في وحدة تحكّم محركات Gen App Builder، انتقِل إلى الإعدادات ثم المصادقة.
  2. ربط المحرّك بموفّر الهوية من Google
  3. للحصول على مستندات إضافية، انتقِل إلى التحكّم في الوصول إلى مصدر بيانات Google Cloud.

الخطوة 7: إعداد Agent Gateway في مثيل Gemini Enterprise

  1. في مثيل Gemini Enterprise (GE)، انتقِل إلى مخازن البيانات المرتبطة.
  2. ضِمن خوادم MCP، اختَر إعداد Agent Gateway.
  3. أدخِل اسم مورد Agent Gateway الكامل الذي تم الحصول عليه في الخطوة 5 (على سبيل المثال، projects/PROJECT_ID/locations/us-central1/agentGateways/ge-agent-gateway).

الخطوة 8: ضبط عناصر التحكّم في وصول وكيل Workspace في "وحدة تحكّم المشرف في Google"

بعد إعداد "بوابة الوكيل" و"نقطة اتخاذ قرار سياسة Workspace"، يمكنك إدارة سياسات وصول الوكيل مباشرةً من "وحدة تحكّم المشرف في Google" باتّباع الخطوات التالية:

  1. في "وحدة تحكّم المشرف في Google"، انتقِل إلى القائمة ثم الوكلاء.
  2. في علامة التبويب الإعدادات، اضبط سياسة الوصول التلقائي لجميع وكلاء Gemini Enterprise. لمزيد من التفاصيل، يُرجى الانتقال إلى مقالة التحكّم في الوصول إلى وكلاء Gemini Enterprise.
  3. في علامة التبويب إدارة الوكلاء، أضِف وكلاء محدّدين إلى قائمة الإدارة لضبط أذونات الوصول الفردية (موثوق به أو محظور). لمزيد من التفاصيل، يُرجى الانتقال إلى مقالة إدارة وكلاء Gemini Enterprise لمستخدمي Workspace.