وثائق مطوّري Nexevo

أرسل taskً، والمنصة تتكفّل بالباقي — توجّهه آليًا إلى النموذج المناسب، وتستدعي الأدوات المناسبة آليًا، وتُدفّق النتيجة عائدًا. لا حاجة لتهيئة أدوات أو اختيار نماذج أو تحديد endpoints.

أرسل task — هذا كل شيء

أرسل حقلًا واحدًا — {task} — إلى POST /v1/workspaces/{workspace_id}/agent/runs. تُوجّهه المنصة آليًا إلى أفضل نموذج، وتستدعي الأدوات المناسبة آليًا، وتُدفّق النتيجة. لن تحتاج أبدًا إلى توصيل الأدوات أو اختيار النماذج أو تحديد endpoints.

bash

curl https://nexevo.ai/v1/workspaces/$NEXEVO_WORKSPACE/agent/runs \
  -H "Authorization: Bearer $NEXEVO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"task": "Summarize today's top AI news."}'
# -> {"run_id": "…", "trace_id": "…"}

يُعيد POST قيم {run_id, trace_id}. تابع GET …/agent/runs/{run_id}/attach لقراءة النتيجة المُدفّقة. راجع Quickstart لتدفّق الثلاث خطوات الكامل.

ما تتكفّل به المنصة نيابةً عنك

Auto-routing — تُقرّر المنصة ما إذا كانت مهمتك تحتاج ردّ محادثة سريعًا أم تشغيل agent مستقل كامل. أنت ترسل إلى endpoint واحد؛ وهي تختار المسار.
Built-in tools — بحث الويب، قاعدة معرفتك، تنفيذ الكود، متصفّح حقيقي، توليد الملفات (PDF/docx/slides) — تُستدعى جميعها آليًا عند الحاجة. لا تتهيّأ ولا تُختار من قِبلك. راجع آلية العمل.
Streamed output — كل خطوة (تخطيط، استدعاءات أدوات، استدلال، الإجابة النهائية) تُدفّق لحظيًا. أنت فقط تقرأ النتيجة.

تحتاج مزيدًا من التحكم؟ (كلها اختياري)

كل معامل آخر هو override اختياري — ثبّت model، عيّن budget_usd، أرفق role متخصصًا، أو اربط التشغيل بمعرفة project. لا شيء منها إلزامي. راجع Agent runs لعرض السطح الكامل.

طرق التكامل

الطريقة	الأنسب لـ	الجهد
`REST API`	تحكّم كامل، أي لغة	أرسل task — راجع Quickstart
`OpenAI / Anthropic SDK`	مستخدم لهذه الـ SDK بالفعل	غيّر base URL + key — راجع Compatibility
`MCP server`	Claude Desktop، Cursor، عملاء MCP	أشر إلى URL واحد — راجع MCP