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/durable-resume.mdx

View on GitHub
---
title: "سيرة ذاتية متينة"
description: "عند مقاطعة تشغيل الوكيل المستضاف واستئنافه في الدورة نفسها، يحظر دفتر يومية استدعاء الأدوات المشتق من دفتر الأستاذ المتين التكرارات المطابقة تمامًا لاستدعاءات الكتابة التي اكتملت بالفعل."
---

# سيرة ذاتية متينة

> **لمن هذا:** أي شخص يريد فهم كيفية تشغيل إطار العمل
> الآثار الجانبية المكررة. هذا سلوك مدمج — يوجد
> لا يوجد شيء يمكن توصيله.

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

السيرة الذاتية الدائمة تسد هذه الفجوة. عند الاستئناف، يعرف إطار العمل استدعاءات أدوات التأثير الجانبي التي تم إكمالها بالفعل ويرفض إعادة تشغيلها — على طبقتين.

<Diagram id="doc-block-1asu7x4" title={"طبقتان تمنعان الآثار الجانبية المكررة في السيرة الذاتية"} summary={"تقرأ المجلة دفتر الأستاذ المتين وتصنف المكالمات السابقة؛ تخبر الطبقة الأولى النموذج، بينما تمنع الطبقة الثانية بشدة الكتابة المعاد إرسالها والتي تطابق الإدخال المكتمل."}>

```html
<div class="diagram-durable">
  <div class="diagram-box" data-rough>
    Run-event ledger<br /><small class="diagram-muted"
      >tool_start / tool_done</small
    >
  </div>
  <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
  <div class="diagram-panel center" data-rough>
    <strong>Tool-call journal</strong
    ><small class="diagram-ok">completed = start+done</small
    ><small class="diagram-warn">interrupted = start, no done</small>
  </div>
  <div class="diagram-col">
    <div class="diagram-pill">Layer 1 · prompt note &rarr; model</div>
    <div class="diagram-pill accent">
      الطبقة 2 · كتابة معاد إرسالها بحظر صارم
    </div>
  </div>
</div>
```

```css
.diagram-durable {
  display: flex;
  align-items: center;
  gap: 14px;
  flex-wrap: wrap;
}
.diagram-durable .diagram-col {
  display: flex;
  flex-direction: column;
  gap: 8px;
}
.diagram-durable .diagram-arrow {
  font-size: 22px;
  line-height: 1;
}
.diagram-durable .center {
  display: flex;
  flex-direction: column;
  align-items: center;
  gap: 4px;
}
```

</Diagram>

## سجل استدعاء الأداة {#journal}

إن دفتر اليومية عبارة عن **قراءة خالصة عبر دفتر الأستاذ المتين لحدث التشغيل** — ولا يوجد رابط تسجيل جديد في المسار السريع. يقوم بتصنيف استدعاءات الأداة المسجلة بالفعل للدورة الحالية:

- **مكتمل** — `tool_start` مع `tool_done` المطابق. تم إجراء المكالمة وحدث أثرها الجانبي وتم تسجيل نتيجتها. **لا تقم بإعادة التشغيل.**
- **تمت المقاطعة** — `tool_start` مع **لا** يطابق `tool_done`. بدأت المكالمة، وقد يكون أثرها الجانبي قد وصل أو لا، وقد أكل الانقطاع النتيجة. النتيجة غير معروفة.

تعكس المطابقة كيفية إعادة بناء المنعطفات المتينة في مكان آخر: زوج `tool_done` مع أقدم `tool_start` الذي لا يزال مفتوحًا لنفس اسم الأداة (FIFO لكل أداة). يقوم حدث `clear` (المخرجات الجزئية المهملة) بإعادة تعيين رصيد كل دورة بحيث لا تترك الأجزاء المهجورة مكالمات وهمية مفتوحة.

## الطبقة 1: مذكرة يومية على مستوى المطالبة {#prompt-note}

عند استئناف التشغيل (مهلة بسيطة، أو مهلة بوابة، أو أي خطأ نقل قابل للاستئناف)، يُلحق إطار العمل **ملاحظة يومية منظمة** بمطالبة الاستئناف، مباشرةً بعد تنبيه "المتابعة من حيث توقفت". توضح الملاحظة النموذج بنص عادي:

- الأداة التي تستدعي **مكتملة بالفعل** (مع نتائج قصيرة) لذلك تعيد استخدامها و **لا** تعيد تشغيلها، و
- استدعاءات الأداة **التي تمت مقاطعتها بنتيجة غير معروفة** لذا فهي تتحقق من الحالة قبل افتراض النجاح أو الفشل.

عندما تكون المجلة فارغة (دورة بدون نشاط أداة، أو متابعة نظيفة)، لا يتم إلحاق أي شيء إضافي ويصبح سلوك السيرة الذاتية بايتًا مقابل بايت كما كان من قبل. لكن المجلة نفسها مطلوبة: إذا تعذّرت قراءة دفتر الأستاذ حتى بعد إعادة محاولة واحدة، يتوقف التشغيل المُستأنَف قبل أن يعمل النموذج، مع `tool_call_journal_unreadable`، ويطلب منك إرسال الطلب مرة أخرى. فمن دون دفتر الأستاذ لا يمكنه معرفة الخطوات التي اكتملت بالفعل.

## الطبقة الثانية: الكتلة الصلبة لطبقة الأدوات {#hard-block}

الملاحظة الفورية تعتبر استشارية - فالنموذج حسن التصرف يستجيب لها، ولكن النموذج ليس ضمانًا. لذا فإن الحلقة تفرضها أيضًا على طبقة الأداة.

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

الخصائص الرئيسية:

- **أدوات الكتابة فقط.** للقراءة فقط (`readOnly` / GET) لا يتم حظر actions أبدًا — إعادة القراءة آمنة وغير فعالة.
- **المحتوى المعنون.** المطابقة موجودة على اسم الأداة + توقيع الإدخال، لذا فإن المكالمة المستأنفة الموجودة في موضع مختلف في الدور لا تزال متطابقة؛ يتم التعامل مع مكالمة _different_ (وسيطات مختلفة) على أنها جديدة وتعمل بشكل طبيعي.
- **يستهلك مرة واحدة.** تتم المطالبة بكل إدخال مكتمل عند مطابقته، لذلك لا تؤدي مكالمتان جديدتان متطابقتان ومتميزتان بالفعل في نفس المنعطف إلى حدوث ماس كهربائي عند إكمال سجل واحد.
- **المكالمات الجديدة لم يتم لمسها.** تظهر مكالمة الدور الأول في دفتر يومية فارغ؛ لا شيء يتغير بالنسبة للتشغيل العادي.

<Callout id="doc-block-fjhhyg" tone="warning">

لا يوقف الحظر الصارم إلا **التكرار المطابق تمامًا**: أداة الكتابة نفسها بالمدخلات نفسها، بعد أن تكون محاولة سابقة في الدورة نفسها قد انتهت وسجّلت نتيجتها. وهو لا يستبعد كل بريد إلكتروني أو عملية دفع أو تذكرة مكررة:

- **لا تُطابَق إعادة المحاولة المُعاد صياغتها.** إذا غيّر النموذج أي وسيطة، مثل نص البريد الإلكتروني، فلن يعود الاستدعاء مطابقًا لاستدعاء مكتمل، فلا يوقفه الحظر الصارم.
- **لا يُمنع التكرار بعد تعطل في منتصف الإرسال إلا لبقية الدورة.** إذا توقفت العملية فجأة بعد وقوع الأثر الجانبي ولكن قبل تسجيل نتيجته، يُعَدّ الاستدعاء مُقاطَعًا، ولا يشمل الحظر الصارم إلا الاستدعاءات المكتملة. وبدلًا من ذلك، يحجب التشغيل المُستأنَف أداة الكتابة تلك، كما يوضح قسم [عمليات الكتابة ذات النتيجة غير المعروفة](#unknown-outcome). أما الرسالة الجديدة فتبدأ دورة جديدة لا يحجبها فيها شيء.
- **يمكن استئناف التشغيل المتعطل في الدورة نفسها عبر مسارين منفصلين.** الأول هو [تشغيل دائم في الخلفية](/docs/durable-background-runs). والثاني جزء لاحق من دورة عادية في المقدمة تستخدم [السلسلة الذاتية في المقدمة](/docs/durable-background-runs#foreground-self-chain). أما أي تشغيل متعطل آخر فينتهي بخطأ. واختيار **متابعة** عليه يستأنف الدورة نفسها، فتنطبق الطبقتان.

أي إجراء يجب ألا يتكرر أثره الجانبي أبدًا يحتاج إلى تحقق خاص به من عدم التكرار. ولا ينطبق الحظر الصارم أبدًا على الإجراءات المخصصة للقراءة فقط.

</Callout>

## عمليات الكتابة ذات النتيجة غير المعروفة {#unknown-outcome}

تكون نتيجة عملية الكتابة غير معروفة عندما تبدأ دون أن تُسجَّل لها نتيجة، أو عندما تنتهي مهلتها، أو عندما تفشل بعد أن تبدأ الكتابة دون أن تذكر ما إذا كان أي شيء قد حُفظ. قد تؤدي إعادة تشغيلها إلى تطبيق التغيير مرتين، لذلك تحجب الحلقة تلك الأداة لبقية الدورة:

- **الاستدعاء نفسه مرة أخرى.** إذا كرّر النموذج الاستدعاء بالوسيطات نفسها، تتحقق الحلقة أولًا مما إذا كانت النتيجة الخاصة بذلك الاستدعاء قد سُجّلت في النهاية، وتعيدها إن كانت كذلك. وإلا فلا يُنفَّذ الاستدعاء: يتوقف التشغيل مع `write_tool_outcome_unknown` ويطلب منك التحقق مما حُفظ، ثم الرد بكلمة "متابعة".
- **أي استدعاء آخر لتلك الأداة.** لا يُنفَّذ أيضًا استدعاء بوسيطات مختلفة، مثل بريد إلكتروني أُعيدت صياغته. ويُبلَّغ النموذج بأن الاستدعاء السابق ربما طُبِّق بالفعل، وبأن عليه التحقق من الحالة الحالية بعملية قراءة وإخبارك بما وجده. وتستمر الدورة، إلا إذا تعذّر تحديد الاستدعاء السابق لأنه لم يسجّل وسيطات يمكن المقارنة بها أو لأنه غائب عن السجل المُعاد تشغيله. عندها قد يكون أي استدعاء لتلك الأداة تكرارًا، فيوقف التشغيل كما يفعل الاستدعاء نفسه.

يُستثنى الإجراء المُعلَّم بـ `retrySafe`، لأن تشغيله مرة أخرى لا يمكن أن يكرر البيانات أو يفسدها: فهو يتحقق قبل أن يكتب، أو يضبط حالة نهائية، مثل استبدال سجل بمعرّفه. ويمكن للنموذج تصحيح وسيطاته والمحاولة مرة أخرى. ولا تُحجب الإجراءات المخصصة للقراءة فقط إلا إذا جرت عملية كتابة داخل أحدها.

## المتابعة التلقائية بعد حد زمني {#auto-continue}

عندما يوقف الخادم دورة عند حد وقت التشغيل ولا يتولاها شيء على جانب الخادم، تتابعها المحادثة من تلقاء نفسها ضمن **الدورة نفسها**. يحصل التشغيل المستأنف على استدعاءات الأدوات ونتائجها في المحادثة، إضافة إلى ملاحظة السجل أعلاه، فتُعاد الاستفادة من الخطوات المكتملة، ويُعيد التكرار المطابق لعملية كتابة — بما في ذلك تفويض `call-agent` بين التطبيقات الذي يُشتق مفتاح عدم التكرار فيه من الدورة — النتيجة المسجلة بدلًا من إرساله مرة أخرى. تعرض المحادثة حالة _جارٍ الاستئناف_، ويظل زر الإيقاف يعمل.

تُتابَع الدورة تلقائيًا **ثلاث مرات كحد أقصى**. يُحفظ العدد مع تشغيلات الدورة، لذلك لا تعيده إعادة تحميل الصفحة إلى الصفر، ولا يمكن لعلامة تبويب ثانية مضاعفته. بعد ذلك، أو بعد أي خطأ أو إيقاف أو إلغاء أو حد لبيانات الاعتماد أو للمعدل، تنتهي الدورة مع إتاحة **متابعة** وتنتظرك.

يؤدي اختيار **متابعة** إلى استئناف دورة التشغيل المتوقف نفسها بالطريقة ذاتها، دون حد لعدد المرات، فتنطبق عليه الطبقتان كما تنطبقان على المتابعة التلقائية. ولا يُعرض إلا لآخر توقف في المحادثة. وإذا أرسلت رسالة جديدة بدلًا من ذلك، يُخبَر الوكيل أولًا بما أنجزته الدورة غير المكتملة، لكن لا تمنع أي من الطبقتين التكرار.

## ذات صلة

- [**Real-Time Sync**](/docs/real-time-collaboration) — كيفية تدفق دفتر الأستاذ للتشغيل الدائم إلى العميل وإعادة تشغيله عند إعادة الاتصال.
- [**Actions**](/docs/actions-overview) - تشير علامات `readOnly` إلى أنها آمنة لإعادة التشغيل؛ يتم التعامل مع كل شيء آخر على أنه آثار جانبية.
- [**In-Loop Processors**](/docs/processors) — وصلة تقوية داخلية أخرى.
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: 472kUpdated 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