Projects

يجمّع المشروع تعليمات قائمة وملفات مرفوعة في سياق مُسماً وقابل لإعادة الاستخدام. أشر إلى مشروع من تشغيل agent أو محادثة، ويُحقن ذلك السياق تلقائيًا.

إنشاء مشروع

POST/v1/workspaces/{workspace_id}/projects —

الحقول: name (مطلوب)، description، instructions (الإرشاد القائم المُطبَّق كلما كان المشروع في النطاق).

bash

curl https://nexevo.ai/v1/workspaces/$NEXEVO_WORKSPACE/projects \
  -H "Authorization: Bearer $NEXEVO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Acme onboarding",
    "description": "Support context for the Acme account",
    "instructions": "Always cite the contract section. Currency is USD."
  }'

الملفات

POST/v1/workspaces/{workspace_id}/projects/{project_id}/files —

رفع ملف (متعدد الأجزاء) إلى المشروع.

GET/v1/workspaces/{workspace_id}/projects/{project_id}/files —

سرد ملفات المشروع.

GET/v1/workspaces/{workspace_id}/projects/{project_id}/context —

السياق المُجمَّع (التعليمات + ملخّص الملفات) الذي يتلقّاه الـ agent.

استخدام مشروع

مرّر project_id عند بدء agent run أو إنشاء محادثة — تُحقن تعليمات وملفات المشروع من جانب الخادم، لذا يفكّر الـ agent بذلك السياق دون إعادة إرسالك له في كل استدعاء.

bash

curl -N https://nexevo.ai/v1/workspaces/$NEXEVO_WORKSPACE/agent/runs \
  -H "Authorization: Bearer $NEXEVO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"task": "Draft the renewal email", "project_id": "PROJECT_UUID"}'

الإدارة

GET/v1/workspaces/{workspace_id}/projects —

PATCH/v1/workspaces/{workspace_id}/projects/{project_id} —

DELETE/v1/workspaces/{workspace_id}/projects/{project_id} —

سرد المشاريع وتحديثها وحذفها.

المشاريع مخصصة للسياق القائم الذي تعيد استخدامه. للحقائق لمرة واحدة التي يجب أن تتذكّرها مساحة العمل عبر كل المهام، استخدم Memory بدلًا من ذلك.