Skip to content

BuilderIO/agent-native / packages/core/docs

agent-native-docs

Unverified

How 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.

FileKindSize
AGENTS.mdmarkdown6.0 KB
SKILL.mdskill md2.2 KB
content/a2a-protocol.mdxmarkdown37.6 KB
content/actions-access-control.mdxmarkdown28.9 KB
content/actions-advanced.mdxmarkdown13.1 KB
content/actions-agent-tools.mdxmarkdown5.6 KB
content/actions-defining.mdxmarkdown31.2 KB
content/actions-other-surfaces.mdxmarkdown10.3 KB
content/actions-overview.mdxmarkdown8.3 KB
content/actions-run-context.mdxmarkdown9.1 KB
content/add-ui-to-your-agent.mdxmarkdown5.0 KB
content/administered-deployments.mdxmarkdown7.7 KB
content/agent-mentions.mdxmarkdown10.2 KB
content/agent-native-config.mdxmarkdown34.9 KB
content/agent-native-toolkit.mdxmarkdown17.3 KB
content/agent-resources.mdxmarkdown27.0 KB
content/agent-surfaces.mdxmarkdown33.8 KB
content/agent-teams.mdxmarkdown13.4 KB
content/agent-web-surfaces.mdxmarkdown10.7 KB
content/agentkit.mdxmarkdown14.0 KB
content/audit-log.mdxmarkdown14.3 KB
content/authentication.mdxmarkdown30.7 KB
content/automation-connectors.mdxmarkdown7.8 KB
content/automations.mdxmarkdown26.7 KB
content/aws-amplify.mdxmarkdown10.7 KB
content/aws-lambda.mdxmarkdown13.9 KB
content/aws-rds.mdxmarkdown1.7 KB
content/azure-postgresql.mdxmarkdown1.8 KB
content/azure-static-web-apps.mdxmarkdown9.1 KB
content/blueprint-installer.mdxmarkdown6.3 KB
content/cli-adapters.mdxmarkdown5.7 KB
content/client-advanced.mdxmarkdown13.1 KB
content/client-agent-chat.mdxmarkdown17.7 KB
content/client-data.mdxmarkdown19.3 KB
content/client-entry-points.mdxmarkdown1.2 KB
content/client-overview.mdxmarkdown10.6 KB
content/client-routing.mdxmarkdown5.7 KB
content/client-sync-internals.mdxmarkdown5.2 KB
content/cloneable-saas.mdxmarkdown16.6 KB
content/cloud-sql.mdxmarkdown2.3 KB
content/cloudflare.mdxmarkdown8.3 KB
content/code-agents-ui.mdxmarkdown26.6 KB
content/components.mdxmarkdown42.9 KB
content/context-awareness.mdxmarkdown24.9 KB
content/create-with-an-agent.mdxmarkdown8.8 KB
content/creating-templates.mdxmarkdown21.6 KB
content/cross-app-connect-design.mdxmarkdown8.4 KB
content/cross-app-sso.mdxmarkdown8.7 KB
content/custom-design-system.mdxmarkdown17.3 KB
content/data-programs.mdxmarkdown25.0 KB
content/decisions.mdxmarkdown7.9 KB
content/deno-deploy.mdxmarkdown7.2 KB
content/deploy-an-app.mdxmarkdown5.0 KB
content/deployment-environment-variables.mdxmarkdown16.3 KB
content/deployment.mdxmarkdown11.3 KB
content/dispatch.mdxmarkdown18.6 KB
content/docker.mdxmarkdown8.1 KB
content/docs-components.mdxmarkdown28.9 KB
content/doctor.mdxmarkdown21.3 KB
content/drafts/clips-experimental-features.mdmarkdown5.4 KB
content/drop-in-agent.mdxmarkdown16.0 KB
content/durable-background-runs.mdxmarkdown13.8 KB
content/durable-resume.mdxmarkdown10.0 KB
content/embedding-sdk.mdxmarkdown31.3 KB
content/environment-variables.mdxmarkdown29.9 KB
content/evals.mdxmarkdown12.4 KB
content/extensions.mdxmarkdown34.8 KB
content/external-agents-catalog.mdxmarkdown40.5 KB
content/external-agents.mdxmarkdown29.3 KB
content/file-uploads.mdxmarkdown10.7 KB
content/generative-ui.mdxmarkdown10.8 KB
content/getting-started-actions.mdxmarkdown2.7 KB
content/getting-started-pages.mdxmarkdown2.6 KB
content/getting-started.mdxmarkdown7.2 KB
content/harness-agents.mdxmarkdown16.9 KB
content/http-api.mdxmarkdown20.9 KB
content/integrations.mdxmarkdown33.8 KB
content/internationalization.mdxmarkdown6.2 KB
content/key-concepts.mdxmarkdown30.6 KB
content/koyeb.mdxmarkdown7.3 KB
content/locales/ar-SA/a2a-protocol.mdxmarkdown48.5 KB
content/locales/ar-SA/actions-access-control.mdxmarkdown40.8 KB
content/locales/ar-SA/actions-advanced.mdxmarkdown16.3 KB
content/locales/ar-SA/actions-agent-tools.mdxmarkdown8.1 KB
content/locales/ar-SA/actions-defining.mdxmarkdown42.2 KB
content/locales/ar-SA/actions-other-surfaces.mdxmarkdown14.5 KB
content/locales/ar-SA/actions-overview.mdxmarkdown11.3 KB
content/locales/ar-SA/actions-run-context.mdxmarkdown11.1 KB
content/locales/ar-SA/add-ui-to-your-agent.mdxmarkdown3.7 KB
content/locales/ar-SA/administered-deployments.mdxmarkdown6.4 KB
content/locales/ar-SA/agent-mentions.mdxmarkdown11.8 KB
content/locales/ar-SA/agent-native-toolkit.mdxmarkdown17.3 KB
content/locales/ar-SA/agent-resources.mdxmarkdown36.8 KB
content/locales/ar-SA/agent-surfaces.mdxmarkdown48.4 KB
content/locales/ar-SA/agent-teams.mdxmarkdown18.5 KB
content/locales/ar-SA/agent-web-surfaces.mdxmarkdown14.3 KB
content/locales/ar-SA/audit-log.mdxmarkdown15.9 KB
content/locales/ar-SA/authentication.mdxmarkdown39.8 KB
content/locales/ar-SA/automations.mdxmarkdown31.3 KB
content/locales/ar-SA/aws-amplify.mdxmarkdown14.9 KB
content/locales/ar-SA/aws-lambda.mdxmarkdown18.9 KB
content/locales/ar-SA/aws-rds.mdxmarkdown319 B
content/locales/ar-SA/azure-postgresql.mdxmarkdown344 B
content/locales/ar-SA/azure-static-web-apps.mdxmarkdown12.4 KB
content/locales/ar-SA/blueprint-installer.mdxmarkdown8.4 KB
content/locales/ar-SA/cli-adapters.mdxmarkdown6.7 KB
content/locales/ar-SA/client-advanced.mdxmarkdown17.8 KB
content/locales/ar-SA/client-agent-chat.mdxmarkdown23.0 KB
content/locales/ar-SA/client-data.mdxmarkdown23.8 KB
content/locales/ar-SA/client-entry-points.mdxmarkdown1.6 KB
content/locales/ar-SA/client-overview.mdxmarkdown13.9 KB
content/locales/ar-SA/client-routing.mdxmarkdown7.2 KB
content/locales/ar-SA/client-sync-internals.mdxmarkdown7.3 KB
content/locales/ar-SA/cloneable-saas.mdxmarkdown23.2 KB
content/locales/ar-SA/cloud-sql.mdxmarkdown317 B
content/locales/ar-SA/cloudflare.mdxmarkdown11.9 KB
content/locales/ar-SA/code-agents-ui.mdxmarkdown34.2 KB
content/locales/ar-SA/components.mdxmarkdown51.5 KB
content/locales/ar-SA/context-awareness.mdxmarkdown33.1 KB
content/locales/ar-SA/create-with-an-agent.mdxmarkdown12.2 KB
content/locales/ar-SA/creating-templates.mdxmarkdown26.8 KB
content/locales/ar-SA/cross-app-connect-design.mdxmarkdown1.5 KB
content/locales/ar-SA/cross-app-sso.mdxmarkdown9.7 KB
content/locales/ar-SA/custom-design-system.mdxmarkdown21.6 KB
content/locales/ar-SA/data-programs.mdxmarkdown33.3 KB
content/locales/ar-SA/decisions.mdxmarkdown9.1 KB
content/locales/ar-SA/deno-deploy.mdxmarkdown10.1 KB
content/locales/ar-SA/deploy-an-app.mdxmarkdown7.1 KB
content/locales/ar-SA/deployment-environment-variables.mdxmarkdown21.3 KB
content/locales/ar-SA/deployment.mdxmarkdown13.9 KB
content/locales/ar-SA/dispatch.mdxmarkdown27.3 KB
content/locales/ar-SA/docker.mdxmarkdown11.3 KB
content/locales/ar-SA/doctor.mdxmarkdown3.4 KB
content/locales/ar-SA/drop-in-agent.mdxmarkdown20.8 KB
content/locales/ar-SA/durable-resume.mdxmarkdown15.4 KB
content/locales/ar-SA/embedding-sdk.mdxmarkdown41.3 KB
content/locales/ar-SA/evals.mdxmarkdown13.3 KB
content/locales/ar-SA/extensions.mdxmarkdown34.0 KB
content/locales/ar-SA/external-agents.mdxmarkdown89.3 KB
content/locales/ar-SA/file-uploads.mdxmarkdown13.4 KB
content/locales/ar-SA/getting-started-actions.mdxmarkdown3.2 KB
content/locales/ar-SA/getting-started-pages.mdxmarkdown3.2 KB
content/locales/ar-SA/getting-started.mdxmarkdown9.7 KB
content/locales/ar-SA/harness-agents.mdxmarkdown22.3 KB
content/locales/ar-SA/internationalization.mdxmarkdown8.2 KB
content/locales/ar-SA/key-concepts.mdxmarkdown42.0 KB
content/locales/ar-SA/koyeb.mdxmarkdown10.2 KB
content/locales/ar-SA/mcp-apps.mdxmarkdown33.7 KB
content/locales/ar-SA/mcp-clients.mdxmarkdown35.0 KB
content/locales/ar-SA/mcp-protocol.mdxmarkdown27.6 KB
content/locales/ar-SA/messaging.mdxmarkdown59.2 KB
content/locales/ar-SA/multi-app-workspace.mdxmarkdown36.2 KB
content/locales/ar-SA/multi-tenancy.mdxmarkdown7.5 KB
content/locales/ar-SA/native-chat-ui.mdxmarkdown21.3 KB
content/locales/ar-SA/neon.mdxmarkdown244 B
content/locales/ar-SA/netlify.mdxmarkdown15.2 KB
content/locales/ar-SA/node-docker.mdxmarkdown878 B
content/locales/ar-SA/node-js.mdxmarkdown8.4 KB
content/locales/ar-SA/notifications.mdxmarkdown16.2 KB
content/locales/ar-SA/observability.mdxmarkdown45.2 KB
content/locales/ar-SA/observational-memory.mdxmarkdown10.9 KB
content/locales/ar-SA/onboarding.mdxmarkdown16.9 KB
content/locales/ar-SA/organizations-teams-permissions.mdxmarkdown5.9 KB
content/locales/ar-SA/package-lifecycle.mdxmarkdown3.0 KB
content/locales/ar-SA/plan-plugin.mdxmarkdown23.0 KB
content/locales/ar-SA/portal.mdxmarkdown636 B
content/locales/ar-SA/postgres.mdxmarkdown487 B
content/locales/ar-SA/pr-visual-recap.mdxmarkdown53.9 KB
content/locales/ar-SA/privacy-and-data-rights.mdxmarkdown6.2 KB
content/locales/ar-SA/processors.mdxmarkdown8.7 KB
content/locales/ar-SA/progress.mdxmarkdown10.7 KB
content/locales/ar-SA/pure-agent-apps.mdxmarkdown5.0 KB
content/locales/ar-SA/real-time-collaboration.mdxmarkdown55.6 KB
content/locales/ar-SA/recorder.mdxmarkdown16.7 KB
content/locales/ar-SA/recurring-jobs.mdxmarkdown23.8 KB
content/locales/ar-SA/render.mdxmarkdown11.2 KB
content/locales/ar-SA/sandbox-adapters.mdxmarkdown18.0 KB
content/locales/ar-SA/security.mdxmarkdown31.5 KB
content/locales/ar-SA/server-database.mdxmarkdown27.6 KB
content/locales/ar-SA/server-middleware.mdxmarkdown7.9 KB
content/locales/ar-SA/server-overview.mdxmarkdown12.2 KB
content/locales/ar-SA/server-plugins.mdxmarkdown9.1 KB
content/locales/ar-SA/server-routes.mdxmarkdown14.3 KB
content/locales/ar-SA/sharing.mdxmarkdown28.6 KB
content/locales/ar-SA/skills-guide.mdxmarkdown27.0 KB
content/locales/ar-SA/ssr-caching.mdxmarkdown7.4 KB
content/locales/ar-SA/supabase.mdxmarkdown264 B
content/locales/ar-SA/syncing-template-changes.mdxmarkdown11.7 KB
content/locales/ar-SA/telemetry.mdxmarkdown21.9 KB
content/locales/ar-SA/template-analytics.mdxmarkdown26.4 KB
content/locales/ar-SA/template-assets.mdxmarkdown31.9 KB
content/locales/ar-SA/template-brain.mdxmarkdown29.7 KB
content/locales/ar-SA/template-calendar-agent.mdxmarkdown10.2 KB
content/locales/ar-SA/template-calendar-developers.mdxmarkdown33.4 KB
content/locales/ar-SA/template-calendar-features.mdxmarkdown14.4 KB
content/locales/ar-SA/template-calendar-integrations.mdxmarkdown6.2 KB
content/locales/ar-SA/template-calendar.mdxmarkdown4.4 KB
content/locales/ar-SA/template-chat-agent.mdxmarkdown4.7 KB
content/locales/ar-SA/template-chat-developers.mdxmarkdown31.3 KB
content/locales/ar-SA/template-chat-features.mdxmarkdown9.9 KB

content/locales/ar-SA/dispatch.mdx

View on GitHub
---
title: "إرسال"
description: "مستوى التحكم في مساحة العمل: مخزن الأسرار ومركز التكامل والمفوض عبر التطبيقات وصندوق البريد المركزي لـ Slack والبريد الإلكتروني وTelegram وWhatsApp."
---

# إرسال

Dispatch هو التطبيق المركزي الذي يقع أمام كل تطبيق آخر في مساحة العمل لديك ويتعامل مع الأسرار وعمليات التكامل والمراسلة والتفويض عبر التطبيقات. إنه **مستوى التحكم في مساحة العمل** — الوكيل الوحيد الذي يتحدث إليه فريقك، وبيانات اعتماد المكان الوحيد، وجهاز التوجيه الوحيد الذي يقرر التطبيق المتخصص الذي يجب أن يتعامل مع طلب معين.

> **إرسال القالب مقابل `@agent-native/dispatch` الحزمة.** تغطي هذه الصفحة مفهوم تطبيق/قالب Dispatch — ما يفعله ولماذا تريده. حزمة `@agent-native/dispatch` npm هي وقت تشغيل منشور بشكل منفصل يجمع منطق خادم قالب Dispatch (المخزن وعمليات التكامل والوجهات والمهام المجدولة والتفويض عبر التطبيقات) كحزمة منسدلة لمساحات العمل التي تعمل على توسيعها. بالنسبة للتطبيق المدمج نفسه (الطرق، الشاشات، دليل الوكيل)، راجع [Dispatch template](/docs/template-dispatch).

بدون Dispatch، سينتهي الأمر بكل تطبيق في مساحة عمل متعددة التطبيقات بإعادة تنفيذ نفس السباكة: روبوت Slack الخاص به، ومتجره السري الخاص، والوظائف المجدولة الخاصة به، ونسخته الخاصة من تعليمات مساحة العمل. يؤدي تدوير مفتاح API واحد إلى عشر عمليات إعادة توزيع. إضافة سياسة جديدة تتحول إلى عشرة نسخ ولصق. تعمل Dispatch على تجميع كل ذلك في تطبيق واحد حتى يواصل الآخرون التركيز على نطاقهم.

<Diagram id="doc-block-17t74c2" title={"Dispatch كمستوى التحكم في مساحة العمل"} summary={"يوجد صندوق بريد واحد، وقبو واحد، وبوابة MCP واحدة، وموارد مشتركة أمام تطبيقات النطاق، والتي يصل إليها Dispatch كأقران A2A."}>

```html
<div class="dsp-hub">
  <div class="diagram-node">
    Users &amp; external agents<br /><small class="diagram-muted"
      >Slack · البريد · Telegram · WhatsApp · MCP</small
    >
  </div>
  <div class="diagram-arrow diagram-muted" aria-hidden="true">&darr;</div>
  <div class="diagram-panel dsp-control" data-rough>
    <span class="diagram-pill accent">Dispatch &mdash; control plane</span>
    <div class="dsp-caps">
      <span class="diagram-pill">صندوق وارد مركزي</span
      ><span class="diagram-pill">خزنة الأسرار</span
      ><span class="diagram-pill">تفويض بين التطبيقات</span
      ><span class="diagram-pill">MCP gateway</span
      ><span class="diagram-pill">موارد مساحة العمل</span>
    </div>
  </div>
  <div class="diagram-arrow diagram-muted" aria-hidden="true">&darr;</div>
  <div class="dsp-peers">
    <div class="diagram-box" data-rough>Mail</div>
    <div class="diagram-box" data-rough>Calendar</div>
    <div class="diagram-box" data-rough>Analytics</div>
  </div>
  <small class="diagram-muted">domain apps &mdash; A2A peers</small>
</div>
```

```css
.dsp-hub {
  display: flex;
  flex-direction: column;
  align-items: center;
  gap: 10px;
}
.dsp-hub .dsp-control {
  display: flex;
  flex-direction: column;
  align-items: center;
  gap: 10px;
  width: 100%;
}
.dsp-hub .dsp-caps {
  display: flex;
  gap: 8px;
  flex-wrap: wrap;
  justify-content: center;
}
.dsp-hub .dsp-peers {
  display: flex;
  gap: 10px;
  flex-wrap: wrap;
  justify-content: center;
}
```

</Diagram>

## عندما تريد الإرسال {#when}

قم بالتواصل مع Dispatch عندما يكون أي مما يلي صحيحًا:

- أنت تقوم بتشغيل [multi-app workspace](/docs/multi-app-workspace) - البريد والتقويم والتحليلات والمحتوى - ولا تريد روبوت Slack واحد لكل تطبيق.
- تريد **صندوق بريد واردًا واحدًا لـ "الوكيل"** حتى يتمكن المستخدمون من إرسال رسالة مباشرة إلى برنامج تتبُّع واحد والتطبيق المتخصص المناسب يتولى العمل خلف الكواليس.
- لديك **أسرار على مستوى مساحة العمل** (مفتاح شريطي، مفتاح OpenAI، رموز API لجهة خارجية) تحتاجها العديد من التطبيقات وتريد قبوًا واحدًا بدلاً من نسخ القيم في كل `.env`.
- تريد **تدفق الموافقة في وقت التشغيل** أمام التغييرات الحساسة (الوجهات المحفوظة، وتعديلات السياسة) حتى يتمكن غير المسؤولين من طلبها ويمكن للمسؤولين تسجيل الخروج بدون نشر التعليمات البرمجية.
- تريد **مشاركة skills، والتعليمات، وملفات تعريف الوكلاء، وخوادم MCP** التي ترثها التطبيقات في مساحة العمل — تتغير مرة واحدة، وتصل إلى الجميع.

إذا كنت تقوم بتشغيل قالب واحد مستقل، فلن تحتاج إلى Dispatch - حيث يمكن لكل قالب توصيل عمليات تكامل المراسلة الخاصة به مباشرةً. راجع [Messaging](/docs/messaging) للتعرف على الإعداد المستقل.

## ما يفعله ديسباتش {#what-it-does}

سبع إمكانيات، جميعها موجودة أعلى قاعدة بيانات مساحة العمل نفسها التي تستخدمها التطبيقات الأخرى:

| القدرة                    | ما يقدمه لك                                                                         | إعداده                                                               |
| ------------------------- | ----------------------------------------------------------------------------------- | -------------------------------------------------------------------- |
| **البريد الوارد المركزي** | يصل Slack والبريد الإلكتروني وTelegram وWhatsApp إلى وكيل واحد بذاكرة مشتركة وأدوات | **الإدارة ← المراسلة** ([Messaging](/docs/messaging))                |
| **خزنة سرية**             | قم بتخزين كل بيانات الاعتماد مرة واحدة؛ التدوير في مكان واحد عبر كل تطبيق           | **Vault** + وضع الوصول (جميع التطبيقات أو اليدوي)                    |
| **التفويض عبر التطبيقات** | توجيه الطلب إلى التطبيق المتخصص المناسب عبر A2A والردود داخل سلسلة الرسائل          | تلقائي ([A2A](/docs/a2a-protocol))                                   |
| **بوابة MCP الموحدة**     | يصل موصل MCP واحد للوكلاء الخارجيين إلى كل تطبيق مساحة عمل ممنوح                    | [External Agents](/docs/external-agents)                             |
| **موارد مساحة العمل**     | المؤلف skills/التعليمات/الملفات الشخصية مرة واحدة؛ ترثها التطبيقات في وقت التشغيل   | **الموارد** ([موارد الوكيل](/docs/agent-resources#global-resources)) |
| **الأحلام**               | مراجعة عمليات التشغيل/التعليقات السابقة واقتراح تحسينات دائمة لكي توافق عليها       | **علامة تبويب الأحلام**                                              |
| **تدفق الموافقة**         | تغييرات وقت التشغيل الحساسة للبوابة خلف مراجعة المشرف المضمنة                       | **سياسة الموافقة على الإرسال**                                       |

تم تفصيل كل منها أدناه.

### البريد الوارد المركزي

يتدفق كل من Slack والبريد الإلكتروني وTelegram وWhatsApp إلى حلقة وكيل Dispatch. قم بتوصيل كل منصة مرة واحدة في **الإدارة → المراسلة** وتصل كل قناة إلى نفس الوكيل بنفس الذاكرة والأدوات. تنتهي رسالة Slack المباشرة والبريد الإلكتروني إلى `agent@yourcompany.com` كسطحين في سجل محادثة واحد، وليس روبوتين منفصلين. راجع [Messaging](/docs/messaging) للحصول على بيانات الاعتماد وخطاف الويب URLs.

### خزنة سرية

قم بتخزين بيانات الاعتماد مرة واحدة في قبو Dispatch. يتم تشفير القيمة داخل مخزن بيانات الاعتماد المشترك، ولا يحتفظ القبو نفسه إلا باسم المفتاح والتسمية والمنح، ولا يحتفظ أبدًا بنسخة نصية صريحة. بشكل افتراضي، يكون الوصول إلى المخزن **جميع التطبيقات**: كل مفتاح محفوظ متاح لكل تطبيق يشارك قاعدة بيانات Dispatch. ويمكن لمساحات العمل التي تحتاج إلى فصل أكثر صرامة تحويل المخزن إلى الوضع **اليدوي**، حيث تكون المنح الصريحة لكل تطبيق مطلوبة. يمكن لغير المسؤولين **طلب** سرًا لأحد التطبيقات؛ المشرفون **الموافقة**، مما يؤدي إلى إنشاء السر، وفي سير العمل اليدوي، المنحة. يتم تسجيل كل قراءة ومنح وتدوير في سجل التدقيق. وهذا ما يجعل "تدوير مفتاح OpenAI" عملية بنقرة واحدة عبر عشرة تطبيقات بدلاً من عشرة علاقات عامة.

### التفويض عبر التطبيقات

يكتشف Dispatch تلقائيًا التطبيقات الأخرى في مساحة العمل الخاصة بك كأقران A2A - بدون تسجيل يدوي، ولا يوجد تكوين لكل تطبيق. عندما يسأل المستخدم "تلخيص عمليات الاشتراك في الأسبوع الماضي" في Slack، تتعرف Dispatch على ذلك كطلب تحليلات وتستدعي تطبيق التحليلات عبر [A2A](/docs/a2a-protocol). عندما يطلبون "صياغة رد على أليس"، فإنه يوجه إلى تطبيق البريد. تقوم Dispatch بنشر الإجابة النهائية مرة أخرى في الموضوع الأصلي. توجد القاعدة السلوكية في تعليمات وكيل الإرسال: ينتمي عمل المجال إلى تطبيق المجال. ديسباتش هي المُنسقة وليست المتخصصة.

### بوابة MCP الموحدة

يمكن أن يكون Dispatch هو موصل MCP الفردي للوكلاء الخارجيين: قم بإضافة `https://dispatch.agent-native.com/mcp` مرة واحدة في Claude أو ChatGPT أو Codex أو Cursor، وسيصل تخويل واحد إلى كل تطبيق مساحة عمل ممنوح بدلاً من موصل واحد لكل تطبيق. راجع [External Agents](/docs/external-agents) للاطلاع على تدفق الاتصال الكامل ومنح التطبيقات وOAuth ومعاينات تطبيقات MCP المضمنة.

<Endpoint id="doc-block-11r2r6y" method="POST" path="/mcp" summary={"نقطة نهاية البوابة الموحدة MCP"} auth="Standard remote MCP OAuth, handled by the framework. The granted-app set scopes which workspace apps the connector can reach." responses={[
  {
    "status": "200",
    "description": "MCP JSON-RPC response — tools, resources, and MCP App UI resources aggregated across granted workspace apps."
  }
]}>

The single MCP connector URL external agents add (e.g. `https://dispatch.agent-native.com/mcp`). One authorization here reaches every **granted** workspace app instead of wiring one connector per app. App grants, OAuth, and inline MCP App previews are covered in [External Agents](/docs/external-agents).

</Endpoint>

### موارد مساحة العمل

يمكن تأليف Skills وتعليمات الدرابزين وملفات تعريف الوكيل والموارد المرجعية مرة واحدة في Dispatch ويتم توريثها بواسطة بقية مساحة العمل. الموارد ذات نطاق **جميع التطبيقات** عالمية: يقوم Dispatch بتخزينها مرة واحدة في نطاق مساحة العمل، ويقرأها كل وكيل تطبيق في وقت التشغيل. ولا يتم نسخها في كل تطبيق، ولا توجد خطوة يدوية لمزامنة موارد مساحة العمل. يمكن للموارد المشتركة للتطبيق والموارد الشخصية تجاوز الإعدادات الافتراضية لمساحة العمل أو تضييقها محليًا.

راجع [موارد الوكيل — Global resources](/docs/agent-resources#global-resources) للاطلاع على جدول المسار الأساسي وحزمة البداية ونموذج التجاوز.

تستخدم موارد الخادم MCP JSON وهي HTTP فقط عن قصد. قم بتخزين الرموز المميزة في
إرسال Vault ومنح هذه المفاتيح أو مزامنتها مع التطبيقات المستهدفة والإشارة إليها
من الرؤوس التي تحتوي على `${keys.NAME}`، وبالتالي لا توجد بيانات الاعتماد الأولية في
نص المصدر.

تسلط صفحة **الموارد** الضوء على حزمة البدء الموصى بها حتى يتمكن المسؤولون من معرفة الملفات الموجودة بسرعة، واستعادة ملفات البدء المفقودة دون استبدال الملفات الموجودة، وتحرير محتوياتها. قم بتوسيع أي مورد لمعاينة مكدس وقت التشغيل الفعال الخاص به لتطبيق/مستخدم محدد. تحتوي كل بطاقة تطبيق أيضًا على طريقة عرض **سياق** تعرض بالضبط ما يتلقاه هذا التطبيق.

### الأحلام

تقوم Dispatch Dreams بمراجعة عمليات التشغيل السابقة للوكيل، والتعليقات، والتقييمات، والإخفاقات المتكررة لاقتراح تحسينات دائمة. تقرير الأحلام هو عبارة عن سطح مراجعة، وليس إعادة كتابة صامتة: يمكنه اقتراح تحديثات للذاكرة الشخصية، أو تنظيف الذاكرة التي لا معنى لها، أو تعديلات `LEARNINGS.md` المشتركة، أو تعليمات مساحة العمل/المهارة/المعرفة/موارد الوكيل، أو المهام المتكررة، ويرتبط كل اقتراح بعمليات التشغيل التي تبرره. تتطلب التعليمات المشتركة والموارد على مستوى الفريق المراجعة قبل تطبيقها، خاصة عندما تأتي الأدلة من Slack أو البريد الإلكتروني أو Telegram أو WhatsApp أو محتوى الويب.

قبل اقتراح الكتابة، تقارن Dreams الأدلة بمؤشر الذاكرة الشخصية وملاحظات `memory/*.md` الموجودة و`LEARNINGS.md` المشتركة. إذا تم تسجيل الدرس بالفعل، فسيسجل التقرير أنه تم تخطيه؛ إذا كانت الذاكرة الشخصية ذات الصلة تبدو قديمة، فإن الاقتراح يستهدف تلك الملاحظة الموجودة بدلاً من إنشاء نسخة مكررة.

ابدأ من علامة التبويب **الأحلام** في Dispatch. قم بتشغيل تمرير يدوي أولاً، وافتح ورقة مراجعة الاقتراح لمقارنة الهدف الحالي بالمحتوى المقترح والأدلة المصدرية، ثم قم بتطبيق التغييرات التي تريد الاحتفاظ بها فقط. بمجرد أن تكون التقارير مفيدة باستمرار، يمكن لـ Dispatch إنشاء مهمة أحلام متكررة تستمر في إنتاج المقترحات دون التطبيق التلقائي للتغييرات المشتركة أو على مستوى التعليمات.

### تدفق الموافقة

يمكن لـ Dispatch إدخال التغييرات الحساسة في وقت التشغيل خلف مراجعة المشرف. يغطي هذا اليوم **الوجهات المحفوظة** (قنوات Slack وعناوين البريد الإلكتروني التي يمكن للوكيل إرسالها بشكل استباقي)، و**مقترحات الأحلام** المشتركة/الفريقية**، و**مورد مساحة العمل** لجميع التطبيقات** الذي ينشئ/يحدث/يحذف، و**سياسة الموافقة على الإرسال** نفسها. عند تمكين السياسة، يتم وضع التغيير في قائمة الانتظار ويظهر الوكيل معاينة موافقة مضمنة مباشرة في الدردشة - يوافق المسؤولون أو يرفضون دون مغادرة المحادثة.

## كيفية تدفق رسالة Slack عبر Dispatch {#flow}

تناول مثالًا واحدًا شاملاً. يقوم المستخدم بإرسال رسالة مباشرة إلى الروبوت: _"تلخيص عمليات الاشتراك في الأسبوع الماضي."_

1. **Slack → خطاف الويب.** Slack `POST` إلى `/_agent-native/integrations/slack/webhook` في تطبيق Dispatch. يتحقق المعالج من التوقيع و**يدرج صفًا في `integration_pending_tasks`**، ثم يطلق `POST` ذاتي الاستهداف إلى معالجه الخاص ويعيد `200` على الفور حتى لا يحاول Slack إعادة المحاولة.
2. **تنفيذ جديد للمعالج.** تعمل نقطة نهاية المعالج في تنفيذ وظيفة جديدة تمامًا مع انتهاء المهلة الكاملة الخاصة بها. فهو يطالب بالمهمة ذريًا ويبدأ حلقة الوكيل.
3. **يقرر وكيل الإرسال.** يقرأ الوكيل الرسالة، ويتعرف على "عمليات الاشتراك" باعتبارها هدفًا للتحليلات، ويستدعي `call-agent` مقابل [A2A endpoint](/docs/a2a-protocol) لتطبيق التحليلات. يتم تنفيذ عمل SQL الفعلي هناك.
4. **تم نشر الرد في سلسلة المحادثات.** يقوم وكيل التحليلات بإرجاع نتيجة. يقوم Dispatch بتنسيقه ونشره مرة أخرى في نفس سلسلة Slack التي كتبها المستخدم، باستخدام الهوية المرتبطة إذا كانت هناك واحدة (بحيث يتصرف الوكيل وفقًا لأذونات الطالب، وليس أذونات مالك مساحة العمل).
5. **الاسترداد في حالة وفاة أي شيء.** إذا تعطل المعالج في منتصف الرحلة - انتهاء مهلة A2A، أو خطأ في عامل المصب، أو تجميد الوظيفة - فإن مهمة إعادة المحاولة تمسح المهام العالقة كل 60 ثانية وتعيد تشغيل المعالج. ما يصل إلى ثلاث محاولات قبل أن يتم وضع علامة `failed` على المهمة.

<Diagram id="doc-block-13jtbce" title={"رسالة Slack عبر Dispatch"} summary={"يتم إدراج Slack في SQL، ويستنزفه تنفيذ جديد، ويقوم وكيل Dispatch بتفويض عمل المجال عبر A2A، ويعود الرد مرة أخرى إلى سلسلة المحادثات الأصلية. تعمل عملية إعادة المحاولة لمدة 60 ثانية على استعادة أي شيء يموت في منتصف الرحلة."}>

```html
<div class="dsp-flow">
  <div class="dsp-row">
    <div class="diagram-node">
      رسالة Slack مباشرة<br /><small class="diagram-muted"
        >"summarize last week's signups"</small
      >
    </div>
    <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
    <div class="diagram-box" data-rough>
      <strong>/slack/webhook</strong><br /><small class="diagram-muted"
        >تحقق + INSERT لمهمة معلقة</small
      >
    </div>
    <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
    <div class="diagram-pill ok">200</div>
  </div>
  <div class="dsp-row">
    <div class="diagram-box" data-rough>
      <strong>fresh processor</strong><br /><small class="diagram-muted"
        >استلام المهمة · بدء حلقة الوكيل</small
      >
    </div>
    <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
    <div class="diagram-panel center" data-rough>
      <span class="diagram-pill accent">وكيل Dispatch يقرر</span
      ><small class="diagram-muted">analytics intent &rarr; call-agent</small>
    </div>
  </div>
  <div class="dsp-row">
    <div class="diagram-box" data-rough>
      تطبيق التحليلات<br /><small class="diagram-muted"
        >نظير A2A · ينفذ عمل SQL</small
      >
    </div>
    <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
    <div class="diagram-pill ok">reply posted in thread</div>
  </div>
  <div class="diagram-panel dsp-retry" data-rough>
    <span class="diagram-pill warn">recovery</span>
    <span class="diagram-muted"
      >if the processor crashes &mdash; A2A timeout, downstream error, freeze
      &mdash; the 60s retry job re-fires it (&le;3 attempts) so the Slack reply
      still arrives</span
    >
    <span class="diagram-arrow diagram-muted" aria-hidden="true">&#8635;</span>
  </div>
</div>
```

```css
.dsp-flow {
  display: flex;
  flex-direction: column;
  gap: 12px;
}
.dsp-flow .dsp-row {
  display: flex;
  align-items: center;
  gap: 10px;
  flex-wrap: wrap;
}
.dsp-flow .center {
  display: flex;
  flex-direction: column;
  align-items: center;
  gap: 4px;
}
.dsp-flow .dsp-retry {
  display: flex;
  align-items: center;
  gap: 8px;
  flex-wrap: wrap;
}
```

</Diagram>

ينطبق نفس التدفق على البريد الإلكتروني، وTelegram، وWhatsApp - يتغير المحول فقط.

## قصة الموثوقية {#reliability}

تم تصميم المسار بالكامل ليظل موجودًا على كل مضيف بدون خادم (Netlify وVercel وCloudflare Workers) دون الاعتماد على عمليات API الخاصة بالتنفيذ في الخلفية الخاصة بالمنصة.

- **Webhook → قائمة انتظار SQL → معالج التنفيذ الجديد. ** لا تعمل حلقة الوكيل مطلقًا داخل معالج webhook. وظيفة المعالج الوحيدة هي التحقق من رقم 200 وإدراجه في قائمة الانتظار وإرجاعه. يؤدي التنفيذ الجديد المنفصل إلى استنزاف قائمة الانتظار، لذلك لا يمكن مطلقًا ربط تشغيل الوكيل البطيء بخطاف الويب الوارد أو التسبب في إعادة محاولة النظام الأساسي.
- **استقصاء استمرار A2A.** عندما يقوم Dispatch بتفويض تطبيق آخر، فإنه يستقصي المهمة النهائية بمهلة محددة. إذا استغرق وكيل المتلقي وقتًا طويلاً جدًا أو تعطل، فإن Dispatch يسجل الاستمرارية وتلتقطه مهمة إعادة المحاولة — ويظل رد Slack الخاص بالمستخدم يصل.
- **A2A عبر التطبيقات الموقعة تلقائيًا.** تعمل مساحات العمل المستضافة متعددة التطبيقات على إنشاء بيانات اعتماد A2A لكل تطبيق تلقائيًا في وقت النشر، بحيث يمكن للتطبيقات الموجودة في نفس مساحة العمل الاتصال ببعضها البعض دون لصق سر JWT على الإطلاق. تقرأ طبقة اكتشاف الوكيل في Dispatch تلك الاعتمادات من قاعدة بيانات مساحة العمل بحيث تظهر التطبيقات المضافة حديثًا كأقران قابلة للاستدعاء تلقائيًا.

## الإعداد {#setup}

ثلاث خطوات قصيرة:

1. **قم ببناء مساحة عمل تتضمن Dispatch.** قم بتشغيل `npx --yes @agent-native/core@latest create my-company-platform` واختر `dispatch` بجانب أي قوالب مجال تريدها. يوجد Dispatch في `apps/dispatch` وتوجد بقية التطبيقات بجانبه. انظر [Multi-App Workspace](/docs/multi-app-workspace).
2. **توصيل الرسائل.** افتح **الإدارة ← المراسلة** في الإرسال وانقر على اتصال بـ Slack أو البريد الإلكتروني أو Telegram أو WhatsApp. تتطابق حقول النموذج مع env vars في مستند [Messaging](/docs/messaging) — ارجع هناك لمعرفة ما تحتاجه كل منصة.
3. **إضافة تطبيقات أخرى.** قم بتشغيل `pnpm exec agent-native add-app` من جذر مساحة العمل لكل تطبيق مجال. تظهر تلقائيًا كأقران A2A في `list-workspace-apps` الخاصة بـ Dispatch - لا يوجد تسجيل يدوي، ولا تحرير بطاقة الوكيل. ستبدأ ديسباتش في التفويض إليهم بمجرد أن تصبح بطاقات الوكيل الخاصة بهم متاحة.

ثم أضف بيانات الاعتماد إلى المخزن وقم (اختياريًا) بتأليف موارد مساحة العمل العامة ضمن **الموارد**. لا يزال من الممكن مزامنة مفاتيح Vault أو منحها وفقًا لوضع الوصول؛ يتم توريث جميع موارد مساحة عمل التطبيق تلقائيًا. إذا كنت بحاجة إلى عزل سري لكل تطبيق، بدّل إعداد الوصول إلى المخزن إلى الوضع اليدوي قبل منح التطبيقات الفردية.

## انظر أيضًا {#see-also}

- [Dispatch template](/docs/template-dispatch) — التطبيق الفعلي المعزز، مع كتالوج الإجراءات الكامل ودليل الوكلاء
- [Messaging](/docs/messaging) — ربط Slack والبريد الإلكتروني وتيليجرام وواتساب
- [A2A Protocol](/docs/a2a-protocol) — كيفية عمل التفويض عبر التطبيقات تحت الغطاء
- [Multi-App Workspace](/docs/multi-app-workspace) — شكل النشر الذي تم تصميم Dispatch من أجله
- [Workspace Governance](/docs/workspace-management) — إدارة git/GitHub التي تقترن بإدارة وقت تشغيل Dispatch
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: 471kUpdated Claude CodeCodexVerifiedInstall
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: 198kUpdated Claude CodeCodexVerifiedInstall
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: 198kUpdated Claude CodeCodexUnverifiedInstall
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: 198kUpdated Claude CodeCodexVerifiedInstall