# توثيق K-Agent

> أعدّ وكيلًا ذكيًا واحدًا ثم استخدمه في أي مكان — إجابات بسؤال واحد، وجلسات محادثة بمعرّفاتك الخاصة، وواجهة متوافقة مع OpenAI، وودجت دردشة لموقعك، بالعربية والإنجليزية.

## ابدأ

- [مقدمة](/docs/get-started/introduction/): ما هو K-Agent، ومكوّناته الأساسية، وما يحدث في الدور الواحد.
- [البدء السريع](/docs/get-started/quickstart/): أنشئ وكيلًا ومفتاحًا، واطرح سؤالًا، ثم حادث الوكيل في جلسة بمعرّفك الخاص.

## افهم المفاهيم

- [الجلسات ومعرّفات الجلسات](/docs/concepts/sessions/): معرّفنا sess_ أو معرّفك external_id: العقد المنشور، والجلب أو الإنشاء، والسجل.
- [التشغيلات والبث](/docs/concepts/runs-and-streaming/): دورة حياة التشغيل، وقائمة الأحداث، والاستئناف بـ Last-Event-ID.
- [التحويل لموظف والأمان](/docs/concepts/handoff-and-safety/): قائمة «لا تتعامل معها بنفسك»، والرد الحرفي عند التصعيد، والتحويل الصادق.
- [مرجع الإعدادات](/docs/concepts/settings/): كل حقل في الإعدادات بنوعه وقيمته الافتراضية وحدوده.

## ابنِ

- [أضف ودجت الدردشة](/docs/guides/widget/): سطر script واحد، وعملاء موثّقون برموز العميل.
- [استخدم حزمة OpenAI](/docs/guides/openai-sdk/): احتفظ بكود OpenAI الخاص بك: معرّف الوكيل هو اسم النموذج.
- [أدوات HTTP](/docs/guides/http-tools/): دع الوكيل يستدعي واجهتك البرمجية بأمان.
- [الويب هوك](/docs/guides/webhooks/): أحداث موقّعة للتحويلات والردود والتذاكر.

## ارجع إلى المرجع

- [الأخطاء](/docs/reference/errors/): كل رمز خطأ، ومعناه، وما العمل.
- [مرجع الواجهة البرمجية](/docs/api/): كل نقاط النهاية، مولّدة من عقد OpenAPI.

تبني بمساعدة مساعد ذكاء اصطناعي؟ وجّهه إلى [`/docs/llms.txt`](/docs/llms.txt)، أو إلى [`/docs/llms-full.txt`](/docs/llms-full.txt) ليحصل على التوثيق العربي كاملًا في ملف واحد. ولكل صفحة زر **نسخ الصفحة** ونسخة بصيغة Markdown.