الانتقال إلى المحتوى الرئيسي
لم تُحدَّث ترجمة هذه الصفحة بعد، والنسخة الإنجليزية هي الأحدث والأصح، وقد يختلف المحتوى أدناه عنها. اقرأ النسخة الإنجليزية.
إذا كانت الواجهة الأمامية (front end) لديك تستخدم أصلًا الـ UI hooks في Vercel AI SDK (useChat من @ai-sdk/react ومثيلاتها في Vue وSvelte وAngular)، فيمكنك إبقاؤها على حالها وتشغيل Lousho agent خلف الـ route. ثلاث دوال مُصدَّرة من جذر الحزمة تتولى التحويل. لا تستورد شيئًا من ai، ولا تستخدم أي node:* module، وتعمل على Node وWorkers وأي runtime مبني على Fetch.

Route handler

بادئة الـ model vendor/ هي التي تختار الـ provider؛ ومع OpenRouter استخدم openrouter/<vendor>/<model> (مثلًا openrouter/openai/gpt-4o-mini).
بدون session (جلسة)، مرّر كل الرسائل بدلها: toUIMessageStreamResponse(agent.stream(fromUIMessages(messages))).

Client

هذا المقتطف يستهدف ai 6 و7 (useChat يأخذ transport، وsendMessage يرسل الرسالة). على ai 4 — وهو peer مدعوم أيضًا — useChat({ api: '/api/chat' }) يأخذ الـ endpoint مباشرة ويرجع input وhandleInputChange وhandleSubmit بدل sendMessage؛ أما ai 5 فليس ضمن الـ peer range.

Event mapping

الـ snapshots التي تأتي من streaming tool تصل كـ preliminary outputs، وuseChat يعرضها كـ output للـ tool part مع preliminary: true. أما الـ tool.done الذي يليها فبدون preliminary، وهو الـ output النهائي. الأحداث التي ليس لها مقابل في الـ UI — retries وcompaction وقرارات الصلاحيات وguardrails وغيرها — وأحداث الـ sub-agents لا تصل. وfinishReason في الـ finish chunk هو الخاص بـ AI SDK (stop، length، content-filter، tool-calls، error؛ وأي قيمة أخرى مثل awaiting-approval أو max-steps تتحوّل إلى other).

Usage والتكلفة

الـ usage يُوضع في messageMetadata الخاصة بالـ finish chunk، فتجده في message.metadata على رسالة الـ assistant المكتملة:
usage هو الـ AgentEventUsage للـ run (يغيب إذا فشل الـ run)؛ وloushoFinishReason هو الـ finish reason الخاص بالـ run نفسه، بدون mapping.

Approvals وask_question

الـ tool الذي يحتاج approval (موافقة)، أو استدعاء ask_question، يوقّف الـ run: الـ stream ينتهي بـ finish مع loushoFinishReason: "awaiting-approval"، بعد data part مخصص يعرضه useChat كـ part من النوع data-lousho-approval:
kind وquestion موجودان فقط في حالة ask_question؛ أما الـ tool الذي ينتظر تسجيل دخول OAuth فيحمل بدلها kind: 'sign-in' وsignIn: { provider, displayName?, url } — اعرض الرابط، وعندما يُعيد الـ provider المستخدم، اعتمده («سجّلت الدخول»). ارسم الـ part بأزرارك وأجب عليه عبر الـ approvals route في الـ session API (POST /chat/:sessionId/approvals/:approvalId، راجع Sessions وApprovals): { "approved": true } أو { "approved": false, "note": "..." } للـ tool، و{ "answer": "prod" } للسؤال. الاستجابة هي تكملة الـ run كـ event stream: يمكنك قراءته بالـ parser الذي توفره الـ UI bindings، أو تجاهله واستدعاء sendMessage من useChat من جديد؛ أو في الـ route لديك، استدعِ agent.approvals.streamResolve() / streamAnswer() وأرجع toUIMessageStreamResponse() للنتيجة، فتظهر التكملة في نفس المحادثة.

تحويل الرسائل الواردة

fromUIMessages() تحوّل الـ text parts إلى نص، والـ file parts من نوع image/* إلى image parts، وباقي الـ file parts إلى file parts — والـ url الخاص بالـ part (عنوان data: أو http(s)) يصبح هو البيانات. أما أجزاء الـ tool وreasoning وdata وsource وأي جزء غير معروف فتتجاهلها، والرسائل التي تصبح فارغة تحذفها. الرسائل تأتي من الـ client، لذا لا يُحتفظ إلا برسائل user وassistant: رسالة system (أو أي role آخر، أو أي عنصر ليس رسالة أصلًا) تُحذف، كي لا يتمكن المستدعي من إضافة تعليمات إلى الـ prompt الخاص بالـ agent. حدّد التعليمات على الـ agent نفسه (createAgent({ instructions }))، لا في الطلب. قد يُضاف لاحقًا subpath مخصص lousho/ai-sdk-ui؛ أما حاليًا فالدوال تأتي من جذر الحزمة.