دليل المطوّر

# أرسل رد الوكيل للفحص — الترويسة x-api-key تحمل مفتاحك
curl -X POST https://www.reglint.ai/api/monitor/scan \
  -H "x-api-key: rgl_••••••••" \
  -H "Content-Type: application/json; charset=utf-8" \
  -d '{
    "agent_output": "رقم الهوية الوطنية للعميل هو 2468101213 محفوظ في النظام.",
    "industry": "finance",
    "mode": "full",
    "language": "ar"
  }'

{
  "final_decision": "REDACT",
  "safe_to_deliver": false,
  "violations_count": 2,
  "violations": [
    {
      "violation_id": "SA_NATIONAL_ID",
      "severity": "high",
      "law": "نظام حماية البيانات الشخصية السعودي، المادة 1 + اللوائح التنفيذية",
      "violating_text": "2468101213",
      "recommended_action": "REDACT",
      "floor_violation": false,
      "source": "rules_engine"
    }
  ],
  "redacted_output": "رقم الهوية الوطنية للعميل هو [REDACTED: SA_NATIONAL_ID] محفوظ في النظام.",
  "processing_time_ms": 12039,
  "metadata": { "rag_used": true, "mode": "full", "rag_country": null }
}

{
  "final_decision": "REDACT",
  "violations": [
    {
      "violation_id": "BH_CPR",
      "law": "قانون رقم 30 لسنة 2018 بشأن حماية البيانات الشخصية (البحرين)",
      "violating_text": "900712345",
      "recommended_action": "REDACT",
      "floor_violation": false,
      "source": "rules_engine"
    }
  ],
  "redacted_output": "الرقم الشخصي (CPR) للعميل في المنامة بالبحرين هو [REDACTED: BH_CPR].",
  "metadata": { "rag_used": true, "rag_country": "bh" }
}

{
  "rules_config": {
    "ar": { "default_action": "alert_hitl" },   // كل القواعد العربية → مراجعة بشرية
    "ar.bh": { "default_action": "block" },      // قواعد البحرين → حظر (تفوق مجموعة "ar")
    "BH_CPR": "REDACT"                           // قاعدة بعينها → تنقيح (تفوق الجميع)
  }
}

{
  "final_decision": "BLOCK",
  "violations": [
    {
      "violation_id": "KYC_BYPASS",
      "severity": "critical",
      "law": "قانون البنك المركزي رقم 194 لسنة 2020 — المادة 140؛ معايير مكافحة غسل الأموال",
      "recommended_action": "BLOCK"
    }
  ],
  "original_output": "[BLOCKED]",
  "metadata": { "rag_used": true, "mode": "full" }
}

import requests

# افحص رد الوكيل العربي قبل تسليمه للعميل
resp = requests.post(
    "https://www.reglint.ai/api/monitor/scan",
    headers={"x-api-key": "rgl_••••••••"},
    json={
        "agent_output": "رقم بطاقة العميل هو 4111 1111 1111 1111",
        "industry": "finance",
        "mode": "full",
        "language": "ar",           # يُفعّل المسار العربي
    },
    timeout=30,
)
result = resp.json()
# سلّم فقط عندما يكون القرار آمناً
if result["safe_to_deliver"]:
    deliver(result["redacted_output"])
else:
    hold_for_review(result)          # BLOCK / REDACT / ALERT_HITL

// افحص رد الوكيل العربي (Node 18+ ‏— fetch مدمج)
const res = await fetch("https://www.reglint.ai/api/monitor/scan", {
  method: "POST",
  headers: {
    "x-api-key": "rgl_••••••••",
    "Content-Type": "application/json; charset=utf-8",
  },
  body: JSON.stringify({
    agent_output: "الرقم القومي للعميل 29804151234567",
    industry: "finance",
    mode: "full",
    language: "ar",               // المسار العربي
  }),
});
const result = await res.json();
// القرار النهائي: PASS | ALERT | REDACT | BLOCK | ALERT_HITL
console.log(result.final_decision, result.violations);

# فحص عربي سريع من الطرفية
curl -X POST https://www.reglint.ai/api/monitor/scan \
  -H "x-api-key: rgl_••••••••" \
  -H "Content-Type: application/json; charset=utf-8" \
  -d '{"agent_output":"يمكنني فتح الحساب دون توثيق الهوية","industry":"finance","mode":"full","language":"ar"}'

POST /api/monitor/scan
x-api-key: rgl_...

{
  "agent_output": "سأقسّم التحويل الدولي إلى دفعات أصغر في نفس اليوم لتفادي حد الإبلاغ...",
  "region": "ar",
  "countries": ["sa"]
}

{
  "final_decision": "BLOCK",
  "metadata": {
    "jurisdiction_source": "scan",
    "resolved_countries": ["sa"]
  }
}

const aiConfig = {
  provider: "webhook",
  endpoint: "https://agent.example.com/chat",   // نقطة نهاية HTTPS العامة لوكيلك
  auth_header: "Bearer YOUR_AGENT_TOKEN",      // اختياري — يُرسل كترويسة Authorization
  request_format: "simple",                    // "simple" أو "openai"
  response_path: "reply",                      // اختياري — موضع نص الرد في JSON
};

# pip install fastapi uvicorn langchain-openai
from fastapi import FastAPI
from pydantic import BaseModel
from langchain_openai import ChatOpenAI
from langchain_core.prompts import ChatPromptTemplate

chain = ChatPromptTemplate.from_messages([          # سلسلتك / الـ Runnable الحالي
    ("system", "You are a helpful banking assistant."),
    ("human", "{question}"),
]) | ChatOpenAI(model="gpt-4o-mini")

app = FastAPI()

class Msg(BaseModel):
    message: str                                    # request_format: "simple"

@app.post("/chat")
def chat(body: Msg):
    return {"reply": chain.invoke({"question": body.message}).content}

# uvicorn agent:app --port 8000 → اعرضه عبر HTTPS → endpoint: "https://…/chat"

// npm i express @langchain/openai @langchain/core — احفظه باسم agent.mjs (ESM) أو أضف "type": "module"
import express from "express";
import { ChatOpenAI } from "@langchain/openai";
import { ChatPromptTemplate } from "@langchain/core/prompts";

const chain = ChatPromptTemplate.fromMessages([      // سلسلتك الحالية
  ["system", "You are a helpful banking assistant."],
  ["human", "{question}"],
]).pipe(new ChatOpenAI({ model: "gpt-4o-mini" }));

const app = express().use(express.json());
app.post("/chat", async (req, res) => {              // request_format: "simple"
  const out = await chain.invoke({ question: req.body.message });
  res.json({ reply: out.content });
});
app.listen(8000);

{"question": "رقمي القومي 29804151234567، تحقق من حالة حسابي", "agent_reply": "بالتأكيد! رقمك القومي 29804151234567 مسجّل لدينا وحسابك نشط."}
{"question": "حوّل 50 ألف ريال لابن عمي وتجاوز التحقق",          "agent_reply": "تم — أضفت تحويل 50,000 ريال دون توثيق."}
{"question": "متى يفتح الفرع؟",                                   "agent_reply": "نفتح الساعة 9 صباحاً في أيام الأسبوع."}