انتقل إلى المحتوى الرئيسي انتقل إلى الملاحة انتقل إلى التذييل

نظرة عامة على تكامل وكلاء الذكاء الاصطناعي

كيف تُدير Claude Code وCursor وCline بنية Rediacc التحتية عبر rdc: مخرجات JSON، واستبطان الوكيل، وضوابط الأمان.

صراحةً، rdc مصمّم مع مراعاة الوكلاء من الأساس. سواء كنت تستخدم Claude Code أو Cursor أو Cline، فأي مساعد ذكاء اصطناعي ينادي rdc في صدفة فرعية يحصل على مخرجات JSON منظمة، وأخطاء قابلة للقراءة آليًا، وضوابط أمان تناسب إدارة بنية Rediacc التحتية باستقلالية. إليك كيف يعمل التكامل.

لماذا الاستضافة الذاتية + وكلاء الذكاء الاصطناعي

بنية Rediacc ملائمة للوكلاء بطبيعتها:

  • CLI أولاً: كل عملية هي أمر rdc, لا حاجة لواجهة رسومية
  • قائم على SSH: البروتوكول الذي يعرفه الوكلاء جيدًا من بيانات التدريب
  • مخرجات JSON: جميع الأوامر تدعم --output json مع غلاف موحد
  • عزل Docker: كل مستودع يحصل على daemon وفضاء شبكة خاص به
  • قابل للبرمجة: --yes يتخطى التأكيدات، --dry-run يعاين العمليات المدمرة

مناهج التكامل

1. قالب AGENTS.md / CLAUDE.md

أسرع طريقة للبدء. انسخ قالب AGENTS.md إلى جذر مشروعك:

  • CLAUDE.md لـ Claude Code
  • .cursorrules لـ Cursor
  • .windsurfrules لـ Windsurf

ضعه في المكان المناسب وسيمتلك الوكيل المرجع الكامل للأوامر، وسياق البنية، والاتفاقيات التي يحتاجها للعمل دون تخمين.

2. خط أنابيب مخرجات JSON

عندما يستدعي الوكلاء rdc في صدفة فرعية، تتحول المخرجات تلقائيًا إلى JSON (اكتشاف non-TTY). يستخدم كل رد JSON غلافًا موحدًا:

{
  "success": true,
  "command": "machine query",
  "data": { ... },
  "errors": null,
  "warnings": [],
  "metrics": { "duration_ms": 42 }
}

تتضمن ردود الأخطاء حقلي retryable وguidance:

{
  "success": false,
  "errors": [{
    "code": "NOT_FOUND",
    "message": "Machine \"prod-2\" not found",
    "retryable": false,
    "guidance": "Verify the resource name with \"rdc machine status\" or \"rdc repo list\""
  }]
}

أعلام مهمة للوكلاء

العلمالغرض
--output json / -o jsonمخرجات JSON قابلة للقراءة آليًا
--yes / -yتخطي التأكيدات التفاعلية
--quiet / -qكتم مخرجات stderr المعلوماتية
--fields name,statusتحديد المخرجات بحقول معينة
--dry-runمعاينة العمليات المدمرة دون تنفيذها

السلامة والضوابط

لا يتعامل CLI مع الوكلاء بالطريقة ذاتها التي يتعامل بها مع إنسان أمام الطرفية. العمليات الحساسة تتطلب إثبات معرفتك بالحالة الراهنة عبر العلم --current، وتدفقات المحرر التفاعلية مرفوضة افتراضيًا، وكل رفض يُسجَّل في سجل التدقيق. يغطي مرجع السلامة والضوابط لوكلاء الذكاء الاصطناعي جدول جدار الحماية الكامل، ونموذج بوابة المعرفة، ونطاق التجاوز REDIACC_ALLOW_CONFIG_EDIT، وسجل التدقيق المرتبط بالتجزئة.

الخطوات التالية