system-prompts-and-models-o.../dealix/docs/AGENT_WORKFLOW_ARCHITECTURE.md
Sami Assiri b13cb389cc feat(dealix): sync full Dealix package to repo
- API routers, ACA modules, integrations (draft operators)
- Docs, landing pages, scripts (launch readiness, scorecard)
- Tests and CI workflow updates for Dealix

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-05-01 21:01:17 +03:00

2.2 KiB

Agent workflow architecture — Dealix (conceptual)

Scope: تصميم مفاهيمي لمسارات وكلاء متينة بدون إضافة langgraph أو تبعيات تنفيذ معقدة إلى requirements.txt حتى موافقة صريحة على التكلفة والصيانة.

الأهداف التشغيلية

  1. Durable execution: إعادة تشغيل آمنة بعد انقطاع؛ حالة الخطوة محفوظة خارج الذاكرة فقط.
  2. Human-in-the-loop: نقاط توقف عند الموافقة على إرسال خارجي، دفع، أو رسائل واتساب.
  3. Tracing: ربط كل إجراء بـ tenant_id، correlation_id، ومسار القرار في action_policy / سجلات المنصة.

طبقات حالية في الريبو

  • Innovation: مسارات عرض و Kill features deterministic تحت /api/v1/innovation/*.
  • Platform Services: سياسة + inbox + بوابة أدوات بدون live تحت /api/v1/platform/*.
  • Intelligence layer: مخرجات JSON خفيفة تحت /api/v1/intelligence/*.

مسار مقترح (مستقبلي)

flowchart LR
  subgraph ingest [Ingest]
    W[Webhook]
  end
  subgraph platform [Platform]
    EB[event_bus]
    UI[unified_inbox]
    AP[action_policy]
    TG[tool_gateway]
  end
  subgraph human [Human]
    H[Approval UI]
  end
  W --> EB --> UI --> AP
  AP -->|approved draft| TG
  AP -->|needs approval| H
  H --> TG

ماذا يضيف LangGraph لاحقاً (إن وُفقت)

  • بيان حالة آلة صريح (nodes/edges) بدل سلاسل if طويلة.
  • استئناف من عقدة بعد موافقة بشرية.
  • دمج أدوات خارجية خلف نفس tool_gateway مع سياسات موحّدة.

مخاطر التبني المبكر

  • ازدواج مع منطق الـ API الحالي.
  • تعقيد التشغيل والمراقبة قبل إثبات الـ MVP مع العملاء.

المراجع الداخلية