وثائق API

ادمج Chameleon بحدود واضحة.

دليل عام لعقد التكامل: كيف تصادق التطبيقات وتحدد نطاق سياق الأعمال وتطلب الذكاء وتتلقى مخرجات منظمة وتتعامل مع الموافقات.

نموذج التكامل

صادق. حدد النطاق. حقق. راجع. نفّذ.

ينتمي كل طلب إلى تطبيق ومساحة عمل معتمدين. يحدد الطلب المهمة والسياق المسموح به. تعيد Chameleon ذكاءً منظماً واقتراح إجراء فقط عندما يدعم سير العمل ذلك.

واجهة API قيد تطوير مُدار. يحصل المطورون المعتمدون على مرجع نقاط النهاية والمخططات وبيانات الاعتماد وإشعارات التغيير داخل مساحة المطور الخاصة بهم.
طلب تصوريJSON
{
  "workspace": "approved-workspace",
  "task": "investigate",
  "question": "Where is margin leaking?",
  "context": ["business_dna", "approved_files"],
  "output": "executive_report",
  "action_policy": "approval_required"
}

الإرشادات الأساسية

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

01

المصادقة

استخدم بيانات اعتماد من جهة الخادم صادرة لتطبيق معتمد. أبقِ الأسرار خارج كود المتصفح والمستودعات العامة والسجلات والاستجابات الظاهرة للعميل.

02

تحديد نطاق السياق

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

03

دورة حياة الطلب

أنشئ المهمة وراقب حالتها عند الحاجة لعمل غير متزامن واسترجع النتيجة واحتفظ بمعرف الطلب.

04

المخرجات المنظمة

توقع نتائج واضحة ومراجع أدلة وحقائق ناقصة وافتراضات ومخاطر وتوصيات واقتراحات إجراءات عند طلبها.

05

الحدود وإعادة المحاولة

احترم حدود التطبيق وتراجع بعد الأعطال المؤقتة وتجنب الطلبات المكررة وحافظ على عدم التكرار حيث يتطلب العقد الحالي ذلك.

06

الأخطاء وقابلية التتبع

احفظ معرفات الطلب وتعامل بشكل منفصل مع أخطاء الصلاحيات والتحقق ولا تكشف الأسرار الداخلية عند تسجيل الأعطال.

انضباط الإنتاج

تعامل مع سير عمل الذكاء كسير عمل تطبيقات حرج.

VERSIONING

ثبّت العقد

استخدم الإصدار المعتمد وراجع إشعارات التغيير قبل اعتماد عقد أحدث.

SECURITY

احمِ بيانات الاعتماد

بدّل المفاتيح المخترقة واعزل بيانات الاعتماد حسب التطبيق والبيئة.

QUALITY

راجع النتائج عالية التأثير

اطلب مراجعة مؤهلة للقرارات القانونية أو المالية أو الطبية أو التنظيمية أو غيرها من القرارات المؤثرة.

CONTROL

وافق قبل التنفيذ

أبقِ التنفيذ الحساس خلف حدود موافقة واضحة للمستخدم أو مساحة العمل.

مستعد للتكامل؟

اطلب الوصول المُدار للحصول على مرجع نقاط النهاية الحالي ومتطلبات التنفيذ.