Chat

أرسل قائمة رسائل ودفّق رد المساعد عائدًا. يختار الموجّه الذكي نموذجًا لك (أو ثبّت واحدًا)؛ وجمّع الأدوار في محادثة لسياق متعدد الأدوار.

استدعاء واحد

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

أرسل قائمة رسائل ودفّق رد المساعد عائدًا. جسم الطلب:

messages (مطلوب) — مصفوفة من {role, content}؛ role هو system أو user أو assistant أو tool.
model — اختياري؛ احذفه (أو اتركه فارغًا) ليدع موجّه Nexevo يختار أفضل نموذج. ثبّته فقط لإجبار تحديد نموذج معيّن.
max_tokens — افتراضي 4096 (1–128000).
temperature — افتراضي 0.7 (0–2).
intent_hint — تلميح قصير لنوع المهمة يتجاوز مصنّف النية عندما يعرف المُتصل نوع الطلب مسبقًا.
conversation_id — ربط هذا الدور تحت محادثة قائمة. عند ضبطه، يُعيد الخادم بناء السجل السابق من قاعدة البيانات، لذا يحتاج messages فقط لحمل دور المستخدم الجديد.
project_id — التشغيل داخل مشروع؛ تُحقن تعليماته وملفات المعرفة من جانب الخادم (مع فحص الوصول).
images — حتى 4 روابط صور (OSS) لمحادثة الرؤية؛ يختار الموجّه نموذجًا يدعم الرؤية ويحوّل آخر دور للمستخدم إلى رسالة متعددة الوسائط.

يُدفّق الرد كـ Server-Sent Events — كائن JSON واحد لكل سطر data:: {delta: "..."} لنص المساعد، و{reasoning: "..."} لسلسلة التفكير، و{context_compacted: {summary, turns_folded}} اختيارية في البداية عند تلخيص الأدوار السابقة، و{error: "..."} عند الفشل. ينتهي البث بـ data: [DONE]. (هذا تنسيق سلكي مختلف عن agent runs، التي تحمل أحداثها حقل type.)

bash

curl -N https://nexevo.ai/v1/workspaces/$NEXEVO_WORKSPACE/chat \
  -H "Authorization: Bearer $NEXEVO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "messages": [{"role": "user", "content": "Explain SEPA Instant in two sentences."}]
  }'

اترك model فارغًا ليدع موجّه Nexevo يختار أفضل نموذج للمهمة (جودة / تكلفة / زمن وصول متوازنة). ثبّت model فقط عندما تحتاج نموذجًا محددًا.

المحادثات (متعددة الأدوار)

للحفاظ على السياق عبر الأدوار، أنشئ محادثة وألحق الرسائل بها:

POST /v1/workspaces/{workspace_id}/conversations — إنشاء موضوع (title، project_id اختياري).
POST /v1/workspaces/{workspace_id}/conversations/{conversation_id}/messages — إلحاق رسالة (role, content).
GET /v1/workspaces/{workspace_id}/conversations / GET /v1/workspaces/{workspace_id}/conversations/{conversation_id} — سرد / جلب المواضيع.
PATCH /v1/workspaces/{workspace_id}/conversations/{conversation_id} — إعادة تسمية / أرشفة.
POST /v1/workspaces/{workspace_id}/conversations/{conversation_id}/share / DELETE /v1/workspaces/{workspace_id}/conversations/{conversation_id}/share — إنشاء / إبطال رابط عام للقراءة فقط.
DELETE /v1/workspaces/{workspace_id}/conversations/{conversation_id} — حذف موضوع.

مرّر project_id للمحادثة لتأريض الموضوع في تعليمات وملفات مشروع.