system-prompts-and-models-o.../ai-agents/README.md
Sami Assiri 39c6334ff6 feat: expand to 30-agent Autonomous Enterprise OS — add 10 strategic agents for partnerships, M&A, contracts, BizDev, supply chain, customer success, dynamic pricing, marketing automation, finance, and competitive intelligence
- 10 new agent prompt files with full JSON schemas
- Router: 30+ new events covering partnerships, acquisitions, contracts, supply chain, customer health, pricing, campaigns, invoicing, competitor alerts
- Executor: full registration (filenames, temperature, tokens, escalation rules, action dispatch)
- Health check: updated to validate all 30 prompts
- Tests: updated and passing (7/7)
- README: rewritten for Enterprise OS vision
2026-04-16 06:49:21 +03:00

124 lines
6.5 KiB
Markdown

# 🤖 Dealix Autonomous Enterprise OS — AI Agent System
## نظرة عامة
30 وكيل AI متخصص يعملون بشكل مستقل بالكامل لإدارة **كل جوانب عمليات الشركة** — من المبيعات والشراكات والاستحواذات والتسويق والمالية وسلسلة التوريد والعقود وتطوير الأعمال — نيابةً عن الشركات والمتاجر في السوق السعودي والخليجي والعالمي.
> **الرؤية**: نظام تشغيل مستقل (Level 5 Autonomy) يدير ويشغّل ويوسّع الشركات بشكل كامل 24/7.
## البنية
```
ai-agents/prompts/ ← 30 ملف تعليمات (System Prompts)
salesflow-saas/backend/
├── app/services/agents/
│ ├── __init__.py ← Module exports
│ ├── router.py ← Event → Agent routing (60+ events)
│ ├── executor.py ← LLM execution engine
│ ├── autonomous_pipeline.py ← 11-stage state machine
│ ├── action_dispatcher.py ← 20+ action types → services
│ ├── manus_orchestrator.py ← Multi-agent orchestration
│ ├── memory.py ← Agent memory & context
│ └── quality_gate.py ← Output quality validation
├── app/api/v1/
│ ├── pipeline_engine.py ← Pipeline REST API
│ └── agent_health.py ← Health check + diagnostics
├── app/workers/
│ ├── agent_tasks.py ← Celery agent tasks
│ └── pipeline_tasks.py ← Celery pipeline tasks
└── app/flows/
├── prospecting_durable_flow.py ← Multi-channel prospecting
└── self_improvement_flow.py ← 6-phase self-optimization
```
## الوكلاء (30 وكيل)
### 🔷 المبيعات والتواصل (20 وكيل أساسي)
| # | الوكيل | الملف | المهمة |
|---|--------|-------|--------|
| 1 | Closer | `closer-agent.md` | إغلاق الصفقات |
| 2 | Lead Qualification | `lead-qualification-agent.md` | تأهيل العملاء |
| 3 | Arabic WhatsApp | `arabic-whatsapp-agent.md` | محادثات واتساب عربية |
| 4 | English Conversation | `english-conversation-agent.md` | محادثات إنجليزية |
| 5 | Outreach Writer | `outreach-message-writer.md` | كتابة رسائل تواصل |
| 6 | Meeting Booking | `meeting-booking-agent.md` | حجز اجتماعات |
| 7 | Objection Handler | `objection-handling-agent.md` | معالجة اعتراضات |
| 8 | Proposal Drafter | `proposal-drafting-agent.md` | صياغة عروض |
| 9 | Sector Strategist | `sector-sales-strategist.md` | استراتيجية قطاعية |
| 10 | Knowledge Retrieval | `knowledge-retrieval-agent.md` | استرجاع معرفة |
| 11 | Compliance Reviewer | `compliance-reviewer.md` | مراجعة امتثال |
| 12 | Fraud Reviewer | `fraud-reviewer.md` | كشف احتيال |
| 13 | Revenue Attribution | `revenue-attribution-agent.md` | تتبع إيرادات |
| 14 | Management Summary | `management-summary-agent.md` | ملخصات إدارية |
| 15 | QA Reviewer | `conversation-qa-reviewer.md` | مراجعة جودة |
| 16 | Affiliate Evaluator | `affiliate-recruitment-evaluator.md` | تقييم مسوقين |
| 17 | Onboarding Coach | `affiliate-onboarding-coach.md` | تدريب مسوقين |
| 18 | Guarantee Reviewer | `guarantee-claim-reviewer.md` | مراجعة ضمان |
| 19 | Voice Call | `voice-call-flow-agent.md` | مكالمات هاتفية |
| 20 | AI Rehearsal | `ai-rehearsal-agent.md` | تحضير اجتماعات |
### 🔶 النمو الاستراتيجي والمؤسسي (10 وكلاء متقدمين)
| # | الوكيل | الملف | المهمة |
|---|--------|-------|--------|
| 21 | Partnership Scout | `partnership-scout-agent.md` | استكشاف وبناء الشراكات (توزيع، JV، White-label) |
| 22 | M&A Growth | `ma-growth-agent.md` | الاستحواذات والدمج والتوسع الجغرافي |
| 23 | Contract Lifecycle | `contract-lifecycle-agent.md` | إدارة دورة حياة العقود |
| 24 | Business Development | `business-development-agent.md` | تطوير الأعمال واكتشاف الفرص |
| 25 | Supply Chain | `supply-chain-agent.md` | إدارة سلسلة التوريد والمشتريات |
| 26 | Customer Success | `customer-success-agent.md` | نجاح العملاء والاحتفاظ |
| 27 | Dynamic Pricing | `dynamic-pricing-agent.md` | التسعير الذكي الديناميكي |
| 28 | Marketing Automation | `marketing-automation-agent.md` | التسويق المؤتمت متعدد القنوات |
| 29 | Finance Automation | `finance-automation-agent.md` | المالية والفواتير والتحصيل |
| 30 | Competitive Intelligence | `competitive-intelligence-agent.md` | الاستخبارات التنافسية |
## مراحل Pipeline
```
NEW → QUALIFYING → QUALIFIED → OUTREACH → MEETING_SCHEDULED →
MEETING_PREP → NEGOTIATION → CLOSING → WON / LOST / NURTURING
```
## أنواع الشراكات المدعومة
| النوع | الوكيل | الوصف |
|-------|--------|-------|
| توزيع | Partnership Scout | الشريك يبيع منتجاتنا |
| تقنية | Partnership Scout | تكامل API |
| Joint Venture | M&A Growth | كيان مشترك |
| White-label | Partnership Scout | إعادة تغليف |
| Franchise | M&A Growth | امتياز تجاري |
| M&A | M&A Growth | اندماج واستحواذ |
| Referral | Partnership Scout | إحالات |
| Co-Marketing | Marketing Automation | حملات مشتركة |
## API Endpoints
```bash
# معالجة lead كامل
POST /api/v1/pipeline/process-lead?tenant_id=xxx
# تقدم يدوي
POST /api/v1/pipeline/advance-stage?tenant_id=xxx
# فحص صحة النظام (30 وكيل)
GET /api/v1/agent-health/status
# تحسين ذاتي
POST /api/v1/agent-health/self-improve
# تشغيل وكيل مباشرة
POST /api/v1/pipeline/run-agent/{agent_type}?tenant_id=xxx
```
## إضافة وكيل جديد
1. أنشئ ملف `.md` في `ai-agents/prompts/`
2. أضف الوكيل في `router.py``AGENT_REGISTRY`
3. أضف الـ mapping في `executor.py``filename_map`
4. أضف الـ actions في `executor.py``_build_actions`
5. أضف الـ temperature/tokens في `executor.py`
6. أضف الملف في `agent_health.py``expected_files` + `filename_map`
7. شغل `python tests/test_agent_system.py` للتحقق