● مجتمع
cocoindex-io
⚡ فوري
cocoindex-claude
بواسطة cocoindex-io · cocoindex-io/cocoindex-claude
يعلم Claude Code كيفية بناء خطوط أنابيب تحويل البيانات في CocoIndex — معالجة زيادية فورية لقواعس بيانات المتجهات والرسوم البيانية للمعرفة.
CocoIndex هي إطار عمل لتحويل البيانات في الوقت الفعلي لخطوط أنابيب الذكاء الاصطناعي (مصدر → تحويل → قاعدة بيانات متجهات / رسم بياني للمعرفة). تحمل هذه المهارة اتفاقياتها إلى Claude Code حتى يكتب النموذج تدفقات CocoIndex اللغوية والوظائف المخصصة وأوامر CLI/API بدلاً من التخمين بشأن مكتبة غير مألوفة.
لماذا تستخدمه
الميزات الأساسية
- معرفة جاهزة للاستخدام بتعريفات تدفقات CocoIndex والمصادر والمصارف
- إرشادات لكتابة وظائف التحويل المخصصة بشكل صحيح
- Claude يختار CLI الصحيح مقابل API البرمجية بناءً على المهمة
- يفهم دلالات المعالجة الزيادية بحيث لا يقترح إعادة بناء كاملة
- رسمي — من تأليف فريق CocoIndex
عرض مباشر
كيف يبدو في الممارسة
cocoindex-claude-skill.replay
▶ جاهز
حالات الاستخدام
استخدامات عملية: cocoindex-claude
متى تستخدمه: لقد قرأت الصفحة الرئيسية لـ CocoIndex وتريد من Claude أن ينشئ سقالة لتدفق عامل بدلاً من نسخ الدروس.
الخطوات
-
وصف الخط
استخدم مهارة cocoindex — أنشئ سقالة لتدفق يراقب ./docs، وينقسم markdown، ويدمج مع OpenAI، ويكتب إلى Qdrant.✓ تم النسخ
→ Claude ينشئ flow.py مع @cocoindex.flow_def واستدعاءات source/transform/export الصحيحة
-
تشغيل والتحقق
الآن أظهر لي أوامر CLI الدقيقة لبناء وتشغيل وتحديث هذا التدفق بشكل زيادي.✓ تم النسخ
→ أوامر cocoindex setup / update / eval بالترتيب الصحيح
النتيجة: flow.py عامل بالإضافة إلى الأوامر لتشغيله — لا مزيد من التخمين حول سطح مزخرف CocoIndex.
المزالق
- Claude يخترع APIs غير موجودة في CocoIndex — اطلب بشكل صريح 'استخدم فقط APIs موثقة في مهارة cocoindex' — تنخفض الهلوسة عندما تكون المهارة في النطاق
متى تستخدمه: التحويلات المدمجة لا تغطي خطوة التحليل / الإثراء الخاصة بك.
الخطوات
-
وصف التحويل
باستخدام مهارة cocoindex — اكتب @cocoindex.op.function التي تأخذ مسار PDF، وتستخرج الجداول، وتُرجع صفوفاً منظمة.✓ تم النسخ
→ توقيع دالة اللغة مع مدخلات/مخرجات مكتوبة بشكل صحيح
-
ربطها بالتدفق
الآن أدخل هذا في تدفقي الموجود في مرحلة التقسيم.✓ تم النسخ
→ Diff مقابل flow.py الحالي مع العملية الجديدة في مكانها
النتيجة: تحويل مخصص يطيع دلالات المعالجة الزيادية في CocoIndex.
المزالق
- تُرجع الدالة مخرجات غير حتمية، مما يكسر المعالجة الزيادية — تذكر المهارة Claude بأن التحويلات يجب أن تكون نقية — إذا واجهت هذا، أعد قراءة قسم المعالجة الزيادية
التركيبات
اجمعها مع خوادم MCP أخرى لتحقيق نتائج x10
اسمح لـ Claude بكتابة ملف flow.py فعلياً إلى القرص، وليس فقط طباعته في الدردشة
أنشئ سقالة لتدفق CocoIndex واحفظه في ./pipelines/docs_to_qdrant.py.✓ تم النسخ
أرسل مخرجات CocoIndex إلى متجر متجهات Postgres واستعلم عنها من نفس الجلسة
بناء التدفق الذي يستهدف pgvector، ثم قم بتشغيل استعلام استرجاع ضده.✓ تم النسخ
التكلفة والحدود
تكلفة التشغيل
- حصة API
- لا يوجد
- الرموز لكل استدعاء
- متواضع — تحمل المهارة مواد مرجعية فقط عند الصلة
- التكلفة المالية
- مجاني — المهارات عبارة عن ملفات محلية
- نصيحة
- CocoIndex نفسها مجانية؛ التكاليف تأتي من نموذج التضمين الخاص بك وقاعدة بيانات المتجهات، وليس هذه المهارة.
الأمان
الصلاحيات والأسرار ونطاق الأثر
تخزين بيانات الاعتماد: لا بيانات اعتماد — مطالبات نقية
نقل البيانات الخارجي: لا شيء من المهارة نفسها. يستدعي خط أنابيبك أي خدمات تضمين / قاعدة بيانات تقوم بتكوينها.
استكشاف الأخطاء
الأخطاء الشائعة وحلولها
كلمات مفتاح الزناد خاطئة — Claude يكتب Python عام بدلاً من CocoIndex
ذكر CocoIndex بشكل صريح، أو قل 'أنشئ سقالة لـ cocoindex flow_def'.
البدائل
cocoindex-claude مقابل البدائل
| البديل | متى تستخدمها | المقايضة |
|---|
| مهارات LlamaIndex | تريد تجريدات استرجاع LlamaIndex بدلاً من نموذج CocoIndex الموجه للتحويل | نموذج عقلي مختلف — LlamaIndex موجهة للاسترجاع أولاً، CocoIndex موجهة للخط الأول |
| Python مكتوب يدويًا | تحتاج إلى معالجة لمرة واحدة ولا تريد الحالة الزيادية | لا إعادة بناء زيادية، لا اتفاقيات إطار العمل |