بروتوكول A2A و MCP
واجهة المطورين وتكامل الوكلاء الذكيين
بدون مفتاح API. استدعِ Quality for Everyone عبر A2A JSON-RPC 2.0 أو بروتوكول سياق النموذج (MCP) للتحقق من الشهادات واستكشاف الدورات وتشغيل 12 حاسبة جودة.
A2A JSON-RPC 2.0
/api/a2a
POST / GET • 60 طلب/دقيقة
خادم أدوات MCP
/api/mcp
tools/list و tools/call
بطاقة الوكيل
/.well-known/agent.json
ملف اكتشاف A2A JSON
بيان النماذج اللغوية
/llms.txt
دليل نصي للوكلاء
أول استدعاء خلال 5 دقائق
أرسل طلب POST بصيغة JSON-RPC 2.0 إلى /api/a2a أو /api/mcp. يمكنك تمرير اسم المهارة داخل params.metadata.skill أو params.skill أو مباشرة في method.
curl -sS -X POST https://www.qualityforeveryone.com/api/a2a \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"id": "first-call-1",
"method": "tasks/send",
"params": {
"metadata": { "skill": "calculate-oee" },
"input": {
"planned": 480,
"run": 456,
"idealCycle": 0.5,
"total": 850,
"good": 820
}
}
}'المهارات وأدوات MCP المسجلة (16)
جميع حاسبات الجودة الـ 12 متاحة عبر كل من /api/a2a و /api/mcp.
| معرّف المهارة / الأداة | البروتوكول | المدخلات المطلوبة | الوصف |
|---|---|---|---|
| verify-certificate | A2A | code (نص، مثال: QFE-7X9B-2M4L-8K1P) | يتحقق من شهادة Quality for Everyone عبر الرمز مع إخفاء أحرف اللقب حفاظًا على الخصوصية. |
| list-courses | A2A | لا يوجد | يعرض جميع دورات الأكاديمية المنشورة دون المسودات أو مفاتيح إجابات الاختبار. |
| get-course | A2A | slug أو id | يسترد البيانات الوصفية للدورة ومخطط الدروس المنشورة. |
| get-lesson | A2A | id أو slug | يسترد محتوى القراءة لدرس منشور ضمن دورة منشورة. |
| calculate-oee | A2A + MCP | planned, run, idealCycle, total, good | Calculate Overall Equipment Effectiveness (Availability × Performance × Quality) and identify the largest loss category. When to use: Use when evaluating manufacturing line efficiency, machine utilization, or TPM/lean equipment losses. |
| calculate-aql | A2A + MCP | lot, aql | Compute ANSI/ASQ Z1.4 / ISO 2859-1 single-sampling acceptance plan (code letter, sample size, Ac, Re) for a given lot size, inspection level, and AQL. When to use: Use when planning incoming, in-process, or final lot acceptance inspection. |
| calculate-grr | A2A + MCP | readings | Perform Measurement Systems Analysis (MSA) Gage R&R using the Average & Range method (2 appraisers, 2-10 parts, 2-3 trials) returning EV, AV, GRR, %TV, %Tolerance, and ndc. When to use: Use when validating measurement system repeatability and reproducibility. |
| calculate-dpmo | A2A + MCP | defects, units, opportunities | Calculate Defects Per Opportunity (DPO), Defects Per Million Opportunities (DPMO), yield %, Z-score, and 1.5-sigma shifted Six Sigma level. When to use: Use when benchmarking defect rates or Six Sigma performance across processes. |
| calculate-rty | A2A + MCP | yieldsPct | Calculate multi-step First Pass Yield (FPY) and Rolled Throughput Yield (RTY), identifying the weakest step and units lost per 1,000. When to use: Use when analyzing cumulative yield loss across a multi-stage production or service process. |
| calculate-takt | A2A + MCP | available, demand | Calculate customer Takt time, cycle-time gap, line capacity, and demand shortfall across time units (s, min, h, shift). When to use: Use when balancing assembly lines or matching production pace to customer demand. |
| calculate-mtbf | A2A + MCP | operating, failures, repair | Calculate Mean Time Between Failures (MTBF), Mean Time To Repair (MTTR), and inherent availability. When to use: Use when analyzing equipment reliability, maintenance KPIs, or uptime SLAs. |
| calculate-capability | A2A + MCP | usl, lsl, mean, sigma | Compute Cp, Cpu, Cpl, Cpk, capability verdict band, sigma level, and expected PPM out-of-spec. When to use: Use when assessing whether a stable process meets engineering specification limits (USL/LSL). |
| calculate-control | A2A + MCP | n, grandMean, rBar | Calculate X-bar and R chart control limits (UCL/LCL) using standard A2, D3, D4 constants and optionally detect Western Electric out-of-control rules. When to use: Use when setting up Statistical Process Control (SPC) charts or checking subgroup means for instability. |
| calculate-copq | A2A + MCP | internal, external, appraisal, prevention, revenue | Calculate total Cost of Quality / Poor Quality, percentage of revenue, failure-to-prevention ratio, and category shares. When to use: Use when quantifying financial impact of internal/external failures, appraisal, and prevention. |
| calculate-ppm | A2A + MCP | defective, total | Convert defective unit counts and total inspected units into Parts Per Million (PPM), percentage rate, and defects per 1,000. When to use: Use when reporting supplier quality PPM or lot defect rates. |
| calculate-risk | A2A + MCP | severity, occurrence, detection | Calculate S×O risk score and FMEA Risk Priority Number (RPN = S×O×D) on a 1-5 scale, flagging cases where high detection masks severe risk. When to use: Use when prioritizing FMEA failure modes or operational quality risks. |