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

> الجديد في K-Agent. صدر الإصدار 1.0 في 6 أكتوبر 2026.

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

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

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

- **إجابات بسؤال واحد** عبر `POST /v1/agents/{agent}/ask`، مع سجل يرسله المستدعي، وتجاوزات لكل طلب، ووضع خصوصية `store: false`، وإجراءات عند الطلب.
- **جلسات محادثة** بمعرّفات المنصة `sess_` أو **بمعرّفك الخاص `external_id`**، مع الجلب أو الإنشاء، ومخاطبة الجلسة بأي من المعرّفين في كل مكان — وفق [عقد معرّفات الجلسات](/docs/concepts/sessions/#عقد-معرّفات-الجلسات) المنشور.
- **البث المباشر** عبر 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 من كل صفحة.