mirror of
https://github.com/crewAIInc/crewAI.git
synced 2026-07-02 13:48:09 +00:00
* feat: adopt directory-based docs versioning with Edge channel Switch docs.crewai.com from navigation-only versioning (every version selector entry rendered the same docs/<lang>/* source files) to Mintlify's directory-based versioning so each version selector entry renders its own snapshot. Add an "Edge" channel under docs/edge/<lang>/* that always reflects main HEAD for unreleased work, eliminating pre-release leakage onto frozen release labels. External links to canonical /<lang>/* URLs are preserved via wildcard redirects that always land on the current default version. Layout: - docs/edge/<lang>/* rolling source (you edit here) - docs/edge/enterprise-api.*.yaml - docs/v<X.Y.Z>/<lang>/* frozen, immutable snapshots - docs/v<X.Y.Z>/enterprise-api.*.yaml - docs/images/ shared, append-only - docs/docs.json nav + redirects URLs follow the Mintlify-idiomatic shape: /edge/<lang>/<page> for Edge, /v<X.Y.Z>/<lang>/<page> for every frozen snapshot. The wildcard redirects /<lang>/:slug* -> /<default>/<lang>/:slug* keep stale links working, and every freeze rewrites them (plus all per-section/per-page redirects) so destinations always resolve to the current default without depending on a second redirect hop. Release flow integration (devtools release): - New module crewai_devtools.docs_versioning.freeze() materialises docs/v<X.Y.Z>/ from docs/edge/, rewrites openapi: refs inside the snapshot, inserts the version into every language block in docs.json, and refreshes all redirect destinations. - _update_docs_and_create_pr() in cli.py now calls that freeze during Phase 2 of devtools release. Edge changelogs are updated first (so the snapshot freeze picks them up), then the snapshot is staged alongside docs.json, branched as docs/freeze-v<X.Y.Z>, and the PR is titled [docs-freeze] docs: snapshot and changelog for v<X.Y.Z> — the title prefix the new CI guard reads. - The PR still gates tag, GitHub release, PyPI publish, and the enterprise release as before; no new PRs are added. - Pre-releases (1.X.YaN, 1.X.YbN, ...) skip the snapshot — they ride Edge — and the docs PR title omits the [docs-freeze] prefix. - docs_check (AI-generated docs scaffolding) writes to docs/edge/<lang>/* so newly-generated unreleased docs land in Edge and never accidentally touch a frozen snapshot. Migration scripts (one-shot): - scripts/docs/freeze_historical_versions.py reconstructs all 16 historical snapshots (v1.10.0 .. v1.14.7) from git tags via git archive | tar, rewriting openapi: MDX refs so each snapshot reads its own enterprise-api YAML rather than the live one. - scripts/docs/prefix_version_paths.py one-shot-migrates docs.json: rewrites every page path in 16 versioned blocks to point under docs/v<X.Y.Z>/, inserts a new Edge entry per language, tags v1.14.7 as Latest (default), prunes pages whose target file doesn't exist in the snapshot (e.g. docs/ar/ didn't exist before v1.12.0), and writes the wildcard + per-section redirects. - scripts/docs/freeze_current_edge.py is now a thin CLI wrapper around docs_versioning.freeze for manual one-off freezes (e.g. retroactively snapshotting a forgotten release). CI guards (.github/workflows/docs-snapshots.yml): - Frozen snapshots under docs/v[0-9]*/ are immutable; only PRs whose title contains [docs-freeze] (i.e. release-cut PRs generated by devtools release or the manual wrapper) may modify them. - Images under docs/images/ are append-only since snapshots share a single image directory. Deleting or renaming an image breaks every historical snapshot that still references it. Restored docs/images/crewai-otel-export.png from PR #3673; it was deleted in PR #4908 but v1.10.0 / v1.10.1 snapshots still reference it. Restoring instead of editing the snapshots preserves historical rendering fidelity and validates the new append-only rule retroactively. Tests: - lib/devtools/tests/test_docs_versioning.py covers the freeze: file copy, openapi rewrite, version insertion, default demotion, redirect upserts, per-section redirect rewriting, idempotency, and invalid inputs. Verified locally with mintlify broken-links: 0 broken links across the full site (Edge + 16 frozen versions, 4 locales). AGENTS.md (repo root) is the contributor guide for the new model; RELEASING.md is the release-cut runbook; README's Contribution section links to both. Co-authored-by: Cursor <cursoragent@cursor.com> * style: resolve linter issues --------- Co-authored-by: Cursor <cursoragent@cursor.com>
215 lines
11 KiB
Plaintext
215 lines
11 KiB
Plaintext
---
|
|
title: "البناء باستخدام الذكاء الاصطناعي"
|
|
description: "كل ما يحتاجه وكلاء البرمجة بالذكاء الاصطناعي للبناء والنشر والتوسع مع CrewAI — المهارات، وثائق مقروءة آلياً، النشر، وميزات المؤسسات."
|
|
icon: robot
|
|
mode: "wide"
|
|
---
|
|
|
|
# البناء باستخدام الذكاء الاصطناعي
|
|
|
|
CrewAI مُصمَّم أصلاً للعمل مع الذكاء الاصطناعي. تجمع هذه الصفحة ما يحتاجه وكيل البرمجة بالذكاء الاصطناعي للبناء مع CrewAI — سواءً كان Claude Code أو Codex أو Cursor أو Gemini CLI أو أي مساعد آخر يساعد المطوّر على إيصال الـ crews والـ flows.
|
|
|
|
### وكلاء البرمجة المدعومون
|
|
|
|
<CardGroup cols={5}>
|
|
<Card title="Claude Code" icon="message-bot" color="#D97706" />
|
|
<Card title="Cursor" icon="arrow-pointer" color="#3B82F6" />
|
|
<Card title="Codex" icon="terminal" color="#10B981" />
|
|
<Card title="Windsurf" icon="wind" color="#06B6D4" />
|
|
<Card title="Gemini CLI" icon="sparkles" color="#8B5CF6" />
|
|
</CardGroup>
|
|
|
|
<Note>
|
|
صُممت هذه الصفحة للبشر وللمساعدين الذكيين على حدٍّ سواء. إذا كنت وكيل برمجة، ابدأ بـ **Skills** للحصول على سياق CrewAI، ثم استخدم **llms.txt** للوصول الكامل إلى الوثائق.
|
|
</Note>
|
|
|
|
---
|
|
|
|
## 1. Skills — علِّم وكيلك CrewAI
|
|
|
|
**Skills** حزم تعليمات تمنح وكلاء البرمجة معرفة عميقة بـ CrewAI — كيفية إنشاء هيكل Flows، وضبط Crews، استخدام الأدوات، واتباع اتفاقيات الإطار.
|
|
|
|
<Tabs>
|
|
<Tab title="Claude Code (سوق الإضافات)">
|
|
<img src="https://cdn.simpleicons.org/anthropic/D97706" alt="Anthropic" width="28" style={{display: "inline", verticalAlign: "middle", marginRight: "8px"}} />
|
|
مهارات 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.jsonc` / `main.py` |
|
|
| `design-agent` | ضبط الوكلاء — الدور، الهدف، الخلفية، الأدوات، نماذج اللغة، الذاكرة، الحدود الآمنة |
|
|
| `design-task` | وصف المهام، التبعيات، المخرجات المنظمة (`output_pydantic`، `output_json`)، المراجعة البشرية |
|
|
| `ask-docs` | الاستعلام من [خادم CrewAI docs MCP](https://docs.crewai.com/mcp) للحصول على تفاصيل واجهة البرمجة الحالية |
|
|
</Tab>
|
|
<Tab title="npx (أي وكيل)">
|
|
يعمل مع Claude Code أو Codex أو Cursor أو Gemini CLI أو أي وكيل برمجة:
|
|
```shell
|
|
npx skills add crewaiinc/skills
|
|
```
|
|
يُجلب من [سجل skills.sh](https://skills.sh/crewaiinc/skills).
|
|
</Tab>
|
|
</Tabs>
|
|
|
|
<Steps>
|
|
<Step title="ثبِّت حزمة المهارات الرسمية">
|
|
استخدم إحدى الطريقتين أعلاه — سوق إضافات Claude Code أو `npx skills add`. كلاهما يثبّت الحزمة الرسمية [crewAIInc/skills](https://github.com/crewAIInc/skills).
|
|
</Step>
|
|
<Step title="يحصل وكيلك فوراً على خبرة CrewAI">
|
|
تعلّم الحزمة وكيلك:
|
|
- **Flows** — تطبيقات ذات حالة، خطوات، وتشغيل crews
|
|
- **Crews والوكلاء** — أنماط JSON-first (`crew.jsonc` و `agents/*.jsonc`)، الأدوار، المهام، التفويض
|
|
- **الأدوات والتكاملات** — البحث، واجهات API، خوادم MCP، وأدوات CrewAI الشائعة
|
|
- **هيكل المشروع** — هياكل CLI واتفاقيات المستودع
|
|
- **أنماط محدثة** — يتماشى مع وثائق CrewAI الحالية وأفضل الممارسات
|
|
</Step>
|
|
<Step title="ابدأ البناء">
|
|
يمكن لوكيلك الآن إنشاء هيكل وبناء مشاريع CrewAI دون أن تعيد شرح الإطار في كل جلسة.
|
|
</Step>
|
|
</Steps>
|
|
|
|
<CardGroup cols={2}>
|
|
<Card title="مفهوم Skills" icon="bolt" href="/ar/concepts/skills">
|
|
كيف تعمل المهارات في وكلاء CrewAI — الحقن، التفعيل، والأنماط.
|
|
</Card>
|
|
<Card title="صفحة Skills" icon="wand-magic-sparkles" href="/ar/skills">
|
|
نظرة على حزمة crewAIInc/skills وما تتضمنه.
|
|
</Card>
|
|
<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.sh" icon="globe" href="https://skills.sh/crewaiinc/skills">
|
|
القائمة الرسمية — المهارات، إحصاءات التثبيت، والتدقيق.
|
|
</Card>
|
|
</CardGroup>
|
|
|
|
---
|
|
|
|
## 2. llms.txt — وثائق مقروءة آلياً
|
|
|
|
ينشر CrewAI ملف `llms.txt` يمنح المساعدين الذكيين وصولاً مباشراً إلى الوثائق الكاملة بصيغة مقروءة آلياً.
|
|
|
|
```
|
|
https://docs.crewai.com/llms.txt
|
|
```
|
|
|
|
<Tabs>
|
|
<Tab title="ما هو llms.txt؟">
|
|
[`llms.txt`](https://llmstxt.org/) معيار ناشئ لجعل الوثائق قابلة للاستهلاك من قبل نماذج اللغة الكبيرة. بدلاً من استخراج HTML، يمكن لوكيلك جلب ملف نصي واحد منظم بكل المحتوى المطلوب.
|
|
|
|
ملف `llms.txt` الخاص بـ CrewAI **متاح فعلياً** — يمكن لوكيلك استخدامه الآن.
|
|
</Tab>
|
|
<Tab title="كيفية الاستخدام">
|
|
وجِّه وكيل البرمجة إلى عنوان URL عندما يحتاج إلى مرجع CrewAI:
|
|
|
|
```
|
|
Fetch https://docs.crewai.com/llms.txt for CrewAI documentation.
|
|
```
|
|
|
|
يمكن للعديد من وكلاء البرمجة (Claude Code، Cursor، وغيرهما) جلب عناوين URL مباشرة. يحتوي الملف على وثائق منظمة تغطي مفاهيم CrewAI وواجهات البرمجة والأدلة.
|
|
</Tab>
|
|
<Tab title="لماذا يهم">
|
|
- **دون استخراج ويب** — محتوى نظيف ومنظم في طلب واحد
|
|
- **دائماً محدث** — يُقدَّم مباشرة من docs.crewai.com
|
|
- **محسّن لنماذج اللغة** — مُنسَّق لنوافذ السياق لا للمتصفحات
|
|
- **يُكمّل Skills** — المهارات تعلّم الأنماط، وllms.txt يوفّر المرجع
|
|
</Tab>
|
|
</Tabs>
|
|
|
|
---
|
|
|
|
## 3. النشر للمؤسسات
|
|
|
|
انتقل من crew محلي إلى الإنتاج على **CrewAI AMP** (منصة إدارة الوكلاء) في دقائق.
|
|
|
|
<Steps>
|
|
<Step title="ابنِ محلياً">
|
|
أنشئ الهيكل واختبر crew أو flow:
|
|
```bash
|
|
crewai create crew my_crew
|
|
cd my_crew
|
|
crewai run
|
|
```
|
|
</Step>
|
|
<Step title="جهّز للنشر">
|
|
تأكد أن هيكل مشروعك جاهز:
|
|
```bash
|
|
crewai deploy --prepare
|
|
```
|
|
راجع [دليل التحضير](/ar/enterprise/guides/prepare-for-deployment) لتفاصيل الهيكل والمتطلبات.
|
|
</Step>
|
|
<Step title="انشر على AMP">
|
|
ادفع إلى منصة CrewAI AMP:
|
|
```bash
|
|
crewai deploy
|
|
```
|
|
يمكنك أيضاً النشر عبر [تكامل GitHub](/ar/enterprise/guides/deploy-to-amp) أو [Crew Studio](/ar/enterprise/guides/enable-crew-studio).
|
|
</Step>
|
|
<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" \
|
|
-H "Content-Type: application/json" \
|
|
-d '{"inputs": {"topic": "AI agents"}}'
|
|
```
|
|
</Step>
|
|
</Steps>
|
|
|
|
<CardGroup cols={2}>
|
|
<Card title="النشر على AMP" icon="rocket" href="/ar/enterprise/guides/deploy-to-amp">
|
|
دليل النشر الكامل — CLI وGitHub وCrew Studio.
|
|
</Card>
|
|
<Card title="مقدمة عن AMP" icon="globe" href="/ar/enterprise/introduction">
|
|
نظرة على المنصة — ما يوفّره AMP لـ crews في الإنتاج.
|
|
</Card>
|
|
</CardGroup>
|
|
|
|
---
|
|
|
|
## 4. ميزات المؤسسات
|
|
|
|
CrewAI AMP مُصمَّم لفرق الإنتاج. إليك ما تحصل عليه بعد النشر.
|
|
|
|
<CardGroup cols={2}>
|
|
<Card title="المراقبة والرصد" icon="chart-line">
|
|
مسارات تنفيذ مفصّلة، وسجلات، ومقاييس أداء لكل تشغيل crew. راقب قرارات الوكلاء، استدعاءات الأدوات، وإكمال المهام في الوقت الفعلي.
|
|
</Card>
|
|
<Card title="Crew Studio" icon="paintbrush">
|
|
واجهة منخفضة/بدون كود لإنشاء crews وتخصيصها ونشرها بصرياً — ثم التصدير إلى الشيفرة أو النشر مباشرة.
|
|
</Card>
|
|
<Card title="بث الويبهوك" icon="webhook">
|
|
بث أحداث فورية من تنفيذات الـ crews إلى أنظمتك. تكامل مع Slack أو Zapier أو أي مستهلك ويبهوك.
|
|
</Card>
|
|
<Card title="إدارة الفريق" icon="users">
|
|
SSO وRBAC وضوابط على مستوى المؤسسة. أدر من يمكنه إنشاء crews ونشرها والوصول إليها.
|
|
</Card>
|
|
<Card title="مستودع الأدوات" icon="toolbox">
|
|
انشر وشارك أدواتاً مخصصة عبر مؤسستك. ثبّت أدوات المجتمع من السجل.
|
|
</Card>
|
|
<Card title="Factory (استضافة ذاتية)" icon="server">
|
|
شغّل CrewAI AMP على بنيتك التحتية. قدرات المنصة كاملة مع ضوابط إقامة البيانات والامتثال.
|
|
</Card>
|
|
</CardGroup>
|
|
|
|
<AccordionGroup>
|
|
<Accordion title="لمن مخصص AMP؟">
|
|
لفرق تحتاج نقل سير عمل وكلاء الذكاء الاصطناعي من النماذج الأولية إلى الإنتاج — مع المراقبة وضوابط الوصول والبنية التحتية القابلة للتوسع. سواءً كنت ناشئاً أو مؤسسة كبيرة، يتولى AMP التعقيد التشغيلي لتتفرغ لبناء الوكلاء.
|
|
</Accordion>
|
|
<Accordion title="ما خيارات النشر المتاحة؟">
|
|
- **السحابة (app.crewai.com)** — تُدار من CrewAI، أسرع طريق إلى الإنتاج
|
|
- **Factory (استضافة ذاتية)** — على بنيتك التحتية لسيطرة كاملة على البيانات
|
|
- **هجين** — دمج السحابة والاستضافة الذاتية حسب حساسية البيانات
|
|
</Accordion>
|
|
</AccordionGroup>
|
|
|
|
<Card title="استكشف CrewAI AMP →" icon="arrow-right" href="https://app.crewai.com">
|
|
سجّل وانشر أول crew لك في الإنتاج.
|
|
</Card>
|