> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gorbit.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# Craft (تجريبي)

> إنشاء تطبيقات ويب ومستندات وشرائح والمزيد من معرفة شركتك

<img className="rounded-image" src="https://mintcdn.com/gorbit/qYeWoSrsnkRPFQDm/assets/overview/core_features/craft.png?fit=max&auto=format&n=qYeWoSrsnkRPFQDm&q=85&s=12bca1c29683735c2797ed9df3adf859" alt="واجهة Gorbit Craft" width="3321" height="1857" data-path="assets/overview/core_features/craft.png" />

يتيح Gorbit Craft للمستخدمين إنشاء تطبيقات ويب، ومستندات، وعروض تقديمية،
والمزيد من معرفة الشركة باستخدام وكيل برمجة ذكاء اصطناعي في بيئة معزولة. يصف المستخدمون ما يريدون،
ويبني الوكيل الأدوات باستخدام مستنداتهم المفهرسة والملفات المرفوعة.

<Note>
  يتطلب Craft تكوين موفر نموذج لغوي كبير (Anthropic، OpenAI، إلخ) ليعمل.
</Note>

## القدرات الرئيسية

<CardGroup cols={2}>
  <Card title="تطبيقات الويب" icon="browser">
    بناء تطبيقات Next.js مع React و shadcn/ui و Recharts للوحات معلومات وأدوات تفاعلية جميلة.
  </Card>

  <Card title="المستندات" icon="file-lines">
    إنشاء مستندات وتقارير وملفات markdown مصقولة من معرفة شركتك.
  </Card>

  <Card title="الشرائح والصور" icon="presentation-screen">
    إنشاء عروض تقديمية ومحتوى مرئي مع nanobanana للشرائح وإنشاء الصور.
  </Card>

  <Card title="تكامل المعرفة" icon="database">
    الوصول إلى المستندات المفهرسة من موصلك (Linear، Slack، Google Drive، Confluence، إلخ)
    مباشرة في مخرجاتك.
  </Card>
</CardGroup>

<Note>
  **قريباً:** جداول البيانات ولوحات معلومات HTML
</Note>

<img className="rounded-image" src="https://mintcdn.com/gorbit/qYeWoSrsnkRPFQDm/assets/overview/core_features/craft_sandbox.png?fit=max&auto=format&n=qYeWoSrsnkRPFQDm&q=85&s=edc9298f349f6825b22ebfae3d93842b" alt="بيئة Craft المعزولة" width="3210" height="1863" data-path="assets/overview/core_features/craft_sandbox.png" />

## كيف يعمل

**إنشاء جلسة** - ابدأ جلسة Craft جديدة من مسار `/craft` في Gorbit

**صف ما تحتاجه** - أخبر الوكيل ما تريد بناءه بلغة طبيعية

**شاهده يبني** - ينشئ الوكيل أداتك باستخدام معرفة شركتك

**معاينة وتكرار** - شاهد مخرجاتك مباشرة واطلب تغييرات أو إضافات

**تنزيل** - صدّر أداتك المكتملة

## ما يمكنك بناؤه

يتفوق Craft في إنشاء أدوات تستفيد من معرفة شركتك:

* **لوحات معلومات تفاعلية** - تصور المقاييس ومؤشرات الأداء الرئيسية من مصادر بياناتك المتصلة
* **أدوات داخلية** - بناء تطبيقات ويب مخصصة لسير عمل محدد
* **مستندات وتقارير** - إنشاء مستندات مصقولة من محتواك المفهرس
* **عروض تقديمية** - إنشاء شرائح مع مرئيات مولدة بالذكاء الاصطناعي
* **مستكشفات البيانات** - واجهات تفاعلية لتصفح وتحليل المستندات
* **نماذج أولية** - نمذجة سريعة للأفكار باستخدام بياناتك الحالية

## التفاصيل التقنية

<Accordion title="بيئة المعزل">
  تعمل كل جلسة Craft في بيئة معزولة مع:

  * إطار عمل تطبيق **Next.js** مع React
  * مكتبة مكونات **shadcn/ui** لعناصر واجهة مستخدم مصقولة
  * **Recharts** لتصور البيانات
  * **بيئة Python** مع numpy و pandas و matplotlib لمعالجة البيانات
  * وصول للقراءة فقط لمستنداتك المفهرسة
  * مساحة عمل منفصلة لكل جلسة
</Accordion>

<Accordion title="حدود تحميل الملفات">
  * الحجم الأقصى للملف: **50MB** لكل ملف
  * الحد الأقصى للملفات لكل جلسة: **20 ملفاً**
  * الحجم الأقصى الإجمالي لكل جلسة: **200MB**
  * الصيغ المدعومة: CSV، JSON، PDF، الصور، وملفات الكود الشائعة
</Accordion>

<Accordion title="خيارات النشر">
  يمكن تشغيل Craft في وضعين:

  * **الوضع المحلي** - تعمل البيئات المعزولة كأدلة داخل نشر Docker Compose (افتراضي)
  * **وضع Kubernetes** - تعمل البيئات المعزولة كبودات Kubernetes مع لقطات وتنظيف تلقائي
    (عمليات نشر بمقياس الإنتاج)
</Accordion>

## تمكين Craft

### عمليات النشر الجديدة

عند تثبيت Gorbit، استخدم علامة `--include-craft`:

```bash theme={null}
curl -fsSL https://raw.githubusercontent.com/gorbit-dot-app/gorbit/main/deployment/docker_compose/install.sh > install.sh && chmod +x install.sh && ./install.sh --include-craft
```

تقوم علامة `--include-craft` بـ:

* تعيين `ENABLE_CRAFT=true` في ملف `.env`
* تعيين `IMAGE_TAG=craft-latest` لاستخدام الصور الممكنة لـ Craft
* تشغيل نص إعداد قوالب Craft عند بدء الحاوية

<Note>
  يضيف Craft Node.js 20 وأداة opencode CLI إلى صورة الواجهة الخلفية، مما يزيد من وقت البناء وحجم الصورة.
  قد يستغرق بدء التشغيل الأول وقتاً أطول أثناء إعداد القوالب.
</Note>

### عمليات النشر الحالية

إذا كنت قد نشرت Gorbit بالفعل بدون Craft، يمكنك تمكينه عن طريق تشغيل:

```bash theme={null}
ENABLE_CRAFT=true IMAGE_TAG=craft-latest docker compose up -d
```

### التحقق من تمكين Craft

بعد التثبيت:

* يجب أن تظهر سجلات حاوية الواجهة الخلفية "Setting up Gorbit Craft templates..."
* يجب أن يكون مسار `/craft` قابلاً للوصول في واجهة المستخدم

<Warning>
  تأكد من أن لديك موفر نموذج لغوي كبير مُعدّ (Anthropic، OpenAI، إلخ) ليعمل Craft.
</Warning>

## التكوين

| متغير البيئة                     | الوصف                                   | الافتراضي |
| -------------------------------- | --------------------------------------- | --------- |
| `ENABLE_CRAFT`                   | تمكين/تعطيل Craft                       | `false`   |
| `SANDBOX_BACKEND`                | وضع المعزل: `local` أو `kubernetes`     | `local`   |
| `SANDBOX_IDLE_TIMEOUT_SECONDS`   | مهلة الخمول قبل تنظيف المعزل            | `3600`    |
| `SANDBOX_MAX_CONCURRENT_PER_ORG` | الحد الأقصى للمعازل المتزامنة لكل مؤسسة | `10`      |