واجهة برمجة التطبيقات للمطوّرين
ابنِ على Cuneiform Chat من شيفرتك الخاصة
واجهة REST API عامة موثّقة بمفتاح تتيح لشيفرتك أن تفعل ما تفعله لوحة التحكم: إدخال المعرفة، وإدارة وكلاء الذكاء الاصطناعي لديك، والاستعلام عنهم من أي مكان. مفتاح bearer واحد، وردود JSON يمكن التنبؤ بها، ومرجع يمكنك النسخ منه.
ما الذي يمكنك بناؤه باستخدام الواجهة البرمجية
أدخِل المعرفة برمجيًا
ادفع المستندات إلى قاعدة معرفة الوكيل مباشرةً من شيفرتك أو من خط الإنتاج لديك. تُحلَّل الملفات وتُقسَّم إلى مقاطع وتُحوَّل إلى تضمينات وتصبح قابلة للبحث — المنظومة نفسها من نوع RAG التي تستخدمها لوحة التحكم، مدفوعةً باستدعاء للواجهة البرمجية.
أدر الوكلاء كشيفرة
أنشئ وكلاء الذكاء الاصطناعي لديك واعرض قائمتهم وحدّثهم وافحصهم عبر الواجهة البرمجية. اربط إعداد الوكلاء بنظام التزويد أو التكامل المستمر (CI) الخاص بك ليصبح إنشاء وكيل جديد خطوةً في النشر بدلًا من نقرة في لوحة التحكم.
استعلِم عن وكيل من أي مكان
أرسل سؤالًا إلى أي وكيل واحصل على إجابة مؤسَّسة، بالاسترجاع والاستدلال نفسيهما اللذين تستخدمهما قنواتك. ضمّنها في تطبيق أو مهمة خلفية أو منتج آخر.
مفاتيح API محدودة النطاق وقابلة للإلغاء
أنشئ مفاتيح بالنطاقات التي تحتاجها كل مهمة فقط وألغها لحظة تسرّبها. تحمل المفاتيح البادئة cuk_live_ وتُعرض مرة واحدة فقط — أقل امتياز ممكن، بحكم التصميم.
أخطاء وحدود معدّل يمكن التنبؤ بها
كل رد هو JSON ذو بنية ثابتة، ورموز أخطاء متّسقة، وترويسات واضحة لحدود المعدّل — حتى يتمكّن عميلك من إعادة المحاولة والتراجع التدريجي وإظهار الأعطال دون تخمين.
مرجع يمكنك النسخ منه
مرجع كامل منشور يغطي التوثيق والاصطلاحات والأخطاء وحدود المعدّل وكل نقطة نهاية عبر النطاقات الثلاثة — مع أمثلة للطلب والرد جاهزة للصق.
من المفتاح إلى أول رد
خمس خطوات من طرفية فارغة إلى تكامل يعمل فعليًا.
احصل على مفتاح
افتح وحدة تحكم المطوّرين في لوحتك وأصدر مفتاح API، مختارًا النطاقات التي يحتاجها التكامل. انسخه مرة واحدة — فهو يبدأ بـ cuk_live_.
وثّق نفسك
أرسل المفتاح بوصفه Authorization: Bearer في كل طلب (ترويسة X-API-Key هي اسم بديل موثَّق). لا رقصة OAuth ولا جلسة بحاجة إلى تجديد.
استدعِ نقطة نهاية
اطرق أي مسار تحت /api/developer/v1 — أدخِل في المعرفة، أو أدر الوكلاء، أو نفّذ استعلامًا عن وكيل. عنوان URL أساسي واحد، وتوثيق واحد، وثلاثة نطاقات.
تعامل مع الرد
حلّل متن JSON، واقرأ ترويسات حدود المعدّل، وتفرّع وفق رمز الخطأ عند حدوث خلل. البنية ثابتة عبر كل نقطة نهاية.
أطلق وتوسّع
انتقل من اختبار بـ curl إلى الإنتاج: دوّر المفاتيح، وحدّد نطاقًا لكل مهمة، ودع حدود المعدّل الموثّقة توجّه إعادة المحاولة والتزامن في عميلك.
حالات الاستخدام
ما الذي تبنيه الفرق على الواجهة البرمجية
زامِن المعرفة من أنظمتك
اربط مهمة ليلية أو webhook لدفع مستندات جديدة أو مقالات مركز المساعدة أو مواصفات المنتج إلى قاعدة معرفة الوكيل — لتبقى الإجابات محدّثة دون أن يلمس أحد لوحة التحكم.
ضمّن وكيلًا في منتجك الخاص
استدعِ نقطة نهاية الاستعلام من تطبيقك أو خادمك الخلفي لإضافة مساعد ذكاء اصطناعي مؤسَّس إلى سطح لا نوفّر له قناة جاهزة: تطبيقك على الجوال، أو أداة داخلية، أو أداة مصغّرة مخصّصة.
زوّد الوكلاء ضمن CI/CD
أنشئ الوكلاء وأعدّهم كجزء من خط نشر، بحيث يتضمّن إطلاق بيئة جديدة أو مستأجِر عميل جديد وكيله الذكي كشيفرة، لا كخطوة إعداد يدوية.
أتمتة سير العمل الإداري
اجعل سكربتًا يطلب من وكيل أن يلخّص أو يصنّف أو يجيب اعتمادًا على قاعدة معرفتك وفق جدول زمني، ووجّه النتيجة إلى حيث يعمل فريقك بالفعل.
شغّل الأدوات ولوحات المعلومات الداخلية
اسحب إجابات الوكيل إلى بوت Slack أو لوحة عمليات أو وحدة دعم تملكها — مفتاح bearer واحد ورد بصيغة JSON هما كل ما يحتاجه التكامل.