إشعار Dynatrace → Agent Builder يستقبل التنبيه → Gemini يحلل → أدوات MCP تنفذ → تحييد التهديد
       1 ثانية                  2 ثانية                  8 ثوانٍ             15 ثانية              25 ثانية إجمالاً

┌──────────────────────────────────────────────────────────────────────┐
│                         بيئة التجربة المعزولة                         │
│                                                                      │
│   ┌─────────────┐   100–1000 طلب/ثانية  ┌──────────────────────────┐ │
│   │  المهاجم    │ ──────────────────────►│    victim-service        │ │
│   │ (DDoS/SQLi) │                        │    المنفذ 8080           │ │
│   └─────────────┘                        │    /admin/* واجهة التحكم  │ │
│                                          └────────────┬─────────────┘ │
└───────────────────────────────────────────────────────│────────────────┘
                                                        │ المقاييس + إشعار الشذوذ
                   ┌────────────────────────────────────▼─────────────────┐
                   │         Dynatrace Mock (محرك الشذوذ)                  │
                   │  درجة مخاطر التهديد ← يرسل POST /alerts/simulate       │
                   └────────────────────────┬─────────────────────────────┘
                                            │ الإشعار
          ┌─────────────────────────────────▼──────────────────────────────┐
          │          Google Cloud Agent Builder (Vertex AI Agent)          │
          │  ┌──────────────────────────────────────────────────────────┐  │
          │  │  Gemini 2.0 Flash — يحلل سياق التهديد                     │  │
          │  │  وصف الأدوات — يتم جلبها ديناميكياً من MCP                 │  │
          │  │  بوابة الإنسان في الحلقة — تتوقف إذا كانت الثقة < الحد الأدنى │ │
          │  └──────────────────────────────────────────────────────────┘  │
          └──────────────┬─────────────────────────┬───────────────────────┘
                         │ استدعاءات REST           │ كتابة التدقيق
         ┌───────────────▼──────┐      ┌────────────▼──────────┐
         │  خادم MCP :8001      │      │  MongoDB 7.0 Atlas    │
         │  11 أداة حقيقية      │      │  الحوادث + الآثار     │
         └───────────┬──────────┘      └───────────────────────┘
                     │ يعمل على البنية التحتية الحية
         ┌───────────▼──────────┐
         │  FastAPI :8000       │
         │  victim-service :8080│
         └──────────────────────┘

                   ┌──────────────────────────────────────────────────┐
                   │              مكدس قابلية المراقبة                  │
                   │  مجمع OTel ──► Jaeger (آثار موزعة)                │
                   │  Prometheus ──────────► Grafana                   │
                   └──────────────────────────────────────────────────┘

.\attack.production.ps1 status   # تحقق من أن جميع الخدمات سليمة
.\attack.production.ps1 ddos     # DDoS — Gemini يحجب عناوين IP + يحدد المعدل
.\attack.production.ps1 sql      # SQL Injection — Gemini يفعل WAF
.\attack.production.ps1 brute    # Brute Force — Gemini يحجب عناوين IP المصدر
.\attack.production.ps1 stop     # إعادة تعيين الدفاعات

class SentinelAgent(reasoning_engines.Queryable):

    def set_up(self):
        # أدوات MCP كـ FunctionDeclarations من Vertex AI — Gemini يختار وقت التشغيل
        mcp_tools = Tool(function_declarations=[
            FunctionDeclaration(name="block_ip_address", ...),
            FunctionDeclaration(name="activate_waf", ...),
            FunctionDeclaration(name="rate_limit_requests", ...),
            FunctionDeclaration(name="scale_service", ...),
            FunctionDeclaration(name="collect_forensic_logs", ...),
            FunctionDeclaration(name="analyze_attack_pattern", ...),
        ])
        self._model = GenerativeModel("gemini-2.0-flash-001", tools=[mcp_tools])
        self._chat = self._model.start_chat()

    def query(self, *, incident: dict) -> dict:
        # نقطة الدخول — Agent Builder يستدعي هذا لكل إشعار Dynatrace
        response = self._chat.send_message(threat_prompt(incident))
        tool_calls = [{"name": p.function_call.name, "args": dict(p.function_call.args)}
                      for p in response.candidates[0].content.parts if p.function_call]
        return {"engine": "agent_builder", "tool_calls": tool_calls, ...}

# اختبار محلي (لا حاجة لـ GCP مع الواجهة الخلفية google_ai_studio)
python scripts/deploy_agent_builder.py --test-only

# النشر إلى نقطة نهاية Agent Builder المُدارة
python scripts/deploy_agent_builder.py --project my-gcp-project

# .env
GEMINI_BACKEND=agent_builder
GOOGLE_CLOUD_PROJECT=my-gcp-project
VERTEX_LOCATION=us-central1

GET /mcp/tools  →  يعيد 11 واصف أداة  →  Gemini يختار الأدوات ويستدعيها

docker compose up -d --build

cd simulacion
docker compose up -d victim-service
cd ..

docker compose ps
# المتوقع: 8 خدمات قيد التشغيل/سليمة

curl http://localhost:8000/health
# المتوقع: {"status": "healthy", "service": "SentinelMCP", ...}

.\attack.ps1 ddos        # هجوم DDoS (افتراضي)
.\attack.ps1 sql         # SQL Injection
.\attack.ps1 brute       # Brute Force
.\attack.ps1 stop        # إيقاف الهجوم + إعادة تعيين الدفاعات
.\attack.ps1 status      # التحقق من حالة النظام

http://localhost:8000/dashboard

# تحرير .env
GOOGLE_API_KEY=AIza...your_key_here
GEMINI_BACKEND=google_ai_studio

gcloud auth application-default login
.\scripts\setup_gcloud.ps1   # يعدّل المشروع، ينشئ مفتاح SA، يحدث .env تلقائياً

GET http://localhost:8001/mcp/tools

sentinel_mcp/
├── api/              نواة FastAPI — المسارات، المخططات، واجهة المستخدم للوحة القيادة
├── agent/            محرك القرار + مزودو LLM (Gemini 2.0 Flash, Vertex AI)
├── mcp_server/       خادم MCP + تطبيقات الأدوات الـ 11
├── services/         خدمة الحوادث، منسق المعالجة، حاسبة التهديدات
├── observability/    مزودو OTel / Dynatrace / SigNoz
└── core/             الإعداد، التسجيل، الاستثناءات

simulacion/
├── victim-service/   خدمة هدف FastAPI مع واجهة التحكم /admin/*
└── attacker/         محرك الهجوم Python (DDoS / SQLi / brute force)

docker/
├── prometheus.yml    إعداد الجمع (victim-service بفاصل 5 ثوانٍ)
└── grafana/          لوحة تحكم مزودة تلقائياً — شاهد بستة أقسام للبنية التحتية