Skip to content

Commit fe66e7d

Browse files
roryproryp
authored
Merge pull request #62 from microsoft/update-translations
🌐 Update translations via Co-op Translator
2 parents d5eff91 + 2065ea0 commit fe66e7d

48 files changed

Lines changed: 2114 additions & 1613 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

‎translations/ar/04-PracticalSamples/calculator/README.md‎

Lines changed: 28 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -1,13 +1,13 @@
11
<!--
22
CO_OP_TRANSLATOR_METADATA:
33
{
4-
"original_hash": "82ea3c5a1b9d4bf4f1e2d906649e874e",
5-
"translation_date": "2025-07-28T11:23:02+00:00",
4+
"original_hash": "b6c16b5514d524e415a94f6097ee7d4c",
5+
"translation_date": "2025-09-18T15:24:06+00:00",
66
"source_file": "04-PracticalSamples/calculator/README.md",
77
"language_code": "ar"
88
}
99
-->
10-
# دليل MCP Calculator للمبتدئين
10+
# دليل استخدام MCP Calculator للمبتدئين
1111

1212
## جدول المحتويات
1313

@@ -18,7 +18,7 @@ CO_OP_TRANSLATOR_METADATA:
1818
- [1. التطبيق الرئيسي](../../../../04-PracticalSamples/calculator)
1919
- [2. خدمة الآلة الحاسبة](../../../../04-PracticalSamples/calculator)
2020
- [3. عميل MCP المباشر](../../../../04-PracticalSamples/calculator)
21-
- [4. العميل المدعوم بالذكاء الاصطناعي](../../../../04-PracticalSamples/calculator)
21+
- [4. عميل مدعوم بالذكاء الاصطناعي](../../../../04-PracticalSamples/calculator)
2222
- [تشغيل الأمثلة](../../../../04-PracticalSamples/calculator)
2323
- [كيف تعمل جميع الأجزاء معًا](../../../../04-PracticalSamples/calculator)
2424
- [الخطوات التالية](../../../../04-PracticalSamples/calculator)
@@ -34,8 +34,8 @@ CO_OP_TRANSLATOR_METADATA:
3434

3535
## المتطلبات الأساسية
3636

37-
قبل البدء، تأكد من توفر ما يلي لديك:
38-
- Java 21 أو إصدار أعلى مثبت
37+
قبل البدء، تأكد من توفر ما يلي:
38+
- تثبيت Java 21 أو أعلى
3939
- Maven لإدارة التبعيات
4040
- حساب GitHub مع رمز وصول شخصي (PAT)
4141
- فهم أساسي لـ Java وSpring Boot
@@ -81,7 +81,7 @@ public class McpServerApplication {
8181
**ما الذي يفعله:**
8282
- يبدأ خادم ويب Spring Boot على المنفذ 8080
8383
- ينشئ `ToolCallbackProvider` لجعل طرق الآلة الحاسبة متاحة كأدوات MCP
84-
- تشير التعليمة `@Bean` إلى Spring لإدارة هذا كعنصر يمكن استخدامه من قبل أجزاء أخرى
84+
- تخبر التعليمة `@Bean` Spring بإدارة هذا كعنصر يمكن استخدامه من قبل أجزاء أخرى
8585

8686
### 2. خدمة الآلة الحاسبة
8787

@@ -115,18 +115,18 @@ public class CalculatorService {
115115

116116
**الميزات الرئيسية:**
117117

118-
1. **تعليمة `@Tool`:** تشير إلى أن هذه الطريقة يمكن استدعاؤها من قبل العملاء الخارجيين
118+
1. **تعليمة `@Tool`:** تخبر MCP أن هذه الطريقة يمكن استدعاؤها من قبل العملاء الخارجيين
119119
2. **وصف واضح:** كل أداة تحتوي على وصف يساعد نماذج الذكاء الاصطناعي على فهم متى يجب استخدامها
120120
3. **تنسيق نتائج متسق:** جميع العمليات تعيد نصوصًا قابلة للقراءة مثل "5.00 + 3.00 = 8.00"
121121
4. **معالجة الأخطاء:** القسمة على الصفر والجذور التربيعية السالبة تعيد رسائل خطأ
122122

123123
**العمليات المتاحة:**
124124
- `add(a, b)` - جمع رقمين
125-
- `subtract(a, b)` - طرح الرقم الثاني من الأول
125+
- `subtract(a, b)` - طرح الثاني من الأول
126126
- `multiply(a, b)` - ضرب رقمين
127-
- `divide(a, b)` - قسمة الرقم الأول على الثاني (مع التحقق من القسمة على الصفر)
127+
- `divide(a, b)` - قسمة الأول على الثاني (مع فحص الصفر)
128128
- `power(base, exponent)` - رفع الأساس إلى قوة الأس
129-
- `squareRoot(number)` - حساب الجذر التربيعي (مع التحقق من الأرقام السالبة)
129+
- `squareRoot(number)` - حساب الجذر التربيعي (مع فحص السالب)
130130
- `modulus(a, b)` - إرجاع باقي القسمة
131131
- `absolute(number)` - إرجاع القيمة المطلقة
132132
- `help()` - إرجاع معلومات حول جميع العمليات
@@ -135,15 +135,15 @@ public class CalculatorService {
135135

136136
**الملف:** `SDKClient.java`
137137

138-
يتواصل هذا العميل مباشرة مع خادم MCP دون استخدام الذكاء الاصطناعي. يقوم باستدعاء وظائف الآلة الحاسبة يدويًا:
138+
هذا العميل يتواصل مباشرة مع خادم MCP دون استخدام الذكاء الاصطناعي. يقوم باستدعاء وظائف الآلة الحاسبة يدويًا:
139139

140140
```java
141141
public class SDKClient {
142142

143143
public static void main(String[] args) {
144-
var transport = new WebFluxSseClientTransport(
144+
McpClientTransport transport = WebFluxSseClientTransport.builder(
145145
WebClient.builder().baseUrl("http://localhost:8080")
146-
);
146+
).build();
147147
new SDKClient(transport).run();
148148
}
149149

@@ -172,18 +172,20 @@ public class SDKClient {
172172
```
173173

174174
**ما الذي يفعله:**
175-
1. **يتصل** بخادم الآلة الحاسبة على `http://localhost:8080`
176-
2. **يعرض** جميع الأدوات المتاحة (وظائف الآلة الحاسبة)
177-
3. **يستدعي** وظائف محددة مع معلمات دقيقة
178-
4. **يطبع** النتائج مباشرة
175+
1. **يتصل** بخادم الآلة الحاسبة على `http://localhost:8080` باستخدام نمط البناء
176+
2. **يستعرض** جميع الأدوات المتاحة (وظائف الآلة الحاسبة)
177+
3. **يستدعي** وظائف محددة بمعلمات دقيقة
178+
4. **يعرض** النتائج مباشرة
179+
180+
**ملاحظة:** يستخدم هذا المثال إصدار Spring AI 1.1.0-SNAPSHOT الذي قدم نمط البناء لـ `WebFluxSseClientTransport`. إذا كنت تستخدم إصدارًا أقدم، قد تحتاج إلى استخدام المُنشئ المباشر بدلاً من ذلك.
179181

180182
**متى تستخدم هذا:** عندما تعرف بالضبط العملية الحسابية التي تريد تنفيذها وترغب في استدعائها برمجيًا.
181183

182-
### 4. العميل المدعوم بالذكاء الاصطناعي
184+
### 4. عميل مدعوم بالذكاء الاصطناعي
183185

184186
**الملف:** `LangChain4jClient.java`
185187

186-
يستخدم هذا العميل نموذج ذكاء اصطناعي (GPT-4o-mini) يمكنه اختيار أدوات الآلة الحاسبة تلقائيًا:
188+
هذا العميل يستخدم نموذج ذكاء اصطناعي (GPT-4o-mini) يمكنه اختيار أدوات الآلة الحاسبة تلقائيًا:
187189

188190
```java
189191
public class LangChain4jClient {
@@ -232,7 +234,7 @@ public class LangChain4jClient {
232234
1. **ينشئ** اتصالًا بنموذج الذكاء الاصطناعي باستخدام رمز GitHub الخاص بك
233235
2. **يتصل** بخادم MCP الخاص بالآلة الحاسبة
234236
3. **يمنح** الذكاء الاصطناعي الوصول إلى جميع أدوات الآلة الحاسبة
235-
4. **يسمح** بطلبات اللغة الطبيعية مثل "احسب مجموع 24.5 و17.3"
237+
4. **يسمح** بطلبات باللغة الطبيعية مثل "احسب مجموع 24.5 و17.3"
236238

237239
**الذكاء الاصطناعي تلقائيًا:**
238240
- يفهم أنك تريد جمع الأرقام
@@ -267,7 +269,7 @@ mvn clean spring-boot:run
267269
Started McpServerApplication in X.XXX seconds
268270
```
269271

270-
### الخطوة 2: اختبار مع العميل المباشر
272+
### الخطوة 2: اختبار العميل المباشر
271273

272274
في نافذة **جديدة** مع استمرار تشغيل الخادم، قم بتشغيل عميل MCP المباشر:
273275
```bash
@@ -282,7 +284,7 @@ Add Result = 5.00 + 3.00 = 8.00
282284
Square Root Result = √16.00 = 4.00
283285
```
284286

285-
### الخطوة 3: اختبار مع العميل المدعوم بالذكاء الاصطناعي
287+
### الخطوة 3: اختبار العميل المدعوم بالذكاء الاصطناعي
286288

287289
```bash
288290
mvn test-compile exec:java -Dexec.mainClass="com.microsoft.mcp.sample.client.LangChain4jClient" -Dexec.classpathScope=test
@@ -308,12 +310,14 @@ The square root of 144 is 12.
308310
3. **الذكاء الاصطناعي** يستدعي خادم MCP: `add(5.0, 3.0)`
309311
4. **خدمة الآلة الحاسبة** تنفذ: `5.0 + 3.0 = 8.0`
310312
5. **خدمة الآلة الحاسبة** تعيد: `"5.00 + 3.00 = 8.00"`
311-
6. **الذكاء الاصطناعي** يتلقى النتيجة ويصيغ استجابة طبيعية
313+
6. **الذكاء الاصطناعي** يستلم النتيجة ويصيغ استجابة طبيعية
312314
7. **أنت** تحصل على: "مجموع 5 و3 هو 8"
313315

314316
## الخطوات التالية
315317

316318
للحصول على المزيد من الأمثلة، راجع [الفصل 04: أمثلة عملية](../README.md)
317319

320+
---
321+
318322
**إخلاء المسؤولية**:
319323
تم ترجمة هذا المستند باستخدام خدمة الترجمة بالذكاء الاصطناعي [Co-op Translator](https://github.com/Azure/co-op-translator). بينما نسعى لتحقيق الدقة، يرجى العلم أن الترجمات الآلية قد تحتوي على أخطاء أو معلومات غير دقيقة. يجب اعتبار المستند الأصلي بلغته الأصلية المصدر الرسمي. للحصول على معلومات حاسمة، يُوصى بالاستعانة بترجمة بشرية احترافية. نحن غير مسؤولين عن أي سوء فهم أو تفسيرات خاطئة تنشأ عن استخدام هذه الترجمة.

‎translations/bg/04-PracticalSamples/calculator/README.md‎

Lines changed: 16 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
11
<!--
22
CO_OP_TRANSLATOR_METADATA:
33
{
4-
"original_hash": "82ea3c5a1b9d4bf4f1e2d906649e874e",
5-
"translation_date": "2025-07-28T11:38:56+00:00",
4+
"original_hash": "b6c16b5514d524e415a94f6097ee7d4c",
5+
"translation_date": "2025-09-18T15:40:37+00:00",
66
"source_file": "04-PracticalSamples/calculator/README.md",
77
"language_code": "bg"
88
}
@@ -61,7 +61,7 @@ calculator/
6161

6262
**Файл:** `McpServerApplication.java`
6363

64-
Това е началната точка на нашата услуга за калкулатор. Това е стандартно Spring Boot приложение с една специална добавка:
64+
Това е началната точка на нашата услуга за калкулатор. Това е стандартно Spring Boot приложение с едно специално допълнение:
6565

6666
```java
6767
@SpringBootApplication
@@ -135,15 +135,15 @@ public class CalculatorService {
135135

136136
**Файл:** `SDKClient.java`
137137

138-
Този клиент комуникира директно със сървъра MCP, без да използва AI. Ръчно извиква специфични функции на калкулатора:
138+
Този клиент комуникира директно с MCP сървъра, без да използва AI. Ръчно извиква специфични функции на калкулатора:
139139

140140
```java
141141
public class SDKClient {
142142

143143
public static void main(String[] args) {
144-
var transport = new WebFluxSseClientTransport(
144+
McpClientTransport transport = WebFluxSseClientTransport.builder(
145145
WebClient.builder().baseUrl("http://localhost:8080")
146-
);
146+
).build();
147147
new SDKClient(transport).run();
148148
}
149149

@@ -172,11 +172,13 @@ public class SDKClient {
172172
```
173173

174174
**Какво прави:**
175-
1. **Свързва се** със сървъра на калкулатора на `http://localhost:8080`
175+
1. **Свързва се** със сървъра на калкулатора на `http://localhost:8080`, използвайки builder pattern
176176
2. **Изброява** всички достъпни инструменти (функциите на калкулатора)
177177
3. **Извиква** специфични функции с точни параметри
178178
4. **Принтира** резултатите директно
179179

180+
**Забележка:** Този пример използва Spring AI 1.1.0-SNAPSHOT зависимост, която въведе builder pattern за `WebFluxSseClientTransport`. Ако използвате по-стара стабилна версия, може да се наложи да използвате директен конструктор вместо това.
181+
180182
**Кога да го използвате:** Когато знаете точно коя операция искате да извършите и искате да я извикате програмно.
181183

182184
### 4. Клиент с AI
@@ -267,7 +269,7 @@ mvn clean spring-boot:run
267269
Started McpServerApplication in X.XXX seconds
268270
```
269271

270-
### Стъпка 2: Тествайте с директен клиент
272+
### Стъпка 2: Тест с директен клиент
271273

272274
В **НОВ** терминал, докато сървърът все още работи, стартирайте директния MCP клиент:
273275
```bash
@@ -282,7 +284,7 @@ Add Result = 5.00 + 3.00 = 8.00
282284
Square Root Result = √16.00 = 4.00
283285
```
284286

285-
### Стъпка 3: Тествайте с AI клиент
287+
### Стъпка 3: Тест с AI клиент
286288

287289
```bash
288290
mvn test-compile exec:java -Dexec.mainClass="com.microsoft.mcp.sample.client.LangChain4jClient" -Dexec.classpathScope=test
@@ -296,8 +298,8 @@ The square root of 144 is 12.
296298

297299
### Стъпка 4: Затворете MCP сървъра
298300

299-
Когато приключите с тестването, можете да спрете AI клиента, като натиснете `Ctrl+C` в неговия терминал. MCP сървърът ще продължи да работи, докато не го спрете.
300-
За да спрете сървъра, натиснете `Ctrl+C` в терминала, където той работи.
301+
Когато приключите с тестовете, можете да спрете AI клиента, като натиснете `Ctrl+C` в неговия терминал. MCP сървърът ще продължи да работи, докато не го спрете.
302+
За да спрете сървъра, натиснете `Ctrl+C` в терминала, където работи.
301303

302304
## Как всичко работи заедно
303305

@@ -315,5 +317,7 @@ The square root of 144 is 12.
315317

316318
За повече примери, вижте [Глава 04: Практически примери](../README.md)
317319

320+
---
321+
318322
**Отказ от отговорност**:
319-
Този документ е преведен с помощта на AI услуга за превод [Co-op Translator](https://github.com/Azure/co-op-translator). Въпреки че се стремим към точност, моля, имайте предвид, че автоматизираните преводи може да съдържат грешки или неточности. Оригиналният документ на неговия роден език трябва да се счита за авторитетен източник. За критична информация се препоръчва професионален човешки превод. Не носим отговорност за недоразумения или погрешни интерпретации, произтичащи от използването на този превод.
323+
Този документ е преведен с помощта на AI услуга за превод [Co-op Translator](https://github.com/Azure/co-op-translator). Въпреки че се стремим към точност, моля, имайте предвид, че автоматизираните преводи може да съдържат грешки или неточности. Оригиналният документ на неговия роден език трябва да се счита за авторитетен източник. За критична информация се препоръчва професионален човешки превод. Ние не носим отговорност за недоразумения или погрешни интерпретации, произтичащи от използването на този превод.

0 commit comments

Comments
 (0)