إطار عمل متعدد الوكلاء مُفعّل بـ MCP لسير العمل الوكيلي المُدار بـ YAML التعريفي، يُستخدم لتدقيق الكود بمساعدة الذكاء الاصطناعي، وفرز الثغرات، والبحث الأمني مع تكامل CodeQL.
وكيل Taskflow الخاص بـ Security Lab هو إطار عمل متعدد الوكلاء (multi-Agent) يدعم MCP لسير عمل وكيلي تصريحي مدفوع بـ YAML.
مبني على OpenAI Agents SDK، ويستخدم Pydantic للتحقق من صحة القواعد النحوية وJinja2 لعرض القوالب.
يستفيد وكيل Taskflow من قواعد نحوية مبنية على YAML على غرار GitHub Workflow لتنفيذ سلسلة من المهام باستخدام مجموعة من الوكلاء.
تتمثل قيمته الأساسية في كونه أداة CLI تتيح للمستخدمين تعريف وبرمجة سير عمل وكيلي بسرعة دون الحاجة إلى كتابة أي كود.
يتم تعريف الوكلاء من خلال الشخصيات، التي تتلقى مهمة لإنجازها، مع مجموعة من الأدوات.
يمكن للوكلاء التعاون لإنجاز تسلسلات من المهام من خلال ما يُسمى taskflows.
يمكنك العثور على نظرة عامة مفصلة عن قواعد taskflow هنا وأمثلة على taskflows هنا.
┌─────────────────────────────────────────────────────┐
│ CLI (cli.py) │
│ Typer-based entry point: -p, -t, -l, -g, -m, --resume, --lint│
└─────────────────────┬───────────────────────────────┘
│
┌─────────────────────▼───────────────────────────────┐
│ Runner (runner.py) │
│ Taskflow execution loop, model resolution, │
│ template rendering, session checkpointing │
└─────────────────────┬───────────────────────────────┘
│
┌─────────────────────▼───────────────────────────────┐
│ MCP Lifecycle (mcp_lifecycle.py) │
│ Server connection, cleanup, process management │
└─────────────────────┬───────────────────────────────┘
│
┌─────────────────────▼───────────────────────────────┐
│ Agent (agent.py) │
│ TaskAgent wrapper, hooks, OpenAI Agents SDK bridge │
└─────────────────────────────────────────────────────┘
Supporting modules:
models.py — Pydantic v2 grammar models (validation)
session.py — Task-level checkpoint / resume
available_tools.py — YAML resource loader with caching
template_utils.py — Jinja2 template environment
mcp_utils.py — MCP client parameter resolution
mcp_transport.py — MCP transport implementations (stdio, streamable)
mcp_prompt.py — System prompt construction
prompt_parser.py — Legacy prompt argument parser
capi.py — AI API endpoint and token management
path_utils.py — Platform-aware data/log directories
يدعم الوكيل كلاً من واجهتي Chat Completions وResponses من OpenAI.
يمكن تكوين نوع واجهة API عالميًا أو لكل نموذج على حدة في ملف model_config:
seclab-taskflow-agent:
version: "1.0"
filetype: model_config
api_type: chat_completions # default for all models
models:
gpt_default: gpt-4.1
gpt_responses: gpt-5.1
model_settings:
gpt_responses:
api_type: responses # override for this model
endpoint: https://api.githubcopilot.com
token: CAPI_TOKEN # env var name containing the API key
يمكن أن يتضمن model_settings الخاص بكل نموذج ما يلي:
api_type — "chat_completions" (الافتراضي) أو "responses"endpoint — تجاوز عنوان URL الأساسي لواجهة API لهذا النموذجtoken — اسم متغير بيئة يحتوي على مفتاح APIيمكن للمشغّل (runner) تشغيل ثلاث مجموعات تطوير برمجيات (SDKs) خلف واجهة موحّدة:
openai_agents (الافتراضي) — مجموعة OpenAI Agents Python SDK. تدعم
عمليات التسليم متعددة الشخصيات (multi-personality handoffs)، وكلاً من chat_completions وresponses
لنوع api_type، وtemperature، وparallel_tool_calls،
وexclude_from_context، وMCP عبر stdio وSSE وHTTP القابل للبث.copilot_sdk — مجموعة GitHub Copilot Python SDK. تدعم البث،
وreasoning_effort، وMCP عبر stdio/SSE/HTTP، والتحكم في أذونات
كل أداة على حدة. تختار مجموعة SDK بروتوكول الاتصال الخاص بها لكل نموذج، لذا لا يتم
احترام حقل api_type في YAML؛ كما أن عمليات التسليم متعددة الشخصيات،
وtemperature، وparallel_tool_calls غير متاحة كذلك.
تفشل مهام سير العمل (taskflows) التي تستخدم حقولاً غير مدعومة عند التحميل مع
خطأ BackendCapabilityError يذكر الحقل المخالف.anthropic_sdk — مجموعة Anthropic Python SDK، التي تشغّل واجهة
Messages API الأصلية (/v1/messages). تدعم البث، واستدعاء الأدوات عبر
MCP، والتفكير التكيفي مع reasoning.effort قابل للتكوين
(low، medium، high، max). لا يتم دعم عمليات التسليم (Handoffs).
مصممة للاستخدام مع نقطة نهاية Anthropic الخاصة بـ CAPI؛ يستخدم المصادقة عبر
Authorization: Bearer (وليس x-api-key).أولوية الاختيار (من الأعلى إلى الأدنى):
backend: الخاص بكل مهمة في كتلة model_settings الخاصة بالمهمة نفسها (يتجاوز
القيمة على مستوى النموذج لتلك المهمة الواحدة؛ انظر _resolve_task_model()).backend: الخاص بكل نموذج في model_settings الخاصة بتكوين النموذج (يسمح
بواجهات خلفية مختلطة في مهمة سير عمل واحدة).backend: على المستوى الأعلى من مستند تكوين النموذج
(الافتراضي العام).SECLAB_TASKFLOW_BACKEND.openai_agents.seclab-taskflow-agent:
version: "1.0"
filetype: model_config
models:
code_analysis: claude-opus-4.7
general_tasks: gpt-5.4-mini
model_settings:
code_analysis:
api_type: messages
backend: anthropic_sdk
reasoning:
effort: high
general_tasks:
api_type: responses
backend: openai_agents
يقوم كل محوّل خلفية (backend adapter) بترجمة الاستثناءات الخاصة بـ SDK إلى التسلسل الهرمي المحايد في sdk/errors.py، بحيث يطبّق المشغّل سياسة إعادة المحاولة دون استيراد أي SDK. إضافة خلفية تعني ترجمة أخطائها أيضًا؛ ويفرض test_every_backend_adapter_translates_transport_failures ذلك عبر السجل.
تتطلب أعطال النقل معالجة صريحة ويسهل تفويتها. تُغلّف SDKs الخاصة بالمورّد httpx فقط حول الاستدعاء الذي يرسل الطلب، ومع البث فإنه يعود بمجرد وصول ترويسات الاستجابة بينما يُكرَّر على الجسم بعد ذلك. لذلك فإن اتصالًا ينقطع في منتصف الجسم يظهر كخطأ httpx مجرّد، لا في التسلسل الهرمي الخاص بـ SDK ولا في الدوال المدمجة. يُعدّد sdk/_transport.py الأخطاء القابلة لإعادة المحاولة، ويقوم كل محوّل بتعيينها إلى BackendTransportError. تُعدَّد المجموعة بدلًا من التقاط httpx.TransportError بالكامل، لأن LocalProtocolError يعني أن الطلب كان مشوّهًا وUnsupportedProtocol حتمي.
لإعادة المحاولة مالك واحد: الفرع، في _deploy_with_transport_retry. وهو المستوى الوحيد الذي يعيد ضبط حالة الالتقاط بين المحاولات، بحيث لا يمكن نشر نتيجة أداة سُجّلت قبل فشل مرتين أو أن تصبح المخرجات المسمّاة للمهمة، وهو يعيد تشغيل الفرع الذي فشل فقط بدلًا من الفروع الشقيقة التي ربما كتبت بالفعل إلى أنظمة خارجية. تُقيَّد إعادة المحاولات بـ TASK_RETRY_LIMIT مع تراجع خطي من TASK_RETRY_BACKOFF.
لا شيء فوق ذلك أو دونه يعيد محاولة الفئات نفسها. حلقات إعادة المحاولة تتداخل، لذا فإن فئة تُلتقط على مستويين تضاعف المحاولات بدلًا من جمعها، وكل محاولة تعيد تشغيل المحادثة بأكملها. يعيد drive_backend_stream محاولة BackendRateLimitError فقط، حيث لم يُصدَر أي محتوى بعد، ويأخذ دالة رد نداء reset_capture بحيث لا يمكن حتى لهذا المسار أن يترك نتائج محاولة جزئية خلفه.
لا تُعاد محاولة الأعطال الحتمية على الإطلاق. ستكرّر BackendMaxTurnsError وBackendBadRequestError وBackendCapabilityError الفشل نفسه مع التراجع، لذا يبلّغ عنها deploy_task_agents ويعود.