نستقطب شركاء تصميم للقطاعات الجديدة — افتح مجالًا جديدًا، واحصل على المنصة بنصف السعر

Quickstart

ثلاث خطوات إلى أول تشغيل agent. سترسل task وتقرأ النتيجة المُدفّقة — والمنصة تتكفّل بكل شيء آخر.

1. احصل على مفتاح API

في التطبيق، افتح Settings → API keys وأنشئ مفتاحًا. المفاتيح مرتبطة بمساحة العمل (sk-ws-…). ويمكنك أيضًا إنشاء واحد عبر الـ API:

POST/v1/workspaces/{workspace_id}/api-keys

أنشئ مفتاح API جديدًا مرتبطًا بمساحة العمل هذه.

bash
export NEXEVO_API_KEY="sk-ws-..."
export NEXEVO_WORKSPACE="00000000-0000-0000-0000-000000000000"

2. أرسل task

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

bash
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. اقرأ النتيجة

bash
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.

الخطوات التالية