الاستخدام والفوترة

يفوتر K-Agent بوحدة واحدة في كل مكان: المحادثة الذكية. لوحة التحكم والواجهة البرمجية وصفحة الأسعار تستخدم التعريف نفسه.

الوحدة: المحادثة الذكية

التعريف: عميل واحد (أو جلسة واحدة إذا كان مجهولًا) مع وكيل واحد، خلال نافذة ثابتة مدتها 24 ساعة تبدأ عند أول رد من الوكيل، وحتى 50 ردًا من الوكيل. الرد رقم 51، أو أي رد بعد 24 ساعة، يفتح محادثة جديدة.

• الرد تشغيلٌ ينتهي بالنتيجة answered. أما التشغيلات المنتهية بـ handed_off أو failed أو cancelled أو superseded فلا تُفوتر أبدًا، ولا تُحتسب ردودًا، ولا تفتح نافذة.
• النافذة لكل عميل، لا لكل جلسة: العميل الموثّق الذي يفتح ثلاث جلسات مع الوكيل نفسه في يوم واحد يستخدم نافذة واحدة. ومن دون عميل تكون الجلسة هي الأساس.
• تُغلق النافذة أيضًا بعد 300,000 رمز إدخال؛ ويفتح الرد التالي نافذة جديدة.
• المحادثات البشرية لا تُفوتر أبدًا. التحويلات وردود فريقك بلا تكلفة، والمقاعد ليست أساس الفوترة.

العدّاد

الحدث	الوحدات
أول رد من الوكيل في النافذة	0.25 × w
الرد الثاني	+ 0.75 × w (يصبح مجموع النافذة 1.0 × w)
الردود من 3 إلى 50	0
سؤال واحد ask	0.25 × w × عدد كتل الإدخال المبدوءة من 50,000 رمز (كتلة واحدة على الأقل)
التشغيلات التي تُحوَّل لموظف أو تفشل أو تُلغى أو تُستبدل	0
التشغيلات التي تفشل لدى المزوّد	0 (مع تسجيل تكلفة المزوّد)
لوحة التجربة في لوحة التحكم	0 (مع تسجيل تكلفة المزوّد)

w هو وزن النموذج، ويُثبَّت عند فتح النافذة: وزن النموذج الذي أنتج الرد الأول. ويُحتسب إدخال السؤال الواحد من كل استدعاءات النموذج في التشغيل، بما فيها الرموز المخزّنة مؤقتًا. والطلبات عديمة الحالة إلى الواجهة المتوافقة مع OpenAI تُفوتر مثل ask.

أوزان النماذج

الفئة	النماذج	الوزن
قياسي (Standard)	deepseek-flash وgpt-6-luna وGemini 3.5 Flash-Lite	1×
متقدم (Advanced)	Gemini 3.8 Flash وClaude Haiku 4.5 وdeepseek-v4-pro	3×
ممتاز (Premium)	Claude Sonnet 5.5	6×
مفتاحك الخاص (BYOK)	أي نموذج، يفوترك عليه مزوّدك	0.2× (رسوم المنصة فقط)

الجدول منشور ويُراجع كل ثلاثة أشهر. ويعيد GET /v1/models فئة كل نموذج ووزنه وهل تسمح به خطتك.

أمثلة محسوبة

ما حدث	الوحدات
عميل يسأل سؤالًا واحدًا على نموذج قياسي	0.25
العميل نفسه يرسل 8 رسائل في ذلك اليوم	1.0
يعود بعد 30 ساعة من الرد الأول ويسأل مجددًا	1.0 + 0.25
60 ردًا خلال 24 ساعة	1.0 (الردود 1–50) + 1.0 (الردان 51–52 يفتحان نافذة جديدة، و53–60 مجانية) = 2.0
محادثة من ثلاثة ردود على Claude Haiku 4.5 (متقدم)	1.0 × 3 = 3.0
محادثة من ثلاثة ردود على مفتاح OpenAI الخاص بك	1.0 × 0.2 = 0.2
سؤال واحد بـ 120,000 رمز إدخال على نموذج قياسي	0.25 × 3 = 0.75
الوكيل يحوّل أول سؤال إلى فريقك	0

الخطط

الأسعار بالريال السعودي، دون ضريبة القيمة المضافة.

الخطة	السعر / شهريًا	المحادثات الذكية المشمولة (نماذج قياسية)	الزيادة	المقاعد
المجانية	0	100 (سقف صارم)	—	2
Starter	299	500	1.00 ريال، تُفوتر شهريًا	5
Business	899	2,000	1.00 ريال، تُفوتر شهريًا	15
Scale	2,499	7,500	1.00 ريال، تُفوتر شهريًا	40
Enterprise	حسب الاتفاق	حسب الاتفاق	حسب الاتفاق	حسب الاتفاق

النموذج المتقدم يُحتسب 3، والممتاز 6، ومفتاحك الخاص 0.2 لكل محادثة.

• النماذج حسب الخطة: المجانية تشمل النماذج القياسية ومفاتيحك الخاصة؛ وStarter يضيف المتقدمة؛ وBusiness وما فوقها تشمل كل النماذج.
• تغيير الخطة يتم عبر فريق Kerneltics في الإصدار v1 — تواصل معنا للترقية. الدفع الإلكتروني والفوترة الإلكترونية وفق متطلبات هيئة الزكاة والضريبة والجمارك يصلان في الإصدار v1.1.

الحصص

• الحصة على مستوى المنظمة، لكل شهر ميلادي بتوقيت الرياض.
• تُفحص عند فتح النافذة. والنافذة المفتوحة تكتمل دائمًا.
• الخطة المجانية تتوقف عند 100 وحدة. عندها ترد الجلسات بإشعار قصير وتحوّل المحادثة إلى فريقك — لا يرى العملاء خطأ فوترة أبدًا — وتعيد طلبات السؤال الواحد 429 quota_exceeded مع x-should-retry: false.
• الخطط المدفوعة لا تتوقف في الإصدار v1. الوحدات التي تتجاوز المشمول تظهر في overage_units وتُفوتر شهريًا. ويمكن أن ينص العقد على سقف صارم بدلًا من ذلك.
• تُطلق التنبيهات عند 75% و100%: شريط في لوحة التحكم، والويب هوك usage.threshold_reached مع {percent}.
• إذا تعطل العدّاد نفسه فإنه يفشل مفتوحًا: يواصل وكيلك الرد.

حدود التكلفة اليومية

لحمايتك من الإنفاق الجامح، لكل منظمة حد يومي لتكلفة النماذج (المجانية 1 دولار، وStarter ‏10 دولارات، وBusiness ‏30 دولارًا، وScale ‏100 دولار افتراضيًا؛ قابلة للتعديل عند الطلب). بعد تجاوز الحد تُحوَّل الجلسات لموظف مع إشعار، وتعيد ask الخطأ 429 cost_cap_exceeded حتى اليوم التالي.

تشغيلات لوحة التجربة على نماذج المنصة محدودة بـ 200 لكل مشروع يوميًا (429 playground_limit_reached)؛ ومع مفتاح مزوّدك الخاص لا حد لها.

واجهة الاستخدام البرمجية

curl https://api.k-agent.kerneltics.com/v1/usage/summary \
  -H "Authorization: Bearer $KAGENT_API_KEY"

{
  "object": "usage_summary",
  "plan": "starter",
  "period": { "start": 1790802000, "end": 1793480400, "timezone": "Asia/Riyadh" },
  "included": 500,
  "used": 212.5,
  "remaining": 287.5,
  "overage_units": 0,
  "hard_cap": false
}

يفصّل GET /v1/usage?group_by=day|agent|model|channel&from=…&to=… الوحدات والرموز والتكلفة عبر الزمن. ويتطلب الاثنان النطاق usage:read. كما يعرض كل تشغيل usage.units وusage.weight الخاصين به.