واجهة برمجة السلطة · في الإنتاج

طبقة السلطة لوكلاء الذكاء الاصطناعي

كل وكيل يحتاج إلى هوية. كل إجراء يحتاج إلى سلطة. كل سلطة تحتاج إلى دليل. يحوّل StructureClerk 192 ولاية قضائية وسياساتكم الداخلية إلى قرارات يستهلكها وكلاؤكم — قبل أن يتصرفوا.

Public API · 0 auth · signed responses

Identity answers who. StructureClerk answers what.

Okta, Auth0 and your IAM know who your agent is. Policy engines like OPA know how to evaluate a rule. StructureClerk provides what's missing: the content of the rule. Which action this agent may perform, in this jurisdiction, on this data, at this autonomy level — and what proof remains. Built to complement your identity and enforcement stack, not to replace it.

الولاية القضائية تغيّر الإجابة

الوكيل نفسه، الإجراء نفسه، البيانات نفسها. لا يتغير سوى المنشأ والوجهة — ومعهما القرار.

الإجراء	من	إلى	القرار	السبب
read.customer_record	CA_QC	CA_QC	ALLOW	يبقى في كيبيك
read.customer_record	CA_QC	US_FED	APPROVE	آلية نقل مطلوبة
read.customer_record	US_FED	CA_QC	ALLOW	الاتجاه المعاكس: نظام مفتوح
read.customer_record	FR	CA_FED	ALLOW	قرار كفاية
replicate.records	CN	US_FED	DENY	واجب التوطين
score.applicant	FR	—	DENY	الحق في تدخل بشري
score.applicant	US_TX	—	ESCALATE	لا حق مكافئ

قواعد الولاية القضائية لا يمكنها إلا تشديد القرار، ولا تخففه أبدًا: يقيّم المحرك الجدول بدونها ثم معها، ويحتفظ بالإجابة الأشد. لذا فإن ذكر ولاية قضائية ليس أبدًا وسيلة للحصول على إذن. وعندما لا تُقدَّم وجهة، تحمل الإجابة تحذيرًا بدلًا من تصريح ضمني.

أوليّة القرار

أربع إجابات ممكنة. تقابل كل منها منطقة من إطار المناطق الثلاث.

ALLOW

الإجراء في المنطقة 1: يمكن للوكيل التصرف وحده ضمن حدود السياسة.

APPROVE

الإجراء في المنطقة 2: يُعدّ الوكيل، ويوافق إنسان قبل التنفيذ.

DENY

الإجراء في المنطقة 3: القرار محجوز للإنسان. لا يمكن للوكيل اتخاذه.

ESCALATE

الثقة أقل من 90٪: يوجّه عتبة الشك الطلب إلى مراجعة بشرية بدلًا من التخمين.

قرارات استشارية. StructureClerk يقرر، وبنيتكم التحتية تنفّذ.

طلب واحد، قرار واحد، دليل واحد

وكيل مالي يريد تنفيذ دفعة بقيمة 12,500 دولار تمس بيانات صحية في كيبيك. هذا ما يجيب به المحرك.

الطلب

POST /api/v1/authority/decide
{
  "agent": { "id": "financebot-01", "autonomy_level": 3 },
  "action": {
    "type": "payment.execute",
    "amount": 12500,
    "currency": "CAD",
    "data_categories": ["personal", "health"]
  },
  "context": { "jurisdictions": ["QC"], "sector": "health" }
}

الاستجابة

{
  "advisory": true,
  "decision": "APPROVE",
  "zone": 2,
  "reason": "financial_threshold_exceeded",
  "reasons": [
    "financial_threshold_exceeded",
    "sensitive_data_regulated_sector"
  ],
  "confidence": 0.96,
  "frameworks": [
    { "name": "Loi 25", "domain": "data_protection", "jurisdiction": "CA_QC" },
    { "name": "Loi 25 (dispositions IA)", "domain": "ai_governance", "jurisdiction": "CA_QC" },
    { "name": "Loi 25 — Volet décision automatisée (Québec)", "domain": "algorithmic_decisions", "jurisdiction": "Québec, Canada", "status": "enacted" },
    { "name": "PIPEDA — Volet décision automatisée", "domain": "algorithmic_decisions", "jurisdiction": "Canada (Fédéral)", "status": "enacted" }
  ],
  "sector_risk_level": "high",
  "evidence": {
    "id": "EVD-1c9a7e58-2b41-4f6e-9c3d-8a5b0e7f21d4",
    "timestamp": "2026-08-13T14:02:11.000Z",
    "sha256": "5b2aeaa5261c375a..."
  },
  "rules_version": "2026-09-18.1",
  "disclaimer": "Décision consultative fondée sur une cartographie réglementaire. Ne constitue pas un avis juridique. L'application de la décision relève de votre infrastructure."
}

Try it now

Query the engine live

This form calls the real public endpoint. The response below, signature included, is exactly what your agent would receive.

Action type

Amount (optional)

Data categories

Jurisdictions

Sector

Agent autonomy level

response

// Pick a scenario or compose an action,
// then request a decision.

Advisory decisions. StructureClerk decides. Your infrastructure enforces.

Agent interoperability

3 protocols, 0 auth

Your agents already query StructureClerk over A2A, MCP and REST. They can now ask it for authorization before acting.

A2AJSON-RPCv0.2.1

Google Agent-to-Agent protocol. Lets AI agents query StructureClerk via JSON-RPC.

/api/a2a

MCPStreamable HTTPv2025-03-26

Model Context Protocol. Exposes 5 compliance tools for MCP-compatible clients.

/api/mcp-http

RESTJSONvv1

Classic REST API. Compliance analysis, jurisdiction mapping and roadmap endpoints.

/api/agent/compliance-check

Integrate in 3 lines

Pick your protocol. Copy. Execute.

a2a-request.json

// A2A — JSON-RPC 2.0
const res = await fetch(
  "https://structureclerk.ca/api/a2a",
  {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify({
      jsonrpc: "2.0",
      method: "compliance/check",
      params: {
        jurisdiction: "QC",
        company_size: "11-50",
        sector: "health",
        uses_ai: true
      },
      id: 1
    })
  }
);
const { result } = await res.json();
console.log(result.applicable_frameworks);

إطار المناطق الثلاث

مستوى استقلالية الوكيل ليس متغيرًا تقنيًا. إنه حدّ حوكمي.

المنطقة 1 — مؤتمتة

→ ALLOW

يتصرف الوكيل وحده ضمن حدود السياسة. قراءات وتصنيفات ومسودات ومطابقات دون بيانات حساسة.

المنطقة 2 — معزَّزة

→ APPROVE

يُعدّ الوكيل، ويوافق الإنسان. إجراءات مالية فوق عتبة، إجراءات لا رجعة فيها، بيانات حساسة في قطاع منظَّم.

المنطقة 3 — محمية

→ DENY

قرار محجوز للإنسان: التوظيف، الفصل، الائتمان، الأجور، القرار الطبي، المعاملة القانونية. لا يمكن للوكيل اتخاذه.

أفقي — عتبة الشك→ ESCALATE

عندما تنخفض ثقة المحرك دون 90٪، يُوجَّه الطلب إلى مراجعة بشرية أيًا كانت نتيجة القاعدة. النظام مصمم ليعرف ما لا يعرفه.

إطار المناطق الثلاث — L'Architecte Numérique، ميشيل فوتسينغ (2026)، توزيع Hachette. larchitectenumerique.com

كل قرار يترك دليلًا

من طلب، وأي إجراء، وفي أي سياق، وأي سياسة كانت سارية، وأي قرار صدر، وفي أي وقت. كل قرار موقَّع تشفيريًا ومُدرج في سجل متسلسل. يمكن لأي طرف ثالث التحقق، دون الوثوق بنا، من أن الوكيل كان يملك ذلك التفويض في تلك اللحظة.

معرّف دليل فريد (EVD-…) في كل استجابة
بصمة SHA-256 لزوج الطلب-القرار
توقيع Ed25519، مفتاح عام منشور
سجل متسلسل: كل إدخال يشير إلى السابق
تحقق علني من طرف ثالث، دون حساب

متوافقة مع اتجاه المعايير

يتبع هذا النهج الاتجاه الذي رسمته مبادرة NIST لمعايير وكلاء الذكاء الاصطناعي (فبراير 2026) بشأن هوية الوكلاء وتفويضهم.

طبقة التنسيق منفصلة عن أي مزوّد نماذج بعينه. إذا تدهور نموذج أو غيّر مزوّد أسعاره، ينتقل النظام دون المساس بمنطق القرار.

عقد القرار مفتوح. نفّذه، وانتقده، ووسّعه. عرض المواصفة (JSON Schema، OpenAPI، MIT)

تستخدم منصة وكلاء بالفعل؟ سيناريوهات التكامل موثقة لعشر منها — monday.com وAgentforce وCopilot Studio وغيرها

ضع وكلاءك تحت السلطة اليوم

خطتا الفريق والأسطول متاحتان الآن. يمكن للمنظمات في البيئات المنظَّمة أيضًا التقدم لبرنامج شريك التصميم — ستة أشهر مجانًا مقابل مراجعة فصلية.