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/actions-agent-tools.mdx
View on GitHub---
title: "وصول الوكيل الإنتاجي"
description: "تحكّم في أدوات الإطار وقدرات تنفيذ الكود التي يملكها الوكيل الإنتاجي المُنشور، من خلال frameworkTools وcodeExecution."
---
# وصول الوكيل الإنتاجي
## أدوات الوكيل الإنتاجي {#production-agent-tools}
يحصل الوكلاء الإنتاجيون على الإجراءات المسجَّلة الخاصة بالتطبيق بالإضافة إلى
أدوات الإطار نفسه. يحدد `frameworkTools` أي من أدوات الإطار هذه يعرضها
هذا التطبيق. كل مجموعة تعتمد افتراضيًا سلوك اليوم، لذا حذف الخيار لا
يغيّر شيئًا:
```ts filename="server/plugins/agent-chat.ts"
export default createAgentChatPlugin({
frameworkTools: {
database: "read", // "write" | "read" | "off", default "read"
extensions: true, // default false
sharing: false, // this app has no share surface
review: false,
},
});
```
```ts filename="server/plugins/core-routes.ts"
export default createCoreRoutesPlugin({
extensionTools: true,
});
```
يقبل `database` و`extensions` نفس القيم التي كانت تقبلها الأعلام القديمة على المستوى الأعلى:
- `database: "read"`. الافتراضي. يسجّل فقط `db-schema` و`db-query`.
يفحص الوكلاء البيانات باستخدام SQL ولكن يجب أن يستخدموا إجراءات التطبيق
المُكتوبة للكتابة.
- `database: "write"` أو `true`. يسجّل بالإضافة إلى ذلك `db-exec` و
`db-patch` لصيانة SQL خام متعمَّدة. الكتابات مقيَّدة بالمستخدم/المؤسسة
الحالية وتغييرات المخطط محظورة.
- `database: "off"` أو `false`. يزيل أدوات قاعدة البيانات الخام من
سطح الوكيل بحيث تكون إجراءات التطبيق هي مسار الوصول الوحيد للبيانات.
- `extensions: true`. يُدخل التطبيق في إجراءات إدارة الإضافات الخاصة
بالإطار وتوجيهات المطالبة (`create-extension`، و`update-extension`، وما إلى ذلك).
اضبط `extensionTools: true` على إضافة core-routes أيضًا للسماح
بإنشاء REST مصادَق عليه. الإضافات مُعطَّلة افتراضيًا.
المجموعات المتبقية هي قيم منطقية، جميعها مُفعَّلة افتراضيًا: `sharing`، و`review`،
و`history`، و`featureFlags`، و`localization`، و`audit`، و`contextXray`،
و`userProfile`، و`automation`، و`docs`، و`resources`، و`browserSessions`،
و`web`، و`workspaceApps`،
و`chat`، و`email`. استخدم `frameworkTools: "minimal"` لإيقاف كل مجموعة دفعة
واحدة لتطبيق صوتي أولاً أو أحادي الغرض، أو
`frameworkTools: { preset: "minimal", resources: true }` للاحتفاظ بواحدة فقط. مفتاح
مجموعة صريح يفوز دائمًا على الإعداد المسبق.
يؤدي إيقاف مجموعة إلى إزالتها من أسطح **الوكيل** فقط: الدردشة التفاعلية،
وMCP، وA2A، والتشغيلات في الخلفية. تبقى مسارات إجراءات HTTP المطابقة
مُثبَّتة، لأن الواجهة تصل إليها من خلال خطافات العميل. تعطيل `sharing`
يجب ألا يُرجع 404 لمربع حوار مشاركة لا يزال على الشاشة. زِن تكلفة
التكافؤ هذه قبل استخدامه: عقد الإطار هو أن أي شيء يمكن للواجهة فعله
يمكن للوكيل فعله، لذا فإن `sharing: false` بجانب زر مشاركة مرئي هو
كسر متعمَّد، ولا يكون منطقيًا إلا عندما لا يملك التطبيق مثل هذا السطح
على الإطلاق.
لم تعد أدوات الإطار تُرقَّى إلى طلب النموذج الأول افتراضيًا، بغضّ النظر
عن هذا الخيار. تبقى في السجل القابل للبحث وتُحمَّل من خلال `tool-search`،
أو فورًا إذا سمّاها التطبيق في `initialToolNames`.
<Callout tone="warning">
الخياران `databaseTools` و`extensionTools` على المستوى الأعلى مهجوران لصالح
`frameworkTools.database` و`frameworkTools.extensions`. لا يزالان مدعومين،
ولكن ضبط علم على المستوى الأعلى ومكافئه في `frameworkTools` على قيم متعارضة
يرمي خطأً عند بدء تشغيل الإضافة بدلاً من الإقلاع بسطح أدوات لم يختره أحد.
</Callout>
## تنفيذ الكود الإنتاجي {#production-code-execution}
افتراضيًا، يعمل الوكلاء الإنتاجيون بدون أدوات تنفيذ الكود. يمكنهم استدعاء إجراءات التطبيق، وأدوات قاعدة البيانات، وأدوات MCP، وأدوات المتصفح/الجلسة، وأدوات الإطار المسجَّلة الأخرى، ولكنهم لا يحصلون على وصول إلى الصدفة أو نظام الملفات.
يمكن لعمليات النشر المتوافقة مع Node الانضمام إلى تنفيذ الكود الإنتاجي من خلال إضافة دردشة الوكيل أو تجاوز بيئة:
```ts filename="server/plugins/agent-chat.ts"
export default createAgentChatPlugin({
codeExecution: { production: "sandboxed" },
});
```
الأوضاع المتاحة هي:
- `off`. الافتراضي. لا تُسجَّل أدوات تنفيذ كود في الإنتاج.
- `sandboxed`. يسجّل `run-code`، وهو مقيّم QuickJS مُعزَّز بحدود للذاكرة والمكدس والمصدر والنتيجة والمخرجات، ووظائف مضيفة تصل إلى الأدوات المسجَّلة المسموح بها مثل `provider-api-request` و`provider-api-docs` و`provider-api-catalog` و`web-request` وجسر ملفات مساحة العمل المستخدَم بواسطة `workspaceRead` / `workspaceWrite`. لا تتوفر وحدات Node.js أو نظام الملفات أو متغيرات البيئة أو الشبكة أو المؤقتات أو imports لكود الضيف.
- `trusted`. يسجّل `run-code` بالإضافة إلى سجل أدوات الترميز الكامل (`bash`، و`read`، و`edit`، و`write`). استخدم هذا فقط لعمليات النشر أحادية المستأجر أو التي يتحكم فيها المشغّل حيث يكون الوصول الكامل للصدفة إلى المضيف متعمَّدًا.
اضبط `AGENT_PROD_CODE_EXECUTION=sandboxed` أو `AGENT_PROD_CODE_EXECUTION=trusted` لتجاوز خيار الإضافة لعملية نشر محددة دون تغيير في الكود. يفرض `AGENT_PROD_CODE_EXECUTION=off` إيقاف تنفيذ الكود حتى عندما يُفعِّله خيار الإضافة.
يستخدم مقيّم `run-code` في الإنتاج QuickJS مُعزَّزًا بدلًا من عملية Node فرعية. وهو ليس حاوية نظام تشغيل؛ تظل الوظائف المضيفة قدرات موثوقة وتفرض المصادقة والتفويض، بينما يحد المقيّم موارد كود الضيف واستدعاءات الجسر.
## ما هي الخطوة التالية
- [**الإجراءات: الوصول والتفويض**](/docs/actions-access-control) — محاور التحكم في الوصول لكل إجراء التي يكملها التحكم على مستوى الأداة في هذه الصفحة
- [**تحديث الواجهة في الإنتاج**](/docs/updating-ui-in-production) — ما يمكن للوكيل المُنشور تحريره وما لا يمكنه مع ترك تنفيذ الكود مُعطَّلًا
- [**النشر: متغيرات البيئة**](/docs/deployment-environment-variables) — `AGENT_PROD_CODE_EXECUTION` ومتغيرات بيئة الإنتاج الأخرى
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 |