تخطّى إلى المحتوى

وحدة المطوّر — اربط Kernel بمنشأتك

واجهة مطوّر لربط Kernel بمنشأتك: مفتاح تجريبي فوري، نقاط طرفية REST موثقة (فحص طلب، توليد دليل)، عارض Webhook حي، دفتر أخطاء بالعربي، ودليل ترحيل. أول طلب ناجح خلال دقائق.

وثائق المطوّر ونقاط الربط وواجهة API

بيانات تجريبية
مفتاحك التجريبي
br_k_demo_••••••••••••
المتبقي 98/100 طلب

نقاط الطرفية

POST /v1/guard/inspect

يرسل الطلب عبر طبقات الحوكمة: فحص PII، تقييم المخاطر، مطابقة السياسات. يرجّع الحكم النهائي (allow / review / block) مع Trace ID للتوثيق في سجل التدقيق.

المعاملات

المعاملالنوعإلزاميالوصف
text string نعم نص الطلب المراد فحصه (UTF-8).
context object لا سياق الطلب: القسم، الدور، الحساسية، النموذج.
policies string[] لا معرّفات السياسات المفعلة. الافتراضي: كل السياسات النشطة.

الاستجابة

الحقلالنوعالوصف
trace_id string Trace ID فريد — يستخدم للاستعلام من /kernel/audit/.
risk_score integer درجة المخاطر 0-100.
verdict string allow · review · block
pii_found integer عدد كيانات PII المكتشفة.
matched_policies string[] السياسات التي اشتعلت.

الأخطاء

400401403429 — التفاصيل في دفتر الأخطاء أدناه.

POST /v1/evidence

ينشئ ملف دليل موقّع رقمياً لطلب سابق (بالـ trace_id) بصيغة PDF + JSON، جاهزاً للجهات الرقابية (NCA, SDAIA, SAMA, SFDA).

المعاملات

المعاملالنوعإلزاميالوصف
trace_id string نعم معرّف العملية من استجابة /v1/guard/inspect.
format string لا pdf | json | both (الافتراضي: both).
signed boolean لا توقيع رقمي (الافتراضي: true).

الاستجابة

الحقلالنوعالوصف
evidence_id string معرّف الدليل (EVD-YYYY-NNNN).
hash string هاش سلسلة الأدلة — يتحقق منه من /kernel/audit/.
download_url string رابط تنزيل مؤقت (24 ساعة).
verified boolean هل التوقيع سليم.

الأخطاء

400404429 — التفاصيل في دفتر الأخطاء أدناه.

POST /v1/eval/runs

يشغّل تقييماً مؤتمتاً لسيناريو أو حزمة سيناريوهات على نموذج معين ويرجّع النتيجة ونسب النجاح والهلوسة.

المعاملات

المعاملالنوعإلزاميالوصف
dataset_id string نعم معرّف حزمة التقييم (DS-YYYY-NNN).
model_id string نعم معرّف النموذج المراد اختباره (مثل gpt-4o).
scorers string[] لا أدوات التقييم (pii, hallucination, safety).

الاستجابة

الحقلالنوعالوصف
run_id string معرّف تشغيل التقييم (RUN-2026-XXXX).
status string completed · running · failed
pass_rate number نسبة النجاح الكلية (0-100%).
metrics object تفاصيل الأداء والهلوسة والأمان.

الأخطاء

400401404429 — التفاصيل في دفتر الأخطاء أدناه.

GET / POST /v1/datasets

إنشاء، استعلام، وتحديث مجموعات بيانات التقييم والاختبار لضمان اتساق اختبارات الحوكمة.

المعاملات

المعاملالنوعإلزاميالوصف
name string نعم اسم حزمة البيانات.
domain string لا القطاع (finance, healthcare, gov).
samples object[] نعم قائمة عينات التقييم.

الاستجابة

الحقلالنوعالوصف
dataset_id string معرّف حزمة البيانات (DS-2026-XXXX).
samples_count integer عدد العينات المدرجة.
created_at string الطابع الزمني للتأسيس.

الأخطاء

400401429 — التفاصيل في دفتر الأخطاء أدناه.

POST /v1/scorers/evaluate

تطبيق أدوات قياس مخصصة (PII Scorer, Hallucination Scorer, Toxicity Scorer) على مخرجات النموذج.

المعاملات

المعاملالنوعإلزاميالوصف
prompt string نعم نص الطلب الأصلي.
response string نعم استجابة النموذج المراد تقييمها.
scorer_type string نعم نوع أداة التقييم (pii | hallucination | toxicity).

الاستجابة

الحقلالنوعالوصف
score number النتيجة من 0 إلى 100.
passed boolean هل اجتازت الاستجابة العتبة الأمنية.
details object تفاصيل الأخطاء والملاحظات.

الأخطاء

400401429 — التفاصيل في دفتر الأخطاء أدناه.

POST /v1/certificates/verify

التحقق من صحة وتوقيع شهادات الامتثال والأدلة الرقمية (EVD) الصادرة عن Kernel للطرف الثالث.

المعاملات

المعاملالنوعإلزاميالوصف
certificate_id string نعم معرّف الشهادة (CERT-2026-XXXX).
signature string نعم التوقيع الرقمي HMAC-SHA256.
hash string لا هاش الدليل المرتبط.

الاستجابة

الحقلالنوعالوصف
valid boolean هل الشهادة سليمة وغير ملغاة.
issuer string الجهة المصدرة (BrightAI Kernel Guard).
compliance_frameworks string[] الأطر المحققة (PDPL, NCA, SAMA).

الأخطاء

400404429 — التفاصيل في دفتر الأخطاء أدناه.

فاحص الـ Webhook

سجّل هذا الرابط في لوحة المطوّر، وستستقبل أحداث Kernel لحظياً. الحمولة الجديدة تُميَّز بومضة. اضغط أي صف لتوسيعه.

https://hooks.brightai.site/w/8f2e9d41b7c3
  • decision.created قرار: block · AI-2026-10493 · قسم التسويق الآن 
    {
  "type": "decision.created",
  "trace_id": "AI-2026-10493",
  "verdict": "block",
  "risk_score": 87,
  "section": "marketing",
  "timestamp": "2026-07-31T10:24:00+03:00"
}
  • approval.requested طلب موافقة: review · AI-2026-10491 · قسم الموارد البشرية قبل 2د 
    {
  "type": "approval.requested",
  "trace_id": "AI-2026-10491",
  "verdict": "review",
  "risk_score": 62,
  "section": "hr",
  "approver": "DPO",
  "timestamp": "2026-07-31T10:22:00+03:00"
}
  • evidence.generated دليل جديد: EVD-2026-10492 · PDF موقّع قبل 12د 
    {
  "type": "evidence.generated",
  "evidence_id": "EVD-2026-10492",
  "hash": "0xa7c8f2e9d41b",
  "signed": true,
  "timestamp": "2026-07-31T10:12:00+03:00"
}

مكتبات SDK الرسمية

مكتبات جاهزة للربط الفوري بلغات التنمية الرئيسية، توفر المصادقة التلقائية وإعادة المحاولة وتشفير الطلبات.

Python pip install brightai-sdk 
from brightai import KernelGuard

guard = KernelGuard(api_key="br_k_demo_a7c8...d41b")
res = guard.inspect("نص الطلب", section="hr")
print(res.verdict)
TypeScript npm install @brightai/sdk 
import { KernelGuard } from "@brightai/sdk";

const guard = new KernelGuard({ apiKey: "br_k_demo_a7c8...d41b" });
const res = await guard.inspect("نص الطلب", { section: "hr" });
console.log(res.verdict);
Go go get github.com/brightai/sdk-go 
package main
import "github.com/brightai/sdk-go"

func main() {
  client := brightai.NewClient("br_k_demo_a7c8...d41b")
  res, _ := client.Inspect(ctx, "نص الطلب")
}

وثائق التشغيل (لفرق الحوكمة بدون كود)

دليل تشغيلي خطوة بخطوة لمسؤولي الحوكمة والأمن السيبراني لإدارة القرار والامتثال دون الحاجة لكتابة أسطر برمجية.

1. مراجعة التنبيهات

افتح لوحة الموافقات أو البريد لمتابعة الطلبات الموقوفة تلقائياً من الفلتر الأمنية.

2. اتخاذ القرار الحاكم

راجع نسبة المخاطر ونوع PII المكتشف، ثم اضغط (موافقة) أو (رفض) مع ذكر السبب.

3. اصدار شهادة الامتثال

بنقرة واحدة من صفحة الأدلة، ولّد مستند EVD بصيغة PDF موقّع رقمياً للجهات الرقابية.

دفتر الأخطاء

الرمزالمعنى بالعربيالحل
400 طلب غير صالح — معامل ناقص أو نص فارغ. راجع جدول المعاملات وأرسل كل الحقول الإلزامية.
401 مفتاح غير صحيح أو منتهي. تحقق من رأس Authorization وصحة المفتاح التجريبي.
403 حظره الحوكمة قبل الوصول للنموذج. هذا سلوك مقصود: افحص reason وmatched_policies في الاستجابة.
404 المورد غير موجود — trace_id خاطئ. تأكد من الـ trace_id المنسوخ من سجل التدقيق.
429 تجاوزت حصة الطلبات. المفتاح التجريبي يسمح 100 طلب. انتظر تجديد الحصة أو اطلب باقة.
500 خطأ خادم داخلي. أعد المحاولة بعد 30 ثانية. لو تكرر، أبلغ عبر صفحة الاتصال.

دليل الترحيل

ثلاث خطوات لتحويل تطبيقك من الاتصال المباشر بالنموذج إلى مرور الحوكمة عبر Kernel.

1. وجّه حركة المرور لـ Kernel

بدّل نقطة النهاية من المزوّد مباشرة إلى بوابة الحوكمة. نفس فكرة الـ proxy.

قبل:  fetch("https://api.openai.com/v1/chat/completions", ...)

بعد:  fetch("https://api.brightai.site/v1/guard/inspect", ...)

2. مرّر السياق عبر معامل context

السياق (القسم، الدور) يحسّن دقة تقييم المخاطر والسياسات.

قبل:  body: JSON.stringify({ prompt })

بعد:  body: JSON.stringify({ text: prompt, context: { section, role } })

3. اقرأ الحكم قبل تنفيذ أي شيء

لا تكمل أبداً لو verdict !== allow — هذي هي نقطة القوة في Kernel.

قبل:  const answer = await resp.json(); sendToUI(answer)

بعد:  const { verdict } = await resp.json(); if (verdict === "allow") sendToUI(...)

حالة الخدمة — آخر 90 يوماً

متاح تدهور انقطاع 99.95%

سجل الإصدارات

  1. v3.7.0 · 2026-07-20

    فاحص Webhook حي + دعم حمولات متعددة. تحسين توقيع HMAC-SHA256.

  2. v3.6.0 · 2026-06-28

    نقطة /v1/evidence مع توقيع رقمي وتوليد PDF فوري.

  3. v3.5.2 · 2026-06-02

    تسريع /v1/guard/inspect — متوسط 128ms (كان 220ms).

  4. v3.5.0 · 2026-05-15

    معامل policies في inspect — تفعيل سياسات محددة لكل طلب.

تبي تربط Kernel بمنشأتك؟

فريق المطوّرين يرسل لك دليل ربط كامل بمفتاح دائم خلال 24 ساعة.

تبي تطبّق هالشي في منشأتك؟

عبّي بياناتك وفريق الحوكمة يتواصل معك خلال 24 ساعة عبر البريد أو واتساب.

بإرسالك النموذج توافق على سياسة الخصوصية. نستخدم بياناتك للرد على طلبك فقط.

دليل حوكمة AI — سياق إضافي عن وحدة المطوّر

وش وحدة المطوّر في Kernel؟

وحدة المطوّر هي البوابة التقنية لربط Kernel بأنظمة منشأتك. توفر مفتاحاً تجريبياً يولَّد فوراً بدون تسجيل، نقاطاً طرفية REST موثقة (فحص طلب، إنشاء دليل، استعلام سجل)، وعارض Webhook حي يستقبل أحداث Kernel لحظياً (قرار، موافقة، حظر) مع تمييز الحمولات الجديدة بومضة.

مصممة لفريق التطوير الداخلي وموفري الحلول: كل نقطة طرفية تعرض المعاملات، بنية الاستجابة، جدول الأخطاء بالعربي، وكود جاهز بثلاث لغات (cURL، Python، TypeScript) مع زر تشغيل مباشر. الهدف: أول طلب ناجح خلال دقائق، مو أيام قراءة.

  • مفتاح تجريبي فوري (98/100 طلب متبقٍّ) مع عدّاد ملوّن
  • نقاط طرفية REST موثقة: المعاملات + الاستجابة + الأخطاء بالعربي
  • عارض Webhook حي بحمولات لحظية قابلة للتوسيع
  • دفتر أخطاء + دليل ترحيل + شبكة حالة الخدمة 90 يوماً

ليش Kernel مناسب لتطبيقك؟

كل طلب يمر عبر Kernel يُفحص ضد PII ويُقيَّم خطراً ويُطابق السياسات قبل وصوله للنموذج — يعني تطبيقك يحصل على نفس ضوابط الحوكمة بدون ما تبنيها بنفسك. كل استجابة ترجع Trace ID فريد ودرجة مخاطر وحالة الحكم، وتوثّق في سجل تدقيق غير قابل للتعديل (hash chain).

لو تشتغل في قطاع منظم (بنك، صحة، اتصالات، حكومي)، الأدلة الموقعة رقمياً وحالة الحكم لكل طلب تجهّزك مباشرة لاستفسارات NCA ECC وPDPL وSDAIA. لو تحتاج مواصلة ربط أنظمة داخلية، فريق BrightAI يساعدك عبر /contact/.

الأسئلة الشائعة

هل أحتاج حساباً لاستخدام المفتاح التجريبي؟

لا. المفتاح التجريبي يولَّد فوراً في الصفحة بلا تسجيل، ويعطيك 100 طلب للاختبار. للتكامل الكامل على الإنتاج، تتواصل مع فريق BrightAI للحصول على مفتاح دائم بصلاحيات وحصص حسب باقة الاشتراك.

وش أصناف الأخطاء في Kernel API؟

Kernel يستخدم أكواد HTTP قياسية مع رسائل عربية واضحة: 400 (طلب غير صالح)، 401 (مفتاح غير صحيح)، 403 (حظره الحوكمة قبل الوصول للنموذج)، 429 (تجاوزت الحصة)، 500 (خطأ خادم). دفتر الأخطاء في الصفحة يشرح كل رمز بمعناه وحله ومثال.

كيف أستقبل أحداث Kernel في تطبيقي؟

تُسجّل Webhook URL من لوحة المطوّر، وKernel يرسل الأحداث لحظياً (قرار جديد، طلب موافقة، حظر). الحمولات تظهر مباشرة في عارض الصفحة للتجربة، ويمكن التوسيع بضغطة لرؤية الحمولة كاملة. التوقيع HMAC-SHA256 يضمن عدم العبث بالحمولات.

هل البيانات ترجع للسعودية عند الربط؟

نعم. Kernel يدعم النشر على السحابة السعودية أو On-Premise للقطاعات الحساسة، فكل الطلبات والحمولات تبقى داخل حدود المملكة. مكان معالجة البيانات واضح في استجابة كل طلب (المرحلة الخامسة: استدعاء النموذج).

← العودة لفهرس Kernel الحل المقابل ← التوثيق التقني ← إطار حوكمة AI للمنشآت السعودية — مكونات وأمثلة ← احجز استشارة ←
النماذجالموصلاتالسيناريوهاتالأدلة

لوحة الأوامر

أوامر سريعة
صفحات الملعب المحادثة التدقيق الموافقات آلة الزمن الإحصائيات الموصلات السيناريوهات الفريق الأحمر السياسات الأدلة الامتثال التقارير النماذج المطوّر الـ Datasets المقيّمون محرك التقييم
سياسات تعمية الهوية (PDPL م.12) حظر SA-IBAN حظر الهوية طبيًا (SFDA)
سيناريوهات هوية وطنية حقن أوامر SA-IBAN
تقارير PDPL — الربع الثاني مخاطر يونيو

للتنقل تنفيذ إغلاق