دليل تكامل وكلاء الذكاء الاصطناعي و WebMCP
منصة رزين تدعم معيار WebMCP لتمكين وكلاء الذكاء الاصطناعي ومحركات البحث الذكية من استدعاء الأدوات الحسابية واسترجاع المعلومات المهيكلة برمجياً وبأعلى درجات الأمان.
1. استدعاء الأدوات برمجياً
أدوات مسجلة بمعيار JSON Schema v7 تنفّذ محلياً داخل المتصفح بدون كشط DOM أو محاكاة النقر.
2. أمان وصلاحيات دقيقة
فصل صارم بين أدوات القراءة والحسابات الخالية من الآثار الجانبية (READ) وعمليات الإرسال المعتمدة (ACTION).
3. شبكة كيانات مترابطة
مخططات Schema.org و JSON-LD تغطي المؤسسة، البرمجيات، الأدوات، الأسعار، والمقالات ككيان معرفي موحد.
سجل أدوات WebMCP المتاحة (15 أداة)
يمكن للوكلاء استدعاء أي من هذه الأدوات مباشرة عبر واجهة WebMCP المدمجة.
search_knowledge_and_solutionsREADSearch across RZAIN ERP modules, 31 Saudi contractor sectors, 10 interactive calculators, and technical construction management articles.
Search keyword or phrase in Arabic or English (e.g. 'مستخلصات', 'ZATCA', 'gantt', 'تأخير', 'خرسانة')
Filter by entity category
get_company_profileREADRetrieve the verified corporate profile, regulatory compliance status (ZATCA / Saudi accounting standards), core differentiators, and contact details for RZAIN (رزين ERP).
list_erp_modulesREADList all 7 specialized ERP modules integrated within the RZAIN platform.
get_module_detailsREADGet full specifications, feature breakdown, and FAQs for a specific RZAIN ERP module (projects, accounting, hr, crm, procurement, inventory, maintenance).
Slug of the module
get_pricing_and_plansREADGet details of RZAIN ERP subscription tiers (Basic, Growth, Enterprise), included features, target audiences, and custom quotation policies.
list_contractor_sectorsREADList the 31 specialized Saudi contractor and construction sectors supported with customized workflows in RZAIN ERP.
Category filter
calculate_project_profitabilityREADCalculate true construction project profitability, net margin percentage, unpriced overhead impact, variation orders net effect, and delay break-even threshold in months.
Original contract value in SAR
Total planned direct costs (materials, labor, plant, subcontractors) in SAR
Head office & site indirect costs as a percentage of contract value (e.g. 8 for 8%)
Net approved and expected variation orders in SAR (can be positive or negative)
Expected or actual project delay duration in months
Monthly site fixed overhead cost during delay in SAR
calculate_cash_flow_gapREADCalculate the working capital financing gap (in days and SAR) and annual cost of capital for a construction project based on billing cycles and supplier terms.
Progress claim issuance cycle in days (typically 30 days)
Owner payment delay after claim certification in days (e.g. 60 or 90 days)
Supplier and subcontractor payment grace period in days (e.g. 45 days)
Average monthly project expenditure/burn rate in SAR
Advance payment percentage received from owner (e.g. 10 for 10%)
Annual banking facility interest rate or opportunity cost of capital % (e.g. 7.5)
calculate_retention_recoveryREADCalculate retention money status, due releases, locked liquidity, and the financing cost of unreleased retention funds.
Total contract value in SAR
Contract retention percentage (typically 10%)
Current work completion percentage (0-100%)
Percentage released at initial handover (typically 50%)
Months passed since initial site handover (0 if not handed over yet)
Defects liability warranty period in months (typically 12 or 24 months)
Annual cost of capital / funding rate % (e.g. 8)
calculate_variation_orderREADCalculate the complete financial claim value of a construction variation order including overheads, profit markup, time prolongation costs, and contractual notice deadline risk.
Direct execution cost of the new variation work in SAR
Overhead percentage to allocate (e.g. 10%)
Contractual profit margin percentage (e.g. 15%)
Additional schedule delay / extension of time in days
Daily site fixed indirect cost in SAR during prolongation
Days elapsed since the change event occurred
Contractual notice period limit in days (e.g. 14 or 28 days)
calculate_tender_markupREADCalculate cumulative compounding markup for construction tenders, final bidding price, safety margin threshold, and projected profit under cost overrun scenarios.
Direct project estimate (Bill of Quantities base cost) in SAR
Site general conditions & management % (e.g. 6%)
Head office general overhead allocation % (e.g. 5%)
Contingency & technical risk allowance % (e.g. 3%)
Bank guarantees, letters of credit & insurance costs % (e.g. 2%)
Target net profit percentage % (e.g. 10%)
Simulated execution cost overrun % for stress testing (e.g. 5%)
run_erp_readiness_assessmentREADEvaluate a construction company's readiness to implement an ERP system across 4 pillars: Operational Processes, Data Hygiene, Management Commitment, and Team Capability.
Score 0 (none) to 3 (fully standardized & audited) for documented SOPs
Score 0 (verbal/whatsapp) to 3 (structured electronic audit trail)
Score 0 (uncontrolled) to 3 (3-way matching PO-GRN-Invoice)
Score 0 (single general ledger bucket) to 3 (hierarchical project/item cost centers)
Score 0 (scattered paper) to 3 (clean structured digital database)
Score 0 (no tracking) to 3 (real-time site and central warehouse balance)
Score 0 (delegated to IT) to 3 (CEO/Owner actively leading transformation)
Score 0 (seeking cheapest software) to 3 (budgeted for software + training + change)
Score 0 (high resistance) to 3 (eager and comfortable with modern apps)
Score 0 (will abandon at first hurdle) to 3 (committed leadership & champions)
get_blog_articleREADRetrieve full text, direct answer snippet, key takeaways, and FAQ for an expert construction article by slug.
Slug of the blog article (e.g. 'progress-claims-delays', 'contracting-cash-flow', 'tender-pricing-mistakes')
search_faqREADSearch and retrieve authoritative answers from RZAIN's comprehensive FAQ knowledge base.
Question keywords or topic (e.g. 'تخصيص', 'مستخلصات', 'ZATCA', 'تجربة', 'دعم')
submit_lead_or_demo_requestACTIONSubmit a consultation request or schedule a live system demonstration for a Saudi contracting company.
Contact person's full name
Contracting company name
Mobile phone number (e.g. 05xxxxxxxx)
Official business email
Company size / employee bracket
Primary operational challenge
Request intent
Additional context or notes
طريقة الاستدعاء عبر JavaScript أو Browser Agent
يمكن لأي وكيل ذكي استدعاء الأدوات الحسابية مباشرة وقراءة النتائج المهيكلة:
// Example: Calculating variation order impact via WebMCP
const result = await window.__rzain_webmcp__.callTool("calculate_variation_order", {
directCost: 150000,
overheadPct: 10,
profitPct: 12,
addedDays: 20,
dailySiteCost: 3500,
noticeDays: 7,
noticeLimitDays: 14
});
console.log(result.data.metrics.totalLegitimateClaimSAR);
// Output: 254800 (Priced change + Extension of Time impact)المستندات المهيكلة الكاملة للوكلاء ونماذج اللغة (LLM Context)
ملفات نصية مهيكلة مخصصة للفهرسة والتدريب والاسترجاع المباشر في أنظمة RAG: