Chat

Hantar senarai mesej dan strimkan balas balas pembantu. Penghala pintar memilih model untuk anda (atau pin satu); kumpulkan giliran menjadi perbualan untuk konteks berbilang-giliran.

Satu panggilan

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

hantar senarai mesej dan strimkan balas pembantu. Body permintaan:

messages (wajib) — tatasusunan {role, content}; role ialah system, user, assistant, atau tool.
model — pilihan; tinggalkan (atau biarkan kosong) untuk membenarkan penghala Nexevo memilih model terbaik. Pin hanya untuk memaksa yang tertentu.
max_tokens — lalai 4096 (1–128000).
temperature — lalai 0.7 (0–2).
intent_hint — pembayang jenis-tugasan pendek yang memintas pengelas niat apabila pemanggil sudah tahu jenis permintaan.
conversation_id — jalinkan giliran ini di bawah perbualan sedia ada. Apabila ditetapkan, pelayan membina semula sejarah terdahulu daripada pangkalan data, jadi messages hanya perlu membawa giliran pengguna baharu.
project_id — jalankan dalam project; arahan dan fail pengetahuannya disuntik di pelayan (diakses-disemak).
images — sehingga 4 URL imej (OSS) untuk sembang penglihatan; penghala memilih model berkemampuan penglihatan dan menukar giliran pengguna terakhir menjadi mesej multimodal.

Balas distrimkan sebagai Server-Sent Events — satu objek JSON setiap baris data:: {delta: "..."} untuk teks pembantu, {reasoning: "..."} untuk rantai-fikir, satu {context_compacted: {summary, turns_folded}} pilihan di awal apabila giliran terdahulu diringkaskan, dan {error: "..."} apabila gagal. Strim berakhir dengan data: [DONE]. (Ini ialah format wayar berbeza daripada agent runs, yang acaranya membawa medan 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."}]
  }'

Biarkan model kosong untuk membenarkan penghala Nexevo memilih model terbaik untuk tugasan (kualiti / kos / kependaman seimbang). Pin model hanya apabila anda perlukan yang tertentu.

Perbualan (berbilang-giliran)

Untuk mengekalkan konteks merentasi giliran, cipta perbualan dan tambah mesej kepadanya:

POST /v1/workspaces/{workspace_id}/conversations — cipta thread (title, project_id pilihan).
POST /v1/workspaces/{workspace_id}/conversations/{conversation_id}/messages — tambah mesej (role, content).
GET /v1/workspaces/{workspace_id}/conversations / GET /v1/workspaces/{workspace_id}/conversations/{conversation_id} — senarai / ambil thread.
PATCH /v1/workspaces/{workspace_id}/conversations/{conversation_id} — namakan semula / arkib.
POST /v1/workspaces/{workspace_id}/conversations/{conversation_id}/share / DELETE /v1/workspaces/{workspace_id}/conversations/{conversation_id}/share — cipta / tarik balik pautan awam baca-sahaja.
DELETE /v1/workspaces/{workspace_id}/conversations/{conversation_id} — padam thread.

Hantar project_id perbualan untuk membumikan thread dalam arahan + fail project.