Quickstart
ثلاث خطوات إلى أول تشغيل agent. سترسل task وتقرأ النتيجة المُدفّقة — والمنصة تتكفّل بكل شيء آخر.
1. احصل على مفتاح API
في التطبيق، افتح Settings → API keys وأنشئ مفتاحًا. المفاتيح مرتبطة بمساحة العمل (sk-ws-…). ويمكنك أيضًا إنشاء واحد عبر الـ API:
POST/v1/workspaces/{workspace_id}/api-keys — أنشئ مفتاح API جديدًا مرتبطًا بمساحة العمل هذه.
export NEXEVO_API_KEY="sk-ws-..."
export NEXEVO_WORKSPACE="00000000-0000-0000-0000-000000000000"2. أرسل task
هذا هو التكامل بأكمله. حقل واحد — task. تختار المنصة النموذج، وتستدعي أي أدوات تحتاجها المهمة، وتُدفّق النتيجة.
curl https://nexevo.ai/v1/workspaces/$NEXEVO_WORKSPACE/agent/runs \
-H "Authorization: Bearer $NEXEVO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"task": "Find the 3 largest cross-border payment providers in SE Asia and summarize each in one line."}'
# -> {"run_id": "…", "trace_id": "…"}يُعيد {run_id, trace_id}. التشغيل الآن قيد التنفيذ — لا تحتاج إلى البقاء متصلًا.
3. اقرأ النتيجة
curl -N https://nexevo.ai/v1/workspaces/$NEXEVO_WORKSPACE/agent/runs/$RUN_ID/attach \
-H "Authorization: Bearer $NEXEVO_API_KEY"كل سطر data: هو حدث — step_start، tool_call، tool_result، llm_delta (نص مُدفّق)، وأخيرًا run_end (يحوي final_text). ينتهي البث بعد الإطار الختامي.
هذا كل شيء — لقد أكملت تكاملًا كاملًا. تعاملت المنصة آليًا مع اختيار النموذج، والبحث في الويب، وتوليف النتيجة. أنت لم تُهيّئ شيئًا سوى الـ task نفسه. لمزيد من السيناريوهات (OpenAI SDK، أسئلة وأجوبة على قاعدة المعرفة، تقارير مجدولة)، راجع Cookbook.
الخطوات التالية
آلية العمل — افهم auto-routing + الأدوات المدمجة
Agent runs — سطح الـ API الكامل
Cookbook — وصفات جاهزة للنسخ واللصق