Merge branch 'main' of https://github.com/microsoft/Generative-AI-for-beginners-java

Author: roryp

.github/workflows/co-op-translator.yml

@@ -12,6 +12,7 @@ jobs:
     permissions:
       contents: write
       pull-requests: write
+      issues: write
 
     steps:
       - name: Checkout repository

translations/ar/README.md

@@ -1,15 +1,17 @@
 <!--
 CO_OP_TRANSLATOR_METADATA:
 {
-  "original_hash": "63b6426b88f6f56398ca3f1fbfc30889",
-  "translation_date": "2025-07-29T08:05:54+00:00",
+  "original_hash": "90ac762d40c6db51b8081cdb3e49e9db",
+  "translation_date": "2025-08-07T11:01:35+00:00",
   "source_file": "README.md",
   "language_code": "ar"
 }
 -->
 # الذكاء الاصطناعي التوليدي للمبتدئين - إصدار Java
 
-**مدة الالتزام**: يمكن إكمال الورشة بالكامل عبر الإنترنت دون الحاجة إلى إعداد محلي. يستغرق إعداد البيئة دقيقتين، بينما يتطلب استكشاف الأمثلة من 1 إلى 3 ساعات حسب عمق الاستكشاف.
+![Generative AI for Beginners - Java Edition](../../translated_images/beg-genai-series.8b48be9951cc574c25f8a3accba949bfd03c2f008e2c613283a1b47316fbee68.ar.png)
+
+**الوقت المطلوب**: يمكن إكمال الورشة بالكامل عبر الإنترنت دون الحاجة إلى إعداد محلي. يستغرق إعداد البيئة دقيقتين، بينما يتطلب استكشاف الأمثلة من 1 إلى 3 ساعات حسب عمق الاستكشاف.
 
 > **البدء السريع**
 
@@ -30,39 +32,40 @@ CO_OP_TRANSLATOR_METADATA:
 
 ### **الفصل الأول: مقدمة في الذكاء الاصطناعي التوليدي**
 - **المفاهيم الأساسية**: فهم نماذج اللغة الكبيرة، الرموز، التضمينات، وقدرات الذكاء الاصطناعي
-- **نظام الذكاء الاصطناعي في Java**: نظرة عامة على Spring AI و OpenAI SDKs
+- **نظام Java للذكاء الاصطناعي**: نظرة عامة على Spring AI و OpenAI SDKs
 - **بروتوكول سياق النموذج**: مقدمة عن MCP ودوره في تواصل وكلاء الذكاء الاصطناعي
 - **التطبيقات العملية**: سيناريوهات واقعية تشمل روبوتات الدردشة وتوليد المحتوى
 - **[→ ابدأ الفصل الأول](./01-IntroToGenAI/README.md)**
 
 ### **الفصل الثاني: إعداد بيئة التطوير**
-- **تكوين متعدد المزودين**: إعداد نماذج GitHub، Azure OpenAI، وتكامل OpenAI Java SDK
+- **إعداد متعدد المزودين**: تكامل نماذج GitHub و Azure OpenAI و OpenAI Java SDK
 - **Spring Boot + Spring AI**: أفضل الممارسات لتطوير تطبيقات الذكاء الاصطناعي للمؤسسات
-- **نماذج GitHub**: الوصول المجاني إلى نماذج الذكاء الاصطناعي للتجربة والتعلم (لا حاجة لبطاقة ائتمان)
-- **أدوات التطوير**: تكوين حاويات Docker، VS Code، و GitHub Codespaces
+- **نماذج GitHub**: الوصول إلى نماذج الذكاء الاصطناعي مجانًا للتجربة والتعلم (لا حاجة لبطاقة ائتمان)
+- **أدوات التطوير**: إعداد حاويات Docker، VS Code، و GitHub Codespaces
 - **[→ ابدأ الفصل الثاني](./02-SetupDevEnvironment/README.md)**
 
 ### **الفصل الثالث: تقنيات الذكاء الاصطناعي التوليدي الأساسية**
-- **هندسة المطالبات**: تقنيات للحصول على استجابات مثالية من نماذج الذكاء الاصطناعي
+- **هندسة التوجيه**: تقنيات للحصول على استجابات مثلى من نماذج الذكاء الاصطناعي
 - **التضمينات وعمليات المتجهات**: تنفيذ البحث الدلالي ومطابقة التشابه
-- **توليد معزز بالاسترجاع (RAG)**: دمج الذكاء الاصطناعي مع مصادر البيانات الخاصة بك
+- **توليد البيانات المعزز بالاسترجاع (RAG)**: دمج الذكاء الاصطناعي مع مصادر البيانات الخاصة بك
 - **استدعاء الوظائف**: توسيع قدرات الذكاء الاصطناعي باستخدام أدوات ومكونات إضافية مخصصة
 - **[→ ابدأ الفصل الثالث](./03-CoreGenerativeAITechniques/README.md)**
 
 ### **الفصل الرابع: التطبيقات العملية والمشاريع**
 - **مولد قصص الحيوانات الأليفة** (`petstory/`): توليد محتوى إبداعي باستخدام نماذج GitHub
 - **عرض محلي لـ Foundry** (`foundrylocal/`): تكامل نماذج الذكاء الاصطناعي المحلية مع OpenAI Java SDK
-- **خدمة حاسبة MCP** (`calculator/`): تنفيذ أساسي لبروتوكول سياق النموذج باستخدام Spring AI
+- **خدمة حاسبة MCP** (`calculator/`): تنفيذ بروتوكول سياق النموذج الأساسي باستخدام Spring AI
 - **[→ ابدأ الفصل الرابع](./04-PracticalSamples/README.md)**
 
 ### **الفصل الخامس: تطوير الذكاء الاصطناعي المسؤول**
-- **سلامة نماذج GitHub**: اختبار تصفية المحتوى المدمجة وآليات السلامة (الحظر الصارم والرفض الناعم)
+- **سلامة نماذج GitHub**: اختبار تصفية المحتوى وآليات السلامة المدمجة (الحظر الصارم والرفض الناعم)
 - **عرض الذكاء الاصطناعي المسؤول**: مثال عملي يوضح كيفية عمل أنظمة السلامة الحديثة للذكاء الاصطناعي
-- **أفضل الممارسات**: إرشادات أساسية لتطوير ونشر الذكاء الاصطناعي الأخلاقي
+- **أفضل الممارسات**: إرشادات أساسية لتطوير ونشر الذكاء الاصطناعي بشكل أخلاقي
 - **[→ ابدأ الفصل الخامس](./05-ResponsibleGenAI/README.md)**
 
 ## موارد إضافية
 
+- [MCP للمبتدئين](https://github.com/microsoft/mcp-for-beginners)
 - [وكلاء الذكاء الاصطناعي للمبتدئين](https://github.com/microsoft/ai-agents-for-beginners)
 - [الذكاء الاصطناعي التوليدي للمبتدئين باستخدام .NET](https://github.com/microsoft/Generative-AI-for-beginners-dotnet)
 - [الذكاء الاصطناعي التوليدي للمبتدئين باستخدام JavaScript](https://github.com/microsoft/generative-ai-with-javascript)
@@ -73,7 +76,7 @@ CO_OP_TRANSLATOR_METADATA:
 - [الأمن السيبراني للمبتدئين](https://github.com/microsoft/Security-101)
 - [تطوير الويب للمبتدئين](https://aka.ms/webdev-beginners)
 - [إنترنت الأشياء للمبتدئين](https://aka.ms/iot-beginners)
-- [تطوير الواقع الممتد للمبتدئين](https://github.com/microsoft/xr-development-for-beginners)
+- [تطوير XR للمبتدئين](https://github.com/microsoft/xr-development-for-beginners)
 - [إتقان GitHub Copilot للبرمجة المزدوجة بالذكاء الاصطناعي](https://aka.ms/GitHubCopilotAI)
 - [إتقان GitHub Copilot لمطوري C#/.NET](https://github.com/microsoft/mastering-github-copilot-for-dotnet-csharp-developers)
 - [اختر مغامرتك الخاصة مع Copilot](https://github.com/microsoft/CopilotAdventures)

translations/bg/README.md

@@ -1,20 +1,20 @@
 <!--
 CO_OP_TRANSLATOR_METADATA:
 {
-  "original_hash": "63b6426b88f6f56398ca3f1fbfc30889",
-  "translation_date": "2025-07-29T10:10:29+00:00",
+  "original_hash": "90ac762d40c6db51b8081cdb3e49e9db",
+  "translation_date": "2025-08-07T11:21:14+00:00",
   "source_file": "README.md",
   "language_code": "bg"
 }
 -->
 # Генеративен AI за начинаещи - Java издание
 [![Microsoft Azure AI Foundry Discord](https://dcbadge.limes.pink/api/server/ByRwuEEgH4)](https://discord.com/invite/ByRwuEEgH4)
 
-![Generative AI for Beginners - Java Edition](../../translated_images/beg-genai-series.8b48be9951cc574c25f8a3accba949bfd03c2f008e2c613283a1b47316fbee68.bg.png)
+![Генеративен AI за начинаещи - Java издание](../../translated_images/beg-genai-series.8b48be9951cc574c25f8a3accba949bfd03c2f008e2c613283a1b47316fbee68.bg.png)
 
-**Време за изпълнение**: Целият уъркшоп може да бъде завършен онлайн без локална настройка. Настройката на средата отнема 2 минути, а изследването на примерите изисква 1-3 часа в зависимост от дълбочината на изследването.
+**Време за изпълнение**: Целият уъркшоп може да бъде завършен онлайн без локална настройка. Настройката на средата отнема 2 минути, а изследването на примерите изисква 1-3 часа в зависимост от дълбочината на проучването.
 
-> **Бърз старт** 
+> **Бърз старт**
 
 1. Направете fork на това хранилище във вашия GitHub акаунт
 2. Кликнете **Code** → **Codespaces** таб → **...** → **New with options...**
@@ -41,31 +41,32 @@ CO_OP_TRANSLATOR_METADATA:
 ### **Глава 2: Настройка на среда за разработка**
 - **Конфигурация за множество доставчици**: Настройка на GitHub Models, Azure OpenAI и OpenAI Java SDK интеграции
 - **Spring Boot + Spring AI**: Най-добри практики за разработка на корпоративни AI приложения
-- **GitHub Models**: Безплатен достъп до AI модели за прототипиране и обучение (без нужда от кредитна карта)
+- **GitHub Models**: Безплатен достъп до AI модели за прототипиране и обучение (без необходимост от кредитна карта)
 - **Инструменти за разработка**: Конфигурация на Docker контейнери, VS Code и GitHub Codespaces
 - **[→ Започнете Глава 2](./02-SetupDevEnvironment/README.md)**
 
 ### **Глава 3: Основни техники за Генеративен AI**
 - **Инженеринг на подканите**: Техники за оптимални отговори от AI моделите
 - **Вграждания и векторни операции**: Имплементация на семантично търсене и съвпадение по сходство
-- **Генерация с извличане (RAG)**: Комбиниране на AI с ваши собствени източници на данни
+- **Генериране с допълнено извличане (RAG)**: Комбиниране на AI с ваши собствени източници на данни
 - **Извикване на функции**: Разширяване на AI възможностите с персонализирани инструменти и плъгини
 - **[→ Започнете Глава 3](./03-CoreGenerativeAITechniques/README.md)**
 
 ### **Глава 4: Практически приложения и проекти**
 - **Генератор на истории за домашни любимци** (`petstory/`): Генериране на креативно съдържание с GitHub Models
-- **Foundry Local Demo** (`foundrylocal/`): Локална интеграция на AI модели с OpenAI Java SDK
-- **MCP Калкулатор услуга** (`calculator/`): Основна имплементация на Протокол за контекст на модела със Spring AI
+- **Локална демонстрация на Foundry** (`foundrylocal/`): Локална интеграция на AI модел с OpenAI Java SDK
+- **Калкулатор на MCP** (`calculator/`): Основна имплементация на Протокол за контекст на модела със Spring AI
 - **[→ Започнете Глава 4](./04-PracticalSamples/README.md)**
 
 ### **Глава 5: Отговорна разработка на AI**
 - **Безопасност на GitHub Models**: Тестване на вградени механизми за филтриране на съдържание и безопасност (твърди блокировки и меки откази)
-- **Демо за отговорен AI**: Практически пример, показващ как работят съвременните системи за безопасност на AI
+- **Демонстрация на отговорен AI**: Практически пример, показващ как работят съвременните системи за безопасност на AI
 - **Най-добри практики**: Основни насоки за етично разработване и внедряване на AI
 - **[→ Започнете Глава 5](./05-ResponsibleGenAI/README.md)**
 
-## Допълнителни ресурси 
+## Допълнителни ресурси
 
+- [MCP For Beginners](https://github.com/microsoft/mcp-for-beginners)
 - [AI Agents For Beginners](https://github.com/microsoft/ai-agents-for-beginners)
 - [Generative AI for Beginners using .NET](https://github.com/microsoft/Generative-AI-for-beginners-dotnet)
 - [Generative AI for Beginners using JavaScript](https://github.com/microsoft/generative-ai-with-javascript)
@@ -83,4 +84,4 @@ CO_OP_TRANSLATOR_METADATA:
 - [RAG Chat App with Azure AI Services](https://github.com/Azure-Samples/azure-search-openai-demo-java)
 
 **Отказ от отговорност**:  
-Този документ е преведен с помощта на AI услуга за превод [Co-op Translator](https://github.com/Azure/co-op-translator). Въпреки че се стремим към точност, моля, имайте предвид, че автоматичните преводи може да съдържат грешки или неточности. Оригиналният документ на неговия изходен език трябва да се счита за авторитетен източник. За критична информация се препоръчва професионален човешки превод. Ние не носим отговорност за каквито и да било недоразумения или погрешни интерпретации, произтичащи от използването на този превод.
+Този документ е преведен с помощта на AI услуга за превод [Co-op Translator](https://github.com/Azure/co-op-translator). Въпреки че се стремим към точност, моля, имайте предвид, че автоматизираните преводи може да съдържат грешки или неточности. Оригиналният документ на неговия роден език трябва да се счита за авторитетен източник. За критична информация се препоръчва професионален човешки превод. Не носим отговорност за недоразумения или погрешни интерпретации, произтичащи от използването на този превод.