BuilderIO/agent-native / packages/core/docs
agent-native-docs
UnverifiedHow to look up version-matched Agent-Native framework docs and source in node_modules. Use before coding against @agent-native/core APIs or advanced features.
content/locales/ar-SA/agent-resources.mdx
View on GitHub---
title: "موارد الوكيل"
description: "تخصيص Claude على مستوى التعليمات البرمجية لكل مستخدم — skills، الذاكرة، التعليمات، الوكلاء المخصصون، المهام المجدولة، خوادم MCP — مدعومة بـ PostgreSQL/PGlite، وليس نظام ملفات."
---
# موارد الوكيل
يأتي كل تطبيق وكيل أصلي مزودًا بـ **موارد الوكيل**: طبقة التخصيص التي تجعل الوكيل ملكًا لك. فهو يحتوي على تعليمات الفريق (`AGENTS.md`)، والتعلم المشترك (`LEARNINGS.md`)، والذاكرة المنظمة الشخصية (`memory/MEMORY.md`)، وskills الذي يسحبه الوكيل عند الطلب، والوكلاء الفرعيين المخصصين، والمهام المجدولة، وخوادم MCP المتصلة — كل ما تتوقعه من إعداد Claude Code / Codex.
التطور: ** إنها صفوف PostgreSQL/PGlite، وليست ملفات نظام الملفات. ** يحصل كل مستخدم على مجموعته الخاصة من موارد الوكيل المخزنة في قاعدة البيانات. لا يوجد صندوق تطوير لتدويره، ولا توجد حاوية لكل مستخدم، ولا توجد ملفات لتحميلها. يمكن أن توفر SaaS متعددة المستأجرين لكل مستخدم وكيلًا قابلاً للتخصيص بالكامل مجانًا بشكل أساسي، لأن كل ذلك عبارة عن صفوف - الذاكرة الشخصية، وخوادم MCP الشخصية، وskills الشخصية، والوكلاء الفرعيين الشخصيين - وتستضيف قاعدة التعليمات البرمجية المشتركة كل منهم في وقت واحد.
<Diagram id="doc-block-rv7x2e" title={"إعداد Claude-Code، ولكن مخزّن كموارد وكيل في PostgreSQL/PGlite"} summary={"نفس طبقة التخصيص - التعليمات، والمهارات، والذاكرة، والوكلاء، والوظائف، MCP - باستثناء كل ملف عبارة عن صف في قاعدة بيانات مشتركة متعددة المستأجرين."}>
```html
<div class="ws-map">
<div class="diagram-card cc">
<span class="diagram-pill warn">Claude Code / Codex</span
><small class="diagram-muted">~/.claude/ on a local disk</small>
<div class="ws-files">
<span class="diagram-box">CLAUDE.md</span
><span class="diagram-box">skills/</span
><span class="diagram-box">memory</span
><span class="diagram-box">mcp.json</span>
</div>
<small class="diagram-muted">one codebase per developer</small>
</div>
<div class="diagram-arrow diagram-muted" aria-hidden="true">→</div>
<div class="diagram-card an">
<span class="diagram-pill accent">موارد Agent-Native</span
><small class="diagram-muted"
>rows in one قاعدة بيانات PostgreSQL/PGlite</small
>
<div class="ws-rows">
<span class="diagram-pill">AGENTS.md</span
><span class="diagram-pill">skills/…</span
><span class="diagram-pill">memory/…</span
><span class="diagram-pill">mcp-servers/…</span>
</div>
<small class="diagram-muted"
>قاعدة كود واحدة، مستخدمون متعددون، بنطاقات
<code>u:<email>:…</code></small
>
</div>
</div>
```
```css
.ws-map {
display: flex;
align-items: center;
gap: 16px;
flex-wrap: wrap;
}
.ws-map .diagram-card {
display: flex;
flex-direction: column;
gap: 8px;
padding: 16px 18px;
flex: 1;
min-width: 220px;
}
.ws-map .ws-files,
.ws-map .ws-rows {
display: flex;
flex-wrap: wrap;
gap: 6px;
margin: 4px 0;
}
.ws-map .diagram-arrow {
font-size: 24px;
}
```
</Diagram>
| رمز Claude / Codex | موارد الوكيل الأصلية |
| -------------------------------------- | ------------------------------------------------- |
| الملفات الموجودة على القرص المحلي لديك | الصفوف في قاعدة بيانات PostgreSQL/PGlite المشتركة |
| قاعدة تعليمات برمجية واحدة لكل مطور | قاعدة تعليمات برمجية واحدة والعديد من المستخدمين |
| يحتاج إلى صندوق تطوير أو حاوية | يتم تشغيله على أي مضيف بدون خادم/حافة |
| التخصيص في `~/.claude/` | التخصيص لكل مستخدم، `u:<email>:…` محدد النطاق |
| `CLAUDE.md` / skills لكل مشروع | `AGENTS.md` لكل تطبيق + موارد الذاكرة |
| تكوين MCP في ملف JSON | تكوين MCP في JSON _أو_ الإعدادات UI، لكل نطاق |
نفس الإمكانيات. اقتصاد مختلف. راجع [التطبيقات](/docs/cloneable-saas) لمعرفة سبب أهمية ذلك بالنسبة إلى SaaS.
## نظرة عامة {#overview}
تحتوي الموارد على ثلاثة نطاقات لوقت التشغيل:
- **شخصي** — مخصص لمستخدم واحد (بريده الإلكتروني). مناسب للتفضيلات والملاحظات والسياق لكل مستخدم.
- **مشتركة / مؤسسة** — مرئية لجميع المستخدمين في التطبيق أو المؤسسة. مناسب لتعليمات التطبيق/الفريق، وskills، والتكوين المشترك.
- **مساحة العمل** — الإعدادات الافتراضية العامة الموروثة المُدارة من Dispatch Resources. جيد لحقائق الشركة، وتحديد المواقع، وإرشادات العلامة التجارية، وحواجز الحماية العالمية، وskills على مستوى مساحة العمل، وخوادم MCP المشتركة. تقرأ التطبيقات هذه في وقت التشغيل؛ ولا يتم نسخها في كل تطبيق.
تعرض علامة تبويب الموارد داخل التطبيق النطاقات الثلاثة جميعها. الموارد الشخصية والمشتركة/المؤسسة قابلة للتحرير هناك. تكون موارد نطاق مساحة العمل للقراءة فقط في لوحات التطبيق ويتم تحريرها مركزيًا من Dispatch، بحيث يرى كل تطبيق نفس الملفات الأساسية بدون خطوة مزامنة.
المسارات الأساسية التي تتحكم في كيفية استخدام الوكيل لكل مورد:
| مورد وقت التشغيل | المسار | كيفية استخدام الوكلاء لها |
| ----------------------------- | --------------------------------------- | -------------------------------------------------- |
| تعليمات الدرابزين | `AGENTS.md` أو `instructions/<slug>.md` | تم تحميله في كل دورة في كل تطبيق يستقبله |
| skills العالمية | `skills/<slug>/SKILL.md` | مُدرج كمساحة عمل skills ويمكن قراءته عند الطلب |
| موارد العلامة التجارية/الشركة | `context/<slug>.md` | تم فهرسة كل منعطف، اقرأ عندما يكون ذلك مناسبًا |
| ملفات تعريف الوكيل المخصصة | `agents/<slug>.md` | متاح كملفات تعريف وكيل محلي قابلة لإعادة الاستخدام |
| خوادم HTTP MCP المشتركة | `mcp-servers/<slug>.json` | تم التحميل في سجل أداة MCP للتطبيقات الممنوحة |
تنطبق هذه المسارات عبر النطاقات الثلاثة كلها - مساحة العمل، والمؤسسة/التطبيق، والشخصية. يفوز النطاق الأحدث عند وجود نفس المسار على مستويات متعددة.
## خذ الموارد معك {#resource-pack}
صدّر حزمة JSON ذات مجموع تحقق لموارد النص التي يمكنك قراءتها أصلًا (`export-resource-pack`)، واستوردها إلى تطبيق أو مستخدم آخر (`import-resource-pack`). عناصر **Export pack** / **Import pack** في تبويب الموارد تستدعي نفس الإجراءات.
- التصدير يشمل النص فقط. تُحذف التحميلات الثنائية. تُحجب السلاسل التي تشبه مفاتيح API وحقول الرموز `env` / `headers` في MCP؛ أعد توصيل MCP بعد الاستيراد.
- الاستيراد يكتب افتراضيًا إلى النطاق **الشخصي** ويتخطى التعارض. استيراد المؤسسة يتطلب نفس ACL الكتابة للمسؤول كما في تحرير ملفات المؤسسة. استيراد مساحة العمل غير متاح.
- الحزمة التي تتجاوز 200 ملف نصي أو 1 ميغابايت تفشل بـ `too_large` بدل الاقتصاص. عدم تطابق المجموع يفشل بشكل مغلق.
<Diagram id="doc-block-olr0y7" title={"ثلاثة نطاقات، ملف واحد فعال"} summary={"يحل وقت التشغيل نفس المسار عبر مساحة العمل والتطبيق والنطاقات الشخصية عند القراءة - يفوز النطاق الأكثر تحديدًا."}>
```html
<div class="ws-stack">
<div class="diagram-card">
<span class="diagram-pill">Workspace</span
><small class="diagram-muted"
>إعدادات افتراضية على مستوى الشركة من Dispatch</small
><code>context/brand.md</code>
</div>
<div class="diagram-arrow diagram-muted" aria-hidden="true">↓</div>
<div class="diagram-card">
<span class="diagram-pill">المؤسسة / التطبيق</span
><small class="diagram-muted">team override for one app</small
><code>context/brand.md</code>
</div>
<div class="diagram-arrow diagram-muted" aria-hidden="true">↓</div>
<div class="diagram-card">
<span class="diagram-pill accent">Personal</span
><small class="diagram-muted">per-user override — wins</small
><code>context/brand.md</code>
</div>
<div class="diagram-arrow diagram-accent" aria-hidden="true">→</div>
<div class="diagram-box ok">Effective <code>context/brand.md</code></div>
</div>
```
```css
.ws-stack {
display: flex;
flex-direction: column;
align-items: flex-start;
gap: 8px;
}
.ws-stack .diagram-card {
display: flex;
flex-direction: column;
gap: 4px;
padding: 12px 16px;
min-width: 280px;
}
.ws-stack .diagram-arrow {
font-size: 20px;
align-self: center;
}
.ws-stack code {
font-size: 0.85em;
}
.ws-stack .diagram-box {
align-self: center;
margin-top: 4px;
}
```
</Diagram>
## الخطوات الأولى: جولة تفصيلية مدتها دقيقة واحدة {#getting-started}
قم بتغيير سلوك الوكيل خلال 60 ثانية.
1. افتح علامة التبويب **الموارد** → **مشتركة** → `AGENTS.md` (قم بإنشائها باستخدام `+` → **ملف** إذا كان مفقودًا).
2. أضف قاعدة واحدة، على سبيل المثال:
```Markdown
## النغمة
كن موجزًا. ابدأ بالإجابة.
```
3. احفظ، وانتقل إلى **الدردشة**، واسأل عن أي شيء — يتبع الوكيل القاعدة الجديدة على الفور.
<Callout id="doc-block-1lakd89" tone="info">
لا إعادة تشغيل ولا إعادة نشر. تتم قراءة `AGENTS.md` في بداية كل دورة، لذا فإن التعديل الذي تحفظه الآن يغير سلوك الوكيل في الرسالة التالية.
</Callout>
**الخطوات التالية، عندما تريدها:**
- **Skills** (`+` → **Skill**) — ملفات إرشادية مركزة يتم استدعاؤها في الدردشة مع `/skill-name`.
- **الوكلاء** (`+` → **الوكيل**) — شخصيات الوكيل الفرعي القابلة لإعادة الاستخدام التي تم استدعاؤها باستخدام `@agent-name`.
- **المهام المجدولة** (`+` → **المهمة المجدولة**) — المطالبات التي يتم تشغيلها على cron. راجع [Recurring Jobs](/docs/recurring-jobs) لمعرفة الجداول الزمنية والمشغلات.
- **الذاكرة** — تحافظ `LEARNINGS.md` المشتركة و`memory/MEMORY.md` الشخصية على السياق الدائم المتاح عبر المحادثات.
## الموارد العالمية والمسارات الأساسية {#global-resources}
تتم إدارة موارد نطاق مساحة العمل من صفحة **الموارد** الخاصة بـ Dispatch ويتم توريثها بواسطة التطبيقات في وقت التشغيل - لا توجد خطوة نسخ أو مزامنة. يدعم Dispatch نطاقين للمنح:
- **جميع التطبيقات** — الموارد العامة التي يرثها كل تطبيق في مساحة العمل. يجب أن تكون معظم سياقات الشركات والعلامات التجارية والشخصيات وتحديد المواقع والرسائل وسياق الحماية **جميع التطبيقات**.
- **التطبيقات المحددة** — الموارد الممنوحة لتطبيقات محددة لسياق أو أدوات خاصة بالتطبيق. استخدم هذه الأشياء باعتدال.
يحدد المسار كيفية استخدام الوكيل لمورد ما (راجع الجدول في [Overview](#overview) أعلاه). هذا هو المكان المناسب للأشخاص الأساسيين، أو تحديد المواقع، أو المراسلة، أو حقائق الشركة، أو إرشادات العلامة التجارية، أو سياسات الدعم، أو أدوات skills المشتركة، أو أدوات HTTP MCP المشتركة التي يجب أن تستفيد منها العديد من التطبيقات.
حزمة بداية مفيدة لمساحة عمل جديدة:
```text
context/company.md # ما تفعله الشركة ICP المنتجات والروابط
context/brand.md # الصوت، الهوية البصرية، التهجئة، الاستخدام المحظور
context/messaging.md # تحديد المواقع، دعائم القيمة، نقاط الإثبات، الاعتراضات
instructions/guardrails.md # قواعد الامتثال والتصعيد والموافقة
skills/company-voice/SKILL.md # on-demand guidance for customer-facing writing
agents/<slug>.md # reusable custom agent profiles
```
احتفظ بملفات `context/` واقعية وسهلة التصفح. ضع القواعد التي يجب أن تنطبق على كل منعطف في `instructions/guardrails.md`. استخدم `skills/company-voice/SKILL.md` عندما يتعين على الوكيل تحويل أو مراجعة النسخة بصوت الشركة عمدًا.
لتجاوز الإعداد الافتراضي العام لتطبيق أو فريق واحد، قم بإنشاء مورد مشترك/مؤسسة في هذا التطبيق بنفس المسار. لتجاوزه لشخص واحد، قم بإنشاء مورد شخصي بنفس المسار. لا تقم بنسخ ملف مساحة العمل إلى كل تطبيق؛ يعمل وقت التشغيل على حل المكدس عند القراءة:
```text
workspace context/brand.md
-> shared/app context/brand.md
-> personal context/brand.md
```
على سبيل المثال:
```text filename="context/brand.md"
# العلامة التجارية
- Voice: direct, warm, concrete
- Use: "workspace", "agent", "team"
- Avoid: unsupported superlatives and vague AI claims
```
## علامة تبويب الموارد {#resources-tab}
تتضمن لوحة الوكيل علامة تبويب **الموارد** بجانب Chat وCLI. يعرض شجرة منظمة في المجلد لجميع الموارد، ومحررًا مضمّنًا لأي ملف نصي (Markdown، JSON، YAML، نص عادي)، وتدفقات الإنشاء المكتوبة في القائمة `+` (الملفات، Skills، الوكلاء، المهام المجدولة). يمكن للمستخدمين تصفح الإعدادات الافتراضية لمساحة العمل الموروثة وإنشاء/تحرير/حذف الموارد الشخصية أو موارد المؤسسة.
عندما تفتح موردًا، يعرض المحرر شريط **السياق الفعال** مع مكدس `workspace default -> organization/app override -> personal override`، حتى تتمكن من رؤية ما تم توريثه وسبب تنشيط التجاوز. يعرض Dispatch نفس النموذج من جانب مستوى التحكم: في صفحة **الموارد** استخدم **فعال في التطبيق**، أو قم بتوسيع **المكدس** في صف الموارد في مربع حوار **السياق** الخاص ببطاقة التطبيق.
عند تمكين سياسة الموافقة على الإرسال، يؤدي إنشاء مورد **جميع التطبيقات** أو تحديثه أو حذفه إلى وضع طلب الموافقة في قائمة الانتظار بدلاً من التقديم على الفور. تعرض مربعات حوار الإنشاء/التحرير/الحذف معاينة للتأثير قبل الحفظ.
انقر على أيقونة `?` في شريط أدوات الموارد للانتقال مرة أخرى إلى هذه المستندات في أي وقت.
## كيفية استخدام الوكيل للموارد {#how-the-agent-uses-resources}
يدير وكيل التطبيق المدمج الموارد باستخدام أداة `resources` الموحدة: استخدم `action: "list"` أو `"read"` أو `"effective"` أو `"write"` أو `"promote"` أو `"delete"`. يمكن لوكلاء CLI/code الخارجيين استخدام أوامر `pnpm action resource-*` المكافئة.
في بداية كل محادثة، يقرأ الوكيل تلقائيًا:
### AGENTS.md والتعليمات {#agents-md}
`AGENTS.md` هو مورد تعليمات يتم تصنيفه افتراضيًا ويتم تحميله في كل دورة من مساحة العمل، والمشتركة/المؤسسة، والنطاقات الشخصية بهذا الترتيب - مساحة العمل للإعدادات الافتراضية على مستوى الشركة، والمشتركة/التطبيق لقواعد الفريق، والشخصية للتفضيلات لكل مستخدم. الملفات الموجودة ضمن `instructions/` هي مستندات حاجز حماية منفصلة تنطبق أيضًا على كل منعطف (قواعد الامتثال، وسياسة التصعيد، وصوت العلامة التجارية) وتتبع نفس الأسبقية. تقوم كل من الدردشة العادية وعمليات التشغيل التي يتم تشغيلها بالتكامل بتحميلها قبل الاستجابة.
```text
AGENTS.md
instructions/customer-support-guardrails.md
instructions/legal-review-policy.md
```
### الموارد المرجعية {#reference-resources}
يقع سياق الشركة القابل لإعادة الاستخدام ضمن `context/` (الشخصيات، وتحديد المواقع، وحقائق المنتج، وإرشادات العلامة التجارية، والملاحظات التنافسية). يرى الوكيل فهرسًا لهذه العناصر ويقرأ الملف ذي الصلة باستخدام أداة `resources` (`action: "read"`) عندما تعتمد المهمة عليها؛ استخدم `action: "effective"` لمعرفة ما إذا كان قد تم تجاوز الإعداد الافتراضي لمساحة العمل لتطبيق أو مستخدم.
### الذاكرة {#memory}
تحتوي موارد الوكيل على سطحي ذاكرة حاليين:
- `LEARNINGS.md` في نطاق **مشترك** للاصطلاحات والتصحيحات على مستوى المشروع والمعرفة الدائمة للفريق.
- `memory/MEMORY.md` في نطاق **شخصي** للذاكرة المنظمة حول المستخدم الحالي.
يقوم نظام الموارد أيضًا بزراعة `LEARNINGS.md` شخصي للتوافق مع مساحات العمل الأقدم، ولكن مسار التحميل المسبق للدردشة مشترك `LEARNINGS.md` بالإضافة إلى `memory/MEMORY.md` الشخصي.
**ما يتم حفظه.** عند تصحيح الوكيل ("استخدم دائمًا X بدلاً من Y")، أو مشاركة تفضيل ("أفضل الإجابات المختصرة")، أو الكشف عن السياق ("يطلق فريقي على هذا اسم "طبقة الإرسال")، يلتقط الوكيل هذا التعلم حتى لا يكرر الخطأ أو يعيد السؤال. تتم عمليات التعلم على مستوى المشروع في `LEARNINGS.md` المشتركة؛ الذاكرة الخاصة بالمستخدم تندرج تحت `memory/`. توضح مهارة `capture-learnings` متى وكيف.
**المكان المناسب.**
| السطح | النطاق | تأليف | اقرأ متى |
| ------------------ | -------------------- | ----------------------------------- | ----------------------------------------------- |
| `AGENTS.md` | مشتركة | البشر / الوكيل عند الطلب | كل منعطف |
| `LEARNINGS.md` | مشتركة | البشر / الوكيل عند الطلب | كل دور (نسخة مشتركة فقط) |
| `memory/MEMORY.md` | شخصي | الوكيل / البشر | كل منعطف |
| `instructions/…` | مشتركة | البشر / الوكيل عند الطلب | كل منعطف |
| `skills/…` | مشتركة | البشر / الوكيل عند الطلب | حسب الطلب (أمر `/slash`) |
| `context/…` | مشتركة | البشر / الوكيل عند الطلب | يتم فهرسة كل منعطف، اقرأ عندما يكون ذلك مناسبًا |
| `mcp-servers/…` | مساحة العمل / مشتركة | البشر عبر Dispatch أو موارد التطبيق | تحديث تكوين MCP |
يمكن للمستخدمين تحرير ملفات الذاكرة هذه مباشرة في علامة التبويب "الموارد" - فهي موارد عادية. احذف السطور التي أخطأ فيها الوكيل، أو احتفظ بالتفضيلات الشخصية في `memory/MEMORY.md`، أو قم بترقية القواعد على مستوى الفريق إلى `AGENTS.md`.
كل سطح من هذه الأسطح — `AGENTS.md`، skills، الذاكرة، الوكلاء المخصصون، خوادم MCP — هو نفس شكل المورد الأساسي: `path` + `scope` + `content`، ويتم التعامل معه وحله بنفس الطريقة.
<DataModel
id="doc-block-1wpj00w"
title={"نموذج موارد الوكيل"}
summary={
"يدعم شكل مورد واحد كل ملف من ملفات موارد الوكيل. يقوم وقت التشغيل بمفاتيحه حسب المسار والنطاق ويحل القيمة الفعالة عند القراءة."
}
entities={[
{
id: "resource",
name: "agent resource",
note: "ملف واحد ضمن موارد الوكيل الخاصة بالمستخدم - التعليمات، أو المهارة، أو الذاكرة، أو الوكيل، أو تكوين MCP، أو المهمة.",
fields: [
{
name: "path",
type: "string",
note: "Canonical path, e.g. AGENTS.md, skills/<slug>/SKILL.md",
},
{
name: "scope",
type: "workspace | shared | personal",
note: "في أي مستوى يعيش هذا الصف",
},
{
name: "owner",
type: "string",
nullable: true,
note: "u:<email> for personal scope",
},
{
name: "content",
type: "text",
note: "Markdown / JSON / YAML الجسم",
},
],
},
]}
/>
## Skills {#skills}
Skills هي ملفات موارد Markdown ضمن مسار `skills/` (يفضل `skills/<name>/SKILL.md`) والتي تمنح الوكيل معرفة المجال عند الطلب، والتي يتم استدعاؤها في الدردشة مع `/skill-name`. قم بإضافتها من علامة التبويب "الموارد"، أو في وضع "الرمز"، من `.agents/skills/`.
اطلع على [Skills Guide](/docs/skills-guide) — المصدر الوحيد لتنسيق المهارات ونطاقها واكتشافها وتأليفها.
## الوكلاء المخصصون {#custom-agents}
الوكلاء المخصصون عبارة عن ملفات تعريف وكيل فرعي محلية قابلة لإعادة الاستخدام ومخزنة كموارد Markdown ضمن `agents/*.md`. هذا هو الموقع الأساسي لتنسيق الوكيل المخصص.
استخدمها عندما تريد مندوبًا مركّزًا باسمه الخاص، ووصفه، وتفضيلاته النموذجية، ومجموعة التعليمات الخاصة به. على عكس skills، لا يعد الوكلاء المخصصون توجيهًا سلبيًا — فهم شخصيات تشغيلية يمكن للوكيل الرئيسي استدعاؤها من خلال إشارات `@` أو عن طريق تحديدهم أثناء نشر الوكيل الفرعي.
### تنسيق الوكيل {#agent-format}
يستخدم الوكلاء المخصصون المادة الأمامية YAML بالإضافة إلى تعليمات Markdown:
<AnnotatedCode
id="doc-block-hipquw"
title={"ملف تعريف وكيل مخصص"}
filename="agents/design.md"
language="markdown"
code={
"---\nname: Design\ndescription: >-\n Reviews layouts, interaction patterns, and product UX decisions.\nmodel: inherit\ntools: inherit\ndelegate-default: false\n---\n\n# الدور\n\nأنت وكيل تصميم مركّز.\n\n## المسؤوليات\n\n- مراجعة التخطيطات وتدفقات التفاعل\n- اقتراح اتجاه مرئي أقوى\n- كن موجزًا وصاحب رأي"
}
annotations={[
{
lines: "2",
label: "@mention handle",
note: "`name` هو ما يظهر في القائمة المنسدلة `@` وما يفوضه الوكيل الرئيسي.",
},
{
lines: "3-4",
label: "متى يتم التفويض",
note: "`description` هو ما يقرأه المنسق ليقرر أن ملف التعريف هذا يناسب المهمة.",
},
{
lines: "5",
label: "نموذج",
note: "`inherit` يعيد استخدام نموذج الوكيل الرئيسي. يتم التجاوز فقط عندما يحتاج ملف التعريف بوضوح إلى ملف تعريف مختلف.",
},
{
lines: "6",
note: "`tools: inherit` في الوقت الحالي — الحقل محجوز لسياسات الأدوات المستقبلية لكل وكيل.",
},
]}
/>
الاصطلاحات الموصى بها:
- قم بتخزين الوكلاء المخصصين في `agents/<slug>.md`
- استخدم `model: inherit` ما لم يكن الملف الشخصي يحتاج بوضوح إلى نموذج مختلف
- احتفظ بـ `tools: inherit` في الوقت الحالي؛ الحقل محجوز لسياسات الأداة المستقبلية
### الوكلاء البعيدون مقابل الوكلاء المخصصون {#remote-vs-custom-agents}
تتضمن موارد الوكيل نوعين من الوكلاء:
- **الوكلاء المخصصون** — ملفات التعريف المحلية في `agents/*.md`، والتي يتم تنفيذها داخل التطبيق/وقت التشغيل الحالي
- **الوكلاء المتصلون** — نظيرات A2A البعيدة الموصوفة بواسطة البيانات في `remote-agents/*.json` (لا يزال يتم التعرف على بيانات `agents/*.json` القديمة)
استخدم الوكلاء المخصصين للتفويض داخل تطبيق واحد. استخدم الوكلاء المتصلين عندما تحتاج إلى الاتصال بتطبيق آخر عبر A2A.
## الإشارة بـ @ وأوامر / {#at-tagging}
اكتب `@` في إدخال الدردشة للإشارة إلى وكيل أو ملف أو مورد، أو `/` لاستدعاء مهارة — يفتح كلاهما قائمة منسدلة عند المؤشر ويضيف شريحة مضمنة عند تحديد عنصر. راجع [إشارات الوكيل](/docs/agent-mentions) للآليات الكاملة (التوجيه و`MentionProvider` واختيار الوكيل الفرعي)، و[دليل المهارات](/docs/skills-guide) لمعرفة كيفية تأليف المهارات واكتشافها.
## وضع الكود مقابل وضع التطبيق {#dev-vs-prod}
يعمل نظام الموارد بشكل مماثل في كلا الوضعين. ما يختلف هو المصادر الإضافية المتاحة لوضع علامات `@` وأوامر `/`:
| الميزة | وضع الكود | وضع التطبيق |
| ---------------------- | ----------------------------------------------------------------------------------- | -------------------------------------------------- |
| @ وضع العلامات | ملفات قاعدة التعليمات البرمجية + موارد الوكيل + الوكلاء المخصصون + الوكلاء المتصلون | موارد الوكيل + الوكلاء المخصصون + الوكلاء المتصلون |
| / أوامر الشرطة المائلة | .agents/skills/ + المورد skills | المورد skills فقط |
| الوصول إلى ملف الوكيل | نظام الملفات + الموارد | الموارد فقط |
| علامة تبويب الموارد | الوصول الكامل | الوصول الكامل |
| AGENTS.md / الذاكرة | متاح | متاح |
## اتصالات مساحة العمل {#workspace-connections}
تسمح اتصالات مساحة العمل للتطبيقات بمشاركة حساب الموفر نفسه (Slack، GitHub، HubSpot، وما إلى ذلك) دون تكرار بيانات الاعتماد. يسجل الاتصال هوية موفر الخدمة وتسميات الحساب والحالة والنطاقات ومنح التطبيقات ومراجع بيانات الاعتماد في PostgreSQL/PGlite. تبقى الأسرار في مخزن بيانات الاعتماد؛ تشير الاتصالات فقط إلى أسماء مفاتيح الاعتماد مثل `SLACK_BOT_TOKEN`.
راجع [Workspace Connections](/docs/workspace-connections) للتعرف على أمثلة التشغيل السريع والاتصال/المنح/بيانات الاعتماد API، وأمثلة Slack وHubSpot وGitHub الملموسة.
## المورد API {#resource-api}
يمكن إدارة الموارد من كود الخادم، actions، أو REST API.
### الخادم API {#server-api}
تم تثبيت نقاط النهاية REST تلقائيًا:
| الطريقة | نقطة النهاية | الوصف |
| -------- | --------------------------------------------- | ------------------------------ |
| `GET` | `/_agent-native/resources?scope=all` | قائمة الموارد |
| `GET` | `/_agent-native/resources?scope=workspace` | سرد موارد مساحة العمل الموروثة |
| `GET` | `/_agent-native/resources/tree?scope=all` | الحصول على شجرة المجلدات |
| `GET` | `/_agent-native/resources/effective?path=...` | إظهار مكدس الميراث الفعال |
| `POST` | `/_agent-native/resources` | إنشاء مورد |
| `GET` | `/_agent-native/resources/:id` | احصل على الموارد مع المحتوى |
| `PUT` | `/_agent-native/resources/:id` | تحديث أحد الموارد |
| `DELETE` | `/_agent-native/resources/:id` | حذف مورد |
| `POST` | `/_agent-native/resources/upload` | تحميل ملف كمورد |
يأتي المورد المقروء عبر `GET /_agent-native/resources/:id` مع `revision`. أعِده بوصفه `expectedRevision` مع `content` الجديد في طلب `PUT`؛ وإذا حفظ شخص آخر محتوى مختلفًا بعد قراءتك، فلن يُكتب أي شيء: تكون الاستجابة 409 مع `errorCode: "save_conflict"`، والمحتوى الحالي في `details.current.content`، ومراجعته في `details.currentRevision`. أما طلب `PUT` بدون `expectedRevision` فما زال يكتب فوق ما هو محفوظ. لا يمكن للحفظ المتحقَّق منه أن يعيد تسمية المورد في الوقت نفسه: أرسل `path` الجديد أولًا في طلب `PUT` مستقل. يتولى `<ResourceEditor saveContent>` ذلك نيابةً عنك: إذا حفظ شخص آخر محتوى مختلفًا أثناء التعديل، فإنه يسأل أي نسخة تريد الاحتفاظ بها، ثم يعرض استعادة النسخة الأخرى.
### الإجراء API {#script-api}
يستخدم الوكيل هذه actions المضمنة. يمكنك أيضًا الاتصال بهم من actions الخاص بك:
```bash
# قم بإدراج كافة الموارد
pnpm action resource-list --scope all
# اقرأ أحد الموارد
pnpm action resource-read --path "skills/my-skill/SKILL.md"
# قراءة سياق مساحة العمل الموروثة التي يديرها Dispatch
pnpm action resource-read --scope workspace --path "context/brand.md"
# Show workspace -> organization/app -> personal precedence for a path
pnpm action resource-effective --path "context/brand.md"
# اكتب مصدرًا
pnpm action resource-write --path "notes/meeting.md" --content "# ملاحظات الاجتماع..."
# استبدال مورد فقط إذا لم يحفظه أحد منذ قراءتك
pnpm action resource-write --path "notes/meeting.md" --content "# ملاحظات الاجتماع..." --expected-revision "rev_…"
# حذف مورد
pnpm action resource-delete --path "notes/old.md"
```
تبدأ قراءات الوكيل للموارد بسطر `[revision …, scope …]`، وتقبل أداتا الكتابة لديه تلك المراجعة بوصفها `expectedRevision` (`--expected-revision` في سطر الأوامر). إذا حفظ أحد الملف بعد القراءة، فلن يُكتب أي شيء: تفشل الكتابة مع `errorCode: "save_conflict"` والمراجعة الحالية، فيعيد الوكيل قراءة الملف ويعيد تعديله. أما الكتابة دون مراجعة فما زالت تستبدل ما هو موجود.
## الخطوة التالية {#whats-next}
- [**دليل المهارات**](/docs/skills-guide) — تأليف ملفات المهارات المشار إليها من `skills/` وتحديد نطاقها
- [**إشارات الوكيل**](/docs/agent-mentions) — الآليات الكاملة لإشارات `@` وأوامر `/`
- [**المهام المتكررة**](/docs/recurring-jobs) — جدولة المطالبات المنشأة من المهام المجدولة
- [**حوكمة مساحة العمل**](/docs/workspace-management) — من يراجع تغييرات مساحة العمل ويوافق عليها ويمتلكها
- [**مساحات العمل متعددة التطبيقات**](/docs/multi-app-workspace) — شكل النشر الذي تمتد إليه مساحة عمل واحدة
- [**اتصالات مساحة العمل**](/docs/workspace-connections) — مشاركة بيانات اعتماد المزوّدين بين التطبيقات
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| rea-changelog-updatemorluto/reaPrepare or rewrite REA release changelogs and GitHub release notes from pinned Git history, with verified contributor thanks and Release Please synchronization. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| academy-guideanthropics/skillsStop and check this skill before finishing any reply to a question about how to use Claude or a Claude product — it recommends matching courses, tutorials, and use cases from Claude Academy (academy.claude.com), Anthropic's learning hub. Trigger on: "how do I", "how can I", "getting started with", "what can Claude do", "teach me", "learn to use"; questions about artifacts, projects, skills, plugins, connectors, MCP; requests about rolling Claude out to a team, class, or organization; and any ask for training materials, onboarding content, or learning resources. Use it when the user is learning how to use a feature or product — not when they are mid-task and just want the task done. This skill composes with other skills: after consulting product documentation to answer how a Claude feature works, also check here for a matching course or tutorial — a docs-grounded answer and an Academy recommendation belong together. Only recommend on a strong match; never invent Academy content. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| claude-apianthropics/skillsReference for the Claude API / Anthropic SDK — model ids, pricing, params, streaming, tool use, MCP, agents, caching, token counting, model migration. TRIGGER — read BEFORE opening the target file; don't skip because it "looks like a one-liner" — whenever: the prompt names Claude/Anthropic in any form (Claude, Anthropic, Fable, Opus, Sonnet, Haiku, `anthropic`, `@anthropic-ai`, `claude-*`, `us.anthropic.*`, `[1m]`); the user asks about an LLM (pricing/model choice/limits/caching) — never answer from memory; OR the task is LLM-shaped with provider unstated (agent/MCP/tool-definition/multi-agent/RAG/LLM-judge/computer-use; generate/summarize/extract/classify/rewrite/converse over NL; debugging refusals/cutoffs/streaming/tool-calls/tokens). SKIP only when another provider is being worked on (overrides all triggers): OpenAI/GPT/Gemini/Llama/Mistral/Cohere/Ollama named in the query; OR `grep -rE 'openai|langchain_openai|google.generativeai|genai|mistralai|cohere|ollama'` over the project hits (run this grep FIRST if no provider named — don't Read the file). | Stars: 198k | Updated | Claude CodeCodex | Unverified | Install |
| doc-coauthoringanthropics/skillsGuide users through a structured workflow for co-authoring documentation. Use when user wants to write documentation, proposals, technical specs, decision docs, or similar structured content. This workflow helps users efficiently transfer context, refine content through iteration, and verify the doc works for readers. Trigger when user mentions writing docs, creating proposals, drafting specs, or similar documentation tasks. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |