updated descriptions and applied the actual translations (#5572)

2026-05-04 16:52:37 +00:00 · 2026-04-21 08:55:39 -07:00
parent 9caed61f36
commit 84a4d47aa7
5 changed files with 309 additions and 255 deletions
--- a/docs/ar/guides/coding-tools/build-with-ai.mdx
+++ b/docs/ar/guides/coding-tools/build-with-ai.mdx
@@ -1,15 +1,15 @@
 ---
-title: "Build with AI"
-description: "Everything AI coding agents need to build, deploy, and scale with CrewAI — skills, machine-readable docs, deployment, and enterprise features."
+title: "البناء باستخدام الذكاء الاصطناعي"
+description: "كل ما يحتاجه وكلاء البرمجة بالذكاء الاصطناعي للبناء والنشر والتوسع مع CrewAI — المهارات، وثائق مقروءة آلياً، النشر، وميزات المؤسسات."
 icon: robot
 mode: "wide"
 ---

-# Build with AI
+# البناء باستخدام الذكاء الاصطناعي

-CrewAI is AI-native. This page brings together everything an AI coding agent needs to build with CrewAI — whether you're Claude Code, Codex, Cursor, Gemini CLI, or any other assistant helping a developer ship crews and flows.
+CrewAI مُصمَّم أصلاً للعمل مع الذكاء الاصطناعي. تجمع هذه الصفحة ما يحتاجه وكيل البرمجة بالذكاء الاصطناعي للبناء مع CrewAI — سواءً كان Claude Code أو Codex أو Cursor أو Gemini CLI أو أي مساعد آخر يساعد المطوّر على إيصال الـ crews والـ flows.

-### Supported Coding Agents
+### وكلاء البرمجة المدعومون

 <CardGroup cols={5}>
  <Card title="Claude Code" icon="message-bot" color="#D97706" />
@@ -20,128 +20,139 @@ CrewAI is AI-native. This page brings together everything an AI coding agent nee
 </CardGroup>

 <Note>
-  This page is designed to be consumed by both humans and AI assistants. If you're a coding agent, start with **Skills** to get CrewAI context, then use **llms.txt** for full docs access.
+  صُممت هذه الصفحة للبشر وللمساعدين الذكيين على حدٍّ سواء. إذا كنت وكيل برمجة، ابدأ بـ **Skills** للحصول على سياق CrewAI، ثم استخدم **llms.txt** للوصول الكامل إلى الوثائق.
 </Note>

 ---

-## 1. Skills — Teach Your Agent CrewAI
+## 1. Skills — علِّم وكيلك CrewAI

-**Skills** are instruction packs that give coding agents deep CrewAI knowledge — how to scaffold Flows, configure Crews, use tools, and follow framework conventions.
+**Skills** حزم تعليمات تمنح وكلاء البرمجة معرفة عميقة بـ CrewAI — كيفية إنشاء هيكل Flows، وضبط Crews، استخدام الأدوات، واتباع اتفاقيات الإطار.

 <Tabs>
-  <Tab title="Claude Code (Plugin Marketplace)">
+  <Tab title="Claude Code (سوق الإضافات)">
    <img src="https://cdn.simpleicons.org/anthropic/D97706" alt="Anthropic" width="28" style={{display: "inline", verticalAlign: "middle", marginRight: "8px"}} />
-    CrewAI skills are available in the **Claude Code plugin marketplace** — the same distribution channel used by top AI-native companies:
-    ```
+    مهارات CrewAI متاحة في **سوق إضافات Claude Code** — نفس قناة التوزيع التي تستخدمها شركات رائدة في مجال الذكاء الاصطناعي:
+    ```shell
    /plugin marketplace add crewAIInc/skills
+    /plugin install crewai-skills@crewai-plugins
+    /reload-plugins
    ```
+
+    تُفعَّل أربع مهارات تلقائياً عند طرح أسئلة متعلقة بـ CrewAI:
+
+    | المهارة | متى تُستخدم |
+    |---------|-------------|
+    | `getting-started` | مشاريع جديدة، الاختيار بين `LLM.call()` / `Agent` / `Crew` / `Flow`، ربط `crew.py` / `main.py` |
+    | `design-agent` | ضبط الوكلاء — الدور، الهدف، الخلفية، الأدوات، نماذج اللغة، الذاكرة، الحدود الآمنة |
+    | `design-task` | وصف المهام، التبعيات، المخرجات المنظمة (`output_pydantic`، `output_json`)، المراجعة البشرية |
+    | `ask-docs` | الاستعلام من [خادم CrewAI docs MCP](https://docs.crewai.com/mcp) للحصول على تفاصيل واجهة البرمجة الحالية |
  </Tab>
-  <Tab title="npx (Any Agent)">
-    Works with Claude Code, Codex, Cursor, Gemini CLI, or any coding agent:
+  <Tab title="npx (أي وكيل)">
+    يعمل مع Claude Code أو Codex أو Cursor أو Gemini CLI أو أي وكيل برمجة:
    ```shell
    npx skills add crewaiinc/skills
    ```
-    Pulls from the [skills.sh registry](https://skills.sh/crewaiinc/skills).
+    يُجلب من [سجل skills.sh](https://skills.sh/crewaiinc/skills).
  </Tab>
 </Tabs>

 <Steps>
-  <Step title="Install the official skill pack">
-    Use either method above — the Claude Code plugin marketplace or `npx skills add`. Both install the official [crewAIInc/skills](https://github.com/crewAIInc/skills) pack.
+  <Step title="ثبِّت حزمة المهارات الرسمية">
+    استخدم إحدى الطريقتين أعلاه — سوق إضافات Claude Code أو `npx skills add`. كلاهما يثبّت الحزمة الرسمية [crewAIInc/skills](https://github.com/crewAIInc/skills).
  </Step>
-  <Step title="Your agent gets instant CrewAI expertise">
-    The skill pack teaches your agent:
-    - **Flows** — stateful apps, steps, and crew kickoffs
-    - **Crews & Agents** — YAML-first patterns, roles, tasks, delegation
-    - **Tools & Integrations** — search, APIs, MCP servers, and common CrewAI tools
-    - **Project layout** — CLI scaffolds and repo conventions
-    - **Up-to-date patterns** — tracks current CrewAI docs and best practices
+  <Step title="يحصل وكيلك فوراً على خبرة CrewAI">
+    تعلّم الحزمة وكيلك:
+    - **Flows** — تطبيقات ذات حالة، خطوات، وتشغيل crews
+    - **Crews والوكلاء** — أنماط YAML أولاً، الأدوار، المهام، التفويض
+    - **الأدوات والتكاملات** — البحث، واجهات API، خوادم MCP، وأدوات CrewAI الشائعة
+    - **هيكل المشروع** — هياكل CLI واتفاقيات المستودع
+    - **أنماط محدثة** — يتماشى مع وثائق CrewAI الحالية وأفضل الممارسات
  </Step>
-  <Step title="Start building">
-    Your agent can now scaffold and build CrewAI projects without you re-explaining the framework each session.
+  <Step title="ابدأ البناء">
+    يمكن لوكيلك الآن إنشاء هيكل وبناء مشاريع CrewAI دون أن تعيد شرح الإطار في كل جلسة.
  </Step>
 </Steps>

 <CardGroup cols={2}>
-  <Card title="Skills concept" icon="bolt" href="/en/concepts/skills">
-    How skills work in CrewAI agents — injection, activation, and patterns.
+  <Card title="مفهوم Skills" icon="bolt" href="/ar/concepts/skills">
+    كيف تعمل المهارات في وكلاء CrewAI — الحقن، التفعيل، والأنماط.
  </Card>
-  <Card title="Skills landing page" icon="wand-magic-sparkles" href="/en/skills">
-    Overview of the crewAIInc/skills pack and what it includes.
+  <Card title="صفحة Skills" icon="wand-magic-sparkles" href="/ar/skills">
+    نظرة على حزمة crewAIInc/skills وما تتضمنه.
  </Card>
-  <Card title="AGENTS.md & coding tools" icon="terminal" href="/en/guides/coding-tools/agents-md">
-    Set up AGENTS.md for Claude Code, Codex, Cursor, and Gemini CLI.
+  <Card title="AGENTS.md والأدوات" icon="terminal" href="/ar/guides/coding-tools/agents-md">
+    إعداد AGENTS.md لـ Claude Code وCodex وCursor وGemini CLI.
  </Card>
-  <Card title="Skills registry (skills.sh)" icon="globe" href="https://skills.sh/crewaiinc/skills">
-    Official listing — skills, install stats, and audits.
+  <Card title="سجل skills.sh" icon="globe" href="https://skills.sh/crewaiinc/skills">
+    القائمة الرسمية — المهارات، إحصاءات التثبيت، والتدقيق.
  </Card>
 </CardGroup>

 ---

-## 2. llms.txt — Machine-Readable Docs
+## 2. llms.txt — وثائق مقروءة آلياً

-CrewAI publishes an `llms.txt` file that gives AI assistants direct access to the full documentation in a machine-readable format.
+ينشر CrewAI ملف `llms.txt` يمنح المساعدين الذكيين وصولاً مباشراً إلى الوثائق الكاملة بصيغة مقروءة آلياً.

 ```
 https://docs.crewai.com/llms.txt
 ```

 <Tabs>
-  <Tab title="What is llms.txt?">
-    [`llms.txt`](https://llmstxt.org/) is an emerging standard for making documentation consumable by large language models. Instead of scraping HTML, your agent can fetch a single structured text file with all the content it needs.
+  <Tab title="ما هو llms.txt؟">
+    [`llms.txt`](https://llmstxt.org/) معيار ناشئ لجعل الوثائق قابلة للاستهلاك من قبل نماذج اللغة الكبيرة. بدلاً من استخراج HTML، يمكن لوكيلك جلب ملف نصي واحد منظم بكل المحتوى المطلوب.

-    CrewAI's `llms.txt` is **already live** — your agent can use it right now.
+    ملف `llms.txt` الخاص بـ CrewAI **متاح فعلياً** — يمكن لوكيلك استخدامه الآن.
  </Tab>
-  <Tab title="How to use it">
-    Point your coding agent at the URL when it needs CrewAI reference docs:
+  <Tab title="كيفية الاستخدام">
+    وجِّه وكيل البرمجة إلى عنوان URL عندما يحتاج إلى مرجع CrewAI:

    ```
    Fetch https://docs.crewai.com/llms.txt for CrewAI documentation.
    ```

-    Many coding agents (Claude Code, Cursor, etc.) can fetch URLs directly. The file contains structured documentation covering all CrewAI concepts, APIs, and guides.
+    يمكن للعديد من وكلاء البرمجة (Claude Code، Cursor، وغيرهما) جلب عناوين URL مباشرة. يحتوي الملف على وثائق منظمة تغطي مفاهيم CrewAI وواجهات البرمجة والأدلة.
  </Tab>
-  <Tab title="Why it matters">
-    - **No scraping required** — clean, structured content in one request
-    - **Always up-to-date** — served directly from docs.crewai.com
-    - **Optimized for LLMs** — formatted for context windows, not browsers
-    - **Complements skills** — skills teach patterns, llms.txt provides reference
+  <Tab title="لماذا يهم">
+    - **دون استخراج ويب** — محتوى نظيف ومنظم في طلب واحد
+    - **دائماً محدث** — يُقدَّم مباشرة من docs.crewai.com
+    - **محسّن لنماذج اللغة** — مُنسَّق لنوافذ السياق لا للمتصفحات
+    - **يُكمّل Skills** — المهارات تعلّم الأنماط، وllms.txt يوفّر المرجع
  </Tab>
 </Tabs>

 ---

-## 3. Deploy to Enterprise
+## 3. النشر للمؤسسات

-Go from a local crew to production on **CrewAI AMP** (Agent Management Platform) in minutes.
+انتقل من crew محلي إلى الإنتاج على **CrewAI AMP** (منصة إدارة الوكلاء) في دقائق.

 <Steps>
-  <Step title="Build locally">
-    Scaffold and test your crew or flow:
+  <Step title="ابنِ محلياً">
+    أنشئ الهيكل واختبر crew أو flow:
    ```bash
    crewai create crew my_crew
    cd my_crew
    crewai run
    ```
  </Step>
-  <Step title="Prepare for deployment">
-    Ensure your project structure is ready:
+  <Step title="جهّز للنشر">
+    تأكد أن هيكل مشروعك جاهز:
    ```bash
    crewai deploy --prepare
    ```
-    See the [preparation guide](/en/enterprise/guides/prepare-for-deployment) for details on project structure and requirements.
+    راجع [دليل التحضير](/ar/enterprise/guides/prepare-for-deployment) لتفاصيل الهيكل والمتطلبات.
  </Step>
-  <Step title="Deploy to AMP">
-    Push to the CrewAI AMP platform:
+  <Step title="انشر على AMP">
+    ادفع إلى منصة CrewAI AMP:
    ```bash
    crewai deploy
    ```
-    You can also deploy via [GitHub integration](/en/enterprise/guides/deploy-to-amp) or [Crew Studio](/en/enterprise/guides/enable-crew-studio).
+    يمكنك أيضاً النشر عبر [تكامل GitHub](/ar/enterprise/guides/deploy-to-amp) أو [Crew Studio](/ar/enterprise/guides/enable-crew-studio).
  </Step>
-  <Step title="Access via API">
-    Your deployed crew gets a REST API endpoint. Integrate it into any application:
+  <Step title="الوصول عبر API">
+    يحصل الـ crew المنشور على نقطة نهاية REST. دمجه في أي تطبيق:
    ```bash
    curl -X POST https://app.crewai.com/api/v1/crews/<crew-id>/kickoff \
      -H "Authorization: Bearer $CREWAI_API_KEY" \
@@ -152,55 +163,55 @@ Go from a local crew to production on **CrewAI AMP** (Agent Management Platform)
 </Steps>

 <CardGroup cols={2}>
-  <Card title="Deploy to AMP" icon="rocket" href="/en/enterprise/guides/deploy-to-amp">
-    Full deployment guide — CLI, GitHub, and Crew Studio methods.
+  <Card title="النشر على AMP" icon="rocket" href="/ar/enterprise/guides/deploy-to-amp">
+    دليل النشر الكامل — CLI وGitHub وCrew Studio.
  </Card>
-  <Card title="AMP introduction" icon="globe" href="/en/enterprise/introduction">
-    Platform overview — what AMP provides for production crews.
+  <Card title="مقدمة عن AMP" icon="globe" href="/ar/enterprise/introduction">
+    نظرة على المنصة — ما يوفّره AMP لـ crews في الإنتاج.
  </Card>
 </CardGroup>

 ---

-## 4. Enterprise Features
+## 4. ميزات المؤسسات

-CrewAI AMP is built for production teams. Here's what you get beyond deployment.
+CrewAI AMP مُصمَّم لفرق الإنتاج. إليك ما تحصل عليه بعد النشر.

 <CardGroup cols={2}>
-  <Card title="Observability" icon="chart-line">
-    Detailed execution traces, logs, and performance metrics for every crew run. Monitor agent decisions, tool calls, and task completion in real time.
+  <Card title="المراقبة والرصد" icon="chart-line">
+    مسارات تنفيذ مفصّلة، وسجلات، ومقاييس أداء لكل تشغيل crew. راقب قرارات الوكلاء، استدعاءات الأدوات، وإكمال المهام في الوقت الفعلي.
  </Card>
  <Card title="Crew Studio" icon="paintbrush">
-    No-code/low-code interface to create, customize, and deploy crews visually — then export to code or deploy directly.
+    واجهة منخفضة/بدون كود لإنشاء crews وتخصيصها ونشرها بصرياً — ثم التصدير إلى الشيفرة أو النشر مباشرة.
  </Card>
-  <Card title="Webhook Streaming" icon="webhook">
-    Stream real-time events from crew executions to your systems. Integrate with Slack, Zapier, or any webhook consumer.
+  <Card title="بث الويبهوك" icon="webhook">
+    بث أحداث فورية من تنفيذات الـ crews إلى أنظمتك. تكامل مع Slack أو Zapier أو أي مستهلك ويبهوك.
  </Card>
-  <Card title="Team Management" icon="users">
-    SSO, RBAC, and organization-level controls. Manage who can create, deploy, and access crews across your team.
+  <Card title="إدارة الفريق" icon="users">
+    SSO وRBAC وضوابط على مستوى المؤسسة. أدر من يمكنه إنشاء crews ونشرها والوصول إليها.
  </Card>
-  <Card title="Tool Repository" icon="toolbox">
-    Publish and share custom tools across your organization. Install community tools from the registry.
+  <Card title="مستودع الأدوات" icon="toolbox">
+    انشر وشارك أدواتاً مخصصة عبر مؤسستك. ثبّت أدوات المجتمع من السجل.
  </Card>
-  <Card title="Factory (Self-Hosted)" icon="server">
-    Run CrewAI AMP on your own infrastructure. Full platform capabilities with data residency and compliance controls.
+  <Card title="Factory (استضافة ذاتية)" icon="server">
+    شغّل CrewAI AMP على بنيتك التحتية. قدرات المنصة كاملة مع ضوابط إقامة البيانات والامتثال.
  </Card>
 </CardGroup>

 <AccordionGroup>
-  <Accordion title="Who is AMP for?">
-    AMP is for teams that need to move AI agent workflows from prototypes to production — with observability, access controls, and scalable infrastructure. Whether you're a startup or enterprise, AMP handles the operational complexity so you can focus on building agents.
+  <Accordion title="لمن مخصص AMP؟">
+    لفرق تحتاج نقل سير عمل وكلاء الذكاء الاصطناعي من النماذج الأولية إلى الإنتاج — مع المراقبة وضوابط الوصول والبنية التحتية القابلة للتوسع. سواءً كنت ناشئاً أو مؤسسة كبيرة، يتولى AMP التعقيد التشغيلي لتتفرغ لبناء الوكلاء.
  </Accordion>
-  <Accordion title="What deployment options are available?">
-    - **Cloud (app.crewai.com)** — managed by CrewAI, fastest path to production
-    - **Factory (self-hosted)** — run on your own infrastructure for full data control
-    - **Hybrid** — mix cloud and self-hosted based on sensitivity requirements
+  <Accordion title="ما خيارات النشر المتاحة؟">
+    - **السحابة (app.crewai.com)** — تُدار من CrewAI، أسرع طريق إلى الإنتاج
+    - **Factory (استضافة ذاتية)** — على بنيتك التحتية لسيطرة كاملة على البيانات
+    - **هجين** — دمج السحابة والاستضافة الذاتية حسب حساسية البيانات
  </Accordion>
-  <Accordion title="How does pricing work?">
-    Sign up at [app.crewai.com](https://app.crewai.com) to see current plans. Enterprise and Factory pricing is available on request.
+  <Accordion title="كيف يعمل التسعير؟">
+    سجّل في [app.crewai.com](https://app.crewai.com) لمعرفة الخطط الحالية. تسعير المؤسسات وFactory متاح عند الطلب.
  </Accordion>
 </AccordionGroup>

-<Card title="Explore CrewAI AMP →" icon="arrow-right" href="https://app.crewai.com">
-  Sign up and deploy your first crew to production.
+<Card title="استكشف CrewAI AMP →" icon="arrow-right" href="https://app.crewai.com">
+  سجّل وانشر أول crew لك في الإنتاج.
 </Card>