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/template-brain.mdx
View on GitHub---
title: "الدماغ"
description: "دردشة نظيفة للشركة مدعومة بالذاكرة المؤسسية المستشهد بها، واستيعاب المصدر القابل للمراجعة، وعمليات تكامل مساحة العمل القابلة لإعادة الاستخدام."
---
# الدماغ
Brain عبارة عن دردشة شركة نظيفة مدعومة بالذاكرة المؤسسية المستشهد بها. يسأل الناس
أسئلة باللغة الإنجليزية البسيطة؛ إجابات الدماغ من معرفة الشركة المعتمدة مع
روابط تعود إلى سلسلة Slack أو الاجتماع أو النص أو المشكلة أو التقاط خطاف الويب
يدعم الإجابة.
يستوعب Brain قنوات Slack المعتمدة وتسجيلات المقاطع ومساحة فريق Granola
ملاحظات، وقضايا GitHub/PRs، وحمولات النص العام/خطاف الويب. يقوم بتخزين الخام
يلتقط ويقطّر الحقائق/القرارات/العمليات الدائمة، ويوجه مسارات حساسة أو
ذكريات منخفضة الثقة من خلال المراجعة قبل أن تصبح معرفة بالشركة.
يظل سطح المنتج بسيطًا عن قصد: **اسأل** هي الدردشة الأساسية
الخبرة، في حين أن **المصادر** و**المراجعة** و**المعرفة** هي المشرف/الدعم
أسطح لتوصيل البيانات، والموافقة على المقترحات، وفحص الذاكرة المستشهد بها.
<Diagram id="doc-block-139f5ge" title={"من المصدر إلى الإجابة المذكورة"} summary={"يستوعب الدماغ المصادر المعتمدة في لقطات أولية، ويقطر الذاكرة الدائمة، ويمررها عبر المراجعة، وعندها فقط يجيب على الاستشهادات."}>
```html
<div class="diagram-flow">
<div class="diagram-card">
<span class="diagram-pill">Sources</span
><small class="diagram-muted"
>Slack · Granola · GitHub · Clips · webhooks</small
>
</div>
<div class="diagram-arrow diagram-muted" aria-hidden="true">→</div>
<div class="diagram-box" data-rough>
اللقطات الخام<br /><small class="diagram-muted">مزال التكرار، منقح</small>
</div>
<div class="diagram-arrow diagram-muted" aria-hidden="true">→</div>
<div class="diagram-box" data-rough>
Distill<br /><small class="diagram-muted">حقائق · قرارات · عمليات</small>
</div>
<div class="diagram-arrow diagram-muted" aria-hidden="true">→</div>
<div class="diagram-card">
<span class="diagram-pill warn">Review</span
><small class="diagram-muted">sensitive / low-confidence queue</small>
</div>
<div class="diagram-arrow diagram-muted" aria-hidden="true">→</div>
<div class="diagram-box" data-rough>
<span class="diagram-pill ok">Knowledge</span
><small class="diagram-muted">معتمد، ذري</small>
</div>
<div class="diagram-arrow diagram-muted" aria-hidden="true">→</div>
<div class="diagram-panel center">
<span class="diagram-pill accent">Ask</span
><small class="diagram-muted">cited answer</small>
</div>
</div>
```
```css
.diagram-flow {
display: flex;
align-items: center;
gap: 10px;
flex-wrap: wrap;
}
.diagram-flow .diagram-card {
display: flex;
flex-direction: column;
gap: 4px;
padding: 10px 12px;
}
.diagram-flow .diagram-box {
display: flex;
flex-direction: column;
gap: 4px;
}
.diagram-flow .diagram-arrow {
font-size: 20px;
line-height: 1;
}
.diagram-flow .center {
display: flex;
flex-direction: column;
align-items: center;
gap: 4px;
}
```
</Diagram>
<WireframeBlock id="doc-block-1uh7c1t">
<Screen
surface="desktop"
html={
"<div style='display:flex;flex-direction:column;gap:14px;padding:18px;min-height:520px;box-sizing:border-box'><div style='display:flex;align-items:center;gap:10px'><h1 style='margin:0'>اسأل ذاكرة الشركة</h1><span class='wf-pill accent'>42 approved memories</span><span class='wf-pill'>3 sources</span><div style='flex:1'></div><button>Sources</button><button>Review</button></div><div class='wf-card' style='display:flex;align-items:center;gap:10px'><span data-icon='search' aria-label='بحث'></span><strong style='flex:1'>لماذا اخترنا التسعير حسب الاستخدام؟</strong><button class='primary'>Ask</button></div><div class='wf-card' style='display:flex;flex-direction:column;gap:10px'><strong>Answer</strong><p style='margin:0'>اختار الفريق التسعير حسب الاستخدام بعد أن أظهرت التجارب أن عدد المقاعد يقلل من قيمة الأتمتة.</p><div style='display:flex;gap:8px;flex-wrap:wrap'><span class='wf-pill accent'>RFC للتسعير</span><span class='wf-pill'>استعادة الإطلاق</span><span class='wf-pill'>ملاحظات المبيعات</span></div></div><div class='wf-card' style='flex:1;display:flex;flex-direction:column;gap:8px'><strong>الخط الزمني للمصادر</strong><div class='wf-box'>3 مايو · تم تسجيل القرار</div><div class='wf-box'>8 مايو · تمت إضافة دليل العميل</div><div class='wf-box'>12 مايو · تمت الموافقة على الملاحظة القانونية</div></div></div>"
}
/>
</WireframeBlock>
عند فتح التطبيق، يكون **السؤال** في المقدمة والوسط — حيث تتم مراجعة الدردشة النظيفة
ذاكرة الشركة. **المصادر**، و**المراجعة**، و**المعرفة** تقع بجانبها كـ
أسطح الإدارة لربط البيانات والموافقة على المقترحات وفحص الاستشهادات
الإدخالات.
## متى يتم اختياره
استخدم Brain عندما يريد فريقك من الوكلاء الإجابة على أسئلة مثل "لماذا قمنا بذلك
هذا القرار بشأن المنتج؟"، أو "كيف تعمل هذه الميزة قيد التطوير؟"، أو "ماذا
هل تغيرت في هذه العملية؟" مع روابط العودة إلى المحادثة المصدر، والاجتماع،
أو المشكلة.
Brain وDispatch متكاملان ولكنهما يؤديان وظائف مختلفة:
- **يمتلك الدماغ ذاكرة الشركة.** فهو يستوعب المصادر، ويراجع اللقطات الأولية،
يستخلص الحقائق/القرارات/العمليات الدائمة، والإجابات من الأدلة المذكورة، و
كشف المعرفة المعتمدة للوكلاء.
- **تمتلك Dispatch مستوى التحكم في مساحة العمل.** وتقوم بمركزية المراسلة،
الأسرار، والوظائف المتكررة، والموافقات، وتنسيق A2A، والتوزيع
والموافقة على الموارد على مستوى مساحة العمل.
في مساحة عمل متعددة التطبيقات، يمكن لـ Dispatch توجيه سؤال إلى Brain عبر A2A و
منح بيانات اعتماد موفر خدمة Brain المشترك. يظل الدماغ هو المتخصص في
تمت الموافقة على استيعاب المصدر ومراجعته واسترجاعه والاستشهاد بإجابات الشركة.
يكشف Brain عن إمكانية الاسترجاع للقراءة فقط والمدعومة بالاقتباسات كقدرة عامة على A2A
حتى تتمكن تطبيقات Dispatch والتطبيقات الشقيقة من طرح أسئلة تتعلق بذاكرة الشركة - وكيل A2A
البطاقة هي بيانات تعريف عامة للاكتشاف، بينما لا يزال استرجاعها يحدث داخل Brain's
سطح عمل مصادق عليه.
## ما يمكنك فعله به
- **طرح الأسئلة المذكورة.** طرح الأسئلة هو السطح الرئيسي للمنتج: محادثة نظيفة
ذاكرة الشركة التي تمت مراجعتها، مع صحة المصدر وعدد المراجعات والمقترحات
تظل الأسئلة ثانوية. ترتبط كل إجابة بسلسلة رسائل Slack،
الاجتماع أو المشكلة أو الالتقاط الذي يدعمه.
- **توصيل المصادر المعتمدة.** التهيئة اليدوية، وخطاف الويب العام، وClips، وSlack،
مصادر الجرانولا وGitHub. تتم مشاركة المصادر مع المؤسسة افتراضيًا وبالتالي تكون الشركة
الذاكرة مفيدة لمساحة العمل بأكملها.
- **المراجعة قبل النشر.** تحصل الذكريات المقترحة على مسار مراجعة من الدرجة الأولى
حيث يقوم المراجعون بتحرير الصياغة، وفحص روابط الأدلة/المصادر، والموافقة عليها أو
رفض. يمكن نشر الإدخالات عالية الثقة وغير الحساسة على الفور؛
يتم وضع الإدخالات على مستوى الشركة أو الإدخالات الحساسة في قائمة الانتظار كمقترحات.
- **فحص المعرفة المستشهد بها.** يعرض مسار المعرفة الذرة المقطرة
الإدخالات التي تحتوي على النوع والموضوع والكيانات والثقة والاقتباسات الدقيقة للأدلة و
يحل محل الروابط.
- **إعادة استخدام عمليات تكامل مساحة العمل.** يمكن لمصادر الدماغ إعادة استخدام مساحة العمل المشتركة
منح الاتصال بدلاً من إعادة إدخال الرموز المميزة للموفر. صفحة المصادر
يُظهر سجلات مصدر الدماغ بجانب منح الاتصال القابلة لإعادة الاستخدام والموفر
الاستعداد.
- **عكس الذاكرة المعتمدة كسياق محيط.** يمكن للإدخالات المعتمدة الأساسية
النسخ المطابق لموارد مساحة العمل ضمن `context/company-brain/...` وغير ذلك
يمكن للتطبيقات استخدامها كسياق. يقوم كلا التدفقين بمعاينة Markdown بالضبط قبل
تم كتابة المورد أو إزالته.
## البدء
عرض توضيحي مباشر: [brain.agent-native.com](https://brain.agent-native.com).
1. **جرّب العرض التوضيحي.** افتح اسأل واختر **بدء العرض التوضيحي**. بذور المخ صغيرة
مجموعة قرارات المنتج، وإجراء عمليات التحقق من الثقة، وطرح سؤال مقتبس لذلك
يمكنك رؤية الإجابات والاستشهادات والمراجعة والسلوك الذي لم يتم العثور عليه قبل الإضافة
بيانات الشركة الحقيقية.
2. **أضف مصدرًا واحدًا.** ابدأ بقناة Slack واحدة، Granola Team-space
خلاصة، أو مستودع GitHub، أو تصدير Clips، أو خطاف ويب عام للنص. احتفظ
النطاق صغير حتى تبدو جودة الاستشهادات والمراجعة صحيحة.
3. **المراجعة قبل النشر.** استخدم المراجعة لفحص الأدلة وتحرير الصياغة
والموافقة على ذاكرة الشركة الدائمة فقط.
4. **اسأل من المصدر.** استخدم "طرح" للأسئلة التي يجب أن ترتكز على
المعرفة المعتمدة، وليس سجلات الدردشة الأولية.
بالنسبة للعرض التوضيحي العام، توضح المجموعة المصنفة استدعاء قرار المنتج،
روابط الاقتباس، السلوك البديل، بوابة المراجعة، التنقيح، المحتوى الشخصي
الاستبعاد والسلوك الصادق غير الموجود دون الاتصال بمساحة عمل حقيقية.
### مطالبات مفيدة
- "ما الذي قررناه بشأن التسعير السنوي، وأين تمت مناقشة ذلك؟"
- "ابحث عن أحدث تغيير في عملية الإعداد واذكر المصدر."
- "تلخيص ما تعنيه مناقشة GitHub لخطة الإطلاق."
- "راجع مقترحات الذاكرة المعلقة وقم بوضع علامة على أي شيء غامض جدًا بحيث لا يمكن نشره."
- "ما هي المصادر القديمة أو التي فشلت مزامنتها؟"
## للمطورين
باقي هذا المستند مخصص لأي شخص يقوم بتعديل قالب Brain أو توسيعه.
### بداية سريعة
```bash
npx --yes @agent-native/core@latest create my-brain --standalone --template brain
cd my-brain
pnpm install
pnpm dev
```
افتح التطبيق واختر **بدء العرض التوضيحي** لرؤية الذاكرة المستشهد بها دون الاتصال بمساحة عمل حقيقية.
### نموذج البيانات
يستخدم Brain عمدًا البحث النصي SQL وتوسيع الاستعلام الوكيل — هناك
لا توجد متطلبات لقاعدة بيانات متجهة، لذا يظل القالب قابلاً للنقل عبر PGlite،
Postgres، وNeon، وhosted PostgreSQL، والمضيفون المشابهون. تعكس حالة التطبيق
المسار الحالي والمرشحات والمعرفات المحددة حتى يعرف الوكيل دائمًا المسار الحالي
التنقل والاختيار.
يعيش مخطط الدماغ في `templates/brain/server/db/schema.ts`. تسعة جداول:
| الجدول | ما يحمله |
| ------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `brain_sources` | تكوين الموصل - الموفر، القنوات/المستودعات المدرجة في القائمة المسموح بها، مؤشرات المزامنة، وضعية المراجعة، `ingest_token_hash`، `status`، `last_synced_at` |
| `brain_source_shares` | منح المشاركة لكل مصدر (المشاهد/المحرر/المسؤول) |
| `brain_raw_captures` | النصوص وتصدير القنوات والملاحظات واستيراد خطاف الويب باستخدام مفتاح إزالة التكرار `external_id` و`content_hash` والنوع وحالة التقطير |
| `brain_knowledge` | المدخلات الذرية المقطرة - النوع (قرار / حقيقة / عملية / ...)، الموضوع، الكيانات، اقتباسات الأدلة، الثقة، `publish_tier`، الروابط محلها |
| `brain_knowledge_shares` | منح مشاركة المعرفة |
| `brain_proposals` | عناصر المراجعة المعلقة — الإنشاء/التحديث/الأرشفة المقترحة مع الأدلة وملاحظات المراجع |
| `brain_proposal_shares` | منح الأسهم لكل اقتراح |
| `brain_sync_runs` | سجل تدقيق المزامنة - الموفر، الحالة، الإحصائيات JSON، الخطأ، الطوابع الزمنية للبدء/الانتهاء |
| `brain_ingest_queue` | قائمة انتظار التقطير الخلفية - التشغيل، الحالة، الأولوية، عدد مرات إعادة المحاولة، `run_after` |
<DataModel
id="doc-block-xt9gsl"
title={"نموذج بيانات الدماغ"}
summary={
"Connectors produce raw captures; distillation turns captures into reviewable knowledge; proposals gate sensitive entries. Sync runs and the ingest queue track background work."
}
entities={[
{
id: "sources",
name: "brain_sources",
note: "تكوين الموصل",
fields: [
{
name: "id",
type: "id",
pk: true,
},
{
name: "provider",
type: "text",
note: "slack / granola / github / clips / webhook",
},
{
name: "ingest_token_hash",
type: "text",
},
{
name: "status",
type: "text",
},
{
name: "last_synced_at",
type: "timestamp",
nullable: true,
},
],
},
{
id: "source_shares",
name: "brain_source_shares",
note: "viewer / editor / admin",
fields: [
{
name: "source_id",
type: "id",
fk: "brain_sources.id",
},
],
},
{
id: "captures",
name: "brain_raw_captures",
note: "الحمولات الأولية التي تم استيعابها",
fields: [
{
name: "id",
type: "id",
pk: true,
},
{
name: "source_id",
type: "id",
fk: "brain_sources.id",
},
{
name: "external_id",
type: "text",
note: "dedupe key",
},
{
name: "content_hash",
type: "text",
},
{
name: "kind",
type: "text",
},
],
},
{
id: "knowledge",
name: "brain_knowledge",
note: "الإدخالات الذرية المقطرة",
fields: [
{
name: "id",
type: "id",
pk: true,
},
{
name: "kind",
type: "text",
note: "decision / fact / process",
},
{
name: "topic",
type: "text",
},
{
name: "entities",
type: "json",
},
{
name: "confidence",
type: "real",
},
{
name: "publish_tier",
type: "text",
},
],
},
{
id: "knowledge_shares",
name: "brain_knowledge_shares",
fields: [
{
name: "knowledge_id",
type: "id",
fk: "brain_knowledge.id",
},
],
},
{
id: "proposals",
name: "brain_proposals",
note: "عناصر المراجعة المعلقة",
fields: [
{
name: "id",
type: "id",
pk: true,
},
{
name: "op",
type: "text",
note: "create / update / archive",
},
],
},
{
id: "proposal_shares",
name: "brain_proposal_shares",
fields: [
{
name: "proposal_id",
type: "id",
fk: "brain_proposals.id",
},
],
},
{
id: "sync_runs",
name: "brain_sync_runs",
note: "سجل تدقيق المزامنة",
fields: [
{
name: "source_id",
type: "id",
fk: "brain_sources.id",
},
{
name: "status",
type: "text",
},
{
name: "stats",
type: "json",
},
],
},
{
id: "ingest_queue",
name: "brain_ingest_queue",
note: "قائمة انتظار التقطير في الخلفية",
fields: [
{
name: "operation",
type: "text",
},
{
name: "status",
type: "text",
},
{
name: "priority",
type: "int",
},
{
name: "run_after",
type: "timestamp",
nullable: true,
},
],
},
]}
relations={[
{
from: "sources",
to: "captures",
kind: "1-n",
label: "ingested into",
},
{
from: "knowledge",
to: "captures",
kind: "n-n",
label: "evidence",
},
{
from: "knowledge",
to: "proposals",
kind: "1-n",
label: "gated by",
},
{
from: "sources",
to: "sync_runs",
kind: "1-n",
label: "audited by",
},
]}
/>
### مفتاح actions
مجمعة حسب المنطقة (`templates/brain/actions/`):
- **إدارة المصدر** — `create-source`، `update-source`، `delete-source`، `get-source`، `list-sources`، `sync-source`، `sync-due-sources`، `run-slack-pilot`، `test-slack-connection`
- **التقاط العرض** — `import-capture`، `import-transcript`، `list-captures`، `get-capture`، `mark-capture-distilled`، `resanitize-captures`
- **التقطير** — `enqueue-distillation`، `enqueue-captures-distillation`، `claim-distillation`، `retry-distillation`، `list-distillation-queue`
- **المعرفة والمراجعة** — `write-knowledge`، `get-knowledge`، `list-knowledge`، `set-knowledge-canonical`، `preview-canonical-resource`، `list-proposals`، `review-proposal`، `approve-proposal`، `reject-proposal`، `update-proposal`
- **البحث والاسترجاع** — `ask-brain`, `search-knowledge`, `search-everything`
- **الإعدادات** — `get-brain-settings`، `update-brain-settings`، `set-settings`، `get-settings`
- **التقييم والعرض التوضيحي** — `seed-demo-data`، `run-demo-eval`، `run-retrieval-eval`
- **السياق والتنقل** — `view-screen`، `navigate`
- **الموفر APIs** — `provider-api-catalog`، `provider-api-docs`، `provider-api-request`
### توصيل المصادر
يحل Brain بيانات اعتماد الموفر من اتصال مساحة العمل الممنوح أولاً،
ثم من بيانات اعتماد مخزن الدماغ المحلي أو المسجلة المتوافقة مع الإصدارات السابقة.
لا تعود بيانات اعتماد مصدر الدماغ إلى متغيرات البيئة على مستوى النشر.
إذا كان الموفر المشترك موجودًا بالفعل، فامنح الوصول إلى Brain بدلاً من نسخ
نفس السر في بيئة خاصة بالدماغ.
**Slack.** قم بإنشاء مصدر محدد بمعرفات قناة محددة. الموصل
التحقق من كل محادثة تم تكوينها، ورفض الرسائل المباشرة وMPIMs، وتخزين المؤشر
بحيث يتم استئناف كل مزامنة من حيث توقفت آخر مزامنة. تدفق آمن للطرح على
تتيح لك كل بطاقة مصدر Slack **اختبار** بيانات الاعتماد والقائمة المسموح بها بدون
سجل القراءة، قم بتشغيل عينة صغيرة من **الطيار الآمن**، **مراجعة اللقطات**،
والموافقة في **قائمة انتظار المراجعة** قبل أن يصبح أي شيء قابلاً للاستعلام عنه. منح
روبوت فقط النطاقات التي يحتاجها المصدر (التحقق من صحة بيانات الاعتماد، القائمة المسموح بها
التحقق، وسجل القنوات المسموح بها، والروابط الدائمة الدائمة).
**Granola.** قم بإنشاء مصدر بنافذة اقتراع وحجم الصفحة. الجرانولا
تكشف مفاتيح API الخاصة بالمؤسسة عن ملاحظات مساحة الفريق، وليس الملاحظات أو المجلدات الخاصة. الدماغ
يخزن ملخص الملاحظة والنص والحاضرين وبيانات تعريف التقويم والمصدر
URL كلتقطير خام قبل التقطير.
**GitHub.** قم بإنشاء مصدر محدد للمستودعات المعتمدة. الموصل
يستورد الإصدار المحدود وسياق طلب السحب بمصدر ثابت URL يمكنه
يتم تقطيرها مثل Slack أو سياق الاجتماع. هذا هو استيعاب سياق الدماغ، وليس
بديل لإعداد التقارير GitHub بنمط Analytics.
**المقاطع وwebhooks العامة.** يكشف Brain عن خطاف ويب موقع للمقاطع و
استيراد النسخ/الالتقاط العام في `/api/_agent-native/brain/ingest`. إنشاء
مصدر به `sourceKey` لاستلام الرمز المميز لحامله، ثم أرسل
`RawCapturePayload` مع `Authorization: Bearer <ingestToken>`. المصادر العامة
استخدام نفس شكل الحمولة لنصوص المكالمات وأبحاث العملاء المستوردة
الملاحظات، أو أي مصدر آخر يمكن أن ينتج التقاطًا محددًا.
<Endpoint id="doc-block-1ahk6lb" title={"Webhook إدخال موقّع"} summary={"تنشر Clips وعمليات استيراد transcript/capture العامة RawCapturePayload مع رمز حامل لكل مصدر."} method="POST" path="/api/_agent-native/brain/ingest" summary={"قم باستيراد لقطة أولية من Clips أو مصدر عام"} auth={"Bearer <ingestToken> issued per source via its sourceKey"} request={{
"contentType": "application/json",
"example": "RawCapturePayload — bounded transcript / capture body"
}} responses={[
{
"status": "200",
"description": "Capture accepted and queued for distillation"
},
{
"status": "401",
"description": "Missing or invalid ingest bearer token"
}
]}>
</Endpoint>
يمكن لمصادر Slack وGranola وGitHub تفعيل `autoSync` في الخلفية باستخدام
إيقاع الاستطلاع بمجرد إثبات جودة المراجعة.
### الخصوصية والبوابة
تم تصميم الدماغ لذاكرة الشركة، وليس للمراقبة الشخصية:
- تقرأ مزامنة Slack فقط القنوات التي تم تكوينها بشكل صريح وترفض الرسائل المباشرة/MPIMs.
- تقرأ مزامنة Granola ملاحظات مساحة الفريق التي كشفها API من Granola، وليست خاصة
الملاحظات أو المجلدات الخاصة.
- يتم تنقيح اللقطات الأولية من أسطح القائمة/البحث بشكل افتراضي؛ المراجعين
وتتطلب تدفقات التقطير معاينات أو محتوى خام فقط عند الحاجة.
- يمكن أن تتطلب تكوينات المصدر المراجعة قبل أن تصبح المعرفة المقطرة متينة
ذاكرة الشركة.
- تتحكم الإعدادات في طبقة النشر الافتراضية، سواء كانت المعرفة بطبقة الشركة تتطلب
الموافقة ومتطلبات الاقتباس وتنقيح البريد الإلكتروني وخطأ الموصل
الإشعارات.
### تخصيصه
يتبع Brain العقد المكون من أربع مناطق للوكيل الأصلي - قم بتغيير السلوك عن طريق التحرير
منطقة المطابقة، ويمكن للوكيل إجراء هذه التعديلات نيابةً عنك:
- `templates/brain/app/routes/` — سطح UI: اسأل، ابحث، معرفة،
المراجعة والمصادر والإعدادات ومسارات الفريق.
- `templates/brain/actions/` — كل عملية يمكن استدعاءها بواسطة الوكيل (الواردات، المصدر
الإدارة، التقارير التجريبية، التقطير، مراجعة المقترحات، البحث المقتبس،
التنقل/السياق). أضف ملفًا جديدًا باستخدام `defineAction` لكشف
القدرة.
- `templates/brain/.agents/skills/` — إرشادات خاصة بالدماغ للتقطير
واسترجاعها. قم بتحديث أو إضافة مهارة عندما تقوم بتعليم الوكيل سير عمل جديد.
- `templates/brain/AGENTS.md` — دليل الوكيل عالي المستوى. قم بالتحديث عند إضافة التخصص
الميزات.
- `templates/brain/server/db/schema.ts` — نموذج البيانات. عمليات الترحيل الإضافية فقط؛
عكس المسار والمرشحات والمعرفات المحددة في `application_state` للوكيل
السياق.
أجرِ هذه التغييرات في مسار تطوير المستودع. يمكن للوكيل المضمّن المساعدة في
تحرير المصدر فقط عندما يمنحه المضيف عمدًا أدوات كتابة repository/workspace؛
وبخلاف ذلك يعمل من خلال actions والبيانات. انظر
[Key Concepts](/docs/key-concepts#agent-modifies-code).
## ما هي الخطوة التالية
- [**Dispatch**](/docs/dispatch) — مستوى التحكم في مساحة العمل
- [**Dispatch template**](/docs/template-dispatch) — تطبيق التنسيق المدعم
- [**موارد الوكيل**](/docs/agent-resources) — الموارد المشتركة عبر التطبيقات
- [**A2A Protocol**](/docs/a2a-protocol) — التفويض عبر التطبيقات
- [**القوالب**](/docs/cloneable-saas) — نموذج الاستنساخ والتملك، وكل قالب مجال آخر يمكنك البدء منه
- [**بدء الاستخدام**](/docs/getting-started) — أساسيات إطار العمل: الإجراءات وحالة التطبيق والمزامنة المباشرة
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 |