الأدوار المتخصصة (agency-agents)

أعطِ تشغيل الـ agent هوية متخصصة — محامي، محلل بيانات، حارس علامة تجارية — مستمدة من مكتبة agency-agents المُضمّنة. يُشكّل الدور من هو الـ agent في تلك المهمة (التخصص، القواعد، النبرة)، قبل الـ prompt الأساسي.

ما الذي يفعله الدور

إنّ الدور المتخصص (أي persona) هو مفتاح هوية. عندما تمرّر slug دور إلى تشغيل agent، يتبنّى الـ agent منظور ذلك التخصص للمهمة — معرفته بالنطاق، وقواعد عمله، وأسلوب تواصله — مع الاحتفاظ بكامل قدرته على الأدوات وعلامة Nexevo. يختلف ذلك عن skill، وهو دليل سير عمل يُطبّقه الـ agent: فالدور هو من يكون الـ agent.

الأدوار اختيارية ويدوية بالكامل. دون اختيار دور، يعمل الـ agent كـ Nexevo عادي. تختار واحدًا من المكتبة (أو من قائمة أدوار المؤلّف في التطبيق)؛ لا يوجد توجيه تلقائي إلى الأدوار.

سرد الأدوار المتاحة

GET/v1/workspaces/{workspace_id}/skill-library —

مكتبة الـ skills + الأدوار في مساحة العمل. الإدخالات ذات kind: "agency" هي أدوار متخصصة؛ وkind: "official" / "custom" هي skills. رشّح على kind للحصول على الأدوار فقط.

bash

curl https://nexevo.ai/v1/workspaces/$NEXEVO_WORKSPACE/skill-library \
  -H "Authorization: Bearer $NEXEVO_API_KEY"
# [
#   {
#     "slug": "engineering-ai-engineer",
#     "name": "AI Engineer",
#     "description": "Expert AI/ML engineer ...",
#     "kind": "agency",
#     "category": "engineering",
#     "emoji": "🤖",
#     "division": "engineering",
#     "division_label": "Engineering",
#     "enabled": true,
#     ...
#   },
#   ...
# ]

يحمل كل إدخال دور: slug (المعرّف الذي تمرّره إلى تشغيل)، وname، وdescription، وcategory / division (مجال الدور — هندسة، تسويق، مالية، تصميم…)، وبيانات العرض (emoji, division_label, division_color). تمتد المكتبة على 18 مجالًا بعشرات الأدوار المتخصصة — من engineering-backend-architect إلى design-brand-guardian إلى finance-cfo.

التشغيل بدور

مرّر slug الدور كـ persona_slug في agent run. تُحقن هوية الدور كرأس على نظام الـ prompt؛ ويحتفظ الـ agent بكل أدواته.

bash

curl https://nexevo.ai/v1/workspaces/$NEXEVO_WORKSPACE/agent/runs \
  -H "Authorization: Bearer $NEXEVO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "task": "Review our checkout flow for drop-off points and propose 3 fixes.",
    "persona_slug": "design-ux-architect"
  }'
# -> {"run_id": "…", "trace_id": "…"}

دور واحد على الأكثر لكل تشغيل. persona_slug المفقود أو المعطّل يتدهور بصمت إلى هوية Nexevo الأساسية — لا يفشل التشغيل أبدًا بسبب البحث عن دور.

الدور هوية، وليس قائمة بيضاء للأدوات. يحتفظ الـ agent بكامل قدرته (الويب، الكود، المتصفح، الموصلات)؛ يُشكّل الدور كيف يفكّر ويتواصل، لا ماذا يستطيع أن يفعل. اقرن الدور بـ skills للحصول على أقوى نتيجة — هوية نطاقية بالإضافة إلى دليل سير عمل.