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/automations.mdx
View on GitHub---
title: "الأتمتة"
description: "عمليات التشغيل التلقائي المجدولة والمشغلة بالحدث مع ظروف اللغة الطبيعية"
---
# الأتمتة
**الأتمتة** هي مهمة ينفذها الوكيل عند حلول موعد أو وقوع حدث أو استدعاء webhook: _عندما يحدث X، افعل Y_. **Scheduled** و**Event** و**Webhook** أنواع من المشغلات، وليست منتجات منفصلة.
كان إطار العمل يعرض الأتمتة المجدولة سابقًا باسم **Recurring Jobs**. يبقى هذا الاسم ومسار `jobs/<name>.md` وأداة `manage-jobs` للتوافق. الإرشادات الجديدة تستخدم **Automations** كمفهوم شامل؛ راجع [Recurring Jobs](/docs/recurring-jobs) عند صيانة مهمة مجدولة قديمة أو استخدام نطاق المؤسسة والحقول المتقدمة.
<Diagram id="doc-block-abgxj6" title={"عندما يحدث X، افعل Y"} summary={"يتم إطلاق حدث على الحافلة، ويفتحها شرط اختياري للغة الطبيعية، ويقوم الوكيل بتشغيل جسم التشغيل الآلي مع إمكانية الوصول الكامل للأداة."}>
```html
<div class="auto-flow">
<div class="diagram-card">
<span class="diagram-pill">حدث</span
><small class="diagram-muted"><code>calendar.booking.created</code></small>
</div>
<div class="diagram-arrow diagram-muted" aria-hidden="true">→</div>
<div class="diagram-card">
<span class="diagram-pill">حالة</span
><small class="diagram-muted"
>يتحقق النموذج: “ينتهي البريد الإلكتروني بـ
@builder.io”</small
>
</div>
<div class="diagram-arrow diagram-muted" aria-hidden="true">→</div>
<div class="diagram-card accent">
<span class="diagram-pill accent">وكيل يدير الجسم</span
><small class="diagram-muted"
>الإجراءات · web-request · MCP · sub-agents</small
>
</div>
</div>
```
```css
.auto-flow {
display: flex;
align-items: center;
gap: 12px;
flex-wrap: wrap;
}
.auto-flow .diagram-card {
display: flex;
flex-direction: column;
gap: 4px;
padding: 14px 16px;
min-width: 180px;
}
.auto-flow .diagram-arrow {
font-size: 22px;
}
```
</Diagram>
## أنواع المشغلات {#trigger-types}
| اكتب | يتم تشغيله عند | حقل المفتاح |
| ---------- | --------------------------------------------------- | -------------------------------- |
| `schedule` | يتطابق تعبير cron (مثل المهام المتكررة) | `schedule` (كرون) |
| `event` | يتم إطلاق حدث مطابق في ناقل أحداث إطار العمل | `event` (الاسم) |
| `webhook` | يصل طلب HTTP `POST` إلى عنوان webhook السري للأتمتة | عنوان URL الذي يُعاد عند إنشائها |
يمكن أن تتضمن مشغلات الأحداث وwebhook `condition`: سلسلة باللغة الطبيعية يتحقق منها نموذج مقابل الحمولة قبل الإرسال. إذا لم يتطابق الشرط، يتم تخطي الأتمتة وتسجيل حالة `skipped`. وإذا تعذر تقييم الشرط، لا يتم تشغيل الأتمتة. راجع [Conditions](#conditions).
### مشغلات Webhook {#webhook-triggers}
يؤدي إنشاء أتمتة من نوع webhook إلى إرجاع مسار URL بالصيغة
`/_agent-native/automations/webhook/<token>`. الرمز المميز في المسار هو السر، لذا أعطِ
عنوان URL فقط للخدمة التي تستدعيه. يصبح كل طلب `POST` إلى هذا العنوان حمولة
الأتمتة، بحد أقصى 64 KB. يتم تحليل نص الطلب المرسل بنوع محتوى JSON، ويُمرَّر أي نص طلب آخر
كنص. تردّ نقطة النهاية بالرمز `202` وتشغّل الأتمتة في الخلفية.
أرسل معرّف حدث ثابتًا في ترويسة `X-Webhook-Event-Id` أو `X-Event-Id` أو
`X-GitHub-Delivery`، أو كحقل `id` نصي من المستوى الأعلى في نص طلب JSON. لا يُضاف التسليم
المتكرر بالمعرّف نفسه إلى قائمة الانتظار مرة أخرى، ويتلقى ردًا `200` يشير إلى أنه تسليم مكرر.
يمنع المعرّف التسليمات المكررة فقط. يمكن إعادة محاولة التشغيل الفاشل، وقد تكرر إعادة المحاولة آثارًا
جانبية سبق أن أحدثها التشغيل الفاشل. وبمجرد أن يفشل التسليم نهائيًا، يُحرَّر معرّفه، ويُضاف أي
تسليم لاحق بهذا المعرّف إلى قائمة الانتظار كتسليم جديد.
## إنشاء عمليات التشغيل الآلي {#creating}
### من خلال سؤال الوكيل
> "عندما يحجز شخص ما اجتماعًا باستخدام بريد إلكتروني @builder.io، أرسل لي رسالة على Slack."
يكتشف الوكيل الأحداث المتاحة، ويؤكد الخطة، ويكتب لك الأتمتة.
### من واجهة Automations
افتح **Settings › Automations**. هذا هو المكان الرئيسي لعرض الأتمتة المجدولة والمشغلة بالأحداث والمشغلة عبر webhook، وفحص الحالة، وتشغيل إحداها الآن، وإيقافها مؤقتًا أو استئنافها، وحذفها. الروابط القديمة `/agent#jobs` تعيد التوجيه إلى هناك.
**Run now** هو أسرع طريقة لاختبار أتمتة. يشغّل تعليمات الأتمتة فورًا، مع آثارها الجانبية الحقيقية. يتجاوز المشغل والشرط، ولا يغيّر موعد التشغيل المجدول التالي، باستثناء حالة واحدة: إذا أوقف إطار العمل الأتمتة مؤقتًا، فإن التشغيل الناجح يعيد تفعيلها، ويُعاد حساب موعد التشغيل التالي للأتمتة المجدولة. يمكن للوكيل فعل الشيء نفسه عبر `manage-automations` مع `action=run-now`.
<Callout tone="warning">
تدعم أداة `manage-automations` الأتمتة الشخصية وأتمتة المؤسسة لكل من المشغلات المجدولة والمشغلة بالأحداث. تكون أتمتة أحداث المؤسسة مرئية للأعضاء، لكنها تعمل دائمًا بهوية منشئها؛ ويمكن للمسؤولين إدارتها من دون تغيير تلك الهوية.
</Callout>
المسار الثالث - كتابة ملف `jobs/<name>.md` يدويًا عبر `resourcePut` - يعمل تمامًا كما هو الحال مع [recurring jobs](/docs/recurring-jobs#creating). للحصول على أتمتة تعتمد على الحدث، يمكنك إضافة المادة الأمامية لمشغل الحدث أدناه إلى نفس الملف. تقوم المهمة التي يتم تشغيلها بواسطة حدث بتعيين `schedule: ""` وتوفر `triggerType: event` واسم `event` و`condition` اختياري:
<AnnotatedCode
id="doc-block-1nt3xht"
title={"أتمتة ناجمة عن الأحداث"}
filename="jobs/slack-on-builder-booking.md"
language="markdown"
code={
'---\nschedule: ""\nenabled: true\ntriggerType: event\nevent: calendar.booking.created\ncondition: "attendee email ends with @builder.io"\nmode: agentic\ndomain: calendar\nrunAs: creator\n---\nSend a Slack message to #sales with the booking details.\nUse the web-request tool to POST to ${keys.SLACK_WEBHOOK}.'
}
annotations={[
{
lines: "2",
label: "لا كرون",
note: 'قم بتعيين مشغلات الأحداث `schedule` إلى `""` - يظل حقل cron فارغًا.',
},
{
lines: "4-5",
label: "الزناد",
note: "`triggerType: event` بالإضافة إلى اسم `event` يشترك في هذه الأتمتة في الناقل.",
},
{
lines: "6",
label: "بوابة",
note: "لغة طبيعية اختيارية `condition`، يتحقق منها نموذج مقابل الحمولة قبل الإرسال.",
},
{
lines: "12",
label: "سر من جانب الخادم",
note: "يتم حل `${keys.SLACK_WEBHOOK}` من جانب الخادم - ولا تدخل القيمة الأولية مطلقًا في سياق الوكيل.",
},
]}
/>
## الأتمتة الأمامية {#frontmatter}
تشارك عمليات التشغيل الآلي كل حقل في [recurring-jobs frontmatter table](/docs/recurring-jobs#frontmatter). تتحكم هذه الحقول الإضافية في مشغلات الأحداث وشروطها ووضع التنفيذ:
| الحقل | اكتب | الافتراضي | الوصف |
| ------------- | ---------------------------------------- | ------------ | -------------------------------------------------------------------------------------------------------------------------------------- |
| `triggerType` | `"schedule"` \| `"event"` \| `"webhook"` | `"schedule"` | كيفية تشغيل الأتمتة |
| `event` | سلسلة | _(اختياري)_ | اسم الحدث المطلوب الاشتراك فيه (مشغّلات الحدث فقط) |
| `condition` | سلسلة | _(اختياري)_ | تم تقييم حالة اللغة الطبيعية قبل الإرسال (مشغلات الحدث وwebhook) |
| `mode` | `"agentic"` | `"agentic"` | حلقة الوكيل الكاملة (الوضع الوحيد المدعوم). تمت إزالة `"deterministic"` — لم يتم تنفيذه قط، وعمليات الأتمتة التي تحدده لم تُطلق أبدًا. |
| `domain` | سلسلة | _(اختياري)_ | علامة التجميع (البريد، التقويم، المقاطع, إلخ.) |
بالنسبة لمشغل الحدث أو webhook، `schedule` هو `""` (فارغ)؛ بالنسبة لمشغل الجدول الزمني فإنه يحمل تعبير cron. يكتب المرسل أيضًا نفس حقول `lastRun` / `lastStatus` / `lastError` المُدارة التي يكتبها المجدول، بالإضافة إلى حالة `"skipped"` عندما يتم تقييم الشرط إلى false. وعندما يتعذر تقييم الشرط، راجع [Conditions](#conditions) لمعرفة ما يتم تسجيله.
## حافلة الأحداث {#event-bus}
تقوم عمليات التكامل بتسجيل الأحداث في وقت تحميل الوحدة. تقوم الحافلة بالتحقق من صحة الحمولات مقابل تعريفات [Standard Schema](https://standardschema.dev) وإرسالها إلى المشتركين.
### الأحداث المضمنة {#built-in-events}
| الحدث | المصدر |
| ---------------------- | ----------------------------------------------- |
| `test.event.fired` | يدوي / إجراء `manage-automations`=اختبار الحريق |
| `agent.turn.completed` | دردشة الوكيل |
| `calendar.*` | تكامل التقويم |
| `clip.*` | تكامل المقاطع |
| `mail.*` | تكامل البريد |
اتصل بـ `manage-automations` مع `action=list-events` من الوكيل لرؤية جميع الأحداث المسجلة مع الأوصاف ومخططات الحمولة للقالب الحالي.
### إصدار أحداث مخصصة {#emitting-events}
قم بتسجيل نوع الحدث في مكون إضافي للخادم، ثم قم بإصداره من actions أو معالجات خطاف الويب:
```ts
import { registerEvent, emit } from "@agent-native/core/event-bus";
import { z } from "zod";
// Register the event type (once, at module load)
registerEvent({
name: "order.completed",
description: "A customer completed an order",
payloadSchema: z.object({
orderId: z.string(),
customerEmail: z.string(),
total: z.number(),
}),
example: {
orderId: "ord_123",
customerEmail: "jane@example.com",
total: 49.99,
},
});
// Emit the event (from an action, webhook handler, etc.)
emit(
"order.completed",
{
orderId: "ord_123",
customerEmail: "jane@example.com",
total: 49.99,
},
{ owner: "user@example.com" },
);
```
يحدد `owner` في بيانات تعريف الحدث الأتمتة التي يمكن تشغيلها. تتطلب أتمتة الأحداث الشخصية وأتمتة المؤسسة تطابقًا تامًا مع هوية `createdBy`.
## الشروط {#conditions}
الشروط هي سلاسل باللغة الطبيعية يتحقق منها نموذج مقابل حمولة الحدث أو webhook. هذا تصنيف نعم/لا، وليس مهمة إنشاء.
- **شرط فارغ أو مفقود** = غير مشروط (يتم تفعيله دائمًا).
- يتم تخزين النتائج مؤقتًا لمدة 5 دقائق، بمفتاح هو تجزئة SHA-256 للشرط والحمولة، وبحد أقصى 500 إدخال.
- يتم اقتطاع الحمولة إلى 4000 حرف قبل إرسالها إلى النموذج.
<Callout tone="info">
الشرط الذي يتعذر تقييمه لا يُعدّ تطابقًا ولا عدم تطابق، ولا يتم تشغيل الأتمتة. عند حدوث خطأ من المزوّد تسجل الأتمتة `lastStatus: error` مع السبب في `lastError`، وتتم إعادة محاولة الحدث. إذا لم يتوفر مفتاح API لتقييم الشرط، تسجل أتمتة الأحداث خطأً لكل حدث مطابق، وتوقف نفسها مؤقتًا بعد ثلاثة أخطاء متتالية. بمجرد توفر مفتاح، يعيد المجدول قيد التشغيل تفعيلها من تلقاء نفسه خلال 15 دقيقة تقريبًا. وعلى مضيف لا يعمل فيه أي مجدول، أعد تفعيلها من **Settings › Automations**. أما أتمتة webhook في الحالة نفسها فلا تتوقف مؤقتًا، بل يفشل تسليمها وتتم إعادة محاولته.
</Callout>
أمثلة على الشروط:
- `"attendee email ends with @builder.io"`
- `"the order total is greater than $100"`
- `"the message contains the word 'urgent'"`
## أداة طلب الويب {#web-request}
تستخدم عمليات التشغيل الآلي أداة `web-request` لـ HTTP الصادرة. وهو يدعم العناصر النائبة `${keys.NAME}` في URL والرؤوس والنص:
```
POST to ${keys.SLACK_WEBHOOK}
Headers: {"Authorization": "Bearer ${keys.API_TOKEN}"}
Body: {"text": "New booking from ${attendeeEmail}"}
```
يتم حل العناصر النائبة **من جانب الخادم** بعد أن يرسل الوكيل استدعاء الأداة — لا تدخل القيمة السرية الأولية مطلقًا في سياق الوكيل.
### المعلمات {#web-request-params}
| المعلمة | اكتب | الافتراضي | الوصف |
| -------------- | ----- | ------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `url` | سلسلة | — | URL كامل. قد يحتوي على مراجع `${keys.NAME}`. |
| `method` | سلسلة | `GET` | طريقة HTTP (GET، POST، PUT، PATCH، DELETE، HEAD). |
| `headers` | سلسلة | `{}` | كائن JSON للرؤوس. قد يحتوي على `${keys.NAME}`. |
| `body` | سلسلة | — | نص الطلب. قد يحتوي على `${keys.NAME}`. |
| `timeout_ms` | الرقم | 15000 | المهلة بالمللي ثانية (30000 كحد أقصى). |
| `maxChars` | رقم | 32000 | الحد الأقصى لأحرف متن الاستجابة التي تُعاد في سياق الوكيل، بحد أقصى 200000. يقتصر الحد على أحرف المتن لا على الاستجابة المنسقة كاملة، لذا قد تضيف البيانات الوصفية والروابط أحرفًا. لا يحد هذا من محتوى الملف المحفوظ. |
| `responseMode` | سلسلة | `auto` | طريقة إرجاع الاستجابة: `auto` (يحوّل HTML إلى Markdown ويبقي JSON والنص خامًا)، أو `raw` أو `text` أو `markdown` أو `links` أو `metadata` أو `matches` مع `search`. |
| `extract` | سلسلة | `readability` | طريقة استخراج HTML: `readability` أو `all-visible` (كل نص المتن المرئي) أو `none` (المستند كاملًا). |
| `includeLinks` | منطقي | متغير | هل تتضمن استجابات HTML المستخرجة قائمة موجزة بالروابط. الافتراضي هو `true` للاستجابات المضمنة و`false` عند استخدام `saveToFile`. |
| `search` | كائن | — | بحث اختياري بعد جلب المحتوى المستخرج: `{ query, queries, terms, regex, regexFlags, source, maxMatches, contextChars, caseSensitive }`. |
| `saveToFile` | سلسلة | — | مسار ملف في مساحة العمل لحفظ الاستجابة كاملة، حتى 20 MiB. مع `search` يعيد كل التطابقات بحد أقصى `maxChars`، وبدونه يعيد معاينة من 2000 حرف. |
يحد `maxChars` افتراضيًا من أحرف متن الاستجابة التي تُعاد في سياق الوكيل فقط. ولا يحد من الاستجابة المنسقة كاملة، لذا قد تضيف البيانات الوصفية والروابط أحرفًا. حد الاستجابات المُضمّنة هو 1 MiB، باستثناء HTML أو XHTML المستخرج الذي يمكن أن يصل إلى 20 MiB. يظل حد HTML الخام وبقية الاستجابات المُضمّنة 1 MiB.
يحفظ `saveToFile` الاستجابات حتى 20 MiB. يُحفظ HTML أو XHTML بصيغة Markdown أو نص مستخرج عند استخدام `responseMode` غير خام. أما الوضع الخام والاستجابات غير HTML فتُحفظ كنص جسم الاستجابة بعد فك ترميزه، من دون استخراج HTML. عند استخدام `saveToFile` مع `search`، تعيد الأداة كل نتائج البحث ضمن حد `maxChars`. ومن دون `search` تعيد معاينة من 2000 حرف. يعني `searchResultsTruncated` أن `maxChars` اقتطع النتيجة المنسقة. ويعني `searchSourceTruncated` أن الأداة فحصت أول 500,000 حرف فقط من مصدر البحث المحدد.
يوضح خطأ تجاوز الحد الحجم المرصود والحد المطبق وطريقة الاسترداد. استخدم `saveToFile` للاستجابات حتى 20 MiB، أو اطلب استجابة أصغر إذا تجاوزت هذا الحد.
## المفاتيح {#keys}
المفاتيح هي أسرار مخصصة تم إنشاؤها بواسطة المستخدمين أو الوكيل لاستخدام التشغيل الآلي (على سبيل المثال، `SLACK_WEBHOOK`، `HUBSPOT_API_KEY`). وهي تختلف عن الأسرار المسجلة (`registerRequiredSecret`) من حيث أنها لا تحتوي على بيانات وصفية محددة في القالب أو خطوة إعداد.
- تم الإنشاء عبر الإعدادات UI أو `/_agent-native/secrets/adhoc` API.
- يمكن أن يتضمن المفتاح الذي يتم إنشاؤه عبر API حقل `urlAllowlist` يقيد المصادر التي يمكن إرسال المفتاح إليها (المطابقة على مستوى الأصل). المفاتيح المضافة في Settings ليس لها قائمة سماح.
- لا يتم عرض القيمة الأولية مطلقًا للذكاء الاصطناعي - تظهر فقط العناصر النائبة `${keys.NAME}` في سياق الوكيل.
- يرجع القرار من نطاق المستخدم إلى نطاق مساحة العمل، حتى يتمكن المستخدمون من تجاوز المفاتيح المشتركة.
## أدوات الوكيل {#agent-tools}
تستخدم عمليات الأتمتة الشخصية وأتمتة المؤسسة أداة `manage-automations` مع معلمة `action`:
| الإجراء | الغرض |
| ------------- | ------------------------------------------------------------------------- |
| `list-events` | اكتشف جميع الأحداث المسجلة مع الأوصاف ومخططات الحمولة |
| `list-hosts` | سرد المضيفين المقترنين للتنفيذ قبل تعيين أحدهم لأتمتة |
| `list` | سرد جميع عمليات الأتمتة ذات الحالة؛ التصفية حسب المجال أو التمكين |
| `define` | إنشاء آلية جديدة (الاسم، نوع المشغل، الحدث، الحالة، النص) |
| `update` | تحديث آلية موجودة (ممكّنة، الحالة، النص) |
| `delete` | حذف عملية تلقائية (يتم التأكيد دائمًا مع المستخدم أولاً) |
| `run-now` | تشغيل أتمتة واحدة فورًا، مع آثار جانبية حقيقية. يتجاوز المشغل والشرط. |
| `fire-test` | أصدر حدث `test.event.fired`. لا تستجيب إلا الأتمتة المشتركة في ذلك الحدث. |
أداة إضافية: `web-request` — HTTP للخارج مع استبدال `${keys.NAME}`.
تدعم `manage-automations` نطاق المؤسسة وتجاوزات النموذج وقوائم السماح الدقيقة لأدوات MCP. وتبقى `manage-jobs` أداة توافق للتكاملات المجدولة القديمة وبيانات التسليم.
## نقاط نهاية API {#api}
| نقطة النهاية | الطريقة | الوصف |
| ------------------------------------------- | ------- | -------------------------------------------------- |
| `/_agent-native/automations` | GET | سرد جميع عمليات التشغيل التلقائي (التي تم تحليلها) |
| `/_agent-native/automations/fire-test` | POST | أصدر حدث `test.event.fired` |
| `/_agent-native/automations/webhook/:token` | POST | تشغيل أتمتة webhook |
| `/_agent-native/secrets/adhoc` | GET | قائمة المفاتيح المخصصة (بدون قيم) |
| `/_agent-native/secrets/adhoc` | POST | إنشاء أو تحديث مفتاح مخصص |
| `/_agent-native/secrets/adhoc/:name` | DELETE | حذف مفتاح مخصص |
<Endpoint id="doc-block-1jlxsh5" title={"إطلاق حدث اختباري"} method="POST" path="/_agent-native/automations/fire-test" summary={"أصدر حدث test.event.fired لتجربة الأتمتة المشتركة فيه"} responses={[
{
"status": "200",
"description": "Event emitted; matching automations are dispatched through the normal condition + ownership path."
}
]}>
يتحقق من مسار الحدث (المطابقة ونطاق المالك والشرط) لأتمتة مشتركة في `test.event.fired`. يُصدر هذا الحدث فقط، لذا لا يمكنه تشغيل أتمتة تستمع إلى حدث حقيقي مثل `calendar.booking.created`. لتجربة أتمتة حقيقية، استخدم **Run now**. يعادل الإجراء `fire-test` في `manage-automations`.
</Endpoint>
## كيف يعمل الإرسال {#dispatch}
<Diagram id="doc-block-znsz65" title={"مسار الإرسال"} summary={"من حدث مطرود إلى تشغيل وكيل مكتمل، مقيد بنطاق الملكية وحالة اللغة الطبيعية."}>
```html
<div class="disp">
<div class="diagram-box accent">حدث إطلاق النار على الحافلة</div>
<div class="diagram-arrow diagram-muted" aria-hidden="true">↓</div>
<div class="diagram-card">
<span class="diagram-pill">مباراة</span
><small class="diagram-muted"
>تحميل الأتمتة التي تم تمكينها والمشتركة في اسم الحدث هذا</small
>
</div>
<div class="diagram-arrow diagram-muted" aria-hidden="true">↓</div>
<div class="diagram-card">
<span class="diagram-pill">نِطَاق</span
><small class="diagram-muted"
>مطابقة <code>createdBy</code> مع مالك الحدث والتحقق من عضوية
المؤسسة</small
>
</div>
<div class="diagram-arrow diagram-muted" aria-hidden="true">↓</div>
<div class="diagram-card">
<span class="diagram-pill warn">حالة</span
><small class="diagram-muted"
>نموذج نعم/لا على الحمولة — false → <code>skipped</code>، الفشل
→ <code>error</code></small
>
</div>
<div class="diagram-arrow diagram-muted" aria-hidden="true">↓</div>
<div class="diagram-card accent">
<span class="diagram-pill accent">يجري</span
><small class="diagram-muted"
><code>runAgentLoop</code> مع النص كموجه، والحمولة كسياق، ومهلة مدتها 5
دقائق</small
>
</div>
<div class="diagram-arrow diagram-muted" aria-hidden="true">↓</div>
<div class="diagram-card ok">
<span class="diagram-pill ok">سِجِلّ</span
><small class="diagram-muted"
>يكتب <code>lastRun</code> / <code>lastStatus</code> /
<code>lastError</code></small
>
</div>
</div>
```
```css
.disp {
display: flex;
flex-direction: column;
gap: 6px;
max-width: 540px;
}
.disp .diagram-card {
display: flex;
flex-direction: column;
gap: 2px;
padding: 10px 14px;
}
.disp .diagram-box {
align-self: flex-start;
}
.disp .diagram-arrow {
font-size: 18px;
align-self: center;
}
```
</Diagram>
## مثال {#example}
**المستخدم:** "عندما يقوم شخص ما بالحجز باستخدام بريد إلكتروني @builder.io، أرسل لي رسالة على Slack."
**تدفق الوكيل:**
1. استدعاء `manage-automations` باستخدام `action=list-events` — العثور على `calendar.booking.created`.
2. تأكيد الخطة مع المستخدم.
3. استدعاء `manage-automations` مع `action=define`:
- `name`: `slack-on-builder-booking`
- `trigger_type`: `event`
- `event`: `calendar.booking.created`
- `condition`: `attendee email ends with @builder.io`
- `mode`: `agentic`
- `domain`: `calendar`
- `body`: `Send a Slack message to #sales with the booking details. Use the web-request tool to POST to ${keys.SLACK_WEBHOOK}.`
4. يتم حفظ التشغيل الآلي باسم `jobs/slack-on-builder-booking.md` ويبدأ الاستماع على الفور.
## مزيد من الأمثلة {#more-examples}
### الإخطار عبر الرد التلقائي على الويب عند التعليق على الخطة
اسأل وكيل الخطة: _"عندما يضيف شخص ما تعليقًا بشريًا على الخطة، POST a
إشعار بخطاف الويب الخاص بي."_
```yaml
---
schedule: ""
triggerType: event
event: plan.commented
condition: "resolutionTarget is human or resolutionTarget is null"
mode: agentic
domain: plan
enabled: true
---
POST to ${keys.NOTIFY_WEBHOOK} with a JSON body:
{"title": "<plan title>", "excerpt": "<comment excerpt>", "author": "<author email or null>", "url": "<app base url + path>"}
```
قم بتعيين `NOTIFY_WEBHOOK` على أي نقطة نهاية HTTP — خطاف ويب وارد Slack، وهو خطاف عام
خدمة إعلام، أو جهاز استقبال مخصص. تقوم أداة `web-request` بحل المشكلة
`${keys.NOTIFY_WEBHOOK}` من جانب الخادم؛ لا يظهر URL الخام أبدًا في
السياق. انظر [Visual Plans — Events and notifications](/docs/template-plan#events)
للاطلاع على مرجع الحمولة النافعة `plan.commented` الكامل وجميع أحداث الخطة الأربعة.
## ما هي الخطوة التالية
- [**Recurring Jobs**](/docs/recurring-jobs) — تعيد عمليات التشغيل الآلي التي يتم تشغيلها بالجدول الزمني استخدام نفس المجدول
- [**Actions**](/docs/actions-overview) — يمكن للأتمتة استدعاء أي إجراء مسجل عبر حلقة الوكيل
- [**Security**](/docs/security) — التحقق من صحة الإدخال والمعالجة السرية
- [**Visual Plans — Events**](/docs/template-plan#events) — مرجع التخطيط للأحداث ووصفات التشغيل الآلي
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 |