diff --git a/ar/acp.mdx b/ar/acp.mdx index 8c9bc54..599718d 100644 --- a/ar/acp.mdx +++ b/ar/acp.mdx @@ -2,6 +2,12 @@ title: "Agent Client Protocol (ACP)" sidebarTitle: "المحررات (ACP)" --- + +{/* pending-translation */} + +لم تُحدَّث ترجمة هذه الصفحة بعد، والنسخة الإنجليزية هي الأحدث والأصح، وقد يختلف المحتوى أدناه عنها. اقرأ [النسخة الإنجليزية](/acp). + + {/* Generated from docs/acp.md in LinuxDevil/lousho by scripts/sync-sdk-docs.mjs. Do not edit here. */} [Agent Client Protocol](https://agentclientprotocol.com) بروتوكول يتيح للمحرر diff --git a/ar/agent-directories.mdx b/ar/agent-directories.mdx index 86cfb4f..b516aa6 100644 --- a/ar/agent-directories.mdx +++ b/ar/agent-directories.mdx @@ -1,6 +1,12 @@ --- title: "مجلدات agent" --- + +{/* pending-translation */} + +لم تُحدَّث ترجمة هذه الصفحة بعد، والنسخة الإنجليزية هي الأحدث والأصح، وقد يختلف المحتوى أدناه عنها. اقرأ [النسخة الإنجليزية](/agent-directories). + + {/* Generated from docs/agent-directories.md in LinuxDevil/lousho by scripts/sync-sdk-docs.mjs. Do not edit here. */} يمكنك تعريف الـ agent كمجلد. `loadAgentDir()` تقرأه وتستدعي `createAgent()` بالخيارات التي تصفها الملفات، فتُرجع بالضبط ما تُرجعه `createAgent()`. يبقى الـ typed code API هو المرجع الأساسي: المجلد طريقة أخرى لكتابة الخيارات نفسها، ويمكنك الانتقال إلى الكود في أي وقت دون إعادة كتابة. diff --git a/ar/agent-forge.mdx b/ar/agent-forge.mdx index 6697ab4..3b1d2de 100644 --- a/ar/agent-forge.mdx +++ b/ar/agent-forge.mdx @@ -1,6 +1,12 @@ --- title: "Agent Forge" --- + +{/* pending-translation */} + +لم تُحدَّث ترجمة هذه الصفحة بعد، والنسخة الإنجليزية هي الأحدث والأصح، وقد يختلف المحتوى أدناه عنها. اقرأ [النسخة الإنجليزية](/agent-forge). + + {/* Generated from docs/agent-forge.md in LinuxDevil/lousho by scripts/sync-sdk-docs.mjs. Do not edit here. */} Agent Forge (`apps/agent-forge`، واسمه الآخر الـ Studio) هو الـ dashboard diff --git a/ar/agent-spec.mdx b/ar/agent-spec.mdx index 7f29200..b0bf198 100644 --- a/ar/agent-spec.mdx +++ b/ar/agent-spec.mdx @@ -2,6 +2,12 @@ title: "Agent spec v2" sidebarTitle: "Agent spec v2" --- + +{/* pending-translation */} + +لم تُحدَّث ترجمة هذه الصفحة بعد، والنسخة الإنجليزية هي الأحدث والأصح، وقد يختلف المحتوى أدناه عنها. اقرأ [النسخة الإنجليزية](/agent-spec). + + {/* Generated from docs/agent-spec.md in LinuxDevil/lousho by scripts/sync-sdk-docs.mjs. Do not edit here. */} ملف مواصفات الـ agent بالإصدار 2 (agent spec v2) هو ملف YAML أو JSON يصف agent كاملًا كبيانات عادية: الـ model، والتعليمات، والـ tools، وخوادم MCP، والـ skills، والذاكرة، والـ sub-agents، والـ handoffs، والـ guardrails، وقواعد الصلاحيات، والـ hooks، والمخرجات المنظَّمة، والـ triggers، و flow اختياري. Agent Forge والـ Agent Author و`lousho dev` كلها تقرأ هذه الصيغة وتكتبها. diff --git a/ar/ai-sdk-ui.mdx b/ar/ai-sdk-ui.mdx index 98b5af1..4473553 100644 --- a/ar/ai-sdk-ui.mdx +++ b/ar/ai-sdk-ui.mdx @@ -2,6 +2,12 @@ title: "AI SDK UI (useChat)" sidebarTitle: "AI SDK UI (useChat)" --- + +{/* pending-translation */} + +لم تُحدَّث ترجمة هذه الصفحة بعد، والنسخة الإنجليزية هي الأحدث والأصح، وقد يختلف المحتوى أدناه عنها. اقرأ [النسخة الإنجليزية](/ai-sdk-ui). + + {/* Generated from docs/ai-sdk-ui.md in LinuxDevil/lousho by scripts/sync-sdk-docs.mjs. Do not edit here. */} إذا كانت الواجهة الأمامية (front end) لديك تستخدم أصلًا الـ UI hooks في Vercel AI SDK (`useChat` من `@ai-sdk/react` ومثيلاتها في Vue وSvelte وAngular)، فيمكنك إبقاؤها على حالها وتشغيل Lousho agent خلف الـ route. ثلاث دوال مُصدَّرة من جذر الحزمة تتولى التحويل. لا تستورد شيئًا من `ai`، ولا تستخدم أي `node:*` module، وتعمل على Node وWorkers وأي runtime مبني على Fetch. diff --git a/ar/api-overview.mdx b/ar/api-overview.mdx index 28a5aa8..f9468d8 100644 --- a/ar/api-overview.mdx +++ b/ar/api-overview.mdx @@ -3,6 +3,12 @@ title: "نظرة عامة على الـ API" sidebarTitle: "نظرة عامة على الـ API" description: "جذر الحزمة (lousho) يصدّر كل شيء أدناه. للمرجع الكامل المولّد للـ API (كل export وكل signature وكل تعليق توثيقي)، ابنِ موقع TypeDoc:" --- + +{/* pending-translation */} + +لم تُحدَّث ترجمة هذه الصفحة بعد، والنسخة الإنجليزية هي الأحدث والأصح، وقد يختلف المحتوى أدناه عنها. اقرأ [النسخة الإنجليزية](/api-overview). + + {/* Generated from docs/api-overview.md in LinuxDevil/lousho by scripts/sync-sdk-docs.mjs. Do not edit here. */} ```bash diff --git a/ar/approvals.mdx b/ar/approvals.mdx index 1c449e3..c1f92a5 100644 --- a/ar/approvals.mdx +++ b/ar/approvals.mdx @@ -1,6 +1,12 @@ --- title: "Approvals" --- + +{/* pending-translation */} + +لم تُحدَّث ترجمة هذه الصفحة بعد، والنسخة الإنجليزية هي الأحدث والأصح، وقد يختلف المحتوى أدناه عنها. اقرأ [النسخة الإنجليزية](/approvals). + + {/* Generated from docs/approvals.md in LinuxDevil/lousho by scripts/sync-sdk-docs.mjs. Do not edit here. */} علّم الـ tool بـ `needsApproval` فيتوقف الـ run قبل تنفيذ الاستدعاء، diff --git a/ar/auth.mdx b/ar/auth.mdx index 1b50b79..a18809d 100644 --- a/ar/auth.mdx +++ b/ar/auth.mdx @@ -1,6 +1,12 @@ --- title: "Route auth والـ principals" --- + +{/* pending-translation */} + +لم تُحدَّث ترجمة هذه الصفحة بعد، والنسخة الإنجليزية هي الأحدث والأصح، وقد يختلف المحتوى أدناه عنها. اقرأ [النسخة الإنجليزية](/auth). + + {/* Generated from docs/auth.md in LinuxDevil/lousho by scripts/sync-sdk-docs.mjs. Do not edit here. */} أي agent يعمل عبر HTTP يحتاج إلى معرفة أمرين عن كل request: هل يُسمح له بالمرور أصلًا، ومن المتصل. تجيب `lousho/auth` عن السؤالين. أنت تعطي الـ route قائمة مرتبة من مدخلات auth: `jwt()` أو `oidc()` أو `basic()` أو `apiToken()` أو `anonymous()`، أو function تكتبها بنفسك. أول entry يقبل الـ request يُرجع **principal** (هوية المتصل بعد أن تحققت منها auth)، وهذا الـ principal يدخل الـ run، وهناك تستطيع دوال `model` و`instructions` و`tools` ونطاقات الـ memory قراءته. diff --git a/ar/build-a-coding-agent.mdx b/ar/build-a-coding-agent.mdx index 6ac4dcc..e9fd2a4 100644 --- a/ar/build-a-coding-agent.mdx +++ b/ar/build-a-coding-agent.mdx @@ -2,6 +2,12 @@ title: "ابنِ coding agent" sidebarTitle: "ابنِ coding agent" --- + +{/* pending-translation */} + +لم تُحدَّث ترجمة هذه الصفحة بعد، والنسخة الإنجليزية هي الأحدث والأصح، وقد يختلف المحتوى أدناه عنها. اقرأ [النسخة الإنجليزية](/build-a-coding-agent). + + {/* Generated from docs/build-a-coding-agent.md in LinuxDevil/lousho by scripts/sync-sdk-docs.mjs. Do not edit here. */} هذه الصفحة تبني coding agent يعمل في الـ terminal على طريقة Claude Code: يقرأ ملفات مشروعك ويعدّلها، ويشغّل أوامر، ويسألك قبل أن يكتب ملفًا أو يشغّل شيئًا خطرًا، ويُبقي المحادثة مستمرة لأسئلة المتابعة. تحتاج إلى Node 22، ومفتاح API في متغيّر البيئة الذي يتوقعه الـ provider (`OPENAI_API_KEY` للـ model المستخدم هنا)، ومجلد مشروع تشغّله فيه. الملف الجاهز في آخر [الخطوة 5](#5-حافظ-على-استمرار-المحادثة)، وتشغّله هكذا `npx tsx coding.ts "Fix the failing test"`. diff --git a/ar/channels.mdx b/ar/channels.mdx index ab11b92..9f8fe5c 100644 --- a/ar/channels.mdx +++ b/ar/channels.mdx @@ -1,6 +1,12 @@ --- title: "Channels" --- + +{/* pending-translation */} + +لم تُحدَّث ترجمة هذه الصفحة بعد، والنسخة الإنجليزية هي الأحدث والأصح، وقد يختلف المحتوى أدناه عنها. اقرأ [النسخة الإنجليزية](/channels). + + {/* Generated from docs/channels.md in LinuxDevil/lousho by scripts/sync-sdk-docs.mjs. Do not edit here. */} يربط الـ **channel** الـ agent بطرف واحد: JSON API، أو webhook، أو تطبيق diff --git a/ar/claude-projects.mdx b/ar/claude-projects.mdx index de7d0c2..0e8242c 100644 --- a/ar/claude-projects.mdx +++ b/ar/claude-projects.mdx @@ -1,6 +1,12 @@ --- title: "مشاريع Claude Code" --- + +{/* pending-translation */} + +لم تُحدَّث ترجمة هذه الصفحة بعد، والنسخة الإنجليزية هي الأحدث والأصح، وقد يختلف المحتوى أدناه عنها. اقرأ [النسخة الإنجليزية](/claude-projects). + + {/* Generated from docs/claude-projects.md in LinuxDevil/lousho by scripts/sync-sdk-docs.mjs. Do not edit here. */} المستودع الذي يحمل أصلًا ملفات Claude Code المعتادة — diff --git a/ar/cli.mdx b/ar/cli.mdx index 6fcea0e..5e4a104 100644 --- a/ar/cli.mdx +++ b/ar/cli.mdx @@ -1,6 +1,12 @@ --- title: "CLI" --- + +{/* pending-translation */} + +لم تُحدَّث ترجمة هذه الصفحة بعد، والنسخة الإنجليزية هي الأحدث والأصح، وقد يختلف المحتوى أدناه عنها. اقرأ [النسخة الإنجليزية](/cli). + + {/* Generated from docs/cli.md in LinuxDevil/lousho by scripts/sync-sdk-docs.mjs. Do not edit here. */} تثبيت الحزمة يثبّت معها أمر `lousho`. ينشئ مشاريع جديدة، ويفحص الإعداد الخاص بك، ويشغّل agent محليًا، ويقدّمه عبر MCP، ويشغّل evals، ويعرض traces محفوظة، ويبني artifact جاهزًا للنشر، ويفتح لوحة Agent Forge. شغّله بـ `npx lousho ` داخل مشروع مثبّت فيه الـ SDK. diff --git a/ar/cloudflare-workers.mdx b/ar/cloudflare-workers.mdx index b63e0c7..2d9da8a 100644 --- a/ar/cloudflare-workers.mdx +++ b/ar/cloudflare-workers.mdx @@ -2,6 +2,11 @@ title: "Cloudflare Workers" --- +{/* pending-translation */} + +لم تُحدَّث ترجمة هذه الصفحة بعد، والنسخة الإنجليزية هي الأحدث والأصح، وقد يختلف المحتوى أدناه عنها. اقرأ [النسخة الإنجليزية](/cloudflare-workers). + + {/* Generated from docs/cloudflare-workers.md in LinuxDevil/lousho by scripts/sync-sdk-docs.mjs. Do not edit here. */} الأمر `npx lousho build --target=cloudflare-worker --agent=agent.yaml` يولّد module Worker باسم `worker.ts`، و`wrangler.toml`، وbundle هو `dist/worker.js` يفحصه الـ build بحثًا عن استيرادات `node:`. يحتاج `tsup` و`wrangler` مثبتين، ويأخذ [ملف agent spec](/ar/configuration) أو [agent directory](/ar/agent-directories) (`npx lousho build ./my-agent --target=cloudflare-worker`). الـ Worker يقدّم نفس [HTTP API](/ar/deployment#http-api) التي تقدّمها الأهداف الثانية. هذا الهدف هو الأضيق حدودًا بين الثلاثة، فنبدأ بحدوده. diff --git a/ar/code-mode.mdx b/ar/code-mode.mdx index 2f751bf..62f1433 100644 --- a/ar/code-mode.mdx +++ b/ar/code-mode.mdx @@ -1,6 +1,12 @@ --- title: "Code mode" --- + +{/* pending-translation */} + +لم تُحدَّث ترجمة هذه الصفحة بعد، والنسخة الإنجليزية هي الأحدث والأصح، وقد يختلف المحتوى أدناه عنها. اقرأ [النسخة الإنجليزية](/code-mode). + + {/* Generated from docs/code-mode.md in LinuxDevil/lousho by scripts/sync-sdk-docs.mjs. Do not edit here. */} مع code mode يحصل الموديل على tool إضافية: `run_code`. بدلًا من أن يستدعي الـ tools diff --git a/ar/compaction.mdx b/ar/compaction.mdx index 0fb9a82..8bf1cff 100644 --- a/ar/compaction.mdx +++ b/ar/compaction.mdx @@ -1,6 +1,12 @@ --- title: "Context compaction" --- + +{/* pending-translation */} + +لم تُحدَّث ترجمة هذه الصفحة بعد، والنسخة الإنجليزية هي الأحدث والأصح، وقد يختلف المحتوى أدناه عنها. اقرأ [النسخة الإنجليزية](/compaction). + + {/* Generated from docs/compaction.md in LinuxDevil/lousho by scripts/sync-sdk-docs.mjs. Do not edit here. */} run طويل لـagent يملأ الـcontext window غالبًا بنتائج الـtools: محتويات ملفات، نتائج بحث، ردود API قرأها الـmodel مرة ولم يعد يحتاجها كاملة. الـcompaction (ضغط سياق المحادثة) يُبقي run كهذا تحت حد الـmodel على مرحلتين: أولاً يستبدل بنتائج الـtools القديمة علامة قصيرة، وإذا لم يكفِ ذلك يستبدل بأقدم الدورات ملخصًا يكتبه model (أرخص). diff --git a/ar/comparison.mdx b/ar/comparison.mdx index 95ba779..2ff6803 100644 --- a/ar/comparison.mdx +++ b/ar/comparison.mdx @@ -2,6 +2,12 @@ title: "مقارنة Lousho بغيرها" description: "تقارن هذه الصفحة Lousho بأربع مكتبات وكلاء أخرى مكتوبة بـ TypeScript: Vercel AI SDK (ToolLoopAgent)، وOpenAI Agents SDK للغة JavaScript، وMastra، وLangGraph.js. كل خانة تخص مشروعًا آخر مأخوذة من توثيقه الرسمي." --- + +{/* pending-translation */} + +لم تُحدَّث ترجمة هذه الصفحة بعد، والنسخة الإنجليزية هي الأحدث والأصح، وقد يختلف المحتوى أدناه عنها. اقرأ [النسخة الإنجليزية](/comparison). + + {/* Generated from docs/comparison.md in LinuxDevil/lousho by scripts/sync-sdk-docs.mjs. Do not edit here. */} آخر تحقق: 9 نوفمبر 2026. هذه المشاريع تتغير بسرعة، لذا قد تكون بعض الخانات قديمة. diff --git a/ar/configuration.mdx b/ar/configuration.mdx index ea40a09..ed33722 100644 --- a/ar/configuration.mdx +++ b/ar/configuration.mdx @@ -1,6 +1,12 @@ --- title: "الإعدادات" --- + +{/* pending-translation */} + +لم تُحدَّث ترجمة هذه الصفحة بعد، والنسخة الإنجليزية هي الأحدث والأصح، وقد يختلف المحتوى أدناه عنها. اقرأ [النسخة الإنجليزية](/configuration). + + {/* Generated from docs/configuration.md in LinuxDevil/lousho by scripts/sync-sdk-docs.mjs. Do not edit here. */} ## ملفات تعريف الـ agent (`AgentSpec`) diff --git a/ar/connectors.mdx b/ar/connectors.mdx index 4962291..72a2fa5 100644 --- a/ar/connectors.mdx +++ b/ar/connectors.mdx @@ -1,6 +1,12 @@ --- title: "الموصِّلات (Connectors)" --- + +{/* pending-translation */} + +لم تُحدَّث ترجمة هذه الصفحة بعد، والنسخة الإنجليزية هي الأحدث والأصح، وقد يختلف المحتوى أدناه عنها. اقرأ [النسخة الإنجليزية](/connectors). + + {/* Generated from docs/connectors.md in LinuxDevil/lousho by scripts/sync-sdk-docs.mjs. Do not edit here. */} الـ connectors (الموصِّلات) هي طريقة الـ agent للوصول إلى خدمات خارجية، مثل Google Docs و Slack diff --git a/ar/decisions.mdx b/ar/decisions.mdx index 65dbceb..5f9eed4 100644 --- a/ar/decisions.mdx +++ b/ar/decisions.mdx @@ -1,6 +1,12 @@ --- title: "Decisions" --- + +{/* pending-translation */} + +لم تُحدَّث ترجمة هذه الصفحة بعد، والنسخة الإنجليزية هي الأحدث والأصح، وقد يختلف المحتوى أدناه عنها. اقرأ [النسخة الإنجليزية](/decisions). + + {/* Generated from docs/decisions.md in LinuxDevil/lousho by scripts/sync-sdk-docs.mjs. Do not edit here. */} `decide()` يستدعي OpenAI Decisions API (`POST /v1/decisions`): endpoint مصمَّم لهذا الغرض، يقيّم input مشتركًا مقابل أسئلة typed ويرجّع إجابات معايَرة (calibrated) أسرع بحوالي 10 مرات من دورة model كاملة. هو الشكل السريع والحتمي لنمط القرار الـ typed، أي التصنيف والتوجيه والبوابات والتقييم بالدرجات، دون أن تشغّل run كاملًا لـ agent. diff --git a/ar/deployment.mdx b/ar/deployment.mdx index 8d2d704..f788cdd 100644 --- a/ar/deployment.mdx +++ b/ar/deployment.mdx @@ -1,6 +1,12 @@ --- title: "النشر" --- + +{/* pending-translation */} + +لم تُحدَّث ترجمة هذه الصفحة بعد، والنسخة الإنجليزية هي الأحدث والأصح، وقد يختلف المحتوى أدناه عنها. اقرأ [النسخة الإنجليزية](/deployment). + + {/* Generated from docs/deployment.md in LinuxDevil/lousho by scripts/sync-sdk-docs.mjs. Do not edit here. */} يأخذ `lousho build` ملف spec للـagent (راجع [الإعداد](/ar/configuration)) ويُخرج منه artifact جاهزًا للنشر على منصة واحدة: diff --git a/ar/durable-execution.mdx b/ar/durable-execution.mdx index addedfe..7dbd6c8 100644 --- a/ar/durable-execution.mdx +++ b/ar/durable-execution.mdx @@ -1,6 +1,12 @@ --- title: "Durable execution" --- + +{/* pending-translation */} + +لم تُحدَّث ترجمة هذه الصفحة بعد، والنسخة الإنجليزية هي الأحدث والأصح، وقد يختلف المحتوى أدناه عنها. اقرأ [النسخة الإنجليزية](/durable-execution). + + {/* Generated from docs/durable-execution.md in LinuxDevil/lousho by scripts/sync-sdk-docs.mjs. Do not edit here. */} مرّر `store` لـ`createAgent()` ومرّر `sessionId` لـ`send()`، فيستمر الـ run رغم crash، أو restart، أو abort، أو approval (موافقة) من إنسان تستغرق أيامًا. ولا شيء هنا يعتمد على host معيّن: أي `CheckpointStore` — `memoryStore()`، أو `SqliteStore`، أو store الـ Cloudflare KV الذي يوفّره build `cloudflare-worker`، أو تنفيذك الخاص بثلاث دوال — وأي `ApprovalStore` تعمل بالطريقة نفسها. diff --git a/ar/errors.mdx b/ar/errors.mdx index 96a9e81..01061c9 100644 --- a/ar/errors.mdx +++ b/ar/errors.mdx @@ -3,6 +3,11 @@ title: "الأخطاء" description: "كل خطأ يرميه الـ SDK عن قصد هو SDKError بكود LOUSHO_* ثابت وتلميح ورابط لقسمه هنا؛ تسرد هذه الصفحة كل كود مع سببه وحلّه." --- +{/* pending-translation */} + +لم تُحدَّث ترجمة هذه الصفحة بعد، والنسخة الإنجليزية هي الأحدث والأصح، وقد يختلف المحتوى أدناه عنها. اقرأ [النسخة الإنجليزية](/errors). + + {/* Generated from docs/errors.md in LinuxDevil/lousho by scripts/sync-sdk-docs.mjs. Do not edit here. */} تقريبًا كل خطأ يرميه الـ SDK عن قصد هو `SDKError` (أو subclass منه مثل `ConfigurationError` أو `ValidationError` أو `MissingPeerDependencyError`) وفيه: diff --git a/ar/evals.mdx b/ar/evals.mdx index be90dc4..96b0c23 100644 --- a/ar/evals.mdx +++ b/ar/evals.mdx @@ -1,6 +1,12 @@ --- title: "Evals" --- + +{/* pending-translation */} + +لم تُحدَّث ترجمة هذه الصفحة بعد، والنسخة الإنجليزية هي الأحدث والأصح، وقد يختلف المحتوى أدناه عنها. اقرأ [النسخة الإنجليزية](/evals). + + {/* Generated from docs/evals.md in LinuxDevil/lousho by scripts/sync-sdk-docs.mjs. Do not edit here. */} الـ evals هي regression tests لـ *سلوك* الـ agent: أي tools استدعى، diff --git a/ar/examples/heal-benchmark.mdx b/ar/examples/heal-benchmark.mdx index 09dcce5..c452648 100644 --- a/ar/examples/heal-benchmark.mdx +++ b/ar/examples/heal-benchmark.mdx @@ -3,6 +3,12 @@ title: "مقياس الإصلاح الذاتي (heal-benchmark)" sidebarTitle: "مقياس الإصلاح الذاتي" description: "طريقة قابلة للتكرار لمعرفة ما إذا كان تغيير في الـ harness الخاص بالـ agent قد ساعد. تشغّل أربعة agents على 28 مهمة وتُبلغ عن معدل النجاح والضجيج والـ tokens واستدعاءات الأدوات لكل نسخة من الـ harness." --- + +{/* pending-translation */} + +لم تُحدَّث ترجمة هذه الصفحة بعد، والنسخة الإنجليزية هي الأحدث والأصح، وقد يختلف المحتوى أدناه عنها. اقرأ [النسخة الإنجليزية](/examples/heal-benchmark). + + {/* Generated from examples/heal-benchmark/README.md in LinuxDevil/lousho by scripts/sync-sdk-docs.mjs. Do not edit here. */} | الـ agent | ما يختبره | diff --git a/ar/executor-api.mdx b/ar/executor-api.mdx index 00c23a7..7593f93 100644 --- a/ar/executor-api.mdx +++ b/ar/executor-api.mdx @@ -2,6 +2,12 @@ title: "Executor API" sidebarTitle: "Executor API" --- + +{/* pending-translation */} + +لم تُحدَّث ترجمة هذه الصفحة بعد، والنسخة الإنجليزية هي الأحدث والأصح، وقد يختلف المحتوى أدناه عنها. اقرأ [النسخة الإنجليزية](/executor-api). + + {/* Generated from docs/executor-api.md in LinuxDevil/lousho by scripts/sync-sdk-docs.mjs. Do not edit here. */} `createAgent()` هي نقطة الدخول الموصى بها (راجع [البدء السريع](/ar/quickstart)). هذه الصفحة للكود الذي يحتاج الخيارات الأدنى مستوى التي لا تأخذها `createAgent()`. ولنقل كود executor موجود إلى `createAgent()`، راجع [الانتقال إلى createAgent()](/ar/migrating-to-create-agent). diff --git a/ar/flows.mdx b/ar/flows.mdx index d40aa5a..66ff80a 100644 --- a/ar/flows.mdx +++ b/ar/flows.mdx @@ -1,6 +1,12 @@ --- title: "Flows" --- + +{/* pending-translation */} + +لم تُحدَّث ترجمة هذه الصفحة بعد، والنسخة الإنجليزية هي الأحدث والأصح، وقد يختلف المحتوى أدناه عنها. اقرأ [النسخة الإنجليزية](/flows). + + {/* Generated from docs/flows.md in LinuxDevil/lousho by scripts/sync-sdk-docs.mjs. Do not edit here. */} الـflow هو سير عمل ثابت من عدة خطوات، يشغّله agent واحد. تكتب الخطوات وترتيبها مسبقاً، بدلًا من أن تترك القرار للـmodel. صف الـgraph بـ`FlowBuilder`، وشغّله بالدالة static `FlowExecutor.execute(flow, context, onEvent?)`. diff --git a/ar/guardrails.mdx b/ar/guardrails.mdx index 9a936f0..4dc2891 100644 --- a/ar/guardrails.mdx +++ b/ar/guardrails.mdx @@ -1,6 +1,12 @@ --- title: "Guardrails و sandboxing" --- + +{/* pending-translation */} + +لم تُحدَّث ترجمة هذه الصفحة بعد، والنسخة الإنجليزية هي الأحدث والأصح، وقد يختلف المحتوى أدناه عنها. اقرأ [النسخة الإنجليزية](/guardrails). + + {/* Generated from docs/guardrails.md in LinuxDevil/lousho by scripts/sync-sdk-docs.mjs. Do not edit here. */} أدوات تشغّل الـ agents بأمان: **input و output guardrails** تفحص ما يدخل أي run وما يخرج منه (ومعاملات الـ tool calls)، و**patch checks** فحوص fail-closed على تغيير مقترح قبل أن تتصرّف بناءً عليه، و**sandboxed tools** تعمل داخل container معزولة بدلًا من عملية الـ host. للقرارات البشرية على كل call انظر [Approvals](/ar/approvals)؛ وللـ hooks التي تفحص كل tool call أو ترفضه انظر [Hooks](/ar/hooks). diff --git a/ar/handoffs.mdx b/ar/handoffs.mdx index cbaeed9..2b00434 100644 --- a/ar/handoffs.mdx +++ b/ar/handoffs.mdx @@ -2,6 +2,12 @@ title: "Handoffs" description: "الـ handoff يمرّر المحادثة كلها إلى agent آخر. الـ triage agent يقرأ طلب المستخدم ويسلّمه إلى متخصص. المتخصص يجيب المستخدم مباشرة، وفي الـ session (الجلسة) يبقى هو صاحب المحادثة في الدورات التالية." --- + +{/* pending-translation */} + +لم تُحدَّث ترجمة هذه الصفحة بعد، والنسخة الإنجليزية هي الأحدث والأصح، وقد يختلف المحتوى أدناه عنها. اقرأ [النسخة الإنجليزية](/handoffs). + + {/* Generated from docs/handoffs.md in LinuxDevil/lousho by scripts/sync-sdk-docs.mjs. Do not edit here. */} ## handoffs أم sub-agents؟ diff --git a/ar/hooks.mdx b/ar/hooks.mdx index c4d8433..2d7f895 100644 --- a/ar/hooks.mdx +++ b/ar/hooks.mdx @@ -1,6 +1,12 @@ --- title: "Hooks" --- + +{/* pending-translation */} + +لم تُحدَّث ترجمة هذه الصفحة بعد، والنسخة الإنجليزية هي الأحدث والأصح، وقد يختلف المحتوى أدناه عنها. اقرأ [النسخة الإنجليزية](/hooks). + + {/* Generated from docs/hooks.md in LinuxDevil/lousho by scripts/sync-sdk-docs.mjs. Do not edit here. */} الـ hook هو object بالشكل `{ name, preToolCall?, postToolCall?, preGenerate?, postGenerate? }` يعمل داخل الـ agent loop، حول كل tool call وكل model call. استخدمه لكتابة audit log، أو لرفض tool، أو لحجب نتيجة أو قصّها، أو لحقن context قبل الـ model call، أو لتغيير الـ request الذي سيُرسَل (header أو `temperature`). diff --git a/ar/hosted-tools.mdx b/ar/hosted-tools.mdx index 7b4aacd..2f752ec 100644 --- a/ar/hosted-tools.mdx +++ b/ar/hosted-tools.mdx @@ -1,6 +1,12 @@ --- title: "Hosted tools عند الـ provider" --- + +{/* pending-translation */} + +لم تُحدَّث ترجمة هذه الصفحة بعد، والنسخة الإنجليزية هي الأحدث والأصح، وقد يختلف المحتوى أدناه عنها. اقرأ [النسخة الإنجليزية](/hosted-tools). + + {/* Generated from docs/hosted-tools.md in LinuxDevil/lousho by scripts/sync-sdk-docs.mjs. Do not edit here. */} بعض الـ providers يشغّلون tools بنفسهم، داخل طلب الـ model نفسه. أشهرها عند OpenAI: web search وcode interpreter وfile search. ضعها في `tools` بجانب الـ tools التي تعرّفها أنت. الـ provider هو الذي يشغّلها، والـ run يبلّغ عن كل call في الـ events، ويحتفظ بها في الـ transcript (سجل الرسائل)، ويحسبها في الـ usage. diff --git a/ar/improve.mdx b/ar/improve.mdx index 2391c43..8f556cb 100644 --- a/ar/improve.mdx +++ b/ar/improve.mdx @@ -2,6 +2,12 @@ title: "تحسين الـ agent" description: "تبحث improveAgent عن harness أفضل دون اتصال، وتختبره مقابل الحالي، وتُرجع اقتراحًا يراجعه شخص." --- + +{/* pending-translation */} + +لم تُحدَّث ترجمة هذه الصفحة بعد، والنسخة الإنجليزية هي الأحدث والأصح، وقد يختلف المحتوى أدناه عنها. اقرأ [النسخة الإنجليزية](/improve). + + {/* Generated from docs/improve.md in LinuxDevil/lousho by scripts/sync-sdk-docs.mjs. Do not edit here. */} تبحث `improveAgent()` عن مجموعة أفضل من التعليمات والمهارات (skills) للـ agent، diff --git a/ar/installation.mdx b/ar/installation.mdx index 7999e9f..7a36f2d 100644 --- a/ar/installation.mdx +++ b/ar/installation.mdx @@ -1,6 +1,12 @@ --- title: "التثبيت" --- + +{/* pending-translation */} + +لم تُحدَّث ترجمة هذه الصفحة بعد، والنسخة الإنجليزية هي الأحدث والأصح، وقد يختلف المحتوى أدناه عنها. اقرأ [النسخة الإنجليزية](/installation). + + {/* Generated from docs/installation.md in LinuxDevil/lousho by scripts/sync-sdk-docs.mjs. Do not edit here. */} ## المتطلبات diff --git a/ar/mcp-integration.mdx b/ar/mcp-integration.mdx index 7c35eb2..2b17027 100644 --- a/ar/mcp-integration.mdx +++ b/ar/mcp-integration.mdx @@ -2,6 +2,12 @@ title: "MCP (Model Context Protocol)" sidebarTitle: "MCP" --- + +{/* pending-translation */} + +لم تُحدَّث ترجمة هذه الصفحة بعد، والنسخة الإنجليزية هي الأحدث والأصح، وقد يختلف المحتوى أدناه عنها. اقرأ [النسخة الإنجليزية](/mcp-integration). + + {/* Generated from docs/mcp.md in LinuxDevil/lousho by scripts/sync-sdk-docs.mjs. Do not edit here. */} MCP يعمل في الاتجاهين. الـ agent يستطيع استدعاء tools موجودة في سيرفرات MCP، diff --git a/ar/memory.mdx b/ar/memory.mdx index c4fe4e3..b91980d 100644 --- a/ar/memory.mdx +++ b/ar/memory.mdx @@ -1,6 +1,12 @@ --- title: "الذاكرة" --- + +{/* pending-translation */} + +لم تُحدَّث ترجمة هذه الصفحة بعد، والنسخة الإنجليزية هي الأحدث والأصح، وقد يختلف المحتوى أدناه عنها. اقرأ [النسخة الإنجليزية](/memory). + + {/* Generated from docs/memory.md in LinuxDevil/lousho by scripts/sync-sdk-docs.mjs. Do not edit here. */} الـ [session](/ar/sessions) (الجلسة) تتذكّر محادثة واحدة. أما الذاكرة فهي ما يحتفظ به الـ agent **عبر** المحادثات: تفضيلات المستخدم، وحقائق قيلت له، وقرارات اتُّخذت الأسبوع الماضي. تعطي الـ agent واحدًا أو أكثر من **memory slots** بأسماء؛ يخزّن كل slot عناصر نصية قصيرة عن طريق provider، ومفتاحها **scope**: ذاكرة واحدة للجميع، أو واحدة لكل session، أو واحدة لكل مستخدم. diff --git a/ar/migrating-from-ai-sdk.mdx b/ar/migrating-from-ai-sdk.mdx index c0272e8..151e078 100644 --- a/ar/migrating-from-ai-sdk.mdx +++ b/ar/migrating-from-ai-sdk.mdx @@ -2,6 +2,12 @@ title: "الانتقال من Vercel AI SDK" sidebarTitle: "الانتقال من الـ AI SDK" --- + +{/* pending-translation */} + +لم تُحدَّث ترجمة هذه الصفحة بعد، والنسخة الإنجليزية هي الأحدث والأصح، وقد يختلف المحتوى أدناه عنها. اقرأ [النسخة الإنجليزية](/migrating-from-ai-sdk). + + {/* Generated from docs/migrating-from-ai-sdk.md in LinuxDevil/lousho by scripts/sync-sdk-docs.mjs. Do not edit here. */} هذه الصفحة للكود المبني على حلقة الـ agent في Vercel AI SDK: `generateText({ tools })` diff --git a/ar/migrating-to-create-agent.mdx b/ar/migrating-to-create-agent.mdx index 0e35a73..296135c 100644 --- a/ar/migrating-to-create-agent.mdx +++ b/ar/migrating-to-create-agent.mdx @@ -2,6 +2,12 @@ title: "الانتقال إلى createAgent()" sidebarTitle: "الانتقال إلى createAgent()" --- + +{/* pending-translation */} + +لم تُحدَّث ترجمة هذه الصفحة بعد، والنسخة الإنجليزية هي الأحدث والأصح، وقد يختلف المحتوى أدناه عنها. اقرأ [النسخة الإنجليزية](/migrating-to-create-agent). + + {/* Generated from docs/migrating-to-create-agent.md in LinuxDevil/lousho by scripts/sync-sdk-docs.mjs. Do not edit here. */} هذه الصفحة للكود الذي يستخدم `AgentBuilder` و`AgentExecutor` و`ToolRegistry` و`resumeAfterApproval()`: الـ API الأدنى مستوى الذي بدأ به الـ SDK. هذه الـ exports انتقلت إلى `lousho/executor` ولن تُحذف. إذا بقيت عليها، راجع [واجهة الـ executor](/ar/executor-api). سبب الانتقال أن استدعاء `createAgent()` واحد يربط الـ tools والـ stores والـ approvals (موافقات) والـ sessions (جلسات) والـ retries (إعادة المحاولة) والـ compaction (ضغط سياق المحادثة)، بينما الـ executor يجعلك تجمع كل واحد منها بنفسك وتمرره في كل استدعاء. diff --git a/ar/models-and-cost.mdx b/ar/models-and-cost.mdx index 93458dc..359447a 100644 --- a/ar/models-and-cost.mdx +++ b/ar/models-and-cost.mdx @@ -2,6 +2,12 @@ title: "الـ models والـ tokens والتكلفة" sidebarTitle: "الـ models والتكلفة" --- + +{/* pending-translation */} + +لم تُحدَّث ترجمة هذه الصفحة بعد، والنسخة الإنجليزية هي الأحدث والأصح، وقد يختلف المحتوى أدناه عنها. اقرأ [النسخة الإنجليزية](/models-and-cost). + + {/* Generated from docs/models-and-cost.md in LinuxDevil/lousho by scripts/sync-sdk-docs.mjs. Do not edit here. */} ## الـ models وجدول الأسعار diff --git a/ar/nextjs.mdx b/ar/nextjs.mdx index 54cbd29..bdae382 100644 --- a/ar/nextjs.mdx +++ b/ar/nextjs.mdx @@ -2,6 +2,12 @@ title: "Next.js وframeworks أخرى على Fetch API" sidebarTitle: "Next.js وFetch frameworks" --- + +{/* pending-translation */} + +لم تُحدَّث ترجمة هذه الصفحة بعد، والنسخة الإنجليزية هي الأحدث والأصح، وقد يختلف المحتوى أدناه عنها. اقرأ [النسخة الإنجليزية](/nextjs). + + {/* Generated from docs/nextjs.md in LinuxDevil/lousho by scripts/sync-sdk-docs.mjs. Do not edit here. */} `createRouteHandler(agent, options?)` يشغّل الـ agent من ملف route في أي framework تستقبل الـ handlers فيه `Request` من Web API وترجع `Response`: الـ Next.js App Router، وSvelteKit، وRemix / React Router، وHono، وBun.serve. هو غلاف رفيع فوق نفس session API المستخدم في `lousho dev` وفي السيرفر المنشور ([النشر](/ar/deployment))، لذلك تعمل الـ bindings الخاصة بـ React وVue وSvelte معه بدون أي تغيير. لا يستورد أي framework ولا أي module من `node:*`. بادئة `vendor/` في اسم الـ model هي التي تحدد الـ provider؛ ومع OpenRouter استخدم `openrouter//` (مثل `openrouter/openai/gpt-4o-mini`). diff --git a/ar/oauth.mdx b/ar/oauth.mdx index 1ef4df9..6e48c55 100644 --- a/ar/oauth.mdx +++ b/ar/oauth.mdx @@ -1,6 +1,12 @@ --- title: "OAuth" --- + +{/* pending-translation */} + +لم تُحدَّث ترجمة هذه الصفحة بعد، والنسخة الإنجليزية هي الأحدث والأصح، وقد يختلف المحتوى أدناه عنها. اقرأ [النسخة الإنجليزية](/oauth). + + {/* Generated from docs/oauth.md in LinuxDevil/lousho by scripts/sync-sdk-docs.mjs. Do not edit here. */} الأدوات وخوادم MCP التي تستدعي API بالنيابة عن أحد تحتاج access token من OAuth، وعادةً refresh token لكي تجلب الذي يليه. هذه الصفحة تغطي أين تعيش هذه الـtokens: في جزء `tokens` من `AgentStore`، مفهرسةً بالـprovider وبمالك الـcredential. وتغطي كيف تحصل الأداة على واحد: تستدعي `ctx.getToken(provider)`، وإذا لم يربط المستخدم حسابه بعد يتوقف الـrun إلى أن يسجّل الدخول ([أدوات تحتاج تسجيل دخول](#أدوات-تحتاج-تسجيل-دخول)). وخوادم MCP عبر HTTP تسجّل الدخول بـOAuth أيضًا ([خوادم MCP مع OAuth](#خوادم-mcp-مع-oauth)). diff --git a/ar/observability.mdx b/ar/observability.mdx index c8fad6e..ba35a2e 100644 --- a/ar/observability.mdx +++ b/ar/observability.mdx @@ -2,6 +2,12 @@ title: "Tracing و observability" sidebarTitle: "Tracing" --- + +{/* pending-translation */} + +لم تُحدَّث ترجمة هذه الصفحة بعد، والنسخة الإنجليزية هي الأحدث والأصح، وقد يختلف المحتوى أدناه عنها. اقرأ [النسخة الإنجليزية](/observability). + + {/* Generated from docs/observability.md in LinuxDevil/lousho by scripts/sync-sdk-docs.mjs. Do not edit here. */} `AgentExecutor.execute()` و`FlowExecutor.execute()` ينتجان spans عبر `TraceExporter`. أسماء الـ spans والـ attributes تتبع [GenAI semantic conventions في OpenTelemetry](https://opentelemetry.io/docs/specs/semconv/gen-ai/)، فالـ observability backends التي تفهم GenAI تتعرف عليها بدون mapping خاص. diff --git a/ar/openapi-tools.mdx b/ar/openapi-tools.mdx index abb8b81..9b1e1a6 100644 --- a/ar/openapi-tools.mdx +++ b/ar/openapi-tools.mdx @@ -1,6 +1,12 @@ --- title: "OpenAPI tools" --- + +{/* pending-translation */} + +لم تُحدَّث ترجمة هذه الصفحة بعد، والنسخة الإنجليزية هي الأحدث والأصح، وقد يختلف المحتوى أدناه عنها. اقرأ [النسخة الإنجليزية](/openapi-tools). + + {/* Generated from docs/openapi-tools.md in LinuxDevil/lousho by scripts/sync-sdk-docs.mjs. Do not edit here. */} أغلب الخدمات تنشر مستند OpenAPI وما عندها سيرفر MCP. `openApiTools()` diff --git a/ar/pause-and-resume.mdx b/ar/pause-and-resume.mdx index 805a292..8e44b28 100644 --- a/ar/pause-and-resume.mdx +++ b/ar/pause-and-resume.mdx @@ -2,6 +2,12 @@ title: "الإيقاف المؤقت وإعادة التشغيل والاستئناف" description: "درس عملي لمهمة واحدة: agent يتوقف ليسأل إنسانًا قبل استدعاء أداة خطِر، ويصمد أمام إعادة تشغيل الـ process وهو ينتظر، ويكمل حين يقرّر أحدهم. ثم ما يحدث حين يموت الـ process في منتصف أداة." --- + +{/* pending-translation */} + +لم تُحدَّث ترجمة هذه الصفحة بعد، والنسخة الإنجليزية هي الأحدث والأصح، وقد يختلف المحتوى أدناه عنها. اقرأ [النسخة الإنجليزية](/pause-and-resume). + + {/* Generated from docs/pause-and-resume.md in LinuxDevil/lousho by scripts/sync-sdk-docs.mjs. Do not edit here. */} تستخدم المقتطفات `mockModel` لكي تعمل كما تُلصَق، دون مفتاح API. ضع diff --git a/ar/pending.json b/ar/pending.json index 27f8904..dce9ed7 100644 --- a/ar/pending.json +++ b/ar/pending.json @@ -1,5 +1,74 @@ [ - "forge-builder", + "acp", + "agent-directories", + "agent-forge", + "agent-spec", + "ai-sdk-ui", + "api-overview", + "approvals", + "auth", + "build-a-coding-agent", + "channels", + "claude-projects", + "cli", + "cloudflare-workers", + "code-mode", + "compaction", + "comparison", + "configuration", + "connectors", + "decisions", + "deployment", + "durable-execution", + "errors", + "evals", + "examples/heal-benchmark", + "executor-api", + "flows", "forge-author", - "forge-lifecycle" + "forge-builder", + "forge-lifecycle", + "guardrails", + "handoffs", + "hooks", + "hosted-tools", + "improve", + "installation", + "mcp-integration", + "memory", + "migrating-from-ai-sdk", + "migrating-to-create-agent", + "models-and-cost", + "nextjs", + "oauth", + "observability", + "openapi-tools", + "pause-and-resume", + "permission-modes", + "prompting-techniques", + "providers", + "queue-and-steer", + "quickstart", + "react", + "reasoning", + "registry", + "runs", + "schedules", + "self-healing", + "sessions", + "skills", + "stream-events", + "streaming", + "structured-output", + "sub-agents", + "svelte", + "testing", + "tool-search", + "tools", + "triggers", + "troubleshooting", + "upgrading", + "utilities", + "vue", + "workspace-tools" ] diff --git a/ar/permission-modes.mdx b/ar/permission-modes.mdx index 56f78c5..dd627e1 100644 --- a/ar/permission-modes.mdx +++ b/ar/permission-modes.mdx @@ -1,6 +1,12 @@ --- title: "أوضاع الصلاحيات" --- + +{/* pending-translation */} + +لم تُحدَّث ترجمة هذه الصفحة بعد، والنسخة الإنجليزية هي الأحدث والأصح، وقد يختلف المحتوى أدناه عنها. اقرأ [النسخة الإنجليزية](/permission-modes). + + {/* Generated from docs/permission-modes.md in LinuxDevil/lousho by scripts/sync-sdk-docs.mjs. Do not edit here. */} وضع الصلاحيات يضع الـ agent في حالة لها اسم، بدلًا من أن تكتب rules: ينظر فقط دون أن يلمس شيئًا (`plan`)، أو يعدّل الملفات دون سؤال (`acceptEdits`)، أو لا يتوقف أبدًا (`dontAsk`). بدّله في منتصف الـ session، بالطريقة نفسها التي تعمل بها مع coding agent: خطّط أولًا، ثم دعه يعدّل. diff --git a/ar/prompting-techniques.mdx b/ar/prompting-techniques.mdx index 4e0807a..ab6ba05 100644 --- a/ar/prompting-techniques.mdx +++ b/ar/prompting-techniques.mdx @@ -2,6 +2,12 @@ title: "تقنيات الـ prompting وإدارة السياق" description: "جودة الـ agent تأتي من ثلاث طبقات، ومن المفيد أن تعرف في أي طبقة تقع كل تقنية، لأن إصلاح agent يتصرف بشكل خاطئ يختلف من طبقة لأخرى:" --- + +{/* pending-translation */} + +لم تُحدَّث ترجمة هذه الصفحة بعد، والنسخة الإنجليزية هي الأحدث والأصح، وقد يختلف المحتوى أدناه عنها. اقرأ [النسخة الإنجليزية](/prompting-techniques). + + {/* Generated from docs/prompting-techniques.md in LinuxDevil/lousho by scripts/sync-sdk-docs.mjs. Do not edit here. */} 1. **تقنيات على مستوى الـ prompt**: ما يُطلب من استدعاء model واحد، وكيف diff --git a/ar/providers.mdx b/ar/providers.mdx index 5371e34..9fbf648 100644 --- a/ar/providers.mdx +++ b/ar/providers.mdx @@ -1,6 +1,12 @@ --- title: "Providers" --- + +{/* pending-translation */} + +لم تُحدَّث ترجمة هذه الصفحة بعد، والنسخة الإنجليزية هي الأحدث والأصح، وقد يختلف المحتوى أدناه عنها. اقرأ [النسخة الإنجليزية](/providers). + + {/* Generated from docs/providers.md in LinuxDevil/lousho by scripts/sync-sdk-docs.mjs. Do not edit here. */} الـ `LLMProvider` هو ما يولّد الـ agent من خلاله. يأتي الـ SDK مع diff --git a/ar/queue-and-steer.mdx b/ar/queue-and-steer.mdx index 0152fcc..5aa68fa 100644 --- a/ar/queue-and-steer.mdx +++ b/ar/queue-and-steer.mdx @@ -2,6 +2,12 @@ title: "Queued input and steering" sidebarTitle: "Queued input and steering" --- + +{/* pending-translation */} + +لم تُحدَّث ترجمة هذه الصفحة بعد، والنسخة الإنجليزية هي الأحدث والأصح، وقد يختلف المحتوى أدناه عنها. اقرأ [النسخة الإنجليزية](/queue-and-steer). + + {/* Generated from docs/queue-and-steer.md in LinuxDevil/lousho by scripts/sync-sdk-docs.mjs. Do not edit here. */} أضف input إلى run ما زال يعمل، أو غيّر اتجاهه. كلاهما methods على الـ run handle الذي تُرجعه `agent.stream()`؛ راجع [Streaming](/ar/streaming). diff --git a/ar/quickstart.mdx b/ar/quickstart.mdx index dd92492..9170765 100644 --- a/ar/quickstart.mdx +++ b/ar/quickstart.mdx @@ -3,6 +3,12 @@ title: "البدء السريع" sidebarTitle: "البدء السريع" description: "هذه الصفحة توصلك من agent بسطر واحد إلى tools وstreaming وsessions وapproval واختبار offline. كل مثال بعد الأول يعمل كما هو دون مفتاح API، على الـ mock provider المدمج في الـ SDK." --- + +{/* pending-translation */} + +لم تُحدَّث ترجمة هذه الصفحة بعد، والنسخة الإنجليزية هي الأحدث والأصح، وقد يختلف المحتوى أدناه عنها. اقرأ [النسخة الإنجليزية](/quickstart). + + {/* Generated from docs/quick-start.md in LinuxDevil/lousho by scripts/sync-sdk-docs.mjs. Do not edit here. */} ## ابدأ مشروع جديد diff --git a/ar/react.mdx b/ar/react.mdx index 1fafad7..123ae93 100644 --- a/ar/react.mdx +++ b/ar/react.mdx @@ -1,6 +1,12 @@ --- title: "React" --- + +{/* pending-translation */} + +لم تُحدَّث ترجمة هذه الصفحة بعد، والنسخة الإنجليزية هي الأحدث والأصح، وقد يختلف المحتوى أدناه عنها. اقرأ [النسخة الإنجليزية](/react). + + {/* Generated from docs/react.md in LinuxDevil/lousho by scripts/sync-sdk-docs.mjs. Do not edit here. */} `useLoushoAgent()` يضع agent خلف واجهة محادثة. يشغّل turn، ويقرأ الـ [typed event stream](/ar/streaming) فور وصوله، ويحوّله إلى state جاهزة للـ render: رسائل بنصها وtool calls، و`status` لحقل كتابة الرسالة، والـ tool call المتوقف على approval إن وُجد. diff --git a/ar/reasoning.mdx b/ar/reasoning.mdx index e43ee99..f4efd4e 100644 --- a/ar/reasoning.mdx +++ b/ar/reasoning.mdx @@ -2,6 +2,11 @@ title: "Reasoning" --- +{/* pending-translation */} + +لم تُحدَّث ترجمة هذه الصفحة بعد، والنسخة الإنجليزية هي الأحدث والأصح، وقد يختلف المحتوى أدناه عنها. اقرأ [النسخة الإنجليزية](/reasoning). + + {/* Generated from docs/reasoning.md in LinuxDevil/lousho by scripts/sync-sdk-docs.mjs. Do not edit here. */} موديلات الـ reasoning تفكّر قبل أن ترد. خيار `reasoning` يحدد مقدار التفكير. diff --git a/ar/registry.mdx b/ar/registry.mdx index 689604e..817f926 100644 --- a/ar/registry.mdx +++ b/ar/registry.mdx @@ -1,6 +1,12 @@ --- title: "Registry" --- + +{/* pending-translation */} + +لم تُحدَّث ترجمة هذه الصفحة بعد، والنسخة الإنجليزية هي الأحدث والأصح، وقد يختلف المحتوى أدناه عنها. اقرأ [النسخة الإنجليزية](/registry). + + {/* Generated from docs/registry.md in LinuxDevil/lousho by scripts/sync-sdk-docs.mjs. Do not edit here. */} `lousho add` يثبّت tool أو skill أو channel أو schedule أو خانة memory أو kit diff --git a/ar/runs.mdx b/ar/runs.mdx index 82970a5..d423018 100644 --- a/ar/runs.mdx +++ b/ar/runs.mdx @@ -3,6 +3,12 @@ title: "Runs: أسباب الانتهاء والإلغاء والـtools الم sidebarTitle: "Runs والإلغاء" description: "كيف ينتهي الـrun، كيف توقفه، وكيف تعمل الـtool calls في دورة model واحدة بالتوازي." --- + +{/* pending-translation */} + +لم تُحدَّث ترجمة هذه الصفحة بعد، والنسخة الإنجليزية هي الأحدث والأصح، وقد يختلف المحتوى أدناه عنها. اقرأ [النسخة الإنجليزية](/runs). + + {/* Generated from docs/runs.md in LinuxDevil/lousho by scripts/sync-sdk-docs.mjs. Do not edit here. */} ## أسباب الانتهاء diff --git a/ar/schedules.mdx b/ar/schedules.mdx index c9b923d..80515d6 100644 --- a/ar/schedules.mdx +++ b/ar/schedules.mdx @@ -1,6 +1,12 @@ --- title: "Schedules" --- + +{/* pending-translation */} + +لم تُحدَّث ترجمة هذه الصفحة بعد، والنسخة الإنجليزية هي الأحدث والأصح، وقد يختلف المحتوى أدناه عنها. اقرأ [النسخة الإنجليزية](/schedules). + + {/* Generated from docs/schedules.md in LinuxDevil/lousho by scripts/sync-sdk-docs.mjs. Do not edit here. */} الـ **schedule** يشغّل الـ agent على تعبير cron، بدون أن يطلبه أحد: ملخص صباحي، تنظيف ليلي. تعرّف واحدًا بـ `defineSchedule()`، و[مجلد الـ agent](/ar/agent-directories) يلتقطها من `schedules/`، و`startSchedules()` (أو سيرفر node) يشغّلها داخل العملية. الـ schedules حلّت محل `CronTriggerAdapter` (راجع [الانتقال من الـ triggers](/ar/upgrading#الانتقال-من-الـ-triggers)). diff --git a/ar/self-healing.mdx b/ar/self-healing.mdx index 87db340..242a142 100644 --- a/ar/self-healing.mdx +++ b/ar/self-healing.mdx @@ -2,6 +2,12 @@ title: "التعافي الذاتي والتحسين الذاتي" description: "كيف يستعيد Lousho الـ run الفاشل الآن (agent.recover()، وإعادة محاولة مع تشخيص، والتوقف المؤقت أثناء انقطاع المزوّد، وحارس التقدّم) ويقترح تعديلات على التعليمات والمهارات لاحقًا (improveAgent)، يوافق عليها شخص دائمًا." --- + +{/* pending-translation */} + +لم تُحدَّث ترجمة هذه الصفحة بعد، والنسخة الإنجليزية هي الأحدث والأصح، وقد يختلف المحتوى أدناه عنها. اقرأ [النسخة الإنجليزية](/self-healing). + + {/* Generated from docs/self-healing.md in LinuxDevil/lousho by scripts/sync-sdk-docs.mjs. Do not edit here. */} يتعامل Lousho مع حالات الفشل في طبقتين: diff --git a/ar/sessions.mdx b/ar/sessions.mdx index 054a7e2..d1efdcc 100644 --- a/ar/sessions.mdx +++ b/ar/sessions.mdx @@ -1,6 +1,12 @@ --- title: "Sessions" --- + +{/* pending-translation */} + +لم تُحدَّث ترجمة هذه الصفحة بعد، والنسخة الإنجليزية هي الأحدث والأصح، وقد يختلف المحتوى أدناه عنها. اقرأ [النسخة الإنجليزية](/sessions). + + {/* Generated from docs/sessions.md in LinuxDevil/lousho by scripts/sync-sdk-docs.mjs. Do not edit here. */} `agent.send(text)` هو turn واحد فقط: كل call يبدأ من سجل فارغ. diff --git a/ar/skills.mdx b/ar/skills.mdx index 3458e4b..a6b2cff 100644 --- a/ar/skills.mdx +++ b/ar/skills.mdx @@ -2,6 +2,11 @@ title: "Skills" --- +{/* pending-translation */} + +لم تُحدَّث ترجمة هذه الصفحة بعد، والنسخة الإنجليزية هي الأحدث والأصح، وقد يختلف المحتوى أدناه عنها. اقرأ [النسخة الإنجليزية](/skills). + + {/* Generated from docs/skills.md in LinuxDevil/lousho by scripts/sync-sdk-docs.mjs. Do not edit here. */} الـ skill هي مجموعة تعليمات لها اسم (مستند markdown) يحمّلها الـ model **فقط عندما يحتاجها**. هذه هي فكرة progressive disclosure: بدلًا من لصق كل playbook في الـ system prompt، تسرد الـ skills بالاسم مع وصف من سطر واحد، ويجلب الـ model النص الكامل عند الطلب. diff --git a/ar/stream-events.mdx b/ar/stream-events.mdx index 340f98d..3a3616d 100644 --- a/ar/stream-events.mdx +++ b/ar/stream-events.mdx @@ -2,6 +2,12 @@ title: "Stream events" sidebarTitle: "Stream events" --- + +{/* pending-translation */} + +لم تُحدَّث ترجمة هذه الصفحة بعد، والنسخة الإنجليزية هي الأحدث والأصح، وقد يختلف المحتوى أدناه عنها. اقرأ [النسخة الإنجليزية](/stream-events). + + {/* Generated from docs/stream-events.md in LinuxDevil/lousho by scripts/sync-sdk-docs.mjs. Do not edit here. */} الأحداث التي يطلقها `agent.stream()`، وترتيبها، وطريقة ترقيم إصداراتها. إذا أردت معرفة كيفية استهلاك الـ stream، فراجع [Streaming](/ar/streaming). diff --git a/ar/streaming.mdx b/ar/streaming.mdx index 3e8cac7..3656048 100644 --- a/ar/streaming.mdx +++ b/ar/streaming.mdx @@ -1,6 +1,12 @@ --- title: "Streaming" --- + +{/* pending-translation */} + +لم تُحدَّث ترجمة هذه الصفحة بعد، والنسخة الإنجليزية هي الأحدث والأصح، وقد يختلف المحتوى أدناه عنها. اقرأ [النسخة الإنجليزية](/streaming). + + {/* Generated from docs/streaming.md in LinuxDevil/lousho by scripts/sync-sdk-docs.mjs. Do not edit here. */} `agent.stream()` تشغّل الـ agent بطريقة `agent.send()` نفسها بالضبط، وتُرجع لك diff --git a/ar/structured-output.mdx b/ar/structured-output.mdx index a5238ce..aad6009 100644 --- a/ar/structured-output.mdx +++ b/ar/structured-output.mdx @@ -1,6 +1,12 @@ --- title: "Structured output" --- + +{/* pending-translation */} + +لم تُحدَّث ترجمة هذه الصفحة بعد، والنسخة الإنجليزية هي الأحدث والأصح، وقد يختلف المحتوى أدناه عنها. اقرأ [النسخة الإنجليزية](/structured-output). + + {/* Generated from docs/structured-output.md in LinuxDevil/lousho by scripts/sync-sdk-docs.mjs. Do not edit here. */} مرّر للـ agent zod schema في الخيار `output`، فيصبح الرد النهائي object typed وصالحًا وفق الـ schema: `result.object`. يستطيع الـ agent إجراء tool calls أولًا كالمعتاد؛ والإجابة النهائية وحدها يجب أن تطابق الـ schema. بادئة `vendor/` في اسم الـ model هي التي تحدد الـ provider؛ ومع OpenRouter استخدم `openrouter//` (مثال: `openrouter/openai/gpt-4o-mini`). diff --git a/ar/sub-agents.mdx b/ar/sub-agents.mdx index befbeab..483bc2b 100644 --- a/ar/sub-agents.mdx +++ b/ar/sub-agents.mdx @@ -1,6 +1,12 @@ --- title: "Sub-agents" --- + +{/* pending-translation */} + +لم تُحدَّث ترجمة هذه الصفحة بعد، والنسخة الإنجليزية هي الأحدث والأصح، وقد يختلف المحتوى أدناه عنها. اقرأ [النسخة الإنجليزية](/sub-agents). + + {/* Generated from docs/sub-agents.md in LinuxDevil/lousho by scripts/sync-sdk-docs.mjs. Do not edit here. */} الـsub-agent (وكيل فرعي) هو agent مستقل — له تعليمات وmodel وtools وskills diff --git a/ar/svelte.mdx b/ar/svelte.mdx index 91a55fd..3e56a21 100644 --- a/ar/svelte.mdx +++ b/ar/svelte.mdx @@ -2,6 +2,11 @@ title: "Svelte" --- +{/* pending-translation */} + +لم تُحدَّث ترجمة هذه الصفحة بعد، والنسخة الإنجليزية هي الأحدث والأصح، وقد يختلف المحتوى أدناه عنها. اقرأ [النسخة الإنجليزية](/svelte). + + {/* Generated from docs/svelte.md in LinuxDevil/lousho by scripts/sync-sdk-docs.mjs. Do not edit here. */} `loushoAgent()` لـSvelte هي نفس [React hook](/ar/react) لكن بصيغة store: نفس diff --git a/ar/testing.mdx b/ar/testing.mdx index d6d52b9..0105657 100644 --- a/ar/testing.mdx +++ b/ar/testing.mdx @@ -1,6 +1,12 @@ --- title: "اختبار الـ agents" --- + +{/* pending-translation */} + +لم تُحدَّث ترجمة هذه الصفحة بعد، والنسخة الإنجليزية هي الأحدث والأصح، وقد يختلف المحتوى أدناه عنها. اقرأ [النسخة الإنجليزية](/testing). + + {/* Generated from docs/testing.md in LinuxDevil/lousho by scripts/sync-sdk-docs.mjs. Do not edit here. */} `lousho/testing` يوفّر `mockModel`: ‏`LLMProvider` يعمل بسكربت deterministic للـ unit tests. تكتب ما يُفترض أن يقوله الـ model في كل turn، وتشغّل الـ agent، ثم تتحقق بالضبط مما أرسله الـ agent إلى الـ model. بلا network، بلا API keys، بلا flakiness. diff --git a/ar/tool-search.mdx b/ar/tool-search.mdx index d132170..d9455f9 100644 --- a/ar/tool-search.mdx +++ b/ar/tool-search.mdx @@ -1,6 +1,12 @@ --- title: "Tool search" --- + +{/* pending-translation */} + +لم تُحدَّث ترجمة هذه الصفحة بعد، والنسخة الإنجليزية هي الأحدث والأصح، وقد يختلف المحتوى أدناه عنها. اقرأ [النسخة الإنجليزية](/tool-search). + + {/* Generated from docs/tool-search.md in LinuxDevil/lousho by scripts/sync-sdk-docs.mjs. Do not edit here. */} agent عنده tools كثيرة (عدة سيرفرات MCP أو toolkit داخلية كبيرة) يرسل diff --git a/ar/tools.mdx b/ar/tools.mdx index 174d7ce..6b743a7 100644 --- a/ar/tools.mdx +++ b/ar/tools.mdx @@ -1,6 +1,12 @@ --- title: "Tools" --- + +{/* pending-translation */} + +لم تُحدَّث ترجمة هذه الصفحة بعد، والنسخة الإنجليزية هي الأحدث والأصح، وقد يختلف المحتوى أدناه عنها. اقرأ [النسخة الإنجليزية](/tools). + + {/* Generated from docs/tools.md in LinuxDevil/lousho by scripts/sync-sdk-docs.mjs. Do not edit here. */} الـ tool هو دالة typed يستطيع الـ model استدعاءها. عرّفه بـ `defineTool()`: تُستنتج أنواع الوسائط والنتيجة من zod `input`، وتمر الوسائط على validation قبل أن تعمل `execute`، ويمكن وضع النتيجة في أي مكان يقبل tools (`createAgent({ tools: [...] })`، `ToolRegistry.register(tool)`، `AgentBuilder.addTool(tool)`). diff --git a/ar/triggers.mdx b/ar/triggers.mdx index be032a3..1de31f8 100644 --- a/ar/triggers.mdx +++ b/ar/triggers.mdx @@ -1,6 +1,12 @@ --- title: "Triggers" --- + +{/* pending-translation */} + +لم تُحدَّث ترجمة هذه الصفحة بعد، والنسخة الإنجليزية هي الأحدث والأصح، وقد يختلف المحتوى أدناه عنها. اقرأ [النسخة الإنجليزية](/triggers). + + {/* Generated from docs/triggers.md in LinuxDevil/lousho by scripts/sync-sdk-docs.mjs. Do not edit here. */} الـtrigger adapter يحوّل آلية تنبيه واحدة إلى run للـagent. الـsubpath `lousho/triggers` هو نقطة التوسعة لآليتك الخاصة (`TriggerAdapter` و`TriggerRegistry`)، ومعه بعض الأدوات المساعدة المشتركة مع الـchannels والـschedules: أشكال `WebhookAuth` و`verifySlackSignature()` و`parseCronExpression()`. أما الـadapters الجاهزة للـwebhook وSlack وcron فقد حُذفت؛ راجع [الانتقال من triggers](/ar/upgrading#الانتقال-من-الـ-triggers). diff --git a/ar/troubleshooting.mdx b/ar/troubleshooting.mdx index a141e56..f85963a 100644 --- a/ar/troubleshooting.mdx +++ b/ar/troubleshooting.mdx @@ -1,6 +1,12 @@ --- title: "حل المشاكل" --- + +{/* pending-translation */} + +لم تُحدَّث ترجمة هذه الصفحة بعد، والنسخة الإنجليزية هي الأحدث والأصح، وقد يختلف المحتوى أدناه عنها. اقرأ [النسخة الإنجليزية](/troubleshooting). + + {/* Generated from docs/troubleshooting.md in LinuxDevil/lousho by scripts/sync-sdk-docs.mjs. Do not edit here. */} الصفحة هذه تبدأ من الشيء الذي تراه، وتدلّك على السبب والحل والصفحة التي تشرحه. شغّل أولًا `npx lousho doctor` ([ماذا يفحص](/ar/installation#استكشاف-الأخطاء-lousho-doctor))، وبعدها إذا عندك رمز خطأ (`LOUSHO_...`) ابحث عنه في [الأخطاء](/ar/errors). diff --git a/ar/upgrading.mdx b/ar/upgrading.mdx index 32a394b..24a3721 100644 --- a/ar/upgrading.mdx +++ b/ar/upgrading.mdx @@ -2,6 +2,12 @@ title: "الترقية إلى 1.0" sidebarTitle: "الترقية إلى 1.0" --- + +{/* pending-translation */} + +لم تُحدَّث ترجمة هذه الصفحة بعد، والنسخة الإنجليزية هي الأحدث والأصح، وقد يختلف المحتوى أدناه عنها. اقرأ [النسخة الإنجليزية](/upgrading). + + {/* Generated from docs/upgrading.md in LinuxDevil/lousho by scripts/sync-sdk-docs.mjs. Do not edit here. */} ## من يحتاج هذه الصفحة diff --git a/ar/utilities.mdx b/ar/utilities.mdx index 4871906..b1a02d1 100644 --- a/ar/utilities.mdx +++ b/ar/utilities.mdx @@ -2,6 +2,12 @@ title: "أدوات مساعدة" description: "دوال مساعدة يصدّرها المسار الفرعي lousho/utils: تشفير و hashing، وتخزين ملفات للمرفقات. لا تحتاج إلى أي منها لبناء agent؛ فهي موجودة للتطبيقات المحيطة به." --- + +{/* pending-translation */} + +لم تُحدَّث ترجمة هذه الصفحة بعد، والنسخة الإنجليزية هي الأحدث والأصح، وقد يختلف المحتوى أدناه عنها. اقرأ [النسخة الإنجليزية](/utilities). + + {/* Generated from docs/utilities.md in LinuxDevil/lousho by scripts/sync-sdk-docs.mjs. Do not edit here. */} ## التشفير و hashing diff --git a/ar/vue.mdx b/ar/vue.mdx index a3f6d45..5ba63d1 100644 --- a/ar/vue.mdx +++ b/ar/vue.mdx @@ -1,6 +1,12 @@ --- title: "Vue" --- + +{/* pending-translation */} + +لم تُحدَّث ترجمة هذه الصفحة بعد، والنسخة الإنجليزية هي الأحدث والأصح، وقد يختلف المحتوى أدناه عنها. اقرأ [النسخة الإنجليزية](/vue). + + {/* Generated from docs/vue.md in LinuxDevil/lousho by scripts/sync-sdk-docs.mjs. Do not edit here. */} `useLoushoAgent()` في Vue 3 هو [الـ hook الخاص بـReact](/ar/react) نفسه، لكن على شكل diff --git a/ar/workspace-tools.mdx b/ar/workspace-tools.mdx index 6e053fb..3efdee3 100644 --- a/ar/workspace-tools.mdx +++ b/ar/workspace-tools.mdx @@ -1,6 +1,12 @@ --- title: "Workspace tools" --- + +{/* pending-translation */} + +لم تُحدَّث ترجمة هذه الصفحة بعد، والنسخة الإنجليزية هي الأحدث والأصح، وقد يختلف المحتوى أدناه عنها. اقرأ [النسخة الإنجليزية](/workspace-tools). + + {/* Generated from docs/workspace-tools.md in LinuxDevil/lousho by scripts/sync-sdk-docs.mjs. Do not edit here. */} تعطي الـworkspace tools الـagent نظام ملفات وshell، فيستطيع العمل كـcoding agent بأسلوب Claude Code. الأدوات نفسها لا تستخدم `node:fs` ولا `node:child_process`، بل تستدعي واجهتين صغيرتين: `FsProvider` و`ShellProvider`. لذلك تعمل الأدوات نفسها على مجلد محلي، أو على شجرة ملفات في الذاكرة أثناء الاختبارات، أو على container في Docker، أو على sandbox بعيد مثل E2B أو Daytona أو Cloudflare. لشرح عملي كامل، راجع [ابنِ coding agent](/ar/build-a-coding-agent).