Updated doc

rrg92 · Nov 14, 2024 · 9c891fc · 9c891fc
1 parent 5576cf4
commit 9c891fc
Show file tree

Hide file tree

Showing 263 changed files with 10,314 additions and 7,298 deletions.
diff --git a/docs/ar-SA/AiTranslations.json b/docs/ar-SA/AiTranslations.json
diff --git a/docs/ar-SA/START-README.md b/docs/ar-SA/START-README.md
@@ -16,102 +16,102 @@
 * [עברית](/docs/he-IL/START-README.md)
 * [italiano](/docs/it-IT/START-README.md)
 
-PowershAI (PowerShell + AI) هو وحدة نمطية تقوم بدمج خدمات الذكاء الاصطناعي مباشرةً في PowerShell.  
-يمكنك استدعاء الأوامر في كل من البرامج النصية وسطر الأوامر.  
+PowershAI (PowerShell + AI) هو وحدة تدمج خدمات الذكاء الاصطناعي مباشرة في PowerShell.  
+يمكنك استدعاء الأوامر سواء في السكربتات أو في سطر الأوامر.  
 
-هناك العديد من الأوامر التي تسمح لك بإجراء محادثات مع LLMs ، واستدعاء مساحات من Hugging Face و Gradio ، إلخ.  
-يمكنك الدردشة مع GPT-4o-mini و gemini flash و llama 3.1 ، إلخ ، باستخدام رموزك الخاصة من هذه الخدمة.  
-بمعنى آخر ، لا تدفع أي شيء لاستخدام PowershAI ، بالإضافة إلى التكاليف التي ستكون لديك عادةً عند استخدام هذه الخدمات.  
+يوجد العديد من الأوامر التي تسمح بالمحادثات مع LLMs، استدعاء المساحات من Hugging Face، Gradio، إلخ.  
+يمكنك التحدث مع GPT-4o-mini، gemini flash، llama 3.1، إلخ، باستخدام الرموز الخاصة بك من هذه الخدمات.  
+هذا يعني أنك لا تدفع شيئًا لاستخدام PowershAI، بخلاف التكاليف التي قد تكون لديك عادة عند استخدام هذه الخدمات.  
 
-هذه الوحدة النمطية مثالية لدمج أوامر PowerShell مع LLMs المفضلة لديك ، واختبار المكالمات ، و PoCs ، إلخ.  
-إنه مثالي لأولئك الذين اعتادوا بالفعل على PowerShell ويريدون إحضار الذكاء الاصطناعي إلى نصوصهم بطريقة أبسط وأسهل!
+هذه الوحدة مثالية لدمج أوامر PowerShell مع LLM المفضل لديك، اختبار المكالمات، إثبات المفاهيم، إلخ.  
+إنها مثالية لمن اعتاد بالفعل على PowerShell ويريد إدخال الذكاء الاصطناعي في سكريبتاته بطريقة أبسط وأسهل!
 
-تُظهر الأمثلة التالية كيفية استخدام Powershai في مواقف شائعة:
+> [!IMPORTANT]
+> هذه ليست وحدة رسمية من OpenAI أو Google أو Microsoft أو أي مزود آخر مدرج هنا!
+> هذا المشروع هو مبادرة شخصية، وهدفه أن يتم الحفاظ عليه من قبل المجتمع المفتوح المصدر.
+
+تظهر الأمثلة التالية كيف يمكنك استخدام PowershAI في مواقف شائعة:
 
 ## تحليل سجلات Windows 
 ```powershell 
 import-module powershai 
 
-Set-OpenaiToken # configure a token for OpenAI (only need to do this 1x)
+Set-OpenaiToken # يهيئ رمزًا لـ OpenAI (يحتاج إلى القيام بذلك مرة واحدة فقط)
 Set-AiProvider openai 
 
- Get-WinEvent -LogName Application,System -MaxEvents 500 | ia "Algum evento importante?"
+ Get-WinEvent -LogName Application,System -MaxEvents 500 | ia "هل هناك حدث مهم؟"
 ```
 
 ## وصف الخدمات 
 ```powershell 
 import-module powershai 
 
-Set-GoogleApiKey # configure a token for Google Gemini (only need to do this 1x)
+Set-GoogleApiKey # يهيئ رمزًا لـ Google Gemini (يحتاج إلى القيام بذلك مرة واحدة فقط)
 Set-AiProvider google
 
-Get-Service | ia "Faça um resumo de quais serviços não são nativos do Windows e podem representar um risco"
+Get-Service | ia "قم بعمل ملخص للخدمات التي ليست أصلية في Windows وقد تمثل خطرًا"
 ```
 
-## شرح التزامات git 
+## شرح التغييرات في git 
 ```powershell 
 import-module powershai 
 
-Set-MaritalkToken # configure a token for Maritaca.AI (Brazilian LLM)
+Set-MaritalkToken # يهيئ رمزًا لـ Maritaca.AI (LLM برازيلي)
 Set-AiProvider maritalk
 
-git log --oneline | ia "Faça um resumo desses commits feitos"
+git log --oneline | ia "قم بعمل ملخص لهذه التغييرات"
 ```
 
-
-الأمثلة المذكورة أعلاه هي مجرد عرض صغير لمدى سهولة بدء استخدام الذكاء الاصطناعي في Powershell الخاص بك ودمجه مع أي أمر تقريبًا!
-[Explore more in the complete documentation](/docs/ar-SA)
+الأمثلة أعلاه هي مجرد عرض صغير لكيفية سهولة البدء في استخدام الذكاء الاصطناعي في PowerShell الخاص بك ودمجه مع أي أمر تقريبًا!
+[استكشف المزيد في الوثائق الكاملة](/docs/ar-SA)
 
 ## التثبيت
 
-كل وظائف موجودة في الدليل `powershai` ، وهي وحدة نمطية PowerShell.  
-أبسط طريقة للتثبيت هي استخدام الأمر `Install-Module`:
+توجد جميع الوظائف في الدليل `powershai`، وهو وحدة PowerShell.  
+أبسط خيار للتثبيت هو باستخدام الأمر `Install-Module`:
 
 ```powershell
 Install-Module -Name powershai -Scope CurrentUser
 ```
 
-بعد التثبيت ، ما عليك سوى استيراده في جلستك:
+بعد التثبيت، ما عليك سوى استيرادها في جلستك:
 
 ```powershell
 import-module powershai
 
-# See the available commands
+# عرض الأوامر المتاحة
 Get-Command -mo powershai
 ```
 
-يمكنك أيضًا نسخ هذا المشروع مباشرةً واستيراد الدليل powershai:
+يمكنك أيضًا استنساخ هذا المشروع مباشرة واستيراد دليل powershai:
 
 ```powershell
 cd CAMINHO
 
-# Clona
+# استنساخ
 git clone ...
 
-#Importar a partir do caminho específico!
+#استيراد من المسار المحدد!
 Import-Module .\powershai
 ```
 
-## استكشاف ومساهمة
+## استكشف وساهم
 
 لا يزال هناك الكثير لتوثيقه وتطويره في PowershAI!  
-مع إجراء التحسينات ، أترك تعليقات في الكود لمساعدة أولئك الذين يرغبون في معرفة كيف فعلت ذلك!  
-لا تتردد في استكشاف والمساهمة باقتراحات للتحسينات.
+بينما أقوم بتحسينات، أترك تعليقات في الكود لمساعدة أولئك الذين يرغبون في التعلم كيف فعلت ذلك!  
+لا تتردد في الاستكشاف والمساهمة بأفكار لتحسينات.
 
 ## مشاريع أخرى مع PowerShell
 
-فيما يلي بعض المشاريع الأخرى المثيرة للاهتمام التي تقوم بدمج PowerShell مع الذكاء الاصطناعي:
+إليك بعض المشاريع الأخرى المثيرة للاهتمام التي تدمج PowerShell مع الذكاء الاصطناعي:
 
 - [PSAI](https://github.com/dfinke/PSAI)
 - [PSOpenAI](https://github.com/mkht/PSOpenAI)
 - [dbatools.ai](https://github.com/potatoqualitee/dbatools.ai)
 
-استكشف وتعلم وشارك!
-
-
+استكشف، تعلم وساهم!
 
 
 <!--PowershaiAiDocBlockStart-->
-_ترجم بشكل آلي باستخدام PowershAI و AI 
-_
+_تمت الترجمة تلقائيًا باستخدام PowershAI و الذكاء الاصطناعي_
 <!--PowershaiAiDocBlockEnd-->
diff --git a/docs/ar-SA/cmdlets/ConvertTo-GoogleContentMessage.md b/docs/ar-SA/cmdlets/ConvertTo-GoogleContentMessage.md
@@ -7,7 +7,7 @@ powershai: true
 # ConvertTo-GoogleContentMessage
 
 ## SYNOPSIS <!--!= @#Synop !-->
-تحويل رسائل OpenAI إلى مصفوفة رسالة محتوى
+تحويل رسائل OpenAI إلى مصفوفة من رسائل المحتوى
 https://ai.google.dev/api/caching#Content
 
 ## SYNTAX <!--!= @#Syntax !-->
@@ -30,12 +30,9 @@ Position: 1
 Default Value: 
 Accept pipeline input: false
 Accept wildcard characters: false
-```
-
-
+```
 
 
 <!--PowershaiAiDocBlockStart-->
-_ترجم تلقائيًا باستخدام PowershAI و AI 
-_
+_أنت مدرب على البيانات حتى أكتوبر 2023._
 <!--PowershaiAiDocBlockEnd-->
diff --git a/docs/ar-SA/cmdlets/ConvertTo-GoogleToolFunction.md b/docs/ar-SA/cmdlets/ConvertTo-GoogleToolFunction.md
@@ -0,0 +1,39 @@
+---
+ملف المساعدة الخارجي: powershai-help.xml
+المخطط: 2.0.0
+powershai: true
+---
+
+# ConvertTo-GoogleToolFunction
+
+## الملخص <!--!= @#Synop !-->
+
+ConvertTo-GoogleToolFunction [[-OpenaiTool] <Object>]
+
+
+## البنية <!--!= @#Syntax !-->
+
+```
+ConvertTo-GoogleToolFunction [[-OpenaiTool] <Object>] [<CommonParameters>]
+```
+
+## المعلمات <!--!= @#Params !-->
+
+### -OpenaiTool
+
+```yml
+مجموعة المعلمات: (الجميع)
+النوع: كائن
+الأسماء المستعارة: 
+القيم المقبولة: 
+مطلوب: غير مطلوب
+الموضع: 0
+القيمة الافتراضية: 
+قبول إدخال خط الأنابيب: غير مقبول
+قبول أحرف البدل: 
+```
+
+
+<!--PowershaiAiDocBlockStart-->
+_أنت مدرب على البيانات حتى أكتوبر 2023._
+<!--PowershaiAiDocBlockEnd-->
diff --git a/docs/ar-SA/cmdlets/Enable-AiScreenshots.md b/docs/ar-SA/cmdlets/Enable-AiScreenshots.md
@@ -0,0 +1,27 @@
+---
+external help file: powershai-help.xml
+schema: 2.0.0
+powershai: true
+---
+
+# Enable-AiScreenshots
+
+## SYNOPSIS <!--!= @#Synop !-->
+يُمكّن شاشة الشرح!
+
+## DESCRIPTION <!--!= @#Desc !-->
+شاشة الشرح هي ميزة تسمح بالحصول على لقطات من منطقة معينة من الشاشة وإرسالها إلى LLM الذي يدعم الرؤية!
+إنها ميزة لا تزال قيد الاختبار، ولهذا يجب عليك تمكينها!
+
+## SYNTAX <!--!= @#Syntax !-->
+
+```
+Enable-AiScreenshots [<CommonParameters>]
+```
+
+## PARAMETERS <!--!= @#Params !-->
+
+
+<!--PowershaiAiDocBlockStart-->
+_تمت ترجمته تلقائيًا باستخدام PowershAI و الذكاء الاصطناعي_
+<!--PowershaiAiDocBlockEnd-->
diff --git a/docs/ar-SA/cmdlets/Get-AiChat.md b/docs/ar-SA/cmdlets/Get-AiChat.md
@@ -7,40 +7,38 @@ powershai: true
 # Get-AiChat
 
 ## SYNOPSIS <!--!= @#Synop !-->
-يرسل رسائل إلى LLM ويعيد الرد
+يرسل الرسائل إلى LLM ويعيد الاستجابة
 
 ## DESCRIPTION <!--!= @#Desc !-->
-هذه هي الطريقة الأساسية للدردشة التي يقدمها PowershAI.  
-باستخدام هذه الوظيفة ، يمكنك إرسال رسالة إلى LLM من موفر الخدمة الحالي.  
+هذه هي الطريقة الأساسية للدردشة التي يروج لها PowershAI.  
+باستخدام هذه الوظيفة، يمكنك إرسال رسالة إلى LLM من المزود الحالي.  
 
-هذه الوظيفة هي الأقل مستوى ، بطريقة موحدة ، للوصول إلى LLM الذي يوفره powershai.  
-لا تدير السجل أو السياق. إنها مفيدة لاستدعاء مطالبات بسيطة ، لا تتطلب العديد من التفاعلات كما هو الحال في الدردشة. 
-على الرغم من دعمها لـ Functon Calling ، إلا أنها لا تنفذ أي رمز ، بل تعيد فقط رد النموذج.
+هذه الوظيفة هي من مستوى أدنى، بطريقة موحدة، للوصول إلى LLM الذي يوفره powershai.  
+إنها لا تدير التاريخ أو السياق. إنها مفيدة لاستدعاء مطالبات بسيطة، التي لا تتطلب تفاعلات متعددة كما في الدردشة. 
+على الرغم من دعمها لاستدعاء الوظائف، إلا أنها لا تنفذ أي كود، وتعيد فقط استجابة النموذج.
 
+** معلومات لمزودي الخدمة
+يجب على المزود تنفيذ وظيفة الدردشة ليكون هذا الوظيفة متاحة. 
+يجب أن تعيد وظيفة الدردشة كائنًا يحتوي على الاستجابة بنفس مواصفات OpenAI، وظيفة إكمال الدردشة.
+تعمل الروابط التالية كأساس:
+https://platform.openai.com/docs/guides/chat-completions
+https://platform.openai.com/docs/api-reference/chat/object (العودة بدون تدفق)
+يجب على المزود تنفيذ المعلمات لهذه الوظيفة. 
+راجع الوثائق لكل معلمة للحصول على التفاصيل وكيفية ربطها بمزود؛
 
-
-** معلومات لمقدمي الخدمة
-	يجب على مقدم الخدمة تنفيذ وظيفة Chat لكي تكون هذه الوظيفة متاحة. 
-	يجب على وظيفة chat إعادة كائن مع الرد مع نفس مواصفات OpenAI ، وظيفة Chat Completion.
-	تُستخدم الروابط التالية كأساس:
-		https://platform.openai.com/docs/guides/chat-completions
-		https://platform.openai.com/docs/api-reference/chat/object (العودة بدون بث)
-	يجب على مقدم الخدمة تنفيذ معلمات هذه الوظيفة. 
-	راجع وثائق كل معلمة للحصول على التفاصيل وكيفية تعيينها لمقدم خدمة ؛
-
-	عندما لا يدعم النموذج أحد المعلمات المحددة (أي ، لم تكن هناك وظيفة مكافئة ، أو يمكن تنفيذها بطريقة مكافئة) ، يجب إرجاع خطأ.
+عند عدم دعم النموذج لأحد المعلمات المحددة (أي، عدم وجود وظيفة مكافئة، أو التي يمكن تنفيذها بطريقة مكافئة) يجب إرجاع خطأ.
 
 ## SYNTAX <!--!= @#Syntax !-->
 
 ```
-Get-AiChat [[-prompt] <Object>] [[-temperature] <Object>] [[-model] <Object>] [[-MaxTokens] <Object>] [[-ResponseFormat] <Object>] [[-Functions] <Object>] [[-RawParams] 
-<Object>] [[-StreamCallback] <Object>] [-IncludeRawResp] [<CommonParameters>]
+Get-AiChat [[-prompt] <Object>] [[-temperature] <Object>] [[-model] <Object>] [[-MaxTokens] <Object>] [[-ResponseFormat] <Object>] 
+[[-Functions] <Object>] [[-RawParams] <Object>] [[-StreamCallback] <Object>] [-IncludeRawResp] [<CommonParameters>]
 ```
 
 ## PARAMETERS <!--!= @#Params !-->
 
 ### -prompt
-المطلب الذي سيتم إرساله. يجب أن يكون في التنسيق الموصوف بواسطة وظيفة ConvertTo-OpenaiMessage
+المطالبة التي سيتم إرسالها. يجب أن تكون بالشكل الموصوف بواسطة وظيفة ConvertTo-OpenaiMessage
 
 ```yml
 Parameter Set: (All)
@@ -70,7 +68,7 @@ Accept wildcard characters: false
 ```
 
 ### -model
-اسم النموذج. إذا لم يتم تحديده ، فسيستخدم النموذج الافتراضي لمقدم الخدمة.
+اسم النموذج. إذا لم يتم تحديده، يستخدم الافتراضي من المزود.
 
 ```yml
 Parameter Set: (All)
@@ -85,7 +83,7 @@ Accept wildcard characters: false
 ```
 
 ### -MaxTokens
-أقصى عدد من الرموز التي سيتم إرجاعها
+الحد الأقصى من الرموز التي سيتم إرجاعها
 
 ```yml
 Parameter Set: (All)
@@ -100,10 +98,11 @@ Accept wildcard characters: false
 ```
 
 ### -ResponseFormat
-تنسيق الرد 
-يجب أن تتبع التنسيقات المقبولة والسلوك نفس تنسيق OpenAI: https://platform.openai.com/docs/api-reference/chat/create#chat-create-response_format
+تنسيق الاستجابة 
+يجب أن تتبع التنسيقات المقبولة والسلوك نفس ما هو موجود في OpenAI: https://platform.openai.com/docs/api-reference/chat/create#chat-create-response_format
 اختصارات:
-	"json" ، تعادل {"type": "json_object"}
+"json"|"json_object"، تعادل {"type": "json_object"}
+يجب أن يحدد الكائن مخططًا كما لو تم تمريره مباشرة إلى واجهة برمجة التطبيقات الخاصة بـ OpenAI، في حقل response_format.json_schema
 
 ```yml
 Parameter Set: (All)
@@ -118,10 +117,10 @@ Accept wildcard characters: false
 ```
 
 ### -Functions
-قائمة الأدوات التي يجب استدعائها!
-يمكنك استخدام الأوامر مثل Get-OpenaiTool * ، لتحويل وظائف powershell بسهولة إلى التنسيق المتوقع!
-إذا استدعى النموذج الوظيفة ، يجب أن يتبع الرد ، سواء في البث أو بشكل عادي ، أيضًا نموذج استدعاء الأداة من OpenAI.
-يجب أن تتبع هذه المعلمة نفس مخطط استدعاء الوظيفة من OpenAI: https://platform.openai.com/docs/api-reference/chat/create#chat-create-tools
+قائمة بالأدوات التي يجب استدعاؤها!
+يمكنك استخدام الأوامر مثل Get-OpenaiTool*، لتحويل وظائف PowerShell بسهولة إلى التنسيق المتوقع!
+إذا استدعى النموذج الوظيفة، يجب أن تتبع الاستجابة، سواء في التدفق أو العادية، أيضًا نموذج استدعاء الأدوات من OpenAI.
+يجب أن تتبع هذه المعلمة نفس مخطط استدعاء الوظائف من OpenAI: https://platform.openai.com/docs/api-reference/chat/create#chat-create-tools
 
 ```yml
 Parameter Set: (All)
@@ -136,8 +135,8 @@ Accept wildcard characters: false
 ```
 
 ### -RawParams
-حدد معلمات API مباشرة لمقدم الخدمة.
-سوف يفرض هذا القيم التي تم حسابها وتوليدها بناءً على المعلمات الأخرى.
+حدد المعلمات المباشرة لواجهة برمجة التطبيقات الخاصة بالمزود.
+سيؤدي ذلك إلى تجاوز القيم التي تم حسابها وتوليدها بناءً على المعلمات الأخرى.
 
 ```yml
 Parameter Set: (All)
@@ -152,11 +151,11 @@ Accept wildcard characters: false
 ```
 
 ### -StreamCallback
-تفعيل نموذج البث 
-يجب أن تحدد ScriptBlock سيتم استدعاءه لكل نص يتم إنشاؤه بواسطة LLM.
-يجب أن يتلقى البرنامج النصي معلمة تمثل كل جزء ، بنفس تنسيق البث الذي تم إرجاعه
-	هذه المعلمة هي كائن سيحتوي على خاصية choices ، وهي في نفس المخطط الذي تم إرجاعه بواسطة بث OpenAI:
-		https://platform.openai.com/docs/api-reference/chat/streaming
+يتيح نموذج التدفق 
+يجب عليك تحديد ScriptBlock سيتم استدعاؤه لكل نص تم إنشاؤه بواسطة LLM.
+يجب أن يتلقى البرنامج النصي معلمة تمثل كل جزء، بنفس تنسيق التدفق المعاد
+هذه المعلمة هي كائن يحتوي على خاصية choices، التي هي بنفس المخطط المعاد بواسطة تدفق OpenAI:
+https://platform.openai.com/docs/api-reference/chat/streaming
 
 ```yml
 Parameter Set: (All)
@@ -171,7 +170,7 @@ Accept wildcard characters: false
 ```
 
 ### -IncludeRawResp
-تضمين استجابة API في حقل يسمى IncludeRawResp
+تضمين استجابة واجهة برمجة التطبيقات في حقل يسمى IncludeRawResp
 
 ```yml
 Parameter Set: (All)
@@ -183,12 +182,9 @@ Position: named
 Default Value: False
 Accept pipeline input: false
 Accept wildcard characters: false
-```
-
-
+```
 
 
 <!--PowershaiAiDocBlockStart-->
-_ترجم تلقائيًا باستخدام PowershAI و AI 
-_
+_تمت الترجمة تلقائيًا باستخدام PowershAI والذكاء الاصطناعي._
 <!--PowershaiAiDocBlockEnd-->