هل يمكن للوكيل إتمام طلب؟
نعم. بعد أن يربط العميل وكيلًا خارجيًا، يمكن للوكيل البحث عن المنتجات وإدارة السلة ومعاينة الدفع وإتمام طلب مدفوع من المحفظة بعد موافقة العميل الصريحة.
الأسئلة الشائعة
كيف يعمل وكيل الذكاء الاصطناعي الخارجي مع حسابك في OT2.
كيف يربط العميل وكيلًا بحسابه؟
ينشئ العميل مفتاح تكامل قابلًا للإلغاء في OT2، أو يوافق على اتصال OAuth 2.1 مع PKCE. لا يحصل الوكيل أبدًا على كلمة مرور العميل أو رمز التحقق OTP أو جلسة تسجيل الدخول.
هل يمكن للوكيل معرفة رصيد المحفظة؟
لا. يمكنه معرفة ما إذا كان رصيد المحفظة موجبًا وما إذا كان يغطي الطلب الذي تمت معاينته فقط. لا تكشف OT2 عن المبلغ أو العجز أو رابط للشحن.
ماذا يحدث إذا كان رصيد المحفظة غير كافٍ؟
يشحن العميل المحفظة من تطبيق OT2. ثم يعيد الوكيل معاينة الدفع قبل طلب الموافقة وإتمام الطلب.
هل يمكن للوكيل استخدام الدفع عند الاستلام أو اختيار طريقة دفع أخرى؟
لا. تجارة الوكلاء تعمل بمحفظة OT2 فقط، ولا يوجد خيار لاختيار طريقة دفع.
هل يمكن للوكيل الشراء لشخص آخر؟
لا. يكون التوصيل للعميل نفسه وعلى عنوانه الخاص. لا تُقبل بيانات تواصل لمستلم آخر أو لصديق أو لهدية.
ما هو checkout_state؟
هي النتيجة الموقّعة وغير المقروءة لمعاينة الدفع. تربط السلة الحالية والعنوان والقسيمة والحالة التي يحسبها الخادم. يجب ألا يعدّلها الوكيل أو يفك ترميزها أبدًا، وعليه إعادة المعاينة بعد أي تغيير.
كيف تتم إعادة المحاولة؟
أعد المحاولة فقط عند خطأ قابل لإعادة المحاولة. إذا كانت نتيجة الطلب غير مؤكدة، فأعد إرسال الطلب نفسه تمامًا بمفتاح عدم التكرار (idempotency key) نفسه. أي تغيّر في حالة الدفع يتطلب معاينة جديدة وموافقة جديدة.
كيف يتم تتبع الطلبات؟
يمكن للوكيل عرض وقراءة وتتبع الطلبات التي تمت عبر اتصاله فقط. ويعرض الحالات وتفاصيل التتبع كما تصله دون اختلاق موعد للوصول.
كيف يتم الإرجاع والاستبدال؟
يتحقق الوكيل من الأهلية، ثم يقدّم منتجًا مستلمًا مؤهلًا مع سبب العميل. تراجع OT2 الطلب، ولا يمكن للوكيل إصدار استرداد مالي.
هل يمكن للعميل إيقاف جميع الوكلاء؟
نعم. يمكن للعميل إيقاف وصول جميع الوكلاء مؤقتًا فورًا واستئنافه لاحقًا. كما يمكن إلغاء اتصال واحد بشكل نهائي.
ماذا يحدث بعد الإلغاء أو التدوير؟
تتوقف بيانات الاعتماد القديمة عن العمل وتُلغى جلسات MCP المرتبطة بها. يجب على الوكيل التوقف واستخدام بيانات اعتماد جديدة مصرّح بها.
ما هو X-Request-Id؟
هو معرّف لاستجابة REST واحدة يُستخدم للربط مع فريق الدعم. احتفظ به عند الإبلاغ عن طلب فاشل أو غير مؤكد. وهو ليس رقم طلب ولا مفتاح عدم تكرار (idempotency key).
مصادر للوكلاء والمطورين
تنشر واجهة OT2 البرمجية هذه المستندات وتحدّثها. يجب على المطورين والوكلاء اعتمادها كمصدر موثوق.
- نظرة عامة على OT2 لنماذج اللغة (llms.txt)
نظرة عامة مختصرة على تجارة الوكلاء في OT2 لنماذج اللغة.
https://ot2.com/llms.txt - الوثائق الكاملة للوكلاء (llms-full.txt)
وثائق تجارة الوكلاء كاملة في ملف نصي واحد.
https://ot2.com/llms-full.txt - دليل مصادقة الوكلاء
كيفية ربط الوكيل بحساب العميل عبر مفتاح تكامل أو OAuth.
https://ot2.com/auth.md - الأسئلة الشائعة للوكلاء بصيغة Markdown
هذه الأسئلة والأجوبة بصيغة Markdown للوكلاء.
https://ot2.com/faq.md - مرجع واجهة REST للوكلاء (OpenAPI)
مرجع OpenAPI لواجهة REST الخاصة بالوكلاء.
https://ot2.com/openapi.yaml - دليل الواجهات البرمجية
قائمة قابلة للقراءة آليًا بأوصاف واجهات OT2 البرمجية ووثائقها.
https://ot2.com/.well-known/api-catalog - اكتشاف خادم MCP
مستند اكتشاف خادم MCP الخاص بـ OT2.
https://ot2.com/.well-known/mcp.json - فهرس مهارات الوكلاء
فهرس مهارات الوكلاء التي تنشرها OT2.
https://ot2.com/.well-known/agent-skills/index.json - مهارة OT2 Commerce للوكلاء
تعليمات مهارة الوكيل (Agent Skill) للتسوق في OT2.
https://ot2.com/agent-skills/ot2-commerce/SKILL.md - ملف robots.txt للواجهة البرمجية
قواعد الزواحف لخادم واجهة OT2 البرمجية.
https://ot2.com/robots.txt - خريطة موقع الواجهة البرمجية
فهرس المستندات العامة على خادم واجهة OT2 البرمجية.
https://ot2.com/sitemap.xml