سجل التغييرات

الإصدار v1.0 — ‏2026-10-06

الإصدار الأول من K-Agent: وكيل واحد، استخدمه في أي مكان. إصدار الواجهة البرمجية 2026-10-06.

استخدم وكيلك في أي مكان

• إجابات بسؤال واحد عبر POST /v1/agents/{agent}/ask، مع سجل يرسله المستدعي، وتجاوزات لكل طلب، ووضع خصوصية store: false، وإجراءات عند الطلب.
• جلسات محادثة بمعرّفات المنصة sess_ أو بمعرّفك الخاص external_id، مع الجلب أو الإنشاء، ومخاطبة الجلسة بأي من المعرّفين في كل مكان — وفق عقد معرّفات الجلسات المنشور.
• البث المباشر عبر Server-Sent Events، قابلًا للاستئناف بـ Last-Event-ID، مع أحداث *.completed معتمدة مرجعًا.
• سياسات تزامن لكل جلسة: queue وreject وinterrupt.
• واجهة متوافقة مع OpenAI على /openai/v1/chat/completions، باسم الوكيل نموذجًا، وجلسات اختيارية، وامتداد kagent.
• ودجت الدردشة (<k-agent-chat>) بمفاتيح قابلة للنشر، ومصادر مسموح بها، وزوار مجهولين، ومستخدمين موثّقين عبر رموز العميل.

أعدّه مرة، وشاهد كل شيء

• وثيقة إعدادات واحدة تغطي الهوية واللهجة العربية والنبرة، والتعليمات، والمعرفة، والأدوات، والضوابط، والتحويل لموظف، وساعات العمل، والمحادثة، والنموذج، والمتغيرات، والتجاوزات، ورد الطوارئ، والودجت — وتُعاد كاملة دائمًا.
• المسودات والإصدارات: نشر تلقائي للإصدار 1، وتعديل بـ If-Match ورقعة دمج JSON، ونشر، واستعادة، ومقارنة، وتصدير واستيراد، وconfig_hash في كل تشغيل.
• «أشعة إكس» للتعليمات (prompt_preview) تعرض كل كتلة بمصدرها وإصدارها ورموزها.
• الجاهزية مع عوائق صريحة، ومفتاحا الإيقاف ai_paused وactions_paused.
• قوالب جاهزة: خدمة العملاء، وأسئلة المبيعات، ومساعد الحجوزات، والأسئلة الداخلية.

أمان في الكود

• قائمة «لا تتعامل معها بنفسك»، مفعّلة افتراضيًا وفي آخر التعليمات.
• الرد الحرفي عند التصعيد لتحويلات المسؤولية القانونية، بالعربية والإنجليزية.
• نتائج تحويل صادقة (queued وrecorded وrecorded_closed وalready وfailed) وقاعدة «لا صمت أبدًا» مع إعادة المحاولة والنماذج البديلة ورسالة الطوارئ.
• انتهاء منزلق لمدة التحويل، وتحويلات تقنية لا تُصمت المحادثة، ومكتب التحويل مع الاستلام والرد والملاحظات الداخلية والإعادة والإغلاق وتولّي المحادثة.

الأدوات والمعرفة

• أدوات مدمجة: transfer_to_human وcreate_ticket وflag_conversation وsearch_knowledge.
• أدوات HTTP بقوالب تُغلق عند الفشل، وأسرار بمضيفات مسموح بها، وهوية من العملاء الموثّقين، وإسقاط للاستجابة، ونقطة اختبار مباشر، واستدعاءات صادرة موقّعة.
• أدوات جهة العميل مع requires_action وsubmit_tool_outputs.
• مصادر معرفة (text وcatalog وapi) بوضع always أو searchable، مع بحث يفهم العربية وتحديث مجدول من الواجهات البرمجية يحتفظ بآخر نسخة سليمة.
• عميل شبكة محمي لكل رابط تضبطه.

المنصة

• مفاتيح سرية بنطاقات وتقييد بالوكلاء، ومفاتيح قابلة للنشر، ورموز عميل، وأدوار للفريق (مالك، ومسؤول، ومطوّر، ومحرّر، ودعم، ومشاهد).
• ويب هوك وفق Standard Webhooks مع إعادة المحاولة، وسجل للإرسالات، وأحداث تجريبية؛ وسجل أحداث على /v1/events.
• وحدة الفوترة المحادثة الذكية مع أوزان النماذج والحصص والتنبيهات، وواجهة الاستخدام البرمجية.
• استخدام مفتاح نموذجك الخاص (OpenAI أو Anthropic أو DeepSeek أو أي مزوّد متوافق مع OpenAI)، مع التحقق منه مباشرة.
• سجل التدقيق، ومحو بيانات العملاء، وإعدادات الاحتفاظ بالبيانات.
• توثيق بالعربية والإنجليزية، ومرجع تفاعلي للواجهة البرمجية، وllms.txt، ونسخة Markdown من كل صفحة.