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/deployment-environment-variables.mdx

View on GitHub
---
title: "النشر: متغيرات البيئة"
description: "مرجع متغيرات بيئة الإنتاج للبناء وزمن التشغيل والأسرار وسلوك الاستضافة."
---

# النشر: متغيرات البيئة

للحصول على المرجع الشامل للمستودع بأكمله، بما في ذلك متغيرات القالب والمزود والمحلي والتكامل المستمر (CI)، راجع [متغيرات البيئة](/docs/environment-variables). تظل الجداول
أدناه الدليل المرجعي لقيم الإنتاج وسلوك الاستضافة.

## البناء / وقت التشغيل {#env-runtime}

| المتغير                                     | الوصف                                                                                                                                                                                                                                                                                                                                                                                         |
| ------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `PORT`                                      | منفذ الخادم (Node.js فقط)                                                                                                                                                                                                                                                                                                                                                                     |
| `NITRO_PRESET`                              | تجاوز الإعداد المسبق للبناء وقت البناء                                                                                                                                                                                                                                                                                                                                                        |
| `APP_BASE_PATH`                             | ثبّت التطبيق تحت بادئة (مثل `/mail`). يُضبط تلقائيًا بواسطة `npx @agent-native/core@latest deploy`. اتركه غير مضبوط للنشر المستقل.                                                                                                                                                                                                                                                            |
| `APP_URL`                                   | مصدر عام أساسي اختياري. يُفحص قبل `BETTER_AUTH_URL` عند تحليل جمهور A2A JWT، ومصدر OAuth العام، وأهداف webhook للإرسال الذاتي، وروابط الموارد المُولَّدة. اضبطه صراحةً في عمليات نشر المعاينة/التجهيز حيث لا يمكن الاعتماد على مضيف الطلب.                                                                                                                                                    |
| `AGENT_PROD_CODE_EXECUTION`                 | وضع تنفيذ كود إنتاجي اختياري: `off` (افتراضي)، أو `sandboxed`، أو `trusted`. راجع [تنفيذ الكود في الإنتاج](/docs/actions-agent-tools#production-code-execution).                                                                                                                                                                                                                              |
| `AGENT_NATIVE_SSR_CACHE`                    | سياسة التخزين المؤقت لواجهة SSR على مستوى النشر بأكمله: غير مضبوطة/`on` تُبقي التخزين المؤقت الصارم الافتراضي، و`off` ترسل `no-store`، أو مدة زمنية مثل `30s` / `5m` تضبط نضارة أقصر. راجع [التخزين المؤقت SSR](/docs/ssr-caching).                                                                                                                                                           |
| `AGENT_NATIVE_HEAD_SCRIPT_SRC`              | عنوان HTTPS اختياري لسكربت يُضاف إلى `<head>` في كل صفحة تُعرض على الخادم. حيث يظهر شريط الموافقة على ملفات تعريف الارتباط، ينتظر موافقة التحليلات، مثل Google Analytics. استخدمه لأدوات خاصة بالنشر مثل أداة ملاحظات داخلية دون تعديل شيفرة التطبيق. تفشل عناوين غير HTTPS في التحقق من الإعدادات.                                                                                           |
| `AGENT_NATIVE_ENABLE_KEEP_WARM`             | انضم إلى دالة الإبقاء دافئًا المجدولة لـ Netlify. غير مضبوط افتراضيًا. راجع [الإبقاء دافئًا](/docs/netlify#netlify-keep-warm).                                                                                                                                                                                                                                                                |
| `AGENT_NATIVE_DISABLE_KEEP_WARM`            | مفتاح إيقاف للتوافق لدالة الإبقاء دافئًا المجدولة لـ Netlify. راجع [الإبقاء دافئًا](/docs/netlify#netlify-keep-warm).                                                                                                                                                                                                                                                                         |
| `AGENT_NATIVE_KEEP_WARM_SCHEDULE`           | تجاوز وتيرة الإبقاء دافئًا بتعبير cron مكون من 5 حقول (الافتراضي `* * * * *` عند التمكين). القيمة التي يتعذر تحليلها تُفشل البناء. راجع [الإبقاء دافئًا](/docs/netlify#netlify-keep-warm).                                                                                                                                                                                                    |
| `AGENT_NATIVE_DISABLE_KEEP_WARM_BACKGROUND` | أسقط دفء دالة الخلفية فقط وأبقِ الخادم دافئًا. راجع [الإبقاء دافئًا](/docs/netlify#netlify-keep-warm).                                                                                                                                                                                                                                                                                        |
| `AGENT_NATIVE_KEEP_WARM_CONCURRENCY`        | مساحات العمل متعددة التطبيقات فقط: مثيلات الخادم التي يبقيها كل تطبيق دافئة (1-50، الافتراضي 1). راجع [Keep-warm](/docs/netlify#netlify-workspace-keep-warm).                                                                                                                                                                                                                                 |
| `AGENT_NATIVE_DISABLE_INPROCESS_SWEEPS`     | أوقف مؤقتات المسح الاحتياطية داخل العملية (إعادة إرسال الأتمتة، ومصالحة فرق الوكلاء، واستعادة تنفيذ الصندوق المعزول). على serverless، تعمل هذه لكل حاوية دافئة، لذا يتوسع معدل استعلامها مع عدد المثيلات. اضبطه **فقط** حيث يقود جدولة دائمة بالفعل نفس الاستعادة، وإلا لن تتم إعادة محاولة العمل المُصفَّف.                                                                                  |
| `CRON_SECRET`                               | Vercel فقط. يرسله Vercel كرمز bearer في طلبات cron، وترفض عملية المسح المجدولة أي طلب لا يتضمنه، لذا لا تعمل الأتمتة المجدولة وأتمتة الأحداث المنتظرة في قائمة الانتظار على Vercel أبدًا حتى يتم ضبطه. راجع [العمل المجدول](/docs/vercel#vercel-scheduled-work).                                                                                                                              |
| `AGENT_NATIVE_VERCEL_CRON_SCHEDULE`         | وتيرة مهمة cron الخاصة بعملية مسح Vercel وقت البناء، بتعبير cron مكون من 5 حقول (الافتراضي `* * * * *`). يجب على مشاريع Hobby ضبط تعبير يومي مثل `0 9 * * *`. القيمة التي يتعذر تحليلها تُفشل البناء. راجع [العمل المجدول](/docs/vercel#vercel-scheduled-work).                                                                                                                               |
| `AGENT_NATIVE_SKIP_ENSURE_TABLES`           | تخطَّ DDL المخطط عند الطلب في عمليات النشر التي لا يغطيها التخطي التلقائي لـ serverless. يتطلب أن يكون مخططك مُهاجَرًا بالفعل. راجع [DDL المخطط عند الطلب](/docs/deployment#skip-ensure-tables).                                                                                                                                                                                              |
| `AGENT_NATIVE_BUILDER_RELAY_SECRET`         | سر HMAC مشترك مخصص لا يقل عن 32 حرفًا لترحيل تفويض Builder الآمن للمعاينة. اضبط نفس القيمة في عملية النشر المؤسسية المعتمدة لرد الاتصال وعمليات نشر المعاينة فقط عندما يجب أن يهبط التفويض في قاعدة بيانات معاينة معزولة.                                                                                                                                                                     |
| `AGENT_NATIVE_BUILDER_RELAY_TARGET_ORIGINS` | قائمة سماح مفصولة بفواصل خاصة برد اتصال المؤسسة فقط لمصادر معاينة موثوقة دقيقة (على سبيل المثال، `https://0123456789abcdef01234567--content.netlify.app`). اضبطها فقط في عملية نشر رد الاتصال المؤسسي. يجب أن تستخدم مصادر Netlify رابطًا دائمًا سداسي عشري ثابتًا خاصًا بالنشر مكونًا من 24 حرفًا. تُرفض أسماء مستعارة `deploy-preview-*` القابلة للتغيير، والأحرف البديلة، ولواحق النطاقات. |

توجد متغيرات اتصال قاعدة البيانات (`DATABASE_URL` و`<APP_NAME>_DATABASE_URL` لكل تطبيق) في [قاعدة البيانات](/docs/server-database#production).

## التكوين الحساس للإنتاج {#env-required-prod}

تغطي هذه الإعدادات السلوك الحساس للإنتاج. يحتاج تطبيق مستقل يستخدم
مصادقة الإطار إلى `BETTER_AUTH_SECRET` ثابت وقاعدة بيانات دائمة.
يُستنتج عنوان URL العام للمصادقة من الطلب، أو القالب المعروف، أو منصة
الاستضافة عندما يكون غير مضبوط. إعدادات مساحة العمل وA2A مشروطة بتلك
الميزات. القيم المفقودة إما تفشل بشكل مغلق أو تعود إلى سلوك أضعف
مع تحذير واضح.

| المتغير                                     | الوصف                                                                                                                                                                                                                                                                                                                                                                      |
| ------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `BETTER_AUTH_SECRET`                        | سلسلة عشوائية لا تقل عن 32 حرفًا. توقّع ملفات تعريف ارتباط الجلسة وهي الاحتياطي لـ `OAUTH_STATE_SECRET` والقيم المشفَّرة المحلية للتطبيق. إنها أيضًا مرشح قراءة قديم لنص خزنة مشتركة مشفَّر موجود بالفعل. مطلوبة بشدة: يرمي الإطار خطأً عند بدء التشغيل إذا كانت مفقودة في الإنتاج.                                                                                        |
| `BETTER_AUTH_URL`                           | تجاوز اختياري لعنوان URL العام لهذا التطبيق (مثل `https://mail.example.com`). يستنتجه الإطار من الطلب، والقالب المعروف، وسياق منصة الاستضافة عندما يكون غير مضبوط.                                                                                                                                                                                                         |
| `ANTHROPIC_API_KEY`                         | مفتاح API للوكيل المضمّن. تستخدم التطبيقات المستضافة ذاتيًا مفاتيح مزوّد LLM المنشورة كبديل مشترك على مستوى التطبيق، بما في ذلك مع قواعد البيانات البعيدة. يمكن للمستخدم المسجّل الدخول دون مفتاح محدد النطاق استخدام حساب النشر عبر المؤسسات، وتُحتسب التكلفة على ذلك الحساب. تمنع بيئات Hosted workspace الإنتاجية هذا البديل.                                           |
| `OAUTH_STATE_SECRET`                        | مفتاح HMAC مخصص لأظرف حالة OAuth (Google، وAtlassian، وZoom). يعود إلى `BETTER_AUTH_SECRET` عندما يكون غير مضبوط، ولكن يُوصى بقيمة مخصصة حتى لا يُبطل تدوير أحدهما الآخر. أنشئه عبر `openssl rand -hex 32`.                                                                                                                                                                |
| `A2A_SECRET`                                | HMAC مشترك لـ JSON-RPC الخاص بـ A2A بين التطبيقات وعمليات التسليم الموقَّعة في الخلفية. مطلوب لعمليات نشر مساحة العمل المستضافة وميزات A2A. بدونه، تفشل تلك النقاط النهائية بشكل مغلق في الإنتاج. عندما لا يكون هناك مفتاح خزنة مساحة عمل مخصص مضبوط، يستخدم نص الخزنة المشترك المشفَّر مفتاحًا مشتقًا من الغرض من هذه القيمة، لذا فإن تدويرها يُدوِّر أيضًا مفتاح الخزنة. |
| `WORKSPACE_SECRETS_ENCRYPTION_KEY`          | مفتاح AES-256-GCM ثابت مفضَّل لخزنة الأسرار المشفَّرة عند الراحة المشتركة. اضبط نفس القيمة في كل تطبيق يقرأ الخزنة. إنه منفصل عن تشفير OAuth/بيانات الاعتماد المحلي للتطبيق، لذا يمكن لثقة A2A أن تدور دون ترك صفوف الخزنة معزولة. يتم ترحيل نص A2A، وBetter Auth، ومفتاح التطبيق المشفَّر الموجود بالفعل عند القراءات الناجحة.                                            |
| `WORKSPACE_SECRETS_ENCRYPTION_KEY_PREVIOUS` | مفتاح خزنة مساحة عمل سابق اختياري يُستخدم فقط أثناء نافذة التدوير. انشره جنبًا إلى جنب مع `WORKSPACE_SECRETS_ENCRYPTION_KEY` الجديد، ودع القراءات الناجحة تعيد تشفير الصفوف، ثم أزله بعد الترحيل.                                                                                                                                                                          |
| `SECRETS_ENCRYPTION_KEY`                    | مفتاح مدمج قديم للتشفير المحلي للتطبيق والخزنة المشتركة. يظل مدعومًا، ولكن يجب أن تستخدم عمليات النشر الجديدة متعددة التطبيقات `WORKSPACE_SECRETS_ENCRYPTION_KEY` للخزنة المشتركة حتى لا يؤدي تغيير تشفير مساحة العمل إلى تغيير نص OAuth المحلي المشفَّر للتطبيق.                                                                                                          |

## المصادقة والهوية {#env-auth}

بيانات اعتماد مزود OAuth (Google، وGitHub)، واحتياطيات bearer الثابتة لـ MCP (`ACCESS_TOKEN` / `ACCESS_TOKENS`)، ومفاتيح تبديل التحقق من البريد الإلكتروني موثَّقة في [المصادقة](/docs/authentication). اضبطها هناك وفقًا لوضع المصادقة الذي تختاره.

## Webhooks الواردة {#env-webhooks}

يتطلب كل تكامل مراسلة سر توقيع خاصًا به في الإنتاج (تفشل المعالجات بشكل مغلق عند الطلبات المزوَّرة عندما يكون السر مفقودًا). المتغيرات الخاصة بكل تكامل مدرجة في [المراسلة](/docs/messaging) و[الأمان](/docs/security). للتطوير المحلي فقط، يعيد `AGENT_NATIVE_ALLOW_UNVERIFIED_WEBHOOKS=1` الانضمام إلى "التحذير والقبول". لا تضبطه أبدًا في الإنتاج.

## تكوين الأمان (اختياري) {#security-config}

الإعدادات الافتراضية صارمة. حفنة من الأعلام الاختيارية تُخفف السلوك (تتبعات المكدس التصحيحية، وwebhooks غير المتحقق منها، واحتياطي المفتاح على مستوى مساحة العمل، ومحول MCP الحُبّي متعدد المؤسسات، وكتابات متغير البيئة وقت التشغيل). موثَّقة مع مقايضاتها الأمنية في [الأمان](/docs/security). لا تضبطها إلا إذا كنت تريد تحديدًا المسار المُخفَّف.

## وراثة .env لمساحة العمل {#env-inheritance}

داخل مساحة عمل، يُحمَّل ملف `.env` الجذر تلقائيًا في كل تطبيق، لذا فإن المفاتيح المشتركة مثل `ANTHROPIC_API_KEY`، و`A2A_SECRET`، و`BETTER_AUTH_SECRET`، و`OAUTH_STATE_SECRET` تحتاج إلى الضبط مرة واحدة فقط. يفوز `apps/<name>/.env` الخاص بكل تطبيق عند التعارض.

## إنشاء أسرار قوية {#env-generate-secrets}

بالنسبة لأي سر معلَّم بـ "عشوائي لا يقل عن 32 حرفًا" (`BETTER_AUTH_SECRET`، و`OAUTH_STATE_SECRET`، و`A2A_SECRET`، و`WORKSPACE_SECRETS_ENCRYPTION_KEY`، و`SECRETS_ENCRYPTION_KEY`، و`AGENT_NATIVE_BUILDER_RELAY_SECRET`)، أنشئ قيمًا جديدة باستخدام:

```bash
openssl rand -hex 32
```

دوِّر مفاتيح التوقيع/الجلسة عن طريق استبدال متغير البيئة في كل مثيل وإعادة النشر. تصبح الجلسات وأظرف حالة OAuth الموقَّعة بموجب المفتاح القديم غير صالحة، لذا قد يحتاج المستخدمون إلى تسجيل الدخول مرة أخرى. دوِّر `WORKSPACE_SECRETS_ENCRYPTION_KEY` باستخدام نافذة `..._PREVIOUS` الموصوفة أعلاه حتى تظل صفوف الخزنة المشفَّرة قابلة للقراءة أثناء ترحيلها.

## ما هي الخطوة التالية

- [**النشر**](/docs/deployment) — اختر قاعدة بيانات دائمة وإعدادًا مسبقًا قبل أول عملية نشر إنتاجي
- [**متغيرات البيئة**](/docs/environment-variables) — المرجع الشامل للمستودع بأكمله، بما في ذلك متغيرات القالب والمزود والمحلي والتكامل المستمر
- [**الأمان**](/docs/security) — قائمة التحقق الخاصة بالإنتاج والأعلام الاختيارية المشار إليها في هذه الصفحة
- [**المصادقة**](/docs/authentication) — بيانات اعتماد OAuth ومتغيرات البيئة لوضع المصادقة الذي تختاره
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