عمليات الأعمالالمهارات العامة

Point of Sale

عمليات نقاط البيع الكاملة لوكلاء الذكاء الاصطناعي — تسجيل المبيعات، معالجة المدفوعات (نقد/بطاقة/إم-بيسا/رمز QR)، إدارة العربات، الولاء، الفواتير الإلكترونية، الإيصالات، الورديات، والاستردادات. 38 أداة، 22 معيار فاتورة إلكترونية، 24 لغة.

افتح مصدر المهارة اقرأ الدليل الرسمي ↗

ما تعلمه هذه المهارة

دليل قابل لإعادة الاستخدام لنوع معين من العمل.

يخبر خادم MCP الوكيل بالإجراءات المتاحة. تضيف المهارة الحكم حول تلك الإجراءات: كيفية التعرف على المهمة، التسلسل الذي يجب اتباعه، ما يجب تجنبه، وكيفية تحديد اكتمال النتيجة.

تنسيق عمليات نقاط البيع — تسجيل المبيعات، معالجة المدفوعات (نقد/بطاقة/نقود محمولة/رمز QR)، إدارة العربات، تطبيق الخصومات، التعامل مع الولاء، إنشاء الفواتير الإلكترونية والإيصالات، إدارة الورديات، ومعالجة الاستردادات. استخدم عند معالجة بيع، مسح الباركود، استلام المدفوعات، تطبيق الخصومات، التحقق من الولاء…

الهيكلية

كيف يوجه Point of Sale وكيل ADK-Rust.

تبقى المهارة قابلة للقراءة وقابلة للنقل لأنها تحتوي على تعليمات بدلاً من بيانات اعتماد الخدمة أو بيانات العمل. يوفرها ADK-Rust للوكيل، يختار الوكيل من حدود الأدوات المراجعة، ويؤدي خادم MCP المتصل العملية المصادق عليها.

طلب المستخدم

يتلقى الوكيل هدفًا معبرًا عنه بلغة عادية.

→

مهارة Point of Sale

يطابق النية، يزود دليل القرار، ويضيق حدود الأداة.

→

وكيل ADK-Rust

يخطط سير العمل ويبث كل خطوة ذات معنى عبر بيئة التشغيل.

→

mcp-pos

ينفذ العمليات المصادق عليها ضد النظام الذي يمتلك القدرة.

→

النتيجة الموثوقة

تشكل قواعد إكمال المهارة الأدلة التي تُعاد إلى المستخدم.

تعليمات محمولة: SKILL.md · حدود القدرة: mcp-pos · الأدوات المسموح بها: 39

دليل القرار

كيف يحول الوكيل الطلب إلى الإجراء الصحيح.

تأتي هذه المسارات مباشرة من تعليمات المهارة. تساعد النموذج على التعرف على النية واختيار أداة أو سير عمل مركّز بدلاً من الارتجال عبر كامل سطح القدرة.

"بيع جديد"، "بدء معاملة"؟

cart_create

"مسح"، "إضافة عنصر"، "باركود"؟

barcode_lookup

"خصم"، "عرض ترويجي"؟

cart_apply_discount

"دفع"، "الدفع"، "نقد"، "بطاقة"، "إم-بيسا"؟

payment_process

"رمز QR"، "مسح للدفع"؟

payment_qr_generate

"تقسيم الدفع"، "جزء نقد وجزء بطاقة"؟

split_tender

"ولاء"، "نقاط"؟

loyalty_check / loyalty_redeem

"إيصال"؟

receipt_generate / receipt_bilingual

سير عمل مثبتة

تسلسلات قابلة للتكرار لنتائج مفيدة.

يربط سير العمل عدة استدعاءات أدوات في مهمة يتعرف عليها المستخدم فعليًا. تشرح المهارة التسلسل والنتيجة المقصودة بينما يقوم ADK-Rust ببث تقدم الوكيل عبر بيئة التشغيل المشتركة.

014 استدعاء

بيع قياسي

مسح → دفع → إيصال

024 استدعاء

نقود محمولة

رمز QR → إم-بيسا → إيصال

035 استدعاء

دفع مقسم

نقد + بطاقة معًا

041 استدعاء

إغلاق وردية

تسوية النقد + الفروقات

052 استدعاء

استرداد

تفويض → إرجاع

06With استدعاء

بدون

مع

حدود الأداة

قد تستخدم المهارة 39 أدوات موثقة.

يتم إعلان هذه القائمة المسموح بها من قبل المهارة. تحافظ على تركيز الوكيل على الإجراءات اللازمة لهذه المهمة بينما يحتفظ mcp-pos بالمسؤولية عن المصادقة، التحقق، والنظام المتصل.

product_register

cart_create

cart_add_item

cart_remove_item

cart_apply_discount

cart_get

barcode_lookup

payment_process

payment_qr_generate

split_tender

multi_currency_checkout

ebt_snap_pay

meal_voucher

fiscal_config

einvoice_generate

receipt_generate

receipt_sign

receipt_bilingual

cart_void

price_override

cart_suspend

cart_recall

suspended_list

receipt_reprint

role_set_limits

authorize_check

age_verify

shift_open

shift_close

daily_summary

loyalty_check

loyalty_redeem

us_tax_lookup

tip_calculate

tip_add

env_levy_add

tax_category_set

buyer_identify

refund

قواعد العمل

ما الذي يجب على الوكيل القيام به.

دائماً أنشئ عربة قبل إضافة العناصر
تحقق من أن الدفع ≥ إجمالي العربة قبل الإتمام
وقع كل إيصال (receipt_sign) للامتثال المالي
تحقق من تفويض الدور للإلغاء، الاسترداد، تجاوز الأسعار
تحقق من العمر للمنتجات المقيدة (الكحول، التبغ)

حدود التشغيل

ما الذي يجب على الوكيل تجنبه.

لا تعالج الدفع دون عرض إجمالي العربة أولاً
لا تلغي دون تفويض المشرف
لا تتخطى توقيع الإيصال (مسار تدقيق مالي)
لا تسمح بتجاوز السعر بدون رمز سبب
لا تعالج استرداد بدون مرجع الإيصال الأصلي

التثبيت والاتصال

أضف المهارة بجانب القدرة التي تتوقعها.

ثبت المستودع حيث يمكن لمحمّل مهارات ADK-Rust اكتشافه، اتصل بـ mcp-pos، وتأكد من توفر الأدوات المعلنة قبل طلب الوكيل استخدام سير العمل.

ثبت المهارة

git clone https://github.com/zavora-ai/skill-point-of-sale.git \
  ~/.skills/skills/point-of-sale

شكل تحميل ADK-Rust

let skills = SkillLoader::from_dir("~/.skills/skills").await?;
let skill = skills.load("point-of-sale").await?;

let agent = LlmAgentBuilder::new("agent")
    .instruction(skill.instructions())
    .tools(skill.allowed_tools(toolset)?)
    .build()?;

بيان التوافق الخاص بالمستودع: يتطلب اتصال بخادم mcp-pos. يدعم 22 معيار فاتورة إلكترونية، 24 لغة، أكثر من 20 مزود دفع عبر رمز QR.

الوثائق الرسمية

اقرأ حزمة المهارة الكاملة.

يبقى المستودع هو المرجع الدقيق لتعليماته، أمثلته، سكريبتات المساعدة، الأصول، متطلبات MCP، الترخيص، والتحديثات اللاحقة.

نظرة عامة ↗README.md تعليمات المهارة ↗SKILL.md تدفقات عمل عبر Mcp ↗references/cross-mcp-workflows.md أمثلة ↗references/examples.md تسلسلات الأدوات ↗references/tool-sequences.md تسوية النقد ↗scripts/cash_reconciliation.py قالب الإيصال ↗assets/receipt-template.md

استمر في الاستكشاف