diff --git a/README.md b/README.md index df255fb9..398f2f4e 100644 --- a/README.md +++ b/README.md @@ -30,7 +30,7 @@ ### Supported via GitHub Action (Automated & Always Up-to-Date) -[Arabic](./translations/ar/README.md) | [Bengali](./translations/bn/README.md) | [Bulgarian](./translations/bg/README.md) | [Burmese (Myanmar)](./translations/my/README.md) | [Chinese (Simplified)](./translations/zh/README.md) | [Chinese (Traditional, Hong Kong)](./translations/hk/README.md) | [Chinese (Traditional, Macau)](./translations/mo/README.md) | [Chinese (Traditional, Taiwan)](./translations/tw/README.md) | [Croatian](./translations/hr/README.md) | [Czech](./translations/cs/README.md) | [Danish](./translations/da/README.md) | [Dutch](./translations/nl/README.md) | [Estonian](./translations/et/README.md) | [Finnish](./translations/fi/README.md) | [French](./translations/fr/README.md) | [German](./translations/de/README.md) | [Greek](./translations/el/README.md) | [Hebrew](./translations/he/README.md) | [Hindi](./translations/hi/README.md) | [Hungarian](./translations/hu/README.md) | [Indonesian](./translations/id/README.md) | [Italian](./translations/it/README.md) | [Japanese](./translations/ja/README.md) | [Kannada](./translations/kn/README.md) | [Korean](./translations/ko/README.md) | [Lithuanian](./translations/lt/README.md) | [Malay](./translations/ms/README.md) | [Malayalam](./translations/ml/README.md) | [Marathi](./translations/mr/README.md) | [Nepali](./translations/ne/README.md) | [Nigerian Pidgin](./translations/pcm/README.md) | [Norwegian](./translations/no/README.md) | [Persian (Farsi)](./translations/fa/README.md) | [Polish](./translations/pl/README.md) | [Portuguese (Brazil)](./translations/br/README.md) | [Portuguese (Portugal)](./translations/pt/README.md) | [Punjabi (Gurmukhi)](./translations/pa/README.md) | [Romanian](./translations/ro/README.md) | [Russian](./translations/ru/README.md) | [Serbian (Cyrillic)](./translations/sr/README.md) | [Slovak](./translations/sk/README.md) | [Slovenian](./translations/sl/README.md) | [Spanish](./translations/es/README.md) | [Swahili](./translations/sw/README.md) | [Swedish](./translations/sv/README.md) | [Tagalog (Filipino)](./translations/tl/README.md) | [Tamil](./translations/ta/README.md) | [Telugu](./translations/te/README.md) | [Thai](./translations/th/README.md) | [Turkish](./translations/tr/README.md) | [Ukrainian](./translations/uk/README.md) | [Urdu](./translations/ur/README.md) | [Vietnamese](./translations/vi/README.md) +[Arabic](./translations/ar/README.md) | [Bengali](./translations/bn/README.md) | [Bulgarian](./translations/bg/README.md) | [Burmese (Myanmar)](./translations/my/README.md) | [Chinese (Simplified)](./translations/zh-CN/README.md) | [Chinese (Traditional, Hong Kong)](./translations/zh-HK/README.md) | [Chinese (Traditional, Macau)](./translations/zh-MO/README.md) | [Chinese (Traditional, Taiwan)](./translations/zh-TW/README.md) | [Croatian](./translations/hr/README.md) | [Czech](./translations/cs/README.md) | [Danish](./translations/da/README.md) | [Dutch](./translations/nl/README.md) | [Estonian](./translations/et/README.md) | [Finnish](./translations/fi/README.md) | [French](./translations/fr/README.md) | [German](./translations/de/README.md) | [Greek](./translations/el/README.md) | [Hebrew](./translations/he/README.md) | [Hindi](./translations/hi/README.md) | [Hungarian](./translations/hu/README.md) | [Indonesian](./translations/id/README.md) | [Italian](./translations/it/README.md) | [Japanese](./translations/ja/README.md) | [Kannada](./translations/kn/README.md) | [Korean](./translations/ko/README.md) | [Lithuanian](./translations/lt/README.md) | [Malay](./translations/ms/README.md) | [Malayalam](./translations/ml/README.md) | [Marathi](./translations/mr/README.md) | [Nepali](./translations/ne/README.md) | [Nigerian Pidgin](./translations/pcm/README.md) | [Norwegian](./translations/no/README.md) | [Persian (Farsi)](./translations/fa/README.md) | [Polish](./translations/pl/README.md) | [Portuguese (Brazil)](./translations/pt-BR/README.md) | [Portuguese (Portugal)](./translations/pt-PT/README.md) | [Punjabi (Gurmukhi)](./translations/pa/README.md) | [Romanian](./translations/ro/README.md) | [Russian](./translations/ru/README.md) | [Serbian (Cyrillic)](./translations/sr/README.md) | [Slovak](./translations/sk/README.md) | [Slovenian](./translations/sl/README.md) | [Spanish](./translations/es/README.md) | [Swahili](./translations/sw/README.md) | [Swedish](./translations/sv/README.md) | [Tagalog (Filipino)](./translations/tl/README.md) | [Tamil](./translations/ta/README.md) | [Telugu](./translations/te/README.md) | [Thai](./translations/th/README.md) | [Turkish](./translations/tr/README.md) | [Ukrainian](./translations/uk/README.md) | [Urdu](./translations/ur/README.md) | [Vietnamese](./translations/vi/README.md) > **Prefer to Clone Locally?** diff --git a/translated_images/ar/.co-op-translator.json b/translated_images/ar/.co-op-translator.json index 2ab06c74..0fc1c5f7 100644 --- a/translated_images/ar/.co-op-translator.json +++ b/translated_images/ar/.co-op-translator.json @@ -77,12 +77,24 @@ "source_file": "01-IntroToGenAI/images/mcp.png", "language_code": "ar" }, + "models.cb07f8af0d724e4d.webp": { + "original_hash": "a1d68725372d3c033c59d1719b859d60", + "translation_date": "2026-01-29T15:19:58+00:00", + "source_file": "02-SetupDevEnvironment/images/models.webp", + "language_code": "ar" + }, "responsible.e4f51a917bafa4bf.webp": { "original_hash": "fa8d1e23eabb52aff991b3257f039a93", "translation_date": "2026-01-16T06:33:50+00:00", "source_file": "05-ResponsibleGenAI/images/responsible.png", "language_code": "ar" }, + "tokens.6283ed277a2ffff4.webp": { + "original_hash": "11572cc20ac9478d3d009a4b7e6aad2d", + "translation_date": "2026-01-29T15:19:34+00:00", + "source_file": "01-IntroToGenAI/images/tokens.webp", + "language_code": "ar" + }, "tool.189edfdb50db566d.webp": { "original_hash": "ed2556303c831d1c9277652dc12014a1", "translation_date": "2026-01-16T06:32:42+00:00", diff --git a/translated_images/ar/models.cb07f8af0d724e4d.webp b/translated_images/ar/models.cb07f8af0d724e4d.webp new file mode 100644 index 00000000..e30879e9 Binary files /dev/null and b/translated_images/ar/models.cb07f8af0d724e4d.webp differ diff --git a/translated_images/ar/tokens.6283ed277a2ffff4.webp b/translated_images/ar/tokens.6283ed277a2ffff4.webp new file mode 100644 index 00000000..8e8e6bce Binary files /dev/null and b/translated_images/ar/tokens.6283ed277a2ffff4.webp differ diff --git a/translated_images/bg/.co-op-translator.json b/translated_images/bg/.co-op-translator.json index b1cdb29a..bc0f793c 100644 --- a/translated_images/bg/.co-op-translator.json +++ b/translated_images/bg/.co-op-translator.json @@ -77,12 +77,24 @@ "source_file": "01-IntroToGenAI/images/mcp.png", "language_code": "bg" }, + "models.cb07f8af0d724e4d.webp": { + "original_hash": "a1d68725372d3c033c59d1719b859d60", + "translation_date": "2026-01-29T16:12:59+00:00", + "source_file": "02-SetupDevEnvironment/images/models.webp", + "language_code": "bg" + }, "responsible.e4f51a917bafa4bf.webp": { "original_hash": "fa8d1e23eabb52aff991b3257f039a93", "translation_date": "2026-01-16T07:29:29+00:00", "source_file": "05-ResponsibleGenAI/images/responsible.png", "language_code": "bg" }, + "tokens.6283ed277a2ffff4.webp": { + "original_hash": "11572cc20ac9478d3d009a4b7e6aad2d", + "translation_date": "2026-01-29T16:12:25+00:00", + "source_file": "01-IntroToGenAI/images/tokens.webp", + "language_code": "bg" + }, "tool.189edfdb50db566d.webp": { "original_hash": "ed2556303c831d1c9277652dc12014a1", "translation_date": "2026-01-16T07:28:17+00:00", diff --git a/translated_images/bg/models.cb07f8af0d724e4d.webp b/translated_images/bg/models.cb07f8af0d724e4d.webp new file mode 100644 index 00000000..e30879e9 Binary files /dev/null and b/translated_images/bg/models.cb07f8af0d724e4d.webp differ diff --git a/translated_images/bg/tokens.6283ed277a2ffff4.webp b/translated_images/bg/tokens.6283ed277a2ffff4.webp new file mode 100644 index 00000000..8e8e6bce Binary files /dev/null and b/translated_images/bg/tokens.6283ed277a2ffff4.webp differ diff --git a/translated_images/bn/.co-op-translator.json b/translated_images/bn/.co-op-translator.json index aa2168ee..b4062baf 100644 --- a/translated_images/bn/.co-op-translator.json +++ b/translated_images/bn/.co-op-translator.json @@ -77,12 +77,24 @@ "source_file": "01-IntroToGenAI/images/mcp.png", "language_code": "bn" }, + "models.cb07f8af0d724e4d.webp": { + "original_hash": "a1d68725372d3c033c59d1719b859d60", + "translation_date": "2026-01-29T15:37:04+00:00", + "source_file": "02-SetupDevEnvironment/images/models.webp", + "language_code": "bn" + }, "responsible.e4f51a917bafa4bf.webp": { "original_hash": "fa8d1e23eabb52aff991b3257f039a93", "translation_date": "2026-01-16T06:52:12+00:00", "source_file": "05-ResponsibleGenAI/images/responsible.png", "language_code": "bn" }, + "tokens.6283ed277a2ffff4.webp": { + "original_hash": "11572cc20ac9478d3d009a4b7e6aad2d", + "translation_date": "2026-01-29T15:36:49+00:00", + "source_file": "01-IntroToGenAI/images/tokens.webp", + "language_code": "bn" + }, "tool.189edfdb50db566d.webp": { "original_hash": "ed2556303c831d1c9277652dc12014a1", "translation_date": "2026-01-16T06:50:52+00:00", diff --git a/translated_images/bn/models.cb07f8af0d724e4d.webp b/translated_images/bn/models.cb07f8af0d724e4d.webp new file mode 100644 index 00000000..e30879e9 Binary files /dev/null and b/translated_images/bn/models.cb07f8af0d724e4d.webp differ diff --git a/translated_images/bn/tokens.6283ed277a2ffff4.webp b/translated_images/bn/tokens.6283ed277a2ffff4.webp new file mode 100644 index 00000000..8e8e6bce Binary files /dev/null and b/translated_images/bn/tokens.6283ed277a2ffff4.webp differ diff --git a/translated_images/cs/.co-op-translator.json b/translated_images/cs/.co-op-translator.json index 6f46f09a..0fae3988 100644 --- a/translated_images/cs/.co-op-translator.json +++ b/translated_images/cs/.co-op-translator.json @@ -77,12 +77,24 @@ "source_file": "01-IntroToGenAI/images/mcp.png", "language_code": "cs" }, + "models.cb07f8af0d724e4d.webp": { + "original_hash": "a1d68725372d3c033c59d1719b859d60", + "translation_date": "2026-01-29T16:08:02+00:00", + "source_file": "02-SetupDevEnvironment/images/models.webp", + "language_code": "cs" + }, "responsible.e4f51a917bafa4bf.webp": { "original_hash": "fa8d1e23eabb52aff991b3257f039a93", "translation_date": "2026-01-16T07:24:57+00:00", "source_file": "05-ResponsibleGenAI/images/responsible.png", "language_code": "cs" }, + "tokens.6283ed277a2ffff4.webp": { + "original_hash": "11572cc20ac9478d3d009a4b7e6aad2d", + "translation_date": "2026-01-29T16:07:29+00:00", + "source_file": "01-IntroToGenAI/images/tokens.webp", + "language_code": "cs" + }, "tool.189edfdb50db566d.webp": { "original_hash": "ed2556303c831d1c9277652dc12014a1", "translation_date": "2026-01-16T07:23:21+00:00", diff --git a/translated_images/cs/models.cb07f8af0d724e4d.webp b/translated_images/cs/models.cb07f8af0d724e4d.webp new file mode 100644 index 00000000..e30879e9 Binary files /dev/null and b/translated_images/cs/models.cb07f8af0d724e4d.webp differ diff --git a/translated_images/cs/tokens.6283ed277a2ffff4.webp b/translated_images/cs/tokens.6283ed277a2ffff4.webp new file mode 100644 index 00000000..8e8e6bce Binary files /dev/null and b/translated_images/cs/tokens.6283ed277a2ffff4.webp differ diff --git a/translated_images/da/.co-op-translator.json b/translated_images/da/.co-op-translator.json index e7db57ad..1a87872a 100644 --- a/translated_images/da/.co-op-translator.json +++ b/translated_images/da/.co-op-translator.json @@ -77,12 +77,24 @@ "source_file": "01-IntroToGenAI/images/mcp.png", "language_code": "da" }, + "models.cb07f8af0d724e4d.webp": { + "original_hash": "a1d68725372d3c033c59d1719b859d60", + "translation_date": "2026-01-29T15:54:49+00:00", + "source_file": "02-SetupDevEnvironment/images/models.webp", + "language_code": "da" + }, "responsible.e4f51a917bafa4bf.webp": { "original_hash": "fa8d1e23eabb52aff991b3257f039a93", "translation_date": "2026-01-16T07:10:53+00:00", "source_file": "05-ResponsibleGenAI/images/responsible.png", "language_code": "da" }, + "tokens.6283ed277a2ffff4.webp": { + "original_hash": "11572cc20ac9478d3d009a4b7e6aad2d", + "translation_date": "2026-01-29T15:54:38+00:00", + "source_file": "01-IntroToGenAI/images/tokens.webp", + "language_code": "da" + }, "tool.189edfdb50db566d.webp": { "original_hash": "ed2556303c831d1c9277652dc12014a1", "translation_date": "2026-01-16T07:09:42+00:00", diff --git a/translated_images/da/models.cb07f8af0d724e4d.webp b/translated_images/da/models.cb07f8af0d724e4d.webp new file mode 100644 index 00000000..e30879e9 Binary files /dev/null and b/translated_images/da/models.cb07f8af0d724e4d.webp differ diff --git a/translated_images/da/tokens.6283ed277a2ffff4.webp b/translated_images/da/tokens.6283ed277a2ffff4.webp new file mode 100644 index 00000000..8e8e6bce Binary files /dev/null and b/translated_images/da/tokens.6283ed277a2ffff4.webp differ diff --git a/translated_images/de/.co-op-translator.json b/translated_images/de/.co-op-translator.json index 119d9ad6..532d4d83 100644 --- a/translated_images/de/.co-op-translator.json +++ b/translated_images/de/.co-op-translator.json @@ -77,12 +77,24 @@ "source_file": "01-IntroToGenAI/images/mcp.png", "language_code": "de" }, + "models.cb07f8af0d724e4d.webp": { + "original_hash": "a1d68725372d3c033c59d1719b859d60", + "translation_date": "2026-01-29T15:19:41+00:00", + "source_file": "02-SetupDevEnvironment/images/models.webp", + "language_code": "de" + }, "responsible.e4f51a917bafa4bf.webp": { "original_hash": "fa8d1e23eabb52aff991b3257f039a93", "translation_date": "2026-01-16T06:33:36+00:00", "source_file": "05-ResponsibleGenAI/images/responsible.png", "language_code": "de" }, + "tokens.6283ed277a2ffff4.webp": { + "original_hash": "11572cc20ac9478d3d009a4b7e6aad2d", + "translation_date": "2026-01-29T15:19:32+00:00", + "source_file": "01-IntroToGenAI/images/tokens.webp", + "language_code": "de" + }, "tool.189edfdb50db566d.webp": { "original_hash": "ed2556303c831d1c9277652dc12014a1", "translation_date": "2026-01-16T06:32:28+00:00", diff --git a/translated_images/de/models.cb07f8af0d724e4d.webp b/translated_images/de/models.cb07f8af0d724e4d.webp new file mode 100644 index 00000000..e30879e9 Binary files /dev/null and b/translated_images/de/models.cb07f8af0d724e4d.webp differ diff --git a/translated_images/de/tokens.6283ed277a2ffff4.webp b/translated_images/de/tokens.6283ed277a2ffff4.webp new file mode 100644 index 00000000..8e8e6bce Binary files /dev/null and b/translated_images/de/tokens.6283ed277a2ffff4.webp differ diff --git a/translated_images/el/.co-op-translator.json b/translated_images/el/.co-op-translator.json index ae11cd43..406cd7b6 100644 --- a/translated_images/el/.co-op-translator.json +++ b/translated_images/el/.co-op-translator.json @@ -77,12 +77,24 @@ "source_file": "01-IntroToGenAI/images/mcp.png", "language_code": "el" }, + "models.cb07f8af0d724e4d.webp": { + "original_hash": "a1d68725372d3c033c59d1719b859d60", + "translation_date": "2026-01-29T15:50:19+00:00", + "source_file": "02-SetupDevEnvironment/images/models.webp", + "language_code": "el" + }, "responsible.e4f51a917bafa4bf.webp": { "original_hash": "fa8d1e23eabb52aff991b3257f039a93", "translation_date": "2026-01-16T07:06:17+00:00", "source_file": "05-ResponsibleGenAI/images/responsible.png", "language_code": "el" }, + "tokens.6283ed277a2ffff4.webp": { + "original_hash": "11572cc20ac9478d3d009a4b7e6aad2d", + "translation_date": "2026-01-29T15:50:03+00:00", + "source_file": "01-IntroToGenAI/images/tokens.webp", + "language_code": "el" + }, "tool.189edfdb50db566d.webp": { "original_hash": "ed2556303c831d1c9277652dc12014a1", "translation_date": "2026-01-16T07:05:03+00:00", diff --git a/translated_images/el/models.cb07f8af0d724e4d.webp b/translated_images/el/models.cb07f8af0d724e4d.webp new file mode 100644 index 00000000..e30879e9 Binary files /dev/null and b/translated_images/el/models.cb07f8af0d724e4d.webp differ diff --git a/translated_images/el/tokens.6283ed277a2ffff4.webp b/translated_images/el/tokens.6283ed277a2ffff4.webp new file mode 100644 index 00000000..8e8e6bce Binary files /dev/null and b/translated_images/el/tokens.6283ed277a2ffff4.webp differ diff --git a/translated_images/en/.co-op-translator.json b/translated_images/en/.co-op-translator.json index de052b67..723c98bc 100644 --- a/translated_images/en/.co-op-translator.json +++ b/translated_images/en/.co-op-translator.json @@ -77,12 +77,24 @@ "source_file": "01-IntroToGenAI/images/mcp.png", "language_code": "en" }, + "models.cb07f8af0d724e4d.webp": { + "original_hash": "a1d68725372d3c033c59d1719b859d60", + "translation_date": "2026-01-29T15:15:31+00:00", + "source_file": "02-SetupDevEnvironment/images/models.webp", + "language_code": "en" + }, "responsible.e4f51a917bafa4bf.webp": { "original_hash": "fa8d1e23eabb52aff991b3257f039a93", "translation_date": "2026-01-16T06:28:38+00:00", "source_file": "05-ResponsibleGenAI/images/responsible.png", "language_code": "en" }, + "tokens.6283ed277a2ffff4.webp": { + "original_hash": "11572cc20ac9478d3d009a4b7e6aad2d", + "translation_date": "2026-01-29T15:15:23+00:00", + "source_file": "01-IntroToGenAI/images/tokens.webp", + "language_code": "en" + }, "tool.189edfdb50db566d.webp": { "original_hash": "ed2556303c831d1c9277652dc12014a1", "translation_date": "2026-01-16T06:27:34+00:00", diff --git a/translated_images/en/beg-genai-series.61edc4a6b2cc5428.webp b/translated_images/en/beg-genai-series.61edc4a6b2cc5428.webp deleted file mode 100644 index e579392b..00000000 Binary files a/translated_images/en/beg-genai-series.61edc4a6b2cc5428.webp and /dev/null differ diff --git a/translated_images/en/comparison.704515f8dc7ed44f.webp b/translated_images/en/comparison.704515f8dc7ed44f.webp deleted file mode 100644 index 814ee357..00000000 Binary files a/translated_images/en/comparison.704515f8dc7ed44f.webp and /dev/null differ diff --git a/translated_images/en/image.ce253bac97cb2e18.webp b/translated_images/en/image.ce253bac97cb2e18.webp deleted file mode 100644 index 3495c5a4..00000000 Binary files a/translated_images/en/image.ce253bac97cb2e18.webp and /dev/null differ diff --git a/translated_images/en/models.cb07f8af0d724e4d.webp b/translated_images/en/models.cb07f8af0d724e4d.webp new file mode 100644 index 00000000..e30879e9 Binary files /dev/null and b/translated_images/en/models.cb07f8af0d724e4d.webp differ diff --git a/translated_images/en/responsible.d11c51f81baaa030.webp b/translated_images/en/responsible.d11c51f81baaa030.webp deleted file mode 100644 index 8ba5bccd..00000000 Binary files a/translated_images/en/responsible.d11c51f81baaa030.webp and /dev/null differ diff --git a/translated_images/en/tokens.6283ed277a2ffff4.webp b/translated_images/en/tokens.6283ed277a2ffff4.webp new file mode 100644 index 00000000..8e8e6bce Binary files /dev/null and b/translated_images/en/tokens.6283ed277a2ffff4.webp differ diff --git a/translated_images/en/tool.214c70103694335c.webp b/translated_images/en/tool.214c70103694335c.webp deleted file mode 100644 index c694facb..00000000 Binary files a/translated_images/en/tool.214c70103694335c.webp and /dev/null differ diff --git a/translated_images/es/.co-op-translator.json b/translated_images/es/.co-op-translator.json index cab7ac6c..59cb0145 100644 --- a/translated_images/es/.co-op-translator.json +++ b/translated_images/es/.co-op-translator.json @@ -77,12 +77,24 @@ "source_file": "01-IntroToGenAI/images/mcp.png", "language_code": "es" }, + "models.cb07f8af0d724e4d.webp": { + "original_hash": "a1d68725372d3c033c59d1719b859d60", + "translation_date": "2026-01-29T15:15:46+00:00", + "source_file": "02-SetupDevEnvironment/images/models.webp", + "language_code": "es" + }, "responsible.e4f51a917bafa4bf.webp": { "original_hash": "fa8d1e23eabb52aff991b3257f039a93", "translation_date": "2026-01-16T06:28:49+00:00", "source_file": "05-ResponsibleGenAI/images/responsible.png", "language_code": "es" }, + "tokens.6283ed277a2ffff4.webp": { + "original_hash": "11572cc20ac9478d3d009a4b7e6aad2d", + "translation_date": "2026-01-29T15:15:25+00:00", + "source_file": "01-IntroToGenAI/images/tokens.webp", + "language_code": "es" + }, "tool.189edfdb50db566d.webp": { "original_hash": "ed2556303c831d1c9277652dc12014a1", "translation_date": "2026-01-16T06:27:46+00:00", diff --git a/translated_images/es/beg-genai-series.61edc4a6b2cc5428.webp b/translated_images/es/beg-genai-series.61edc4a6b2cc5428.webp deleted file mode 100644 index 19c17ee4..00000000 Binary files a/translated_images/es/beg-genai-series.61edc4a6b2cc5428.webp and /dev/null differ diff --git a/translated_images/es/comparison.704515f8dc7ed44f.webp b/translated_images/es/comparison.704515f8dc7ed44f.webp deleted file mode 100644 index 0313e6ff..00000000 Binary files a/translated_images/es/comparison.704515f8dc7ed44f.webp and /dev/null differ diff --git a/translated_images/es/image.ce253bac97cb2e18.webp b/translated_images/es/image.ce253bac97cb2e18.webp deleted file mode 100644 index 896d5d45..00000000 Binary files a/translated_images/es/image.ce253bac97cb2e18.webp and /dev/null differ diff --git a/translated_images/es/models.cb07f8af0d724e4d.webp b/translated_images/es/models.cb07f8af0d724e4d.webp new file mode 100644 index 00000000..e30879e9 Binary files /dev/null and b/translated_images/es/models.cb07f8af0d724e4d.webp differ diff --git a/translated_images/es/responsible.d11c51f81baaa030.webp b/translated_images/es/responsible.d11c51f81baaa030.webp deleted file mode 100644 index 628c7d9d..00000000 Binary files a/translated_images/es/responsible.d11c51f81baaa030.webp and /dev/null differ diff --git a/translated_images/es/tokens.6283ed277a2ffff4.webp b/translated_images/es/tokens.6283ed277a2ffff4.webp new file mode 100644 index 00000000..8e8e6bce Binary files /dev/null and b/translated_images/es/tokens.6283ed277a2ffff4.webp differ diff --git a/translated_images/es/tool.214c70103694335c.webp b/translated_images/es/tool.214c70103694335c.webp deleted file mode 100644 index a120db8e..00000000 Binary files a/translated_images/es/tool.214c70103694335c.webp and /dev/null differ diff --git a/translated_images/et/.co-op-translator.json b/translated_images/et/.co-op-translator.json index f9c40424..d10fec1d 100644 --- a/translated_images/et/.co-op-translator.json +++ b/translated_images/et/.co-op-translator.json @@ -77,12 +77,24 @@ "source_file": "01-IntroToGenAI/images/mcp.png", "language_code": "et" }, + "models.cb07f8af0d724e4d.webp": { + "original_hash": "a1d68725372d3c033c59d1719b859d60", + "translation_date": "2026-01-29T16:27:15+00:00", + "source_file": "02-SetupDevEnvironment/images/models.webp", + "language_code": "et" + }, "responsible.e4f51a917bafa4bf.webp": { "original_hash": "fa8d1e23eabb52aff991b3257f039a93", "translation_date": "2026-01-16T07:43:47+00:00", "source_file": "05-ResponsibleGenAI/images/responsible.png", "language_code": "et" }, + "tokens.6283ed277a2ffff4.webp": { + "original_hash": "11572cc20ac9478d3d009a4b7e6aad2d", + "translation_date": "2026-01-29T16:26:53+00:00", + "source_file": "01-IntroToGenAI/images/tokens.webp", + "language_code": "et" + }, "tool.189edfdb50db566d.webp": { "original_hash": "ed2556303c831d1c9277652dc12014a1", "translation_date": "2026-01-16T07:42:33+00:00", diff --git a/translated_images/et/models.cb07f8af0d724e4d.webp b/translated_images/et/models.cb07f8af0d724e4d.webp new file mode 100644 index 00000000..e30879e9 Binary files /dev/null and b/translated_images/et/models.cb07f8af0d724e4d.webp differ diff --git a/translated_images/et/tokens.6283ed277a2ffff4.webp b/translated_images/et/tokens.6283ed277a2ffff4.webp new file mode 100644 index 00000000..8e8e6bce Binary files /dev/null and b/translated_images/et/tokens.6283ed277a2ffff4.webp differ diff --git a/translated_images/fa/.co-op-translator.json b/translated_images/fa/.co-op-translator.json index c1777626..a4caaf67 100644 --- a/translated_images/fa/.co-op-translator.json +++ b/translated_images/fa/.co-op-translator.json @@ -77,12 +77,24 @@ "source_file": "01-IntroToGenAI/images/mcp.png", "language_code": "fa" }, + "models.cb07f8af0d724e4d.webp": { + "original_hash": "a1d68725372d3c033c59d1719b859d60", + "translation_date": "2026-01-29T15:23:56+00:00", + "source_file": "02-SetupDevEnvironment/images/models.webp", + "language_code": "fa" + }, "responsible.e4f51a917bafa4bf.webp": { "original_hash": "fa8d1e23eabb52aff991b3257f039a93", "translation_date": "2026-01-16T06:38:15+00:00", "source_file": "05-ResponsibleGenAI/images/responsible.png", "language_code": "fa" }, + "tokens.6283ed277a2ffff4.webp": { + "original_hash": "11572cc20ac9478d3d009a4b7e6aad2d", + "translation_date": "2026-01-29T15:23:46+00:00", + "source_file": "01-IntroToGenAI/images/tokens.webp", + "language_code": "fa" + }, "tool.189edfdb50db566d.webp": { "original_hash": "ed2556303c831d1c9277652dc12014a1", "translation_date": "2026-01-16T06:37:04+00:00", diff --git a/translated_images/fa/models.cb07f8af0d724e4d.webp b/translated_images/fa/models.cb07f8af0d724e4d.webp new file mode 100644 index 00000000..e30879e9 Binary files /dev/null and b/translated_images/fa/models.cb07f8af0d724e4d.webp differ diff --git a/translated_images/fa/tokens.6283ed277a2ffff4.webp b/translated_images/fa/tokens.6283ed277a2ffff4.webp new file mode 100644 index 00000000..8e8e6bce Binary files /dev/null and b/translated_images/fa/tokens.6283ed277a2ffff4.webp differ diff --git a/translated_images/fi/.co-op-translator.json b/translated_images/fi/.co-op-translator.json index 30709bc5..102e7cac 100644 --- a/translated_images/fi/.co-op-translator.json +++ b/translated_images/fi/.co-op-translator.json @@ -77,12 +77,24 @@ "source_file": "01-IntroToGenAI/images/mcp.png", "language_code": "fi" }, + "models.cb07f8af0d724e4d.webp": { + "original_hash": "a1d68725372d3c033c59d1719b859d60", + "translation_date": "2026-01-29T15:55:05+00:00", + "source_file": "02-SetupDevEnvironment/images/models.webp", + "language_code": "fi" + }, "responsible.e4f51a917bafa4bf.webp": { "original_hash": "fa8d1e23eabb52aff991b3257f039a93", "translation_date": "2026-01-16T07:11:04+00:00", "source_file": "05-ResponsibleGenAI/images/responsible.png", "language_code": "fi" }, + "tokens.6283ed277a2ffff4.webp": { + "original_hash": "11572cc20ac9478d3d009a4b7e6aad2d", + "translation_date": "2026-01-29T15:54:41+00:00", + "source_file": "01-IntroToGenAI/images/tokens.webp", + "language_code": "fi" + }, "tool.189edfdb50db566d.webp": { "original_hash": "ed2556303c831d1c9277652dc12014a1", "translation_date": "2026-01-16T07:09:55+00:00", diff --git a/translated_images/fi/models.cb07f8af0d724e4d.webp b/translated_images/fi/models.cb07f8af0d724e4d.webp new file mode 100644 index 00000000..e30879e9 Binary files /dev/null and b/translated_images/fi/models.cb07f8af0d724e4d.webp differ diff --git a/translated_images/fi/tokens.6283ed277a2ffff4.webp b/translated_images/fi/tokens.6283ed277a2ffff4.webp new file mode 100644 index 00000000..8e8e6bce Binary files /dev/null and b/translated_images/fi/tokens.6283ed277a2ffff4.webp differ diff --git a/translated_images/fr/.co-op-translator.json b/translated_images/fr/.co-op-translator.json index e0ec74a3..afb54b39 100644 --- a/translated_images/fr/.co-op-translator.json +++ b/translated_images/fr/.co-op-translator.json @@ -77,12 +77,24 @@ "source_file": "01-IntroToGenAI/images/mcp.png", "language_code": "fr" }, + "models.cb07f8af0d724e4d.webp": { + "original_hash": "a1d68725372d3c033c59d1719b859d60", + "translation_date": "2026-01-29T15:15:38+00:00", + "source_file": "02-SetupDevEnvironment/images/models.webp", + "language_code": "fr" + }, "responsible.e4f51a917bafa4bf.webp": { "original_hash": "fa8d1e23eabb52aff991b3257f039a93", "translation_date": "2026-01-16T06:28:43+00:00", "source_file": "05-ResponsibleGenAI/images/responsible.png", "language_code": "fr" }, + "tokens.6283ed277a2ffff4.webp": { + "original_hash": "11572cc20ac9478d3d009a4b7e6aad2d", + "translation_date": "2026-01-29T15:15:24+00:00", + "source_file": "01-IntroToGenAI/images/tokens.webp", + "language_code": "fr" + }, "tool.189edfdb50db566d.webp": { "original_hash": "ed2556303c831d1c9277652dc12014a1", "translation_date": "2026-01-16T06:27:40+00:00", diff --git a/translated_images/fr/beg-genai-series.61edc4a6b2cc5428.webp b/translated_images/fr/beg-genai-series.61edc4a6b2cc5428.webp deleted file mode 100644 index 259bf8fd..00000000 Binary files a/translated_images/fr/beg-genai-series.61edc4a6b2cc5428.webp and /dev/null differ diff --git a/translated_images/fr/comparison.704515f8dc7ed44f.webp b/translated_images/fr/comparison.704515f8dc7ed44f.webp deleted file mode 100644 index 1855cdbf..00000000 Binary files a/translated_images/fr/comparison.704515f8dc7ed44f.webp and /dev/null differ diff --git a/translated_images/fr/image.ce253bac97cb2e18.webp b/translated_images/fr/image.ce253bac97cb2e18.webp deleted file mode 100644 index 7729d839..00000000 Binary files a/translated_images/fr/image.ce253bac97cb2e18.webp and /dev/null differ diff --git a/translated_images/fr/models.cb07f8af0d724e4d.webp b/translated_images/fr/models.cb07f8af0d724e4d.webp new file mode 100644 index 00000000..e30879e9 Binary files /dev/null and b/translated_images/fr/models.cb07f8af0d724e4d.webp differ diff --git a/translated_images/fr/responsible.d11c51f81baaa030.webp b/translated_images/fr/responsible.d11c51f81baaa030.webp deleted file mode 100644 index 62bd558e..00000000 Binary files a/translated_images/fr/responsible.d11c51f81baaa030.webp and /dev/null differ diff --git a/translated_images/fr/tokens.6283ed277a2ffff4.webp b/translated_images/fr/tokens.6283ed277a2ffff4.webp new file mode 100644 index 00000000..8e8e6bce Binary files /dev/null and b/translated_images/fr/tokens.6283ed277a2ffff4.webp differ diff --git a/translated_images/fr/tool.214c70103694335c.webp b/translated_images/fr/tool.214c70103694335c.webp deleted file mode 100644 index 7a2476d1..00000000 Binary files a/translated_images/fr/tool.214c70103694335c.webp and /dev/null differ diff --git a/translated_images/he/.co-op-translator.json b/translated_images/he/.co-op-translator.json index 1220ed03..c3f86b84 100644 --- a/translated_images/he/.co-op-translator.json +++ b/translated_images/he/.co-op-translator.json @@ -77,12 +77,24 @@ "source_file": "01-IntroToGenAI/images/mcp.png", "language_code": "he" }, + "models.cb07f8af0d724e4d.webp": { + "original_hash": "a1d68725372d3c033c59d1719b859d60", + "translation_date": "2026-01-29T15:58:50+00:00", + "source_file": "02-SetupDevEnvironment/images/models.webp", + "language_code": "he" + }, "responsible.e4f51a917bafa4bf.webp": { "original_hash": "fa8d1e23eabb52aff991b3257f039a93", "translation_date": "2026-01-16T07:15:19+00:00", "source_file": "05-ResponsibleGenAI/images/responsible.png", "language_code": "he" }, + "tokens.6283ed277a2ffff4.webp": { + "original_hash": "11572cc20ac9478d3d009a4b7e6aad2d", + "translation_date": "2026-01-29T15:58:33+00:00", + "source_file": "01-IntroToGenAI/images/tokens.webp", + "language_code": "he" + }, "tool.189edfdb50db566d.webp": { "original_hash": "ed2556303c831d1c9277652dc12014a1", "translation_date": "2026-01-16T07:14:08+00:00", diff --git a/translated_images/he/models.cb07f8af0d724e4d.webp b/translated_images/he/models.cb07f8af0d724e4d.webp new file mode 100644 index 00000000..e30879e9 Binary files /dev/null and b/translated_images/he/models.cb07f8af0d724e4d.webp differ diff --git a/translated_images/he/tokens.6283ed277a2ffff4.webp b/translated_images/he/tokens.6283ed277a2ffff4.webp new file mode 100644 index 00000000..8e8e6bce Binary files /dev/null and b/translated_images/he/tokens.6283ed277a2ffff4.webp differ diff --git a/translated_images/hi/.co-op-translator.json b/translated_images/hi/.co-op-translator.json index bb9b50fd..f1dfa32c 100644 --- a/translated_images/hi/.co-op-translator.json +++ b/translated_images/hi/.co-op-translator.json @@ -77,12 +77,24 @@ "source_file": "01-IntroToGenAI/images/mcp.png", "language_code": "hi" }, + "models.cb07f8af0d724e4d.webp": { + "original_hash": "a1d68725372d3c033c59d1719b859d60", + "translation_date": "2026-01-29T15:32:51+00:00", + "source_file": "02-SetupDevEnvironment/images/models.webp", + "language_code": "hi" + }, "responsible.e4f51a917bafa4bf.webp": { "original_hash": "fa8d1e23eabb52aff991b3257f039a93", "translation_date": "2026-01-16T06:47:34+00:00", "source_file": "05-ResponsibleGenAI/images/responsible.png", "language_code": "hi" }, + "tokens.6283ed277a2ffff4.webp": { + "original_hash": "11572cc20ac9478d3d009a4b7e6aad2d", + "translation_date": "2026-01-29T15:32:23+00:00", + "source_file": "01-IntroToGenAI/images/tokens.webp", + "language_code": "hi" + }, "tool.189edfdb50db566d.webp": { "original_hash": "ed2556303c831d1c9277652dc12014a1", "translation_date": "2026-01-16T06:46:20+00:00", diff --git a/translated_images/hi/models.cb07f8af0d724e4d.webp b/translated_images/hi/models.cb07f8af0d724e4d.webp new file mode 100644 index 00000000..e30879e9 Binary files /dev/null and b/translated_images/hi/models.cb07f8af0d724e4d.webp differ diff --git a/translated_images/hi/tokens.6283ed277a2ffff4.webp b/translated_images/hi/tokens.6283ed277a2ffff4.webp new file mode 100644 index 00000000..8e8e6bce Binary files /dev/null and b/translated_images/hi/tokens.6283ed277a2ffff4.webp differ diff --git a/translated_images/hr/.co-op-translator.json b/translated_images/hr/.co-op-translator.json index 58ca6553..0e4ee2e8 100644 --- a/translated_images/hr/.co-op-translator.json +++ b/translated_images/hr/.co-op-translator.json @@ -77,12 +77,24 @@ "source_file": "01-IntroToGenAI/images/mcp.png", "language_code": "hr" }, + "models.cb07f8af0d724e4d.webp": { + "original_hash": "a1d68725372d3c033c59d1719b859d60", + "translation_date": "2026-01-29T16:17:47+00:00", + "source_file": "02-SetupDevEnvironment/images/models.webp", + "language_code": "hr" + }, "responsible.e4f51a917bafa4bf.webp": { "original_hash": "fa8d1e23eabb52aff991b3257f039a93", "translation_date": "2026-01-16T07:34:16+00:00", "source_file": "05-ResponsibleGenAI/images/responsible.png", "language_code": "hr" }, + "tokens.6283ed277a2ffff4.webp": { + "original_hash": "11572cc20ac9478d3d009a4b7e6aad2d", + "translation_date": "2026-01-29T16:17:23+00:00", + "source_file": "01-IntroToGenAI/images/tokens.webp", + "language_code": "hr" + }, "tool.189edfdb50db566d.webp": { "original_hash": "ed2556303c831d1c9277652dc12014a1", "translation_date": "2026-01-16T07:32:52+00:00", diff --git a/translated_images/hr/models.cb07f8af0d724e4d.webp b/translated_images/hr/models.cb07f8af0d724e4d.webp new file mode 100644 index 00000000..e30879e9 Binary files /dev/null and b/translated_images/hr/models.cb07f8af0d724e4d.webp differ diff --git a/translated_images/hr/tokens.6283ed277a2ffff4.webp b/translated_images/hr/tokens.6283ed277a2ffff4.webp new file mode 100644 index 00000000..8e8e6bce Binary files /dev/null and b/translated_images/hr/tokens.6283ed277a2ffff4.webp differ diff --git a/translated_images/hu/.co-op-translator.json b/translated_images/hu/.co-op-translator.json index 3d8043b8..8e03651c 100644 --- a/translated_images/hu/.co-op-translator.json +++ b/translated_images/hu/.co-op-translator.json @@ -77,12 +77,24 @@ "source_file": "01-IntroToGenAI/images/mcp.png", "language_code": "hu" }, + "models.cb07f8af0d724e4d.webp": { + "original_hash": "a1d68725372d3c033c59d1719b859d60", + "translation_date": "2026-01-29T16:07:50+00:00", + "source_file": "02-SetupDevEnvironment/images/models.webp", + "language_code": "hu" + }, "responsible.e4f51a917bafa4bf.webp": { "original_hash": "fa8d1e23eabb52aff991b3257f039a93", "translation_date": "2026-01-16T07:24:49+00:00", "source_file": "05-ResponsibleGenAI/images/responsible.png", "language_code": "hu" }, + "tokens.6283ed277a2ffff4.webp": { + "original_hash": "11572cc20ac9478d3d009a4b7e6aad2d", + "translation_date": "2026-01-29T16:07:28+00:00", + "source_file": "01-IntroToGenAI/images/tokens.webp", + "language_code": "hu" + }, "tool.189edfdb50db566d.webp": { "original_hash": "ed2556303c831d1c9277652dc12014a1", "translation_date": "2026-01-16T07:23:16+00:00", diff --git a/translated_images/hu/models.cb07f8af0d724e4d.webp b/translated_images/hu/models.cb07f8af0d724e4d.webp new file mode 100644 index 00000000..e30879e9 Binary files /dev/null and b/translated_images/hu/models.cb07f8af0d724e4d.webp differ diff --git a/translated_images/hu/tokens.6283ed277a2ffff4.webp b/translated_images/hu/tokens.6283ed277a2ffff4.webp new file mode 100644 index 00000000..8e8e6bce Binary files /dev/null and b/translated_images/hu/tokens.6283ed277a2ffff4.webp differ diff --git a/translated_images/id/.co-op-translator.json b/translated_images/id/.co-op-translator.json index cc3dc6b9..360dd32b 100644 --- a/translated_images/id/.co-op-translator.json +++ b/translated_images/id/.co-op-translator.json @@ -77,12 +77,24 @@ "source_file": "01-IntroToGenAI/images/mcp.png", "language_code": "id" }, + "models.cb07f8af0d724e4d.webp": { + "original_hash": "a1d68725372d3c033c59d1719b859d60", + "translation_date": "2026-01-29T16:03:07+00:00", + "source_file": "02-SetupDevEnvironment/images/models.webp", + "language_code": "id" + }, "responsible.e4f51a917bafa4bf.webp": { "original_hash": "fa8d1e23eabb52aff991b3257f039a93", "translation_date": "2026-01-16T07:19:50+00:00", "source_file": "05-ResponsibleGenAI/images/responsible.png", "language_code": "id" }, + "tokens.6283ed277a2ffff4.webp": { + "original_hash": "11572cc20ac9478d3d009a4b7e6aad2d", + "translation_date": "2026-01-29T16:02:56+00:00", + "source_file": "01-IntroToGenAI/images/tokens.webp", + "language_code": "id" + }, "tool.189edfdb50db566d.webp": { "original_hash": "ed2556303c831d1c9277652dc12014a1", "translation_date": "2026-01-16T07:18:37+00:00", diff --git a/translated_images/id/models.cb07f8af0d724e4d.webp b/translated_images/id/models.cb07f8af0d724e4d.webp new file mode 100644 index 00000000..e30879e9 Binary files /dev/null and b/translated_images/id/models.cb07f8af0d724e4d.webp differ diff --git a/translated_images/id/tokens.6283ed277a2ffff4.webp b/translated_images/id/tokens.6283ed277a2ffff4.webp new file mode 100644 index 00000000..8e8e6bce Binary files /dev/null and b/translated_images/id/tokens.6283ed277a2ffff4.webp differ diff --git a/translated_images/it/.co-op-translator.json b/translated_images/it/.co-op-translator.json index ff611b3f..323524da 100644 --- a/translated_images/it/.co-op-translator.json +++ b/translated_images/it/.co-op-translator.json @@ -77,12 +77,24 @@ "source_file": "01-IntroToGenAI/images/mcp.png", "language_code": "it" }, + "models.cb07f8af0d724e4d.webp": { + "original_hash": "a1d68725372d3c033c59d1719b859d60", + "translation_date": "2026-01-29T15:45:55+00:00", + "source_file": "02-SetupDevEnvironment/images/models.webp", + "language_code": "it" + }, "responsible.e4f51a917bafa4bf.webp": { "original_hash": "fa8d1e23eabb52aff991b3257f039a93", "translation_date": "2026-01-16T07:01:38+00:00", "source_file": "05-ResponsibleGenAI/images/responsible.png", "language_code": "it" }, + "tokens.6283ed277a2ffff4.webp": { + "original_hash": "11572cc20ac9478d3d009a4b7e6aad2d", + "translation_date": "2026-01-29T15:45:45+00:00", + "source_file": "01-IntroToGenAI/images/tokens.webp", + "language_code": "it" + }, "tool.189edfdb50db566d.webp": { "original_hash": "ed2556303c831d1c9277652dc12014a1", "translation_date": "2026-01-16T07:00:21+00:00", diff --git a/translated_images/it/models.cb07f8af0d724e4d.webp b/translated_images/it/models.cb07f8af0d724e4d.webp new file mode 100644 index 00000000..e30879e9 Binary files /dev/null and b/translated_images/it/models.cb07f8af0d724e4d.webp differ diff --git a/translated_images/it/tokens.6283ed277a2ffff4.webp b/translated_images/it/tokens.6283ed277a2ffff4.webp new file mode 100644 index 00000000..8e8e6bce Binary files /dev/null and b/translated_images/it/tokens.6283ed277a2ffff4.webp differ diff --git a/translated_images/ja/.co-op-translator.json b/translated_images/ja/.co-op-translator.json index bce3d64e..fee03281 100644 --- a/translated_images/ja/.co-op-translator.json +++ b/translated_images/ja/.co-op-translator.json @@ -77,12 +77,24 @@ "source_file": "01-IntroToGenAI/images/mcp.png", "language_code": "ja" }, + "models.cb07f8af0d724e4d.webp": { + "original_hash": "a1d68725372d3c033c59d1719b859d60", + "translation_date": "2026-01-29T15:32:32+00:00", + "source_file": "02-SetupDevEnvironment/images/models.webp", + "language_code": "ja" + }, "responsible.e4f51a917bafa4bf.webp": { "original_hash": "fa8d1e23eabb52aff991b3257f039a93", "translation_date": "2026-01-16T06:47:22+00:00", "source_file": "05-ResponsibleGenAI/images/responsible.png", "language_code": "ja" }, + "tokens.6283ed277a2ffff4.webp": { + "original_hash": "11572cc20ac9478d3d009a4b7e6aad2d", + "translation_date": "2026-01-29T15:32:21+00:00", + "source_file": "01-IntroToGenAI/images/tokens.webp", + "language_code": "ja" + }, "tool.189edfdb50db566d.webp": { "original_hash": "ed2556303c831d1c9277652dc12014a1", "translation_date": "2026-01-16T06:46:09+00:00", diff --git a/translated_images/ja/models.cb07f8af0d724e4d.webp b/translated_images/ja/models.cb07f8af0d724e4d.webp new file mode 100644 index 00000000..e30879e9 Binary files /dev/null and b/translated_images/ja/models.cb07f8af0d724e4d.webp differ diff --git a/translated_images/ja/tokens.6283ed277a2ffff4.webp b/translated_images/ja/tokens.6283ed277a2ffff4.webp new file mode 100644 index 00000000..8e8e6bce Binary files /dev/null and b/translated_images/ja/tokens.6283ed277a2ffff4.webp differ diff --git a/translated_images/kn/.co-op-translator.json b/translated_images/kn/.co-op-translator.json index 9125b49e..b9089e94 100644 --- a/translated_images/kn/.co-op-translator.json +++ b/translated_images/kn/.co-op-translator.json @@ -77,12 +77,24 @@ "source_file": "01-IntroToGenAI/images/mcp.png", "language_code": "kn" }, + "models.cb07f8af0d724e4d.webp": { + "original_hash": "a1d68725372d3c033c59d1719b859d60", + "translation_date": "2026-01-29T16:32:35+00:00", + "source_file": "02-SetupDevEnvironment/images/models.webp", + "language_code": "kn" + }, "responsible.e4f51a917bafa4bf.webp": { "original_hash": "fa8d1e23eabb52aff991b3257f039a93", "translation_date": "2026-01-16T07:48:31+00:00", "source_file": "05-ResponsibleGenAI/images/responsible.png", "language_code": "kn" }, + "tokens.6283ed277a2ffff4.webp": { + "original_hash": "11572cc20ac9478d3d009a4b7e6aad2d", + "translation_date": "2026-01-29T16:31:57+00:00", + "source_file": "01-IntroToGenAI/images/tokens.webp", + "language_code": "kn" + }, "tool.189edfdb50db566d.webp": { "original_hash": "ed2556303c831d1c9277652dc12014a1", "translation_date": "2026-01-16T07:47:06+00:00", diff --git a/translated_images/kn/models.cb07f8af0d724e4d.webp b/translated_images/kn/models.cb07f8af0d724e4d.webp new file mode 100644 index 00000000..e30879e9 Binary files /dev/null and b/translated_images/kn/models.cb07f8af0d724e4d.webp differ diff --git a/translated_images/kn/tokens.6283ed277a2ffff4.webp b/translated_images/kn/tokens.6283ed277a2ffff4.webp new file mode 100644 index 00000000..8e8e6bce Binary files /dev/null and b/translated_images/kn/tokens.6283ed277a2ffff4.webp differ diff --git a/translated_images/ko/.co-op-translator.json b/translated_images/ko/.co-op-translator.json index 8098709c..5592b42b 100644 --- a/translated_images/ko/.co-op-translator.json +++ b/translated_images/ko/.co-op-translator.json @@ -77,12 +77,24 @@ "source_file": "01-IntroToGenAI/images/mcp.png", "language_code": "ko" }, + "models.cb07f8af0d724e4d.webp": { + "original_hash": "a1d68725372d3c033c59d1719b859d60", + "translation_date": "2026-01-29T15:32:40+00:00", + "source_file": "02-SetupDevEnvironment/images/models.webp", + "language_code": "ko" + }, "responsible.e4f51a917bafa4bf.webp": { "original_hash": "fa8d1e23eabb52aff991b3257f039a93", "translation_date": "2026-01-16T06:47:28+00:00", "source_file": "05-ResponsibleGenAI/images/responsible.png", "language_code": "ko" }, + "tokens.6283ed277a2ffff4.webp": { + "original_hash": "11572cc20ac9478d3d009a4b7e6aad2d", + "translation_date": "2026-01-29T15:32:22+00:00", + "source_file": "01-IntroToGenAI/images/tokens.webp", + "language_code": "ko" + }, "tool.189edfdb50db566d.webp": { "original_hash": "ed2556303c831d1c9277652dc12014a1", "translation_date": "2026-01-16T06:46:14+00:00", diff --git a/translated_images/ko/models.cb07f8af0d724e4d.webp b/translated_images/ko/models.cb07f8af0d724e4d.webp new file mode 100644 index 00000000..e30879e9 Binary files /dev/null and b/translated_images/ko/models.cb07f8af0d724e4d.webp differ diff --git a/translated_images/ko/tokens.6283ed277a2ffff4.webp b/translated_images/ko/tokens.6283ed277a2ffff4.webp new file mode 100644 index 00000000..8e8e6bce Binary files /dev/null and b/translated_images/ko/tokens.6283ed277a2ffff4.webp differ diff --git a/translated_images/lt/.co-op-translator.json b/translated_images/lt/.co-op-translator.json index d4dbe6b4..b2d299bb 100644 --- a/translated_images/lt/.co-op-translator.json +++ b/translated_images/lt/.co-op-translator.json @@ -77,12 +77,24 @@ "source_file": "01-IntroToGenAI/images/mcp.png", "language_code": "lt" }, + "models.cb07f8af0d724e4d.webp": { + "original_hash": "a1d68725372d3c033c59d1719b859d60", + "translation_date": "2026-01-29T16:22:57+00:00", + "source_file": "02-SetupDevEnvironment/images/models.webp", + "language_code": "lt" + }, "responsible.e4f51a917bafa4bf.webp": { "original_hash": "fa8d1e23eabb52aff991b3257f039a93", "translation_date": "2026-01-16T07:39:11+00:00", "source_file": "05-ResponsibleGenAI/images/responsible.png", "language_code": "lt" }, + "tokens.6283ed277a2ffff4.webp": { + "original_hash": "11572cc20ac9478d3d009a4b7e6aad2d", + "translation_date": "2026-01-29T16:22:13+00:00", + "source_file": "01-IntroToGenAI/images/tokens.webp", + "language_code": "lt" + }, "tool.189edfdb50db566d.webp": { "original_hash": "ed2556303c831d1c9277652dc12014a1", "translation_date": "2026-01-16T07:37:48+00:00", diff --git a/translated_images/lt/models.cb07f8af0d724e4d.webp b/translated_images/lt/models.cb07f8af0d724e4d.webp new file mode 100644 index 00000000..e30879e9 Binary files /dev/null and b/translated_images/lt/models.cb07f8af0d724e4d.webp differ diff --git a/translated_images/lt/tokens.6283ed277a2ffff4.webp b/translated_images/lt/tokens.6283ed277a2ffff4.webp new file mode 100644 index 00000000..8e8e6bce Binary files /dev/null and b/translated_images/lt/tokens.6283ed277a2ffff4.webp differ diff --git a/translated_images/ml/.co-op-translator.json b/translated_images/ml/.co-op-translator.json index a744afaa..e1b9ca46 100644 --- a/translated_images/ml/.co-op-translator.json +++ b/translated_images/ml/.co-op-translator.json @@ -77,12 +77,24 @@ "source_file": "01-IntroToGenAI/images/mcp.png", "language_code": "ml" }, + "models.cb07f8af0d724e4d.webp": { + "original_hash": "a1d68725372d3c033c59d1719b859d60", + "translation_date": "2026-01-29T16:32:23+00:00", + "source_file": "02-SetupDevEnvironment/images/models.webp", + "language_code": "ml" + }, "responsible.e4f51a917bafa4bf.webp": { "original_hash": "fa8d1e23eabb52aff991b3257f039a93", "translation_date": "2026-01-16T07:48:24+00:00", "source_file": "05-ResponsibleGenAI/images/responsible.png", "language_code": "ml" }, + "tokens.6283ed277a2ffff4.webp": { + "original_hash": "11572cc20ac9478d3d009a4b7e6aad2d", + "translation_date": "2026-01-29T16:31:56+00:00", + "source_file": "01-IntroToGenAI/images/tokens.webp", + "language_code": "ml" + }, "tool.189edfdb50db566d.webp": { "original_hash": "ed2556303c831d1c9277652dc12014a1", "translation_date": "2026-01-16T07:46:59+00:00", diff --git a/translated_images/ml/models.cb07f8af0d724e4d.webp b/translated_images/ml/models.cb07f8af0d724e4d.webp new file mode 100644 index 00000000..e30879e9 Binary files /dev/null and b/translated_images/ml/models.cb07f8af0d724e4d.webp differ diff --git a/translated_images/ml/tokens.6283ed277a2ffff4.webp b/translated_images/ml/tokens.6283ed277a2ffff4.webp new file mode 100644 index 00000000..8e8e6bce Binary files /dev/null and b/translated_images/ml/tokens.6283ed277a2ffff4.webp differ diff --git a/translated_images/mr/.co-op-translator.json b/translated_images/mr/.co-op-translator.json index 17b67ea7..3ae0efeb 100644 --- a/translated_images/mr/.co-op-translator.json +++ b/translated_images/mr/.co-op-translator.json @@ -77,12 +77,24 @@ "source_file": "01-IntroToGenAI/images/mcp.png", "language_code": "mr" }, + "models.cb07f8af0d724e4d.webp": { + "original_hash": "a1d68725372d3c033c59d1719b859d60", + "translation_date": "2026-01-29T15:37:17+00:00", + "source_file": "02-SetupDevEnvironment/images/models.webp", + "language_code": "mr" + }, "responsible.e4f51a917bafa4bf.webp": { "original_hash": "fa8d1e23eabb52aff991b3257f039a93", "translation_date": "2026-01-16T06:52:18+00:00", "source_file": "05-ResponsibleGenAI/images/responsible.png", "language_code": "mr" }, + "tokens.6283ed277a2ffff4.webp": { + "original_hash": "11572cc20ac9478d3d009a4b7e6aad2d", + "translation_date": "2026-01-29T15:36:50+00:00", + "source_file": "01-IntroToGenAI/images/tokens.webp", + "language_code": "mr" + }, "tool.189edfdb50db566d.webp": { "original_hash": "ed2556303c831d1c9277652dc12014a1", "translation_date": "2026-01-16T06:51:00+00:00", diff --git a/translated_images/mr/models.cb07f8af0d724e4d.webp b/translated_images/mr/models.cb07f8af0d724e4d.webp new file mode 100644 index 00000000..e30879e9 Binary files /dev/null and b/translated_images/mr/models.cb07f8af0d724e4d.webp differ diff --git a/translated_images/mr/tokens.6283ed277a2ffff4.webp b/translated_images/mr/tokens.6283ed277a2ffff4.webp new file mode 100644 index 00000000..8e8e6bce Binary files /dev/null and b/translated_images/mr/tokens.6283ed277a2ffff4.webp differ diff --git a/translated_images/ms/.co-op-translator.json b/translated_images/ms/.co-op-translator.json index a16f913f..74820f4b 100644 --- a/translated_images/ms/.co-op-translator.json +++ b/translated_images/ms/.co-op-translator.json @@ -77,12 +77,24 @@ "source_file": "01-IntroToGenAI/images/mcp.png", "language_code": "ms" }, + "models.cb07f8af0d724e4d.webp": { + "original_hash": "a1d68725372d3c033c59d1719b859d60", + "translation_date": "2026-01-29T16:03:15+00:00", + "source_file": "02-SetupDevEnvironment/images/models.webp", + "language_code": "ms" + }, "responsible.e4f51a917bafa4bf.webp": { "original_hash": "fa8d1e23eabb52aff991b3257f039a93", "translation_date": "2026-01-16T07:19:56+00:00", "source_file": "05-ResponsibleGenAI/images/responsible.png", "language_code": "ms" }, + "tokens.6283ed277a2ffff4.webp": { + "original_hash": "11572cc20ac9478d3d009a4b7e6aad2d", + "translation_date": "2026-01-29T16:02:57+00:00", + "source_file": "01-IntroToGenAI/images/tokens.webp", + "language_code": "ms" + }, "tool.189edfdb50db566d.webp": { "original_hash": "ed2556303c831d1c9277652dc12014a1", "translation_date": "2026-01-16T07:18:45+00:00", diff --git a/translated_images/ms/models.cb07f8af0d724e4d.webp b/translated_images/ms/models.cb07f8af0d724e4d.webp new file mode 100644 index 00000000..e30879e9 Binary files /dev/null and b/translated_images/ms/models.cb07f8af0d724e4d.webp differ diff --git a/translated_images/ms/tokens.6283ed277a2ffff4.webp b/translated_images/ms/tokens.6283ed277a2ffff4.webp new file mode 100644 index 00000000..8e8e6bce Binary files /dev/null and b/translated_images/ms/tokens.6283ed277a2ffff4.webp differ diff --git a/translated_images/my/.co-op-translator.json b/translated_images/my/.co-op-translator.json index a3b4dac6..02f2ca29 100644 --- a/translated_images/my/.co-op-translator.json +++ b/translated_images/my/.co-op-translator.json @@ -77,12 +77,24 @@ "source_file": "01-IntroToGenAI/images/mcp.png", "language_code": "my" }, + "models.cb07f8af0d724e4d.webp": { + "original_hash": "a1d68725372d3c033c59d1719b859d60", + "translation_date": "2026-01-29T16:22:35+00:00", + "source_file": "02-SetupDevEnvironment/images/models.webp", + "language_code": "my" + }, "responsible.e4f51a917bafa4bf.webp": { "original_hash": "fa8d1e23eabb52aff991b3257f039a93", "translation_date": "2026-01-16T07:38:54+00:00", "source_file": "05-ResponsibleGenAI/images/responsible.png", "language_code": "my" }, + "tokens.6283ed277a2ffff4.webp": { + "original_hash": "11572cc20ac9478d3d009a4b7e6aad2d", + "translation_date": "2026-01-29T16:22:11+00:00", + "source_file": "01-IntroToGenAI/images/tokens.webp", + "language_code": "my" + }, "tool.189edfdb50db566d.webp": { "original_hash": "ed2556303c831d1c9277652dc12014a1", "translation_date": "2026-01-16T07:37:33+00:00", diff --git a/translated_images/my/models.cb07f8af0d724e4d.webp b/translated_images/my/models.cb07f8af0d724e4d.webp new file mode 100644 index 00000000..e30879e9 Binary files /dev/null and b/translated_images/my/models.cb07f8af0d724e4d.webp differ diff --git a/translated_images/my/tokens.6283ed277a2ffff4.webp b/translated_images/my/tokens.6283ed277a2ffff4.webp new file mode 100644 index 00000000..8e8e6bce Binary files /dev/null and b/translated_images/my/tokens.6283ed277a2ffff4.webp differ diff --git a/translated_images/ne/.co-op-translator.json b/translated_images/ne/.co-op-translator.json index 8fa20396..f74592c5 100644 --- a/translated_images/ne/.co-op-translator.json +++ b/translated_images/ne/.co-op-translator.json @@ -77,12 +77,24 @@ "source_file": "01-IntroToGenAI/images/mcp.png", "language_code": "ne" }, + "models.cb07f8af0d724e4d.webp": { + "original_hash": "a1d68725372d3c033c59d1719b859d60", + "translation_date": "2026-01-29T15:37:28+00:00", + "source_file": "02-SetupDevEnvironment/images/models.webp", + "language_code": "ne" + }, "responsible.e4f51a917bafa4bf.webp": { "original_hash": "fa8d1e23eabb52aff991b3257f039a93", "translation_date": "2026-01-16T06:52:23+00:00", "source_file": "05-ResponsibleGenAI/images/responsible.png", "language_code": "ne" }, + "tokens.6283ed277a2ffff4.webp": { + "original_hash": "11572cc20ac9478d3d009a4b7e6aad2d", + "translation_date": "2026-01-29T15:36:52+00:00", + "source_file": "01-IntroToGenAI/images/tokens.webp", + "language_code": "ne" + }, "tool.189edfdb50db566d.webp": { "original_hash": "ed2556303c831d1c9277652dc12014a1", "translation_date": "2026-01-16T06:51:06+00:00", diff --git a/translated_images/ne/models.cb07f8af0d724e4d.webp b/translated_images/ne/models.cb07f8af0d724e4d.webp new file mode 100644 index 00000000..e30879e9 Binary files /dev/null and b/translated_images/ne/models.cb07f8af0d724e4d.webp differ diff --git a/translated_images/ne/tokens.6283ed277a2ffff4.webp b/translated_images/ne/tokens.6283ed277a2ffff4.webp new file mode 100644 index 00000000..8e8e6bce Binary files /dev/null and b/translated_images/ne/tokens.6283ed277a2ffff4.webp differ diff --git a/translated_images/nl/.co-op-translator.json b/translated_images/nl/.co-op-translator.json index 213dacd1..26170c03 100644 --- a/translated_images/nl/.co-op-translator.json +++ b/translated_images/nl/.co-op-translator.json @@ -77,12 +77,24 @@ "source_file": "01-IntroToGenAI/images/mcp.png", "language_code": "nl" }, + "models.cb07f8af0d724e4d.webp": { + "original_hash": "a1d68725372d3c033c59d1719b859d60", + "translation_date": "2026-01-29T15:58:41+00:00", + "source_file": "02-SetupDevEnvironment/images/models.webp", + "language_code": "nl" + }, "responsible.e4f51a917bafa4bf.webp": { "original_hash": "fa8d1e23eabb52aff991b3257f039a93", "translation_date": "2026-01-16T07:15:13+00:00", "source_file": "05-ResponsibleGenAI/images/responsible.png", "language_code": "nl" }, + "tokens.6283ed277a2ffff4.webp": { + "original_hash": "11572cc20ac9478d3d009a4b7e6aad2d", + "translation_date": "2026-01-29T15:58:32+00:00", + "source_file": "01-IntroToGenAI/images/tokens.webp", + "language_code": "nl" + }, "tool.189edfdb50db566d.webp": { "original_hash": "ed2556303c831d1c9277652dc12014a1", "translation_date": "2026-01-16T07:14:02+00:00", diff --git a/translated_images/nl/models.cb07f8af0d724e4d.webp b/translated_images/nl/models.cb07f8af0d724e4d.webp new file mode 100644 index 00000000..e30879e9 Binary files /dev/null and b/translated_images/nl/models.cb07f8af0d724e4d.webp differ diff --git a/translated_images/nl/tokens.6283ed277a2ffff4.webp b/translated_images/nl/tokens.6283ed277a2ffff4.webp new file mode 100644 index 00000000..8e8e6bce Binary files /dev/null and b/translated_images/nl/tokens.6283ed277a2ffff4.webp differ diff --git a/translated_images/no/.co-op-translator.json b/translated_images/no/.co-op-translator.json index c6a85948..05dc1239 100644 --- a/translated_images/no/.co-op-translator.json +++ b/translated_images/no/.co-op-translator.json @@ -77,12 +77,24 @@ "source_file": "01-IntroToGenAI/images/mcp.png", "language_code": "no" }, + "models.cb07f8af0d724e4d.webp": { + "original_hash": "a1d68725372d3c033c59d1719b859d60", + "translation_date": "2026-01-29T15:54:56+00:00", + "source_file": "02-SetupDevEnvironment/images/models.webp", + "language_code": "no" + }, "responsible.e4f51a917bafa4bf.webp": { "original_hash": "fa8d1e23eabb52aff991b3257f039a93", "translation_date": "2026-01-16T07:10:58+00:00", "source_file": "05-ResponsibleGenAI/images/responsible.png", "language_code": "no" }, + "tokens.6283ed277a2ffff4.webp": { + "original_hash": "11572cc20ac9478d3d009a4b7e6aad2d", + "translation_date": "2026-01-29T15:54:39+00:00", + "source_file": "01-IntroToGenAI/images/tokens.webp", + "language_code": "no" + }, "tool.189edfdb50db566d.webp": { "original_hash": "ed2556303c831d1c9277652dc12014a1", "translation_date": "2026-01-16T07:09:48+00:00", diff --git a/translated_images/no/models.cb07f8af0d724e4d.webp b/translated_images/no/models.cb07f8af0d724e4d.webp new file mode 100644 index 00000000..e30879e9 Binary files /dev/null and b/translated_images/no/models.cb07f8af0d724e4d.webp differ diff --git a/translated_images/no/tokens.6283ed277a2ffff4.webp b/translated_images/no/tokens.6283ed277a2ffff4.webp new file mode 100644 index 00000000..8e8e6bce Binary files /dev/null and b/translated_images/no/tokens.6283ed277a2ffff4.webp differ diff --git a/translated_images/pa/.co-op-translator.json b/translated_images/pa/.co-op-translator.json index dd1048f4..eebf34d1 100644 --- a/translated_images/pa/.co-op-translator.json +++ b/translated_images/pa/.co-op-translator.json @@ -77,12 +77,24 @@ "source_file": "01-IntroToGenAI/images/mcp.png", "language_code": "pa" }, + "models.cb07f8af0d724e4d.webp": { + "original_hash": "a1d68725372d3c033c59d1719b859d60", + "translation_date": "2026-01-29T15:41:41+00:00", + "source_file": "02-SetupDevEnvironment/images/models.webp", + "language_code": "pa" + }, "responsible.e4f51a917bafa4bf.webp": { "original_hash": "fa8d1e23eabb52aff991b3257f039a93", "translation_date": "2026-01-16T06:56:59+00:00", "source_file": "05-ResponsibleGenAI/images/responsible.png", "language_code": "pa" }, + "tokens.6283ed277a2ffff4.webp": { + "original_hash": "11572cc20ac9478d3d009a4b7e6aad2d", + "translation_date": "2026-01-29T15:41:26+00:00", + "source_file": "01-IntroToGenAI/images/tokens.webp", + "language_code": "pa" + }, "tool.189edfdb50db566d.webp": { "original_hash": "ed2556303c831d1c9277652dc12014a1", "translation_date": "2026-01-16T06:55:45+00:00", diff --git a/translated_images/pa/models.cb07f8af0d724e4d.webp b/translated_images/pa/models.cb07f8af0d724e4d.webp new file mode 100644 index 00000000..e30879e9 Binary files /dev/null and b/translated_images/pa/models.cb07f8af0d724e4d.webp differ diff --git a/translated_images/pa/tokens.6283ed277a2ffff4.webp b/translated_images/pa/tokens.6283ed277a2ffff4.webp new file mode 100644 index 00000000..8e8e6bce Binary files /dev/null and b/translated_images/pa/tokens.6283ed277a2ffff4.webp differ diff --git a/translated_images/pcm/.co-op-translator.json b/translated_images/pcm/.co-op-translator.json index c6352870..e4fce632 100644 --- a/translated_images/pcm/.co-op-translator.json +++ b/translated_images/pcm/.co-op-translator.json @@ -77,12 +77,24 @@ "source_file": "01-IntroToGenAI/images/mcp.png", "language_code": "pcm" }, + "models.cb07f8af0d724e4d.webp": { + "original_hash": "a1d68725372d3c033c59d1719b859d60", + "translation_date": "2026-01-29T16:27:24+00:00", + "source_file": "02-SetupDevEnvironment/images/models.webp", + "language_code": "pcm" + }, "responsible.e4f51a917bafa4bf.webp": { "original_hash": "fa8d1e23eabb52aff991b3257f039a93", "translation_date": "2026-01-16T07:43:51+00:00", "source_file": "05-ResponsibleGenAI/images/responsible.png", "language_code": "pcm" }, + "tokens.6283ed277a2ffff4.webp": { + "original_hash": "11572cc20ac9478d3d009a4b7e6aad2d", + "translation_date": "2026-01-29T16:26:55+00:00", + "source_file": "01-IntroToGenAI/images/tokens.webp", + "language_code": "pcm" + }, "tool.189edfdb50db566d.webp": { "original_hash": "ed2556303c831d1c9277652dc12014a1", "translation_date": "2026-01-16T07:42:38+00:00", diff --git a/translated_images/pcm/models.cb07f8af0d724e4d.webp b/translated_images/pcm/models.cb07f8af0d724e4d.webp new file mode 100644 index 00000000..e30879e9 Binary files /dev/null and b/translated_images/pcm/models.cb07f8af0d724e4d.webp differ diff --git a/translated_images/pcm/tokens.6283ed277a2ffff4.webp b/translated_images/pcm/tokens.6283ed277a2ffff4.webp new file mode 100644 index 00000000..8e8e6bce Binary files /dev/null and b/translated_images/pcm/tokens.6283ed277a2ffff4.webp differ diff --git a/translated_images/pl/.co-op-translator.json b/translated_images/pl/.co-op-translator.json index 996835bf..447cd15f 100644 --- a/translated_images/pl/.co-op-translator.json +++ b/translated_images/pl/.co-op-translator.json @@ -77,12 +77,24 @@ "source_file": "01-IntroToGenAI/images/mcp.png", "language_code": "pl" }, + "models.cb07f8af0d724e4d.webp": { + "original_hash": "a1d68725372d3c033c59d1719b859d60", + "translation_date": "2026-01-29T15:46:04+00:00", + "source_file": "02-SetupDevEnvironment/images/models.webp", + "language_code": "pl" + }, "responsible.e4f51a917bafa4bf.webp": { "original_hash": "fa8d1e23eabb52aff991b3257f039a93", "translation_date": "2026-01-16T07:01:45+00:00", "source_file": "05-ResponsibleGenAI/images/responsible.png", "language_code": "pl" }, + "tokens.6283ed277a2ffff4.webp": { + "original_hash": "11572cc20ac9478d3d009a4b7e6aad2d", + "translation_date": "2026-01-29T15:45:46+00:00", + "source_file": "01-IntroToGenAI/images/tokens.webp", + "language_code": "pl" + }, "tool.189edfdb50db566d.webp": { "original_hash": "ed2556303c831d1c9277652dc12014a1", "translation_date": "2026-01-16T07:00:29+00:00", diff --git a/translated_images/pl/models.cb07f8af0d724e4d.webp b/translated_images/pl/models.cb07f8af0d724e4d.webp new file mode 100644 index 00000000..e30879e9 Binary files /dev/null and b/translated_images/pl/models.cb07f8af0d724e4d.webp differ diff --git a/translated_images/pl/tokens.6283ed277a2ffff4.webp b/translated_images/pl/tokens.6283ed277a2ffff4.webp new file mode 100644 index 00000000..8e8e6bce Binary files /dev/null and b/translated_images/pl/tokens.6283ed277a2ffff4.webp differ diff --git a/translated_images/br/.co-op-translator.json b/translated_images/pt-BR/.co-op-translator.json similarity index 78% rename from translated_images/br/.co-op-translator.json rename to translated_images/pt-BR/.co-op-translator.json index 96c59417..f96a50ce 100644 --- a/translated_images/br/.co-op-translator.json +++ b/translated_images/pt-BR/.co-op-translator.json @@ -3,96 +3,108 @@ "original_hash": "a967aa7c967f7eef94f31926c4c8067c", "translation_date": "2026-01-16T06:55:38+00:00", "source_file": "images/beg-genai-series.png", - "language_code": "br" + "language_code": "pt-BR" }, "codespaces-create.b44a36f728660ab7.webp": { "original_hash": "7eab55896561d1bc55c6a162156d0017", "translation_date": "2026-01-16T06:57:59+00:00", "source_file": "02-SetupDevEnvironment/images/codespaces-create.png", - "language_code": "br" + "language_code": "pt-BR" }, "codespaces.9945ded8ceb431a5.webp": { "original_hash": "48d3567c3959e06e4ce108c43a1bb655", "translation_date": "2026-01-16T06:57:25+00:00", "source_file": "02-SetupDevEnvironment/images/codespaces.png", - "language_code": "br" + "language_code": "pt-BR" }, "devcontainer.21126c9d6de64494.webp": { "original_hash": "5a080e0e2e92ea495d1fd4fb0c3dca16", "translation_date": "2026-01-16T06:57:30+00:00", "source_file": "02-SetupDevEnvironment/images/devcontainer.png", - "language_code": "br" + "language_code": "pt-BR" }, "embedding.398e50802c0037f9.webp": { "original_hash": "3b42046dab31decbe80630673d9a4299", "translation_date": "2026-01-16T06:56:31+00:00", "source_file": "01-IntroToGenAI/images/embedding.png", - "language_code": "br" + "language_code": "pt-BR" }, "flow.f4ef62c3052d12a8.webp": { "original_hash": "384dbf925c9bd33ed060d90696e1e5dc", "translation_date": "2026-01-16T06:56:21+00:00", "source_file": "01-IntroToGenAI/images/flow.png", - "language_code": "br" + "language_code": "pt-BR" }, "image-1.b36122aba30b20ad.webp": { "original_hash": "beb64e9c23de84eff0eb1949f9e903cd", "translation_date": "2026-01-16T06:59:03+00:00", "source_file": "02-SetupDevEnvironment/images/image-1.png", - "language_code": "br" + "language_code": "pt-BR" }, "image-2.fc0da29a6e4d2aff.webp": { "original_hash": "6e06c4be35f0713416497bbcbf5272f1", "translation_date": "2026-01-16T06:58:29+00:00", "source_file": "02-SetupDevEnvironment/images/image-2.png", - "language_code": "br" + "language_code": "pt-BR" }, "image-3.bf93d533bbc84268.webp": { "original_hash": "682e3bce2f2c57bb12667e96da792191", "translation_date": "2026-01-16T06:57:48+00:00", "source_file": "02-SetupDevEnvironment/images/image-3.png", - "language_code": "br" + "language_code": "pt-BR" }, "image.73c7e2ff4a652e77.webp": { "original_hash": "65b6d1abec8bfb715c24ebe0f8929028", "translation_date": "2026-01-16T06:57:14+00:00", "source_file": "05-ResponsibleGenAI/images/image.png", - "language_code": "br" + "language_code": "pt-BR" }, "image.833552b62eee7766.webp": { "original_hash": "6ea0edb52249206f1b5cbea93bedb7fb", "translation_date": "2026-01-16T06:58:41+00:00", "source_file": "02-SetupDevEnvironment/images/image.png", - "language_code": "br" + "language_code": "pt-BR" }, "llms.225ca2b8a0d34473.webp": { "original_hash": "3e69ea1754a889ad7f1a690103fe75b6", "translation_date": "2026-01-16T06:56:51+00:00", "source_file": "01-IntroToGenAI/images/llms.png", - "language_code": "br" + "language_code": "pt-BR" }, "mcp.3fcf1d13c662ef9a.webp": { "original_hash": "93122a41e7b6451319598b97a160174b", "translation_date": "2026-01-16T06:56:25+00:00", "source_file": "01-IntroToGenAI/images/mcp.png", - "language_code": "br" + "language_code": "pt-BR" + }, + "models.cb07f8af0d724e4d.webp": { + "original_hash": "a1d68725372d3c033c59d1719b859d60", + "translation_date": "2026-01-29T15:41:56+00:00", + "source_file": "02-SetupDevEnvironment/images/models.webp", + "language_code": "pt-BR" }, "responsible.e4f51a917bafa4bf.webp": { "original_hash": "fa8d1e23eabb52aff991b3257f039a93", "translation_date": "2026-01-16T06:57:08+00:00", "source_file": "05-ResponsibleGenAI/images/responsible.png", - "language_code": "br" + "language_code": "pt-BR" + }, + "tokens.6283ed277a2ffff4.webp": { + "original_hash": "11572cc20ac9478d3d009a4b7e6aad2d", + "translation_date": "2026-01-29T15:41:28+00:00", + "source_file": "01-IntroToGenAI/images/tokens.webp", + "language_code": "pt-BR" }, "tool.189edfdb50db566d.webp": { "original_hash": "ed2556303c831d1c9277652dc12014a1", "translation_date": "2026-01-16T06:55:57+00:00", "source_file": "04-PracticalSamples/calculator/images/tool.png", - "language_code": "br" + "language_code": "pt-BR" }, "vector.f12f114934e223df.webp": { "original_hash": "b3c0003a891ccc7f1dc4711beb194a02", "translation_date": "2026-01-16T06:56:41+00:00", "source_file": "01-IntroToGenAI/images/vector.png", - "language_code": "br" + "language_code": "pt-BR" } } \ No newline at end of file diff --git a/translated_images/br/beg-genai-series.8b48be9951cc574c.webp b/translated_images/pt-BR/beg-genai-series.8b48be9951cc574c.webp similarity index 100% rename from translated_images/br/beg-genai-series.8b48be9951cc574c.webp rename to translated_images/pt-BR/beg-genai-series.8b48be9951cc574c.webp diff --git a/translated_images/br/codespaces-create.b44a36f728660ab7.webp b/translated_images/pt-BR/codespaces-create.b44a36f728660ab7.webp similarity index 100% rename from translated_images/br/codespaces-create.b44a36f728660ab7.webp rename to translated_images/pt-BR/codespaces-create.b44a36f728660ab7.webp diff --git a/translated_images/br/codespaces.9945ded8ceb431a5.webp b/translated_images/pt-BR/codespaces.9945ded8ceb431a5.webp similarity index 100% rename from translated_images/br/codespaces.9945ded8ceb431a5.webp rename to translated_images/pt-BR/codespaces.9945ded8ceb431a5.webp diff --git a/translated_images/br/devcontainer.21126c9d6de64494.webp b/translated_images/pt-BR/devcontainer.21126c9d6de64494.webp similarity index 100% rename from translated_images/br/devcontainer.21126c9d6de64494.webp rename to translated_images/pt-BR/devcontainer.21126c9d6de64494.webp diff --git a/translated_images/br/embedding.398e50802c0037f9.webp b/translated_images/pt-BR/embedding.398e50802c0037f9.webp similarity index 100% rename from translated_images/br/embedding.398e50802c0037f9.webp rename to translated_images/pt-BR/embedding.398e50802c0037f9.webp diff --git a/translated_images/br/flow.f4ef62c3052d12a8.webp b/translated_images/pt-BR/flow.f4ef62c3052d12a8.webp similarity index 100% rename from translated_images/br/flow.f4ef62c3052d12a8.webp rename to translated_images/pt-BR/flow.f4ef62c3052d12a8.webp diff --git a/translated_images/br/image-1.b36122aba30b20ad.webp b/translated_images/pt-BR/image-1.b36122aba30b20ad.webp similarity index 100% rename from translated_images/br/image-1.b36122aba30b20ad.webp rename to translated_images/pt-BR/image-1.b36122aba30b20ad.webp diff --git a/translated_images/br/image-2.fc0da29a6e4d2aff.webp b/translated_images/pt-BR/image-2.fc0da29a6e4d2aff.webp similarity index 100% rename from translated_images/br/image-2.fc0da29a6e4d2aff.webp rename to translated_images/pt-BR/image-2.fc0da29a6e4d2aff.webp diff --git a/translated_images/br/image-3.bf93d533bbc84268.webp b/translated_images/pt-BR/image-3.bf93d533bbc84268.webp similarity index 100% rename from translated_images/br/image-3.bf93d533bbc84268.webp rename to translated_images/pt-BR/image-3.bf93d533bbc84268.webp diff --git a/translated_images/br/image.73c7e2ff4a652e77.webp b/translated_images/pt-BR/image.73c7e2ff4a652e77.webp similarity index 100% rename from translated_images/br/image.73c7e2ff4a652e77.webp rename to translated_images/pt-BR/image.73c7e2ff4a652e77.webp diff --git a/translated_images/br/image.833552b62eee7766.webp b/translated_images/pt-BR/image.833552b62eee7766.webp similarity index 100% rename from translated_images/br/image.833552b62eee7766.webp rename to translated_images/pt-BR/image.833552b62eee7766.webp diff --git a/translated_images/br/llms.225ca2b8a0d34473.webp b/translated_images/pt-BR/llms.225ca2b8a0d34473.webp similarity index 100% rename from translated_images/br/llms.225ca2b8a0d34473.webp rename to translated_images/pt-BR/llms.225ca2b8a0d34473.webp diff --git a/translated_images/br/mcp.3fcf1d13c662ef9a.webp b/translated_images/pt-BR/mcp.3fcf1d13c662ef9a.webp similarity index 100% rename from translated_images/br/mcp.3fcf1d13c662ef9a.webp rename to translated_images/pt-BR/mcp.3fcf1d13c662ef9a.webp diff --git a/translated_images/pt-BR/models.cb07f8af0d724e4d.webp b/translated_images/pt-BR/models.cb07f8af0d724e4d.webp new file mode 100644 index 00000000..e30879e9 Binary files /dev/null and b/translated_images/pt-BR/models.cb07f8af0d724e4d.webp differ diff --git a/translated_images/br/responsible.e4f51a917bafa4bf.webp b/translated_images/pt-BR/responsible.e4f51a917bafa4bf.webp similarity index 100% rename from translated_images/br/responsible.e4f51a917bafa4bf.webp rename to translated_images/pt-BR/responsible.e4f51a917bafa4bf.webp diff --git a/translated_images/pt-BR/tokens.6283ed277a2ffff4.webp b/translated_images/pt-BR/tokens.6283ed277a2ffff4.webp new file mode 100644 index 00000000..8e8e6bce Binary files /dev/null and b/translated_images/pt-BR/tokens.6283ed277a2ffff4.webp differ diff --git a/translated_images/br/tool.189edfdb50db566d.webp b/translated_images/pt-BR/tool.189edfdb50db566d.webp similarity index 100% rename from translated_images/br/tool.189edfdb50db566d.webp rename to translated_images/pt-BR/tool.189edfdb50db566d.webp diff --git a/translated_images/br/vector.f12f114934e223df.webp b/translated_images/pt-BR/vector.f12f114934e223df.webp similarity index 100% rename from translated_images/br/vector.f12f114934e223df.webp rename to translated_images/pt-BR/vector.f12f114934e223df.webp diff --git a/translated_images/pt/.co-op-translator.json b/translated_images/pt-PT/.co-op-translator.json similarity index 78% rename from translated_images/pt/.co-op-translator.json rename to translated_images/pt-PT/.co-op-translator.json index 22ac7db5..1610333b 100644 --- a/translated_images/pt/.co-op-translator.json +++ b/translated_images/pt-PT/.co-op-translator.json @@ -3,96 +3,108 @@ "original_hash": "a967aa7c967f7eef94f31926c4c8067c", "translation_date": "2026-01-16T06:55:37+00:00", "source_file": "images/beg-genai-series.png", - "language_code": "pt" + "language_code": "pt-PT" }, "codespaces-create.b44a36f728660ab7.webp": { "original_hash": "7eab55896561d1bc55c6a162156d0017", "translation_date": "2026-01-16T06:57:56+00:00", "source_file": "02-SetupDevEnvironment/images/codespaces-create.png", - "language_code": "pt" + "language_code": "pt-PT" }, "codespaces.9945ded8ceb431a5.webp": { "original_hash": "48d3567c3959e06e4ce108c43a1bb655", "translation_date": "2026-01-16T06:57:21+00:00", "source_file": "02-SetupDevEnvironment/images/codespaces.png", - "language_code": "pt" + "language_code": "pt-PT" }, "devcontainer.21126c9d6de64494.webp": { "original_hash": "5a080e0e2e92ea495d1fd4fb0c3dca16", "translation_date": "2026-01-16T06:57:28+00:00", "source_file": "02-SetupDevEnvironment/images/devcontainer.png", - "language_code": "pt" + "language_code": "pt-PT" }, "embedding.398e50802c0037f9.webp": { "original_hash": "3b42046dab31decbe80630673d9a4299", "translation_date": "2026-01-16T06:56:29+00:00", "source_file": "01-IntroToGenAI/images/embedding.png", - "language_code": "pt" + "language_code": "pt-PT" }, "flow.f4ef62c3052d12a8.webp": { "original_hash": "384dbf925c9bd33ed060d90696e1e5dc", "translation_date": "2026-01-16T06:56:13+00:00", "source_file": "01-IntroToGenAI/images/flow.png", - "language_code": "pt" + "language_code": "pt-PT" }, "image-1.b36122aba30b20ad.webp": { "original_hash": "beb64e9c23de84eff0eb1949f9e903cd", "translation_date": "2026-01-16T06:58:54+00:00", "source_file": "02-SetupDevEnvironment/images/image-1.png", - "language_code": "pt" + "language_code": "pt-PT" }, "image-2.fc0da29a6e4d2aff.webp": { "original_hash": "6e06c4be35f0713416497bbcbf5272f1", "translation_date": "2026-01-16T06:58:20+00:00", "source_file": "02-SetupDevEnvironment/images/image-2.png", - "language_code": "pt" + "language_code": "pt-PT" }, "image-3.bf93d533bbc84268.webp": { "original_hash": "682e3bce2f2c57bb12667e96da792191", "translation_date": "2026-01-16T06:57:42+00:00", "source_file": "02-SetupDevEnvironment/images/image-3.png", - "language_code": "pt" + "language_code": "pt-PT" }, "image.73c7e2ff4a652e77.webp": { "original_hash": "65b6d1abec8bfb715c24ebe0f8929028", "translation_date": "2026-01-16T06:57:12+00:00", "source_file": "05-ResponsibleGenAI/images/image.png", - "language_code": "pt" + "language_code": "pt-PT" }, "image.833552b62eee7766.webp": { "original_hash": "6ea0edb52249206f1b5cbea93bedb7fb", "translation_date": "2026-01-16T06:58:38+00:00", "source_file": "02-SetupDevEnvironment/images/image.png", - "language_code": "pt" + "language_code": "pt-PT" }, "llms.225ca2b8a0d34473.webp": { "original_hash": "3e69ea1754a889ad7f1a690103fe75b6", "translation_date": "2026-01-16T06:56:48+00:00", "source_file": "01-IntroToGenAI/images/llms.png", - "language_code": "pt" + "language_code": "pt-PT" }, "mcp.3fcf1d13c662ef9a.webp": { "original_hash": "93122a41e7b6451319598b97a160174b", "translation_date": "2026-01-16T06:56:24+00:00", "source_file": "01-IntroToGenAI/images/mcp.png", - "language_code": "pt" + "language_code": "pt-PT" + }, + "models.cb07f8af0d724e4d.webp": { + "original_hash": "a1d68725372d3c033c59d1719b859d60", + "translation_date": "2026-01-29T15:41:48+00:00", + "source_file": "02-SetupDevEnvironment/images/models.webp", + "language_code": "pt-PT" }, "responsible.e4f51a917bafa4bf.webp": { "original_hash": "fa8d1e23eabb52aff991b3257f039a93", "translation_date": "2026-01-16T06:57:04+00:00", "source_file": "05-ResponsibleGenAI/images/responsible.png", - "language_code": "pt" + "language_code": "pt-PT" + }, + "tokens.6283ed277a2ffff4.webp": { + "original_hash": "11572cc20ac9478d3d009a4b7e6aad2d", + "translation_date": "2026-01-29T15:41:27+00:00", + "source_file": "01-IntroToGenAI/images/tokens.webp", + "language_code": "pt-PT" }, "tool.189edfdb50db566d.webp": { "original_hash": "ed2556303c831d1c9277652dc12014a1", "translation_date": "2026-01-16T06:55:50+00:00", "source_file": "04-PracticalSamples/calculator/images/tool.png", - "language_code": "pt" + "language_code": "pt-PT" }, "vector.f12f114934e223df.webp": { "original_hash": "b3c0003a891ccc7f1dc4711beb194a02", "translation_date": "2026-01-16T06:56:38+00:00", "source_file": "01-IntroToGenAI/images/vector.png", - "language_code": "pt" + "language_code": "pt-PT" } } \ No newline at end of file diff --git a/translated_images/pt/beg-genai-series.8b48be9951cc574c.webp b/translated_images/pt-PT/beg-genai-series.8b48be9951cc574c.webp similarity index 100% rename from translated_images/pt/beg-genai-series.8b48be9951cc574c.webp rename to translated_images/pt-PT/beg-genai-series.8b48be9951cc574c.webp diff --git a/translated_images/pt/codespaces-create.b44a36f728660ab7.webp b/translated_images/pt-PT/codespaces-create.b44a36f728660ab7.webp similarity index 100% rename from translated_images/pt/codespaces-create.b44a36f728660ab7.webp rename to translated_images/pt-PT/codespaces-create.b44a36f728660ab7.webp diff --git a/translated_images/pt/codespaces.9945ded8ceb431a5.webp b/translated_images/pt-PT/codespaces.9945ded8ceb431a5.webp similarity index 100% rename from translated_images/pt/codespaces.9945ded8ceb431a5.webp rename to translated_images/pt-PT/codespaces.9945ded8ceb431a5.webp diff --git a/translated_images/pt/devcontainer.21126c9d6de64494.webp b/translated_images/pt-PT/devcontainer.21126c9d6de64494.webp similarity index 100% rename from translated_images/pt/devcontainer.21126c9d6de64494.webp rename to translated_images/pt-PT/devcontainer.21126c9d6de64494.webp diff --git a/translated_images/pt/embedding.398e50802c0037f9.webp b/translated_images/pt-PT/embedding.398e50802c0037f9.webp similarity index 100% rename from translated_images/pt/embedding.398e50802c0037f9.webp rename to translated_images/pt-PT/embedding.398e50802c0037f9.webp diff --git a/translated_images/pt/flow.f4ef62c3052d12a8.webp b/translated_images/pt-PT/flow.f4ef62c3052d12a8.webp similarity index 100% rename from translated_images/pt/flow.f4ef62c3052d12a8.webp rename to translated_images/pt-PT/flow.f4ef62c3052d12a8.webp diff --git a/translated_images/pt/image-1.b36122aba30b20ad.webp b/translated_images/pt-PT/image-1.b36122aba30b20ad.webp similarity index 100% rename from translated_images/pt/image-1.b36122aba30b20ad.webp rename to translated_images/pt-PT/image-1.b36122aba30b20ad.webp diff --git a/translated_images/pt/image-2.fc0da29a6e4d2aff.webp b/translated_images/pt-PT/image-2.fc0da29a6e4d2aff.webp similarity index 100% rename from translated_images/pt/image-2.fc0da29a6e4d2aff.webp rename to translated_images/pt-PT/image-2.fc0da29a6e4d2aff.webp diff --git a/translated_images/pt/image-3.bf93d533bbc84268.webp b/translated_images/pt-PT/image-3.bf93d533bbc84268.webp similarity index 100% rename from translated_images/pt/image-3.bf93d533bbc84268.webp rename to translated_images/pt-PT/image-3.bf93d533bbc84268.webp diff --git a/translated_images/pt/image.73c7e2ff4a652e77.webp b/translated_images/pt-PT/image.73c7e2ff4a652e77.webp similarity index 100% rename from translated_images/pt/image.73c7e2ff4a652e77.webp rename to translated_images/pt-PT/image.73c7e2ff4a652e77.webp diff --git a/translated_images/pt/image.833552b62eee7766.webp b/translated_images/pt-PT/image.833552b62eee7766.webp similarity index 100% rename from translated_images/pt/image.833552b62eee7766.webp rename to translated_images/pt-PT/image.833552b62eee7766.webp diff --git a/translated_images/pt/llms.225ca2b8a0d34473.webp b/translated_images/pt-PT/llms.225ca2b8a0d34473.webp similarity index 100% rename from translated_images/pt/llms.225ca2b8a0d34473.webp rename to translated_images/pt-PT/llms.225ca2b8a0d34473.webp diff --git a/translated_images/pt/mcp.3fcf1d13c662ef9a.webp b/translated_images/pt-PT/mcp.3fcf1d13c662ef9a.webp similarity index 100% rename from translated_images/pt/mcp.3fcf1d13c662ef9a.webp rename to translated_images/pt-PT/mcp.3fcf1d13c662ef9a.webp diff --git a/translated_images/pt-PT/models.cb07f8af0d724e4d.webp b/translated_images/pt-PT/models.cb07f8af0d724e4d.webp new file mode 100644 index 00000000..e30879e9 Binary files /dev/null and b/translated_images/pt-PT/models.cb07f8af0d724e4d.webp differ diff --git a/translated_images/pt/responsible.e4f51a917bafa4bf.webp b/translated_images/pt-PT/responsible.e4f51a917bafa4bf.webp similarity index 100% rename from translated_images/pt/responsible.e4f51a917bafa4bf.webp rename to translated_images/pt-PT/responsible.e4f51a917bafa4bf.webp diff --git a/translated_images/pt-PT/tokens.6283ed277a2ffff4.webp b/translated_images/pt-PT/tokens.6283ed277a2ffff4.webp new file mode 100644 index 00000000..8e8e6bce Binary files /dev/null and b/translated_images/pt-PT/tokens.6283ed277a2ffff4.webp differ diff --git a/translated_images/pt/tool.189edfdb50db566d.webp b/translated_images/pt-PT/tool.189edfdb50db566d.webp similarity index 100% rename from translated_images/pt/tool.189edfdb50db566d.webp rename to translated_images/pt-PT/tool.189edfdb50db566d.webp diff --git a/translated_images/pt/vector.f12f114934e223df.webp b/translated_images/pt-PT/vector.f12f114934e223df.webp similarity index 100% rename from translated_images/pt/vector.f12f114934e223df.webp rename to translated_images/pt-PT/vector.f12f114934e223df.webp diff --git a/translated_images/ro/.co-op-translator.json b/translated_images/ro/.co-op-translator.json index 9253ba4d..40088ab9 100644 --- a/translated_images/ro/.co-op-translator.json +++ b/translated_images/ro/.co-op-translator.json @@ -77,12 +77,24 @@ "source_file": "01-IntroToGenAI/images/mcp.png", "language_code": "ro" }, + "models.cb07f8af0d724e4d.webp": { + "original_hash": "a1d68725372d3c033c59d1719b859d60", + "translation_date": "2026-01-29T16:12:48+00:00", + "source_file": "02-SetupDevEnvironment/images/models.webp", + "language_code": "ro" + }, "responsible.e4f51a917bafa4bf.webp": { "original_hash": "fa8d1e23eabb52aff991b3257f039a93", "translation_date": "2026-01-16T07:29:23+00:00", "source_file": "05-ResponsibleGenAI/images/responsible.png", "language_code": "ro" }, + "tokens.6283ed277a2ffff4.webp": { + "original_hash": "11572cc20ac9478d3d009a4b7e6aad2d", + "translation_date": "2026-01-29T16:12:24+00:00", + "source_file": "01-IntroToGenAI/images/tokens.webp", + "language_code": "ro" + }, "tool.189edfdb50db566d.webp": { "original_hash": "ed2556303c831d1c9277652dc12014a1", "translation_date": "2026-01-16T07:28:10+00:00", diff --git a/translated_images/ro/models.cb07f8af0d724e4d.webp b/translated_images/ro/models.cb07f8af0d724e4d.webp new file mode 100644 index 00000000..e30879e9 Binary files /dev/null and b/translated_images/ro/models.cb07f8af0d724e4d.webp differ diff --git a/translated_images/ro/tokens.6283ed277a2ffff4.webp b/translated_images/ro/tokens.6283ed277a2ffff4.webp new file mode 100644 index 00000000..8e8e6bce Binary files /dev/null and b/translated_images/ro/tokens.6283ed277a2ffff4.webp differ diff --git a/translated_images/ru/.co-op-translator.json b/translated_images/ru/.co-op-translator.json index ce570786..09b7cf8c 100644 --- a/translated_images/ru/.co-op-translator.json +++ b/translated_images/ru/.co-op-translator.json @@ -77,12 +77,24 @@ "source_file": "01-IntroToGenAI/images/mcp.png", "language_code": "ru" }, + "models.cb07f8af0d724e4d.webp": { + "original_hash": "a1d68725372d3c033c59d1719b859d60", + "translation_date": "2026-01-29T15:19:50+00:00", + "source_file": "02-SetupDevEnvironment/images/models.webp", + "language_code": "ru" + }, "responsible.e4f51a917bafa4bf.webp": { "original_hash": "fa8d1e23eabb52aff991b3257f039a93", "translation_date": "2026-01-16T06:33:43+00:00", "source_file": "05-ResponsibleGenAI/images/responsible.png", "language_code": "ru" }, + "tokens.6283ed277a2ffff4.webp": { + "original_hash": "11572cc20ac9478d3d009a4b7e6aad2d", + "translation_date": "2026-01-29T15:19:33+00:00", + "source_file": "01-IntroToGenAI/images/tokens.webp", + "language_code": "ru" + }, "tool.189edfdb50db566d.webp": { "original_hash": "ed2556303c831d1c9277652dc12014a1", "translation_date": "2026-01-16T06:32:35+00:00", diff --git a/translated_images/ru/models.cb07f8af0d724e4d.webp b/translated_images/ru/models.cb07f8af0d724e4d.webp new file mode 100644 index 00000000..e30879e9 Binary files /dev/null and b/translated_images/ru/models.cb07f8af0d724e4d.webp differ diff --git a/translated_images/ru/tokens.6283ed277a2ffff4.webp b/translated_images/ru/tokens.6283ed277a2ffff4.webp new file mode 100644 index 00000000..8e8e6bce Binary files /dev/null and b/translated_images/ru/tokens.6283ed277a2ffff4.webp differ diff --git a/translated_images/sk/.co-op-translator.json b/translated_images/sk/.co-op-translator.json index 857b35af..c9c9d66f 100644 --- a/translated_images/sk/.co-op-translator.json +++ b/translated_images/sk/.co-op-translator.json @@ -77,12 +77,24 @@ "source_file": "01-IntroToGenAI/images/mcp.png", "language_code": "sk" }, + "models.cb07f8af0d724e4d.webp": { + "original_hash": "a1d68725372d3c033c59d1719b859d60", + "translation_date": "2026-01-29T16:12:36+00:00", + "source_file": "02-SetupDevEnvironment/images/models.webp", + "language_code": "sk" + }, "responsible.e4f51a917bafa4bf.webp": { "original_hash": "fa8d1e23eabb52aff991b3257f039a93", "translation_date": "2026-01-16T07:29:17+00:00", "source_file": "05-ResponsibleGenAI/images/responsible.png", "language_code": "sk" }, + "tokens.6283ed277a2ffff4.webp": { + "original_hash": "11572cc20ac9478d3d009a4b7e6aad2d", + "translation_date": "2026-01-29T16:12:22+00:00", + "source_file": "01-IntroToGenAI/images/tokens.webp", + "language_code": "sk" + }, "tool.189edfdb50db566d.webp": { "original_hash": "ed2556303c831d1c9277652dc12014a1", "translation_date": "2026-01-16T07:28:04+00:00", diff --git a/translated_images/sk/models.cb07f8af0d724e4d.webp b/translated_images/sk/models.cb07f8af0d724e4d.webp new file mode 100644 index 00000000..e30879e9 Binary files /dev/null and b/translated_images/sk/models.cb07f8af0d724e4d.webp differ diff --git a/translated_images/sk/tokens.6283ed277a2ffff4.webp b/translated_images/sk/tokens.6283ed277a2ffff4.webp new file mode 100644 index 00000000..8e8e6bce Binary files /dev/null and b/translated_images/sk/tokens.6283ed277a2ffff4.webp differ diff --git a/translated_images/sl/.co-op-translator.json b/translated_images/sl/.co-op-translator.json index 7c80ed92..41ad0abc 100644 --- a/translated_images/sl/.co-op-translator.json +++ b/translated_images/sl/.co-op-translator.json @@ -77,12 +77,24 @@ "source_file": "01-IntroToGenAI/images/mcp.png", "language_code": "sl" }, + "models.cb07f8af0d724e4d.webp": { + "original_hash": "a1d68725372d3c033c59d1719b859d60", + "translation_date": "2026-01-29T16:17:58+00:00", + "source_file": "02-SetupDevEnvironment/images/models.webp", + "language_code": "sl" + }, "responsible.e4f51a917bafa4bf.webp": { "original_hash": "fa8d1e23eabb52aff991b3257f039a93", "translation_date": "2026-01-16T07:34:22+00:00", "source_file": "05-ResponsibleGenAI/images/responsible.png", "language_code": "sl" }, + "tokens.6283ed277a2ffff4.webp": { + "original_hash": "11572cc20ac9478d3d009a4b7e6aad2d", + "translation_date": "2026-01-29T16:17:24+00:00", + "source_file": "01-IntroToGenAI/images/tokens.webp", + "language_code": "sl" + }, "tool.189edfdb50db566d.webp": { "original_hash": "ed2556303c831d1c9277652dc12014a1", "translation_date": "2026-01-16T07:32:59+00:00", diff --git a/translated_images/sl/models.cb07f8af0d724e4d.webp b/translated_images/sl/models.cb07f8af0d724e4d.webp new file mode 100644 index 00000000..e30879e9 Binary files /dev/null and b/translated_images/sl/models.cb07f8af0d724e4d.webp differ diff --git a/translated_images/sl/tokens.6283ed277a2ffff4.webp b/translated_images/sl/tokens.6283ed277a2ffff4.webp new file mode 100644 index 00000000..8e8e6bce Binary files /dev/null and b/translated_images/sl/tokens.6283ed277a2ffff4.webp differ diff --git a/translated_images/sr/.co-op-translator.json b/translated_images/sr/.co-op-translator.json index 0ed68c89..f1912ccf 100644 --- a/translated_images/sr/.co-op-translator.json +++ b/translated_images/sr/.co-op-translator.json @@ -77,12 +77,24 @@ "source_file": "01-IntroToGenAI/images/mcp.png", "language_code": "sr" }, + "models.cb07f8af0d724e4d.webp": { + "original_hash": "a1d68725372d3c033c59d1719b859d60", + "translation_date": "2026-01-29T16:17:36+00:00", + "source_file": "02-SetupDevEnvironment/images/models.webp", + "language_code": "sr" + }, "responsible.e4f51a917bafa4bf.webp": { "original_hash": "fa8d1e23eabb52aff991b3257f039a93", "translation_date": "2026-01-16T07:34:10+00:00", "source_file": "05-ResponsibleGenAI/images/responsible.png", "language_code": "sr" }, + "tokens.6283ed277a2ffff4.webp": { + "original_hash": "11572cc20ac9478d3d009a4b7e6aad2d", + "translation_date": "2026-01-29T16:17:22+00:00", + "source_file": "01-IntroToGenAI/images/tokens.webp", + "language_code": "sr" + }, "tool.189edfdb50db566d.webp": { "original_hash": "ed2556303c831d1c9277652dc12014a1", "translation_date": "2026-01-16T07:32:45+00:00", diff --git a/translated_images/sr/models.cb07f8af0d724e4d.webp b/translated_images/sr/models.cb07f8af0d724e4d.webp new file mode 100644 index 00000000..e30879e9 Binary files /dev/null and b/translated_images/sr/models.cb07f8af0d724e4d.webp differ diff --git a/translated_images/sr/tokens.6283ed277a2ffff4.webp b/translated_images/sr/tokens.6283ed277a2ffff4.webp new file mode 100644 index 00000000..8e8e6bce Binary files /dev/null and b/translated_images/sr/tokens.6283ed277a2ffff4.webp differ diff --git a/translated_images/sv/.co-op-translator.json b/translated_images/sv/.co-op-translator.json index 86454c5a..26d789f4 100644 --- a/translated_images/sv/.co-op-translator.json +++ b/translated_images/sv/.co-op-translator.json @@ -77,12 +77,24 @@ "source_file": "01-IntroToGenAI/images/mcp.png", "language_code": "sv" }, + "models.cb07f8af0d724e4d.webp": { + "original_hash": "a1d68725372d3c033c59d1719b859d60", + "translation_date": "2026-01-29T15:50:41+00:00", + "source_file": "02-SetupDevEnvironment/images/models.webp", + "language_code": "sv" + }, "responsible.e4f51a917bafa4bf.webp": { "original_hash": "fa8d1e23eabb52aff991b3257f039a93", "translation_date": "2026-01-16T07:06:29+00:00", "source_file": "05-ResponsibleGenAI/images/responsible.png", "language_code": "sv" }, + "tokens.6283ed277a2ffff4.webp": { + "original_hash": "11572cc20ac9478d3d009a4b7e6aad2d", + "translation_date": "2026-01-29T15:50:06+00:00", + "source_file": "01-IntroToGenAI/images/tokens.webp", + "language_code": "sv" + }, "tool.189edfdb50db566d.webp": { "original_hash": "ed2556303c831d1c9277652dc12014a1", "translation_date": "2026-01-16T07:05:16+00:00", diff --git a/translated_images/sv/models.cb07f8af0d724e4d.webp b/translated_images/sv/models.cb07f8af0d724e4d.webp new file mode 100644 index 00000000..e30879e9 Binary files /dev/null and b/translated_images/sv/models.cb07f8af0d724e4d.webp differ diff --git a/translated_images/sv/tokens.6283ed277a2ffff4.webp b/translated_images/sv/tokens.6283ed277a2ffff4.webp new file mode 100644 index 00000000..8e8e6bce Binary files /dev/null and b/translated_images/sv/tokens.6283ed277a2ffff4.webp differ diff --git a/translated_images/sw/.co-op-translator.json b/translated_images/sw/.co-op-translator.json index d3d13ba2..b9fe57db 100644 --- a/translated_images/sw/.co-op-translator.json +++ b/translated_images/sw/.co-op-translator.json @@ -77,12 +77,24 @@ "source_file": "01-IntroToGenAI/images/mcp.png", "language_code": "sw" }, + "models.cb07f8af0d724e4d.webp": { + "original_hash": "a1d68725372d3c033c59d1719b859d60", + "translation_date": "2026-01-29T16:07:39+00:00", + "source_file": "02-SetupDevEnvironment/images/models.webp", + "language_code": "sw" + }, "responsible.e4f51a917bafa4bf.webp": { "original_hash": "fa8d1e23eabb52aff991b3257f039a93", "translation_date": "2026-01-16T07:24:42+00:00", "source_file": "05-ResponsibleGenAI/images/responsible.png", "language_code": "sw" }, + "tokens.6283ed277a2ffff4.webp": { + "original_hash": "11572cc20ac9478d3d009a4b7e6aad2d", + "translation_date": "2026-01-29T16:07:27+00:00", + "source_file": "01-IntroToGenAI/images/tokens.webp", + "language_code": "sw" + }, "tool.189edfdb50db566d.webp": { "original_hash": "ed2556303c831d1c9277652dc12014a1", "translation_date": "2026-01-16T07:23:09+00:00", diff --git a/translated_images/sw/models.cb07f8af0d724e4d.webp b/translated_images/sw/models.cb07f8af0d724e4d.webp new file mode 100644 index 00000000..e30879e9 Binary files /dev/null and b/translated_images/sw/models.cb07f8af0d724e4d.webp differ diff --git a/translated_images/sw/tokens.6283ed277a2ffff4.webp b/translated_images/sw/tokens.6283ed277a2ffff4.webp new file mode 100644 index 00000000..8e8e6bce Binary files /dev/null and b/translated_images/sw/tokens.6283ed277a2ffff4.webp differ diff --git a/translated_images/ta/.co-op-translator.json b/translated_images/ta/.co-op-translator.json index a9a431c6..c895d70d 100644 --- a/translated_images/ta/.co-op-translator.json +++ b/translated_images/ta/.co-op-translator.json @@ -77,12 +77,24 @@ "source_file": "01-IntroToGenAI/images/mcp.png", "language_code": "ta" }, + "models.cb07f8af0d724e4d.webp": { + "original_hash": "a1d68725372d3c033c59d1719b859d60", + "translation_date": "2026-01-29T16:27:05+00:00", + "source_file": "02-SetupDevEnvironment/images/models.webp", + "language_code": "ta" + }, "responsible.e4f51a917bafa4bf.webp": { "original_hash": "fa8d1e23eabb52aff991b3257f039a93", "translation_date": "2026-01-16T07:43:40+00:00", "source_file": "05-ResponsibleGenAI/images/responsible.png", "language_code": "ta" }, + "tokens.6283ed277a2ffff4.webp": { + "original_hash": "11572cc20ac9478d3d009a4b7e6aad2d", + "translation_date": "2026-01-29T16:26:52+00:00", + "source_file": "01-IntroToGenAI/images/tokens.webp", + "language_code": "ta" + }, "tool.189edfdb50db566d.webp": { "original_hash": "ed2556303c831d1c9277652dc12014a1", "translation_date": "2026-01-16T07:42:26+00:00", diff --git a/translated_images/ta/models.cb07f8af0d724e4d.webp b/translated_images/ta/models.cb07f8af0d724e4d.webp new file mode 100644 index 00000000..e30879e9 Binary files /dev/null and b/translated_images/ta/models.cb07f8af0d724e4d.webp differ diff --git a/translated_images/ta/tokens.6283ed277a2ffff4.webp b/translated_images/ta/tokens.6283ed277a2ffff4.webp new file mode 100644 index 00000000..8e8e6bce Binary files /dev/null and b/translated_images/ta/tokens.6283ed277a2ffff4.webp differ diff --git a/translated_images/te/.co-op-translator.json b/translated_images/te/.co-op-translator.json index 44be79c6..1b8eb7a3 100644 --- a/translated_images/te/.co-op-translator.json +++ b/translated_images/te/.co-op-translator.json @@ -77,12 +77,24 @@ "source_file": "01-IntroToGenAI/images/mcp.png", "language_code": "te" }, + "models.cb07f8af0d724e4d.webp": { + "original_hash": "a1d68725372d3c033c59d1719b859d60", + "translation_date": "2026-01-29T16:32:09+00:00", + "source_file": "02-SetupDevEnvironment/images/models.webp", + "language_code": "te" + }, "responsible.e4f51a917bafa4bf.webp": { "original_hash": "fa8d1e23eabb52aff991b3257f039a93", "translation_date": "2026-01-16T07:48:16+00:00", "source_file": "05-ResponsibleGenAI/images/responsible.png", "language_code": "te" }, + "tokens.6283ed277a2ffff4.webp": { + "original_hash": "11572cc20ac9478d3d009a4b7e6aad2d", + "translation_date": "2026-01-29T16:31:55+00:00", + "source_file": "01-IntroToGenAI/images/tokens.webp", + "language_code": "te" + }, "tool.189edfdb50db566d.webp": { "original_hash": "ed2556303c831d1c9277652dc12014a1", "translation_date": "2026-01-16T07:46:52+00:00", diff --git a/translated_images/te/models.cb07f8af0d724e4d.webp b/translated_images/te/models.cb07f8af0d724e4d.webp new file mode 100644 index 00000000..e30879e9 Binary files /dev/null and b/translated_images/te/models.cb07f8af0d724e4d.webp differ diff --git a/translated_images/te/tokens.6283ed277a2ffff4.webp b/translated_images/te/tokens.6283ed277a2ffff4.webp new file mode 100644 index 00000000..8e8e6bce Binary files /dev/null and b/translated_images/te/tokens.6283ed277a2ffff4.webp differ diff --git a/translated_images/th/.co-op-translator.json b/translated_images/th/.co-op-translator.json index f67f1413..43b47089 100644 --- a/translated_images/th/.co-op-translator.json +++ b/translated_images/th/.co-op-translator.json @@ -77,12 +77,24 @@ "source_file": "01-IntroToGenAI/images/mcp.png", "language_code": "th" }, + "models.cb07f8af0d724e4d.webp": { + "original_hash": "a1d68725372d3c033c59d1719b859d60", + "translation_date": "2026-01-29T15:50:32+00:00", + "source_file": "02-SetupDevEnvironment/images/models.webp", + "language_code": "th" + }, "responsible.e4f51a917bafa4bf.webp": { "original_hash": "fa8d1e23eabb52aff991b3257f039a93", "translation_date": "2026-01-16T07:06:24+00:00", "source_file": "05-ResponsibleGenAI/images/responsible.png", "language_code": "th" }, + "tokens.6283ed277a2ffff4.webp": { + "original_hash": "11572cc20ac9478d3d009a4b7e6aad2d", + "translation_date": "2026-01-29T15:50:05+00:00", + "source_file": "01-IntroToGenAI/images/tokens.webp", + "language_code": "th" + }, "tool.189edfdb50db566d.webp": { "original_hash": "ed2556303c831d1c9277652dc12014a1", "translation_date": "2026-01-16T07:05:09+00:00", diff --git a/translated_images/th/models.cb07f8af0d724e4d.webp b/translated_images/th/models.cb07f8af0d724e4d.webp new file mode 100644 index 00000000..e30879e9 Binary files /dev/null and b/translated_images/th/models.cb07f8af0d724e4d.webp differ diff --git a/translated_images/th/tokens.6283ed277a2ffff4.webp b/translated_images/th/tokens.6283ed277a2ffff4.webp new file mode 100644 index 00000000..8e8e6bce Binary files /dev/null and b/translated_images/th/tokens.6283ed277a2ffff4.webp differ diff --git a/translated_images/tl/.co-op-translator.json b/translated_images/tl/.co-op-translator.json index cdb4707d..045b63d3 100644 --- a/translated_images/tl/.co-op-translator.json +++ b/translated_images/tl/.co-op-translator.json @@ -77,12 +77,24 @@ "source_file": "01-IntroToGenAI/images/mcp.png", "language_code": "tl" }, + "models.cb07f8af0d724e4d.webp": { + "original_hash": "a1d68725372d3c033c59d1719b859d60", + "translation_date": "2026-01-29T16:03:25+00:00", + "source_file": "02-SetupDevEnvironment/images/models.webp", + "language_code": "tl" + }, "responsible.e4f51a917bafa4bf.webp": { "original_hash": "fa8d1e23eabb52aff991b3257f039a93", "translation_date": "2026-01-16T07:20:02+00:00", "source_file": "05-ResponsibleGenAI/images/responsible.png", "language_code": "tl" }, + "tokens.6283ed277a2ffff4.webp": { + "original_hash": "11572cc20ac9478d3d009a4b7e6aad2d", + "translation_date": "2026-01-29T16:02:58+00:00", + "source_file": "01-IntroToGenAI/images/tokens.webp", + "language_code": "tl" + }, "tool.189edfdb50db566d.webp": { "original_hash": "ed2556303c831d1c9277652dc12014a1", "translation_date": "2026-01-16T07:18:52+00:00", diff --git a/translated_images/tl/models.cb07f8af0d724e4d.webp b/translated_images/tl/models.cb07f8af0d724e4d.webp new file mode 100644 index 00000000..e30879e9 Binary files /dev/null and b/translated_images/tl/models.cb07f8af0d724e4d.webp differ diff --git a/translated_images/tl/tokens.6283ed277a2ffff4.webp b/translated_images/tl/tokens.6283ed277a2ffff4.webp new file mode 100644 index 00000000..8e8e6bce Binary files /dev/null and b/translated_images/tl/tokens.6283ed277a2ffff4.webp differ diff --git a/translated_images/tr/.co-op-translator.json b/translated_images/tr/.co-op-translator.json index 23ff830c..28d94b26 100644 --- a/translated_images/tr/.co-op-translator.json +++ b/translated_images/tr/.co-op-translator.json @@ -77,12 +77,24 @@ "source_file": "01-IntroToGenAI/images/mcp.png", "language_code": "tr" }, + "models.cb07f8af0d724e4d.webp": { + "original_hash": "a1d68725372d3c033c59d1719b859d60", + "translation_date": "2026-01-29T15:46:14+00:00", + "source_file": "02-SetupDevEnvironment/images/models.webp", + "language_code": "tr" + }, "responsible.e4f51a917bafa4bf.webp": { "original_hash": "fa8d1e23eabb52aff991b3257f039a93", "translation_date": "2026-01-16T07:01:52+00:00", "source_file": "05-ResponsibleGenAI/images/responsible.png", "language_code": "tr" }, + "tokens.6283ed277a2ffff4.webp": { + "original_hash": "11572cc20ac9478d3d009a4b7e6aad2d", + "translation_date": "2026-01-29T15:45:47+00:00", + "source_file": "01-IntroToGenAI/images/tokens.webp", + "language_code": "tr" + }, "tool.189edfdb50db566d.webp": { "original_hash": "ed2556303c831d1c9277652dc12014a1", "translation_date": "2026-01-16T07:00:36+00:00", diff --git a/translated_images/tr/models.cb07f8af0d724e4d.webp b/translated_images/tr/models.cb07f8af0d724e4d.webp new file mode 100644 index 00000000..e30879e9 Binary files /dev/null and b/translated_images/tr/models.cb07f8af0d724e4d.webp differ diff --git a/translated_images/tr/tokens.6283ed277a2ffff4.webp b/translated_images/tr/tokens.6283ed277a2ffff4.webp new file mode 100644 index 00000000..8e8e6bce Binary files /dev/null and b/translated_images/tr/tokens.6283ed277a2ffff4.webp differ diff --git a/translated_images/uk/.co-op-translator.json b/translated_images/uk/.co-op-translator.json index 1e3a76c2..fbda3cad 100644 --- a/translated_images/uk/.co-op-translator.json +++ b/translated_images/uk/.co-op-translator.json @@ -77,12 +77,24 @@ "source_file": "01-IntroToGenAI/images/mcp.png", "language_code": "uk" }, + "models.cb07f8af0d724e4d.webp": { + "original_hash": "a1d68725372d3c033c59d1719b859d60", + "translation_date": "2026-01-29T16:22:47+00:00", + "source_file": "02-SetupDevEnvironment/images/models.webp", + "language_code": "uk" + }, "responsible.e4f51a917bafa4bf.webp": { "original_hash": "fa8d1e23eabb52aff991b3257f039a93", "translation_date": "2026-01-16T07:39:01+00:00", "source_file": "05-ResponsibleGenAI/images/responsible.png", "language_code": "uk" }, + "tokens.6283ed277a2ffff4.webp": { + "original_hash": "11572cc20ac9478d3d009a4b7e6aad2d", + "translation_date": "2026-01-29T16:22:12+00:00", + "source_file": "01-IntroToGenAI/images/tokens.webp", + "language_code": "uk" + }, "tool.189edfdb50db566d.webp": { "original_hash": "ed2556303c831d1c9277652dc12014a1", "translation_date": "2026-01-16T07:37:41+00:00", diff --git a/translated_images/uk/models.cb07f8af0d724e4d.webp b/translated_images/uk/models.cb07f8af0d724e4d.webp new file mode 100644 index 00000000..e30879e9 Binary files /dev/null and b/translated_images/uk/models.cb07f8af0d724e4d.webp differ diff --git a/translated_images/uk/tokens.6283ed277a2ffff4.webp b/translated_images/uk/tokens.6283ed277a2ffff4.webp new file mode 100644 index 00000000..8e8e6bce Binary files /dev/null and b/translated_images/uk/tokens.6283ed277a2ffff4.webp differ diff --git a/translated_images/ur/.co-op-translator.json b/translated_images/ur/.co-op-translator.json index ffb910ef..0c3d1fce 100644 --- a/translated_images/ur/.co-op-translator.json +++ b/translated_images/ur/.co-op-translator.json @@ -77,12 +77,24 @@ "source_file": "01-IntroToGenAI/images/mcp.png", "language_code": "ur" }, + "models.cb07f8af0d724e4d.webp": { + "original_hash": "a1d68725372d3c033c59d1719b859d60", + "translation_date": "2026-01-29T15:24:08+00:00", + "source_file": "02-SetupDevEnvironment/images/models.webp", + "language_code": "ur" + }, "responsible.e4f51a917bafa4bf.webp": { "original_hash": "fa8d1e23eabb52aff991b3257f039a93", "translation_date": "2026-01-16T06:38:21+00:00", "source_file": "05-ResponsibleGenAI/images/responsible.png", "language_code": "ur" }, + "tokens.6283ed277a2ffff4.webp": { + "original_hash": "11572cc20ac9478d3d009a4b7e6aad2d", + "translation_date": "2026-01-29T15:23:47+00:00", + "source_file": "01-IntroToGenAI/images/tokens.webp", + "language_code": "ur" + }, "tool.189edfdb50db566d.webp": { "original_hash": "ed2556303c831d1c9277652dc12014a1", "translation_date": "2026-01-16T06:37:11+00:00", diff --git a/translated_images/ur/models.cb07f8af0d724e4d.webp b/translated_images/ur/models.cb07f8af0d724e4d.webp new file mode 100644 index 00000000..e30879e9 Binary files /dev/null and b/translated_images/ur/models.cb07f8af0d724e4d.webp differ diff --git a/translated_images/ur/tokens.6283ed277a2ffff4.webp b/translated_images/ur/tokens.6283ed277a2ffff4.webp new file mode 100644 index 00000000..8e8e6bce Binary files /dev/null and b/translated_images/ur/tokens.6283ed277a2ffff4.webp differ diff --git a/translated_images/vi/.co-op-translator.json b/translated_images/vi/.co-op-translator.json index 02bf1639..644a8694 100644 --- a/translated_images/vi/.co-op-translator.json +++ b/translated_images/vi/.co-op-translator.json @@ -77,12 +77,24 @@ "source_file": "01-IntroToGenAI/images/mcp.png", "language_code": "vi" }, + "models.cb07f8af0d724e4d.webp": { + "original_hash": "a1d68725372d3c033c59d1719b859d60", + "translation_date": "2026-01-29T15:59:00+00:00", + "source_file": "02-SetupDevEnvironment/images/models.webp", + "language_code": "vi" + }, "responsible.e4f51a917bafa4bf.webp": { "original_hash": "fa8d1e23eabb52aff991b3257f039a93", "translation_date": "2026-01-16T07:15:25+00:00", "source_file": "05-ResponsibleGenAI/images/responsible.png", "language_code": "vi" }, + "tokens.6283ed277a2ffff4.webp": { + "original_hash": "11572cc20ac9478d3d009a4b7e6aad2d", + "translation_date": "2026-01-29T15:58:34+00:00", + "source_file": "01-IntroToGenAI/images/tokens.webp", + "language_code": "vi" + }, "tool.189edfdb50db566d.webp": { "original_hash": "ed2556303c831d1c9277652dc12014a1", "translation_date": "2026-01-16T07:14:17+00:00", diff --git a/translated_images/vi/models.cb07f8af0d724e4d.webp b/translated_images/vi/models.cb07f8af0d724e4d.webp new file mode 100644 index 00000000..e30879e9 Binary files /dev/null and b/translated_images/vi/models.cb07f8af0d724e4d.webp differ diff --git a/translated_images/vi/tokens.6283ed277a2ffff4.webp b/translated_images/vi/tokens.6283ed277a2ffff4.webp new file mode 100644 index 00000000..8e8e6bce Binary files /dev/null and b/translated_images/vi/tokens.6283ed277a2ffff4.webp differ diff --git a/translated_images/zh/.co-op-translator.json b/translated_images/zh-CN/.co-op-translator.json similarity index 78% rename from translated_images/zh/.co-op-translator.json rename to translated_images/zh-CN/.co-op-translator.json index e4971b40..fedb4b85 100644 --- a/translated_images/zh/.co-op-translator.json +++ b/translated_images/zh-CN/.co-op-translator.json @@ -3,96 +3,108 @@ "original_hash": "a967aa7c967f7eef94f31926c4c8067c", "translation_date": "2026-01-16T06:36:58+00:00", "source_file": "images/beg-genai-series.png", - "language_code": "zh" + "language_code": "zh-CN" }, "codespaces-create.b44a36f728660ab7.webp": { "original_hash": "7eab55896561d1bc55c6a162156d0017", "translation_date": "2026-01-16T06:39:15+00:00", "source_file": "02-SetupDevEnvironment/images/codespaces-create.png", - "language_code": "zh" + "language_code": "zh-CN" }, "codespaces.9945ded8ceb431a5.webp": { "original_hash": "48d3567c3959e06e4ce108c43a1bb655", "translation_date": "2026-01-16T06:38:40+00:00", "source_file": "02-SetupDevEnvironment/images/codespaces.png", - "language_code": "zh" + "language_code": "zh-CN" }, "devcontainer.21126c9d6de64494.webp": { "original_hash": "5a080e0e2e92ea495d1fd4fb0c3dca16", "translation_date": "2026-01-16T06:38:45+00:00", "source_file": "02-SetupDevEnvironment/images/devcontainer.png", - "language_code": "zh" + "language_code": "zh-CN" }, "embedding.398e50802c0037f9.webp": { "original_hash": "3b42046dab31decbe80630673d9a4299", "translation_date": "2026-01-16T06:37:51+00:00", "source_file": "01-IntroToGenAI/images/embedding.png", - "language_code": "zh" + "language_code": "zh-CN" }, "flow.f4ef62c3052d12a8.webp": { "original_hash": "384dbf925c9bd33ed060d90696e1e5dc", "translation_date": "2026-01-16T06:37:40+00:00", "source_file": "01-IntroToGenAI/images/flow.png", - "language_code": "zh" + "language_code": "zh-CN" }, "image-1.b36122aba30b20ad.webp": { "original_hash": "beb64e9c23de84eff0eb1949f9e903cd", "translation_date": "2026-01-16T06:40:22+00:00", "source_file": "02-SetupDevEnvironment/images/image-1.png", - "language_code": "zh" + "language_code": "zh-CN" }, "image-2.fc0da29a6e4d2aff.webp": { "original_hash": "6e06c4be35f0713416497bbcbf5272f1", "translation_date": "2026-01-16T06:39:50+00:00", "source_file": "02-SetupDevEnvironment/images/image-2.png", - "language_code": "zh" + "language_code": "zh-CN" }, "image-3.bf93d533bbc84268.webp": { "original_hash": "682e3bce2f2c57bb12667e96da792191", "translation_date": "2026-01-16T06:39:05+00:00", "source_file": "02-SetupDevEnvironment/images/image-3.png", - "language_code": "zh" + "language_code": "zh-CN" }, "image.73c7e2ff4a652e77.webp": { "original_hash": "65b6d1abec8bfb715c24ebe0f8929028", "translation_date": "2026-01-16T06:38:29+00:00", "source_file": "05-ResponsibleGenAI/images/image.png", - "language_code": "zh" + "language_code": "zh-CN" }, "image.833552b62eee7766.webp": { "original_hash": "6ea0edb52249206f1b5cbea93bedb7fb", "translation_date": "2026-01-16T06:40:03+00:00", "source_file": "02-SetupDevEnvironment/images/image.png", - "language_code": "zh" + "language_code": "zh-CN" }, "llms.225ca2b8a0d34473.webp": { "original_hash": "3e69ea1754a889ad7f1a690103fe75b6", "translation_date": "2026-01-16T06:38:09+00:00", "source_file": "01-IntroToGenAI/images/llms.png", - "language_code": "zh" + "language_code": "zh-CN" }, "mcp.3fcf1d13c662ef9a.webp": { "original_hash": "93122a41e7b6451319598b97a160174b", "translation_date": "2026-01-16T06:37:45+00:00", "source_file": "01-IntroToGenAI/images/mcp.png", - "language_code": "zh" + "language_code": "zh-CN" + }, + "models.cb07f8af0d724e4d.webp": { + "original_hash": "a1d68725372d3c033c59d1719b859d60", + "translation_date": "2026-01-29T15:24:13+00:00", + "source_file": "02-SetupDevEnvironment/images/models.webp", + "language_code": "zh-CN" }, "responsible.e4f51a917bafa4bf.webp": { "original_hash": "fa8d1e23eabb52aff991b3257f039a93", "translation_date": "2026-01-16T06:38:25+00:00", "source_file": "05-ResponsibleGenAI/images/responsible.png", - "language_code": "zh" + "language_code": "zh-CN" + }, + "tokens.6283ed277a2ffff4.webp": { + "original_hash": "11572cc20ac9478d3d009a4b7e6aad2d", + "translation_date": "2026-01-29T15:23:48+00:00", + "source_file": "01-IntroToGenAI/images/tokens.webp", + "language_code": "zh-CN" }, "tool.189edfdb50db566d.webp": { "original_hash": "ed2556303c831d1c9277652dc12014a1", "translation_date": "2026-01-16T06:37:17+00:00", "source_file": "04-PracticalSamples/calculator/images/tool.png", - "language_code": "zh" + "language_code": "zh-CN" }, "vector.f12f114934e223df.webp": { "original_hash": "b3c0003a891ccc7f1dc4711beb194a02", "translation_date": "2026-01-16T06:38:00+00:00", "source_file": "01-IntroToGenAI/images/vector.png", - "language_code": "zh" + "language_code": "zh-CN" } } \ No newline at end of file diff --git a/translated_images/zh/beg-genai-series.8b48be9951cc574c.webp b/translated_images/zh-CN/beg-genai-series.8b48be9951cc574c.webp similarity index 100% rename from translated_images/zh/beg-genai-series.8b48be9951cc574c.webp rename to translated_images/zh-CN/beg-genai-series.8b48be9951cc574c.webp diff --git a/translated_images/zh/codespaces-create.b44a36f728660ab7.webp b/translated_images/zh-CN/codespaces-create.b44a36f728660ab7.webp similarity index 100% rename from translated_images/zh/codespaces-create.b44a36f728660ab7.webp rename to translated_images/zh-CN/codespaces-create.b44a36f728660ab7.webp diff --git a/translated_images/zh/codespaces.9945ded8ceb431a5.webp b/translated_images/zh-CN/codespaces.9945ded8ceb431a5.webp similarity index 100% rename from translated_images/zh/codespaces.9945ded8ceb431a5.webp rename to translated_images/zh-CN/codespaces.9945ded8ceb431a5.webp diff --git a/translated_images/zh/devcontainer.21126c9d6de64494.webp b/translated_images/zh-CN/devcontainer.21126c9d6de64494.webp similarity index 100% rename from translated_images/zh/devcontainer.21126c9d6de64494.webp rename to translated_images/zh-CN/devcontainer.21126c9d6de64494.webp diff --git a/translated_images/zh/embedding.398e50802c0037f9.webp b/translated_images/zh-CN/embedding.398e50802c0037f9.webp similarity index 100% rename from translated_images/zh/embedding.398e50802c0037f9.webp rename to translated_images/zh-CN/embedding.398e50802c0037f9.webp diff --git a/translated_images/zh/flow.f4ef62c3052d12a8.webp b/translated_images/zh-CN/flow.f4ef62c3052d12a8.webp similarity index 100% rename from translated_images/zh/flow.f4ef62c3052d12a8.webp rename to translated_images/zh-CN/flow.f4ef62c3052d12a8.webp diff --git a/translated_images/zh/image-1.b36122aba30b20ad.webp b/translated_images/zh-CN/image-1.b36122aba30b20ad.webp similarity index 100% rename from translated_images/zh/image-1.b36122aba30b20ad.webp rename to translated_images/zh-CN/image-1.b36122aba30b20ad.webp diff --git a/translated_images/zh/image-2.fc0da29a6e4d2aff.webp b/translated_images/zh-CN/image-2.fc0da29a6e4d2aff.webp similarity index 100% rename from translated_images/zh/image-2.fc0da29a6e4d2aff.webp rename to translated_images/zh-CN/image-2.fc0da29a6e4d2aff.webp diff --git a/translated_images/zh/image-3.bf93d533bbc84268.webp b/translated_images/zh-CN/image-3.bf93d533bbc84268.webp similarity index 100% rename from translated_images/zh/image-3.bf93d533bbc84268.webp rename to translated_images/zh-CN/image-3.bf93d533bbc84268.webp diff --git a/translated_images/zh/image.73c7e2ff4a652e77.webp b/translated_images/zh-CN/image.73c7e2ff4a652e77.webp similarity index 100% rename from translated_images/zh/image.73c7e2ff4a652e77.webp rename to translated_images/zh-CN/image.73c7e2ff4a652e77.webp diff --git a/translated_images/zh/image.833552b62eee7766.webp b/translated_images/zh-CN/image.833552b62eee7766.webp similarity index 100% rename from translated_images/zh/image.833552b62eee7766.webp rename to translated_images/zh-CN/image.833552b62eee7766.webp diff --git a/translated_images/zh/llms.225ca2b8a0d34473.webp b/translated_images/zh-CN/llms.225ca2b8a0d34473.webp similarity index 100% rename from translated_images/zh/llms.225ca2b8a0d34473.webp rename to translated_images/zh-CN/llms.225ca2b8a0d34473.webp diff --git a/translated_images/zh/mcp.3fcf1d13c662ef9a.webp b/translated_images/zh-CN/mcp.3fcf1d13c662ef9a.webp similarity index 100% rename from translated_images/zh/mcp.3fcf1d13c662ef9a.webp rename to translated_images/zh-CN/mcp.3fcf1d13c662ef9a.webp diff --git a/translated_images/zh-CN/models.cb07f8af0d724e4d.webp b/translated_images/zh-CN/models.cb07f8af0d724e4d.webp new file mode 100644 index 00000000..e30879e9 Binary files /dev/null and b/translated_images/zh-CN/models.cb07f8af0d724e4d.webp differ diff --git a/translated_images/zh/responsible.e4f51a917bafa4bf.webp b/translated_images/zh-CN/responsible.e4f51a917bafa4bf.webp similarity index 100% rename from translated_images/zh/responsible.e4f51a917bafa4bf.webp rename to translated_images/zh-CN/responsible.e4f51a917bafa4bf.webp diff --git a/translated_images/zh-CN/tokens.6283ed277a2ffff4.webp b/translated_images/zh-CN/tokens.6283ed277a2ffff4.webp new file mode 100644 index 00000000..8e8e6bce Binary files /dev/null and b/translated_images/zh-CN/tokens.6283ed277a2ffff4.webp differ diff --git a/translated_images/zh/tool.189edfdb50db566d.webp b/translated_images/zh-CN/tool.189edfdb50db566d.webp similarity index 100% rename from translated_images/zh/tool.189edfdb50db566d.webp rename to translated_images/zh-CN/tool.189edfdb50db566d.webp diff --git a/translated_images/zh/vector.f12f114934e223df.webp b/translated_images/zh-CN/vector.f12f114934e223df.webp similarity index 100% rename from translated_images/zh/vector.f12f114934e223df.webp rename to translated_images/zh-CN/vector.f12f114934e223df.webp diff --git a/translated_images/hk/.co-op-translator.json b/translated_images/zh-HK/.co-op-translator.json similarity index 78% rename from translated_images/hk/.co-op-translator.json rename to translated_images/zh-HK/.co-op-translator.json index 82d22f72..f4aec4dd 100644 --- a/translated_images/hk/.co-op-translator.json +++ b/translated_images/zh-HK/.co-op-translator.json @@ -3,96 +3,108 @@ "original_hash": "a967aa7c967f7eef94f31926c4c8067c", "translation_date": "2026-01-16T06:41:32+00:00", "source_file": "images/beg-genai-series.png", - "language_code": "hk" + "language_code": "zh-HK" }, "codespaces-create.b44a36f728660ab7.webp": { "original_hash": "7eab55896561d1bc55c6a162156d0017", "translation_date": "2026-01-16T06:43:46+00:00", "source_file": "02-SetupDevEnvironment/images/codespaces-create.png", - "language_code": "hk" + "language_code": "zh-HK" }, "codespaces.9945ded8ceb431a5.webp": { "original_hash": "48d3567c3959e06e4ce108c43a1bb655", "translation_date": "2026-01-16T06:43:16+00:00", "source_file": "02-SetupDevEnvironment/images/codespaces.png", - "language_code": "hk" + "language_code": "zh-HK" }, "devcontainer.21126c9d6de64494.webp": { "original_hash": "5a080e0e2e92ea495d1fd4fb0c3dca16", "translation_date": "2026-01-16T06:43:23+00:00", "source_file": "02-SetupDevEnvironment/images/devcontainer.png", - "language_code": "hk" + "language_code": "zh-HK" }, "embedding.398e50802c0037f9.webp": { "original_hash": "3b42046dab31decbe80630673d9a4299", "translation_date": "2026-01-16T06:42:25+00:00", "source_file": "01-IntroToGenAI/images/embedding.png", - "language_code": "hk" + "language_code": "zh-HK" }, "flow.f4ef62c3052d12a8.webp": { "original_hash": "384dbf925c9bd33ed060d90696e1e5dc", "translation_date": "2026-01-16T06:42:07+00:00", "source_file": "01-IntroToGenAI/images/flow.png", - "language_code": "hk" + "language_code": "zh-HK" }, "image-1.b36122aba30b20ad.webp": { "original_hash": "beb64e9c23de84eff0eb1949f9e903cd", "translation_date": "2026-01-16T06:44:43+00:00", "source_file": "02-SetupDevEnvironment/images/image-1.png", - "language_code": "hk" + "language_code": "zh-HK" }, "image-2.fc0da29a6e4d2aff.webp": { "original_hash": "6e06c4be35f0713416497bbcbf5272f1", "translation_date": "2026-01-16T06:44:08+00:00", "source_file": "02-SetupDevEnvironment/images/image-2.png", - "language_code": "hk" + "language_code": "zh-HK" }, "image-3.bf93d533bbc84268.webp": { "original_hash": "682e3bce2f2c57bb12667e96da792191", "translation_date": "2026-01-16T06:43:35+00:00", "source_file": "02-SetupDevEnvironment/images/image-3.png", - "language_code": "hk" + "language_code": "zh-HK" }, "image.73c7e2ff4a652e77.webp": { "original_hash": "65b6d1abec8bfb715c24ebe0f8929028", "translation_date": "2026-01-16T06:43:08+00:00", "source_file": "05-ResponsibleGenAI/images/image.png", - "language_code": "hk" + "language_code": "zh-HK" }, "image.833552b62eee7766.webp": { "original_hash": "6ea0edb52249206f1b5cbea93bedb7fb", "translation_date": "2026-01-16T06:44:27+00:00", "source_file": "02-SetupDevEnvironment/images/image.png", - "language_code": "hk" + "language_code": "zh-HK" }, "llms.225ca2b8a0d34473.webp": { "original_hash": "3e69ea1754a889ad7f1a690103fe75b6", "translation_date": "2026-01-16T06:42:45+00:00", "source_file": "01-IntroToGenAI/images/llms.png", - "language_code": "hk" + "language_code": "zh-HK" }, "mcp.3fcf1d13c662ef9a.webp": { "original_hash": "93122a41e7b6451319598b97a160174b", "translation_date": "2026-01-16T06:42:20+00:00", "source_file": "01-IntroToGenAI/images/mcp.png", - "language_code": "hk" + "language_code": "zh-HK" + }, + "models.cb07f8af0d724e4d.webp": { + "original_hash": "a1d68725372d3c033c59d1719b859d60", + "translation_date": "2026-01-29T15:28:19+00:00", + "source_file": "02-SetupDevEnvironment/images/models.webp", + "language_code": "zh-HK" }, "responsible.e4f51a917bafa4bf.webp": { "original_hash": "fa8d1e23eabb52aff991b3257f039a93", "translation_date": "2026-01-16T06:43:00+00:00", "source_file": "05-ResponsibleGenAI/images/responsible.png", - "language_code": "hk" + "language_code": "zh-HK" + }, + "tokens.6283ed277a2ffff4.webp": { + "original_hash": "11572cc20ac9478d3d009a4b7e6aad2d", + "translation_date": "2026-01-29T15:28:01+00:00", + "source_file": "01-IntroToGenAI/images/tokens.webp", + "language_code": "zh-HK" }, "tool.189edfdb50db566d.webp": { "original_hash": "ed2556303c831d1c9277652dc12014a1", "translation_date": "2026-01-16T06:41:46+00:00", "source_file": "04-PracticalSamples/calculator/images/tool.png", - "language_code": "hk" + "language_code": "zh-HK" }, "vector.f12f114934e223df.webp": { "original_hash": "b3c0003a891ccc7f1dc4711beb194a02", "translation_date": "2026-01-16T06:42:35+00:00", "source_file": "01-IntroToGenAI/images/vector.png", - "language_code": "hk" + "language_code": "zh-HK" } } \ No newline at end of file diff --git a/translated_images/hk/beg-genai-series.8b48be9951cc574c.webp b/translated_images/zh-HK/beg-genai-series.8b48be9951cc574c.webp similarity index 100% rename from translated_images/hk/beg-genai-series.8b48be9951cc574c.webp rename to translated_images/zh-HK/beg-genai-series.8b48be9951cc574c.webp diff --git a/translated_images/hk/codespaces-create.b44a36f728660ab7.webp b/translated_images/zh-HK/codespaces-create.b44a36f728660ab7.webp similarity index 100% rename from translated_images/hk/codespaces-create.b44a36f728660ab7.webp rename to translated_images/zh-HK/codespaces-create.b44a36f728660ab7.webp diff --git a/translated_images/hk/codespaces.9945ded8ceb431a5.webp b/translated_images/zh-HK/codespaces.9945ded8ceb431a5.webp similarity index 100% rename from translated_images/hk/codespaces.9945ded8ceb431a5.webp rename to translated_images/zh-HK/codespaces.9945ded8ceb431a5.webp diff --git a/translated_images/hk/devcontainer.21126c9d6de64494.webp b/translated_images/zh-HK/devcontainer.21126c9d6de64494.webp similarity index 100% rename from translated_images/hk/devcontainer.21126c9d6de64494.webp rename to translated_images/zh-HK/devcontainer.21126c9d6de64494.webp diff --git a/translated_images/hk/embedding.398e50802c0037f9.webp b/translated_images/zh-HK/embedding.398e50802c0037f9.webp similarity index 100% rename from translated_images/hk/embedding.398e50802c0037f9.webp rename to translated_images/zh-HK/embedding.398e50802c0037f9.webp diff --git a/translated_images/hk/flow.f4ef62c3052d12a8.webp b/translated_images/zh-HK/flow.f4ef62c3052d12a8.webp similarity index 100% rename from translated_images/hk/flow.f4ef62c3052d12a8.webp rename to translated_images/zh-HK/flow.f4ef62c3052d12a8.webp diff --git a/translated_images/hk/image-1.b36122aba30b20ad.webp b/translated_images/zh-HK/image-1.b36122aba30b20ad.webp similarity index 100% rename from translated_images/hk/image-1.b36122aba30b20ad.webp rename to translated_images/zh-HK/image-1.b36122aba30b20ad.webp diff --git a/translated_images/hk/image-2.fc0da29a6e4d2aff.webp b/translated_images/zh-HK/image-2.fc0da29a6e4d2aff.webp similarity index 100% rename from translated_images/hk/image-2.fc0da29a6e4d2aff.webp rename to translated_images/zh-HK/image-2.fc0da29a6e4d2aff.webp diff --git a/translated_images/hk/image-3.bf93d533bbc84268.webp b/translated_images/zh-HK/image-3.bf93d533bbc84268.webp similarity index 100% rename from translated_images/hk/image-3.bf93d533bbc84268.webp rename to translated_images/zh-HK/image-3.bf93d533bbc84268.webp diff --git a/translated_images/hk/image.73c7e2ff4a652e77.webp b/translated_images/zh-HK/image.73c7e2ff4a652e77.webp similarity index 100% rename from translated_images/hk/image.73c7e2ff4a652e77.webp rename to translated_images/zh-HK/image.73c7e2ff4a652e77.webp diff --git a/translated_images/hk/image.833552b62eee7766.webp b/translated_images/zh-HK/image.833552b62eee7766.webp similarity index 100% rename from translated_images/hk/image.833552b62eee7766.webp rename to translated_images/zh-HK/image.833552b62eee7766.webp diff --git a/translated_images/hk/llms.225ca2b8a0d34473.webp b/translated_images/zh-HK/llms.225ca2b8a0d34473.webp similarity index 100% rename from translated_images/hk/llms.225ca2b8a0d34473.webp rename to translated_images/zh-HK/llms.225ca2b8a0d34473.webp diff --git a/translated_images/hk/mcp.3fcf1d13c662ef9a.webp b/translated_images/zh-HK/mcp.3fcf1d13c662ef9a.webp similarity index 100% rename from translated_images/hk/mcp.3fcf1d13c662ef9a.webp rename to translated_images/zh-HK/mcp.3fcf1d13c662ef9a.webp diff --git a/translated_images/zh-HK/models.cb07f8af0d724e4d.webp b/translated_images/zh-HK/models.cb07f8af0d724e4d.webp new file mode 100644 index 00000000..e30879e9 Binary files /dev/null and b/translated_images/zh-HK/models.cb07f8af0d724e4d.webp differ diff --git a/translated_images/hk/responsible.e4f51a917bafa4bf.webp b/translated_images/zh-HK/responsible.e4f51a917bafa4bf.webp similarity index 100% rename from translated_images/hk/responsible.e4f51a917bafa4bf.webp rename to translated_images/zh-HK/responsible.e4f51a917bafa4bf.webp diff --git a/translated_images/zh-HK/tokens.6283ed277a2ffff4.webp b/translated_images/zh-HK/tokens.6283ed277a2ffff4.webp new file mode 100644 index 00000000..8e8e6bce Binary files /dev/null and b/translated_images/zh-HK/tokens.6283ed277a2ffff4.webp differ diff --git a/translated_images/hk/tool.189edfdb50db566d.webp b/translated_images/zh-HK/tool.189edfdb50db566d.webp similarity index 100% rename from translated_images/hk/tool.189edfdb50db566d.webp rename to translated_images/zh-HK/tool.189edfdb50db566d.webp diff --git a/translated_images/hk/vector.f12f114934e223df.webp b/translated_images/zh-HK/vector.f12f114934e223df.webp similarity index 100% rename from translated_images/hk/vector.f12f114934e223df.webp rename to translated_images/zh-HK/vector.f12f114934e223df.webp diff --git a/translated_images/mo/.co-op-translator.json b/translated_images/zh-MO/.co-op-translator.json similarity index 78% rename from translated_images/mo/.co-op-translator.json rename to translated_images/zh-MO/.co-op-translator.json index ede62402..15dd69b7 100644 --- a/translated_images/mo/.co-op-translator.json +++ b/translated_images/zh-MO/.co-op-translator.json @@ -3,96 +3,108 @@ "original_hash": "a967aa7c967f7eef94f31926c4c8067c", "translation_date": "2026-01-16T06:41:31+00:00", "source_file": "images/beg-genai-series.png", - "language_code": "mo" + "language_code": "zh-MO" }, "codespaces-create.b44a36f728660ab7.webp": { "original_hash": "7eab55896561d1bc55c6a162156d0017", "translation_date": "2026-01-16T06:43:43+00:00", "source_file": "02-SetupDevEnvironment/images/codespaces-create.png", - "language_code": "mo" + "language_code": "zh-MO" }, "codespaces.9945ded8ceb431a5.webp": { "original_hash": "48d3567c3959e06e4ce108c43a1bb655", "translation_date": "2026-01-16T06:43:12+00:00", "source_file": "02-SetupDevEnvironment/images/codespaces.png", - "language_code": "mo" + "language_code": "zh-MO" }, "devcontainer.21126c9d6de64494.webp": { "original_hash": "5a080e0e2e92ea495d1fd4fb0c3dca16", "translation_date": "2026-01-16T06:43:21+00:00", "source_file": "02-SetupDevEnvironment/images/devcontainer.png", - "language_code": "mo" + "language_code": "zh-MO" }, "embedding.398e50802c0037f9.webp": { "original_hash": "3b42046dab31decbe80630673d9a4299", "translation_date": "2026-01-16T06:42:23+00:00", "source_file": "01-IntroToGenAI/images/embedding.png", - "language_code": "mo" + "language_code": "zh-MO" }, "flow.f4ef62c3052d12a8.webp": { "original_hash": "384dbf925c9bd33ed060d90696e1e5dc", "translation_date": "2026-01-16T06:42:00+00:00", "source_file": "01-IntroToGenAI/images/flow.png", - "language_code": "mo" + "language_code": "zh-MO" }, "image-1.b36122aba30b20ad.webp": { "original_hash": "beb64e9c23de84eff0eb1949f9e903cd", "translation_date": "2026-01-16T06:44:38+00:00", "source_file": "02-SetupDevEnvironment/images/image-1.png", - "language_code": "mo" + "language_code": "zh-MO" }, "image-2.fc0da29a6e4d2aff.webp": { "original_hash": "6e06c4be35f0713416497bbcbf5272f1", "translation_date": "2026-01-16T06:43:59+00:00", "source_file": "02-SetupDevEnvironment/images/image-2.png", - "language_code": "mo" + "language_code": "zh-MO" }, "image-3.bf93d533bbc84268.webp": { "original_hash": "682e3bce2f2c57bb12667e96da792191", "translation_date": "2026-01-16T06:43:29+00:00", "source_file": "02-SetupDevEnvironment/images/image-3.png", - "language_code": "mo" + "language_code": "zh-MO" }, "image.73c7e2ff4a652e77.webp": { "original_hash": "65b6d1abec8bfb715c24ebe0f8929028", "translation_date": "2026-01-16T06:43:07+00:00", "source_file": "05-ResponsibleGenAI/images/image.png", - "language_code": "mo" + "language_code": "zh-MO" }, "image.833552b62eee7766.webp": { "original_hash": "6ea0edb52249206f1b5cbea93bedb7fb", "translation_date": "2026-01-16T06:44:23+00:00", "source_file": "02-SetupDevEnvironment/images/image.png", - "language_code": "mo" + "language_code": "zh-MO" }, "llms.225ca2b8a0d34473.webp": { "original_hash": "3e69ea1754a889ad7f1a690103fe75b6", "translation_date": "2026-01-16T06:42:41+00:00", "source_file": "01-IntroToGenAI/images/llms.png", - "language_code": "mo" + "language_code": "zh-MO" }, "mcp.3fcf1d13c662ef9a.webp": { "original_hash": "93122a41e7b6451319598b97a160174b", "translation_date": "2026-01-16T06:42:16+00:00", "source_file": "01-IntroToGenAI/images/mcp.png", - "language_code": "mo" + "language_code": "zh-MO" + }, + "models.cb07f8af0d724e4d.webp": { + "original_hash": "a1d68725372d3c033c59d1719b859d60", + "translation_date": "2026-01-29T15:28:11+00:00", + "source_file": "02-SetupDevEnvironment/images/models.webp", + "language_code": "zh-MO" }, "responsible.e4f51a917bafa4bf.webp": { "original_hash": "fa8d1e23eabb52aff991b3257f039a93", "translation_date": "2026-01-16T06:42:54+00:00", "source_file": "05-ResponsibleGenAI/images/responsible.png", - "language_code": "mo" + "language_code": "zh-MO" + }, + "tokens.6283ed277a2ffff4.webp": { + "original_hash": "11572cc20ac9478d3d009a4b7e6aad2d", + "translation_date": "2026-01-29T15:28:00+00:00", + "source_file": "01-IntroToGenAI/images/tokens.webp", + "language_code": "zh-MO" }, "tool.189edfdb50db566d.webp": { "original_hash": "ed2556303c831d1c9277652dc12014a1", "translation_date": "2026-01-16T06:41:40+00:00", "source_file": "04-PracticalSamples/calculator/images/tool.png", - "language_code": "mo" + "language_code": "zh-MO" }, "vector.f12f114934e223df.webp": { "original_hash": "b3c0003a891ccc7f1dc4711beb194a02", "translation_date": "2026-01-16T06:42:30+00:00", "source_file": "01-IntroToGenAI/images/vector.png", - "language_code": "mo" + "language_code": "zh-MO" } } \ No newline at end of file diff --git a/translated_images/mo/beg-genai-series.8b48be9951cc574c.webp b/translated_images/zh-MO/beg-genai-series.8b48be9951cc574c.webp similarity index 100% rename from translated_images/mo/beg-genai-series.8b48be9951cc574c.webp rename to translated_images/zh-MO/beg-genai-series.8b48be9951cc574c.webp diff --git a/translated_images/mo/codespaces-create.b44a36f728660ab7.webp b/translated_images/zh-MO/codespaces-create.b44a36f728660ab7.webp similarity index 100% rename from translated_images/mo/codespaces-create.b44a36f728660ab7.webp rename to translated_images/zh-MO/codespaces-create.b44a36f728660ab7.webp diff --git a/translated_images/mo/codespaces.9945ded8ceb431a5.webp b/translated_images/zh-MO/codespaces.9945ded8ceb431a5.webp similarity index 100% rename from translated_images/mo/codespaces.9945ded8ceb431a5.webp rename to translated_images/zh-MO/codespaces.9945ded8ceb431a5.webp diff --git a/translated_images/mo/devcontainer.21126c9d6de64494.webp b/translated_images/zh-MO/devcontainer.21126c9d6de64494.webp similarity index 100% rename from translated_images/mo/devcontainer.21126c9d6de64494.webp rename to translated_images/zh-MO/devcontainer.21126c9d6de64494.webp diff --git a/translated_images/mo/embedding.398e50802c0037f9.webp b/translated_images/zh-MO/embedding.398e50802c0037f9.webp similarity index 100% rename from translated_images/mo/embedding.398e50802c0037f9.webp rename to translated_images/zh-MO/embedding.398e50802c0037f9.webp diff --git a/translated_images/mo/flow.f4ef62c3052d12a8.webp b/translated_images/zh-MO/flow.f4ef62c3052d12a8.webp similarity index 100% rename from translated_images/mo/flow.f4ef62c3052d12a8.webp rename to translated_images/zh-MO/flow.f4ef62c3052d12a8.webp diff --git a/translated_images/mo/image-1.b36122aba30b20ad.webp b/translated_images/zh-MO/image-1.b36122aba30b20ad.webp similarity index 100% rename from translated_images/mo/image-1.b36122aba30b20ad.webp rename to translated_images/zh-MO/image-1.b36122aba30b20ad.webp diff --git a/translated_images/mo/image-2.fc0da29a6e4d2aff.webp b/translated_images/zh-MO/image-2.fc0da29a6e4d2aff.webp similarity index 100% rename from translated_images/mo/image-2.fc0da29a6e4d2aff.webp rename to translated_images/zh-MO/image-2.fc0da29a6e4d2aff.webp diff --git a/translated_images/mo/image-3.bf93d533bbc84268.webp b/translated_images/zh-MO/image-3.bf93d533bbc84268.webp similarity index 100% rename from translated_images/mo/image-3.bf93d533bbc84268.webp rename to translated_images/zh-MO/image-3.bf93d533bbc84268.webp diff --git a/translated_images/mo/image.73c7e2ff4a652e77.webp b/translated_images/zh-MO/image.73c7e2ff4a652e77.webp similarity index 100% rename from translated_images/mo/image.73c7e2ff4a652e77.webp rename to translated_images/zh-MO/image.73c7e2ff4a652e77.webp diff --git a/translated_images/mo/image.833552b62eee7766.webp b/translated_images/zh-MO/image.833552b62eee7766.webp similarity index 100% rename from translated_images/mo/image.833552b62eee7766.webp rename to translated_images/zh-MO/image.833552b62eee7766.webp diff --git a/translated_images/mo/llms.225ca2b8a0d34473.webp b/translated_images/zh-MO/llms.225ca2b8a0d34473.webp similarity index 100% rename from translated_images/mo/llms.225ca2b8a0d34473.webp rename to translated_images/zh-MO/llms.225ca2b8a0d34473.webp diff --git a/translated_images/mo/mcp.3fcf1d13c662ef9a.webp b/translated_images/zh-MO/mcp.3fcf1d13c662ef9a.webp similarity index 100% rename from translated_images/mo/mcp.3fcf1d13c662ef9a.webp rename to translated_images/zh-MO/mcp.3fcf1d13c662ef9a.webp diff --git a/translated_images/zh-MO/models.cb07f8af0d724e4d.webp b/translated_images/zh-MO/models.cb07f8af0d724e4d.webp new file mode 100644 index 00000000..e30879e9 Binary files /dev/null and b/translated_images/zh-MO/models.cb07f8af0d724e4d.webp differ diff --git a/translated_images/mo/responsible.e4f51a917bafa4bf.webp b/translated_images/zh-MO/responsible.e4f51a917bafa4bf.webp similarity index 100% rename from translated_images/mo/responsible.e4f51a917bafa4bf.webp rename to translated_images/zh-MO/responsible.e4f51a917bafa4bf.webp diff --git a/translated_images/zh-MO/tokens.6283ed277a2ffff4.webp b/translated_images/zh-MO/tokens.6283ed277a2ffff4.webp new file mode 100644 index 00000000..8e8e6bce Binary files /dev/null and b/translated_images/zh-MO/tokens.6283ed277a2ffff4.webp differ diff --git a/translated_images/mo/tool.189edfdb50db566d.webp b/translated_images/zh-MO/tool.189edfdb50db566d.webp similarity index 100% rename from translated_images/mo/tool.189edfdb50db566d.webp rename to translated_images/zh-MO/tool.189edfdb50db566d.webp diff --git a/translated_images/mo/vector.f12f114934e223df.webp b/translated_images/zh-MO/vector.f12f114934e223df.webp similarity index 100% rename from translated_images/mo/vector.f12f114934e223df.webp rename to translated_images/zh-MO/vector.f12f114934e223df.webp diff --git a/translated_images/tw/.co-op-translator.json b/translated_images/zh-TW/.co-op-translator.json similarity index 78% rename from translated_images/tw/.co-op-translator.json rename to translated_images/zh-TW/.co-op-translator.json index afcaf37a..b99fa393 100644 --- a/translated_images/tw/.co-op-translator.json +++ b/translated_images/zh-TW/.co-op-translator.json @@ -3,96 +3,108 @@ "original_hash": "a967aa7c967f7eef94f31926c4c8067c", "translation_date": "2026-01-16T06:41:33+00:00", "source_file": "images/beg-genai-series.png", - "language_code": "tw" + "language_code": "zh-TW" }, "codespaces-create.b44a36f728660ab7.webp": { "original_hash": "7eab55896561d1bc55c6a162156d0017", "translation_date": "2026-01-16T06:43:49+00:00", "source_file": "02-SetupDevEnvironment/images/codespaces-create.png", - "language_code": "tw" + "language_code": "zh-TW" }, "codespaces.9945ded8ceb431a5.webp": { "original_hash": "48d3567c3959e06e4ce108c43a1bb655", "translation_date": "2026-01-16T06:43:20+00:00", "source_file": "02-SetupDevEnvironment/images/codespaces.png", - "language_code": "tw" + "language_code": "zh-TW" }, "devcontainer.21126c9d6de64494.webp": { "original_hash": "5a080e0e2e92ea495d1fd4fb0c3dca16", "translation_date": "2026-01-16T06:43:24+00:00", "source_file": "02-SetupDevEnvironment/images/devcontainer.png", - "language_code": "tw" + "language_code": "zh-TW" }, "embedding.398e50802c0037f9.webp": { "original_hash": "3b42046dab31decbe80630673d9a4299", "translation_date": "2026-01-16T06:42:27+00:00", "source_file": "01-IntroToGenAI/images/embedding.png", - "language_code": "tw" + "language_code": "zh-TW" }, "flow.f4ef62c3052d12a8.webp": { "original_hash": "384dbf925c9bd33ed060d90696e1e5dc", "translation_date": "2026-01-16T06:42:15+00:00", "source_file": "01-IntroToGenAI/images/flow.png", - "language_code": "tw" + "language_code": "zh-TW" }, "image-1.b36122aba30b20ad.webp": { "original_hash": "beb64e9c23de84eff0eb1949f9e903cd", "translation_date": "2026-01-16T06:44:49+00:00", "source_file": "02-SetupDevEnvironment/images/image-1.png", - "language_code": "tw" + "language_code": "zh-TW" }, "image-2.fc0da29a6e4d2aff.webp": { "original_hash": "6e06c4be35f0713416497bbcbf5272f1", "translation_date": "2026-01-16T06:44:18+00:00", "source_file": "02-SetupDevEnvironment/images/image-2.png", - "language_code": "tw" + "language_code": "zh-TW" }, "image-3.bf93d533bbc84268.webp": { "original_hash": "682e3bce2f2c57bb12667e96da792191", "translation_date": "2026-01-16T06:43:40+00:00", "source_file": "02-SetupDevEnvironment/images/image-3.png", - "language_code": "tw" + "language_code": "zh-TW" }, "image.73c7e2ff4a652e77.webp": { "original_hash": "65b6d1abec8bfb715c24ebe0f8929028", "translation_date": "2026-01-16T06:43:09+00:00", "source_file": "05-ResponsibleGenAI/images/image.png", - "language_code": "tw" + "language_code": "zh-TW" }, "image.833552b62eee7766.webp": { "original_hash": "6ea0edb52249206f1b5cbea93bedb7fb", "translation_date": "2026-01-16T06:44:31+00:00", "source_file": "02-SetupDevEnvironment/images/image.png", - "language_code": "tw" + "language_code": "zh-TW" }, "llms.225ca2b8a0d34473.webp": { "original_hash": "3e69ea1754a889ad7f1a690103fe75b6", "translation_date": "2026-01-16T06:42:48+00:00", "source_file": "01-IntroToGenAI/images/llms.png", - "language_code": "tw" + "language_code": "zh-TW" }, "mcp.3fcf1d13c662ef9a.webp": { "original_hash": "93122a41e7b6451319598b97a160174b", "translation_date": "2026-01-16T06:42:21+00:00", "source_file": "01-IntroToGenAI/images/mcp.png", - "language_code": "tw" + "language_code": "zh-TW" + }, + "models.cb07f8af0d724e4d.webp": { + "original_hash": "a1d68725372d3c033c59d1719b859d60", + "translation_date": "2026-01-29T15:28:26+00:00", + "source_file": "02-SetupDevEnvironment/images/models.webp", + "language_code": "zh-TW" }, "responsible.e4f51a917bafa4bf.webp": { "original_hash": "fa8d1e23eabb52aff991b3257f039a93", "translation_date": "2026-01-16T06:43:05+00:00", "source_file": "05-ResponsibleGenAI/images/responsible.png", - "language_code": "tw" + "language_code": "zh-TW" + }, + "tokens.6283ed277a2ffff4.webp": { + "original_hash": "11572cc20ac9478d3d009a4b7e6aad2d", + "translation_date": "2026-01-29T15:28:02+00:00", + "source_file": "01-IntroToGenAI/images/tokens.webp", + "language_code": "zh-TW" }, "tool.189edfdb50db566d.webp": { "original_hash": "ed2556303c831d1c9277652dc12014a1", "translation_date": "2026-01-16T06:41:51+00:00", "source_file": "04-PracticalSamples/calculator/images/tool.png", - "language_code": "tw" + "language_code": "zh-TW" }, "vector.f12f114934e223df.webp": { "original_hash": "b3c0003a891ccc7f1dc4711beb194a02", "translation_date": "2026-01-16T06:42:38+00:00", "source_file": "01-IntroToGenAI/images/vector.png", - "language_code": "tw" + "language_code": "zh-TW" } } \ No newline at end of file diff --git a/translated_images/tw/beg-genai-series.8b48be9951cc574c.webp b/translated_images/zh-TW/beg-genai-series.8b48be9951cc574c.webp similarity index 100% rename from translated_images/tw/beg-genai-series.8b48be9951cc574c.webp rename to translated_images/zh-TW/beg-genai-series.8b48be9951cc574c.webp diff --git a/translated_images/tw/codespaces-create.b44a36f728660ab7.webp b/translated_images/zh-TW/codespaces-create.b44a36f728660ab7.webp similarity index 100% rename from translated_images/tw/codespaces-create.b44a36f728660ab7.webp rename to translated_images/zh-TW/codespaces-create.b44a36f728660ab7.webp diff --git a/translated_images/tw/codespaces.9945ded8ceb431a5.webp b/translated_images/zh-TW/codespaces.9945ded8ceb431a5.webp similarity index 100% rename from translated_images/tw/codespaces.9945ded8ceb431a5.webp rename to translated_images/zh-TW/codespaces.9945ded8ceb431a5.webp diff --git a/translated_images/tw/devcontainer.21126c9d6de64494.webp b/translated_images/zh-TW/devcontainer.21126c9d6de64494.webp similarity index 100% rename from translated_images/tw/devcontainer.21126c9d6de64494.webp rename to translated_images/zh-TW/devcontainer.21126c9d6de64494.webp diff --git a/translated_images/tw/embedding.398e50802c0037f9.webp b/translated_images/zh-TW/embedding.398e50802c0037f9.webp similarity index 100% rename from translated_images/tw/embedding.398e50802c0037f9.webp rename to translated_images/zh-TW/embedding.398e50802c0037f9.webp diff --git a/translated_images/tw/flow.f4ef62c3052d12a8.webp b/translated_images/zh-TW/flow.f4ef62c3052d12a8.webp similarity index 100% rename from translated_images/tw/flow.f4ef62c3052d12a8.webp rename to translated_images/zh-TW/flow.f4ef62c3052d12a8.webp diff --git a/translated_images/tw/image-1.b36122aba30b20ad.webp b/translated_images/zh-TW/image-1.b36122aba30b20ad.webp similarity index 100% rename from translated_images/tw/image-1.b36122aba30b20ad.webp rename to translated_images/zh-TW/image-1.b36122aba30b20ad.webp diff --git a/translated_images/tw/image-2.fc0da29a6e4d2aff.webp b/translated_images/zh-TW/image-2.fc0da29a6e4d2aff.webp similarity index 100% rename from translated_images/tw/image-2.fc0da29a6e4d2aff.webp rename to translated_images/zh-TW/image-2.fc0da29a6e4d2aff.webp diff --git a/translated_images/tw/image-3.bf93d533bbc84268.webp b/translated_images/zh-TW/image-3.bf93d533bbc84268.webp similarity index 100% rename from translated_images/tw/image-3.bf93d533bbc84268.webp rename to translated_images/zh-TW/image-3.bf93d533bbc84268.webp diff --git a/translated_images/tw/image.73c7e2ff4a652e77.webp b/translated_images/zh-TW/image.73c7e2ff4a652e77.webp similarity index 100% rename from translated_images/tw/image.73c7e2ff4a652e77.webp rename to translated_images/zh-TW/image.73c7e2ff4a652e77.webp diff --git a/translated_images/tw/image.833552b62eee7766.webp b/translated_images/zh-TW/image.833552b62eee7766.webp similarity index 100% rename from translated_images/tw/image.833552b62eee7766.webp rename to translated_images/zh-TW/image.833552b62eee7766.webp diff --git a/translated_images/tw/llms.225ca2b8a0d34473.webp b/translated_images/zh-TW/llms.225ca2b8a0d34473.webp similarity index 100% rename from translated_images/tw/llms.225ca2b8a0d34473.webp rename to translated_images/zh-TW/llms.225ca2b8a0d34473.webp diff --git a/translated_images/tw/mcp.3fcf1d13c662ef9a.webp b/translated_images/zh-TW/mcp.3fcf1d13c662ef9a.webp similarity index 100% rename from translated_images/tw/mcp.3fcf1d13c662ef9a.webp rename to translated_images/zh-TW/mcp.3fcf1d13c662ef9a.webp diff --git a/translated_images/zh-TW/models.cb07f8af0d724e4d.webp b/translated_images/zh-TW/models.cb07f8af0d724e4d.webp new file mode 100644 index 00000000..e30879e9 Binary files /dev/null and b/translated_images/zh-TW/models.cb07f8af0d724e4d.webp differ diff --git a/translated_images/tw/responsible.e4f51a917bafa4bf.webp b/translated_images/zh-TW/responsible.e4f51a917bafa4bf.webp similarity index 100% rename from translated_images/tw/responsible.e4f51a917bafa4bf.webp rename to translated_images/zh-TW/responsible.e4f51a917bafa4bf.webp diff --git a/translated_images/zh-TW/tokens.6283ed277a2ffff4.webp b/translated_images/zh-TW/tokens.6283ed277a2ffff4.webp new file mode 100644 index 00000000..8e8e6bce Binary files /dev/null and b/translated_images/zh-TW/tokens.6283ed277a2ffff4.webp differ diff --git a/translated_images/tw/tool.189edfdb50db566d.webp b/translated_images/zh-TW/tool.189edfdb50db566d.webp similarity index 100% rename from translated_images/tw/tool.189edfdb50db566d.webp rename to translated_images/zh-TW/tool.189edfdb50db566d.webp diff --git a/translated_images/tw/vector.f12f114934e223df.webp b/translated_images/zh-TW/vector.f12f114934e223df.webp similarity index 100% rename from translated_images/tw/vector.f12f114934e223df.webp rename to translated_images/zh-TW/vector.f12f114934e223df.webp diff --git a/translations/ar/.co-op-translator.json b/translations/ar/.co-op-translator.json new file mode 100644 index 00000000..7bd8ee43 --- /dev/null +++ b/translations/ar/.co-op-translator.json @@ -0,0 +1,92 @@ +{ + "01-IntroToGenAI/README.md": { + "original_hash": "75bfb080ca725e8a9aa9c80cae25fba1", + "translation_date": "2025-07-29T08:08:18+00:00", + "source_file": "01-IntroToGenAI/README.md", + "language_code": "ar" + }, + "02-SetupDevEnvironment/README.md": { + "original_hash": "96a30d42b9751a3d4e4b20e28d29d459", + "translation_date": "2026-01-28T04:39:55+00:00", + "source_file": "02-SetupDevEnvironment/README.md", + "language_code": "ar" + }, + "02-SetupDevEnvironment/examples/basic-chat-azure/README.md": { + "original_hash": "efd82efe50711d7e257eb943151d682c", + "translation_date": "2025-07-27T13:34:04+00:00", + "source_file": "02-SetupDevEnvironment/examples/basic-chat-azure/README.md", + "language_code": "ar" + }, + "02-SetupDevEnvironment/getting-started-azure-openai.md": { + "original_hash": "bfdb4b4eadbee3a59ef742439f58326a", + "translation_date": "2025-07-27T12:51:54+00:00", + "source_file": "02-SetupDevEnvironment/getting-started-azure-openai.md", + "language_code": "ar" + }, + "03-CoreGenerativeAITechniques/README.md": { + "original_hash": "685f55cb07de19b52a30ce6e8b6d889e", + "translation_date": "2025-08-28T21:26:05+00:00", + "source_file": "03-CoreGenerativeAITechniques/README.md", + "language_code": "ar" + }, + "04-PracticalSamples/README.md": { + "original_hash": "14c0a61ecc1cd2012a9c129236dfdf71", + "translation_date": "2025-07-29T08:08:01+00:00", + "source_file": "04-PracticalSamples/README.md", + "language_code": "ar" + }, + "04-PracticalSamples/calculator/README.md": { + "original_hash": "b6c16b5514d524e415a94f6097ee7d4c", + "translation_date": "2025-09-18T15:24:06+00:00", + "source_file": "04-PracticalSamples/calculator/README.md", + "language_code": "ar" + }, + "04-PracticalSamples/foundrylocal/README.md": { + "original_hash": "f787307400de59adc25a1404466a35f3", + "translation_date": "2025-11-04T07:13:50+00:00", + "source_file": "04-PracticalSamples/foundrylocal/README.md", + "language_code": "ar" + }, + "04-PracticalSamples/petstory/README.md": { + "original_hash": "0cbf68d605615a1e602c832a24616859", + "translation_date": "2025-07-25T10:45:53+00:00", + "source_file": "04-PracticalSamples/petstory/README.md", + "language_code": "ar" + }, + "05-ResponsibleGenAI/README.md": { + "original_hash": "301c05c2f57e60a6950b8c665b8bdbba", + "translation_date": "2025-07-29T15:41:16+00:00", + "source_file": "05-ResponsibleGenAI/README.md", + "language_code": "ar" + }, + "AGENTS.md": { + "original_hash": "afc90918d008cf77fd1982691f681306", + "translation_date": "2025-10-03T08:26:25+00:00", + "source_file": "AGENTS.md", + "language_code": "ar" + }, + "CODE_OF_CONDUCT.md": { + "original_hash": "442b123d034f92f7c384d2bbd28f99f1", + "translation_date": "2025-07-21T17:36:24+00:00", + "source_file": "CODE_OF_CONDUCT.md", + "language_code": "ar" + }, + "README.md": { + "original_hash": "125a08948d881c95628094f4dd1fbd43", + "translation_date": "2026-01-29T15:19:30+00:00", + "source_file": "README.md", + "language_code": "ar" + }, + "SECURITY.md": { + "original_hash": "57f14126c1c6add76b3aef3844dfe4e3", + "translation_date": "2025-07-21T17:34:07+00:00", + "source_file": "SECURITY.md", + "language_code": "ar" + }, + "SUPPORT.md": { + "original_hash": "b8ef73cc49dec68e2c885ee9df545129", + "translation_date": "2025-07-21T17:37:27+00:00", + "source_file": "SUPPORT.md", + "language_code": "ar" + } +} \ No newline at end of file diff --git a/translations/ar/01-IntroToGenAI/README.md b/translations/ar/01-IntroToGenAI/README.md index b35bbd1e..b55329b6 100644 --- a/translations/ar/01-IntroToGenAI/README.md +++ b/translations/ar/01-IntroToGenAI/README.md @@ -1,12 +1,3 @@ - # مقدمة في الذكاء الاصطناعي التوليدي - إصدار جافا ## ما ستتعلمه diff --git a/translations/ar/02-SetupDevEnvironment/README.md b/translations/ar/02-SetupDevEnvironment/README.md index 31ea9b89..e142e4fe 100644 --- a/translations/ar/02-SetupDevEnvironment/README.md +++ b/translations/ar/02-SetupDevEnvironment/README.md @@ -1,13 +1,253 @@ - +# إعداد بيئة التطوير للذكاء الاصطناعي التوليدي لجافا +> **البدء السريع**: البرمجة في السحابة خلال دقيقتين - انتقل إلى [إعداد GitHub Codespaces](../../../02-SetupDevEnvironment) - لا حاجة لتثبيت محلي ويستخدم نماذج github! + +> **مهتم بـ Azure OpenAI؟**، راجع [دليل إعداد Azure OpenAI](getting-started-azure-openai.md) مع خطوات لإنشاء مورد جديد في Azure OpenAI. + +## ما الذي ستتعلمه + +- إعداد بيئة تطوير جافا لتطبيقات الذكاء الاصطناعي +- اختيار وتكوين بيئة التطوير المفضلة لديك (سحابة أولاً مع Codespaces، حاوية تطوير محلية، أو إعداد محلي كامل) +- اختبار إعدادك من خلال الاتصال بنماذج GitHub + +## جدول المحتويات + +- [ما الذي ستتعلمه](../../../02-SetupDevEnvironment) +- [مقدمة](../../../02-SetupDevEnvironment) +- [الخطوة 1: إعداد بيئة التطوير الخاصة بك](../../../02-SetupDevEnvironment) + - [الخيار أ: GitHub Codespaces (موصى به)](../../../02-SetupDevEnvironment) + - [الخيار ب: حاوية تطوير محلية](../../../02-SetupDevEnvironment) + - [الخيار ج: استخدم تثبيتك المحلي الحالي](../../../02-SetupDevEnvironment) +- [الخطوة 2: إنشاء رمز وصول شخصي على GitHub](../../../02-SetupDevEnvironment) +- [الخطوة 3: اختبار إعدادك](../../../02-SetupDevEnvironment) +- [استكشاف الأخطاء وإصلاحها](../../../02-SetupDevEnvironment) +- [الملخص](../../../02-SetupDevEnvironment) +- [الخطوات التالية](../../../02-SetupDevEnvironment) + +## مقدمة + +سيرشدك هذا الفصل خلال إعداد بيئة تطوير. سنستخدم **نماذج GitHub** كمثال أساسي لأنها مجانية وسهلة الإعداد باستخدام حساب GitHub فقط، ولا تتطلب بطاقة ائتمان، وتوفر الوصول إلى نماذج متعددة للتجربة. + +**لا حاجة لإعداد محلي!** يمكنك البدء بالبرمجة فورًا باستخدام GitHub Codespaces، التي توفر بيئة تطوير كاملة في متصفحك. + +لقطة شاشة: نماذج GitHub + +نوصي باستخدام [**نماذج GitHub**](https://github.com/marketplace?type=models) لهذه الدورة لأنها: +- **مجانية** للبدء +- **سهلة** الإعداد فقط بحساب GitHub +- **لا تحتاج إلى بطاقة ائتمان** +- **نماذج متعددة** متاحة للتجربة + +> **ملاحظة**: حدود الاستخدام المجانية لنماذج GitHub المستخدمة في هذا التدريب هي: +> - 15 طلبًا في الدقيقة (150 في اليوم) +> - حوالي 8,000 كلمة دخل، 4,000 كلمة خرج لكل طلب +> - 5 طلبات متزامنة +> +> للاستخدام في الإنتاج، قم بالترقية إلى نماذج Azure AI Foundry بحساب Azure الخاص بك. لا يلزم تعديل الكود الخاص بك. راجع [توثيق Azure AI Foundry](https://learn.microsoft.com/azure/ai-foundry/foundry-models/how-to/quickstart-github-models). + +## الخطوة 1: إعداد بيئة التطوير الخاصة بك + + + +لقد أنشأنا حاوية تطوير مهيأة مسبقًا لتقليل زمن الإعداد وضمان توفر جميع الأدوات اللازمة لدورة الذكاء الاصطناعي التوليدي لجافا. اختر نهج التطوير المفضل لديك: + +### خيارات إعداد البيئة: + +#### الخيار أ: GitHub Codespaces (موصى به) + +**ابدأ البرمجة خلال دقيقتين - لا حاجة لإعداد محلي!** + +1. قم بفورك هذا المستودع إلى حساب GitHub الخاص بك + > **ملاحظة**: إذا كنت تريد تعديل التكوين الأساسي، يرجى مراجعة [تكوين حاوية التطوير](../../../.devcontainer/devcontainer.json) +2. انقر على **Code** → تبويب **Codespaces** → **...** → **جديد مع خيارات...** +3. استخدم الإعدادات الافتراضية – هذا سيختار **تكوين حاوية التطوير**: **بيئة تطوير جافا للذكاء الاصطناعي التوليدي**، حاوية تطوير مخصصة أنشئت لهذه الدورة +4. انقر على **إنشاء codespace** +5. انتظر حوالي دقيقتين حتى تكون البيئة جاهزة +6. تابع إلى [الخطوة 2: إنشاء رمز وصول GitHub](../../../02-SetupDevEnvironment) + +لقطة شاشة: قائمة فرعية لـ Codespaces + +لقطة شاشة: جديد مع خيارات + +لقطة شاشة: خيارات إنشاء codespace + + +> **فوائد Codespaces**: +> - لا حاجة للتثبيت المحلي +> - يعمل على أي جهاز يحتوي على متصفح +> - مهيأ مسبقًا بجميع الأدوات والاعتمادات +> - مجاني لمدة 60 ساعة شهريًا للحسابات الشخصية +> - بيئة موحدة لجميع المتعلمين + +#### الخيار ب: حاوية تطوير محلية + +**للمطورين الذين يفضلون التطوير المحلي باستخدام Docker** + +1. قم بفورك واستنساخ هذا المستودع إلى جهازك المحلي + > **ملاحظة**: إذا كنت تريد تعديل التكوين الأساسي، يرجى مراجعة [تكوين حاوية التطوير](../../../.devcontainer/devcontainer.json) +2. قم بتثبيت [Docker Desktop](https://www.docker.com/products/docker-desktop/) و [VS Code](https://code.visualstudio.com/) +3. ثبت إضافة [Dev Containers extension](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers) في VS Code +4. افتح مجلد المستودع في VS Code +5. عند ظهور الطلب، انقر على **إعادة الفتح في الحاوية** (أو استخدم `Ctrl+Shift+P` → "Dev Containers: Reopen in Container") +6. انتظر حتى يتم بناء الحاوية وتشغيلها +7. تابع إلى [الخطوة 2: إنشاء رمز وصول GitHub](../../../02-SetupDevEnvironment) + +لقطة شاشة: إعداد حاوية التطوير + +لقطة شاشة: اكتمال بناء حاوية التطوير + +#### الخيار ج: استخدم تثبيتك المحلي الحالي + +**للمطورين الذين لديهم بيئات جافا موجودة** + +المتطلبات المسبقة: +- [جافا 21+](https://www.oracle.com/java/technologies/javase/jdk21-archive-downloads.html) +- [Maven 3.9+](https://maven.apache.org/download.cgi) +- [VS Code](https://code.visualstudio.com) أو بيئة التطوير المتكاملة المفضلة لديك + +الخطوات: +1. استنسخ هذا المستودع إلى جهازك المحلي +2. افتح المشروع في بيئة التطوير المتكاملة الخاصة بك +3. تابع إلى [الخطوة 2: إنشاء رمز وصول GitHub](../../../02-SetupDevEnvironment) + +> **نصيحة محترف**: إذا كان جهازك ذو مواصفات منخفضة ولكن تريد استخدام VS Code محليًا، استخدم GitHub Codespaces! يمكنك ربط VS Code المحلي الخاص بك بـ Codespace مستضاف على السحابة لأفضل تجربة. + +لقطة شاشة: إنشاء مثيل حاوية تطوير محلية + + +## الخطوة 2: إنشاء رمز وصول شخصي على GitHub + +1. انتقل إلى [إعدادات GitHub](https://github.com/settings/profile) واختر **Settings** من قائمة الملف الشخصي. +2. في الشريط الجانبي الأيسر، انقر على **Developer settings** (عادة في الأسفل). +3. تحت **Personal access tokens**، انقر على **Fine-grained tokens** (أو اتبع هذا [الرابط المباشر](https://github.com/settings/personal-access-tokens)). +4. انقر على **Generate new token**. +5. تحت "اسم الرمز"، قدم اسمًا وصفيًا (مثل `GenAI-Java-Course-Token`). +6. اضبط تاريخ انتهاء الصلاحية (موصى به: 7 أيام لأفضل ممارسات الأمان). +7. تحت "مالك المورد"، اختر حساب المستخدم الخاص بك. +8. تحت "وصول المستودعات"، اختر المستودعات التي تريد استخدامها مع نماذج GitHub (أو "كل المستودعات" إذا لزم الأمر). +9. تحت "أذونات الحساب"، ابحث عن **Models** واضبطها على **قراءة فقط**. +10. انقر على **Generate token**. +11. **انسخ الرمز واحفظه الآن** – لن تراه مرة أخرى! + +> **نصيحة أمان**: استخدم الحد الأدنى من الأذونات المطلوبة وأقصر مدة صلاحية ممكنة لرموز الوصول الخاصة بك. + +## الخطوة 3: اختبار إعدادك مع مثال نماذج GitHub + +بمجرد أن تكون بيئة التطوير جاهزة، دعنا نختبر تكامل نماذج GitHub بالتطبيق النموذجي الخاص بنا في [`02-SetupDevEnvironment/examples/github-models`](../../../02-SetupDevEnvironment/examples/github-models). + +1. افتح الطرفية في بيئة التطوير الخاصة بك. +2. انتقل إلى مثال نماذج GitHub: + ```bash + cd 02-SetupDevEnvironment/examples/github-models + ``` +3. قم بتعيين رمز GitHub الخاص بك كمتغير بيئة: + ```bash + # ماك أو إس / لينكس + export GITHUB_TOKEN=your_token_here + + # ويندوز (موجه الأوامر) + set GITHUB_TOKEN=your_token_here + + # ويندوز (باورشيل) + $env:GITHUB_TOKEN="your_token_here" + ``` + +4. شغّل التطبيق: + ```bash + mvn compile exec:java -Dexec.mainClass="com.example.githubmodels.App" + ``` + +ينبغي أن ترى مخرجات مشابهة لـ: +```text +Using model: gpt-4.1-nano +Sending request to GitHub Models... +Response: Hello World! +``` + +### فهم كود المثال + +أولاً، دعنا نفهم ما قمنا بتشغيله. المثال تحت `examples/github-models` يستخدم OpenAI Java SDK للاتصال بنماذج GitHub: + +**ما يقوم به هذا الكود:** +- **الاتصال** بنماذج GitHub باستخدام رمز الوصول الشخصي الخاص بك +- **إرسال** رسالة بسيطة "قل مرحباً بالعالم!" إلى نموذج الذكاء الاصطناعي +- **استقبال** وعرض الرد من الذكاء الاصطناعي +- **التحقق** من أن إعدادك يعمل بشكل صحيح + +**اعتماد رئيسي** (في `pom.xml`): +```xml + + com.openai + openai-java + 2.12.0 + +``` + +**الكود الرئيسي** (`App.java`): +```java +// الاتصال بنماذج GitHub باستخدام OpenAI Java SDK +OpenAIClient client = OpenAIOkHttpClient.builder() + .apiKey(pat) + .baseUrl("https://models.inference.ai.azure.com") + .build(); + +// إنشاء طلب إكمال المحادثة +ChatCompletionCreateParams params = ChatCompletionCreateParams.builder() + .model(modelId) + .addSystemMessage("You are a concise assistant.") + .addUserMessage("Say Hello World!") + .build(); + +// الحصول على استجابة الذكاء الاصطناعي +ChatCompletion response = client.chat().completions().create(params); +System.out.println("Response: " + response.choices().get(0).message().content().orElse("No response content")); +``` + +## الملخص + +رائع! لديك الآن كل شيء معد: + +- أنشأت رمز وصول شخصي على GitHub مع الأذونات المناسبة للوصول لنماذج الذكاء الاصطناعي +- شغلت بيئة تطوير جافا الخاصة بك (سواء كانت Codespaces، حاويات التطوير، أو محليًا) +- اتصلت بنماذج GitHub باستخدام OpenAI Java SDK لتطوير الذكاء الاصطناعي مجاني +- اختبرت كل شيء مع مثال بسيط يتواصل مع نماذج الذكاء الاصطناعي + +## الخطوات التالية + +[الفصل 3: تقنيات الذكاء الاصطناعي التوليدي الأساسية](../03-CoreGenerativeAITechniques/README.md) + +## استكشاف الأخطاء وإصلاحها + +هل تواجه مشاكل؟ إليك المشاكل الشائعة والحلول: + +- **الرمز لا يعمل؟** + - تأكد من نسخ الرمز بالكامل بدون فراغات إضافية + - تحقق من تعيين الرمز بشكل صحيح كمتغير بيئة + - تأكد من أن الرمز لديه الأذونات الصحيحة (Models: قراءة فقط) + +- **Maven غير موجود؟** + - إذا كنت تستخدم حاويات التطوير أو Codespaces، يجب أن يكون Maven مثبتًا مسبقًا + - للإعداد المحلي، تأكد من تثبيت جافا 21+ وMaven 3.9+ + - جرب الأمر `mvn --version` للتحقق من التثبيت + +- **مشاكل في الاتصال؟** + - تحقق من اتصال الإنترنت لديك + - تحقق من إمكانية الوصول إلى GitHub من شبكتك + - تأكد أنك لست خلف جدار حماية يمنع الوصول إلى نقطة نهاية نماذج GitHub + +- **حاوية التطوير لا تبدأ؟** + - تأكد من تشغيل Docker Desktop (للتطوير المحلي) + - جرب إعادة بناء الحاوية: `Ctrl+Shift+P` → "Dev Containers: Rebuild Container" + +- **أخطاء تجميع التطبيق؟** + - تحقق من أنك في الدليل الصحيح: `02-SetupDevEnvironment/examples/github-models` + - جرب التنظيف وإعادة البناء: `mvn clean compile` + +> **هل تحتاج مساعدة؟**: لا تزال تواجه مشاكل؟ افتح مشكلة في المستودع وسنساعدك. --- + +**تنويه**: +تمت ترجمة هذا المستند باستخدام خدمة الترجمة الآلية [Co-op Translator](https://github.com/Azure/co-op-translator). بينما نسعى لتحقيق الدقة، يرجى العلم أن الترجمات الآلية قد تحتوي على أخطاء أو عدم دقة. يجب اعتبار المستند الأصلي بلغته الأصلية المصدر المعتمد. للحصول على معلومات حرجة، يُنصح بالاعتماد على الترجمة البشرية المهنية. نحن غير مسؤولين عن أي سوء فهم أو تفسير خاطئ ناتج عن استخدام هذه الترجمة. + \ No newline at end of file diff --git a/translations/ar/02-SetupDevEnvironment/examples/basic-chat-azure/README.md b/translations/ar/02-SetupDevEnvironment/examples/basic-chat-azure/README.md index 3abbcd53..ccda4f38 100644 --- a/translations/ar/02-SetupDevEnvironment/examples/basic-chat-azure/README.md +++ b/translations/ar/02-SetupDevEnvironment/examples/basic-chat-azure/README.md @@ -1,12 +1,3 @@ - # مثال شامل للدردشة الأساسية مع Azure OpenAI يوضح هذا المثال كيفية إنشاء تطبيق بسيط باستخدام Spring Boot يتصل بـ Azure OpenAI لاختبار الإعداد الخاص بك. diff --git a/translations/ar/02-SetupDevEnvironment/getting-started-azure-openai.md b/translations/ar/02-SetupDevEnvironment/getting-started-azure-openai.md index a3e21429..bcd8f764 100644 --- a/translations/ar/02-SetupDevEnvironment/getting-started-azure-openai.md +++ b/translations/ar/02-SetupDevEnvironment/getting-started-azure-openai.md @@ -1,12 +1,3 @@ - # إعداد بيئة التطوير لـ Azure OpenAI > **البدء السريع**: هذا الدليل مخصص لإعداد Azure OpenAI. للبدء الفوري باستخدام النماذج المجانية، استخدم [نماذج GitHub مع Codespaces](./README.md#quick-start-cloud). diff --git a/translations/ar/03-CoreGenerativeAITechniques/README.md b/translations/ar/03-CoreGenerativeAITechniques/README.md index 4427af7f..e292b993 100644 --- a/translations/ar/03-CoreGenerativeAITechniques/README.md +++ b/translations/ar/03-CoreGenerativeAITechniques/README.md @@ -1,12 +1,3 @@ - # دليل تقنيات الذكاء الاصطناعي التوليدي الأساسية ## جدول المحتويات diff --git a/translations/ar/04-PracticalSamples/README.md b/translations/ar/04-PracticalSamples/README.md index 231b6686..2eb415e6 100644 --- a/translations/ar/04-PracticalSamples/README.md +++ b/translations/ar/04-PracticalSamples/README.md @@ -1,12 +1,3 @@ - # التطبيقات العملية والمشاريع ## ما ستتعلمه diff --git a/translations/ar/04-PracticalSamples/calculator/README.md b/translations/ar/04-PracticalSamples/calculator/README.md index 47ae618f..c86cf544 100644 --- a/translations/ar/04-PracticalSamples/calculator/README.md +++ b/translations/ar/04-PracticalSamples/calculator/README.md @@ -1,12 +1,3 @@ - # دليل استخدام MCP Calculator للمبتدئين ## جدول المحتويات diff --git a/translations/ar/04-PracticalSamples/foundrylocal/README.md b/translations/ar/04-PracticalSamples/foundrylocal/README.md index 0326e65c..542c06b7 100644 --- a/translations/ar/04-PracticalSamples/foundrylocal/README.md +++ b/translations/ar/04-PracticalSamples/foundrylocal/README.md @@ -1,12 +1,3 @@ - # دليل استخدام Foundry Local مع Spring Boot ## جدول المحتويات diff --git a/translations/ar/04-PracticalSamples/petstory/README.md b/translations/ar/04-PracticalSamples/petstory/README.md index 8d21b459..c0ddbd41 100644 --- a/translations/ar/04-PracticalSamples/petstory/README.md +++ b/translations/ar/04-PracticalSamples/petstory/README.md @@ -1,12 +1,3 @@ - # دليل إنشاء قصص الحيوانات الأليفة للمبتدئين ## جدول المحتويات diff --git a/translations/ar/05-ResponsibleGenAI/README.md b/translations/ar/05-ResponsibleGenAI/README.md index b1e03c0d..138520ec 100644 --- a/translations/ar/05-ResponsibleGenAI/README.md +++ b/translations/ar/05-ResponsibleGenAI/README.md @@ -1,12 +1,3 @@ - # الذكاء الاصطناعي التوليدي المسؤول ## ما ستتعلمه diff --git a/translations/ar/AGENTS.md b/translations/ar/AGENTS.md index 26aba085..3d9caf9c 100644 --- a/translations/ar/AGENTS.md +++ b/translations/ar/AGENTS.md @@ -1,12 +1,3 @@ - # AGENTS.md ## نظرة عامة على المشروع diff --git a/translations/ar/CODE_OF_CONDUCT.md b/translations/ar/CODE_OF_CONDUCT.md index 1047e957..81e41594 100644 --- a/translations/ar/CODE_OF_CONDUCT.md +++ b/translations/ar/CODE_OF_CONDUCT.md @@ -1,12 +1,3 @@ - # مدونة قواعد السلوك لمصادر مايكروسوفت المفتوحة لقد تبنى هذا المشروع [مدونة قواعد السلوك لمصادر مايكروسوفت المفتوحة](https://opensource.microsoft.com/codeofconduct/). diff --git a/translations/ar/README.md b/translations/ar/README.md index 38dc488d..85913cd5 100644 --- a/translations/ar/README.md +++ b/translations/ar/README.md @@ -1,90 +1,82 @@ - -# الذكاء الاصطناعي التوليدي للمبتدئين - إصدار جافا +# الذكاء الاصطناعي التوليدي للمبتدئين - نسخة جافا [![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) -![الذكاء الاصطناعي التوليدي للمبتدئين - إصدار جافا](../../translated_images/ar/beg-genai-series.8b48be9951cc574c.webp) +![Generative AI for Beginners - Java Edition](../../translated_images/ar/beg-genai-series.8b48be9951cc574c.webp) -**مدة الالتزام**: يمكن إتمام ورشة العمل بأكملها عبر الإنترنت دون تثبيت محلي. يستغرق إعداد البيئة دقيقتين، مع استكشاف العينات الذي يتطلب من 1 إلى 3 ساعات حسب عمق الاستكشاف. +**الوقت المطلوب**: يمكن إتمام الورشة بالكامل عبر الإنترنت دون إعداد محلي. يستغرق إعداد البيئة دقيقتين، مع استكشاف العينات يتطلب من 1 إلى 3 ساعات حسب عمق الاستكشاف. -> **بدء سريع** +> **البدء السريع** -1. قم بعمل فورك لهذا المستودع إلى حسابك على GitHub -2. اضغط على **Code** → علامة التبويب **Codespaces** → **...** → **New with options...** -3. استخدم الإعدادات الافتراضية – هذا سيختار حاوية التطوير التي تم إنشاؤها لهذه الدورة -4. اضغط على **Create codespace** +1. استنسخ هذا المستودع إلى حسابك على GitHub +2. اضغط على **Code** → علامة تبويب **Codespaces** → **...** → **جديد مع خيارات...** +3. استخدم الإعدادات الافتراضية – هذا سيختار حاوية التطوير المخصصة لهذه الدورة +4. اضغط **إنشاء مساحة رمز** 5. انتظر حوالي دقيقتين حتى تكون البيئة جاهزة 6. انتقل مباشرة إلى [المثال الأول](./02-SetupDevEnvironment/README.md#step-2-create-a-github-personal-access-token) -> **هل تفضل الاستنساخ محليًا؟** +> **تفضل النسخ محليًا؟** > -> يتضمن هذا المستودع أكثر من 50 ترجمة للغات مما يزيد بشكل كبير من حجم التنزيل. للاستنساخ بدون الترجمات، استخدم الاستنساخ الجزئي: +> يحتوي هذا المستودع على أكثر من 50 ترجمة لغة مما يزيد بشكل كبير حجم التنزيل. لاستنساخ دون الترجمات، استخدم الاستنساخ الجزئي: > ```bash > git clone --filter=blob:none --sparse https://github.com/microsoft/Generative-AI-for-beginners-java.git > cd Generative-AI-for-beginners-java > git sparse-checkout set --no-cone '/*' '!translations' '!translated_images' > ``` -> هذا يمنحك كل ما تحتاجه لإكمال الدورة بتنزيل أسرع بكثير. +> هذا يمنحك كل ما تحتاجه لإتمام الدورة مع تنزيل أسرع بكثير. -## دعم متعدد اللغات -### مدعوم عبر GitHub Action (مؤتمت ودائم التحديث) +## دعم لغات متعددة + +### مدعوم عبر GitHub Action (آلي وعلى الدوام محدث) -[العربية](./README.md) | [البنغالية](../bn/README.md) | [البلغارية](../bg/README.md) | [البورمية (ميانمار)](../my/README.md) | [الصينية (المبسطة)](../zh/README.md) | [الصينية (التقليدية، هونغ كونغ)](../hk/README.md) | [الصينية (التقليدية، ماكاو)](../mo/README.md) | [الصينية (التقليدية، تايوان)](../tw/README.md) | [الكرواتية](../hr/README.md) | [التشيكية](../cs/README.md) | [الدانمركية](../da/README.md) | [الهولندية](../nl/README.md) | [الإستونية](../et/README.md) | [الفنلندية](../fi/README.md) | [الفرنسية](../fr/README.md) | [الألمانية](../de/README.md) | [اليونانية](../el/README.md) | [العبرية](../he/README.md) | [الهندية](../hi/README.md) | [الهنغارية](../hu/README.md) | [الإندونيسية](../id/README.md) | [الإيطالية](../it/README.md) | [اليابانية](../ja/README.md) | [الكنادية](../kn/README.md) | [الكورية](../ko/README.md) | [الليتوانية](../lt/README.md) | [الماليزية](../ms/README.md) | [المالايالامية](../ml/README.md) | [الماراثية](../mr/README.md) | [النيبالية](../ne/README.md) | [بيبغة نيجيرية](../pcm/README.md) | [النرويجية](../no/README.md) | [الفارسية (اللغة الفارسية)](../fa/README.md) | [البولندية](../pl/README.md) | [البرتغالية (البرازيل)](../br/README.md) | [البرتغالية (البرتغال)](../pt/README.md) | [البنجابية (غورموخي)](../pa/README.md) | [الرومانية](../ro/README.md) | [الروسية](../ru/README.md) | [الصربية (السيريلية)](../sr/README.md) | [السلوفاكية](../sk/README.md) | [السلوفينية](../sl/README.md) | [الإسبانية](../es/README.md) | [السواحيلية](../sw/README.md) | [السويدية](../sv/README.md) | [التاغالوغ (الفلبينية)](../tl/README.md) | [التاميلية](../ta/README.md) | [التيلوجو](../te/README.md) | [التايلاندية](../th/README.md) | [التركية](../tr/README.md) | [الأوكرانية](../uk/README.md) | [الأردية](../ur/README.md) | [الفيتنامية](../vi/README.md) +[العربية](./README.md) | [البنغالية](../bn/README.md) | [البلغارية](../bg/README.md) | [البورمية (ميانمار)](../my/README.md) | [الصينية (مبسطة)](../zh-CN/README.md) | [الصينية (تقليدية، هونغ كونغ)](../zh-HK/README.md) | [الصينية (تقليدية، ماكاو)](../zh-MO/README.md) | [الصينية (تقليدية، تايوان)](../zh-TW/README.md) | [الكرواتية](../hr/README.md) | [التشيكية](../cs/README.md) | [الدنماركية](../da/README.md) | [الهولندية](../nl/README.md) | [الإستونية](../et/README.md) | [الفنلندية](../fi/README.md) | [الفرنسية](../fr/README.md) | [الألمانية](../de/README.md) | [اليونانية](../el/README.md) | [العبرية](../he/README.md) | [الهندية](../hi/README.md) | [الهنغارية](../hu/README.md) | [الإندونيسية](../id/README.md) | [الإيطالية](../it/README.md) | [اليابانية](../ja/README.md) | [الكانادا](../kn/README.md) | [الكورية](../ko/README.md) | [الليتوانية](../lt/README.md) | [الماليزية](../ms/README.md) | [المالايالامية](../ml/README.md) | [الماراثية](../mr/README.md) | [النيبالية](../ne/README.md) | [نيجيريان بيدجين](../pcm/README.md) | [النرويجية](../no/README.md) | [الفارسية (اللغة الفارسية)](../fa/README.md) | [البولندية](../pl/README.md) | [البرتغالية (البرازيل)](../pt-BR/README.md) | [البرتغالية (البرتغال)](../pt-PT/README.md) | [البنجابية (جرموخي)](../pa/README.md) | [الرومانية](../ro/README.md) | [الروسية](../ru/README.md) | [الصربية (السيريلية)](../sr/README.md) | [السلوفاكية](../sk/README.md) | [السلوفينية](../sl/README.md) | [الإسبانية](../es/README.md) | [السواحيلية](../sw/README.md) | [السويدية](../sv/README.md) | [التاغالوغية (الفلبينية)](../tl/README.md) | [التاميلية](../ta/README.md) | [التيلوغو](../te/README.md) | [التايلاندية](../th/README.md) | [التركية](../tr/README.md) | [الأوكرانية](../uk/README.md) | [الأردية](../ur/README.md) | [الفيتنامية](../vi/README.md) -> **هل تفضل الاستنساخ محليًا؟** +> **تفضل النسخ محليًا؟** -> يتضمن هذا المستودع أكثر من 50 ترجمة للغات مما يزيد بشكل كبير من حجم التنزيل. للاستنساخ بدون الترجمات، استخدم الاستنساخ الجزئي: +> يحتوي هذا المستودع على أكثر من 50 ترجمة لغة مما يزيد بشكل كبير حجم التنزيل. لاستنساخ دون الترجمات، استخدم الاستنساخ الجزئي: > ```bash > git clone --filter=blob:none --sparse https://github.com/microsoft/Generative-AI-for-beginners-java.git > cd Generative-AI-for-beginners-java > git sparse-checkout set --no-cone '/*' '!translations' '!translated_images' > ``` -> هذا يمنحك كل ما تحتاجه لإكمال الدورة بتنزيل أسرع بكثير. +> هذا يمنحك كل ما تحتاجه لإتمام الدورة مع تنزيل أسرع بكثير. ## هيكل الدورة ومسار التعلم ### **الفصل 1: مقدمة في الذكاء الاصطناعي التوليدي** -- **المفاهيم الأساسية**: فهم نماذج اللغات الكبيرة، الرموز المميزة، التضمينات، وقدرات الذكاء الاصطناعي -- **بيئة الذكاء الاصطناعي في جافا**: نظرة عامة على Spring AI و OpenAI SDKs -- **بروتوكول سياق النموذج**: مقدمة عن MCP ودوره في تواصل وكلاء الذكاء الاصطناعي -- **تطبيقات عملية**: سيناريوهات واقعية تشمل الدردشات وتوليد المحتوى -- **[→ بدء الفصل 1](./01-IntroToGenAI/README.md)** +- **المفاهيم الأساسية**: فهم نماذج اللغة الكبيرة، الرموز، التضمينات، وقدرات الذكاء الاصطناعي +- **نظام الذكاء الاصطناعي في جافا**: نظرة عامة على Spring AI وOpenAI SDKs +- **بروتوكول سياق النموذج**: مقدمة في MCP ودوره في تواصل وكلاء الذكاء الاصطناعي +- **التطبيقات العملية**: سيناريوهات العالم الحقيقي بما في ذلك روبوتات الدردشة وتوليد المحتوى +- **[→ ابدأ الفصل 1](./01-IntroToGenAI/README.md)** ### **الفصل 2: إعداد بيئة التطوير** -- **تكوين مزود متعدد**: إعداد نماذج GitHub، Azure OpenAI، وتكاملات OpenAI Java SDK +- **تكوين متعدد المزودين**: إعداد نماذج GitHub وAzure OpenAI وOpenAI Java SDK - **Spring Boot + Spring AI**: أفضل الممارسات لتطوير تطبيقات الذكاء الاصطناعي للمؤسسات -- **نماذج GitHub**: وصول مجاني لنماذج الذكاء الاصطناعي للنمذجة الأولية والتعلم (لا تحتاج بطاقة ائتمان) -- **أدوات التطوير**: حاويات Docker، VS Code، وتكوين GitHub Codespaces -- **[→ بدء الفصل 2](./02-SetupDevEnvironment/README.md)** +- **نماذج GitHub**: وصول مجاني لنماذج الذكاء الاصطناعي للنماذج الأولية والتعلم (بدون بطاقة ائتمان) +- **أدوات التطوير**: حاويات Docker، VS Code، وإعداد GitHub Codespaces +- **[→ ابدأ الفصل 2](./02-SetupDevEnvironment/README.md)** ### **الفصل 3: تقنيات الذكاء الاصطناعي التوليدي الأساسية** -- **هندسة المطالبات**: تقنيات لتحقيق أفضل استجابات لنماذج الذكاء الاصطناعي -- **التضمينات وعمليات المتجهات**: تطبيق البحث الدلالي ومطابقة التشابه -- **التوليد المعزز بالاسترجاع (RAG)**: دمج الذكاء الاصطناعي مع مصادر بياناتك الخاصة -- **استدعاء الدوال**: توسيع قدرات الذكاء الاصطناعي بأدوات وإضافات مخصصة -- **[→ بدء الفصل 3](./03-CoreGenerativeAITechniques/README.md)** +- **هندسة الموجهات**: تقنيات للحصول على استجابات مثالية من نماذج الذكاء الاصطناعي +- **التضمينات والعمليات الموجهة**: تنفيذ البحث الدلالي ومطابقة التشابه +- **التوليد المدعوم بالاستخراج (RAG)**: دمج الذكاء الاصطناعي مع مصادر بياناتك الخاصة +- **استدعاء الوظائف**: توسيع قدرات الذكاء الاصطناعي بأدوات وإضافات مخصصة +- **[→ ابدأ الفصل 3](./03-CoreGenerativeAITechniques/README.md)** ### **الفصل 4: التطبيقات العملية والمشاريع** - **مولد قصص الحيوانات الأليفة** (`petstory/`): توليد محتوى إبداعي باستخدام نماذج GitHub -- **عرض Foundry محلي** (`foundrylocal/`): دمج نموذج الذكاء الاصطناعي المحلي مع OpenAI Java SDK -- **خدمة آلة حاسبة MCP** (`calculator/`): تطبيق أساسي لبروتوكول سياق النموذج مع Spring AI -- **[→ بدء الفصل 4](./04-PracticalSamples/README.md)** +- **عرض Foundry المحلي** (`foundrylocal/`): دمج نموذج الذكاء الاصطناعي المحلي باستخدام OpenAI Java SDK +- **خدمة حاسبة MCP** (`calculator/`): تنفيذ أساسي لبروتوكول سياق النموذج باستخدام Spring AI +- **[→ ابدأ الفصل 4](./04-PracticalSamples/README.md)** ### **الفصل 5: تطوير الذكاء الاصطناعي المسؤول** -- **أمان نماذج GitHub**: اختبار آليات تصفية المحتوى والسلامة المدمجة (الكتل الصارمة والرفض اللين) -- **عرض للذكاء الاصطناعي المسؤول**: مثال عملي يوضح كيف تعمل أنظمة الأمان الحديثة في الذكاء الاصطناعي +- **سلامة نماذج GitHub**: اختبار آليات تصفية المحتوى والسلامة المدمجة (الحجب الصارم والرفض اللين) +- **عرض الذكاء الاصطناعي المسؤول**: مثال عملي يوضح كيفية عمل أنظمة السلامة الحديثة للذكاء الاصطناعي - **أفضل الممارسات**: إرشادات أساسية لتطوير ونشر الذكاء الاصطناعي الأخلاقي -- **[→ بدء الفصل 5](./05-ResponsibleGenAI/README.md)** +- **[→ ابدأ الفصل 5](./05-ResponsibleGenAI/README.md)** ## موارد إضافية @@ -95,11 +87,11 @@ CO_OP_TRANSLATOR_METADATA: --- -### Azure / Edge / MCP / Agents +### Azure / Edge / MCP / الوكلاء [![AZD للمبتدئين](https://img.shields.io/badge/AZD%20for%20Beginners-0078D4?style=for-the-badge&labelColor=E5E7EB&color=0078D4)](https://github.com/microsoft/AZD-for-beginners?WT.mc_id=academic-105485-koreyst) [![Edge AI للمبتدئين](https://img.shields.io/badge/Edge%20AI%20for%20Beginners-00B8E4?style=for-the-badge&labelColor=E5E7EB&color=00B8E4)](https://github.com/microsoft/edgeai-for-beginners?WT.mc_id=academic-105485-koreyst) [![MCP للمبتدئين](https://img.shields.io/badge/MCP%20for%20Beginners-009688?style=for-the-badge&labelColor=E5E7EB&color=009688)](https://github.com/microsoft/mcp-for-beginners?WT.mc_id=academic-105485-koreyst) -[![وكلاء الذكاء الاصطناعي للمبتدئين](https://img.shields.io/badge/AI%20Agents%20for%20Beginners-00C49A?style=for-the-badge&labelColor=E5E7EB&color=00C49A)](https://github.com/microsoft/ai-agents-for-beginners?WT.mc_id=academic-105485-koreyst) +[![الوكلاء الذكاء الاصطناعي للمبتدئين](https://img.shields.io/badge/AI%20Agents%20for%20Beginners-00C49A?style=for-the-badge&labelColor=E5E7EB&color=00C49A)](https://github.com/microsoft/ai-agents-for-beginners?WT.mc_id=academic-105485-koreyst) --- @@ -113,34 +105,35 @@ CO_OP_TRANSLATOR_METADATA: ### التعلم الأساسي [![تعلم الآلة للمبتدئين](https://img.shields.io/badge/ML%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=22C55E)](https://aka.ms/ml-beginners?WT.mc_id=academic-105485-koreyst) -[![علم البيانات للمبتدئين](https://img.shields.io/badge/Data%20Science%20for%20Beginners-84CC16?style=for-the-badge&labelColor=E5E7EB&color=84CC16)](https://aka.ms/datascience-beginners?WT.mc_id=academic-105485-koreyst) +[![علوم البيانات للمبتدئين](https://img.shields.io/badge/Data%20Science%20for%20Beginners-84CC16?style=for-the-badge&labelColor=E5E7EB&color=84CC16)](https://aka.ms/datascience-beginners?WT.mc_id=academic-105485-koreyst) [![الذكاء الاصطناعي للمبتدئين](https://img.shields.io/badge/AI%20for%20Beginners-A3E635?style=for-the-badge&labelColor=E5E7EB&color=A3E635)](https://aka.ms/ai-beginners?WT.mc_id=academic-105485-koreyst) [![الأمن السيبراني للمبتدئين](https://img.shields.io/badge/Cybersecurity%20for%20Beginners-F97316?style=for-the-badge&labelColor=E5E7EB&color=F97316)](https://github.com/microsoft/Security-101?WT.mc_id=academic-96948-sayoung) + [![تطوير الويب للمبتدئين](https://img.shields.io/badge/Web%20Dev%20for%20Beginners-EC4899?style=for-the-badge&labelColor=E5E7EB&color=EC4899)](https://aka.ms/webdev-beginners?WT.mc_id=academic-105485-koreyst) [![إنترنت الأشياء للمبتدئين](https://img.shields.io/badge/IoT%20for%20Beginners-14B8A6?style=for-the-badge&labelColor=E5E7EB&color=14B8A6)](https://aka.ms/iot-beginners?WT.mc_id=academic-105485-koreyst) -[![تطوير الواقع الممتد للمبتدئين](https://img.shields.io/badge/XR%20Development%20for%20Beginners-38BDF8?style=for-the-badge&labelColor=E5E7EB&color=38BDF8)](https://github.com/microsoft/xr-development-for-beginners?WT.mc_id=academic-105485-koreyst) +[![تطوير XR للمبتدئين](https://img.shields.io/badge/XR%20Development%20for%20Beginners-38BDF8?style=for-the-badge&labelColor=E5E7EB&color=38BDF8)](https://github.com/microsoft/xr-development-for-beginners?WT.mc_id=academic-105485-koreyst) --- -### سلسلة كوبايلوت -[![كوبايلوت للبرمجة الزوجية بالذكاء الاصطناعي](https://img.shields.io/badge/Copilot%20for%20AI%20Paired%20Programming-FACC15?style=for-the-badge&labelColor=E5E7EB&color=FACC15)](https://aka.ms/GitHubCopilotAI?WT.mc_id=academic-105485-koreyst) -[![كوبايلوت لـ C#/.NET](https://img.shields.io/badge/Copilot%20for%20C%23/.NET-FBBF24?style=for-the-badge&labelColor=E5E7EB&color=FBBF24)](https://github.com/microsoft/mastering-github-copilot-for-dotnet-csharp-developers?WT.mc_id=academic-105485-koreyst) -[![مغامرات كوبايلوت](https://img.shields.io/badge/Copilot%20Adventure-FDE68A?style=for-the-badge&labelColor=E5E7EB&color=FDE68A)](https://github.com/microsoft/CopilotAdventures?WT.mc_id=academic-105485-koreyst) +### سلسلة المساعد +[![المساعد للبرمجة المزدوجة بالذكاء الاصطناعي](https://img.shields.io/badge/Copilot%20for%20AI%20Paired%20Programming-FACC15?style=for-the-badge&labelColor=E5E7EB&color=FACC15)](https://aka.ms/GitHubCopilotAI?WT.mc_id=academic-105485-koreyst) +[![المساعد لـ C#/.NET](https://img.shields.io/badge/Copilot%20for%20C%23/.NET-FBBF24?style=for-the-badge&labelColor=E5E7EB&color=FBBF24)](https://github.com/microsoft/mastering-github-copilot-for-dotnet-csharp-developers?WT.mc_id=academic-105485-koreyst) +[![مغامرة المساعد](https://img.shields.io/badge/Copilot%20Adventure-FDE68A?style=for-the-badge&labelColor=E5E7EB&color=FDE68A)](https://github.com/microsoft/CopilotAdventures?WT.mc_id=academic-105485-koreyst) ## الحصول على المساعدة -إذا واجهت صعوبة أو كان لديك أي أسئلة حول بناء تطبيقات الذكاء الاصطناعي. انضم إلى المتعلمين الآخرين والمطورين ذوي الخبرة في مناقشات حول MCP. إنها مجتمع داعم حيث الأسئلة مرحب بها والمعرفة تُشارك بحرية. +إذا واجهت صعوبة أو كان لديك أي أسئلة حول بناء تطبيقات الذكاء الاصطناعي. انضم إلى المتعلمين الآخرين والمطورين ذوي الخبرة في مناقشات حول MCP. إنها مجتمع داعم حيث تُرحب الأسئلة وتُشارك المعرفة بحرية. -[![مايكروسوفت فاوندري ديسكورد](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) +[![خادم Discord لمايكروسوفت فاوندري](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) -إذا كان لديك ملاحظات عن المنتج أو أخطاء أثناء البناء قم بزيارة: +إذا كان لديك ملاحظات على المنتج أو أخطاء أثناء التطوير، قم بزيارة: -[![منتدى مطوري مايكروسوفت فاوندري](https://img.shields.io/badge/GitHub-Microsoft_Foundry_Developer_Forum-blue?style=for-the-badge&logo=github&color=000000&logoColor=fff)](https://aka.ms/foundry/forum) +[![منتدى مطوري مايكروسوفت فاوندري على GitHub](https://img.shields.io/badge/GitHub-Microsoft_Foundry_Developer_Forum-blue?style=for-the-badge&logo=github&color=000000&logoColor=fff)](https://aka.ms/foundry/forum) --- -**تنويه**: -تمت ترجمة هذا المستند باستخدام خدمة الترجمة الآلية [Co-op Translator](https://github.com/Azure/co-op-translator). بينما نسعى لتحقيق الدقة، يرجى العلم أن الترجمات الآلية قد تحتوي على أخطاء أو عدم دقة. يجب اعتبار النسخة الأصلية من المستند بلغتها الأصلية المصدر المرجعي والصحيح. بالنسبة للمعلومات الحرجة، يُنصح بالاستعانة بترجمة بشرية محترفة. نحن غير مسؤولين عن أي سوء فهم أو تفسير خاطئ ناتج عن استخدام هذه الترجمة. +**إخلاء المسؤولية**: +تمت ترجمة هذا المستند باستخدام خدمة الترجمة الآلية [Co-op Translator](https://github.com/Azure/co-op-translator). بينما نسعى للدقة، يرجى العلم أن الترجمات الآلية قد تحتوي على أخطاء أو عدم دقة. يجب اعتبار المستند الأصلي بلغته الأصلية المصدر الموثوق والمعتمد. للمعلومات الهامة، يُنصح بالاعتماد على الترجمة الاحترافية البشرية. نحن غير مسؤولين عن أي سوء فهم أو تفسيرات خاطئة ناتجة عن استخدام هذه الترجمة. \ No newline at end of file diff --git a/translations/ar/SECURITY.md b/translations/ar/SECURITY.md index 6d9a79cf..7f93df89 100644 --- a/translations/ar/SECURITY.md +++ b/translations/ar/SECURITY.md @@ -1,12 +1,3 @@ - ## الأمان تأخذ Microsoft أمان منتجاتنا وخدماتنا البرمجية على محمل الجد، بما في ذلك جميع مستودعات الشيفرة المصدرية التي تُدار من خلال منظماتنا على GitHub، والتي تشمل [Microsoft](https://github.com/Microsoft)، [Azure](https://github.com/Azure)، [DotNet](https://github.com/dotnet)، [AspNet](https://github.com/aspnet) و[Xamarin](https://github.com/xamarin). diff --git a/translations/ar/SUPPORT.md b/translations/ar/SUPPORT.md index d7de044e..38204217 100644 --- a/translations/ar/SUPPORT.md +++ b/translations/ar/SUPPORT.md @@ -1,12 +1,3 @@ - # الدعم ## كيفية الإبلاغ عن المشكلات والحصول على المساعدة diff --git a/translations/bg/.co-op-translator.json b/translations/bg/.co-op-translator.json new file mode 100644 index 00000000..258f6dfc --- /dev/null +++ b/translations/bg/.co-op-translator.json @@ -0,0 +1,92 @@ +{ + "01-IntroToGenAI/README.md": { + "original_hash": "75bfb080ca725e8a9aa9c80cae25fba1", + "translation_date": "2025-07-29T10:13:19+00:00", + "source_file": "01-IntroToGenAI/README.md", + "language_code": "bg" + }, + "02-SetupDevEnvironment/README.md": { + "original_hash": "96a30d42b9751a3d4e4b20e28d29d459", + "translation_date": "2026-01-28T05:23:45+00:00", + "source_file": "02-SetupDevEnvironment/README.md", + "language_code": "bg" + }, + "02-SetupDevEnvironment/examples/basic-chat-azure/README.md": { + "original_hash": "efd82efe50711d7e257eb943151d682c", + "translation_date": "2025-07-27T13:47:21+00:00", + "source_file": "02-SetupDevEnvironment/examples/basic-chat-azure/README.md", + "language_code": "bg" + }, + "02-SetupDevEnvironment/getting-started-azure-openai.md": { + "original_hash": "bfdb4b4eadbee3a59ef742439f58326a", + "translation_date": "2025-07-27T13:27:05+00:00", + "source_file": "02-SetupDevEnvironment/getting-started-azure-openai.md", + "language_code": "bg" + }, + "03-CoreGenerativeAITechniques/README.md": { + "original_hash": "685f55cb07de19b52a30ce6e8b6d889e", + "translation_date": "2025-08-28T22:16:55+00:00", + "source_file": "03-CoreGenerativeAITechniques/README.md", + "language_code": "bg" + }, + "04-PracticalSamples/README.md": { + "original_hash": "14c0a61ecc1cd2012a9c129236dfdf71", + "translation_date": "2025-07-29T10:12:57+00:00", + "source_file": "04-PracticalSamples/README.md", + "language_code": "bg" + }, + "04-PracticalSamples/calculator/README.md": { + "original_hash": "b6c16b5514d524e415a94f6097ee7d4c", + "translation_date": "2025-09-18T15:40:37+00:00", + "source_file": "04-PracticalSamples/calculator/README.md", + "language_code": "bg" + }, + "04-PracticalSamples/foundrylocal/README.md": { + "original_hash": "f787307400de59adc25a1404466a35f3", + "translation_date": "2025-11-04T07:34:24+00:00", + "source_file": "04-PracticalSamples/foundrylocal/README.md", + "language_code": "bg" + }, + "04-PracticalSamples/petstory/README.md": { + "original_hash": "0cbf68d605615a1e602c832a24616859", + "translation_date": "2025-07-25T11:59:33+00:00", + "source_file": "04-PracticalSamples/petstory/README.md", + "language_code": "bg" + }, + "05-ResponsibleGenAI/README.md": { + "original_hash": "301c05c2f57e60a6950b8c665b8bdbba", + "translation_date": "2025-07-29T15:59:23+00:00", + "source_file": "05-ResponsibleGenAI/README.md", + "language_code": "bg" + }, + "AGENTS.md": { + "original_hash": "afc90918d008cf77fd1982691f681306", + "translation_date": "2025-10-03T08:43:49+00:00", + "source_file": "AGENTS.md", + "language_code": "bg" + }, + "CODE_OF_CONDUCT.md": { + "original_hash": "442b123d034f92f7c384d2bbd28f99f1", + "translation_date": "2025-07-21T20:37:45+00:00", + "source_file": "CODE_OF_CONDUCT.md", + "language_code": "bg" + }, + "README.md": { + "original_hash": "125a08948d881c95628094f4dd1fbd43", + "translation_date": "2026-01-29T16:12:20+00:00", + "source_file": "README.md", + "language_code": "bg" + }, + "SECURITY.md": { + "original_hash": "57f14126c1c6add76b3aef3844dfe4e3", + "translation_date": "2025-07-21T20:35:49+00:00", + "source_file": "SECURITY.md", + "language_code": "bg" + }, + "SUPPORT.md": { + "original_hash": "b8ef73cc49dec68e2c885ee9df545129", + "translation_date": "2025-07-21T20:39:01+00:00", + "source_file": "SUPPORT.md", + "language_code": "bg" + } +} \ No newline at end of file diff --git a/translations/bg/01-IntroToGenAI/README.md b/translations/bg/01-IntroToGenAI/README.md index 687fad35..a3c5efa0 100644 --- a/translations/bg/01-IntroToGenAI/README.md +++ b/translations/bg/01-IntroToGenAI/README.md @@ -1,12 +1,3 @@ - # Въведение в Генеративния AI - Java издание ## Какво ще научите diff --git a/translations/bg/02-SetupDevEnvironment/README.md b/translations/bg/02-SetupDevEnvironment/README.md index 51dba5af..3960c23c 100644 --- a/translations/bg/02-SetupDevEnvironment/README.md +++ b/translations/bg/02-SetupDevEnvironment/README.md @@ -1,13 +1,254 @@ - +# Настройване на средата за разработка за Generative AI за Java +> **Бърз старт**: Програмирайте в облака за 2 минути - Отидете директно на [GitHub Codespaces Настройка](../../../02-SetupDevEnvironment) - не е необходима локална инсталация и използва модели на GitHub! + +> **Интересувате се от Azure OpenAI?**, вижте нашето [Ръководство за настройка на Azure OpenAI](getting-started-azure-openai.md) със стъпки за създаване на нов ресурс Azure OpenAI. + +## Какво ще научите + +- Настройване на среда за разработка на Java за AI приложения +- Избор и конфигуриране на предпочитаната среда за разработка (облачно първо с Codespaces, локален dev контейнер или пълна локална настройка) +- Тествайте вашата настройка чрез свързване с GitHub модели + +## Съдържание + +- [Какво ще научите](../../../02-SetupDevEnvironment) +- [Въведение](../../../02-SetupDevEnvironment) +- [Стъпка 1: Настройване на средата за разработка](../../../02-SetupDevEnvironment) + - [Опция A: GitHub Codespaces (Препоръчително)](../../../02-SetupDevEnvironment) + - [Опция B: Локален Dev Container](../../../02-SetupDevEnvironment) + - [Опция C: Използвайте съществуващата си локална инсталация](../../../02-SetupDevEnvironment) +- [Стъпка 2: Създаване на персонален токен за достъп до GitHub](../../../02-SetupDevEnvironment) +- [Стъпка 3: Тествайте настройката си](../../../02-SetupDevEnvironment) +- [Отстраняване на неизправности](../../../02-SetupDevEnvironment) +- [Обобщение](../../../02-SetupDevEnvironment) +- [Следващи стъпки](../../../02-SetupDevEnvironment) + +## Въведение + +Тази глава ще ви преведе през настройването на среда за разработка. Ще използваме **GitHub модели** като основен пример, защото са безплатни, лесни за настройка с просто GitHub акаунт, не изискват кредитна карта и предоставят достъп до множество модели за експериментиране. + +**Не е необходимо локално настройване!** Можете да започнете да кодирате веднага, използвайки GitHub Codespaces, които предоставят пълна среда за разработка в браузъра ви. + +Екранна снимка: GitHub модели + +Препоръчваме да използвате [**GitHub модели**](https://github.com/marketplace?type=models) за този курс, защото те са: +- **Безплатни** за начало +- **Лесни** за настройка само с GitHub акаунт +- **Без кредитна карта** необходима +- **Налични множество модели** за експериментиране + +> **Забележка**: GitHub моделите, използвани в това обучение, имат следните безплатни ограничения: +> - 15 заявки в минута (150 на ден) +> - ~8,000 думи вход, ~4,000 думи изход на заявка +> - 5 паралелни заявки +> +> За продуктивна употреба, надградете до Azure AI Foundry модели с вашия Azure акаунт. Вашият код не трябва да се променя. Вижте документацията на [Azure AI Foundry](https://learn.microsoft.com/azure/ai-foundry/foundry-models/how-to/quickstart-github-models). + + +## Стъпка 1: Настройване на средата за разработка + + + +Създадохме предварително конфигуриран контейнер за разработка, за да минимизираме времето за настройка и да сме сигурни, че имате всички необходими инструменти за този курс Generative AI за Java. Изберете предпочитаната среда за разработка: + +### Опции за настройка на средата: + +#### Опция A: GitHub Codespaces (Препоръчително) + +**Започнете програмирането за 2 минути - не е нужна локална инсталация!** + +1. Форкнете това хранилище в своя GitHub акаунт + > **Забележка**: Ако желаете да редактирате базовата конфигурация, разгледайте [Dev Container Configuration](../../../.devcontainer/devcontainer.json) +2. Кликнете **Code** → раздела **Codespaces** → **...** → **New with options...** +3. Използвайте настройките по подразбиране – това ще избере **Dev container конфигурация**: **Generative AI Java Development Environment** персонализиран devcontainer, създаден за този курс +4. Кликнете **Create codespace** +5. Изчакайте около 2 минути за зареждане на средата +6. Продължете към [Стъпка 2: Създаване на GitHub токен](../../../02-SetupDevEnvironment) + +Екранна снимка: Codespaces подменю + +Екранна снимка: New with options + +Екранна снимка: Опции за създаване на codespace + + +> **Предимства на Codespaces**: +> - Не е необходима локална инсталация +> - Работи на всяко устройство с браузър +> - Предварително конфигурирана с всички необходими инструменти и зависимости +> - Безплатно 60 часа месечно за лични акаунти +> - Консистентна среда за всички участници + +#### Опция B: Локален Dev Container + +**За разработчици, които предпочитат локална разработка с Docker** + +1. Форкнете и клонирайте това хранилище на своя локален компютър + > **Забележка**: Ако желаете да редактирате базовата конфигурация, разгледайте [Dev Container Configuration](../../../.devcontainer/devcontainer.json) +2. Инсталирайте [Docker Desktop](https://www.docker.com/products/docker-desktop/) и [VS Code](https://code.visualstudio.com/) +3. Инсталирайте [разширението Dev Containers](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers) в VS Code +4. Отворете папката с репозитория в VS Code +5. При подканване кликнете **Reopen in Container** (или използвайте `Ctrl+Shift+P` → "Dev Containers: Reopen in Container") +6. Изчакайте контейнерът да се изгради и стартира +7. Продължете към [Стъпка 2: Създаване на GitHub токен](../../../02-SetupDevEnvironment) + +Екранна снимка: Настройка на dev контейнер + +Екранна снимка: Край на билд на dev контейнер + +#### Опция C: Използвайте съществуващата си локална инсталация + +**За разработчици със съществуващи Java среди** + +Предпоставки: +- [Java 21+](https://www.oracle.com/java/technologies/javase/jdk21-archive-downloads.html) +- [Maven 3.9+](https://maven.apache.org/download.cgi) +- [VS Code](https://code.visualstudio.com) или предпочитаната IDE + +Стъпки: +1. Клонирайте това хранилище на локалния си компютър +2. Отворете проекта в IDE-то си +3. Продължете към [Стъпка 2: Създаване на GitHub токен](../../../02-SetupDevEnvironment) + +> **Професионален съвет**: Ако имате слаба машина, но искате локално VS Code, използвайте GitHub Codespaces! Можете да свържете локалния си VS Code с хостнат в облака Codespace за най-доброто от двата свята. + +Екранна снимка: Създаден локален devcontainer инстанс + + +## Стъпка 2: Създаване на персонален токен за достъп до GitHub + +1. Отидете на [GitHub Settings](https://github.com/settings/profile) и изберете **Settings** от менюто в профила си. +2. В лявата странична лента кликнете **Developer settings** (обикновено в дъното). +3. Под **Personal access tokens** кликнете **Fine-grained tokens** (или следвайте този директен [линк](https://github.com/settings/personal-access-tokens)). +4. Кликнете **Generate new token**. +5. Под "Token name" въведете описателно име (например `GenAI-Java-Course-Token`). +6. Задайте дата на изтичане (препоръчително: 7 дни за най-добра практика по сигурност). +7. Под "Resource owner" изберете своя потребителски акаунт. +8. Под "Repository access" изберете репозиториите, с които искате да използвате GitHub модели (или "All repositories" ако е необходимо). +9. Под "Account permissions" намерете **Models** и задайте **Read-only**. +10. Кликнете **Generate token**. +11. **Копирайте и запазете токена веднага** – няма да го видите отново! + +> **Съвет за сигурност**: Използвайте минималния необходим обхват и най-краткия практически период на валидност за вашите токени. + +## Стъпка 3: Тествайте настройката си с примера на GitHub модели + +След като средата за разработка е готова, нека тестваем интеграцията с GitHub модели с нашето примерното приложение в [`02-SetupDevEnvironment/examples/github-models`](../../../02-SetupDevEnvironment/examples/github-models). + +1. Отворете терминала в средата си за разработка. +2. Отидете в примерната папка за GitHub модели: + ```bash + cd 02-SetupDevEnvironment/examples/github-models + ``` +3. Задайте своя GitHub токен като променлива на средата: + ```bash + # macOS/Linux + export GITHUB_TOKEN=your_token_here + + # Windows (Команден ред) + set GITHUB_TOKEN=your_token_here + + # Windows (PowerShell) + $env:GITHUB_TOKEN="your_token_here" + ``` + +4. Стартирайте приложението: + ```bash + mvn compile exec:java -Dexec.mainClass="com.example.githubmodels.App" + ``` + +Трябва да видите изход, подобен на: +```text +Using model: gpt-4.1-nano +Sending request to GitHub Models... +Response: Hello World! +``` + +### Разбиране на примерния код + +Първо, нека разберем какво тъкмо стартирахме. Примерът в `examples/github-models` използва OpenAI Java SDK за връзка с GitHub модели: + +**Какво прави този код:** +- **Свързва се** с GitHub модели, използвайки вашия персонален токен за достъп +- **Изпраща** просто съобщение "Say Hello World!" до AI модела +- **Получава** и показва отговора от AI +- **Проверява** дали вашата настройка работи правилно + +**Ключова зависимост** (в `pom.xml`): +```xml + + com.openai + openai-java + 2.12.0 + +``` + +**Основен код** (`App.java`): +```java +// Свържете се с GitHub модели, използвайки OpenAI Java SDK +OpenAIClient client = OpenAIOkHttpClient.builder() + .apiKey(pat) + .baseUrl("https://models.inference.ai.azure.com") + .build(); + +// Създайте заявка за допълване на чат +ChatCompletionCreateParams params = ChatCompletionCreateParams.builder() + .model(modelId) + .addSystemMessage("You are a concise assistant.") + .addUserMessage("Say Hello World!") + .build(); + +// Получете AI отговор +ChatCompletion response = client.chat().completions().create(params); +System.out.println("Response: " + response.choices().get(0).message().content().orElse("No response content")); +``` + +## Обобщение + +Страхотно! Вече имате всичко настроено: + +- Създаден GitHub персонален токен с правилните разрешения за достъп до AI моделите +- Вашата Java среда за разработка работи (било то Codespaces, dev контейнер или локална) +- Свързахте се с GitHub модели с помощта на OpenAI Java SDK за безплатна AI разработка +- Тествали сте всичко с прост пример, който комуникира с AI модели + +## Следващи стъпки + +[Глава 3: Основни техники в Generative AI](../03-CoreGenerativeAITechniques/README.md) + +## Отстраняване на неизправности + +Имаме проблеми? Ето често срещани проблеми и решения: + +- **Токенът не работи?** + - Уверете се, че сте копирали целия токен без допълнителни интервали + - Проверете дали токенът е правилно зададен като променлива на средата + - Уверете се, че токенът има правилните разрешения (Models: Read-only) + +- **Maven не е намерен?** + - Ако използвате dev контейнери/Codespaces, Maven трябва да е предварително инсталиран + - За локална настройка, уверете се, че имате инсталирани Java 21+ и Maven 3.9+ + - Изпълнете `mvn --version` за проверка на инсталацията + +- **Проблеми с връзката?** + - Проверете интернет връзката си + - Убедете се, че GitHub е достъпен от вашата мрежа + - Уверете се, че не сте зад защитна стена, блокираща крайни точки на GitHub модели + +- **Dev контейнерът не се стартира?** + - Уверете се, че Docker Desktop работи (за локална разработка) + - Опитайте да пресъздадете контейнера: `Ctrl+Shift+P` → "Dev Containers: Rebuild Container" + +- **Грешки при компилация на приложението?** + - Убедете се, че сте в правилната директория: `02-SetupDevEnvironment/examples/github-models` + - Опитайте да почистите и компилирате отново: `mvn clean compile` + +> **Нуждаете се от помощ?**: Още имате проблеми? Отворете issue в хранилището и ние ще ви помогнем. --- + +**Отказ от отговорност**: +Този документ е преведен с помощта на AI преводаческа услуга [Co-op Translator](https://github.com/Azure/co-op-translator). Въпреки че се стремим към точност, моля имайте предвид, че автоматизираните преводи могат да съдържат грешки или неточности. Оригиналният документ на неговия изходен език трябва да се счита за авторитетен източник. За критична информация се препоръчва професионален човешки превод. Ние не носим отговорност за никакви недоразумения или погрешни тълкувания, възникнали в резултат на използването на този превод. + \ No newline at end of file diff --git a/translations/bg/02-SetupDevEnvironment/examples/basic-chat-azure/README.md b/translations/bg/02-SetupDevEnvironment/examples/basic-chat-azure/README.md index 353a73cc..28875305 100644 --- a/translations/bg/02-SetupDevEnvironment/examples/basic-chat-azure/README.md +++ b/translations/bg/02-SetupDevEnvironment/examples/basic-chat-azure/README.md @@ -1,12 +1,3 @@ - # Основен чат с Azure OpenAI - Пример от край до край Този пример демонстрира как да създадете проста Spring Boot апликация, която се свързва с Azure OpenAI и тества вашата конфигурация. diff --git a/translations/bg/02-SetupDevEnvironment/getting-started-azure-openai.md b/translations/bg/02-SetupDevEnvironment/getting-started-azure-openai.md index 82ffa9a5..b194a1e6 100644 --- a/translations/bg/02-SetupDevEnvironment/getting-started-azure-openai.md +++ b/translations/bg/02-SetupDevEnvironment/getting-started-azure-openai.md @@ -1,12 +1,3 @@ - # Настройване на среда за разработка за Azure OpenAI > **Бърз старт**: Това ръководство е за настройка на Azure OpenAI. За незабавен старт с безплатни модели, използвайте [GitHub Models with Codespaces](./README.md#quick-start-cloud). diff --git a/translations/bg/03-CoreGenerativeAITechniques/README.md b/translations/bg/03-CoreGenerativeAITechniques/README.md index 69fbfa20..b1727e3a 100644 --- a/translations/bg/03-CoreGenerativeAITechniques/README.md +++ b/translations/bg/03-CoreGenerativeAITechniques/README.md @@ -1,12 +1,3 @@ - # Основни техники за генериращ ИИ - Урок ## Съдържание diff --git a/translations/bg/04-PracticalSamples/README.md b/translations/bg/04-PracticalSamples/README.md index e16d0b5d..4ded7fb9 100644 --- a/translations/bg/04-PracticalSamples/README.md +++ b/translations/bg/04-PracticalSamples/README.md @@ -1,12 +1,3 @@ - # Практически приложения и проекти ## Какво ще научите diff --git a/translations/bg/04-PracticalSamples/calculator/README.md b/translations/bg/04-PracticalSamples/calculator/README.md index 8197e60c..0de0a505 100644 --- a/translations/bg/04-PracticalSamples/calculator/README.md +++ b/translations/bg/04-PracticalSamples/calculator/README.md @@ -1,12 +1,3 @@ - # Урок за MCP калкулатор за начинаещи ## Съдържание diff --git a/translations/bg/04-PracticalSamples/foundrylocal/README.md b/translations/bg/04-PracticalSamples/foundrylocal/README.md index 441b85fa..25964336 100644 --- a/translations/bg/04-PracticalSamples/foundrylocal/README.md +++ b/translations/bg/04-PracticalSamples/foundrylocal/README.md @@ -1,12 +1,3 @@ - # Урок за Foundry Local Spring Boot ## Съдържание diff --git a/translations/bg/04-PracticalSamples/petstory/README.md b/translations/bg/04-PracticalSamples/petstory/README.md index 4ef941c3..3bc45920 100644 --- a/translations/bg/04-PracticalSamples/petstory/README.md +++ b/translations/bg/04-PracticalSamples/petstory/README.md @@ -1,12 +1,3 @@ - # Ръководство за начинаещи: Генератор на истории за домашни любимци ## Съдържание diff --git a/translations/bg/05-ResponsibleGenAI/README.md b/translations/bg/05-ResponsibleGenAI/README.md index 9aca5212..fe3c289d 100644 --- a/translations/bg/05-ResponsibleGenAI/README.md +++ b/translations/bg/05-ResponsibleGenAI/README.md @@ -1,12 +1,3 @@ - # Отговорен Генеративен AI ## Какво ще научите diff --git a/translations/bg/AGENTS.md b/translations/bg/AGENTS.md index 3eed6244..6523901b 100644 --- a/translations/bg/AGENTS.md +++ b/translations/bg/AGENTS.md @@ -1,12 +1,3 @@ - # AGENTS.md ## Преглед на проекта diff --git a/translations/bg/CODE_OF_CONDUCT.md b/translations/bg/CODE_OF_CONDUCT.md index 3a2d64ad..a8c47933 100644 --- a/translations/bg/CODE_OF_CONDUCT.md +++ b/translations/bg/CODE_OF_CONDUCT.md @@ -1,12 +1,3 @@ - # Кодекс за поведение на Microsoft за отворен код Този проект е приел [Кодекса за поведение на Microsoft за отворен код](https://opensource.microsoft.com/codeofconduct/). diff --git a/translations/bg/README.md b/translations/bg/README.md index d9f544eb..82f82ed3 100644 --- a/translations/bg/README.md +++ b/translations/bg/README.md @@ -1,27 +1,18 @@ - -# Генеративен изкуствен интелект за начинаещи - Java издание +# Генеративен AI за начинаещи - Java издание [![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) -![Генеративен изкуствен интелект за начинаещи - Java издание](../../translated_images/bg/beg-genai-series.8b48be9951cc574c.webp) +![Генеративен AI за начинаещи - Java издание](../../translated_images/bg/beg-genai-series.8b48be9951cc574c.webp) -**Време за ангажираност**: Целият семинар може да бъде завършен онлайн без локална настройка. Настройката на средата отнема 2 минути, като разглеждането на примерите изисква от 1 до 3 часа в зависимост от дълбочината на проучване. +**Времево задължение**: Целият уъркшоп може да бъде завършен онлайн без локална настройка. Настройката на средата отнема 2 минути, като разглеждането на примерите изисква от 1 до 3 часа в зависимост от дълбочината на изследване. -> **Бърз старт** +> **Бърз старт** -1. Форкнете това хранилище във вашия GitHub акаунт -2. Кликнете върху **Code** → раздел **Codespaces** → **...** → **New with options...** -3. Използвайте подразбиращите се настройки – това ще избере развойната контейнерна среда, създадена за този курс -4. Кликнете върху **Create codespace** -5. Изчакайте ~2 минути, докато средата бъде готова -6. Придвижете се директно към [Първия пример](./02-SetupDevEnvironment/README.md#step-2-create-a-github-personal-access-token) +1. Направете форк на това хранилище в своя GitHub акаунт +2. Кликнете **Code** → раздел **Codespaces** → **...** → **New with options...** +3. Използвайте подразбиращите се настройки – това ще избере Development контейнера, създаден за този курс +4. Кликнете **Create codespace** +5. Изчакайте около 2 минути, докато средата се подготви +6. Преминете директно към [Първия пример](./02-SetupDevEnvironment/README.md#step-2-create-a-github-personal-access-token) > **Предпочитате да клонирате локално?** > @@ -39,7 +30,7 @@ CO_OP_TRANSLATOR_METADATA: ### Поддържа се чрез GitHub Action (Автоматизирано и винаги актуално) -[Арабски](../ar/README.md) | [Бенгалски](../bn/README.md) | [Български](./README.md) | [Бирмански (Мианмар)](../my/README.md) | [Китайски (опростен)](../zh/README.md) | [Китайски (традиционен, Хонконг)](../hk/README.md) | [Китайски (традиционен, Макао)](../mo/README.md) | [Китайски (традиционен, Тайван)](../tw/README.md) | [Хърватски](../hr/README.md) | [Чешки](../cs/README.md) | [Датски](../da/README.md) | [Холандски](../nl/README.md) | [Естонски](../et/README.md) | [Фински](../fi/README.md) | [Френски](../fr/README.md) | [Немски](../de/README.md) | [Гръцки](../el/README.md) | [Иврит](../he/README.md) | [Хинди](../hi/README.md) | [Унгарски](../hu/README.md) | [Индонезийски](../id/README.md) | [Италиански](../it/README.md) | [Японски](../ja/README.md) | [Каннада](../kn/README.md) | [Корейски](../ko/README.md) | [Литовски](../lt/README.md) | [Малайски](../ms/README.md) | [Малаялам](../ml/README.md) | [Маратхи](../mr/README.md) | [Непалски](../ne/README.md) | [Нигерийски пиджин](../pcm/README.md) | [Норвежки](../no/README.md) | [Персийски (фарси)](../fa/README.md) | [Полски](../pl/README.md) | [Португалски (Бразилия)](../br/README.md) | [Португалски (Португалия)](../pt/README.md) | [Панджаби (Гурмукхи)](../pa/README.md) | [Румънски](../ro/README.md) | [Руски](../ru/README.md) | [Сръбски (кирилица)](../sr/README.md) | [Словашки](../sk/README.md) | [Словенски](../sl/README.md) | [Испански](../es/README.md) | [Суахили](../sw/README.md) | [Шведски](../sv/README.md) | [Тагалог (Филипински)](../tl/README.md) | [Тамилски](../ta/README.md) | [Телугу](../te/README.md) | [Тайски](../th/README.md) | [Турски](../tr/README.md) | [Украински](../uk/README.md) | [Урду](../ur/README.md) | [Виетнамски](../vi/README.md) +[Арабски](../ar/README.md) | [Бенгалски](../bn/README.md) | [Български](./README.md) | [Бирмански (Мианмар)](../my/README.md) | [Китайски (опростен)](../zh-CN/README.md) | [Китайски (традиционен, Хонг Конг)](../zh-HK/README.md) | [Китайски (традиционен, Макао)](../zh-MO/README.md) | [Китайски (традиционен, Тайван)](../zh-TW/README.md) | [Хърватски](../hr/README.md) | [Чешки](../cs/README.md) | [Датски](../da/README.md) | [Холандски](../nl/README.md) | [Естонски](../et/README.md) | [Фински](../fi/README.md) | [Френски](../fr/README.md) | [Немски](../de/README.md) | [Гръцки](../el/README.md) | [Иврит](../he/README.md) | [Хинди](../hi/README.md) | [Унгарски](../hu/README.md) | [Индонезийски](../id/README.md) | [Италиански](../it/README.md) | [Японски](../ja/README.md) | [Каннада](../kn/README.md) | [Корейски](../ko/README.md) | [Литовски](../lt/README.md) | [Малайски](../ms/README.md) | [Малаялам](../ml/README.md) | [Маратхи](../mr/README.md) | [Непалски](../ne/README.md) | [Нигерийски пиджин](../pcm/README.md) | [Норвежки](../no/README.md) | [Персийски (фарси)](../fa/README.md) | [Полски](../pl/README.md) | [Португалски (Бразилия)](../pt-BR/README.md) | [Португалски (Португалия)](../pt-PT/README.md) | [Панджаби (Гурумукхи)](../pa/README.md) | [Румънски](../ro/README.md) | [Руски](../ru/README.md) | [Сръбски (кирилица)](../sr/README.md) | [Словашки](../sk/README.md) | [Словенски](../sl/README.md) | [Испански](../es/README.md) | [Суахили](../sw/README.md) | [Шведски](../sv/README.md) | [Тагалог (Филипински)](../tl/README.md) | [Тамилски](../ta/README.md) | [Телугу](../te/README.md) | [Тайски](../th/README.md) | [Турски](../tr/README.md) | [Украински](../uk/README.md) | [Урду](../ur/README.md) | [Виетнамски](../vi/README.md) > **Предпочитате да клонирате локално?** @@ -54,37 +45,37 @@ CO_OP_TRANSLATOR_METADATA: ## Структура на курса и учебен път -### **Глава 1: Въведение в генеративния изкуствен интелект** -- **Основни понятия**: Разбиране на големи езикови модели, токени, вграждания и възможности на AI +### **Глава 1: Въведение в генеративния AI** +- **Основни понятия**: Разбиране на големи езикови модели, токени, embeddings и възможности на AI - **Java AI екосистема**: Преглед на Spring AI и OpenAI SDK -- **Протокол за контекст на моделите**: Въведение в MCP и ролята му в комуникацията на AI агенти -- **Практически приложения**: Реални сценарии включително чатботове и генериране на съдържание +- **Протокол за контекста на модела**: Въведение в MCP и ролята му в комуникацията между AI агенти +- **Практически приложения**: Реални сценарии, включително чатботове и генериране на съдържание - **[→ Започнете Глава 1](./01-IntroToGenAI/README.md)** -### **Глава 2: Настройка на развойна среда** -- **Множество доставчици**: Настройка на GitHub Models, Azure OpenAI и OpenAI Java SDK интеграции +### **Глава 2: Настройка на средата за разработка** +- **Много доставчици**: Настройка на GitHub Models, Azure OpenAI и OpenAI Java SDK интеграции - **Spring Boot + Spring AI**: Най-добри практики за разработка на корпоративни AI приложения -- **GitHub Models**: Безплатен достъп до AI модели за прототипиране и обучение (без нужда от кредитна карта) -- **Инструменти за разработка**: Конфигурация на Docker контейнери, VS Code и GitHub Codespaces +- **GitHub Models**: Безплатен достъп до AI модели за прототипиране и учене (без кредитна карта) +- **Инструменти за разработчици**: Docker контейнери, VS Code и GitHub Codespaces конфигурация - **[→ Започнете Глава 2](./02-SetupDevEnvironment/README.md)** -### **Глава 3: Основни техники на генеративния AI** -- **Инженерство на заявки (prompt engineering)**: Техники за оптимални отговори от AI модели -- **Вграждания и векторни операции**: Изграждане на семантично търсене и търсене за сходство +### **Глава 3: Основни техники в генеративния AI** +- **Създаване на заявки (Prompt Engineering)**: Техники за оптимални отговори от AI модели +- **Embeddings и векторни операции**: Имплементиране на семантично търсене и намиране на сходства - **Retrieval-Augmented Generation (RAG)**: Комбиниране на AI с ваши собствени източници на данни -- **Викане на функции**: Разширяване на възможностите на AI с персонализирани инструменти и плъгини +- **Извикване на функции**: Разширяване на възможностите на AI с персонализирани инструменти и плъгини - **[→ Започнете Глава 3](./03-CoreGenerativeAITechniques/README.md)** ### **Глава 4: Практически приложения и проекти** - **Генератор на истории за домашни любимци** (`petstory/`): Креативно генериране на съдържание с GitHub Models -- **Foundry Local демо** (`foundrylocal/`): Локална интеграция на AI модели с OpenAI Java SDK -- **MCP изчислителна услуга** (`calculator/`): Основна имплементация на Model Context Protocol със Spring AI +- **Foundry локално демо** (`foundrylocal/`): Локална интеграция на AI модели с OpenAI Java SDK +- **MCP Калькулатор услуга** (`calculator/`): Основна имплементация на Model Context Protocol с Spring AI - **[→ Започнете Глава 4](./04-PracticalSamples/README.md)** -### **Глава 5: Отговорна разработка на AI** -- **Безопасност на GitHub Models**: Тествайте вграденото филтриране на съдържание и механизми за безопасност (твърди блокировки и меки отразявания) -- **Демо за отговорен AI**: Практически пример, показващ как работят съвременните системи за безопасност на AI -- **Най-добри практики**: Основни насоки за етично разработване и внедряване на AI +### **Глава 5: Отговорно развитие на AI** +- **GitHub Models безопасност**: Тестване на вградени филтри за съдържание и механизми за безопасност (строги блокирания и меки откази) +- **Демонстрация на отговорен AI**: Практически пример, показващ как работят съвременните системи за безопасност на AI +- **Най-добри практики**: Основни насоки за етично развитие и внедряване на AI - **[→ Започнете Глава 5](./05-ResponsibleGenAI/README.md)** ## Допълнителни ресурси @@ -100,11 +91,11 @@ CO_OP_TRANSLATOR_METADATA: [![AZD за начинаещи](https://img.shields.io/badge/AZD%20for%20Beginners-0078D4?style=for-the-badge&labelColor=E5E7EB&color=0078D4)](https://github.com/microsoft/AZD-for-beginners?WT.mc_id=academic-105485-koreyst) [![Edge AI за начинаещи](https://img.shields.io/badge/Edge%20AI%20for%20Beginners-00B8E4?style=for-the-badge&labelColor=E5E7EB&color=00B8E4)](https://github.com/microsoft/edgeai-for-beginners?WT.mc_id=academic-105485-koreyst) [![MCP за начинаещи](https://img.shields.io/badge/MCP%20for%20Beginners-009688?style=for-the-badge&labelColor=E5E7EB&color=009688)](https://github.com/microsoft/mcp-for-beginners?WT.mc_id=academic-105485-koreyst) -[![AI агенти за начинаещи](https://img.shields.io/badge/AI%20Agents%20for%20Beginners-00C49A?style=for-the-badge&labelColor=E5E7EB&color=00C49A)](https://github.com/microsoft/ai-agents-for-beginners?WT.mc_id=academic-105485-koreyst) +[![AI Агенти за начинаещи](https://img.shields.io/badge/AI%20Agents%20for%20Beginners-00C49A?style=for-the-badge&labelColor=E5E7EB&color=00C49A)](https://github.com/microsoft/ai-agents-for-beginners?WT.mc_id=academic-105485-koreyst) --- -### Серия генеративен AI +### Серия за генеративен AI [![Генеративен AI за начинаещи](https://img.shields.io/badge/Generative%20AI%20for%20Beginners-8B5CF6?style=for-the-badge&labelColor=E5E7EB&color=8B5CF6)](https://github.com/microsoft/generative-ai-for-beginners?WT.mc_id=academic-105485-koreyst) [![Генеративен AI (.NET)](https://img.shields.io/badge/Generative%20AI%20(.NET)-9333EA?style=for-the-badge&labelColor=E5E7EB&color=9333EA)](https://github.com/microsoft/Generative-AI-for-beginners-dotnet?WT.mc_id=academic-105485-koreyst) [![Генеративен AI (Java)](https://img.shields.io/badge/Generative%20AI%20(Java)-C084FC?style=for-the-badge&labelColor=E5E7EB&color=C084FC)](https://github.com/microsoft/generative-ai-for-beginners-java?WT.mc_id=academic-105485-koreyst) @@ -113,29 +104,30 @@ CO_OP_TRANSLATOR_METADATA: --- ### Основно обучение -[![Машинно обучение за начинаещи](https://img.shields.io/badge/ML%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=22C55E)](https://aka.ms/ml-beginners?WT.mc_id=academic-105485-koreyst) +[![ML за начинаещи](https://img.shields.io/badge/ML%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=22C55E)](https://aka.ms/ml-beginners?WT.mc_id=academic-105485-koreyst) [![Наука за данни за начинаещи](https://img.shields.io/badge/Data%20Science%20for%20Beginners-84CC16?style=for-the-badge&labelColor=E5E7EB&color=84CC16)](https://aka.ms/datascience-beginners?WT.mc_id=academic-105485-koreyst) -[![Изкуствен интелект за начинаещи](https://img.shields.io/badge/AI%20for%20Beginners-A3E635?style=for-the-badge&labelColor=E5E7EB&color=A3E635)](https://aka.ms/ai-beginners?WT.mc_id=academic-105485-koreyst) +[![AI за начинаещи](https://img.shields.io/badge/AI%20for%20Beginners-A3E635?style=for-the-badge&labelColor=E5E7EB&color=A3E635)](https://aka.ms/ai-beginners?WT.mc_id=academic-105485-koreyst) [![Киберсигурност за начинаещи](https://img.shields.io/badge/Cybersecurity%20for%20Beginners-F97316?style=for-the-badge&labelColor=E5E7EB&color=F97316)](https://github.com/microsoft/Security-101?WT.mc_id=academic-96948-sayoung) + [![Уеб разработка за начинаещи](https://img.shields.io/badge/Web%20Dev%20for%20Beginners-EC4899?style=for-the-badge&labelColor=E5E7EB&color=EC4899)](https://aka.ms/webdev-beginners?WT.mc_id=academic-105485-koreyst) -[![IoT for Beginners](https://img.shields.io/badge/IoT%20for%20Beginners-14B8A6?style=for-the-badge&labelColor=E5E7EB&color=14B8A6)](https://aka.ms/iot-beginners?WT.mc_id=academic-105485-koreyst) -[![XR Development for Beginners](https://img.shields.io/badge/XR%20Development%20for%20Beginners-38BDF8?style=for-the-badge&labelColor=E5E7EB&color=38BDF8)](https://github.com/microsoft/xr-development-for-beginners?WT.mc_id=academic-105485-koreyst) +[![Internet на нещата за начинаещи](https://img.shields.io/badge/IoT%20for%20Beginners-14B8A6?style=for-the-badge&labelColor=E5E7EB&color=14B8A6)](https://aka.ms/iot-beginners?WT.mc_id=academic-105485-koreyst) +[![XR разработка за начинаещи](https://img.shields.io/badge/XR%20Development%20for%20Beginners-38BDF8?style=for-the-badge&labelColor=E5E7EB&color=38BDF8)](https://github.com/microsoft/xr-development-for-beginners?WT.mc_id=academic-105485-koreyst) --- -### Copilot Series -[![Copilot for AI Paired Programming](https://img.shields.io/badge/Copilot%20for%20AI%20Paired%20Programming-FACC15?style=for-the-badge&labelColor=E5E7EB&color=FACC15)](https://aka.ms/GitHubCopilotAI?WT.mc_id=academic-105485-koreyst) -[![Copilot for C#/.NET](https://img.shields.io/badge/Copilot%20for%20C%23/.NET-FBBF24?style=for-the-badge&labelColor=E5E7EB&color=FBBF24)](https://github.com/microsoft/mastering-github-copilot-for-dotnet-csharp-developers?WT.mc_id=academic-105485-koreyst) -[![Copilot Adventure](https://img.shields.io/badge/Copilot%20Adventure-FDE68A?style=for-the-badge&labelColor=E5E7EB&color=FDE68A)](https://github.com/microsoft/CopilotAdventures?WT.mc_id=academic-105485-koreyst) +### Серия Copilot +[![Copilot за свързано с ИИ програмиране](https://img.shields.io/badge/Copilot%20for%20AI%20Paired%20Programming-FACC15?style=for-the-badge&labelColor=E5E7EB&color=FACC15)](https://aka.ms/GitHubCopilotAI?WT.mc_id=academic-105485-koreyst) +[![Copilot за C#/.NET](https://img.shields.io/badge/Copilot%20for%20C%23/.NET-FBBF24?style=for-the-badge&labelColor=E5E7EB&color=FBBF24)](https://github.com/microsoft/mastering-github-copilot-for-dotnet-csharp-developers?WT.mc_id=academic-105485-koreyst) +[![Приключение с Copilot](https://img.shields.io/badge/Copilot%20Adventure-FDE68A?style=for-the-badge&labelColor=E5E7EB&color=FDE68A)](https://github.com/microsoft/CopilotAdventures?WT.mc_id=academic-105485-koreyst) ## Получаване на помощ -Ако зациклите или имате въпроси относно създаването на AI приложения. Присъединете се към други обучаващи се и опитни разработчици в дискусии за MCP. Това е подкрепяща общност, където въпросите са добре дошли и знанието се споделя свободно. +Ако срещнете затруднения или имате въпроси относно създаването на ИИ приложения, присъединете се към други обучаващи се и опитни разработчици в обсъждания за MCP. Това е подкрепяща общност, в която въпросите са добре дошли и знанието се споделя свободно. [![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) -Ако имате обратна връзка за продукта или грешки по време на разработка, посетете: +Ако имате обратна връзка за продукта или срещате грешки по време на разработване, посетете: [![Microsoft Foundry Developer Forum](https://img.shields.io/badge/GitHub-Microsoft_Foundry_Developer_Forum-blue?style=for-the-badge&logo=github&color=000000&logoColor=fff)](https://aka.ms/foundry/forum) @@ -143,5 +135,5 @@ CO_OP_TRANSLATOR_METADATA: **Отказ от отговорност**: -Този документ е преведен с помощта на AI преводаческа услуга [Co-op Translator](https://github.com/Azure/co-op-translator). Въпреки че се стремим към точност, моля, имайте предвид, че автоматизираните преводи могат да съдържат грешки или неточности. Оригиналният документ на неговия език трябва да се счита за авторитетен източник. За критична информация се препоръчва професионален човешки превод. Ние не носим отговорност за каквито и да е недоразумения или неправилни тълкувания, произтичащи от използването на този превод. +Този документ е преведен с помощта на AI преводаческа услуга [Co-op Translator](https://github.com/Azure/co-op-translator). Въпреки че се стремим към точност, моля, имайте предвид, че автоматизираните преводи могат да съдържат грешки или неточности. Оригиналният документ на неговия роден език трябва да се счита за авторитетен източник. За критична информация се препоръчва професионален човешки превод. Ние не носим отговорност за каквито и да е недоразумения или неправилни тълкувания, възникнали от използването на този превод. \ No newline at end of file diff --git a/translations/bg/SECURITY.md b/translations/bg/SECURITY.md index 83e6f0a2..d6c325df 100644 --- a/translations/bg/SECURITY.md +++ b/translations/bg/SECURITY.md @@ -1,12 +1,3 @@ - ## Сигурност Microsoft приема сигурността на своите софтуерни продукти и услуги сериозно, включително всички хранилища с изходен код, управлявани чрез нашите GitHub организации, които включват [Microsoft](https://github.com/Microsoft), [Azure](https://github.com/Azure), [DotNet](https://github.com/dotnet), [AspNet](https://github.com/aspnet) и [Xamarin](https://github.com/xamarin). diff --git a/translations/bg/SUPPORT.md b/translations/bg/SUPPORT.md index 105f429e..7612f511 100644 --- a/translations/bg/SUPPORT.md +++ b/translations/bg/SUPPORT.md @@ -1,12 +1,3 @@ - # Поддръжка ## Как да съобщите за проблеми и получите помощ diff --git a/translations/bn/.co-op-translator.json b/translations/bn/.co-op-translator.json new file mode 100644 index 00000000..fc4523f8 --- /dev/null +++ b/translations/bn/.co-op-translator.json @@ -0,0 +1,92 @@ +{ + "01-IntroToGenAI/README.md": { + "original_hash": "75bfb080ca725e8a9aa9c80cae25fba1", + "translation_date": "2025-07-29T08:42:52+00:00", + "source_file": "01-IntroToGenAI/README.md", + "language_code": "bn" + }, + "02-SetupDevEnvironment/README.md": { + "original_hash": "96a30d42b9751a3d4e4b20e28d29d459", + "translation_date": "2026-01-28T04:49:51+00:00", + "source_file": "02-SetupDevEnvironment/README.md", + "language_code": "bn" + }, + "02-SetupDevEnvironment/examples/basic-chat-azure/README.md": { + "original_hash": "efd82efe50711d7e257eb943151d682c", + "translation_date": "2025-07-27T13:37:49+00:00", + "source_file": "02-SetupDevEnvironment/examples/basic-chat-azure/README.md", + "language_code": "bn" + }, + "02-SetupDevEnvironment/getting-started-azure-openai.md": { + "original_hash": "bfdb4b4eadbee3a59ef742439f58326a", + "translation_date": "2025-07-27T13:01:09+00:00", + "source_file": "02-SetupDevEnvironment/getting-started-azure-openai.md", + "language_code": "bn" + }, + "03-CoreGenerativeAITechniques/README.md": { + "original_hash": "685f55cb07de19b52a30ce6e8b6d889e", + "translation_date": "2025-08-28T22:00:42+00:00", + "source_file": "03-CoreGenerativeAITechniques/README.md", + "language_code": "bn" + }, + "04-PracticalSamples/README.md": { + "original_hash": "14c0a61ecc1cd2012a9c129236dfdf71", + "translation_date": "2025-07-29T08:42:29+00:00", + "source_file": "04-PracticalSamples/README.md", + "language_code": "bn" + }, + "04-PracticalSamples/calculator/README.md": { + "original_hash": "b6c16b5514d524e415a94f6097ee7d4c", + "translation_date": "2025-09-18T15:28:26+00:00", + "source_file": "04-PracticalSamples/calculator/README.md", + "language_code": "bn" + }, + "04-PracticalSamples/foundrylocal/README.md": { + "original_hash": "f787307400de59adc25a1404466a35f3", + "translation_date": "2025-11-04T07:19:29+00:00", + "source_file": "04-PracticalSamples/foundrylocal/README.md", + "language_code": "bn" + }, + "04-PracticalSamples/petstory/README.md": { + "original_hash": "0cbf68d605615a1e602c832a24616859", + "translation_date": "2025-07-25T11:05:39+00:00", + "source_file": "04-PracticalSamples/petstory/README.md", + "language_code": "bn" + }, + "05-ResponsibleGenAI/README.md": { + "original_hash": "301c05c2f57e60a6950b8c665b8bdbba", + "translation_date": "2025-07-29T15:46:11+00:00", + "source_file": "05-ResponsibleGenAI/README.md", + "language_code": "bn" + }, + "AGENTS.md": { + "original_hash": "afc90918d008cf77fd1982691f681306", + "translation_date": "2025-10-03T08:32:23+00:00", + "source_file": "AGENTS.md", + "language_code": "bn" + }, + "CODE_OF_CONDUCT.md": { + "original_hash": "442b123d034f92f7c384d2bbd28f99f1", + "translation_date": "2025-07-21T17:36:40+00:00", + "source_file": "CODE_OF_CONDUCT.md", + "language_code": "bn" + }, + "README.md": { + "original_hash": "125a08948d881c95628094f4dd1fbd43", + "translation_date": "2026-01-29T15:34:47+00:00", + "source_file": "README.md", + "language_code": "bn" + }, + "SECURITY.md": { + "original_hash": "57f14126c1c6add76b3aef3844dfe4e3", + "translation_date": "2025-07-21T17:34:46+00:00", + "source_file": "SECURITY.md", + "language_code": "bn" + }, + "SUPPORT.md": { + "original_hash": "b8ef73cc49dec68e2c885ee9df545129", + "translation_date": "2025-07-21T17:37:44+00:00", + "source_file": "SUPPORT.md", + "language_code": "bn" + } +} \ No newline at end of file diff --git a/translations/bn/01-IntroToGenAI/README.md b/translations/bn/01-IntroToGenAI/README.md index 276ad516..3b8f24dc 100644 --- a/translations/bn/01-IntroToGenAI/README.md +++ b/translations/bn/01-IntroToGenAI/README.md @@ -1,12 +1,3 @@ - # জেনারেটিভ এআই - জাভা সংস্করণে পরিচিতি ## আপনি কী শিখবেন diff --git a/translations/bn/02-SetupDevEnvironment/README.md b/translations/bn/02-SetupDevEnvironment/README.md index f5fee40b..fbac0b78 100644 --- a/translations/bn/02-SetupDevEnvironment/README.md +++ b/translations/bn/02-SetupDevEnvironment/README.md @@ -1,13 +1,252 @@ - +# Java এর জন্য Generative AI এর ডেভেলপমেন্ট এনভায়রনমেন্ট সেট আপ করা +> **দ্রুত শুরু করুন**: ২ মিনিটে ক্লাউডে কোড করুন - যান [GitHub Codespaces Setup](../../../02-SetupDevEnvironment) এ - কোনও লোকাল ইনস্টলেশনের প্রয়োজন নেই এবং GitHub মডেল ব্যবহার করে! + +> **Azure OpenAI তে আগ্রহী?**, আমাদের [Azure OpenAI Setup Guide](getting-started-azure-openai.md) দেখুন যেখানে নতুন Azure OpenAI রিসোর্স তৈরি করার ধাপ উল্লেখ করা হয়েছে। + +## আপনি যা শিখবেন + +- AI অ্যাপ্লিকেশনের জন্য একটি Java ডেভেলপমেন্ট এনভায়রনমেন্ট সেট আপ করা +- আপনার পছন্দের ডেভেলপমেন্ট এনভায়রনমেন্ট নির্বাচন এবং কনফিগার করা (Codespaces সহ ক্লাউড ফার্স্ট, লোকাল ডেভ কনটেইনার, বা সম্পূর্ণ লোকাল সেটআপ) +- GitHub মডেলগুলোর সাথে সংযোগ করে আপনার সেটআপ পরীক্ষা করা + +## বিষয় তালিকা + +- [আপনি যা শিখবেন](../../../02-SetupDevEnvironment) +- [পরিচিতি](../../../02-SetupDevEnvironment) +- [ধাপ ১: আপনার ডেভেলপমেন্ট এনভায়রনমেন্ট সেট আপ করুন](../../../02-SetupDevEnvironment) + - [বিকল্প A: GitHub Codespaces (প্রস্তাবিত)](../../../02-SetupDevEnvironment) + - [বিকল্প B: লোকাল ডেভ কন্টেইনার](../../../02-SetupDevEnvironment) + - [বিকল্প C: আপনার বিদ্যমান লোকাল ইনস্টলেশন ব্যবহার করুন](../../../02-SetupDevEnvironment) +- [ধাপ ২: GitHub Personal Access Token তৈরি করুন](../../../02-SetupDevEnvironment) +- [ধাপ ৩: আপনার সেটআপ পরীক্ষা করুন](../../../02-SetupDevEnvironment) +- [সমস্যা সমাধান](../../../02-SetupDevEnvironment) +- [সারাংশ](../../../02-SetupDevEnvironment) +- [পরবর্তী ধাপ](../../../02-SetupDevEnvironment) + +## পরিচিতি + +এই অধ্যায়ে আমরা ডেভেলপমেন্ট এনভায়রনমেন্ট সেট আপ করার নির্দেশনা দেব। আমরা **GitHub Models** ব্যবহার করব কারণ এটি বিনামূল্যে, কেবলমাত্র একটি GitHub একাউন্ট দিয়ে সহজে সেট আপ করা যায়, কোনও ক্রেডিট কার্ডের দরকার নেই, এবং পরীক্ষা-নিরীক্ষার জন্য একাধিক মডেল অ্যাক্সেস দেয়। + +**কোনও লোকাল সেটআপের প্রয়োজন নেই!** আপনি ব্রাউজারে একটি সম্পূর্ণ ডেভেলপমেন্ট এনভায়রনমেন্ট প্রদান করে GitHub Codespaces ব্যবহার করে অবিলম্বে কোডিং শুরু করতে পারেন। + +স্ক্রীনশট: GitHub মডেল + +আমরা এই কোর্সের জন্য [**GitHub Models**](https://github.com/marketplace?type=models) ব্যবহারের পরামর্শ দিই কারণ এটা: +- শুরু করার জন্য **বিনামূল্যে** +- শুধু একটি GitHub একাউন্ট দিয়ে **সহজ** সেটআপ +- **কোনও ক্রেডিট কার্ডের দরকার নেই** +- পরীক্ষা-নিরীক্ষার জন্য **বিভিন্ন মডেল** উপলব্ধ + +> **নোট**: এই প্রশিক্ষণে ব্যবহৃত GitHub Models এর ফ্রি সীমা রয়েছে: +> - প্রতি মিনিটে ১৫টি অনুরোধ (প্রতিদিন ১৫০) +> - প্রতি অনুরোধে প্রায় ৮,০০০ শব্দ ইনপুট, প্রায় ৪,০০০ শব্দ আউটপুট +> - ৫টি একসঙ্গে চলমান অনুরোধ +> +> উৎপাদন ব্যবহারের জন্য, আপনার Azure একাউন্ট দিয়ে Azure AI Foundry মডেলে আপগ্রেড করুন। আপনার কোড পরিবর্তন করার প্রয়োজন নেই। দেখুন [Azure AI Foundry ডকুমেন্টেশন](https://learn.microsoft.com/azure/ai-foundry/foundry-models/how-to/quickstart-github-models)। + +## ধাপ ১: আপনার ডেভেলপমেন্ট এনভায়রনমেন্ট সেট আপ করুন + + + +আমরা একটি পূর্ব-কনফিগারড ডেভেলপমেন্ট কনটেইনার তৈরি করেছি যাতে সেটআপের সময় কম লাগে এবং আপনার কাছে এই Generative AI for Java কোর্সের জন্য প্রয়োজনীয় সব সরঞ্জাম থাকে। আপনার পছন্দসই ডেভেলপমেন্ট পদ্ধতি নির্বাচন করুন: + +### এনভায়রনমেন্ট সেটআপ বিকল্পসমূহ: + +#### বিকল্প A: GitHub Codespaces (প্রস্তাবিত) + +**২ মিনিটে কোডিং শুরু করুন - কোনও লোকাল সেটআপের প্রয়োজন নেই!** + +১. এই রেপোজিটরিটি আপনার GitHub একাউন্টে ফোর্ক করুন + > **নোট**: যদি আপনি মূল কনফিগারেশন সম্পাদনা করতে চান তবে [Dev Container Configuration](../../../.devcontainer/devcontainer.json) দেখুন +২. ক্লিক করুন **Code** → **Codespaces** ট্যাব → **...** → **New with options...** +৩. ডিফল্ট ব্যবহার করুন – এটি নির্বাচন করবে **Dev container configuration**: **Generative AI Java Development Environment**, এই কোর্সের জন্য তৈরি কাস্টম ডেভকন্টেইনার +৪. ক্লিক করুন **Create codespace** +৫. প্রায় ২ মিনিট অপেক্ষা করুন এনভায়রনমেন্ট প্রস্তুত হওয়ার জন্য +৬. এগিয়ে যান [ধাপ ২: GitHub Token তৈরি করুন](../../../02-SetupDevEnvironment) + +স্ক্রীনশট: Codespaces সাবমেনু + +স্ক্রীনশট: নতুন বিকল্প সহ + +স্ক্রীনশট: কোডস্পেস অপশন তৈরি + + +> **Codespaces এর সুবিধা**: +> - কোনও লোকাল ইনস্টলেশনের দরকার নেই +> - যেকোনো ব্রাউজারযুক্ত ডিভাইসে কাজ করে +> - সমস্ত টুল এবং নির্ভরতাসমূহ পূর্ব-কনফিগারড +> - ব্যক্তিগত অ্যাকাউন্টের জন্য প্রতি মাসে ৬০ ঘণ্টা বিনামূল্যে +> - সকল শিক্ষার্থীর জন্য একটি সঙ্গতিপূর্ণ পরিবেশ + +#### বিকল্প B: লোকাল ডেভ কনটেইনার + +**ডকার ব্যবহার করে লোকাল ডেভেলপমেন্ট পছন্দকারীদের জন্য** + +১. এই রেপোজিটরিটি ফোর্ক এবং ক্লোন করুন আপনার লোকাল মেশিনে + > **নোট**: যদি আপনি মূল কনফিগারেশন সম্পাদনা করতে চান তবে [Dev Container Configuration](../../../.devcontainer/devcontainer.json) দেখুন +২. [Docker Desktop](https://www.docker.com/products/docker-desktop/) এবং [VS Code](https://code.visualstudio.com/) ইনস্টল করুন +৩. VS Code-এ [Dev Containers এক্সটেনশন](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers) ইনস্টল করুন +৪. রেপোজিটরি ফোল্ডার VS Code-এ খুলুন +৫. প্রম্পট পেলে ক্লিক করুন **Reopen in Container** (অথবা `Ctrl+Shift+P` → "Dev Containers: Reopen in Container" ব্যবহার করুন) +৬. কনটেইনার তৈরি এবং শুরু হওয়ার জন্য অপেক্ষা করুন +৭. এগিয়ে যান [ধাপ ২: GitHub Token তৈরি করুন](../../../02-SetupDevEnvironment) + +স্ক্রীনশট: ডেভ কনটেইনার সেটআপ + +স্ক্রীনশট: ডেভ কনটেইনার বিল্ড সম্পন্ন + +#### বিকল্প C: আপনার বিদ্যমান লোকাল ইনস্টলেশন ব্যবহার করুন + +**বিদ্যমান Java এনভায়রনমেন্ট সহ ডেভেলপারদের জন্য** + +প্রাকশর্ত: +- [Java 21+](https://www.oracle.com/java/technologies/javase/jdk21-archive-downloads.html) +- [Maven 3.9+](https://maven.apache.org/download.cgi) +- [VS Code](https://code.visualstudio.com) অথবা আপনার পছন্দের আইডিই + +ধাপসমূহ: +১. এই রেপোজিটরিটি আপনার লোকাল মেশিনে ক্লোন করুন +২. প্রকল্পটি আপনার আইডিই-তে খুলুন +৩. এগিয়ে যান [ধাপ ২: GitHub Token তৈরি করুন](../../../02-SetupDevEnvironment) + +> **প্রো টিপ**: আপনার মেশিনের স্পেস কম হলেও যদি VS Code লোকাল ব্যবহার করতে চান, GitHub Codespaces ব্যবহার করুন! আপনি আপনার লোকাল VS Code কে ক্লাউড-হোস্টেড Codespace এর সাথে সংযুক্ত করতে পারেন যাতে উভয়ের সুবিধা মিলে। + +স্ক্রীনশট: তৈরি করা লোকাল ডেভকন্টেইনার ইনস্ট্যান্স + +## ধাপ ২: একটি GitHub Personal Access Token তৈরি করুন + +১. [GitHub Settings](https://github.com/settings/profile) এ যান এবং আপনার প্রোফাইল মেনু থেকে **Settings** নির্বাচন করুন। +২. বাম সাইডবারে **Developer settings** (সাধারণত নিচে থাকে) ক্লিক করুন। +৩. **Personal access tokens** এর অধীনে **Fine-grained tokens** ক্লিক করুন (অথবা সরাসরি [লিংক](https://github.com/settings/personal-access-tokens) অনুসরণ করুন)। +৪. **Generate new token** ক্লিক করুন। +৫. "Token name" এ একটি বর্ণনামূলক নাম দিন (যেমন, `GenAI-Java-Course-Token`)। +৬. মেয়াদ শেষের তারিখ সেট করুন (নিরাপত্তার জন্য ৭ দিন সুপারিশকৃত)। +৭. "Resource owner" এ আপনার ইউজার একাউন্ট নির্বাচন করুন। +৮. "Repository access" এ যেসব রেপোজিটরি GitHub Models এর জন্য ব্যবহার করতে চান সেগুলো নির্বাচন করুন (অথবা প্রয়োজনে "All repositories")। +৯. "Account permissions" এ **Models** নির্বাচন করুন এবং সেট করুন **Read-only**। +১০. **Generate token** ক্লিক করুন। +১১. **আপনার টোকেনটি এখন কপি এবং সংরক্ষণ করুন** – এটি আর দেখানো হবে না! + +> **নিরাপত্তা টিপ**: আপনার Token এর জন্য সর্বনিম্ন প্রয়োজনীয় স্কোপ ব্যবহার করুন এবং কেবল প্রয়োজনীয়তম মেয়াদ দিন। + +## ধাপ ৩: GitHub Models উদাহরণ দিয়ে আপনার সেটআপ পরীক্ষা করুন + +আপনার ডেভেলপমেন্ট এনভায়রনমেন্ট প্রস্তুত হলে, চলুন GitHub Models এর ইন্টিগ্রেশন পরীক্ষা করি আমাদের উদাহরণ অ্যাপ্লিকেশন [`02-SetupDevEnvironment/examples/github-models`](../../../02-SetupDevEnvironment/examples/github-models) এ। + +১. আপনার ডেভেলপমেন্ট এনভায়রনমেন্টে টার্মিনাল খুলুন। +২. GitHub Models উদাহরণ ফোল্ডারে যান: + ```bash + cd 02-SetupDevEnvironment/examples/github-models + ``` +3. আপনার GitHub টোকেন একটি এনভায়রনমেন্ট ভেরিয়েবল হিসেবে সেট করুন: + ```bash + # ম্যাকওএস/লিনাক্স + export GITHUB_TOKEN=your_token_here + + # উইন্ডোজ (কমান্ড প্রম্পট) + set GITHUB_TOKEN=your_token_here + + # উইন্ডোজ (পাওয়ারশেল) + $env:GITHUB_TOKEN="your_token_here" + ``` + +৪. অ্যাপ্লিকেশন চালান: + ```bash + mvn compile exec:java -Dexec.mainClass="com.example.githubmodels.App" + ``` + +আপনি এই রকম আউটপুট দেখতে পাবেন: +```text +Using model: gpt-4.1-nano +Sending request to GitHub Models... +Response: Hello World! +``` + +### উদাহরণ কোড বোঝা + +প্রথমে, আমরা যা চালিয়েছি তা বুঝি। `examples/github-models` এর নিচের উদাহরণটি OpenAI Java SDK ব্যবহার করে GitHub Models এর সাথে সংযোগ স্থাপন করে: + +**এই কোড কি করে:** +- আপনার ব্যক্তিগত অ্যাক্সেস টোকেন দিয়ে GitHub Models এর সাথে **সংযোগ** করে +- AI মডেলকে একটি সহজ "Say Hello World!" মেসেজ **পাঠায়** +- AI এর প্রতিক্রিয়া **প্রাপ্ত** ও প্রদর্শন করে +- নিশ্চিত করে আপনার সেটআপ সঠিকভাবে কাজ করছে + +**মুখ্য নির্ভরতা** (`pom.xml` এ): +```xml + + com.openai + openai-java + 2.12.0 + +``` + +**মূল কোড** (`App.java`): +```java +// OpenAI Java SDK ব্যবহার করে GitHub মডেলের সাথে সংযুক্ত করুন +OpenAIClient client = OpenAIOkHttpClient.builder() + .apiKey(pat) + .baseUrl("https://models.inference.ai.azure.com") + .build(); + +// চ্যাট সম্পূর্ণতার অনুরোধ তৈরি করুন +ChatCompletionCreateParams params = ChatCompletionCreateParams.builder() + .model(modelId) + .addSystemMessage("You are a concise assistant.") + .addUserMessage("Say Hello World!") + .build(); + +// AI প্রতিক্রিয়া নিন +ChatCompletion response = client.chat().completions().create(params); +System.out.println("Response: " + response.choices().get(0).message().content().orElse("No response content")); +``` + +## সারাংশ + +দারুণ! এখন আপনার সবকিছু সেট আপ সম্পন্ন: + +- AI মডেল অ্যাক্সেসের জন্য সঠিক অনুমোদনসহ একটি GitHub Personal Access Token তৈরি করেছেন +- আপনার Java ডেভেলপমেন্ট এনভায়রনমেন্ট চালু করেছেন (Codespaces, ডেভ কনটেইনার বা লোকাল যাই হোক) +- OpenAI Java SDK ব্যবহার করে GitHub Models এর সাথে সংযোগ করেছেন বিনামূল্যে AI ডেভেলপমেন্টের জন্য +- একটি সহজ উদাহরণ দিয়ে পরীক্ষা করেছেন যা AI মডেলগুলোর সাথে কথা বলে + +## পরবর্তী ধাপ + +[অধ্যায় ৩: কোর Generative AI প্রযুক্তি](../03-CoreGenerativeAITechniques/README.md) + +## সমস্যা সমাধান + +সমস্যা হচ্ছে? এখানে সাধারণ সমস্যা এবং সমাধান দেওয়া হলো: + +- **টোকেন কাজ করছে না?** + - নিশ্চিত করুন আপনি সম্পূর্ণ টোকেন ঠিক ভাবে কপি করেছেন, অতিরিক্ত স্পেস নেই + - টোকেন সঠিকভাবে এনভায়রনমেন্ট ভেরিয়েবল হিসেবে সেট হয়েছে কি না যাচাই করুন + - টোকেনে সঠিক অনুমতি আছে কিনা দেখুন (Models: Read-only) + +- **Maven পাওয়া যাচ্ছে না?** + - যদি dev container/Codespaces ব্যবহার করেন, Maven পূর্বেই ইনস্টল করা থাকে + - লোকাল সেটআপে Java 21+ এবং Maven 3.9+ ইনস্টল আছে কিনা নিশ্চিত করুন + - `mvn --version` চালিয়ে যাচাই করুন + +- **সংযোগ সমস্যা?** + - আপনার ইন্টারনেট সংযোগ ঠিক আছে কিনা পরীক্ষা করুন + - আপনার নেটওয়ার্ক থেকে GitHub অ্যাক্সেসযোগ্য কিনা নিশ্চিত করুন + - Firewall দ্বারা GitHub Models endpoint ব্লক হচ্ছে কিনা দেখুন + +- **Dev container শুরু হয় না?** + - নিশ্চিত করুন Docker Desktop চলছে (লোকাল ডেভের জন্য) + - কনটেইনার পুনর্নির্মাণ করুন: `Ctrl+Shift+P` → "Dev Containers: Rebuild Container" + +- **অ্যাপ্লিকেশন কম্পাইলেশন এরর হচ্ছে?** + - সঠিক ডিরেক্টরিতে আছেন কিনা দেখুন: `02-SetupDevEnvironment/examples/github-models` + - ক্লিন ও বিল্ড করার চেষ্টা করুন: `mvn clean compile` + +> **সাহায্য প্রয়োজন?**: এখনও সমস্যা থাকলে রেপোজিটরিতে একটি ইস্যু খুলুন, আমরা সাহায্য করব। --- + +**বিজ্ঞপ্তি**: +এই নথিটি AI অনুবাদ সেবা [Co-op Translator](https://github.com/Azure/co-op-translator) ব্যবহার করে অনূদিত হয়েছে। আমরা সঠিকতার জন্য চেষ্টা করি, তবে অনুগ্রহ করে জান্তু automated অনুবাদে ভুল বা অসঙ্গতি থাকতে পারে। মূল নথিটি তার নিজ ভাষায় বিশ্বস্ত উৎস হিসেবে বিবেচিত হওয়া উচিত। গুরুত্বপূর্ণ তথ্যের জন্য পেশাদার মানব অনুবাদ পরামর্শযোগ্য। এই অনুবাদের ব্যবহারে কোনো ভুল বোঝাবুঝি বা ভুল ব্যাখ্যার জন্য আমরা দায়ী নই। + \ No newline at end of file diff --git a/translations/bn/02-SetupDevEnvironment/examples/basic-chat-azure/README.md b/translations/bn/02-SetupDevEnvironment/examples/basic-chat-azure/README.md index fd7e0c72..1bdaf403 100644 --- a/translations/bn/02-SetupDevEnvironment/examples/basic-chat-azure/README.md +++ b/translations/bn/02-SetupDevEnvironment/examples/basic-chat-azure/README.md @@ -1,12 +1,3 @@ - # Azure OpenAI-এর সাথে বেসিক চ্যাট - সম্পূর্ণ উদাহরণ এই উদাহরণটি দেখায় কীভাবে একটি সাধারণ Spring Boot অ্যাপ্লিকেশন তৈরি করা যায় যা Azure OpenAI-এর সাথে সংযুক্ত হয় এবং আপনার সেটআপ পরীক্ষা করে। diff --git a/translations/bn/02-SetupDevEnvironment/getting-started-azure-openai.md b/translations/bn/02-SetupDevEnvironment/getting-started-azure-openai.md index a4baaa32..158dbf32 100644 --- a/translations/bn/02-SetupDevEnvironment/getting-started-azure-openai.md +++ b/translations/bn/02-SetupDevEnvironment/getting-started-azure-openai.md @@ -1,12 +1,3 @@ - # Azure OpenAI-এর জন্য ডেভেলপমেন্ট এনভায়রনমেন্ট সেটআপ > **দ্রুত শুরু**: এই গাইডটি Azure OpenAI সেটআপের জন্য। বিনামূল্যে মডেল দিয়ে তাত্ক্ষণিক শুরু করতে, [GitHub Models with Codespaces](./README.md#quick-start-cloud) ব্যবহার করুন। diff --git a/translations/bn/03-CoreGenerativeAITechniques/README.md b/translations/bn/03-CoreGenerativeAITechniques/README.md index fb09060c..8f900a11 100644 --- a/translations/bn/03-CoreGenerativeAITechniques/README.md +++ b/translations/bn/03-CoreGenerativeAITechniques/README.md @@ -1,12 +1,3 @@ - # কোর জেনারেটিভ এআই টেকনিকস টিউটোরিয়াল ## সূচিপত্র diff --git a/translations/bn/04-PracticalSamples/README.md b/translations/bn/04-PracticalSamples/README.md index 28238192..336cfa11 100644 --- a/translations/bn/04-PracticalSamples/README.md +++ b/translations/bn/04-PracticalSamples/README.md @@ -1,12 +1,3 @@ - # ব্যবহারিক প্রয়োগ ও প্রকল্পসমূহ ## আপনি কী শিখবেন diff --git a/translations/bn/04-PracticalSamples/calculator/README.md b/translations/bn/04-PracticalSamples/calculator/README.md index 60f102d5..2e6e2044 100644 --- a/translations/bn/04-PracticalSamples/calculator/README.md +++ b/translations/bn/04-PracticalSamples/calculator/README.md @@ -1,12 +1,3 @@ - # MCP ক্যালকুলেটর টিউটোরিয়াল নবাগতদের জন্য ## বিষয়সূচি diff --git a/translations/bn/04-PracticalSamples/foundrylocal/README.md b/translations/bn/04-PracticalSamples/foundrylocal/README.md index 4485a537..1d7ea91e 100644 --- a/translations/bn/04-PracticalSamples/foundrylocal/README.md +++ b/translations/bn/04-PracticalSamples/foundrylocal/README.md @@ -1,12 +1,3 @@ - # Foundry Local Spring Boot টিউটোরিয়াল ## বিষয়সূচি diff --git a/translations/bn/04-PracticalSamples/petstory/README.md b/translations/bn/04-PracticalSamples/petstory/README.md index 053f09d5..88919598 100644 --- a/translations/bn/04-PracticalSamples/petstory/README.md +++ b/translations/bn/04-PracticalSamples/petstory/README.md @@ -1,12 +1,3 @@ - # পেট স্টোরি জেনারেটর টিউটোরিয়াল নবাগতদের জন্য ## বিষয়সূচি diff --git a/translations/bn/05-ResponsibleGenAI/README.md b/translations/bn/05-ResponsibleGenAI/README.md index 90a70624..c20c476a 100644 --- a/translations/bn/05-ResponsibleGenAI/README.md +++ b/translations/bn/05-ResponsibleGenAI/README.md @@ -1,12 +1,3 @@ - # দায়িত্বশীল জেনারেটিভ AI ## আপনি কী শিখবেন diff --git a/translations/bn/AGENTS.md b/translations/bn/AGENTS.md index 90b05337..54ef5b2a 100644 --- a/translations/bn/AGENTS.md +++ b/translations/bn/AGENTS.md @@ -1,12 +1,3 @@ - # AGENTS.md ## প্রকল্পের সংক্ষিপ্ত বিবরণ diff --git a/translations/bn/CODE_OF_CONDUCT.md b/translations/bn/CODE_OF_CONDUCT.md index 61baef27..4a9b4ae9 100644 --- a/translations/bn/CODE_OF_CONDUCT.md +++ b/translations/bn/CODE_OF_CONDUCT.md @@ -1,12 +1,3 @@ - # মাইক্রোসফট ওপেন সোর্স আচরণবিধি এই প্রকল্পটি [মাইক্রোসফট ওপেন সোর্স আচরণবিধি](https://opensource.microsoft.com/codeofconduct/) গ্রহণ করেছে। diff --git a/translations/bn/README.md b/translations/bn/README.md index 29dba6cd..10341159 100644 --- a/translations/bn/README.md +++ b/translations/bn/README.md @@ -1,147 +1,138 @@ - -# নবপ্রবীণদের জন্য জেনেরেটিভ এআই - জাভা সংস্করণ +# শিক্ষানবিসদের জন্য জেনারেটিভ এআই - জাভা সংস্করণ [![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) -![নবপ্রবীণদের জন্য জেনেরেটিভ এআই - জাভা সংস্করণ](../../translated_images/bn/beg-genai-series.8b48be9951cc574c.webp) +![Generative AI for Beginners - Java Edition](../../translated_images/bn/beg-genai-series.8b48be9951cc574c.webp) -**সময় বরাদ্দ**: সম্পূর্ণ কর্মশালাটি অনলাইনে স্থানীয় সেটআপ ছাড়াই সম্পন্ন করা যেতে পারে। পরিবেশ সেটআপ করতে ২ মিনিট সময় লাগে, নমুনাগুলি অন্বেষণ করতে ১-৩ ঘণ্টা সময় লাগতে পারে যা অন্বেষণ গভীরতার উপর নির্ভর করে। +**সময়সাপেক্ষতা**: পুরো কর্মশালাটি অনলাইনে সম্পন্ন করা যেতে পারে কোনো লোকাল সেটআপ ছাড়াই। পরিবেশ সেটআপে ২ মিনিট লাগে, আর নমুনাগুলো খুঁজে দেখার জন্য অন্বেষণের গভীরতার ওপর নির্ভর করে ১-৩ ঘণ্টা লাগে। > **দ্রুত শুরু** -১. এই রিপোজিটরিটি আপনার গিটহাব অ্যাকাউন্টে ফর্ক করুন -২. ক্লিক করুন **Code** → **Codespaces** ট্যাব → **...** → **New with options...** -৩. ডিফল্ট ব্যবহার করুন – এটি এই কোর্সের জন্য তৈরি করা ডেভেলপমেন্ট কন্টেইনার নির্বাচন করবে -৪. ক্লিক করুন **Create codespace** -৫. পরিবেশ প্রস্তুত হতে প্রায় ২ মিনিট অপেক্ষা করুন -৬. সরাসরি লাফ দিন [প্রথম উদাহরণের দিকে](./02-SetupDevEnvironment/README.md#step-2-create-a-github-personal-access-token) +১. এই রিপোজিটরিটি আপনার GitHub অ্যাকাউন্টে ফর্ক করুন +২. **Code** → **Codespaces** ট্যাব → **...** → **New with options...** ক্লিক করুন +৩. ডিফল্ট ব্যবহার করুন – এতে এই কোর্সের জন্য তৈরি ডেভেলপমেন্ট কন্টেইনার নির্বাচিত হবে +৪. **Create codespace** ক্লিক করুন +৫. পরিবেশ প্রস্তুত হতে ~২ মিনিট অপেক্ষা করুন +৬. সরাসরি [প্রথম উদাহরণের দিকে যান](./02-SetupDevEnvironment/README.md#step-2-create-a-github-personal-access-token) -> **লোকাল-এ ক্লোন করতে পছন্দ করেন?** +> **লোকালি ক্লোন করতে চান?** > -> এই রিপোজিটরিতে ৫০+ ভাষার অনুবাদ অন্তর্ভুক্ত রয়েছে যা ডাউনলোড সাইজ উল্লেখযোগ্যভাবে বৃদ্ধি করে। অনুবাদের ছাড়া ক্লোন করতে sparse checkout ব্যবহার করুন: +> এই রিপোজিটরিতে ৫০+ ভাষার অনুবাদ অন্তর্ভুক্ত, যা ডাউনলোড সাইজ উল্লেখযোগ্যভাবে বৃদ্ধি করে। অনুবাদ ছাড়া ক্লোন করতে, sparse checkout ব্যবহার করুন: > ```bash > git clone --filter=blob:none --sparse https://github.com/microsoft/Generative-AI-for-beginners-java.git > cd Generative-AI-for-beginners-java > git sparse-checkout set --no-cone '/*' '!translations' '!translated_images' > ``` -> এটি আপনাকে কোর্স সম্পন্ন করার জন্য প্রয়োজনীয় সবকিছু ভালো হারে ডাউনলোড করতে দিবে। +> এতে কোর্স সম্পন্ন করার জন্য প্রয়োজনীয় সবকিছু দ্রুত ডাউনলোড হবে। +## বহু-ভাষা সমর্থন -## বহু-ভাষার সমর্থন - -### গিটহাব অ্যাকশনের মাধ্যমে সমর্থিত (স্বয়ংক্রিয় ও সর্বদা আপ-টু-ডেট) +### GitHub Action এর মাধ্যমে সমর্থিত (স্বয়ংক্রিয় এবং সর্বদা সর্বশেষ) -[আরবি](../ar/README.md) | [বাংলা](./README.md) | [বুলগেরিয়ান](../bg/README.md) | [বার্মিজ (মায়ানমার)](../my/README.md) | [চীনা (সরলীকৃত)](../zh/README.md) | [চীনা (প্রচলিত, হংকং)](../hk/README.md) | [চীনা (প্রচলিত, মাকাও)](../mo/README.md) | [চীনা (প্রচলিত, তাইওয়ান)](../tw/README.md) | [ক্রোয়েশিয়ান](../hr/README.md) | [চেক](../cs/README.md) | [ডেনিশ](../da/README.md) | [ডাচ](../nl/README.md) | [এস্টোনিয়ান](../et/README.md) | [ফিনিশ](../fi/README.md) | [ফরাসি](../fr/README.md) | [জার্মান](../de/README.md) | [গ্রিক](../el/README.md) | [হিব্রু](../he/README.md) | [হিন্দি](../hi/README.md) | [হাঙ্গেরিয়ান](../hu/README.md) | [ইন্দোনেশিয়ান](../id/README.md) | [ইতালিয়ান](../it/README.md) | [জাপানিস](../ja/README.md) | [কন্নড়](../kn/README.md) | [কোরিয়ান](../ko/README.md) | [লিথুয়ানিয়ান](../lt/README.md) | [মালয়](../ms/README.md) | [মলয়ালম](../ml/README.md) | [মারাঠি](../mr/README.md) | [নেপালী](../ne/README.md) | [নাইজেরিয়ান পিজিন](../pcm/README.md) | [নরওয়েজিয়ান](../no/README.md) | [ফার্সি](../fa/README.md) | [পোলিশ](../pl/README.md) | [পর্তুগিজ (ব্রাজিল)](../br/README.md) | [পর্তুগিজ (পর্তুগাল)](../pt/README.md) | [পাঞ্জাবি (গুরুমুখী)](../pa/README.md) | [রোমানিয়ান](../ro/README.md) | [রাশিয়ান](../ru/README.md) | [সার্বিয়ান (সিরিলিক)](../sr/README.md) | [স্লোভাক](../sk/README.md) | [স্লোভেনিয়ান](../sl/README.md) | [স্প্যানিশ](../es/README.md) | [সোয়াহিলি](../sw/README.md) | [সুইডিশ](../sv/README.md) | [টাগালগ (ফিলিপিনো)](../tl/README.md) | [তামিল](../ta/README.md) | [তেলুগু](../te/README.md) | [থাই](../th/README.md) | [তুর্কি](../tr/README.md) | [ইউক্রেনিয়ান](../uk/README.md) | [উর্দু](../ur/README.md) | [ভিয়েতনামী](../vi/README.md) - -> **লোকাল-এ ক্লোন করতে পছন্দ করেন?** +[Arabic](../ar/README.md) | [Bengali](./README.md) | [Bulgarian](../bg/README.md) | [Burmese (Myanmar)](../my/README.md) | [Chinese (Simplified)](../zh-CN/README.md) | [Chinese (Traditional, Hong Kong)](../zh-HK/README.md) | [Chinese (Traditional, Macau)](../zh-MO/README.md) | [Chinese (Traditional, Taiwan)](../zh-TW/README.md) | [Croatian](../hr/README.md) | [Czech](../cs/README.md) | [Danish](../da/README.md) | [Dutch](../nl/README.md) | [Estonian](../et/README.md) | [Finnish](../fi/README.md) | [French](../fr/README.md) | [German](../de/README.md) | [Greek](../el/README.md) | [Hebrew](../he/README.md) | [Hindi](../hi/README.md) | [Hungarian](../hu/README.md) | [Indonesian](../id/README.md) | [Italian](../it/README.md) | [Japanese](../ja/README.md) | [Kannada](../kn/README.md) | [Korean](../ko/README.md) | [Lithuanian](../lt/README.md) | [Malay](../ms/README.md) | [Malayalam](../ml/README.md) | [Marathi](../mr/README.md) | [Nepali](../ne/README.md) | [Nigerian Pidgin](../pcm/README.md) | [Norwegian](../no/README.md) | [Persian (Farsi)](../fa/README.md) | [Polish](../pl/README.md) | [Portuguese (Brazil)](../pt-BR/README.md) | [Portuguese (Portugal)](../pt-PT/README.md) | [Punjabi (Gurmukhi)](../pa/README.md) | [Romanian](../ro/README.md) | [Russian](../ru/README.md) | [Serbian (Cyrillic)](../sr/README.md) | [Slovak](../sk/README.md) | [Slovenian](../sl/README.md) | [Spanish](../es/README.md) | [Swahili](../sw/README.md) | [Swedish](../sv/README.md) | [Tagalog (Filipino)](../tl/README.md) | [Tamil](../ta/README.md) | [Telugu](../te/README.md) | [Thai](../th/README.md) | [Turkish](../tr/README.md) | [Ukrainian](../uk/README.md) | [Urdu](../ur/README.md) | [Vietnamese](../vi/README.md) -> এই রিপোজিটরিতে ৫০+ ভাষার অনুবাদ অন্তর্ভুক্ত রয়েছে যা ডাউনলোড সাইজ উল্লেখযোগ্যভাবে বৃদ্ধি করে। অনুবাদের ছাড়া ক্লোন করতে sparse checkout ব্যবহার করুন: +> **লোকালি ক্লোন করতে চান?** +> +> এই রিপোজিটরিতে ৫০+ ভাষার অনুবাদ অন্তর্ভুক্ত, যা ডাউনলোড সাইজ উল্লেখযোগ্যভাবে বৃদ্ধি করে। অনুবাদ ছাড়া ক্লোন করতে, sparse checkout ব্যবহার করুন: > ```bash > git clone --filter=blob:none --sparse https://github.com/microsoft/Generative-AI-for-beginners-java.git > cd Generative-AI-for-beginners-java > git sparse-checkout set --no-cone '/*' '!translations' '!translated_images' > ``` -> এটি আপনাকে কোর্স সম্পন্ন করার জন্য প্রয়োজনীয় সবকিছু ভালো হারে ডাউনলোড করতে দিবে। +> এতে কোর্স সম্পন্ন করার জন্য প্রয়োজনীয় সবকিছু দ্রুত ডাউনলোড হবে। -## কোর্স কাঠামো ও শেখার পথ +## কোর্সের কাঠামো ও শেখার পথ -### **অধ্যায় ১: জেনেরেটিভ এআই পরিচিতি** -- **প্রাথমিক ধারণা**: বড় ভাষা মডেল, টোকেন, এম্বেডিংস এবং এআই সক্ষমতা বোঝা -- **জাভা এআই ইকোসিস্টেম**: স্প্রিং এআই ও ওপেনএআই এসডিকেগুলোর সংক্ষিপ্ত বিবরণ -- **মডেল কন্টেক্সট প্রোটোকল**: MCP পরিচিতি এবং এটি কীভাবে এআই এজেন্টের সাথে যোগাযোগ করে -- **প্রায়োগিক ব্যবহার**: চ্যাটবট ও বিষয়বস্তু সৃষ্টিসহ বাস্তব বিশ্বে প্রয়োগ +### **অধ্যায় ১: জেনারেটিভ এআই এর পরিচিতি** +- **মূল ধারণা**: বড় ভাষা মডেলসমূহ, টোকেন, এম্বেডিংস, এবং এআই সক্ষমতার বোধগম্যতা +- **জাভা এআই ইকোসিস্টেম**: Spring AI এবং OpenAI SDK এর ওভারভিউ +- **মডেল কনটেক্সট প্রটোকল**: MCP এর পরিচিতি এবং এর ভূমিকা এআই এজেন্ট যোগাযোগে +- **প্র্যাকটিক্যাল অ্যাপ্লিকেশনস**: বাস্তব জীবনের পরিস্থিতি যেমন চ্যাটবট এবং কন্টেন্ট জেনারেশন - **[→ অধ্যায় ১ শুরু করুন](./01-IntroToGenAI/README.md)** -### **অধ্যায় ২: ডেভেলপমেন্ট পরিবেশ সেটআপ** -- **মাল্টি-প্রোভাইডার কনফিগারেশন**: গিটহাব মডেল, আজুর ওপেনএআই, ও ওপেনএআই জাভা এসডিকে সেটআপ -- **স্প্রিং বুট + স্প্রিং এআই**: এন্টারপ্রাইজ এআই অ্যাপ্লিকেশন ডেভেলপমেন্টের সেরা পদ্ধতি -- **গিটহাব মডেল**: প্রোটোটাইপিং ও শেখার জন্য ফ্রি এআই মডেল অ্যাক্সেস (কোনো ক্রেডিট কার্ড দরকার নয়) -- **ডেভেলপমেন্ট টুলস**: ডকার কন্টেইনার, ভিএস কোড, ও গিটহাব কোডস্পেসেস কনফিগারেশন +### **অধ্যায় ২: ডেভেলপমেন্ট পরিবেশ সেটআপ** +- **একাধিক প্রদানকারী কনফিগারেশন**: GitHub Models, Azure OpenAI, এবং OpenAI Java SDK ইন্টিগ্রেশন সেটআপ +- **Spring Boot + Spring AI**: এন্টারপ্রাইজ এআই অ্যাপ্লিকেশন উন্নয়নের সেরা অনুশীলন +- **GitHub Models**: প্রোটোটাইপিং ও শেখার জন্য ফ্রি এআই মডেল অ্যাক্সেস (ক্রেডিট কার্ডের প্রয়োজন নেই) +- **ডেভেলপমেন্ট টুলস**: Docker কন্টেইনার, VS Code, এবং GitHub Codespaces কনফিগারেশন - **[→ অধ্যায় ২ শুরু করুন](./02-SetupDevEnvironment/README.md)** -### **অধ্যায় ৩: মূল জেনেরেটিভ এআই কৌশল** -- **প্রম্পট ইঞ্জিনিয়ারিং**: আদর্শ এআই মডেল প্রতিক্রিয়া পাওয়ার কৌশল -- **এম্বেডিংস ও ভেক্টর অপারেশন**: সেমান্টিক অনুসন্ধান ও সাদৃশ্য মিলানো কার্যকরী করা -- **রিট্রিভাল-অগমেন্টেড জেনারেশন (RAG)**: নিজের ডেটা উৎসের সঙ্গে এআই একত্রিত করুন -- **ফাংশন কলিং**: কাস্টম সরঞ্জাম ও প্লাগইন দিয়ে এআই সক্ষমতা বাড়ানো +### **অধ্যায় ৩: মূল জেনারেটিভ এআই টেকনিকস** +- **প্রম্পট ইঞ্জিনিয়ারিং**: অপ্টিমাল এআই মডেল প্রতিক্রিয়া জন্য টেকনিকস +- **এম্বেডিংস এবং ভেক্টর অপারেশনস**: সেমান্টিক সার্চ এবং সাদৃশ্য মিলায়ন প্রয়োগ +- **রিট্রিভাল-অগমেন্টেড জেনারেশন (RAG)**: আপনার নিজের ডেটা উৎসের সাথে এআই একত্রিত করা +- **ফাংশন কলিং**: কাস্টম টুলস এবং প্লাগইন দিয়ে এআই সক্ষমতা বৃদ্ধি - **[→ অধ্যায় ৩ শুরু করুন](./03-CoreGenerativeAITechniques/README.md)** -### **অধ্যায় ৪: প্রাযুক্তিক ব্যবহার ও প্রকল্পসমূহ** -- **পেট স্টোরি জেনারেটর** (`petstory/`): গিটহাব মডেলের সাহায্যে সৃজনশীল বিষয়বস্তু সৃষ্টি -- **ফাউন্ড্রি লোকাল ডেমো** (`foundrylocal/`): লোকাল এআই মডেলের ওপেনএআই জাভা এসডিকে সহযোগিতায় সংযুক্তি -- **MCP ক্যালকুলেটর সার্ভিস** (`calculator/`): স্প্রিং এআই দিয়ে মডেল কন্টেক্সট প্রোটোকলের মৌলিক বাস্তবায়ন +### **অধ্যায় ৪: বাস্তব প্রয়োগ ও প্রকল্প** +- **পেট স্টোরি জেনারেটর** (`petstory/`): GitHub Models ব্যবহার করে সৃজনশীল কন্টেন্ট উৎপাদন +- **Foundry Local Demo** (`foundrylocal/`): OpenAI Java SDK দিয়ে লোকাল এআই মডেল ইন্টিগ্রেশন +- **MCP Calculator Service** (`calculator/`): Spring AI ব্যবহার করে মডেল কনটেক্সট প্রটোকল বাস্তবায়ন - **[→ অধ্যায় ৪ শুরু করুন](./04-PracticalSamples/README.md)** -### **অধ্যায় ৫: দায়িত্বশীল এআই ডেভেলপমেন্ট** -- **গিটহাব মডেল নিরাপত্তা**: বিল্ট-ইন বিষয়বস্তু ফিল্টারিং ও সেফটি ব্যবস্থা (হার্ড ব্লক ও সফট প্রত্যাখ্যান) পরীক্ষা করা -- **দায়িত্বশীল এআই ডেমো**: আধুনিক এআই সেফটি সিস্টেমগুলি কীভাবে কাজ করে তা হাতে-কলমে উদাহরণ -- **সেরা অনুশীলন**: নৈতিক এআই ডেভেলপমেন্ট ও ডেপ্লয়মেন্টের অপরিহার্য নির্দেশিকা +### **অধ্যায় ৫: দায়িত্বশীল এআই উন্নয়ন** +- **GitHub Models Safety**: বিল্ট-ইন কন্টেন্ট ফিল্টারিং ও সেফটি মেকানিজম (হার্ড ব্লক এবং সফট প্রত্যাখ্যান) পরীক্ষা +- **দায়িত্বশীল এআই ডেমো**: আধুনিক এআই সেফটি সিস্টেম কিভাবে কাজ করে তা হাতে-কলমে উদাহরণ +- **সেরা অনুশীলন**: নৈতিক এআই উন্নয়ন ও প্রয়োগের জন্য অত্যাবশ্যক নির্দেশিকা - **[→ অধ্যায় ৫ শুরু করুন](./05-ResponsibleGenAI/README.md)** -## অতিরিক্ত সম্পদসমূহ +## অতিরিক্ত সম্পদ -### ল্যাংচেইন -[![নবপ্রবীণদের জন্য LangChain4j](https://img.shields.io/badge/LangChain4j%20for%20Beginners-22C55E?style=for-the-badge&&labelColor=E5E7EB&color=0553D6)](https://aka.ms/langchain4j-for-beginners) -[![নবপ্রবীণদের জন্য LangChain.js](https://img.shields.io/badge/LangChain.js%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=0553D6)](https://aka.ms/langchainjs-for-beginners?WT.mc_id=m365-94501-dwahlin) +### LangChain +[![LangChain4j for Beginners](https://img.shields.io/badge/LangChain4j%20for%20Beginners-22C55E?style=for-the-badge&&labelColor=E5E7EB&color=0553D6)](https://aka.ms/langchain4j-for-beginners) +[![LangChain.js for Beginners](https://img.shields.io/badge/LangChain.js%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=0553D6)](https://aka.ms/langchainjs-for-beginners?WT.mc_id=m365-94501-dwahlin) --- -### আজুর / এজ / MCP / এজেন্টস -[![নবপ্রবীণদের জন্য AZD](https://img.shields.io/badge/AZD%20for%20Beginners-0078D4?style=for-the-badge&labelColor=E5E7EB&color=0078D4)](https://github.com/microsoft/AZD-for-beginners?WT.mc_id=academic-105485-koreyst) -[![নবপ্রবীণদের জন্য এজ এআই](https://img.shields.io/badge/Edge%20AI%20for%20Beginners-00B8E4?style=for-the-badge&labelColor=E5E7EB&color=00B8E4)](https://github.com/microsoft/edgeai-for-beginners?WT.mc_id=academic-105485-koreyst) -[![নবপ্রবীণদের জন্য MCP](https://img.shields.io/badge/MCP%20for%20Beginners-009688?style=for-the-badge&labelColor=E5E7EB&color=009688)](https://github.com/microsoft/mcp-for-beginners?WT.mc_id=academic-105485-koreyst) -[![নবপ্রবীণদের জন্য এআই এজেন্টস](https://img.shields.io/badge/AI%20Agents%20for%20Beginners-00C49A?style=for-the-badge&labelColor=E5E7EB&color=00C49A)](https://github.com/microsoft/ai-agents-for-beginners?WT.mc_id=academic-105485-koreyst) +### Azure / Edge / MCP / Agents +[![AZD for Beginners](https://img.shields.io/badge/AZD%20for%20Beginners-0078D4?style=for-the-badge&labelColor=E5E7EB&color=0078D4)](https://github.com/microsoft/AZD-for-beginners?WT.mc_id=academic-105485-koreyst) +[![Edge AI for Beginners](https://img.shields.io/badge/Edge%20AI%20for%20Beginners-00B8E4?style=for-the-badge&labelColor=E5E7EB&color=00B8E4)](https://github.com/microsoft/edgeai-for-beginners?WT.mc_id=academic-105485-koreyst) +[![MCP for Beginners](https://img.shields.io/badge/MCP%20for%20Beginners-009688?style=for-the-badge&labelColor=E5E7EB&color=009688)](https://github.com/microsoft/mcp-for-beginners?WT.mc_id=academic-105485-koreyst) +[![AI Agents for Beginners](https://img.shields.io/badge/AI%20Agents%20for%20Beginners-00C49A?style=for-the-badge&labelColor=E5E7EB&color=00C49A)](https://github.com/microsoft/ai-agents-for-beginners?WT.mc_id=academic-105485-koreyst) --- -### জেনেরেটিভ এআই সিরিজ -[![নবপ্রবীণদের জন্য জেনেরেটিভ এআই](https://img.shields.io/badge/Generative%20AI%20for%20Beginners-8B5CF6?style=for-the-badge&labelColor=E5E7EB&color=8B5CF6)](https://github.com/microsoft/generative-ai-for-beginners?WT.mc_id=academic-105485-koreyst) -[![জেনেরেটিভ এআই (.NET)](https://img.shields.io/badge/Generative%20AI%20(.NET)-9333EA?style=for-the-badge&labelColor=E5E7EB&color=9333EA)](https://github.com/microsoft/Generative-AI-for-beginners-dotnet?WT.mc_id=academic-105485-koreyst) -[![জেনেরেটিভ এআই (জাভা)](https://img.shields.io/badge/Generative%20AI%20(Java)-C084FC?style=for-the-badge&labelColor=E5E7EB&color=C084FC)](https://github.com/microsoft/generative-ai-for-beginners-java?WT.mc_id=academic-105485-koreyst) -[![জেনেরেটিভ এআই (জাভাস্ক্রিপ্ট)](https://img.shields.io/badge/Generative%20AI%20(JavaScript)-E879F9?style=for-the-badge&labelColor=E5E7EB&color=E879F9)](https://github.com/microsoft/generative-ai-with-javascript?WT.mc_id=academic-105485-koreyst) +### Generative AI Series +[![Generative AI for Beginners](https://img.shields.io/badge/Generative%20AI%20for%20Beginners-8B5CF6?style=for-the-badge&labelColor=E5E7EB&color=8B5CF6)](https://github.com/microsoft/generative-ai-for-beginners?WT.mc_id=academic-105485-koreyst) +[![Generative AI (.NET)](https://img.shields.io/badge/Generative%20AI%20(.NET)-9333EA?style=for-the-badge&labelColor=E5E7EB&color=9333EA)](https://github.com/microsoft/Generative-AI-for-beginners-dotnet?WT.mc_id=academic-105485-koreyst) +[![Generative AI (Java)](https://img.shields.io/badge/Generative%20AI%20(Java)-C084FC?style=for-the-badge&labelColor=E5E7EB&color=C084FC)](https://github.com/microsoft/generative-ai-for-beginners-java?WT.mc_id=academic-105485-koreyst) +[![Generative AI (JavaScript)](https://img.shields.io/badge/Generative%20AI%20(JavaScript)-E879F9?style=for-the-badge&labelColor=E5E7EB&color=E879F9)](https://github.com/microsoft/generative-ai-with-javascript?WT.mc_id=academic-105485-koreyst) --- -### মূল পাঠ্যক্রম -[![নবপ্রবীণদের জন্য এমএল](https://img.shields.io/badge/ML%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=22C55E)](https://aka.ms/ml-beginners?WT.mc_id=academic-105485-koreyst) -[![নবপ্রবীণদের জন্য ডেটা সায়েন্স](https://img.shields.io/badge/Data%20Science%20for%20Beginners-84CC16?style=for-the-badge&labelColor=E5E7EB&color=84CC16)](https://aka.ms/datascience-beginners?WT.mc_id=academic-105485-koreyst) -[![নবপ্রবীণদের জন্য এআই](https://img.shields.io/badge/AI%20for%20Beginners-A3E635?style=for-the-badge&labelColor=E5E7EB&color=A3E635)](https://aka.ms/ai-beginners?WT.mc_id=academic-105485-koreyst) -[![নবপ্রবীণদের জন্য সাইবারসিকিউরিটি](https://img.shields.io/badge/Cybersecurity%20for%20Beginners-F97316?style=for-the-badge&labelColor=E5E7EB&color=F97316)](https://github.com/microsoft/Security-101?WT.mc_id=academic-96948-sayoung) -[![নবপ্রবীণদের জন্য ওয়েব ডেভেলপমেন্ট](https://img.shields.io/badge/Web%20Dev%20for%20Beginners-EC4899?style=for-the-badge&labelColor=E5E7EB&color=EC4899)](https://aka.ms/webdev-beginners?WT.mc_id=academic-105485-koreyst) -[![শুরু করার জন্য IoT](https://img.shields.io/badge/IoT%20for%20Beginners-14B8A6?style=for-the-badge&labelColor=E5E7EB&color=14B8A6)](https://aka.ms/iot-beginners?WT.mc_id=academic-105485-koreyst) -[![শুরু করার জন্য XR ডেভেলপমেন্ট](https://img.shields.io/badge/XR%20Development%20for%20Beginners-38BDF8?style=for-the-badge&labelColor=E5E7EB&color=38BDF8)](https://github.com/microsoft/xr-development-for-beginners?WT.mc_id=academic-105485-koreyst) +### মূল শেখার বিষয় +[![ML for Beginners](https://img.shields.io/badge/ML%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=22C55E)](https://aka.ms/ml-beginners?WT.mc_id=academic-105485-koreyst) +[![Data Science for Beginners](https://img.shields.io/badge/Data%20Science%20for%20Beginners-84CC16?style=for-the-badge&labelColor=E5E7EB&color=84CC16)](https://aka.ms/datascience-beginners?WT.mc_id=academic-105485-koreyst) +[![AI for Beginners](https://img.shields.io/badge/AI%20for%20Beginners-A3E635?style=for-the-badge&labelColor=E5E7EB&color=A3E635)](https://aka.ms/ai-beginners?WT.mc_id=academic-105485-koreyst) +[![Cybersecurity for Beginners](https://img.shields.io/badge/Cybersecurity%20for%20Beginners-F97316?style=for-the-badge&labelColor=E5E7EB&color=F97316)](https://github.com/microsoft/Security-101?WT.mc_id=academic-96948-sayoung) + +[![Web Dev for Beginners](https://img.shields.io/badge/Web%20Dev%20for%20Beginners-EC4899?style=for-the-badge&labelColor=E5E7EB&color=EC4899)](https://aka.ms/webdev-beginners?WT.mc_id=academic-105485-koreyst) +[![IoT for Beginners](https://img.shields.io/badge/IoT%20for%20Beginners-14B8A6?style=for-the-badge&labelColor=E5E7EB&color=14B8A6)](https://aka.ms/iot-beginners?WT.mc_id=academic-105485-koreyst) +[![XR Development for Beginners](https://img.shields.io/badge/XR%20Development%20for%20Beginners-38BDF8?style=for-the-badge&labelColor=E5E7EB&color=38BDF8)](https://github.com/microsoft/xr-development-for-beginners?WT.mc_id=academic-105485-koreyst) --- -### কপিলট সিরিজ -[![AI জোড়া প্রোগ্রামিংয়ের জন্য কপিলট](https://img.shields.io/badge/Copilot%20for%20AI%20Paired%20Programming-FACC15?style=for-the-badge&labelColor=E5E7EB&color=FACC15)](https://aka.ms/GitHubCopilotAI?WT.mc_id=academic-105485-koreyst) -[![C#/.NET এর জন্য কপিলট](https://img.shields.io/badge/Copilot%20for%20C%23/.NET-FBBF24?style=for-the-badge&labelColor=E5E7EB&color=FBBF24)](https://github.com/microsoft/mastering-github-copilot-for-dotnet-csharp-developers?WT.mc_id=academic-105485-koreyst) -[![কপিলট অ্যাডভেঞ্চার](https://img.shields.io/badge/Copilot%20Adventure-FDE68A?style=for-the-badge&labelColor=E5E7EB&color=FDE68A)](https://github.com/microsoft/CopilotAdventures?WT.mc_id=academic-105485-koreyst) +### কপাইলট সিরিজ +[![Copilot for AI Paired Programming](https://img.shields.io/badge/Copilot%20for%20AI%20Paired%20Programming-FACC15?style=for-the-badge&labelColor=E5E7EB&color=FACC15)](https://aka.ms/GitHubCopilotAI?WT.mc_id=academic-105485-koreyst) +[![Copilot for C#/.NET](https://img.shields.io/badge/Copilot%20for%20C%23/.NET-FBBF24?style=for-the-badge&labelColor=E5E7EB&color=FBBF24)](https://github.com/microsoft/mastering-github-copilot-for-dotnet-csharp-developers?WT.mc_id=academic-105485-koreyst) +[![Copilot Adventure](https://img.shields.io/badge/Copilot%20Adventure-FDE68A?style=for-the-badge&labelColor=E5E7EB&color=FDE68A)](https://github.com/microsoft/CopilotAdventures?WT.mc_id=academic-105485-koreyst) -## সাহায্য নেওয়া +## সাহায্যের জন্য -যদি আপনি আটকে যান বা AI অ্যাপ তৈরি সম্পর্কে কোনো প্রশ্ন থাকে। MCP সম্পর্কে আলোচনা করার জন্য সহপাঠী শিক্ষার্থী এবং দক্ষ ডেভেলপারদের সঙ্গে যোগ দিন। এটি একটি সমর্থনশীল কমিউনিটি যেখানে প্রশ্ন করাটা স্বাগত এবং জ্ঞানের বিনিময় অবাধ। +যদি আপনি আটকে যান বা AI অ্যাপ তৈরি সম্পর্কে কোনো প্রশ্ন থাকে। MCP সম্পর্কে সহপাঠী এবং অভিজ্ঞ ডেভেলপারদের সাথে আলোচনায় যোগ দিন। এটি একটি সহায়ক কমিউনিটি যেখানে প্রশ্ন স্বাগত এবং জ্ঞান বিনামূল্যে ভাগ করা হয়। -[![মাইক্রোসফ্ট ফাউন্ড্রি ডিসকর্ড](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) +[![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) -আপনার যদি পণ্য ফিডব্যাক বা নির্মাণ চলাকালে কোনো ত্রুটি থাকে তবে দেখুন: +যদি আপনার পণ্যের মতামত বা নির্মাণকালে ত্রুটি থাকে তাহলে এই ঠিকানায় যান: -[![মাইক্রোসফ্ট ফাউন্ড্রি ডেভেলপার ফোরাম](https://img.shields.io/badge/GitHub-Microsoft_Foundry_Developer_Forum-blue?style=for-the-badge&logo=github&color=000000&logoColor=fff)](https://aka.ms/foundry/forum) +[![Microsoft Foundry Developer Forum](https://img.shields.io/badge/GitHub-Microsoft_Foundry_Developer_Forum-blue?style=for-the-badge&logo=github&color=000000&logoColor=fff)](https://aka.ms/foundry/forum) --- -**অস্বীকৃতি**: -এই নথিটি AI অনুবাদ সেবা [Co-op Translator](https://github.com/Azure/co-op-translator) ব্যবহার করে অনুবাদ করা হয়েছে। আমরা যথাসাধ্য সঠিকতার চেষ্টা করি, তবে স্বয়ংক্রিয় অনুবাদে ভুল বা অসঙ্গতি থাকতে পারে। মূল নথিটি তার স্বতন্ত্র ভাষায় সর্বোত্তম সূত্র বলে বিবেচিত হওয়া উচিত। গুরুত্বপূর্ণ তথ্যের জন্য পেশাদার মানব অনুবাদ সুপারিশ করা হয়। এই অনুবাদের ব্যবহারে কোনো误ব্যবধান বা ভুল বোঝাবুঝির জন্য আমরা দায়বদ্ধ নই। +**দায়িত্ব পরিহার**: +এই ডকুমেন্টটি AI অনুবাদ সেবা [Co-op Translator](https://github.com/Azure/co-op-translator) ব্যবহার করে অনুবাদ করা হয়েছে। আমরা যথাসাধ্য সঠিকতার চেষ্টা করি, তবে স্বয়ংক্রিয় অনুবাদে ত্রুটি বা অসঙ্গতি থাকতে পারে। মূল ডকুমেন্টের স্বতন্ত্র ভাষাটি সর্বোচ্চ কর্তৃপক্ষ হিসেবে বিবেচনা করা উচিত। গুরুত্বপূর্ণ তথ্যের জন্য পেশাদার মানব অনুবাদ সুপারিশ করা হয়। এই অনুবাদের ব্যবহারে কোন ভুলবোঝাবুঝি বা ভুল ব্যাখ্যার জন্য আমরা দায়িত্ববোধ করি না। \ No newline at end of file diff --git a/translations/bn/SECURITY.md b/translations/bn/SECURITY.md index d647b4f8..e149e34e 100644 --- a/translations/bn/SECURITY.md +++ b/translations/bn/SECURITY.md @@ -1,12 +1,3 @@ - ## নিরাপত্তা মাইক্রোসফট আমাদের সফটওয়্যার পণ্য এবং পরিষেবাগুলোর নিরাপত্তাকে অত্যন্ত গুরুত্ব সহকারে গ্রহণ করে, যার মধ্যে রয়েছে আমাদের GitHub সংগঠনগুলোর মাধ্যমে পরিচালিত সমস্ত সোর্স কোড রিপোজিটরি, যেমন [Microsoft](https://github.com/Microsoft), [Azure](https://github.com/Azure), [DotNet](https://github.com/dotnet), [AspNet](https://github.com/aspnet) এবং [Xamarin](https://github.com/xamarin)। diff --git a/translations/bn/SUPPORT.md b/translations/bn/SUPPORT.md index 529c2b05..f4665d29 100644 --- a/translations/bn/SUPPORT.md +++ b/translations/bn/SUPPORT.md @@ -1,12 +1,3 @@ - # সহায়তা ## সমস্যা জমা দেওয়া এবং সাহায্য পাওয়া কীভাবে diff --git a/translations/br/02-SetupDevEnvironment/README.md b/translations/br/02-SetupDevEnvironment/README.md deleted file mode 100644 index 45b8e978..00000000 --- a/translations/br/02-SetupDevEnvironment/README.md +++ /dev/null @@ -1,13 +0,0 @@ - - - ---- - diff --git a/translations/br/README.md b/translations/br/README.md deleted file mode 100644 index ede67e14..00000000 --- a/translations/br/README.md +++ /dev/null @@ -1,147 +0,0 @@ - -# IA Generativa para Iniciantes - Edição Java -[![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) - -![IA Generativa para Iniciantes - Edição Java](../../translated_images/br/beg-genai-series.8b48be9951cc574c.webp) - -**Comprometimento de Tempo**: O workshop completo pode ser feito online sem configuração local. A configuração do ambiente leva 2 minutos, sendo que explorar os exemplos requer de 1 a 3 horas dependendo da profundidade da exploração. - -> **Início Rápido** - -1. Faça um fork deste repositório para sua conta no GitHub -2. Clique em **Code** → aba **Codespaces** → **...** → **New with options...** -3. Use as opções padrão – isso selecionará o container de Desenvolvimento criado para este curso -4. Clique em **Create codespace** -5. Aguarde cerca de 2 minutos até que o ambiente esteja pronto -6. Vá direto para [O primeiro exemplo](./02-SetupDevEnvironment/README.md#step-2-create-a-github-personal-access-token) - -> **Prefere Clonar Localmente?** -> -> Este repositório inclui traduções em mais de 50 idiomas, o que aumenta consideravelmente o tamanho do download. Para clonar sem as traduções, use sparse checkout: -> ```bash -> git clone --filter=blob:none --sparse https://github.com/microsoft/Generative-AI-for-beginners-java.git -> cd Generative-AI-for-beginners-java -> git sparse-checkout set --no-cone '/*' '!translations' '!translated_images' -> ``` -> Isso fornece tudo o que você precisa para completar o curso com um download muito mais rápido. - - -## Suporte Multilíngue - -### Suportado via GitHub Action (Automatizado & Sempre Atualizado) - - -[Árabe](../ar/README.md) | [Bengali](../bn/README.md) | [Búlgaro](../bg/README.md) | [Birmanês (Myanmar)](../my/README.md) | [Chinês (Simplificado)](../zh/README.md) | [Chinês (Tradicional, Hong Kong)](../hk/README.md) | [Chinês (Tradicional, Macau)](../mo/README.md) | [Chinês (Tradicional, Taiwan)](../tw/README.md) | [Croata](../hr/README.md) | [Tcheco](../cs/README.md) | [Dinamarquês](../da/README.md) | [Holandês](../nl/README.md) | [Estoniano](../et/README.md) | [Finlandês](../fi/README.md) | [Francês](../fr/README.md) | [Alemão](../de/README.md) | [Grego](../el/README.md) | [Hebraico](../he/README.md) | [Hindi](../hi/README.md) | [Húngaro](../hu/README.md) | [Indonésio](../id/README.md) | [Italiano](../it/README.md) | [Japonês](../ja/README.md) | [Kannada](../kn/README.md) | [Coreano](../ko/README.md) | [Lituano](../lt/README.md) | [Malaio](../ms/README.md) | [Malaiala](../ml/README.md) | [Marata](../mr/README.md) | [Nepali](../ne/README.md) | [Pidgin Nigeriano](../pcm/README.md) | [Norueguês](../no/README.md) | [Persa (Farsi)](../fa/README.md) | [Polonês](../pl/README.md) | [Português (Brasil)](./README.md) | [Português (Portugal)](../pt/README.md) | [Punjabi (Gurmukhi)](../pa/README.md) | [Romeno](../ro/README.md) | [Russo](../ru/README.md) | [Sérvio (Cirílico)](../sr/README.md) | [Eslovaco](../sk/README.md) | [Esloveno](../sl/README.md) | [Espanhol](../es/README.md) | [Suaíli](../sw/README.md) | [Sueco](../sv/README.md) | [Tagalo (Filipino)](../tl/README.md) | [Tâmil](../ta/README.md) | [Telugu](../te/README.md) | [Tailandês](../th/README.md) | [Turco](../tr/README.md) | [Ucraniano](../uk/README.md) | [Urdu](../ur/README.md) | [Vietnamita](../vi/README.md) - -> **Prefere Clonar Localmente?** - -> Este repositório inclui traduções em mais de 50 idiomas, o que aumenta consideravelmente o tamanho do download. Para clonar sem as traduções, use sparse checkout: -> ```bash -> git clone --filter=blob:none --sparse https://github.com/microsoft/Generative-AI-for-beginners-java.git -> cd Generative-AI-for-beginners-java -> git sparse-checkout set --no-cone '/*' '!translations' '!translated_images' -> ``` -> Isso fornece tudo o que você precisa para completar o curso com um download muito mais rápido. - - -## Estrutura do Curso & Caminho de Aprendizagem - -### **Capítulo 1: Introdução à IA Generativa** -- **Conceitos Centrais**: Compreendendo Modelos de Linguagem de Grande Porte, tokens, embeddings e capacidades de IA -- **Ecossistema de IA em Java**: Visão geral do Spring AI e OpenAI SDKs -- **Protocolo de Contexto de Modelo**: Introdução ao MCP e seu papel na comunicação de agentes de IA -- **Aplicações Práticas**: Cenários do mundo real incluindo chatbots e geração de conteúdo -- **[→ Começar Capítulo 1](./01-IntroToGenAI/README.md)** - -### **Capítulo 2: Configuração do Ambiente de Desenvolvimento** -- **Configuração Multi-Provedor**: Configuração dos Modelos GitHub, Azure OpenAI e OpenAI Java SDK -- **Spring Boot + Spring AI**: Melhores práticas para desenvolvimento de aplicações enterprise de IA -- **Modelos GitHub**: Acesso gratuito a modelos de IA para prototipação e aprendizado (não requer cartão de crédito) -- **Ferramentas de Desenvolvimento**: Containers Docker, VS Code e configuração do GitHub Codespaces -- **[→ Começar Capítulo 2](./02-SetupDevEnvironment/README.md)** - -### **Capítulo 3: Técnicas Centrais de IA Generativa** -- **Engenharia de Prompts**: Técnicas para respostas ótimas dos modelos de IA -- **Embeddings & Operações Vetoriais**: Implementar busca semântica e correspondência de similaridade -- **Geração com Recuperação Ampliada (RAG)**: Combine IA com suas próprias fontes de dados -- **Chamada de Funções**: Estenda as capacidades da IA com ferramentas personalizadas e plugins -- **[→ Começar Capítulo 3](./03-CoreGenerativeAITechniques/README.md)** - -### **Capítulo 4: Aplicações Práticas & Projetos** -- **Gerador de Histórias de Pets** (`petstory/`): Geração criativa de conteúdo com Modelos GitHub -- **Demonstração Local Foundry** (`foundrylocal/`): Integração local de modelos IA com OpenAI Java SDK -- **Serviço Calculadora MCP** (`calculator/`): Implementação básica do Protocolo de Contexto de Modelo com Spring AI -- **[→ Começar Capítulo 4](./04-PracticalSamples/README.md)** - -### **Capítulo 5: Desenvolvimento Responsável de IA** -- **Segurança dos Modelos GitHub**: Teste dos filtros embutidos de conteúdo e mecanismos de segurança (bloqueios rígidos e recusas suaves) -- **Demonstração de IA Responsável**: Exemplo prático mostrando como os sistemas modernos de segurança de IA funcionam na prática -- **Melhores Práticas**: Diretrizes essenciais para o desenvolvimento e implantação ética de IA -- **[→ Começar Capítulo 5](./05-ResponsibleGenAI/README.md)** - -## Recursos Adicionais - - -### LangChain -[![LangChain4j para Iniciantes](https://img.shields.io/badge/LangChain4j%20for%20Beginners-22C55E?style=for-the-badge&&labelColor=E5E7EB&color=0553D6)](https://aka.ms/langchain4j-for-beginners) -[![LangChain.js para Iniciantes](https://img.shields.io/badge/LangChain.js%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=0553D6)](https://aka.ms/langchainjs-for-beginners?WT.mc_id=m365-94501-dwahlin) - ---- - -### Azure / Edge / MCP / Agentes -[![AZD para Iniciantes](https://img.shields.io/badge/AZD%20for%20Beginners-0078D4?style=for-the-badge&labelColor=E5E7EB&color=0078D4)](https://github.com/microsoft/AZD-for-beginners?WT.mc_id=academic-105485-koreyst) -[![Edge AI para Iniciantes](https://img.shields.io/badge/Edge%20AI%20for%20Beginners-00B8E4?style=for-the-badge&labelColor=E5E7EB&color=00B8E4)](https://github.com/microsoft/edgeai-for-beginners?WT.mc_id=academic-105485-koreyst) -[![MCP para Iniciantes](https://img.shields.io/badge/MCP%20for%20Beginners-009688?style=for-the-badge&labelColor=E5E7EB&color=009688)](https://github.com/microsoft/mcp-for-beginners?WT.mc_id=academic-105485-koreyst) -[![Agentes de IA para Iniciantes](https://img.shields.io/badge/AI%20Agents%20for%20Beginners-00C49A?style=for-the-badge&labelColor=E5E7EB&color=00C49A)](https://github.com/microsoft/ai-agents-for-beginners?WT.mc_id=academic-105485-koreyst) - ---- - -### Série de IA Generativa -[![IA Generativa para Iniciantes](https://img.shields.io/badge/Generative%20AI%20for%20Beginners-8B5CF6?style=for-the-badge&labelColor=E5E7EB&color=8B5CF6)](https://github.com/microsoft/generative-ai-for-beginners?WT.mc_id=academic-105485-koreyst) -[![IA Generativa (.NET)](https://img.shields.io/badge/Generative%20AI%20(.NET)-9333EA?style=for-the-badge&labelColor=E5E7EB&color=9333EA)](https://github.com/microsoft/Generative-AI-for-beginners-dotnet?WT.mc_id=academic-105485-koreyst) -[![IA Generativa (Java)](https://img.shields.io/badge/Generative%20AI%20(Java)-C084FC?style=for-the-badge&labelColor=E5E7EB&color=C084FC)](https://github.com/microsoft/generative-ai-for-beginners-java?WT.mc_id=academic-105485-koreyst) -[![IA Generativa (JavaScript)](https://img.shields.io/badge/Generative%20AI%20(JavaScript)-E879F9?style=for-the-badge&labelColor=E5E7EB&color=E879F9)](https://github.com/microsoft/generative-ai-with-javascript?WT.mc_id=academic-105485-koreyst) - ---- - -### Aprendizado Central -[![ML para Iniciantes](https://img.shields.io/badge/ML%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=22C55E)](https://aka.ms/ml-beginners?WT.mc_id=academic-105485-koreyst) -[![Ciência de Dados para Iniciantes](https://img.shields.io/badge/Data%20Science%20for%20Beginners-84CC16?style=for-the-badge&labelColor=E5E7EB&color=84CC16)](https://aka.ms/datascience-beginners?WT.mc_id=academic-105485-koreyst) -[![IA para Iniciantes](https://img.shields.io/badge/AI%20for%20Beginners-A3E635?style=for-the-badge&labelColor=E5E7EB&color=A3E635)](https://aka.ms/ai-beginners?WT.mc_id=academic-105485-koreyst) -[![Cibersegurança para Iniciantes](https://img.shields.io/badge/Cybersecurity%20for%20Beginners-F97316?style=for-the-badge&labelColor=E5E7EB&color=F97316)](https://github.com/microsoft/Security-101?WT.mc_id=academic-96948-sayoung) -[![Desenvolvimento Web para Iniciantes](https://img.shields.io/badge/Web%20Dev%20for%20Beginners-EC4899?style=for-the-badge&labelColor=E5E7EB&color=EC4899)](https://aka.ms/webdev-beginners?WT.mc_id=academic-105485-koreyst) -[![IoT for Beginners](https://img.shields.io/badge/IoT%20for%20Beginners-14B8A6?style=for-the-badge&labelColor=E5E7EB&color=14B8A6)](https://aka.ms/iot-beginners?WT.mc_id=academic-105485-koreyst) -[![XR Development for Beginners](https://img.shields.io/badge/XR%20Development%20for%20Beginners-38BDF8?style=for-the-badge&labelColor=E5E7EB&color=38BDF8)](https://github.com/microsoft/xr-development-for-beginners?WT.mc_id=academic-105485-koreyst) - ---- - -### Série Copilot -[![Copilot for AI Paired Programming](https://img.shields.io/badge/Copilot%20for%20AI%20Paired%20Programming-FACC15?style=for-the-badge&labelColor=E5E7EB&color=FACC15)](https://aka.ms/GitHubCopilotAI?WT.mc_id=academic-105485-koreyst) -[![Copilot for C#/.NET](https://img.shields.io/badge/Copilot%20for%20C%23/.NET-FBBF24?style=for-the-badge&labelColor=E5E7EB&color=FBBF24)](https://github.com/microsoft/mastering-github-copilot-for-dotnet-csharp-developers?WT.mc_id=academic-105485-koreyst) -[![Copilot Adventure](https://img.shields.io/badge/Copilot%20Adventure-FDE68A?style=for-the-badge&labelColor=E5E7EB&color=FDE68A)](https://github.com/microsoft/CopilotAdventures?WT.mc_id=academic-105485-koreyst) - - -## Obtendo Ajuda - -Se você ficar preso ou tiver alguma dúvida sobre como criar aplicativos de IA. Junte-se a outros aprendizes e desenvolvedores experientes em discussões sobre MCP. É uma comunidade acolhedora onde perguntas são bem-vindas e o conhecimento é compartilhado gratuitamente. - -[![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) - -Se você tiver feedback sobre produtos ou erros durante a criação, visite: - -[![Microsoft Foundry Developer Forum](https://img.shields.io/badge/GitHub-Microsoft_Foundry_Developer_Forum-blue?style=for-the-badge&logo=github&color=000000&logoColor=fff)](https://aka.ms/foundry/forum) - ---- - - -**Aviso Legal**: -Este documento foi traduzido utilizando o serviço de tradução por IA [Co-op Translator](https://github.com/Azure/co-op-translator). Embora nos esforcemos para garantir a precisão, esteja ciente de que traduções automatizadas podem conter erros ou imprecisões. O documento original em seu idioma nativo deve ser considerado a fonte autorizada. Para informações críticas, recomenda-se a tradução profissional realizada por um humano. Não nos responsabilizamos por quaisquer mal-entendidos ou interpretações incorretas decorrentes do uso desta tradução. - \ No newline at end of file diff --git a/translations/cs/.co-op-translator.json b/translations/cs/.co-op-translator.json new file mode 100644 index 00000000..ea02b5d0 --- /dev/null +++ b/translations/cs/.co-op-translator.json @@ -0,0 +1,92 @@ +{ + "01-IntroToGenAI/README.md": { + "original_hash": "75bfb080ca725e8a9aa9c80cae25fba1", + "translation_date": "2025-07-29T10:02:59+00:00", + "source_file": "01-IntroToGenAI/README.md", + "language_code": "cs" + }, + "02-SetupDevEnvironment/README.md": { + "original_hash": "96a30d42b9751a3d4e4b20e28d29d459", + "translation_date": "2026-01-28T05:19:12+00:00", + "source_file": "02-SetupDevEnvironment/README.md", + "language_code": "cs" + }, + "02-SetupDevEnvironment/examples/basic-chat-azure/README.md": { + "original_hash": "efd82efe50711d7e257eb943151d682c", + "translation_date": "2025-07-27T13:46:13+00:00", + "source_file": "02-SetupDevEnvironment/examples/basic-chat-azure/README.md", + "language_code": "cs" + }, + "02-SetupDevEnvironment/getting-started-azure-openai.md": { + "original_hash": "bfdb4b4eadbee3a59ef742439f58326a", + "translation_date": "2025-07-27T13:23:55+00:00", + "source_file": "02-SetupDevEnvironment/getting-started-azure-openai.md", + "language_code": "cs" + }, + "03-CoreGenerativeAITechniques/README.md": { + "original_hash": "685f55cb07de19b52a30ce6e8b6d889e", + "translation_date": "2025-08-28T22:14:58+00:00", + "source_file": "03-CoreGenerativeAITechniques/README.md", + "language_code": "cs" + }, + "04-PracticalSamples/README.md": { + "original_hash": "14c0a61ecc1cd2012a9c129236dfdf71", + "translation_date": "2025-07-29T10:02:44+00:00", + "source_file": "04-PracticalSamples/README.md", + "language_code": "cs" + }, + "04-PracticalSamples/calculator/README.md": { + "original_hash": "b6c16b5514d524e415a94f6097ee7d4c", + "translation_date": "2025-09-18T15:39:19+00:00", + "source_file": "04-PracticalSamples/calculator/README.md", + "language_code": "cs" + }, + "04-PracticalSamples/foundrylocal/README.md": { + "original_hash": "f787307400de59adc25a1404466a35f3", + "translation_date": "2025-11-04T07:33:09+00:00", + "source_file": "04-PracticalSamples/foundrylocal/README.md", + "language_code": "cs" + }, + "04-PracticalSamples/petstory/README.md": { + "original_hash": "0cbf68d605615a1e602c832a24616859", + "translation_date": "2025-07-25T11:53:17+00:00", + "source_file": "04-PracticalSamples/petstory/README.md", + "language_code": "cs" + }, + "05-ResponsibleGenAI/README.md": { + "original_hash": "301c05c2f57e60a6950b8c665b8bdbba", + "translation_date": "2025-07-29T15:57:40+00:00", + "source_file": "05-ResponsibleGenAI/README.md", + "language_code": "cs" + }, + "AGENTS.md": { + "original_hash": "afc90918d008cf77fd1982691f681306", + "translation_date": "2025-10-03T08:42:15+00:00", + "source_file": "AGENTS.md", + "language_code": "cs" + }, + "CODE_OF_CONDUCT.md": { + "original_hash": "442b123d034f92f7c384d2bbd28f99f1", + "translation_date": "2025-07-21T20:37:27+00:00", + "source_file": "CODE_OF_CONDUCT.md", + "language_code": "cs" + }, + "README.md": { + "original_hash": "125a08948d881c95628094f4dd1fbd43", + "translation_date": "2026-01-29T16:07:25+00:00", + "source_file": "README.md", + "language_code": "cs" + }, + "SECURITY.md": { + "original_hash": "57f14126c1c6add76b3aef3844dfe4e3", + "translation_date": "2025-07-21T20:35:09+00:00", + "source_file": "SECURITY.md", + "language_code": "cs" + }, + "SUPPORT.md": { + "original_hash": "b8ef73cc49dec68e2c885ee9df545129", + "translation_date": "2025-07-21T20:38:43+00:00", + "source_file": "SUPPORT.md", + "language_code": "cs" + } +} \ No newline at end of file diff --git a/translations/cs/01-IntroToGenAI/README.md b/translations/cs/01-IntroToGenAI/README.md index eec9abe9..2d37d6da 100644 --- a/translations/cs/01-IntroToGenAI/README.md +++ b/translations/cs/01-IntroToGenAI/README.md @@ -1,12 +1,3 @@ - # Úvod do generativní AI - Java Edition ## Co se naučíte diff --git a/translations/cs/02-SetupDevEnvironment/README.md b/translations/cs/02-SetupDevEnvironment/README.md index 8494aea8..b094630b 100644 --- a/translations/cs/02-SetupDevEnvironment/README.md +++ b/translations/cs/02-SetupDevEnvironment/README.md @@ -1,13 +1,253 @@ - +# Nastavení vývojového prostředí pro Generative AI pro Javu +> **Rychlý začátek**: Kódujte v cloudu za 2 minuty – přejděte na [Nastavení GitHub Codespaces](../../../02-SetupDevEnvironment) – není potřeba žádná lokální instalace a používají se modely GitHubu! + +> **Máte zájem o Azure OpenAI?**, podívejte se na náš [Průvodce nastavením Azure OpenAI](getting-started-azure-openai.md) se kroky pro vytvoření nové Azure OpenAI služby. + +## Co se naučíte + +- Nastavení vývojového prostředí pro AI aplikace v Javě +- Výběr a konfigurace preferovaného vývojového prostředí (priorita cloudu s Codespaces, lokální dev kontejner nebo plná lokální instalace) +- Otestování vašeho nastavení připojením k GitHub modelům + +## Obsah + +- [Co se naučíte](../../../02-SetupDevEnvironment) +- [Úvod](../../../02-SetupDevEnvironment) +- [Krok 1: Nastavení vývojového prostředí](../../../02-SetupDevEnvironment) + - [Možnost A: GitHub Codespaces (doporučeno)](../../../02-SetupDevEnvironment) + - [Možnost B: Lokální dev kontejner](../../../02-SetupDevEnvironment) + - [Možnost C: Použijte svou existující lokální instalaci](../../../02-SetupDevEnvironment) +- [Krok 2: Vytvoření osobního přístupového tokenu GitHub](../../../02-SetupDevEnvironment) +- [Krok 3: Otestujte své nastavení](../../../02-SetupDevEnvironment) +- [Řešení problémů](../../../02-SetupDevEnvironment) +- [Shrnutí](../../../02-SetupDevEnvironment) +- [Další kroky](../../../02-SetupDevEnvironment) + +## Úvod + +Tato kapitola vás provede nastavením vývojového prostředí. Jako hlavní příklad využijeme **GitHub Models**, protože jsou zdarma, snadno se nastavují pouze se GitHub účtem, nevyžadují kreditní kartu a poskytují přístup k více modelům pro experimentování. + +**Není potřeba žádné lokální nastavení!** Můžete začít kódovat ihned s využitím GitHub Codespaces, které poskytuje plné vývojové prostředí ve vašem prohlížeči. + +Screenshot: GitHub Models + +Pro tento kurz doporučujeme používat [**GitHub Models**](https://github.com/marketplace?type=models), protože jsou: +- **Zdarma** pro zahájení +- **Snadno** se nastavují pouze s GitHub účtem +- **Bez požadavku na kreditní kartu** +- **S více modely** pro experimentování + +> **Poznámka**: GitHub Models použité v tomto školení mají tyto bezplatné limity: +> - 15 požadavků za minutu (150 denně) +> - cca 8 000 slov vstup, cca 4 000 slov výstup na jeden požadavek +> - 5 současných požadavků +> +> Pro produkční použití upgradujte na Azure AI Foundry Models s vaším Azure účtem. Kód není potřeba měnit. Viz [dokumentace Azure AI Foundry](https://learn.microsoft.com/azure/ai-foundry/foundry-models/how-to/quickstart-github-models). + +## Krok 1: Nastavení vývojového prostředí + + + +Vytvořili jsme předpřipravený vývojový kontejner, který minimalizuje dobu nastavení a zajišťuje, že máte všechny potřebné nástroje pro tento kurz Generative AI pro Javu. Vyberte si preferovaný způsob vývoje: + +### Možnosti nastavení prostředí: + +#### Možnost A: GitHub Codespaces (doporučeno) + +**Začněte kódovat za 2 minuty – není třeba žádná lokální instalace!** + +1. Forkněte tento repozitář do svého GitHub účtu + > **Poznámka**: Pokud chcete upravit základní konfiguraci, podívejte se na [Dev Container Configuration](../../../.devcontainer/devcontainer.json) +2. Klikněte na **Code** → záložka **Codespaces** → **...** → **New with options...** +3. Použijte výchozí nastavení – tím vyberete **Dev container configuration**: **Generative AI Java Development Environment** vlastní devcontainer vytvořený pro tento kurz +4. Klikněte na **Create codespace** +5. Počkejte cca 2 minuty, než bude prostředí připraveno +6. Pokračujte na [Krok 2: Vytvoření GitHub tokenu](../../../02-SetupDevEnvironment) + +Screenshot: Codespaces submenu + +Screenshot: New with options + +Screenshot: Create codespace options + + +> **Výhody Codespaces**: +> - Žádná lokální instalace není potřeba +> - Funguje na jakémkoli zařízení s prohlížečem +> - Předkonfigurované všechny nástroje a závislosti +> - Zdarma 60 hodin měsíčně pro osobní účty +> - Konzistentní prostředí pro všechny studenty + +#### Možnost B: Lokální dev kontejner + +**Pro vývojáře, kteří preferují lokální vývoj s Dockerem** + +1. Forkněte a naklonujte tento repozitář na svůj lokální počítač + > **Poznámka**: Pokud chcete upravit základní konfiguraci, podívejte se na [Dev Container Configuration](../../../.devcontainer/devcontainer.json) +2. Nainstalujte [Docker Desktop](https://www.docker.com/products/docker-desktop/) a [VS Code](https://code.visualstudio.com/) +3. Nainstalujte [Dev Containers rozšíření](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers) ve VS Code +4. Otevřete složku repozitáře ve VS Code +5. Při výzvě klikněte na **Reopen in Container** (nebo použijte `Ctrl+Shift+P` → "Dev Containers: Reopen in Container") +6. Počkejte na sestavení a spuštění kontejneru +7. Pokračujte na [Krok 2: Vytvoření GitHub tokenu](../../../02-SetupDevEnvironment) + +Screenshot: Dev container setup + +Screenshot: Dev container build complete + +#### Možnost C: Použijte svou existující lokální instalaci + +**Pro vývojáře s existujícím Java prostředím** + +Předpoklady: +- [Java 21+](https://www.oracle.com/java/technologies/javase/jdk21-archive-downloads.html) +- [Maven 3.9+](https://maven.apache.org/download.cgi) +- [VS Code](https://code.visualstudio.com) nebo váš preferovaný IDE + +Kroky: +1. Naklonujte tento repozitář na svůj lokální počítač +2. Otevřete projekt ve svém IDE +3. Pokračujte na [Krok 2: Vytvoření GitHub tokenu](../../../02-SetupDevEnvironment) + +> **Profesionální tip**: Pokud máte slabý počítač, ale chcete VS Code lokálně, použijte GitHub Codespaces! Můžete připojit svůj lokální VS Code na cloud-hostovaný Codespace a získat to nejlepší z obou světů. + +Screenshot: created local devcontainer instance + + +## Krok 2: Vytvoření osobního přístupového tokenu GitHub + +1. Přejděte do [Nastavení GitHubu](https://github.com/settings/profile) a vyberte **Settings** z menu svého profilu. +2. V levém bočním panelu klikněte na **Developer settings** (obvykle dole). +3. Pod **Personal access tokens** klikněte na **Fine-grained tokens** (nebo přímo využijte tento [odkaz](https://github.com/settings/personal-access-tokens)). +4. Klikněte na **Generate new token**. +5. Do "Token name" vložte popisný název (např. `GenAI-Java-Course-Token`). +6. Nastavte datum expirace (doporučeno: 7 dní z důvodu bezpečnosti). +7. Pod "Resource owner" vyberte svůj uživatelský účet. +8. Pod "Repository access" vyberte repozitáře, které chcete použít s GitHub Models (nebo "All repositories", pokud je potřeba). +9. Pod "Account permissions" najděte **Models** a nastavte na **Read-only**. +10. Klikněte na **Generate token**. +11. **Zkopírujte a uložte si token okamžitě** – znovu jej už neuvidíte! + +> **Bezpečnostní tip**: Používejte minimální potřebné oprávnění a co nejkratší praktickou dobu platnosti přístupových tokenů. + +## Krok 3: Otestujte své nastavení s příkladem GitHub Models + +Jakmile je vaše vývojové prostředí připraveno, otestujeme integraci GitHub Models pomocí našeho ukázkového projektu v [`02-SetupDevEnvironment/examples/github-models`](../../../02-SetupDevEnvironment/examples/github-models). + +1. Otevřete terminál ve svém vývojovém prostředí. +2. Přejděte do složky s příkladem GitHub Models: + ```bash + cd 02-SetupDevEnvironment/examples/github-models + ``` +3. Nastavte svůj GitHub token jako proměnnou prostředí: + ```bash + # macOS/Linux + export GITHUB_TOKEN=your_token_here + + # Windows (Příkazový řádek) + set GITHUB_TOKEN=your_token_here + + # Windows (PowerShell) + $env:GITHUB_TOKEN="your_token_here" + ``` + +4. Spusťte aplikaci: + ```bash + mvn compile exec:java -Dexec.mainClass="com.example.githubmodels.App" + ``` + +Měli byste vidět výstup podobný tomuto: +```text +Using model: gpt-4.1-nano +Sending request to GitHub Models... +Response: Hello World! +``` + +### Pochopení příkladového kódu + +Nejprve se podívejme, co jsme právě spustili. Příklad v `examples/github-models` využívá OpenAI Java SDK k připojení k GitHub Models: + +**Co tento kód dělá:** +- **Připojuje** se k GitHub Models pomocí vašeho osobního přístupového tokenu +- **Posílá** jednoduchou zprávu "Say Hello World!" AI modelu +- **Přijímá** a zobrazuje odpověď AI +- **Ověřuje**, že vaše nastavení funguje správně + +**Klíčová závislost** (v `pom.xml`): +```xml + + com.openai + openai-java + 2.12.0 + +``` + +**Hlavní kód** (`App.java`): +```java +// Připojte se k modelům GitHub pomocí OpenAI Java SDK +OpenAIClient client = OpenAIOkHttpClient.builder() + .apiKey(pat) + .baseUrl("https://models.inference.ai.azure.com") + .build(); + +// Vytvořte požadavek na dokončení chatu +ChatCompletionCreateParams params = ChatCompletionCreateParams.builder() + .model(modelId) + .addSystemMessage("You are a concise assistant.") + .addUserMessage("Say Hello World!") + .build(); + +// Získejte odpověď AI +ChatCompletion response = client.chat().completions().create(params); +System.out.println("Response: " + response.choices().get(0).message().content().orElse("No response content")); +``` + +## Shrnutí + +Skvělé! Nyní máte vše nastaveno: + +- Vytvořen osobní přístupový token GitHub s správnými oprávněními pro přístup k AI modelům +- Nasměrováno a spuštěno své Java vývojové prostředí (ať už Codespaces, dev kontejnery nebo lokálně) +- Připojeno k GitHub Models pomocí OpenAI Java SDK zdarma pro vývoj AI +- Otestováno, že vše funguje, pomocí jednoduchého příkladu, který komunikuje s AI modely + +## Další kroky + +[Kapitola 3: Základní techniky generativní AI](../03-CoreGenerativeAITechniques/README.md) + +## Řešení problémů + +Máte problémy? Zde jsou běžné problémy a jejich řešení: + +- **Token nefunguje?** + - Zkontrolujte, že jste zkopírovali celý token bez mezer navíc + - Ověřte, že je token správně nastaven jako proměnná prostředí + - Zkontrolujte, zda má token správná oprávnění (Models: Read-only) + +- **Maven není nalezen?** + - Pokud používáte dev kontejnery/Codespaces, Maven by měl být předinstalovaný + - Pro lokální setup zajistěte instalaci Java 21+ a Maven 3.9+ + - Použijte příkaz `mvn --version` k ověření instalace + +- **Problémy s připojením?** + - Zkontrolujte své internetové připojení + - Ověřte dostupnost GitHubu z vaší sítě + - Ujistěte se, že nemáte firewall blokující přístup k GitHub Models endpointu + +- **Dev container se nespouští?** + - Zkontrolujte, že Docker Desktop běží (pro lokální vývoj) + - Zkuste rekonstrukci kontejneru: `Ctrl+Shift+P` → "Dev Containers: Rebuild Container" + +- **Chyby při kompilaci aplikace?** + - Ujistěte se, že jste ve správném adresáři: `02-SetupDevEnvironment/examples/github-models` + - Zkuste čistou kompilaci: `mvn clean compile` + +> **Potřebujete pomoc?**: Pokud problémy přetrvávají, otevřete issue v repozitáři a rádi vám pomůžeme. --- + +**Prohlášení o vyloučení odpovědnosti**: +Tento dokument byl přeložen pomocí AI překladatelské služby [Co-op Translator](https://github.com/Azure/co-op-translator). I když usilujeme o přesnost, vezměte prosím na vědomí, že automatické překlady mohou obsahovat chyby nebo nepřesnosti. Původní dokument v jeho mateřském jazyce by měl být považován za autoritativní zdroj. Pro kritické informace se doporučuje profesionální lidský překlad. Nejsme odpovědní za jakákoliv nedorozumění nebo nesprávné výklady vyplývající z použití tohoto překladu. + \ No newline at end of file diff --git a/translations/cs/02-SetupDevEnvironment/examples/basic-chat-azure/README.md b/translations/cs/02-SetupDevEnvironment/examples/basic-chat-azure/README.md index 70c8c25c..f569e16c 100644 --- a/translations/cs/02-SetupDevEnvironment/examples/basic-chat-azure/README.md +++ b/translations/cs/02-SetupDevEnvironment/examples/basic-chat-azure/README.md @@ -1,12 +1,3 @@ - # Základní chat s Azure OpenAI - Kompletní příklad Tento příklad ukazuje, jak vytvořit jednoduchou aplikaci Spring Boot, která se připojuje k Azure OpenAI a testuje vaše nastavení. diff --git a/translations/cs/02-SetupDevEnvironment/getting-started-azure-openai.md b/translations/cs/02-SetupDevEnvironment/getting-started-azure-openai.md index 3829b192..a6ef0856 100644 --- a/translations/cs/02-SetupDevEnvironment/getting-started-azure-openai.md +++ b/translations/cs/02-SetupDevEnvironment/getting-started-azure-openai.md @@ -1,12 +1,3 @@ - # Nastavení vývojového prostředí pro Azure OpenAI > **Rychlý start**: Tento průvodce je určen pro nastavení Azure OpenAI. Pro okamžitý začátek s bezplatnými modely použijte [GitHub Models with Codespaces](./README.md#quick-start-cloud). diff --git a/translations/cs/03-CoreGenerativeAITechniques/README.md b/translations/cs/03-CoreGenerativeAITechniques/README.md index 22d5ce7e..d525e082 100644 --- a/translations/cs/03-CoreGenerativeAITechniques/README.md +++ b/translations/cs/03-CoreGenerativeAITechniques/README.md @@ -1,12 +1,3 @@ - # Návod na základní techniky generativní AI ## Obsah diff --git a/translations/cs/04-PracticalSamples/README.md b/translations/cs/04-PracticalSamples/README.md index 57b159cd..3b706e28 100644 --- a/translations/cs/04-PracticalSamples/README.md +++ b/translations/cs/04-PracticalSamples/README.md @@ -1,12 +1,3 @@ - # Praktické aplikace a projekty ## Co se naučíte diff --git a/translations/cs/04-PracticalSamples/calculator/README.md b/translations/cs/04-PracticalSamples/calculator/README.md index 95efd68a..1e7d6443 100644 --- a/translations/cs/04-PracticalSamples/calculator/README.md +++ b/translations/cs/04-PracticalSamples/calculator/README.md @@ -1,12 +1,3 @@ - # Návod na MCP kalkulačku pro začátečníky ## Obsah diff --git a/translations/cs/04-PracticalSamples/foundrylocal/README.md b/translations/cs/04-PracticalSamples/foundrylocal/README.md index 9750eaf7..0b8b902b 100644 --- a/translations/cs/04-PracticalSamples/foundrylocal/README.md +++ b/translations/cs/04-PracticalSamples/foundrylocal/README.md @@ -1,12 +1,3 @@ - # Foundry Local Spring Boot Tutorial ## Obsah diff --git a/translations/cs/04-PracticalSamples/petstory/README.md b/translations/cs/04-PracticalSamples/petstory/README.md index 75dd5ee3..81705252 100644 --- a/translations/cs/04-PracticalSamples/petstory/README.md +++ b/translations/cs/04-PracticalSamples/petstory/README.md @@ -1,12 +1,3 @@ - # Generátor příběhů o mazlíčcích - tutoriál pro začátečníky ## Obsah diff --git a/translations/cs/05-ResponsibleGenAI/README.md b/translations/cs/05-ResponsibleGenAI/README.md index 2e0c6e23..5f846cd4 100644 --- a/translations/cs/05-ResponsibleGenAI/README.md +++ b/translations/cs/05-ResponsibleGenAI/README.md @@ -1,12 +1,3 @@ - # Odpovědná generativní AI ## Co se naučíte diff --git a/translations/cs/AGENTS.md b/translations/cs/AGENTS.md index 9dee63bc..5b8ea940 100644 --- a/translations/cs/AGENTS.md +++ b/translations/cs/AGENTS.md @@ -1,12 +1,3 @@ - # AGENTS.md ## Přehled projektu diff --git a/translations/cs/CODE_OF_CONDUCT.md b/translations/cs/CODE_OF_CONDUCT.md index 37dddb57..5bfef455 100644 --- a/translations/cs/CODE_OF_CONDUCT.md +++ b/translations/cs/CODE_OF_CONDUCT.md @@ -1,12 +1,3 @@ - # Kodex chování pro otevřený zdroj Microsoftu Tento projekt přijal [Kodex chování pro otevřený zdroj Microsoftu](https://opensource.microsoft.com/codeofconduct/). diff --git a/translations/cs/README.md b/translations/cs/README.md index 5ae3b26c..cb2d5dbc 100644 --- a/translations/cs/README.md +++ b/translations/cs/README.md @@ -1,90 +1,81 @@ - -# Generativní AI pro začátečníky - edice Java +# Generativní AI pro začátečníky - Java edice [![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) -![Generativní AI pro začátečníky - edice Java](../../translated_images/cs/beg-genai-series.8b48be9951cc574c.webp) +![Generativní AI pro začátečníky - Java edice](../../translated_images/cs/beg-genai-series.8b48be9951cc574c.webp) -**Časová náročnost**: Celý workshop lze dokončit online bez lokální instalace. Nastavení prostředí zabere 2 minuty, prozkoumání ukázek vyžaduje 1–3 hodiny podle hloubky průzkumu. +**Časová náročnost**: Celý workshop lze dokončit online bez lokální instalace. Nastavení prostředí trvá 2 minuty, prozkoumání ukázek vyžaduje 1–3 hodiny podle hloubky prozkoumání. > **Rychlý start** -1. Forkněte si tento repozitář na svůj GitHub účet -2. Klikněte na **Code** → záložka **Codespaces** → **...** → **Nový s možnostmi...** -3. Použijte výchozí nastavení – vybere se vývojový kontejner vytvořený pro tento kurz -4. Klikněte na **Vytvořit codespace** -5. Počkejte ~2 minuty na připravení prostředí -6. Přejděte rovnou na [První příklad](./02-SetupDevEnvironment/README.md#step-2-create-a-github-personal-access-token) +1. Vytvořte fork tohoto repozitáře na svém GitHub účtu +2. Klikněte na **Code** → záložku **Codespaces** → **...** → **New with options...** +3. Použijte výchozí nastavení – tím vyberete vývojový kontejner vytvořený pro tento kurz +4. Klikněte na **Create codespace** +5. Počkejte přibližně 2 minuty, než bude prostředí připravené +6. Přejděte přímo na [První příklad](./02-SetupDevEnvironment/README.md#step-2-create-a-github-personal-access-token) -> **Preferujete klonovat lokálně?** +> **Raději klonovat lokálně?** -> Tento repozitář obsahuje více než 50 jazykových překladů, které výrazně zvětšují velikost stahování. Pro klonování bez překladů použijte sparse checkout: +> Tento repozitář obsahuje přes 50 jazykových překladů, což výrazně zvětšuje velikost stahování. Pro klonování bez překladů použijte sparse checkout: > ```bash > git clone --filter=blob:none --sparse https://github.com/microsoft/Generative-AI-for-beginners-java.git > cd Generative-AI-for-beginners-java > git sparse-checkout set --no-cone '/*' '!translations' '!translated_images' > ``` -> Tím získáte vše potřebné k dokončení kurzu s výrazně rychlejším stažením. +> Tím získáte vše potřebné k dokončení kurzu s mnohem rychlejším stažením. -## Podpora vícejazyčnosti +## Podpora více jazyků -### Podporováno přes GitHub Action (automatické a vždy aktuální) +### Podpora přes GitHub Action (automatizované a vždy aktuální) -[Arabština](../ar/README.md) | [Bengálština](../bn/README.md) | [Bulharština](../bg/README.md) | [Barmština (Myanmar)](../my/README.md) | [Čínština (zjednodušená)](../zh/README.md) | [Čínština (tradiční, Hongkong)](../hk/README.md) | [Čínština (tradiční, Macao)](../mo/README.md) | [Čínština (tradiční, Tchajwan)](../tw/README.md) | [Chorvatština](../hr/README.md) | [Čeština](./README.md) | [Dánština](../da/README.md) | [Nizozemština](../nl/README.md) | [Estonština](../et/README.md) | [Finština](../fi/README.md) | [Francouzština](../fr/README.md) | [Němčina](../de/README.md) | [Řečtina](../el/README.md) | [Hebrejština](../he/README.md) | [Hindština](../hi/README.md) | [Maďarština](../hu/README.md) | [Indonéština](../id/README.md) | [Italština](../it/README.md) | [Japonština](../ja/README.md) | [Kannadština](../kn/README.md) | [Korejština](../ko/README.md) | [Litevština](../lt/README.md) | [Malajština](../ms/README.md) | [Malayalam](../ml/README.md) | [Maráthština](../mr/README.md) | [Nepálština](../ne/README.md) | [Nigérijský pidžin](../pcm/README.md) | [Norština](../no/README.md) | [Perština (Fársí)](../fa/README.md) | [Polština](../pl/README.md) | [Portugalština (Brazílie)](../br/README.md) | [Portugalština (Portugalsko)](../pt/README.md) | [Paňdžábština (Gurmukhí)](../pa/README.md) | [Rumunština](../ro/README.md) | [Ruština](../ru/README.md) | [Srbština (cyrilice)](../sr/README.md) | [Slovenština](../sk/README.md) | [Slovinština](../sl/README.md) | [Španělština](../es/README.md) | [Svahilština](../sw/README.md) | [Švédština](../sv/README.md) | [Tagalog (filipínština)](../tl/README.md) | [Tamilština](../ta/README.md) | [Telugština](../te/README.md) | [Thajština](../th/README.md) | [Turečtina](../tr/README.md) | [Ukrajinština](../uk/README.md) | [Urdu](../ur/README.md) | [Vietnamština](../vi/README.md) +[Arabština](../ar/README.md) | [Bengálština](../bn/README.md) | [Bulharština](../bg/README.md) | [Barmština (Myanmar)](../my/README.md) | [Čínština (zjednodušená)](../zh-CN/README.md) | [Čínština (tradiční, Hongkong)](../zh-HK/README.md) | [Čínština (tradiční, Macao)](../zh-MO/README.md) | [Čínština (tradiční, Tchaj-wan)](../zh-TW/README.md) | [Chorvatština](../hr/README.md) | [Čeština](./README.md) | [Dánština](../da/README.md) | [Nizozemština](../nl/README.md) | [Estonština](../et/README.md) | [Finština](../fi/README.md) | [Francouzština](../fr/README.md) | [Němčina](../de/README.md) | [Řečtina](../el/README.md) | [Hebrejština](../he/README.md) | [Hindi](../hi/README.md) | [Maďarština](../hu/README.md) | [Indonéština](../id/README.md) | [Italština](../it/README.md) | [Japonština](../ja/README.md) | [Kannadština](../kn/README.md) | [Korejština](../ko/README.md) | [Litevština](../lt/README.md) | [Malajština](../ms/README.md) | [Malajalámština](../ml/README.md) | [Maráthština](../mr/README.md) | [Nepálština](../ne/README.md) | [Nigerijský pidžin](../pcm/README.md) | [Norština](../no/README.md) | [Perština (Farsi)](../fa/README.md) | [Polština](../pl/README.md) | [Portugalština (Brazílie)](../pt-BR/README.md) | [Portugalština (Portugalsko)](../pt-PT/README.md) | [Paňdžábština (Gurmukhí)](../pa/README.md) | [Rumunština](../ro/README.md) | [Ruština](../ru/README.md) | [Srbština (cyrilice)](../sr/README.md) | [Slovenština](../sk/README.md) | [Slovinština](../sl/README.md) | [Španělština](../es/README.md) | [Svahilština](../sw/README.md) | [Švédština](../sv/README.md) | [Tagalog (Filipínština)](../tl/README.md) | [Tamilština](../ta/README.md) | [Telugština](../te/README.md) | [Thajština](../th/README.md) | [Turečtina](../tr/README.md) | [Ukrajinština](../uk/README.md) | [Urdu](../ur/README.md) | [Vietnamština](../vi/README.md) -> **Preferujete klonovat lokálně?** +> **Raději klonovat lokálně?** -> Tento repozitář obsahuje více než 50 jazykových překladů, které výrazně zvětšují velikost stahování. Pro klonování bez překladů použijte sparse checkout: +> Tento repozitář obsahuje přes 50 jazykových překladů, což výrazně zvětšuje velikost stahování. Pro klonování bez překladů použijte sparse checkout: > ```bash > git clone --filter=blob:none --sparse https://github.com/microsoft/Generative-AI-for-beginners-java.git > cd Generative-AI-for-beginners-java > git sparse-checkout set --no-cone '/*' '!translations' '!translated_images' > ``` -> Tím získáte vše potřebné k dokončení kurzu s výrazně rychlejším stažením. +> Tím získáte vše potřebné k dokončení kurzu s mnohem rychlejším stažením. ## Struktura kurzu a učební cesta ### **Kapitola 1: Úvod do generativní AI** -- **Základní pojmy**: Pochopení velkých jazykových modelů, tokenů, embeddingů a schopností AI -- **Ekosystém Java AI**: Přehled Spring AI a OpenAI SDK -- **Protokol pro kontext modelu**: Úvod do MCP a jeho role v komunikaci AI agentů -- **Praktické aplikace**: Reálné scénáře včetně chatbotů a generování obsahu -- **[→ Zahájit kapitolu 1](./01-IntroToGenAI/README.md)** +- **Základní pojmy**: Pochopení velkých jazykových modelů, tokenů, embeddingů a AI schopností +- **Java AI ekosystém**: Přehled Spring AI a OpenAI SDK +- **Protokol kontextu modelu**: Úvod do MCP a jeho role v komunikaci AI agentů +- **Praktické aplikace**: Reálné scénáře včetně chatbotů a generování obsahu +- **[→ Začít kapitolu 1](./01-IntroToGenAI/README.md)** ### **Kapitola 2: Nastavení vývojového prostředí** -- **Konfigurace více poskytovatelů**: Nastavení GitHub Models, Azure OpenAI a OpenAI Java SDK integrací -- **Spring Boot + Spring AI**: Nejlepší postupy pro vývoj podnikových AI aplikací -- **GitHub Models**: Bezplatný přístup k AI modelům pro prototypování a učení (není potřeba kreditní karta) -- **Vývojové nástroje**: Kontejnery Docker, VS Code a konfigurace GitHub Codespaces -- **[→ Zahájit kapitolu 2](./02-SetupDevEnvironment/README.md)** - -### **Kapitola 3: Základní techniky generativní AI** -- **Prompt Engineering**: Techniky pro optimální odpovědi AI modelů -- **Embeddingy a vektorové operace**: Implementace sémantického vyhledávání a porovnávání podobnosti -- **Retrieval-Augmented Generation (RAG)**: Kombinace AI s vašimi vlastními datovými zdroji -- **Volání funkcí**: Rozšíření schopností AI pomocí vlastních nástrojů a pluginů -- **[→ Zahájit kapitolu 3](./03-CoreGenerativeAITechniques/README.md)** +- **Konfigurace více poskytovatelů**: Nastavení GitHub Models, Azure OpenAI a OpenAI Java SDK integrací +- **Spring Boot + Spring AI**: Nejlepší postupy pro vývoj podnikového AI +- **GitHub Models**: Volný přístup k AI modelům pro prototypování a učení (není potřeba kreditní karta) +- **Vývojové nástroje**: Kontejnery Docker, VS Code a konfigurace GitHub Codespaces +- **[→ Začít kapitolu 2](./02-SetupDevEnvironment/README.md)** + +### **Kapitola 3: Klíčové techniky generativní AI** +- **Prompt engineering**: Techniky pro optimální odpovědi AI modelů +- **Embeddingy a vektorové operace**: Implementace sémantického vyhledávání a porovnávání podobnosti +- **Retrieval-Augmented Generation (RAG)**: Kombinujte AI s vlastními zdroji dat +- **Volání funkcí**: Rozšiřte schopnosti AI pomocí vlastních nástrojů a pluginů +- **[→ Začít kapitolu 3](./03-CoreGenerativeAITechniques/README.md)** ### **Kapitola 4: Praktické aplikace a projekty** -- **Generátor příběhů o mazlíčcích** (`petstory/`): Kreativní generování obsahu s GitHub Models -- **Demo Foundry lokálně** (`foundrylocal/`): Lokální integrace AI modelu s OpenAI Java SDK -- **Služba kalkulačky MCP** (`calculator/`): Základní implementace Model Context Protocol pomocí Spring AI -- **[→ Zahájit kapitolu 4](./04-PracticalSamples/README.md)** +- **Generátor příběhů o mazlíčcích** (`petstory/`): Kreativní generování obsahu s GitHub Models +- **Foundry lokální demo** (`foundrylocal/`): Lokální integrace AI modelu s OpenAI Java SDK +- **MCP kalkulační služba** (`calculator/`): Základní implementace Model Context Protocol se Spring AI +- **[→ Začít kapitolu 4](./04-PracticalSamples/README.md)** ### **Kapitola 5: Odpovědný vývoj AI** -- **Bezpečnost GitHub Models**: Testování vestavěného filtrování obsahu a bezpečnostních mechanismů (tvrdé blokace a měkké odmítnutí) -- **Demo odpovědné AI**: Praktický příklad ukazující, jak fungují moderní bezpečnostní systémy AI -- **Nejlepší postupy**: Zásadní pokyny pro etický vývoj a nasazení AI -- **[→ Zahájit kapitolu 5](./05-ResponsibleGenAI/README.md)** +- **Bezpečnost GitHub Models**: Testování vestavěného filtrování obsahu a bezpečnostních mechanismů (pevné blokace a měkké odmítnutí) +- **Demo odpovědného AI**: Praktický příklad ukazující, jak fungují moderní bezpečnostní systémy AI +- **Nejlepší postupy**: Základní zásady pro etický vývoj a nasazení AI +- **[→ Začít kapitolu 5](./05-ResponsibleGenAI/README.md)** ## Další zdroje @@ -95,14 +86,14 @@ CO_OP_TRANSLATOR_METADATA: --- -### Azure / Edge / MCP / Agent +### Azure / Edge / MCP / Agenti [![AZD pro začátečníky](https://img.shields.io/badge/AZD%20for%20Beginners-0078D4?style=for-the-badge&labelColor=E5E7EB&color=0078D4)](https://github.com/microsoft/AZD-for-beginners?WT.mc_id=academic-105485-koreyst) [![Edge AI pro začátečníky](https://img.shields.io/badge/Edge%20AI%20for%20Beginners-00B8E4?style=for-the-badge&labelColor=E5E7EB&color=00B8E4)](https://github.com/microsoft/edgeai-for-beginners?WT.mc_id=academic-105485-koreyst) [![MCP pro začátečníky](https://img.shields.io/badge/MCP%20for%20Beginners-009688?style=for-the-badge&labelColor=E5E7EB&color=009688)](https://github.com/microsoft/mcp-for-beginners?WT.mc_id=academic-105485-koreyst) [![AI agenti pro začátečníky](https://img.shields.io/badge/AI%20Agents%20for%20Beginners-00C49A?style=for-the-badge&labelColor=E5E7EB&color=00C49A)](https://github.com/microsoft/ai-agents-for-beginners?WT.mc_id=academic-105485-koreyst) --- - + ### Série Generativní AI [![Generativní AI pro začátečníky](https://img.shields.io/badge/Generative%20AI%20for%20Beginners-8B5CF6?style=for-the-badge&labelColor=E5E7EB&color=8B5CF6)](https://github.com/microsoft/generative-ai-for-beginners?WT.mc_id=academic-105485-koreyst) [![Generativní AI (.NET)](https://img.shields.io/badge/Generative%20AI%20(.NET)-9333EA?style=for-the-badge&labelColor=E5E7EB&color=9333EA)](https://github.com/microsoft/Generative-AI-for-beginners-dotnet?WT.mc_id=academic-105485-koreyst) @@ -110,37 +101,38 @@ CO_OP_TRANSLATOR_METADATA: [![Generativní AI (JavaScript)](https://img.shields.io/badge/Generative%20AI%20(JavaScript)-E879F9?style=for-the-badge&labelColor=E5E7EB&color=E879F9)](https://github.com/microsoft/generative-ai-with-javascript?WT.mc_id=academic-105485-koreyst) --- - -### Klíčové učení + +### Základní vzdělávání [![Strojové učení pro začátečníky](https://img.shields.io/badge/ML%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=22C55E)](https://aka.ms/ml-beginners?WT.mc_id=academic-105485-koreyst) -[![Datová věda pro začátečníky](https://img.shields.io/badge/Data%20Science%20for%20Beginners-84CC16?style=for-the-badge&labelColor=E5E7EB&color=84CC16)](https://aka.ms/datascience-beginners?WT.mc_id=academic-105485-koreyst) +[![Data Science pro začátečníky](https://img.shields.io/badge/Data%20Science%20for%20Beginners-84CC16?style=for-the-badge&labelColor=E5E7EB&color=84CC16)](https://aka.ms/datascience-beginners?WT.mc_id=academic-105485-koreyst) [![AI pro začátečníky](https://img.shields.io/badge/AI%20for%20Beginners-A3E635?style=for-the-badge&labelColor=E5E7EB&color=A3E635)](https://aka.ms/ai-beginners?WT.mc_id=academic-105485-koreyst) [![Kybernetická bezpečnost pro začátečníky](https://img.shields.io/badge/Cybersecurity%20for%20Beginners-F97316?style=for-the-badge&labelColor=E5E7EB&color=F97316)](https://github.com/microsoft/Security-101?WT.mc_id=academic-96948-sayoung) -[![Webový vývoj pro začátečníky](https://img.shields.io/badge/Web%20Dev%20for%20Beginners-EC4899?style=for-the-badge&labelColor=E5E7EB&color=EC4899)](https://aka.ms/webdev-beginners?WT.mc_id=academic-105485-koreyst) -[![IoT pro začátečníky](https://img.shields.io/badge/IoT%20for%20Beginners-14B8A6?style=for-the-badge&labelColor=E5E7EB&color=14B8A6)](https://aka.ms/iot-beginners?WT.mc_id=academic-105485-koreyst) -[![Vývoj XR pro začátečníky](https://img.shields.io/badge/XR%20Development%20for%20Beginners-38BDF8?style=for-the-badge&labelColor=E5E7EB&color=38BDF8)](https://github.com/microsoft/xr-development-for-beginners?WT.mc_id=academic-105485-koreyst) + +[![Web Dev for Beginners](https://img.shields.io/badge/Web%20Dev%20for%20Beginners-EC4899?style=for-the-badge&labelColor=E5E7EB&color=EC4899)](https://aka.ms/webdev-beginners?WT.mc_id=academic-105485-koreyst) +[![IoT for Beginners](https://img.shields.io/badge/IoT%20for%20Beginners-14B8A6?style=for-the-badge&labelColor=E5E7EB&color=14B8A6)](https://aka.ms/iot-beginners?WT.mc_id=academic-105485-koreyst) +[![XR Development for Beginners](https://img.shields.io/badge/XR%20Development%20for%20Beginners-38BDF8?style=for-the-badge&labelColor=E5E7EB&color=38BDF8)](https://github.com/microsoft/xr-development-for-beginners?WT.mc_id=academic-105485-koreyst) --- ### Série Copilot -[![Copilot pro AI párové programování](https://img.shields.io/badge/Copilot%20for%20AI%20Paired%20Programming-FACC15?style=for-the-badge&labelColor=E5E7EB&color=FACC15)](https://aka.ms/GitHubCopilotAI?WT.mc_id=academic-105485-koreyst) -[![Copilot pro C#/.NET](https://img.shields.io/badge/Copilot%20for%20C%23/.NET-FBBF24?style=for-the-badge&labelColor=E5E7EB&color=FBBF24)](https://github.com/microsoft/mastering-github-copilot-for-dotnet-csharp-developers?WT.mc_id=academic-105485-koreyst) -[![Dobrodružství Copilot](https://img.shields.io/badge/Copilot%20Adventure-FDE68A?style=for-the-badge&labelColor=E5E7EB&color=FDE68A)](https://github.com/microsoft/CopilotAdventures?WT.mc_id=academic-105485-koreyst) +[![Copilot for AI Paired Programming](https://img.shields.io/badge/Copilot%20for%20AI%20Paired%20Programming-FACC15?style=for-the-badge&labelColor=E5E7EB&color=FACC15)](https://aka.ms/GitHubCopilotAI?WT.mc_id=academic-105485-koreyst) +[![Copilot for C#/.NET](https://img.shields.io/badge/Copilot%20for%20C%23/.NET-FBBF24?style=for-the-badge&labelColor=E5E7EB&color=FBBF24)](https://github.com/microsoft/mastering-github-copilot-for-dotnet-csharp-developers?WT.mc_id=academic-105485-koreyst) +[![Copilot Adventure](https://img.shields.io/badge/Copilot%20Adventure-FDE68A?style=for-the-badge&labelColor=E5E7EB&color=FDE68A)](https://github.com/microsoft/CopilotAdventures?WT.mc_id=academic-105485-koreyst) ## Získání pomoci -Pokud se zaseknete nebo máte jakékoli otázky ohledně tvorby AI aplikací, připojte se ke komunitě spolužáků a zkušených vývojářů v diskuzích o MCP. Je to podpůrná komunita, kde jsou otázky vítány a znalosti se volně sdílejí. +Pokud narazíte na problémy nebo máte jakékoli otázky ohledně tvorby AI aplikací. Přidejte se k ostatním studentům a zkušeným vývojářům v diskuzích o MCP. Je to podpůrná komunita, kde jsou otázky vítány a znalosti se svobodně sdílejí. [![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) -Pokud máte zpětnou vazbu k produktu nebo narazíte na chyby při vývoji, navštivte: +Pokud máte zpětnou vazbu k produktu nebo chyby při vývoji, navštivte: [![Microsoft Foundry Developer Forum](https://img.shields.io/badge/GitHub-Microsoft_Foundry_Developer_Forum-blue?style=for-the-badge&logo=github&color=000000&logoColor=fff)](https://aka.ms/foundry/forum) --- -**Prohlášení o vyloučení odpovědnosti**: -Tento dokument byl přeložen pomocí AI překladatelské služby [Co-op Translator](https://github.com/Azure/co-op-translator). Přestože se snažíme o přesnost, mějte prosím na paměti, že automatické překlady mohou obsahovat chyby či nepřesnosti. Originální dokument v jeho mateřském jazyce by měl být považován za závazný zdroj. Pro zásadní informace se doporučuje využít profesionální lidský překlad. Nejsme odpovědní za jakékoliv nedorozumění či nesprávné interpretace vyplývající z použití tohoto překladu. +**Upozornění**: +Tento dokument byl přeložen pomocí AI překladatelské služby [Co-op Translator](https://github.com/Azure/co-op-translator). Přestože usilujeme o přesnost, mějte prosím na paměti, že automatické překlady mohou obsahovat chyby nebo nepřesnosti. Originální dokument v jeho původním jazyce by měl být považován za autoritativní zdroj. Pro kritické informace se doporučuje využít profesionální lidský překlad. Neneseme odpovědnost za jakékoliv nedorozumění či nesprávné výklady vyplývající z použití tohoto překladu. \ No newline at end of file diff --git a/translations/cs/SECURITY.md b/translations/cs/SECURITY.md index b5cda1d2..94d16b61 100644 --- a/translations/cs/SECURITY.md +++ b/translations/cs/SECURITY.md @@ -1,12 +1,3 @@ - ## Zabezpečení Microsoft bere bezpečnost svých softwarových produktů a služeb vážně, což zahrnuje všechny repozitáře zdrojového kódu spravované prostřednictvím našich organizací na GitHubu, mezi které patří [Microsoft](https://github.com/Microsoft), [Azure](https://github.com/Azure), [DotNet](https://github.com/dotnet), [AspNet](https://github.com/aspnet) a [Xamarin](https://github.com/xamarin). diff --git a/translations/cs/SUPPORT.md b/translations/cs/SUPPORT.md index ab92a279..a614a5cf 100644 --- a/translations/cs/SUPPORT.md +++ b/translations/cs/SUPPORT.md @@ -1,12 +1,3 @@ - # Podpora ## Jak nahlásit problémy a získat pomoc diff --git a/translations/da/.co-op-translator.json b/translations/da/.co-op-translator.json new file mode 100644 index 00000000..af3beb9e --- /dev/null +++ b/translations/da/.co-op-translator.json @@ -0,0 +1,92 @@ +{ + "01-IntroToGenAI/README.md": { + "original_hash": "75bfb080ca725e8a9aa9c80cae25fba1", + "translation_date": "2025-07-29T09:27:11+00:00", + "source_file": "01-IntroToGenAI/README.md", + "language_code": "da" + }, + "02-SetupDevEnvironment/README.md": { + "original_hash": "96a30d42b9751a3d4e4b20e28d29d459", + "translation_date": "2026-01-28T05:04:32+00:00", + "source_file": "02-SetupDevEnvironment/README.md", + "language_code": "da" + }, + "02-SetupDevEnvironment/examples/basic-chat-azure/README.md": { + "original_hash": "efd82efe50711d7e257eb943151d682c", + "translation_date": "2025-07-27T13:42:20+00:00", + "source_file": "02-SetupDevEnvironment/examples/basic-chat-azure/README.md", + "language_code": "da" + }, + "02-SetupDevEnvironment/getting-started-azure-openai.md": { + "original_hash": "bfdb4b4eadbee3a59ef742439f58326a", + "translation_date": "2025-07-27T13:13:27+00:00", + "source_file": "02-SetupDevEnvironment/getting-started-azure-openai.md", + "language_code": "da" + }, + "03-CoreGenerativeAITechniques/README.md": { + "original_hash": "685f55cb07de19b52a30ce6e8b6d889e", + "translation_date": "2025-08-28T22:08:14+00:00", + "source_file": "03-CoreGenerativeAITechniques/README.md", + "language_code": "da" + }, + "04-PracticalSamples/README.md": { + "original_hash": "14c0a61ecc1cd2012a9c129236dfdf71", + "translation_date": "2025-07-29T09:26:58+00:00", + "source_file": "04-PracticalSamples/README.md", + "language_code": "da" + }, + "04-PracticalSamples/calculator/README.md": { + "original_hash": "b6c16b5514d524e415a94f6097ee7d4c", + "translation_date": "2025-09-18T15:34:18+00:00", + "source_file": "04-PracticalSamples/calculator/README.md", + "language_code": "da" + }, + "04-PracticalSamples/foundrylocal/README.md": { + "original_hash": "f787307400de59adc25a1404466a35f3", + "translation_date": "2025-11-04T07:26:47+00:00", + "source_file": "04-PracticalSamples/foundrylocal/README.md", + "language_code": "da" + }, + "04-PracticalSamples/petstory/README.md": { + "original_hash": "0cbf68d605615a1e602c832a24616859", + "translation_date": "2025-07-25T11:31:56+00:00", + "source_file": "04-PracticalSamples/petstory/README.md", + "language_code": "da" + }, + "05-ResponsibleGenAI/README.md": { + "original_hash": "301c05c2f57e60a6950b8c665b8bdbba", + "translation_date": "2025-07-29T15:52:33+00:00", + "source_file": "05-ResponsibleGenAI/README.md", + "language_code": "da" + }, + "AGENTS.md": { + "original_hash": "afc90918d008cf77fd1982691f681306", + "translation_date": "2025-10-03T08:37:31+00:00", + "source_file": "AGENTS.md", + "language_code": "da" + }, + "CODE_OF_CONDUCT.md": { + "original_hash": "442b123d034f92f7c384d2bbd28f99f1", + "translation_date": "2025-07-21T19:08:22+00:00", + "source_file": "CODE_OF_CONDUCT.md", + "language_code": "da" + }, + "README.md": { + "original_hash": "125a08948d881c95628094f4dd1fbd43", + "translation_date": "2026-01-29T15:52:26+00:00", + "source_file": "README.md", + "language_code": "da" + }, + "SECURITY.md": { + "original_hash": "57f14126c1c6add76b3aef3844dfe4e3", + "translation_date": "2025-07-21T19:06:13+00:00", + "source_file": "SECURITY.md", + "language_code": "da" + }, + "SUPPORT.md": { + "original_hash": "b8ef73cc49dec68e2c885ee9df545129", + "translation_date": "2025-07-21T19:09:29+00:00", + "source_file": "SUPPORT.md", + "language_code": "da" + } +} \ No newline at end of file diff --git a/translations/da/01-IntroToGenAI/README.md b/translations/da/01-IntroToGenAI/README.md index c72bafc5..9d2ff497 100644 --- a/translations/da/01-IntroToGenAI/README.md +++ b/translations/da/01-IntroToGenAI/README.md @@ -1,12 +1,3 @@ - # Introduktion til Generativ AI - Java Edition ## Hvad du vil lære diff --git a/translations/da/02-SetupDevEnvironment/README.md b/translations/da/02-SetupDevEnvironment/README.md index da39ff1a..b3bbf0fd 100644 --- a/translations/da/02-SetupDevEnvironment/README.md +++ b/translations/da/02-SetupDevEnvironment/README.md @@ -1,13 +1,254 @@ - +# Opsætning af udviklingsmiljøet til Generativ AI for Java +> **Hurtig start**: Kode i skyen på 2 minutter - spring til [GitHub Codespaces Setup](../../../02-SetupDevEnvironment) - ingen lokal installation kræves og bruger github-modeller! + +> **Interesseret i Azure OpenAI?**, se vores [Azure OpenAI Setup Guide](getting-started-azure-openai.md) med trin til at oprette en ny Azure OpenAI-ressource. + +## Det du vil lære + +- Opsæt et Java udviklingsmiljø til AI-applikationer +- Vælg og konfigurer dit foretrukne udviklingsmiljø (cloud-first med Codespaces, lokal dev container, eller fuld lokal opsætning) +- Test din opsætning ved at oprette forbindelse til GitHub Models + +## Indholdsfortegnelse + +- [Det du vil lære](../../../02-SetupDevEnvironment) +- [Introduktion](../../../02-SetupDevEnvironment) +- [Trin 1: Opsæt dit udviklingsmiljø](../../../02-SetupDevEnvironment) + - [Mulighed A: GitHub Codespaces (Anbefalet)](../../../02-SetupDevEnvironment) + - [Mulighed B: Lokal Dev Container](../../../02-SetupDevEnvironment) + - [Mulighed C: Brug din eksisterende lokale installation](../../../02-SetupDevEnvironment) +- [Trin 2: Opret GitHub Personal Access Token](../../../02-SetupDevEnvironment) +- [Trin 3: Test din opsætning](../../../02-SetupDevEnvironment) +- [Fejlfinding](../../../02-SetupDevEnvironment) +- [Opsummering](../../../02-SetupDevEnvironment) +- [Næste skridt](../../../02-SetupDevEnvironment) + +## Introduktion + +Dette kapitel vil guide dig gennem opsætningen af et udviklingsmiljø. Vi bruger **GitHub Models** som vores primære eksempel, fordi det er gratis, nemt at sætte op med blot en GitHub-konto, kræver ikke kreditkort, og giver adgang til flere modeller til eksperimentering. + +**Ingen lokal opsætning nødvendig!** Du kan begynde at kode med det samme ved at bruge GitHub Codespaces, som leverer et fuldt udviklingsmiljø i din browser. + +Screenshot: GitHub Models + +Vi anbefaler at bruge [**GitHub Models**](https://github.com/marketplace?type=models) til dette kursus fordi det er: +- **Gratis** at komme i gang +- **Nemt** at opsætte med blot en GitHub-konto +- **Ingen kreditkort** påkrævet +- **Flere modeller** til rådighed for eksperimentering + +> **Bemærk**: GitHub Models brugt i denne træning har disse gratis begrænsninger: +> - 15 anmodninger pr. minut (150 pr. dag) +> - ~8.000 ord ind, ~4.000 ord ud pr. anmodning +> - 5 samtidige anmodninger +> +> Til produktionsbrug, opgrader til Azure AI Foundry Models med din Azure-konto. Din kode behøver ikke at ændres. Se [Azure AI Foundry dokumentationen](https://learn.microsoft.com/azure/ai-foundry/foundry-models/how-to/quickstart-github-models). + + +## Trin 1: Opsæt dit udviklingsmiljø + + + +Vi har oprettet en forkonfigureret udviklingscontainer for at minimere opsætningstiden og sikre, at du har alle nødvendige værktøjer til dette Generative AI for Java kursus. Vælg din foretrukne udviklingstilgang: + +### Miljøopsætningsmuligheder: + +#### Mulighed A: GitHub Codespaces (Anbefalet) + +**Begynd at kode på 2 minutter - ingen lokal opsætning nødvendig!** + +1. Fork dette repository til din GitHub-konto + > **Bemærk**: Hvis du vil redigere den grundlæggende konfiguration, se venligst [Dev Container Configuration](../../../.devcontainer/devcontainer.json) +2. Klik på **Code** → **Codespaces** fanen → **...** → **Ny med muligheder...** +3. Brug standardindstillingerne – dette vælger **Dev container-konfigurationen**: **Generative AI Java Development Environment** speciallavet devcontainer til dette kursus +4. Klik på **Create codespace** +5. Vent ~2 minutter på at miljøet er klar +6. Fortsæt til [Trin 2: Opret GitHub Token](../../../02-SetupDevEnvironment) + +Screenshot: Codespaces submenu + +Screenshot: New with options + +Screenshot: Create codespace options + + +> **Fordele ved Codespaces**: +> - Ingen lokal installation påkrævet +> - Virker på enhver enhed med en browser +> - Forudkonfigureret med alle værktøjer og afhængigheder +> - Gratis 60 timer pr. måned for personlige konti +> - Ensartet miljø for alle elever + +#### Mulighed B: Lokal Dev Container + +**For udviklere der foretrækker lokal udvikling med Docker** + +1. Fork og clone dette repository til din lokale maskine + > **Bemærk**: Hvis du vil redigere den grundlæggende konfiguration, se venligst [Dev Container Configuration](../../../.devcontainer/devcontainer.json) +2. Installer [Docker Desktop](https://www.docker.com/products/docker-desktop/) og [VS Code](https://code.visualstudio.com/) +3. Installer [Dev Containers udvidelsen](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers) i VS Code +4. Åbn repository-mappen i VS Code +5. Når du bliver spurgt, klik på **Reopen in Container** (eller brug `Ctrl+Shift+P` → "Dev Containers: Reopen in Container") +6. Vent på at containeren bygges og starter +7. Fortsæt til [Trin 2: Opret GitHub Token](../../../02-SetupDevEnvironment) + +Screenshot: Dev container setup + +Screenshot: Dev container build complete + +#### Mulighed C: Brug din eksisterende lokale installation + +**For udviklere med eksisterende Java-miljøer** + +Forudsætninger: +- [Java 21+](https://www.oracle.com/java/technologies/javase/jdk21-archive-downloads.html) +- [Maven 3.9+](https://maven.apache.org/download.cgi) +- [VS Code](https://code.visualstudio.com) eller dit foretrukne IDE + +Trin: +1. Clone dette repository til din lokale maskine +2. Åbn projektet i dit IDE +3. Fortsæt til [Trin 2: Opret GitHub Token](../../../02-SetupDevEnvironment) + +> **Pro Tip**: Har du en lav-spec-maskine, men vil bruge VS Code lokalt, så brug GitHub Codespaces! Du kan forbinde din lokale VS Code til et cloud-hosted Codespace og få det bedste fra begge verdener. + +Screenshot: created local devcontainer instance + + +## Trin 2: Opret en GitHub Personal Access Token + +1. Naviger til [GitHub Settings](https://github.com/settings/profile) og vælg **Settings** i din profilmenu. +2. Klik i venstre sidebjælke på **Developer settings** (normalt nederst). +3. Under **Personal access tokens**, klik på **Fine-grained tokens** (eller følg dette direkte [link](https://github.com/settings/personal-access-tokens)). +4. Klik på **Generate new token**. +5. Under "Token name", giv et beskrivende navn (f.eks. `GenAI-Java-Course-Token`). +6. Angiv en udløbsdato (anbefalet: 7 dage for bedst sikkerhedspraksis). +7. Under "Resource owner", vælg din bruger-konto. +8. Under "Repository access", vælg de repositories, du vil bruge med GitHub Models (eller "Alle repositories" hvis nødvendigt). +9. Under "Account permissions", find **Models** og sæt den til **Read-only**. +10. Klik på **Generate token**. +11. **Kopiér og gem din token nu** – du får den ikke vist igen! + +> **Sikkerhedstips**: Brug den mindst mulige tilladelse og kortest praktisk gyldighedstid for dine adgangstokener. + +## Trin 3: Test din opsætning med GitHub Models-eksemplet + +Når dit udviklingsmiljø er klar, lad os teste GitHub Models integrationen med vores eksempelapplikation i [`02-SetupDevEnvironment/examples/github-models`](../../../02-SetupDevEnvironment/examples/github-models). + +1. Åbn terminalen i dit udviklingsmiljø. +2. Naviger til GitHub Models eksemplet: + ```bash + cd 02-SetupDevEnvironment/examples/github-models + ``` +3. Sæt dit GitHub token som en miljøvariabel: + ```bash + # macOS/Linux + export GITHUB_TOKEN=your_token_here + + # Windows (Kommandoprompt) + set GITHUB_TOKEN=your_token_here + + # Windows (PowerShell) + $env:GITHUB_TOKEN="your_token_here" + ``` + +4. Kør applikationen: + ```bash + mvn compile exec:java -Dexec.mainClass="com.example.githubmodels.App" + ``` + +Du burde se output som: +```text +Using model: gpt-4.1-nano +Sending request to GitHub Models... +Response: Hello World! +``` + +### Forståelse af eksempel-koden + +Lad os først forstå hvad vi lige har kørt. Eksemplet under `examples/github-models` bruger OpenAI Java SDK til at forbinde til GitHub Models: + +**Hvad denne kode gør:** +- **Forbinder** til GitHub Models ved hjælp af din personal access token +- **Sender** en simpel "Say Hello World!" besked til AI-modellen +- **Modtager** og viser AI'ens svar +- **Validerer** at din opsætning fungerer korrekt + +**Nøgleafhængighed** (i `pom.xml`): +```xml + + com.openai + openai-java + 2.12.0 + +``` + +**Hovedkode** (`App.java`): +```java +// Opret forbindelse til GitHub-modeller ved hjælp af OpenAI Java SDK +OpenAIClient client = OpenAIOkHttpClient.builder() + .apiKey(pat) + .baseUrl("https://models.inference.ai.azure.com") + .build(); + +// Opret chatkompletteringsanmodning +ChatCompletionCreateParams params = ChatCompletionCreateParams.builder() + .model(modelId) + .addSystemMessage("You are a concise assistant.") + .addUserMessage("Say Hello World!") + .build(); + +// Hent AI-svar +ChatCompletion response = client.chat().completions().create(params); +System.out.println("Response: " + response.choices().get(0).message().content().orElse("No response content")); +``` + +## Opsummering + +Fremragende! Du har nu alt sat op: + +- Oprettet en GitHub Personal Access Token med de rette tilladelser til AI model-adgang +- Fået dit Java udviklingsmiljø op at køre (uanset om det er Codespaces, dev containers eller lokal) +- Forbundet til GitHub Models ved brug af OpenAI Java SDK til gratis AI-udvikling +- Testet at det hele virker med et simpelt eksempel, der kommunikerer med AI-modeller + +## Næste skridt + +[Kapitel 3: Kerne teknikker inden for Generativ AI](../03-CoreGenerativeAITechniques/README.md) + +## Fejlfinding + +Problemer? Her er almindelige problemer og løsninger: + +- **Token virker ikke?** + - Sørg for, at du har kopieret hele token uden ekstra mellemrum + - Bekræft at token er korrekt sat som miljøvariabel + - Tjek at din token har de korrekte tilladelser (Models: Read-only) + +- **Maven ikke fundet?** + - Hvis du bruger dev containers/Codespaces, burde Maven være forudinstalleret + - For lokal opsætning, sikre at Java 21+ og Maven 3.9+ er installeret + - Prøv `mvn --version` for at verificere installation + +- **Forbindelsesproblemer?** + - Tjek din internetforbindelse + - Bekræft at GitHub er tilgængelig fra dit netværk + - Sørg for, at du ikke er bag en firewall, der blokerer GitHub Models endpoint + +- **Dev container starter ikke?** + - Sørg for Docker Desktop kører (ved lokal udvikling) + - Prøv at genopbygge containeren: `Ctrl+Shift+P` → "Dev Containers: Rebuild Container" + +- **Kompileringsfejl i applikationen?** + - Sørg for at du er i den korrekte mappe: `02-SetupDevEnvironment/examples/github-models` + - Prøv at rydde op og genbygge: `mvn clean compile` + +> **Brug for hjælp?**: Stadig problemer? Opret en issue i repository'et, og vi hjælper dig. --- + +**Ansvarsfraskrivelse**: +Dette dokument er blevet oversat ved hjælp af AI-oversættelsestjenesten [Co-op Translator](https://github.com/Azure/co-op-translator). Selvom vi bestræber os på nøjagtighed, bedes du være opmærksom på, at automatiserede oversættelser kan indeholde fejl eller unøjagtigheder. Det oprindelige dokument på dets modersmål skal betragtes som den autoritative kilde. For kritisk information anbefales professionel menneskelig oversættelse. Vi påtager os intet ansvar for misforståelser eller fejltolkninger, der opstår som følge af brugen af denne oversættelse. + \ No newline at end of file diff --git a/translations/da/02-SetupDevEnvironment/examples/basic-chat-azure/README.md b/translations/da/02-SetupDevEnvironment/examples/basic-chat-azure/README.md index ff7bc7d9..300f19de 100644 --- a/translations/da/02-SetupDevEnvironment/examples/basic-chat-azure/README.md +++ b/translations/da/02-SetupDevEnvironment/examples/basic-chat-azure/README.md @@ -1,12 +1,3 @@ - # Grundlæggende Chat med Azure OpenAI - End-to-End Eksempel Dette eksempel viser, hvordan man opretter en simpel Spring Boot-applikation, der forbinder til Azure OpenAI og tester din opsætning. diff --git a/translations/da/02-SetupDevEnvironment/getting-started-azure-openai.md b/translations/da/02-SetupDevEnvironment/getting-started-azure-openai.md index 67f670d5..44722e00 100644 --- a/translations/da/02-SetupDevEnvironment/getting-started-azure-openai.md +++ b/translations/da/02-SetupDevEnvironment/getting-started-azure-openai.md @@ -1,12 +1,3 @@ - # Opsætning af udviklingsmiljø for Azure OpenAI > **Hurtig start**: Denne guide er til opsætning af Azure OpenAI. For en øjeblikkelig start med gratis modeller, brug [GitHub Models med Codespaces](./README.md#quick-start-cloud). diff --git a/translations/da/03-CoreGenerativeAITechniques/README.md b/translations/da/03-CoreGenerativeAITechniques/README.md index 30c7ab1c..a6c67d53 100644 --- a/translations/da/03-CoreGenerativeAITechniques/README.md +++ b/translations/da/03-CoreGenerativeAITechniques/README.md @@ -1,12 +1,3 @@ - # Core Generative AI Techniques Tutorial ## Indholdsfortegnelse diff --git a/translations/da/04-PracticalSamples/README.md b/translations/da/04-PracticalSamples/README.md index 1fc740be..f281087d 100644 --- a/translations/da/04-PracticalSamples/README.md +++ b/translations/da/04-PracticalSamples/README.md @@ -1,12 +1,3 @@ - # Praktiske Anvendelser og Projekter ## Hvad Du Vil Lære diff --git a/translations/da/04-PracticalSamples/calculator/README.md b/translations/da/04-PracticalSamples/calculator/README.md index a7965015..b4c8c37d 100644 --- a/translations/da/04-PracticalSamples/calculator/README.md +++ b/translations/da/04-PracticalSamples/calculator/README.md @@ -1,12 +1,3 @@ - # MCP Calculator Tutorial for Begyndere ## Indholdsfortegnelse diff --git a/translations/da/04-PracticalSamples/foundrylocal/README.md b/translations/da/04-PracticalSamples/foundrylocal/README.md index bf01bc08..b661d28d 100644 --- a/translations/da/04-PracticalSamples/foundrylocal/README.md +++ b/translations/da/04-PracticalSamples/foundrylocal/README.md @@ -1,12 +1,3 @@ - # Foundry Local Spring Boot Tutorial ## Indholdsfortegnelse diff --git a/translations/da/04-PracticalSamples/petstory/README.md b/translations/da/04-PracticalSamples/petstory/README.md index d7b0df4a..c74e5791 100644 --- a/translations/da/04-PracticalSamples/petstory/README.md +++ b/translations/da/04-PracticalSamples/petstory/README.md @@ -1,12 +1,3 @@ - # Pet Historie Generator Tutorial for Begyndere ## Indholdsfortegnelse diff --git a/translations/da/05-ResponsibleGenAI/README.md b/translations/da/05-ResponsibleGenAI/README.md index 90462115..a047a963 100644 --- a/translations/da/05-ResponsibleGenAI/README.md +++ b/translations/da/05-ResponsibleGenAI/README.md @@ -1,12 +1,3 @@ - # Ansvarlig Generativ AI ## Hvad Du Vil Lære diff --git a/translations/da/AGENTS.md b/translations/da/AGENTS.md index c708f013..37ed7780 100644 --- a/translations/da/AGENTS.md +++ b/translations/da/AGENTS.md @@ -1,12 +1,3 @@ - # AGENTS.md ## Projektoversigt diff --git a/translations/da/CODE_OF_CONDUCT.md b/translations/da/CODE_OF_CONDUCT.md index f625b482..81fca51f 100644 --- a/translations/da/CODE_OF_CONDUCT.md +++ b/translations/da/CODE_OF_CONDUCT.md @@ -1,12 +1,3 @@ - # Microsoft Open Source Adfærdskodeks Dette projekt har vedtaget [Microsoft Open Source Adfærdskodeks](https://opensource.microsoft.com/codeofconduct/). diff --git a/translations/da/README.md b/translations/da/README.md index b11266a7..3bedb1bc 100644 --- a/translations/da/README.md +++ b/translations/da/README.md @@ -1,31 +1,22 @@ - -# Generativ AI for Begyndere - Java Udgave +# Generativ AI for Begyndere - Java Edition [![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) -![Generativ AI for Begyndere - Java Udgave](../../translated_images/da/beg-genai-series.8b48be9951cc574c.webp) +![Generativ AI for Begyndere - Java Edition](../../translated_images/da/beg-genai-series.8b48be9951cc574c.webp) -**Tidsforbrug**: Hele workshoppen kan gennemføres online uden lokal opsætning. Miljøopsætningen tager 2 minutter, og udforskning af prøverne kræver 1-3 timer afhængigt af udforskningsdybden. +**Tid**: Hele workshoppen kan gennemføres online uden lokal opsætning. Miljøopsætningen tager 2 minutter, og udforskning af eksempler kræver 1-3 timer afhængigt af udforskningsdybden. -> **Hurtig Start** +> **Hurtig start** 1. Fork dette repository til din GitHub-konto -2. Klik **Code** → **Codespaces** fanen → **...** → **Ny med muligheder...** -3. Brug standardindstillingerne – dette vil vælge udviklingscontaineren oprettet til dette kursus -4. Klik **Opret codespace** -5. Vent ca. 2 minutter på, at miljøet er klar +2. Klik på **Code** → **Codespaces** fanen → **...** → **New with options...** +3. Brug standardindstillingerne – det vil vælge udviklingscontaineren oprettet til dette kursus +4. Klik **Create codespace** +5. Vent ~2 minutter på at miljøet er klar 6. Gå direkte til [Det første eksempel](./02-SetupDevEnvironment/README.md#step-2-create-a-github-personal-access-token) > **Foretrækker du at klone lokalt?** > -> Dette repository inkluderer 50+ sprogoversættelser, som øger downloadstørrelsen betydeligt. For at klone uden oversættelser, brug sparse checkout: +> Dette repository inkluderer 50+ sprogoversættelser, hvilket betydeligt øger downloadstørrelsen. For at klone uden oversættelser, brug sparse checkout: > ```bash > git clone --filter=blob:none --sparse https://github.com/microsoft/Generative-AI-for-beginners-java.git > cd Generative-AI-for-beginners-java @@ -34,16 +25,16 @@ CO_OP_TRANSLATOR_METADATA: > Dette giver dig alt, hvad du behøver for at gennemføre kurset med en meget hurtigere download. -## Flersproget Support +## Fleresprogssupport ### Understøttet via GitHub Action (Automatiseret & Altid Opdateret) -[Arabisk](../ar/README.md) | [Bengali](../bn/README.md) | [Bulgarsk](../bg/README.md) | [Burmesisk (Myanmar)](../my/README.md) | [Kinesisk (Forenklet)](../zh/README.md) | [Kinesisk (Traditionel, Hong Kong)](../hk/README.md) | [Kinesisk (Traditionel, Macau)](../mo/README.md) | [Kinesisk (Traditionel, Taiwan)](../tw/README.md) | [Kroatisk](../hr/README.md) | [Tjekkisk](../cs/README.md) | [Dansk](./README.md) | [Hollandsk](../nl/README.md) | [Estisk](../et/README.md) | [Finsk](../fi/README.md) | [Fransk](../fr/README.md) | [Tysk](../de/README.md) | [Græsk](../el/README.md) | [Hebraisk](../he/README.md) | [Hindi](../hi/README.md) | [Ungarsk](../hu/README.md) | [Indonesisk](../id/README.md) | [Italiensk](../it/README.md) | [Japansk](../ja/README.md) | [Kannada](../kn/README.md) | [Koreansk](../ko/README.md) | [Litauisk](../lt/README.md) | [Malayisk](../ms/README.md) | [Malayalam](../ml/README.md) | [Marathi](../mr/README.md) | [Nepalesisk](../ne/README.md) | [Nigeriansk Pidgin](../pcm/README.md) | [Norsk](../no/README.md) | [Persisk (Farsi)](../fa/README.md) | [Polsk](../pl/README.md) | [Portugisisk (Brasilien)](../br/README.md) | [Portugisisk (Portugal)](../pt/README.md) | [Punjabi (Gurmukhi)](../pa/README.md) | [Rumænsk](../ro/README.md) | [Russisk](../ru/README.md) | [Serbisk (Kyrillisk)](../sr/README.md) | [Slovakisk](../sk/README.md) | [Slovensk](../sl/README.md) | [Spansk](../es/README.md) | [Swahili](../sw/README.md) | [Svensk](../sv/README.md) | [Tagalog (Filippinsk)](../tl/README.md) | [Tamil](../ta/README.md) | [Telugu](../te/README.md) | [Thai](../th/README.md) | [Tyrkisk](../tr/README.md) | [Ukrainsk](../uk/README.md) | [Urdu](../ur/README.md) | [Vietnamesisk](../vi/README.md) +[Arabisk](../ar/README.md) | [Bengalsk](../bn/README.md) | [Bulgarsk](../bg/README.md) | [Burmesisk (Myanmar)](../my/README.md) | [Kinesisk (Forenklet)](../zh-CN/README.md) | [Kinesisk (Traditionelt, Hong Kong)](../zh-HK/README.md) | [Kinesisk (Traditionelt, Macau)](../zh-MO/README.md) | [Kinesisk (Traditionelt, Taiwan)](../zh-TW/README.md) | [Kroatisk](../hr/README.md) | [Tjekkisk](../cs/README.md) | [Dansk](./README.md) | [Hollandsk](../nl/README.md) | [Estisk](../et/README.md) | [Finsk](../fi/README.md) | [Fransk](../fr/README.md) | [Tysk](../de/README.md) | [Grekisk](../el/README.md) | [Hebraisk](../he/README.md) | [Hindi](../hi/README.md) | [Ungarsk](../hu/README.md) | [Indonesisk](../id/README.md) | [Italiensk](../it/README.md) | [Japansk](../ja/README.md) | [Kannada](../kn/README.md) | [Koreansk](../ko/README.md) | [Litauisk](../lt/README.md) | [Malaysisk](../ms/README.md) | [Malayalam](../ml/README.md) | [Marathi](../mr/README.md) | [Nepalesisk](../ne/README.md) | [Nigeriansk Pidgin](../pcm/README.md) | [Norsk](../no/README.md) | [Persisk (Farsi)](../fa/README.md) | [Polsk](../pl/README.md) | [Portugisisk (Brasilien)](../pt-BR/README.md) | [Portugisisk (Portugal)](../pt-PT/README.md) | [Punjabi (Gurmukhi)](../pa/README.md) | [Rumænsk](../ro/README.md) | [Russisk](../ru/README.md) | [Serbisk (Cyrillisk)](../sr/README.md) | [Slovakisk](../sk/README.md) | [Slovensk](../sl/README.md) | [Spansk](../es/README.md) | [Swahili](../sw/README.md) | [Svensk](../sv/README.md) | [Tagalog (Filipino)](../tl/README.md) | [Tamil](../ta/README.md) | [Telugu](../te/README.md) | [Thai](../th/README.md) | [Tyrkisk](../tr/README.md) | [Ukrainsk](../uk/README.md) | [Urdu](../ur/README.md) | [Vietnamesisk](../vi/README.md) > **Foretrækker du at klone lokalt?** -> Dette repository inkluderer 50+ sprogoversættelser, som øger downloadstørrelsen betydeligt. For at klone uden oversættelser, brug sparse checkout: +> Dette repository inkluderer 50+ sprogoversættelser, hvilket betydeligt øger downloadstørrelsen. For at klone uden oversættelser, brug sparse checkout: > ```bash > git clone --filter=blob:none --sparse https://github.com/microsoft/Generative-AI-for-beginners-java.git > cd Generative-AI-for-beginners-java @@ -52,96 +43,96 @@ CO_OP_TRANSLATOR_METADATA: > Dette giver dig alt, hvad du behøver for at gennemføre kurset med en meget hurtigere download. -## Kursusstruktur & Læringssti +## Kursusstruktur & Læringsvej ### **Kapitel 1: Introduktion til Generativ AI** -- **Kernebegreber**: Forståelse af store sprogmodeller, tokens, indlejringer og AI-kapaciteter -- **Java AI Økosystem**: Oversigt over Spring AI og OpenAI SDK'er -- **Model Context Protocol**: Introduktion til MCP og dets rolle i AI-agent kommunikation -- **Praktiske Anvendelser**: Virkelige scenarier, herunder chatbots og indholdsgenerering +- **Kernebegreber**: Forståelse af store sprogmodeller, tokens, embeddings og AI’s kapaciteter +- **Java AI Økosystem**: Oversigt over Spring AI og OpenAI SDK’er +- **Model Context Protocol**: Introduktion til MCP og dens rolle i AI-agentkommunikation +- **Praktiske Anvendelser**: Virkelige scenarier inklusive chatbots og indholdsgenerering - **[→ Start Kapitel 1](./01-IntroToGenAI/README.md)** ### **Kapitel 2: Opsætning af Udviklingsmiljø** -- **Multi-udbyder Konfiguration**: Opsæt GitHub Models, Azure OpenAI og OpenAI Java SDK integrationer -- **Spring Boot + Spring AI**: Bedste praksis for udvikling af AI-applikationer til virksomheder -- **GitHub Models**: Gratis AI-modeladgang til prototyping og læring (ingen kreditkort krævet) +- **Multi-udbyder Konfiguration**: Opsæt GitHub Models, Azure OpenAI og OpenAI Java SDK-integrationer +- **Spring Boot + Spring AI**: Bedste praksis til virksomheders AI-applikationsudvikling +- **GitHub Models**: Gratis AI-modeladgang til prototyping og læring (ingen kreditkort nødvendig) - **Udviklingsværktøjer**: Docker-containere, VS Code og GitHub Codespaces konfiguration - **[→ Start Kapitel 2](./02-SetupDevEnvironment/README.md)** -### **Kapitel 3: Grundlæggende Generative AI-teknikker** +### **Kapitel 3: Kerne Generative AI Teknikker** - **Prompt Engineering**: Teknikker til optimale AI-modelsvar -- **Indlejringer & Vektoroperationer**: Implementer semantisk søgning og ligningsmatchning +- **Embeddings & Vektoroperationer**: Implementering af semantisk søgning og ligheds matching - **Retrieval-Augmented Generation (RAG)**: Kombiner AI med dine egne datakilder -- **Funktionskald**: Udvid AI-kapaciteter med brugerdefinerede værktøjer og plugins +- **Function Calling**: Udvid AI’s funktionaliteter med brugerdefinerede værktøjer og plugins - **[→ Start Kapitel 3](./03-CoreGenerativeAITechniques/README.md)** ### **Kapitel 4: Praktiske Anvendelser & Projekter** - **Pet Story Generator** (`petstory/`): Kreativ indholdsgenerering med GitHub Models -- **Foundry Local Demo** (`foundrylocal/`): Lokal AI-model integration med OpenAI Java SDK +- **Foundry Local Demo** (`foundrylocal/`): Lokal AI-modelintegration med OpenAI Java SDK - **MCP Calculator Service** (`calculator/`): Grundlæggende Model Context Protocol-implementering med Spring AI - **[→ Start Kapitel 4](./04-PracticalSamples/README.md)** ### **Kapitel 5: Ansvarlig AI-udvikling** -- **GitHub Models Sikkerhed**: Test indbyggede indholdsfiltreringer og sikkerhedsmekanismer (hårde blokeringer og bløde afvisninger) -- **Ansvarlig AI Demo**: Praktisk eksempel, der viser hvordan moderne AI-sikkerhedssystemer fungerer i praksis -- **Bedste praksis**: Væsentlige retningslinjer for etisk AI-udvikling og implementering +- **GitHub Models Sikkerhed**: Test indbygget indholdsfiltning og sikringsmekanismer (hårde blokeringer og bløde afslag) +- **Ansvarlig AI Demo**: Praktisk eksempel, der viser hvordan moderne AI-sikkerhedssystemer fungerer +- **Bedste Praksis**: Vigtige retningslinjer for etisk AI-udvikling og implementering - **[→ Start Kapitel 5](./05-ResponsibleGenAI/README.md)** ## Yderligere Ressourcer ### LangChain -[![LangChain4j for Begyndere](https://img.shields.io/badge/LangChain4j%20for%20Beginners-22C55E?style=for-the-badge&&labelColor=E5E7EB&color=0553D6)](https://aka.ms/langchain4j-for-beginners) -[![LangChain.js for Begyndere](https://img.shields.io/badge/LangChain.js%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=0553D6)](https://aka.ms/langchainjs-for-beginners?WT.mc_id=m365-94501-dwahlin) +[![LangChain4j for Beginners](https://img.shields.io/badge/LangChain4j%20for%20Beginners-22C55E?style=for-the-badge&&labelColor=E5E7EB&color=0553D6)](https://aka.ms/langchain4j-for-beginners) +[![LangChain.js for Beginners](https://img.shields.io/badge/LangChain.js%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=0553D6)](https://aka.ms/langchainjs-for-beginners?WT.mc_id=m365-94501-dwahlin) --- ### Azure / Edge / MCP / Agenter -[![AZD for Begyndere](https://img.shields.io/badge/AZD%20for%20Beginners-0078D4?style=for-the-badge&labelColor=E5E7EB&color=0078D4)](https://github.com/microsoft/AZD-for-beginners?WT.mc_id=academic-105485-koreyst) -[![Edge AI for Begyndere](https://img.shields.io/badge/Edge%20AI%20for%20Beginners-00B8E4?style=for-the-badge&labelColor=E5E7EB&color=00B8E4)](https://github.com/microsoft/edgeai-for-beginners?WT.mc_id=academic-105485-koreyst) -[![MCP for Begyndere](https://img.shields.io/badge/MCP%20for%20Beginners-009688?style=for-the-badge&labelColor=E5E7EB&color=009688)](https://github.com/microsoft/mcp-for-beginners?WT.mc_id=academic-105485-koreyst) -[![AI Agenter for Begyndere](https://img.shields.io/badge/AI%20Agents%20for%20Beginners-00C49A?style=for-the-badge&labelColor=E5E7EB&color=00C49A)](https://github.com/microsoft/ai-agents-for-beginners?WT.mc_id=academic-105485-koreyst) +[![AZD for Beginners](https://img.shields.io/badge/AZD%20for%20Beginners-0078D4?style=for-the-badge&labelColor=E5E7EB&color=0078D4)](https://github.com/microsoft/AZD-for-beginners?WT.mc_id=academic-105485-koreyst) +[![Edge AI for Beginners](https://img.shields.io/badge/Edge%20AI%20for%20Beginners-00B8E4?style=for-the-badge&labelColor=E5E7EB&color=00B8E4)](https://github.com/microsoft/edgeai-for-beginners?WT.mc_id=academic-105485-koreyst) +[![MCP for Beginners](https://img.shields.io/badge/MCP%20for%20Beginners-009688?style=for-the-badge&labelColor=E5E7EB&color=009688)](https://github.com/microsoft/mcp-for-beginners?WT.mc_id=academic-105485-koreyst) +[![AI Agents for Beginners](https://img.shields.io/badge/AI%20Agents%20for%20Beginners-00C49A?style=for-the-badge&labelColor=E5E7EB&color=00C49A)](https://github.com/microsoft/ai-agents-for-beginners?WT.mc_id=academic-105485-koreyst) --- - -### Generative AI Serie -[![Generativ AI for Begyndere](https://img.shields.io/badge/Generative%20AI%20for%20Beginners-8B5CF6?style=for-the-badge&labelColor=E5E7EB&color=8B5CF6)](https://github.com/microsoft/generative-ai-for-beginners?WT.mc_id=academic-105485-koreyst) + +### Generativ AI Serie +[![Generativ AI for Beginners](https://img.shields.io/badge/Generative%20AI%20for%20Beginners-8B5CF6?style=for-the-badge&labelColor=E5E7EB&color=8B5CF6)](https://github.com/microsoft/generative-ai-for-beginners?WT.mc_id=academic-105485-koreyst) [![Generativ AI (.NET)](https://img.shields.io/badge/Generative%20AI%20(.NET)-9333EA?style=for-the-badge&labelColor=E5E7EB&color=9333EA)](https://github.com/microsoft/Generative-AI-for-beginners-dotnet?WT.mc_id=academic-105485-koreyst) [![Generativ AI (Java)](https://img.shields.io/badge/Generative%20AI%20(Java)-C084FC?style=for-the-badge&labelColor=E5E7EB&color=C084FC)](https://github.com/microsoft/generative-ai-for-beginners-java?WT.mc_id=academic-105485-koreyst) [![Generativ AI (JavaScript)](https://img.shields.io/badge/Generative%20AI%20(JavaScript)-E879F9?style=for-the-badge&labelColor=E5E7EB&color=E879F9)](https://github.com/microsoft/generative-ai-with-javascript?WT.mc_id=academic-105485-koreyst) --- - -### Grundlæggende Læring -[![ML for Begyndere](https://img.shields.io/badge/ML%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=22C55E)](https://aka.ms/ml-beginners?WT.mc_id=academic-105485-koreyst) -[![Data Science for Begyndere](https://img.shields.io/badge/Data%20Science%20for%20Beginners-84CC16?style=for-the-badge&labelColor=E5E7EB&color=84CC16)](https://aka.ms/datascience-beginners?WT.mc_id=academic-105485-koreyst) -[![AI for Begyndere](https://img.shields.io/badge/AI%20for%20Beginners-A3E635?style=for-the-badge&labelColor=E5E7EB&color=A3E635)](https://aka.ms/ai-beginners?WT.mc_id=academic-105485-koreyst) -[![Cybersecurity for Begyndere](https://img.shields.io/badge/Cybersecurity%20for%20Beginners-F97316?style=for-the-badge&labelColor=E5E7EB&color=F97316)](https://github.com/microsoft/Security-101?WT.mc_id=academic-96948-sayoung) -[![Web Dev for Begyndere](https://img.shields.io/badge/Web%20Dev%20for%20Beginners-EC4899?style=for-the-badge&labelColor=E5E7EB&color=EC4899)](https://aka.ms/webdev-beginners?WT.mc_id=academic-105485-koreyst) + +### Kerne Læring +[![ML for Beginners](https://img.shields.io/badge/ML%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=22C55E)](https://aka.ms/ml-beginners?WT.mc_id=academic-105485-koreyst) +[![Data Science for Beginners](https://img.shields.io/badge/Data%20Science%20for%20Beginners-84CC16?style=for-the-badge&labelColor=E5E7EB&color=84CC16)](https://aka.ms/datascience-beginners?WT.mc_id=academic-105485-koreyst) +[![AI for Beginners](https://img.shields.io/badge/AI%20for%20Beginners-A3E635?style=for-the-badge&labelColor=E5E7EB&color=A3E635)](https://aka.ms/ai-beginners?WT.mc_id=academic-105485-koreyst) +[![Cybersecurity for Beginners](https://img.shields.io/badge/Cybersecurity%20for%20Beginners-F97316?style=for-the-badge&labelColor=E5E7EB&color=F97316)](https://github.com/microsoft/Security-101?WT.mc_id=academic-96948-sayoung) +[![Web Dev for Beginners](https://img.shields.io/badge/Web%20Dev%20for%20Beginners-EC4899?style=for-the-badge&labelColor=E5E7EB&color=EC4899)](https://aka.ms/webdev-beginners?WT.mc_id=academic-105485-koreyst) [![IoT for Beginners](https://img.shields.io/badge/IoT%20for%20Beginners-14B8A6?style=for-the-badge&labelColor=E5E7EB&color=14B8A6)](https://aka.ms/iot-beginners?WT.mc_id=academic-105485-koreyst) [![XR Development for Beginners](https://img.shields.io/badge/XR%20Development%20for%20Beginners-38BDF8?style=for-the-badge&labelColor=E5E7EB&color=38BDF8)](https://github.com/microsoft/xr-development-for-beginners?WT.mc_id=academic-105485-koreyst) --- -### Copilot Serien +### Copilot-serie [![Copilot for AI Paired Programming](https://img.shields.io/badge/Copilot%20for%20AI%20Paired%20Programming-FACC15?style=for-the-badge&labelColor=E5E7EB&color=FACC15)](https://aka.ms/GitHubCopilotAI?WT.mc_id=academic-105485-koreyst) [![Copilot for C#/.NET](https://img.shields.io/badge/Copilot%20for%20C%23/.NET-FBBF24?style=for-the-badge&labelColor=E5E7EB&color=FBBF24)](https://github.com/microsoft/mastering-github-copilot-for-dotnet-csharp-developers?WT.mc_id=academic-105485-koreyst) [![Copilot Adventure](https://img.shields.io/badge/Copilot%20Adventure-FDE68A?style=for-the-badge&labelColor=E5E7EB&color=FDE68A)](https://github.com/microsoft/CopilotAdventures?WT.mc_id=academic-105485-koreyst) -## Få Hjælp +## Få hjælp -Hvis du sidder fast eller har spørgsmål om at bygge AI-apps. Deltag i samtaler med andre lærende og erfarne udviklere omkring MCP. Det er et støttende fællesskab, hvor spørgsmål er velkomne, og viden deles frit. +Hvis du sidder fast eller har spørgsmål om at bygge AI-apps. Deltag sammen med andre lærende og erfarne udviklere i diskussioner om MCP. Det er et støttende fællesskab, hvor spørgsmål er velkomne, og viden deles frit. [![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) -Hvis du har produktfeedback eller fejl under opbygning, besøg: +Hvis du har feedback på produkter eller fejl under udvikling, besøg: [![Microsoft Foundry Developer Forum](https://img.shields.io/badge/GitHub-Microsoft_Foundry_Developer_Forum-blue?style=for-the-badge&logo=github&color=000000&logoColor=fff)](https://aka.ms/foundry/forum) --- -**Ansvarsfraskrivelse**: -Dette dokument er oversat ved hjælp af AI-oversættelsestjenesten [Co-op Translator](https://github.com/Azure/co-op-translator). Selvom vi bestræber os på nøjagtighed, bedes du være opmærksom på, at automatiserede oversættelser kan indeholde fejl eller unøjagtigheder. Det originale dokument på dets native sprog bør anses for at være den autoritative kilde. For kritisk information anbefales professionel menneskelig oversættelse. Vi påtager os intet ansvar for misforståelser eller fejltolkninger, der opstår som følge af brugen af denne oversættelse. +**Ansvarsfraskrivelse**: +Dette dokument er oversat ved hjælp af AI-oversættelsestjenesten [Co-op Translator](https://github.com/Azure/co-op-translator). Selvom vi bestræber os på nøjagtighed, bedes du være opmærksom på, at automatiserede oversættelser kan indeholde fejl eller unøjagtigheder. Det oprindelige dokument på dets modersmål bør betragtes som den autoritative kilde. For kritisk information anbefales professionel menneskelig oversættelse. Vi påtager os intet ansvar for misforståelser eller fejltolkninger, der opstår ved brug af denne oversættelse. \ No newline at end of file diff --git a/translations/da/SECURITY.md b/translations/da/SECURITY.md index 771d7844..b422bdde 100644 --- a/translations/da/SECURITY.md +++ b/translations/da/SECURITY.md @@ -1,12 +1,3 @@ - ## Sikkerhed Microsoft tager sikkerheden af vores softwareprodukter og -tjenester alvorligt, hvilket inkluderer alle kildekoderepositorier, der administreres gennem vores GitHub-organisationer, som inkluderer [Microsoft](https://github.com/Microsoft), [Azure](https://github.com/Azure), [DotNet](https://github.com/dotnet), [AspNet](https://github.com/aspnet) og [Xamarin](https://github.com/xamarin). diff --git a/translations/da/SUPPORT.md b/translations/da/SUPPORT.md index f76b0b9e..626b5f10 100644 --- a/translations/da/SUPPORT.md +++ b/translations/da/SUPPORT.md @@ -1,12 +1,3 @@ - # Support ## Sådan indsender du problemer og får hjælp diff --git a/translations/de/.co-op-translator.json b/translations/de/.co-op-translator.json new file mode 100644 index 00000000..34b3a3a2 --- /dev/null +++ b/translations/de/.co-op-translator.json @@ -0,0 +1,92 @@ +{ + "01-IntroToGenAI/README.md": { + "original_hash": "75bfb080ca725e8a9aa9c80cae25fba1", + "translation_date": "2025-07-29T08:02:29+00:00", + "source_file": "01-IntroToGenAI/README.md", + "language_code": "de" + }, + "02-SetupDevEnvironment/README.md": { + "original_hash": "96a30d42b9751a3d4e4b20e28d29d459", + "translation_date": "2026-01-28T04:37:41+00:00", + "source_file": "02-SetupDevEnvironment/README.md", + "language_code": "de" + }, + "02-SetupDevEnvironment/examples/basic-chat-azure/README.md": { + "original_hash": "efd82efe50711d7e257eb943151d682c", + "translation_date": "2025-07-27T13:33:19+00:00", + "source_file": "02-SetupDevEnvironment/examples/basic-chat-azure/README.md", + "language_code": "de" + }, + "02-SetupDevEnvironment/getting-started-azure-openai.md": { + "original_hash": "bfdb4b4eadbee3a59ef742439f58326a", + "translation_date": "2025-07-27T12:50:09+00:00", + "source_file": "02-SetupDevEnvironment/getting-started-azure-openai.md", + "language_code": "de" + }, + "03-CoreGenerativeAITechniques/README.md": { + "original_hash": "685f55cb07de19b52a30ce6e8b6d889e", + "translation_date": "2025-08-28T21:53:08+00:00", + "source_file": "03-CoreGenerativeAITechniques/README.md", + "language_code": "de" + }, + "04-PracticalSamples/README.md": { + "original_hash": "14c0a61ecc1cd2012a9c129236dfdf71", + "translation_date": "2025-07-29T08:02:15+00:00", + "source_file": "04-PracticalSamples/README.md", + "language_code": "de" + }, + "04-PracticalSamples/calculator/README.md": { + "original_hash": "b6c16b5514d524e415a94f6097ee7d4c", + "translation_date": "2025-09-18T15:23:09+00:00", + "source_file": "04-PracticalSamples/calculator/README.md", + "language_code": "de" + }, + "04-PracticalSamples/foundrylocal/README.md": { + "original_hash": "f787307400de59adc25a1404466a35f3", + "translation_date": "2025-11-04T07:12:40+00:00", + "source_file": "04-PracticalSamples/foundrylocal/README.md", + "language_code": "de" + }, + "04-PracticalSamples/petstory/README.md": { + "original_hash": "0cbf68d605615a1e602c832a24616859", + "translation_date": "2025-07-25T10:42:02+00:00", + "source_file": "04-PracticalSamples/petstory/README.md", + "language_code": "de" + }, + "05-ResponsibleGenAI/README.md": { + "original_hash": "301c05c2f57e60a6950b8c665b8bdbba", + "translation_date": "2025-07-29T15:40:31+00:00", + "source_file": "05-ResponsibleGenAI/README.md", + "language_code": "de" + }, + "AGENTS.md": { + "original_hash": "afc90918d008cf77fd1982691f681306", + "translation_date": "2025-10-03T08:25:17+00:00", + "source_file": "AGENTS.md", + "language_code": "de" + }, + "CODE_OF_CONDUCT.md": { + "original_hash": "442b123d034f92f7c384d2bbd28f99f1", + "translation_date": "2025-07-21T15:59:04+00:00", + "source_file": "CODE_OF_CONDUCT.md", + "language_code": "de" + }, + "README.md": { + "original_hash": "125a08948d881c95628094f4dd1fbd43", + "translation_date": "2026-01-29T15:17:33+00:00", + "source_file": "README.md", + "language_code": "de" + }, + "SECURITY.md": { + "original_hash": "57f14126c1c6add76b3aef3844dfe4e3", + "translation_date": "2025-07-21T15:57:21+00:00", + "source_file": "SECURITY.md", + "language_code": "de" + }, + "SUPPORT.md": { + "original_hash": "b8ef73cc49dec68e2c885ee9df545129", + "translation_date": "2025-07-21T16:00:07+00:00", + "source_file": "SUPPORT.md", + "language_code": "de" + } +} \ No newline at end of file diff --git a/translations/de/01-IntroToGenAI/README.md b/translations/de/01-IntroToGenAI/README.md index 7ce8acf8..4c24c212 100644 --- a/translations/de/01-IntroToGenAI/README.md +++ b/translations/de/01-IntroToGenAI/README.md @@ -1,12 +1,3 @@ - # Einführung in Generative KI - Java Edition ## Was Sie lernen werden diff --git a/translations/de/02-SetupDevEnvironment/README.md b/translations/de/02-SetupDevEnvironment/README.md index bf48325d..e4fc08ec 100644 --- a/translations/de/02-SetupDevEnvironment/README.md +++ b/translations/de/02-SetupDevEnvironment/README.md @@ -1,13 +1,254 @@ - +# Einrichtung der Entwicklungsumgebung für Generative KI für Java +> **Schnellstart**: Programmieren in der Cloud in 2 Minuten – springen Sie zu [GitHub Codespaces Einrichtung](../../../02-SetupDevEnvironment) – keine lokale Installation erforderlich und verwendet GitHub-Modelle! + +> **Interessiert an Azure OpenAI?** Siehe unseren [Azure OpenAI Einrichtungsguide](getting-started-azure-openai.md) mit Schritten zur Erstellung einer neuen Azure OpenAI-Ressource. + +## Was Sie lernen werden + +- Einrichtung einer Java-Entwicklungsumgebung für KI-Anwendungen +- Auswahl und Konfiguration Ihrer bevorzugten Entwicklungsumgebung (Cloud-first mit Codespaces, lokale Dev-Container oder vollständige lokale Einrichtung) +- Testen Ihrer Einrichtung durch Verbindung zu GitHub-Modellen + +## Inhaltsverzeichnis + +- [Was Sie lernen werden](../../../02-SetupDevEnvironment) +- [Einführung](../../../02-SetupDevEnvironment) +- [Schritt 1: Einrichten Ihrer Entwicklungsumgebung](../../../02-SetupDevEnvironment) + - [Option A: GitHub Codespaces (empfohlen)](../../../02-SetupDevEnvironment) + - [Option B: Lokaler Dev-Container](../../../02-SetupDevEnvironment) + - [Option C: Verwenden Sie Ihre bestehende lokale Installation](../../../02-SetupDevEnvironment) +- [Schritt 2: Erstellen eines GitHub Personal Access Token](../../../02-SetupDevEnvironment) +- [Schritt 3: Testen Sie Ihre Einrichtung](../../../02-SetupDevEnvironment) +- [Fehlerbehebung](../../../02-SetupDevEnvironment) +- [Zusammenfassung](../../../02-SetupDevEnvironment) +- [Nächste Schritte](../../../02-SetupDevEnvironment) + +## Einführung + +Dieses Kapitel führt Sie durch die Einrichtung einer Entwicklungsumgebung. Wir verwenden **GitHub-Modelle** als unser primäres Beispiel, da es kostenlos ist, mit nur einem GitHub-Konto einfach einzurichten, keine Kreditkarte benötigt und Zugang zu mehreren Modellen für Experimente bietet. + +**Keine lokale Einrichtung erforderlich!** Sie können sofort mit der Programmierung beginnen, indem Sie GitHub Codespaces verwenden, die eine vollständige Entwicklungsumgebung in Ihrem Browser bereitstellen. + +Screenshot: GitHub Modelle + +Wir empfehlen die Nutzung von [**GitHub Models**](https://github.com/marketplace?type=models) für diesen Kurs, weil es: +- **Kostenlos** zum Einstieg ist +- **Einfach** mit nur einem GitHub-Konto einzurichten ist +- **Keine Kreditkarte** benötigt +- **Mehrere Modelle** für Experimente bereitstellt + +> **Hinweis**: Die in diesem Training verwendeten GitHub-Modelle haben folgende kostenlose Limits: +> - 15 Anfragen pro Minute (150 pro Tag) +> - ~8.000 Wörter Eingabe, ~4.000 Wörter Ausgabe pro Anfrage +> - 5 gleichzeitige Anfragen +> +> Für den Produktionseinsatz verwenden Sie Azure AI Foundry Models mit Ihrem Azure-Konto. Ihr Code muss nicht geändert werden. Siehe die [Azure AI Foundry Dokumentation](https://learn.microsoft.com/azure/ai-foundry/foundry-models/how-to/quickstart-github-models). + + +## Schritt 1: Einrichten Ihrer Entwicklungsumgebung + + + +Wir haben einen vorkonfigurierten Entwicklungscontainer erstellt, um die Einrichtungszeit zu minimieren und sicherzustellen, dass Sie alle notwendigen Werkzeuge für diesen Generative AI für Java-Kurs haben. Wählen Sie Ihren bevorzugten Entwicklungsansatz: + +### Optionen zur Umgebungseinrichtung: + +#### Option A: GitHub Codespaces (empfohlen) + +**Starten Sie die Programmierung in 2 Minuten – keine lokale Einrichtung notwendig!** + +1. Forken Sie dieses Repository in Ihr GitHub-Konto + > **Hinweis**: Wenn Sie die Grundkonfiguration bearbeiten möchten, sehen Sie sich bitte die [Dev Container Konfiguration](../../../.devcontainer/devcontainer.json) an +2. Klicken Sie auf **Code** → Tab **Codespaces** → **...** → **Neu mit Optionen...** +3. Verwenden Sie die Standardwerte – dies wählt die **Dev Container-Konfiguration**: **Generative AI Java Development Environment**, der benutzerdefinierte Devcontainer, der für diesen Kurs erstellt wurde +4. Klicken Sie auf **Codespace erstellen** +5. Warten Sie ca. 2 Minuten, bis die Umgebung bereit ist +6. Fahren Sie fort mit [Schritt 2: Erstellen eines GitHub Tokens](../../../02-SetupDevEnvironment) + +Screenshot: Codespaces Untermenü + +Screenshot: Neu mit Optionen + +Screenshot: Optionen Codespace erstellen + + +> **Vorteile von Codespaces**: +> - Keine lokale Installation erforderlich +> - Funktioniert auf jedem Gerät mit Browser +> - Vorgefertigt mit allen Tools und Abhängigkeiten +> - 60 freie Stunden pro Monat für persönliche Konten +> - Einheitliche Umgebung für alle Lernenden + +#### Option B: Lokaler Dev-Container + +**Für Entwickler, die lokale Entwicklung mit Docker bevorzugen** + +1. Forken und klonen Sie dieses Repository auf Ihre lokale Maschine + > **Hinweis**: Wenn Sie die Grundkonfiguration bearbeiten möchten, sehen Sie sich bitte die [Dev Container Konfiguration](../../../.devcontainer/devcontainer.json) an +2. Installieren Sie [Docker Desktop](https://www.docker.com/products/docker-desktop/) und [VS Code](https://code.visualstudio.com/) +3. Installieren Sie die [Dev Containers Erweiterung](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers) in VS Code +4. Öffnen Sie den Repository-Ordner in VS Code +5. Wenn Sie dazu aufgefordert werden, klicken Sie auf **Im Container erneut öffnen** (oder verwenden Sie `Ctrl+Shift+P` → „Dev Containers: Im Container erneut öffnen“) +6. Warten Sie, bis der Container gebaut und gestartet ist +7. Fahren Sie fort mit [Schritt 2: Erstellen eines GitHub Tokens](../../../02-SetupDevEnvironment) + +Screenshot: Dev Container Einrichtung + +Screenshot: Dev Container Build abgeschlossen + +#### Option C: Verwenden Sie Ihre bestehende lokale Installation + +**Für Entwickler mit vorhandenen Java-Umgebungen** + +Voraussetzungen: +- [Java 21+](https://www.oracle.com/java/technologies/javase/jdk21-archive-downloads.html) +- [Maven 3.9+](https://maven.apache.org/download.cgi) +- [VS Code](https://code.visualstudio.com) oder Ihre bevorzugte IDE + +Schritte: +1. Klonen Sie dieses Repository auf Ihre lokale Maschine +2. Öffnen Sie das Projekt in Ihrer IDE +3. Fahren Sie fort mit [Schritt 2: Erstellen eines GitHub Tokens](../../../02-SetupDevEnvironment) + +> **Profi-Tipp**: Wenn Sie ein leistungsschwächeres Gerät haben, aber VS Code lokal verwenden möchten, benutzen Sie GitHub Codespaces! Sie können Ihr lokales VS Code mit einem cloud-gehosteten Codespace verbinden für das Beste aus beiden Welten. + +Screenshot: erstellte lokale Devcontainer Instanz + + +## Schritt 2: Erstellen eines GitHub Personal Access Token + +1. Navigieren Sie zu [GitHub Einstellungen](https://github.com/settings/profile) und wählen Sie **Einstellungen** aus Ihrem Profilmenü. +2. Klicken Sie in der linken Seitenleiste auf **Entwicklereinstellungen** (normalerweise ganz unten). +3. Unter **Personal access tokens** klicken Sie auf **Feingranulare Tokens** (oder folgen Sie diesem direkten [Link](https://github.com/settings/personal-access-tokens)). +4. Klicken Sie auf **Neues Token generieren**. +5. Unter „Token-Name“ geben Sie einen beschreibenden Namen ein (z. B. `GenAI-Java-Kurs-Token`). +6. Legen Sie ein Ablaufdatum fest (empfohlen: 7 Tage aus Sicherheitsgründen). +7. Wählen Sie unter „Ressourcenbesitzer“ Ihr Benutzerkonto aus. +8. Wählen Sie unter „Repository-Zugriff“ die Repositories aus, die Sie mit GitHub-Modelle verwenden möchten (oder „Alle Repositories“, falls benötigt). +9. Unter „Kontoberechtigungen“ finden Sie **Models** und setzen es auf **Nur Lesen**. +10. Klicken Sie auf **Token generieren**. +11. **Kopieren Sie Ihr Token jetzt und speichern Sie es – Sie werden es nicht wieder sehen!** + +> **Sicherheitstipp**: Verwenden Sie den minimal erforderlichen Umfang und die kürzeste praktische Ablaufzeit für Ihre Zugriffstoken. + +## Schritt 3: Testen Sie Ihre Einrichtung mit dem GitHub Models Beispiel + +Sobald Ihre Entwicklungsumgebung bereit ist, testen wir die GitHub Models Integration mit unserer Beispielanwendung in [`02-SetupDevEnvironment/examples/github-models`](../../../02-SetupDevEnvironment/examples/github-models). + +1. Öffnen Sie das Terminal in Ihrer Entwicklungsumgebung. +2. Navigieren Sie zum GitHub Models Beispiel: + ```bash + cd 02-SetupDevEnvironment/examples/github-models + ``` +3. Setzen Sie Ihr GitHub-Token als Umgebungsvariable: + ```bash + # macOS/Linux + export GITHUB_TOKEN=your_token_here + + # Windows (Eingabeaufforderung) + set GITHUB_TOKEN=your_token_here + + # Windows (PowerShell) + $env:GITHUB_TOKEN="your_token_here" + ``` + +4. Starten Sie die Anwendung: + ```bash + mvn compile exec:java -Dexec.mainClass="com.example.githubmodels.App" + ``` + +Sie sollten eine Ausgabe ähnlich der folgenden sehen: +```text +Using model: gpt-4.1-nano +Sending request to GitHub Models... +Response: Hello World! +``` + +### Das Beispielprogramm verstehen + +Zuerst verstehen wir, was wir gerade ausgeführt haben. Das Beispiel unter `examples/github-models` verwendet das OpenAI Java SDK, um sich mit GitHub Models zu verbinden: + +**Was dieser Code macht:** +- **Verbindet** sich mit GitHub Models über Ihr Personal Access Token +- **Sendet** eine einfache Nachricht „Say Hello World!“ an das KI-Modell +- **Erhält** und zeigt die Antwort der KI an +- **Validiert**, dass Ihre Einrichtung korrekt funktioniert + +**Wichtige Abhängigkeit** (in `pom.xml`): +```xml + + com.openai + openai-java + 2.12.0 + +``` + +**Hauptcode** (`App.java`): +```java +// Mit GitHub-Modellen über das OpenAI Java SDK verbinden +OpenAIClient client = OpenAIOkHttpClient.builder() + .apiKey(pat) + .baseUrl("https://models.inference.ai.azure.com") + .build(); + +// Chat-Vervollständigungsanfrage erstellen +ChatCompletionCreateParams params = ChatCompletionCreateParams.builder() + .model(modelId) + .addSystemMessage("You are a concise assistant.") + .addUserMessage("Say Hello World!") + .build(); + +// KI-Antwort erhalten +ChatCompletion response = client.chat().completions().create(params); +System.out.println("Response: " + response.choices().get(0).message().content().orElse("No response content")); +``` + +## Zusammenfassung + +Super! Jetzt haben Sie alles eingerichtet: + +- GitHub Personal Access Token mit den richtigen Berechtigungen für den Zugriff auf KI-Modelle erstellt +- Ihre Java-Entwicklungsumgebung zum Laufen gebracht (ob Codespaces, Dev-Container oder lokal) +- Sich mit GitHub Models über das OpenAI Java SDK für kostenlose KI-Entwicklung verbunden +- Mit einem einfachen Beispiel getestet, das mit KI-Modellen kommuniziert + +## Nächste Schritte + +[Kapitels 3: Core Generative AI Techniques](../03-CoreGenerativeAITechniques/README.md) + +## Fehlerbehebung + +Probleme? Hier sind häufige Probleme und Lösungen: + +- **Token funktioniert nicht?** + - Stellen Sie sicher, dass Sie das gesamte Token ohne zusätzliche Leerzeichen kopiert haben + - Vergewissern Sie sich, dass das Token korrekt als Umgebungsvariable gesetzt ist + - Prüfen Sie, ob Ihr Token die richtigen Berechtigungen hat (Models: Nur Lesen) + +- **Maven nicht gefunden?** + - Wenn Sie Dev-Container/Codespaces verwenden, sollte Maven vorinstalliert sein + - Für eine lokale Einrichtung stellen Sie sicher, dass Java 21+ und Maven 3.9+ installiert sind + - Versuchen Sie `mvn --version` zur Überprüfung der Installation + +- **Verbindungsprobleme?** + - Prüfen Sie Ihre Internetverbindung + - Vergewissern Sie sich, dass GitHub von Ihrem Netzwerk aus erreichbar ist + - Stellen Sie sicher, dass keine Firewall das GitHub Models-Endpunkt blockiert + +- **Dev-Container startet nicht?** + - Stellen Sie sicher, dass Docker Desktop läuft (für lokale Entwicklung) + - Versuchen Sie, den Container neu zu bauen: `Ctrl+Shift+P` → „Dev Containers: Container neu bauen“ + +- **Kompilierungsfehler in der Anwendung?** + - Prüfen Sie, dass Sie sich im richtigen Verzeichnis befinden: `02-SetupDevEnvironment/examples/github-models` + - Versuchen Sie, zu säubern und neu zu bauen: `mvn clean compile` + +> **Brauchen Sie Hilfe?**: Noch Probleme? Öffnen Sie ein Issue im Repository und wir helfen Ihnen weiter. --- + +**Haftungsausschluss**: +Dieses Dokument wurde mit dem KI-Übersetzungsdienst [Co-op Translator](https://github.com/Azure/co-op-translator) übersetzt. Obwohl wir uns um Genauigkeit bemühen, beachten Sie bitte, dass automatisierte Übersetzungen Fehler oder Ungenauigkeiten enthalten können. Das Originaldokument in seiner Ursprungssprache ist die maßgebliche Quelle. Für wichtige Informationen empfehlen wir eine professionelle menschliche Übersetzung. Wir übernehmen keine Haftung für Missverständnisse oder Fehlinterpretationen, die durch die Nutzung dieser Übersetzung entstehen. + \ No newline at end of file diff --git a/translations/de/02-SetupDevEnvironment/examples/basic-chat-azure/README.md b/translations/de/02-SetupDevEnvironment/examples/basic-chat-azure/README.md index 0540e762..1d06fd6a 100644 --- a/translations/de/02-SetupDevEnvironment/examples/basic-chat-azure/README.md +++ b/translations/de/02-SetupDevEnvironment/examples/basic-chat-azure/README.md @@ -1,12 +1,3 @@ - # Basis-Chat mit Azure OpenAI - End-to-End-Beispiel Dieses Beispiel zeigt, wie man eine einfache Spring Boot-Anwendung erstellt, die sich mit Azure OpenAI verbindet und Ihre Einrichtung testet. diff --git a/translations/de/02-SetupDevEnvironment/getting-started-azure-openai.md b/translations/de/02-SetupDevEnvironment/getting-started-azure-openai.md index 63c295b9..c9655196 100644 --- a/translations/de/02-SetupDevEnvironment/getting-started-azure-openai.md +++ b/translations/de/02-SetupDevEnvironment/getting-started-azure-openai.md @@ -1,12 +1,3 @@ - # Einrichten der Entwicklungsumgebung für Azure OpenAI > **Schnellstart**: Diese Anleitung ist für die Einrichtung von Azure OpenAI gedacht. Für einen sofortigen Start mit kostenlosen Modellen nutzen Sie [GitHub Models mit Codespaces](./README.md#quick-start-cloud). diff --git a/translations/de/03-CoreGenerativeAITechniques/README.md b/translations/de/03-CoreGenerativeAITechniques/README.md index dc1f9238..b8c981f7 100644 --- a/translations/de/03-CoreGenerativeAITechniques/README.md +++ b/translations/de/03-CoreGenerativeAITechniques/README.md @@ -1,12 +1,3 @@ - # Kerntechniken der Generativen KI Tutorial ## Inhaltsverzeichnis diff --git a/translations/de/04-PracticalSamples/README.md b/translations/de/04-PracticalSamples/README.md index 46bed60e..713bf18f 100644 --- a/translations/de/04-PracticalSamples/README.md +++ b/translations/de/04-PracticalSamples/README.md @@ -1,12 +1,3 @@ - # Praktische Anwendungen & Projekte ## Was Sie lernen werden diff --git a/translations/de/04-PracticalSamples/calculator/README.md b/translations/de/04-PracticalSamples/calculator/README.md index 20a50465..164c4413 100644 --- a/translations/de/04-PracticalSamples/calculator/README.md +++ b/translations/de/04-PracticalSamples/calculator/README.md @@ -1,12 +1,3 @@ - # MCP-Rechner-Tutorial für Anfänger ## Inhaltsverzeichnis diff --git a/translations/de/04-PracticalSamples/foundrylocal/README.md b/translations/de/04-PracticalSamples/foundrylocal/README.md index 12801e1e..19e22a62 100644 --- a/translations/de/04-PracticalSamples/foundrylocal/README.md +++ b/translations/de/04-PracticalSamples/foundrylocal/README.md @@ -1,12 +1,3 @@ - # Foundry Local Spring Boot Tutorial ## Inhaltsverzeichnis diff --git a/translations/de/04-PracticalSamples/petstory/README.md b/translations/de/04-PracticalSamples/petstory/README.md index 2ff164a8..abd08c12 100644 --- a/translations/de/04-PracticalSamples/petstory/README.md +++ b/translations/de/04-PracticalSamples/petstory/README.md @@ -1,12 +1,3 @@ - # Anleitung für Anfänger: Pet Story Generator ## Inhaltsverzeichnis diff --git a/translations/de/05-ResponsibleGenAI/README.md b/translations/de/05-ResponsibleGenAI/README.md index a6c5134c..f99d5d72 100644 --- a/translations/de/05-ResponsibleGenAI/README.md +++ b/translations/de/05-ResponsibleGenAI/README.md @@ -1,12 +1,3 @@ - # Verantwortungsvolle Generative KI ## Was Sie lernen werden diff --git a/translations/de/AGENTS.md b/translations/de/AGENTS.md index d9852399..a45ce587 100644 --- a/translations/de/AGENTS.md +++ b/translations/de/AGENTS.md @@ -1,12 +1,3 @@ - # AGENTS.md ## Projektübersicht diff --git a/translations/de/CODE_OF_CONDUCT.md b/translations/de/CODE_OF_CONDUCT.md index 620fa027..7848a3ae 100644 --- a/translations/de/CODE_OF_CONDUCT.md +++ b/translations/de/CODE_OF_CONDUCT.md @@ -1,12 +1,3 @@ - # Microsoft Open Source Verhaltenskodex Dieses Projekt hat den [Microsoft Open Source Verhaltenskodex](https://opensource.microsoft.com/codeofconduct/) übernommen. diff --git a/translations/de/README.md b/translations/de/README.md index 5ca954cf..5e4ee009 100644 --- a/translations/de/README.md +++ b/translations/de/README.md @@ -1,55 +1,46 @@ - -# Generative KI für Einsteiger – Java Edition +# Generative KI für Einsteiger - Java Ausgabe [![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) -![Generative KI für Einsteiger – Java Edition](../../translated_images/de/beg-genai-series.8b48be9951cc574c.webp) +![Generative KI für Einsteiger - Java Ausgabe](../../translated_images/de/beg-genai-series.8b48be9951cc574c.webp) -**Zeitaufwand**: Der gesamte Workshop kann online ohne lokale Einrichtung durchgeführt werden. Die Einrichtung der Umgebung dauert 2 Minuten, das Durcharbeiten der Beispiele erfordert je nach Detailtiefe 1–3 Stunden. +**Zeitaufwand**: Der gesamte Workshop kann online ohne lokale Einrichtung abgeschlossen werden. Die Einrichtung der Umgebung dauert 2 Minuten, das Erkunden der Beispiele erfordert je nach Tiefe 1-3 Stunden. > **Schnellstart** -1. Forke dieses Repository in deinen GitHub-Account +1. Forke dieses Repository in dein GitHub-Konto 2. Klicke auf **Code** → Reiter **Codespaces** → **...** → **Neu mit Optionen...** -3. Verwende die Standardwerte – damit wird der für diesen Kurs erstellte Development-Container ausgewählt +3. Verwende die Standardwerte – es wird der für diesen Kurs erstellte Development-Container ausgewählt 4. Klicke auf **Codespace erstellen** -5. Warte ca. 2 Minuten, bis die Umgebung bereit ist -6. Springe direkt zu [Dem ersten Beispiel](./02-SetupDevEnvironment/README.md#step-2-create-a-github-personal-access-token) +5. Warte ~2 Minuten, bis die Umgebung bereit ist +6. Gehe direkt zu [Das erste Beispiel](./02-SetupDevEnvironment/README.md#step-2-create-a-github-personal-access-token) -> **Lieber lokal klonen?** +> **Bevorzugst du das lokale Klonen?** > -> Dieses Repository enthält über 50 Sprachübersetzungen, die die Downloadgröße erheblich erhöhen. Um ohne Übersetzungen zu klonen, verwende Sparse Checkout: +> Dieses Repository enthält über 50 Sprachübersetzungen, was die Downloadgröße deutlich erhöht. Zum Klonen ohne Übersetzungen verwende Sparse Checkout: > ```bash > git clone --filter=blob:none --sparse https://github.com/microsoft/Generative-AI-for-beginners-java.git > cd Generative-AI-for-beginners-java > git sparse-checkout set --no-cone '/*' '!translations' '!translated_images' > ``` -> So erhältst du alles, was du zur Kursteilnahme benötigst, bei deutlich schnellerem Download. +> Damit erhältst du alles, was du brauchst, um den Kurs mit wesentlich schnellerem Download abzuschließen. ## Mehrsprachige Unterstützung -### Unterstützt über GitHub Action (Automatisiert & immer aktuell) +### Unterstützt über GitHub Action (Automatisiert & stets aktuell) -[Arabisch](../ar/README.md) | [Bengalisch](../bn/README.md) | [Bulgarisch](../bg/README.md) | [Birmanisch (Myanmar)](../my/README.md) | [Chinesisch (vereinfacht)](../zh/README.md) | [Chinesisch (traditionell, Hongkong)](../hk/README.md) | [Chinesisch (traditionell, Macau)](../mo/README.md) | [Chinesisch (traditionell, Taiwan)](../tw/README.md) | [Kroatisch](../hr/README.md) | [Tschechisch](../cs/README.md) | [Dänisch](../da/README.md) | [Niederländisch](../nl/README.md) | [Estnisch](../et/README.md) | [Finnisch](../fi/README.md) | [Französisch](../fr/README.md) | [Deutsch](./README.md) | [Griechisch](../el/README.md) | [Hebräisch](../he/README.md) | [Hindi](../hi/README.md) | [Ungarisch](../hu/README.md) | [Indonesisch](../id/README.md) | [Italienisch](../it/README.md) | [Japanisch](../ja/README.md) | [Kannada](../kn/README.md) | [Koreanisch](../ko/README.md) | [Litauisch](../lt/README.md) | [Malaiisch](../ms/README.md) | [Malayalam](../ml/README.md) | [Marathi](../mr/README.md) | [Nepalesisch](../ne/README.md) | [Nigerianisches Pidgin](../pcm/README.md) | [Norwegisch](../no/README.md) | [Persisch (Farsi)](../fa/README.md) | [Polnisch](../pl/README.md) | [Portugiesisch (Brasilien)](../br/README.md) | [Portugiesisch (Portugal)](../pt/README.md) | [Punjabi (Gurmukhi)](../pa/README.md) | [Rumänisch](../ro/README.md) | [Russisch](../ru/README.md) | [Serbisch (Kyrillisch)](../sr/README.md) | [Slowakisch](../sk/README.md) | [Slowenisch](../sl/README.md) | [Spanisch](../es/README.md) | [Swahili](../sw/README.md) | [Schwedisch](../sv/README.md) | [Tagalog (Filipino)](../tl/README.md) | [Tamil](../ta/README.md) | [Telugu](../te/README.md) | [Thailändisch](../th/README.md) | [Türkisch](../tr/README.md) | [Ukrainisch](../uk/README.md) | [Urdu](../ur/README.md) | [Vietnamesisch](../vi/README.md) +[Arabisch](../ar/README.md) | [Bengalisch](../bn/README.md) | [Bulgarisch](../bg/README.md) | [Burmese (Myanmar)](../my/README.md) | [Chinesisch (vereinfacht)](../zh-CN/README.md) | [Chinesisch (traditionell, Hongkong)](../zh-HK/README.md) | [Chinesisch (traditionell, Macau)](../zh-MO/README.md) | [Chinesisch (traditionell, Taiwan)](../zh-TW/README.md) | [Kroatisch](../hr/README.md) | [Tschechisch](../cs/README.md) | [Dänisch](../da/README.md) | [Niederländisch](../nl/README.md) | [Estnisch](../et/README.md) | [Finnisch](../fi/README.md) | [Französisch](../fr/README.md) | [Deutsch](./README.md) | [Griechisch](../el/README.md) | [Hebräisch](../he/README.md) | [Hindi](../hi/README.md) | [Ungarisch](../hu/README.md) | [Indonesisch](../id/README.md) | [Italienisch](../it/README.md) | [Japanisch](../ja/README.md) | [Kannada](../kn/README.md) | [Koreanisch](../ko/README.md) | [Litauisch](../lt/README.md) | [Malaiisch](../ms/README.md) | [Malayalam](../ml/README.md) | [Marathi](../mr/README.md) | [Nepalesisch](../ne/README.md) | [Nigerianisches Pidgin](../pcm/README.md) | [Norwegisch](../no/README.md) | [Persisch (Farsi)](../fa/README.md) | [Polnisch](../pl/README.md) | [Portugiesisch (Brasilien)](../pt-BR/README.md) | [Portugiesisch (Portugal)](../pt-PT/README.md) | [Punjabi (Gurmukhi)](../pa/README.md) | [Rumänisch](../ro/README.md) | [Russisch](../ru/README.md) | [Serbisch (Kyrillisch)](../sr/README.md) | [Slowakisch](../sk/README.md) | [Slowenisch](../sl/README.md) | [Spanisch](../es/README.md) | [Suaheli](../sw/README.md) | [Schwedisch](../sv/README.md) | [Tagalog (Filipino)](../tl/README.md) | [Tamil](../ta/README.md) | [Telugu](../te/README.md) | [Thailändisch](../th/README.md) | [Türkisch](../tr/README.md) | [Ukrainisch](../uk/README.md) | [Urdu](../ur/README.md) | [Vietnamesisch](../vi/README.md) -> **Lieber lokal klonen?** +> **Bevorzugst du das lokale Klonen?** -> Dieses Repository enthält über 50 Sprachübersetzungen, die die Downloadgröße erheblich erhöhen. Um ohne Übersetzungen zu klonen, verwende Sparse Checkout: +> Dieses Repository enthält über 50 Sprachübersetzungen, was die Downloadgröße deutlich erhöht. Zum Klonen ohne Übersetzungen verwende Sparse Checkout: > ```bash > git clone --filter=blob:none --sparse https://github.com/microsoft/Generative-AI-for-beginners-java.git > cd Generative-AI-for-beginners-java > git sparse-checkout set --no-cone '/*' '!translations' '!translated_images' > ``` -> So erhältst du alles, was du zur Kursteilnahme benötigst, bei deutlich schnellerem Download. +> Damit erhältst du alles, was du brauchst, um den Kurs mit wesentlich schnellerem Download abzuschließen. ## Kursstruktur & Lernpfad @@ -57,35 +48,35 @@ CO_OP_TRANSLATOR_METADATA: ### **Kapitel 1: Einführung in Generative KI** - **Kernkonzepte**: Verständnis von großen Sprachmodellen, Tokens, Einbettungen und KI-Fähigkeiten - **Java KI-Ökosystem**: Überblick über Spring AI und OpenAI SDKs -- **Model Context Protocol**: Einführung in MCP und seine Rolle in der Kommunikation von KI-Agenten -- **Praktische Anwendungen**: Szenarien aus der Praxis wie Chatbots und Inhaltserstellung -- **[→ Starte Kapitel 1](./01-IntroToGenAI/README.md)** +- **Modell-Kontext-Protokoll**: Einführung in MCP und seine Rolle in der Kommunikation von KI-Agenten +- **Praktische Anwendungen**: Anwendungsbeispiele wie Chatbots und Inhaltserstellung +- **[→ Kapitel 1 starten](./01-IntroToGenAI/README.md)** -### **Kapitel 2: Einrichtung der Entwicklungsumgebung** -- **Multi-Provider-Konfiguration**: Einrichtung von GitHub Models, Azure OpenAI und OpenAI Java SDK Integrationen -- **Spring Boot + Spring AI**: Best Practices für die Entwicklung von KI-Unternehmensanwendungen -- **GitHub Models**: Kostenloser KI-Modellzugriff zum Prototyping und Lernen (keine Kreditkarte erforderlich) -- **Entwicklungstools**: Docker-Container, VS Code und GitHub Codespaces Konfiguration -- **[→ Starte Kapitel 2](./02-SetupDevEnvironment/README.md)** +### **Kapitel 2: Entwicklungsumgebung einrichten** +- **Multi-Provider Konfiguration**: Einrichtung von GitHub Models, Azure OpenAI und OpenAI Java SDK-Integrationen +- **Spring Boot + Spring AI**: Best Practices für die Entwicklung von Enterprise-KI-Anwendungen +- **GitHub Models**: Kostenloser Zugriff auf KI-Modelle für Prototyping und Lernen (keine Kreditkarte erforderlich) +- **Entwicklungswerkzeuge**: Docker-Container, VS Code und GitHub Codespaces Konfiguration +- **[→ Kapitel 2 starten](./02-SetupDevEnvironment/README.md)** ### **Kapitel 3: Kerntechniken der Generativen KI** -- **Prompt Engineering**: Techniken für optimale KI-Modellantworten -- **Einbettungen & Vektoroperationen**: Umsetzung von semantischer Suche und Ähnlichkeitsvergleich +- **Prompt Engineering**: Techniken für optimale Antworten von KI-Modellen +- **Embeddings & Vektoroperationen**: Umsetzung von semantischer Suche und Ähnlichkeitssuche - **Retrieval-Augmented Generation (RAG)**: Kombination von KI mit eigenen Datenquellen -- **Funktionsaufrufe**: Erweiterung der KI-Fähigkeiten mit benutzerdefinierten Werkzeugen und Plugins -- **[→ Starte Kapitel 3](./03-CoreGenerativeAITechniques/README.md)** +- **Funktionsaufrufe**: Erweiterung der KI-Fähigkeiten mit eigenen Tools und Plugins +- **[→ Kapitel 3 starten](./03-CoreGenerativeAITechniques/README.md)** ### **Kapitel 4: Praktische Anwendungen & Projekte** - **Pet Story Generator** (`petstory/`): Kreative Inhaltserstellung mit GitHub Models - **Foundry Local Demo** (`foundrylocal/`): Lokale KI-Modellintegration mit OpenAI Java SDK -- **MCP Rechner-Service** (`calculator/`): Grundlegende Model Context Protocol Implementierung mit Spring AI -- **[→ Starte Kapitel 4](./04-PracticalSamples/README.md)** +- **MCP Calculator Service** (`calculator/`): Grundlegende Modell-Kontext-Protokoll-Implementierung mit Spring AI +- **[→ Kapitel 4 starten](./04-PracticalSamples/README.md)** -### **Kapitel 5: Verantwortungsbewusste KI-Entwicklung** -- **GitHub Models Sicherheit**: Testen der eingebauten Inhaltsfilter- und Sicherheitsmechanismen (harte Sperren und weiche Ablehnungen) -- **Responsibility AI Demo**: Praktisches Beispiel, das zeigt, wie moderne KI-Sicherheitssysteme funktionieren -- **Best Practices**: Essenzielle Richtlinien für ethische KI-Entwicklung und -Einsatz -- **[→ Starte Kapitel 5](./05-ResponsibleGenAI/README.md)** +### **Kapitel 5: Verantwortungsvolle KI-Entwicklung** +- **GitHub Models Sicherheit**: Testen von eingebauten Inhaltsfiltern und Sicherheitsmechanismen (harte Blockaden und weiche Ablehnungen) +- **Responsible AI Demo**: Praxisbeispiel, wie moderne KI-Sicherheitssysteme funktionieren +- **Best Practices**: Wesentliche Richtlinien für ethische KI-Entwicklung und Einsatz +- **[→ Kapitel 5 starten](./05-ResponsibleGenAI/README.md)** ## Zusätzliche Ressourcen @@ -103,39 +94,40 @@ CO_OP_TRANSLATOR_METADATA: [![KI-Agenten für Einsteiger](https://img.shields.io/badge/AI%20Agents%20for%20Beginners-00C49A?style=for-the-badge&labelColor=E5E7EB&color=00C49A)](https://github.com/microsoft/ai-agents-for-beginners?WT.mc_id=academic-105485-koreyst) --- - -### Generative KI Serie + +### Generative KI Reihe [![Generative KI für Einsteiger](https://img.shields.io/badge/Generative%20AI%20for%20Beginners-8B5CF6?style=for-the-badge&labelColor=E5E7EB&color=8B5CF6)](https://github.com/microsoft/generative-ai-for-beginners?WT.mc_id=academic-105485-koreyst) [![Generative KI (.NET)](https://img.shields.io/badge/Generative%20AI%20(.NET)-9333EA?style=for-the-badge&labelColor=E5E7EB&color=9333EA)](https://github.com/microsoft/Generative-AI-for-beginners-dotnet?WT.mc_id=academic-105485-koreyst) [![Generative KI (Java)](https://img.shields.io/badge/Generative%20AI%20(Java)-C084FC?style=for-the-badge&labelColor=E5E7EB&color=C084FC)](https://github.com/microsoft/generative-ai-for-beginners-java?WT.mc_id=academic-105485-koreyst) [![Generative KI (JavaScript)](https://img.shields.io/badge/Generative%20AI%20(JavaScript)-E879F9?style=for-the-badge&labelColor=E5E7EB&color=E879F9)](https://github.com/microsoft/generative-ai-with-javascript?WT.mc_id=academic-105485-koreyst) --- - -### Kernwissen Lernen + +### Kernlernen [![ML für Einsteiger](https://img.shields.io/badge/ML%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=22C55E)](https://aka.ms/ml-beginners?WT.mc_id=academic-105485-koreyst) -[![Data Science für Einsteiger](https://img.shields.io/badge/Data%20Science%20for%20Beginners-84CC16?style=for-the-badge&labelColor=E5E7EB&color=84CC16)](https://aka.ms/datascience-beginners?WT.mc_id=academic-105485-koreyst) +[![Datenwissenschaft für Einsteiger](https://img.shields.io/badge/Data%20Science%20for%20Beginners-84CC16?style=for-the-badge&labelColor=E5E7EB&color=84CC16)](https://aka.ms/datascience-beginners?WT.mc_id=academic-105485-koreyst) [![KI für Einsteiger](https://img.shields.io/badge/AI%20for%20Beginners-A3E635?style=for-the-badge&labelColor=E5E7EB&color=A3E635)](https://aka.ms/ai-beginners?WT.mc_id=academic-105485-koreyst) -[![Cybersecurity für Einsteiger](https://img.shields.io/badge/Cybersecurity%20for%20Beginners-F97316?style=for-the-badge&labelColor=E5E7EB&color=F97316)](https://github.com/microsoft/Security-101?WT.mc_id=academic-96948-sayoung) -[![Webentwicklung für Einsteiger](https://img.shields.io/badge/Web%20Dev%20for%20Beginners-EC4899?style=for-the-badge&labelColor=E5E7EB&color=EC4899)](https://aka.ms/webdev-beginners?WT.mc_id=academic-105485-koreyst) -[![IoT für Anfänger](https://img.shields.io/badge/IoT%20for%20Beginners-14B8A6?style=for-the-badge&labelColor=E5E7EB&color=14B8A6)](https://aka.ms/iot-beginners?WT.mc_id=academic-105485-koreyst) -[![XR-Entwicklung für Anfänger](https://img.shields.io/badge/XR%20Development%20for%20Beginners-38BDF8?style=for-the-badge&labelColor=E5E7EB&color=38BDF8)](https://github.com/microsoft/xr-development-for-beginners?WT.mc_id=academic-105485-koreyst) +[![Cybersicherheit für Einsteiger](https://img.shields.io/badge/Cybersecurity%20for%20Beginners-F97316?style=for-the-badge&labelColor=E5E7EB&color=F97316)](https://github.com/microsoft/Security-101?WT.mc_id=academic-96948-sayoung) + +[![Web Dev for Beginners](https://img.shields.io/badge/Web%20Dev%20for%20Beginners-EC4899?style=for-the-badge&labelColor=E5E7EB&color=EC4899)](https://aka.ms/webdev-beginners?WT.mc_id=academic-105485-koreyst) +[![IoT for Beginners](https://img.shields.io/badge/IoT%20for%20Beginners-14B8A6?style=for-the-badge&labelColor=E5E7EB&color=14B8A6)](https://aka.ms/iot-beginners?WT.mc_id=academic-105485-koreyst) +[![XR Development for Beginners](https://img.shields.io/badge/XR%20Development%20for%20Beginners-38BDF8?style=for-the-badge&labelColor=E5E7EB&color=38BDF8)](https://github.com/microsoft/xr-development-for-beginners?WT.mc_id=academic-105485-koreyst) --- -### Copilot-Serie -[![Copilot für AI Paired Programming](https://img.shields.io/badge/Copilot%20for%20AI%20Paired%20Programming-FACC15?style=for-the-badge&labelColor=E5E7EB&color=FACC15)](https://aka.ms/GitHubCopilotAI?WT.mc_id=academic-105485-koreyst) -[![Copilot für C#/.NET](https://img.shields.io/badge/Copilot%20for%20C%23/.NET-FBBF24?style=for-the-badge&labelColor=E5E7EB&color=FBBF24)](https://github.com/microsoft/mastering-github-copilot-for-dotnet-csharp-developers?WT.mc_id=academic-105485-koreyst) -[![Copilot Abenteuer](https://img.shields.io/badge/Copilot%20Adventure-FDE68A?style=for-the-badge&labelColor=E5E7EB&color=FDE68A)](https://github.com/microsoft/CopilotAdventures?WT.mc_id=academic-105485-koreyst) +### Copilot Serie +[![Copilot for AI Paired Programming](https://img.shields.io/badge/Copilot%20for%20AI%20Paired%20Programming-FACC15?style=for-the-badge&labelColor=E5E7EB&color=FACC15)](https://aka.ms/GitHubCopilotAI?WT.mc_id=academic-105485-koreyst) +[![Copilot for C#/.NET](https://img.shields.io/badge/Copilot%20for%20C%23/.NET-FBBF24?style=for-the-badge&labelColor=E5E7EB&color=FBBF24)](https://github.com/microsoft/mastering-github-copilot-for-dotnet-csharp-developers?WT.mc_id=academic-105485-koreyst) +[![Copilot Adventure](https://img.shields.io/badge/Copilot%20Adventure-FDE68A?style=for-the-badge&labelColor=E5E7EB&color=FDE68A)](https://github.com/microsoft/CopilotAdventures?WT.mc_id=academic-105485-koreyst) ## Hilfe erhalten -Wenn Sie nicht weiterkommen oder Fragen zum Erstellen von KI-Apps haben. Treten Sie Gleichgesinnten und erfahrenen Entwicklern bei, um sich über MCP auszutauschen. Es ist eine unterstützende Gemeinschaft, in der Fragen willkommen sind und Wissen frei geteilt wird. +Falls Sie feststecken oder Fragen zum Erstellen von KI-Anwendungen haben. Treten Sie mit anderen Lernenden und erfahrenen Entwicklern in Diskussionen über MCP ein. Es ist eine unterstützende Gemeinschaft, in der Fragen willkommen sind und Wissen frei geteilt wird. [![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) -Wenn Sie Produktfeedback oder Fehler beim Erstellen haben, besuchen Sie: +Wenn Sie Produktfeedback oder Fehler während der Entwicklung haben, besuchen Sie: [![Microsoft Foundry Developer Forum](https://img.shields.io/badge/GitHub-Microsoft_Foundry_Developer_Forum-blue?style=for-the-badge&logo=github&color=000000&logoColor=fff)](https://aka.ms/foundry/forum) @@ -143,5 +135,5 @@ Wenn Sie Produktfeedback oder Fehler beim Erstellen haben, besuchen Sie: **Haftungsausschluss**: -Dieses Dokument wurde mit dem KI-Übersetzungsdienst [Co-op Translator](https://github.com/Azure/co-op-translator) übersetzt. Obwohl wir auf Genauigkeit achten, bitten wir zu beachten, dass automatisierte Übersetzungen Fehler oder Ungenauigkeiten enthalten können. Das Originaldokument in der Ausgangssprache ist als maßgebliche Quelle zu betrachten. Für wichtige Informationen wird eine professionelle menschliche Übersetzung empfohlen. Wir übernehmen keine Haftung für Missverständnisse oder Fehlinterpretationen, die aus der Nutzung dieser Übersetzung entstehen. +Dieses Dokument wurde mithilfe des KI-Übersetzungsdienstes [Co-op Translator](https://github.com/Azure/co-op-translator) übersetzt. Obwohl wir uns um Genauigkeit bemühen, beachten Sie bitte, dass automatisierte Übersetzungen Fehler oder Ungenauigkeiten enthalten können. Das Originaldokument in seiner Originalsprache ist als maßgebliche Quelle anzusehen. Bei wichtigen Informationen wird eine professionelle menschliche Übersetzung empfohlen. Für Missverständnisse oder Fehlinterpretationen, die durch die Nutzung dieser Übersetzung entstehen, übernehmen wir keine Haftung. \ No newline at end of file diff --git a/translations/de/SECURITY.md b/translations/de/SECURITY.md index f161ec29..8236de38 100644 --- a/translations/de/SECURITY.md +++ b/translations/de/SECURITY.md @@ -1,12 +1,3 @@ - ## Sicherheit Microsoft nimmt die Sicherheit seiner Softwareprodukte und -dienste sehr ernst, einschließlich aller Quellcode-Repositories, die über unsere GitHub-Organisationen verwaltet werden, wie [Microsoft](https://github.com/Microsoft), [Azure](https://github.com/Azure), [DotNet](https://github.com/dotnet), [AspNet](https://github.com/aspnet) und [Xamarin](https://github.com/xamarin). diff --git a/translations/de/SUPPORT.md b/translations/de/SUPPORT.md index 95b863eb..32f8e954 100644 --- a/translations/de/SUPPORT.md +++ b/translations/de/SUPPORT.md @@ -1,12 +1,3 @@ - # Unterstützung ## So melden Sie Probleme und erhalten Hilfe diff --git a/translations/el/.co-op-translator.json b/translations/el/.co-op-translator.json new file mode 100644 index 00000000..812b89e7 --- /dev/null +++ b/translations/el/.co-op-translator.json @@ -0,0 +1,92 @@ +{ + "01-IntroToGenAI/README.md": { + "original_hash": "75bfb080ca725e8a9aa9c80cae25fba1", + "translation_date": "2025-07-29T09:17:22+00:00", + "source_file": "01-IntroToGenAI/README.md", + "language_code": "el" + }, + "02-SetupDevEnvironment/README.md": { + "original_hash": "96a30d42b9751a3d4e4b20e28d29d459", + "translation_date": "2026-01-28T05:00:48+00:00", + "source_file": "02-SetupDevEnvironment/README.md", + "language_code": "el" + }, + "02-SetupDevEnvironment/examples/basic-chat-azure/README.md": { + "original_hash": "efd82efe50711d7e257eb943151d682c", + "translation_date": "2025-07-27T13:41:10+00:00", + "source_file": "02-SetupDevEnvironment/examples/basic-chat-azure/README.md", + "language_code": "el" + }, + "02-SetupDevEnvironment/getting-started-azure-openai.md": { + "original_hash": "bfdb4b4eadbee3a59ef742439f58326a", + "translation_date": "2025-07-27T13:10:25+00:00", + "source_file": "02-SetupDevEnvironment/getting-started-azure-openai.md", + "language_code": "el" + }, + "03-CoreGenerativeAITechniques/README.md": { + "original_hash": "685f55cb07de19b52a30ce6e8b6d889e", + "translation_date": "2025-08-28T22:06:24+00:00", + "source_file": "03-CoreGenerativeAITechniques/README.md", + "language_code": "el" + }, + "04-PracticalSamples/README.md": { + "original_hash": "14c0a61ecc1cd2012a9c129236dfdf71", + "translation_date": "2025-07-29T09:17:00+00:00", + "source_file": "04-PracticalSamples/README.md", + "language_code": "el" + }, + "04-PracticalSamples/calculator/README.md": { + "original_hash": "b6c16b5514d524e415a94f6097ee7d4c", + "translation_date": "2025-09-18T15:32:47+00:00", + "source_file": "04-PracticalSamples/calculator/README.md", + "language_code": "el" + }, + "04-PracticalSamples/foundrylocal/README.md": { + "original_hash": "f787307400de59adc25a1404466a35f3", + "translation_date": "2025-11-04T07:25:09+00:00", + "source_file": "04-PracticalSamples/foundrylocal/README.md", + "language_code": "el" + }, + "04-PracticalSamples/petstory/README.md": { + "original_hash": "0cbf68d605615a1e602c832a24616859", + "translation_date": "2025-07-25T11:25:41+00:00", + "source_file": "04-PracticalSamples/petstory/README.md", + "language_code": "el" + }, + "05-ResponsibleGenAI/README.md": { + "original_hash": "301c05c2f57e60a6950b8c665b8bdbba", + "translation_date": "2025-07-29T15:50:46+00:00", + "source_file": "05-ResponsibleGenAI/README.md", + "language_code": "el" + }, + "AGENTS.md": { + "original_hash": "afc90918d008cf77fd1982691f681306", + "translation_date": "2025-10-03T08:36:16+00:00", + "source_file": "AGENTS.md", + "language_code": "el" + }, + "CODE_OF_CONDUCT.md": { + "original_hash": "442b123d034f92f7c384d2bbd28f99f1", + "translation_date": "2025-07-21T19:08:03+00:00", + "source_file": "CODE_OF_CONDUCT.md", + "language_code": "el" + }, + "README.md": { + "original_hash": "125a08948d881c95628094f4dd1fbd43", + "translation_date": "2026-01-29T15:48:09+00:00", + "source_file": "README.md", + "language_code": "el" + }, + "SECURITY.md": { + "original_hash": "57f14126c1c6add76b3aef3844dfe4e3", + "translation_date": "2025-07-21T19:05:36+00:00", + "source_file": "SECURITY.md", + "language_code": "el" + }, + "SUPPORT.md": { + "original_hash": "b8ef73cc49dec68e2c885ee9df545129", + "translation_date": "2025-07-21T19:09:10+00:00", + "source_file": "SUPPORT.md", + "language_code": "el" + } +} \ No newline at end of file diff --git a/translations/el/01-IntroToGenAI/README.md b/translations/el/01-IntroToGenAI/README.md index 17cccbe8..70139f71 100644 --- a/translations/el/01-IntroToGenAI/README.md +++ b/translations/el/01-IntroToGenAI/README.md @@ -1,12 +1,3 @@ - # Εισαγωγή στη Γενεσιουργό Τεχνητή Νοημοσύνη - Έκδοση Java ## Τι θα μάθετε diff --git a/translations/el/02-SetupDevEnvironment/README.md b/translations/el/02-SetupDevEnvironment/README.md index cc0b4997..d2276788 100644 --- a/translations/el/02-SetupDevEnvironment/README.md +++ b/translations/el/02-SetupDevEnvironment/README.md @@ -1,13 +1,254 @@ - +# Ρύθμιση του Περιβάλλοντος Ανάπτυξης για Γενετική AI για Java +> **Γρήγορη Εκκίνηση**: Κωδικοποιήστε στο Cloud σε 2 λεπτά - Μεταβείτε στο [GitHub Codespaces Setup](../../../02-SetupDevEnvironment) - δεν απαιτείται τοπική εγκατάσταση και χρησιμοποιεί μοντέλα του GitHub! + +> **Ενδιαφέρεστε για Azure OpenAI;**, δείτε τον [Οδηγό Ρύθμισης Azure OpenAI](getting-started-azure-openai.md) με βήματα για τη δημιουργία ενός νέου πόρου Azure OpenAI. + +## Τι θα μάθετε + +- Ρύθμιση περιβάλλοντος ανάπτυξης Java για εφαρμογές AI +- Επιλογή και διαμόρφωση του προτιμώμενου περιβάλλοντος ανάπτυξης (cloud-first με Codespaces, τοπικό dev container, ή πλήρης τοπική ρύθμιση) +- Δοκιμή της ρύθμισης με σύνδεση στα μοντέλα GitHub + +## Περιεχόμενα + +- [Τι θα μάθετε](../../../02-SetupDevEnvironment) +- [Εισαγωγή](../../../02-SetupDevEnvironment) +- [Βήμα 1: Ρυθμίστε το Περιβάλλον Ανάπτυξής σας](../../../02-SetupDevEnvironment) + - [Επιλογή Α: GitHub Codespaces (Συνιστάται)](../../../02-SetupDevEnvironment) + - [Επιλογή Β: Τοπικό Dev Container](../../../02-SetupDevEnvironment) + - [Επιλογή Γ: Χρήση της Υφιστάμενης Τοπικής Εγκατάστασης](../../../02-SetupDevEnvironment) +- [Βήμα 2: Δημιουργία Προσωπικού Access Token GitHub](../../../02-SetupDevEnvironment) +- [Βήμα 3: Δοκιμή της Ρύθμισής σας](../../../02-SetupDevEnvironment) +- [Επίλυση Προβλημάτων](../../../02-SetupDevEnvironment) +- [Περίληψη](../../../02-SetupDevEnvironment) +- [Επόμενα Βήματα](../../../02-SetupDevEnvironment) + +## Εισαγωγή + +Αυτό το κεφάλαιο θα σας καθοδηγήσει στη ρύθμιση ενός περιβάλλοντος ανάπτυξης. Θα χρησιμοποιήσουμε τα **GitHub Models** ως κύριο παράδειγμα επειδή είναι δωρεάν, εύκολα στη ρύθμιση με μόνο έναν λογαριασμό GitHub, δεν απαιτεί πιστωτική κάρτα και παρέχει πρόσβαση σε πολλά μοντέλα για πειραματισμό. + +**Δεν απαιτείται τοπική ρύθμιση!** Μπορείτε να ξεκινήσετε αμέσως να κωδικοποιείτε χρησιμοποιώντας GitHub Codespaces, που παρέχει πλήρες περιβάλλον ανάπτυξης στον browser σας. + +Screenshot: GitHub Models + +Συνιστούμε τη χρήση των [**GitHub Models**](https://github.com/marketplace?type=models) για αυτό το μάθημα επειδή είναι: +- **Δωρεάν** για να ξεκινήσετε +- **Εύκολο** στη ρύθμιση με μόνο έναν λογαριασμό GitHub +- **Χωρίς ανάγκη πιστωτικής κάρτας** +- **Πολλαπλά μοντέλα** διαθέσιμα για πειραματισμό + +> **Σημείωση**: Τα GitHub Models που χρησιμοποιούνται σε αυτή την εκπαίδευση έχουν τα παρακάτω δωρεάν όρια: +> - 15 αιτήματα ανά λεπτό (150 ανά ημέρα) +> - ~8.000 λέξεις εισόδου, ~4.000 λέξεις εξόδου ανά αίτημα +> - 5 ταυτόχρονα αιτήματα +> +> Για χρήση στην παραγωγή, αναβαθμίστε σε Azure AI Foundry Models με τον λογαριασμό Azure σας. Δεν χρειάζεται να αλλάξετε τον κώδικά σας. Δείτε την [τεκμηρίωση Azure AI Foundry](https://learn.microsoft.com/azure/ai-foundry/foundry-models/how-to/quickstart-github-models). + + +## Βήμα 1: Ρυθμίστε το Περιβάλλον Ανάπτυξής σας + + + +Έχουμε δημιουργήσει ένα προκαθορισμένο development container για να ελαχιστοποιήσουμε το χρόνο ρύθμισης και να διασφαλίσουμε ότι έχετε όλα τα απαραίτητα εργαλεία για αυτό το μάθημα Γενετικής AI για Java. Επιλέξτε την προτιμώμενη μέθοδο ανάπτυξης: + +### Επιλογές Ρύθμισης Περιβάλλοντος: + +#### Επιλογή Α: GitHub Codespaces (Συνιστάται) + +**Ξεκινήστε να κωδικοποιείτε σε 2 λεπτά - δεν απαιτείται τοπική ρύθμιση!** + +1. Κάντε fork αυτό το αποθετήριο στο λογαριασμό GitHub σας + > **Σημείωση**: Αν θέλετε να επεξεργαστείτε τη βασική διαμόρφωση, παρακαλώ δείτε το [Dev Container Configuration](../../../.devcontainer/devcontainer.json) +2. Κάντε κλικ **Code** → καρτέλα **Codespaces** → **...** → **New with options...** +3. Χρησιμοποιήστε τις προεπιλογές – αυτό θα επιλέξει τη **Dev container configuration**: **Generative AI Java Development Environment**, προσαρμοσμένο devcontainer δημιουργημένο για αυτό το μάθημα +4. Κάντε κλικ στο **Create codespace** +5. Περιμένετε περίπου 2 λεπτά μέχρι να είναι έτοιμο το περιβάλλον +6. Συνεχίστε στο [Βήμα 2: Δημιουργία GitHub Token](../../../02-SetupDevEnvironment) + +Screenshot: Codespaces submenu + +Screenshot: New with options + +Screenshot: Create codespace options + + +> **Πλεονεκτήματα των Codespaces**: +> - Δεν απαιτείται τοπική εγκατάσταση +> - Λειτουργεί σε οποιαδήποτε συσκευή με browser +> - Προδιαμορφωμένο με όλα τα εργαλεία και εξαρτήσεις +> - Δωρεάν 60 ώρες ανά μήνα για προσωπικούς λογαριασμούς +> - Συνεπές περιβάλλον για όλους τους μαθητές + +#### Επιλογή Β: Τοπικό Dev Container + +**Για προγραμματιστές που προτιμούν τοπική ανάπτυξη με Docker** + +1. Κάντε fork και clone αυτό το αποθετήριο στην τοπική σας μηχανή + > **Σημείωση**: Αν θέλετε να επεξεργαστείτε τη βασική διαμόρφωση, παρακαλώ δείτε το [Dev Container Configuration](../../../.devcontainer/devcontainer.json) +2. Εγκαταστήστε το [Docker Desktop](https://www.docker.com/products/docker-desktop/) και το [VS Code](https://code.visualstudio.com/) +3. Εγκαταστήστε την επέκταση [Dev Containers](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers) στο VS Code +4. Ανοίξτε το φάκελο του αποθετηρίου στο VS Code +5. Όταν ζητηθεί, κάντε κλικ στο **Reopen in Container** (ή χρησιμοποιήστε `Ctrl+Shift+P` → "Dev Containers: Reopen in Container") +6. Περιμένετε να ολοκληρωθεί η κατασκευή και εκκίνηση του container +7. Συνεχίστε στο [Βήμα 2: Δημιουργία GitHub Token](../../../02-SetupDevEnvironment) + +Screenshot: Dev container setup + +Screenshot: Dev container build complete + +#### Επιλογή Γ: Χρήση της Υφιστάμενης Τοπικής Εγκατάστασης + +**Για προγραμματιστές με υπάρχοντα περιβάλλοντα Java** + +Απαιτήσεις: +- [Java 21+](https://www.oracle.com/java/technologies/javase/jdk21-archive-downloads.html) +- [Maven 3.9+](https://maven.apache.org/download.cgi) +- [VS Code](https://code.visualstudio.com) ή το προτιμώμενο IDE σας + +Βήματα: +1. Κλωνοποιήστε αυτό το αποθετήριο στην τοπική μηχανή σας +2. Ανοίξτε το έργο στο IDE σας +3. Συνεχίστε στο [Βήμα 2: Δημιουργία GitHub Token](../../../02-SetupDevEnvironment) + +> **Επαγγελματική Συμβουλή**: Αν έχετε μηχανή χαμηλών προδιαγραφών αλλά θέλετε το VS Code τοπικά, χρησιμοποιήστε το GitHub Codespaces! Μπορείτε να συνδέσετε το τοπικό VS Code σε ένα φιλοξενούμενο στο cloud Codespace για το καλύτερο και από τους δύο κόσμους. + +Screenshot: created local devcontainer instance + + +## Βήμα 2: Δημιουργία Προσωπικού Access Token GitHub + +1. Μεταβείτε στις [Ρυθμίσεις του GitHub](https://github.com/settings/profile) και επιλέξτε **Settings** από το μενού προφίλ σας. +2. Στην αριστερή πλευρική μπάρα, κάντε κλικ στο **Developer settings** (συνήθως κάτω κάτω). +3. Κάτω από **Personal access tokens**, κάντε κλικ στο **Fine-grained tokens** (ή ακολουθήστε αυτόν τον άμεσο [σύνδεσμο](https://github.com/settings/personal-access-tokens)). +4. Κάντε κλικ στο **Generate new token**. +5. Στο "Token name", δώστε μια περιγραφική ονομασία (π.χ., `GenAI-Java-Course-Token`). +6. Ορίστε ημερομηνία λήξης (συνιστάται: 7 ημέρες για βέλτιστες πρακτικές ασφαλείας). +7. Στο "Resource owner" επιλέξτε τον λογαριασμό χρήστη σας. +8. Στο "Repository access" επιλέξτε τα αποθετήρια που θέλετε να χρησιμοποιήσετε με το GitHub Models (ή "All repositories" αν χρειάζεται). +9. Στα "Account permissions", βρείτε **Models** και ορίστε το σε **Read-only**. +10. Κάντε κλικ στο **Generate token**. +11. **Αντιγράψτε και αποθηκεύστε το token τώρα** – δεν θα το δείτε ξανά! + +> **Συμβουλή Ασφαλείας**: Χρησιμοποιήστε το ελάχιστο απαιτούμενο εύρος και τη μικρότερη πρακτική διάρκεια λήξης για τα tokens πρόσβασης σας. + +## Βήμα 3: Δοκιμή της Ρύθμισής σας με το Παράδειγμα GitHub Models + +Αφού είναι έτοιμο το περιβάλλον ανάπτυξης, ας δοκιμάσουμε την ενσωμάτωση των GitHub Models με την εφαρμογή παραδείγματος στο [`02-SetupDevEnvironment/examples/github-models`](../../../02-SetupDevEnvironment/examples/github-models). + +1. Ανοίξτε το τερματικό στο περιβάλλον ανάπτυξής σας. +2. Μεταβείτε στο παράδειγμα GitHub Models: + ```bash + cd 02-SetupDevEnvironment/examples/github-models + ``` +3. Ορίστε το GitHub token σας ως μεταβλητή περιβάλλοντος: + ```bash + # macOS/Linux + export GITHUB_TOKEN=your_token_here + + # Windows (Γραμμή Εντολών) + set GITHUB_TOKEN=your_token_here + + # Windows (PowerShell) + $env:GITHUB_TOKEN="your_token_here" + ``` + +4. Εκτελέστε την εφαρμογή: + ```bash + mvn compile exec:java -Dexec.mainClass="com.example.githubmodels.App" + ``` + +Θα δείτε έξοδο παρόμοια με: +```text +Using model: gpt-4.1-nano +Sending request to GitHub Models... +Response: Hello World! +``` + +### Κατανόηση του Κώδικα Παραδείγματος + +Πρώτα, ας καταλάβουμε τι μόλις εκτελέσαμε. Το παράδειγμα στο `examples/github-models` χρησιμοποιεί το OpenAI Java SDK για σύνδεση στα GitHub Models: + +**Τι κάνει αυτός ο κώδικας:** +- **Συνδέεται** με τα GitHub Models χρησιμοποιώντας το προσωπικό access token σας +- **Στέλνει** ένα απλό μήνυμα "Say Hello World!" στο μοντέλο AI +- **Λαμβάνει** και εμφανίζει την απάντηση του AI +- **Επαληθεύει** ότι η ρύθμιση λειτουργεί σωστά + +**Βασική Εξάρτηση** (στο `pom.xml`): +```xml + + com.openai + openai-java + 2.12.0 + +``` + +**Κύριος Κώδικας** (`App.java`): +```java +// Συνδεθείτε με τα μοντέλα GitHub χρησιμοποιώντας το OpenAI Java SDK +OpenAIClient client = OpenAIOkHttpClient.builder() + .apiKey(pat) + .baseUrl("https://models.inference.ai.azure.com") + .build(); + +// Δημιουργήστε αίτημα ολοκλήρωσης συνομιλίας +ChatCompletionCreateParams params = ChatCompletionCreateParams.builder() + .model(modelId) + .addSystemMessage("You are a concise assistant.") + .addUserMessage("Say Hello World!") + .build(); + +// Λάβετε απάντηση AI +ChatCompletion response = client.chat().completions().create(params); +System.out.println("Response: " + response.choices().get(0).message().content().orElse("No response content")); +``` + +## Περίληψη + +Τέλεια! Τώρα έχετε όλα έτοιμα: + +- Δημιουργήσατε ένα Προσωπικό Access Token GitHub με τα σωστά δικαιώματα για πρόσβαση σε μοντέλα AI +- Τρέχετε το περιβάλλον ανάπτυξης Java σας (είτε Codespaces, dev containers, είτε τοπικό) +- Συνδεθήκατε στα GitHub Models χρησιμοποιώντας το OpenAI Java SDK για δωρεάν ανάπτυξη AI +- Δοκιμάσατε ότι όλα λειτουργούν με ένα απλό παράδειγμα που επικοινωνεί με τα μοντέλα AI + +## Επόμενα Βήματα + +[Κεφάλαιο 3: Βασικές Τεχνικές Γενετικής AI](../03-CoreGenerativeAITechniques/README.md) + +## Επίλυση Προβλημάτων + +Έχετε προβλήματα; Εδώ είναι κοινά ζητήματα και λύσεις: + +- **Το token δεν λειτουργεί;** + - Επιβεβαιώστε ότι αντιγράψατε ολόκληρο το token χωρίς επιπλέον κενά + - Ελέγξτε ότι το token έχει οριστεί σωστά ως μεταβλητή περιβάλλοντος + - Βεβαιωθείτε ότι το token έχει τα σωστά δικαιώματα (Models: Read-only) + +- **Δεν βρέθηκε το Maven;** + - Αν χρησιμοποιείτε dev containers/Codespaces, το Maven πρέπει να είναι ήδη εγκατεστημένο + - Για τοπική ρύθμιση, βεβαιωθείτε ότι έχετε εγκαταστήσει Java 21+ και Maven 3.9+ + - Δοκιμάστε `mvn --version` για να ελέγξετε την εγκατάσταση + +- **Προβλήματα σύνδεσης;** + - Ελέγξτε τη σύνδεσή σας στο διαδίκτυο + - Βεβαιωθείτε ότι το GitHub είναι προσβάσιμο από το δίκτυό σας + - Σιγουρευτείτε ότι δεν είστε πίσω από firewall που μπλοκάρει το endpoint των GitHub Models + +- **Το dev container δεν ξεκινά;** + - Βεβαιωθείτε ότι το Docker Desktop τρέχει (για τοπική ανάπτυξη) + - Δοκιμάστε να ξαναχτίσετε το container: `Ctrl+Shift+P` → "Dev Containers: Rebuild Container" + +- **Σφάλματα κατά τη μεταγλώττιση της εφαρμογής;** + - Βεβαιωθείτε ότι βρίσκεστε στον σωστό φάκελο: `02-SetupDevEnvironment/examples/github-models` + - Δοκιμάστε καθάρισμα και ξανακατασκευή: `mvn clean compile` + +> **Χρειάζεστε βοήθεια;**: Αν εξακολουθείτε να έχετε προβλήματα, ανοίξτε ένα issue στο αποθετήριο και θα σας βοηθήσουμε. --- + +**Αποποίηση ευθυνών**: +Αυτό το έγγραφο έχει μεταφραστεί χρησιμοποιώντας την υπηρεσία αυτόματης μετάφρασης AI [Co-op Translator](https://github.com/Azure/co-op-translator). Παρότι προσπαθούμε για ακρίβεια, παρακαλούμε να λάβετε υπόψη ότι οι αυτόματες μεταφράσεις μπορεί να περιέχουν λάθη ή ανακρίβειες. Το πρωτότυπο έγγραφο στη γλώσσα του θεωρείται η αυθεντική πηγή. Για κρίσιμες πληροφορίες, συνιστάται επαγγελματική ανθρώπινη μετάφραση. Δεν φέρουμε καμία ευθύνη για τυχόν παρερμηνείες ή λανθασμένες αντιλήψεις που προκύπτουν από τη χρήση αυτής της μετάφρασης. + \ No newline at end of file diff --git a/translations/el/02-SetupDevEnvironment/examples/basic-chat-azure/README.md b/translations/el/02-SetupDevEnvironment/examples/basic-chat-azure/README.md index 476d7663..957cbd88 100644 --- a/translations/el/02-SetupDevEnvironment/examples/basic-chat-azure/README.md +++ b/translations/el/02-SetupDevEnvironment/examples/basic-chat-azure/README.md @@ -1,12 +1,3 @@ - # Βασική Συνομιλία με το Azure OpenAI - Παράδειγμα από Άκρη σε Άκρη Αυτό το παράδειγμα δείχνει πώς να δημιουργήσετε μια απλή εφαρμογή Spring Boot που συνδέεται με το Azure OpenAI και δοκιμάζει τη ρύθμισή σας. diff --git a/translations/el/02-SetupDevEnvironment/getting-started-azure-openai.md b/translations/el/02-SetupDevEnvironment/getting-started-azure-openai.md index e95343e0..490bc481 100644 --- a/translations/el/02-SetupDevEnvironment/getting-started-azure-openai.md +++ b/translations/el/02-SetupDevEnvironment/getting-started-azure-openai.md @@ -1,12 +1,3 @@ - # Ρύθμιση του Περιβάλλοντος Ανάπτυξης για το Azure OpenAI > **Γρήγορη Εκκίνηση**: Αυτός ο οδηγός αφορά τη ρύθμιση του Azure OpenAI. Για άμεση εκκίνηση με δωρεάν μοντέλα, χρησιμοποιήστε [GitHub Models with Codespaces](./README.md#quick-start-cloud). diff --git a/translations/el/03-CoreGenerativeAITechniques/README.md b/translations/el/03-CoreGenerativeAITechniques/README.md index 97caa91f..81c753d9 100644 --- a/translations/el/03-CoreGenerativeAITechniques/README.md +++ b/translations/el/03-CoreGenerativeAITechniques/README.md @@ -1,12 +1,3 @@ - # Βασικές Τεχνικές Γενετικής Τεχνητής Νοημοσύνης - Εκπαιδευτικό Υλικό ## Πίνακας Περιεχομένων diff --git a/translations/el/04-PracticalSamples/README.md b/translations/el/04-PracticalSamples/README.md index 3e5b5d89..1aed16a8 100644 --- a/translations/el/04-PracticalSamples/README.md +++ b/translations/el/04-PracticalSamples/README.md @@ -1,12 +1,3 @@ - # Πρακτικές Εφαρμογές & Έργα ## Τι Θα Μάθετε diff --git a/translations/el/04-PracticalSamples/calculator/README.md b/translations/el/04-PracticalSamples/calculator/README.md index 6f90b16e..a7bf5497 100644 --- a/translations/el/04-PracticalSamples/calculator/README.md +++ b/translations/el/04-PracticalSamples/calculator/README.md @@ -1,12 +1,3 @@ - # Εκπαιδευτικό Υλικό MCP Calculator για Αρχάριους ## Πίνακας Περιεχομένων diff --git a/translations/el/04-PracticalSamples/foundrylocal/README.md b/translations/el/04-PracticalSamples/foundrylocal/README.md index b98f4a12..c116d2a8 100644 --- a/translations/el/04-PracticalSamples/foundrylocal/README.md +++ b/translations/el/04-PracticalSamples/foundrylocal/README.md @@ -1,12 +1,3 @@ - # Οδηγός για το Foundry Local με Spring Boot ## Περιεχόμενα diff --git a/translations/el/04-PracticalSamples/petstory/README.md b/translations/el/04-PracticalSamples/petstory/README.md index af4651b6..c7fe44ba 100644 --- a/translations/el/04-PracticalSamples/petstory/README.md +++ b/translations/el/04-PracticalSamples/petstory/README.md @@ -1,12 +1,3 @@ - # Οδηγός για Αρχάριους: Δημιουργία Ιστοριών για Κατοικίδια ## Πίνακας Περιεχομένων diff --git a/translations/el/05-ResponsibleGenAI/README.md b/translations/el/05-ResponsibleGenAI/README.md index 2f749dbc..7d933498 100644 --- a/translations/el/05-ResponsibleGenAI/README.md +++ b/translations/el/05-ResponsibleGenAI/README.md @@ -1,12 +1,3 @@ - # Υπεύθυνη Γενεσιουργός Τεχνητή Νοημοσύνη ## Τι Θα Μάθετε diff --git a/translations/el/AGENTS.md b/translations/el/AGENTS.md index 492cb691..b30bb6c6 100644 --- a/translations/el/AGENTS.md +++ b/translations/el/AGENTS.md @@ -1,12 +1,3 @@ - # AGENTS.md ## Επισκόπηση Έργου diff --git a/translations/el/CODE_OF_CONDUCT.md b/translations/el/CODE_OF_CONDUCT.md index fc973e78..dbe5651d 100644 --- a/translations/el/CODE_OF_CONDUCT.md +++ b/translations/el/CODE_OF_CONDUCT.md @@ -1,12 +1,3 @@ - # Κώδικας Δεοντολογίας Ανοιχτού Κώδικα της Microsoft Αυτό το έργο έχει υιοθετήσει τον [Κώδικα Δεοντολογίας Ανοιχτού Κώδικα της Microsoft](https://opensource.microsoft.com/codeofconduct/). diff --git a/translations/el/README.md b/translations/el/README.md index 36ce9ec0..dad49c86 100644 --- a/translations/el/README.md +++ b/translations/el/README.md @@ -1,141 +1,132 @@ - -# Δημιουργική Τεχνητή Νοημοσύνη για Αρχάριους - Έκδοση Java +# Γεννητική ΤΝ για Αρχάριους - Έκδοση Java [![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) -![Generative AI for Beginners - Java Edition](../../translated_images/el/beg-genai-series.8b48be9951cc574c.webp) +![Γεννητική ΤΝ για Αρχάριους - Έκδοση Java](../../translated_images/el/beg-genai-series.8b48be9951cc574c.webp) -**Διάρκεια**: Το ολόκληρο εργαστήριο μπορεί να ολοκληρωθεί διαδικτυακά χωρίς τοπική εγκατάσταση. Η ρύθμιση του περιβάλλοντος διαρκεί 2 λεπτά, ενώ η εξερεύνηση των δειγμάτων απαιτεί 1-3 ώρες ανάλογα με το βάθος της εξερεύνησης. +**Απαιτούμενος Χρόνος**: Το εργαστήριο μπορεί να ολοκληρωθεί εξ ολοκλήρου διαδικτυακά χωρίς τοπική εγκατάσταση. Η ρύθμιση του περιβάλλοντος διαρκεί 2 λεπτά, ενώ η εξερεύνηση των παραδειγμάτων απαιτεί 1-3 ώρες ανάλογα με το βάθος της διερεύνησης. -> **Γρήγορη Εκκίνηση** +> **Γρήγορη Εκκίνηση** -1. Κάντε fork αυτό το αποθετήριο στον λογαριασμό σας στο GitHub -2. Κάντε κλικ στο **Code** → καρτέλα **Codespaces** → **...** → **New with options...** -3. Χρησιμοποιήστε τις προεπιλογές – αυτό θα επιλέξει το Development container που έχει δημιουργηθεί για το μάθημα -4. Πατήστε **Create codespace** -5. Περιμένετε ~2 λεπτά για να είναι έτοιμο το περιβάλλον -6. Πηγαίνετε απευθείας στο [Το πρώτο παράδειγμα](./02-SetupDevEnvironment/README.md#step-2-create-a-github-personal-access-token) +1. Δημιουργήστε fork αυτού του αποθετηρίου στον λογαριασμό σας στο GitHub +2. Κάντε κλικ στο **Code** → στην καρτέλα **Codespaces** → **...** → **Δημιουργία με επιλογές...** +3. Χρησιμοποιήστε τις προεπιλογές – αυτό θα επιλέξει το κοντέινερ ανάπτυξης που δημιουργήθηκε για αυτό το μάθημα +4. Κάντε κλικ στο **Δημιουργία codespace** +5. Περιμένετε περίπου 2 λεπτά για να είναι έτοιμο το περιβάλλον +6. Μεταβείτε απευθείας στο [Πρώτο παράδειγμα](./02-SetupDevEnvironment/README.md#step-2-create-a-github-personal-access-token) -> **Προτιμάτε να Κλωνοποιήσετε τοπικά;** +> **Προτιμάτε να κάνετε τοπικό κλωνοποίηση;** > -> Αυτό το αποθετήριο περιλαμβάνει πάνω από 50 μεταφράσεις σε γλώσσες, που αυξάνει σημαντικά το μέγεθος λήψης. Για να κλωνοποιήσετε χωρίς τις μεταφράσεις, χρησιμοποιήστε το sparse checkout: +> Αυτό το αποθετήριο περιλαμβάνει πάνω από 50 μεταφράσεις γλωσσών που αυξάνουν σημαντικά το μέγεθος λήψης. Για κλωνοποίηση χωρίς μεταφράσεις, χρησιμοποιήστε sparse checkout: > ```bash > git clone --filter=blob:none --sparse https://github.com/microsoft/Generative-AI-for-beginners-java.git > cd Generative-AI-for-beginners-java > git sparse-checkout set --no-cone '/*' '!translations' '!translated_images' > ``` -> Αυτό σας δίνει ό,τι χρειάζεστε για να ολοκληρώσετε το μάθημα με πολύ πιο γρήγορη λήψη. +> Αυτό σας δίνει ό,τι χρειάζεστε για να ολοκληρώσετε το μάθημα με πολύ ταχύτερη λήψη. -## Υποστήριξη πολλαπλών γλωσσών +## Υποστήριξη Πολλών Γλωσσών -### Υποστηρίζεται μέσω GitHub Action (Αυτοματοποιημένα & Πάντα Ενημερωμένα) +### Υποστηρίζεται μέσω GitHub Action (Αυτοματοποιημένο & Πάντα Ενημερωμένο) -[Αραβικά](../ar/README.md) | [Μπενγκάλι](../bn/README.md) | [Βουλγαρικά](../bg/README.md) | [Βιρμανικά (Μιανμάρ)](../my/README.md) | [Κινέζικα (Απλοποιημένα)](../zh/README.md) | [Κινέζικα (Παραδοσιακά, Χονγκ Κονγκ)](../hk/README.md) | [Κινέζικα (Παραδοσιακά, Μακάο)](../mo/README.md) | [Κινέζικα (Παραδοσιακά, Ταϊβάν)](../tw/README.md) | [Κροατικά](../hr/README.md) | [Τσέχικα](../cs/README.md) | [Δανικά](../da/README.md) | [Ολλανδικά](../nl/README.md) | [Εσθονικά](../et/README.md) | [Φινλανδικά](../fi/README.md) | [Γαλλικά](../fr/README.md) | [Γερμανικά](../de/README.md) | [Ελληνικά](./README.md) | [Εβραϊκά](../he/README.md) | [Χίντι](../hi/README.md) | [Ουγγρικά](../hu/README.md) | [Ινδονησιακά](../id/README.md) | [Ιταλικά](../it/README.md) | [Ιαπωνικά](../ja/README.md) | [Κανάντα](../kn/README.md) | [Κορεατικά](../ko/README.md) | [Λιθουανικά](../lt/README.md) | [Μαλαϊκά](../ms/README.md) | [Μαλαγιαλάμ](../ml/README.md) | [Μαράθι](../mr/README.md) | [Νεπάλ](../ne/README.md) | [Νιγηριανός Πίνγκιν](../pcm/README.md) | [Νορβηγικά](../no/README.md) | [Περσικά (Φαρσί)](../fa/README.md) | [Πολωνικά](../pl/README.md) | [Πορτογαλικά (Βραζιλίας)](../br/README.md) | [Πορτογαλικά (Πορτογαλίας)](../pt/README.md) | [Πουντζάμπι (Γκουρμούκι)](../pa/README.md) | [Ρουμανικά](../ro/README.md) | [Ρωσικά](../ru/README.md) | [Σερβικά (Κυριλλικά)](../sr/README.md) | [Σλοβακικά](../sk/README.md) | [Σλοβενικά](../sl/README.md) | [Ισπανικά](../es/README.md) | [Σουαχίλι](../sw/README.md) | [Σουηδικά](../sv/README.md) | [Ταγκαλόγκ (Φιλιππινέζικα)](../tl/README.md) | [Ταμίλ](../ta/README.md) | [Τελούγκου](../te/README.md) | [Ταϊλανδικά](../th/README.md) | [Τουρκικά](../tr/README.md) | [Ουκρανικά](../uk/README.md) | [Ουρντού](../ur/README.md) | [Βιετναμέζικα](../vi/README.md) +[Αραβικά](../ar/README.md) | [Μπενγκάλι](../bn/README.md) | [Βουλγαρικά](../bg/README.md) | [Βιρμανικά (Μυανμάρ)](../my/README.md) | [Κινεζικά (Απλοποιημένα)](../zh-CN/README.md) | [Κινεζικά (Παραδοσιακά, Χονγκ Κονγκ)](../zh-HK/README.md) | [Κινεζικά (Παραδοσιακά, Μακάο)](../zh-MO/README.md) | [Κινεζικά (Παραδοσιακά, Ταϊβάν)](../zh-TW/README.md) | [Κροατικά](../hr/README.md) | [Τσέχικα](../cs/README.md) | [Δανέζικα](../da/README.md) | [Ολλανδικά](../nl/README.md) | [Εσθονικά](../et/README.md) | [Φινλανδικά](../fi/README.md) | [Γαλλικά](../fr/README.md) | [Γερμανικά](../de/README.md) | [Ελληνικά](./README.md) | [Εβραϊκά](../he/README.md) | [Χίντι](../hi/README.md) | [Ουγγρικά](../hu/README.md) | [Ινδονησιακά](../id/README.md) | [Ιταλικά](../it/README.md) | [Ιαπωνικά](../ja/README.md) | [Kannada](../kn/README.md) | [Κορεατικά](../ko/README.md) | [Λιθουανικά](../lt/README.md) | [Μαλαιάλαμ](../ms/README.md) | [Μαλαγιάλαμ](../ml/README.md) | [Μαραθί](../mr/README.md) | [Νεπάλ](../ne/README.md) | [Νιγηριανό Πίτζιν](../pcm/README.md) | [Νορβηγικά](../no/README.md) | [Περσικά (Φαρσί)](../fa/README.md) | [Πολωνικά](../pl/README.md) | [Πορτογαλικά (Βραζιλία)](../pt-BR/README.md) | [Πορτογαλικά (Πορτογαλία)](../pt-PT/README.md) | [Πουντζάμπι (Gurmukhi)](../pa/README.md) | [Ρουμανικά](../ro/README.md) | [Ρωσικά](../ru/README.md) | [Σερβικά (Κυριλλικά)](../sr/README.md) | [Σλοβακικά](../sk/README.md) | [Σλοβενικά](../sl/README.md) | [Ισπανικά](../es/README.md) | [Σουαχίλι](../sw/README.md) | [Σουηδικά](../sv/README.md) | [Ταγκάλογκ (Φιλιππινέζικα)](../tl/README.md) | [Ταμίλ](../ta/README.md) | [Τελούγκου](../te/README.md) | [Ταϊλανδικά](../th/README.md) | [Τουρκικά](../tr/README.md) | [Ουκρανικά](../uk/README.md) | [Ουρντού](../ur/README.md) | [Βιετναμέζικα](../vi/README.md) -> **Προτιμάτε να Κλωνοποιήσετε τοπικά;** +> **Προτιμάτε να κάνετε τοπικό κλωνοποίηση;** -> Αυτό το αποθετήριο περιλαμβάνει πάνω από 50 μεταφράσεις σε γλώσσες, που αυξάνει σημαντικά το μέγεθος λήψης. Για να κλωνοποιήσετε χωρίς τις μεταφράσεις, χρησιμοποιήστε το sparse checkout: +> Αυτό το αποθετήριο περιλαμβάνει πάνω από 50 μεταφράσεις γλωσσών που αυξάνουν σημαντικά το μέγεθος λήψης. Για κλωνοποίηση χωρίς μεταφράσεις, χρησιμοποιήστε sparse checkout: > ```bash > git clone --filter=blob:none --sparse https://github.com/microsoft/Generative-AI-for-beginners-java.git > cd Generative-AI-for-beginners-java > git sparse-checkout set --no-cone '/*' '!translations' '!translated_images' > ``` -> Αυτό σας δίνει ό,τι χρειάζεστε για να ολοκληρώσετε το μάθημα με πολύ πιο γρήγορη λήψη. +> Αυτό σας δίνει ό,τι χρειάζεστε για να ολοκληρώσετε το μάθημα με πολύ ταχύτερη λήψη. -## Δομή Μαθήματος & Μονοπάτι Μάθησης +## Δομή Μαθήματος & Διαδρομή Μάθησης -### **Κεφάλαιο 1: Εισαγωγή στη Δημιουργική Τεχνητή Νοημοσύνη** -- **Βασικές Έννοιες**: Κατανόηση των Μεγάλων Γλωσσικών Μοντέλων, των tokens, embeddings, και των δυνατοτήτων της ΤΝ -- **Οικοσύστημα Java AI**: Επισκόπηση των Spring AI και OpenAI SDKs -- **Πρωτόκολλο Πλαισίου Μοντέλου**: Εισαγωγή στο MCP και ο ρόλος του στη επικοινωνία πράκτορα ΤΝ -- **Πρακτικές Εφαρμογές**: Ρεαλιστικά σενάρια όπως chatbots και δημιουργία περιεχομένου +### **Κεφάλαιο 1: Εισαγωγή στη Γεννητική ΤΝ** +- **Βασικές Έννοιες**: Κατανόηση Μεγάλων Γλωσσικών Μοντέλων, tokens, embeddings, και δυνατοτήτων ΤΝ +- **Οικοσύστημα ΤΝ για Java**: Επισκόπηση των Spring AI και OpenAI SDKs +- **Πρωτόκολλο Πλαισίου Μοντέλου**: Εισαγωγή στο MCP και ο ρόλος του στην επικοινωνία πρακτόρων ΤΝ +- **Πρακτικές Εφαρμογές**: Σενάρια πραγματικού κόσμου όπως chatbots και δημιουργία περιεχομένου - **[→ Ξεκινήστε το Κεφάλαιο 1](./01-IntroToGenAI/README.md)** ### **Κεφάλαιο 2: Ρύθμιση Περιβάλλοντος Ανάπτυξης** -- **Διαμόρφωση Πολλαπλών Πάροχων**: Ρύθμιση GitHub Models, Azure OpenAI και OpenAI Java SDK ενσωματώσεων -- **Spring Boot + Spring AI**: Καλές πρακτικές για ανάπτυξη εφαρμογών ΤΝ σε επιχειρήσεις -- **GitHub Models**: Δωρεάν πρόσβαση σε μοντέλα ΤΝ για πρωτότυπα και εκμάθηση (χωρίς πιστωτική κάρτα) -- **Εργαλεία Ανάπτυξης**: Ρυθμίσεις Docker containers, VS Code, και GitHub Codespaces +- **Διαμόρφωση Πολλών Παρόχων**: Ρύθμιση GitHub Models, Azure OpenAI, και OpenAI Java SDK ενσωματώσεων +- **Spring Boot + Spring AI**: Βέλτιστες πρακτικές για ανάπτυξη επιχειρηματικών εφαρμογών ΤΝ +- **GitHub Models**: Δωρεάν πρόσβαση σε μοντέλα ΤΝ για πρωτοτυποποίηση και εκμάθηση (χωρίς πιστωτική κάρτα) +- **Εργαλεία Ανάπτυξης**: Docker containers, VS Code, και ρυθμίσεις GitHub Codespaces - **[→ Ξεκινήστε το Κεφάλαιο 2](./02-SetupDevEnvironment/README.md)** -### **Κεφάλαιο 3: Βασικές Τεχνικές Δημιουργικής ΤΝ** -- **Μηχανική Εντολών (Prompt Engineering)**: Τεχνικές για βέλτιστες απαντήσεις από το μοντέλο ΤΝ -- **Embeddings & Λειτουργίες Διανυσμάτων**: Υλοποίηση σημασιολογικής αναζήτησης και αντιστοίχισης ομοιότητας -- **Ανάκτηση-Ενισχυμένη Δημιουργία (RAG)**: Συνδυασμός ΤΝ με δικές σας πηγές δεδομένων -- **Κλήση Λειτουργιών**: Επέκταση δυνατοτήτων ΤΝ με προσαρμοσμένα εργαλεία και plugins +### **Κεφάλαιο 3: Βασικές Τεχνικές Γεννητικής ΤΝ** +- **Prompt Engineering**: Τεχνικές για βέλτιστες απαντήσεις μοντέλων ΤΝ +- **Embeddings & Λειτουργίες Διανυσμάτων**: Υλοποίηση σημασιολογικής αναζήτησης και αντιστοίχισης ομοιότητας +- **Retrieval-Augmented Generation (RAG)**: Συνδυασμός ΤΝ με τις δικές σας πηγές δεδομένων +- **Function Calling**: Επέκταση δυνατοτήτων ΤΝ με προσαρμοσμένα εργαλεία και plugins - **[→ Ξεκινήστε το Κεφάλαιο 3](./03-CoreGenerativeAITechniques/README.md)** ### **Κεφάλαιο 4: Πρακτικές Εφαρμογές & Έργα** -- **Δημιουργός Ιστορίας Κατοικιδίων** (`petstory/`): Δημιουργική παραγωγή περιεχομένου με GitHub Models -- **Demο Foundry Local** (`foundrylocal/`): Τοπική ενσωμάτωση μοντέλου ΤΝ με OpenAI Java SDK -- **Υπηρεσία Υπολογιστή MCP** (`calculator/`): Βασική υλοποίηση Model Context Protocol με Spring AI +- **Pet Story Generator** (`petstory/`): Δημιουργική παραγωγή περιεχομένου με GitHub Models +- **Foundry Local Demo** (`foundrylocal/`): Τοπική ενσωμάτωση μοντέλου ΤΝ με OpenAI Java SDK +- **MCP Calculator Service** (`calculator/`): Βασική υλοποίηση Πρωτοκόλλου Πλαισίου Μοντέλου με Spring AI - **[→ Ξεκινήστε το Κεφάλαιο 4](./04-PracticalSamples/README.md)** ### **Κεφάλαιο 5: Υπεύθυνη Ανάπτυξη ΤΝ** -- **Ασφάλεια GitHub Models**: Δοκιμή ενσωματωμένου φιλτραρίσματος περιεχομένου και μηχανισμών ασφαλείας (ισχυροί αποκλεισμοί και μαλακές απορρίψεις) -- **Demo Υπεύθυνης ΤΝ**: Πραγματικό παράδειγμα που δείχνει πώς λειτουργούν τα σύγχρονα συστήματα ασφαλείας ΤΝ -- **Βέλτιστες Πρακτικές**: Βασικές οδηγίες για ηθική ανάπτυξη και εφαρμογή ΤΝ +- **Ασφάλεια GitHub Models**: Δοκιμή ενσωματωμένων φίλτρων περιεχομένου και μηχανισμών ασφάλειας (αυστηροί αποκλεισμοί και μαλακές απορρίψεις) +- **Υπεύθυνο Demo ΤΝ**: Παραδειγματική εφαρμογή που δείχνει πώς λειτουργούν τα σύγχρονα συστήματα ασφάλειας ΤΝ στην πράξη +- **Βέλτιστες Πρακτικές**: Οδηγίες για ηθική ανάπτυξη και ανάπτυξη ΤΝ - **[→ Ξεκινήστε το Κεφάλαιο 5](./05-ResponsibleGenAI/README.md)** -## Επιπλέον Πόροι +## Πρόσθετοι Πόροι -### LangChain -[![LangChain4j για Αρχάριους](https://img.shields.io/badge/LangChain4j%20for%20Beginners-22C55E?style=for-the-badge&&labelColor=E5E7EB&color=0553D6)](https://aka.ms/langchain4j-for-beginners) +### LangChain +[![LangChain4j για Αρχάριους](https://img.shields.io/badge/LangChain4j%20for%20Beginners-22C55E?style=for-the-badge&&labelColor=E5E7EB&color=0553D6)](https://aka.ms/langchain4j-for-beginners) [![LangChain.js για Αρχάριους](https://img.shields.io/badge/LangChain.js%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=0553D6)](https://aka.ms/langchainjs-for-beginners?WT.mc_id=m365-94501-dwahlin) --- -### Azure / Edge / MCP / Agents -[![AZD για Αρχάριους](https://img.shields.io/badge/AZD%20for%20Beginners-0078D4?style=for-the-badge&labelColor=E5E7EB&color=0078D4)](https://github.com/microsoft/AZD-for-beginners?WT.mc_id=academic-105485-koreyst) -[![Edge AI για Αρχάριους](https://img.shields.io/badge/Edge%20AI%20for%20Beginners-00B8E4?style=for-the-badge&labelColor=E5E7EB&color=00B8E4)](https://github.com/microsoft/edgeai-for-beginners?WT.mc_id=academic-105485-koreyst) -[![MCP για Αρχάριους](https://img.shields.io/badge/MCP%20for%20Beginners-009688?style=for-the-badge&labelColor=E5E7EB&color=009688)](https://github.com/microsoft/mcp-for-beginners?WT.mc_id=academic-105485-koreyst) -[![AI Agents για Αρχάριους](https://img.shields.io/badge/AI%20Agents%20for%20Beginners-00C49A?style=for-the-badge&labelColor=E5E7EB&color=00C49A)](https://github.com/microsoft/ai-agents-for-beginners?WT.mc_id=academic-105485-koreyst) +### Azure / Edge / MCP / Πράκτορες +[![AZD για Αρχάριους](https://img.shields.io/badge/AZD%20for%20Beginners-0078D4?style=for-the-badge&labelColor=E5E7EB&color=0078D4)](https://github.com/microsoft/AZD-for-beginners?WT.mc_id=academic-105485-koreyst) +[![Edge AI για Αρχάριους](https://img.shields.io/badge/Edge%20AI%20for%20Beginners-00B8E4?style=for-the-badge&labelColor=E5E7EB&color=00B8E4)](https://github.com/microsoft/edgeai-for-beginners?WT.mc_id=academic-105485-koreyst) +[![MCP για Αρχάριους](https://img.shields.io/badge/MCP%20for%20Beginners-009688?style=for-the-badge&labelColor=E5E7EB&color=009688)](https://github.com/microsoft/mcp-for-beginners?WT.mc_id=academic-105485-koreyst) +[![Πράκτορες ΤΝ για Αρχάριους](https://img.shields.io/badge/AI%20Agents%20for%20Beginners-00C49A?style=for-the-badge&labelColor=E5E7EB&color=00C49A)](https://github.com/microsoft/ai-agents-for-beginners?WT.mc_id=academic-105485-koreyst) --- -### Σειρά Δημιουργικής ΤΝ -[![Δημιουργική ΤΝ για Αρχάριους](https://img.shields.io/badge/Generative%20AI%20for%20Beginners-8B5CF6?style=for-the-badge&labelColor=E5E7EB&color=8B5CF6)](https://github.com/microsoft/generative-ai-for-beginners?WT.mc_id=academic-105485-koreyst) -[![Δημιουργική ΤΝ (.NET)](https://img.shields.io/badge/Generative%20AI%20(.NET)-9333EA?style=for-the-badge&labelColor=E5E7EB&color=9333EA)](https://github.com/microsoft/Generative-AI-for-beginners-dotnet?WT.mc_id=academic-105485-koreyst) -[![Δημιουργική ΤΝ (Java)](https://img.shields.io/badge/Generative%20AI%20(Java)-C084FC?style=for-the-badge&labelColor=E5E7EB&color=C084FC)](https://github.com/microsoft/generative-ai-for-beginners-java?WT.mc_id=academic-105485-koreyst) -[![Δημιουργική ΤΝ (JavaScript)](https://img.shields.io/badge/Generative%20AI%20(JavaScript)-E879F9?style=for-the-badge&labelColor=E5E7EB&color=E879F9)](https://github.com/microsoft/generative-ai-with-javascript?WT.mc_id=academic-105485-koreyst) +### Σειρά Γεννητικής ΤΝ +[![Γεννητική ΤΝ για Αρχάριους](https://img.shields.io/badge/Generative%20AI%20for%20Beginners-8B5CF6?style=for-the-badge&labelColor=E5E7EB&color=8B5CF6)](https://github.com/microsoft/generative-ai-for-beginners?WT.mc_id=academic-105485-koreyst) +[![Γεννητική ΤΝ (.NET)](https://img.shields.io/badge/Generative%20AI%20(.NET)-9333EA?style=for-the-badge&labelColor=E5E7EB&color=9333EA)](https://github.com/microsoft/Generative-AI-for-beginners-dotnet?WT.mc_id=academic-105485-koreyst) +[![Γεννητική ΤΝ (Java)](https://img.shields.io/badge/Generative%20AI%20(Java)-C084FC?style=for-the-badge&labelColor=E5E7EB&color=C084FC)](https://github.com/microsoft/generative-ai-for-beginners-java?WT.mc_id=academic-105485-koreyst) +[![Γεννητική ΤΝ (JavaScript)](https://img.shields.io/badge/Generative%20AI%20(JavaScript)-E879F9?style=for-the-badge&labelColor=E5E7EB&color=E879F9)](https://github.com/microsoft/generative-ai-with-javascript?WT.mc_id=academic-105485-koreyst) --- -### Βασική Μάθηση -[![Μηχανική Μάθηση για Αρχάριους](https://img.shields.io/badge/ML%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=22C55E)](https://aka.ms/ml-beginners?WT.mc_id=academic-105485-koreyst) -[![Επιστήμη Δεδομένων για Αρχάριους](https://img.shields.io/badge/Data%20Science%20for%20Beginners-84CC16?style=for-the-badge&labelColor=E5E7EB&color=84CC16)](https://aka.ms/datascience-beginners?WT.mc_id=academic-105485-koreyst) -[![Τεχνητή Νοημοσύνη για Αρχάριους](https://img.shields.io/badge/AI%20for%20Beginners-A3E635?style=for-the-badge&labelColor=E5E7EB&color=A3E635)](https://aka.ms/ai-beginners?WT.mc_id=academic-105485-koreyst) +### Βασική Μάθηση +[![Μηχανική Μάθηση για Αρχάριους](https://img.shields.io/badge/ML%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=22C55E)](https://aka.ms/ml-beginners?WT.mc_id=academic-105485-koreyst) +[![Επιστήμη Δεδομένων για Αρχάριους](https://img.shields.io/badge/Data%20Science%20for%20Beginners-84CC16?style=for-the-badge&labelColor=E5E7EB&color=84CC16)](https://aka.ms/datascience-beginners?WT.mc_id=academic-105485-koreyst) +[![ΤΝ για Αρχάριους](https://img.shields.io/badge/AI%20for%20Beginners-A3E635?style=for-the-badge&labelColor=E5E7EB&color=A3E635)](https://aka.ms/ai-beginners?WT.mc_id=academic-105485-koreyst) [![Κυβερνοασφάλεια για Αρχάριους](https://img.shields.io/badge/Cybersecurity%20for%20Beginners-F97316?style=for-the-badge&labelColor=E5E7EB&color=F97316)](https://github.com/microsoft/Security-101?WT.mc_id=academic-96948-sayoung) -[![Web Dev για Αρχάριους](https://img.shields.io/badge/Web%20Dev%20for%20Beginners-EC4899?style=for-the-badge&labelColor=E5E7EB&color=EC4899)](https://aka.ms/webdev-beginners?WT.mc_id=academic-105485-koreyst) -[![IoT για Αρχάριους](https://img.shields.io/badge/IoT%20for%20Beginners-14B8A6?style=for-the-badge&labelColor=E5E7EB&color=14B8A6)](https://aka.ms/iot-beginners?WT.mc_id=academic-105485-koreyst) -[![Ανάπτυξη XR για Αρχάριους](https://img.shields.io/badge/XR%20Development%20for%20Beginners-38BDF8?style=for-the-badge&labelColor=E5E7EB&color=38BDF8)](https://github.com/microsoft/xr-development-for-beginners?WT.mc_id=academic-105485-koreyst) +[![Web Dev for Beginners](https://img.shields.io/badge/Web%20Dev%20for%20Beginners-EC4899?style=for-the-badge&labelColor=E5E7EB&color=EC4899)](https://aka.ms/webdev-beginners?WT.mc_id=academic-105485-koreyst) +[![IoT for Beginners](https://img.shields.io/badge/IoT%20for%20Beginners-14B8A6?style=for-the-badge&labelColor=E5E7EB&color=14B8A6)](https://aka.ms/iot-beginners?WT.mc_id=academic-105485-koreyst) +[![XR Development for Beginners](https://img.shields.io/badge/XR%20Development%20for%20Beginners-38BDF8?style=for-the-badge&labelColor=E5E7EB&color=38BDF8)](https://github.com/microsoft/xr-development-for-beginners?WT.mc_id=academic-105485-koreyst) --- ### Σειρά Copilot -[![Copilot για AI Συνδυασμένο Προγραμματισμό](https://img.shields.io/badge/Copilot%20for%20AI%20Paired%20Programming-FACC15?style=for-the-badge&labelColor=E5E7EB&color=FACC15)](https://aka.ms/GitHubCopilotAI?WT.mc_id=academic-105485-koreyst) -[![Copilot για C#/.NET](https://img.shields.io/badge/Copilot%20for%20C%23/.NET-FBBF24?style=for-the-badge&labelColor=E5E7EB&color=FBBF24)](https://github.com/microsoft/mastering-github-copilot-for-dotnet-csharp-developers?WT.mc_id=academic-105485-koreyst) -[![Περιπέτεια Copilot](https://img.shields.io/badge/Copilot%20Adventure-FDE68A?style=for-the-badge&labelColor=E5E7EB&color=FDE68A)](https://github.com/microsoft/CopilotAdventures?WT.mc_id=academic-105485-koreyst) +[![Copilot for AI Paired Programming](https://img.shields.io/badge/Copilot%20for%20AI%20Paired%20Programming-FACC15?style=for-the-badge&labelColor=E5E7EB&color=FACC15)](https://aka.ms/GitHubCopilotAI?WT.mc_id=academic-105485-koreyst) +[![Copilot for C#/.NET](https://img.shields.io/badge/Copilot%20for%20C%23/.NET-FBBF24?style=for-the-badge&labelColor=E5E7EB&color=FBBF24)](https://github.com/microsoft/mastering-github-copilot-for-dotnet-csharp-developers?WT.mc_id=academic-105485-koreyst) +[![Copilot Adventure](https://img.shields.io/badge/Copilot%20Adventure-FDE68A?style=for-the-badge&labelColor=E5E7EB&color=FDE68A)](https://github.com/microsoft/CopilotAdventures?WT.mc_id=academic-105485-koreyst) ## Λήψη Βοήθειας -Αν κολλήσετε ή έχετε οποιεσδήποτε ερωτήσεις σχετικά με τη δημιουργία εφαρμογών AI. Ενώστε τους συναδέλφους μαθητές και έμπειρους προγραμματιστές σε συζητήσεις σχετικά με το MCP. Είναι μια υποστηρικτική κοινότητα όπου οι ερωτήσεις είναι ευπρόσδεκτες και η γνώση μοιράζεται ελεύθερα. +Αν κολλήσετε ή έχετε οποιεσδήποτε απορίες σχετικά με την κατασκευή εφαρμογών AI, συμμετάσχετε σε συζητήσεις με άλλους εκπαιδευόμενους και έμπειρους προγραμματιστές για το MCP. Είναι μια υποστηρικτική κοινότητα όπου οι ερωτήσεις είναι ευπρόσδεκτες και η γνώση μοιράζεται ελεύθερα. [![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) -Αν έχετε σχόλια για το προϊόν ή σφάλματα κατά την κατασκευή, επισκεφτείτε: +Αν έχετε σχόλια προϊόντος ή σφάλματα κατά την κατασκευή, επισκεφθείτε: [![Microsoft Foundry Developer Forum](https://img.shields.io/badge/GitHub-Microsoft_Foundry_Developer_Forum-blue?style=for-the-badge&logo=github&color=000000&logoColor=fff)](https://aka.ms/foundry/forum) @@ -143,5 +134,5 @@ CO_OP_TRANSLATOR_METADATA: **Αποποίηση ευθυνών**: -Το παρόν έγγραφο έχει μεταφραστεί χρησιμοποιώντας την υπηρεσία μετάφρασης με ΤΝ [Co-op Translator](https://github.com/Azure/co-op-translator). Παρόλο που επιδιώκουμε τη μέγιστη ακρίβεια, παρακαλούμε να λάβετε υπόψη ότι οι αυτόματες μεταφράσεις ενδέχεται να περιέχουν σφάλματα ή ανακρίβειες. Το πρωτότυπο έγγραφο στην αρχική του γλώσσα πρέπει να θεωρείται ως η αξιόπιστη πηγή. Για κρίσιμες πληροφορίες, συνιστάται επαγγελματική ανθρωπογενής μετάφραση. Δεν φέρουμε ευθύνη για τυχόν παρεξηγήσεις ή λανθασμένες ερμηνείες που προκύπτουν από τη χρήση αυτής της μετάφρασης. +Αυτό το έγγραφο έχει μεταφραστεί χρησιμοποιώντας την υπηρεσία αυτόματης μετάφρασης AI [Co-op Translator](https://github.com/Azure/co-op-translator). Παρά τις προσπάθειές μας για ακρίβεια, παρακαλούμε να λάβετε υπόψη ότι οι αυτοματοποιημένες μεταφράσεις ενδέχεται να περιέχουν λάθη ή ανακρίβειες. Το πρωτότυπο έγγραφο στη μητρική του γλώσσα πρέπει να θεωρείται η αυθεντική πηγή. Για κρίσιμες πληροφορίες συνιστάται η επαγγελματική ανθρώπινη μετάφραση. Δεν φέρουμε ευθύνη για τυχόν παρεξηγήσεις ή λανθασμένες ερμηνείες που προκύπτουν από τη χρήση αυτής της μετάφρασης. \ No newline at end of file diff --git a/translations/el/SECURITY.md b/translations/el/SECURITY.md index ad9d8fae..3b4b2a0a 100644 --- a/translations/el/SECURITY.md +++ b/translations/el/SECURITY.md @@ -1,12 +1,3 @@ - ## Ασφάλεια Η Microsoft αντιμετωπίζει με σοβαρότητα την ασφάλεια των προϊόντων και υπηρεσιών λογισμικού της, συμπεριλαμβανομένων όλων των αποθετηρίων πηγαίου κώδικα που διαχειρίζεται μέσω των οργανισμών της στο GitHub, όπως [Microsoft](https://github.com/Microsoft), [Azure](https://github.com/Azure), [DotNet](https://github.com/dotnet), [AspNet](https://github.com/aspnet) και [Xamarin](https://github.com/xamarin). diff --git a/translations/el/SUPPORT.md b/translations/el/SUPPORT.md index 0937a75c..b8e9db7e 100644 --- a/translations/el/SUPPORT.md +++ b/translations/el/SUPPORT.md @@ -1,12 +1,3 @@ - # Υποστήριξη ## Πώς να αναφέρετε προβλήματα και να λάβετε βοήθεια diff --git a/translations/en/.co-op-translator.json b/translations/en/.co-op-translator.json new file mode 100644 index 00000000..22ad2d3c --- /dev/null +++ b/translations/en/.co-op-translator.json @@ -0,0 +1,92 @@ +{ + "01-IntroToGenAI/README.md": { + "original_hash": "75bfb080ca725e8a9aa9c80cae25fba1", + "translation_date": "2025-07-29T07:53:45+00:00", + "source_file": "01-IntroToGenAI/README.md", + "language_code": "en" + }, + "02-SetupDevEnvironment/README.md": { + "original_hash": "96a30d42b9751a3d4e4b20e28d29d459", + "translation_date": "2026-01-28T04:33:38+00:00", + "source_file": "02-SetupDevEnvironment/README.md", + "language_code": "en" + }, + "02-SetupDevEnvironment/examples/basic-chat-azure/README.md": { + "original_hash": "efd82efe50711d7e257eb943151d682c", + "translation_date": "2025-07-27T13:32:16+00:00", + "source_file": "02-SetupDevEnvironment/examples/basic-chat-azure/README.md", + "language_code": "en" + }, + "02-SetupDevEnvironment/getting-started-azure-openai.md": { + "original_hash": "bfdb4b4eadbee3a59ef742439f58326a", + "translation_date": "2025-07-27T12:47:35+00:00", + "source_file": "02-SetupDevEnvironment/getting-started-azure-openai.md", + "language_code": "en" + }, + "03-CoreGenerativeAITechniques/README.md": { + "original_hash": "685f55cb07de19b52a30ce6e8b6d889e", + "translation_date": "2025-08-28T21:51:44+00:00", + "source_file": "03-CoreGenerativeAITechniques/README.md", + "language_code": "en" + }, + "04-PracticalSamples/README.md": { + "original_hash": "14c0a61ecc1cd2012a9c129236dfdf71", + "translation_date": "2025-07-29T07:53:33+00:00", + "source_file": "04-PracticalSamples/README.md", + "language_code": "en" + }, + "04-PracticalSamples/calculator/README.md": { + "original_hash": "b6c16b5514d524e415a94f6097ee7d4c", + "translation_date": "2025-09-18T15:21:53+00:00", + "source_file": "04-PracticalSamples/calculator/README.md", + "language_code": "en" + }, + "04-PracticalSamples/foundrylocal/README.md": { + "original_hash": "f787307400de59adc25a1404466a35f3", + "translation_date": "2025-11-04T07:11:01+00:00", + "source_file": "04-PracticalSamples/foundrylocal/README.md", + "language_code": "en" + }, + "04-PracticalSamples/petstory/README.md": { + "original_hash": "0cbf68d605615a1e602c832a24616859", + "translation_date": "2025-07-25T10:36:22+00:00", + "source_file": "04-PracticalSamples/petstory/README.md", + "language_code": "en" + }, + "05-ResponsibleGenAI/README.md": { + "original_hash": "301c05c2f57e60a6950b8c665b8bdbba", + "translation_date": "2025-07-29T15:39:12+00:00", + "source_file": "05-ResponsibleGenAI/README.md", + "language_code": "en" + }, + "AGENTS.md": { + "original_hash": "afc90918d008cf77fd1982691f681306", + "translation_date": "2025-10-03T08:24:12+00:00", + "source_file": "AGENTS.md", + "language_code": "en" + }, + "CODE_OF_CONDUCT.md": { + "original_hash": "442b123d034f92f7c384d2bbd28f99f1", + "translation_date": "2025-07-21T20:37:11+00:00", + "source_file": "CODE_OF_CONDUCT.md", + "language_code": "en" + }, + "README.md": { + "original_hash": "125a08948d881c95628094f4dd1fbd43", + "translation_date": "2026-01-29T15:13:29+00:00", + "source_file": "README.md", + "language_code": "en" + }, + "SECURITY.md": { + "original_hash": "57f14126c1c6add76b3aef3844dfe4e3", + "translation_date": "2025-07-21T20:34:36+00:00", + "source_file": "SECURITY.md", + "language_code": "en" + }, + "SUPPORT.md": { + "original_hash": "b8ef73cc49dec68e2c885ee9df545129", + "translation_date": "2025-07-21T20:38:27+00:00", + "source_file": "SUPPORT.md", + "language_code": "en" + } +} \ No newline at end of file diff --git a/translations/en/01-IntroToGenAI/README.md b/translations/en/01-IntroToGenAI/README.md index 511ede94..4dc23fe2 100644 --- a/translations/en/01-IntroToGenAI/README.md +++ b/translations/en/01-IntroToGenAI/README.md @@ -1,12 +1,3 @@ - # Introduction to Generative AI - Java Edition ## What You'll Learn diff --git a/translations/en/02-SetupDevEnvironment/README.md b/translations/en/02-SetupDevEnvironment/README.md index f15f1491..178c3ccd 100644 --- a/translations/en/02-SetupDevEnvironment/README.md +++ b/translations/en/02-SetupDevEnvironment/README.md @@ -1,13 +1,254 @@ - +# Setting Up the Development Environment for Generative AI for Java +> **Quick Start**: Code in the Cloud in 2 minutes - Jump to [GitHub Codespaces Setup](../../../02-SetupDevEnvironment) - no local installation required and uses github models! + +> **Interested in Azure OpenAI?**, see our [Azure OpenAI Setup Guide](getting-started-azure-openai.md) with steps to create a new Azure OpenAI resource. + +## What You'll Learn + +- Set up a Java development environment for AI applications +- Choose and configure your preferred development environment (cloud-first with Codespaces, local dev container, or full local setup) +- Test your setup by connecting to GitHub Models + +## Table of Contents + +- [What You'll Learn](../../../02-SetupDevEnvironment) +- [Introduction](../../../02-SetupDevEnvironment) +- [Step 1: Set Up Your Development Environment](../../../02-SetupDevEnvironment) + - [Option A: GitHub Codespaces (Recommended)](../../../02-SetupDevEnvironment) + - [Option B: Local Dev Container](../../../02-SetupDevEnvironment) + - [Option C: Use Your Existing Local Installation](../../../02-SetupDevEnvironment) +- [Step 2: Create GitHub Personal Access Token](../../../02-SetupDevEnvironment) +- [Step 3: Test Your Setup](../../../02-SetupDevEnvironment) +- [Troubleshooting](../../../02-SetupDevEnvironment) +- [Summary](../../../02-SetupDevEnvironment) +- [Next Steps](../../../02-SetupDevEnvironment) + +## Introduction + +This chapter will guide you through setting up a development environment. We'll use **GitHub Models** as our primary example because it's free, easy to set up with just a GitHub account, requires no credit card, and provides access to multiple models for experimentation. + +**No local setup required!** You can start coding immediately using GitHub Codespaces, which provides a full development environment in your browser. + +Screenshot: GitHub Models + +We recommend using [**GitHub Models**](https://github.com/marketplace?type=models) for this course because it's: +- **Free** to get started +- **Easy** to set up with just a GitHub account +- **No credit card** required +- **Multiple models** available for experimentation + +> **Note**: The GitHub Models used in this training have these free limits: +> - 15 requests per minute (150 per day) +> - ~8,000 words in, ~4,000 words out per request +> - 5 concurrent requests +> +> For production use, upgrade to Azure AI Foundry Models with your Azure account. Your code doesn't need to change. See the [Azure AI Foundry documentation](https://learn.microsoft.com/azure/ai-foundry/foundry-models/how-to/quickstart-github-models). + + +## Step 1: Set Up Your Development Environment + + + +We've created a preconfigured development container to minimize setup time and ensure you have all the necessary tools for this Generative AI for Java course. Choose your preferred development approach: + +### Environment Setup Options: + +#### Option A: GitHub Codespaces (Recommended) + +**Start coding in 2 minutes - no local setup required!** + +1. Fork this repository to your GitHub account + > **Note**: If you want to edit the basic config please have a look at the [Dev Container Configuration](../../../.devcontainer/devcontainer.json) +2. Click **Code** → **Codespaces** tab → **...** → **New with options...** +3. Use the defaults – this will select the **Dev container configuration**: **Generative AI Java Development Environment** custom devcontainer created for this course +4. Click **Create codespace** +5. Wait ~2 minutes for the environment to be ready +6. Proceed to [Step 2: Create GitHub Token](../../../02-SetupDevEnvironment) + +Screenshot: Codespaces submenu + +Screenshot: New with options + +Screenshot: Create codespace options + + +> **Benefits of Codespaces**: +> - No local installation required +> - Works on any device with a browser +> - Pre-configured with all tools and dependencies +> - Free 60 hours per month for personal accounts +> - Consistent environment for all learners + +#### Option B: Local Dev Container + +**For developers who prefer local development with Docker** + +1. Fork and clone this repository to your local machine + > **Note**: If you want to edit the basic config please have a look at the [Dev Container Configuration](../../../.devcontainer/devcontainer.json) +2. Install [Docker Desktop](https://www.docker.com/products/docker-desktop/) and [VS Code](https://code.visualstudio.com/) +3. Install the [Dev Containers extension](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers) in VS Code +4. Open the repository folder in VS Code +5. When prompted, click **Reopen in Container** (or use `Ctrl+Shift+P` → "Dev Containers: Reopen in Container") +6. Wait for the container to build and start +7. Proceed to [Step 2: Create GitHub Token](../../../02-SetupDevEnvironment) + +Screenshot: Dev container setup + +Screenshot: Dev container build complete + +#### Option C: Use Your Existing Local Installation + +**For developers with existing Java environments** + +Prerequisites: +- [Java 21+](https://www.oracle.com/java/technologies/javase/jdk21-archive-downloads.html) +- [Maven 3.9+](https://maven.apache.org/download.cgi) +- [VS Code](https://code.visualstudio.com) or your preferred IDE + +Steps: +1. Clone this repository to your local machine +2. Open the project in your IDE +3. Proceed to [Step 2: Create GitHub Token](../../../02-SetupDevEnvironment) + +> **Pro Tip**: If you have a low-spec machine but want VS Code locally, use GitHub Codespaces! You can connect your local VS Code to a cloud-hosted Codespace for the best of both worlds. + +Screenshot: created local devcontainer instance + + +## Step 2: Create a GitHub Personal Access Token + +1. Navigate to [GitHub Settings](https://github.com/settings/profile) and select **Settings** from your profile menu. +2. In the left sidebar, click **Developer settings** (usually at the bottom). +3. Under **Personal access tokens**, click **Fine-grained tokens** (or follow this direct [link](https://github.com/settings/personal-access-tokens)). +4. Click **Generate new token**. +5. Under "Token name", provide a descriptive name (e.g., `GenAI-Java-Course-Token`). +6. Set an expiration date (recommended: 7 days for security best practices). +7. Under "Resource owner", select your user account. +8. Under "Repository access", select the repositories you want to use with GitHub Models (or "All repositories" if needed). +9. Under "Account permissions", find **Models** and set it to **Read-only**. +10. Click **Generate token**. +11. **Copy and save your token now** – you won't see it again! + +> **Security Tip**: Use the minimum required scope and shortest practical expiration time for your access tokens. + +## Step 3: Test Your Setup with the GitHub Models Example + +Once your development environment is ready, let's test the GitHub Models integration with our example application in [`02-SetupDevEnvironment/examples/github-models`](../../../02-SetupDevEnvironment/examples/github-models). + +1. Open the terminal in your development environment. +2. Navigate to the GitHub Models example: + ```bash + cd 02-SetupDevEnvironment/examples/github-models + ``` +3. Set your GitHub token as an environment variable: + ```bash + # macOS/Linux + export GITHUB_TOKEN=your_token_here + + # Windows (Command Prompt) + set GITHUB_TOKEN=your_token_here + + # Windows (PowerShell) + $env:GITHUB_TOKEN="your_token_here" + ``` + +4. Run the application: + ```bash + mvn compile exec:java -Dexec.mainClass="com.example.githubmodels.App" + ``` + +You should see output similar to: +```text +Using model: gpt-4.1-nano +Sending request to GitHub Models... +Response: Hello World! +``` + +### Understanding the Example Code + +First, let's understand what we just ran. The example under `examples/github-models` uses the OpenAI Java SDK to connect to GitHub Models: + +**What this code does:** +- **Connects** to GitHub Models using your personal access token +- **Sends** a simple "Say Hello World!" message to the AI model +- **Receives** and displays the AI's response +- **Validates** your setup is working correctly + +**Key Dependency** (in `pom.xml`): +```xml + + com.openai + openai-java + 2.12.0 + +``` + +**Main Code** (`App.java`): +```java +// Connect to GitHub Models using OpenAI Java SDK +OpenAIClient client = OpenAIOkHttpClient.builder() + .apiKey(pat) + .baseUrl("https://models.inference.ai.azure.com") + .build(); + +// Create chat completion request +ChatCompletionCreateParams params = ChatCompletionCreateParams.builder() + .model(modelId) + .addSystemMessage("You are a concise assistant.") + .addUserMessage("Say Hello World!") + .build(); + +// Get AI response +ChatCompletion response = client.chat().completions().create(params); +System.out.println("Response: " + response.choices().get(0).message().content().orElse("No response content")); +``` + +## Summary + +Great! You now have everything set up: + +- Created a GitHub Personal Access Token with the right permissions for AI model access +- Got your Java development environment running (whether that's Codespaces, dev containers, or local) +- Connected to GitHub Models using the OpenAI Java SDK for free AI development +- Tested it all works with a simple example that talks to AI models + +## Next Steps + +[Chapter 3: Core Generative AI Techniques](../03-CoreGenerativeAITechniques/README.md) + +## Troubleshooting + +Having issues? Here are common problems and solutions: + +- **Token not working?** + - Ensure you copied the entire token without any extra spaces + - Verify the token is set correctly as an environment variable + - Check that your token has the correct permissions (Models: Read-only) + +- **Maven not found?** + - If using dev containers/Codespaces, Maven should be pre-installed + - For local setup, ensure Java 21+ and Maven 3.9+ are installed + - Try `mvn --version` to verify installation + +- **Connection issues?** + - Check your internet connection + - Verify GitHub is accessible from your network + - Ensure you're not behind a firewall blocking the GitHub Models endpoint + +- **Dev container not starting?** + - Ensure Docker Desktop is running (for local development) + - Try rebuilding the container: `Ctrl+Shift+P` → "Dev Containers: Rebuild Container" + +- **Application compilation errors?** + - Ensure you're in the correct directory: `02-SetupDevEnvironment/examples/github-models` + - Try cleaning and rebuilding: `mvn clean compile` + +> **Need help?**: Still having issues? Open an issue in the repository and we'll help you out. --- + +**Disclaimer**: +This document has been translated using the AI translation service [Co-op Translator](https://github.com/Azure/co-op-translator). While we strive for accuracy, please be aware that automated translations may contain errors or inaccuracies. The original document in its native language should be considered the authoritative source. For critical information, professional human translation is recommended. We are not liable for any misunderstandings or misinterpretations arising from the use of this translation. + \ No newline at end of file diff --git a/translations/en/02-SetupDevEnvironment/examples/basic-chat-azure/README.md b/translations/en/02-SetupDevEnvironment/examples/basic-chat-azure/README.md index 87442b5f..52ad5bac 100644 --- a/translations/en/02-SetupDevEnvironment/examples/basic-chat-azure/README.md +++ b/translations/en/02-SetupDevEnvironment/examples/basic-chat-azure/README.md @@ -1,12 +1,3 @@ - # Basic Chat with Azure OpenAI - End-to-End Example This example demonstrates how to create a simple Spring Boot application that connects to Azure OpenAI and tests your setup. diff --git a/translations/en/02-SetupDevEnvironment/getting-started-azure-openai.md b/translations/en/02-SetupDevEnvironment/getting-started-azure-openai.md index 556bacc6..9ba49050 100644 --- a/translations/en/02-SetupDevEnvironment/getting-started-azure-openai.md +++ b/translations/en/02-SetupDevEnvironment/getting-started-azure-openai.md @@ -1,12 +1,3 @@ - # Setting Up the Development Environment for Azure OpenAI > **Quick Start**: This guide is for Azure OpenAI setup. For an immediate start with free models, use [GitHub Models with Codespaces](./README.md#quick-start-cloud). diff --git a/translations/en/03-CoreGenerativeAITechniques/README.md b/translations/en/03-CoreGenerativeAITechniques/README.md index 3661cbb4..d755c9aa 100644 --- a/translations/en/03-CoreGenerativeAITechniques/README.md +++ b/translations/en/03-CoreGenerativeAITechniques/README.md @@ -1,12 +1,3 @@ - # Core Generative AI Techniques Tutorial ## Table of Contents diff --git a/translations/en/04-PracticalSamples/README.md b/translations/en/04-PracticalSamples/README.md index 722fed8f..fac24ec4 100644 --- a/translations/en/04-PracticalSamples/README.md +++ b/translations/en/04-PracticalSamples/README.md @@ -1,12 +1,3 @@ - # Practical Applications & Projects ## What You'll Learn diff --git a/translations/en/04-PracticalSamples/calculator/README.md b/translations/en/04-PracticalSamples/calculator/README.md index e54eddaf..652e60e9 100644 --- a/translations/en/04-PracticalSamples/calculator/README.md +++ b/translations/en/04-PracticalSamples/calculator/README.md @@ -1,12 +1,3 @@ - # MCP Calculator Tutorial for Beginners ## Table of Contents diff --git a/translations/en/04-PracticalSamples/foundrylocal/README.md b/translations/en/04-PracticalSamples/foundrylocal/README.md index 7a19b318..080250ce 100644 --- a/translations/en/04-PracticalSamples/foundrylocal/README.md +++ b/translations/en/04-PracticalSamples/foundrylocal/README.md @@ -1,12 +1,3 @@ - # Foundry Local Spring Boot Tutorial ## Table of Contents diff --git a/translations/en/04-PracticalSamples/petstory/README.md b/translations/en/04-PracticalSamples/petstory/README.md index fe47e22f..f9d920ca 100644 --- a/translations/en/04-PracticalSamples/petstory/README.md +++ b/translations/en/04-PracticalSamples/petstory/README.md @@ -1,12 +1,3 @@ - # Pet Story Generator Tutorial for Beginners ## Table of Contents diff --git a/translations/en/05-ResponsibleGenAI/README.md b/translations/en/05-ResponsibleGenAI/README.md index 97bfe6ef..5c98d0a1 100644 --- a/translations/en/05-ResponsibleGenAI/README.md +++ b/translations/en/05-ResponsibleGenAI/README.md @@ -1,12 +1,3 @@ - # Responsible Generative AI ## What You'll Learn diff --git a/translations/en/AGENTS.md b/translations/en/AGENTS.md index 662d8419..9151fe91 100644 --- a/translations/en/AGENTS.md +++ b/translations/en/AGENTS.md @@ -1,12 +1,3 @@ - # AGENTS.md ## Project Overview diff --git a/translations/en/CODE_OF_CONDUCT.md b/translations/en/CODE_OF_CONDUCT.md index b698514e..f033a580 100644 --- a/translations/en/CODE_OF_CONDUCT.md +++ b/translations/en/CODE_OF_CONDUCT.md @@ -1,12 +1,3 @@ - # Microsoft Open Source Code of Conduct This project follows the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/). diff --git a/translations/en/README.md b/translations/en/README.md index 51eec975..a3b5e439 100644 --- a/translations/en/README.md +++ b/translations/en/README.md @@ -1,12 +1,3 @@ - # Generative AI for Beginners - Java Edition [![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) @@ -39,7 +30,7 @@ CO_OP_TRANSLATOR_METADATA: ### Supported via GitHub Action (Automated & Always Up-to-Date) -[Arabic](../ar/README.md) | [Bengali](../bn/README.md) | [Bulgarian](../bg/README.md) | [Burmese (Myanmar)](../my/README.md) | [Chinese (Simplified)](../zh/README.md) | [Chinese (Traditional, Hong Kong)](../hk/README.md) | [Chinese (Traditional, Macau)](../mo/README.md) | [Chinese (Traditional, Taiwan)](../tw/README.md) | [Croatian](../hr/README.md) | [Czech](../cs/README.md) | [Danish](../da/README.md) | [Dutch](../nl/README.md) | [Estonian](../et/README.md) | [Finnish](../fi/README.md) | [French](../fr/README.md) | [German](../de/README.md) | [Greek](../el/README.md) | [Hebrew](../he/README.md) | [Hindi](../hi/README.md) | [Hungarian](../hu/README.md) | [Indonesian](../id/README.md) | [Italian](../it/README.md) | [Japanese](../ja/README.md) | [Kannada](../kn/README.md) | [Korean](../ko/README.md) | [Lithuanian](../lt/README.md) | [Malay](../ms/README.md) | [Malayalam](../ml/README.md) | [Marathi](../mr/README.md) | [Nepali](../ne/README.md) | [Nigerian Pidgin](../pcm/README.md) | [Norwegian](../no/README.md) | [Persian (Farsi)](../fa/README.md) | [Polish](../pl/README.md) | [Portuguese (Brazil)](../br/README.md) | [Portuguese (Portugal)](../pt/README.md) | [Punjabi (Gurmukhi)](../pa/README.md) | [Romanian](../ro/README.md) | [Russian](../ru/README.md) | [Serbian (Cyrillic)](../sr/README.md) | [Slovak](../sk/README.md) | [Slovenian](../sl/README.md) | [Spanish](../es/README.md) | [Swahili](../sw/README.md) | [Swedish](../sv/README.md) | [Tagalog (Filipino)](../tl/README.md) | [Tamil](../ta/README.md) | [Telugu](../te/README.md) | [Thai](../th/README.md) | [Turkish](../tr/README.md) | [Ukrainian](../uk/README.md) | [Urdu](../ur/README.md) | [Vietnamese](../vi/README.md) +[Arabic](../ar/README.md) | [Bengali](../bn/README.md) | [Bulgarian](../bg/README.md) | [Burmese (Myanmar)](../my/README.md) | [Chinese (Simplified)](../zh-CN/README.md) | [Chinese (Traditional, Hong Kong)](../zh-HK/README.md) | [Chinese (Traditional, Macau)](../zh-MO/README.md) | [Chinese (Traditional, Taiwan)](../zh-TW/README.md) | [Croatian](../hr/README.md) | [Czech](../cs/README.md) | [Danish](../da/README.md) | [Dutch](../nl/README.md) | [Estonian](../et/README.md) | [Finnish](../fi/README.md) | [French](../fr/README.md) | [German](../de/README.md) | [Greek](../el/README.md) | [Hebrew](../he/README.md) | [Hindi](../hi/README.md) | [Hungarian](../hu/README.md) | [Indonesian](../id/README.md) | [Italian](../it/README.md) | [Japanese](../ja/README.md) | [Kannada](../kn/README.md) | [Korean](../ko/README.md) | [Lithuanian](../lt/README.md) | [Malay](../ms/README.md) | [Malayalam](../ml/README.md) | [Marathi](../mr/README.md) | [Nepali](../ne/README.md) | [Nigerian Pidgin](../pcm/README.md) | [Norwegian](../no/README.md) | [Persian (Farsi)](../fa/README.md) | [Polish](../pl/README.md) | [Portuguese (Brazil)](../pt-BR/README.md) | [Portuguese (Portugal)](../pt-PT/README.md) | [Punjabi (Gurmukhi)](../pa/README.md) | [Romanian](../ro/README.md) | [Russian](../ru/README.md) | [Serbian (Cyrillic)](../sr/README.md) | [Slovak](../sk/README.md) | [Slovenian](../sl/README.md) | [Spanish](../es/README.md) | [Swahili](../sw/README.md) | [Swedish](../sv/README.md) | [Tagalog (Filipino)](../tl/README.md) | [Tamil](../ta/README.md) | [Telugu](../te/README.md) | [Thai](../th/README.md) | [Turkish](../tr/README.md) | [Ukrainian](../uk/README.md) | [Urdu](../ur/README.md) | [Vietnamese](../vi/README.md) > **Prefer to Clone Locally?** @@ -117,6 +108,7 @@ CO_OP_TRANSLATOR_METADATA: [![Data Science for Beginners](https://img.shields.io/badge/Data%20Science%20for%20Beginners-84CC16?style=for-the-badge&labelColor=E5E7EB&color=84CC16)](https://aka.ms/datascience-beginners?WT.mc_id=academic-105485-koreyst) [![AI for Beginners](https://img.shields.io/badge/AI%20for%20Beginners-A3E635?style=for-the-badge&labelColor=E5E7EB&color=A3E635)](https://aka.ms/ai-beginners?WT.mc_id=academic-105485-koreyst) [![Cybersecurity for Beginners](https://img.shields.io/badge/Cybersecurity%20for%20Beginners-F97316?style=for-the-badge&labelColor=E5E7EB&color=F97316)](https://github.com/microsoft/Security-101?WT.mc_id=academic-96948-sayoung) + [![Web Dev for Beginners](https://img.shields.io/badge/Web%20Dev%20for%20Beginners-EC4899?style=for-the-badge&labelColor=E5E7EB&color=EC4899)](https://aka.ms/webdev-beginners?WT.mc_id=academic-105485-koreyst) [![IoT for Beginners](https://img.shields.io/badge/IoT%20for%20Beginners-14B8A6?style=for-the-badge&labelColor=E5E7EB&color=14B8A6)](https://aka.ms/iot-beginners?WT.mc_id=academic-105485-koreyst) [![XR Development for Beginners](https://img.shields.io/badge/XR%20Development%20for%20Beginners-38BDF8?style=for-the-badge&labelColor=E5E7EB&color=38BDF8)](https://github.com/microsoft/xr-development-for-beginners?WT.mc_id=academic-105485-koreyst) @@ -131,11 +123,11 @@ CO_OP_TRANSLATOR_METADATA: ## Getting Help -If you get stuck or have any questions about building AI apps. Join fellow learners and experienced developers in discussions about MCP. It's a supportive community where questions are welcome and knowledge is shared freely. +If you get stuck or have any questions about building AI apps, join fellow learners and experienced developers in discussions about MCP. It's a supportive community where questions are welcome and knowledge is shared freely. [![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) -If you have product feedback or errors while building visit: +If you have product feedback or encounter errors while building, visit: [![Microsoft Foundry Developer Forum](https://img.shields.io/badge/GitHub-Microsoft_Foundry_Developer_Forum-blue?style=for-the-badge&logo=github&color=000000&logoColor=fff)](https://aka.ms/foundry/forum) @@ -143,5 +135,5 @@ If you have product feedback or errors while building visit: **Disclaimer**: -This document has been translated using the AI translation service [Co-op Translator](https://github.com/Azure/co-op-translator). While we strive for accuracy, please be aware that automated translations may contain errors or inaccuracies. The original document in its native language should be considered the authoritative source. For critical information, professional human translation is recommended. We are not liable for any misunderstandings or misinterpretations arising from the use of this translation. +This document has been translated using the AI translation service [Co-op Translator](https://github.com/Azure/co-op-translator). While we strive for accuracy, please note that automated translations may contain errors or inaccuracies. The original document in its native language should be considered the authoritative source. For critical information, professional human translation is recommended. We are not liable for any misunderstandings or misinterpretations resulting from the use of this translation. \ No newline at end of file diff --git a/translations/en/SECURITY.md b/translations/en/SECURITY.md index 73de3bb8..6b5b46b3 100644 --- a/translations/en/SECURITY.md +++ b/translations/en/SECURITY.md @@ -1,12 +1,3 @@ - ## Security Microsoft prioritizes the security of its software products and services, including all source code repositories managed through our GitHub organizations, such as [Microsoft](https://github.com/Microsoft), [Azure](https://github.com/Azure), [DotNet](https://github.com/dotnet), [AspNet](https://github.com/aspnet), and [Xamarin](https://github.com/xamarin). diff --git a/translations/en/SUPPORT.md b/translations/en/SUPPORT.md index d9e8fcff..426a6c1c 100644 --- a/translations/en/SUPPORT.md +++ b/translations/en/SUPPORT.md @@ -1,12 +1,3 @@ - # Support ## How to file issues and get help diff --git a/translations/es/.co-op-translator.json b/translations/es/.co-op-translator.json new file mode 100644 index 00000000..747931bb --- /dev/null +++ b/translations/es/.co-op-translator.json @@ -0,0 +1,92 @@ +{ + "01-IntroToGenAI/README.md": { + "original_hash": "75bfb080ca725e8a9aa9c80cae25fba1", + "translation_date": "2025-07-29T07:59:30+00:00", + "source_file": "01-IntroToGenAI/README.md", + "language_code": "es" + }, + "02-SetupDevEnvironment/README.md": { + "original_hash": "96a30d42b9751a3d4e4b20e28d29d459", + "translation_date": "2026-01-28T04:36:22+00:00", + "source_file": "02-SetupDevEnvironment/README.md", + "language_code": "es" + }, + "02-SetupDevEnvironment/examples/basic-chat-azure/README.md": { + "original_hash": "efd82efe50711d7e257eb943151d682c", + "translation_date": "2025-07-27T13:32:56+00:00", + "source_file": "02-SetupDevEnvironment/examples/basic-chat-azure/README.md", + "language_code": "es" + }, + "02-SetupDevEnvironment/getting-started-azure-openai.md": { + "original_hash": "bfdb4b4eadbee3a59ef742439f58326a", + "translation_date": "2025-07-27T12:49:10+00:00", + "source_file": "02-SetupDevEnvironment/getting-started-azure-openai.md", + "language_code": "es" + }, + "03-CoreGenerativeAITechniques/README.md": { + "original_hash": "685f55cb07de19b52a30ce6e8b6d889e", + "translation_date": "2025-08-28T21:52:36+00:00", + "source_file": "03-CoreGenerativeAITechniques/README.md", + "language_code": "es" + }, + "04-PracticalSamples/README.md": { + "original_hash": "14c0a61ecc1cd2012a9c129236dfdf71", + "translation_date": "2025-07-29T07:59:17+00:00", + "source_file": "04-PracticalSamples/README.md", + "language_code": "es" + }, + "04-PracticalSamples/calculator/README.md": { + "original_hash": "b6c16b5514d524e415a94f6097ee7d4c", + "translation_date": "2025-09-18T15:22:46+00:00", + "source_file": "04-PracticalSamples/calculator/README.md", + "language_code": "es" + }, + "04-PracticalSamples/foundrylocal/README.md": { + "original_hash": "f787307400de59adc25a1404466a35f3", + "translation_date": "2025-11-04T07:12:08+00:00", + "source_file": "04-PracticalSamples/foundrylocal/README.md", + "language_code": "es" + }, + "04-PracticalSamples/petstory/README.md": { + "original_hash": "0cbf68d605615a1e602c832a24616859", + "translation_date": "2025-07-25T10:40:07+00:00", + "source_file": "04-PracticalSamples/petstory/README.md", + "language_code": "es" + }, + "05-ResponsibleGenAI/README.md": { + "original_hash": "301c05c2f57e60a6950b8c665b8bdbba", + "translation_date": "2025-07-29T15:40:02+00:00", + "source_file": "05-ResponsibleGenAI/README.md", + "language_code": "es" + }, + "AGENTS.md": { + "original_hash": "afc90918d008cf77fd1982691f681306", + "translation_date": "2025-10-03T08:24:52+00:00", + "source_file": "AGENTS.md", + "language_code": "es" + }, + "CODE_OF_CONDUCT.md": { + "original_hash": "442b123d034f92f7c384d2bbd28f99f1", + "translation_date": "2025-07-21T15:58:58+00:00", + "source_file": "CODE_OF_CONDUCT.md", + "language_code": "es" + }, + "README.md": { + "original_hash": "125a08948d881c95628094f4dd1fbd43", + "translation_date": "2026-01-29T15:15:21+00:00", + "source_file": "README.md", + "language_code": "es" + }, + "SECURITY.md": { + "original_hash": "57f14126c1c6add76b3aef3844dfe4e3", + "translation_date": "2025-07-21T15:57:12+00:00", + "source_file": "SECURITY.md", + "language_code": "es" + }, + "SUPPORT.md": { + "original_hash": "b8ef73cc49dec68e2c885ee9df545129", + "translation_date": "2025-07-21T16:00:02+00:00", + "source_file": "SUPPORT.md", + "language_code": "es" + } +} \ No newline at end of file diff --git a/translations/es/01-IntroToGenAI/README.md b/translations/es/01-IntroToGenAI/README.md index 5bba5147..c1e6b4c9 100644 --- a/translations/es/01-IntroToGenAI/README.md +++ b/translations/es/01-IntroToGenAI/README.md @@ -1,12 +1,3 @@ - # Introducción a la IA Generativa - Edición Java ## Lo que aprenderás diff --git a/translations/es/02-SetupDevEnvironment/README.md b/translations/es/02-SetupDevEnvironment/README.md index 29d5dec9..24eb6365 100644 --- a/translations/es/02-SetupDevEnvironment/README.md +++ b/translations/es/02-SetupDevEnvironment/README.md @@ -1,13 +1,254 @@ - +# Configuración del Entorno de Desarrollo para Generative AI para Java +> **Inicio rápido**: Programa en la nube en 2 minutos - Salta a [Configuración de GitHub Codespaces](../../../02-SetupDevEnvironment) - ¡no se requiere instalación local y usa modelos de GitHub! + +> **¿Interesado en Azure OpenAI?**, consulta nuestra [Guía de configuración de Azure OpenAI](getting-started-azure-openai.md) con pasos para crear un nuevo recurso de Azure OpenAI. + +## Lo que aprenderás + +- Configurar un entorno de desarrollo Java para aplicaciones de IA +- Elegir y configurar tu entorno de desarrollo preferido (priorizando la nube con Codespaces, contenedor de desarrollo local o configuración local completa) +- Probar tu configuración conectándote a los modelos de GitHub + +## Tabla de Contenidos + +- [Lo que aprenderás](../../../02-SetupDevEnvironment) +- [Introducción](../../../02-SetupDevEnvironment) +- [Paso 1: Configura tu entorno de desarrollo](../../../02-SetupDevEnvironment) + - [Opción A: GitHub Codespaces (Recomendado)](../../../02-SetupDevEnvironment) + - [Opción B: Contenedor de desarrollo local](../../../02-SetupDevEnvironment) + - [Opción C: Usa tu instalación local existente](../../../02-SetupDevEnvironment) +- [Paso 2: Crea un token de acceso personal de GitHub](../../../02-SetupDevEnvironment) +- [Paso 3: Prueba tu configuración](../../../02-SetupDevEnvironment) +- [Solución de problemas](../../../02-SetupDevEnvironment) +- [Resumen](../../../02-SetupDevEnvironment) +- [Próximos pasos](../../../02-SetupDevEnvironment) + +## Introducción + +Este capítulo te guiará en la configuración de un entorno de desarrollo. Usaremos **GitHub Models** como nuestro ejemplo principal porque es gratuito, fácil de configurar solo con una cuenta de GitHub, no requiere tarjeta de crédito y ofrece acceso a múltiples modelos para experimentar. + +**¡No se requiere configuración local!** Puedes empezar a programar inmediatamente usando GitHub Codespaces, que proporciona un entorno de desarrollo completo en tu navegador. + +Captura de pantalla: GitHub Models + +Recomendamos usar [**GitHub Models**](https://github.com/marketplace?type=models) para este curso porque es: +- **Gratis** para comenzar +- **Fácil** de configurar solo con una cuenta de GitHub +- **No requiere tarjeta de crédito** +- **Múltiples modelos** disponibles para experimentar + +> **Nota**: Los modelos de GitHub usados en esta capacitación tienen estos límites gratuitos: +> - 15 solicitudes por minuto (150 por día) +> - ~8,000 palabras de entrada, ~4,000 palabras de salida por solicitud +> - 5 solicitudes concurrentes +> +> Para uso en producción, actualiza a Azure AI Foundry Models con tu cuenta de Azure. No necesitas cambiar tu código. Consulta la [documentación de Azure AI Foundry](https://learn.microsoft.com/azure/ai-foundry/foundry-models/how-to/quickstart-github-models). + + +## Paso 1: Configura tu entorno de desarrollo + + + +Hemos creado un contenedor de desarrollo preconfigurado para minimizar el tiempo de configuración y asegurarnos de que tengas todas las herramientas necesarias para este curso de Generative AI para Java. Elige tu enfoque preferido de desarrollo: + +### Opciones de configuración del entorno: + +#### Opción A: GitHub Codespaces (Recomendado) + +**¡Comienza a programar en 2 minutos - no se requiere configuración local!** + +1. Haz fork de este repositorio en tu cuenta de GitHub + > **Nota**: Si quieres editar la configuración básica, consulta [Configuración del contenedor de desarrollo](../../../.devcontainer/devcontainer.json) +2. Haz clic en **Code** → pestaña **Codespaces** → **...** → **Nuevo con opciones...** +3. Usa los valores predeterminados – esto seleccionará la **Configuración del contenedor de desarrollo**: **Generative AI Java Development Environment**, un devcontainer personalizado creado para este curso +4. Haz clic en **Crear codespace** +5. Espera ~2 minutos a que el entorno esté listo +6. Continúa con [Paso 2: Crea token de GitHub](../../../02-SetupDevEnvironment) + +Captura de pantalla: submenú Codespaces + +Captura de pantalla: Nuevo con opciones + +Captura de pantalla: opciones para crear codespace + + +> **Beneficios de Codespaces**: +> - No requiere instalación local +> - Funciona en cualquier dispositivo con navegador +> - Preconfigurado con todas las herramientas y dependencias +> - 60 horas gratis al mes para cuentas personales +> - Entorno consistente para todos los estudiantes + +#### Opción B: Contenedor de desarrollo local + +**Para desarrolladores que prefieren desarrollo local con Docker** + +1. Haz fork y clona este repositorio en tu máquina local + > **Nota**: Si quieres editar la configuración básica, consulta [Configuración del contenedor de desarrollo](../../../.devcontainer/devcontainer.json) +2. Instala [Docker Desktop](https://www.docker.com/products/docker-desktop/) y [VS Code](https://code.visualstudio.com/) +3. Instala la [extensión Dev Containers](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers) en VS Code +4. Abre la carpeta del repositorio en VS Code +5. Cuando se te pida, haz clic en **Reabrir en contenedor** (o usa `Ctrl+Shift+P` → "Dev Containers: Reopen in Container") +6. Espera a que el contenedor se construya y arranque +7. Continúa con [Paso 2: Crea token de GitHub](../../../02-SetupDevEnvironment) + +Captura de pantalla: configuración del contenedor de desarrollo + +Captura de pantalla: compilación del contenedor completada + +#### Opción C: Usa tu instalación local existente + +**Para desarrolladores con entornos Java ya existentes** + +Requisitos previos: +- [Java 21+](https://www.oracle.com/java/technologies/javase/jdk21-archive-downloads.html) +- [Maven 3.9+](https://maven.apache.org/download.cgi) +- [VS Code](https://code.visualstudio.com) o tu IDE preferido + +Pasos: +1. Clona este repositorio en tu máquina local +2. Abre el proyecto en tu IDE +3. Continúa con [Paso 2: Crea token de GitHub](../../../02-SetupDevEnvironment) + +> **Consejo profesional**: Si tienes un equipo con pocas especificaciones pero quieres VS Code local, ¡usa GitHub Codespaces! Puedes conectar tu VS Code local a un Codespace alojado en la nube para lo mejor de ambos mundos. + +Captura de pantalla: instancia local creada de devcontainer + + +## Paso 2: Crea un token de acceso personal de GitHub + +1. Navega a [Configuraciones de GitHub](https://github.com/settings/profile) y selecciona **Settings** en el menú de tu perfil. +2. En la barra lateral izquierda, haz clic en **Developer settings** (generalmente al final). +3. Bajo **Personal access tokens**, haz clic en **Fine-grained tokens** (o sigue este enlace directo [link](https://github.com/settings/personal-access-tokens)). +4. Haz clic en **Generate new token**. +5. En "Token name", proporciona un nombre descriptivo (por ejemplo, `GenAI-Java-Course-Token`). +6. Establece una fecha de expiración (recomendado: 7 días por buenas prácticas de seguridad). +7. En "Resource owner", selecciona tu cuenta de usuario. +8. En "Repository access", selecciona los repositorios que quieras usar con GitHub Models (o "All repositories" si es necesario). +9. En "Account permissions", encuentra **Models** y configúralo como **Read-only**. +10. Haz clic en **Generate token**. +11. **Copia y guarda tu token ahora** – ¡no lo verás de nuevo! + +> **Consejo de seguridad**: Usa el alcance mínimo requerido y el tiempo de expiración más corto que sea práctico para tus tokens de acceso. + +## Paso 3: Prueba tu configuración con el ejemplo de GitHub Models + +Una vez que tu entorno de desarrollo esté listo, vamos a probar la integración con GitHub Models usando nuestra aplicación ejemplo en [`02-SetupDevEnvironment/examples/github-models`](../../../02-SetupDevEnvironment/examples/github-models). + +1. Abre la terminal en tu entorno de desarrollo. +2. Navega al ejemplo de GitHub Models: + ```bash + cd 02-SetupDevEnvironment/examples/github-models + ``` +3. Establece tu token de GitHub como una variable de entorno: + ```bash + # macOS/Linux + export GITHUB_TOKEN=your_token_here + + # Windows (Símbolo del sistema) + set GITHUB_TOKEN=your_token_here + + # Windows (PowerShell) + $env:GITHUB_TOKEN="your_token_here" + ``` + +4. Ejecuta la aplicación: + ```bash + mvn compile exec:java -Dexec.mainClass="com.example.githubmodels.App" + ``` + +Verás una salida similar a: +```text +Using model: gpt-4.1-nano +Sending request to GitHub Models... +Response: Hello World! +``` + +### Entendiendo el código del ejemplo + +Primero, entendamos qué acabamos de ejecutar. El ejemplo en `examples/github-models` usa el SDK Java de OpenAI para conectarse a GitHub Models: + +**Lo que hace este código:** +- **Se conecta** a GitHub Models usando tu token de acceso personal +- **Envía** un simple mensaje "Say Hello World!" al modelo de IA +- **Recibe** y muestra la respuesta de la IA +- **Valida** que tu configuración está funcionando correctamente + +**Dependencia clave** (en `pom.xml`): +```xml + + com.openai + openai-java + 2.12.0 + +``` + +**Código principal** (`App.java`): +```java +// Conéctese a los modelos de GitHub usando el SDK de OpenAI para Java +OpenAIClient client = OpenAIOkHttpClient.builder() + .apiKey(pat) + .baseUrl("https://models.inference.ai.azure.com") + .build(); + +// Crear solicitud de finalización de chat +ChatCompletionCreateParams params = ChatCompletionCreateParams.builder() + .model(modelId) + .addSystemMessage("You are a concise assistant.") + .addUserMessage("Say Hello World!") + .build(); + +// Obtener respuesta de IA +ChatCompletion response = client.chat().completions().create(params); +System.out.println("Response: " + response.choices().get(0).message().content().orElse("No response content")); +``` + +## Resumen + +¡Genial! Ahora tienes todo configurado: + +- Creaste un token de acceso personal de GitHub con los permisos correctos para acceder a los modelos de IA +- Tu entorno de desarrollo Java está funcionando (ya sea Codespaces, contenedores o local) +- Te conectaste a GitHub Models usando el SDK Java de OpenAI para desarrollo de IA gratis +- Probaste que todo funciona con un ejemplo simple que interactúa con modelos de IA + +## Próximos pasos + +[Capítulo 3: Técnicas principales de Generative AI](../03-CoreGenerativeAITechniques/README.md) + +## Solución de problemas + +¿Tienes problemas? Aquí están los problemas comunes y soluciones: + +- **¿El token no funciona?** + - Asegúrate de haber copiado el token completo sin espacios adicionales + - Verifica que el token esté correctamente configurado como variable de entorno + - Confirma que tu token tiene los permisos correctos (Models: Sólo lectura) + +- **¿Maven no se encuentra?** + - Si usas contenedores dev/Codespaces, Maven debe estar preinstalado + - Para configuración local, asegúrate de tener Java 21+ y Maven 3.9+ instalados + - Prueba `mvn --version` para verificar la instalación + +- **¿Problemas de conexión?** + - Revisa tu conexión a internet + - Verifica que GitHub sea accesible desde tu red + - Asegúrate de no estar detrás de un firewall que bloquee el endpoint de GitHub Models + +- **¿El contenedor dev no inicia?** + - Asegúrate de que Docker Desktop esté en ejecución (para desarrollo local) + - Intenta reconstruir el contenedor: `Ctrl+Shift+P` → "Dev Containers: Rebuild Container" + +- **¿Errores de compilación de la aplicación?** + - Asegúrate de estar en el directorio correcto: `02-SetupDevEnvironment/examples/github-models` + - Intenta limpiar y reconstruir: `mvn clean compile` + +> **¿Necesitas ayuda?**: ¿Sigues teniendo problemas? Abre un issue en el repositorio y te ayudaremos. --- + +**Aviso legal**: +Este documento ha sido traducido utilizando el servicio de traducción automática [Co-op Translator](https://github.com/Azure/co-op-translator). Aunque nos esforzamos por la precisión, tenga en cuenta que las traducciones automáticas pueden contener errores o inexactitudes. El documento original en su idioma nativo debe considerarse la fuente autorizada. Para información crítica, se recomienda la traducción profesional realizada por humanos. No nos responsabilizamos por ningún malentendido o interpretación errónea que surja del uso de esta traducción. + \ No newline at end of file diff --git a/translations/es/02-SetupDevEnvironment/examples/basic-chat-azure/README.md b/translations/es/02-SetupDevEnvironment/examples/basic-chat-azure/README.md index 06bf56ee..160bba09 100644 --- a/translations/es/02-SetupDevEnvironment/examples/basic-chat-azure/README.md +++ b/translations/es/02-SetupDevEnvironment/examples/basic-chat-azure/README.md @@ -1,12 +1,3 @@ - # Chat Básico con Azure OpenAI - Ejemplo de Principio a Fin Este ejemplo demuestra cómo crear una aplicación simple de Spring Boot que se conecta a Azure OpenAI y prueba tu configuración. diff --git a/translations/es/02-SetupDevEnvironment/getting-started-azure-openai.md b/translations/es/02-SetupDevEnvironment/getting-started-azure-openai.md index a0064110..9dae492d 100644 --- a/translations/es/02-SetupDevEnvironment/getting-started-azure-openai.md +++ b/translations/es/02-SetupDevEnvironment/getting-started-azure-openai.md @@ -1,12 +1,3 @@ - # Configuración del Entorno de Desarrollo para Azure OpenAI > **Inicio Rápido**: Esta guía es para configurar Azure OpenAI. Para comenzar de inmediato con modelos gratuitos, utiliza [Modelos de GitHub con Codespaces](./README.md#quick-start-cloud). diff --git a/translations/es/03-CoreGenerativeAITechniques/README.md b/translations/es/03-CoreGenerativeAITechniques/README.md index 9232a7ce..ee978608 100644 --- a/translations/es/03-CoreGenerativeAITechniques/README.md +++ b/translations/es/03-CoreGenerativeAITechniques/README.md @@ -1,12 +1,3 @@ - # Tutorial de Técnicas Básicas de IA Generativa ## Tabla de Contenidos diff --git a/translations/es/04-PracticalSamples/README.md b/translations/es/04-PracticalSamples/README.md index 4e99073f..151f9d8b 100644 --- a/translations/es/04-PracticalSamples/README.md +++ b/translations/es/04-PracticalSamples/README.md @@ -1,12 +1,3 @@ - # Aplicaciones Prácticas y Proyectos ## Lo que Aprenderás diff --git a/translations/es/04-PracticalSamples/calculator/README.md b/translations/es/04-PracticalSamples/calculator/README.md index ab972af3..9a3f7348 100644 --- a/translations/es/04-PracticalSamples/calculator/README.md +++ b/translations/es/04-PracticalSamples/calculator/README.md @@ -1,12 +1,3 @@ - # Tutorial de la Calculadora MCP para Principiantes ## Tabla de Contenidos diff --git a/translations/es/04-PracticalSamples/foundrylocal/README.md b/translations/es/04-PracticalSamples/foundrylocal/README.md index 81788acc..df1e18ac 100644 --- a/translations/es/04-PracticalSamples/foundrylocal/README.md +++ b/translations/es/04-PracticalSamples/foundrylocal/README.md @@ -1,12 +1,3 @@ - # Tutorial de Foundry Local con Spring Boot ## Tabla de Contenidos diff --git a/translations/es/04-PracticalSamples/petstory/README.md b/translations/es/04-PracticalSamples/petstory/README.md index ceed42c4..c32af547 100644 --- a/translations/es/04-PracticalSamples/petstory/README.md +++ b/translations/es/04-PracticalSamples/petstory/README.md @@ -1,12 +1,3 @@ - # Tutorial del Generador de Historias de Mascotas para Principiantes ## Tabla de Contenidos diff --git a/translations/es/05-ResponsibleGenAI/README.md b/translations/es/05-ResponsibleGenAI/README.md index c157513d..1355776c 100644 --- a/translations/es/05-ResponsibleGenAI/README.md +++ b/translations/es/05-ResponsibleGenAI/README.md @@ -1,12 +1,3 @@ - # IA Generativa Responsable ## Lo que Aprenderás diff --git a/translations/es/AGENTS.md b/translations/es/AGENTS.md index d14b7742..5346708a 100644 --- a/translations/es/AGENTS.md +++ b/translations/es/AGENTS.md @@ -1,12 +1,3 @@ - # AGENTS.md ## Resumen del Proyecto diff --git a/translations/es/CODE_OF_CONDUCT.md b/translations/es/CODE_OF_CONDUCT.md index ec211df8..962ca2c7 100644 --- a/translations/es/CODE_OF_CONDUCT.md +++ b/translations/es/CODE_OF_CONDUCT.md @@ -1,12 +1,3 @@ - # Código de Conducta de Código Abierto de Microsoft Este proyecto ha adoptado el [Código de Conducta de Código Abierto de Microsoft](https://opensource.microsoft.com/codeofconduct/). diff --git a/translations/es/README.md b/translations/es/README.md index c52dc0c9..7c016a52 100644 --- a/translations/es/README.md +++ b/translations/es/README.md @@ -1,31 +1,22 @@ - # IA Generativa para Principiantes - Edición Java [![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) ![IA Generativa para Principiantes - Edición Java](../../translated_images/es/beg-genai-series.8b48be9951cc574c.webp) -**Compromiso de tiempo**: Todo el taller se puede completar en línea sin configuración local. La configuración del entorno toma 2 minutos, con la exploración de los ejemplos requiriendo de 1 a 3 horas según la profundidad de la exploración. +**Compromiso de tiempo**: El taller completo se puede completar en línea sin configuración local. La configuración del entorno toma 2 minutos, y explorar los ejemplos requiere de 1 a 3 horas dependiendo de la profundidad de la exploración. -> **Inicio rápido** +> **Inicio Rápido** 1. Haz un fork de este repositorio en tu cuenta de GitHub 2. Haz clic en **Code** → pestaña **Codespaces** → **...** → **Nuevo con opciones...** -3. Usa los valores predeterminados – esto seleccionará el contenedor de desarrollo creado para este curso -4. Haz clic en **Create codespace** +3. Usa los valores por defecto – esto seleccionará el contenedor de desarrollo creado para este curso +4. Haz clic en **Crear codespace** 5. Espera ~2 minutos para que el entorno esté listo 6. Ve directamente a [El primer ejemplo](./02-SetupDevEnvironment/README.md#step-2-create-a-github-personal-access-token) -> **¿Prefieres clonar localmente?** +> **¿Prefieres Clonar Localmente?** > -> Este repositorio incluye más de 50 traducciones de idiomas que aumentan significativamente el tamaño de la descarga. Para clonar sin traducciones, usa sparse checkout: +> Este repositorio incluye más de 50 traducciones de idiomas lo que incrementa significativamente el tamaño de descarga. Para clonar sin las traducciones, usa la extracción dispersa: > ```bash > git clone --filter=blob:none --sparse https://github.com/microsoft/Generative-AI-for-beginners-java.git > cd Generative-AI-for-beginners-java @@ -36,14 +27,14 @@ CO_OP_TRANSLATOR_METADATA: ## Soporte Multilingüe -### Soportado vía GitHub Action (Automatizado y Siempre Actualizado) +### Soportado mediante GitHub Action (Automatizado y Siempre Actualizado) -[Árabe](../ar/README.md) | [Bengalí](../bn/README.md) | [Búlgaro](../bg/README.md) | [Birmano (Myanmar)](../my/README.md) | [Chino (Simplificado)](../zh/README.md) | [Chino (Tradicional, Hong Kong)](../hk/README.md) | [Chino (Tradicional, Macao)](../mo/README.md) | [Chino (Tradicional, Taiwán)](../tw/README.md) | [Croata](../hr/README.md) | [Checo](../cs/README.md) | [Danés](../da/README.md) | [Holandés](../nl/README.md) | [Estonio](../et/README.md) | [Finlandés](../fi/README.md) | [Francés](../fr/README.md) | [Alemán](../de/README.md) | [Griego](../el/README.md) | [Hebreo](../he/README.md) | [Hindi](../hi/README.md) | [Húngaro](../hu/README.md) | [Indonesio](../id/README.md) | [Italiano](../it/README.md) | [Japonés](../ja/README.md) | [Kannada](../kn/README.md) | [Coreano](../ko/README.md) | [Lituano](../lt/README.md) | [Malayo](../ms/README.md) | [Malabar](../ml/README.md) | [Maratí](../mr/README.md) | [Nepalí](../ne/README.md) | [Pidgin Nigeriano](../pcm/README.md) | [Noruego](../no/README.md) | [Persa (Farsi)](../fa/README.md) | [Polaco](../pl/README.md) | [Portugués (Brasil)](../br/README.md) | [Portugués (Portugal)](../pt/README.md) | [Punjabi (Gurmukhi)](../pa/README.md) | [Rumano](../ro/README.md) | [Ruso](../ru/README.md) | [Serbio (Cirílico)](../sr/README.md) | [Eslovaco](../sk/README.md) | [Esloveno](../sl/README.md) | [Español](./README.md) | [Swahili](../sw/README.md) | [Sueco](../sv/README.md) | [Tagalo (Filipino)](../tl/README.md) | [Tamil](../ta/README.md) | [Telugu](../te/README.md) | [Tailandés](../th/README.md) | [Turco](../tr/README.md) | [Ucraniano](../uk/README.md) | [Urdu](../ur/README.md) | [Vietnamita](../vi/README.md) +[Árabe](../ar/README.md) | [Bengalí](../bn/README.md) | [Búlgaro](../bg/README.md) | [Birmano (Myanmar)](../my/README.md) | [Chino (Simplificado)](../zh-CN/README.md) | [Chino (Tradicional, Hong Kong)](../zh-HK/README.md) | [Chino (Tradicional, Macao)](../zh-MO/README.md) | [Chino (Tradicional, Taiwán)](../zh-TW/README.md) | [Croata](../hr/README.md) | [Checo](../cs/README.md) | [Danés](../da/README.md) | [Holandés](../nl/README.md) | [Estonio](../et/README.md) | [Finlandés](../fi/README.md) | [Francés](../fr/README.md) | [Alemán](../de/README.md) | [Griego](../el/README.md) | [Hebreo](../he/README.md) | [Hindi](../hi/README.md) | [Húngaro](../hu/README.md) | [Indonesio](../id/README.md) | [Italiano](../it/README.md) | [Japonés](../ja/README.md) | [Kannada](../kn/README.md) | [Coreano](../ko/README.md) | [Lituano](../lt/README.md) | [Malayo](../ms/README.md) | [Malayalam](../ml/README.md) | [Maratí](../mr/README.md) | [Nepalí](../ne/README.md) | [Pidgin Nigeriano](../pcm/README.md) | [Noruego](../no/README.md) | [Persa (Farsi)](../fa/README.md) | [Polaco](../pl/README.md) | [Portugués (Brasil)](../pt-BR/README.md) | [Portugués (Portugal)](../pt-PT/README.md) | [Punjabi (Gurmukhi)](../pa/README.md) | [Rumano](../ro/README.md) | [Ruso](../ru/README.md) | [Serbio (Cirílico)](../sr/README.md) | [Eslovaco](../sk/README.md) | [Esloveno](../sl/README.md) | [Español](./README.md) | [Swahili](../sw/README.md) | [Sueco](../sv/README.md) | [Tagalo (Filipino)](../tl/README.md) | [Tamil](../ta/README.md) | [Telugu](../te/README.md) | [Tailandés](../th/README.md) | [Turco](../tr/README.md) | [Ucraniano](../uk/README.md) | [Urdu](../ur/README.md) | [Vietnamita](../vi/README.md) -> **¿Prefieres clonar localmente?** +> **¿Prefieres Clonar Localmente?** -> Este repositorio incluye más de 50 traducciones de idiomas que aumentan significativamente el tamaño de la descarga. Para clonar sin traducciones, usa sparse checkout: +> Este repositorio incluye más de 50 traducciones de idiomas lo que incrementa significativamente el tamaño de descarga. Para clonar sin las traducciones, usa la extracción dispersa: > ```bash > git clone --filter=blob:none --sparse https://github.com/microsoft/Generative-AI-for-beginners-java.git > cd Generative-AI-for-beginners-java @@ -55,36 +46,36 @@ CO_OP_TRANSLATOR_METADATA: ## Estructura del Curso y Ruta de Aprendizaje ### **Capítulo 1: Introducción a la IA Generativa** -- **Conceptos Básicos**: Comprender Modelos de Lenguaje Grandes, tokens, embeddings y capacidades de IA -- **Ecosistema Java AI**: Visión general de Spring AI y SDKs OpenAI -- **Protocolo del Contexto del Modelo**: Introducción a MCP y su rol en la comunicación de agentes AI +- **Conceptos Básicos**: Entendiendo Modelos de Lenguaje Grandes, tokens, incrustaciones y capacidades de IA +- **Ecosistema de IA en Java**: Resumen de Spring AI y SDKs OpenAI +- **Protocolo de Contexto de Modelo**: Introducción a MCP y su rol en la comunicación de agentes IA - **Aplicaciones Prácticas**: Escenarios del mundo real incluyendo chatbots y generación de contenido - **[→ Comenzar Capítulo 1](./01-IntroToGenAI/README.md)** ### **Capítulo 2: Configuración del Entorno de Desarrollo** -- **Configuración Multi-Proveedor**: Configura GitHub Models, Azure OpenAI y OpenAI Java SDK integraciones -- **Spring Boot + Spring AI**: Mejores prácticas para desarrollo de aplicaciones empresariales AI -- **GitHub Models**: Acceso gratuito a modelos AI para prototipos y aprendizaje (no se requiere tarjeta de crédito) +- **Configuración Multi-Proveedor**: Configura GitHub Models, Azure OpenAI e integraciones del SDK Java OpenAI +- **Spring Boot + Spring AI**: Mejores prácticas para desarrollo de aplicaciones IA empresariales +- **GitHub Models**: Acceso gratuito a modelos IA para prototipos y aprendizaje (sin tarjeta de crédito) - **Herramientas de Desarrollo**: Contenedores Docker, VS Code y configuración de GitHub Codespaces - **[→ Comenzar Capítulo 2](./02-SetupDevEnvironment/README.md)** -### **Capítulo 3: Técnicas Core de IA Generativa** -- **Ingeniería de Prompts**: Técnicas para respuestas óptimas de modelos AI -- **Embeddings y Operaciones Vectoriales**: Implementa búsqueda semántica y comparación por similitud -- **Generación Augmentada por Recuperación (RAG)**: Combina AI con tus propias fuentes de datos -- **Llamadas a Funciones**: Extiende las capacidades de AI con herramientas y plug-ins personalizados +### **Capítulo 3: Técnicas Básicas de IA Generativa** +- **Ingeniería de Prompts**: Técnicas para respuestas óptimas del modelo IA +- **Incrustaciones & Operaciones Vectoriales**: Implementa búsqueda semántica y comparación de similitud +- **Generación Aumentada por Recuperación (RAG)**: Combina IA con tus propias fuentes de datos +- **Llamadas a Funciones**: Extiende capacidades IA con herramientas y plugins personalizados - **[→ Comenzar Capítulo 3](./03-CoreGenerativeAITechniques/README.md)** ### **Capítulo 4: Aplicaciones Prácticas y Proyectos** - **Generador de Historias de Mascotas** (`petstory/`): Generación creativa de contenido con GitHub Models -- **Demo Foundry Local** (`foundrylocal/`): Integración local de modelos AI con OpenAI Java SDK -- **Servicio Calculadora MCP** (`calculator/`): Implementación básica de Model Context Protocol con Spring AI +- **Demo Local Foundry** (`foundrylocal/`): Integración local de modelos IA con SDK Java OpenAI +- **Servicio Calculadora MCP** (`calculator/`): Implementación básica del Protocolo de Contexto de Modelo con Spring AI - **[→ Comenzar Capítulo 4](./04-PracticalSamples/README.md)** ### **Capítulo 5: Desarrollo Responsable de IA** -- **Seguridad en GitHub Models**: Prueba el filtrado de contenido incorporado y mecanismos de seguridad (bloqueos duros y negativas suaves) -- **Demo de IA Responsable**: Ejemplo práctico que muestra cómo funcionan los sistemas modernos de seguridad AI -- **Mejores Prácticas**: Guías esenciales para desarrollo y despliegue ético de IA +- **Seguridad en GitHub Models**: Prueba filtros de contenido integrados y mecanismos de seguridad (bloqueos duros y rechazos suaves) +- **Demo de IA Responsable**: Ejemplo práctico que muestra cómo funcionan los sistemas modernos de seguridad en IA +- **Mejores Prácticas**: Directrices esenciales para el desarrollo y despliegue ético de IA - **[→ Comenzar Capítulo 5](./05-ResponsibleGenAI/README.md)** ## Recursos Adicionales @@ -100,7 +91,7 @@ CO_OP_TRANSLATOR_METADATA: [![AZD para Principiantes](https://img.shields.io/badge/AZD%20for%20Beginners-0078D4?style=for-the-badge&labelColor=E5E7EB&color=0078D4)](https://github.com/microsoft/AZD-for-beginners?WT.mc_id=academic-105485-koreyst) [![Edge AI para Principiantes](https://img.shields.io/badge/Edge%20AI%20for%20Beginners-00B8E4?style=for-the-badge&labelColor=E5E7EB&color=00B8E4)](https://github.com/microsoft/edgeai-for-beginners?WT.mc_id=academic-105485-koreyst) [![MCP para Principiantes](https://img.shields.io/badge/MCP%20for%20Beginners-009688?style=for-the-badge&labelColor=E5E7EB&color=009688)](https://github.com/microsoft/mcp-for-beginners?WT.mc_id=academic-105485-koreyst) -[![Agentes AI para Principiantes](https://img.shields.io/badge/AI%20Agents%20for%20Beginners-00C49A?style=for-the-badge&labelColor=E5E7EB&color=00C49A)](https://github.com/microsoft/ai-agents-for-beginners?WT.mc_id=academic-105485-koreyst) +[![Agentes IA para Principiantes](https://img.shields.io/badge/AI%20Agents%20for%20Beginners-00C49A?style=for-the-badge&labelColor=E5E7EB&color=00C49A)](https://github.com/microsoft/ai-agents-for-beginners?WT.mc_id=academic-105485-koreyst) --- @@ -117,31 +108,31 @@ CO_OP_TRANSLATOR_METADATA: [![Ciencia de Datos para Principiantes](https://img.shields.io/badge/Data%20Science%20for%20Beginners-84CC16?style=for-the-badge&labelColor=E5E7EB&color=84CC16)](https://aka.ms/datascience-beginners?WT.mc_id=academic-105485-koreyst) [![IA para Principiantes](https://img.shields.io/badge/AI%20for%20Beginners-A3E635?style=for-the-badge&labelColor=E5E7EB&color=A3E635)](https://aka.ms/ai-beginners?WT.mc_id=academic-105485-koreyst) [![Ciberseguridad para Principiantes](https://img.shields.io/badge/Cybersecurity%20for%20Beginners-F97316?style=for-the-badge&labelColor=E5E7EB&color=F97316)](https://github.com/microsoft/Security-101?WT.mc_id=academic-96948-sayoung) -[![Desarrollo Web para Principiantes](https://img.shields.io/badge/Web%20Dev%20for%20Beginners-EC4899?style=for-the-badge&labelColor=E5E7EB&color=EC4899)](https://aka.ms/webdev-beginners?WT.mc_id=academic-105485-koreyst) -[![IoT para Principiantes](https://img.shields.io/badge/IoT%20for%20Beginners-14B8A6?style=for-the-badge&labelColor=E5E7EB&color=14B8A6)](https://aka.ms/iot-beginners?WT.mc_id=academic-105485-koreyst) -[![Desarrollo XR para Principiantes](https://img.shields.io/badge/XR%20Development%20for%20Beginners-38BDF8?style=for-the-badge&labelColor=E5E7EB&color=38BDF8)](https://github.com/microsoft/xr-development-for-beginners?WT.mc_id=academic-105485-koreyst) +[![Web Dev for Beginners](https://img.shields.io/badge/Web%20Dev%20for%20Beginners-EC4899?style=for-the-badge&labelColor=E5E7EB&color=EC4899)](https://aka.ms/webdev-beginners?WT.mc_id=academic-105485-koreyst) +[![IoT for Beginners](https://img.shields.io/badge/IoT%20for%20Beginners-14B8A6?style=for-the-badge&labelColor=E5E7EB&color=14B8A6)](https://aka.ms/iot-beginners?WT.mc_id=academic-105485-koreyst) +[![XR Development for Beginners](https://img.shields.io/badge/XR%20Development%20for%20Beginners-38BDF8?style=for-the-badge&labelColor=E5E7EB&color=38BDF8)](https://github.com/microsoft/xr-development-for-beginners?WT.mc_id=academic-105485-koreyst) --- ### Serie Copilot -[![Copilot para Programación en Pareja con IA](https://img.shields.io/badge/Copilot%20for%20AI%20Paired%20Programming-FACC15?style=for-the-badge&labelColor=E5E7EB&color=FACC15)](https://aka.ms/GitHubCopilotAI?WT.mc_id=academic-105485-koreyst) -[![Copilot para C#/.NET](https://img.shields.io/badge/Copilot%20for%20C%23/.NET-FBBF24?style=for-the-badge&labelColor=E5E7EB&color=FBBF24)](https://github.com/microsoft/mastering-github-copilot-for-dotnet-csharp-developers?WT.mc_id=academic-105485-koreyst) -[![Aventura Copilot](https://img.shields.io/badge/Copilot%20Adventure-FDE68A?style=for-the-badge&labelColor=E5E7EB&color=FDE68A)](https://github.com/microsoft/CopilotAdventures?WT.mc_id=academic-105485-koreyst) +[![Copilot for AI Paired Programming](https://img.shields.io/badge/Copilot%20for%20AI%20Paired%20Programming-FACC15?style=for-the-badge&labelColor=E5E7EB&color=FACC15)](https://aka.ms/GitHubCopilotAI?WT.mc_id=academic-105485-koreyst) +[![Copilot for C#/.NET](https://img.shields.io/badge/Copilot%20for%20C%23/.NET-FBBF24?style=for-the-badge&labelColor=E5E7EB&color=FBBF24)](https://github.com/microsoft/mastering-github-copilot-for-dotnet-csharp-developers?WT.mc_id=academic-105485-koreyst) +[![Copilot Adventure](https://img.shields.io/badge/Copilot%20Adventure-FDE68A?style=for-the-badge&labelColor=E5E7EB&color=FDE68A)](https://github.com/microsoft/CopilotAdventures?WT.mc_id=academic-105485-koreyst) -## Obtener Ayuda +## Obtener ayuda -Si te quedas atascado o tienes alguna pregunta sobre cómo crear aplicaciones de IA. Únete a otros aprendices y desarrolladores experimentados en discusiones sobre MCP. Es una comunidad de apoyo donde las preguntas son bienvenidas y el conocimiento se comparte libremente. +Si te quedas atascado o tienes alguna pregunta sobre la creación de aplicaciones de IA, únete a otros aprendices y desarrolladores experimentados en discusiones sobre MCP. Es una comunidad de apoyo donde las preguntas son bienvenidas y el conocimiento se comparte libremente. [![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) -Si tienes comentarios sobre el producto o errores mientras construyes, visita: +Si tienes comentarios sobre el producto o encuentras errores durante la creación, visita: -[![Foro de Desarrolladores de Microsoft Foundry](https://img.shields.io/badge/GitHub-Microsoft_Foundry_Developer_Forum-blue?style=for-the-badge&logo=github&color=000000&logoColor=fff)](https://aka.ms/foundry/forum) +[![Microsoft Foundry Developer Forum](https://img.shields.io/badge/GitHub-Microsoft_Foundry_Developer_Forum-blue?style=for-the-badge&logo=github&color=000000&logoColor=fff)](https://aka.ms/foundry/forum) --- **Aviso legal**: -Este documento ha sido traducido utilizando el servicio de traducción automática [Co-op Translator](https://github.com/Azure/co-op-translator). Aunque nos esforzamos por la precisión, tenga en cuenta que las traducciones automatizadas pueden contener errores o inexactitudes. El documento original en su idioma nativo debe considerarse la fuente autorizada. Para información crítica, se recomienda una traducción profesional realizada por un humano. No nos hacemos responsables por malentendidos o interpretaciones erróneas derivadas del uso de esta traducción. +Este documento ha sido traducido utilizando el servicio de traducción automática [Co-op Translator](https://github.com/Azure/co-op-translator). Aunque nos esforzamos por la precisión, tenga en cuenta que las traducciones automáticas pueden contener errores o inexactitudes. El documento original en su idioma nativo debe considerarse la fuente autorizada. Para información crítica, se recomienda la traducción humana profesional. No nos hacemos responsables de malentendidos o interpretaciones erróneas derivadas del uso de esta traducción. \ No newline at end of file diff --git a/translations/es/SECURITY.md b/translations/es/SECURITY.md index 2a9eae12..e882deb5 100644 --- a/translations/es/SECURITY.md +++ b/translations/es/SECURITY.md @@ -1,12 +1,3 @@ - ## Seguridad Microsoft se toma muy en serio la seguridad de nuestros productos y servicios de software, lo que incluye todos los repositorios de código fuente gestionados a través de nuestras organizaciones de GitHub, que incluyen [Microsoft](https://github.com/Microsoft), [Azure](https://github.com/Azure), [DotNet](https://github.com/dotnet), [AspNet](https://github.com/aspnet) y [Xamarin](https://github.com/xamarin). diff --git a/translations/es/SUPPORT.md b/translations/es/SUPPORT.md index 96571b5d..1575dbf0 100644 --- a/translations/es/SUPPORT.md +++ b/translations/es/SUPPORT.md @@ -1,12 +1,3 @@ - # Soporte ## Cómo reportar problemas y obtener ayuda diff --git a/translations/et/.co-op-translator.json b/translations/et/.co-op-translator.json new file mode 100644 index 00000000..726a6c92 --- /dev/null +++ b/translations/et/.co-op-translator.json @@ -0,0 +1,92 @@ +{ + "01-IntroToGenAI/README.md": { + "original_hash": "75bfb080ca725e8a9aa9c80cae25fba1", + "translation_date": "2025-10-11T10:49:08+00:00", + "source_file": "01-IntroToGenAI/README.md", + "language_code": "et" + }, + "02-SetupDevEnvironment/README.md": { + "original_hash": "96a30d42b9751a3d4e4b20e28d29d459", + "translation_date": "2026-01-28T05:34:15+00:00", + "source_file": "02-SetupDevEnvironment/README.md", + "language_code": "et" + }, + "02-SetupDevEnvironment/examples/basic-chat-azure/README.md": { + "original_hash": "efd82efe50711d7e257eb943151d682c", + "translation_date": "2025-10-11T10:45:49+00:00", + "source_file": "02-SetupDevEnvironment/examples/basic-chat-azure/README.md", + "language_code": "et" + }, + "02-SetupDevEnvironment/getting-started-azure-openai.md": { + "original_hash": "bfdb4b4eadbee3a59ef742439f58326a", + "translation_date": "2025-10-11T10:44:07+00:00", + "source_file": "02-SetupDevEnvironment/getting-started-azure-openai.md", + "language_code": "et" + }, + "03-CoreGenerativeAITechniques/README.md": { + "original_hash": "685f55cb07de19b52a30ce6e8b6d889e", + "translation_date": "2025-10-11T10:47:57+00:00", + "source_file": "03-CoreGenerativeAITechniques/README.md", + "language_code": "et" + }, + "04-PracticalSamples/README.md": { + "original_hash": "14c0a61ecc1cd2012a9c129236dfdf71", + "translation_date": "2025-10-11T10:39:51+00:00", + "source_file": "04-PracticalSamples/README.md", + "language_code": "et" + }, + "04-PracticalSamples/calculator/README.md": { + "original_hash": "b6c16b5514d524e415a94f6097ee7d4c", + "translation_date": "2025-10-11T10:40:26+00:00", + "source_file": "04-PracticalSamples/calculator/README.md", + "language_code": "et" + }, + "04-PracticalSamples/foundrylocal/README.md": { + "original_hash": "f787307400de59adc25a1404466a35f3", + "translation_date": "2025-11-04T07:39:08+00:00", + "source_file": "04-PracticalSamples/foundrylocal/README.md", + "language_code": "et" + }, + "04-PracticalSamples/petstory/README.md": { + "original_hash": "0cbf68d605615a1e602c832a24616859", + "translation_date": "2025-10-11T10:42:41+00:00", + "source_file": "04-PracticalSamples/petstory/README.md", + "language_code": "et" + }, + "05-ResponsibleGenAI/README.md": { + "original_hash": "301c05c2f57e60a6950b8c665b8bdbba", + "translation_date": "2025-10-11T10:43:27+00:00", + "source_file": "05-ResponsibleGenAI/README.md", + "language_code": "et" + }, + "AGENTS.md": { + "original_hash": "afc90918d008cf77fd1982691f681306", + "translation_date": "2025-10-11T10:37:42+00:00", + "source_file": "AGENTS.md", + "language_code": "et" + }, + "CODE_OF_CONDUCT.md": { + "original_hash": "442b123d034f92f7c384d2bbd28f99f1", + "translation_date": "2025-10-11T10:39:09+00:00", + "source_file": "CODE_OF_CONDUCT.md", + "language_code": "et" + }, + "README.md": { + "original_hash": "125a08948d881c95628094f4dd1fbd43", + "translation_date": "2026-01-29T16:25:54+00:00", + "source_file": "README.md", + "language_code": "et" + }, + "SECURITY.md": { + "original_hash": "57f14126c1c6add76b3aef3844dfe4e3", + "translation_date": "2025-10-11T10:39:25+00:00", + "source_file": "SECURITY.md", + "language_code": "et" + }, + "SUPPORT.md": { + "original_hash": "b8ef73cc49dec68e2c885ee9df545129", + "translation_date": "2025-10-11T10:38:58+00:00", + "source_file": "SUPPORT.md", + "language_code": "et" + } +} \ No newline at end of file diff --git a/translations/et/01-IntroToGenAI/README.md b/translations/et/01-IntroToGenAI/README.md index 8712e184..9794f985 100644 --- a/translations/et/01-IntroToGenAI/README.md +++ b/translations/et/01-IntroToGenAI/README.md @@ -1,12 +1,3 @@ - # Generatiivse tehisintellekti sissejuhatus - Java väljaanne ## Mida sa õpid diff --git a/translations/et/02-SetupDevEnvironment/README.md b/translations/et/02-SetupDevEnvironment/README.md index 0032de04..f6a2b1ad 100644 --- a/translations/et/02-SetupDevEnvironment/README.md +++ b/translations/et/02-SetupDevEnvironment/README.md @@ -1,158 +1,152 @@ - -# Generatiivse tehisintellekti arenduskeskkonna seadistamine Java jaoks +# Arenduskeskkonna seadistamine Generatiivse tehisintellekti jaoks Java jaoks -> **Kiire algus**: Koodi pilves 2 minutiga – liigu [GitHub Codespaces'i seadistamise](../../../02-SetupDevEnvironment) juurde – ei vaja kohalikku installimist ja kasutab GitHubi mudeleid! +> **Kiire algus**: Koodi kirjutamine pilves 2 minutiga - liigu otse [GitHub Codespacesi seadistusse](../../../02-SetupDevEnvironment) - kohaliku installatsiooni pole vaja ja kasutatakse githubi mudeleid! -> **Huvitatud Azure OpenAI-st?** Vaata meie [Azure OpenAI seadistusjuhendit](getting-started-azure-openai.md), kus on sammud uue Azure OpenAI ressursi loomiseks. +> **Huvitatud Azure OpenAI-st?**, vaata meie [Azure OpenAI seadistusjuhendit](getting-started-azure-openai.md) koos sammudega uue Azure OpenAI ressursi loomiseks. -## Mida õpid +## Mida sa õpid -- Seadistada Java arenduskeskkonda AI rakenduste jaoks -- Valida ja konfigureerida oma eelistatud arenduskeskkonda (pilvepõhine Codespaces, kohalik dev-container või täielik kohalik seadistus) -- Testida oma seadistust, ühendades GitHubi mudelitega +- Seadistada Java arenduskeskkond AI rakenduste jaoks +- Valida ja konfigureerida eelistatud arenduskeskkond (pilvepõhine Codespacesiga, kohalik arenduskonteiner või täismahus kohalik seadistus) +- Testida oma seadistust ühendudes GitHubi mudelitega ## Sisukord -- [Mida õpid](../../../02-SetupDevEnvironment) +- [Mida sa õpid](../../../02-SetupDevEnvironment) - [Sissejuhatus](../../../02-SetupDevEnvironment) - [1. samm: Arenduskeskkonna seadistamine](../../../02-SetupDevEnvironment) - - [Valik A: GitHub Codespaces (soovitatav)](../../../02-SetupDevEnvironment) - - [Valik B: Kohalik dev-container](../../../02-SetupDevEnvironment) - - [Valik C: Olemasoleva kohaliku installatsiooni kasutamine](../../../02-SetupDevEnvironment) -- [2. samm: GitHubi isikliku juurdepääsutunnuse loomine](../../../02-SetupDevEnvironment) -- [3. samm: Seadistuse testimine](../../../02-SetupDevEnvironment) + - [Valik A: GitHub Codespaces (Soovitatav)](../../../02-SetupDevEnvironment) + - [Valik B: Kohalik arenduskonteiner](../../../02-SetupDevEnvironment) + - [Valik C: Kasuta oma olemasolevat kohalikku installatsiooni](../../../02-SetupDevEnvironment) +- [2. samm: Loo GitHubi isiklik juurdepääsutunnus](../../../02-SetupDevEnvironment) +- [3. samm: Testi oma seadistust](../../../02-SetupDevEnvironment) - [Tõrkeotsing](../../../02-SetupDevEnvironment) - [Kokkuvõte](../../../02-SetupDevEnvironment) - [Järgmised sammud](../../../02-SetupDevEnvironment) ## Sissejuhatus -See peatükk juhendab sind arenduskeskkonna seadistamisel. Kasutame **GitHubi mudeleid** peamise näitena, kuna see on tasuta, lihtne seadistada ainult GitHubi kontoga, ei vaja krediitkaarti ja pakub mitmeid mudeleid katsetamiseks. +See peatükk juhendab sind arenduskeskkonna seadistamisel. Kasutame peamise näitena **GitHubi mudeleid**, sest need on tasuta, lihtsasti seadistatavad ainult GitHubi kontoga, ei vaja krediitkaarti ja annavad ligipääsu mitmele mudelile katsetamiseks. -**Kohalikku seadistust pole vaja!** Saad kohe koodi kirjutama hakata, kasutades GitHub Codespaces'i, mis pakub täielikku arenduskeskkonda otse sinu brauseris. +**Kohalikku seadistust pole vaja!** Saad kohe kodeerima hakata GitHub Codespaces'is, mis pakub brauseris täisväärtuslikku arenduskeskkonda. -Ekraanipilt: GitHubi mudelid +Ekraanipilt: GitHub Models -Soovitame kasutada [**GitHubi mudeleid**](https://github.com/marketplace?type=models) selle kursuse jaoks, kuna see on: +Soovitame seda kursust läbides kasutada [**GitHub Models**](https://github.com/marketplace?type=models), sest see on: - **Tasuta** alustamiseks - **Lihtne** seadistada ainult GitHubi kontoga -- **Ei vaja krediitkaarti** -- **Mitmed mudelid** katsetamiseks +- **Krediitkaarti pole vaja** +- **Mitmed mudelid** katsetamiseks saadaval -> **Märkus**: Selle koolituse GitHubi mudelitel on järgmised tasuta piirangud: +> **Märkus**: Selle koolituse GitHubi mudelitel on need tasuta piirangud: > - 15 päringut minutis (150 päevas) -> - ~8000 sõna sisend, ~4000 sõna väljund päringu kohta +> - ~8 000 sõna sisendit, ~4 000 sõna väljundit päringu kohta > - 5 samaaegset päringut > -> Tootmiskasutuseks uuenda Azure AI Foundry mudelitele oma Azure'i kontoga. Sinu kood ei vaja muutmist. Vaata [Azure AI Foundry dokumentatsiooni](https://learn.microsoft.com/azure/ai-foundry/foundry-models/how-to/quickstart-github-models). +> Tootmiskasutuseks uuenda Azure AI Foundry mudelitele oma Azure kontoga. Koodi pole vaja muuta. Vaata [Azure AI Foundry dokumentatsiooni](https://learn.microsoft.com/azure/ai-foundry/foundry-models/how-to/quickstart-github-models). + ## 1. samm: Arenduskeskkonna seadistamine -Oleme loonud eelkonfigureeritud arenduscontaineri, et minimeerida seadistusaega ja tagada, et sul on kõik vajalikud tööriistad selle generatiivse tehisintellekti Java kursuse jaoks. Vali oma eelistatud arendusviis: +Oleme loonud eelkonfigureeritud arenduskonteineri, et vähendada seadistamise aega ja tagada kõik vajalikud tööriistad selle Generatiivse AI Java kursuse jaoks. Vali endale sobiv arendusviis: ### Keskkonna seadistamise valikud: -#### Valik A: GitHub Codespaces (soovitatav) +#### Valik A: GitHub Codespaces (Soovitatav) -**Alusta koodi kirjutamist 2 minutiga – kohalikku seadistust pole vaja!** +**Alusta kodeerimist 2 minutiga - kohalikku seadistust pole vaja!** -1. Forki see repositoorium oma GitHubi kontole - > **Märkus**: Kui soovid muuta põhikonfiguratsiooni, vaata [Dev Container Configuration](../../../.devcontainer/devcontainer.json) -2. Klõpsa **Code** → **Codespaces** vahekaart → **...** → **New with options...** -3. Kasuta vaikeseadeid – see valib **Dev container configuration**: **Generative AI Java Development Environment** kohandatud devcontaineri, mis on loodud selle kursuse jaoks +1. Hargne see reposiit oma GitHubi kontole + > **Märkus**: Kui soovid baas-konfiguratsiooni muuta, vaata [Dev Container Configuration](../../../.devcontainer/devcontainer.json) +2. Klõpsa **Code** → vahekaart **Codespaces** → **...** → **New with options...** +3. Kasuta vaikimisi seadeid – see valib **Dev container configuration**: **Generative AI Java Development Environment**, mis on selle kursuse kohandatud devcontainer 4. Klõpsa **Create codespace** -5. Oota ~2 minutit, kuni keskkond on valmis -6. Jätka [2. sammuga: GitHubi tunnuse loomine](../../../02-SetupDevEnvironment) +5. Oota umbes 2 minutit, kuni keskkond on valmis +6. Liigu edasi [2. sammu: Loo GitHubi token](../../../02-SetupDevEnvironment) + +Ekraanipilt: Codespacesi alammenüü -Ekraanipilt: Codespaces'i alammenüü +Ekraanipilt: Uus valikutega -Ekraanipilt: New with options +Ekraanipilt: Create codespace valikud -Ekraanipilt: Codespace'i loomise valikud -> **Codespaces'i eelised**: -> - Kohalikku installimist pole vaja -> - Töötab igas seadmes, millel on brauser -> - Eelkonfigureeritud kõigi tööriistade ja sõltuvustega -> - Tasuta 60 tundi kuus isikliku konto jaoks +> **Codespacesi eelised**: +> - Ei vaja kohalikku installatsiooni +> - Toimib igas seadmes, kus on brauser +> - Eelkonfigureeritud kõikide tööriistade ja sõltuvustega +> - Tasuta 60 tundi kuus isiklikele kontodele > - Ühtne keskkond kõigile õppijatele -#### Valik B: Kohalik dev-container +#### Valik B: Kohalik arenduskonteiner **Arendajatele, kes eelistavad kohalikku arendust Dockeriga** -1. Forki ja klooni see repositoorium oma kohalikku masinasse - > **Märkus**: Kui soovid muuta põhikonfiguratsiooni, vaata [Dev Container Configuration](../../../.devcontainer/devcontainer.json) -2. Installi [Docker Desktop](https://www.docker.com/products/docker-desktop/) ja [VS Code](https://code.visualstudio.com/) -3. Installi [Dev Containers laiendus](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers) VS Code'is -4. Ava repositooriumi kaust VS Code'is +1. Hargne ja klooni see reposiit oma kohalikule masinale + > **Märkus**: Kui soovid baas-konfiguratsiooni muuta, vaata [Dev Container Configuration](../../../.devcontainer/devcontainer.json) +2. Paigalda [Docker Desktop](https://www.docker.com/products/docker-desktop/) ja [VS Code](https://code.visualstudio.com/) +3. Paigalda VS Code'i [Dev Containers plugin](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers) +4. Ava repokataloog VS Code'is 5. Kui küsitakse, klõpsa **Reopen in Container** (või kasuta `Ctrl+Shift+P` → "Dev Containers: Reopen in Container") -6. Oota, kuni container ehitatakse ja käivitatakse -7. Jätka [2. sammuga: GitHubi tunnuse loomine](../../../02-SetupDevEnvironment) +6. Oota, kuni konteiner koostatakse ja käivitatakse +7. Liigu edasi [2. sammu: Loo GitHubi token](../../../02-SetupDevEnvironment) -Ekraanipilt: Dev-containeri seadistamine +Ekraanipilt: Arenduskonteineri seadistamine -Ekraanipilt: Dev-containeri ehitamine lõpetatud +Ekraanipilt: Arenduskonteineri koostamine lõpetatud -#### Valik C: Olemasoleva kohaliku installatsiooni kasutamine +#### Valik C: Kasuta oma olemasolevat kohalikku installatsiooni -**Arendajatele, kellel on olemasolev Java keskkond** +**Arendajatele, kellel on olemas Java arenduskeskkond** -Eeltingimused: +Nõuded: - [Java 21+](https://www.oracle.com/java/technologies/javase/jdk21-archive-downloads.html) - [Maven 3.9+](https://maven.apache.org/download.cgi) -- [VS Code](https://code.visualstudio.com) või sinu eelistatud IDE +- [VS Code](https://code.visualstudio.com) või eelistatud IDE Sammud: -1. Klooni see repositoorium oma kohalikku masinasse +1. Klooni see reposiit oma kohalikule masinale 2. Ava projekt oma IDE-s -3. Jätka [2. sammuga: GitHubi tunnuse loomine](../../../02-SetupDevEnvironment) +3. Liigu edasi [2. sammu: Loo GitHubi token](../../../02-SetupDevEnvironment) + +> **Nõuanded**: Kui su arvuti on madala võimsusega, aga soovid VS Code'i kohapeal kasutada, kasuta GitHub Codespaces’i! Saad ühendada kohaliku VS Code'i pilves asuva Codespace’iga, mis annab kahe maailma parima koosluse. -> **Pro nõuanne**: Kui sul on madala spetsifikatsiooniga masin, kuid soovid VS Code'i kohapeal, kasuta GitHub Codespaces'i! Sa saad ühendada oma kohaliku VS Code'i pilvehostitud Codespace'iga, et saada mõlemast maailmast parim. +Ekraanipilt: loodud kohalik devcontaineri instants -Ekraanipilt: loodud kohalik dev-containeri instants -## 2. samm: GitHubi isikliku juurdepääsutunnuse loomine +## 2. samm: Loo GitHubi isiklik juurdepääsutunnus -1. Navigeeri [GitHubi seadistustesse](https://github.com/settings/profile) ja vali **Settings** oma profiilimenüüst. -2. Vasakpoolses külgribas klõpsa **Developer settings** (tavaliselt allosas). -3. **Personal access tokens** all klõpsa **Fine-grained tokens** (või kasuta seda otselinki: [link](https://github.com/settings/personal-access-tokens)). +1. Mine [GitHubi seadistustesse](https://github.com/settings/profile) ja vali oma profiilimenüüst **Settings**. +2. Vasakult menüüst klõpsa **Developer settings** (tavaliselt allosas). +3. **Personal access tokens** alt klõpsa **Fine-grained tokens** (või kasuta seda otselinki [link](https://github.com/settings/personal-access-tokens)). 4. Klõpsa **Generate new token**. -5. "Token name" all anna kirjeldav nimi (nt `GenAI-Java-Course-Token`). -6. Määra aegumiskuupäev (soovitatav: 7 päeva turvapraktikate jaoks). -7. "Resource owner" all vali oma kasutajakonto. -8. "Repository access" all vali repositooriumid, mida soovid kasutada GitHubi mudelitega (või "All repositories", kui vaja). -9. "Account permissions" all leia **Models** ja määra see **Read-only**. +5. "Token name" lahtrisse pane kirjeldav nimi (näiteks `GenAI-Java-Course-Token`). +6. Sea aegumiskuupäev (soovituslik: 7 päeva turvalisuse tagamiseks). +7. "Resource owner" alt vali oma kasutajakonto. +8. "Repository access" alt vali repod, mida soovid GitHubi mudelitega kasutada (või "All repositories", kui vaja). +9. "Account permissions" alt leia **Models** ja seadista see **Read-only**-ks. 10. Klõpsa **Generate token**. -11. **Kopeeri ja salvesta oma tunnus kohe** – sa ei näe seda enam! +11. **Kopeeri ja salvesta oma token nüüd** – seda enam ei näe! -> **Turvanõuanne**: Kasuta minimaalselt vajalikku ulatust ja lühimat praktilist aegumisaega oma juurdepääsutunnuste jaoks. +> **Turvalisuse näpunäide**: Kasuta minimaalset vajalikku ulatust ja lühimat praktilist aegumisaega oma juurdepääsutunnuste jaoks. -## 3. samm: Seadistuse testimine GitHubi mudelite näitega +## 3. samm: Testi oma seadistust GitHub Models näitega -Kui sinu arenduskeskkond on valmis, testime GitHubi mudelite integreerimist meie näiterakendusega [`02-SetupDevEnvironment/examples/github-models`](../../../02-SetupDevEnvironment/examples/github-models). +Kui su arenduskeskkond on valmis, testime GitHub Models integratsiooni meie näidisrakendusega kaustas [`02-SetupDevEnvironment/examples/github-models`](../../../02-SetupDevEnvironment/examples/github-models). 1. Ava terminal oma arenduskeskkonnas. -2. Navigeeri GitHubi mudelite näite juurde: +2. Liigu GitHub Models näidise kausta: ```bash cd 02-SetupDevEnvironment/examples/github-models ``` -3. Määra oma GitHubi tunnus keskkonnamuutujana: +3. Sea oma GitHub token keskkonnamuutujana: ```bash # macOS/Linux export GITHUB_TOKEN=your_token_here - # Windows (Command Prompt) + # Windows (Käsuviip) set GITHUB_TOKEN=your_token_here # Windows (PowerShell) @@ -164,24 +158,24 @@ Kui sinu arenduskeskkond on valmis, testime GitHubi mudelite integreerimist meie mvn compile exec:java -Dexec.mainClass="com.example.githubmodels.App" ``` -Sa peaksid nägema väljundit, mis on sarnane: +Näed väljundit, mis on sarnane: ```text Using model: gpt-4.1-nano Sending request to GitHub Models... Response: Hello World! ``` -### Näitekoodi mõistmine +### Näidiskoodi mõistmine -Esmalt mõistame, mida me just käivitasime. Näide `examples/github-models` kaustas kasutab OpenAI Java SDK-d, et ühendada GitHubi mudelitega: +Kõigepealt vaatame, mida me jooksutasime. Näidis `examples/github-models` kasutab OpenAI Java SDK-d, et ühendada GitHub Modelsiga: **Mida see kood teeb:** -- **Ühendub** GitHubi mudelitega, kasutades sinu isiklikku juurdepääsutunnust +- **Ühendub** GitHub Modelsiga, kasutades sinu isiklikku juurdepääsutunnust - **Saadab** lihtsa sõnumi "Say Hello World!" AI mudelile -- **Võtab vastu** ja kuvab AI vastuse -- **Kinnitab**, et sinu seadistus töötab õigesti +- **Vastab** ja kuvab AI vastuse +- **Kontrollib**, et sinu seadistus töötab korrektselt -**Peamine sõltuvus** (failis `pom.xml`): +**Peamine sõltuvus** (`pom.xml`-is): ```xml com.openai @@ -190,69 +184,71 @@ Esmalt mõistame, mida me just käivitasime. Näide `examples/github-models` kau ``` -**Põhikood** (`App.java`): +**Peamine kood** (`App.java`): ```java -// Connect to GitHub Models using OpenAI Java SDK +// Ühenda GitHubi mudelitega, kasutades OpenAI Java SDK-d OpenAIClient client = OpenAIOkHttpClient.builder() .apiKey(pat) .baseUrl("https://models.inference.ai.azure.com") .build(); -// Create chat completion request +// Loo vestluse lõpetamise päring ChatCompletionCreateParams params = ChatCompletionCreateParams.builder() .model(modelId) .addSystemMessage("You are a concise assistant.") .addUserMessage("Say Hello World!") .build(); -// Get AI response +// Saa tehisintellekti vastus ChatCompletion response = client.chat().completions().create(params); System.out.println("Response: " + response.choices().get(0).message().content().orElse("No response content")); ``` ## Kokkuvõte -Suurepärane! Sul on nüüd kõik seadistatud: +Suurepärane! Sul on nüüd kõik valmis: -- Loodud GitHubi isiklik juurdepääsutunnus õigete õigustega AI mudelitele juurdepääsuks -- Käivitatud Java arenduskeskkond (olgu see Codespaces, dev-container või kohalik) -- Ühendatud GitHubi mudelitega, kasutades OpenAI Java SDK-d tasuta AI arenduseks -- Testitud, et kõik töötab lihtsa näitega, mis suhtleb AI mudelitega +- Loodud GitHubi isiklik juurdepääsutunnus õigete AI mudelite juurdepääsu õigustega +- Käivitatud Java arenduskeskkond (olgu see Codespaces, dev konteiner või kohalik) +- Ühendatud GitHub Modelsiga OpenAI Java SDK abil tasuta AI arenduseks +- Testitud kõik toimib lihtsa näitega, mis suhtleb AI mudelitega ## Järgmised sammud -[3. peatükk: Generatiivse tehisintellekti põhitehnikad](../03-CoreGenerativeAITechniques/README.md) +[3. peatükk: Tuum Generatiivse AI tehnikad](../03-CoreGenerativeAITechniques/README.md) ## Tõrkeotsing -Probleemid? Siin on levinud probleemid ja lahendused: +Probleemide korral siin on levinumad vead ja lahendused: -- **Tunnus ei tööta?** - - Veendu, et kopeerisid kogu tunnuse ilma lisatühikuteta - - Kontrolli, et tunnus on õigesti keskkonnamuutujana määratud - - Veendu, et tunnusel on õiged õigused (Models: Read and write) +- **Token ei tööta?** + - Veendu, et kopeerisid kogu tokeni ilma tühikuteta + - Kontrolli, et token on õigesti keskkonnamuutujasse määratud + - Veendu tokeni õigustes (Models: Read-only) -- **Maveni puudumine?** - - Kui kasutad dev-containerit/Codespaces'i, peaks Maven olema eelinstallitud - - Kohaliku seadistuse jaoks veendu, et Java 21+ ja Maven 3.9+ on installitud +- **Mavenit ei leitud?** + - Dev konteinerite või Codespacesi puhul peaks Maven olema eelinstallitud + - Kohaliku seadistuse puhul veendu, et Java 21+ ja Maven 3.9+ on paigaldatud - Proovi `mvn --version`, et kontrollida installatsiooni - **Ühenduse probleemid?** - Kontrolli oma internetiühendust - - Veendu, et GitHub on sinu võrgust kättesaadav - - Kontrolli, et tulemüür ei blokeeri GitHubi mudelite lõpp-punkti + - Veendu, et GitHub on võrgust ligipääsetav + - Kontrolli, et ei ole tulemüüri, mis blokeerib GitHub Models lõpp-punkti -- **Dev-container ei käivitu?** +- **Dev konteiner ei käivitu?** - Veendu, et Docker Desktop töötab (kohaliku arenduse jaoks) - - Proovi containerit uuesti ehitada: `Ctrl+Shift+P` → "Dev Containers: Rebuild Container" + - Proovi konteinerit uuesti ehitada: `Ctrl+Shift+P` → "Dev Containers: Rebuild Container" - **Rakenduse kompileerimisvead?** - Veendu, et oled õiges kataloogis: `02-SetupDevEnvironment/examples/github-models` - - Proovi puhastada ja uuesti ehitada: `mvn clean compile` + - Proovi puhastada ja uuesti kompileerida: `mvn clean compile` -> **Abi vaja?**: Ikka probleeme? Ava repositooriumis probleem ja me aitame sind. +> **Vajad abi?**: Kui probleemid jätkuvad, ava probleem repos ja aitame sind. --- -**Lahtiütlus**: -See dokument on tõlgitud AI tõlketeenuse [Co-op Translator](https://github.com/Azure/co-op-translator) abil. Kuigi püüame tagada täpsust, palume arvestada, et automaatsed tõlked võivad sisaldada vigu või ebatäpsusi. Algne dokument selle algses keeles tuleks pidada autoriteetseks allikaks. Olulise teabe puhul soovitame kasutada professionaalset inimtõlget. Me ei vastuta selle tõlke kasutamisest tulenevate arusaamatuste või valesti tõlgenduste eest. \ No newline at end of file + +**Vastutusest loobumine**: +See dokument on tõlgitud kasutades AI tõlketeenust [Co-op Translator](https://github.com/Azure/co-op-translator). Kuigi me püüame täpsust, palun pange tähele, et automatiseeritud tõlgetes võib esineda vigu või ebatäpsusi. Originaaldokument selle emakeeles tuleks lugeda usaldusväärseks allikaks. Olulise teabe puhul soovitame kasutada professionaalset inimtõlget. Me ei vastuta tõlgenduste ega arusaamatuste eest, mis võivad tuleneda selle tõlke kasutamisest. + \ No newline at end of file diff --git a/translations/et/02-SetupDevEnvironment/examples/basic-chat-azure/README.md b/translations/et/02-SetupDevEnvironment/examples/basic-chat-azure/README.md index 8b23e516..02f10a4d 100644 --- a/translations/et/02-SetupDevEnvironment/examples/basic-chat-azure/README.md +++ b/translations/et/02-SetupDevEnvironment/examples/basic-chat-azure/README.md @@ -1,12 +1,3 @@ - # Põhiline vestlus Azure OpenAI-ga - Näide algusest lõpuni See näide näitab, kuidas luua lihtne Spring Boot rakendus, mis ühendub Azure OpenAI-ga ja testib teie seadistust. diff --git a/translations/et/02-SetupDevEnvironment/getting-started-azure-openai.md b/translations/et/02-SetupDevEnvironment/getting-started-azure-openai.md index f38fefa4..c1eb88db 100644 --- a/translations/et/02-SetupDevEnvironment/getting-started-azure-openai.md +++ b/translations/et/02-SetupDevEnvironment/getting-started-azure-openai.md @@ -1,12 +1,3 @@ - # Azure OpenAI arenduskeskkonna seadistamine > **Kiire alustamine**: See juhend on mõeldud Azure OpenAI seadistamiseks. Tasuta mudelitega koheseks alustamiseks kasuta [GitHub Models with Codespaces](./README.md#quick-start-cloud). diff --git a/translations/et/03-CoreGenerativeAITechniques/README.md b/translations/et/03-CoreGenerativeAITechniques/README.md index b7a16783..cb0d6f0c 100644 --- a/translations/et/03-CoreGenerativeAITechniques/README.md +++ b/translations/et/03-CoreGenerativeAITechniques/README.md @@ -1,12 +1,3 @@ - # Generatiivse tehisintellekti põhitehnikate õpetus ## Sisukord diff --git a/translations/et/04-PracticalSamples/README.md b/translations/et/04-PracticalSamples/README.md index d62e052e..e2c266b7 100644 --- a/translations/et/04-PracticalSamples/README.md +++ b/translations/et/04-PracticalSamples/README.md @@ -1,12 +1,3 @@ - # Praktilised Rakendused ja Projektid ## Mida Sa Õpid diff --git a/translations/et/04-PracticalSamples/calculator/README.md b/translations/et/04-PracticalSamples/calculator/README.md index fb381b3a..32c570ce 100644 --- a/translations/et/04-PracticalSamples/calculator/README.md +++ b/translations/et/04-PracticalSamples/calculator/README.md @@ -1,12 +1,3 @@ - # MCP Kalkulaatori Õpetus Algajatele ## Sisukord diff --git a/translations/et/04-PracticalSamples/foundrylocal/README.md b/translations/et/04-PracticalSamples/foundrylocal/README.md index a55ad608..1a73b31e 100644 --- a/translations/et/04-PracticalSamples/foundrylocal/README.md +++ b/translations/et/04-PracticalSamples/foundrylocal/README.md @@ -1,12 +1,3 @@ - # Foundry Local Spring Boot Õpetus ## Sisukord diff --git a/translations/et/04-PracticalSamples/petstory/README.md b/translations/et/04-PracticalSamples/petstory/README.md index 23456557..2d411f15 100644 --- a/translations/et/04-PracticalSamples/petstory/README.md +++ b/translations/et/04-PracticalSamples/petstory/README.md @@ -1,12 +1,3 @@ - # Lemmiklooma Loo Generaatori Õpetus Algajatele ## Sisukord diff --git a/translations/et/05-ResponsibleGenAI/README.md b/translations/et/05-ResponsibleGenAI/README.md index 3b133177..afdb4ed9 100644 --- a/translations/et/05-ResponsibleGenAI/README.md +++ b/translations/et/05-ResponsibleGenAI/README.md @@ -1,12 +1,3 @@ - # Vastutustundlik generatiivne tehisintellekt ## Mida õpid diff --git a/translations/et/AGENTS.md b/translations/et/AGENTS.md index 03a63d8e..e01f9943 100644 --- a/translations/et/AGENTS.md +++ b/translations/et/AGENTS.md @@ -1,12 +1,3 @@ - # AGENTS.md ## Projekti Ülevaade diff --git a/translations/et/CODE_OF_CONDUCT.md b/translations/et/CODE_OF_CONDUCT.md index 26f9aa47..2c27cfb4 100644 --- a/translations/et/CODE_OF_CONDUCT.md +++ b/translations/et/CODE_OF_CONDUCT.md @@ -1,12 +1,3 @@ - # Microsofti avatud lähtekoodi käitumisjuhend See projekt on omaks võtnud [Microsofti avatud lähtekoodi käitumisjuhendi](https://opensource.microsoft.com/codeofconduct/). diff --git a/translations/et/README.md b/translations/et/README.md index b778ce33..cc83d167 100644 --- a/translations/et/README.md +++ b/translations/et/README.md @@ -1,90 +1,81 @@ - # Generatiivne tehisintellekt algajatele - Java väljaanne [![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) ![Generatiivne tehisintellekt algajatele - Java väljaanne](../../translated_images/et/beg-genai-series.8b48be9951cc574c.webp) -**Ajapanus**: Kogu töötuba saab lõpetada veebis ilma kohaliku seadistuseta. Keskkonna seadistamine võtab 2 minutit ja näidiste uurimine 1–3 tundi, sõltuvalt uurimise sügavusest. +**Ajapühendus**: Kogu töötuba saab täita veebis ilma kohalikku seadistust tegemata. Keskkonna seadistamine võtab 2 minutit, näidiste uurimine 1-3 tundi, sõltuvalt uurimise sügavusest. -> **Kiire algus** +> **Kiirstart** -1. Forki see hoidla oma GitHubi kontole -2. Klõpsa **Code** → **Codespaces** vahekaart → **...** → **New with options...** -3. Kasuta vaikeseadeid – see valib selle kursuse jaoks loodud arendusmahuti -4. Klõpsa **Create codespace** -5. Oota ~2 minutit, kuni keskkond on valmis -6. Hüpata otse [Esimese näite juurde](./02-SetupDevEnvironment/README.md#step-2-create-a-github-personal-access-token) +1. Tehke selle hoidla fork oma GitHubi kontole +2. Klõpsake **Code** → **Codespaces** vaheleht → **...** → **New with options...** +3. Kasutage vaikeseadeid – see valib kursuse jaoks loodud arenduskonteineri +4. Klõpsake **Create codespace** +5. Oodake umbes 2 minutit, kuni keskkond on valmis +6. Minge otse [Esimese näite juurde](./02-SetupDevEnvironment/README.md#step-2-create-a-github-personal-access-token) -> **Eelistad kloonida kohalikult?** +> **Eelistate kloonida lokaalselt?** > -> Selles hoidlas on üle 50 keele tõlke, mis suurendab allalaadimise mahtu märkimisväärselt. Ilma tõlgeteta kloonimiseks kasuta sparse checkout'i: +> See hoidla sisaldab 50+ keele tõlget, mis suurendab märkimisväärselt allalaadimise suurust. Tõlgeteta kloonimiseks kasutage sparsereview valikut: > ```bash > git clone --filter=blob:none --sparse https://github.com/microsoft/Generative-AI-for-beginners-java.git > cd Generative-AI-for-beginners-java > git sparse-checkout set --no-cone '/*' '!translations' '!translated_images' > ``` -> See annab sulle kõik vajaliku kursuse läbimiseks palju kiiremalt. +> See annab teile kõik vajaliku kursuse lõpetamiseks palju kiiremalt. ## Mitmekeelne tugi -### Toetatud GitHub Actioni kaudu (automaatne ja alati ajakohane) +### Toetatud GitHub Action'i kaudu (Automaatne ja alati ajakohane) -[araabia](../ar/README.md) | [bengali](../bn/README.md) | [bulgaaria](../bg/README.md) | [burma (Myanmar)](../my/README.md) | [hiina (lihtsustatud)](../zh/README.md) | [hiina (traditsiooniline, Hongkong)](../hk/README.md) | [hiina (traditsiooniline, Macau)](../mo/README.md) | [hiina (traditsiooniline, Taiwan)](../tw/README.md) | [horvaadi](../hr/README.md) | [tšehhi](../cs/README.md) | [taani](../da/README.md) | [hollandi](../nl/README.md) | [eesti](./README.md) | [soome](../fi/README.md) | [prantsuse](../fr/README.md) | [saksa](../de/README.md) | [kreeka](../el/README.md) | [heebrea](../he/README.md) | [hindi](../hi/README.md) | [ungari](../hu/README.md) | [indoneesia](../id/README.md) | [itaalia](../it/README.md) | [jaapani](../ja/README.md) | [kannada](../kn/README.md) | [korea](../ko/README.md) | [leedu](../lt/README.md) | [malai](../ms/README.md) | [malajalami](../ml/README.md) | [marathi](../mr/README.md) | [nepali](../ne/README.md) | [Nigeeria pidgin](../pcm/README.md) | [norra](../no/README.md) | [pärsia (Farsi)](../fa/README.md) | [poola](../pl/README.md) | [portugali (Brasiilia)](../br/README.md) | [portugali (Portugal)](../pt/README.md) | [pandžabi (Gurmukhi)](../pa/README.md) | [rumeenia](../ro/README.md) | [vene](../ru/README.md) | [serbia (kirillitsa)](../sr/README.md) | [slovaki](../sk/README.md) | [sloveeni](../sl/README.md) | [hispaania](../es/README.md) | [suahiili](../sw/README.md) | [rootsi](../sv/README.md) | [tagalogi (filipino)](../tl/README.md) | [tamiili](../ta/README.md) | [telugu](../te/README.md) | [tai](../th/README.md) | [türgi](../tr/README.md) | [ukraina](../uk/README.md) | [urdu](../ur/README.md) | [vietnami](../vi/README.md) +[Araabia](../ar/README.md) | [Bengali](../bn/README.md) | [Bulgaaria](../bg/README.md) | [Birma (Myanmar)](../my/README.md) | [Hiina (lihtsustatud)](../zh-CN/README.md) | [Hiina (traditsiooniline, Hong Kong)](../zh-HK/README.md) | [Hiina (traditsiooniline, Macau)](../zh-MO/README.md) | [Hiina (traditsiooniline, Taiwan)](../zh-TW/README.md) | [Horvaadi](../hr/README.md) | [Tšehhi](../cs/README.md) | [Taani](../da/README.md) | [Hollandi](../nl/README.md) | [Eesti](./README.md) | [Soome](../fi/README.md) | [Prantsuse](../fr/README.md) | [Saksa](../de/README.md) | [Kreeka](../el/README.md) | [Heebrea](../he/README.md) | [Hindi](../hi/README.md) | [Ungari](../hu/README.md) | [Indoneesia](../id/README.md) | [Itaalia](../it/README.md) | [Jaapani](../ja/README.md) | [Kannada](../kn/README.md) | [Korea](../ko/README.md) | [Leedu](../lt/README.md) | [Malai](../ms/README.md) | [Malayalam](../ml/README.md) | [Marathi](../mr/README.md) | [Nepali](../ne/README.md) | [Nigeeria pidžin](../pcm/README.md) | [Norra](../no/README.md) | [Pärsia (Farsi)](../fa/README.md) | [Poola](../pl/README.md) | [Portugali (Brasiilia)](../pt-BR/README.md) | [Portugali (Portugal)](../pt-PT/README.md) | [Panjabi (Gurmukhi)](../pa/README.md) | [Rumeenia](../ro/README.md) | [Vene](../ru/README.md) | [Serbia (tsõrilitsa)](../sr/README.md) | [Slovaki](../sk/README.md) | [Sloveeni](../sl/README.md) | [Hispaania](../es/README.md) | [Suaheli](../sw/README.md) | [Rootsi](../sv/README.md) | [Tagalog (Filipiinid)](../tl/README.md) | [Tamili](../ta/README.md) | [Telugu](../te/README.md) | [Tai](../th/README.md) | [Türgi](../tr/README.md) | [Ukraina](../uk/README.md) | [Urdu](../ur/README.md) | [Vietnami](../vi/README.md) -> **Eelistad kloonida kohalikult?** +> **Eelistate kloonida lokaalselt?** -> Selles hoidlas on üle 50 keele tõlke, mis suurendab allalaadimise mahtu märkimisväärselt. Ilma tõlgeteta kloonimiseks kasuta sparse checkout'i: +> See hoidla sisaldab 50+ keele tõlget, mis suurendab märkimisväärselt allalaadimise suurust. Tõlgeteta kloonimiseks kasutage sparsereview valikut: > ```bash > git clone --filter=blob:none --sparse https://github.com/microsoft/Generative-AI-for-beginners-java.git > cd Generative-AI-for-beginners-java > git sparse-checkout set --no-cone '/*' '!translations' '!translated_images' > ``` -> See annab sulle kõik vajaliku kursuse läbimiseks palju kiiremalt. +> See annab teile kõik vajaliku kursuse lõpetamiseks palju kiiremalt. ## Kursuse struktuur ja õppeteekond ### **1. peatükk: Sissejuhatus generatiivsesse tehisintellekti** -- **Põhikontseptsioonid**: Suurte keelemudelite, tokenite, manuste ja tehisintellekti võimete mõistmine -- **Java AI ökosüsteem**: Ülevaade Spring AI ja OpenAI SDK-dest -- **Mudeli konteksti protokoll**: Sissejuhatus MCP-sse ja selle roll AI agentide suhtluses -- **Praktilised rakendused**: Tõelised stsenaariumid, sealhulgas vestlusrobotid ja sisuloomine -- **[→ Alusta 1. peatükist](./01-IntroToGenAI/README.md)** +- **Põhikontseptsioonid**: Suurte keelemudelite, tokenite, manuste ja tehisintellekti võimekuse mõistmine +- **Java tehisintellekti ökosüsteem**: Ülevaade Spring AI ja OpenAI SDK-dest +- **Mudelikontextiprotocol**: Tutvustus MCP-st ja selle rollist AI agentide suhtluses +- **Praktilised rakendused**: Reaalsed stsenaariumid, sealhulgas vestlusrobotid ja sisuloome +- **[→ Alusta 1. peatükki](./01-IntroToGenAI/README.md)** ### **2. peatükk: Arenduskeskkonna seadistamine** -- **Mitme pakkuja konfiguratsioon**: GitHubi mudelite, Azure OpenAI ja OpenAI Java SDK integratsioonide seadistamine -- **Spring Boot + Spring AI**: Parimad tavad ettevõtte AI rakenduste arendamiseks -- **GitHubi mudelid**: Tasuta AI mudelite ligipääs prototüüpimiseks ja õppimiseks (ilma krediitkaardita) -- **Arendustööriistad**: Docker mahutid, VS Code ja GitHubi Codespaces konfiguratsioon -- **[→ Alusta 2. peatükist](./02-SetupDevEnvironment/README.md)** - -### **3. peatükk: Põhilised generatiivse tehisintellekti tehnikad** -- **Promptide inseneriteadus**: Optimaalse AI mudelitele vastamise tehnikad -- **Manused ja vektoritöötlus**: Semantilise otsingu ja sarnasuse sobitamise rakendamine -- **Taasmine täiendatud genereerimine (RAG)**: AI ühendamine oma andmeallikatega -- **Funktsioonide kutsumine**: AI võimete laiendamine kohandatud tööriistade ja pistikprogrammidega -- **[→ Alusta 3. peatükist](./03-CoreGenerativeAITechniques/README.md)** +- **Mitme teenusepakkuja konfiguratsioon**: GitHubi mudelite, Azure OpenAI ja OpenAI Java SDK integratsioonide seadistamine +- **Spring Boot + Spring AI**: Parimad tavad ettevõtte tehisintellekti rakenduste arendamiseks +- **GitHub mudelid**: Tasuta AI mudelite ligipääs prototüüpimiseks ja õppimiseks (pole krediitkaarti vaja) +- **Arendustööriistad**: Docker konteinerid, VS Code ja GitHub Codespaces seadistamine +- **[→ Alusta 2. peatükki](./02-SetupDevEnvironment/README.md)** + +### **3. peatükk: Põhitehnoloogiad generatiivses tehisintellektis** +- **Promptide inseneritöö**: Optimaalsete AI mudeli vastuste tehnikad +- **Manused ja vektortegevused**: Semantilise otsingu ja sarnasuse sobitamise rakendamine +- **Tagasitoomisega rikastatud genereerimine (RAG)**: AI ühendamine oma andmeallikatega +- **Funktsioonikõned**: AI võimekuse laiendamine kohandatud tööriistade ja pistikprogrammidega +- **[→ Alusta 3. peatükki](./03-CoreGenerativeAITechniques/README.md)** ### **4. peatükk: Praktilised rakendused ja projektid** -- **Lemmiku loo generaator** (`petstory/`): Loov sisuloomine GitHubi mudelitega +- **Lemmiklooma loo generaator** (`petstory/`): Loominguline sisuloome GitHubi mudelitega - **Foundry kohalik demo** (`foundrylocal/`): Kohalik AI mudeli integratsioon OpenAI Java SDK-ga -- **MCP kalkulaatori teenus** (`calculator/`): Põhiline Mudeli konteksti protokolli rakendus Spring AI-ga -- **[→ Alusta 4. peatükist](./04-PracticalSamples/README.md)** +- **MCP kalkulaatori teenus** (`calculator/`): Põhilise Model Context Protocol rakendus Spring AI-ga +- **[→ Alusta 4. peatükki](./04-PracticalSamples/README.md)** -### **5. peatükk: Vastutustundlik AI arendus** -- **GitHubi mudelite turvalisus**: Sisseehitatud sisufiltri ja turvaprotokollide (rasked plokid ja pehmed keeldumised) testimine -- **Vastutustundliku AI demo**: Praktiline näide tänapäevaste AI turvasüsteemide toimimisest -- **Parimad tavad**: Olulised juhised eetiliseks AI arenduseks ja kasutuselevõtuks -- **[→ Alusta 5. peatükist](./05-ResponsibleGenAI/README.md)** +### **5. peatükk: Vastutustundlik tehisintellekti arendus** +- **GitHubi mudelite turvalisus**: Sisseehitatud sisufiltreerimise ja turvaprotokollide testimine (rasked blokeeringud ja pehmed keelamisotsused) +- **Vastutustundliku AI demo**: Praktiline näide sellest, kuidas moodsa AI turvasüsteemid toimivad +- **Parimad tavad**: Eetilise AI arendamise ja juurutamise põhinõuanded +- **[→ Alusta 5. peatükki](./05-ResponsibleGenAI/README.md)** ## Täiendavad ressursid @@ -95,52 +86,52 @@ CO_OP_TRANSLATOR_METADATA: --- -### Azure / Edge / MCP / Agentid +### Azure / Edge / MCP / Agendid [![AZD algajatele](https://img.shields.io/badge/AZD%20for%20Beginners-0078D4?style=for-the-badge&labelColor=E5E7EB&color=0078D4)](https://github.com/microsoft/AZD-for-beginners?WT.mc_id=academic-105485-koreyst) [![Edge AI algajatele](https://img.shields.io/badge/Edge%20AI%20for%20Beginners-00B8E4?style=for-the-badge&labelColor=E5E7EB&color=00B8E4)](https://github.com/microsoft/edgeai-for-beginners?WT.mc_id=academic-105485-koreyst) [![MCP algajatele](https://img.shields.io/badge/MCP%20for%20Beginners-009688?style=for-the-badge&labelColor=E5E7EB&color=009688)](https://github.com/microsoft/mcp-for-beginners?WT.mc_id=academic-105485-koreyst) -[![AI agentid algajatele](https://img.shields.io/badge/AI%20Agents%20for%20Beginners-00C49A?style=for-the-badge&labelColor=E5E7EB&color=00C49A)](https://github.com/microsoft/ai-agents-for-beginners?WT.mc_id=academic-105485-koreyst) +[![AI agendid algajatele](https://img.shields.io/badge/AI%20Agents%20for%20Beginners-00C49A?style=for-the-badge&labelColor=E5E7EB&color=00C49A)](https://github.com/microsoft/ai-agents-for-beginners?WT.mc_id=academic-105485-koreyst) --- - -### Generatiivne AI seeria -[![Generatiivne AI algajatele](https://img.shields.io/badge/Generative%20AI%20for%20Beginners-8B5CF6?style=for-the-badge&labelColor=E5E7EB&color=8B5CF6)](https://github.com/microsoft/generative-ai-for-beginners?WT.mc_id=academic-105485-koreyst) -[![Generatiivne AI (.NET)](https://img.shields.io/badge/Generative%20AI%20(.NET)-9333EA?style=for-the-badge&labelColor=E5E7EB&color=9333EA)](https://github.com/microsoft/Generative-AI-for-beginners-dotnet?WT.mc_id=academic-105485-koreyst) -[![Generatiivne AI (Java)](https://img.shields.io/badge/Generative%20AI%20(Java)-C084FC?style=for-the-badge&labelColor=E5E7EB&color=C084FC)](https://github.com/microsoft/generative-ai-for-beginners-java?WT.mc_id=academic-105485-koreyst) -[![Generatiivne AI (JavaScript)](https://img.shields.io/badge/Generative%20AI%20(JavaScript)-E879F9?style=for-the-badge&labelColor=E5E7EB&color=E879F9)](https://github.com/microsoft/generative-ai-with-javascript?WT.mc_id=academic-105485-koreyst) + +### Generatiivne tehisintellekti sari +[![Generatiivne tehisintellekt algajatele](https://img.shields.io/badge/Generative%20AI%20for%20Beginners-8B5CF6?style=for-the-badge&labelColor=E5E7EB&color=8B5CF6)](https://github.com/microsoft/generative-ai-for-beginners?WT.mc_id=academic-105485-koreyst) +[![Generatiivne tehisintellekt (.NET)](https://img.shields.io/badge/Generative%20AI%20(.NET)-9333EA?style=for-the-badge&labelColor=E5E7EB&color=9333EA)](https://github.com/microsoft/Generative-AI-for-beginners-dotnet?WT.mc_id=academic-105485-koreyst) +[![Generatiivne tehisintellekt (Java)](https://img.shields.io/badge/Generative%20AI%20(Java)-C084FC?style=for-the-badge&labelColor=E5E7EB&color=C084FC)](https://github.com/microsoft/generative-ai-for-beginners-java?WT.mc_id=academic-105485-koreyst) +[![Generatiivne tehisintellekt (JavaScript)](https://img.shields.io/badge/Generative%20AI%20(JavaScript)-E879F9?style=for-the-badge&labelColor=E5E7EB&color=E879F9)](https://github.com/microsoft/generative-ai-with-javascript?WT.mc_id=academic-105485-koreyst) --- - -### Põhioskused + +### Põhiõpe [![Masinõpe algajatele](https://img.shields.io/badge/ML%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=22C55E)](https://aka.ms/ml-beginners?WT.mc_id=academic-105485-koreyst) [![Andmeteadus algajatele](https://img.shields.io/badge/Data%20Science%20for%20Beginners-84CC16?style=for-the-badge&labelColor=E5E7EB&color=84CC16)](https://aka.ms/datascience-beginners?WT.mc_id=academic-105485-koreyst) -[![AI algajatele](https://img.shields.io/badge/AI%20for%20Beginners-A3E635?style=for-the-badge&labelColor=E5E7EB&color=A3E635)](https://aka.ms/ai-beginners?WT.mc_id=academic-105485-koreyst) -[![Küberjulgeolek algajatele](https://img.shields.io/badge/Cybersecurity%20for%20Beginners-F97316?style=for-the-badge&labelColor=E5E7EB&color=F97316)](https://github.com/microsoft/Security-101?WT.mc_id=academic-96948-sayoung) +[![Tehisintellekt algajatele](https://img.shields.io/badge/AI%20for%20Beginners-A3E635?style=for-the-badge&labelColor=E5E7EB&color=A3E635)](https://aka.ms/ai-beginners?WT.mc_id=academic-105485-koreyst) +[![Küberkaitse algajatele](https://img.shields.io/badge/Cybersecurity%20for%20Beginners-F97316?style=for-the-badge&labelColor=E5E7EB&color=F97316)](https://github.com/microsoft/Security-101?WT.mc_id=academic-96948-sayoung) [![Veebiarendus algajatele](https://img.shields.io/badge/Web%20Dev%20for%20Beginners-EC4899?style=for-the-badge&labelColor=E5E7EB&color=EC4899)](https://aka.ms/webdev-beginners?WT.mc_id=academic-105485-koreyst) [![IoT algajatele](https://img.shields.io/badge/IoT%20for%20Beginners-14B8A6?style=for-the-badge&labelColor=E5E7EB&color=14B8A6)](https://aka.ms/iot-beginners?WT.mc_id=academic-105485-koreyst) -[![XR arendamine algajatele](https://img.shields.io/badge/XR%20Development%20for%20Beginners-38BDF8?style=for-the-badge&labelColor=E5E7EB&color=38BDF8)](https://github.com/microsoft/xr-development-for-beginners?WT.mc_id=academic-105485-koreyst) +[![XR arendus algajatele](https://img.shields.io/badge/XR%20Development%20for%20Beginners-38BDF8?style=for-the-badge&labelColor=E5E7EB&color=38BDF8)](https://github.com/microsoft/xr-development-for-beginners?WT.mc_id=academic-105485-koreyst) --- ### Copiloti sari [![Copilot tehisintellekti paarisprogrammeerimiseks](https://img.shields.io/badge/Copilot%20for%20AI%20Paired%20Programming-FACC15?style=for-the-badge&labelColor=E5E7EB&color=FACC15)](https://aka.ms/GitHubCopilotAI?WT.mc_id=academic-105485-koreyst) [![Copilot C#/.NET jaoks](https://img.shields.io/badge/Copilot%20for%20C%23/.NET-FBBF24?style=for-the-badge&labelColor=E5E7EB&color=FBBF24)](https://github.com/microsoft/mastering-github-copilot-for-dotnet-csharp-developers?WT.mc_id=academic-105485-koreyst) -[![Copilot seiklus](https://img.shields.io/badge/Copilot%20Adventure-FDE68A?style=for-the-badge&labelColor=E5E7EB&color=FDE68A)](https://github.com/microsoft/CopilotAdventures?WT.mc_id=academic-105485-koreyst) +[![Copiloti seiklus](https://img.shields.io/badge/Copilot%20Adventure-FDE68A?style=for-the-badge&labelColor=E5E7EB&color=FDE68A)](https://github.com/microsoft/CopilotAdventures?WT.mc_id=academic-105485-koreyst) ## Abi saamine -Kui te jääte hätta või teil on küsimusi tehisintellekti rakenduste loomise kohta. Liituge teiste õppijate ja kogenud arendajatega aruteludes MCP teemal. See on toetav kogukond, kus küsimused on teretulnud ja teadmisi jagatakse vabalt. +Kui jääd hätta või sul on küsimusi tehisintellekti rakenduste koostamise kohta. Liitu teiste õppijate ja kogenud arendajatega aruteludes MCP kohta. See on toetav kogukond, kus küsimused on teretulnud ja teadmisi jagatakse vabalt. [![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) -Kui teil on toodet puudutav tagasiside või ehitamisel tekib vigu, külastage: +Kui sul on toote tagasisidet või ehitamise ajal vigu, külasta: [![Microsoft Foundry arendajate foorum](https://img.shields.io/badge/GitHub-Microsoft_Foundry_Developer_Forum-blue?style=for-the-badge&logo=github&color=000000&logoColor=fff)](https://aka.ms/foundry/forum) --- -**Vastutusest loobumine**: -See dokument on tõlgitud kasutades tehisintellektil põhinevat tõlkimisteenust [Co-op Translator](https://github.com/Azure/co-op-translator). Kuigi püüame täpsust, palun arvestage, et automatiseeritud tõlked võivad sisaldada vigu või ebatäpsusi. Originaaldokument oma emakeeles tuleks pidada autoriteetseks allikaks. Olulise teabe puhul soovitatakse kasutada professionaalset inimtõlget. Me ei vastuta mistahes arusaamatuste või valesti mõistmiste eest, mis võivad tekkida selle tõlke kasutamisest. +**Vastutusest loobumine**: +See dokument on tõlgitud tehisintellekti tõlketeenuse [Co-op Translator](https://github.com/Azure/co-op-translator) abil. Kuigi püüdleme täpsuse poole, tuleb arvestada, et automaatsed tõlked võivad sisaldada vigu või ebatäpsusi. Originaaldokument oma emakeeles on ametlik allikas. Kriitilise teabe puhul soovitatakse kasutada professionaalset inimtõlget. Me ei vastuta selle tõlke kasutamisest tingitud arusaamatuste või valesti tõlgendamise eest. \ No newline at end of file diff --git a/translations/et/SECURITY.md b/translations/et/SECURITY.md index 9799b90c..815f0361 100644 --- a/translations/et/SECURITY.md +++ b/translations/et/SECURITY.md @@ -1,12 +1,3 @@ - ## Turvalisus diff --git a/translations/et/SUPPORT.md b/translations/et/SUPPORT.md index c5b677ef..9c8ea873 100644 --- a/translations/et/SUPPORT.md +++ b/translations/et/SUPPORT.md @@ -1,12 +1,3 @@ - # Tugi ## Kuidas esitada probleeme ja saada abi diff --git a/translations/fa/.co-op-translator.json b/translations/fa/.co-op-translator.json new file mode 100644 index 00000000..9303a348 --- /dev/null +++ b/translations/fa/.co-op-translator.json @@ -0,0 +1,92 @@ +{ + "01-IntroToGenAI/README.md": { + "original_hash": "75bfb080ca725e8a9aa9c80cae25fba1", + "translation_date": "2025-07-29T08:12:50+00:00", + "source_file": "01-IntroToGenAI/README.md", + "language_code": "fa" + }, + "02-SetupDevEnvironment/README.md": { + "original_hash": "96a30d42b9751a3d4e4b20e28d29d459", + "translation_date": "2026-01-28T04:40:42+00:00", + "source_file": "02-SetupDevEnvironment/README.md", + "language_code": "fa" + }, + "02-SetupDevEnvironment/examples/basic-chat-azure/README.md": { + "original_hash": "efd82efe50711d7e257eb943151d682c", + "translation_date": "2025-07-27T13:34:27+00:00", + "source_file": "02-SetupDevEnvironment/examples/basic-chat-azure/README.md", + "language_code": "fa" + }, + "02-SetupDevEnvironment/getting-started-azure-openai.md": { + "original_hash": "bfdb4b4eadbee3a59ef742439f58326a", + "translation_date": "2025-07-27T12:52:42+00:00", + "source_file": "02-SetupDevEnvironment/getting-started-azure-openai.md", + "language_code": "fa" + }, + "03-CoreGenerativeAITechniques/README.md": { + "original_hash": "685f55cb07de19b52a30ce6e8b6d889e", + "translation_date": "2025-08-28T21:55:00+00:00", + "source_file": "03-CoreGenerativeAITechniques/README.md", + "language_code": "fa" + }, + "04-PracticalSamples/README.md": { + "original_hash": "14c0a61ecc1cd2012a9c129236dfdf71", + "translation_date": "2025-07-29T08:12:35+00:00", + "source_file": "04-PracticalSamples/README.md", + "language_code": "fa" + }, + "04-PracticalSamples/calculator/README.md": { + "original_hash": "b6c16b5514d524e415a94f6097ee7d4c", + "translation_date": "2025-09-18T15:24:33+00:00", + "source_file": "04-PracticalSamples/calculator/README.md", + "language_code": "fa" + }, + "04-PracticalSamples/foundrylocal/README.md": { + "original_hash": "f787307400de59adc25a1404466a35f3", + "translation_date": "2025-11-04T07:14:25+00:00", + "source_file": "04-PracticalSamples/foundrylocal/README.md", + "language_code": "fa" + }, + "04-PracticalSamples/petstory/README.md": { + "original_hash": "0cbf68d605615a1e602c832a24616859", + "translation_date": "2025-07-25T10:48:07+00:00", + "source_file": "04-PracticalSamples/petstory/README.md", + "language_code": "fa" + }, + "05-ResponsibleGenAI/README.md": { + "original_hash": "301c05c2f57e60a6950b8c665b8bdbba", + "translation_date": "2025-07-29T15:41:52+00:00", + "source_file": "05-ResponsibleGenAI/README.md", + "language_code": "fa" + }, + "AGENTS.md": { + "original_hash": "afc90918d008cf77fd1982691f681306", + "translation_date": "2025-10-03T08:26:50+00:00", + "source_file": "AGENTS.md", + "language_code": "fa" + }, + "CODE_OF_CONDUCT.md": { + "original_hash": "442b123d034f92f7c384d2bbd28f99f1", + "translation_date": "2025-07-21T15:59:09+00:00", + "source_file": "CODE_OF_CONDUCT.md", + "language_code": "fa" + }, + "README.md": { + "original_hash": "125a08948d881c95628094f4dd1fbd43", + "translation_date": "2026-01-29T15:21:52+00:00", + "source_file": "README.md", + "language_code": "fa" + }, + "SECURITY.md": { + "original_hash": "57f14126c1c6add76b3aef3844dfe4e3", + "translation_date": "2025-07-21T15:57:34+00:00", + "source_file": "SECURITY.md", + "language_code": "fa" + }, + "SUPPORT.md": { + "original_hash": "b8ef73cc49dec68e2c885ee9df545129", + "translation_date": "2025-07-21T16:00:12+00:00", + "source_file": "SUPPORT.md", + "language_code": "fa" + } +} \ No newline at end of file diff --git a/translations/fa/01-IntroToGenAI/README.md b/translations/fa/01-IntroToGenAI/README.md index 70c2c9a6..021149b6 100644 --- a/translations/fa/01-IntroToGenAI/README.md +++ b/translations/fa/01-IntroToGenAI/README.md @@ -1,12 +1,3 @@ - # مقدمه‌ای بر هوش مصنوعی مولد - نسخه جاوا ## آنچه خواهید آموخت diff --git a/translations/fa/02-SetupDevEnvironment/README.md b/translations/fa/02-SetupDevEnvironment/README.md index 262fbca8..47f8c914 100644 --- a/translations/fa/02-SetupDevEnvironment/README.md +++ b/translations/fa/02-SetupDevEnvironment/README.md @@ -1,13 +1,253 @@ - +# راه‌اندازی محیط توسعه برای هوش مصنوعی مولد در جاوا +> **شروع سریع**: برنامه‌نویسی در ابر در ۲ دقیقه - به بخش [راه‌اندازی GitHub Codespaces](../../../02-SetupDevEnvironment) بروید - نیازی به نصب محلی نیست و از مدل‌های گیت‌هاب استفاده می‌کند! + +> **علاقه‌مند به Azure OpenAI هستید؟**، راهنمای [راه‌اندازی Azure OpenAI](getting-started-azure-openai.md) ما را ببینید که مراحل ایجاد یک منبع جدید Azure OpenAI را توضیح می‌دهد. + +## آنچه یاد می‌گیرید + +- راه‌اندازی محیط توسعه جاوا برای برنامه‌های هوش مصنوعی +- انتخاب و پیکربندی محیط توسعه دلخواه خود (ابتدا ابری با Codespaces، کانتینر توسعه محلی یا راه‌اندازی کامل محلی) +- تست راه‌اندازی با اتصال به مدل‌های GitHub + +## فهرست مطالب + +- [آنچه یاد می‌گیرید](../../../02-SetupDevEnvironment) +- [مقدمه](../../../02-SetupDevEnvironment) +- [مرحله ۱: راه‌اندازی محیط توسعه](../../../02-SetupDevEnvironment) + - [گزینه الف: GitHub Codespaces (توصیه‌شده)](../../../02-SetupDevEnvironment) + - [گزینه ب: کانتینر توسعه محلی](../../../02-SetupDevEnvironment) + - [گزینه ج: استفاده از نصب محلی موجود شما](../../../02-SetupDevEnvironment) +- [مرحله ۲: ایجاد توکن دسترسی شخصی GitHub](../../../02-SetupDevEnvironment) +- [مرحله ۳: تست راه‌اندازی با نمونه مدل‌های GitHub](../../../02-SetupDevEnvironment) +- [عیب‌یابی](../../../02-SetupDevEnvironment) +- [خلاصه](../../../02-SetupDevEnvironment) +- [مراحل بعدی](../../../02-SetupDevEnvironment) + +## مقدمه + +این فصل شما را در راه‌اندازی محیط توسعه راهنمایی می‌کند. ما از **مدل‌های GitHub** به عنوان نمونه اصلی استفاده می‌کنیم زیرا رایگان است، تنها با یک حساب گیت‌هاب به راحتی راه‌اندازی می‌شود، نیازی به کارت اعتباری ندارد و دسترسی به چندین مدل برای آزمایش فراهم می‌کند. + +**نیازی به راه‌اندازی محلی نیست!** شما می‌توانید بلافاصله با استفاده از GitHub Codespaces شروع به برنامه‌نویسی کنید که یک محیط توسعه کامل را در مرورگر شما فراهم می‌کند. + +Screenshot: GitHub Models + +ما استفاده از [**مدل‌های GitHub**](https://github.com/marketplace?type=models) را برای این دوره توصیه می‌کنیم زیرا: +- شروع آن **رایگان** است +- با داشتن فقط یک حساب گیت‌هاب **راه‌اندازی آن آسان** است +- **نیازی به کارت اعتباری** ندارد +- **چندین مدل** برای آزمایش در دسترس است + +> **توجه**: محدودیت‌های رایگان مدل‌های GitHub که در این آموزش استفاده می‌شوند عبارتند از: +> - ۱۵ درخواست در دقیقه (۱۵۰ درخواست در روز) +> - حدود ۸,۰۰۰ کلمه ورودی و ۴,۰۰۰ کلمه خروجی در هر درخواست +> - ۵ درخواست همزمان +> +> برای استفاده در تولید، به مدل‌های Azure AI Foundry با حساب Azure خود ارتقاء دهید. نیازی به تغییر در کد شما نیست. مستندات [Azure AI Foundry](https://learn.microsoft.com/azure/ai-foundry/foundry-models/how-to/quickstart-github-models) را ببینید. + +## مرحله ۱: راه‌اندازی محیط توسعه + + + +ما یک کانتینر توسعه پیش‌پیکربندی شده ایجاد کرده‌ایم تا زمان راه‌اندازی را به حداقل برسانیم و اطمینان حاصل کنیم که همه ابزارهای لازم برای این دوره هوش مصنوعی مولد در جاوا در اختیار دارید. روش توسعه دلخواه خود را انتخاب کنید: + +### گزینه‌های راه‌اندازی محیط: + +#### گزینه الف: GitHub Codespaces (توصیه‌شده) + +**در ۲ دقیقه شروع به کدنویسی کنید - نیازی به راه‌اندازی محلی نیست!** + +1. این مخزن را به حساب GitHub خود فورک کنید + > **توجه**: اگر می‌خواهید پیکربندی پایه را ویرایش کنید، به [پیکربندی کانتینر توسعه](../../../.devcontainer/devcontainer.json) مراجعه کنید +2. روی **Code** کلیک کنید → تب **Codespaces** → روی **...** کلیک کنید → گزینه **New with options...** +3. تنظیمات پیش‌فرض را استفاده کنید – این گزینه کانتینر توسعه با پیکربندی **محیط توسعه جاوا هوش مصنوعی مولد** را که سفارشی برای این دوره ساخته شده انتخاب می‌کند +4. روی **Create codespace** کلیک کنید +5. حدود ۲ دقیقه صبر کنید تا محیط آماده شود +6. به [مرحله ۲: ایجاد توکن GitHub](../../../02-SetupDevEnvironment) بروید + +Screenshot: Codespaces submenu + +Screenshot: New with options + +Screenshot: Create codespace options + + +> **مزایای Codespaces**: +> - نیازی به نصب محلی ندارد +> - روی هر دستگاهی با مرورگر کار می‌کند +> - با همه ابزارها و وابستگی‌ها پیش‌تنظیم شده است +> - ۶۰ ساعت رایگان در ماه برای حساب‌های شخصی +> - محیطی یکنواخت برای همه یادگیرندگان + +#### گزینه ب: کانتینر توسعه محلی + +**برای توسعه‌دهندگانی که ترجیح می‌دهند به صورت محلی با Docker توسعه دهند** + +1. این مخزن را فورک و کلون کنید بر روی رایانه محلی خود + > **توجه**: اگر می‌خواهید پیکربندی پایه را ویرایش کنید، به [پیکربندی کانتینر توسعه](../../../.devcontainer/devcontainer.json) مراجعه کنید +2. [Docker Desktop](https://www.docker.com/products/docker-desktop/) و [VS Code](https://code.visualstudio.com/) را نصب کنید +3. افزونه [Dev Containers](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers) را در VS Code نصب کنید +4. پوشه مخزن را در VS Code باز کنید +5. زمانی که درخواست شد، روی **Reopen in Container** کلیک کنید (یا از `Ctrl+Shift+P` → "Dev Containers: Reopen in Container" استفاده کنید) +6. منتظر بمانید تا کانتینر ساخته شده و شروع به کار کند +7. به [مرحله ۲: ایجاد توکن GitHub](../../../02-SetupDevEnvironment) بروید + +Screenshot: Dev container setup + +Screenshot: Dev container build complete + +#### گزینه ج: استفاده از نصب محلی موجود شما + +**برای توسعه‌دهندگانی که محیط جاوای موجود دارند** + +پیش‌نیازها: +- [جاوا ۲۱ یا بالاتر](https://www.oracle.com/java/technologies/javase/jdk21-archive-downloads.html) +- [مِیون ۳.۹ یا بالاتر](https://maven.apache.org/download.cgi) +- [VS Code](https://code.visualstudio.com) یا IDE دلخواه شما + +مراحل: +1. این مخزن را روی رایانه محلی خود کلون کنید +2. پروژه را در IDE خود باز کنید +3. به [مرحله ۲: ایجاد توکن GitHub](../../../02-SetupDevEnvironment) بروید + +> **نکته حرفه‌ای**: اگر دستگاه شما مشخصات پایین دارد ولی می‌خواهید VS Code را محلی استفاده کنید، از GitHub Codespaces استفاده کنید! می‌توانید VS Code محلی خود را به Codespace میزبانی شده در ابر متصل کنید و از بهترین هر دو دنیا بهره‌مند شوید. + +Screenshot: created local devcontainer instance + +## مرحله ۲: ایجاد توکن دسترسی شخصی GitHub + +1. به [تنظیمات GitHub](https://github.com/settings/profile) بروید و از منوی پروفایل خود **Settings** را انتخاب کنید. +2. در نوار کناری سمت چپ، روی **Developer settings** کلیک کنید (معمولاً در پایین قرار دارد). +3. زیر بخش **Personal access tokens** روی **Fine-grained tokens** کلیک کنید (یا مستقیم این [لینک](https://github.com/settings/personal-access-tokens) را دنبال کنید). +4. روی **Generate new token** کلیک کنید. +5. در قسمت "Token name"، یک نام توصیفی وارد کنید (مثلاً `GenAI-Java-Course-Token`). +6. یک تاریخ انقضا تعیین کنید (توصیه می‌شود: ۷ روز برای رعایت بهترین شیوه‌های امنیتی). +7. در بخش "Resource owner"، حساب کاربری خود را انتخاب کنید. +8. در بخش "Repository access"، مخازنی که می‌خواهید با مدل‌های GitHub استفاده کنید انتخاب کنید (یا «تمام مخازن» اگر نیاز بود). +9. در بخش "Account permissions"، گزینه **Models** را پیدا کرده و آن را روی **فقط خواندنی** تنظیم کنید. +10. روی **Generate token** کلیک کنید. +11. **توکن خود را همین حالا کپی و ذخیره کنید** — دفعه بعد دیگر نمایش داده نخواهد شد! + +> **نکته امنیتی**: حداقل سطح دسترسی لازم و کوتاه‌ترین زمان انقضاء ممکن را برای توکن‌های دسترسی خود انتخاب کنید. + +## مرحله ۳: تست راه‌اندازی با نمونه مدل‌های GitHub + +پس از آماده شدن محیط توسعه، بیایید یکپارچگی مدل‌های GitHub را با برنامه نمونه در [`02-SetupDevEnvironment/examples/github-models`](../../../02-SetupDevEnvironment/examples/github-models) تست کنیم. + +1. ترمینال را در محیط توسعه خود باز کنید. +2. به مسیر نمونه مدل‌های GitHub بروید: + ```bash + cd 02-SetupDevEnvironment/examples/github-models + ``` + +3. توکن GitHub خود را به عنوان یک متغیر محیطی تنظیم کنید: + ```bash + # مک‌اواس/لینوکس + export GITHUB_TOKEN=your_token_here + + # ویندوز (خط فرمان) + set GITHUB_TOKEN=your_token_here + + # ویندوز (پاورشل) + $env:GITHUB_TOKEN="your_token_here" + ``` + +4. برنامه را اجرا کنید: + ```bash + mvn compile exec:java -Dexec.mainClass="com.example.githubmodels.App" + ``` + +خروجی مشابه زیر باید نمایش داده شود: +```text +Using model: gpt-4.1-nano +Sending request to GitHub Models... +Response: Hello World! +``` + +### درک کد نمونه + +ابتدا بیایید بفهمیم چه کاری انجام دادیم. نمونه در `examples/github-models` از OpenAI Java SDK برای اتصال به مدل‌های GitHub استفاده می‌کند: + +**این کد چه می‌کند:** +- **اتصال** به مدل‌های GitHub با استفاده از توکن دسترسی شخصی شما +- ارسال پیام ساده "سلام دنیا!" به مدل هوش مصنوعی +- دریافت و نمایش پاسخ هوش مصنوعی +- **اعتبارسنجی** اینکه راه‌اندازی شما به درستی کار می‌کند + +**وابستگی کلیدی** (در `pom.xml`): +```xml + + com.openai + openai-java + 2.12.0 + +``` + +**کد اصلی** (`App.java`): +```java +// اتصال به مدل‌های GitHub با استفاده از OpenAI Java SDK +OpenAIClient client = OpenAIOkHttpClient.builder() + .apiKey(pat) + .baseUrl("https://models.inference.ai.azure.com") + .build(); + +// ایجاد درخواست تکمیل چت +ChatCompletionCreateParams params = ChatCompletionCreateParams.builder() + .model(modelId) + .addSystemMessage("You are a concise assistant.") + .addUserMessage("Say Hello World!") + .build(); + +// دریافت پاسخ هوش مصنوعی +ChatCompletion response = client.chat().completions().create(params); +System.out.println("Response: " + response.choices().get(0).message().content().orElse("No response content")); +``` + +## خلاصه + +عالی است! حالا همه چیز را راه‌اندازی کرده‌اید: + +- توکن دسترسی شخصی GitHub با مجوزهای مناسب برای دسترسی به مدل‌های AI ساخته‌اید +- محیط توسعه جاوا خود را راه‌اندازی کرده‌اید (چه Codespaces، کانتینر توسعه یا راه‌اندازی محلی) +- به مدل‌های GitHub با استفاده از OpenAI Java SDK برای توسعه رایگان هوش مصنوعی متصل شده‌اید +- با نمونه ساده‌ای که با مدل‌های AI صحبت می‌کند، همه چیز را تست کرده‌اید + +## مراحل بعدی + +[فصل ۳: تکنیک‌های اصلی هوش مصنوعی مولد](../03-CoreGenerativeAITechniques/README.md) + +## عیب‌یابی + +مشکلی دارید؟ مسائل و راه‌حل‌های رایج: + +- **توکن کار نمی‌کند؟** + - مطمئن شوید کل توکن را بدون فاصله اضافی کپی کرده‌اید + - بررسی کنید که توکن به درستی به عنوان متغیر محیطی تنظیم شده است + - مطمئن شوید توکن مجوزهای درست دارد (Models: فقط خواندنی) + +- **Maven پیدا نمی‌شود؟** + - اگر از کانتینرهای توسعه یا Codespaces استفاده می‌کنید، Maven باید از قبل نصب شده باشد + - برای راه‌اندازی محلی، اطمینان حاصل کنید جاوا ۲۱ و Maven ۳.۹ نصب شده‌اند + - اجرای `mvn --version` برای بررسی نصب + +- **مشکل اتصال دارید؟** + - اتصال اینترنت خود را بررسی کنید + - اطمینان حاصل کنید GitHub از شبکه شما قابل دسترس است + - مطمئن شوید پشت فایروال نیستید که دسترسی به نقطه پایان مدل‌های GitHub را مسدود کرده باشد + +- **کانتینر توسعه راه نمی‌افتد؟** + - اطمینان حاصل کنید Docker Desktop (برای توسعه محلی) در حال اجرا است + - سعی کنید کانتینر را مجدداً بسازید: `Ctrl+Shift+P` → "Dev Containers: Rebuild Container" + +- **خطاهای کامپایل برنامه؟** + - مطمئن شوید در دایرکتوری درست هستید: `02-SetupDevEnvironment/examples/github-models` + - سعی کنید پاکسازی و ساخت مجدد کنید: `mvn clean compile` + +> **نیاز به کمک دارید؟**: هنوز مشکل دارید؟ یک issue در مخزن باز کنید و ما کمکتان خواهیم کرد. --- + +**سلب مسئولیت**: +این سند با استفاده از سرویس ترجمه هوش مصنوعی [Co-op Translator](https://github.com/Azure/co-op-translator) ترجمه شده است. در حالی که ما در تلاش برای دقت هستیم، لطفاً توجه داشته باشید که ترجمه‌های خودکار ممکن است دارای خطاها یا نادرستی‌هایی باشند. سند اصلی به زبان مادری‌اش باید به عنوان منبع معتبر در نظر گرفته شود. برای اطلاعات حیاتی، ترجمه حرفه‌ای انسانی توصیه می‌شود. ما مسئول هیچگونه سوء تفاهم یا تفسیر نادرست ناشی از استفاده از این ترجمه نیستیم. + \ No newline at end of file diff --git a/translations/fa/02-SetupDevEnvironment/examples/basic-chat-azure/README.md b/translations/fa/02-SetupDevEnvironment/examples/basic-chat-azure/README.md index 9569b2bb..b743d314 100644 --- a/translations/fa/02-SetupDevEnvironment/examples/basic-chat-azure/README.md +++ b/translations/fa/02-SetupDevEnvironment/examples/basic-chat-azure/README.md @@ -1,12 +1,3 @@ - # مثال کامل ارتباط ساده با Azure OpenAI این مثال نشان می‌دهد که چگونه یک برنامه ساده Spring Boot ایجاد کنید که به Azure OpenAI متصل شود و تنظیمات شما را آزمایش کند. diff --git a/translations/fa/02-SetupDevEnvironment/getting-started-azure-openai.md b/translations/fa/02-SetupDevEnvironment/getting-started-azure-openai.md index 8f0e7bd8..c3eeaed7 100644 --- a/translations/fa/02-SetupDevEnvironment/getting-started-azure-openai.md +++ b/translations/fa/02-SetupDevEnvironment/getting-started-azure-openai.md @@ -1,12 +1,3 @@ - # راه‌اندازی محیط توسعه برای Azure OpenAI > **شروع سریع**: این راهنما برای تنظیم Azure OpenAI است. برای شروع سریع با مدل‌های رایگان، از [مدل‌های GitHub با Codespaces](./README.md#quick-start-cloud) استفاده کنید. diff --git a/translations/fa/03-CoreGenerativeAITechniques/README.md b/translations/fa/03-CoreGenerativeAITechniques/README.md index bcf7459f..3e0d44ea 100644 --- a/translations/fa/03-CoreGenerativeAITechniques/README.md +++ b/translations/fa/03-CoreGenerativeAITechniques/README.md @@ -1,12 +1,3 @@ - # آموزش تکنیک‌های اصلی هوش مصنوعی مولد ## فهرست مطالب diff --git a/translations/fa/04-PracticalSamples/README.md b/translations/fa/04-PracticalSamples/README.md index 59799eee..dc34868d 100644 --- a/translations/fa/04-PracticalSamples/README.md +++ b/translations/fa/04-PracticalSamples/README.md @@ -1,12 +1,3 @@ - # کاربردها و پروژه‌های عملی ## آنچه خواهید آموخت diff --git a/translations/fa/04-PracticalSamples/calculator/README.md b/translations/fa/04-PracticalSamples/calculator/README.md index 4dd9e2a2..749de37c 100644 --- a/translations/fa/04-PracticalSamples/calculator/README.md +++ b/translations/fa/04-PracticalSamples/calculator/README.md @@ -1,12 +1,3 @@ - # آموزش ماشین حساب MCP برای مبتدیان ## فهرست مطالب diff --git a/translations/fa/04-PracticalSamples/foundrylocal/README.md b/translations/fa/04-PracticalSamples/foundrylocal/README.md index d2927bfb..8c01c7c5 100644 --- a/translations/fa/04-PracticalSamples/foundrylocal/README.md +++ b/translations/fa/04-PracticalSamples/foundrylocal/README.md @@ -1,12 +1,3 @@ - # آموزش Foundry Local Spring Boot ## فهرست مطالب diff --git a/translations/fa/04-PracticalSamples/petstory/README.md b/translations/fa/04-PracticalSamples/petstory/README.md index 3c4f704e..b37f4e87 100644 --- a/translations/fa/04-PracticalSamples/petstory/README.md +++ b/translations/fa/04-PracticalSamples/petstory/README.md @@ -1,12 +1,3 @@ - # آموزش تولید داستان حیوانات خانگی برای مبتدیان ## فهرست مطالب diff --git a/translations/fa/05-ResponsibleGenAI/README.md b/translations/fa/05-ResponsibleGenAI/README.md index b9a51be6..3a4dc8ad 100644 --- a/translations/fa/05-ResponsibleGenAI/README.md +++ b/translations/fa/05-ResponsibleGenAI/README.md @@ -1,12 +1,3 @@ - # هوش مصنوعی مولد مسئولانه ## آنچه خواهید آموخت diff --git a/translations/fa/AGENTS.md b/translations/fa/AGENTS.md index ff5cea97..7769ad52 100644 --- a/translations/fa/AGENTS.md +++ b/translations/fa/AGENTS.md @@ -1,12 +1,3 @@ - # AGENTS.md ## نمای کلی پروژه diff --git a/translations/fa/CODE_OF_CONDUCT.md b/translations/fa/CODE_OF_CONDUCT.md index 05eb50db..0a6f9fc1 100644 --- a/translations/fa/CODE_OF_CONDUCT.md +++ b/translations/fa/CODE_OF_CONDUCT.md @@ -1,12 +1,3 @@ - # منشور رفتاری کد متن‌باز مایکروسافت این پروژه منشور رفتاری کد متن‌باز مایکروسافت را پذیرفته است. [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/) diff --git a/translations/fa/README.md b/translations/fa/README.md index bebfb420..4b53a0b6 100644 --- a/translations/fa/README.md +++ b/translations/fa/README.md @@ -1,89 +1,81 @@ - # هوش مصنوعی مولد برای مبتدیان - نسخه جاوا [![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) ![هوش مصنوعی مولد برای مبتدیان - نسخه جاوا](../../translated_images/fa/beg-genai-series.8b48be9951cc574c.webp) -**مدت زمان مورد نیاز**: کل کارگاه را می‌توان به صورت آنلاین بدون نصب محلی انجام داد. راه‌اندازی محیط ۲ دقیقه زمان می‌برد و بررسی نمونه‌ها بین ۱ تا ۳ ساعت بسته به عمق کاوش نیاز دارد. +**زمان تعهد**: کل کارگاه را می‌توان به صورت آنلاین بدون راه‌اندازی محلی کامل کرد. راه‌اندازی محیط ۲ دقیقه طول می‌کشد، با کاوش نمونه‌ها که بسته به عمق کاوش ۱ تا ۳ ساعت زمان می‌برد. > **شروع سریع** -۱. این مخزن را به حساب GitHub خود فورک کنید -۲. روی **Code** کلیک کنید → تب **Codespaces** → **...** → **New with options...** -۳. تنظیمات پیش‌فرض را استفاده کنید – این باعث انتخاب کانتینر توسعه‌ای می‌شود که برای این دوره ساخته شده است -۴. روی **Create codespace** کلیک کنید -۵. حدود ۲ دقیقه منتظر بمانید تا محیط آماده شود -۶. مستقیم به [اولین مثال](./02-SetupDevEnvironment/README.md#step-2-create-a-github-personal-access-token) بروید +1. این مخزن را به حساب GitHub خود فورک کنید +2. روی **کد** → تب **Codespaces** → **...** → **New with options...** کلیک کنید +3. از تنظیمات پیش‌فرض استفاده کنید – این تنظیمات کانتینر توسعه‌ای است که برای این دوره ایجاد شده است +4. روی **Create codespace** کلیک کنید +5. حدود ۲ دقیقه صبر کنید تا محیط آماده شود +6. مستقیماً به [اولین مثال](./02-SetupDevEnvironment/README.md#step-2-create-a-github-personal-access-token) بروید -> **ترجیح می‌دهید به صورت محلی کلون کنید؟** -> -> این مخزن شامل بیش از ۵۰ ترجمه زبانی است که به طور قابل توجهی حجم دانلود را افزایش می‌دهد. برای کلون کردن بدون ترجمه‌ها، از sparse checkout استفاده کنید: +> **ترجیح می‌دهید به صورت محلی کلون کنید؟** +> +> این مخزن شامل بیش از ۵۰ ترجمه زبانی است که اندازه دانلود را به طور قابل توجهی افزایش می‌دهد. برای کلون بدون ترجمه‌ها، از sparse checkout استفاده کنید: > ```bash > git clone --filter=blob:none --sparse https://github.com/microsoft/Generative-AI-for-beginners-java.git > cd Generative-AI-for-beginners-java > git sparse-checkout set --no-cone '/*' '!translations' '!translated_images' > ``` -> این به شما همه چیز لازم برای تکمیل دوره را با دانلود بسیار سریع‌تر می‌دهد. +> این به شما هر چیزی را که برای تکمیل دوره نیاز دارید با دانلود بسیار سریع‌تر می‌دهد. + ## پشتیبانی چند زبانه -### پشتیبانی شده از طریق GitHub Action (خودکار و همیشه به‌روز) +### از طریق GitHub Action پشتیبانی می‌شود (خودکار و همیشه به‌روز) -[عربی](../ar/README.md) | [بنگالی](../bn/README.md) | [بلغاری](../bg/README.md) | [برمه‌ای (میانمار)](../my/README.md) | [چینی (ساده‌شده)](../zh/README.md) | [چینی (سنتی، هنگ‌کنگ)](../hk/README.md) | [چینی (سنتی، ماکائو)](../mo/README.md) | [چینی (سنتی، تایوان)](../tw/README.md) | [کرواتی](../hr/README.md) | [چکی](../cs/README.md) | [دانمارکی](../da/README.md) | [هلندی](../nl/README.md) | [استونیایی](../et/README.md) | [فنلاندی](../fi/README.md) | [فرانسوی](../fr/README.md) | [آلمانی](../de/README.md) | [یونانی](../el/README.md) | [عبری](../he/README.md) | [هندی](../hi/README.md) | [مجارستانی](../hu/README.md) | [اندونزیایی](../id/README.md) | [ایتالیایی](../it/README.md) | [ژاپنی](../ja/README.md) | [کانادا](../kn/README.md) | [کره‌ای](../ko/README.md) | [لیتوانیایی](../lt/README.md) | [مالایی](../ms/README.md) | [مالایالم](../ml/README.md) | [مراتی](../mr/README.md) | [نپالی](../ne/README.md) | [پیدجین نیجریه‌ای](../pcm/README.md) | [نروژی](../no/README.md) | [فارسی (Farsi)](./README.md) | [لهستانی](../pl/README.md) | [پرتغالی (برزیل)](../br/README.md) | [پرتغالی (پرتغال)](../pt/README.md) | [پنجابی (گورموخی)](../pa/README.md) | [رومانیایی](../ro/README.md) | [روسی](../ru/README.md) | [صربی (سیریلیک)](../sr/README.md) | [اسلواکی](../sk/README.md) | [اسلونیایی](../sl/README.md) | [اسپانیایی](../es/README.md) | [سواحلی](../sw/README.md) | [سوئدی](../sv/README.md) | [تاگالوگ (فیلیپینی)](../tl/README.md) | [تامیل](../ta/README.md) | [تلوگو](../te/README.md) | [تایلندی](../th/README.md) | [ترکی](../tr/README.md) | [اوکراینی](../uk/README.md) | [اردو](../ur/README.md) | [ویتنامی](../vi/README.md) +[عربی](../ar/README.md) | [بنگالی](../bn/README.md) | [بلغاری](../bg/README.md) | [برمه‌ای (میانمار)](../my/README.md) | [چینی (ساده‌شده)](../zh-CN/README.md) | [چینی (سنتی، هنگ‌کنگ)](../zh-HK/README.md) | [چینی (سنتی، ماکائو)](../zh-MO/README.md) | [چینی (سنتی، تایوان)](../zh-TW/README.md) | [کرواسیایی](../hr/README.md) | [چکی](../cs/README.md) | [دانمارکی](../da/README.md) | [هلندی](../nl/README.md) | [استونیایی](../et/README.md) | [فنلاندی](../fi/README.md) | [فرانسوی](../fr/README.md) | [آلمانی](../de/README.md) | [یونانی](../el/README.md) | [عبری](../he/README.md) | [هندی](../hi/README.md) | [مجارستانی](../hu/README.md) | [اندونزیایی](../id/README.md) | [ایتالیایی](../it/README.md) | [ژاپنی](../ja/README.md) | [کانادا](../kn/README.md) | [کره‌ای](../ko/README.md) | [لیتوانیایی](../lt/README.md) | [مالایی](../ms/README.md) | [مالایالام](../ml/README.md) | [مراتی](../mr/README.md) | [نپالی](../ne/README.md) | [پیدجین نیجریه‌ای](../pcm/README.md) | [نروژی](../no/README.md) | [فارسی](./README.md) | [لهستانی](../pl/README.md) | [پرتغالی (برزیل)](../pt-BR/README.md) | [پرتغالی (پرتغال)](../pt-PT/README.md) | [پنجابی (گورمخی)](../pa/README.md) | [رومانیایی](../ro/README.md) | [روسی](../ru/README.md) | [صربی (سیریلیک)](../sr/README.md) | [اسلواکی](../sk/README.md) | [اسلوونیایی](../sl/README.md) | [اسپانیایی](../es/README.md) | [سواحیلی](../sw/README.md) | [سوئدی](../sv/README.md) | [تاگالوگ (فیلیپینی)](../tl/README.md) | [تامیلی](../ta/README.md) | [تلوگو](../te/README.md) | [تایلندی](../th/README.md) | [ترکی](../tr/README.md) | [اوکراینی](../uk/README.md) | [اردو](../ur/README.md) | [ویتنامی](../vi/README.md) > **ترجیح می‌دهید به صورت محلی کلون کنید؟** -> این مخزن شامل بیش از ۵۰ ترجمه زبانی است که به طور قابل توجهی حجم دانلود را افزایش می‌دهد. برای کلون کردن بدون ترجمه‌ها، از sparse checkout استفاده کنید: +> این مخزن شامل بیش از ۵۰ ترجمه زبانی است که اندازه دانلود را به طور قابل توجهی افزایش می‌دهد. برای کلون بدون ترجمه‌ها، از sparse checkout استفاده کنید: > ```bash > git clone --filter=blob:none --sparse https://github.com/microsoft/Generative-AI-for-beginners-java.git > cd Generative-AI-for-beginners-java > git sparse-checkout set --no-cone '/*' '!translations' '!translated_images' > ``` -> این به شما همه چیز لازم برای تکمیل دوره را با دانلود بسیار سریع‌تر می‌دهد. +> این به شما هر چیزی را که برای تکمیل دوره نیاز دارید با دانلود بسیار سریع‌تر می‌دهد. ## ساختار دوره و مسیر یادگیری -### **فصل ۱: مقدمه‌ای بر هوش مصنوعی مولد** -- **مفاهیم اصلی**: درک مدل‌های زبان بزرگ، توکن‌ها، تعبیه‌ها و قابلیت‌های هوش مصنوعی -- **اکوسیستم هوش مصنوعی جاوا**: مرور کلی Spring AI و SDKهای OpenAI -- **پروتکل متن مدل (MCP)**: معرفی MCP و نقش آن در ارتباط عامل‌های هوش مصنوعی -- **کاربردهای عملی**: سناریوهای دنیای واقعی شامل چت‌بات‌ها و تولید محتوا +### **فصل ۱: معرفی هوش مصنوعی مولد** +- **مفاهیم اصلی**: درک مدل‌های زبان بزرگ، توکن‌ها، امبدینگ‌ها و قابلیت‌های هوش مصنوعی +- **اکوسیستم هوش مصنوعی جاوا**: مرور بر Spring AI و SDKهای OpenAI +- **پروتکل زمینه مدل**: معرفی MCP و نقش آن در ارتباط عوامل هوش مصنوعی +- **کاربردهای عملی**: سناریوهای واقعی مانند چت‌بات‌ها و تولید محتوا - **[→ شروع فصل ۱](./01-IntroToGenAI/README.md)** ### **فصل ۲: راه‌اندازی محیط توسعه** -- **پیکربندی چند ارائه‌دهنده**: راه‌اندازی مدل‌های GitHub، Azure OpenAI و یکپارچه‌سازی‌های SDK جاوا OpenAI -- **Spring Boot + Spring AI**: بهترین شیوه‌ها برای توسعه برنامه‌های سازمانی هوش مصنوعی -- **مدل‌های GitHub**: دسترسی رایگان به مدل هوش مصنوعی برای نمونه‌سازی و یادگیری (نیاز به کارت اعتباری نیست) -- **ابزارهای توسعه**: کانتینرهای داکر، VS Code و پیکربندی GitHub Codespaces +- **پیکربندی چند ارائه‌دهنده**: راه‌اندازی GitHub Models، Azure OpenAI و یکپارچه‌سازی SDK جاوای OpenAI +- **Spring Boot + Spring AI**: بهترین روش‌ها برای توسعه برنامه‌های سازمانی هوش مصنوعی +- **مدل‌های GitHub**: دسترسی رایگان به مدل‌های هوش مصنوعی برای نمونه‌سازی و یادگیری (بدون نیاز به کارت اعتباری) +- **ابزارهای توسعه**: کانتینرهای Docker، VS Code و پیکربندی GitHub Codespaces - **[→ شروع فصل ۲](./02-SetupDevEnvironment/README.md)** ### **فصل ۳: تکنیک‌های اصلی هوش مصنوعی مولد** -- **مهندسی درخواست**: تکنیک‌هایی برای پاسخ‌های بهینه مدل هوش مصنوعی -- **تعبیه‌ها و عملیات برداری**: پیاده‌سازی جستجوی معنایی و تطبیق شباهت -- **تولید تقویت‌شده بازیابی (RAG)**: ترکیب هوش مصنوعی با منابع داده خودتان -- **تماس با توابع**: گسترش قابلیت‌های هوش مصنوعی با ابزارها و پلاگین‌های سفارشی +- **مهندسی پرامپت**: تکنیک‌هایی برای پاسخ‌های بهینه مدل هوش مصنوعی +- **امبدینگ‌ها و عملیات برداری**: پیاده‌سازی جستجوی معنایی و تطبیق شباهت +- **تولید تقویت‌شده با بازیابی (RAG)**: ترکیب هوش مصنوعی با منابع داده خودتان +- **فراخوانی تابع**: گسترش قابلیت‌های هوش مصنوعی با ابزارها و افزونه‌های سفارشی - **[→ شروع فصل ۳](./03-CoreGenerativeAITechniques/README.md)** -### **فصل ۴: کاربردهای عملی و پروژه‌ها** -- **مولد داستان حیوانات خانگی** (`petstory/`): تولید محتوای خلاقانه با مدل‌های GitHub -- **دموی محلی Foundry** (`foundrylocal/`): یکپارچه‌سازی مدل هوش مصنوعی محلی با SDK جاوا OpenAI -- **خدمات محاسبه MCP** (`calculator/`): پیاده‌سازی پایه پروتکل متن مدل با Spring AI +### **فصل ۴: کاربردها و پروژه‌های عملی** +- **تولید داستان حیوان خانگی** (`petstory/`): تولید محتوای خلاقانه با GitHub Models +- **دموی محلی Foundry** (`foundrylocal/`): ادغام مدل هوش مصنوعی محلی با SDK جاوای OpenAI +- **سرویس ماشین‌حساب MCP** (`calculator/`): پیاده‌سازی پایه پروتکل زمینه مدل با Spring AI - **[→ شروع فصل ۴](./04-PracticalSamples/README.md)** ### **فصل ۵: توسعه مسئولانه هوش مصنوعی** -- **ایمنی مدل‌های GitHub**: آزمایش فیلترینگ محتوا و مکانیسم‌های ایمنی داخلی (مسدودسازی سخت و رد نرم) -- **دموی هوش مصنوعی مسئولانه**: نمونه عملی نحوه عملکرد سیستم‌های ایمنی مدرن هوش مصنوعی -- **بهترین شیوه‌ها**: دستورالعمل‌های ضروری برای توسعه و استقرار اخلاقی هوش مصنوعی +- **ایمنی مدل‌های GitHub**: آزمایش فیلترینگ محتوا و مکانیزم‌های ایمنی داخلی (مسدودهای سخت و ردهای نرم) +- **دموی هوش مصنوعی مسئولانه**: مثال عملی نشان‌دهنده عملکرد سیستم‌های ایمنی هوش مصنوعی مدرن +- **بهترین روش‌ها**: دستورالعمل‌های ضروری برای توسعه و به‌کارگیری اخلاقی هوش مصنوعی - **[→ شروع فصل ۵](./05-ResponsibleGenAI/README.md)** ## منابع اضافی @@ -99,7 +91,7 @@ CO_OP_TRANSLATOR_METADATA: [![AZD برای مبتدیان](https://img.shields.io/badge/AZD%20for%20Beginners-0078D4?style=for-the-badge&labelColor=E5E7EB&color=0078D4)](https://github.com/microsoft/AZD-for-beginners?WT.mc_id=academic-105485-koreyst) [![Edge AI برای مبتدیان](https://img.shields.io/badge/Edge%20AI%20for%20Beginners-00B8E4?style=for-the-badge&labelColor=E5E7EB&color=00B8E4)](https://github.com/microsoft/edgeai-for-beginners?WT.mc_id=academic-105485-koreyst) [![MCP برای مبتدیان](https://img.shields.io/badge/MCP%20for%20Beginners-009688?style=for-the-badge&labelColor=E5E7EB&color=009688)](https://github.com/microsoft/mcp-for-beginners?WT.mc_id=academic-105485-koreyst) -[![عامل‌های هوش مصنوعی برای مبتدیان](https://img.shields.io/badge/AI%20Agents%20for%20Beginners-00C49A?style=for-the-badge&labelColor=E5E7EB&color=00C49A)](https://github.com/microsoft/ai-agents-for-beginners?WT.mc_id=academic-105485-koreyst) +[![عوامل هوش مصنوعی برای مبتدیان](https://img.shields.io/badge/AI%20Agents%20for%20Beginners-00C49A?style=for-the-badge&labelColor=E5E7EB&color=00C49A)](https://github.com/microsoft/ai-agents-for-beginners?WT.mc_id=academic-105485-koreyst) --- @@ -111,30 +103,31 @@ CO_OP_TRANSLATOR_METADATA: --- -### یادگیری پایه +### یادگیری اصلی [![یادگیری ماشین برای مبتدیان](https://img.shields.io/badge/ML%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=22C55E)](https://aka.ms/ml-beginners?WT.mc_id=academic-105485-koreyst) [![علم داده برای مبتدیان](https://img.shields.io/badge/Data%20Science%20for%20Beginners-84CC16?style=for-the-badge&labelColor=E5E7EB&color=84CC16)](https://aka.ms/datascience-beginners?WT.mc_id=academic-105485-koreyst) [![هوش مصنوعی برای مبتدیان](https://img.shields.io/badge/AI%20for%20Beginners-A3E635?style=for-the-badge&labelColor=E5E7EB&color=A3E635)](https://aka.ms/ai-beginners?WT.mc_id=academic-105485-koreyst) [![امنیت سایبری برای مبتدیان](https://img.shields.io/badge/Cybersecurity%20for%20Beginners-F97316?style=for-the-badge&labelColor=E5E7EB&color=F97316)](https://github.com/microsoft/Security-101?WT.mc_id=academic-96948-sayoung) + [![توسعه وب برای مبتدیان](https://img.shields.io/badge/Web%20Dev%20for%20Beginners-EC4899?style=for-the-badge&labelColor=E5E7EB&color=EC4899)](https://aka.ms/webdev-beginners?WT.mc_id=academic-105485-koreyst) -[![IoT for Beginners](https://img.shields.io/badge/IoT%20for%20Beginners-14B8A6?style=for-the-badge&labelColor=E5E7EB&color=14B8A6)](https://aka.ms/iot-beginners?WT.mc_id=academic-105485-koreyst) -[![XR Development for Beginners](https://img.shields.io/badge/XR%20Development%20for%20Beginners-38BDF8?style=for-the-badge&labelColor=E5E7EB&color=38BDF8)](https://github.com/microsoft/xr-development-for-beginners?WT.mc_id=academic-105485-koreyst) +[![اینترنت اشیا برای مبتدیان](https://img.shields.io/badge/IoT%20for%20Beginners-14B8A6?style=for-the-badge&labelColor=E5E7EB&color=14B8A6)](https://aka.ms/iot-beginners?WT.mc_id=academic-105485-koreyst) +[![توسعه XR برای مبتدیان](https://img.shields.io/badge/XR%20Development%20for%20Beginners-38BDF8?style=for-the-badge&labelColor=E5E7EB&color=38BDF8)](https://github.com/microsoft/xr-development-for-beginners?WT.mc_id=academic-105485-koreyst) --- - -### سری آموزش کوپایلوت -[![Copilot for AI Paired Programming](https://img.shields.io/badge/Copilot%20for%20AI%20Paired%20Programming-FACC15?style=for-the-badge&labelColor=E5E7EB&color=FACC15)](https://aka.ms/GitHubCopilotAI?WT.mc_id=academic-105485-koreyst) -[![Copilot for C#/.NET](https://img.shields.io/badge/Copilot%20for%20C%23/.NET-FBBF24?style=for-the-badge&labelColor=E5E7EB&color=FBBF24)](https://github.com/microsoft/mastering-github-copilot-for-dotnet-csharp-developers?WT.mc_id=academic-105485-koreyst) -[![Copilot Adventure](https://img.shields.io/badge/Copilot%20Adventure-FDE68A?style=for-the-badge&labelColor=E5E7EB&color=FDE68A)](https://github.com/microsoft/CopilotAdventures?WT.mc_id=academic-105485-koreyst) + +### سری کوپایلوت +[![کوپایلوت برای برنامه‌نویسی جفتی هوش مصنوعی](https://img.shields.io/badge/Copilot%20for%20AI%20Paired%20Programming-FACC15?style=for-the-badge&labelColor=E5E7EB&color=FACC15)](https://aka.ms/GitHubCopilotAI?WT.mc_id=academic-105485-koreyst) +[![کوپایلوت برای C#/.NET](https://img.shields.io/badge/Copilot%20for%20C%23/.NET-FBBF24?style=for-the-badge&labelColor=E5E7EB&color=FBBF24)](https://github.com/microsoft/mastering-github-copilot-for-dotnet-csharp-developers?WT.mc_id=academic-105485-koreyst) +[![ماجراجویی کوپایلوت](https://img.shields.io/badge/Copilot%20Adventure-FDE68A?style=for-the-badge&labelColor=E5E7EB&color=FDE68A)](https://github.com/microsoft/CopilotAdventures?WT.mc_id=academic-105485-koreyst) ## دریافت کمک -اگر در ساخت برنامه‌های هوش مصنوعی به مشکل برخوردید یا سوالی داشتید، به همراه سایر یادگیرندگان و توسعه‌دهندگان مجرب در بحث‌های مربوط به MCP شرکت کنید. این یک جامعه حمایتی است که در آن سوالات پذیرفته می‌شوند و دانش به‌صورت آزادانه به اشتراک گذاشته می‌شود. +اگر گیر کردید یا سوالی درباره ساخت اپلیکیشن‌های هوش مصنوعی دارید. به همراه یادگیرندگان و توسعه‌دهندگان باتجربه در بحث‌های MCP بپیوندید. این یک جامعه حمایتی است که سوالات پذیرفته می‌شود و دانش آزادانه به اشتراک گذاشته می‌شود. -[![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) +[![دیسکورد Microsoft Foundry](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) -اگر بازخورد محصول دارید یا هنگام ساخت با خطا مواجه شدید، به اینجا مراجعه کنید: +اگر بازخورد محصول یا خطایی هنگام توسعه داشتید به اینجا مراجعه کنید: [![Microsoft Foundry Developer Forum](https://img.shields.io/badge/GitHub-Microsoft_Foundry_Developer_Forum-blue?style=for-the-badge&logo=github&color=000000&logoColor=fff)](https://aka.ms/foundry/forum) @@ -142,5 +135,5 @@ CO_OP_TRANSLATOR_METADATA: **سلب مسئولیت**: -این سند با استفاده از سرویس ترجمه ماشینی هوش مصنوعی [Co-op Translator](https://github.com/Azure/co-op-translator) ترجمه شده است. با اینکه ما تلاش می‌کنیم دقت بالایی داشته باشیم، لطفاً توجه داشته باشید که ترجمه‌های خودکار ممکن است شامل خطاها یا نواقصی باشند. سند اصلی به زبان بومی خود به عنوان منبع معتبر در نظر گرفته شود. برای اطلاعات حیاتی، استفاده از ترجمه حرفه‌ای انسانی توصیه می‌شود. ما مسئول هیچ گونه سوءتفاهم یا برداشت نادرست ناشی از استفاده از این ترجمه نیستیم. +این سند با استفاده از خدمات ترجمه هوش مصنوعی [Co-op Translator](https://github.com/Azure/co-op-translator) ترجمه شده است. در حالی که ما در پی دقت هستیم، لطفاً توجه داشته باشید که ترجمه‌های خودکار ممکن است حاوی اشتباهات یا نواقصی باشند. سند اصلی به زبان مادری خود باید به عنوان منبع معتبر در نظر گرفته شود. برای اطلاعات حساس، ترجمه حرفه‌ای انسانی توصیه می‌شود. ما مسئول هرگونه سوء تفاهم یا تفسیر نادرست ناشی از استفاده از این ترجمه نمی‌باشیم. \ No newline at end of file diff --git a/translations/fa/SECURITY.md b/translations/fa/SECURITY.md index 8962ef86..b61434e8 100644 --- a/translations/fa/SECURITY.md +++ b/translations/fa/SECURITY.md @@ -1,12 +1,3 @@ - ## امنیت مایکروسافت امنیت محصولات و خدمات نرم‌افزاری خود را جدی می‌گیرد، که شامل تمامی مخازن کد منبع مدیریت‌شده از طریق سازمان‌های GitHub ما می‌شود، از جمله [Microsoft](https://github.com/Microsoft)، [Azure](https://github.com/Azure)، [DotNet](https://github.com/dotnet)، [AspNet](https://github.com/aspnet) و [Xamarin](https://github.com/xamarin). diff --git a/translations/fa/SUPPORT.md b/translations/fa/SUPPORT.md index e0b09472..9fc198b0 100644 --- a/translations/fa/SUPPORT.md +++ b/translations/fa/SUPPORT.md @@ -1,12 +1,3 @@ - # پشتیبانی ## نحوه ثبت مشکلات و دریافت کمک diff --git a/translations/fi/.co-op-translator.json b/translations/fi/.co-op-translator.json new file mode 100644 index 00000000..278da8f6 --- /dev/null +++ b/translations/fi/.co-op-translator.json @@ -0,0 +1,92 @@ +{ + "01-IntroToGenAI/README.md": { + "original_hash": "75bfb080ca725e8a9aa9c80cae25fba1", + "translation_date": "2025-07-29T09:33:20+00:00", + "source_file": "01-IntroToGenAI/README.md", + "language_code": "fi" + }, + "02-SetupDevEnvironment/README.md": { + "original_hash": "96a30d42b9751a3d4e4b20e28d29d459", + "translation_date": "2026-01-28T05:05:54+00:00", + "source_file": "02-SetupDevEnvironment/README.md", + "language_code": "fi" + }, + "02-SetupDevEnvironment/examples/basic-chat-azure/README.md": { + "original_hash": "efd82efe50711d7e257eb943151d682c", + "translation_date": "2025-07-27T13:43:04+00:00", + "source_file": "02-SetupDevEnvironment/examples/basic-chat-azure/README.md", + "language_code": "fi" + }, + "02-SetupDevEnvironment/getting-started-azure-openai.md": { + "original_hash": "bfdb4b4eadbee3a59ef742439f58326a", + "translation_date": "2025-07-27T13:15:22+00:00", + "source_file": "02-SetupDevEnvironment/getting-started-azure-openai.md", + "language_code": "fi" + }, + "03-CoreGenerativeAITechniques/README.md": { + "original_hash": "685f55cb07de19b52a30ce6e8b6d889e", + "translation_date": "2025-08-28T22:09:16+00:00", + "source_file": "03-CoreGenerativeAITechniques/README.md", + "language_code": "fi" + }, + "04-PracticalSamples/README.md": { + "original_hash": "14c0a61ecc1cd2012a9c129236dfdf71", + "translation_date": "2025-07-29T09:33:04+00:00", + "source_file": "04-PracticalSamples/README.md", + "language_code": "fi" + }, + "04-PracticalSamples/calculator/README.md": { + "original_hash": "b6c16b5514d524e415a94f6097ee7d4c", + "translation_date": "2025-09-18T15:35:10+00:00", + "source_file": "04-PracticalSamples/calculator/README.md", + "language_code": "fi" + }, + "04-PracticalSamples/foundrylocal/README.md": { + "original_hash": "f787307400de59adc25a1404466a35f3", + "translation_date": "2025-11-04T07:27:38+00:00", + "source_file": "04-PracticalSamples/foundrylocal/README.md", + "language_code": "fi" + }, + "04-PracticalSamples/petstory/README.md": { + "original_hash": "0cbf68d605615a1e602c832a24616859", + "translation_date": "2025-07-25T11:35:49+00:00", + "source_file": "04-PracticalSamples/petstory/README.md", + "language_code": "fi" + }, + "05-ResponsibleGenAI/README.md": { + "original_hash": "301c05c2f57e60a6950b8c665b8bdbba", + "translation_date": "2025-07-29T15:53:27+00:00", + "source_file": "05-ResponsibleGenAI/README.md", + "language_code": "fi" + }, + "AGENTS.md": { + "original_hash": "afc90918d008cf77fd1982691f681306", + "translation_date": "2025-10-03T08:38:19+00:00", + "source_file": "AGENTS.md", + "language_code": "fi" + }, + "CODE_OF_CONDUCT.md": { + "original_hash": "442b123d034f92f7c384d2bbd28f99f1", + "translation_date": "2025-07-21T19:08:32+00:00", + "source_file": "CODE_OF_CONDUCT.md", + "language_code": "fi" + }, + "README.md": { + "original_hash": "125a08948d881c95628094f4dd1fbd43", + "translation_date": "2026-01-29T15:54:36+00:00", + "source_file": "README.md", + "language_code": "fi" + }, + "SECURITY.md": { + "original_hash": "57f14126c1c6add76b3aef3844dfe4e3", + "translation_date": "2025-07-21T19:06:37+00:00", + "source_file": "SECURITY.md", + "language_code": "fi" + }, + "SUPPORT.md": { + "original_hash": "b8ef73cc49dec68e2c885ee9df545129", + "translation_date": "2025-07-21T19:09:41+00:00", + "source_file": "SUPPORT.md", + "language_code": "fi" + } +} \ No newline at end of file diff --git a/translations/fi/01-IntroToGenAI/README.md b/translations/fi/01-IntroToGenAI/README.md index 784e8b40..be17541a 100644 --- a/translations/fi/01-IntroToGenAI/README.md +++ b/translations/fi/01-IntroToGenAI/README.md @@ -1,12 +1,3 @@ - # Johdanto generatiiviseen tekoälyyn - Java Edition ## Mitä opit diff --git a/translations/fi/02-SetupDevEnvironment/README.md b/translations/fi/02-SetupDevEnvironment/README.md index 66697521..b28fce86 100644 --- a/translations/fi/02-SetupDevEnvironment/README.md +++ b/translations/fi/02-SetupDevEnvironment/README.md @@ -1,13 +1,251 @@ - +# Kehitysympäristön asentaminen Generative AI:ta varten Javassa +> **Pika-aloitus**: Koodaa pilvessä 2 minuutissa – siirry kohtaan [GitHub Codespaces -asennus](../../../02-SetupDevEnvironment) – ei tarvitse paikallista asennusta ja käyttää GitHub-malleja! + +> **Kiinnostaako Azure OpenAI?**, katso [Azure OpenAI -asennusopas](getting-started-azure-openai.md) uusien Azure OpenAI -resurssien luomiseen. + +## Mitä opit + +- Miten asennat Java-kehitysympäristön tekoälysovelluksia varten +- Kuinka valitset ja konfiguroit haluamasi kehitysympäristön (pilvipainotteinen Codespaces, paikallinen dev container tai täydellinen paikallinen asennus) +- Testaat asennuksesi yhdistämällä GitHub-malleihin + +## Sisällysluettelo + +- [Mitä opit](../../../02-SetupDevEnvironment) +- [Johdanto](../../../02-SetupDevEnvironment) +- [Vaihe 1: Kehitysympäristön asentaminen](../../../02-SetupDevEnvironment) + - [Vaihtoehto A: GitHub Codespaces (suositus)](../../../02-SetupDevEnvironment) + - [Vaihtoehto B: Paikallinen dev container](../../../02-SetupDevEnvironment) + - [Vaihtoehto C: Käytä olemassa olevaa paikallista asennustasi](../../../02-SetupDevEnvironment) +- [Vaihe 2: GitHub-henkilökohtaisten käyttöoikeustunnusten luominen](../../../02-SetupDevEnvironment) +- [Vaihe 3: Asennuksen testaaminen](../../../02-SetupDevEnvironment) +- [Vianetsintä](../../../02-SetupDevEnvironment) +- [Yhteenveto](../../../02-SetupDevEnvironment) +- [Seuraavat askeleet](../../../02-SetupDevEnvironment) + +## Johdanto + +Tässä luvussa opastamme sinut läpi kehitysympäristön asentamisen. Käytämme pääesimerkkinä **GitHub-malleja**, koska ne ovat ilmaisia, helppoja ottaa käyttöön pelkällä GitHub-tilillä, eivät vaadi luottokorttia ja tarjoavat useita malleja kokeiltavaksi. + +**Paikallista asennusta ei tarvita!** Voit aloittaa koodaamisen heti GitHub Codespacesin avulla, joka antaa täyden kehitysympäristön selaimessasi. + +Näyttökuva: GitHub Models + +Suosittelemme tämän kurssin käyttämistä yhdessä [**GitHub Models**](https://github.com/marketplace?type=models) kanssa, koska se on: +- **Ilmainen** aloittaa +- **Helppo** ottaa käyttöön pelkällä GitHub-tilillä +- **Ei luottokorttia** vaadita +- **Useita malleja** kokeiltavaksi + +> **Huom:** Tässä koulutuksessa käytetyillä GitHub-malleilla on seuraavat ilmaiset rajoitukset: +> - 15 pyyntöä minuutissa (150 päivässä) +> - n. 8 000 sanaa sisään ja n. 4 000 sanaa ulos per pyyntö +> - 5 samanaikaista pyyntöä +> +> Tuotantokäyttöön suosittelemme päivitystä Azure AI Foundry -malleihin Azure-tililläsi. Koodiasi ei tarvitse muuttaa. Katso [Azure AI Foundry -dokumentaatio](https://learn.microsoft.com/azure/ai-foundry/foundry-models/how-to/quickstart-github-models). + +## Vaihe 1: Kehitysympäristön asentaminen + + + +Olemme luoneet valmiiksi määritellyn kehityskontainerin, jotta asennusaika minimoidaan ja sinulla on kaikki tarvittavat työkalut Generative AI Java -kurssia varten. Valitse haluamasi kehitystapa: + +### Kehitysympäristön asennusvaihtoehdot: + +#### Vaihtoehto A: GitHub Codespaces (suositus) + +**Aloita koodaaminen 2 minuutissa – paikallista asennusta ei tarvita!** + +1. Forkkaa tämä repositorio omaan GitHub-tiliisi + > **Huom:** Jos haluat muokata peruskonfiguraatiota, katso [Dev Container Configuration](../../../.devcontainer/devcontainer.json) +2. Klikkaa **Code** → **Codespaces** -välilehti → **...** → **New with options...** +3. Käytä oletusasetuksia – tämä valitsee **Dev container configuration**: **Generative AI Java Development Environment** -erikoiskehityskontainerin tälle kurssille +4. Klikkaa **Create codespace** +5. Odota noin 2 minuuttia, että ympäristö on valmis +6. Jatka kohtaan [Vaihe 2: Luo GitHub-tunnus](../../../02-SetupDevEnvironment) + +Näyttökuva: Codespaces alakohdasta + +Näyttökuva: Uusi valintojen kanssa + +Näyttökuva: Codespace luomisen valinnat + +> **Codespacesin edut**: +> - Ei tarvitse paikallista asennusta +> - Toimii millä tahansa laitteella, jossa on selain +> - Esikonfiguroitu kaikilla työkaluilla ja riippuvuuksilla +> - Henkilökohtaisille tileille ilmainen 60 tuntia kuukaudessa +> - Tasalaatuinen ympäristö kaikille oppijoille + +#### Vaihtoehto B: Paikallinen dev container + +**Kehittäjille, jotka haluavat paikallista Docker-kehitystä** + +1. Forkkaa ja kloonaa tämä repositorio paikalliselle koneellesi + > **Huom:** Jos haluat muokata peruskonfiguraatiota, katso [Dev Container Configuration](../../../.devcontainer/devcontainer.json) +2. Asenna [Docker Desktop](https://www.docker.com/products/docker-desktop/) ja [VS Code](https://code.visualstudio.com/) +3. Asenna [Dev Containers -laajennus](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers) VS Codeen +4. Avaa repositoriokansio VS Codessa +5. Kun saat kehotteen, klikkaa **Reopen in Container** (tai käytä `Ctrl+Shift+P` → "Dev Containers: Reopen in Container") +6. Odota, että kontaineri rakentuu ja käynnistyy +7. Jatka kohtaan [Vaihe 2: Luo GitHub-tunnus](../../../02-SetupDevEnvironment) + +Näyttökuva: Dev containerin asennus + +Näyttökuva: Dev container -rakennus valmis + +#### Vaihtoehto C: Käytä olemassa olevaa paikallista asennustasi + +**Kehittäjille, joilla on jo Java-ympäristö asennettuna** + +Esivaatimukset: +- [Java 21+](https://www.oracle.com/java/technologies/javase/jdk21-archive-downloads.html) +- [Maven 3.9+](https://maven.apache.org/download.cgi) +- [VS Code](https://code.visualstudio.com) tai haluamasi IDE + +Vaiheet: +1. Kloonaa tämä repositorio paikalliselle koneellesi +2. Avaa projekti IDE:ssäsi +3. Jatka kohtaan [Vaihe 2: Luo GitHub-tunnus](../../../02-SetupDevEnvironment) + +> **Vinkki ammattilaisille**: Jos sinulla on heikkotehoinen kone, mutta haluat VS Coden paikallisesti, käytä GitHub Codespacesia! Voit yhdistää paikallisen VS Codesi pilvipohjaiseen Codespaceen ja saada molempien parhaat puolet. + +Näyttökuva: luotu paikallinen devcontainer-instanssi + +## Vaihe 2: Luo GitHub-henkilökohtainen käyttöoikeustunnus + +1. Mene osoitteeseen [GitHub Asetukset](https://github.com/settings/profile) ja valitse profiilivalikosta **Settings**. +2. Vasemmassa sivupalkissa klikkaa **Developer settings** (yleensä alhaalla). +3. Valitse **Personal access tokens** → **Fine-grained tokens** (tai käytä suoraa [linkkiä](https://github.com/settings/personal-access-tokens)). +4. Klikkaa **Generate new token**. +5. Kirjoita "Token name" -kohtaan kuvaava nimi (esim. `GenAI-Java-Course-Token`). +6. Aseta vanhentumispäivä (suositus: 7 päivää turvallisuuden vuoksi). +7. Valitse "Resource owner":ksi oma käyttäjätilisi. +8. Valitse "Repository access" -kohdasta repositoriot, joita haluat käyttää GitHub-mallien kanssa (tai "All repositories", jos tarpeen). +9. Käy "Account permissions" -kohdassa läpi ja etsi **Models**, aseta se **Read-onlyksi**. +10. Klikkaa **Generate token**. +11. **Kopioi ja tallenna token heti** – et näe sitä enää uudestaan! + +> **Turvallisuusvinkki**: Käytä vain välttämättömät käyttöoikeudet ja lyhyintä mahdollisuutta voimassaoloaikaa. + +## Vaihe 3: Testaa asennus GitHub Models -esimerkillä + +Kun kehitysympäristö on valmis, testataan GitHub-mallien yhdistäminen esimerkkisovelluksella kansiossa [`02-SetupDevEnvironment/examples/github-models`](../../../02-SetupDevEnvironment/examples/github-models). + +1. Avaa terminaali kehitysympäristössäsi. +2. Siirry GitHub Models -esimerkkikansioon: + ```bash + cd 02-SetupDevEnvironment/examples/github-models + ``` +3. Aseta GitHub-tunnuksesi ympäristömuuttujaksi: + ```bash + # macOS/Linux + export GITHUB_TOKEN=your_token_here + + # Windows (Komentokehote) + set GITHUB_TOKEN=your_token_here + + # Windows (PowerShell) + $env:GITHUB_TOKEN="your_token_here" + ``` + +4. Käynnistä sovellus: + ```bash + mvn compile exec:java -Dexec.mainClass="com.example.githubmodels.App" + ``` + +Sinun pitäisi nähdä tuloste, joka muistuttaa tätä: +```text +Using model: gpt-4.1-nano +Sending request to GitHub Models... +Response: Hello World! +``` + +### Ymmärrä esimerkkikoodi + +Katsotaan ensin mitä ajoimme. `examples/github-models` -kansiossa oleva esimerkki käyttää OpenAI Java SDK:ta yhdistääkseen GitHub-malleihin: + +**Mitkä asiat tämä koodi tekee:** +- **Yhdistää** GitHub-malleihin henkilökohtaisen käyttöoikeustunnuksesi avulla +- **Lähettää** yksinkertaisen "Say Hello World!" -viestin AI-mallille +- **Vastaanottaa** ja näyttää AI:n vastauksen +- **Varmistaa**, että asennuksesi toimii oikein + +**Tärkeä riippuvuus** (tiedostossa `pom.xml`): +```xml + + com.openai + openai-java + 2.12.0 + +``` + +**Pääkoodi** (`App.java`): +```java +// Yhdistä GitHub-malleihin OpenAI Java SDK:n avulla +OpenAIClient client = OpenAIOkHttpClient.builder() + .apiKey(pat) + .baseUrl("https://models.inference.ai.azure.com") + .build(); + +// Luo chat-vastauksen pyyntö +ChatCompletionCreateParams params = ChatCompletionCreateParams.builder() + .model(modelId) + .addSystemMessage("You are a concise assistant.") + .addUserMessage("Say Hello World!") + .build(); + +// Hanki tekoälyn vastaus +ChatCompletion response = client.chat().completions().create(params); +System.out.println("Response: " + response.choices().get(0).message().content().orElse("No response content")); +``` + +## Yhteenveto + +Hienoa! Sinulla on nyt kaikki asennettuna: + +- Loit GitHub-henkilökohtaisen käyttöoikeustunnuksen AI-mallien käyttöön tarvittavilla oikeuksilla +- Käynnistit Java-kehitysympäristösi (Codespaces, dev container tai paikallinen) +- Yhdistit GitHub-malleihin käyttämällä OpenAI Java SDK:ta ilmaiseen AI-kehitykseen +- Testasit kaiken toimivan yksinkertaisella esimerkillä, joka kommunikoi AI-mallien kanssa + +## Seuraavat askeleet + +[Luku 3: Keskeiset generatiivisen tekoälyn tekniikat](../03-CoreGenerativeAITechniques/README.md) + +## Vianetsintä + +Ongelmia? Tässä yleisimmät ongelmat ja ratkaisut: + +- **Token ei toimi?** + - Varmista, että kopioit tokenin kokonaan, ilman ylimääräisiä välilyöntejä + - Tarkista, että token on asetettu oikein ympäristömuuttujaksi + - Varmista, että tokenilla on oikeat oikeudet (Models: Read-only) + +- **Mavenia ei löydy?** + - Käytätkö dev containeria tai Codespacesia? Maven on siellä valmiiksi asennettu + - Paikallisessa asennuksessa varmista, että Java 21+ ja Maven 3.9+ on asennettu + - Kokeile komentoa `mvn --version` asennuksen tarkistamiseen + +- **Yhteysongelmat?** + - Tarkista internet-yhteytesi + - Varmista, että GitHub on verkostossasi saavutettavissa + - Varmista ettei palomuuri estä GitHub Models -päätepistettä + +- **Dev container ei käynnisty?** + - Tarkista, että Docker Desktop on käynnissä (paikallisessa kehityksessä) + - Kokeile uudelleenrakentaa kontaineri: `Ctrl+Shift+P` → "Dev Containers: Rebuild Container" + +- **Sovelluksen käännösvirheet?** + - Varmista, että olet oikeassa kansiossa: `02-SetupDevEnvironment/examples/github-models` + - Kokeile puhdistaa ja kääntää uudelleen: `mvn clean compile` + +> **Tarvitsetko apua?**: Jos ongelmat jatkuvat, avaa issue repositorioon, niin autamme. --- + +**Vastuuvapauslauseke**: +Tämä asiakirja on käännetty käyttämällä tekoälypohjaista käännöspalvelua [Co-op Translator](https://github.com/Azure/co-op-translator). Vaikka pyrimme tarkkuuteen, huomioithan, että automaattikäännöksissä voi esiintyä virheitä tai epätarkkuuksia. Alkuperäinen asiakirja sen alkuperäiskielellä on katsottava viralliseksi lähteeksi. Tärkeissä tiedoissa suositellaan ammattimaista ihmiskäännöstä. Emme ole vastuussa tämän käännöksen käytöstä aiheutuvista väärinkäsityksistä tai tulkinnoista. + \ No newline at end of file diff --git a/translations/fi/02-SetupDevEnvironment/examples/basic-chat-azure/README.md b/translations/fi/02-SetupDevEnvironment/examples/basic-chat-azure/README.md index b40dff85..1bd130ad 100644 --- a/translations/fi/02-SetupDevEnvironment/examples/basic-chat-azure/README.md +++ b/translations/fi/02-SetupDevEnvironment/examples/basic-chat-azure/README.md @@ -1,12 +1,3 @@ - # Peruskeskustelu Azure OpenAI:n kanssa - Esimerkki alusta loppuun Tämä esimerkki näyttää, kuinka luoda yksinkertainen Spring Boot -sovellus, joka yhdistyy Azure OpenAI:hin ja testaa kokoonpanosi. diff --git a/translations/fi/02-SetupDevEnvironment/getting-started-azure-openai.md b/translations/fi/02-SetupDevEnvironment/getting-started-azure-openai.md index 41178051..9348a7a3 100644 --- a/translations/fi/02-SetupDevEnvironment/getting-started-azure-openai.md +++ b/translations/fi/02-SetupDevEnvironment/getting-started-azure-openai.md @@ -1,12 +1,3 @@ - # Kehitysympäristön asennus Azure OpenAI:lle > **Pika-aloitus**: Tämä opas on tarkoitettu Azure OpenAI -asennukseen. Jos haluat aloittaa nopeasti ilmaisilla malleilla, käytä [GitHub-malleja Codespacesin kanssa](./README.md#quick-start-cloud). diff --git a/translations/fi/03-CoreGenerativeAITechniques/README.md b/translations/fi/03-CoreGenerativeAITechniques/README.md index 2bcf22dd..7a387062 100644 --- a/translations/fi/03-CoreGenerativeAITechniques/README.md +++ b/translations/fi/03-CoreGenerativeAITechniques/README.md @@ -1,12 +1,3 @@ - # Generatiivisen tekoälyn ydintekniikoiden opas ## Sisällysluettelo diff --git a/translations/fi/04-PracticalSamples/README.md b/translations/fi/04-PracticalSamples/README.md index ed9cdaf1..3536840f 100644 --- a/translations/fi/04-PracticalSamples/README.md +++ b/translations/fi/04-PracticalSamples/README.md @@ -1,12 +1,3 @@ - # Käytännön sovellukset ja projektit ## Mitä opit diff --git a/translations/fi/04-PracticalSamples/calculator/README.md b/translations/fi/04-PracticalSamples/calculator/README.md index 511aa120..dfb3dcbc 100644 --- a/translations/fi/04-PracticalSamples/calculator/README.md +++ b/translations/fi/04-PracticalSamples/calculator/README.md @@ -1,12 +1,3 @@ - # MCP-laskinopas aloittelijoille ## Sisällysluettelo diff --git a/translations/fi/04-PracticalSamples/foundrylocal/README.md b/translations/fi/04-PracticalSamples/foundrylocal/README.md index 5710cd28..d5883b5e 100644 --- a/translations/fi/04-PracticalSamples/foundrylocal/README.md +++ b/translations/fi/04-PracticalSamples/foundrylocal/README.md @@ -1,12 +1,3 @@ - # Foundry Local Spring Boot -opas ## Sisällysluettelo diff --git a/translations/fi/04-PracticalSamples/petstory/README.md b/translations/fi/04-PracticalSamples/petstory/README.md index 12bfb092..a408e53b 100644 --- a/translations/fi/04-PracticalSamples/petstory/README.md +++ b/translations/fi/04-PracticalSamples/petstory/README.md @@ -1,12 +1,3 @@ - # Lemmikkitarinan luontiohje aloittelijoille ## Sisällysluettelo diff --git a/translations/fi/05-ResponsibleGenAI/README.md b/translations/fi/05-ResponsibleGenAI/README.md index d016c74b..49b25aec 100644 --- a/translations/fi/05-ResponsibleGenAI/README.md +++ b/translations/fi/05-ResponsibleGenAI/README.md @@ -1,12 +1,3 @@ - # Vastuullinen Generatiivinen AI ## Mitä opit diff --git a/translations/fi/AGENTS.md b/translations/fi/AGENTS.md index 42cbf70c..5ad6324f 100644 --- a/translations/fi/AGENTS.md +++ b/translations/fi/AGENTS.md @@ -1,12 +1,3 @@ - # AGENTS.md ## Projektin yleiskuvaus diff --git a/translations/fi/CODE_OF_CONDUCT.md b/translations/fi/CODE_OF_CONDUCT.md index f78e694c..9b188790 100644 --- a/translations/fi/CODE_OF_CONDUCT.md +++ b/translations/fi/CODE_OF_CONDUCT.md @@ -1,12 +1,3 @@ - # Microsoftin avoimen lähdekoodin toimintasäännöt Tämä projekti on ottanut käyttöön [Microsoftin avoimen lähdekoodin toimintasäännöt](https://opensource.microsoft.com/codeofconduct/). diff --git a/translations/fi/README.md b/translations/fi/README.md index f4ed6330..e501c7fd 100644 --- a/translations/fi/README.md +++ b/translations/fi/README.md @@ -1,37 +1,28 @@ - -# Generatiivinen tekoäly aloittelijoille - Java Edition +# Generatiivinen tekoäly aloittelijoille - Java-versio [![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) -![Generatiivinen tekoäly aloittelijoille - Java Edition](../../translated_images/fi/beg-genai-series.8b48be9951cc574c.webp) +![Generatiivinen tekoäly aloittelijoille - Java-versio](../../translated_images/fi/beg-genai-series.8b48be9951cc574c.webp) -**Ajan tarve**: Koko työpajan voi suorittaa verkossa ilman paikallista asennusta. Ympäristön asetukset vievät 2 minuuttia, ja esimerkkien tutkimiseen menee 1-3 tuntia riippuen tutkimisen syvyydestä. +**Ajan tarve**: Koko työpaja voidaan suorittaa verkossa ilman paikallista asennusta. Ympäristön asennus vie 2 minuuttia, ja esimerkkien tutkiminen vaatii 1–3 tuntia riippuen tutkimisen syvyydestä. -> **Pika-aloitus** +> **Pika-aloitus** -1. Tee forkki tästä repositoriosta GitHub-tilillesi -2. Valitse **Code** → **Codespaces** -välilehti → **...** → **Uusi vaihtoehdoilla...** -3. Käytä oletuksia – tämä valitsee tähän kurssiin luodun kehityssäiliön -4. Klikkaa **Luo codespace** +1. Tee fork tästä reposta GitHub-tilillesi +2. Klikkaa **Code** → **Codespaces** -välilehti → **...** → **New with options...** +3. Käytä oletuksia – tämä valitsee tämän kurssin kehityssäiliön +4. Klikkaa **Create codespace** 5. Odota noin 2 minuuttia, että ympäristö on valmis 6. Siirry suoraan kohtaan [Ensimmäinen esimerkki](./02-SetupDevEnvironment/README.md#step-2-create-a-github-personal-access-token) > **Haluatko mieluummin kloonata paikallisesti?** > -> Tämä repositorio sisältää yli 50 kielen käännökset, jotka merkittävästi suurentavat lataustiedoston kokoa. Kloonaa ilman käännöksiä käyttämällä sparse checkoutia: +> Tässä repossa on yli 50 kielikäännöstä, jotka lisäävät merkittävästi lataustiedoston kokoa. Jos haluat kloonata ilman käännöksiä, käytä sparse checkout -menetelmää: > ```bash > git clone --filter=blob:none --sparse https://github.com/microsoft/Generative-AI-for-beginners-java.git > cd Generative-AI-for-beginners-java > git sparse-checkout set --no-cone '/*' '!translations' '!translated_images' > ``` -> Tämä antaa kaiken tarvittavan kurssin suorittamiseen huomattavasti nopeammalla latauksella. +> Tämä antaa sinulle kaiken tarvittavan kurssin suorittamiseen paljon nopeammalla latauksella. ## Monikielinen tuki @@ -39,52 +30,52 @@ CO_OP_TRANSLATOR_METADATA: ### Tuettu GitHub Actionin kautta (automaattinen ja aina ajan tasalla) -[Arabia](../ar/README.md) | [Bengali](../bn/README.md) | [Bulgaria](../bg/README.md) | [Burma (Myanmar)](../my/README.md) | [Kiina (yksinkertaistettu)](../zh/README.md) | [Kiina (perinteinen, Hong Kong)](../hk/README.md) | [Kiina (perinteinen, Macao)](../mo/README.md) | [Kiina (perinteinen, Taiwan)](../tw/README.md) | [Kroatia](../hr/README.md) | [Tšekki](../cs/README.md) | [Tanska](../da/README.md) | [Hollanti](../nl/README.md) | [Viro](../et/README.md) | [Suomi](./README.md) | [Ranska](../fr/README.md) | [Saksa](../de/README.md) | [Kreikka](../el/README.md) | [Heprea](../he/README.md) | [Hindi](../hi/README.md) | [Unkari](../hu/README.md) | [Indonesia](../id/README.md) | [Italia](../it/README.md) | [Japani](../ja/README.md) | [Kannada](../kn/README.md) | [Korea](../ko/README.md) | [Liettua](../lt/README.md) | [Malaiji](../ms/README.md) | [Malayalam](../ml/README.md) | [Marathi](../mr/README.md) | [Nepali](../ne/README.md) | [Nigerian Pidgin](../pcm/README.md) | [Norja](../no/README.md) | [Persia (Farsi)](../fa/README.md) | [Puola](../pl/README.md) | [Portugali (Brasilia)](../br/README.md) | [Portugali (Portugali)](../pt/README.md) | [Punjabi (Gurmukhi)](../pa/README.md) | [Romania](../ro/README.md) | [Venäjä](../ru/README.md) | [Serbia (kyrillinen)](../sr/README.md) | [Slovakki](../sk/README.md) | [Slovenia](../sl/README.md) | [Espanja](../es/README.md) | [Swaheli](../sw/README.md) | [Ruotsi](../sv/README.md) | [Tagalog (filipino)](../tl/README.md) | [Tamili](../ta/README.md) | [Telugu](../te/README.md) | [Thai](../th/README.md) | [Turkki](../tr/README.md) | [Ukraina](../uk/README.md) | [Urdu](../ur/README.md) | [Vietnam](../vi/README.md) +[Arabia](../ar/README.md) | [Bengali](../bn/README.md) | [Bulgaria](../bg/README.md) | [Burma (Myanmar)](../my/README.md) | [Kiina (yksinkertaistettu)](../zh-CN/README.md) | [Kiina (perinteinen, Hongkong)](../zh-HK/README.md) | [Kiina (perinteinen, Macao)](../zh-MO/README.md) | [Kiina (perinteinen, Taiwan)](../zh-TW/README.md) | [Kroatia](../hr/README.md) | [Tšekki](../cs/README.md) | [Tanska](../da/README.md) | [Alankomaat](../nl/README.md) | [Viro](../et/README.md) | [Suomi](./README.md) | [Ranska](../fr/README.md) | [Saksa](../de/README.md) | [Kreikka](../el/README.md) | [Heprea](../he/README.md) | [Hindi](../hi/README.md) | [Unkari](../hu/README.md) | [Indonesia](../id/README.md) | [Italia](../it/README.md) | [Japani](../ja/README.md) | [Kannada](../kn/README.md) | [Korea](../ko/README.md) | [Liettua](../lt/README.md) | [Malaiji](../ms/README.md) | [Malayalam](../ml/README.md) | [Marathi](../mr/README.md) | [Nepali](../ne/README.md) | [Nigerian Pidgin](../pcm/README.md) | [Norja](../no/README.md) | [Persia (Farsi)](../fa/README.md) | [Puola](../pl/README.md) | [Portugali (Brasilia)](../pt-BR/README.md) | [Portugali (Portugali)](../pt-PT/README.md) | [Punjabi (Gurmukhi)](../pa/README.md) | [Romania](../ro/README.md) | [Venäjä](../ru/README.md) | [Serbia (kyrillinen)](../sr/README.md) | [Slovakki](../sk/README.md) | [Slovenia](../sl/README.md) | [Espanja](../es/README.md) | [Swahili](../sw/README.md) | [Ruotsi](../sv/README.md) | [Tagalog (Filipino)](../tl/README.md) | [Tamili](../ta/README.md) | [Telugu](../te/README.md) | [Thai](../th/README.md) | [Turkki](../tr/README.md) | [Ukraina](../uk/README.md) | [Urdu](../ur/README.md) | [Vietnam](../vi/README.md) > **Haluatko mieluummin kloonata paikallisesti?** -> Tämä repositorio sisältää yli 50 kielen käännöksiä, mikä lisää merkittävästi lataustiedoston kokoa. Kloonaa ilman käännöksiä käyttämällä sparse checkoutia: +> Tässä repossa on yli 50 kielikäännöstä, jotka lisäävät merkittävästi lataustiedoston kokoa. Jos haluat kloonata ilman käännöksiä, käytä sparse checkout -menetelmää: > ```bash > git clone --filter=blob:none --sparse https://github.com/microsoft/Generative-AI-for-beginners-java.git > cd Generative-AI-for-beginners-java > git sparse-checkout set --no-cone '/*' '!translations' '!translated_images' > ``` -> Tämä antaa kaiken tarvitsemasi kurssin suorittamiseen paljon nopeammalla latauksella. +> Tämä antaa sinulle kaiken tarvittavan kurssin suorittamiseen paljon nopeammalla latauksella. ## Kurssin rakenne ja oppimispolku -### **Luku 1: Johdatus generatiiviseen tekoälyyn** -- **Peruskäsitteet**: Suurten kielimallien, tokenien, upotusten ja tekoälyn kyvykkyyksien ymmärtäminen -- **Java AI -ekosysteemi**: Yleiskatsaus Spring AI:hin ja OpenAI SDK:hin -- **Mallin kontekstiprotokolla**: Johdatus MCP:hen ja sen rooliin tekoälyagenttien kommunikaatiossa -- **Käytännön sovellukset**: Reaalimaailman skenaariot, mukaan lukien chatbotit ja sisällöntuotanto +### **Luku 1: Johdanto generaatiiviseen tekoälyyn** +- **Keskeiset käsitteet**: Suurten kielimallien, tokenien, upotusten ja tekoälyn kykyjen ymmärtäminen +- **Java AI -ekosysteemi**: Yleisnäkymä Spring AI:sta ja OpenAI SDK:sta +- **Mallin kontekstiprotokolla**: Johdanto MCP:hen ja sen rooli tekoälyagenttien kommunikaatiossa +- **Käytännön sovellukset**: Todellisen maailman skenaariot kuten chatbotit ja sisällöntuotanto - **[→ Aloita luku 1](./01-IntroToGenAI/README.md)** ### **Luku 2: Kehitysympäristön asennus** -- **Monitoimittajakonfiguraatio**: GitHub-mallit, Azure OpenAI ja OpenAI Java SDK -integraatiot -- **Spring Boot + Spring AI**: Parhaat käytännöt yritystason tekoälysovelluskehitykseen -- **GitHub-mallit**: Ilmainen pääsy tekoälymalleihin prototypointiin ja oppimiseen (ei luottokorttia vaadita) +- **Monitoimittajakonfiguraatio**: GitHub-mallien, Azure OpenAI:n ja OpenAI Java SDK:n yhdistäminen +- **Spring Boot + Spring AI**: parhaat käytännöt yritystason tekoälysovelluskehitykseen +- **GitHub-mallit**: Ilmainen tekoälymallien käyttö prototypointiin ja oppimiseen (ei tarvita luottokorttia) - **Kehitystyökalut**: Docker-kontit, VS Code ja GitHub Codespaces -asetukset - **[→ Aloita luku 2](./02-SetupDevEnvironment/README.md)** -### **Luku 3: Keskeiset generatiivisen tekoälyn tekniikat** -- **Prompt-tekniikat**: Tekniikat parhaiden vastausten saamiseksi tekoälymalleilta -- **Upotukset ja vektoriopeet**: Semanttisen haun ja samankaltaisuuden sovittamisen toteutus -- **Hakuavusteinen generointi (RAG)**: Yhdistä tekoäly omaan tietolähteeseesi -- **Funktioiden kutsuminen**: Laajenna tekoälyn ominaisuuksia omilla työkaluilla ja laajennuksilla +### **Luku 3: Keskeiset generaatiivisen tekoälyn tekniikat** +- **Vihjerakentaminen**: Tekniikat optimaalisiin tekoälymallivastauksiin +- **Upotukset ja vektoritoiminnot**: Semanttinen haku ja vastaavuuksien löytäminen +- **Hakuparannettu generointi (RAG)**: Yhdistä tekoäly omiin tietolähteisiisi +- **Funktiokutsut**: Laajenna tekoälyn kykyjä omilla työkaluilla ja lisäosilla - **[→ Aloita luku 3](./03-CoreGenerativeAITechniques/README.md)** ### **Luku 4: Käytännön sovellukset ja projektit** -- **Lemmikkitarinan generaattori** (`petstory/`): Luova sisällöntuotanto GitHub-malleilla -- **Foundryn paikallinen demo** (`foundrylocal/`): Paikallinen tekoälymallien integraatio OpenAI Java SDK:lla -- **MCP-laskinpalvelu** (`calculator/`): Perusmallikonseptiprotokollan toteutus Spring AI:lla +- **Lemmikkitarina-generaattori** (`petstory/`): Luova sisällöntuotanto GitHub-malleilla +- **Foundry Local Demo** (`foundrylocal/`): Paikallinen tekoälymallin integrointi OpenAI Java SDK:lla +- **MCP-laskentapalvelu** (`calculator/`): Perustason Model Context Protocol -toteutus Spring AI:lla - **[→ Aloita luku 4](./04-PracticalSamples/README.md)** ### **Luku 5: Vastuullinen tekoälykehitys** -- **GitHub-mallien turvallisuus**: Kokeile sisäänrakennettuja sisällönsuodatuksia ja turvamekanismeja (kovat estot ja pehmeät kieltäytymiset) -- **Vastuullisen tekoälyn demo**: Käytännön esimerkki nykyaikaisten tekoälyn turvajärjestelmien toiminnasta -- **Parhaat käytännöt**: Keskeiset ohjeet eettiseen tekoälykehitykseen ja käyttöönottoon +- **GitHub-mallien turvallisuus**: Kokeile sisäänrakennettuja sisältösuodatuksia ja turvamekanismeja (kovat esto ja pehmeät kieltäytymiset) +- **Vastuullisen tekoälyn demo**: Käytännön esimerkki siitä, miten nykyaikaiset turvallisuusjärjestelmät toimivat tekoälyssä +- **Parhaat käytännöt**: Olennaiset ohjeistukset eettiseen tekoälykehitykseen ja käyttöönottoon - **[→ Aloita luku 5](./05-ResponsibleGenAI/README.md)** ## Lisäresurssit @@ -100,11 +91,11 @@ CO_OP_TRANSLATOR_METADATA: [![AZD aloittelijoille](https://img.shields.io/badge/AZD%20for%20Beginners-0078D4?style=for-the-badge&labelColor=E5E7EB&color=0078D4)](https://github.com/microsoft/AZD-for-beginners?WT.mc_id=academic-105485-koreyst) [![Edge AI aloittelijoille](https://img.shields.io/badge/Edge%20AI%20for%20Beginners-00B8E4?style=for-the-badge&labelColor=E5E7EB&color=00B8E4)](https://github.com/microsoft/edgeai-for-beginners?WT.mc_id=academic-105485-koreyst) [![MCP aloittelijoille](https://img.shields.io/badge/MCP%20for%20Beginners-009688?style=for-the-badge&labelColor=E5E7EB&color=009688)](https://github.com/microsoft/mcp-for-beginners?WT.mc_id=academic-105485-koreyst) -[![AI-agentit aloittelijoille](https://img.shields.io/badge/AI%20Agents%20for%20Beginners-00C49A?style=for-the-badge&labelColor=E5E7EB&color=00C49A)](https://github.com/microsoft/ai-agents-for-beginners?WT.mc_id=academic-105485-koreyst) +[![Tekoälyagentit aloittelijoille](https://img.shields.io/badge/AI%20Agents%20for%20Beginners-00C49A?style=for-the-badge&labelColor=E5E7EB&color=00C49A)](https://github.com/microsoft/ai-agents-for-beginners?WT.mc_id=academic-105485-koreyst) --- -### Generatiivinen tekoälysarja +### Generatiivisen tekoälyn sarja [![Generatiivinen tekoäly aloittelijoille](https://img.shields.io/badge/Generative%20AI%20for%20Beginners-8B5CF6?style=for-the-badge&labelColor=E5E7EB&color=8B5CF6)](https://github.com/microsoft/generative-ai-for-beginners?WT.mc_id=academic-105485-koreyst) [![Generatiivinen tekoäly (.NET)](https://img.shields.io/badge/Generative%20AI%20(.NET)-9333EA?style=for-the-badge&labelColor=E5E7EB&color=9333EA)](https://github.com/microsoft/Generative-AI-for-beginners-dotnet?WT.mc_id=academic-105485-koreyst) [![Generatiivinen tekoäly (Java)](https://img.shields.io/badge/Generative%20AI%20(Java)-C084FC?style=for-the-badge&labelColor=E5E7EB&color=C084FC)](https://github.com/microsoft/generative-ai-for-beginners-java?WT.mc_id=academic-105485-koreyst) @@ -112,30 +103,31 @@ CO_OP_TRANSLATOR_METADATA: --- -### Perusopetus +### Keskeinen oppiminen [![ML aloittelijoille](https://img.shields.io/badge/ML%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=22C55E)](https://aka.ms/ml-beginners?WT.mc_id=academic-105485-koreyst) -[![Data Science aloittelijoille](https://img.shields.io/badge/Data%20Science%20for%20Beginners-84CC16?style=for-the-badge&labelColor=E5E7EB&color=84CC16)](https://aka.ms/datascience-beginners?WT.mc_id=academic-105485-koreyst) +[![Data-analytiikka aloittelijoille](https://img.shields.io/badge/Data%20Science%20for%20Beginners-84CC16?style=for-the-badge&labelColor=E5E7EB&color=84CC16)](https://aka.ms/datascience-beginners?WT.mc_id=academic-105485-koreyst) [![Tekoäly aloittelijoille](https://img.shields.io/badge/AI%20for%20Beginners-A3E635?style=for-the-badge&labelColor=E5E7EB&color=A3E635)](https://aka.ms/ai-beginners?WT.mc_id=academic-105485-koreyst) [![Kyberturvallisuus aloittelijoille](https://img.shields.io/badge/Cybersecurity%20for%20Beginners-F97316?style=for-the-badge&labelColor=E5E7EB&color=F97316)](https://github.com/microsoft/Security-101?WT.mc_id=academic-96948-sayoung) -[![Web-kehitys aloittelijoille](https://img.shields.io/badge/Web%20Dev%20for%20Beginners-EC4899?style=for-the-badge&labelColor=E5E7EB&color=EC4899)](https://aka.ms/webdev-beginners?WT.mc_id=academic-105485-koreyst) + +[![Web Dev for Beginners](https://img.shields.io/badge/Web%20Dev%20for%20Beginners-EC4899?style=for-the-badge&labelColor=E5E7EB&color=EC4899)](https://aka.ms/webdev-beginners?WT.mc_id=academic-105485-koreyst) [![IoT for Beginners](https://img.shields.io/badge/IoT%20for%20Beginners-14B8A6?style=for-the-badge&labelColor=E5E7EB&color=14B8A6)](https://aka.ms/iot-beginners?WT.mc_id=academic-105485-koreyst) [![XR Development for Beginners](https://img.shields.io/badge/XR%20Development%20for%20Beginners-38BDF8?style=for-the-badge&labelColor=E5E7EB&color=38BDF8)](https://github.com/microsoft/xr-development-for-beginners?WT.mc_id=academic-105485-koreyst) --- -### Copilot -sarja +### Copilot-sarja [![Copilot for AI Paired Programming](https://img.shields.io/badge/Copilot%20for%20AI%20Paired%20Programming-FACC15?style=for-the-badge&labelColor=E5E7EB&color=FACC15)](https://aka.ms/GitHubCopilotAI?WT.mc_id=academic-105485-koreyst) [![Copilot for C#/.NET](https://img.shields.io/badge/Copilot%20for%20C%23/.NET-FBBF24?style=for-the-badge&labelColor=E5E7EB&color=FBBF24)](https://github.com/microsoft/mastering-github-copilot-for-dotnet-csharp-developers?WT.mc_id=academic-105485-koreyst) [![Copilot Adventure](https://img.shields.io/badge/Copilot%20Adventure-FDE68A?style=for-the-badge&labelColor=E5E7EB&color=FDE68A)](https://github.com/microsoft/CopilotAdventures?WT.mc_id=academic-105485-koreyst) -## Apua saamaan +## Apua saatavilla -Jos jäät jumiin tai sinulla on kysyttävää tekoälysovellusten rakentamisesta, liity muiden oppijoiden ja kokeneiden kehittäjien keskusteluihin MCP:stä. Se on tukevainen yhteisö, jossa kysymykset ovat tervetulleita ja tietoa jaetaan vapaasti. +Jos jäät jumiin tai sinulla on kysyttävää AI-sovellusten rakentamisesta, liity muiden oppijoiden ja kokeneiden kehittäjien keskusteluihin MCP:stä. Se on kannustava yhteisö, jossa kysymyksiä saa esittää ja tieto jaetaan vapaasti. [![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) -Jos sinulla on tuotearvioita tai kohtaat virheitä rakentamisen aikana, käy täällä: +Jos sinulla on palautetta tuotteesta tai kohtaat virheitä kehittäessäsi, käy osoitteessa: [![Microsoft Foundry Developer Forum](https://img.shields.io/badge/GitHub-Microsoft_Foundry_Developer_Forum-blue?style=for-the-badge&logo=github&color=000000&logoColor=fff)](https://aka.ms/foundry/forum) @@ -143,5 +135,5 @@ Jos sinulla on tuotearvioita tai kohtaat virheitä rakentamisen aikana, käy tä **Vastuuvapauslauseke**: -Tämä asiakirja on käännetty käyttäen tekoälypohjaista käännöspalvelua [Co-op Translator](https://github.com/Azure/co-op-translator). Pyrimme tarkkuuteen, mutta huomioithan, että automaattiset käännökset voivat sisältää virheitä tai epätarkkuuksia. Alkuperäinen asiakirja sen omalla kielellä on luotettava lähde. Tärkeiden tietojen osalta suositellaan ammattilaisten tekemää ihmiskäännöstä. Emme ole vastuussa tämän käännöksen käytöstä aiheutuvista väärinymmärryksistä tai virhetulkinnoista. +Tämä asiakirja on käännetty käyttämällä tekoälykäännöspalvelua [Co-op Translator](https://github.com/Azure/co-op-translator). Pyrimme tarkkuuteen, mutta huomaathan, että automaattiset käännökset saattavat sisältää virheitä tai epätarkkuuksia. Alkuperäistä asiakirjaa sen alkuperäisellä kielellä tulee pitää auktoriteettisena lähteenä. Tärkeiden tietojen osalta suosittelemme ammattimaista ihmiskäännöstä. Emme ole vastuussa tämän käännöksen käytöstä aiheutuvista väärinymmärryksistä tai virhetulkinnoista. \ No newline at end of file diff --git a/translations/fi/SECURITY.md b/translations/fi/SECURITY.md index f7371e2a..c6f20a07 100644 --- a/translations/fi/SECURITY.md +++ b/translations/fi/SECURITY.md @@ -1,12 +1,3 @@ - ## Turvallisuus Microsoft suhtautuu vakavasti ohjelmistotuotteidensa ja palveluidensa turvallisuuteen, mukaan lukien kaikki lähdekoodivarastot, joita hallinnoidaan GitHub-organisaatioidemme kautta, kuten [Microsoft](https://github.com/Microsoft), [Azure](https://github.com/Azure), [DotNet](https://github.com/dotnet), [AspNet](https://github.com/aspnet) ja [Xamarin](https://github.com/xamarin). diff --git a/translations/fi/SUPPORT.md b/translations/fi/SUPPORT.md index b89e13a7..89ce201d 100644 --- a/translations/fi/SUPPORT.md +++ b/translations/fi/SUPPORT.md @@ -1,12 +1,3 @@ - # Tuki ## Kuinka raportoida ongelmia ja saada apua diff --git a/translations/fr/.co-op-translator.json b/translations/fr/.co-op-translator.json new file mode 100644 index 00000000..15ca9ac8 --- /dev/null +++ b/translations/fr/.co-op-translator.json @@ -0,0 +1,92 @@ +{ + "01-IntroToGenAI/README.md": { + "original_hash": "75bfb080ca725e8a9aa9c80cae25fba1", + "translation_date": "2025-07-29T07:56:34+00:00", + "source_file": "01-IntroToGenAI/README.md", + "language_code": "fr" + }, + "02-SetupDevEnvironment/README.md": { + "original_hash": "96a30d42b9751a3d4e4b20e28d29d459", + "translation_date": "2026-01-28T04:34:58+00:00", + "source_file": "02-SetupDevEnvironment/README.md", + "language_code": "fr" + }, + "02-SetupDevEnvironment/examples/basic-chat-azure/README.md": { + "original_hash": "efd82efe50711d7e257eb943151d682c", + "translation_date": "2025-07-27T13:32:34+00:00", + "source_file": "02-SetupDevEnvironment/examples/basic-chat-azure/README.md", + "language_code": "fr" + }, + "02-SetupDevEnvironment/getting-started-azure-openai.md": { + "original_hash": "bfdb4b4eadbee3a59ef742439f58326a", + "translation_date": "2025-07-27T12:48:20+00:00", + "source_file": "02-SetupDevEnvironment/getting-started-azure-openai.md", + "language_code": "fr" + }, + "03-CoreGenerativeAITechniques/README.md": { + "original_hash": "685f55cb07de19b52a30ce6e8b6d889e", + "translation_date": "2025-08-28T21:52:04+00:00", + "source_file": "03-CoreGenerativeAITechniques/README.md", + "language_code": "fr" + }, + "04-PracticalSamples/README.md": { + "original_hash": "14c0a61ecc1cd2012a9c129236dfdf71", + "translation_date": "2025-07-29T07:56:19+00:00", + "source_file": "04-PracticalSamples/README.md", + "language_code": "fr" + }, + "04-PracticalSamples/calculator/README.md": { + "original_hash": "b6c16b5514d524e415a94f6097ee7d4c", + "translation_date": "2025-09-18T15:22:20+00:00", + "source_file": "04-PracticalSamples/calculator/README.md", + "language_code": "fr" + }, + "04-PracticalSamples/foundrylocal/README.md": { + "original_hash": "f787307400de59adc25a1404466a35f3", + "translation_date": "2025-11-04T07:11:33+00:00", + "source_file": "04-PracticalSamples/foundrylocal/README.md", + "language_code": "fr" + }, + "04-PracticalSamples/petstory/README.md": { + "original_hash": "0cbf68d605615a1e602c832a24616859", + "translation_date": "2025-07-25T10:38:23+00:00", + "source_file": "04-PracticalSamples/petstory/README.md", + "language_code": "fr" + }, + "05-ResponsibleGenAI/README.md": { + "original_hash": "301c05c2f57e60a6950b8c665b8bdbba", + "translation_date": "2025-07-29T15:39:37+00:00", + "source_file": "05-ResponsibleGenAI/README.md", + "language_code": "fr" + }, + "AGENTS.md": { + "original_hash": "afc90918d008cf77fd1982691f681306", + "translation_date": "2025-10-03T08:24:32+00:00", + "source_file": "AGENTS.md", + "language_code": "fr" + }, + "CODE_OF_CONDUCT.md": { + "original_hash": "442b123d034f92f7c384d2bbd28f99f1", + "translation_date": "2025-07-21T15:58:33+00:00", + "source_file": "CODE_OF_CONDUCT.md", + "language_code": "fr" + }, + "README.md": { + "original_hash": "125a08948d881c95628094f4dd1fbd43", + "translation_date": "2026-01-29T15:14:26+00:00", + "source_file": "README.md", + "language_code": "fr" + }, + "SECURITY.md": { + "original_hash": "57f14126c1c6add76b3aef3844dfe4e3", + "translation_date": "2025-07-21T15:56:24+00:00", + "source_file": "SECURITY.md", + "language_code": "fr" + }, + "SUPPORT.md": { + "original_hash": "b8ef73cc49dec68e2c885ee9df545129", + "translation_date": "2025-07-21T15:59:40+00:00", + "source_file": "SUPPORT.md", + "language_code": "fr" + } +} \ No newline at end of file diff --git a/translations/fr/01-IntroToGenAI/README.md b/translations/fr/01-IntroToGenAI/README.md index 44752655..af1086d2 100644 --- a/translations/fr/01-IntroToGenAI/README.md +++ b/translations/fr/01-IntroToGenAI/README.md @@ -1,12 +1,3 @@ - # Introduction à l'IA Générative - Édition Java ## Ce que vous apprendrez diff --git a/translations/fr/02-SetupDevEnvironment/README.md b/translations/fr/02-SetupDevEnvironment/README.md index e9a441c1..3a3b0706 100644 --- a/translations/fr/02-SetupDevEnvironment/README.md +++ b/translations/fr/02-SetupDevEnvironment/README.md @@ -1,13 +1,254 @@ - +# Configuration de l'environnement de développement pour Generative AI for Java +> **Démarrage rapide** : Codez dans le cloud en 2 minutes - Passez à [Configuration GitHub Codespaces](../../../02-SetupDevEnvironment) - aucune installation locale requise et utilise les modèles GitHub ! + +> **Intéressé par Azure OpenAI ?**, consultez notre [Guide de configuration Azure OpenAI](getting-started-azure-openai.md) avec les étapes pour créer une nouvelle ressource Azure OpenAI. + +## Ce que vous apprendrez + +- Configurer un environnement de développement Java pour les applications d'IA +- Choisir et configurer votre environnement de développement préféré (cloud-first avec Codespaces, conteneur dev local, ou installation locale complète) +- Tester votre configuration en vous connectant aux modèles GitHub + +## Table des matières + +- [Ce que vous apprendrez](../../../02-SetupDevEnvironment) +- [Introduction](../../../02-SetupDevEnvironment) +- [Étape 1 : Configurez votre environnement de développement](../../../02-SetupDevEnvironment) + - [Option A : GitHub Codespaces (recommandé)](../../../02-SetupDevEnvironment) + - [Option B : Conteneur dev local](../../../02-SetupDevEnvironment) + - [Option C : Utilisez votre installation locale existante](../../../02-SetupDevEnvironment) +- [Étape 2 : Créez un token d'accès personnel GitHub](../../../02-SetupDevEnvironment) +- [Étape 3 : Testez votre configuration](../../../02-SetupDevEnvironment) +- [Dépannage](../../../02-SetupDevEnvironment) +- [Résumé](../../../02-SetupDevEnvironment) +- [Étapes suivantes](../../../02-SetupDevEnvironment) + +## Introduction + +Ce chapitre vous guidera dans la configuration d'un environnement de développement. Nous utiliserons **GitHub Models** comme exemple principal car il est gratuit, facile à configurer avec juste un compte GitHub, ne nécessite pas de carte de crédit, et offre l'accès à plusieurs modèles pour expérimenter. + +**Aucune configuration locale requise !** Vous pouvez commencer à coder immédiatement en utilisant GitHub Codespaces, qui fournit un environnement de développement complet dans votre navigateur. + +Capture d'écran : GitHub Models + +Nous recommandons d'utiliser [**GitHub Models**](https://github.com/marketplace?type=models) pour ce cours car il est : +- **Gratuit** pour commencer +- **Facile** à configurer avec un simple compte GitHub +- **Pas de carte bancaire** requise +- **Plusieurs modèles** disponibles pour l'expérimentation + +> **Note** : Les modèles GitHub utilisés dans cette formation ont ces limites gratuites : +> - 15 requêtes par minute (150 par jour) +> - ~8 000 mots en entrée, ~4 000 mots en sortie par requête +> - 5 requêtes simultanées +> +> Pour une utilisation en production, passez aux modèles Azure AI Foundry avec votre compte Azure. Votre code n’a pas besoin d’être modifié. Voir la [documentation Azure AI Foundry](https://learn.microsoft.com/azure/ai-foundry/foundry-models/how-to/quickstart-github-models). + + +## Étape 1 : Configurez votre environnement de développement + + + +Nous avons créé un conteneur de développement préconfiguré pour minimiser le temps d’installation et garantir que vous disposiez de tous les outils nécessaires pour ce cours Generative AI for Java. Choisissez votre approche de développement préférée : + +### Options de configuration de l'environnement : + +#### Option A : GitHub Codespaces (recommandé) + +**Commencez à coder en 2 minutes - aucune configuration locale requise !** + +1. Forkez ce dépôt sur votre compte GitHub + > **Note** : Si vous souhaitez modifier la configuration de base, veuillez consulter la [Configuration du Dev Container](../../../.devcontainer/devcontainer.json) +2. Cliquez sur **Code** → onglet **Codespaces** → **...** → **Nouveau avec options...** +3. Utilisez les valeurs par défaut – cela sélectionnera la **configuration du dev container** : **Environnement de développement Java pour Generative AI** conteneur personnalisé créé pour ce cours +4. Cliquez sur **Créer codespace** +5. Attendez ~2 minutes que l’environnement soit prêt +6. Passez à [Étape 2 : Créer un token GitHub](../../../02-SetupDevEnvironment) + +Capture d'écran : sous-menu Codespaces + +Capture d'écran : Nouveau avec options + +Capture d'écran : Options création codespace + + +> **Avantages de Codespaces** : +> - Aucune installation locale requise +> - Fonctionne sur n'importe quel appareil avec un navigateur +> - Pré-configuré avec tous les outils et dépendances +> - 60 heures gratuites par mois pour les comptes personnels +> - Environnement cohérent pour tous les apprenants + +#### Option B : Conteneur Dev local + +**Pour les développeurs préférant un développement local avec Docker** + +1. Forkez et clonez ce dépôt sur votre machine locale + > **Note** : Si vous souhaitez modifier la configuration de base, veuillez consulter la [Configuration du Dev Container](../../../.devcontainer/devcontainer.json) +2. Installez [Docker Desktop](https://www.docker.com/products/docker-desktop/) et [VS Code](https://code.visualstudio.com/) +3. Installez l’[extension Dev Containers](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers) dans VS Code +4. Ouvrez le dossier du dépôt dans VS Code +5. Lorsque vous y êtes invité, cliquez sur **Réouvrir dans le conteneur** (ou utilisez `Ctrl+Shift+P` → "Dev Containers : Réouvrir dans le conteneur") +6. Attendez que le conteneur soit construit et démarré +7. Passez à [Étape 2 : Créer un token GitHub](../../../02-SetupDevEnvironment) + +Capture d'écran : configuration du dev container + +Capture d'écran : build dev container terminé + +#### Option C : Utilisez votre installation locale existante + +**Pour les développeurs avec un environnement Java existant** + +Prérequis : +- [Java 21+](https://www.oracle.com/java/technologies/javase/jdk21-archive-downloads.html) +- [Maven 3.9+](https://maven.apache.org/download.cgi) +- [VS Code](https://code.visualstudio.com) ou votre IDE préféré + +Étapes : +1. Clonez ce dépôt sur votre machine locale +2. Ouvrez le projet dans votre IDE +3. Passez à [Étape 2 : Créer un token GitHub](../../../02-SetupDevEnvironment) + +> **Astuce Pro** : Si vous avez une machine peu puissante mais souhaitez VS Code en local, utilisez GitHub Codespaces ! Vous pouvez connecter votre VS Code local à un Codespace hébergé dans le cloud pour profiter du meilleur des deux mondes. + +Capture d'écran : instance locale du devcontainer créée + + +## Étape 2 : Créez un token d'accès personnel GitHub + +1. Rendez-vous dans [Paramètres GitHub](https://github.com/settings/profile) et sélectionnez **Paramètres** dans votre menu profil. +2. Dans la barre latérale gauche, cliquez sur **Paramètres développeur** (généralement en bas). +3. Sous **Tokens d'accès personnel**, cliquez sur **Tokens à granularité fine** (ou suivez ce [lien direct](https://github.com/settings/personal-access-tokens)). +4. Cliquez sur **Générer un nouveau token**. +5. Sous "Nom du token", donnez un nom descriptif (ex. : `GenAI-Java-Course-Token`). +6. Définissez une date d'expiration (recommandé : 7 jours pour les bonnes pratiques de sécurité). +7. Sous "Propriétaire de la ressource", sélectionnez votre compte utilisateur. +8. Sous "Accès aux dépôts", sélectionnez les dépôts que vous souhaitez utiliser avec GitHub Models (ou "Tous les dépôts" si nécessaire). +9. Sous "Autorisations du compte", trouvez **Models** et définissez-le en **Lecture seule**. +10. Cliquez sur **Générer le token**. +11. **Copiez et sauvegardez votre token maintenant** – vous ne le verrez plus après ! + +> **Conseil de sécurité** : Utilisez la portée minimale requise et la durée d’expiration la plus courte possible pour vos tokens d’accès. + +## Étape 3 : Testez votre configuration avec l’exemple GitHub Models + +Une fois votre environnement de développement prêt, testons l’intégration des GitHub Models avec notre application exemple dans [`02-SetupDevEnvironment/examples/github-models`](../../../02-SetupDevEnvironment/examples/github-models). + +1. Ouvrez le terminal dans votre environnement de développement. +2. Naviguez vers l’exemple GitHub Models : + ```bash + cd 02-SetupDevEnvironment/examples/github-models + ``` +3. Définissez votre token GitHub comme variable d’environnement : + ```bash + # macOS/Linux + export GITHUB_TOKEN=your_token_here + + # Windows (Invite de commandes) + set GITHUB_TOKEN=your_token_here + + # Windows (PowerShell) + $env:GITHUB_TOKEN="your_token_here" + ``` + +4. Lancez l’application : + ```bash + mvn compile exec:java -Dexec.mainClass="com.example.githubmodels.App" + ``` + +Vous devriez voir une sortie similaire à : +```text +Using model: gpt-4.1-nano +Sending request to GitHub Models... +Response: Hello World! +``` + +### Comprendre le code exemple + +Commençons par comprendre ce que nous venons d’exécuter. L’exemple sous `examples/github-models` utilise le SDK OpenAI Java pour se connecter aux GitHub Models : + +**Ce que ce code fait :** +- **Se connecte** aux GitHub Models en utilisant votre token d'accès personnel +- **Envoie** un message simple "Say Hello World!" au modèle d’IA +- **Reçoit** et affiche la réponse de l’IA +- **Valide** que votre configuration fonctionne correctement + +**Dépendance clé** (dans `pom.xml`) : +```xml + + com.openai + openai-java + 2.12.0 + +``` + +**Code principal** (`App.java`) : +```java +// Se connecter aux modèles GitHub en utilisant le SDK Java OpenAI +OpenAIClient client = OpenAIOkHttpClient.builder() + .apiKey(pat) + .baseUrl("https://models.inference.ai.azure.com") + .build(); + +// Créer une requête de complétion de chat +ChatCompletionCreateParams params = ChatCompletionCreateParams.builder() + .model(modelId) + .addSystemMessage("You are a concise assistant.") + .addUserMessage("Say Hello World!") + .build(); + +// Obtenir la réponse de l'IA +ChatCompletion response = client.chat().completions().create(params); +System.out.println("Response: " + response.choices().get(0).message().content().orElse("No response content")); +``` + +## Résumé + +Super ! Vous avez maintenant tout configuré : + +- Créé un token d’accès personnel GitHub avec les bonnes permissions pour accéder aux modèles IA +- Mis en place votre environnement de développement Java (que ce soit Codespaces, conteneurs dev ou local) +- Connecté aux GitHub Models en utilisant le SDK OpenAI Java pour un développement IA gratuit +- Testé que tout fonctionne avec un exemple simple qui dialogue avec les modèles IA + +## Étapes suivantes + +[Chapitre 3 : Techniques principales de Generative AI](../03-CoreGenerativeAITechniques/README.md) + +## Dépannage + +Vous rencontrez des problèmes ? Voici les problèmes courants et leurs solutions : + +- **Le token ne fonctionne pas ?** + - Assurez-vous d’avoir copié le token en entier sans espaces supplémentaires + - Vérifiez que le token est bien défini comme variable d’environnement + - Vérifiez que votre token a les bonnes permissions (Models : Lecture seule) + +- **Maven introuvable ?** + - Si vous utilisez dev containers/Codespaces, Maven est normalement préinstallé + - Pour une installation locale, assurez-vous que Java 21+ et Maven 3.9+ sont installés + - Essayez `mvn --version` pour vérifier l’installation + +- **Problèmes de connexion ?** + - Vérifiez votre connexion internet + - Assurez-vous que GitHub est accessible depuis votre réseau + - Vérifiez que vous n’êtes pas derrière un pare-feu bloquant l’endpoint GitHub Models + +- **Le conteneur dev ne démarre pas ?** + - Assurez-vous que Docker Desktop est bien lancé (pour le développement local) + - Essayez de reconstruire le conteneur : `Ctrl+Shift+P` → "Dev Containers : Rebuild Container" + +- **Erreurs de compilation de l'application ?** + - Assurez-vous d’être dans le bon répertoire : `02-SetupDevEnvironment/examples/github-models` + - Essayez de nettoyer et reconstruire : `mvn clean compile` + +> **Besoin d’aide ?** : Toujours des problèmes ? Ouvrez une issue dans le dépôt et nous vous aiderons. --- + +**Avertissement** : +Ce document a été traduit à l’aide du service de traduction automatique [Co-op Translator](https://github.com/Azure/co-op-translator). Bien que nous nous efforcions d’assurer l’exactitude, veuillez noter que les traductions automatiques peuvent comporter des erreurs ou des inexactitudes. Le document original dans sa langue d’origine doit être considéré comme la source faisant autorité. Pour les informations critiques, une traduction humaine professionnelle est recommandée. Nous déclinons toute responsabilité en cas de malentendus ou de mauvaises interprétations résultant de l’utilisation de cette traduction. + \ No newline at end of file diff --git a/translations/fr/02-SetupDevEnvironment/examples/basic-chat-azure/README.md b/translations/fr/02-SetupDevEnvironment/examples/basic-chat-azure/README.md index 6f050e58..2c9468b8 100644 --- a/translations/fr/02-SetupDevEnvironment/examples/basic-chat-azure/README.md +++ b/translations/fr/02-SetupDevEnvironment/examples/basic-chat-azure/README.md @@ -1,12 +1,3 @@ - # Chat de Base avec Azure OpenAI - Exemple de Bout en Bout Cet exemple montre comment créer une application Spring Boot simple qui se connecte à Azure OpenAI et teste votre configuration. diff --git a/translations/fr/02-SetupDevEnvironment/getting-started-azure-openai.md b/translations/fr/02-SetupDevEnvironment/getting-started-azure-openai.md index 83d6a531..05e66a2b 100644 --- a/translations/fr/02-SetupDevEnvironment/getting-started-azure-openai.md +++ b/translations/fr/02-SetupDevEnvironment/getting-started-azure-openai.md @@ -1,12 +1,3 @@ - # Configuration de l'environnement de développement pour Azure OpenAI > **Démarrage rapide** : Ce guide est destiné à la configuration d'Azure OpenAI. Pour un démarrage immédiat avec des modèles gratuits, utilisez [GitHub Models avec Codespaces](./README.md#quick-start-cloud). diff --git a/translations/fr/03-CoreGenerativeAITechniques/README.md b/translations/fr/03-CoreGenerativeAITechniques/README.md index eacbd76d..43fdb021 100644 --- a/translations/fr/03-CoreGenerativeAITechniques/README.md +++ b/translations/fr/03-CoreGenerativeAITechniques/README.md @@ -1,12 +1,3 @@ - # Tutoriel sur les techniques fondamentales de l'IA générative ## Table des matières diff --git a/translations/fr/04-PracticalSamples/README.md b/translations/fr/04-PracticalSamples/README.md index de6b2ad1..49ae8850 100644 --- a/translations/fr/04-PracticalSamples/README.md +++ b/translations/fr/04-PracticalSamples/README.md @@ -1,12 +1,3 @@ - # Applications Pratiques & Projets ## Ce Que Vous Allez Apprendre diff --git a/translations/fr/04-PracticalSamples/calculator/README.md b/translations/fr/04-PracticalSamples/calculator/README.md index 9fb46d2a..f0a5f3be 100644 --- a/translations/fr/04-PracticalSamples/calculator/README.md +++ b/translations/fr/04-PracticalSamples/calculator/README.md @@ -1,12 +1,3 @@ - # Tutoriel du Calculateur MCP pour Débutants ## Table des Matières diff --git a/translations/fr/04-PracticalSamples/foundrylocal/README.md b/translations/fr/04-PracticalSamples/foundrylocal/README.md index d5eb9b7c..1fb04063 100644 --- a/translations/fr/04-PracticalSamples/foundrylocal/README.md +++ b/translations/fr/04-PracticalSamples/foundrylocal/README.md @@ -1,12 +1,3 @@ - # Tutoriel Foundry Local avec Spring Boot ## Table des matières diff --git a/translations/fr/04-PracticalSamples/petstory/README.md b/translations/fr/04-PracticalSamples/petstory/README.md index b1a7c1b9..861b6911 100644 --- a/translations/fr/04-PracticalSamples/petstory/README.md +++ b/translations/fr/04-PracticalSamples/petstory/README.md @@ -1,12 +1,3 @@ - # Tutoriel du générateur d'histoires pour animaux de compagnie pour débutants ## Table des matières diff --git a/translations/fr/05-ResponsibleGenAI/README.md b/translations/fr/05-ResponsibleGenAI/README.md index edda258b..e7da25a2 100644 --- a/translations/fr/05-ResponsibleGenAI/README.md +++ b/translations/fr/05-ResponsibleGenAI/README.md @@ -1,12 +1,3 @@ - # IA Générative Responsable ## Ce que vous allez apprendre diff --git a/translations/fr/AGENTS.md b/translations/fr/AGENTS.md index bab5f9fb..47276110 100644 --- a/translations/fr/AGENTS.md +++ b/translations/fr/AGENTS.md @@ -1,12 +1,3 @@ - # AGENTS.md ## Aperçu du projet diff --git a/translations/fr/CODE_OF_CONDUCT.md b/translations/fr/CODE_OF_CONDUCT.md index 5e204122..9d28d140 100644 --- a/translations/fr/CODE_OF_CONDUCT.md +++ b/translations/fr/CODE_OF_CONDUCT.md @@ -1,12 +1,3 @@ - # Code de conduite Open Source de Microsoft Ce projet a adopté le [Code de conduite Open Source de Microsoft](https://opensource.microsoft.com/codeofconduct/). diff --git a/translations/fr/README.md b/translations/fr/README.md index c200d37d..0e62b189 100644 --- a/translations/fr/README.md +++ b/translations/fr/README.md @@ -1,90 +1,81 @@ - -# IA Générative pour Débutants - Édition Java +# Intelligence Artificielle Générative pour Débutants - Édition Java [![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) -![IA Générative pour Débutants - Édition Java](../../translated_images/fr/beg-genai-series.8b48be9951cc574c.webp) +![Generative AI for Beginners - Java Edition](../../translated_images/fr/beg-genai-series.8b48be9951cc574c.webp) -**Temps requis** : L’atelier complet peut être réalisé en ligne sans configuration locale. La mise en place de l’environnement prend 2 minutes, l’exploration des exemples nécessite 1 à 3 heures selon la profondeur de l’exploration. +**Temps d'engagement** : L'atelier complet peut être réalisé en ligne sans installation locale. La configuration de l'environnement prend 2 minutes, et l'exploration des exemples nécessite 1 à 3 heures selon la profondeur de l'exploration. > **Démarrage rapide** -1. Créez un fork de ce dépôt vers votre compte GitHub +1. Forkez ce dépôt sur votre compte GitHub 2. Cliquez sur **Code** → onglet **Codespaces** → **...** → **Nouveau avec options...** -3. Utilisez les paramètres par défaut – cela sélectionnera le conteneur de développement créé pour ce cours -4. Cliquez sur **Créer codespace** -5. Attendez environ 2 minutes que l’environnement soit prêt +3. Utilisez les valeurs par défaut – cela sélectionnera le conteneur de développement créé pour ce cours +4. Cliquez sur **Créer un codespace** +5. Attendez environ 2 minutes que l'environnement soit prêt 6. Passez directement à [Le premier exemple](./02-SetupDevEnvironment/README.md#step-2-create-a-github-personal-access-token) -> **Vous préférez Cloner en Local ?** +> **Vous préférez cloner localement ?** > -> Ce dépôt comprend plus de 50 traductions de langues, ce qui augmente significativement la taille du téléchargement. Pour cloner sans les traductions, utilisez le sparse checkout : +> Ce dépôt inclut plus de 50 traductions linguistiques ce qui augmente significativement la taille du téléchargement. Pour cloner sans les traductions, utilisez Sparse Checkout : > ```bash > git clone --filter=blob:none --sparse https://github.com/microsoft/Generative-AI-for-beginners-java.git > cd Generative-AI-for-beginners-java > git sparse-checkout set --no-cone '/*' '!translations' '!translated_images' > ``` -> Cela vous donne tout ce dont vous avez besoin pour suivre le cours avec un téléchargement beaucoup plus rapide. +> Cela vous fournit tout ce dont vous avez besoin pour compléter le cours avec un téléchargement beaucoup plus rapide. ## Support Multilingue -### Pris en charge via GitHub Action (Automatisé et Toujours à Jour) +### Pris en charge via GitHub Action (Automatisé et toujours à jour) -[Arabe](../ar/README.md) | [Bengali](../bn/README.md) | [Bulgare](../bg/README.md) | [Birman (Myanmar)](../my/README.md) | [Chinois (Simplifié)](../zh/README.md) | [Chinois (Traditionnel, Hong Kong)](../hk/README.md) | [Chinois (Traditionnel, Macao)](../mo/README.md) | [Chinois (Traditionnel, Taïwan)](../tw/README.md) | [Croate](../hr/README.md) | [Tchèque](../cs/README.md) | [Danois](../da/README.md) | [Néerlandais](../nl/README.md) | [Estonien](../et/README.md) | [Finnois](../fi/README.md) | [Français](./README.md) | [Allemand](../de/README.md) | [Grec](../el/README.md) | [Hébreu](../he/README.md) | [Hindi](../hi/README.md) | [Hongrois](../hu/README.md) | [Indonésien](../id/README.md) | [Italien](../it/README.md) | [Japonais](../ja/README.md) | [Kannada](../kn/README.md) | [Coréen](../ko/README.md) | [Lituanien](../lt/README.md) | [Malais](../ms/README.md) | [Malayalam](../ml/README.md) | [Marathi](../mr/README.md) | [Népalais](../ne/README.md) | [Pidgin nigérian](../pcm/README.md) | [Norvégien](../no/README.md) | [Persan (Farsi)](../fa/README.md) | [Polonais](../pl/README.md) | [Portugais (Brésil)](../br/README.md) | [Portugais (Portugal)](../pt/README.md) | [Punjabi (Gurmukhi)](../pa/README.md) | [Roumain](../ro/README.md) | [Russe](../ru/README.md) | [Serbe (Cyrillique)](../sr/README.md) | [Slovaque](../sk/README.md) | [Slovène](../sl/README.md) | [Espagnol](../es/README.md) | [Swahili](../sw/README.md) | [Suédois](../sv/README.md) | [Tagalog (Filipino)](../tl/README.md) | [Tamil](../ta/README.md) | [Télougou](../te/README.md) | [Thaï](../th/README.md) | [Turc](../tr/README.md) | [Ukrainien](../uk/README.md) | [Ourdou](../ur/README.md) | [Vietnamien](../vi/README.md) +[Arabe](../ar/README.md) | [Bengali](../bn/README.md) | [Bulgare](../bg/README.md) | [Birman (Myanmar)](../my/README.md) | [Chinois (Simplifié)](../zh-CN/README.md) | [Chinois (Traditionnel, Hong Kong)](../zh-HK/README.md) | [Chinois (Traditionnel, Macao)](../zh-MO/README.md) | [Chinois (Traditionnel, Taïwan)](../zh-TW/README.md) | [Croate](../hr/README.md) | [Tchèque](../cs/README.md) | [Danois](../da/README.md) | [Néerlandais](../nl/README.md) | [Estonien](../et/README.md) | [Finnois](../fi/README.md) | [Français](./README.md) | [Allemand](../de/README.md) | [Grec](../el/README.md) | [Hébreu](../he/README.md) | [Hindi](../hi/README.md) | [Hongrois](../hu/README.md) | [Indonésien](../id/README.md) | [Italien](../it/README.md) | [Japonais](../ja/README.md) | [Kannada](../kn/README.md) | [Coréen](../ko/README.md) | [Lituanien](../lt/README.md) | [Malais](../ms/README.md) | [Malayalam](../ml/README.md) | [Marathi](../mr/README.md) | [Népalais](../ne/README.md) | [Pidgin nigérian](../pcm/README.md) | [Norvégien](../no/README.md) | [Persan (Farsi)](../fa/README.md) | [Polonais](../pl/README.md) | [Portugais (Brésil)](../pt-BR/README.md) | [Portugais (Portugal)](../pt-PT/README.md) | [Pendjabi (Gurmukhi)](../pa/README.md) | [Roumain](../ro/README.md) | [Russe](../ru/README.md) | [Serbe (Cyrillique)](../sr/README.md) | [Slovaque](../sk/README.md) | [Slovène](../sl/README.md) | [Espagnol](../es/README.md) | [Swahili](../sw/README.md) | [Suédois](../sv/README.md) | [Tagalog (Filipino)](../tl/README.md) | [Tamoul](../ta/README.md) | [Télougou](../te/README.md) | [Thaï](../th/README.md) | [Turc](../tr/README.md) | [Ukrainien](../uk/README.md) | [Ourdou](../ur/README.md) | [Vietnamien](../vi/README.md) -> **Vous préférez Cloner en Local ?** +> **Vous préférez cloner localement ?** -> Ce dépôt comprend plus de 50 traductions de langues, ce qui augmente significativement la taille du téléchargement. Pour cloner sans les traductions, utilisez le sparse checkout : +> Ce dépôt inclut plus de 50 traductions linguistiques ce qui augmente significativement la taille du téléchargement. Pour cloner sans les traductions, utilisez Sparse Checkout : > ```bash > git clone --filter=blob:none --sparse https://github.com/microsoft/Generative-AI-for-beginners-java.git > cd Generative-AI-for-beginners-java > git sparse-checkout set --no-cone '/*' '!translations' '!translated_images' > ``` -> Cela vous donne tout ce dont vous avez besoin pour suivre le cours avec un téléchargement beaucoup plus rapide. +> Cela vous fournit tout ce dont vous avez besoin pour compléter le cours avec un téléchargement beaucoup plus rapide. -## Structure du Cours & Parcours d’Apprentissage +## Structure du Cours & Parcours d'Apprentissage -### **Chapitre 1 : Introduction à l’IA Générative** -- **Concepts clés** : Comprendre les grands modèles de langage, les tokens, les embeddings et les capacités de l’IA -- **Écosystème Java AI** : Vue d’ensemble des SDK Spring AI et OpenAI -- **Protocole du Contexte du Modèle** : Introduction au MCP et son rôle dans la communication des agents IA -- **Applications pratiques** : Scénarios réels incluant chatbots et génération de contenu +### **Chapitre 1 : Introduction à l'IA Générative** +- **Concepts Clés** : Comprendre les grands modèles de langage, les tokens, les embeddings et les capacités de l'IA +- **Écosystème Java AI** : Vue d'ensemble des SDK Spring AI et OpenAI +- **Protocole de Contexte du Modèle** : Introduction au MCP et son rôle dans la communication des agents IA +- **Applications Pratiques** : Scénarios réels comprenant chatbots et génération de contenu - **[→ Commencer le Chapitre 1](./01-IntroToGenAI/README.md)** -### **Chapitre 2 : Configuration de l’Environnement de Développement** -- **Configuration multi-fournisseurs** : Mise en place des modèles GitHub, Azure OpenAI, et intégrations OpenAI Java SDK -- **Spring Boot + Spring AI** : Bonnes pratiques pour le développement d’applications IA en entreprise -- **Modèles GitHub** : Accès gratuit aux modèles IA pour prototypage et apprentissage (sans carte bancaire requise) -- **Outils de développement** : Configuration des conteneurs Docker, VS Code, et GitHub Codespaces +### **Chapitre 2 : Configuration de l'Environnement de Développement** +- **Configuration Multi-Fournisseurs** : Mise en place des GitHub Models, Azure OpenAI, et intégrations OpenAI Java SDK +- **Spring Boot + Spring AI** : Bonnes pratiques pour le développement d'applications IA d'entreprise +- **GitHub Models** : Accès gratuit aux modèles IA pour prototypage et apprentissage (pas besoin de carte bancaire) +- **Outils de Développement** : Conteneurs Docker, VS Code, et configuration GitHub Codespaces - **[→ Commencer le Chapitre 2](./02-SetupDevEnvironment/README.md)** -### **Chapitre 3 : Techniques Fondamentales de l’IA Générative** -- **Prompt Engineering** : Techniques pour des réponses optimales des modèles IA -- **Embeddings & Opérations Vectorielles** : Implémentez la recherche sémantique et le jumelage de similarité -- **Génération Améliorée par Récupération (RAG)** : Combinez l’IA avec vos propres sources de données -- **Appel de Fonctions** : Étendez les capacités de l’IA avec des outils et plugins personnalisés +### **Chapitre 3 : Techniques Fondamentales de l'IA Générative** +- **Conception de Prompts** : Techniques pour des réponses optimales du modèle IA +- **Embeddings & Opérations Vectorielles** : Implémenter la recherche sémantique et la mise en correspondance de similarités +- **Génération Augmentée par Recherche (RAG)** : Combiner l'IA avec vos propres sources de données +- **Appel de Fonction** : Étendre les capacités de l'IA avec des outils et plugins personnalisés - **[→ Commencer le Chapitre 3](./03-CoreGenerativeAITechniques/README.md)** ### **Chapitre 4 : Applications Pratiques & Projets** -- **Générateur d’Histoires d’Animaux** (`petstory/`) : Génération créative de contenu avec les modèles GitHub -- **Démo Foundry Local** (`foundrylocal/`) : Intégration locale des modèles IA avec OpenAI Java SDK -- **Service de Calculateur MCP** (`calculator/`) : Implémentation basique du Protocole du Contexte du Modèle avec Spring AI +- **Générateur d'histoires pour animaux** (`petstory/`) : Génération créative de contenu avec GitHub Models +- **Démo locale Foundry** (`foundrylocal/`) : Intégration locale de modèles IA avec OpenAI Java SDK +- **Service Calculateur MCP** (`calculator/`) : Implémentation basique du protocole de contexte de modèle avec Spring AI - **[→ Commencer le Chapitre 4](./04-PracticalSamples/README.md)** -### **Chapitre 5 : Développement Responsable de l’IA** -- **Sécurité des Modèles GitHub** : Testez les filtres de contenu intégrés et les mécanismes de sécurité (blocages stricts et refus souples) -- **Démonstration d’IA Responsable** : Exemple pratique montrant le fonctionnement des systèmes de sécurité IA modernes -- **Meilleures Pratiques** : Directives essentielles pour un développement et un déploiement éthiques de l’IA +### **Chapitre 5 : Développement Responsable en IA** +- **Sécurité GitHub Models** : Tester les filtres de contenu intégrés et mécanismes de sécurité (bloquages stricts et refus doux) +- **Démo d'IA Responsable** : Exemple pratique montrant le fonctionnement des systèmes modernes de sécurité IA +- **Bonnes Pratiques** : Directives essentielles pour un développement et un déploiement éthiques de l'IA - **[→ Commencer le Chapitre 5](./05-ResponsibleGenAI/README.md)** ## Ressources Supplémentaires @@ -105,7 +96,7 @@ CO_OP_TRANSLATOR_METADATA: --- ### Série IA Générative -[![IA Générative pour Débutants](https://img.shields.io/badge/Generative%20AI%20for%20Beginners-8B5CF6?style=for-the-badge&labelColor=E5E7EB&color=8B5CF6)](https://github.com/microsoft/generative-ai-for-beginners?WT.mc_id=academic-105485-koreyst) +[![Intelligence Artificielle Générative pour Débutants](https://img.shields.io/badge/Generative%20AI%20for%20Beginners-8B5CF6?style=for-the-badge&labelColor=E5E7EB&color=8B5CF6)](https://github.com/microsoft/generative-ai-for-beginners?WT.mc_id=academic-105485-koreyst) [![IA Générative (.NET)](https://img.shields.io/badge/Generative%20AI%20(.NET)-9333EA?style=for-the-badge&labelColor=E5E7EB&color=9333EA)](https://github.com/microsoft/Generative-AI-for-beginners-dotnet?WT.mc_id=academic-105485-koreyst) [![IA Générative (Java)](https://img.shields.io/badge/Generative%20AI%20(Java)-C084FC?style=for-the-badge&labelColor=E5E7EB&color=C084FC)](https://github.com/microsoft/generative-ai-for-beginners-java?WT.mc_id=academic-105485-koreyst) [![IA Générative (JavaScript)](https://img.shields.io/badge/Generative%20AI%20(JavaScript)-E879F9?style=for-the-badge&labelColor=E5E7EB&color=E879F9)](https://github.com/microsoft/generative-ai-with-javascript?WT.mc_id=academic-105485-koreyst) @@ -117,21 +108,21 @@ CO_OP_TRANSLATOR_METADATA: [![Science des Données pour Débutants](https://img.shields.io/badge/Data%20Science%20for%20Beginners-84CC16?style=for-the-badge&labelColor=E5E7EB&color=84CC16)](https://aka.ms/datascience-beginners?WT.mc_id=academic-105485-koreyst) [![IA pour Débutants](https://img.shields.io/badge/AI%20for%20Beginners-A3E635?style=for-the-badge&labelColor=E5E7EB&color=A3E635)](https://aka.ms/ai-beginners?WT.mc_id=academic-105485-koreyst) [![Cybersécurité pour Débutants](https://img.shields.io/badge/Cybersecurity%20for%20Beginners-F97316?style=for-the-badge&labelColor=E5E7EB&color=F97316)](https://github.com/microsoft/Security-101?WT.mc_id=academic-96948-sayoung) -[![Développement Web pour Débutants](https://img.shields.io/badge/Web%20Dev%20for%20Beginners-EC4899?style=for-the-badge&labelColor=E5E7EB&color=EC4899)](https://aka.ms/webdev-beginners?WT.mc_id=academic-105485-koreyst) -[![IoT pour débutants](https://img.shields.io/badge/IoT%20for%20Beginners-14B8A6?style=for-the-badge&labelColor=E5E7EB&color=14B8A6)](https://aka.ms/iot-beginners?WT.mc_id=academic-105485-koreyst) -[![Développement XR pour débutants](https://img.shields.io/badge/XR%20Development%20for%20Beginners-38BDF8?style=for-the-badge&labelColor=E5E7EB&color=38BDF8)](https://github.com/microsoft/xr-development-for-beginners?WT.mc_id=academic-105485-koreyst) +[![Web Dev for Beginners](https://img.shields.io/badge/Web%20Dev%20for%20Beginners-EC4899?style=for-the-badge&labelColor=E5E7EB&color=EC4899)](https://aka.ms/webdev-beginners?WT.mc_id=academic-105485-koreyst) +[![IoT for Beginners](https://img.shields.io/badge/IoT%20for%20Beginners-14B8A6?style=for-the-badge&labelColor=E5E7EB&color=14B8A6)](https://aka.ms/iot-beginners?WT.mc_id=academic-105485-koreyst) +[![XR Development for Beginners](https://img.shields.io/badge/XR%20Development%20for%20Beginners-38BDF8?style=for-the-badge&labelColor=E5E7EB&color=38BDF8)](https://github.com/microsoft/xr-development-for-beginners?WT.mc_id=academic-105485-koreyst) --- ### Série Copilot -[![Copilot pour la programmation assistée par IA](https://img.shields.io/badge/Copilot%20for%20AI%20Paired%20Programming-FACC15?style=for-the-badge&labelColor=E5E7EB&color=FACC15)](https://aka.ms/GitHubCopilotAI?WT.mc_id=academic-105485-koreyst) -[![Copilot pour C#/.NET](https://img.shields.io/badge/Copilot%20for%20C%23/.NET-FBBF24?style=for-the-badge&labelColor=E5E7EB&color=FBBF24)](https://github.com/microsoft/mastering-github-copilot-for-dotnet-csharp-developers?WT.mc_id=academic-105485-koreyst) -[![Aventure Copilot](https://img.shields.io/badge/Copilot%20Adventure-FDE68A?style=for-the-badge&labelColor=E5E7EB&color=FDE68A)](https://github.com/microsoft/CopilotAdventures?WT.mc_id=academic-105485-koreyst) +[![Copilot for AI Paired Programming](https://img.shields.io/badge/Copilot%20for%20AI%20Paired%20Programming-FACC15?style=for-the-badge&labelColor=E5E7EB&color=FACC15)](https://aka.ms/GitHubCopilotAI?WT.mc_id=academic-105485-koreyst) +[![Copilot for C#/.NET](https://img.shields.io/badge/Copilot%20for%20C%23/.NET-FBBF24?style=for-the-badge&labelColor=E5E7EB&color=FBBF24)](https://github.com/microsoft/mastering-github-copilot-for-dotnet-csharp-developers?WT.mc_id=academic-105485-koreyst) +[![Copilot Adventure](https://img.shields.io/badge/Copilot%20Adventure-FDE68A?style=for-the-badge&labelColor=E5E7EB&color=FDE68A)](https://github.com/microsoft/CopilotAdventures?WT.mc_id=academic-105485-koreyst) ## Obtenir de l’aide -Si vous êtes bloqué ou avez des questions sur la création d’applications IA. Rejoignez d’autres apprenants et développeurs expérimentés dans les discussions sur MCP. C’est une communauté bienveillante où les questions sont les bienvenues et le savoir est partagé librement. +Si vous êtes bloqué ou avez des questions sur la création d'applications d'IA. Rejoignez d'autres apprenants et développeurs expérimentés dans les discussions sur MCP. C’est une communauté bienveillante où les questions sont les bienvenues et où le savoir est partagé librement. [![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) @@ -142,6 +133,6 @@ Si vous avez des retours sur le produit ou des erreurs lors de la création, vis --- -**Avertissement** : -Ce document a été traduit à l'aide du service de traduction automatique [Co-op Translator](https://github.com/Azure/co-op-translator). Bien que nous nous efforcions d'assurer l'exactitude, veuillez noter que les traductions automatiques peuvent contenir des erreurs ou des inexactitudes. Le document original dans sa langue d'origine doit être considéré comme la source faisant foi. Pour toute information critique, il est recommandé de recourir à une traduction professionnelle humaine. Nous ne sommes pas responsables des éventuels malentendus ou interprétations erronées résultant de l'utilisation de cette traduction. +**Avertissement** : +Ce document a été traduit à l’aide du service de traduction automatique [Co-op Translator](https://github.com/Azure/co-op-translator). Bien que nous nous efforcions d’assurer l’exactitude, veuillez noter que les traductions automatisées peuvent contenir des erreurs ou des inexactitudes. Le document original dans sa langue natale doit être considéré comme la source officielle. Pour les informations critiques, une traduction professionnelle humaine est recommandée. Nous ne sommes pas responsables des éventuels malentendus ou mauvaises interprétations résultant de l’utilisation de cette traduction. \ No newline at end of file diff --git a/translations/fr/SECURITY.md b/translations/fr/SECURITY.md index bc324035..f94dea02 100644 --- a/translations/fr/SECURITY.md +++ b/translations/fr/SECURITY.md @@ -1,12 +1,3 @@ - ## Sécurité Microsoft prend très au sérieux la sécurité de ses produits logiciels et services, y compris tous les dépôts de code source gérés via nos organisations GitHub, qui incluent [Microsoft](https://github.com/Microsoft), [Azure](https://github.com/Azure), [DotNet](https://github.com/dotnet), [AspNet](https://github.com/aspnet) et [Xamarin](https://github.com/xamarin). diff --git a/translations/fr/SUPPORT.md b/translations/fr/SUPPORT.md index 118cdcbf..8b204af3 100644 --- a/translations/fr/SUPPORT.md +++ b/translations/fr/SUPPORT.md @@ -1,12 +1,3 @@ - # Support ## Comment signaler des problèmes et obtenir de l'aide diff --git a/translations/he/.co-op-translator.json b/translations/he/.co-op-translator.json new file mode 100644 index 00000000..16779733 --- /dev/null +++ b/translations/he/.co-op-translator.json @@ -0,0 +1,92 @@ +{ + "01-IntroToGenAI/README.md": { + "original_hash": "75bfb080ca725e8a9aa9c80cae25fba1", + "translation_date": "2025-07-29T09:39:40+00:00", + "source_file": "01-IntroToGenAI/README.md", + "language_code": "he" + }, + "02-SetupDevEnvironment/README.md": { + "original_hash": "96a30d42b9751a3d4e4b20e28d29d459", + "translation_date": "2026-01-28T05:08:45+00:00", + "source_file": "02-SetupDevEnvironment/README.md", + "language_code": "he" + }, + "02-SetupDevEnvironment/examples/basic-chat-azure/README.md": { + "original_hash": "efd82efe50711d7e257eb943151d682c", + "translation_date": "2025-07-27T13:43:47+00:00", + "source_file": "02-SetupDevEnvironment/examples/basic-chat-azure/README.md", + "language_code": "he" + }, + "02-SetupDevEnvironment/getting-started-azure-openai.md": { + "original_hash": "bfdb4b4eadbee3a59ef742439f58326a", + "translation_date": "2025-07-27T13:17:23+00:00", + "source_file": "02-SetupDevEnvironment/getting-started-azure-openai.md", + "language_code": "he" + }, + "03-CoreGenerativeAITechniques/README.md": { + "original_hash": "685f55cb07de19b52a30ce6e8b6d889e", + "translation_date": "2025-08-28T22:10:24+00:00", + "source_file": "03-CoreGenerativeAITechniques/README.md", + "language_code": "he" + }, + "04-PracticalSamples/README.md": { + "original_hash": "14c0a61ecc1cd2012a9c129236dfdf71", + "translation_date": "2025-07-29T09:39:26+00:00", + "source_file": "04-PracticalSamples/README.md", + "language_code": "he" + }, + "04-PracticalSamples/calculator/README.md": { + "original_hash": "b6c16b5514d524e415a94f6097ee7d4c", + "translation_date": "2025-09-18T15:35:57+00:00", + "source_file": "04-PracticalSamples/calculator/README.md", + "language_code": "he" + }, + "04-PracticalSamples/foundrylocal/README.md": { + "original_hash": "f787307400de59adc25a1404466a35f3", + "translation_date": "2025-11-04T07:28:58+00:00", + "source_file": "04-PracticalSamples/foundrylocal/README.md", + "language_code": "he" + }, + "04-PracticalSamples/petstory/README.md": { + "original_hash": "0cbf68d605615a1e602c832a24616859", + "translation_date": "2025-07-25T11:39:11+00:00", + "source_file": "04-PracticalSamples/petstory/README.md", + "language_code": "he" + }, + "05-ResponsibleGenAI/README.md": { + "original_hash": "301c05c2f57e60a6950b8c665b8bdbba", + "translation_date": "2025-07-29T15:54:32+00:00", + "source_file": "05-ResponsibleGenAI/README.md", + "language_code": "he" + }, + "AGENTS.md": { + "original_hash": "afc90918d008cf77fd1982691f681306", + "translation_date": "2025-10-03T08:39:07+00:00", + "source_file": "AGENTS.md", + "language_code": "he" + }, + "CODE_OF_CONDUCT.md": { + "original_hash": "442b123d034f92f7c384d2bbd28f99f1", + "translation_date": "2025-07-21T19:08:43+00:00", + "source_file": "CODE_OF_CONDUCT.md", + "language_code": "he" + }, + "README.md": { + "original_hash": "125a08948d881c95628094f4dd1fbd43", + "translation_date": "2026-01-29T15:57:35+00:00", + "source_file": "README.md", + "language_code": "he" + }, + "SECURITY.md": { + "original_hash": "57f14126c1c6add76b3aef3844dfe4e3", + "translation_date": "2025-07-21T19:06:59+00:00", + "source_file": "SECURITY.md", + "language_code": "he" + }, + "SUPPORT.md": { + "original_hash": "b8ef73cc49dec68e2c885ee9df545129", + "translation_date": "2025-07-21T19:09:54+00:00", + "source_file": "SUPPORT.md", + "language_code": "he" + } +} \ No newline at end of file diff --git a/translations/he/01-IntroToGenAI/README.md b/translations/he/01-IntroToGenAI/README.md index 6ee0b171..313afcb9 100644 --- a/translations/he/01-IntroToGenAI/README.md +++ b/translations/he/01-IntroToGenAI/README.md @@ -1,12 +1,3 @@ - # מבוא ל-AI גנרטיבי - מהדורת Java ## מה תלמדו diff --git a/translations/he/02-SetupDevEnvironment/README.md b/translations/he/02-SetupDevEnvironment/README.md index 80282040..39d7a7ec 100644 --- a/translations/he/02-SetupDevEnvironment/README.md +++ b/translations/he/02-SetupDevEnvironment/README.md @@ -1,13 +1,254 @@ - +# הקמת סביבת הפיתוח ל-AI גנרטיבי עבור Java +> **התחלה מהירה**: כתבו קוד בענן תוך 2 דקות - עברו ל-[הגדרת GitHub Codespaces](../../../02-SetupDevEnvironment) - אין צורך בהתקנה מקומית ומשתמש בדגמי github! + +> **מעוניינים ב-Azure OpenAI?**, ראו את [מדריך ההגדרה של Azure OpenAI](getting-started-azure-openai.md) עם צעדים ליצירת משאב Azure OpenAI חדש. + +## מה תלמדו + +- הקמת סביבת פיתוח Java ליישומי AI +- בחירת והגדרת סביבת הפיתוח המועדפת עליכם (cloud-first עם Codespaces, מכולת פיתוח מקומית, או התקנה מקומית מלאה) +- בדיקת ההגדרה שלכם על ידי חיבור לדגמי GitHub + +## תוכן העניינים + +- [מה תלמדו](../../../02-SetupDevEnvironment) +- [מבוא](../../../02-SetupDevEnvironment) +- [שלב 1: הקמת סביבת הפיתוח שלכם](../../../02-SetupDevEnvironment) + - [אפשרות א: GitHub Codespaces (מומלץ)](../../../02-SetupDevEnvironment) + - [אפשרות ב: מכולת פיתוח מקומית](../../../02-SetupDevEnvironment) + - [אפשרות ג: השתמשו בהתקנה מקומית קיימת](../../../02-SetupDevEnvironment) +- [שלב 2: יצירת אסימון גישה אישי GitHub](../../../02-SetupDevEnvironment) +- [שלב 3: בדיקת ההגדרה שלכם](../../../02-SetupDevEnvironment) +- [פתרון בעיות](../../../02-SetupDevEnvironment) +- [סיכום](../../../02-SetupDevEnvironment) +- [השלבים הבאים](../../../02-SetupDevEnvironment) + +## מבוא + +פרק זה ינחה אתכם בהקמת סביבת פיתוח. נשתמש ב**דגמי GitHub** כדוגמה העיקרית כי הם חינמיים, קלים להגדרה עם חשבון GitHub בלבד, לא דורשים כרטיס אשראי, ומציעים גישה למספר דגמים לניסויים. + +**אין צורך בהתקנה מקומית!** אתם יכולים להתחיל לכתוב קוד מיד באמצעות GitHub Codespaces, שמספק סביבת פיתוח מלאה בדפדפן שלכם. + +צילום מסך: דגמי GitHub + +ממליצים להשתמש ב-[**דגמי GitHub**](https://github.com/marketplace?type=models) לקורס זה מפני שהם: +- **חינם** להתחלה +- **קלים** להגדרה עם חשבון GitHub בלבד +- **בלי צורך בכרטיס אשראי** +- **מספר דגמים** זמינים לניסויים + +> **הערה**: לדגמי GitHub בהם משתמשים באימון זה יש הגבלות חינמיות כאלה: +> - 15 בקשות לדקה (150 ביום) +> - כ-8,000 מילים כניסה, כ-4,000 מילים יציאה לכל בקשה +> - 5 בקשות במקביל +> +> לשימוש בביצוע, שדרגו ל-Azure AI Foundry Models עם חשבון Azure שלכם. הקוד שלכם לא יצטרך להשתנות. ראה את [תיעוד Azure AI Foundry](https://learn.microsoft.com/azure/ai-foundry/foundry-models/how-to/quickstart-github-models). + + +## שלב 1: הקמת סביבת הפיתוח שלכם + + + +יצרנו מכולת פיתוח קונפיגורציה מראש כדי לצמצם זמן הקמה ולהבטיח שיש לכם את כל הכלים הנחוצים לקורס AI גנרטיבי עבור Java. בחרו את גישת הפיתוח המועדפת עליכם: + +### אפשרויות הגדרת סביבה: + +#### אפשרות א: GitHub Codespaces (מומלץ) + +**התחילו לכתוב קוד תוך 2 דקות - אין צורך בהתקנה מקומית!** + +1. צרו Fork למאגר זה לחשבון ה-GitHub שלכם + > **הערה**: במידה ואתם רוצים לערוך את ההגדרה הבסיסית, עיינו ב-[Dev Container Configuration](../../../.devcontainer/devcontainer.json) +2. לחצו על **Code** → לשונית **Codespaces** → **...** → **חדש עם אפשרויות...** +3. השתמשו בהגדרות ברירת המחדל – זה יבחר את **Dev container configuration**: **Generative AI Java Development Environment** מכולת הפיתוח המותאמת לקורס זה +4. לחצו על **Create codespace** +5. המתינו כ-2 דקות לסיום ההכנה של הסביבה +6. המשיכו ל[שלב 2: יצירת אסימון GitHub](../../../02-SetupDevEnvironment) + +צילום מסך: תת-תפריט Codespaces + +צילום מסך: חדש עם אפשרויות + +צילום מסך: אפשרויות יצירת codespace + + +> **יתרונות Codespaces**: +> - אין צורך בהתקנה מקומית +> - פועל בכל מכשיר עם דפדפן +> - מוגדר מראש עם כל הכלים וההתלויות +> - 60 שעות חינם בחודש לחשבונות אישיים +> - סביבה עקבית לכל הלומדים + +#### אפשרות ב: מכולת פיתוח מקומית + +**למפתחים שמעדיפים פיתוח מקומי עם Docker** + +1. צרו Fork ו-clone למאגר זה למחשב המקומי שלכם + > **הערה**: במידה ואתם רוצים לערוך את ההגדרה הבסיסית, עיינו ב-[Dev Container Configuration](../../../.devcontainer/devcontainer.json) +2. התקינו את [Docker Desktop](https://www.docker.com/products/docker-desktop/) ו-[VS Code](https://code.visualstudio.com/) +3. התקינו את [הרחבת Dev Containers](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers) ב-VS Code +4. פתחו את תיקיית המאגר ב-VS Code +5. כאשר תתבקשו, לחצו **Reopen in Container** (או הקישו `Ctrl+Shift+P` → "Dev Containers: Reopen in Container") +6. המתינו שהמכולה תיבנה ותתחיל +7. המשיכו ל[שלב 2: יצירת אסימון GitHub](../../../02-SetupDevEnvironment) + +צילום מסך: הגדרת מכולת פיתוח + +צילום מסך: סיום בניית מכולת פיתוח + +#### אפשרות ג: השתמשו בהתקנה מקומית קיימת + +**למפתחים עם סביבות Java קיימות** + +דרישות מוקדמות: +- [Java 21+](https://www.oracle.com/java/technologies/javase/jdk21-archive-downloads.html) +- [Maven 3.9+](https://maven.apache.org/download.cgi) +- [VS Code](https://code.visualstudio.com) או סביבת הפיתוח המועדפת עליכם + +צעדים: +1. העתיקו את המאגר למחשב המקומי שלכם +2. פתחו את הפרויקט ב-IDE שלכם +3. המשיכו ל[שלב 2: יצירת אסימון GitHub](../../../02-SetupDevEnvironment) + +> **טיפ מקצועי**: אם יש לכם מכשיר חלש, אבל רוצים VS Code מקומית, השתמשו ב-GitHub Codespaces! ניתן לחבר את VS Code המקומי שלכם ל-Codespace בענן ולקבל את הטוב משני העולמות. + +צילום מסך: מופע מכולת פיתוח מקומית שנוצרה + + +## שלב 2: יצירת אסימון גישה אישי GitHub + +1. עברו אל [הגדרות GitHub](https://github.com/settings/profile) ובחרו **Settings** מתפריט הפרופיל שלכם. +2. בסרגל הצד השמאלי, לחצו על **Developer settings** (לרוב בתחתית). +3. תחת **Personal access tokens**, לחצו על **Fine-grained tokens** (או גשו ישירות עם [קישור](https://github.com/settings/personal-access-tokens)). +4. לחצו על **Generate new token**. +5. תחת "Token name", כתבו שם מתאר (למשל, `GenAI-Java-Course-Token`). +6. הגדירו תאריך תפוגה (מומלץ: 7 ימים כדי לשמור על בטיחות). +7. תחת "Resource owner", בחרו את חשבון המשתמש שלכם. +8. תחת "Repository access", בחרו את המאגר/ים שברצונכם להשתמש עימם עם דגמי GitHub (או "כל המאגר/ים" במידת הצורך). +9. תחת "Account permissions", מצאו **Models** והגדרו ל**קריאה בלבד**. +10. לחצו על **Generate token**. +11. **העתיקו ושמרו את האסימון עכשיו** – לא תראו אותו שוב! + +> **טיפ ביטחון**: השתמשו בטווח ההרשאות המזערי הדרוש ובזמן תפוגה קצר ככל האפשר לאסימוני הגישה שלכם. + +## שלב 3: בדיקת ההגדרה שלכם עם דוגמת דגמי GitHub + +לאחר שסביבת הפיתוח שלכם מוכנה, בואו נבדוק את האינטגרציה עם דגמי GitHub באמצעות אפליקציית הדוגמה ב-[`02-SetupDevEnvironment/examples/github-models`](../../../02-SetupDevEnvironment/examples/github-models). + +1. פותחים טרמינל בסביבת הפיתוח שלכם. +2. עוברים אל דוגמת דגמי GitHub: + ```bash + cd 02-SetupDevEnvironment/examples/github-models + ``` +3. הגדירו את אסימון GitHub שלכם כמשתנה סביבה: + ```bash + # macOS/Linux + export GITHUB_TOKEN=your_token_here + + # Windows (שורת הפקודה) + set GITHUB_TOKEN=your_token_here + + # Windows (PowerShell) + $env:GITHUB_TOKEN="your_token_here" + ``` + +4. הריצו את האפליקציה: + ```bash + mvn compile exec:java -Dexec.mainClass="com.example.githubmodels.App" + ``` + +תראו פלט דומה ל: +```text +Using model: gpt-4.1-nano +Sending request to GitHub Models... +Response: Hello World! +``` + +### הבנת קוד הדוגמה + +קודם כל, נבין מה הרצנו עכשיו. הדוגמה תחת `examples/github-models` משתמשת ב-SDK של OpenAI ל-Java כדי להתחבר לדגמי GitHub: + +**מה הקוד הזה עושה:** +- **מתחבר** לדגמי GitHub באמצעות אסימון הגישה האישי שלכם +- **שולח** הודעה פשוטה "Say Hello World!" למודל ה-AI +- **מקבל** ומציג את התגובה של ה-AI +- **מאמת** שההגדרה שלכם פועלת כראוי + +**תלות עיקרית** (ב-`pom.xml`): +```xml + + com.openai + openai-java + 2.12.0 + +``` + +**קוד ראשי** (`App.java`): +```java +// התחבר למודלים של GitHub באמצעות OpenAI Java SDK +OpenAIClient client = OpenAIOkHttpClient.builder() + .apiKey(pat) + .baseUrl("https://models.inference.ai.azure.com") + .build(); + +// צור בקשת השלמת שיחה +ChatCompletionCreateParams params = ChatCompletionCreateParams.builder() + .model(modelId) + .addSystemMessage("You are a concise assistant.") + .addUserMessage("Say Hello World!") + .build(); + +// קבל תגובת בינה מלאכותית +ChatCompletion response = client.chat().completions().create(params); +System.out.println("Response: " + response.choices().get(0).message().content().orElse("No response content")); +``` + +## סיכום + +מעולה! עכשיו הכל מוכן: + +- יצרתם אסימון גישה אישי ל-GitHub עם ההרשאות הנכונות לגישה לדגמי AI +- הפעלתם את סביבת הפיתוח Java שלכם (בין אם Codespaces, מכולת פיתוח, או מקומית) +- התחברתם לדגמי GitHub באמצעות ה-SDK של OpenAI ל-Java לפיתוח AI חינמי +- בדקתם שהכל עובד עם דוגמה פשוטה שמתקשרת עם דגמי AI + +## השלבים הבאים + +[פרק 3: טכניקות ליבה של AI גנרטיבי](../03-CoreGenerativeAITechniques/README.md) + +## פתרון בעיות + +נתקלתם בבעיות? הנה בעיות נפוצות ופתרונות: + +- **האסימון לא עובד?** + - ודאו שהעתקתם את כל האסימון ללא רווחים מיותרים + - וודאו שהאסימון מוגדר נכון כמשתנה סביבה + - בדקו שלאסימון יש את ההרשאות הנכונות (Models: קריאה בלבד) + +- **Maven לא נמצא?** + - אם אתם משתמשים במכולות/Codespaces, Maven מותקן מראש + - בהתקנה מקומית, ודאו ש-Java 21+ ו-Maven 3.9+ מותקנים + - נסו `mvn --version` לוודא התקנה + +- **בעיות חיבור?** + - בדקו את חיבור האינטרנט שלכם + - וודאו ש-GitHub נגיש מהרשת שלכם + - ודאו שאינכם מאחורי חומת אש החוסמת את נקודת הקצה של דגמי GitHub + +- **מכולת פיתוח לא מתחילה?** + - ודאו ש-Docker Desktop פועל (לפיתוח מקומי) + - נסו לבנות מחדש את המכולה: `Ctrl+Shift+P` → "Dev Containers: Rebuild Container" + +- **שגיאות קומפילציה של האפליקציה?** + - וודאו שאתם בתיקייה הנכונה: `02-SetupDevEnvironment/examples/github-models` + - נסו לנקות ולבנות מחדש: `mvn clean compile` + +> **צריכים עזרה?**: עדיין יש בעיות? פתחו בעיה במאגר ונעזור לכם. --- + +**כתב ויתור**: +מסמך זה תורגם בשירות תרגום מבוסס בינה מלאכותית [Co-op Translator](https://github.com/Azure/co-op-translator). למרות שאנו שואפים לדיוק, יש לקחת בחשבון כי תרגומים אוטומטיים עלולים להכיל טעויות או אי-דיוקים. המסמך המקורי בשפתו המקורית נחשב למקור הסמכותי. למידע קריטי מומלץ להיעזר בתרגום מקצועי של אדם. איננו אחראים לכל אי הבנה או פרשנות שגויה הנובעת משימוש בתרגום זה. + \ No newline at end of file diff --git a/translations/he/02-SetupDevEnvironment/examples/basic-chat-azure/README.md b/translations/he/02-SetupDevEnvironment/examples/basic-chat-azure/README.md index c8aa0a4d..217be5ae 100644 --- a/translations/he/02-SetupDevEnvironment/examples/basic-chat-azure/README.md +++ b/translations/he/02-SetupDevEnvironment/examples/basic-chat-azure/README.md @@ -1,12 +1,3 @@ - # דוגמה בסיסית לשיחה עם Azure OpenAI - מא' ועד ת' דוגמה זו מדגימה כיצד ליצור אפליקציית Spring Boot פשוטה שמתחברת ל-Azure OpenAI ובודקת את ההגדרות שלך. diff --git a/translations/he/02-SetupDevEnvironment/getting-started-azure-openai.md b/translations/he/02-SetupDevEnvironment/getting-started-azure-openai.md index 6c1efe94..a8ea4b76 100644 --- a/translations/he/02-SetupDevEnvironment/getting-started-azure-openai.md +++ b/translations/he/02-SetupDevEnvironment/getting-started-azure-openai.md @@ -1,12 +1,3 @@ - # הגדרת סביבת הפיתוח עבור Azure OpenAI > **התחלה מהירה**: מדריך זה מיועד להגדרת Azure OpenAI. להתחלה מיידית עם מודלים חינמיים, השתמשו ב-[GitHub Models with Codespaces](./README.md#quick-start-cloud). diff --git a/translations/he/03-CoreGenerativeAITechniques/README.md b/translations/he/03-CoreGenerativeAITechniques/README.md index 12cc1fc1..6ff67ee5 100644 --- a/translations/he/03-CoreGenerativeAITechniques/README.md +++ b/translations/he/03-CoreGenerativeAITechniques/README.md @@ -1,12 +1,3 @@ - # מדריך לטכניקות ליבה ב-AI גנרטיבי ## תוכן העניינים diff --git a/translations/he/04-PracticalSamples/README.md b/translations/he/04-PracticalSamples/README.md index d1f41b71..c0c292b0 100644 --- a/translations/he/04-PracticalSamples/README.md +++ b/translations/he/04-PracticalSamples/README.md @@ -1,12 +1,3 @@ - # יישומים מעשיים ופרויקטים ## מה תלמדו diff --git a/translations/he/04-PracticalSamples/calculator/README.md b/translations/he/04-PracticalSamples/calculator/README.md index 05e9dd79..72313bdf 100644 --- a/translations/he/04-PracticalSamples/calculator/README.md +++ b/translations/he/04-PracticalSamples/calculator/README.md @@ -1,12 +1,3 @@ - # מדריך למתחילים למחשבון MCP ## תוכן עניינים diff --git a/translations/he/04-PracticalSamples/foundrylocal/README.md b/translations/he/04-PracticalSamples/foundrylocal/README.md index 154764f1..4d4545b7 100644 --- a/translations/he/04-PracticalSamples/foundrylocal/README.md +++ b/translations/he/04-PracticalSamples/foundrylocal/README.md @@ -1,12 +1,3 @@ - # מדריך Foundry Local עם Spring Boot ## תוכן עניינים diff --git a/translations/he/04-PracticalSamples/petstory/README.md b/translations/he/04-PracticalSamples/petstory/README.md index 0e7260f0..38db399f 100644 --- a/translations/he/04-PracticalSamples/petstory/README.md +++ b/translations/he/04-PracticalSamples/petstory/README.md @@ -1,12 +1,3 @@ - # מדריך למתחילים ליצירת סיפורים על חיות מחמד ## תוכן עניינים diff --git a/translations/he/05-ResponsibleGenAI/README.md b/translations/he/05-ResponsibleGenAI/README.md index e932f063..93796fca 100644 --- a/translations/he/05-ResponsibleGenAI/README.md +++ b/translations/he/05-ResponsibleGenAI/README.md @@ -1,12 +1,3 @@ - # בינה מלאכותית אחראית ## מה תלמדו diff --git a/translations/he/AGENTS.md b/translations/he/AGENTS.md index c1d84224..bf3f8507 100644 --- a/translations/he/AGENTS.md +++ b/translations/he/AGENTS.md @@ -1,12 +1,3 @@ - # AGENTS.md ## סקירת הפרויקט diff --git a/translations/he/CODE_OF_CONDUCT.md b/translations/he/CODE_OF_CONDUCT.md index 04950370..1948f7aa 100644 --- a/translations/he/CODE_OF_CONDUCT.md +++ b/translations/he/CODE_OF_CONDUCT.md @@ -1,12 +1,3 @@ - # קוד ההתנהגות של קוד פתוח של מיקרוסופט הפרויקט הזה אימץ את [קוד ההתנהגות של קוד פתוח של מיקרוסופט](https://opensource.microsoft.com/codeofconduct/). diff --git a/translations/he/README.md b/translations/he/README.md index 4d4e6ec5..06aead40 100644 --- a/translations/he/README.md +++ b/translations/he/README.md @@ -1,91 +1,82 @@ - -# אינטליגנציה מלאכותית גנרטיבית למתחילים - מהדורת Java -[![Discord של Microsoft Foundry](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) - -![אינטליגנציה מלאכותית גנרטיבית למתחילים - מהדורת Java](../../translated_images/he/beg-genai-series.8b48be9951cc574c.webp) - -**זמן התחייבות**: כל הסדנה ניתנת לביצוע באופן מקוון ללא התקנה מקומית. הגדרת הסביבה לוקחת 2 דקות, וחקר הדוגמאות דורש 1-3 שעות בהתאם לעומק החקירה. +# בינה מלאכותית גנרטיבית למתחילים - מהדורת Java +[![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) + +![בינה מלאכותית גנרטיבית למתחילים - מהדורת Java](../../translated_images/he/beg-genai-series.8b48be9951cc574c.webp) + +**משך זמן מחויבות**: כל הסדנה ניתנת להשלמה באופן מקוון ללא צורך בהתקנה מקומית. הגדרת הסביבה אורכת 2 דקות, וחקר הדוגמאות דורש 1-3 שעות בהתאם לעומק החקירה. > **התחלה מהירה** -1. צור Fork למאגר זה לחשבון GitHub שלך +1. פצל את המאגר הזה לחשבון ה-GitHub שלך 2. לחץ על **Code** → לשונית **Codespaces** → **...** → **חדש עם אפשרויות...** -3. השתמש בערכי ברירת המחדל – זה יבחר את מכולת הפיתוח שנוצרה לקורס זה +3. השתמש כברירות מחדל – זה יבחר במיכל הפיתוח שנוצר לקורס זה 4. לחץ על **Create codespace** -5. המתן כ-2 דקות עד שהסביבה תהיה מוכנה -6. עבור ישירות ל-[הדוגמה הראשונה](./02-SetupDevEnvironment/README.md#step-2-create-a-github-personal-access-token) +5. המתן כ-2 דקות עד שהסביבה תתכונן +6. קפוץ ישירות ל-[הדוגמה הראשונה](./02-SetupDevEnvironment/README.md#step-2-create-a-github-personal-access-token) -> **מעדיף לשכפל מקומית?** - -> מאגר זה כולל יותר מ-50 תרגומים לשפות שונות שמגדילים משמעותית את גודל ההורדה. לשכפול ללא תרגומים, השתמש ב-sparse checkout: +> **מעדיפים לשכפל מקומית?** +> +> מאגר זה מכיל מעל 50 תרגומי שפות שמגבירים משמעותית את נפח ההורדה. לשכפול ללא תרגומים, השתמש ב-sparse checkout: > ```bash > git clone --filter=blob:none --sparse https://github.com/microsoft/Generative-AI-for-beginners-java.git > cd Generative-AI-for-beginners-java > git sparse-checkout set --no-cone '/*' '!translations' '!translated_images' > ``` -> זה נותן לך את כל מה שאתה צריך כדי להשלים את הקורס עם הורדה מהירה בהרבה. +> זה נותן לך את כל מה שצריך להשלמת הקורס במהירות הורדה גבוהה בהרבה. ## תמיכה בריבוי שפות -### נתמך באמצעות GitHub Action (מאובטח ותמיד מעודכן) +### נתמך באמצעות GitHub Action (אוטומטי ותמיד מעודכן) -[ערבית](../ar/README.md) | [בנגלית](../bn/README.md) | [בולגרית](../bg/README.md) | [בורמית (מיאנמר)](../my/README.md) | [סינית (מפושטת)](../zh/README.md) | [סינית (מסורתית, הונג קונג)](../hk/README.md) | [סינית (מסורתית, מקאו)](../mo/README.md) | [סינית (מסורתית, טייוואן)](../tw/README.md) | [קרואטית](../hr/README.md) | [צ'כית](../cs/README.md) | [דנית](../da/README.md) | [הולנדית](../nl/README.md) | [אסטונית](../et/README.md) | [פינית](../fi/README.md) | [צרפתית](../fr/README.md) | [גרמנית](../de/README.md) | [יוונית](../el/README.md) | [עברית](./README.md) | [הינדי](../hi/README.md) | [הונגרית](../hu/README.md) | [אינדונזית](../id/README.md) | [איטלקית](../it/README.md) | [יפנית](../ja/README.md) | [קאנדה](../kn/README.md) | [קוריאנית](../ko/README.md) | [ליטאית](../lt/README.md) | [מלאית](../ms/README.md) | [מאליאלאם](../ml/README.md) | [מרטהית](../mr/README.md) | [נפאלית](../ne/README.md) | [ניגרית פידגין](../pcm/README.md) | [נורווגית](../no/README.md) | [פרסית (פארסית)](../fa/README.md) | [פולנית](../pl/README.md) | [פורטוגזית (ברזיל)](../br/README.md) | [פורטוגזית (פורטוגל)](../pt/README.md) | [פנג'אבית (ג'רמוכי)](../pa/README.md) | [רומנית](../ro/README.md) | [רוסית](../ru/README.md) | [סרבית (קירילית)](../sr/README.md) | [סלובקית](../sk/README.md) | [סלובנית](../sl/README.md) | [ספרדית](../es/README.md) | [סווהילית](../sw/README.md) | [שוודית](../sv/README.md) | [טגלוג (פיליפינית)](../tl/README.md) | [טמילית](../ta/README.md) | [טלוגו](../te/README.md) | [תאית](../th/README.md) | [טורקית](../tr/README.md) | [אוקראינית](../uk/README.md) | [אורדו](../ur/README.md) | [וייטנאמית](../vi/README.md) +[ערבית](../ar/README.md) | [בנגלית](../bn/README.md) | [בולגרית](../bg/README.md) | [בורמזית (מיאנמר)](../my/README.md) | [סינית (מפושטת)](../zh-CN/README.md) | [סינית (מסורתית, הונג קונג)](../zh-HK/README.md) | [סינית (מסורתית, מקאו)](../zh-MO/README.md) | [סינית (מסורתית, טייוואן)](../zh-TW/README.md) | [קרואטית](../hr/README.md) | [צ'כית](../cs/README.md) | [דנית](../da/README.md) | [הולנדית](../nl/README.md) | [אסטונית](../et/README.md) | [פינית](../fi/README.md) | [צרפתית](../fr/README.md) | [גרמנית](../de/README.md) | [יוונית](../el/README.md) | [עברית](./README.md) | [הינדי](../hi/README.md) | [הונגרית](../hu/README.md) | [אינדונזית](../id/README.md) | [איטלקית](../it/README.md) | [יפנית](../ja/README.md) | [קאנדה](../kn/README.md) | [קוריאנית](../ko/README.md) | [ליטאית](../lt/README.md) | [מלזית](../ms/README.md) | [מליאלאם](../ml/README.md) | [מרטהית](../mr/README.md) | [נפאלית](../ne/README.md) | [נגיריאנית פידג'ין](../pcm/README.md) | [נורווגית](../no/README.md) | [פרסית (פרסית)](../fa/README.md) | [פולנית](../pl/README.md) | [פורטוגזית (ברזיל)](../pt-BR/README.md) | [פורטוגזית (פורטוגל)](../pt-PT/README.md) | [פונג'בית (גורמוכי)](../pa/README.md) | [רומנית](../ro/README.md) | [רוסית](../ru/README.md) | [סרבית (קירילית)](../sr/README.md) | [סלובקית](../sk/README.md) | [סלובנית](../sl/README.md) | [ספרדית](../es/README.md) | [סוואהילי](../sw/README.md) | [שוודית](../sv/README.md) | [טגאלוג (פיליפינית)](../tl/README.md) | [טמילית](../ta/README.md) | [טלאגו](../te/README.md) | [תאית](../th/README.md) | [טורקית](../tr/README.md) | [אוקראינית](../uk/README.md) | [אורדו](../ur/README.md) | [ויאטנמית](../vi/README.md) -> **מעדיף לשכפל מקומית?** +> **מעדיפים לשכפל מקומית?** -> מאגר זה כולל יותר מ-50 תרגומים לשפות שונות שמגדילים משמעותית את גודל ההורדה. לשכפול ללא תרגומים, השתמש ב-sparse checkout: +> מאגר זה מכיל מעל 50 תרגומי שפות שמגבירים משמעותית את נפח ההורדה. לשכפול ללא תרגומים, השתמש ב-sparse checkout: > ```bash > git clone --filter=blob:none --sparse https://github.com/microsoft/Generative-AI-for-beginners-java.git > cd Generative-AI-for-beginners-java > git sparse-checkout set --no-cone '/*' '!translations' '!translated_images' > ``` -> זה נותן לך את כל מה שאתה צריך כדי להשלים את הקורס עם הורדה מהירה בהרבה. +> זה נותן לך את כל מה שצריך להשלמת הקורס במהירות הורדה גבוהה בהרבה. ## מבנה הקורס ונתיב הלמידה -### **פרק 1: מבוא לאינטליגנציה מלאכותית גנרטיבית** -- **מושגים מרכזיים**: הבנת מודלים לשוניים גדולים, טוקנים, אמבדינגים ויכולות AI -- **אקו-סיסטם AI בג'אווה**: סקירה של Spring AI ו-OpenAI SDKs -- **פרוטוקול הקשר המודל (MCP)**: מבוא ל-MCP ותפקידו בתקשורת סוכני AI -- **יישומים מעשיים**: תרחישים אמיתיים כולל צ'אטבוטים ויצירת תוכן -- **[→ להתחיל פרק 1](./01-IntroToGenAI/README.md)** - -### **פרק 2: הגדרת סביבת הפיתוח** -- **קונפיגורציה עם מספר ספקים**: הגדרת GitHub Models, Azure OpenAI ו-OpenAI Java SDK -- **Spring Boot + Spring AI**: שיטות עבודה מומלצות לפיתוח יישומי AI ארגוניים -- **GitHub Models**: גישה חינמית למודלי AI לפרוטוטייפינג וללמידה (ללא צורך בכרטיס אשראי) -- **כלי פיתוח**: מכולות דוקר, VS Code וקונפיגורציית GitHub Codespaces -- **[→ להתחיל פרק 2](./02-SetupDevEnvironment/README.md)** - -### **פרק 3: טכניקות מרכזיות ב-AI גנרטיבי** -- **הנדסת פרומפטים**: טכניקות לתגובה מיטבית של מודלי AI -- **אמבדינגים ופעולות וקטור**: יישום חיפוש סמנטי והתאמת דמיון -- **יצירה מוגברת בהחזרה (RAG)**: שילוב AI עם מקורות המידע שלך -- **קריאת פונקציות**: הרחבת יכולות AI עם כלים ותוספים מותאמים אישית -- **[→ להתחיל פרק 3](./03-CoreGenerativeAITechniques/README.md)** +### **פרק 1: מבוא לבינה מלאכותית גנרטיבית** +- **מושגי יסוד**: הבנת מודלים לשוניים גדולים, טוקנים, אמבדינגים ויכולות AI +- **מערכת האקולוגית של Java AI**: סקירת Spring AI ו-SDKs של OpenAI +- **פרוטוקול הקשר מודלים**: מבוא ל-MCP ותפקידו בתקשורת סוכני AI +- **יישומים מעשיים**: תרחישים מהעולם האמיתי כולל צ'טבוטים ויצירת תוכן +- **[→ התחלת פרק 1](./01-IntroToGenAI/README.md)** + +### **פרק 2: הגדרת סביבת פיתוח** +- **קונפיגורציית סביבה מרובת ספקים**: הגדרת מודלים של GitHub, Azure OpenAI, ו-OpenAI Java SDK +- **Spring Boot + Spring AI**: שיטות עבודה מומלצות לפיתוח אפליקציות AI ארגוניות +- **מודלים של GitHub**: גישה חינמית למודל AI לפרוטוטייפ ולמידה (ללא צורך בכרטיס אשראי) +- **כלי פיתוח**: מכולות Docker, VS Code, והגדרת GitHub Codespaces +- **[→ התחלת פרק 2](./02-SetupDevEnvironment/README.md)** + +### **פרק 3: טכניקות מרכזיות של בינה מלאכותית גנרטיבית** +- **הנדסת פרומפטים**: טכניקות לתגובות מיטביות של מודל AI +- **אמבדינגים ופונקציות וקטור**: יישום חיפוש סמנטי והתאמת דמיון +- **הפקה מורשת בשילוב מידע (RAG)**: שילוב AI עם מקורות הנתונים האישיים שלך +- **קריאת פונקציות**: הרחבת יכולות AI עם כלים ותוספים מותאמים +- **[→ התחלת פרק 3](./03-CoreGenerativeAITechniques/README.md)** ### **פרק 4: יישומים מעשיים ופרויקטים** -- **מחולל סיפור על חיות מחמד** (`petstory/`): יצירת תוכן יצירתי עם GitHub Models -- **הדגמה מקומית של Foundry** (`foundrylocal/`): אינטגרציה מקומית של מודל AI עם OpenAI Java SDK -- **שירות מחשבון MCP** (`calculator/`): יישום בסיסי של פרוטוקול הקשר המודל עם Spring AI -- **[→ להתחיל פרק 4](./04-PracticalSamples/README.md)** +- **מחולל סיפור לחיות מחמד** (`petstory/`): יצירת תוכן יצירתי עם מודלים של GitHub +- **הדגמת Foundry מקומית** (`foundrylocal/`): אינטגרציית מודל AI מקומי עם OpenAI Java SDK +- **שירות מחשבון MCP** (`calculator/`): מימוש בסיסי של פרוטוקול הקשר מודלים באמצעות Spring AI +- **[→ התחלת פרק 4](./04-PracticalSamples/README.md)** -### **פרק 5: פיתוח AI אחראי** -- **בטיחות GitHub Models**: בדיקת סינון תוכן מובנה ומנגנוני בטיחות (חסימות קשוחות וסירובים רכים) -- **הדגמת AI אחראי**: דוגמה מעשית להראות כיצד מערכות בטיחות AI מודרניות פועלות -- **שיטות עבודה מומלצות**: קווים מנחים חיוניים לפיתוח והטמעת AI אתי -- **[→ להתחיל פרק 5](./05-ResponsibleGenAI/README.md)** +### **פרק 5: פיתוח בינה מלאכותית אחראי** +- **בטיחות מודלים של GitHub**: בדוק סינון תוכן מובנה ומנגנוני בטיחות (חסימות קשות וסירובים רכים) +- **הדגמה של בינה מלאכותית אחראית**: דוגמה מעשית המראה כיצד מערכות בטיחות מודרניות פועלות בפועל +- **שיטות עבודה מומלצות**: קווים מנחים חיוניים לפיתוח והטמעה אתית של AI +- **[→ התחלת פרק 5](./05-ResponsibleGenAI/README.md)** ## משאבים נוספים @@ -104,44 +95,45 @@ CO_OP_TRANSLATOR_METADATA: --- -### סדרת אינטליגנציה מלאכותית גנרטיבית -[![אינטליגנציה מלאכותית גנרטיבית למתחילים](https://img.shields.io/badge/Generative%20AI%20for%20Beginners-8B5CF6?style=for-the-badge&labelColor=E5E7EB&color=8B5CF6)](https://github.com/microsoft/generative-ai-for-beginners?WT.mc_id=academic-105485-koreyst) -[![אינטליגנציה מלאכותית גנרטיבית (.NET)](https://img.shields.io/badge/Generative%20AI%20(.NET)-9333EA?style=for-the-badge&labelColor=E5E7EB&color=9333EA)](https://github.com/microsoft/Generative-AI-for-beginners-dotnet?WT.mc_id=academic-105485-koreyst) -[![אינטליגנציה מלאכותית גנרטיבית (Java)](https://img.shields.io/badge/Generative%20AI%20(Java)-C084FC?style=for-the-badge&labelColor=E5E7EB&color=C084FC)](https://github.com/microsoft/generative-ai-for-beginners-java?WT.mc_id=academic-105485-koreyst) -[![אינטליגנציה מלאכותית גנרטיבית (JavaScript)](https://img.shields.io/badge/Generative%20AI%20(JavaScript)-E879F9?style=for-the-badge&labelColor=E5E7EB&color=E879F9)](https://github.com/microsoft/generative-ai-with-javascript?WT.mc_id=academic-105485-koreyst) +### סדרת בינה מלאכותית גנרטיבית +[![בינה מלאכותית גנרטיבית למתחילים](https://img.shields.io/badge/Generative%20AI%20for%20Beginners-8B5CF6?style=for-the-badge&labelColor=E5E7EB&color=8B5CF6)](https://github.com/microsoft/generative-ai-for-beginners?WT.mc_id=academic-105485-koreyst) +[![בינה מלאכותית גנרטיבית (.NET)](https://img.shields.io/badge/Generative%20AI%20(.NET)-9333EA?style=for-the-badge&labelColor=E5E7EB&color=9333EA)](https://github.com/microsoft/Generative-AI-for-beginners-dotnet?WT.mc_id=academic-105485-koreyst) +[![בינה מלאכותית גנרטיבית (Java)](https://img.shields.io/badge/Generative%20AI%20(Java)-C084FC?style=for-the-badge&labelColor=E5E7EB&color=C084FC)](https://github.com/microsoft/generative-ai-for-beginners-java?WT.mc_id=academic-105485-koreyst) +[![בינה מלאכותית גנרטיבית (JavaScript)](https://img.shields.io/badge/Generative%20AI%20(JavaScript)-E879F9?style=for-the-badge&labelColor=E5E7EB&color=E879F9)](https://github.com/microsoft/generative-ai-with-javascript?WT.mc_id=academic-105485-koreyst) --- -### למידה בסיסית +### למידה ליבתית [![למידת מכונה למתחילים](https://img.shields.io/badge/ML%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=22C55E)](https://aka.ms/ml-beginners?WT.mc_id=academic-105485-koreyst) -[![מדעי נתונים למתחילים](https://img.shields.io/badge/Data%20Science%20for%20Beginners-84CC16?style=for-the-badge&labelColor=E5E7EB&color=84CC16)](https://aka.ms/datascience-beginners?WT.mc_id=academic-105485-koreyst) -[![AI למתחילים](https://img.shields.io/badge/AI%20for%20Beginners-A3E635?style=for-the-badge&labelColor=E5E7EB&color=A3E635)](https://aka.ms/ai-beginners?WT.mc_id=academic-105485-koreyst) -[![אבטחת מידע למתחילים](https://img.shields.io/badge/Cybersecurity%20for%20Beginners-F97316?style=for-the-badge&labelColor=E5E7EB&color=F97316)](https://github.com/microsoft/Security-101?WT.mc_id=academic-96948-sayoung) +[![מדעי הנתונים למתחילים](https://img.shields.io/badge/Data%20Science%20for%20Beginners-84CC16?style=for-the-badge&labelColor=E5E7EB&color=84CC16)](https://aka.ms/datascience-beginners?WT.mc_id=academic-105485-koreyst) +[![בינה מלאכותית למתחילים](https://img.shields.io/badge/AI%20for%20Beginners-A3E635?style=for-the-badge&labelColor=E5E7EB&color=A3E635)](https://aka.ms/ai-beginners?WT.mc_id=academic-105485-koreyst) +[![סייבר למתחילים](https://img.shields.io/badge/Cybersecurity%20for%20Beginners-F97316?style=for-the-badge&labelColor=E5E7EB&color=F97316)](https://github.com/microsoft/Security-101?WT.mc_id=academic-96948-sayoung) + [![פיתוח ווב למתחילים](https://img.shields.io/badge/Web%20Dev%20for%20Beginners-EC4899?style=for-the-badge&labelColor=E5E7EB&color=EC4899)](https://aka.ms/webdev-beginners?WT.mc_id=academic-105485-koreyst) -[![IoT למתחילים](https://img.shields.io/badge/IoT%20for%20Beginners-14B8A6?style=for-the-badge&labelColor=E5E7EB&color=14B8A6)](https://aka.ms/iot-beginners?WT.mc_id=academic-105485-koreyst) +[![אינטרנט של הדברים למתחילים](https://img.shields.io/badge/IoT%20for%20Beginners-14B8A6?style=for-the-badge&labelColor=E5E7EB&color=14B8A6)](https://aka.ms/iot-beginners?WT.mc_id=academic-105485-koreyst) [![פיתוח XR למתחילים](https://img.shields.io/badge/XR%20Development%20for%20Beginners-38BDF8?style=for-the-badge&labelColor=E5E7EB&color=38BDF8)](https://github.com/microsoft/xr-development-for-beginners?WT.mc_id=academic-105485-koreyst) --- -### סדרת Copilot -[![Copilot לתכנות זוגי בינה מלאכותית](https://img.shields.io/badge/Copilot%20for%20AI%20Paired%20Programming-FACC15?style=for-the-badge&labelColor=E5E7EB&color=FACC15)](https://aka.ms/GitHubCopilotAI?WT.mc_id=academic-105485-koreyst) -[![Copilot ל-C#/.NET](https://img.shields.io/badge/Copilot%20for%20C%23/.NET-FBBF24?style=for-the-badge&labelColor=E5E7EB&color=FBBF24)](https://github.com/microsoft/mastering-github-copilot-for-dotnet-csharp-developers?WT.mc_id=academic-105485-koreyst) -[![הרפתקת Copilot](https://img.shields.io/badge/Copilot%20Adventure-FDE68A?style=for-the-badge&labelColor=E5E7EB&color=FDE68A)](https://github.com/microsoft/CopilotAdventures?WT.mc_id=academic-105485-koreyst) +### סדרת קופיילוט +[![קופיילוט לתכנות משותף בינה מלאכותית](https://img.shields.io/badge/Copilot%20for%20AI%20Paired%20Programming-FACC15?style=for-the-badge&labelColor=E5E7EB&color=FACC15)](https://aka.ms/GitHubCopilotAI?WT.mc_id=academic-105485-koreyst) +[![קופיילוט ל-C#/.NET](https://img.shields.io/badge/Copilot%20for%20C%23/.NET-FBBF24?style=for-the-badge&labelColor=E5E7EB&color=FBBF24)](https://github.com/microsoft/mastering-github-copilot-for-dotnet-csharp-developers?WT.mc_id=academic-105485-koreyst) +[![הרפתקת קופיילוט](https://img.shields.io/badge/Copilot%20Adventure-FDE68A?style=for-the-badge&labelColor=E5E7EB&color=FDE68A)](https://github.com/microsoft/CopilotAdventures?WT.mc_id=academic-105485-koreyst) -## לקבלת עזרה +## קבלת עזרה -אם נתקעת או יש לך שאלות לגבי בניית אפליקציות בינה מלאכותית. הצטרף ללומדים אחרים ומפתחים מנוסים בדיונים בנושא MCP. זו קהילה תומכת שבה שאלות מתקבלות בברכה והידע משותף בחופשיות. +אם נתקעת או יש לך שאלות על בניית אפליקציות בינה מלאכותית. הצטרף ללומדים אחרים ולמפתחים מנוסים בדיונים על MCP. זוהי קהילה תומכת שבה שאלות מתקבלות בברכה והידע משתף בחופשיות. [![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) אם יש לך משוב על מוצר או שגיאות בזמן הבנייה בקר ב: -[![פורום המפתחים Microsoft Foundry על GitHub](https://img.shields.io/badge/GitHub-Microsoft_Foundry_Developer_Forum-blue?style=for-the-badge&logo=github&color=000000&logoColor=fff)](https://aka.ms/foundry/forum) +[![פורום מפתחי Microsoft Foundry](https://img.shields.io/badge/GitHub-Microsoft_Foundry_Developer_Forum-blue?style=for-the-badge&logo=github&color=000000&logoColor=fff)](https://aka.ms/foundry/forum) --- -**כתב התראה**: -מסמך זה תורגם באמצעות שירות תרגום מבוסס בינה מלאכותית [Co-op Translator](https://github.com/Azure/co-op-translator). למרות שאנו שואפים לדיוק, יש לקחת בחשבון כי תרגומים אוטומטיים עלולים לכלול שגיאות או אי דיוקים. המסמך המקורי בשפתו המקורית יש להיחשב למקור הסמכותי. למידע קריטי מומלץ להשתמש בתרגום מקצועי של בני אדם. אנו לא נושאים באחריות לכל הבנה שגויה או פרשנות מוטעית הנובעת מהשימוש בתרגום זה. +**כתב ויתור**: +מסמך זה תורגם באמצעות שירות תרגום מבוסס בינה מלאכותית [Co-op Translator](https://github.com/Azure/co-op-translator). למרות שאנו שואפים לדיוק, יש לקחת בחשבון כי תרגומים אוטומטיים עלולים להכיל שגיאות או אי־דיוקים. המסמך המקורי בשפת המקור שלו הוא המקור הסמכותי. למידע קריטי מומלץ תרגום מקצועי על ידי אדם. אנו לא אחראים על אי-הבנות או פרשנויות שגויות הנובעות משימוש בתרגום זה. \ No newline at end of file diff --git a/translations/he/SECURITY.md b/translations/he/SECURITY.md index bd7ede7e..6126cb01 100644 --- a/translations/he/SECURITY.md +++ b/translations/he/SECURITY.md @@ -1,12 +1,3 @@ - ## אבטחה מיקרוסופט מתייחסת ברצינות לאבטחת מוצרי התוכנה והשירותים שלה, כולל כל מאגרי הקוד המנוהלים דרך הארגונים שלנו ב-GitHub, הכוללים את [Microsoft](https://github.com/Microsoft), [Azure](https://github.com/Azure), [DotNet](https://github.com/dotnet), [AspNet](https://github.com/aspnet) ו-[Xamarin](https://github.com/xamarin). diff --git a/translations/he/SUPPORT.md b/translations/he/SUPPORT.md index 0964bc88..fa033a0b 100644 --- a/translations/he/SUPPORT.md +++ b/translations/he/SUPPORT.md @@ -1,12 +1,3 @@ - # תמיכה ## כיצד לדווח על בעיות ולקבל עזרה diff --git a/translations/hi/.co-op-translator.json b/translations/hi/.co-op-translator.json new file mode 100644 index 00000000..93bbe7b5 --- /dev/null +++ b/translations/hi/.co-op-translator.json @@ -0,0 +1,92 @@ +{ + "01-IntroToGenAI/README.md": { + "original_hash": "75bfb080ca725e8a9aa9c80cae25fba1", + "translation_date": "2025-07-29T08:39:03+00:00", + "source_file": "01-IntroToGenAI/README.md", + "language_code": "hi" + }, + "02-SetupDevEnvironment/README.md": { + "original_hash": "96a30d42b9751a3d4e4b20e28d29d459", + "translation_date": "2026-01-28T04:49:06+00:00", + "source_file": "02-SetupDevEnvironment/README.md", + "language_code": "hi" + }, + "02-SetupDevEnvironment/examples/basic-chat-azure/README.md": { + "original_hash": "efd82efe50711d7e257eb943151d682c", + "translation_date": "2025-07-27T13:37:23+00:00", + "source_file": "02-SetupDevEnvironment/examples/basic-chat-azure/README.md", + "language_code": "hi" + }, + "02-SetupDevEnvironment/getting-started-azure-openai.md": { + "original_hash": "bfdb4b4eadbee3a59ef742439f58326a", + "translation_date": "2025-07-27T13:00:09+00:00", + "source_file": "02-SetupDevEnvironment/getting-started-azure-openai.md", + "language_code": "hi" + }, + "03-CoreGenerativeAITechniques/README.md": { + "original_hash": "685f55cb07de19b52a30ce6e8b6d889e", + "translation_date": "2025-08-28T22:00:04+00:00", + "source_file": "03-CoreGenerativeAITechniques/README.md", + "language_code": "hi" + }, + "04-PracticalSamples/README.md": { + "original_hash": "14c0a61ecc1cd2012a9c129236dfdf71", + "translation_date": "2025-07-29T08:38:45+00:00", + "source_file": "04-PracticalSamples/README.md", + "language_code": "hi" + }, + "04-PracticalSamples/calculator/README.md": { + "original_hash": "b6c16b5514d524e415a94f6097ee7d4c", + "translation_date": "2025-09-18T15:27:58+00:00", + "source_file": "04-PracticalSamples/calculator/README.md", + "language_code": "hi" + }, + "04-PracticalSamples/foundrylocal/README.md": { + "original_hash": "f787307400de59adc25a1404466a35f3", + "translation_date": "2025-11-04T07:18:48+00:00", + "source_file": "04-PracticalSamples/foundrylocal/README.md", + "language_code": "hi" + }, + "04-PracticalSamples/petstory/README.md": { + "original_hash": "0cbf68d605615a1e602c832a24616859", + "translation_date": "2025-07-25T11:03:22+00:00", + "source_file": "04-PracticalSamples/petstory/README.md", + "language_code": "hi" + }, + "05-ResponsibleGenAI/README.md": { + "original_hash": "301c05c2f57e60a6950b8c665b8bdbba", + "translation_date": "2025-07-29T15:45:37+00:00", + "source_file": "05-ResponsibleGenAI/README.md", + "language_code": "hi" + }, + "AGENTS.md": { + "original_hash": "afc90918d008cf77fd1982691f681306", + "translation_date": "2025-10-03T08:31:54+00:00", + "source_file": "AGENTS.md", + "language_code": "hi" + }, + "CODE_OF_CONDUCT.md": { + "original_hash": "442b123d034f92f7c384d2bbd28f99f1", + "translation_date": "2025-07-21T15:59:20+00:00", + "source_file": "CODE_OF_CONDUCT.md", + "language_code": "hi" + }, + "README.md": { + "original_hash": "125a08948d881c95628094f4dd1fbd43", + "translation_date": "2026-01-29T15:32:18+00:00", + "source_file": "README.md", + "language_code": "hi" + }, + "SECURITY.md": { + "original_hash": "57f14126c1c6add76b3aef3844dfe4e3", + "translation_date": "2025-07-21T15:58:01+00:00", + "source_file": "SECURITY.md", + "language_code": "hi" + }, + "SUPPORT.md": { + "original_hash": "b8ef73cc49dec68e2c885ee9df545129", + "translation_date": "2025-07-21T16:00:24+00:00", + "source_file": "SUPPORT.md", + "language_code": "hi" + } +} \ No newline at end of file diff --git a/translations/hi/01-IntroToGenAI/README.md b/translations/hi/01-IntroToGenAI/README.md index 093e3625..a1b5b93c 100644 --- a/translations/hi/01-IntroToGenAI/README.md +++ b/translations/hi/01-IntroToGenAI/README.md @@ -1,12 +1,3 @@ - # जेनरेटिव एआई का परिचय - जावा संस्करण ## आप क्या सीखेंगे diff --git a/translations/hi/02-SetupDevEnvironment/README.md b/translations/hi/02-SetupDevEnvironment/README.md index 4ac6941c..e445ee79 100644 --- a/translations/hi/02-SetupDevEnvironment/README.md +++ b/translations/hi/02-SetupDevEnvironment/README.md @@ -1,13 +1,253 @@ - +# जेनरेटिव AI के लिए जावा के विकास वातावरण की स्थापना +> **त्वरित प्रारंभ**: 2 मिनट में क्लाउड में कोड करें - [GitHub Codespaces सेटअप](../../../02-SetupDevEnvironment) पर जाएं - किसी स्थानीय स्थापना की आवश्यकता नहीं है और गिटहब मॉडल का उपयोग करता है! + +> **Azure OpenAI में रुचि है?**, देखें हमारा [Azure OpenAI सेटअप गाइड](getting-started-azure-openai.md) जिसमें नया Azure OpenAI रिसोर्स बनाने के चरण हैं। + +## आप क्या सीखेंगे + +- AI एप्लिकेशन के लिए जावा विकास वातावरण सेट करना +- अपनी पसंद के विकास वातावरण का चयन और कॉन्फ़िगरेशन करना (Codespaces के साथ क्लाउड-प्रथम, स्थानीय डेव कंटेनर, या पूर्ण स्थानीय सेटअप) +- GitHub मॉडल से जुड़कर अपनी सेटअप का परीक्षण करना + +## सामग्री सूची + +- [आप क्या सीखेंगे](../../../02-SetupDevEnvironment) +- [परिचय](../../../02-SetupDevEnvironment) +- [चरण 1: अपना विकास वातावरण सेट करें](../../../02-SetupDevEnvironment) + - [विकल्प A: GitHub Codespaces (सिफारिश की गई)](../../../02-SetupDevEnvironment) + - [विकल्प B: स्थानीय डेव कंटेनर](../../../02-SetupDevEnvironment) + - [विकल्प C: अपनी मौजूदा स्थानीय स्थापना का उपयोग करें](../../../02-SetupDevEnvironment) +- [चरण 2: GitHub व्यक्तिगत प्रवेश टोकन बनाएं](../../../02-SetupDevEnvironment) +- [चरण 3: अपनी सेटअप का परीक्षण करें](../../../02-SetupDevEnvironment) +- [समस्याओं का निवारण](../../../02-SetupDevEnvironment) +- [सारांश](../../../02-SetupDevEnvironment) +- [अगले कदम](../../../02-SetupDevEnvironment) + +## परिचय + +यह अध्याय आपको विकास वातावरण सेट करने में मार्गदर्शन करेगा। हम **GitHub मॉडल** का मुख्य उदाहरण के रूप में उपयोग करेंगे क्योंकि यह मुफ्त है, केवल एक GitHub खाते के साथ सेट करना आसान है, किसी क्रेडिट कार्ड की जरूरत नहीं है, और प्रयोग के लिए कई मॉडल उपलब्ध कराता है। + +**कोई स्थानीय सेटअप आवश्यक नहीं!** आप तुरंत ब्राउज़र में GitHub Codespaces का उपयोग कर कोडिंग शुरू कर सकते हैं, जो एक पूर्ण विकास वातावरण प्रदान करता है। + +Screenshot: GitHub Models + +हम इस कोर्स के लिए [**GitHub मॉडल**](https://github.com/marketplace?type=models) का उपयोग करने की सलाह देते हैं क्योंकि यह: +- शुरू करने के लिए **मुफ्त** है +- केवल एक GitHub खाते के साथ सेट करना **आसान** है +- **क्रेडिट कार्ड की आवश्यकता नहीं** +- **प्रयोग के लिए कई मॉडल** उपलब्ध हैं + +> **ध्यान दें**: इस प्रशिक्षण में उपयोग किए गए GitHub मॉडल के ये मुफ्त सीमाएं हैं: +> - प्रति मिनट 15 अनुरोध (प्रति दिन 150) +> - प्रत्येक अनुरोध में लगभग 8,000 शब्द इनपुट, लगभग 4,000 शब्द आउटपुट +> - 5 समवर्ती अनुरोध +> +> उत्पादन उपयोग के लिए, अपने Azure खाते से Azure AI Foundry मॉडल में अपग्रेड करें। आपका कोड बदलने की आवश्यकता नहीं है। देखें [Azure AI Foundry दस्तावेज़](https://learn.microsoft.com/azure/ai-foundry/foundry-models/how-to/quickstart-github-models)। + +## चरण 1: अपना विकास वातावरण सेट करें + + + +हमने इस जेनरेटिव AI जावा कोर्स के लिए एक पूर्व कॉन्फ़िगर किया गया विकास कंटेनर बनाया है ताकि सेटअप समय कम हो और आपके पास सभी आवश्यक उपकरण उपलब्ध हों। अपनी पसंद के विकास विधि का चयन करें: + +### वातावरण सेटअप विकल्प: + +#### विकल्प A: GitHub Codespaces (सिफारिश की गई) + +**2 मिनट में कोडिंग शुरू करें - कोई स्थानीय सेटअप आवश्यक नहीं!** + +1. इस रिपोजिटरी को अपने GitHub खाते में फोर्क करें + > **ध्यान दें**: यदि आप मूल कॉन्फ़िग संपादित करना चाहते हैं तो कृपया [Dev Container Configuration](../../../.devcontainer/devcontainer.json) देखें +2. **Code** → **Codespaces** टैब → **...** → **New with options...** पर क्लिक करें +3. डिफ़ॉल्ट सेटिंग्स का उपयोग करें – यह चयन करेगा **Dev container configuration**: इस कोर्स के लिए बनाया गया **Generative AI Java Development Environment** कस्टम devcontainer +4. **Create codespace** पर क्लिक करें +5. वातावरण के तैयार होने के लिए लगभग 2 मिनट प्रतीक्षा करें +6. [चरण 2: GitHub टोकन बनाएं](../../../02-SetupDevEnvironment) पर जाएं + +Screenshot: Codespaces submenu + +Screenshot: New with options + +Screenshot: Create codespace options + + +> **Codespaces के लाभ**: +> - कोई स्थानीय इंस्टॉलेशन आवश्यक नहीं +> - किसी भी ब्राउज़र वाले डिवाइस पर काम करता है +> - सभी टूल्स और निर्भरताओं के साथ पूर्व-कॉन्फ़िगर किया गया +> - व्यक्तिगत खातों के लिए प्रति माह मुफ्त 60 घंटे +> - सभी शिक्षार्थियों के लिए एकसमान वातावरण + +#### विकल्प B: स्थानीय डेव कंटेनर + +**विकासकों के लिए जो स्थानीय विकास के लिए Docker पसंद करते हैं** + +1. इस रिपोजिटरी को अपने स्थानीय मशीन पर फोर्क और क्लोन करें + > **ध्यान दें**: यदि आप मूल कॉन्फ़िग संपादित करना चाहते हैं तो कृपया [Dev Container Configuration](../../../.devcontainer/devcontainer.json) देखें +2. [Docker Desktop](https://www.docker.com/products/docker-desktop/) और [VS Code](https://code.visualstudio.com/) इंस्टॉल करें +3. VS Code में [Dev Containers extension](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers) इंस्टॉल करें +4. VS Code में रिपोजिटरी फोल्डर खोलें +5. जब पूछा जाए, तो **Reopen in Container** पर क्लिक करें (या `Ctrl+Shift+P` → "Dev Containers: Reopen in Container" उपयोग करें) +6. कंटेनर बनने और शुरू होने के लिए प्रतीक्षा करें +7. [चरण 2: GitHub टोकन बनाएं](../../../02-SetupDevEnvironment) पर जाएं + +Screenshot: Dev container setup + +Screenshot: Dev container build complete + +#### विकल्प C: अपनी मौजूदा स्थानीय स्थापना का उपयोग करें + +**उन विकासकों के लिए जिनके पास मौजूदा जावा वातावरण है** + +पूर्वापेक्षाएँ: +- [Java 21+](https://www.oracle.com/java/technologies/javase/jdk21-archive-downloads.html) +- [Maven 3.9+](https://maven.apache.org/download.cgi) +- [VS Code](https://code.visualstudio.com) या आपकी पसंद का IDE + +चरण: +1. इस रिपोजिटरी को स्थानीय मशीन पर क्लोन करें +2. IDE में प्रोजेक्ट खोलें +3. [चरण 2: GitHub टोकन बनाएं](../../../02-SetupDevEnvironment) पर जाएं + +> **प्रो टिप**: यदि आपके पास कम संसाधन वाली मशीन है लेकिन आप स्थानीय VS Code चाहते हैं, तो GitHub Codespaces का उपयोग करें! आप अपने स्थानीय VS Code को क्लाउड-होस्ट किए गए Codespace से जोड़ सकते हैं जिससे दोनों का सर्वश्रेष्ठ लाभ मिले। + +Screenshot: created local devcontainer instance + + +## चरण 2: GitHub व्यक्तिगत प्रवेश टोकन बनाएं + +1. [GitHub सेटिंग्स](https://github.com/settings/profile) पर जाएं और अपने प्रोफ़ाइल मेनू से **Settings** चुनें। +2. बाएं साइडबार में, **Developer settings** पर क्लिक करें (आमतौर पर नीचे होता है)। +3. **Personal access tokens** के अंतर्गत, **Fine-grained tokens** पर क्लिक करें (या सीधे इस [लिंक](https://github.com/settings/personal-access-tokens) का पालन करें)। +4. **Generate new token** पर क्लिक करें। +5. "Token name" के तहत एक वर्णनात्मक नाम दें (जैसे `GenAI-Java-Course-Token`)। +6. समाप्ति तिथि सेट करें (सिफारिश: सुरक्षा सर्वोत्तम अभ्यास के लिए 7 दिन)। +7. "Resource owner" के तहत अपना उपयोगकर्ता खाता चुनें। +8. "Repository access" के तहत उन रिपोजिटरीज़ का चयन करें जिनमें आप GitHub मॉडल का उपयोग करना चाहते हैं (या "सभी रिपोजिटरी" यदि आवश्यक हो)। +9. "Account permissions" के तहत **Models** ढूंढें और इसे **Read-only** सेट करें। +10. **Generate token** पर क्लिक करें। +11. **अपना टोकन अभी कॉपी और सुरक्षित करें** – आप इसे फिर से नहीं देख पाएंगे! + +> **सुरक्षा सुझाव**: अपने एक्सेस टोकन के लिए न्यूनतम आवश्यक स्कोप और यथासंभव कम समाप्ति समय का उपयोग करें। + +## चरण 3: GitHub मॉडल उदाहरण के साथ अपनी सेटअप का परीक्षण करें + +एक बार आपका विकास वातावरण तैयार हो जाने पर, चलिए हमारे उदाहरण एप्लिकेशन [`02-SetupDevEnvironment/examples/github-models`](../../../02-SetupDevEnvironment/examples/github-models) में GitHub मॉडल एकीकरण का परीक्षण करते हैं। + +1. अपने विकास वातावरण में टर्मिनल खोलें। +2. GitHub मॉडल उदाहरण फ़ोल्डर में जाएं: + ```bash + cd 02-SetupDevEnvironment/examples/github-models + ``` +3. अपनी GitHub टोकन को पर्यावरण चर के रूप में सेट करें: + ```bash + # मैकओएस/लिनक्स + export GITHUB_TOKEN=your_token_here + + # विंडोज (कमांड प्रॉम्प्ट) + set GITHUB_TOKEN=your_token_here + + # विंडोज (पावरशेल) + $env:GITHUB_TOKEN="your_token_here" + ``` + +4. एप्लिकेशन चलाएं: + ```bash + mvn compile exec:java -Dexec.mainClass="com.example.githubmodels.App" + ``` + +आपको ऐसा आउटपुट दिखाई देगा: +```text +Using model: gpt-4.1-nano +Sending request to GitHub Models... +Response: Hello World! +``` + +### उदाहरण कोड को समझना + +पहले, चलिए समझते हैं कि हमने क्या चलाया है। `examples/github-models` के तहत उदाहरण OpenAI Java SDK का उपयोग करके GitHub मॉडल से जुड़ता है: + +**यह कोड क्या करता है:** +- आपके व्यक्तिगत एक्सेस टोकन का उपयोग करके GitHub मॉडल से **कनेक्ट** होता है +- AI मॉडल को एक सरल "Say Hello World!" संदेश **भेजता** है +- AI के उत्तर को प्राप्त करता और प्रदर्शित करता है +- आपकी सेटअप सही से काम कर रही है यह **सत्यापित** करता है + +**मुख्य निर्भरता** (`pom.xml` में): +```xml + + com.openai + openai-java + 2.12.0 + +``` + +**मुख्य कोड** (`App.java`): +```java +// OpenAI Java SDK का उपयोग करके GitHub मॉडल से कनेक्ट करें +OpenAIClient client = OpenAIOkHttpClient.builder() + .apiKey(pat) + .baseUrl("https://models.inference.ai.azure.com") + .build(); + +// चैट पूर्णता अनुरोध बनाएँ +ChatCompletionCreateParams params = ChatCompletionCreateParams.builder() + .model(modelId) + .addSystemMessage("You are a concise assistant.") + .addUserMessage("Say Hello World!") + .build(); + +// AI प्रतिक्रिया प्राप्त करें +ChatCompletion response = client.chat().completions().create(params); +System.out.println("Response: " + response.choices().get(0).message().content().orElse("No response content")); +``` + +## सारांश + +शानदार! अब आपके पास सब कुछ सेट अप है: + +- AI मॉडल एक्सेस के लिए सही अनुमतियों वाला GitHub व्यक्तिगत एक्सेस टोकन बनाया +- अपना जावा विकास वातावरण चला लिया (चाहे Codespaces हो, डेव कंटेनर हो, या स्थानीय) +- OpenAI Java SDK के साथ GitHub मॉडल से जुड़ा मुफ्त AI विकास के लिए +- एक सरल उदाहरण की मदद से सब कुछ परीक्षण किया जो AI मॉडल से बात करता है + +## अगले कदम + +[अध्याय 3: कोर जेनरेटिव AI तकनीकें](../03-CoreGenerativeAITechniques/README.md) + +## समस्याओं का निवारण + +समस्याएँ हो रही हैं? यहाँ सामान्य समस्याएं और समाधान हैं: + +- **टोकन काम नहीं कर रहा?** + - सुनिश्चित करें कि आपने पूरा टोकन बिना किसी अतिरिक्त जगह के कॉपी किया है + - जाँचें कि टोकन पर्यावरण चर के रूप में सही सेट है + - देखें कि आपके टोकन के पास सही अनुमतियाँ हैं (Models: Read-only) + +- **Maven नहीं मिला?** + - यदि आप डेव कंटेनर/Codespaces का उपयोग कर रहे हैं, तो Maven पहले से इंस्टॉल होना चाहिए + - स्थानीय सेटअप के लिए, सुनिश्चित करें कि Java 21+ और Maven 3.9+ इंस्टॉल हैं + - इंस्टॉलेशन सत्यापित करने के लिए `mvn --version` चलाएँ + +- **कनेक्शन समस्याएं?** + - अपनी इंटरनेट कनेक्शन जांचें + - सत्यापित करें कि GitHub आपके नेटवर्क से सुलभ है + - जांचें कि आप किसी फ़ायरवॉल के पीछे नहीं हैं जो GitHub मॉडल्स के एंडपॉइंट को ब्लॉक कर रहा हो + +- **डेव कंटेनर शुरू नहीं हो रहा?** + - सुनिश्चित करें कि Docker Desktop चल रहा है (स्थानीय विकास के लिए) + - कंटेनर फिर से बनाने का प्रयास करें: `Ctrl+Shift+P` → "Dev Containers: Rebuild Container" + +- **एप्लिकेशन संग्रहीत त्रुटियाँ?** + - सुनिश्चित करें कि आप सही डायरेक्टरी में हैं: `02-SetupDevEnvironment/examples/github-models` + - साफ़ और पुनर्निर्माण करने का प्रयास करें: `mvn clean compile` + +> **मदद चाहिए?**: अभी भी समस्या है? रिपोजिटरी में एक मुद्दा खोलें और हम आपकी मदद करेंगे। --- + +**अस्वीकरण**: +यह दस्तावेज़ AI अनुवाद सेवा [Co-op Translator](https://github.com/Azure/co-op-translator) का उपयोग करके अनूदित किया गया है। जबकि हम सटीकता के लिए प्रयासरत हैं, कृपया ध्यान दें कि स्वचालित अनुवादों में त्रुटियाँ या अशुद्धियाँ हो सकती हैं। मूल भाषा में दस्तावेज़ को आधिकारिक स्रोत माना जाना चाहिए। महत्वपूर्ण जानकारी के लिए, पेशेवर मानव अनुवाद की सलाह दी जाती है। इस अनुवाद के उपयोग से उत्पन्न किसी भी गलतफहमी या गलत व्याख्या के लिए हम जिम्मेदार नहीं हैं। + \ No newline at end of file diff --git a/translations/hi/02-SetupDevEnvironment/examples/basic-chat-azure/README.md b/translations/hi/02-SetupDevEnvironment/examples/basic-chat-azure/README.md index a9680b01..caee976d 100644 --- a/translations/hi/02-SetupDevEnvironment/examples/basic-chat-azure/README.md +++ b/translations/hi/02-SetupDevEnvironment/examples/basic-chat-azure/README.md @@ -1,12 +1,3 @@ - # Azure OpenAI के साथ बेसिक चैट - एंड-टू-एंड उदाहरण यह उदाहरण दिखाता है कि कैसे एक साधारण Spring Boot एप्लिकेशन बनाया जाए जो Azure OpenAI से कनेक्ट हो और आपकी सेटअप को टेस्ट करे। diff --git a/translations/hi/02-SetupDevEnvironment/getting-started-azure-openai.md b/translations/hi/02-SetupDevEnvironment/getting-started-azure-openai.md index c03b0f48..31cf1ac3 100644 --- a/translations/hi/02-SetupDevEnvironment/getting-started-azure-openai.md +++ b/translations/hi/02-SetupDevEnvironment/getting-started-azure-openai.md @@ -1,12 +1,3 @@ - # Azure OpenAI के लिए डेवलपमेंट एनवायरनमेंट सेटअप करना > **त्वरित शुरुआत**: यह गाइड Azure OpenAI सेटअप के लिए है। मुफ्त मॉडल्स के साथ तुरंत शुरुआत करने के लिए [GitHub Models with Codespaces](./README.md#quick-start-cloud) का उपयोग करें। diff --git a/translations/hi/03-CoreGenerativeAITechniques/README.md b/translations/hi/03-CoreGenerativeAITechniques/README.md index 20308ddd..a5e14db1 100644 --- a/translations/hi/03-CoreGenerativeAITechniques/README.md +++ b/translations/hi/03-CoreGenerativeAITechniques/README.md @@ -1,12 +1,3 @@ - # कोर जनरेटिव AI तकनीकों का ट्यूटोरियल ## सामग्री तालिका diff --git a/translations/hi/04-PracticalSamples/README.md b/translations/hi/04-PracticalSamples/README.md index 4d3a56f9..c2aab55a 100644 --- a/translations/hi/04-PracticalSamples/README.md +++ b/translations/hi/04-PracticalSamples/README.md @@ -1,12 +1,3 @@ - # व्यावहारिक अनुप्रयोग और प्रोजेक्ट्स ## आप क्या सीखेंगे diff --git a/translations/hi/04-PracticalSamples/calculator/README.md b/translations/hi/04-PracticalSamples/calculator/README.md index b81e79a9..6acc5373 100644 --- a/translations/hi/04-PracticalSamples/calculator/README.md +++ b/translations/hi/04-PracticalSamples/calculator/README.md @@ -1,12 +1,3 @@ - # MCP कैलकुलेटर ट्यूटोरियल शुरुआती लोगों के लिए ## सामग्री की तालिका diff --git a/translations/hi/04-PracticalSamples/foundrylocal/README.md b/translations/hi/04-PracticalSamples/foundrylocal/README.md index 1e490b19..bd1d9652 100644 --- a/translations/hi/04-PracticalSamples/foundrylocal/README.md +++ b/translations/hi/04-PracticalSamples/foundrylocal/README.md @@ -1,12 +1,3 @@ - # Foundry Local Spring Boot ट्यूटोरियल ## सामग्री तालिका diff --git a/translations/hi/04-PracticalSamples/petstory/README.md b/translations/hi/04-PracticalSamples/petstory/README.md index 22907ab4..78946795 100644 --- a/translations/hi/04-PracticalSamples/petstory/README.md +++ b/translations/hi/04-PracticalSamples/petstory/README.md @@ -1,12 +1,3 @@ - # पालतू कहानी जनरेटर ट्यूटोरियल शुरुआती लोगों के लिए ## सामग्री तालिका diff --git a/translations/hi/05-ResponsibleGenAI/README.md b/translations/hi/05-ResponsibleGenAI/README.md index 0098cf13..47174d24 100644 --- a/translations/hi/05-ResponsibleGenAI/README.md +++ b/translations/hi/05-ResponsibleGenAI/README.md @@ -1,12 +1,3 @@ - # जिम्मेदार जनरेटिव एआई ## आप क्या सीखेंगे diff --git a/translations/hi/AGENTS.md b/translations/hi/AGENTS.md index e6c47069..46ecba78 100644 --- a/translations/hi/AGENTS.md +++ b/translations/hi/AGENTS.md @@ -1,12 +1,3 @@ - # AGENTS.md ## परियोजना का अवलोकन diff --git a/translations/hi/CODE_OF_CONDUCT.md b/translations/hi/CODE_OF_CONDUCT.md index 3fae2497..b0cba255 100644 --- a/translations/hi/CODE_OF_CONDUCT.md +++ b/translations/hi/CODE_OF_CONDUCT.md @@ -1,12 +1,3 @@ - # Microsoft ओपन सोर्स आचार संहिता इस प्रोजेक्ट ने [Microsoft ओपन सोर्स आचार संहिता](https://opensource.microsoft.com/codeofconduct/) को अपनाया है। diff --git a/translations/hi/README.md b/translations/hi/README.md index b5a7d8eb..c007ac73 100644 --- a/translations/hi/README.md +++ b/translations/hi/README.md @@ -1,140 +1,132 @@ - # शुरुआती लोगों के लिए जनरेटिव एआई - जावा संस्करण [![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) -![शुरुआती लोगों के लिए जनरेटिव एआई - जावा संस्करण](../../translated_images/hi/beg-genai-series.8b48be9951cc574c.webp) +![Generative AI for Beginners - Java Edition](../../translated_images/hi/beg-genai-series.8b48be9951cc574c.webp) -**समय प्रतिबद्धता**: पूरे कार्यशाला को ऑनलाइन बिना स्थानीय सेटअप के पूरा किया जा सकता है। वातावरण सेटअप में 2 मिनट लगते हैं, और नमूनों का पता लगाने में 1-3 घंटे लग सकते हैं, जो जांच की गहराई पर निर्भर करता है। +**समय प्रतिबद्धता**: पूरा कार्यशाला ऑनलाइन बिना स्थानीय सेटअप के पूरा किया जा सकता है। पर्यावरण सेटअप में 2 मिनट लगते हैं, और सैंपल्स की जांच करने में 1-3 घंटे लग सकते हैं, खोज की गहराई पर निर्भर करता है। -> **शीघ्र प्रारंभ** +> **त्वरित शुरुआत** 1. इस रिपॉजिटरी को अपने GitHub खाते में फोर्क करें -2. क्लिक करें **Code** → **Codespaces** टैब → **...** → **New with options...** -3. डिफ़ॉल्ट्स का उपयोग करें – इससे इस कोर्स के लिए बनाया गया Development container चुना जाएगा -4. क्लिक करें **Create codespace** -5. ~2 मिनट तक प्रतीक्षा करें जब तक वातावरण तैयार न हो जाए -6. सीधे कूदें [पहले उदाहरण पर](./02-SetupDevEnvironment/README.md#step-2-create-a-github-personal-access-token) +2. **Code** → **Codespaces** टैब → **...** → **New with options...** पर क्लिक करें +3. डिफ़ॉल्ट का उपयोग करें – यह इस कोर्स के लिए बनाए गए डेवलपमेंट कंटेनर को चुनेगा +4. **Create codespace** पर क्लिक करें +5. पर्यावरण के तैयार होने के लिए लगभग 2 मिनट प्रतीक्षा करें +6. सीधे [पहले उदाहरण](./02-SetupDevEnvironment/README.md#step-2-create-a-github-personal-access-token) पर जाएं > **स्थानीय रूप से क्लोन करना पसंद है?** - -> इस रिपॉजिटरी में 50+ भाषा अनुवाद शामिल हैं जो डाउनलोड आकार को काफी बढ़ाते हैं। अनुवादों के बिना क्लोन करने के लिए, sparse checkout का उपयोग करें: +> +> इस रिपॉजिटरी में 50+ भाषा अनुवाद शामिल हैं जो डाउनलोड आकार को काफी बढ़ा देते हैं। बिना अनुवाद के क्लोन करने के लिए, sparse checkout का उपयोग करें: > ```bash > git clone --filter=blob:none --sparse https://github.com/microsoft/Generative-AI-for-beginners-java.git > cd Generative-AI-for-beginners-java > git sparse-checkout set --no-cone '/*' '!translations' '!translated_images' > ``` -> यह आपको कोर्स पूरा करने के लिए आवश्यक सब कुछ बहुत तेज़ डाउनलोड के साथ देता है। +> इससे आपको कोर्स पूरा करने के लिए आवश्यक सभी कुछ मिलेगा और डाउनलोड तेज़ होगा। ## बहुभाषी समर्थन -### GitHub Action के माध्यम से समर्थित (स्वचालित और हमेशा अपडेटेड) +### GitHub Action के माध्यम से समर्थित (स्वचालित और हमेशा अद्यतन) -[अरबी](../ar/README.md) | [बंगाली](../bn/README.md) | [बल्गेरियाई](../bg/README.md) | [बर्मी (म्यांमार)](../my/README.md) | [चीनी (सरलीकृत)](../zh/README.md) | [चीनी (पारंपरिक, हॉन्ग कॉन्ग)](../hk/README.md) | [चीनी (पारंपरिक, मकाऊ)](../mo/README.md) | [चीनी (पारंपरिक, ताइवान)](../tw/README.md) | [क्रोएशियाई](../hr/README.md) | [चेक](../cs/README.md) | [डेनिश](../da/README.md) | [डच](../nl/README.md) | [एस्तोनियाई](../et/README.md) | [फिनिश](../fi/README.md) | [फ्रेंच](../fr/README.md) | [जर्मन](../de/README.md) | [ग्रीक](../el/README.md) | [हिब्रू](../he/README.md) | [हिन्दी](./README.md) | [हंगेरियन](../hu/README.md) | [इंडोनेशियाई](../id/README.md) | [इतालवी](../it/README.md) | [जापानी](../ja/README.md) | [कन्नड़](../kn/README.md) | [कोरियाई](../ko/README.md) | [लिथुआनियाई](../lt/README.md) | [मलय](../ms/README.md) | [मलयालम](../ml/README.md) | [मराठी](../mr/README.md) | [नेपाली](../ne/README.md) | [नाइजीरियन पिजिन](../pcm/README.md) | [नॉर्वेजियाई](../no/README.md) | [फारसी (पर्शियन)](../fa/README.md) | [पोलिश](../pl/README.md) | [पुर्तगाली (ब्राज़ील)](../br/README.md) | [पुर्तगाली (पुर्तगाल)](../pt/README.md) | [पंजाबी (गुरमुखी)](../pa/README.md) | [रोमानियाई](../ro/README.md) | [रूसी](../ru/README.md) | [सर्बियाई (सिरिलिक)](../sr/README.md) | [स्लोवाक](../sk/README.md) | [स्लोवेनियाई](../sl/README.md) | [स्पैनिश](../es/README.md) | [स्वाहिली](../sw/README.md) | [स्वीडिश](../sv/README.md) | [टागालोग (फिलीपीनो)](../tl/README.md) | [तमिल](../ta/README.md) | [तेलुगु](../te/README.md) | [थाई](../th/README.md) | [तुर्की](../tr/README.md) | [यूक्रेनी](../uk/README.md) | [उर्दू](../ur/README.md) | [वियतनामी](../vi/README.md) +[अरबी](../ar/README.md) | [बंगाली](../bn/README.md) | [बुल्गेरियाई](../bg/README.md) | [बर्मीज़ (म्यांमार)](../my/README.md) | [चीनी (सरलीकृत)](../zh-CN/README.md) | [चीनी (पारंपरिक, हॉन्ग कॉन्ग)](../zh-HK/README.md) | [चीनी (पारंपरिक, मकाऊ)](../zh-MO/README.md) | [चीनी (पारंपरिक, ताइवान)](../zh-TW/README.md) | [क्रोएशियाई](../hr/README.md) | [चेक](../cs/README.md) | [डेनिश](../da/README.md) | [डच](../nl/README.md) | [एस्टोनियाई](../et/README.md) | [फिनिश](../fi/README.md) | [फ्रेंच](../fr/README.md) | [जर्मन](../de/README.md) | [ग्रीक](../el/README.md) | [हेब्रू](../he/README.md) | [हिंदी](./README.md) | [हंगेरियाई](../hu/README.md) | [इंडोनेशियाई](../id/README.md) | [इतालवी](../it/README.md) | [जापानी](../ja/README.md) | [कन्नड़](../kn/README.md) | [कोरियाई](../ko/README.md) | [लिथुआनियाई](../lt/README.md) | [मलय](../ms/README.md) | [मलयालम](../ml/README.md) | [मराठी](../mr/README.md) | [नेपाली](../ne/README.md) | [नाइजीरियाई पिड्गिन](../pcm/README.md) | [नॉर्वेजियन](../no/README.md) | [फारसी (पर्शियन)](../fa/README.md) | [पोलिश](../pl/README.md) | [पुर्तगाली (ब्राज़ील)](../pt-BR/README.md) | [पुर्तगाली (पुर्तगाल)](../pt-PT/README.md) | [पंजाबी (गुरमुखी)](../pa/README.md) | [रोमानियाई](../ro/README.md) | [रूसी](../ru/README.md) | [सर्बियाई (सिरिलिक)](../sr/README.md) | [स्लोवाक](../sk/README.md) | [स्लोवेनियाई](../sl/README.md) | [स्पेनिश](../es/README.md) | [स्वाहिली](../sw/README.md) | [स्वीडिश](../sv/README.md) | [टागालोग (फिलिपिनो)](../tl/README.md) | [तमिल](../ta/README.md) | [तेलुगु](../te/README.md) | [थाई](../th/README.md) | [तुर्की](../tr/README.md) | [यूक्रेनी](../uk/README.md) | [उर्दू](../ur/README.md) | [वियतनामी](../vi/README.md) > **स्थानीय रूप से क्लोन करना पसंद है?** -> इस रिपॉजिटरी में 50+ भाषा अनुवाद शामिल हैं जो डाउनलोड आकार को काफी बढ़ाते हैं। अनुवादों के बिना क्लोन करने के लिए, sparse checkout का उपयोग करें: +> इस रिपॉजिटरी में 50+ भाषा अनुवाद शामिल हैं जो डाउनलोड आकार को काफी बढ़ा देते हैं। बिना अनुवाद के क्लोन करने के लिए, sparse checkout का उपयोग करें: > ```bash > git clone --filter=blob:none --sparse https://github.com/microsoft/Generative-AI-for-beginners-java.git > cd Generative-AI-for-beginners-java > git sparse-checkout set --no-cone '/*' '!translations' '!translated_images' > ``` -> यह आपको कोर्स पूरा करने के लिए आवश्यक सब कुछ बहुत तेज़ डाउनलोड के साथ देता है। +> इससे आपको कोर्स पूरा करने के लिए आवश्यक सभी कुछ मिलेगा और डाउनलोड तेज़ होगा। -## कोर्स संरचना और सीखने का रास्ता +## कोर्स संरचना और सीखने का मार्ग ### **अध्याय 1: जनरेटिव एआई का परिचय** -- **मूल अवधारणाएं**: बड़े भाषा मॉडल, टोकन, एम्बेडिंग्स, और एआई क्षमताओं को समझना -- **जावा एआई इकोसिस्टम**: स्प्रिंग एआई और OpenAI SDKs का अवलोकन +- **मूल अवधारणाएं**: बड़े भाषा मॉडल, टोकन, एम्बेडिंग, और AI क्षमताओं को समझना +- **जावा AI इकोसिस्टम**: Spring AI और OpenAI SDKs का अवलोकन - **मॉडल कॉन्टेक्स्ट प्रोटोकॉल**: MCP का परिचय और AI एजेंट संचार में इसकी भूमिका - **व्यावहारिक अनुप्रयोग**: चैटबॉट और सामग्री निर्माण सहित वास्तविक दुनिया के परिदृश्य - **[→ अध्याय 1 शुरू करें](./01-IntroToGenAI/README.md)** -### **अध्याय 2: विकास वातावरण सेटअप** -- **मल्टी-प्रोवाइडर कॉन्फ़िगरेशन**: GitHub Models, Azure OpenAI, और OpenAI Java SDK इंटीग्रेशन सेटअप करना -- **स्प्रिंग बूट + स्प्रिंग एआई**: उद्यम एआई एप्लिकेशन विकास के लिए सर्वोत्तम प्रथाएँ -- **GitHub मॉडलों**: प्रोटोटाइपिंग और सीखने के लिए मुफ़्त AI मॉडल एक्सेस (कोई क्रेडिट कार्ड आवश्यक नहीं) -- **डेवलपमेंट उपकरण**: Docker कंटेनर, VS Code, और GitHub Codespaces कॉन्फ़िगरेशन +### **अध्याय 2: विकास पर्यावरण सेटअप** +- **मल्टी-प्रोवाइडर कॉन्फ़िगरेशन**: GitHub मॉडल, Azure OpenAI, और OpenAI जावा SDK इंटीग्रेशन सेटअप करें +- **Spring Boot + Spring AI**: एंटरप्राइज AI एप्लिकेशन विकास के लिए सर्वोत्तम प्रथाएं +- **GitHub मॉडल**: प्रोटोटाइपिंग और सीखने के लिए मुफ्त AI मॉडल एक्सेस (कोई क्रेडिट कार्ड आवश्यक नहीं) +- **विकास उपकरण**: Docker कंटेनर, VS Code, और GitHub Codespaces कॉन्फ़िगरेशन - **[→ अध्याय 2 शुरू करें](./02-SetupDevEnvironment/README.md)** -### **अध्याय 3: कोर जनरेटिव एआई तकनीकें** +### **अध्याय 3: कोर जनरेटिव AI तकनीकें** - **प्रॉम्प्ट इंजीनियरिंग**: AI मॉडल प्रतिक्रियाओं के लिए तकनीकें -- **एम्बेडिंग्स और वेक्टर ऑपरेशन**: सेमांटिक सर्च और समानता मिलान लागू करना -- **रिट्रीवल-अगमेंटेड जनरेशन (RAG)**: AI को अपने डेटा स्रोतों के साथ संयोजित करना +- **एम्बेडिंग्स और वेक्टर ऑपरेशन**: सिमेंटिक खोज और समानता मिलान को लागू करना +- **रिकवरी-अग्युमेन्टेड जनरेशन (RAG)**: अपने डेटा स्रोतों के साथ AI का संयोजन - **फंक्शन कॉलिंग**: कस्टम टूल्स और प्लगइन्स के साथ AI क्षमताओं का विस्तार - **[→ अध्याय 3 शुरू करें](./03-CoreGenerativeAITechniques/README.md)** ### **अध्याय 4: व्यावहारिक अनुप्रयोग और परियोजनाएं** -- **पैट स्टोरी जनरेटर** (`petstory/`): GitHub मॉडलों के साथ रचनात्मक सामग्री निर्माण -- **Foundry Local डेमो** (`foundrylocal/`): OpenAI Java SDK के साथ स्थानीय AI मॉडल इंटीग्रेशन -- **MCP कैलकुलेटर सेवा** (`calculator/`): स्प्रिंग एआई के साथ बेसिक मॉडल कॉन्टेक्स्ट प्रोटोकॉल कार्यान्वयन +- **पेट स्टोरी जनरेटर** (`petstory/`): GitHub मॉडल के साथ क्रिएटिव कंटेंट निर्माण +- **Foundry Local Demo** (`foundrylocal/`): OpenAI जावा SDK के साथ स्थानीय AI मॉडल एकीकरण +- **MCP कैलकुलेटर सेवा** (`calculator/`): Spring AI के साथ बेसिक मॉडल कॉन्टेक्स्ट प्रोटोकॉल इम्प्लीमेंटेशन - **[→ अध्याय 4 शुरू करें](./04-PracticalSamples/README.md)** -### **अध्याय 5: जिम्मेदार एआई विकास** -- **GitHub मॉडलों की सुरक्षा**: बिल्ट-इन सामग्री फ़िल्टरिंग और सुरक्षा तंत्र का परीक्षण (हार्ड ब्लॉक और सॉफ्ट रिफ़्यूज) -- **जिम्मेदार एआई डेमो**: दिखाता है कि आधुनिक AI सुरक्षा सिस्टम कैसे व्यावहारिक रूप में काम करते हैं -- **शीर्ष प्रथाएँ**: नैतिक AI विकास और परिनियोजन के लिए आवश्यक दिशानिर्देश +### **अध्याय 5: जिम्मेदार AI विकास** +- **GitHub मॉडल सुरक्षा**: बिल्ट-इन कंटेंट फ़िल्टरिंग और सुरक्षा तंत्र का परीक्षण (हार्ड ब्लॉक्स और सॉफ्ट रिज़र्वेशन) +- **जिम्मेदार AI डेमो**: एक व्यावहारिक उदाहरण जो दिखाता है कि आधुनिक AI सुरक्षा सिस्टम कैसे काम करते हैं +- **सर्वोत्तम प्रथाएं**: नैतिक AI विकास और तैनाती के लिए आवश्यक दिशानिर्देश - **[→ अध्याय 5 शुरू करें](./05-ResponsibleGenAI/README.md)** ## अतिरिक्त संसाधन ### LangChain -[![शुरुआती लोगों के लिए LangChain4j](https://img.shields.io/badge/LangChain4j%20for%20Beginners-22C55E?style=for-the-badge&&labelColor=E5E7EB&color=0553D6)](https://aka.ms/langchain4j-for-beginners) -[![शुरुआती लोगों के लिए LangChain.js](https://img.shields.io/badge/LangChain.js%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=0553D6)](https://aka.ms/langchainjs-for-beginners?WT.mc_id=m365-94501-dwahlin) +[![LangChain4j for Beginners](https://img.shields.io/badge/LangChain4j%20for%20Beginners-22C55E?style=for-the-badge&&labelColor=E5E7EB&color=0553D6)](https://aka.ms/langchain4j-for-beginners) +[![LangChain.js for Beginners](https://img.shields.io/badge/LangChain.js%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=0553D6)](https://aka.ms/langchainjs-for-beginners?WT.mc_id=m365-94501-dwahlin) --- -### Azure / एज / MCP / एजेंट्स -[![शुरुआती लोगों के लिए AZD](https://img.shields.io/badge/AZD%20for%20Beginners-0078D4?style=for-the-badge&labelColor=E5E7EB&color=0078D4)](https://github.com/microsoft/AZD-for-beginners?WT.mc_id=academic-105485-koreyst) -[![शुरुआती लोगों के लिए एज एआई](https://img.shields.io/badge/Edge%20AI%20for%20Beginners-00B8E4?style=for-the-badge&labelColor=E5E7EB&color=00B8E4)](https://github.com/microsoft/edgeai-for-beginners?WT.mc_id=academic-105485-koreyst) -[![शुरुआती लोगों के लिए MCP](https://img.shields.io/badge/MCP%20for%20Beginners-009688?style=for-the-badge&labelColor=E5E7EB&color=009688)](https://github.com/microsoft/mcp-for-beginners?WT.mc_id=academic-105485-koreyst) -[![शुरुआती लोगों के लिए AI एजेंट्स](https://img.shields.io/badge/AI%20Agents%20for%20Beginners-00C49A?style=for-the-badge&labelColor=E5E7EB&color=00C49A)](https://github.com/microsoft/ai-agents-for-beginners?WT.mc_id=academic-105485-koreyst) +### Azure / Edge / MCP / एजेंट्स +[![AZD for Beginners](https://img.shields.io/badge/AZD%20for%20Beginners-0078D4?style=for-the-badge&labelColor=E5E7EB&color=0078D4)](https://github.com/microsoft/AZD-for-beginners?WT.mc_id=academic-105485-koreyst) +[![Edge AI for Beginners](https://img.shields.io/badge/Edge%20AI%20for%20Beginners-00B8E4?style=for-the-badge&labelColor=E5E7EB&color=00B8E4)](https://github.com/microsoft/edgeai-for-beginners?WT.mc_id=academic-105485-koreyst) +[![MCP for Beginners](https://img.shields.io/badge/MCP%20for%20Beginners-009688?style=for-the-badge&labelColor=E5E7EB&color=009688)](https://github.com/microsoft/mcp-for-beginners?WT.mc_id=academic-105485-koreyst) +[![AI Agents for Beginners](https://img.shields.io/badge/AI%20Agents%20for%20Beginners-00C49A?style=for-the-badge&labelColor=E5E7EB&color=00C49A)](https://github.com/microsoft/ai-agents-for-beginners?WT.mc_id=academic-105485-koreyst) --- - -### जनरेटिव एआई श्रृंखला -[![शुरुआती लोगों के लिए जनरेटिव एआई](https://img.shields.io/badge/Generative%20AI%20for%20Beginners-8B5CF6?style=for-the-badge&labelColor=E5E7EB&color=8B5CF6)](https://github.com/microsoft/generative-ai-for-beginners?WT.mc_id=academic-105485-koreyst) -[![जनरेटिव एआई (.NET)](https://img.shields.io/badge/Generative%20AI%20(.NET)-9333EA?style=for-the-badge&labelColor=E5E7EB&color=9333EA)](https://github.com/microsoft/Generative-AI-for-beginners-dotnet?WT.mc_id=academic-105485-koreyst) -[![जनरेटिव एआई (जावा)](https://img.shields.io/badge/Generative%20AI%20(Java)-C084FC?style=for-the-badge&labelColor=E5E7EB&color=C084FC)](https://github.com/microsoft/generative-ai-for-beginners-java?WT.mc_id=academic-105485-koreyst) -[![जनरेटिव एआई (जावास्क्रिप्ट)](https://img.shields.io/badge/Generative%20AI%20(JavaScript)-E879F9?style=for-the-badge&labelColor=E5E7EB&color=E879F9)](https://github.com/microsoft/generative-ai-with-javascript?WT.mc_id=academic-105485-koreyst) + +### जनरेटिव AI श्रृंखला +[![Generative AI for Beginners](https://img.shields.io/badge/Generative%20AI%20for%20Beginners-8B5CF6?style=for-the-badge&labelColor=E5E7EB&color=8B5CF6)](https://github.com/microsoft/generative-ai-for-beginners?WT.mc_id=academic-105485-koreyst) +[![Generative AI (.NET)](https://img.shields.io/badge/Generative%20AI%20(.NET)-9333EA?style=for-the-badge&labelColor=E5E7EB&color=9333EA)](https://github.com/microsoft/Generative-AI-for-beginners-dotnet?WT.mc_id=academic-105485-koreyst) +[![Generative AI (Java)](https://img.shields.io/badge/Generative%20AI%20(Java)-C084FC?style=for-the-badge&labelColor=E5E7EB&color=C084FC)](https://github.com/microsoft/generative-ai-for-beginners-java?WT.mc_id=academic-105485-koreyst) +[![Generative AI (JavaScript)](https://img.shields.io/badge/Generative%20AI%20(JavaScript)-E879F9?style=for-the-badge&labelColor=E5E7EB&color=E879F9)](https://github.com/microsoft/generative-ai-with-javascript?WT.mc_id=academic-105485-koreyst) --- + +### मूल शिक्षण +[![ML for Beginners](https://img.shields.io/badge/ML%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=22C55E)](https://aka.ms/ml-beginners?WT.mc_id=academic-105485-koreyst) +[![Data Science for Beginners](https://img.shields.io/badge/Data%20Science%20for%20Beginners-84CC16?style=for-the-badge&labelColor=E5E7EB&color=84CC16)](https://aka.ms/datascience-beginners?WT.mc_id=academic-105485-koreyst) +[![AI for Beginners](https://img.shields.io/badge/AI%20for%20Beginners-A3E635?style=for-the-badge&labelColor=E5E7EB&color=A3E635)](https://aka.ms/ai-beginners?WT.mc_id=academic-105485-koreyst) +[![Cybersecurity for Beginners](https://img.shields.io/badge/Cybersecurity%20for%20Beginners-F97316?style=for-the-badge&labelColor=E5E7EB&color=F97316)](https://github.com/microsoft/Security-101?WT.mc_id=academic-96948-sayoung) -### मुख्य सीखना -[![शुरुआती लोगों के लिए मशीन लर्निंग](https://img.shields.io/badge/ML%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=22C55E)](https://aka.ms/ml-beginners?WT.mc_id=academic-105485-koreyst) -[![शुरुआती लोगों के लिए डेटा साइंस](https://img.shields.io/badge/Data%20Science%20for%20Beginners-84CC16?style=for-the-badge&labelColor=E5E7EB&color=84CC16)](https://aka.ms/datascience-beginners?WT.mc_id=academic-105485-koreyst) -[![शुरुआती लोगों के लिए एआई](https://img.shields.io/badge/AI%20for%20Beginners-A3E635?style=for-the-badge&labelColor=E5E7EB&color=A3E635)](https://aka.ms/ai-beginners?WT.mc_id=academic-105485-koreyst) -[![शुरुआती लोगों के लिए साइबरसिक्योरिटी](https://img.shields.io/badge/Cybersecurity%20for%20Beginners-F97316?style=for-the-badge&labelColor=E5E7EB&color=F97316)](https://github.com/microsoft/Security-101?WT.mc_id=academic-96948-sayoung) -[![शुरुआती लोगों के लिए वेब डेवलपमेंट](https://img.shields.io/badge/Web%20Dev%20for%20Beginners-EC4899?style=for-the-badge&labelColor=E5E7EB&color=EC4899)](https://aka.ms/webdev-beginners?WT.mc_id=academic-105485-koreyst) +[![Web Dev for Beginners](https://img.shields.io/badge/Web%20Dev%20for%20Beginners-EC4899?style=for-the-badge&labelColor=E5E7EB&color=EC4899)](https://aka.ms/webdev-beginners?WT.mc_id=academic-105485-koreyst) [![IoT for Beginners](https://img.shields.io/badge/IoT%20for%20Beginners-14B8A6?style=for-the-badge&labelColor=E5E7EB&color=14B8A6)](https://aka.ms/iot-beginners?WT.mc_id=academic-105485-koreyst) [![XR Development for Beginners](https://img.shields.io/badge/XR%20Development%20for%20Beginners-38BDF8?style=for-the-badge&labelColor=E5E7EB&color=38BDF8)](https://github.com/microsoft/xr-development-for-beginners?WT.mc_id=academic-105485-koreyst) --- -### कोपिलट श्रृंखला +### Copilot श्रृंखला [![Copilot for AI Paired Programming](https://img.shields.io/badge/Copilot%20for%20AI%20Paired%20Programming-FACC15?style=for-the-badge&labelColor=E5E7EB&color=FACC15)](https://aka.ms/GitHubCopilotAI?WT.mc_id=academic-105485-koreyst) [![Copilot for C#/.NET](https://img.shields.io/badge/Copilot%20for%20C%23/.NET-FBBF24?style=for-the-badge&labelColor=E5E7EB&color=FBBF24)](https://github.com/microsoft/mastering-github-copilot-for-dotnet-csharp-developers?WT.mc_id=academic-105485-koreyst) [![Copilot Adventure](https://img.shields.io/badge/Copilot%20Adventure-FDE68A?style=for-the-badge&labelColor=E5E7EB&color=FDE68A)](https://github.com/microsoft/CopilotAdventures?WT.mc_id=academic-105485-koreyst) -## मदद प्राप्त करें +## सहायता प्राप्त करें -अगर आप अटक जाते हैं या AI ऐप बनाने के बारे में कोई सवाल है, तो साथ सीखने वालों और अनुभवी डेवलपर्स के साथ MCP पर चर्चा में जुड़ें। यह एक सहायक समुदाय है जहां सवालों का स्वागत है और ज्ञान स्वभाव से साझा किया जाता है। +यदि आप फंस जाते हैं या AI ऐप बनाने के बारे में कोई भी प्रश्न हैं। MCP के बारे में चर्चा में साथी शिक्षार्थियों और अनुभवी डेवलपर्स के साथ जुड़ें। यह एक सहायक समुदाय है जहाँ प्रश्न स्वागत योग्य हैं और ज्ञान स्वतंत्र रूप से साझा किया जाता है। [![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) -अगर आपके पास उत्पाद प्रतिक्रियाएँ या निर्माण के दौरान त्रुटियाँ हैं, तो यहाँ जाएँ: +यदि आपके पास उत्पाद प्रतिक्रिया या निर्माण के दौरान त्रुटियां हैं तो यहाँ जाएं: [![Microsoft Foundry Developer Forum](https://img.shields.io/badge/GitHub-Microsoft_Foundry_Developer_Forum-blue?style=for-the-badge&logo=github&color=000000&logoColor=fff)](https://aka.ms/foundry/forum) @@ -142,5 +134,5 @@ CO_OP_TRANSLATOR_METADATA: **अस्वीकरण**: -यह दस्तावेज़ AI अनुवाद सेवा [Co-op Translator](https://github.com/Azure/co-op-translator) का उपयोग करके अनुवादित किया गया है। जबकि हम सटीकता के लिए प्रयासरत हैं, कृपया ध्यान दें कि स्वचालित अनुवाद में त्रुटियाँ या अस्पष्टताएँ हो सकती हैं। मूल दस्तावेज़ अपनी मूल भाषा में ही प्रामाणिक स्रोत माना जाना चाहिए। महत्वपूर्ण जानकारी के लिए, पेशेवर मानव अनुवाद की सिफारिश की जाती है। इस अनुवाद के उपयोग से उत्पन्न किसी भी गलतफहमी या गलत व्याख्या के लिए हम जिम्मेदार नहीं हैं। +यह दस्तावेज़ एआई अनुवाद सेवा [Co-op Translator](https://github.com/Azure/co-op-translator) का उपयोग करके अनूदित किया गया है। जबकि हम सटीकता के लिए प्रयासरत हैं, कृपया ध्यान दें कि स्वचालित अनुवादों में त्रुटियाँ या अशुद्धियाँ हो सकती हैं। मूल भाषा में मूल दस्तावेज़ को आधिकारिक स्रोत माना जाना चाहिए। महत्वपूर्ण जानकारी के लिए, पेशेवर मानवीय अनुवाद की सलाह दी जाती है। इस अनुवाद के उपयोग से उत्पन्न किसी भी गलतफहमी या गलत व्याख्या के लिए हम जिम्मेदार नहीं हैं। \ No newline at end of file diff --git a/translations/hi/SECURITY.md b/translations/hi/SECURITY.md index 4a56b64a..f43dd52a 100644 --- a/translations/hi/SECURITY.md +++ b/translations/hi/SECURITY.md @@ -1,12 +1,3 @@ - ## सुरक्षा Microsoft हमारे सॉफ़्टवेयर उत्पादों और सेवाओं की सुरक्षा को गंभीरता से लेता है, जिसमें हमारे GitHub संगठनों के माध्यम से प्रबंधित सभी स्रोत कोड रिपॉजिटरी शामिल हैं, जैसे [Microsoft](https://github.com/Microsoft), [Azure](https://github.com/Azure), [DotNet](https://github.com/dotnet), [AspNet](https://github.com/aspnet) और [Xamarin](https://github.com/xamarin)। diff --git a/translations/hi/SUPPORT.md b/translations/hi/SUPPORT.md index 5ba53723..df54624c 100644 --- a/translations/hi/SUPPORT.md +++ b/translations/hi/SUPPORT.md @@ -1,12 +1,3 @@ - # सहायता ## समस्याएँ दर्ज करना और मदद प्राप्त करना diff --git a/translations/hk/02-SetupDevEnvironment/README.md b/translations/hk/02-SetupDevEnvironment/README.md deleted file mode 100644 index 545d7692..00000000 --- a/translations/hk/02-SetupDevEnvironment/README.md +++ /dev/null @@ -1,13 +0,0 @@ - - - ---- - diff --git a/translations/hk/README.md b/translations/hk/README.md deleted file mode 100644 index bff25fdf..00000000 --- a/translations/hk/README.md +++ /dev/null @@ -1,146 +0,0 @@ - -# 生成式人工智能初學者指南 - Java 版 -[![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) - -![生成式人工智能初學者指南 - Java 版](../../translated_images/hk/beg-genai-series.8b48be9951cc574c.webp) - -**所需時間**：整個工作坊可線上完成，毋須本地設置。環境設定約需 2 分鐘，瀏覽範例所需時間依探索深度約 1-3 小時。 - -> **快速開始** - -1. 將本儲存庫分叉到你的 GitHub 帳戶 -2. 點擊 **Code** → **Codespaces** 標籤 → **...** → **帶選項新建...** -3. 使用預設值 — 此選擇將會載入為本課程所建立的開發容器 -4. 點擊 **建立 codespace** -5. 等待約 2 分鐘以完成環境準備 -6. 直接跳到 [第一個範例](./02-SetupDevEnvironment/README.md#step-2-create-a-github-personal-access-token) - -> **偏好本地克隆？** -> -> 本儲存庫包含 50 多種語言的翻譯，導致下載大小大幅增加。若想無翻譯地克隆，請使用 sparse checkout： -> ```bash -> git clone --filter=blob:none --sparse https://github.com/microsoft/Generative-AI-for-beginners-java.git -> cd Generative-AI-for-beginners-java -> git sparse-checkout set --no-cone '/*' '!translations' '!translated_images' -> ``` -> 如此你將快速獲得完成課程所需的所有內容。 - -## 多語言支援 - -### 透過 GitHub Action 支援（自動且永遠保持最新） - - -[阿拉伯文](../ar/README.md) | [孟加拉文](../bn/README.md) | [保加利亞文](../bg/README.md) | [緬甸文 (Myanmar)](../my/README.md) | [中文 (簡體)](../zh/README.md) | [中文 (繁體，香港)](./README.md) | [中文 (繁體，澳門)](../mo/README.md) | [中文 (繁體，臺灣)](../tw/README.md) | [克羅地亞文](../hr/README.md) | [捷克文](../cs/README.md) | [丹麥文](../da/README.md) | [荷蘭文](../nl/README.md) | [愛沙尼亞文](../et/README.md) | [芬蘭文](../fi/README.md) | [法文](../fr/README.md) | [德文](../de/README.md) | [希臘文](../el/README.md) | [希伯來文](../he/README.md) | [印地文](../hi/README.md) | [匈牙利文](../hu/README.md) | [印尼文](../id/README.md) | [義大利文](../it/README.md) | [日文](../ja/README.md) | [坎納達文](../kn/README.md) | [韓文](../ko/README.md) | [立陶宛文](../lt/README.md) | [馬來文](../ms/README.md) | [馬拉雅拉姆文](../ml/README.md) | [馬拉地文](../mr/README.md) | [尼泊爾文](../ne/README.md) | [奈及利亞皮欽語](../pcm/README.md) | [挪威文](../no/README.md) | [波斯文 (法爾西)](../fa/README.md) | [波蘭文](../pl/README.md) | [葡萄牙文 (巴西)](../br/README.md) | [葡萄牙文 (葡萄牙)](../pt/README.md) | [旁遮普文 (古魯穆奇)](../pa/README.md) | [羅馬尼亞文](../ro/README.md) | [俄文](../ru/README.md) | [塞爾維亞文 (西里爾字母)](../sr/README.md) | [斯洛伐克文](../sk/README.md) | [斯洛文尼亞文](../sl/README.md) | [西班牙文](../es/README.md) | [斯瓦希里文](../sw/README.md) | [瑞典文](../sv/README.md) | [塔加洛語 (菲律賓語)](../tl/README.md) | [泰米爾文](../ta/README.md) | [泰盧固文](../te/README.md) | [泰文](../th/README.md) | [土耳其文](../tr/README.md) | [烏克蘭文](../uk/README.md) | [烏爾都文](../ur/README.md) | [越南文](../vi/README.md) - -> **偏好本地克隆？** - -> 本儲存庫包含 50 多種語言的翻譯，導致下載大小大幅增加。若想無翻譯地克隆，請使用 sparse checkout： -> ```bash -> git clone --filter=blob:none --sparse https://github.com/microsoft/Generative-AI-for-beginners-java.git -> cd Generative-AI-for-beginners-java -> git sparse-checkout set --no-cone '/*' '!translations' '!translated_images' -> ``` -> 如此你將快速獲得完成課程所需的所有內容。 - - -## 課程結構與學習路徑 - -### **第一章：生成式人工智能簡介** -- **核心概念**：理解大型語言模型、tokens、嵌入向量及 AI 能力 -- **Java AI 生態系**：Spring AI 與 OpenAI SDK 概覽 -- **模型上下文協議**：MCP 介紹與其在 AI 代理通訊中的角色 -- **實務應用**：聊天機器人及內容生成等真實場景 -- **[→ 開始第一章](./01-IntroToGenAI/README.md)** - -### **第二章：開發環境設置** -- **多供應商配置**：設定 GitHub Models、Azure OpenAI 與 OpenAI Java SDK 整合 -- **Spring Boot + Spring AI**：企業級 AI 應用最佳實踐 -- **GitHub Models**：免費 AI 模型使用（無須信用卡）供快速原型與學習 -- **開發工具**：Docker 容器、VS Code 與 GitHub Codespaces 配置 -- **[→ 開始第二章](./02-SetupDevEnvironment/README.md)** - -### **第三章：生成式 AI 核心技術** -- **提示工程**：促使 AI 模型給出最佳回應的技術 -- **嵌入向量與向量運算**：實現語義搜尋與相似性匹配 -- **檢索增強生成 (RAG)**：結合 AI 與自有資料源 -- **函式呼叫**：利用自訂工具與插件擴充 AI 能力 -- **[→ 開始第三章](./03-CoreGenerativeAITechniques/README.md)** - -### **第四章：實務應用與專案** -- **寵物故事生成器** (`petstory/`)：使用 GitHub Models 進行創意內容生成 -- **Foundry 本地示範** (`foundrylocal/`)：OpenAI Java SDK 本地 AI 模型整合 -- **MCP 計算器服務** (`calculator/`)：使用 Spring AI 的基本模型上下文協議實作 -- **[→ 開始第四章](./04-PracticalSamples/README.md)** - -### **第五章：負責任的 AI 開發** -- **GitHub Models 安全性**：測試內建內容過濾和安全機制（嚴格封鎖與軟性拒絕） -- **負責任 AI 演示**：示範現代 AI 安全系統的操作實例 -- **最佳實踐**：道德 AI 開發與部署的要點指南 -- **[→ 開始第五章](./05-ResponsibleGenAI/README.md)** - -## 其他資源 - - -### LangChain -[![LangChain4j 初學者](https://img.shields.io/badge/LangChain4j%20for%20Beginners-22C55E?style=for-the-badge&&labelColor=E5E7EB&color=0553D6)](https://aka.ms/langchain4j-for-beginners) -[![LangChain.js 初學者](https://img.shields.io/badge/LangChain.js%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=0553D6)](https://aka.ms/langchainjs-for-beginners?WT.mc_id=m365-94501-dwahlin) - ---- - -### Azure / Edge / MCP / 代理 -[![AZD 初學者](https://img.shields.io/badge/AZD%20for%20Beginners-0078D4?style=for-the-badge&labelColor=E5E7EB&color=0078D4)](https://github.com/microsoft/AZD-for-beginners?WT.mc_id=academic-105485-koreyst) -[![Edge AI 初學者](https://img.shields.io/badge/Edge%20AI%20for%20Beginners-00B8E4?style=for-the-badge&labelColor=E5E7EB&color=00B8E4)](https://github.com/microsoft/edgeai-for-beginners?WT.mc_id=academic-105485-koreyst) -[![MCP 初學者](https://img.shields.io/badge/MCP%20for%20Beginners-009688?style=for-the-badge&labelColor=E5E7EB&color=009688)](https://github.com/microsoft/mcp-for-beginners?WT.mc_id=academic-105485-koreyst) -[![AI 代理初學者](https://img.shields.io/badge/AI%20Agents%20for%20Beginners-00C49A?style=for-the-badge&labelColor=E5E7EB&color=00C49A)](https://github.com/microsoft/ai-agents-for-beginners?WT.mc_id=academic-105485-koreyst) - ---- - -### 生成式 AI 系列 -[![生成式人工智能初學者](https://img.shields.io/badge/Generative%20AI%20for%20Beginners-8B5CF6?style=for-the-badge&labelColor=E5E7EB&color=8B5CF6)](https://github.com/microsoft/generative-ai-for-beginners?WT.mc_id=academic-105485-koreyst) -[![生成式 AI (.NET)](https://img.shields.io/badge/Generative%20AI%20(.NET)-9333EA?style=for-the-badge&labelColor=E5E7EB&color=9333EA)](https://github.com/microsoft/Generative-AI-for-beginners-dotnet?WT.mc_id=academic-105485-koreyst) -[![生成式 AI (Java)](https://img.shields.io/badge/Generative%20AI%20(Java)-C084FC?style=for-the-badge&labelColor=E5E7EB&color=C084FC)](https://github.com/microsoft/generative-ai-for-beginners-java?WT.mc_id=academic-105485-koreyst) -[![生成式 AI (JavaScript)](https://img.shields.io/badge/Generative%20AI%20(JavaScript)-E879F9?style=for-the-badge&labelColor=E5E7EB&color=E879F9)](https://github.com/microsoft/generative-ai-with-javascript?WT.mc_id=academic-105485-koreyst) - ---- - -### 核心學習 -[![機器學習初學者](https://img.shields.io/badge/ML%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=22C55E)](https://aka.ms/ml-beginners?WT.mc_id=academic-105485-koreyst) -[![資料科學初學者](https://img.shields.io/badge/Data%20Science%20for%20Beginners-84CC16?style=for-the-badge&labelColor=E5E7EB&color=84CC16)](https://aka.ms/datascience-beginners?WT.mc_id=academic-105485-koreyst) -[![人工智能初學者](https://img.shields.io/badge/AI%20for%20Beginners-A3E635?style=for-the-badge&labelColor=E5E7EB&color=A3E635)](https://aka.ms/ai-beginners?WT.mc_id=academic-105485-koreyst) -[![網絡安全初學者](https://img.shields.io/badge/Cybersecurity%20for%20Beginners-F97316?style=for-the-badge&labelColor=E5E7EB&color=F97316)](https://github.com/microsoft/Security-101?WT.mc_id=academic-96948-sayoung) -[![網頁開發初學者](https://img.shields.io/badge/Web%20Dev%20for%20Beginners-EC4899?style=for-the-badge&labelColor=E5E7EB&color=EC4899)](https://aka.ms/webdev-beginners?WT.mc_id=academic-105485-koreyst) -[![IoT for Beginners](https://img.shields.io/badge/IoT%20for%20Beginners-14B8A6?style=for-the-badge&labelColor=E5E7EB&color=14B8A6)](https://aka.ms/iot-beginners?WT.mc_id=academic-105485-koreyst) -[![XR Development for Beginners](https://img.shields.io/badge/XR%20Development%20for%20Beginners-38BDF8?style=for-the-badge&labelColor=E5E7EB&color=38BDF8)](https://github.com/microsoft/xr-development-for-beginners?WT.mc_id=academic-105485-koreyst) - ---- - -### Copilot 系列 -[![Copilot for AI Paired Programming](https://img.shields.io/badge/Copilot%20for%20AI%20Paired%20Programming-FACC15?style=for-the-badge&labelColor=E5E7EB&color=FACC15)](https://aka.ms/GitHubCopilotAI?WT.mc_id=academic-105485-koreyst) -[![Copilot for C#/.NET](https://img.shields.io/badge/Copilot%20for%20C%23/.NET-FBBF24?style=for-the-badge&labelColor=E5E7EB&color=FBBF24)](https://github.com/microsoft/mastering-github-copilot-for-dotnet-csharp-developers?WT.mc_id=academic-105485-koreyst) -[![Copilot Adventure](https://img.shields.io/badge/Copilot%20Adventure-FDE68A?style=for-the-badge&labelColor=E5E7EB&color=FDE68A)](https://github.com/microsoft/CopilotAdventures?WT.mc_id=academic-105485-koreyst) - - -## 尋求幫助 - -如果您遇到困難或對建立 AI 應用有任何疑問，加入其他學習者和有經驗的開發者，共同討論 MCP。這是一個支持性的社群，歡迎提問並自由分享知識。 - -[![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) - -如果您在開發過程中有產品反饋或錯誤，請造訪： - -[![Microsoft Foundry Developer Forum](https://img.shields.io/badge/GitHub-Microsoft_Foundry_Developer_Forum-blue?style=for-the-badge&logo=github&color=000000&logoColor=fff)](https://aka.ms/foundry/forum) - ---- - - -**免責聲明**： -本文件由 AI 翻譯服務 [Co-op Translator](https://github.com/Azure/co-op-translator) 所翻譯。雖然我們致力於確保準確性，但請注意自動翻譯可能包含錯誤或不準確之處。原始文件的母語版本應被視為權威來源。對於重要資訊，建議採用專業人工翻譯。我們不對因使用本翻譯而產生的任何誤解或曲解承擔責任。 - \ No newline at end of file diff --git a/translations/hr/.co-op-translator.json b/translations/hr/.co-op-translator.json new file mode 100644 index 00000000..3128517a --- /dev/null +++ b/translations/hr/.co-op-translator.json @@ -0,0 +1,92 @@ +{ + "01-IntroToGenAI/README.md": { + "original_hash": "75bfb080ca725e8a9aa9c80cae25fba1", + "translation_date": "2025-07-29T10:20:46+00:00", + "source_file": "01-IntroToGenAI/README.md", + "language_code": "hr" + }, + "02-SetupDevEnvironment/README.md": { + "original_hash": "96a30d42b9751a3d4e4b20e28d29d459", + "translation_date": "2026-01-28T05:25:25+00:00", + "source_file": "02-SetupDevEnvironment/README.md", + "language_code": "hr" + }, + "02-SetupDevEnvironment/examples/basic-chat-azure/README.md": { + "original_hash": "efd82efe50711d7e257eb943151d682c", + "translation_date": "2025-07-27T13:48:10+00:00", + "source_file": "02-SetupDevEnvironment/examples/basic-chat-azure/README.md", + "language_code": "hr" + }, + "02-SetupDevEnvironment/getting-started-azure-openai.md": { + "original_hash": "bfdb4b4eadbee3a59ef742439f58326a", + "translation_date": "2025-07-27T13:29:00+00:00", + "source_file": "02-SetupDevEnvironment/getting-started-azure-openai.md", + "language_code": "hr" + }, + "03-CoreGenerativeAITechniques/README.md": { + "original_hash": "685f55cb07de19b52a30ce6e8b6d889e", + "translation_date": "2025-08-28T22:18:20+00:00", + "source_file": "03-CoreGenerativeAITechniques/README.md", + "language_code": "hr" + }, + "04-PracticalSamples/README.md": { + "original_hash": "14c0a61ecc1cd2012a9c129236dfdf71", + "translation_date": "2025-07-29T10:20:29+00:00", + "source_file": "04-PracticalSamples/README.md", + "language_code": "hr" + }, + "04-PracticalSamples/calculator/README.md": { + "original_hash": "b6c16b5514d524e415a94f6097ee7d4c", + "translation_date": "2025-09-18T15:43:19+00:00", + "source_file": "04-PracticalSamples/calculator/README.md", + "language_code": "hr" + }, + "04-PracticalSamples/foundrylocal/README.md": { + "original_hash": "f787307400de59adc25a1404466a35f3", + "translation_date": "2025-11-04T07:35:45+00:00", + "source_file": "04-PracticalSamples/foundrylocal/README.md", + "language_code": "hr" + }, + "04-PracticalSamples/petstory/README.md": { + "original_hash": "0cbf68d605615a1e602c832a24616859", + "translation_date": "2025-07-25T12:04:08+00:00", + "source_file": "04-PracticalSamples/petstory/README.md", + "language_code": "hr" + }, + "05-ResponsibleGenAI/README.md": { + "original_hash": "301c05c2f57e60a6950b8c665b8bdbba", + "translation_date": "2025-07-29T16:00:26+00:00", + "source_file": "05-ResponsibleGenAI/README.md", + "language_code": "hr" + }, + "AGENTS.md": { + "original_hash": "afc90918d008cf77fd1982691f681306", + "translation_date": "2025-10-03T08:44:48+00:00", + "source_file": "AGENTS.md", + "language_code": "hr" + }, + "CODE_OF_CONDUCT.md": { + "original_hash": "442b123d034f92f7c384d2bbd28f99f1", + "translation_date": "2025-07-21T20:37:56+00:00", + "source_file": "CODE_OF_CONDUCT.md", + "language_code": "hr" + }, + "README.md": { + "original_hash": "125a08948d881c95628094f4dd1fbd43", + "translation_date": "2026-01-29T16:16:18+00:00", + "source_file": "README.md", + "language_code": "hr" + }, + "SECURITY.md": { + "original_hash": "57f14126c1c6add76b3aef3844dfe4e3", + "translation_date": "2025-07-21T20:36:13+00:00", + "source_file": "SECURITY.md", + "language_code": "hr" + }, + "SUPPORT.md": { + "original_hash": "b8ef73cc49dec68e2c885ee9df545129", + "translation_date": "2025-07-21T20:39:13+00:00", + "source_file": "SUPPORT.md", + "language_code": "hr" + } +} \ No newline at end of file diff --git a/translations/hr/01-IntroToGenAI/README.md b/translations/hr/01-IntroToGenAI/README.md index 9454492f..6ac7504f 100644 --- a/translations/hr/01-IntroToGenAI/README.md +++ b/translations/hr/01-IntroToGenAI/README.md @@ -1,12 +1,3 @@ - # Uvod u Generativnu AI - Java izdanje ## Što ćete naučiti diff --git a/translations/hr/02-SetupDevEnvironment/README.md b/translations/hr/02-SetupDevEnvironment/README.md index e2501082..59a36ad1 100644 --- a/translations/hr/02-SetupDevEnvironment/README.md +++ b/translations/hr/02-SetupDevEnvironment/README.md @@ -1,13 +1,253 @@ - +# Postavljanje Razvojnog Okruženja za Generativnu AI za Javu +> **Brzi početak**: Kodirajte u oblaku za 2 minute - skočite na [Postavljanje GitHub Codespaces](../../../02-SetupDevEnvironment) - nije potrebna lokalna instalacija i koristi GitHub modele! + +> **Zanima vas Azure OpenAI?**, pogledajte naš [Vodič za postavljanje Azure OpenAI](getting-started-azure-openai.md) sa koracima za kreiranje novog Azure OpenAI resursa. + +## Što ćete naučiti + +- Postaviti razvojno okruženje za Java AI aplikacije +- Izabrati i konfigurirati željeno razvojno okruženje (cloud-first s Codespaces, lokalni dev container ili potpuna lokalna instalacija) +- Testirati postavke povezivanjem s GitHub modelima + +## Sadržaj + +- [Što ćete naučiti](../../../02-SetupDevEnvironment) +- [Uvod](../../../02-SetupDevEnvironment) +- [Korak 1: Postavite razvojno okruženje](../../../02-SetupDevEnvironment) + - [Opcija A: GitHub Codespaces (Preporučeno)](../../../02-SetupDevEnvironment) + - [Opcija B: Lokalni Dev Container](../../../02-SetupDevEnvironment) + - [Opcija C: Upotrijebite postojeću lokalnu instalaciju](../../../02-SetupDevEnvironment) +- [Korak 2: Kreirajte GitHub osobni pristupni token](../../../02-SetupDevEnvironment) +- [Korak 3: Testirajte postavke](../../../02-SetupDevEnvironment) +- [Rješavanje problema](../../../02-SetupDevEnvironment) +- [Sažetak](../../../02-SetupDevEnvironment) +- [Sljedeći koraci](../../../02-SetupDevEnvironment) + +## Uvod + +Ovo poglavlje vodi vas kroz postavljanje razvojnog okruženja. Koristit ćemo **GitHub modele** kao naš primarni primjer jer su besplatni, jednostavni za postavljanje s samo GitHub računom, ne zahtijevaju kreditnu karticu i omogućuju pristup više modela za eksperimentiranje. + +**Nije potrebna lokalna instalacija!** Možete odmah početi kodirati koristeći GitHub Codespaces koji pruža potpuno razvojno okruženje u vašem pregledniku. + +Screenshot: GitHub modeli + +Preporučujemo korištenje [**GitHub modela**](https://github.com/marketplace?type=models) za ovaj tečaj jer su: +- **Besplatni** za početak +- **Jednostavni** za postavljanje s samo GitHub računom +- **Nije potrebna kreditna kartica** +- Dostupno je **više modela** za eksperimentiranje + +> **Napomena**: GitHub modeli korišteni u ovoj obuci imaju ove besplatne limite: +> - 15 zahtjeva u minuti (150 dnevno) +> - ~8,000 riječi ulaza, ~4,000 riječi izlaza po zahtjevu +> - 5 istovremenih zahtjeva +> +> Za produkcijsku upotrebu nadogradite na Azure AI Foundry modele s vašim Azure računom. Vaš kod ne mora se mijenjati. Pogledajte [Azure AI Foundry dokumentaciju](https://learn.microsoft.com/azure/ai-foundry/foundry-models/how-to/quickstart-github-models). + +## Korak 1: Postavite razvojno okruženje + + + +Kreirali smo unaprijed konfiguriran razvojni container kako bismo smanjili vrijeme postavljanja i osigurali da imate sve potrebne alate za ovaj Generativni AI tečaj za Javu. Izaberite željeni razvojni pristup: + +### Opcije za postavljanje okruženja: + +#### Opcija A: GitHub Codespaces (Preporučeno) + +**Počnite kodirati za 2 minute - nije potrebna lokalna instalacija!** + +1. Forkajte ovaj repozitorij na vaš GitHub račun + > **Napomena**: Ako želite uređivati osnovnu konfiguraciju, pogledajte [Dev Container Configuration](../../../.devcontainer/devcontainer.json) +2. Kliknite **Code** → karticu **Codespaces** → **...** → **New with options...** +3. Koristite zadane postavke – ovo će odabrati **Dev container konfiguraciju**: **Generative AI Java Development Environment** prilagođeni devcontainer kreiran za ovaj tečaj +4. Kliknite **Create codespace** +5. Pričekajte ~2 minute da se okruženje pripremi +6. Nastavite na [Korak 2: Kreirajte GitHub Token](../../../02-SetupDevEnvironment) + +Screenshot: Codespaces podizbornik + +Screenshot: New with options + +Screenshot: Opcije za kreiranje codespacea + + +> **Prednosti Codespacesa**: +> - Nije potrebna lokalna instalacija +> - Radi na bilo kojem uređaju s preglednikom +> - Unaprijed konfiguriran sa svim alatima i ovisnostima +> - Besplatnih 60 sati mjesečno za osobne račune +> - Dosljedno okruženje za sve polaznike + +#### Opcija B: Lokalni Dev Container + +**Za developere koji preferiraju lokalni razvoj s Dockerom** + +1. Forkajte i klonirajte ovaj repozitorij na vaše lokalno računalo + > **Napomena**: Ako želite uređivati osnovnu konfiguraciju, pogledajte [Dev Container Configuration](../../../.devcontainer/devcontainer.json) +2. Instalirajte [Docker Desktop](https://www.docker.com/products/docker-desktop/) i [VS Code](https://code.visualstudio.com/) +3. Instalirajte [Dev Containers proširenje](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers) u VS Code +4. Otvorite mapu repozitorija u VS Code-u +5. Kada se pojavi upit, kliknite **Reopen in Container** (ili koristite `Ctrl+Shift+P` → "Dev Containers: Reopen in Container") +6. Pričekajte da se container izgradi i pokrene +7. Nastavite na [Korak 2: Kreirajte GitHub Token](../../../02-SetupDevEnvironment) + +Screenshot: Postavljanje dev containera + +Screenshot: Dev container build završen + +#### Opcija C: Upotrijebite postojeću lokalnu instalaciju + +**Za developere s postojećim Java okruženjem** + +Preduvjeti: +- [Java 21+](https://www.oracle.com/java/technologies/javase/jdk21-archive-downloads.html) +- [Maven 3.9+](https://maven.apache.org/download.cgi) +- [VS Code](https://code.visualstudio.com) ili vaš omiljeni IDE + +Koraci: +1. Klonirajte ovaj repozitorij na vaše lokalno računalo +2. Otvorite projekt u svom IDE-u +3. Nastavite na [Korak 2: Kreirajte GitHub Token](../../../02-SetupDevEnvironment) + +> **Savjet**: Ako imate računalo slabijih specifikacija, ali želite lokalni VS Code, koristite GitHub Codespaces! Možete spojiti lokalni VS Code na cloud-hosted Codespace za najbolje od oba svijeta. + +Screenshot: kreiran lokalni devcontainer primjer + + +## Korak 2: Kreirajte GitHub osobni pristupni token + +1. Idite na [GitHub postavke](https://github.com/settings/profile) i izaberite **Settings** iz izbornika profila. +2. U lijevom bočnom izborniku kliknite **Developer settings** (obično pri dnu). +3. Pod **Personal access tokens**, kliknite **Fine-grained tokens** (ili slijedite ovaj direktni [link](https://github.com/settings/personal-access-tokens)). +4. Kliknite **Generate new token**. +5. Pod "Token name" unesite opisni naziv (npr. `GenAI-Java-Course-Token`). +6. Postavite datum isteka (preporučeno: 7 dana radi sigurnosnih najboljih praksi). +7. Pod "Resource owner", izaberite svoj korisnički račun. +8. Pod "Repository access", izaberite repozitorije koje želite koristiti s GitHub modelima (ili "All repositories" ako je potrebno). +9. Pod "Account permissions", pronađite **Models** i postavite ga na **Read-only**. +10. Kliknite **Generate token**. +11. **Kopirajte i spremite token odmah** – nećete ga moći ponovno vidjeti! + +> **Sigurnosni savjet**: Koristite minimalan potrebni opseg i najkraće moguće vrijeme trajanja za vaše pristupne tokene. + +## Korak 3: Testirajte postavke s GitHub Models primjerom + +Kad je vaše razvojno okruženje spremno, testirajmo integraciju GitHub modela s našom primjer aplikacijom u [`02-SetupDevEnvironment/examples/github-models`](../../../02-SetupDevEnvironment/examples/github-models). + +1. Otvorite terminal u vašem razvojnom okruženju. +2. Idite u mapu s primjerom GitHub modela: + ```bash + cd 02-SetupDevEnvironment/examples/github-models + ``` +3. Postavite svoj GitHub token kao varijablu okoline: + ```bash + # macOS/Linux + export GITHUB_TOKEN=your_token_here + + # Windows (Command Prompt) + set GITHUB_TOKEN=your_token_here + + # Windows (PowerShell) + $env:GITHUB_TOKEN="your_token_here" + ``` + +4. Pokrenite aplikaciju: + ```bash + mvn compile exec:java -Dexec.mainClass="com.example.githubmodels.App" + ``` + +Trebali biste vidjeti izlaz sličan ovom: +```text +Using model: gpt-4.1-nano +Sending request to GitHub Models... +Response: Hello World! +``` + +### Razumijevanje Primjera Koda + +Prvo, razumimo što smo upravo pokrenuli. Primjer u `examples/github-models` koristi OpenAI Java SDK za povezivanje s GitHub modelima: + +**Što ovaj kod radi:** +- **Povezuje se** s GitHub modelima koristeći vaš osobni pristupni token +- **Šalje** jednostavnu poruku "Say Hello World!" AI modelu +- **Prima** i prikazuje odgovor AI-ja +- **Provjerava** da vaša postavka ispravno radi + +**Ključna ovisnost** (u `pom.xml`): +```xml + + com.openai + openai-java + 2.12.0 + +``` + +**Glavni kod** (`App.java`): +```java +// Povežite se s GitHub modelima koristeći OpenAI Java SDK +OpenAIClient client = OpenAIOkHttpClient.builder() + .apiKey(pat) + .baseUrl("https://models.inference.ai.azure.com") + .build(); + +// Kreirajte zahtjev za dovršetak chata +ChatCompletionCreateParams params = ChatCompletionCreateParams.builder() + .model(modelId) + .addSystemMessage("You are a concise assistant.") + .addUserMessage("Say Hello World!") + .build(); + +// Dobijte odgovor AI-ja +ChatCompletion response = client.chat().completions().create(params); +System.out.println("Response: " + response.choices().get(0).message().content().orElse("No response content")); +``` + +## Sažetak + +Odlično! Sada imate sve postavljeno: + +- Kreirali ste GitHub osobni pristupni token s pravim dopuštenjima za pristup AI modelima +- Pokrenuli ste Java razvojno okruženje (bilo da koristite Codespaces, dev containere ili lokalno) +- Povezali ste se s GitHub modelima koristeći OpenAI Java SDK za besplatan AI razvoj +- Testirali da sve radi jednostavnim primjerom koji komunicira s AI modelima + +## Sljedeći koraci + +[Poglavlje 3: Osnovne tehnike generativne AI](../03-CoreGenerativeAITechniques/README.md) + +## Rješavanje problema + +Imate problema? Evo uobičajenih problema i rješenja: + +- **Token ne radi?** + - Provjerite jeste li kopirali cijeli token bez dodatnih praznina + - Provjerite je li token ispravno postavljen kao varijabla okoline + - Potvrdite da token ima ispravna dopuštenja (Models: Read-only) + +- **Maven nije pronađen?** + - Ako koristite dev container/ Codespaces, Maven bi trebao biti unaprijed instaliran + - Za lokalnu instalaciju, osigurajte da je Java 21+ i Maven 3.9+ instaliran + - Pokušajte izvršiti `mvn --version` za provjeru instalacije + +- **Problemi s vezom?** + - Provjerite internetsku vezu + - Provjerite možete li pristupiti GitHubu s vaše mreže + - Provjerite da niste iza vatrozida koji blokira GitHub Models endpoint + +- **Dev container se ne pokreće?** + - Provjerite da je Docker Desktop pokrenut (za lokalni razvoj) + - Pokušajte ponovno izgraditi container: `Ctrl+Shift+P` → "Dev Containers: Rebuild Container" + +- **Pogreške pri kompajliranju aplikacije?** + - Provjerite jeste li u ispravnom direktoriju: `02-SetupDevEnvironment/examples/github-models` + - Pokušajte očistiti i ponovo izgraditi: `mvn clean compile` + +> **Trebate pomoć?**: Još imate problema? Otvorite issue u repozitoriju i pomoći ćemo vam. --- + +**Odricanje od odgovornosti**: +Ovaj dokument je preveden pomoću AI usluge za prijevod [Co-op Translator](https://github.com/Azure/co-op-translator). Iako nastojimo postići točnost, molimo imajte na umu da automatski prijevodi mogu sadržavati pogreške ili netočnosti. Izvornik dokumenta na izvornom jeziku treba se smatrati autoritativnim izvorom. Za kritične informacije preporučuje se profesionalni ljudski prijevod. Nismo odgovorni za bilo kakva nesporazuma ili pogrešna tumačenja koja proizlaze iz korištenja ovog prijevoda. + \ No newline at end of file diff --git a/translations/hr/02-SetupDevEnvironment/examples/basic-chat-azure/README.md b/translations/hr/02-SetupDevEnvironment/examples/basic-chat-azure/README.md index 1ad487db..516cfc18 100644 --- a/translations/hr/02-SetupDevEnvironment/examples/basic-chat-azure/README.md +++ b/translations/hr/02-SetupDevEnvironment/examples/basic-chat-azure/README.md @@ -1,12 +1,3 @@ - # Osnovni Chat s Azure OpenAI - Primjer od početka do kraja Ovaj primjer pokazuje kako napraviti jednostavnu Spring Boot aplikaciju koja se povezuje s Azure OpenAI i testira vašu konfiguraciju. diff --git a/translations/hr/02-SetupDevEnvironment/getting-started-azure-openai.md b/translations/hr/02-SetupDevEnvironment/getting-started-azure-openai.md index e5c0bbf3..8c69f679 100644 --- a/translations/hr/02-SetupDevEnvironment/getting-started-azure-openai.md +++ b/translations/hr/02-SetupDevEnvironment/getting-started-azure-openai.md @@ -1,12 +1,3 @@ - # Postavljanje Razvojnog Okruženja za Azure OpenAI > **Brzi početak**: Ovaj vodič je za postavljanje Azure OpenAI. Za trenutni početak s besplatnim modelima, koristite [GitHub Models with Codespaces](./README.md#quick-start-cloud). diff --git a/translations/hr/03-CoreGenerativeAITechniques/README.md b/translations/hr/03-CoreGenerativeAITechniques/README.md index 25dfe93d..1f0b0f3c 100644 --- a/translations/hr/03-CoreGenerativeAITechniques/README.md +++ b/translations/hr/03-CoreGenerativeAITechniques/README.md @@ -1,12 +1,3 @@ - # Vodič za osnovne tehnike generativne umjetne inteligencije ## Sadržaj diff --git a/translations/hr/04-PracticalSamples/README.md b/translations/hr/04-PracticalSamples/README.md index 01fe58d5..f364d6d3 100644 --- a/translations/hr/04-PracticalSamples/README.md +++ b/translations/hr/04-PracticalSamples/README.md @@ -1,12 +1,3 @@ - # Praktične Primjene i Projekti ## Što ćete naučiti diff --git a/translations/hr/04-PracticalSamples/calculator/README.md b/translations/hr/04-PracticalSamples/calculator/README.md index f293d252..42cfa83e 100644 --- a/translations/hr/04-PracticalSamples/calculator/README.md +++ b/translations/hr/04-PracticalSamples/calculator/README.md @@ -1,12 +1,3 @@ - # MCP Kalkulator Vodič za Početnike ## Sadržaj diff --git a/translations/hr/04-PracticalSamples/foundrylocal/README.md b/translations/hr/04-PracticalSamples/foundrylocal/README.md index 65ed2ccc..e676018d 100644 --- a/translations/hr/04-PracticalSamples/foundrylocal/README.md +++ b/translations/hr/04-PracticalSamples/foundrylocal/README.md @@ -1,12 +1,3 @@ - # Foundry Local Spring Boot Vodič ## Sadržaj diff --git a/translations/hr/04-PracticalSamples/petstory/README.md b/translations/hr/04-PracticalSamples/petstory/README.md index d68ee31f..a043328f 100644 --- a/translations/hr/04-PracticalSamples/petstory/README.md +++ b/translations/hr/04-PracticalSamples/petstory/README.md @@ -1,12 +1,3 @@ - # Vodič za početnike: Generator priča o kućnim ljubimcima ## Sadržaj diff --git a/translations/hr/05-ResponsibleGenAI/README.md b/translations/hr/05-ResponsibleGenAI/README.md index 8d9d4bfb..f8d7d08d 100644 --- a/translations/hr/05-ResponsibleGenAI/README.md +++ b/translations/hr/05-ResponsibleGenAI/README.md @@ -1,12 +1,3 @@ - # Odgovorna Generativna AI ## Što ćete naučiti diff --git a/translations/hr/AGENTS.md b/translations/hr/AGENTS.md index 73361c77..f1d3f201 100644 --- a/translations/hr/AGENTS.md +++ b/translations/hr/AGENTS.md @@ -1,12 +1,3 @@ - # AGENTS.md ## Pregled projekta diff --git a/translations/hr/CODE_OF_CONDUCT.md b/translations/hr/CODE_OF_CONDUCT.md index 485e04af..ff0d38ec 100644 --- a/translations/hr/CODE_OF_CONDUCT.md +++ b/translations/hr/CODE_OF_CONDUCT.md @@ -1,12 +1,3 @@ - # Microsoftov Kodeks ponašanja za otvoreni izvor Ovaj projekt je usvojio [Microsoftov Kodeks ponašanja za otvoreni izvor](https://opensource.microsoft.com/codeofconduct/). diff --git a/translations/hr/README.md b/translations/hr/README.md index 6555f3ef..55c28994 100644 --- a/translations/hr/README.md +++ b/translations/hr/README.md @@ -1,148 +1,139 @@ - -# Generativna AI za Početnike - Java Izdanje +# Generativna AI za početnike - Java izdanje [![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) -![Generativna AI za Početnike - Java Izdanje](../../translated_images/hr/beg-genai-series.8b48be9951cc574c.webp) +![Generativna AI za početnike - Java izdanje](../../translated_images/hr/beg-genai-series.8b48be9951cc574c.webp) -**Vrijeme Ulaganja**: Cijeli radionicu moguće je dovršiti online bez lokalne instalacije. Postavljanje okruženja traje 2 minute, dok istraživanje primjera zahtijeva 1-3 sata ovisno o dubini istraživanja. +**Vrijeme potrebno**: Cijela radionica može se završiti online bez lokalne postavke. Postavljanje okruženja traje 2 minute, a istraživanje primjera zahtijeva 1-3 sata ovisno o dubini istraživanja. -> **Brzi Početak** +> **Brzi početak** -1. Forkajte ovaj repozitorij na svoj GitHub račun -2. Kliknite **Code** → karticu **Codespaces** → **...** → **New with options...** +1. Napravite fork ovog spremišta na svoj GitHub račun +2. Kliknite **Code** → kartica **Codespaces** → **...** → **New with options...** 3. Koristite zadane postavke – ovo će odabrati razvojni kontejner kreiran za ovaj tečaj 4. Kliknite **Create codespace** 5. Pričekajte ~2 minute da se okruženje pripremi 6. Odmah prijeđite na [Prvi primjer](./02-SetupDevEnvironment/README.md#step-2-create-a-github-personal-access-token) -> **Više volite klonirati lokalno?** +> **Preferirate klonirati lokalno?** > -> Ovaj repozitorij uključuje 50+ prijevoda na različite jezike što značajno povećava veličinu preuzimanja. Za kloniranje bez prijevoda, koristite sparse checkout: +> Ovo spremište uključuje 50+ prijevoda jezika, što značajno povećava veličinu preuzimanja. Za kloniranje bez prijevoda, koristite sparse checkout: > ```bash > git clone --filter=blob:none --sparse https://github.com/microsoft/Generative-AI-for-beginners-java.git > cd Generative-AI-for-beginners-java > git sparse-checkout set --no-cone '/*' '!translations' '!translated_images' > ``` -> Ovo vam daje sve što vam treba za završetak tečaja uz znatno brže preuzimanje. +> Ovo vam daje sve što vam treba za završetak tečaja s puno bržim preuzimanjem. -## Podrška za Više Jezika +## Podrška za više jezika -### Podržano putem GitHub Akcije (Automatski & Uvijek ažurno) +### Podržano putem GitHub Action (automatizirano i uvijek ažurno) -[Arapski](../ar/README.md) | [Bengalski](../bn/README.md) | [Bugarski](../bg/README.md) | [Burmese (Myanmar)](../my/README.md) | [Kineski (Pojednostavljeni)](../zh/README.md) | [Kineski (Tradicionalni, Hong Kong)](../hk/README.md) | [Kineski (Tradicionalni, Macau)](../mo/README.md) | [Kineski (Tradicionalni, Taiwan)](../tw/README.md) | [Hrvatski](./README.md) | [Češki](../cs/README.md) | [Danski](../da/README.md) | [Nizozemski](../nl/README.md) | [Estonski](../et/README.md) | [Finski](../fi/README.md) | [Francuski](../fr/README.md) | [Njemački](../de/README.md) | [Grčki](../el/README.md) | [Hebrejski](../he/README.md) | [Hindi](../hi/README.md) | [Mađarski](../hu/README.md) | [Indonezijski](../id/README.md) | [Talijanski](../it/README.md) | [Japanski](../ja/README.md) | [Kannada](../kn/README.md) | [Korejski](../ko/README.md) | [Litavski](../lt/README.md) | [Malajski](../ms/README.md) | [Malajalamski](../ml/README.md) | [Marati](../mr/README.md) | [Nepalski](../ne/README.md) | [Nigerijski Pidgin](../pcm/README.md) | [Norveški](../no/README.md) | [Perzijski (Farsi)](../fa/README.md) | [Poljski](../pl/README.md) | [Portugalski (Brazil)](../br/README.md) | [Portugalski (Portugal)](../pt/README.md) | [Punjabi (Gurmukhi)](../pa/README.md) | [Rumunjski](../ro/README.md) | [Ruski](../ru/README.md) | [Srpski (ćirilica)](../sr/README.md) | [Slovački](../sk/README.md) | [Slovenski](../sl/README.md) | [Španjolski](../es/README.md) | [Svahili](../sw/README.md) | [Švedski](../sv/README.md) | [Tagalog (Filipinski)](../tl/README.md) | [Tamilski](../ta/README.md) | [Telugu](../te/README.md) | [Tajlandski](../th/README.md) | [Turski](../tr/README.md) | [Ukrajinski](../uk/README.md) | [Urdu](../ur/README.md) | [Vijetnamski](../vi/README.md) +[Arapski](../ar/README.md) | [Bengalski](../bn/README.md) | [Bugarski](../bg/README.md) | [Burmanski (Myanmar)](../my/README.md) | [Kineski (pojednostavljeni)](../zh-CN/README.md) | [Kineski (tradicionalni, Hong Kong)](../zh-HK/README.md) | [Kineski (tradicionalni, Makao)](../zh-MO/README.md) | [Kineski (tradicionalni, Tajvan)](../zh-TW/README.md) | [Hrvatski](./README.md) | [Češki](../cs/README.md) | [Danski](../da/README.md) | [Nizozemski](../nl/README.md) | [Estonski](../et/README.md) | [Finski](../fi/README.md) | [Francuski](../fr/README.md) | [Njemački](../de/README.md) | [Grčki](../el/README.md) | [Hebrejski](../he/README.md) | [Hindi](../hi/README.md) | [Mađarski](../hu/README.md) | [Indonezijski](../id/README.md) | [Talijanski](../it/README.md) | [Japanski](../ja/README.md) | [Kannada](../kn/README.md) | [Korejski](../ko/README.md) | [Litvanski](../lt/README.md) | [Malajski](../ms/README.md) | [Malajalamski](../ml/README.md) | [Marathi](../mr/README.md) | [Nepalski](../ne/README.md) | [Nigerijski pidžin](../pcm/README.md) | [Norveški](../no/README.md) | [Perzijski (Farsi)](../fa/README.md) | [Poljski](../pl/README.md) | [Portugalski (Brazil)](../pt-BR/README.md) | [Portugalski (Portugal)](../pt-PT/README.md) | [Punjabi (Gurmukhi)](../pa/README.md) | [Rumunjski](../ro/README.md) | [Ruski](../ru/README.md) | [Srpski (ćirilica)](../sr/README.md) | [Slovački](../sk/README.md) | [Slovenski](../sl/README.md) | [Španjolski](../es/README.md) | [Svahili](../sw/README.md) | [Švedski](../sv/README.md) | [Tagalog (Filipinski)](../tl/README.md) | [Tamilski](../ta/README.md) | [Telugu](../te/README.md) | [Tajlandski](../th/README.md) | [Turski](../tr/README.md) | [Ukrajinski](../uk/README.md) | [Urdu](../ur/README.md) | [Vijetnamski](../vi/README.md) -> **Više volite klonirati lokalno?** +> **Preferirate klonirati lokalno?** -> Ovaj repozitorij uključuje 50+ prijevoda na različite jezike što značajno povećava veličinu preuzimanja. Za kloniranje bez prijevoda, koristite sparse checkout: +> Ovo spremište uključuje 50+ prijevoda jezika, što značajno povećava veličinu preuzimanja. Za kloniranje bez prijevoda, koristite sparse checkout: > ```bash > git clone --filter=blob:none --sparse https://github.com/microsoft/Generative-AI-for-beginners-java.git > cd Generative-AI-for-beginners-java > git sparse-checkout set --no-cone '/*' '!translations' '!translated_images' > ``` -> Ovo vam daje sve što vam treba za završetak tečaja uz znatno brže preuzimanje. +> Ovo vam daje sve što vam treba za završetak tečaja s puno bržim preuzimanjem. -## Struktura Tečaja & Put Učenja - -### **Poglavlje 1: Uvod u Generativnu AI** -- **Osnovni Pojmovi**: Razumijevanje Velikih Jezičnih Modela, tokena, ureza i AI sposobnosti -- **Java AI Ekosustav**: Pregled Spring AI i OpenAI SDK-ova -- **Protokol Konteksta Modela**: Uvod u MCP i njegovu ulogu u komunikaciji AI agenata -- **Praktične Primjene**: Stvarni scenariji uključujući chatbotove i generiranje sadržaja -- **[→ Početak Poglavlja 1](./01-IntroToGenAI/README.md)** - -### **Poglavlje 2: Postavljanje Razvojnog Okruženja** -- **Konfiguracija Više Pružatelja**: Postavljanje GitHub Models, Azure OpenAI i OpenAI Java SDK integracija -- **Spring Boot + Spring AI**: Najbolje prakse za razvoj poslovnih AI aplikacija -- **GitHub Models**: Besplatan pristup AI modelima za prototipiranje i učenje (nije potrebna kreditna kartica) -- **Razvojni Alati**: Docker kontejneri, VS Code i GitHub Codespaces konfiguracija -- **[→ Početak Poglavlja 2](./02-SetupDevEnvironment/README.md)** - -### **Poglavlje 3: Osnovne Tehnike Generativne AI** -- **Inženjerstvo Prompta**: Tehnike za optimalne odgovore AI modela -- **Urezi i Vektorske Operacije**: Implementacija semantičkog pretraživanja i podudaranja sličnosti -- **Generiranje s Pomoći Dohvaćanja (RAG)**: Kombinacija AI-a s vlastitim izvorima podataka -- **Pozivanje Funkcija**: Proširenje AI mogućnosti prilagođenim alatima i dodacima -- **[→ Početak Poglavlja 3](./03-CoreGenerativeAITechniques/README.md)** - -### **Poglavlje 4: Praktične Primjene & Projekti** -- **Generator Priča o Kućnim Ljubimcima** (`petstory/`): Kreativno generiranje sadržaja s GitHub Models -- **Foundry Lokalna Demo Verzija** (`foundrylocal/`): Lokalna integracija AI modela s OpenAI Java SDK -- **MCP Kalkulator Servis** (`calculator/`): Osnovna implementacija Protokola Konteksta Modela sa Spring AI -- **[→ Početak Poglavlja 4](./04-PracticalSamples/README.md)** - -### **Poglavlje 5: Odgovorni Razvoj AI** -- **Sigurnost GitHub Models**: Testiranje ugrađenih mehanizama filtriranja sadržaja i sigurnosnih mjera (čvrste blokade i mekana odbijanja) -- **Demo Odgovorne AI**: Praktični primjer kako suvremeni sigurnosni sustavi AI-a funkcioniraju -- **Najbolje Prakse**: Osnovne smjernice za etički razvoj i implementaciju AI -- **[→ Početak Poglavlja 5](./05-ResponsibleGenAI/README.md)** - -## Dodatni Resursi +## Struktura tečaja i put učenja + +### **Poglavlje 1: Uvod u generativnu AI** +- **Osnovni pojmovi**: Razumijevanje velikih jezičnih modela, tokena, ugradnji i sposobnosti AI +- **Java AI ekosustav**: Pregled Spring AI i OpenAI SDK +- **Protokol konteksta modela**: Uvod u MCP i njegovu ulogu u komunikaciji AI agenata +- **Praktične primjene**: Scenariji iz stvarnog svijeta uključujući chatbotove i generiranje sadržaja +- **[→ Započni poglavlje 1](./01-IntroToGenAI/README.md)** + +### **Poglavlje 2: Postavljanje razvojne okoline** +- **Konfiguracija više pružatelja usluga**: Postavljanje GitHub modela, Azure OpenAI i OpenAI Java SDK integracija +- **Spring Boot + Spring AI**: Najbolje prakse za razvoj AI aplikacija u poduzećima +- **GitHub modeli**: Besplatan pristup AI modelima za prototipiranje i učenje (bez potrebe za karticom) +- **Alati za razvoj**: Docker kontejneri, VS Code i konfiguracija GitHub Codespaces +- **[→ Započni poglavlje 2](./02-SetupDevEnvironment/README.md)** + +### **Poglavlje 3: Osnovne tehnike generativne AI** +- **Prompt inženjering**: Tehnike za optimalne odgovore AI modela +- **Ugradnje i vektorske operacije**: Implementacija semantičke pretrage i usporedbe sličnosti +- **Retrieval-Augmented Generation (RAG)**: Kombinirajte AI s vlastitim izvorima podataka +- **Pozivanje funkcija**: Proširite sposobnosti AI prilagođenim alatima i dodacima +- **[→ Započni poglavlje 3](./03-CoreGenerativeAITechniques/README.md)** + +### **Poglavlje 4: Praktične primjene i projekti** +- **Generator priča o kućnim ljubimcima** (`petstory/`): Kreativno generiranje sadržaja s GitHub modelima +- **Foundry lokalna demonstracija** (`foundrylocal/`): Lokalna integracija AI modela s OpenAI Java SDK +- **MCP kalkulator servis** (`calculator/`): Osnovna implementacija Protokola konteksta modela sa Spring AI +- **[→ Započni poglavlje 4](./04-PracticalSamples/README.md)** + +### **Poglavlje 5: Odgovorni razvoj AI** +- **Sigurnost GitHub modela**: Isprobajte ugrađene mehanizme filtriranja sadržaja i sigurnosne mjere (tvrde blokade i meke odbijanja) +- **Demo odgovorne AI**: Praktični primjer koji pokazuje kako suvremeni AI sigurnosni sustavi rade u praksi +- **Najbolje prakse**: Osnovne smjernice za etički razvoj i implementaciju AI +- **[→ Započni poglavlje 5](./05-ResponsibleGenAI/README.md)** + +## Dodatni resursi ### LangChain -[![LangChain4j za Početnike](https://img.shields.io/badge/LangChain4j%20for%20Beginners-22C55E?style=for-the-badge&&labelColor=E5E7EB&color=0553D6)](https://aka.ms/langchain4j-for-beginners) -[![LangChain.js za Početnike](https://img.shields.io/badge/LangChain.js%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=0553D6)](https://aka.ms/langchainjs-for-beginners?WT.mc_id=m365-94501-dwahlin) +[![LangChain4j za početnike](https://img.shields.io/badge/LangChain4j%20for%20Beginners-22C55E?style=for-the-badge&&labelColor=E5E7EB&color=0553D6)](https://aka.ms/langchain4j-for-beginners) +[![LangChain.js za početnike](https://img.shields.io/badge/LangChain.js%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=0553D6)](https://aka.ms/langchainjs-for-beginners?WT.mc_id=m365-94501-dwahlin) --- ### Azure / Edge / MCP / Agenti -[![AZD za Početnike](https://img.shields.io/badge/AZD%20for%20Beginners-0078D4?style=for-the-badge&labelColor=E5E7EB&color=0078D4)](https://github.com/microsoft/AZD-for-beginners?WT.mc_id=academic-105485-koreyst) -[![Edge AI za Početnike](https://img.shields.io/badge/Edge%20AI%20for%20Beginners-00B8E4?style=for-the-badge&labelColor=E5E7EB&color=00B8E4)](https://github.com/microsoft/edgeai-for-beginners?WT.mc_id=academic-105485-koreyst) -[![MCP za Početnike](https://img.shields.io/badge/MCP%20for%20Beginners-009688?style=for-the-badge&labelColor=E5E7EB&color=009688)](https://github.com/microsoft/mcp-for-beginners?WT.mc_id=academic-105485-koreyst) -[![AI Agenti za Početnike](https://img.shields.io/badge/AI%20Agents%20for%20Beginners-00C49A?style=for-the-badge&labelColor=E5E7EB&color=00C49A)](https://github.com/microsoft/ai-agents-for-beginners?WT.mc_id=academic-105485-koreyst) +[![AZD za početnike](https://img.shields.io/badge/AZD%20for%20Beginners-0078D4?style=for-the-badge&labelColor=E5E7EB&color=0078D4)](https://github.com/microsoft/AZD-for-beginners?WT.mc_id=academic-105485-koreyst) +[![Edge AI za početnike](https://img.shields.io/badge/Edge%20AI%20for%20Beginners-00B8E4?style=for-the-badge&labelColor=E5E7EB&color=00B8E4)](https://github.com/microsoft/edgeai-for-beginners?WT.mc_id=academic-105485-koreyst) +[![MCP za početnike](https://img.shields.io/badge/MCP%20for%20Beginners-009688?style=for-the-badge&labelColor=E5E7EB&color=009688)](https://github.com/microsoft/mcp-for-beginners?WT.mc_id=academic-105485-koreyst) +[![AI agenti za početnike](https://img.shields.io/badge/AI%20Agents%20for%20Beginners-00C49A?style=for-the-badge&labelColor=E5E7EB&color=00C49A)](https://github.com/microsoft/ai-agents-for-beginners?WT.mc_id=academic-105485-koreyst) --- -### Serija Generativne AI -[![Generativna AI za Početnike](https://img.shields.io/badge/Generative%20AI%20for%20Beginners-8B5CF6?style=for-the-badge&labelColor=E5E7EB&color=8B5CF6)](https://github.com/microsoft/generative-ai-for-beginners?WT.mc_id=academic-105485-koreyst) +### Serija generativne AI +[![Generativna AI za početnike](https://img.shields.io/badge/Generative%20AI%20for%20Beginners-8B5CF6?style=for-the-badge&labelColor=E5E7EB&color=8B5CF6)](https://github.com/microsoft/generative-ai-for-beginners?WT.mc_id=academic-105485-koreyst) [![Generativna AI (.NET)](https://img.shields.io/badge/Generative%20AI%20(.NET)-9333EA?style=for-the-badge&labelColor=E5E7EB&color=9333EA)](https://github.com/microsoft/Generative-AI-for-beginners-dotnet?WT.mc_id=academic-105485-koreyst) [![Generativna AI (Java)](https://img.shields.io/badge/Generative%20AI%20(Java)-C084FC?style=for-the-badge&labelColor=E5E7EB&color=C084FC)](https://github.com/microsoft/generative-ai-for-beginners-java?WT.mc_id=academic-105485-koreyst) [![Generativna AI (JavaScript)](https://img.shields.io/badge/Generative%20AI%20(JavaScript)-E879F9?style=for-the-badge&labelColor=E5E7EB&color=E879F9)](https://github.com/microsoft/generative-ai-with-javascript?WT.mc_id=academic-105485-koreyst) --- -### Temeljno Učenje -[![ML za Početnike](https://img.shields.io/badge/ML%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=22C55E)](https://aka.ms/ml-beginners?WT.mc_id=academic-105485-koreyst) -[![Podatkovna Znanost za Početnike](https://img.shields.io/badge/Data%20Science%20for%20Beginners-84CC16?style=for-the-badge&labelColor=E5E7EB&color=84CC16)](https://aka.ms/datascience-beginners?WT.mc_id=academic-105485-koreyst) -[![AI za Početnike](https://img.shields.io/badge/AI%20for%20Beginners-A3E635?style=for-the-badge&labelColor=E5E7EB&color=A3E635)](https://aka.ms/ai-beginners?WT.mc_id=academic-105485-koreyst) -[![Kibernetička Sigurnost za Početnike](https://img.shields.io/badge/Cybersecurity%20for%20Beginners-F97316?style=for-the-badge&labelColor=E5E7EB&color=F97316)](https://github.com/microsoft/Security-101?WT.mc_id=academic-96948-sayoung) -[![Web Razvoj za Početnike](https://img.shields.io/badge/Web%20Dev%20for%20Beginners-EC4899?style=for-the-badge&labelColor=E5E7EB&color=EC4899)](https://aka.ms/webdev-beginners?WT.mc_id=academic-105485-koreyst) +### Osnovno učenje +[![ML za početnike](https://img.shields.io/badge/ML%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=22C55E)](https://aka.ms/ml-beginners?WT.mc_id=academic-105485-koreyst) +[![Data Science za početnike](https://img.shields.io/badge/Data%20Science%20for%20Beginners-84CC16?style=for-the-badge&labelColor=E5E7EB&color=84CC16)](https://aka.ms/datascience-beginners?WT.mc_id=academic-105485-koreyst) +[![AI za početnike](https://img.shields.io/badge/AI%20for%20Beginners-A3E635?style=for-the-badge&labelColor=E5E7EB&color=A3E635)](https://aka.ms/ai-beginners?WT.mc_id=academic-105485-koreyst) +[![Kibernetička sigurnost za početnike](https://img.shields.io/badge/Cybersecurity%20for%20Beginners-F97316?style=for-the-badge&labelColor=E5E7EB&color=F97316)](https://github.com/microsoft/Security-101?WT.mc_id=academic-96948-sayoung) -[![IoT za početnike](https://img.shields.io/badge/IoT%20for%20Beginners-14B8A6?style=for-the-badge&labelColor=E5E7EB&color=14B8A6)](https://aka.ms/iot-beginners?WT.mc_id=academic-105485-koreyst) -[![XR razvoj za početnike](https://img.shields.io/badge/XR%20Development%20for%20Beginners-38BDF8?style=for-the-badge&labelColor=E5E7EB&color=38BDF8)](https://github.com/microsoft/xr-development-for-beginners?WT.mc_id=academic-105485-koreyst) +[![Web Dev for Beginners](https://img.shields.io/badge/Web%20Dev%20for%20Beginners-EC4899?style=for-the-badge&labelColor=E5E7EB&color=EC4899)](https://aka.ms/webdev-beginners?WT.mc_id=academic-105485-koreyst) +[![IoT for Beginners](https://img.shields.io/badge/IoT%20for%20Beginners-14B8A6?style=for-the-badge&labelColor=E5E7EB&color=14B8A6)](https://aka.ms/iot-beginners?WT.mc_id=academic-105485-koreyst) +[![XR Development for Beginners](https://img.shields.io/badge/XR%20Development%20for%20Beginners-38BDF8?style=for-the-badge&labelColor=E5E7EB&color=38BDF8)](https://github.com/microsoft/xr-development-for-beginners?WT.mc_id=academic-105485-koreyst) --- -### Serija Copilot -[![Copilot za AI u parnom programiranju](https://img.shields.io/badge/Copilot%20for%20AI%20Paired%20Programming-FACC15?style=for-the-badge&labelColor=E5E7EB&color=FACC15)](https://aka.ms/GitHubCopilotAI?WT.mc_id=academic-105485-koreyst) -[![Copilot za C#/.NET](https://img.shields.io/badge/Copilot%20for%20C%23/.NET-FBBF24?style=for-the-badge&labelColor=E5E7EB&color=FBBF24)](https://github.com/microsoft/mastering-github-copilot-for-dotnet-csharp-developers?WT.mc_id=academic-105485-koreyst) -[![Copilot pustolovina](https://img.shields.io/badge/Copilot%20Adventure-FDE68A?style=for-the-badge&labelColor=E5E7EB&color=FDE68A)](https://github.com/microsoft/CopilotAdventures?WT.mc_id=academic-105485-koreyst) +### Copilot serija +[![Copilot for AI Paired Programming](https://img.shields.io/badge/Copilot%20for%20AI%20Paired%20Programming-FACC15?style=for-the-badge&labelColor=E5E7EB&color=FACC15)](https://aka.ms/GitHubCopilotAI?WT.mc_id=academic-105485-koreyst) +[![Copilot for C#/.NET](https://img.shields.io/badge/Copilot%20for%20C%23/.NET-FBBF24?style=for-the-badge&labelColor=E5E7EB&color=FBBF24)](https://github.com/microsoft/mastering-github-copilot-for-dotnet-csharp-developers?WT.mc_id=academic-105485-koreyst) +[![Copilot Adventure](https://img.shields.io/badge/Copilot%20Adventure-FDE68A?style=for-the-badge&labelColor=E5E7EB&color=FDE68A)](https://github.com/microsoft/CopilotAdventures?WT.mc_id=academic-105485-koreyst) ## Dobivanje pomoći -Ako zapnete ili imate bilo kakvih pitanja oko izgradnje AI aplikacija. Pridružite se kolegama učenicima i iskusnim programerima u raspravama o MCP-u. To je podržavajuća zajednica u kojoj su pitanja dobrodošla i gdje se znanje slobodno dijeli. +Ako zapnete ili imate bilo kakvih pitanja o izradi AI aplikacija. Pridružite se drugim polaznicima i iskusnim programerima u raspravama o MCP-u. To je podržavajuća zajednica u kojoj su pitanja dobrodošla i u kojoj se znanje slobodno dijeli. [![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) -Ako imate povratnu informaciju o proizvodu ili pogreške tijekom izgradnje, posjetite: +Ako imate povratnu informaciju o proizvodu ili greške tijekom izrade, posjetite: [![Microsoft Foundry Developer Forum](https://img.shields.io/badge/GitHub-Microsoft_Foundry_Developer_Forum-blue?style=for-the-badge&logo=github&color=000000&logoColor=fff)](https://aka.ms/foundry/forum) --- -**Odricanje od odgovornosti**: -Ovaj dokument preveden je korištenjem AI prevoditeljske usluge [Co-op Translator](https://github.com/Azure/co-op-translator). Iako činimo napore da prijevod bude točan, imajte na umu da automatizirani prijevodi mogu sadržavati pogreške ili netočnosti. Izvorni dokument na izvornom jeziku treba smatrati autoritativnim izvorom. Za kritične informacije preporučuje se profesionalni ljudski prijevod. Ne snosimo odgovornost za eventualne nesporazume ili kriva tumačenja koja proizlaze iz korištenja ovog prijevoda. +**Izjava o odricanju odgovornosti**: +Ovaj je dokument preveden pomoću AI usluge za prijevod [Co-op Translator](https://github.com/Azure/co-op-translator). Iako težimo točnosti, imajte na umu da automatski prijevodi mogu sadržavati pogreške ili netočnosti. Izvorni dokument na izvornom jeziku smatra se službenim i autoritativnim izvorom. Za važne informacije preporučuje se profesionalni ljudski prijevod. Ne snosimo odgovornost za bilo kakva nesporazuma ili pogrešna tumačenja koja proizlaze iz korištenja ovog prijevoda. \ No newline at end of file diff --git a/translations/hr/SECURITY.md b/translations/hr/SECURITY.md index b4040906..c790214b 100644 --- a/translations/hr/SECURITY.md +++ b/translations/hr/SECURITY.md @@ -1,12 +1,3 @@ - ## Sigurnost Microsoft ozbiljno pristupa sigurnosti svojih softverskih proizvoda i usluga, uključujući sve repozitorije izvornog koda kojima upravljamo putem naših GitHub organizacija, kao što su [Microsoft](https://github.com/Microsoft), [Azure](https://github.com/Azure), [DotNet](https://github.com/dotnet), [AspNet](https://github.com/aspnet) i [Xamarin](https://github.com/xamarin). diff --git a/translations/hr/SUPPORT.md b/translations/hr/SUPPORT.md index f4542eb4..dfe3092a 100644 --- a/translations/hr/SUPPORT.md +++ b/translations/hr/SUPPORT.md @@ -1,12 +1,3 @@ - # Podrška ## Kako prijaviti probleme i dobiti pomoć diff --git a/translations/hu/.co-op-translator.json b/translations/hu/.co-op-translator.json new file mode 100644 index 00000000..36a23430 --- /dev/null +++ b/translations/hu/.co-op-translator.json @@ -0,0 +1,92 @@ +{ + "01-IntroToGenAI/README.md": { + "original_hash": "75bfb080ca725e8a9aa9c80cae25fba1", + "translation_date": "2025-07-29T09:59:32+00:00", + "source_file": "01-IntroToGenAI/README.md", + "language_code": "hu" + }, + "02-SetupDevEnvironment/README.md": { + "original_hash": "96a30d42b9751a3d4e4b20e28d29d459", + "translation_date": "2026-01-28T05:17:40+00:00", + "source_file": "02-SetupDevEnvironment/README.md", + "language_code": "hu" + }, + "02-SetupDevEnvironment/examples/basic-chat-azure/README.md": { + "original_hash": "efd82efe50711d7e257eb943151d682c", + "translation_date": "2025-07-27T13:45:46+00:00", + "source_file": "02-SetupDevEnvironment/examples/basic-chat-azure/README.md", + "language_code": "hu" + }, + "02-SetupDevEnvironment/getting-started-azure-openai.md": { + "original_hash": "bfdb4b4eadbee3a59ef742439f58326a", + "translation_date": "2025-07-27T13:22:50+00:00", + "source_file": "02-SetupDevEnvironment/getting-started-azure-openai.md", + "language_code": "hu" + }, + "03-CoreGenerativeAITechniques/README.md": { + "original_hash": "685f55cb07de19b52a30ce6e8b6d889e", + "translation_date": "2025-08-28T22:14:12+00:00", + "source_file": "03-CoreGenerativeAITechniques/README.md", + "language_code": "hu" + }, + "04-PracticalSamples/README.md": { + "original_hash": "14c0a61ecc1cd2012a9c129236dfdf71", + "translation_date": "2025-07-29T09:59:14+00:00", + "source_file": "04-PracticalSamples/README.md", + "language_code": "hu" + }, + "04-PracticalSamples/calculator/README.md": { + "original_hash": "b6c16b5514d524e415a94f6097ee7d4c", + "translation_date": "2025-09-18T15:38:33+00:00", + "source_file": "04-PracticalSamples/calculator/README.md", + "language_code": "hu" + }, + "04-PracticalSamples/foundrylocal/README.md": { + "original_hash": "f787307400de59adc25a1404466a35f3", + "translation_date": "2025-11-04T07:32:45+00:00", + "source_file": "04-PracticalSamples/foundrylocal/README.md", + "language_code": "hu" + }, + "04-PracticalSamples/petstory/README.md": { + "original_hash": "0cbf68d605615a1e602c832a24616859", + "translation_date": "2025-07-25T11:51:09+00:00", + "source_file": "04-PracticalSamples/petstory/README.md", + "language_code": "hu" + }, + "05-ResponsibleGenAI/README.md": { + "original_hash": "301c05c2f57e60a6950b8c665b8bdbba", + "translation_date": "2025-07-29T15:57:09+00:00", + "source_file": "05-ResponsibleGenAI/README.md", + "language_code": "hu" + }, + "AGENTS.md": { + "original_hash": "afc90918d008cf77fd1982691f681306", + "translation_date": "2025-10-03T08:41:46+00:00", + "source_file": "AGENTS.md", + "language_code": "hu" + }, + "CODE_OF_CONDUCT.md": { + "original_hash": "442b123d034f92f7c384d2bbd28f99f1", + "translation_date": "2025-07-21T20:37:21+00:00", + "source_file": "CODE_OF_CONDUCT.md", + "language_code": "hu" + }, + "README.md": { + "original_hash": "125a08948d881c95628094f4dd1fbd43", + "translation_date": "2026-01-29T16:06:26+00:00", + "source_file": "README.md", + "language_code": "hu" + }, + "SECURITY.md": { + "original_hash": "57f14126c1c6add76b3aef3844dfe4e3", + "translation_date": "2025-07-21T20:34:57+00:00", + "source_file": "SECURITY.md", + "language_code": "hu" + }, + "SUPPORT.md": { + "original_hash": "b8ef73cc49dec68e2c885ee9df545129", + "translation_date": "2025-07-21T20:38:36+00:00", + "source_file": "SUPPORT.md", + "language_code": "hu" + } +} \ No newline at end of file diff --git a/translations/hu/01-IntroToGenAI/README.md b/translations/hu/01-IntroToGenAI/README.md index 14d3aba0..f9212a8e 100644 --- a/translations/hu/01-IntroToGenAI/README.md +++ b/translations/hu/01-IntroToGenAI/README.md @@ -1,12 +1,3 @@ - # Bevezetés a Generatív MI-be - Java kiadás ## Amit megtanulsz diff --git a/translations/hu/02-SetupDevEnvironment/README.md b/translations/hu/02-SetupDevEnvironment/README.md index 5722a1da..432f5f4d 100644 --- a/translations/hu/02-SetupDevEnvironment/README.md +++ b/translations/hu/02-SetupDevEnvironment/README.md @@ -1,13 +1,251 @@ - +# Fejlesztői környezet beállítása Generatív Mesterséges Intelligencia Java-hoz +> **Gyors kezdés**: Kódolj a felhőben 2 perc alatt – ugorj a [GitHub Codespaces beállítás](../../../02-SetupDevEnvironment) részhez – nincs szükség helyi telepítésre, és GitHub modelleket használ! + +> **Érdekel az Azure OpenAI?**, tekintsd meg az [Azure OpenAI beállítási útmutatót](getting-started-azure-openai.md), amely lépéseket tartalmaz egy új Azure OpenAI erőforrás létrehozásához. + +## Amit megtanulsz + +- Java fejlesztői környezet beállítása MI alkalmazásokhoz +- Fejlesztői környezet kiválasztása és konfigurálása (felhő-alapú Codespaces, helyi fejlesztői konténer vagy teljes helyi beállítás) +- A beállítás tesztelése a GitHub modellekhez való kapcsolódással + +## Tartalomjegyzék + +- [Amit megtanulsz](../../../02-SetupDevEnvironment) +- [Bevezetés](../../../02-SetupDevEnvironment) +- [1. lépés: Fejlesztői környezet beállítása](../../../02-SetupDevEnvironment) + - [A opció: GitHub Codespaces (ajánlott)](../../../02-SetupDevEnvironment) + - [B opció: Helyi fejlesztői konténer](../../../02-SetupDevEnvironment) + - [C opció: Használd a meglévő helyi telepítésedet](../../../02-SetupDevEnvironment) +- [2. lépés: GitHub személyes hozzáférési token létrehozása](../../../02-SetupDevEnvironment) +- [3. lépés: Beállítás tesztelése](../../../02-SetupDevEnvironment) +- [Hibaelhárítás](../../../02-SetupDevEnvironment) +- [Összefoglalás](../../../02-SetupDevEnvironment) +- [Következő lépések](../../../02-SetupDevEnvironment) + +## Bevezetés + +Ez a fejezet végigvezet a fejlesztői környezet beállításán. Elsődleges példánk a **GitHub modellek**, mert ingyenes, könnyen beállítható csak egy GitHub fiókkal, nem kell bankkártya, és több modell elérését kínálja kísérletezéshez. + +**Nem szükséges helyi beállítás!** Azonnal kezdhetsz kódolni a GitHub Codespaces használatával, amely teljes fejlesztői környezetet biztosít a böngésződben. + +GitHub modellek képernyőképe + +Azért ajánljuk a [**GitHub modelleket**](https://github.com/marketplace?type=models) ehhez a tanfolyamhoz, mert: +- **Ingyenes** a kezdés +- **Könnyen beállítható** egy GitHub fiókkal +- **Nincs szükség bankkártyára** +- **Több modell** elérhető kísérletezésre + +> **Megjegyzés**: A képzésben használt GitHub modelleknél ezek az ingyenes korlátok vannak: +> - 15 kérés percenként (150 naponta) +> - kb. 8,000 szó be- és kb. 4,000 szó kimenet kérésenként +> - 5 párhuzamos kérés +> +> Termelési használathoz válts át Azure AI Foundry modellekre az Azure fiókoddal. A kódodon nem kell változtatni. Lásd az [Azure AI Foundry dokumentációját](https://learn.microsoft.com/azure/ai-foundry/foundry-models/how-to/quickstart-github-models). + +## 1. lépés: Fejlesztői környezet beállítása + + + +Elkészítettünk egy előre konfigurált fejlesztői konténert, hogy minimalizáljuk a beállítási időt, és biztosítsuk a szükséges eszközöket ehhez a Generatív AI Java kurzushoz. Válaszd ki a preferált fejlesztési módot: + +### Környezetbeállítási lehetőségek: + +#### A opció: GitHub Codespaces (ajánlott) + +**Kezdj kódolni 2 perc alatt – nincs helyi telepítés!** + +1. Forkold ezt a repót a GitHub fiókodba + > **Megjegyzés**: Ha a konfigurációt szerkesztenéd, nézd meg a [Dev Container konfigurációt](../../../.devcontainer/devcontainer.json) +2. Kattints a **Code** → **Codespaces** fülre → **...** → **Új opciókkal...** +3. Használd az alapértelmezetteket – ez a **Generative AI Java Development Environment** devcontainer konfigurációt választja, amely a kurzushoz készült +4. Kattints a **Codespace létrehozása** gombra +5. Várj kb. 2 percet, amíg a környezet elkészül +6. Folytasd a [2. lépéssel: GitHub token létrehozása](../../../02-SetupDevEnvironment) + +Codespaces almenü képernyőképe + +Új opciókkal képernyőkép + +Codespace létrehozása opció képernyő + +> **A Codespaces előnyei**: +> - Nem szükséges helyi telepítés +> - Bármilyen böngészőt használó eszközön működik +> - Előre konfigurált az összes eszközzel és függőséggel +> - Személyes fiókoknak havi 60 ingyenes óra +> - Egységes környezet minden tanulónak + +#### B opció: Helyi fejlesztői konténer + +**Fejlesztőknek, akik helyi Docker alapú fejlesztést kedvelnek** + +1. Forkold és klónozd a repót a helyi gépedre + > **Megjegyzés**: Ha a konfigurációt szerkesztenéd, nézd meg a [Dev Container konfigurációt](../../../.devcontainer/devcontainer.json) +2. Telepítsd a [Docker Desktopot](https://www.docker.com/products/docker-desktop/) és a [VS Code-ot](https://code.visualstudio.com/) +3. Telepítsd a [Dev Containers kiterjesztést](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers) a VS Code-ban +4. Nyisd meg a repó mappáját VS Code-ban +5. Amikor felajánlja, kattints a **Megnyitás konténerben** opcióra (vagy használd a `Ctrl+Shift+P` → "Dev Containers: Reopen in Container" parancsot) +6. Várj, amíg a konténer felépül és elindul +7. Folytasd a [2. lépéssel: GitHub token létrehozása](../../../02-SetupDevEnvironment) + +Fejlesztői konténer beállítás képernyő + +Fejlesztői konténer build kész képernyő + +#### C opció: Használd a meglévő helyi telepítésedet + +**Fejlesztőknek meglévő Java környezettel** + +Előfeltételek: +- [Java 21+](https://www.oracle.com/java/technologies/javase/jdk21-archive-downloads.html) +- [Maven 3.9+](https://maven.apache.org/download.cgi) +- [VS Code](https://code.visualstudio.com) vagy kedvenc IDE-d + +Lépések: +1. Klónozd a repót a helyi gépedre +2. Nyisd meg a projektet az IDE-ben +3. Folytasd a [2. lépéssel: GitHub token létrehozása](../../../02-SetupDevEnvironment) + +> **Tipp**: Ha gyenge géped van, de szeretnéd a helyi VS Code-ot használni, inkább használj GitHub Codespaces-t! Kapcsolódhatsz helyi VS Code-dal egy felhőben futó Codespace-hez, így mindkét világ előnyeit élvezheted. + +Helyi fejlesztői konténer példány létrehozva + +## 2. lépés: GitHub személyes hozzáférési token létrehozása + +1. Nyisd meg a [GitHub beállításokat](https://github.com/settings/profile) és válaszd a profilod menüjében a **Settings** (Beállítások) lehetőséget. +2. A bal oldali sávban kattints a **Developer settings** (Fejlesztői beállítások) menüpontra (általában alul). +3. A **Personal access tokens** alatt válaszd a **Fine-grained tokens** opciót (vagy használd ezt a közvetlen [linket](https://github.com/settings/personal-access-tokens)). +4. Kattints a **Generate new token** (Új token generálása) gombra. +5. Adj a tokennek egy leíró nevet (pl. `GenAI-Java-Course-Token`). +6. Állíts be lejárati dátumot (javasolt: 7 nap a biztonságos használathoz). +7. A "Resource owner" alatt válaszd ki a saját felhasználódat. +8. A "Repository access" alatt válaszd ki azokat a repókat, amelyeket GitHub Modellekhez használni szeretnél (vagy ha szükséges, "All repositories"). +9. Az "Account permissions" alatt keresd meg a **Models** jogosultságot, és állítsd **Read-only**-ra. +10. Kattints a **Generate token** gombra. +11. **Másold ki és mentsd el a tokent most** – többé nem látod újra! + +> **Biztonsági tipp**: Használd a lehető legkisebb jogosultsági kört és a legrövidebb praktikus lejárati időt a tokeneknél. + +## 3. lépés: Beállítás tesztelése a GitHub modellek példával + +Ha a fejlesztői környezet készen áll, teszteljük a GitHub Modellek integrációt az alábbi példaalkalmazással a [`02-SetupDevEnvironment/examples/github-models`](../../../02-SetupDevEnvironment/examples/github-models) mappában. + +1. Nyisd meg a terminált a fejlesztői környezetedben. +2. Navigálj a GitHub Modellek példához: + ```bash + cd 02-SetupDevEnvironment/examples/github-models + ``` +3. Állítsd be a GitHub tokent környezeti változóként: + ```bash + # macOS/Linux + export GITHUB_TOKEN=your_token_here + + # Windows (Parancssor) + set GITHUB_TOKEN=your_token_here + + # Windows (PowerShell) + $env:GITHUB_TOKEN="your_token_here" + ``` + +4. Futtasd az alkalmazást: + ```bash + mvn compile exec:java -Dexec.mainClass="com.example.githubmodels.App" + ``` + +Az alábbihoz hasonló kimenetet kell látnod: +```text +Using model: gpt-4.1-nano +Sending request to GitHub Models... +Response: Hello World! +``` + +### A példa kód megértése + +Először is nézzük meg, mit futtattunk. A `examples/github-models` mappában lévő példa az OpenAI Java SDK-t használja a GitHub Modellekhez való kapcsolódáshoz: + +**Ez a kód mit csinál:** +- **Csatlakozik** a GitHub Modellekhez a személyes tokened segítségével +- **Elküld** az MI modellnek egy egyszerű "Say Hello World!" üzenetet +- **Megkapja** és megjeleníti az MI válaszát +- **Ellenőrzi**, hogy a környezeted helyesen működik-e + +**Fő függőség** (a `pom.xml`-ben): +```xml + + com.openai + openai-java + 2.12.0 + +``` + +**Fő kód** (`App.java`): +```java +// Csatlakozás GitHub modellekhez OpenAI Java SDK használatával +OpenAIClient client = OpenAIOkHttpClient.builder() + .apiKey(pat) + .baseUrl("https://models.inference.ai.azure.com") + .build(); + +// Csevegési befejezési kérés létrehozása +ChatCompletionCreateParams params = ChatCompletionCreateParams.builder() + .model(modelId) + .addSystemMessage("You are a concise assistant.") + .addUserMessage("Say Hello World!") + .build(); + +// AI válasz lekérése +ChatCompletion response = client.chat().completions().create(params); +System.out.println("Response: " + response.choices().get(0).message().content().orElse("No response content")); +``` + +## Összefoglalás + +Remek! Most mindent beállítottál: + +- Létrehoztál egy GitHub Személyes Hozzáférési Tokent az AI modellekhez szükséges jogosultságokkal +- Fut a Java fejlesztői környezeted (akár Codespaces, fejlesztői konténer vagy helyi) +- Csatlakozol a GitHub Modellekhez az OpenAI Java SDK-val ingyenes AI fejlesztéshez +- Tesztelted az egészet egy egyszerű példával, amely AI modellekkel kommunikál + +## Következő lépések + +[3. fejezet: Alapvető generatív mesterséges intelligencia technikák](../03-CoreGenerativeAITechniques/README.md) + +## Hibaelhárítás + +Problémáid vannak? Íme a gyakori gondok és megoldások: + +- **Token nem működik?** + - Győződj meg róla, hogy az egész tokent másoltad, szóközök nélkül + - Ellenőrizd, hogy a token helyesen van-e beállítva környezeti változóként + - Nézd meg, hogy a tokennek megvan-e a megfelelő jogosultsága (Models: Read-only) + +- **Maven nem található?** + - Ha dev konténert vagy Codespaces-t használsz, a Maven telepítve kell legyen + - Helyi környezetben győződj meg róla, hogy Java 21+ és Maven 3.9+ telepítve van + - Használd a `mvn --version` parancsot az ellenőrzéshez + +- **Kapcsolódási problémák?** + - Ellenőrizd az internetkapcsolatodat + - Győződj meg arról, hogy elérhető a GitHub a hálózatodról + - Ellenőrizd, hogy nem vagy-e tűzfal mögött, amely blokkolja a GitHub Modellek végpontját + +- **Dev konténer nem indul?** + - Győződj meg róla, hogy a Docker Desktop fut (helyi fejlesztéshez) + - Próbáld újraépíteni a konténert: `Ctrl+Shift+P` → "Dev Containers: Rebuild Container" + +- **Alkalmazás fordítási hibák?** + - Győződj meg, hogy a megfelelő könyvtárban vagy: `02-SetupDevEnvironment/examples/github-models` + - Próbáld meg tisztítani és újrafordítani: `mvn clean compile` + +> **Segítségre van szükséged?**: Ha továbbra is gondod van, nyiss egy issue-t a repóban, és segítünk. --- + +**Kizáró nyilatkozat**: +Ez a dokumentum az AI fordító szolgáltatás, a [Co-op Translator](https://github.com/Azure/co-op-translator) segítségével készült. Bár igyekszünk a pontosságra, kérjük, vegye figyelembe, hogy az automatikus fordítások tartalmazhatnak hibákat vagy pontatlanságokat. Az eredeti dokumentum az anyanyelvén tekintendő hiteles forrásnak. Kritikus információk esetén javasolt a profi, emberi fordítás igénybevétele. Nem vállalunk felelősséget a fordítás használatából eredő félreértésekért vagy félreértelmezésekért. + \ No newline at end of file diff --git a/translations/hu/02-SetupDevEnvironment/examples/basic-chat-azure/README.md b/translations/hu/02-SetupDevEnvironment/examples/basic-chat-azure/README.md index 584e5feb..a330fe75 100644 --- a/translations/hu/02-SetupDevEnvironment/examples/basic-chat-azure/README.md +++ b/translations/hu/02-SetupDevEnvironment/examples/basic-chat-azure/README.md @@ -1,12 +1,3 @@ - # Alapvető Chat az Azure OpenAI-val - Teljes Példa Ez a példa bemutatja, hogyan lehet létrehozni egy egyszerű Spring Boot alkalmazást, amely csatlakozik az Azure OpenAI-hoz, és teszteli a beállításokat. diff --git a/translations/hu/02-SetupDevEnvironment/getting-started-azure-openai.md b/translations/hu/02-SetupDevEnvironment/getting-started-azure-openai.md index bc8035bf..6e13dd4f 100644 --- a/translations/hu/02-SetupDevEnvironment/getting-started-azure-openai.md +++ b/translations/hu/02-SetupDevEnvironment/getting-started-azure-openai.md @@ -1,12 +1,3 @@ - # Az Azure OpenAI fejlesztési környezet beállítása > **Gyors kezdés**: Ez az útmutató az Azure OpenAI beállításához készült. Ha azonnal szeretnéd elkezdeni ingyenes modellekkel, használd a [GitHub Models with Codespaces](./README.md#quick-start-cloud) lehetőséget. diff --git a/translations/hu/03-CoreGenerativeAITechniques/README.md b/translations/hu/03-CoreGenerativeAITechniques/README.md index 603a4e72..0369445c 100644 --- a/translations/hu/03-CoreGenerativeAITechniques/README.md +++ b/translations/hu/03-CoreGenerativeAITechniques/README.md @@ -1,12 +1,3 @@ - # Generatív AI Alaptechnikák Oktatóanyag ## Tartalomjegyzék diff --git a/translations/hu/04-PracticalSamples/README.md b/translations/hu/04-PracticalSamples/README.md index d48cc3e9..dda7fba5 100644 --- a/translations/hu/04-PracticalSamples/README.md +++ b/translations/hu/04-PracticalSamples/README.md @@ -1,12 +1,3 @@ - # Gyakorlati Alkalmazások és Projektek ## Amit Megtanulsz diff --git a/translations/hu/04-PracticalSamples/calculator/README.md b/translations/hu/04-PracticalSamples/calculator/README.md index ddedba4d..3c07c273 100644 --- a/translations/hu/04-PracticalSamples/calculator/README.md +++ b/translations/hu/04-PracticalSamples/calculator/README.md @@ -1,12 +1,3 @@ - # MCP Kalkulátor Útmutató Kezdőknek ## Tartalomjegyzék diff --git a/translations/hu/04-PracticalSamples/foundrylocal/README.md b/translations/hu/04-PracticalSamples/foundrylocal/README.md index bdf025fb..e23e714a 100644 --- a/translations/hu/04-PracticalSamples/foundrylocal/README.md +++ b/translations/hu/04-PracticalSamples/foundrylocal/README.md @@ -1,12 +1,3 @@ - # Foundry Local Spring Boot oktatóanyag ## Tartalomjegyzék diff --git a/translations/hu/04-PracticalSamples/petstory/README.md b/translations/hu/04-PracticalSamples/petstory/README.md index 70af85ef..7a14effe 100644 --- a/translations/hu/04-PracticalSamples/petstory/README.md +++ b/translations/hu/04-PracticalSamples/petstory/README.md @@ -1,12 +1,3 @@ - # Kisállat Történet Generátor Kezdőknek ## Tartalomjegyzék diff --git a/translations/hu/05-ResponsibleGenAI/README.md b/translations/hu/05-ResponsibleGenAI/README.md index d00fb707..cc3681b9 100644 --- a/translations/hu/05-ResponsibleGenAI/README.md +++ b/translations/hu/05-ResponsibleGenAI/README.md @@ -1,12 +1,3 @@ - # Felelős Generatív AI ## Amit Megtanulsz diff --git a/translations/hu/AGENTS.md b/translations/hu/AGENTS.md index de75f33b..be875fc9 100644 --- a/translations/hu/AGENTS.md +++ b/translations/hu/AGENTS.md @@ -1,12 +1,3 @@ - # AGENTS.md ## Projekt Áttekintés diff --git a/translations/hu/CODE_OF_CONDUCT.md b/translations/hu/CODE_OF_CONDUCT.md index 41b3f4ca..114222f9 100644 --- a/translations/hu/CODE_OF_CONDUCT.md +++ b/translations/hu/CODE_OF_CONDUCT.md @@ -1,12 +1,3 @@ - # Microsoft Nyílt Forráskódú Magatartási Kódex Ez a projekt a [Microsoft Nyílt Forráskódú Magatartási Kódexét](https://opensource.microsoft.com/codeofconduct/) fogadta el. diff --git a/translations/hu/README.md b/translations/hu/README.md index d1e02dc0..37480291 100644 --- a/translations/hu/README.md +++ b/translations/hu/README.md @@ -1,89 +1,81 @@ - -# Generatív AI kezdőknek - Java kiadás +# Generatív MI kezdőknek - Java kiadás [![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) -![Generatív AI kezdőknek - Java kiadás](../../translated_images/hu/beg-genai-series.8b48be9951cc574c.webp) +![Generatív MI kezdőknek - Java kiadás](../../translated_images/hu/beg-genai-series.8b48be9951cc574c.webp) -**Időigény**: Az egész workshop online, helyi telepítés nélkül elvégezhető. A környezet beállítása 2 percet vesz igénybe, a minták felfedezése pedig az elmélyülés mértékétől függően 1-3 órát igényel. +**Időigény**: Az egész workshop online elvégezhető helyi beállítás nélkül. A környezet beállítása 2 percet vesz igénybe, a minták felfedezése pedig a felfedezés mélységétől függően 1-3 órát. > **Gyors kezdés** -1. Forkold ezt a tárolót a GitHub fiókodba -2. Kattints a **Code** → **Codespaces** fülre → **...** → **Új lehetőségekkel...** -3. Használd az alapértelmezetteket – ez kiválasztja a kurzushoz létrehozott fejlesztői konténert -4. Kattints a **Codespace létrehozása** gombra -5. Várj kb. 2 percet, amíg a környezet készen áll -6. Ugrás közvetlenül az [Első példához](./02-SetupDevEnvironment/README.md#step-2-create-a-github-personal-access-token) +1. Forkold ezt a tárat a GitHub fiókodba +2. Kattints a **Code** → **Codespaces** fülre → **...** → **New with options...** +3. Használd az alapbeállításokat – ez kiválasztja a kurzushoz létrehozott fejlesztői konténert +4. Kattints a **Create codespace** gombra +5. Várj ~2 percet, amíg a környezet készen áll +6. Ugorj egyenesen az [Első példához](./02-SetupDevEnvironment/README.md#step-2-create-a-github-personal-access-token) -> **Inkább helyileg klónoznál?** +> **Inkább helyileg klónoznád?** > -> Ez a tároló több mint 50 nyelvű fordítást tartalmaz, ami jelentősen megnöveli a letöltési méretet. Ha fordítások nélkül szeretnéd klónozni, használd a sparse checkout-ot: +> Ez a tár több mint 50 nyelvi fordítást tartalmaz, amelyek jelentősen megnövelik a letöltési méretet. Fordítások nélküli klónozáshoz használj sparse checkoutot: > ```bash > git clone --filter=blob:none --sparse https://github.com/microsoft/Generative-AI-for-beginners-java.git > cd Generative-AI-for-beginners-java > git sparse-checkout set --no-cone '/*' '!translations' '!translated_images' > ``` -> Ez mindent tartalmaz, amire a kurzus befejezéséhez szükséged van, sokkal gyorsabb letöltéssel. +> Ez megad mindent, amire szükséged van a kurzus elvégzéséhez sokkal gyorsabb letöltéssel. + ## Többnyelvű támogatás -### GitHub Action segítségével támogatott (automatikus és mindig naprakész) +### GitHub Action segítségével támogatott (automatizált és mindig naprakész) -[Arab](../ar/README.md) | [Bengáli](../bn/README.md) | [Bolgár](../bg/README.md) | [Burmai (Myanmar)](../my/README.md) | [Kínai (egyszerűsített)](../zh/README.md) | [Kínai (hagyományos, Hong Kong)](../hk/README.md) | [Kínai (hagyományos, Makaó)](../mo/README.md) | [Kínai (hagyományos, Tajvan)](../tw/README.md) | [Horvát](../hr/README.md) | [Cseh](../cs/README.md) | [Dán](../da/README.md) | [Holland](../nl/README.md) | [Észt](../et/README.md) | [Finn](../fi/README.md) | [Francia](../fr/README.md) | [Német](../de/README.md) | [Görög](../el/README.md) | [Héber](../he/README.md) | [Hindi](../hi/README.md) | [Magyar](./README.md) | [Indonéz](../id/README.md) | [Olasz](../it/README.md) | [Japán](../ja/README.md) | [Kannada](../kn/README.md) | [Koreai](../ko/README.md) | [Litván](../lt/README.md) | [Maláj](../ms/README.md) | [Malajálam](../ml/README.md) | [Marathi](../mr/README.md) | [Nepáli](../ne/README.md) | [Nigériai pidgin](../pcm/README.md) | [Norvég](../no/README.md) | [Perzsa (Fárszi)](../fa/README.md) | [Lengyel](../pl/README.md) | [Portugál (Brazília)](../br/README.md) | [Portugál (Portugália)](../pt/README.md) | [Pandzsábi (Gurmukhi)](../pa/README.md) | [Román](../ro/README.md) | [Orosz](../ru/README.md) | [Szerb (cirill)](../sr/README.md) | [Szlovák](../sk/README.md) | [Szlovén](../sl/README.md) | [Spanyol](../es/README.md) | [Szuahéli](../sw/README.md) | [Svéd](../sv/README.md) | [Tagalog (filippínó)](../tl/README.md) | [Tamil](../ta/README.md) | [Telugu](../te/README.md) | [Thai](../th/README.md) | [Török](../tr/README.md) | [Ukrán](../uk/README.md) | [Urdu](../ur/README.md) | [Vietnami](../vi/README.md) +[Arab](../ar/README.md) | [Bengáli](../bn/README.md) | [Bolgár](../bg/README.md) | [Burmai (Myanmar)](../my/README.md) | [Kínai (egyszerűsített)](../zh-CN/README.md) | [Kínai (hagyományos, Hong Kong)](../zh-HK/README.md) | [Kínai (hagyományos, Macau)](../zh-MO/README.md) | [Kínai (hagyományos, Tajvan)](../zh-TW/README.md) | [Horvát](../hr/README.md) | [Cseh](../cs/README.md) | [Dán](../da/README.md) | [Holland](../nl/README.md) | [Észt](../et/README.md) | [Finn](../fi/README.md) | [Francia](../fr/README.md) | [Német](../de/README.md) | [Görög](../el/README.md) | [Héber](../he/README.md) | [Hindi](../hi/README.md) | [Magyar](./README.md) | [Indonéz](../id/README.md) | [Olasz](../it/README.md) | [Japán](../ja/README.md) | [Kannada](../kn/README.md) | [Koreai](../ko/README.md) | [Litván](../lt/README.md) | [Maláj](../ms/README.md) | [Malayalam](../ml/README.md) | [Marathi](../mr/README.md) | [Nepáli](../ne/README.md) | [Nigériai pidgin](../pcm/README.md) | [Norvég](../no/README.md) | [Perzsa (Fárszi)](../fa/README.md) | [Lengyel](../pl/README.md) | [Portugál (Brazília)](../pt-BR/README.md) | [Portugál (Portugália)](../pt-PT/README.md) | [Pandzsábi (Gurmukhi)](../pa/README.md) | [Román](../ro/README.md) | [Orosz](../ru/README.md) | [Szerb (cirill)](../sr/README.md) | [Szlovák](../sk/README.md) | [Szlovén](../sl/README.md) | [Spanyol](../es/README.md) | [Szvahili](../sw/README.md) | [Svéd](../sv/README.md) | [Tagalog (filippínó)](../tl/README.md) | [Tamil](../ta/README.md) | [Telugu](../te/README.md) | [Thai](../th/README.md) | [Török](../tr/README.md) | [Ukrán](../uk/README.md) | [Urdu](../ur/README.md) | [Vietnam](../vi/README.md) -> **Inkább helyileg klónoznál?** +> **Inkább helyileg klónoznád?** -> Ez a tároló több mint 50 nyelvű fordítást tartalmaz, ami jelentősen megnöveli a letöltési méretet. Ha fordítások nélkül szeretnéd klónozni, használd a sparse checkout-ot: +> Ez a tár több mint 50 nyelvi fordítást tartalmaz, amelyek jelentősen megnövelik a letöltési méretet. Fordítások nélküli klónozáshoz használj sparse checkoutot: > ```bash > git clone --filter=blob:none --sparse https://github.com/microsoft/Generative-AI-for-beginners-java.git > cd Generative-AI-for-beginners-java > git sparse-checkout set --no-cone '/*' '!translations' '!translated_images' > ``` -> Ez mindent tartalmaz, amire a kurzus befejezéséhez szükséged van, sokkal gyorsabb letöltéssel. +> Ez megad mindent, amire szükséged van a kurzus elvégzéséhez sokkal gyorsabb letöltéssel. -## Kurzus felépítése és tanulási útvonal +## A kurzus felépítése és tanulási út -### **1. fejezet: Bevezetés a generatív AI-ba** -- **Alapfogalmak**: Nagy nyelvi modellek, tokenek, beágyazások és az AI képességeinek megértése -- **Java AI ökoszisztéma**: Spring AI és OpenAI SDK-k áttekintése -- **Model Context Protocol (MCP)**: Bevezető az MCP-be és szerepe az AI ügynökök közti kommunikációban -- **Gyakorlati alkalmazások**: Valós életbeli forgatókönyvek, beleértve chatbotokat és tartalomgenerálást +### **1. fejezet: Bevezetés a generatív MI-be** +- **Alapfogalmak**: Nagy nyelvi modellek, tokenek, beágyazások és a MI képességeinek megértése +- **Java MI ökoszisztéma**: Áttekintés a Spring AI és OpenAI SDK-król +- **Model Context Protocol**: Bevezetés az MCP-be és szerepe az MI ügynökök közötti kommunikációban +- **Gyakorlati alkalmazások**: Valós példák, köztük chatbotok és tartalomgenerálás - **[→ 1. fejezet kezdése](./01-IntroToGenAI/README.md)** ### **2. fejezet: Fejlesztői környezet beállítása** -- **Több szolgáltató konfigurálása**: GitHub Models, Azure OpenAI és OpenAI Java SDK integrációk beállítása -- **Spring Boot + Spring AI**: Legjobb gyakorlatok vállalati AI alkalmazások fejlesztéséhez -- **GitHub Models**: Ingyenes AI modellhozzáférés prototípus készítéshez és tanuláshoz (bankkártya nem szükséges) +- **Több szolgáltató konfigurációja**: GitHub modellek, Azure OpenAI és OpenAI Java SDK integrációk beállítása +- **Spring Boot + Spring AI**: Legjobb gyakorlatok vállalati MI alkalmazások fejlesztéséhez +- **GitHub modellek**: Ingyenes MI modellhozzáférés prototípushoz és tanuláshoz (bankkártya nem szükséges) - **Fejlesztői eszközök**: Docker konténerek, VS Code és GitHub Codespaces konfiguráció - **[→ 2. fejezet kezdése](./02-SetupDevEnvironment/README.md)** -### **3. fejezet: Alapvető generatív AI technikák** -- **Prompt mérnökség**: Az AI modell optimális válaszainak technikái -- **Beágyazások és vektorműveletek**: Szemantikus keresés és hasonlóságkeresés megvalósítása -- **Retrieval-Augmented Generation (RAG)**: AI kombinálása saját adatforrásaiddal -- **Funkcióhívás**: Az AI képességek bővítése egyedi eszközökkel és bővítményekkel +### **3. fejezet: Alapvető generatív MI technikák** +- **Prompt tervezés**: Optimális MI modell válaszok elérésének technikái +- **Beágyazások és vektor műveletek**: Szemantikus keresés és hasonlóság alapú egyeztetés megvalósítása +- **Retrieval-Augmented Generation (RAG)**: MI kombinálása saját adatforrásaiddal +- **Funkcióhívás**: MI képességek bővítése egyedi eszközökkel és pluginokkal - **[→ 3. fejezet kezdése](./03-CoreGenerativeAITechniques/README.md)** ### **4. fejezet: Gyakorlati alkalmazások és projektek** -- **Háziállat-történet generátor** (`petstory/`): Kreatív tartalomgenerálás GitHub Models segítségével -- **Foundry helyi demó** (`foundrylocal/`): Helyi AI modell integráció OpenAI Java SDK-val -- **MCP kalkulátor szolgáltatás** (`calculator/`): Alapvető Model Context Protocol megvalósítás Spring AI-val +- **Háziállat-történet generátor** (`petstory/`): Kreatív tartalomgenerálás GitHub modellekkel +- **Foundry helyi demo** (`foundrylocal/`): Helyi MI modell integráció OpenAI Java SDK segítségével +- **MCP kalkulátor szolgáltatás** (`calculator/`): Alap Model Context Protocol implementáció Spring AI-val - **[→ 4. fejezet kezdése](./04-PracticalSamples/README.md)** -### **5. fejezet: Felelős AI fejlesztés** -- **GitHub Models biztonság**: Beépített tartalomszűrés és biztonsági mechanizmusok tesztelése (kemény blokkok és lágy visszautasítások) -- **Felelős AI bemutató**: Kézzel fogható példa arra, hogyan működnek a modern AI biztonsági rendszerek a gyakorlatban -- **Legjobb gyakorlatok**: Lényeges irányelvek az etikus AI fejlesztéshez és bevezetéshez +### **5. fejezet: Felelős MI fejlesztés** +- **GitHub modellek biztonsága**: Beépített tartalomszűrési és biztonsági mechanizmusok tesztelése (kemény tiltások és lágy elutasítások) +- **Felelős MI demó**: Gyakorlati példa arra, hogyan működnek a modern MI biztonsági rendszerek a gyakorlatban +- **Legjobb gyakorlatok**: Alapvető irányelvek az etikus MI fejlesztéshez és bevezetéshez - **[→ 5. fejezet kezdése](./05-ResponsibleGenAI/README.md)** ## További források @@ -97,50 +89,51 @@ CO_OP_TRANSLATOR_METADATA: ### Azure / Edge / MCP / Ügynökök [![AZD kezdőknek](https://img.shields.io/badge/AZD%20for%20Beginners-0078D4?style=for-the-badge&labelColor=E5E7EB&color=0078D4)](https://github.com/microsoft/AZD-for-beginners?WT.mc_id=academic-105485-koreyst) -[![Edge AI kezdőknek](https://img.shields.io/badge/Edge%20AI%20for%20Beginners-00B8E4?style=for-the-badge&labelColor=E5E7EB&color=00B8E4)](https://github.com/microsoft/edgeai-for-beginners?WT.mc_id=academic-105485-koreyst) +[![Edge MI kezdőknek](https://img.shields.io/badge/Edge%20AI%20for%20Beginners-00B8E4?style=for-the-badge&labelColor=E5E7EB&color=00B8E4)](https://github.com/microsoft/edgeai-for-beginners?WT.mc_id=academic-105485-koreyst) [![MCP kezdőknek](https://img.shields.io/badge/MCP%20for%20Beginners-009688?style=for-the-badge&labelColor=E5E7EB&color=009688)](https://github.com/microsoft/mcp-for-beginners?WT.mc_id=academic-105485-koreyst) -[![AI Ügynökök kezdőknek](https://img.shields.io/badge/AI%20Agents%20for%20Beginners-00C49A?style=for-the-badge&labelColor=E5E7EB&color=00C49A)](https://github.com/microsoft/ai-agents-for-beginners?WT.mc_id=academic-105485-koreyst) +[![MI ügynökök kezdőknek](https://img.shields.io/badge/AI%20Agents%20for%20Beginners-00C49A?style=for-the-badge&labelColor=E5E7EB&color=00C49A)](https://github.com/microsoft/ai-agents-for-beginners?WT.mc_id=academic-105485-koreyst) --- -### Generatív AI sorozat -[![Generatív AI kezdőknek](https://img.shields.io/badge/Generative%20AI%20for%20Beginners-8B5CF6?style=for-the-badge&labelColor=E5E7EB&color=8B5CF6)](https://github.com/microsoft/generative-ai-for-beginners?WT.mc_id=academic-105485-koreyst) -[![Generatív AI (.NET)](https://img.shields.io/badge/Generative%20AI%20(.NET)-9333EA?style=for-the-badge&labelColor=E5E7EB&color=9333EA)](https://github.com/microsoft/Generative-AI-for-beginners-dotnet?WT.mc_id=academic-105485-koreyst) -[![Generatív AI (Java)](https://img.shields.io/badge/Generative%20AI%20(Java)-C084FC?style=for-the-badge&labelColor=E5E7EB&color=C084FC)](https://github.com/microsoft/generative-ai-for-beginners-java?WT.mc_id=academic-105485-koreyst) -[![Generatív AI (JavaScript)](https://img.shields.io/badge/Generative%20AI%20(JavaScript)-E879F9?style=for-the-badge&labelColor=E5E7EB&color=E879F9)](https://github.com/microsoft/generative-ai-with-javascript?WT.mc_id=academic-105485-koreyst) +### Generatív MI sorozat +[![Generatív MI kezdőknek](https://img.shields.io/badge/Generative%20AI%20for%20Beginners-8B5CF6?style=for-the-badge&labelColor=E5E7EB&color=8B5CF6)](https://github.com/microsoft/generative-ai-for-beginners?WT.mc_id=academic-105485-koreyst) +[![Generatív MI (.NET)](https://img.shields.io/badge/Generative%20AI%20(.NET)-9333EA?style=for-the-badge&labelColor=E5E7EB&color=9333EA)](https://github.com/microsoft/Generative-AI-for-beginners-dotnet?WT.mc_id=academic-105485-koreyst) +[![Generatív MI (Java)](https://img.shields.io/badge/Generative%20AI%20(Java)-C084FC?style=for-the-badge&labelColor=E5E7EB&color=C084FC)](https://github.com/microsoft/generative-ai-for-beginners-java?WT.mc_id=academic-105485-koreyst) +[![Generatív MI (JavaScript)](https://img.shields.io/badge/Generative%20AI%20(JavaScript)-E879F9?style=for-the-badge&labelColor=E5E7EB&color=E879F9)](https://github.com/microsoft/generative-ai-with-javascript?WT.mc_id=academic-105485-koreyst) --- ### Alapvető tanulás [![Gépi tanulás kezdőknek](https://img.shields.io/badge/ML%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=22C55E)](https://aka.ms/ml-beginners?WT.mc_id=academic-105485-koreyst) [![Adattudomány kezdőknek](https://img.shields.io/badge/Data%20Science%20for%20Beginners-84CC16?style=for-the-badge&labelColor=E5E7EB&color=84CC16)](https://aka.ms/datascience-beginners?WT.mc_id=academic-105485-koreyst) -[![AI kezdőknek](https://img.shields.io/badge/AI%20for%20Beginners-A3E635?style=for-the-badge&labelColor=E5E7EB&color=A3E635)](https://aka.ms/ai-beginners?WT.mc_id=academic-105485-koreyst) +[![MI kezdőknek](https://img.shields.io/badge/AI%20for%20Beginners-A3E635?style=for-the-badge&labelColor=E5E7EB&color=A3E635)](https://aka.ms/ai-beginners?WT.mc_id=academic-105485-koreyst) [![Kiberbiztonság kezdőknek](https://img.shields.io/badge/Cybersecurity%20for%20Beginners-F97316?style=for-the-badge&labelColor=E5E7EB&color=F97316)](https://github.com/microsoft/Security-101?WT.mc_id=academic-96948-sayoung) + [![Webfejlesztés kezdőknek](https://img.shields.io/badge/Web%20Dev%20for%20Beginners-EC4899?style=for-the-badge&labelColor=E5E7EB&color=EC4899)](https://aka.ms/webdev-beginners?WT.mc_id=academic-105485-koreyst) -[![IoT for Beginners](https://img.shields.io/badge/IoT%20for%20Beginners-14B8A6?style=for-the-badge&labelColor=E5E7EB&color=14B8A6)](https://aka.ms/iot-beginners?WT.mc_id=academic-105485-koreyst) -[![XR Development for Beginners](https://img.shields.io/badge/XR%20Development%20for%20Beginners-38BDF8?style=for-the-badge&labelColor=E5E7EB&color=38BDF8)](https://github.com/microsoft/xr-development-for-beginners?WT.mc_id=academic-105485-koreyst) +[![IoT kezdőknek](https://img.shields.io/badge/IoT%20for%20Beginners-14B8A6?style=for-the-badge&labelColor=E5E7EB&color=14B8A6)](https://aka.ms/iot-beginners?WT.mc_id=academic-105485-koreyst) +[![XR fejlesztés kezdőknek](https://img.shields.io/badge/XR%20Development%20for%20Beginners-38BDF8?style=for-the-badge&labelColor=E5E7EB&color=38BDF8)](https://github.com/microsoft/xr-development-for-beginners?WT.mc_id=academic-105485-koreyst) --- ### Copilot Sorozat -[![Copilot for AI Paired Programming](https://img.shields.io/badge/Copilot%20for%20AI%20Paired%20Programming-FACC15?style=for-the-badge&labelColor=E5E7EB&color=FACC15)](https://aka.ms/GitHubCopilotAI?WT.mc_id=academic-105485-koreyst) -[![Copilot for C#/.NET](https://img.shields.io/badge/Copilot%20for%20C%23/.NET-FBBF24?style=for-the-badge&labelColor=E5E7EB&color=FBBF24)](https://github.com/microsoft/mastering-github-copilot-for-dotnet-csharp-developers?WT.mc_id=academic-105485-koreyst) -[![Copilot Adventure](https://img.shields.io/badge/Copilot%20Adventure-FDE68A?style=for-the-badge&labelColor=E5E7EB&color=FDE68A)](https://github.com/microsoft/CopilotAdventures?WT.mc_id=academic-105485-koreyst) +[![Copilot AI páros programozáshoz](https://img.shields.io/badge/Copilot%20for%20AI%20Paired%20Programming-FACC15?style=for-the-badge&labelColor=E5E7EB&color=FACC15)](https://aka.ms/GitHubCopilotAI?WT.mc_id=academic-105485-koreyst) +[![Copilot C#/.NET-hez](https://img.shields.io/badge/Copilot%20for%20C%23/.NET-FBBF24?style=for-the-badge&labelColor=E5E7EB&color=FBBF24)](https://github.com/microsoft/mastering-github-copilot-for-dotnet-csharp-developers?WT.mc_id=academic-105485-koreyst) +[![Copilot Kaland](https://img.shields.io/badge/Copilot%20Adventure-FDE68A?style=for-the-badge&labelColor=E5E7EB&color=FDE68A)](https://github.com/microsoft/CopilotAdventures?WT.mc_id=academic-105485-koreyst) -## Segítség kérése +## Segítségkérés -Ha elakad vagy kérdése van az AI alkalmazások fejlesztésével kapcsolatban. Csatlakozzon a tanulók és tapasztalt fejlesztők közösségéhez, akik az MCP-ről folytatnak beszélgetéseket. Ez egy támogató közösség, ahol a kérdések megengedettek és a tudás szabadon megosztott. +Ha elakadnál, vagy bármilyen kérdésed lenne az AI alkalmazások építésével kapcsolatban, csatlakozz a többi tanulóhoz és tapasztalt fejlesztőhöz az MCP közösségében. Ez egy támogató közösség, ahol a kérdéseket szívesen fogadják és a tudást szabadon megosztják. [![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) -Ha termék-visszajelzése vagy hibák merülnek fel a fejlesztés során, látogasson el ide: +Ha termék visszajelzésed van vagy hibákat tapasztalsz építés közben, látogass el ide: -[![Microsoft Foundry Developer Forum](https://img.shields.io/badge/GitHub-Microsoft_Foundry_Developer_Forum-blue?style=for-the-badge&logo=github&color=000000&logoColor=fff)](https://aka.ms/foundry/forum) +[![Microsoft Foundry Fejlesztői Fórum](https://img.shields.io/badge/GitHub-Microsoft_Foundry_Developer_Forum-blue?style=for-the-badge&logo=github&color=000000&logoColor=fff)](https://aka.ms/foundry/forum) --- -**Nyilatkozat**: -Ezt a dokumentumot az [Co-op Translator](https://github.com/Azure/co-op-translator) AI fordító szolgáltatásával fordították le. Bár az pontosságra törekszünk, kérjük, vegye figyelembe, hogy az automatikus fordítások hibákat vagy pontatlanságokat tartalmazhatnak. Az eredeti dokumentum az anyanyelvén tekintendő hiteles forrásnak. Fontos információk esetén professzionális emberi fordítást javaslunk. Nem vállalunk felelősséget a fordítás használatából eredő félreértésekért vagy téves értelmezésekért. +**Felelősség kizárása**: +Ez a dokumentum az AI fordítási szolgáltatás, a [Co-op Translator](https://github.com/Azure/co-op-translator) segítségével készült. Bár a pontosságra törekszünk, kérjük, vegye figyelembe, hogy az automatikus fordítások hibákat vagy pontatlanságokat tartalmazhatnak. Az eredeti dokumentum, anyanyelvén tekintendő hiteles forrásnak. Kritikus információk esetén professzionális, emberi fordítást javaslunk. Nem vállalunk felelősséget az ebből eredő félreértésekért vagy félreértelmezésekért. \ No newline at end of file diff --git a/translations/hu/SECURITY.md b/translations/hu/SECURITY.md index 73e6848b..3f14db69 100644 --- a/translations/hu/SECURITY.md +++ b/translations/hu/SECURITY.md @@ -1,12 +1,3 @@ - ## Biztonság A Microsoft komolyan veszi szoftvertermékei és szolgáltatásai biztonságát, beleértve az összes forráskód-tárházat, amelyeket GitHub szervezeteinken keresztül kezelünk, mint például [Microsoft](https://github.com/Microsoft), [Azure](https://github.com/Azure), [DotNet](https://github.com/dotnet), [AspNet](https://github.com/aspnet) és [Xamarin](https://github.com/xamarin). diff --git a/translations/hu/SUPPORT.md b/translations/hu/SUPPORT.md index 36feb2c0..c629c4b6 100644 --- a/translations/hu/SUPPORT.md +++ b/translations/hu/SUPPORT.md @@ -1,12 +1,3 @@ - # Támogatás ## Hogyan lehet hibákat jelenteni és segítséget kérni diff --git a/translations/id/.co-op-translator.json b/translations/id/.co-op-translator.json new file mode 100644 index 00000000..3461c6ad --- /dev/null +++ b/translations/id/.co-op-translator.json @@ -0,0 +1,92 @@ +{ + "01-IntroToGenAI/README.md": { + "original_hash": "75bfb080ca725e8a9aa9c80cae25fba1", + "translation_date": "2025-07-29T09:46:18+00:00", + "source_file": "01-IntroToGenAI/README.md", + "language_code": "id" + }, + "02-SetupDevEnvironment/README.md": { + "original_hash": "96a30d42b9751a3d4e4b20e28d29d459", + "translation_date": "2026-01-28T05:11:42+00:00", + "source_file": "02-SetupDevEnvironment/README.md", + "language_code": "id" + }, + "02-SetupDevEnvironment/examples/basic-chat-azure/README.md": { + "original_hash": "efd82efe50711d7e257eb943151d682c", + "translation_date": "2025-07-27T13:44:24+00:00", + "source_file": "02-SetupDevEnvironment/examples/basic-chat-azure/README.md", + "language_code": "id" + }, + "02-SetupDevEnvironment/getting-started-azure-openai.md": { + "original_hash": "bfdb4b4eadbee3a59ef742439f58326a", + "translation_date": "2025-07-27T13:19:10+00:00", + "source_file": "02-SetupDevEnvironment/getting-started-azure-openai.md", + "language_code": "id" + }, + "03-CoreGenerativeAITechniques/README.md": { + "original_hash": "685f55cb07de19b52a30ce6e8b6d889e", + "translation_date": "2025-08-28T22:11:43+00:00", + "source_file": "03-CoreGenerativeAITechniques/README.md", + "language_code": "id" + }, + "04-PracticalSamples/README.md": { + "original_hash": "14c0a61ecc1cd2012a9c129236dfdf71", + "translation_date": "2025-07-29T09:46:05+00:00", + "source_file": "04-PracticalSamples/README.md", + "language_code": "id" + }, + "04-PracticalSamples/calculator/README.md": { + "original_hash": "b6c16b5514d524e415a94f6097ee7d4c", + "translation_date": "2025-09-18T15:36:48+00:00", + "source_file": "04-PracticalSamples/calculator/README.md", + "language_code": "id" + }, + "04-PracticalSamples/foundrylocal/README.md": { + "original_hash": "f787307400de59adc25a1404466a35f3", + "translation_date": "2025-11-04T07:29:54+00:00", + "source_file": "04-PracticalSamples/foundrylocal/README.md", + "language_code": "id" + }, + "04-PracticalSamples/petstory/README.md": { + "original_hash": "0cbf68d605615a1e602c832a24616859", + "translation_date": "2025-07-25T11:42:57+00:00", + "source_file": "04-PracticalSamples/petstory/README.md", + "language_code": "id" + }, + "05-ResponsibleGenAI/README.md": { + "original_hash": "301c05c2f57e60a6950b8c665b8bdbba", + "translation_date": "2025-07-29T15:55:36+00:00", + "source_file": "05-ResponsibleGenAI/README.md", + "language_code": "id" + }, + "AGENTS.md": { + "original_hash": "afc90918d008cf77fd1982691f681306", + "translation_date": "2025-10-03T08:40:01+00:00", + "source_file": "AGENTS.md", + "language_code": "id" + }, + "CODE_OF_CONDUCT.md": { + "original_hash": "442b123d034f92f7c384d2bbd28f99f1", + "translation_date": "2025-07-21T19:08:54+00:00", + "source_file": "CODE_OF_CONDUCT.md", + "language_code": "id" + }, + "README.md": { + "original_hash": "125a08948d881c95628094f4dd1fbd43", + "translation_date": "2026-01-29T16:00:46+00:00", + "source_file": "README.md", + "language_code": "id" + }, + "SECURITY.md": { + "original_hash": "57f14126c1c6add76b3aef3844dfe4e3", + "translation_date": "2025-07-21T19:07:29+00:00", + "source_file": "SECURITY.md", + "language_code": "id" + }, + "SUPPORT.md": { + "original_hash": "b8ef73cc49dec68e2c885ee9df545129", + "translation_date": "2025-07-21T19:10:06+00:00", + "source_file": "SUPPORT.md", + "language_code": "id" + } +} \ No newline at end of file diff --git a/translations/id/01-IntroToGenAI/README.md b/translations/id/01-IntroToGenAI/README.md index a1202120..6b6f191b 100644 --- a/translations/id/01-IntroToGenAI/README.md +++ b/translations/id/01-IntroToGenAI/README.md @@ -1,12 +1,3 @@ - # Pengantar Generative AI - Edisi Java ## Apa yang Akan Anda Pelajari diff --git a/translations/id/02-SetupDevEnvironment/README.md b/translations/id/02-SetupDevEnvironment/README.md index 3c720f60..9f0e7e19 100644 --- a/translations/id/02-SetupDevEnvironment/README.md +++ b/translations/id/02-SetupDevEnvironment/README.md @@ -1,13 +1,254 @@ - +# Menyiapkan Lingkungan Pengembangan untuk Generative AI untuk Java +> **Mulai Cepat**: Kode di Cloud dalam 2 menit - Langsung ke [Pengaturan GitHub Codespaces](../../../02-SetupDevEnvironment) - tidak perlu instalasi lokal dan menggunakan model github! + +> **Tertarik dengan Azure OpenAI?**, lihat [Panduan Pengaturan Azure OpenAI](getting-started-azure-openai.md) kami dengan langkah-langkah membuat sumber daya Azure OpenAI baru. + +## Apa yang Akan Anda Pelajari + +- Menyiapkan lingkungan pengembangan Java untuk aplikasi AI +- Memilih dan mengonfigurasi lingkungan pengembangan favorit Anda (cloud-first dengan Codespaces, kontainer dev lokal, atau pengaturan lokal penuh) +- Menguji pengaturan Anda dengan menghubungkan ke GitHub Models + +## Daftar Isi + +- [Apa yang Akan Anda Pelajari](../../../02-SetupDevEnvironment) +- [Pendahuluan](../../../02-SetupDevEnvironment) +- [Langkah 1: Siapkan Lingkungan Pengembangan Anda](../../../02-SetupDevEnvironment) + - [Opsi A: GitHub Codespaces (Direkomendasikan)](../../../02-SetupDevEnvironment) + - [Opsi B: Kontainer Dev Lokal](../../../02-SetupDevEnvironment) + - [Opsi C: Gunakan Instalasi Lokal Anda yang Ada](../../../02-SetupDevEnvironment) +- [Langkah 2: Buat Token Akses Pribadi GitHub](../../../02-SetupDevEnvironment) +- [Langkah 3: Uji Pengaturan Anda](../../../02-SetupDevEnvironment) +- [Pemecahan Masalah](../../../02-SetupDevEnvironment) +- [Ringkasan](../../../02-SetupDevEnvironment) +- [Langkah Selanjutnya](../../../02-SetupDevEnvironment) + +## Pendahuluan + +Bab ini akan membimbing Anda melalui penyiapan lingkungan pengembangan. Kita akan menggunakan **GitHub Models** sebagai contoh utama karena gratis, mudah disiapkan hanya dengan akun GitHub, tidak memerlukan kartu kredit, dan memberikan akses ke beberapa model untuk eksperimen. + +**Tidak perlu pengaturan lokal!** Anda dapat mulai coding langsung menggunakan GitHub Codespaces, yang menyediakan lingkungan pengembangan lengkap di browser Anda. + +Screenshot: GitHub Models + +Kami merekomendasikan menggunakan [**GitHub Models**](https://github.com/marketplace?type=models) untuk kursus ini karena: +- **Gratis** untuk memulai +- **Mudah** disiapkan hanya dengan akun GitHub +- **Tidak memerlukan kartu kredit** +- **Beberapa model** tersedia untuk eksperimen + +> **Catatan**: GitHub Models yang digunakan dalam pelatihan ini memiliki batasan gratis berikut: +> - 15 permintaan per menit (150 per hari) +> - ~8.000 kata masuk, ~4.000 kata keluar per permintaan +> - 5 permintaan bersamaan +> +> Untuk penggunaan produksi, tingkatkan ke Azure AI Foundry Models dengan akun Azure Anda. Kode Anda tidak perlu diubah. Lihat [dokumentasi Azure AI Foundry](https://learn.microsoft.com/azure/ai-foundry/foundry-models/how-to/quickstart-github-models). + + +## Langkah 1: Siapkan Lingkungan Pengembangan Anda + + + +Kami telah membuat kontainer pengembangan yang sudah dikonfigurasi sebelumnya untuk meminimalkan waktu pengaturan dan memastikan Anda memiliki semua alat yang diperlukan untuk kursus Generative AI untuk Java ini. Pilih pendekatan pengembangan yang Anda sukai: + +### Opsi Pengaturan Lingkungan: + +#### Opsi A: GitHub Codespaces (Direkomendasikan) + +**Mulai coding dalam 2 menit - tidak perlu pengaturan lokal!** + +1. Fork repositori ini ke akun GitHub Anda + > **Catatan**: Jika Anda ingin mengedit konfigurasi dasar, silakan lihat [Konfigurasi Dev Container](../../../.devcontainer/devcontainer.json) +2. Klik **Code** → tab **Codespaces** → **...** → **New with options...** +3. Gunakan default – ini akan memilih **Konfigurasi kontainer dev**: **Generative AI Java Development Environment** kontainer dev khusus yang dibuat untuk kursus ini +4. Klik **Create codespace** +5. Tunggu sekitar 2 menit supaya lingkungan siap +6. Lanjut ke [Langkah 2: Buat Token GitHub](../../../02-SetupDevEnvironment) + +Screenshot: submenu Codespaces + +Screenshot: New with options + +Screenshot: opsi buat codespace + + +> **Manfaat Codespaces**: +> - Tidak perlu instalasi lokal +> - Bisa digunakan di perangkat apa saja yang memiliki browser +> - Sudah pra-konfigurasi dengan semua alat dan dependensi +> - Gratis 60 jam per bulan untuk akun pribadi +> - Lingkungan yang konsisten untuk semua pelajar + +#### Opsi B: Kontainer Dev Lokal + +**Untuk pengembang yang lebih suka pengembangan lokal dengan Docker** + +1. Fork dan clone repositori ini ke mesin lokal Anda + > **Catatan**: Jika Anda ingin mengedit konfigurasi dasar, silakan lihat [Konfigurasi Dev Container](../../../.devcontainer/devcontainer.json) +2. Instal [Docker Desktop](https://www.docker.com/products/docker-desktop/) dan [VS Code](https://code.visualstudio.com/) +3. Instal [ekstensi Dev Containers](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers) di VS Code +4. Buka folder repositori di VS Code +5. Ketika diminta, klik **Reopen in Container** (atau gunakan `Ctrl+Shift+P` → "Dev Containers: Reopen in Container") +6. Tunggu kontainer selesai build dan mulai +7. Lanjut ke [Langkah 2: Buat Token GitHub](../../../02-SetupDevEnvironment) + +Screenshot: pengaturan Dev container + +Screenshot: build Dev container selesai + +#### Opsi C: Gunakan Instalasi Lokal Anda yang Ada + +**Untuk pengembang dengan lingkungan Java yang sudah ada** + +Prasyarat: +- [Java 21+](https://www.oracle.com/java/technologies/javase/jdk21-archive-downloads.html) +- [Maven 3.9+](https://maven.apache.org/download.cgi) +- [VS Code](https://code.visualstudio.com) atau IDE favorit Anda + +Langkah-langkah: +1. Clone repositori ini ke mesin lokal Anda +2. Buka proyek di IDE Anda +3. Lanjut ke [Langkah 2: Buat Token GitHub](../../../02-SetupDevEnvironment) + +> **Tips Profesional**: Jika Anda memiliki mesin spek rendah tapi ingin menggunakan VS Code secara lokal, gunakan GitHub Codespaces! Anda dapat menghubungkan VS Code lokal ke Codespace yang dihosting cloud untuk mendapatkan manfaat keduanya. + +Screenshot: contoh instansi devcontainer lokal dibuat + + +## Langkah 2: Buat Token Akses Pribadi GitHub + +1. Buka [Pengaturan GitHub](https://github.com/settings/profile) dan pilih **Settings** dari menu profil Anda. +2. Di sidebar kiri, klik **Developer settings** (biasanya di bagian bawah). +3. Di bawah **Personal access tokens**, klik **Fine-grained tokens** (atau ikuti tautan langsung ini [link](https://github.com/settings/personal-access-tokens)). +4. Klik **Generate new token**. +5. Di bawah "Token name", berikan nama yang deskriptif (misalnya, `GenAI-Java-Course-Token`). +6. Tetapkan tanggal kadaluarsa (disarankan: 7 hari untuk praktik keamanan terbaik). +7. Di bawah "Resource owner", pilih akun pengguna Anda. +8. Di bawah "Repository access", pilih repositori yang akan Anda gunakan dengan GitHub Models (atau "All repositories" jika perlu). +9. Di bawah "Account permissions", cari **Models** dan setel ke **Read-only**. +10. Klik **Generate token**. +11. **Salin dan simpan token Anda sekarang** – Anda tidak akan melihatnya lagi! + +> **Tips Keamanan**: Gunakan cakupan minimum yang diperlukan dan waktu kadaluarsa sesingkat mungkin untuk token akses Anda. + +## Langkah 3: Uji Pengaturan Anda dengan Contoh GitHub Models + +Setelah lingkungan pengembangan Anda siap, mari uji integrasi GitHub Models dengan aplikasi contoh di [`02-SetupDevEnvironment/examples/github-models`](../../../02-SetupDevEnvironment/examples/github-models). + +1. Buka terminal di lingkungan pengembangan Anda. +2. Arahkan ke contoh GitHub Models: + ```bash + cd 02-SetupDevEnvironment/examples/github-models + ``` +3. Tetapkan token GitHub Anda sebagai variabel lingkungan: + ```bash + # macOS/Linux + export GITHUB_TOKEN=your_token_here + + # Windows (Command Prompt) + set GITHUB_TOKEN=your_token_here + + # Windows (PowerShell) + $env:GITHUB_TOKEN="your_token_here" + ``` + +4. Jalankan aplikasinya: + ```bash + mvn compile exec:java -Dexec.mainClass="com.example.githubmodels.App" + ``` + +Anda harus melihat keluaran serupa: +```text +Using model: gpt-4.1-nano +Sending request to GitHub Models... +Response: Hello World! +``` + +### Memahami Kode Contoh + +Pertama, mari kita pahami apa yang baru saja kita jalankan. Contoh dalam `examples/github-models` menggunakan OpenAI Java SDK untuk menghubungkan ke GitHub Models: + +**Apa yang dilakukan kode ini:** +- **Menghubungkan** ke GitHub Models menggunakan token akses pribadi Anda +- **Mengirim** pesan sederhana "Say Hello World!" ke model AI +- **Menerima** dan menampilkan respons dari AI +- **Memvalidasi** bahwa pengaturan Anda berfungsi dengan benar + +**Dependensi Utama** (dalam `pom.xml`): +```xml + + com.openai + openai-java + 2.12.0 + +``` + +**Kode Utama** (`App.java`): +```java +// Terhubung ke Model GitHub menggunakan OpenAI Java SDK +OpenAIClient client = OpenAIOkHttpClient.builder() + .apiKey(pat) + .baseUrl("https://models.inference.ai.azure.com") + .build(); + +// Buat permintaan penyelesaian obrolan +ChatCompletionCreateParams params = ChatCompletionCreateParams.builder() + .model(modelId) + .addSystemMessage("You are a concise assistant.") + .addUserMessage("Say Hello World!") + .build(); + +// Dapatkan respons AI +ChatCompletion response = client.chat().completions().create(params); +System.out.println("Response: " + response.choices().get(0).message().content().orElse("No response content")); +``` + +## Ringkasan + +Bagus! Sekarang Anda telah menyiapkan semuanya: + +- Membuat Token Akses Pribadi GitHub dengan izin yang tepat untuk akses model AI +- Menjalankan lingkungan pengembangan Java Anda (baik itu Codespaces, kontainer dev, atau lokal) +- Terhubung ke GitHub Models menggunakan OpenAI Java SDK untuk pengembangan AI gratis +- Menguji semuanya bekerja dengan contoh sederhana yang berbicara dengan model AI + +## Langkah Selanjutnya + +[Bab 3: Teknik Generative AI Inti](../03-CoreGenerativeAITechniques/README.md) + +## Pemecahan Masalah + +Mengalami masalah? Berikut masalah dan solusi umum: + +- **Token tidak bekerja?** + - Pastikan Anda menyalin seluruh token tanpa spasi tambahan + - Verifikasi token sudah diatur dengan benar sebagai variabel lingkungan + - Periksa bahwa token Anda memiliki izin yang tepat (Models: Read-only) + +- **Maven tidak ditemukan?** + - Jika menggunakan dev container/Codespaces, Maven sudah terpasang + - Untuk pengaturan lokal, pastikan Java 21+ dan Maven 3.9+ sudah terpasang + - Coba jalankan `mvn --version` untuk verifikasi instalasi + +- **Masalah koneksi?** + - Periksa koneksi internet Anda + - Pastikan GitHub dapat diakses dari jaringan Anda + - Pastikan Anda tidak berada di balik firewall yang memblokir endpoint GitHub Models + +- **Kontainer dev tidak mulai?** + - Pastikan Docker Desktop berjalan (untuk pengembangan lokal) + - Coba bangun ulang kontainer: `Ctrl+Shift+P` → "Dev Containers: Rebuild Container" + +- **Kesalahan kompilasi aplikasi?** + - Pastikan Anda berada di direktori yang benar: `02-SetupDevEnvironment/examples/github-models` + - Coba bersihkan dan bangun ulang: `mvn clean compile` + +> **Butuh bantuan?**: Masih mengalami masalah? Buka issue di repositori dan kami akan membantu Anda. --- + +**Penafian**: +Dokumen ini telah diterjemahkan menggunakan layanan terjemahan AI [Co-op Translator](https://github.com/Azure/co-op-translator). Meskipun kami berusaha untuk akurasi, harap diingat bahwa terjemahan otomatis mungkin mengandung kesalahan atau ketidakakuratan. Dokumen asli dalam bahasa aslinya harus dianggap sebagai sumber yang sahih. Untuk informasi penting, disarankan menggunakan terjemahan profesional oleh manusia. Kami tidak bertanggung jawab atas kesalahpahaman atau salah tafsir yang timbul dari penggunaan terjemahan ini. + \ No newline at end of file diff --git a/translations/id/02-SetupDevEnvironment/examples/basic-chat-azure/README.md b/translations/id/02-SetupDevEnvironment/examples/basic-chat-azure/README.md index 053518dd..013b27aa 100644 --- a/translations/id/02-SetupDevEnvironment/examples/basic-chat-azure/README.md +++ b/translations/id/02-SetupDevEnvironment/examples/basic-chat-azure/README.md @@ -1,12 +1,3 @@ - # Obrolan Dasar dengan Azure OpenAI - Contoh End-to-End Contoh ini menunjukkan cara membuat aplikasi Spring Boot sederhana yang terhubung ke Azure OpenAI dan menguji pengaturan Anda. diff --git a/translations/id/02-SetupDevEnvironment/getting-started-azure-openai.md b/translations/id/02-SetupDevEnvironment/getting-started-azure-openai.md index 5a548022..35a09d04 100644 --- a/translations/id/02-SetupDevEnvironment/getting-started-azure-openai.md +++ b/translations/id/02-SetupDevEnvironment/getting-started-azure-openai.md @@ -1,12 +1,3 @@ - # Menyiapkan Lingkungan Pengembangan untuk Azure OpenAI > **Quick Start**: Panduan ini untuk pengaturan Azure OpenAI. Untuk memulai dengan model gratis, gunakan [GitHub Models with Codespaces](./README.md#quick-start-cloud). diff --git a/translations/id/03-CoreGenerativeAITechniques/README.md b/translations/id/03-CoreGenerativeAITechniques/README.md index cf5fe749..68a6f13f 100644 --- a/translations/id/03-CoreGenerativeAITechniques/README.md +++ b/translations/id/03-CoreGenerativeAITechniques/README.md @@ -1,12 +1,3 @@ - # Tutorial Teknik Inti Generative AI ## Daftar Isi diff --git a/translations/id/04-PracticalSamples/README.md b/translations/id/04-PracticalSamples/README.md index cef78a23..579629e5 100644 --- a/translations/id/04-PracticalSamples/README.md +++ b/translations/id/04-PracticalSamples/README.md @@ -1,12 +1,3 @@ - # Aplikasi Praktis & Proyek ## Apa yang Akan Anda Pelajari diff --git a/translations/id/04-PracticalSamples/calculator/README.md b/translations/id/04-PracticalSamples/calculator/README.md index a5607dba..5cf1c960 100644 --- a/translations/id/04-PracticalSamples/calculator/README.md +++ b/translations/id/04-PracticalSamples/calculator/README.md @@ -1,12 +1,3 @@ - # Tutorial MCP Calculator untuk Pemula ## Daftar Isi diff --git a/translations/id/04-PracticalSamples/foundrylocal/README.md b/translations/id/04-PracticalSamples/foundrylocal/README.md index 5c66de7d..0c064a8f 100644 --- a/translations/id/04-PracticalSamples/foundrylocal/README.md +++ b/translations/id/04-PracticalSamples/foundrylocal/README.md @@ -1,12 +1,3 @@ - # Tutorial Spring Boot Foundry Local ## Daftar Isi diff --git a/translations/id/04-PracticalSamples/petstory/README.md b/translations/id/04-PracticalSamples/petstory/README.md index 613280d9..54c71926 100644 --- a/translations/id/04-PracticalSamples/petstory/README.md +++ b/translations/id/04-PracticalSamples/petstory/README.md @@ -1,12 +1,3 @@ - # Tutorial Generator Cerita Hewan Peliharaan untuk Pemula ## Daftar Isi diff --git a/translations/id/05-ResponsibleGenAI/README.md b/translations/id/05-ResponsibleGenAI/README.md index 01c97b95..cf3b0033 100644 --- a/translations/id/05-ResponsibleGenAI/README.md +++ b/translations/id/05-ResponsibleGenAI/README.md @@ -1,12 +1,3 @@ - # AI Generatif yang Bertanggung Jawab ## Apa yang Akan Anda Pelajari diff --git a/translations/id/AGENTS.md b/translations/id/AGENTS.md index e4eba626..264dac2e 100644 --- a/translations/id/AGENTS.md +++ b/translations/id/AGENTS.md @@ -1,12 +1,3 @@ - # AGENTS.md ## Gambaran Proyek diff --git a/translations/id/CODE_OF_CONDUCT.md b/translations/id/CODE_OF_CONDUCT.md index d450f12d..7f784833 100644 --- a/translations/id/CODE_OF_CONDUCT.md +++ b/translations/id/CODE_OF_CONDUCT.md @@ -1,12 +1,3 @@ - # Kode Etik Sumber Terbuka Microsoft Proyek ini telah mengadopsi [Kode Etik Sumber Terbuka Microsoft](https://opensource.microsoft.com/codeofconduct/). diff --git a/translations/id/README.md b/translations/id/README.md index 66271253..0ff9d851 100644 --- a/translations/id/README.md +++ b/translations/id/README.md @@ -1,31 +1,22 @@ - # Generative AI untuk Pemula - Edisi Java [![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) ![Generative AI untuk Pemula - Edisi Java](../../translated_images/id/beg-genai-series.8b48be9951cc574c.webp) -**Komitmen Waktu**: Seluruh workshop dapat diselesaikan secara online tanpa pengaturan lokal. Pengaturan lingkungan memakan waktu 2 menit, dengan penjelajahan contoh membutuhkan 1-3 jam tergantung pada kedalaman eksplorasi. +**Komitmen Waktu**: Seluruh workshop dapat diselesaikan secara daring tanpa pengaturan lokal. Pengaturan lingkungan memakan waktu 2 menit, dengan eksplorasi sampel memerlukan 1-3 jam tergantung kedalaman eksplorasi. > **Mulai Cepat** 1. Fork repositori ini ke akun GitHub Anda -2. Klik **Code** → tab **Codespaces** → **...** → **Baru dengan opsi...** -3. Gunakan default – ini akan memilih kontainer Pengembangan yang dibuat untuk kursus ini -4. Klik **Buat codespace** -5. Tunggu ~2 menit agar lingkungan siap +2. Klik **Code** → tab **Codespaces** → **...** → **New with options...** +3. Gunakan pengaturan default – ini akan memilih kontainer Pengembangan yang dibuat untuk kursus ini +4. Klik **Create codespace** +5. Tunggu ~2 menit sampai lingkungan siap 6. Langsung lompat ke [Contoh pertama](./02-SetupDevEnvironment/README.md#step-2-create-a-github-personal-access-token) -> **Lebih suka Clone Secara Lokal?** +> **Lebih Suka Clone Secara Lokal?** > -> Repositori ini menyertakan lebih dari 50 terjemahan bahasa yang secara signifikan meningkatkan ukuran unduhan. Untuk clone tanpa terjemahan, gunakan sparse checkout: +> Repositori ini mencakup lebih dari 50 terjemahan bahasa yang secara signifikan meningkatkan ukuran unduhan. Untuk meng-clone tanpa terjemahan, gunakan sparse checkout: > ```bash > git clone --filter=blob:none --sparse https://github.com/microsoft/Generative-AI-for-beginners-java.git > cd Generative-AI-for-beginners-java @@ -33,17 +24,16 @@ CO_OP_TRANSLATOR_METADATA: > ``` > Ini memberikan Anda semua yang Anda butuhkan untuk menyelesaikan kursus dengan unduhan yang jauh lebih cepat. - ## Dukungan Multi-Bahasa ### Didukung melalui GitHub Action (Otomatis & Selalu Terbaru) -[Arab](../ar/README.md) | [Bengali](../bn/README.md) | [Bulgaria](../bg/README.md) | [Birma (Myanmar)](../my/README.md) | [Cina (Sederhana)](../zh/README.md) | [Cina (Tradisional, Hong Kong)](../hk/README.md) | [Cina (Tradisional, Macau)](../mo/README.md) | [Cina (Tradisional, Taiwan)](../tw/README.md) | [Kroasia](../hr/README.md) | [Ceko](../cs/README.md) | [Denmark](../da/README.md) | [Belanda](../nl/README.md) | [Estonia](../et/README.md) | [Finlandia](../fi/README.md) | [Perancis](../fr/README.md) | [Jerman](../de/README.md) | [Yunani](../el/README.md) | [Ibrani](../he/README.md) | [Hindi](../hi/README.md) | [Hungaria](../hu/README.md) | [Indonesia](./README.md) | [Italia](../it/README.md) | [Jepang](../ja/README.md) | [Kannada](../kn/README.md) | [Korea](../ko/README.md) | [Lituania](../lt/README.md) | [Melayu](../ms/README.md) | [Malayalam](../ml/README.md) | [Marathi](../mr/README.md) | [Nepali](../ne/README.md) | [Pidgin Nigeria](../pcm/README.md) | [Norwegia](../no/README.md) | [Persia (Farsi)](../fa/README.md) | [Polandia](../pl/README.md) | [Portugis (Brasil)](../br/README.md) | [Portugis (Portugal)](../pt/README.md) | [Punjabi (Gurmukhi)](../pa/README.md) | [Rumania](../ro/README.md) | [Rusia](../ru/README.md) | [Serbia (Sirilik)](../sr/README.md) | [Slovakia](../sk/README.md) | [Slovenia](../sl/README.md) | [Spanyol](../es/README.md) | [Swahili](../sw/README.md) | [Swedia](../sv/README.md) | [Tagalog (Filipina)](../tl/README.md) | [Tamil](../ta/README.md) | [Telugu](../te/README.md) | [Thai](../th/README.md) | [Turki](../tr/README.md) | [Ukraina](../uk/README.md) | [Urdu](../ur/README.md) | [Vietnam](../vi/README.md) +[Arab](../ar/README.md) | [Bengali](../bn/README.md) | [Bulgaria](../bg/README.md) | [Burma (Myanmar)](../my/README.md) | [Cina (Sederhana)](../zh-CN/README.md) | [Cina (Tradisional, Hong Kong)](../zh-HK/README.md) | [Cina (Tradisional, Macau)](../zh-MO/README.md) | [Cina (Tradisional, Taiwan)](../zh-TW/README.md) | [Kroasia](../hr/README.md) | [Ceko](../cs/README.md) | [Denmark](../da/README.md) | [Belanda](../nl/README.md) | [Estonia](../et/README.md) | [Finlandia](../fi/README.md) | [Prancis](../fr/README.md) | [Jerman](../de/README.md) | [Yunani](../el/README.md) | [Ibrani](../he/README.md) | [Hindi](../hi/README.md) | [Hungaria](../hu/README.md) | [Indonesia](./README.md) | [Italia](../it/README.md) | [Jepang](../ja/README.md) | [Kannada](../kn/README.md) | [Korea](../ko/README.md) | [Lituania](../lt/README.md) | [Melayu](../ms/README.md) | [Malayalam](../ml/README.md) | [Marathi](../mr/README.md) | [Nepali](../ne/README.md) | [Pidgin Nigeria](../pcm/README.md) | [Norwegia](../no/README.md) | [Persia (Farsi)](../fa/README.md) | [Polandia](../pl/README.md) | [Portugis (Brasil)](../pt-BR/README.md) | [Portugis (Portugal)](../pt-PT/README.md) | [Punjabi (Gurmukhi)](../pa/README.md) | [Rumania](../ro/README.md) | [Rusia](../ru/README.md) | [Serbia (Sirilik)](../sr/README.md) | [Slovak](../sk/README.md) | [Slovenia](../sl/README.md) | [Spanyol](../es/README.md) | [Swahili](../sw/README.md) | [Swedia](../sv/README.md) | [Tagalog (Filipina)](../tl/README.md) | [Tamil](../ta/README.md) | [Telugu](../te/README.md) | [Thai](../th/README.md) | [Turki](../tr/README.md) | [Ukraina](../uk/README.md) | [Urdu](../ur/README.md) | [Vietnam](../vi/README.md) -> **Lebih suka Clone Secara Lokal?** +> **Lebih Suka Clone Secara Lokal?** -> Repositori ini menyertakan lebih dari 50 terjemahan bahasa yang secara signifikan meningkatkan ukuran unduhan. Untuk clone tanpa terjemahan, gunakan sparse checkout: +> Repositori ini mencakup lebih dari 50 terjemahan bahasa yang secara signifikan meningkatkan ukuran unduhan. Untuk meng-clone tanpa terjemahan, gunakan sparse checkout: > ```bash > git clone --filter=blob:none --sparse https://github.com/microsoft/Generative-AI-for-beginners-java.git > cd Generative-AI-for-beginners-java @@ -56,23 +46,23 @@ CO_OP_TRANSLATOR_METADATA: ### **Bab 1: Pengenalan Generative AI** - **Konsep Inti**: Memahami Large Language Models, token, embeddings, dan kemampuan AI -- **Ekosistem AI Java**: Gambaran umum Spring AI dan OpenAI SDK +- **Ekosistem AI Java**: Gambaran tentang Spring AI dan OpenAI SDK - **Protokol Konteks Model**: Pengenalan MCP dan perannya dalam komunikasi agen AI - **Aplikasi Praktis**: Skenario dunia nyata termasuk chatbot dan pembuatan konten - **[→ Mulai Bab 1](./01-IntroToGenAI/README.md)** ### **Bab 2: Pengaturan Lingkungan Pengembangan** -- **Konfigurasi Multi-Penyedia**: Atur GitHub Models, Azure OpenAI, dan integrasi OpenAI Java SDK +- **Konfigurasi Multi-Penyedia**: Siapkan GitHub Models, Azure OpenAI, dan integrasi OpenAI Java SDK - **Spring Boot + Spring AI**: Praktik terbaik untuk pengembangan aplikasi AI perusahaan -- **GitHub Models**: Akses model AI gratis untuk prototyping dan pembelajaran (tanpa kartu kredit) -- **Alat Pengembangan**: Kontainer Docker, VS Code, dan konfigurasi GitHub Codespaces +- **GitHub Models**: Akses model AI gratis untuk prototipe dan pembelajaran (tanpa kartu kredit) +- **Alat Pengembangan**: Docker containers, VS Code, dan konfigurasi GitHub Codespaces - **[→ Mulai Bab 2](./02-SetupDevEnvironment/README.md)** ### **Bab 3: Teknik Inti Generative AI** -- **Prompt Engineering**: Teknik untuk respons optimal model AI +- **Rekayasa Prompt**: Teknik untuk respons model AI yang optimal - **Embeddings & Operasi Vektor**: Terapkan pencarian semantik dan pencocokan kesamaan - **Retrieval-Augmented Generation (RAG)**: Gabungkan AI dengan sumber data Anda sendiri -- **Panggilan Fungsi**: Perluas kemampuan AI dengan alat dan plugin khusus +- **Pemanggilan Fungsi**: Perluas kemampuan AI dengan alat dan plugin khusus - **[→ Mulai Bab 3](./03-CoreGenerativeAITechniques/README.md)** ### **Bab 4: Aplikasi Praktis & Proyek** @@ -82,9 +72,9 @@ CO_OP_TRANSLATOR_METADATA: - **[→ Mulai Bab 4](./04-PracticalSamples/README.md)** ### **Bab 5: Pengembangan AI yang Bertanggung Jawab** -- **Keamanan GitHub Models**: Uji filter konten bawaan dan mekanisme keamanan (blok keras dan penolakan lunak) -- **Demo AI Bertanggung Jawab**: Contoh langsung menunjukkan bagaimana sistem keamanan AI modern bekerja dalam praktik -- **Praktik Terbaik**: Pedoman penting untuk pengembangan dan penerapan AI yang etis +- **Keamanan GitHub Models**: Uji penyaringan konten bawaan dan mekanisme keamanan (blok keras dan penolakan lembut) +- **Demo AI yang Bertanggung Jawab**: Contoh langsung yang menunjukkan cara kerja sistem keamanan AI modern +- **Praktik Terbaik**: Panduan penting untuk pengembangan dan penerapan AI yang etis - **[→ Mulai Bab 5](./05-ResponsibleGenAI/README.md)** ## Sumber Daya Tambahan @@ -100,7 +90,7 @@ CO_OP_TRANSLATOR_METADATA: [![AZD untuk Pemula](https://img.shields.io/badge/AZD%20for%20Beginners-0078D4?style=for-the-badge&labelColor=E5E7EB&color=0078D4)](https://github.com/microsoft/AZD-for-beginners?WT.mc_id=academic-105485-koreyst) [![Edge AI untuk Pemula](https://img.shields.io/badge/Edge%20AI%20for%20Beginners-00B8E4?style=for-the-badge&labelColor=E5E7EB&color=00B8E4)](https://github.com/microsoft/edgeai-for-beginners?WT.mc_id=academic-105485-koreyst) [![MCP untuk Pemula](https://img.shields.io/badge/MCP%20for%20Beginners-009688?style=for-the-badge&labelColor=E5E7EB&color=009688)](https://github.com/microsoft/mcp-for-beginners?WT.mc_id=academic-105485-koreyst) -[![Agen AI untuk Pemula](https://img.shields.io/badge/AI%20Agents%20for%20Beginners-00C49A?style=for-the-badge&labelColor=E5E7EB&color=00C49A)](https://github.com/microsoft/ai-agents-for-beginners?WT.mc_id=academic-105485-koreyst) +[![AI Agen untuk Pemula](https://img.shields.io/badge/AI%20Agents%20for%20Beginners-00C49A?style=for-the-badge&labelColor=E5E7EB&color=00C49A)](https://github.com/microsoft/ai-agents-for-beginners?WT.mc_id=academic-105485-koreyst) --- @@ -114,34 +104,35 @@ CO_OP_TRANSLATOR_METADATA: ### Pembelajaran Inti [![ML untuk Pemula](https://img.shields.io/badge/ML%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=22C55E)](https://aka.ms/ml-beginners?WT.mc_id=academic-105485-koreyst) -[![Data Science untuk Pemula](https://img.shields.io/badge/Data%20Science%20for%20Beginners-84CC16?style=for-the-badge&labelColor=E5E7EB&color=84CC16)](https://aka.ms/datascience-beginners?WT.mc_id=academic-105485-koreyst) +[![Ilmu Data untuk Pemula](https://img.shields.io/badge/Data%20Science%20for%20Beginners-84CC16?style=for-the-badge&labelColor=E5E7EB&color=84CC16)](https://aka.ms/datascience-beginners?WT.mc_id=academic-105485-koreyst) [![AI untuk Pemula](https://img.shields.io/badge/AI%20for%20Beginners-A3E635?style=for-the-badge&labelColor=E5E7EB&color=A3E635)](https://aka.ms/ai-beginners?WT.mc_id=academic-105485-koreyst) [![Keamanan Siber untuk Pemula](https://img.shields.io/badge/Cybersecurity%20for%20Beginners-F97316?style=for-the-badge&labelColor=E5E7EB&color=F97316)](https://github.com/microsoft/Security-101?WT.mc_id=academic-96948-sayoung) -[![Pengembangan Web untuk Pemula](https://img.shields.io/badge/Web%20Dev%20for%20Beginners-EC4899?style=for-the-badge&labelColor=E5E7EB&color=EC4899)](https://aka.ms/webdev-beginners?WT.mc_id=academic-105485-koreyst) + +[![Web Dev untuk Pemula](https://img.shields.io/badge/Web%20Dev%20for%20Beginners-EC4899?style=for-the-badge&labelColor=E5E7EB&color=EC4899)](https://aka.ms/webdev-beginners?WT.mc_id=academic-105485-koreyst) [![IoT untuk Pemula](https://img.shields.io/badge/IoT%20for%20Beginners-14B8A6?style=for-the-badge&labelColor=E5E7EB&color=14B8A6)](https://aka.ms/iot-beginners?WT.mc_id=academic-105485-koreyst) [![Pengembangan XR untuk Pemula](https://img.shields.io/badge/XR%20Development%20for%20Beginners-38BDF8?style=for-the-badge&labelColor=E5E7EB&color=38BDF8)](https://github.com/microsoft/xr-development-for-beginners?WT.mc_id=academic-105485-koreyst) --- ### Seri Copilot -[![Copilot untuk Pemrograman Pasangan AI](https://img.shields.io/badge/Copilot%20for%20AI%20Paired%20Programming-FACC15?style=for-the-badge&labelColor=E5E7EB&color=FACC15)](https://aka.ms/GitHubCopilotAI?WT.mc_id=academic-105485-koreyst) +[![Copilot untuk Pemrograman Berpasangan AI](https://img.shields.io/badge/Copilot%20for%20AI%20Paired%20Programming-FACC15?style=for-the-badge&labelColor=E5E7EB&color=FACC15)](https://aka.ms/GitHubCopilotAI?WT.mc_id=academic-105485-koreyst) [![Copilot untuk C#/.NET](https://img.shields.io/badge/Copilot%20for%20C%23/.NET-FBBF24?style=for-the-badge&labelColor=E5E7EB&color=FBBF24)](https://github.com/microsoft/mastering-github-copilot-for-dotnet-csharp-developers?WT.mc_id=academic-105485-koreyst) [![Petualangan Copilot](https://img.shields.io/badge/Copilot%20Adventure-FDE68A?style=for-the-badge&labelColor=E5E7EB&color=FDE68A)](https://github.com/microsoft/CopilotAdventures?WT.mc_id=academic-105485-koreyst) ## Mendapatkan Bantuan -Jika Anda mengalami kebuntuan atau memiliki pertanyaan tentang membangun aplikasi AI. Bergabunglah dengan sesama pelajar dan pengembang berpengalaman dalam diskusi tentang MCP. Ini adalah komunitas yang suportif di mana pertanyaan disambut dan pengetahuan dibagikan secara bebas. +Jika Anda mengalami kesulitan atau memiliki pertanyaan tentang membangun aplikasi AI. Bergabunglah dengan pelajar dan pengembang berpengalaman lainnya dalam diskusi tentang MCP. Ini adalah komunitas yang mendukung di mana pertanyaan disambut dan pengetahuan dibagikan secara bebas. [![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) -Jika Anda memiliki umpan balik produk atau menemukan kesalahan saat membangun, kunjungi: +Jika Anda memiliki masukan produk atau menemukan kesalahan saat membangun, kunjungi: -[![Microsoft Foundry Developer Forum](https://img.shields.io/badge/GitHub-Microsoft_Foundry_Developer_Forum-blue?style=for-the-badge&logo=github&color=000000&logoColor=fff)](https://aka.ms/foundry/forum) +[![Forum Pengembang Microsoft Foundry](https://img.shields.io/badge/GitHub-Microsoft_Foundry_Developer_Forum-blue?style=for-the-badge&logo=github&color=000000&logoColor=fff)](https://aka.ms/foundry/forum) --- -**Penafian**: -Dokumen ini telah diterjemahkan menggunakan layanan terjemahan AI [Co-op Translator](https://github.com/Azure/co-op-translator). Meskipun kami berusaha untuk akurasi, harap diketahui bahwa terjemahan otomatis mungkin mengandung kesalahan atau ketidakakuratan. Dokumen asli dalam bahasa aslinya harus dianggap sebagai sumber yang sahih. Untuk informasi yang krusial, disarankan menggunakan terjemahan profesional oleh manusia. Kami tidak bertanggung jawab atas kesalahpahaman atau salah tafsir yang timbul akibat penggunaan terjemahan ini. +**Penafian**: +Dokumen ini telah diterjemahkan menggunakan layanan terjemahan AI [Co-op Translator](https://github.com/Azure/co-op-translator). Meskipun kami berupaya untuk mencapai akurasi, harap diketahui bahwa terjemahan otomatis mungkin mengandung kesalahan atau ketidakakuratan. Dokumen asli dalam bahasa aslinya harus dianggap sebagai sumber yang sahih. Untuk informasi penting, disarankan menggunakan terjemahan profesional oleh manusia. Kami tidak bertanggung jawab atas kesalahpahaman atau penafsiran yang salah yang timbul dari penggunaan terjemahan ini. \ No newline at end of file diff --git a/translations/id/SECURITY.md b/translations/id/SECURITY.md index ab0bb8d4..2be70332 100644 --- a/translations/id/SECURITY.md +++ b/translations/id/SECURITY.md @@ -1,12 +1,3 @@ - ## Keamanan Microsoft sangat memperhatikan keamanan produk dan layanan perangkat lunak kami, termasuk semua repositori kode sumber yang dikelola melalui organisasi GitHub kami, seperti [Microsoft](https://github.com/Microsoft), [Azure](https://github.com/Azure), [DotNet](https://github.com/dotnet), [AspNet](https://github.com/aspnet), dan [Xamarin](https://github.com/xamarin). diff --git a/translations/id/SUPPORT.md b/translations/id/SUPPORT.md index 00e472cd..7b9611f7 100644 --- a/translations/id/SUPPORT.md +++ b/translations/id/SUPPORT.md @@ -1,12 +1,3 @@ - # Dukungan ## Cara melaporkan masalah dan mendapatkan bantuan diff --git a/translations/it/.co-op-translator.json b/translations/it/.co-op-translator.json new file mode 100644 index 00000000..bffa211c --- /dev/null +++ b/translations/it/.co-op-translator.json @@ -0,0 +1,92 @@ +{ + "01-IntroToGenAI/README.md": { + "original_hash": "75bfb080ca725e8a9aa9c80cae25fba1", + "translation_date": "2025-07-29T09:05:11+00:00", + "source_file": "01-IntroToGenAI/README.md", + "language_code": "it" + }, + "02-SetupDevEnvironment/README.md": { + "original_hash": "96a30d42b9751a3d4e4b20e28d29d459", + "translation_date": "2026-01-28T04:56:43+00:00", + "source_file": "02-SetupDevEnvironment/README.md", + "language_code": "it" + }, + "02-SetupDevEnvironment/examples/basic-chat-azure/README.md": { + "original_hash": "efd82efe50711d7e257eb943151d682c", + "translation_date": "2025-07-27T13:39:58+00:00", + "source_file": "02-SetupDevEnvironment/examples/basic-chat-azure/README.md", + "language_code": "it" + }, + "02-SetupDevEnvironment/getting-started-azure-openai.md": { + "original_hash": "bfdb4b4eadbee3a59ef742439f58326a", + "translation_date": "2025-07-27T13:07:31+00:00", + "source_file": "02-SetupDevEnvironment/getting-started-azure-openai.md", + "language_code": "it" + }, + "03-CoreGenerativeAITechniques/README.md": { + "original_hash": "685f55cb07de19b52a30ce6e8b6d889e", + "translation_date": "2025-08-28T22:04:34+00:00", + "source_file": "03-CoreGenerativeAITechniques/README.md", + "language_code": "it" + }, + "04-PracticalSamples/README.md": { + "original_hash": "14c0a61ecc1cd2012a9c129236dfdf71", + "translation_date": "2025-07-29T09:04:50+00:00", + "source_file": "04-PracticalSamples/README.md", + "language_code": "it" + }, + "04-PracticalSamples/calculator/README.md": { + "original_hash": "b6c16b5514d524e415a94f6097ee7d4c", + "translation_date": "2025-09-18T15:31:13+00:00", + "source_file": "04-PracticalSamples/calculator/README.md", + "language_code": "it" + }, + "04-PracticalSamples/foundrylocal/README.md": { + "original_hash": "f787307400de59adc25a1404466a35f3", + "translation_date": "2025-11-04T07:23:26+00:00", + "source_file": "04-PracticalSamples/foundrylocal/README.md", + "language_code": "it" + }, + "04-PracticalSamples/petstory/README.md": { + "original_hash": "0cbf68d605615a1e602c832a24616859", + "translation_date": "2025-07-25T11:18:56+00:00", + "source_file": "04-PracticalSamples/petstory/README.md", + "language_code": "it" + }, + "05-ResponsibleGenAI/README.md": { + "original_hash": "301c05c2f57e60a6950b8c665b8bdbba", + "translation_date": "2025-07-29T15:49:25+00:00", + "source_file": "05-ResponsibleGenAI/README.md", + "language_code": "it" + }, + "AGENTS.md": { + "original_hash": "afc90918d008cf77fd1982691f681306", + "translation_date": "2025-10-03T08:34:59+00:00", + "source_file": "AGENTS.md", + "language_code": "it" + }, + "CODE_OF_CONDUCT.md": { + "original_hash": "442b123d034f92f7c384d2bbd28f99f1", + "translation_date": "2025-07-21T17:37:11+00:00", + "source_file": "CODE_OF_CONDUCT.md", + "language_code": "it" + }, + "README.md": { + "original_hash": "125a08948d881c95628094f4dd1fbd43", + "translation_date": "2026-01-29T15:43:45+00:00", + "source_file": "README.md", + "language_code": "it" + }, + "SECURITY.md": { + "original_hash": "57f14126c1c6add76b3aef3844dfe4e3", + "translation_date": "2025-07-21T17:35:55+00:00", + "source_file": "SECURITY.md", + "language_code": "it" + }, + "SUPPORT.md": { + "original_hash": "b8ef73cc49dec68e2c885ee9df545129", + "translation_date": "2025-07-21T17:38:16+00:00", + "source_file": "SUPPORT.md", + "language_code": "it" + } +} \ No newline at end of file diff --git a/translations/it/01-IntroToGenAI/README.md b/translations/it/01-IntroToGenAI/README.md index ebe4a050..953f30c8 100644 --- a/translations/it/01-IntroToGenAI/README.md +++ b/translations/it/01-IntroToGenAI/README.md @@ -1,12 +1,3 @@ - # Introduzione all'AI Generativa - Edizione Java ## Cosa Imparerai diff --git a/translations/it/02-SetupDevEnvironment/README.md b/translations/it/02-SetupDevEnvironment/README.md index cb58e73a..09c2ba1c 100644 --- a/translations/it/02-SetupDevEnvironment/README.md +++ b/translations/it/02-SetupDevEnvironment/README.md @@ -1,13 +1,251 @@ - +# Configurazione dell'ambiente di sviluppo per Generative AI per Java +> **Avvio rapido**: Codifica nel cloud in 2 minuti - Vai a [Configurazione di GitHub Codespaces](../../../02-SetupDevEnvironment) - nessuna installazione locale necessaria e utilizza i modelli github! + +> **Interessato a Azure OpenAI?**, consulta la nostra [Guida di configurazione di Azure OpenAI](getting-started-azure-openai.md) con i passaggi per creare una nuova risorsa Azure OpenAI. + +## Cosa imparerai + +- Configurare un ambiente di sviluppo Java per applicazioni AI +- Scegliere e configurare il tuo ambiente di sviluppo preferito (cloud-first con Codespaces, contenitore di sviluppo locale o configurazione locale completa) +- Testare la configurazione connettendosi ai modelli GitHub + +## Indice + +- [Cosa imparerai](../../../02-SetupDevEnvironment) +- [Introduzione](../../../02-SetupDevEnvironment) +- [Passo 1: Configura il tuo ambiente di sviluppo](../../../02-SetupDevEnvironment) + - [Opzione A: GitHub Codespaces (Consigliato)](../../../02-SetupDevEnvironment) + - [Opzione B: Contenitore di sviluppo locale](../../../02-SetupDevEnvironment) + - [Opzione C: Usa la tua installazione locale esistente](../../../02-SetupDevEnvironment) +- [Passo 2: Crea un token di accesso personale GitHub](../../../02-SetupDevEnvironment) +- [Passo 3: Testa la tua configurazione](../../../02-SetupDevEnvironment) +- [Risoluzione problemi](../../../02-SetupDevEnvironment) +- [Sommario](../../../02-SetupDevEnvironment) +- [Passi successivi](../../../02-SetupDevEnvironment) + +## Introduzione + +Questo capitolo ti guiderà nella configurazione di un ambiente di sviluppo. Utilizzeremo **GitHub Models** come esempio principale perché è gratuito, facile da configurare con solo un account GitHub, non richiede carta di credito e offre accesso a più modelli per la sperimentazione. + +**Nessuna configurazione locale richiesta!** Puoi iniziare a programmare immediatamente usando GitHub Codespaces, che fornisce un ambiente di sviluppo completo nel tuo browser. + +Screenshot: GitHub Models + +Raccomandiamo di utilizzare [**GitHub Models**](https://github.com/marketplace?type=models) per questo corso perché è: +- **Gratuito** per iniziare +- **Facile** da configurare con solo un account GitHub +- **Nessuna carta di credito** richiesta +- **Più modelli** disponibili per la sperimentazione + +> **Nota**: I modelli GitHub usati in questa formazione hanno questi limiti gratuiti: +> - 15 richieste al minuto (150 al giorno) +> - ~8.000 parole in ingresso, ~4.000 parole in uscita per richiesta +> - 5 richieste concorrenti +> +> Per uso in produzione, esegui l'upgrade ai modelli Azure AI Foundry con il tuo account Azure. Il codice non deve cambiare. Vedi la [documentazione Azure AI Foundry](https://learn.microsoft.com/azure/ai-foundry/foundry-models/how-to/quickstart-github-models). + +## Passo 1: Configura il tuo ambiente di sviluppo + + + +Abbiamo creato un contenitore di sviluppo preconfigurato per minimizzare il tempo di configurazione e garantirti tutti gli strumenti necessari per questo corso Generative AI per Java. Scegli il tuo approccio di sviluppo preferito: + +### Opzioni per configurare l'ambiente: + +#### Opzione A: GitHub Codespaces (Consigliato) + +**Inizia a programmare in 2 minuti - nessuna configurazione locale richiesta!** + +1. Fai un fork di questo repository nel tuo account GitHub + > **Nota**: Se vuoi modificare la configurazione base, dai un'occhiata a [Dev Container Configuration](../../../.devcontainer/devcontainer.json) +2. Clicca su **Code** → scheda **Codespaces** → **...** → **New with options...** +3. Usa i valori predefiniti – questo selezionerà la **configurazione del contenitore di sviluppo**: **Generative AI Java Development Environment** contenitore dev personalizzato creato per questo corso +4. Clicca su **Create codespace** +5. Attendi ~2 minuti che l'ambiente sia pronto +6. Prosegui a [Passo 2: Crea token GitHub](../../../02-SetupDevEnvironment) + +Screenshot: sottomenu Codespaces + +Screenshot: New with options + +Screenshot: opzioni per creare codespace + +> **Benefici di Codespaces**: +> - Nessuna installazione locale richiesta +> - Funziona su qualsiasi dispositivo con un browser +> - Preconfigurato con tutti gli strumenti e dipendenze +> - 60 ore gratuite al mese per account personali +> - Ambiente coerente per tutti gli studenti + +#### Opzione B: Contenitore di sviluppo locale + +**Per sviluppatori che preferiscono sviluppo locale con Docker** + +1. Fai un fork e clona questo repository sulla tua macchina locale + > **Nota**: Se vuoi modificare la configurazione base, dai un'occhiata a [Dev Container Configuration](../../../.devcontainer/devcontainer.json) +2. Installa [Docker Desktop](https://www.docker.com/products/docker-desktop/) e [VS Code](https://code.visualstudio.com/) +3. Installa l'[estensione Dev Containers](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers) in VS Code +4. Apri la cartella del repository in VS Code +5. Quando richiesto, clicca su **Reopen in Container** (o usa `Ctrl+Shift+P` → "Dev Containers: Reopen in Container") +6. Attendi che il contenitore venga buildato e avviato +7. Prosegui a [Passo 2: Crea token GitHub](../../../02-SetupDevEnvironment) + +Screenshot: configurazione contenitore dev + +Screenshot: build contenitore dev completata + +#### Opzione C: Usa la tua installazione locale esistente + +**Per sviluppatori con ambienti Java esistenti** + +Prerequisiti: +- [Java 21+](https://www.oracle.com/java/technologies/javase/jdk21-archive-downloads.html) +- [Maven 3.9+](https://maven.apache.org/download.cgi) +- [VS Code](https://code.visualstudio.com) o il tuo IDE preferito + +Passaggi: +1. Clona questo repository sulla tua macchina locale +2. Apri il progetto nel tuo IDE +3. Prosegui a [Passo 2: Crea token GitHub](../../../02-SetupDevEnvironment) + +> **Consiglio professionale**: Se hai un computer con specifiche basse ma vuoi VS Code localmente, usa GitHub Codespaces! Puoi connettere il tuo VS Code locale a un Codespace ospitato nel cloud per il meglio di entrambi i mondi. + +Screenshot: istanza contenitore dev locale creata + +## Passo 2: Crea un token di accesso personale GitHub + +1. Vai su [Impostazioni GitHub](https://github.com/settings/profile) e seleziona **Settings** dal menu del profilo. +2. Nella barra laterale sinistra, clicca su **Developer settings** (di solito in fondo). +3. Sotto **Personal access tokens**, clicca su **Fine-grained tokens** (o segui questo [link](https://github.com/settings/personal-access-tokens)). +4. Clicca su **Generate new token**. +5. Sotto "Token name", fornisci un nome descrittivo (es. `GenAI-Java-Course-Token`). +6. Imposta una data di scadenza (consigliato: 7 giorni per le migliori pratiche di sicurezza). +7. Sotto "Resource owner", seleziona il tuo account utente. +8. Sotto "Repository access", seleziona i repository che vuoi usare con GitHub Models (o "All repositories" se necessario). +9. Sotto "Account permissions", trova **Models** e impostalo su **Read-only**. +10. Clicca su **Generate token**. +11. **Copia e salva il tuo token ora** – non lo vedrai più! + +> **Suggerimento di sicurezza**: Usa il minimo ambito necessario e la più breve durata pratica per i token di accesso. + +## Passo 3: Testa la tua configurazione con l'esempio GitHub Models + +Quando il tuo ambiente di sviluppo è pronto, testiamo l'integrazione con GitHub Models con la nostra applicazione di esempio in [`02-SetupDevEnvironment/examples/github-models`](../../../02-SetupDevEnvironment/examples/github-models). + +1. Apri il terminale nel tuo ambiente di sviluppo. +2. Vai nella cartella dell'esempio GitHub Models: + ```bash + cd 02-SetupDevEnvironment/examples/github-models + ``` +3. Imposta il tuo token GitHub come variabile d'ambiente: + ```bash + # macOS/Linux + export GITHUB_TOKEN=your_token_here + + # Windows (Prompt dei comandi) + set GITHUB_TOKEN=your_token_here + + # Windows (PowerShell) + $env:GITHUB_TOKEN="your_token_here" + ``` + +4. Esegui l'applicazione: + ```bash + mvn compile exec:java -Dexec.mainClass="com.example.githubmodels.App" + ``` + +Dovresti vedere un output simile a: +```text +Using model: gpt-4.1-nano +Sending request to GitHub Models... +Response: Hello World! +``` + +### Comprendere il codice di esempio + +Prima, capiamo cosa abbiamo appena eseguito. L'esempio sotto `examples/github-models` usa l'SDK Java OpenAI per connettersi a GitHub Models: + +**Cosa fa questo codice:** +- **Si connette** a GitHub Models usando il tuo token di accesso personale +- **Invia** un semplice messaggio "Say Hello World!" al modello AI +- **Riceve** e mostra la risposta dell'AI +- **Valida** che la tua configurazione funzioni correttamente + +**Dipendenza chiave** (in `pom.xml`): +```xml + + com.openai + openai-java + 2.12.0 + +``` + +**Codice principale** (`App.java`): +```java +// Connettersi a GitHub Models usando OpenAI Java SDK +OpenAIClient client = OpenAIOkHttpClient.builder() + .apiKey(pat) + .baseUrl("https://models.inference.ai.azure.com") + .build(); + +// Creare richiesta completamento chat +ChatCompletionCreateParams params = ChatCompletionCreateParams.builder() + .model(modelId) + .addSystemMessage("You are a concise assistant.") + .addUserMessage("Say Hello World!") + .build(); + +// Ottenere risposta AI +ChatCompletion response = client.chat().completions().create(params); +System.out.println("Response: " + response.choices().get(0).message().content().orElse("No response content")); +``` + +## Sommario + +Ottimo! Ora hai tutto configurato: + +- Creato un token di accesso personale GitHub con i permessi corretti per l'accesso ai modelli AI +- Fatto partire il tuo ambiente di sviluppo Java (sia Codespaces, contenitori dev o locale) +- Collegato a GitHub Models usando l'SDK Java OpenAI per sviluppo AI gratuito +- Testato che tutto funzioni con un semplice esempio che comunica con i modelli AI + +## Passi successivi + +[Capitolo 3: Tecniche principali di Generative AI](../03-CoreGenerativeAITechniques/README.md) + +## Risoluzione problemi + +Hai problemi? Ecco problemi comuni e soluzioni: + +- **Token non funziona?** + - Assicurati di aver copiato l'intero token senza spazi extra + - Verifica che il token sia impostato correttamente come variabile d'ambiente + - Controlla che il token abbia i permessi corretti (Models: Read-only) + +- **Maven non trovato?** + - Se usi dev container/Codespaces, Maven dovrebbe essere preinstallato + - Per configurazione locale, assicurati che Java 21+ e Maven 3.9+ siano installati + - Prova `mvn --version` per verificare l'installazione + +- **Problemi di connessione?** + - Controlla la tua connessione internet + - Verifica che GitHub sia accessibile dalla tua rete + - Assicurati di non essere dietro a un firewall che blocca l'endpoint GitHub Models + +- **Contenitore dev non parte?** + - Verifica che Docker Desktop sia in esecuzione (per sviluppo locale) + - Prova a ricostruire il contenitore: `Ctrl+Shift+P` → "Dev Containers: Rebuild Container" + +- **Errori di compilazione applicazione?** + - Assicurati di essere nella directory corretta: `02-SetupDevEnvironment/examples/github-models` + - Prova a pulire e ricostruire: `mvn clean compile` + +> **Hai bisogno di aiuto?**: Ancora problemi? Apri un issue nel repository e ti aiuteremo. --- + +**Avvertenza**: +Questo documento è stato tradotto utilizzando il servizio di traduzione automatica [Co-op Translator](https://github.com/Azure/co-op-translator). Pur impegnandoci per garantire l’accuratezza, si prega di considerare che le traduzioni automatiche possono contenere errori o inesattezze. Il documento originale nella sua lingua nativa deve essere considerato la fonte autorevole. Per informazioni critiche, si raccomanda una traduzione professionale effettuata da un traduttore umano. Non ci assumiamo alcuna responsabilità per eventuali fraintendimenti o interpretazioni errate derivanti dall’uso di questa traduzione. + \ No newline at end of file diff --git a/translations/it/02-SetupDevEnvironment/examples/basic-chat-azure/README.md b/translations/it/02-SetupDevEnvironment/examples/basic-chat-azure/README.md index 09661d9a..0875c758 100644 --- a/translations/it/02-SetupDevEnvironment/examples/basic-chat-azure/README.md +++ b/translations/it/02-SetupDevEnvironment/examples/basic-chat-azure/README.md @@ -1,12 +1,3 @@ - # Chat di Base con Azure OpenAI - Esempio Completo Questo esempio dimostra come creare una semplice applicazione Spring Boot che si connette ad Azure OpenAI e testa la tua configurazione. diff --git a/translations/it/02-SetupDevEnvironment/getting-started-azure-openai.md b/translations/it/02-SetupDevEnvironment/getting-started-azure-openai.md index 70e991af..d3c015a2 100644 --- a/translations/it/02-SetupDevEnvironment/getting-started-azure-openai.md +++ b/translations/it/02-SetupDevEnvironment/getting-started-azure-openai.md @@ -1,12 +1,3 @@ - # Configurazione dell'Ambiente di Sviluppo per Azure OpenAI > **Avvio Rapido**: Questa guida è per la configurazione di Azure OpenAI. Per iniziare subito con modelli gratuiti, utilizza [GitHub Models con Codespaces](./README.md#quick-start-cloud). diff --git a/translations/it/03-CoreGenerativeAITechniques/README.md b/translations/it/03-CoreGenerativeAITechniques/README.md index c8e4b436..73039365 100644 --- a/translations/it/03-CoreGenerativeAITechniques/README.md +++ b/translations/it/03-CoreGenerativeAITechniques/README.md @@ -1,12 +1,3 @@ - # Tutorial sulle Tecniche Fondamentali di Generative AI ## Indice diff --git a/translations/it/04-PracticalSamples/README.md b/translations/it/04-PracticalSamples/README.md index f1809644..02bc0461 100644 --- a/translations/it/04-PracticalSamples/README.md +++ b/translations/it/04-PracticalSamples/README.md @@ -1,12 +1,3 @@ - # Applicazioni Pratiche e Progetti ## Cosa Imparerai diff --git a/translations/it/04-PracticalSamples/calculator/README.md b/translations/it/04-PracticalSamples/calculator/README.md index 55243d1a..18eb7bb8 100644 --- a/translations/it/04-PracticalSamples/calculator/README.md +++ b/translations/it/04-PracticalSamples/calculator/README.md @@ -1,12 +1,3 @@ - # Tutorial del Calcolatore MCP per Principianti ## Indice diff --git a/translations/it/04-PracticalSamples/foundrylocal/README.md b/translations/it/04-PracticalSamples/foundrylocal/README.md index 5acd42f3..6a40bf28 100644 --- a/translations/it/04-PracticalSamples/foundrylocal/README.md +++ b/translations/it/04-PracticalSamples/foundrylocal/README.md @@ -1,12 +1,3 @@ - # Tutorial di Foundry Local con Spring Boot ## Indice diff --git a/translations/it/04-PracticalSamples/petstory/README.md b/translations/it/04-PracticalSamples/petstory/README.md index d049d47b..855c3fd1 100644 --- a/translations/it/04-PracticalSamples/petstory/README.md +++ b/translations/it/04-PracticalSamples/petstory/README.md @@ -1,12 +1,3 @@ - # Tutorial del Generatore di Storie per Animali Domestici per Principianti ## Indice diff --git a/translations/it/05-ResponsibleGenAI/README.md b/translations/it/05-ResponsibleGenAI/README.md index 0176891e..3cf928a4 100644 --- a/translations/it/05-ResponsibleGenAI/README.md +++ b/translations/it/05-ResponsibleGenAI/README.md @@ -1,12 +1,3 @@ - # Intelligenza Artificiale Generativa Responsabile ## Cosa Imparerai diff --git a/translations/it/AGENTS.md b/translations/it/AGENTS.md index 9d2be492..b68cbd26 100644 --- a/translations/it/AGENTS.md +++ b/translations/it/AGENTS.md @@ -1,12 +1,3 @@ - # AGENTS.md ## Panoramica del Progetto diff --git a/translations/it/CODE_OF_CONDUCT.md b/translations/it/CODE_OF_CONDUCT.md index 4142c586..b5055a88 100644 --- a/translations/it/CODE_OF_CONDUCT.md +++ b/translations/it/CODE_OF_CONDUCT.md @@ -1,12 +1,3 @@ - # Codice di Condotta per l'Open Source di Microsoft Questo progetto ha adottato il [Codice di Condotta per l'Open Source di Microsoft](https://opensource.microsoft.com/codeofconduct/). diff --git a/translations/it/README.md b/translations/it/README.md index 47e95635..17b8d647 100644 --- a/translations/it/README.md +++ b/translations/it/README.md @@ -1,26 +1,17 @@ - -# Intelligenza Artificiale Generativa per Principianti - Edizione Java +# Generative AI per Principianti - Edizione Java [![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) -![Intelligenza Artificiale Generativa per Principianti - Edizione Java](../../translated_images/it/beg-genai-series.8b48be9951cc574c.webp) +![Generative AI per Principianti - Edizione Java](../../translated_images/it/beg-genai-series.8b48be9951cc574c.webp) -**Impegno Temporale**: L'intero workshop può essere completato online senza configurazioni locali. L'installazione dell'ambiente richiede 2 minuti, mentre l’esplorazione degli esempi richiede da 1 a 3 ore a seconda della profondità dell'esplorazione. +**Tempo di impegno**: L'intero workshop può essere completato online senza configurazioni locali. La configurazione dell'ambiente richiede 2 minuti, mentre l'esplorazione degli esempi richiede da 1 a 3 ore a seconda della profondità dell'esplorazione. -> **Inizio Rapido** +> **Avvio rapido** -1. Fai il fork di questo repository sul tuo account GitHub -2. Clicca su **Code** → scheda **Codespaces** → **...** → **New with options...** -3. Usa i valori predefiniti – questo selezionerà il container di sviluppo creato per questo corso -4. Clicca su **Create codespace** -5. Attendi circa 2 minuti che l’ambiente sia pronto +1. Fai un fork di questo repository sul tuo account GitHub +2. Clicca su **Code** → scheda **Codespaces** → **...** → **Nuovo con opzioni...** +3. Usa le impostazioni predefinite – questo selezionerà il contenitore di sviluppo creato per questo corso +4. Clicca su **Crea codespace** +5. Attendi ~2 minuti che l'ambiente sia pronto 6. Vai direttamente a [Il primo esempio](./02-SetupDevEnvironment/README.md#step-2-create-a-github-personal-access-token) > **Preferisci Clonare Localmente?** @@ -34,12 +25,12 @@ CO_OP_TRANSLATOR_METADATA: > Questo ti dà tutto il necessario per completare il corso con un download molto più veloce. -## Supporto Multilingue +## Supporto Multi-Lingua -### Supportato tramite GitHub Action (Automatizzato e Sempre Aggiornato) +### Supportato tramite GitHub Action (Automatizzato & Sempre Aggiornato) -[Arabo](../ar/README.md) | [Bengalese](../bn/README.md) | [Bulgaro](../bg/README.md) | [Birmano (Myanmar)](../my/README.md) | [Cinese (Semplificato)](../zh/README.md) | [Cinese (Tradizionale, Hong Kong)](../hk/README.md) | [Cinese (Tradizionale, Macao)](../mo/README.md) | [Cinese (Tradizionale, Taiwan)](../tw/README.md) | [Croato](../hr/README.md) | [Ceco](../cs/README.md) | [Danese](../da/README.md) | [Olandese](../nl/README.md) | [Estone](../et/README.md) | [Finlandese](../fi/README.md) | [Francese](../fr/README.md) | [Tedesco](../de/README.md) | [Greco](../el/README.md) | [Ebraico](../he/README.md) | [Hindi](../hi/README.md) | [Ungherese](../hu/README.md) | [Indonesiano](../id/README.md) | [Italiano](./README.md) | [Giapponese](../ja/README.md) | [Kannada](../kn/README.md) | [Coreano](../ko/README.md) | [Lituano](../lt/README.md) | [Malese](../ms/README.md) | [Malayalam](../ml/README.md) | [Marathi](../mr/README.md) | [Nepalese](../ne/README.md) | [Pidgin Nigeriano](../pcm/README.md) | [Norvegese](../no/README.md) | [Persiano (Farsi)](../fa/README.md) | [Polacco](../pl/README.md) | [Portoghese (Brasile)](../br/README.md) | [Portoghese (Portogallo)](../pt/README.md) | [Punjabi (Gurmukhi)](../pa/README.md) | [Romeno](../ro/README.md) | [Russo](../ru/README.md) | [Serbo (Cirillico)](../sr/README.md) | [Slovacco](../sk/README.md) | [Sloveno](../sl/README.md) | [Spagnolo](../es/README.md) | [Swahili](../sw/README.md) | [Svedese](../sv/README.md) | [Tagalog (Filippino)](../tl/README.md) | [Tamil](../ta/README.md) | [Telugu](../te/README.md) | [Thailandese](../th/README.md) | [Turco](../tr/README.md) | [Ucraino](../uk/README.md) | [Urdu](../ur/README.md) | [Vietnamita](../vi/README.md) +[Arabo](../ar/README.md) | [Bengalese](../bn/README.md) | [Bulgaro](../bg/README.md) | [Birmano (Myanmar)](../my/README.md) | [Cinese (Semplificato)](../zh-CN/README.md) | [Cinese (Tradizionale, Hong Kong)](../zh-HK/README.md) | [Cinese (Tradizionale, Macao)](../zh-MO/README.md) | [Cinese (Tradizionale, Taiwan)](../zh-TW/README.md) | [Croato](../hr/README.md) | [Ceco](../cs/README.md) | [Danese](../da/README.md) | [Olandese](../nl/README.md) | [Estone](../et/README.md) | [Finlandese](../fi/README.md) | [Francese](../fr/README.md) | [Tedesco](../de/README.md) | [Greco](../el/README.md) | [Ebraico](../he/README.md) | [Hindi](../hi/README.md) | [Ungherese](../hu/README.md) | [Indonesiano](../id/README.md) | [Italiano](./README.md) | [Giapponese](../ja/README.md) | [Kannada](../kn/README.md) | [Coreano](../ko/README.md) | [Lituano](../lt/README.md) | [Malese](../ms/README.md) | [Malayalam](../ml/README.md) | [Marathi](../mr/README.md) | [Nepalese](../ne/README.md) | [Pidgin Nigeriano](../pcm/README.md) | [Norvegese](../no/README.md) | [Persiano (Farsi)](../fa/README.md) | [Polacco](../pl/README.md) | [Portoghese (Brasile)](../pt-BR/README.md) | [Portoghese (Portogallo)](../pt-PT/README.md) | [Punjabi (Gurmukhi)](../pa/README.md) | [Rumeno](../ro/README.md) | [Russo](../ru/README.md) | [Serbo (Cirillico)](../sr/README.md) | [Slovacco](../sk/README.md) | [Sloveno](../sl/README.md) | [Spagnolo](../es/README.md) | [Swahili](../sw/README.md) | [Svedese](../sv/README.md) | [Tagalog (Filippino)](../tl/README.md) | [Tamil](../ta/README.md) | [Telugu](../te/README.md) | [Thailandese](../th/README.md) | [Turco](../tr/README.md) | [Ucraino](../uk/README.md) | [Urdu](../ur/README.md) | [Vietnamita](../vi/README.md) > **Preferisci Clonare Localmente?** @@ -52,42 +43,42 @@ CO_OP_TRANSLATOR_METADATA: > Questo ti dà tutto il necessario per completare il corso con un download molto più veloce. -## Struttura del Corso e Percorso di Apprendimento +## Struttura del Corso & Percorso di Apprendimento -### **Capitolo 1: Introduzione all’Intelligenza Artificiale Generativa** -- **Concetti Base**: Comprensione dei Large Language Models, token, embedding e capacità AI -- **Ecosistema Java AI**: Panoramica di Spring AI e SDK OpenAI -- **Protocollo del Contesto del Modello**: Introduzione a MCP e al suo ruolo nella comunicazione tra agenti AI +### **Capitolo 1: Introduzione all'Intelligenza Artificiale Generativa** +- **Concetti Chiave**: Comprendere i Modelli di Linguaggio di Grandi Dimensioni, token, embeddings e capacità AI +- **Ecosistema AI Java**: Panoramica di Spring AI e SDK OpenAI +- **Protocollo Model Context**: Introduzione a MCP e il suo ruolo nella comunicazione degli agenti AI - **Applicazioni Pratiche**: Scenari reali inclusi chatbot e generazione di contenuti - **[→ Inizia Capitolo 1](./01-IntroToGenAI/README.md)** -### **Capitolo 2: Configurazione dell’Ambiente di Sviluppo** -- **Configurazione Multi-Provider**: Configura GitHub Models, Azure OpenAI e integrazioni Java SDK OpenAI +### **Capitolo 2: Configurazione dell'Ambiente di Sviluppo** +- **Configurazione Multi-Provider**: Setup di GitHub Models, Azure OpenAI e integrazioni SDK OpenAI Java - **Spring Boot + Spring AI**: Best practice per lo sviluppo di applicazioni AI enterprise -- **GitHub Models**: Accesso gratuito a modelli AI per prototipi e apprendimento (non serve carta di credito) -- **Strumenti di Sviluppo**: Container Docker, VS Code e configurazione GitHub Codespaces +- **GitHub Models**: Accesso gratuito ai modelli AI per prototipazione e apprendimento (non serve carta di credito) +- **Strumenti di Sviluppo**: Configurazione container Docker, VS Code e GitHub Codespaces - **[→ Inizia Capitolo 2](./02-SetupDevEnvironment/README.md)** -### **Capitolo 3: Tecniche Fondamentali di Intelligenza Artificiale Generativa** +### **Capitolo 3: Tecniche Fondamentali dell'AI Generativa** - **Prompt Engineering**: Tecniche per risposte ottimali dai modelli AI -- **Embedding e Operazioni Vectoriali**: Implementa ricerche semantiche e matching di similarità -- **Retrieval-Augmented Generation (RAG)**: Combina AI con i tuoi dati -- **Function Calling**: Estendi le capacità AI con strumenti personalizzati e plugin +- **Embeddings & Operazioni Vettoriali**: Implementare ricerca semantica e matching di similarità +- **Retrieval-Augmented Generation (RAG)**: Combinare AI con le tue fonti di dati +- **Chiamata di Funzioni**: Estendere le capacità AI con strumenti e plugin personalizzati - **[→ Inizia Capitolo 3](./03-CoreGenerativeAITechniques/README.md)** ### **Capitolo 4: Applicazioni Pratiche & Progetti** -- **Generatore di Storie per Animali Domestici** (`petstory/`): Generazione creativa di contenuti con GitHub Models +- **Generatore di Racconti per Animali** (`petstory/`): Generazione creativa di contenuti con GitHub Models - **Demo Locale Foundry** (`foundrylocal/`): Integrazione di modelli AI locali con OpenAI Java SDK -- **Servizio Calcolatore MCP** (`calculator/`): Implementazione base del Model Context Protocol con Spring AI +- **Servizio Calcolatrice MCP** (`calculator/`): Implementazione base del Model Context Protocol con Spring AI - **[→ Inizia Capitolo 4](./04-PracticalSamples/README.md)** -### **Capitolo 5: Sviluppo Responsabile dell’AI** -- **Sicurezza dei GitHub Models**: Test dei filtri incorporati e meccanismi di sicurezza (blocchi rigidi e rifiuti soft) -- **Demo AI Responsabile**: Esempio pratico su come funzionano i sistemi di sicurezza AI moderni -- **Best Practice**: Linee guida essenziali per uno sviluppo e un impiego etico dell’AI +### **Capitolo 5: Sviluppo Responsabile dell'AI** +- **Sicurezza GitHub Models**: Testare i filtri di contenuto e i meccanismi di sicurezza integrati (blocchi rigidi e rifiuti soft) +- **Demo AI Responsabile**: Esempio pratico che mostra il funzionamento dei moderni sistemi di sicurezza AI +- **Best Practice**: Linee guida essenziali per uno sviluppo e distribuzione etica dell'AI - **[→ Inizia Capitolo 5](./05-ResponsibleGenAI/README.md)** -## Risorse Addizionali +## Risorse Aggiuntive ### LangChain @@ -104,44 +95,45 @@ CO_OP_TRANSLATOR_METADATA: --- -### Serie su Intelligenza Artificiale Generativa -[![Intelligenza Artificiale Generativa per Principianti](https://img.shields.io/badge/Generative%20AI%20for%20Beginners-8B5CF6?style=for-the-badge&labelColor=E5E7EB&color=8B5CF6)](https://github.com/microsoft/generative-ai-for-beginners?WT.mc_id=academic-105485-koreyst) -[![Intelligenza Artificiale Generativa (.NET)](https://img.shields.io/badge/Generative%20AI%20(.NET)-9333EA?style=for-the-badge&labelColor=E5E7EB&color=9333EA)](https://github.com/microsoft/Generative-AI-for-beginners-dotnet?WT.mc_id=academic-105485-koreyst) -[![Intelligenza Artificiale Generativa (Java)](https://img.shields.io/badge/Generative%20AI%20(Java)-C084FC?style=for-the-badge&labelColor=E5E7EB&color=C084FC)](https://github.com/microsoft/generative-ai-for-beginners-java?WT.mc_id=academic-105485-koreyst) -[![Intelligenza Artificiale Generativa (JavaScript)](https://img.shields.io/badge/Generative%20AI%20(JavaScript)-E879F9?style=for-the-badge&labelColor=E5E7EB&color=E879F9)](https://github.com/microsoft/generative-ai-with-javascript?WT.mc_id=academic-105485-koreyst) +### Serie Generative AI +[![Generative AI per Principianti](https://img.shields.io/badge/Generative%20AI%20for%20Beginners-8B5CF6?style=for-the-badge&labelColor=E5E7EB&color=8B5CF6)](https://github.com/microsoft/generative-ai-for-beginners?WT.mc_id=academic-105485-koreyst) +[![Generative AI (.NET)](https://img.shields.io/badge/Generative%20AI%20(.NET)-9333EA?style=for-the-badge&labelColor=E5E7EB&color=9333EA)](https://github.com/microsoft/Generative-AI-for-beginners-dotnet?WT.mc_id=academic-105485-koreyst) +[![Generative AI (Java)](https://img.shields.io/badge/Generative%20AI%20(Java)-C084FC?style=for-the-badge&labelColor=E5E7EB&color=C084FC)](https://github.com/microsoft/generative-ai-for-beginners-java?WT.mc_id=academic-105485-koreyst) +[![Generative AI (JavaScript)](https://img.shields.io/badge/Generative%20AI%20(JavaScript)-E879F9?style=for-the-badge&labelColor=E5E7EB&color=E879F9)](https://github.com/microsoft/generative-ai-with-javascript?WT.mc_id=academic-105485-koreyst) --- -### Apprendimento Fondamentale +### Apprendimento Base [![ML per Principianti](https://img.shields.io/badge/ML%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=22C55E)](https://aka.ms/ml-beginners?WT.mc_id=academic-105485-koreyst) [![Data Science per Principianti](https://img.shields.io/badge/Data%20Science%20for%20Beginners-84CC16?style=for-the-badge&labelColor=E5E7EB&color=84CC16)](https://aka.ms/datascience-beginners?WT.mc_id=academic-105485-koreyst) [![AI per Principianti](https://img.shields.io/badge/AI%20for%20Beginners-A3E635?style=for-the-badge&labelColor=E5E7EB&color=A3E635)](https://aka.ms/ai-beginners?WT.mc_id=academic-105485-koreyst) [![Cybersecurity per Principianti](https://img.shields.io/badge/Cybersecurity%20for%20Beginners-F97316?style=for-the-badge&labelColor=E5E7EB&color=F97316)](https://github.com/microsoft/Security-101?WT.mc_id=academic-96948-sayoung) -[![Web Dev per Principianti](https://img.shields.io/badge/Web%20Dev%20for%20Beginners-EC4899?style=for-the-badge&labelColor=E5E7EB&color=EC4899)](https://aka.ms/webdev-beginners?WT.mc_id=academic-105485-koreyst) -[![IoT for Beginners](https://img.shields.io/badge/IoT%20for%20Beginners-14B8A6?style=for-the-badge&labelColor=E5E7EB&color=14B8A6)](https://aka.ms/iot-beginners?WT.mc_id=academic-105485-koreyst) -[![XR Development for Beginners](https://img.shields.io/badge/XR%20Development%20for%20Beginners-38BDF8?style=for-the-badge&labelColor=E5E7EB&color=38BDF8)](https://github.com/microsoft/xr-development-for-beginners?WT.mc_id=academic-105485-koreyst) + +[![Sviluppo Web per Principianti](https://img.shields.io/badge/Web%20Dev%20for%20Beginners-EC4899?style=for-the-badge&labelColor=E5E7EB&color=EC4899)](https://aka.ms/webdev-beginners?WT.mc_id=academic-105485-koreyst) +[![IoT per Principianti](https://img.shields.io/badge/IoT%20for%20Beginners-14B8A6?style=for-the-badge&labelColor=E5E7EB&color=14B8A6)](https://aka.ms/iot-beginners?WT.mc_id=academic-105485-koreyst) +[![Sviluppo XR per Principianti](https://img.shields.io/badge/XR%20Development%20for%20Beginners-38BDF8?style=for-the-badge&labelColor=E5E7EB&color=38BDF8)](https://github.com/microsoft/xr-development-for-beginners?WT.mc_id=academic-105485-koreyst) --- ### Serie Copilot -[![Copilot for AI Paired Programming](https://img.shields.io/badge/Copilot%20for%20AI%20Paired%20Programming-FACC15?style=for-the-badge&labelColor=E5E7EB&color=FACC15)](https://aka.ms/GitHubCopilotAI?WT.mc_id=academic-105485-koreyst) -[![Copilot for C#/.NET](https://img.shields.io/badge/Copilot%20for%20C%23/.NET-FBBF24?style=for-the-badge&labelColor=E5E7EB&color=FBBF24)](https://github.com/microsoft/mastering-github-copilot-for-dotnet-csharp-developers?WT.mc_id=academic-105485-koreyst) -[![Copilot Adventure](https://img.shields.io/badge/Copilot%20Adventure-FDE68A?style=for-the-badge&labelColor=E5E7EB&color=FDE68A)](https://github.com/microsoft/CopilotAdventures?WT.mc_id=academic-105485-koreyst) +[![Copilot per Programmazione Affiancata AI](https://img.shields.io/badge/Copilot%20for%20AI%20Paired%20Programming-FACC15?style=for-the-badge&labelColor=E5E7EB&color=FACC15)](https://aka.ms/GitHubCopilotAI?WT.mc_id=academic-105485-koreyst) +[![Copilot per C#/.NET](https://img.shields.io/badge/Copilot%20for%20C%23/.NET-FBBF24?style=for-the-badge&labelColor=E5E7EB&color=FBBF24)](https://github.com/microsoft/mastering-github-copilot-for-dotnet-csharp-developers?WT.mc_id=academic-105485-koreyst) +[![Avventure con Copilot](https://img.shields.io/badge/Copilot%20Adventure-FDE68A?style=for-the-badge&labelColor=E5E7EB&color=FDE68A)](https://github.com/microsoft/CopilotAdventures?WT.mc_id=academic-105485-koreyst) -## Ricevere Aiuto +## Ottenere Aiuto -Se rimani bloccato o hai domande sulla creazione di app AI. Unisciti ad altri studenti e sviluppatori esperti nelle discussioni su MCP. È una comunità di supporto dove le domande sono benvenute e la conoscenza viene condivisa liberamente. +Se sei bloccato o hai domande sulla creazione di app AI. Unisciti ad altri studenti e sviluppatori esperti nelle discussioni su MCP. È una comunità di supporto dove le domande sono benvenute e la conoscenza viene condivisa liberamente. [![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) -Se hai feedback sul prodotto o incontri errori durante la creazione visita: +Se hai feedback sul prodotto o errori durante lo sviluppo visita: [![Microsoft Foundry Developer Forum](https://img.shields.io/badge/GitHub-Microsoft_Foundry_Developer_Forum-blue?style=for-the-badge&logo=github&color=000000&logoColor=fff)](https://aka.ms/foundry/forum) --- -**Disclaimer**: -Questo documento è stato tradotto utilizzando il servizio di traduzione automatica [Co-op Translator](https://github.com/Azure/co-op-translator). Pur impegnandoci per garantire l'accuratezza, si prega di notare che le traduzioni automatizzate possono contenere errori o inesattezze. Il documento originale nella sua lingua nativa deve essere considerato la fonte autorevole. Per informazioni critiche, si raccomanda una traduzione professionale effettuata da un traduttore umano. Non ci assumiamo alcuna responsabilità per eventuali malintesi o interpretazioni errate derivanti dall'uso di questa traduzione. +**Avvertenza**: +Questo documento è stato tradotto utilizzando il servizio di traduzione AI [Co-op Translator](https://github.com/Azure/co-op-translator). Sebbene ci impegniamo per garantire accuratezza, si prega di notare che le traduzioni automatiche possono contenere errori o inesattezze. Il documento originale nella sua lingua madre deve essere considerato la fonte autorevole. Per informazioni critiche, si raccomanda una traduzione professionale umana. Non siamo responsabili per eventuali fraintendimenti o interpretazioni errate derivanti dall’uso di questa traduzione. \ No newline at end of file diff --git a/translations/it/SECURITY.md b/translations/it/SECURITY.md index 2ff82c77..67a76102 100644 --- a/translations/it/SECURITY.md +++ b/translations/it/SECURITY.md @@ -1,12 +1,3 @@ - ## Sicurezza Microsoft prende molto seriamente la sicurezza dei propri prodotti software e servizi, inclusi tutti i repository di codice sorgente gestiti attraverso le nostre organizzazioni GitHub, che includono [Microsoft](https://github.com/Microsoft), [Azure](https://github.com/Azure), [DotNet](https://github.com/dotnet), [AspNet](https://github.com/aspnet) e [Xamarin](https://github.com/xamarin). diff --git a/translations/it/SUPPORT.md b/translations/it/SUPPORT.md index e3e3d8fe..ff7974be 100644 --- a/translations/it/SUPPORT.md +++ b/translations/it/SUPPORT.md @@ -1,12 +1,3 @@ - # Supporto ## Come segnalare problemi e ottenere aiuto diff --git a/translations/ja/.co-op-translator.json b/translations/ja/.co-op-translator.json new file mode 100644 index 00000000..29cff37e --- /dev/null +++ b/translations/ja/.co-op-translator.json @@ -0,0 +1,92 @@ +{ + "01-IntroToGenAI/README.md": { + "original_hash": "75bfb080ca725e8a9aa9c80cae25fba1", + "translation_date": "2025-07-29T08:32:15+00:00", + "source_file": "01-IntroToGenAI/README.md", + "language_code": "ja" + }, + "02-SetupDevEnvironment/README.md": { + "original_hash": "96a30d42b9751a3d4e4b20e28d29d459", + "translation_date": "2026-01-28T04:46:55+00:00", + "source_file": "02-SetupDevEnvironment/README.md", + "language_code": "ja" + }, + "02-SetupDevEnvironment/examples/basic-chat-azure/README.md": { + "original_hash": "efd82efe50711d7e257eb943151d682c", + "translation_date": "2025-07-27T13:36:37+00:00", + "source_file": "02-SetupDevEnvironment/examples/basic-chat-azure/README.md", + "language_code": "ja" + }, + "02-SetupDevEnvironment/getting-started-azure-openai.md": { + "original_hash": "bfdb4b4eadbee3a59ef742439f58326a", + "translation_date": "2025-07-27T12:58:34+00:00", + "source_file": "02-SetupDevEnvironment/getting-started-azure-openai.md", + "language_code": "ja" + }, + "03-CoreGenerativeAITechniques/README.md": { + "original_hash": "685f55cb07de19b52a30ce6e8b6d889e", + "translation_date": "2025-08-28T21:58:58+00:00", + "source_file": "03-CoreGenerativeAITechniques/README.md", + "language_code": "ja" + }, + "04-PracticalSamples/README.md": { + "original_hash": "14c0a61ecc1cd2012a9c129236dfdf71", + "translation_date": "2025-07-29T08:32:01+00:00", + "source_file": "04-PracticalSamples/README.md", + "language_code": "ja" + }, + "04-PracticalSamples/calculator/README.md": { + "original_hash": "b6c16b5514d524e415a94f6097ee7d4c", + "translation_date": "2025-09-18T15:27:07+00:00", + "source_file": "04-PracticalSamples/calculator/README.md", + "language_code": "ja" + }, + "04-PracticalSamples/foundrylocal/README.md": { + "original_hash": "f787307400de59adc25a1404466a35f3", + "translation_date": "2025-11-04T07:17:54+00:00", + "source_file": "04-PracticalSamples/foundrylocal/README.md", + "language_code": "ja" + }, + "04-PracticalSamples/petstory/README.md": { + "original_hash": "0cbf68d605615a1e602c832a24616859", + "translation_date": "2025-07-25T10:59:20+00:00", + "source_file": "04-PracticalSamples/petstory/README.md", + "language_code": "ja" + }, + "05-ResponsibleGenAI/README.md": { + "original_hash": "301c05c2f57e60a6950b8c665b8bdbba", + "translation_date": "2025-07-29T15:44:40+00:00", + "source_file": "05-ResponsibleGenAI/README.md", + "language_code": "ja" + }, + "AGENTS.md": { + "original_hash": "afc90918d008cf77fd1982691f681306", + "translation_date": "2025-10-03T08:30:59+00:00", + "source_file": "AGENTS.md", + "language_code": "ja" + }, + "CODE_OF_CONDUCT.md": { + "original_hash": "442b123d034f92f7c384d2bbd28f99f1", + "translation_date": "2025-07-21T15:58:37+00:00", + "source_file": "CODE_OF_CONDUCT.md", + "language_code": "ja" + }, + "README.md": { + "original_hash": "125a08948d881c95628094f4dd1fbd43", + "translation_date": "2026-01-29T15:30:22+00:00", + "source_file": "README.md", + "language_code": "ja" + }, + "SECURITY.md": { + "original_hash": "57f14126c1c6add76b3aef3844dfe4e3", + "translation_date": "2025-07-21T15:56:36+00:00", + "source_file": "SECURITY.md", + "language_code": "ja" + }, + "SUPPORT.md": { + "original_hash": "b8ef73cc49dec68e2c885ee9df545129", + "translation_date": "2025-07-21T15:59:46+00:00", + "source_file": "SUPPORT.md", + "language_code": "ja" + } +} \ No newline at end of file diff --git a/translations/ja/01-IntroToGenAI/README.md b/translations/ja/01-IntroToGenAI/README.md index b0645c9b..412ca245 100644 --- a/translations/ja/01-IntroToGenAI/README.md +++ b/translations/ja/01-IntroToGenAI/README.md @@ -1,12 +1,3 @@ - # ジェネレーティブAI入門 - Java版 ## 学べること diff --git a/translations/ja/02-SetupDevEnvironment/README.md b/translations/ja/02-SetupDevEnvironment/README.md index 973f54e3..96534178 100644 --- a/translations/ja/02-SetupDevEnvironment/README.md +++ b/translations/ja/02-SetupDevEnvironment/README.md @@ -1,187 +1,180 @@ - -# Java 向け Generative AI 開発環境のセットアップ +# Java向け生成AIの開発環境のセットアップ -> **クイックスタート**: 2 分でクラウドでコードを作成 - [GitHub Codespaces セットアップ](#option-a-github-codespaces-recommended) へジャンプ - ローカルインストールは不要で、GitHub モデルを使用します！ +> **クイックスタート**: 2分でクラウドでコーディング - [GitHub Codespacesセットアップ](../../../02-SetupDevEnvironment)へジャンプ - ローカルインストール不要でGitHubモデルを利用！ -> **Azure OpenAI にご興味がありますか?** 新しい Azure OpenAI リソースを作成する手順が記載されている [Azure OpenAI セットアップ ガイド](getting-started-azure-openai.md) をご覧ください。 +> **Azure OpenAIに興味がありますか？** 新しいAzure OpenAIリソースの作成手順については、[Azure OpenAIセットアップガイド](getting-started-azure-openai.md)をご覧ください。 -## 学習内容 +## 学べること -- AIアプリケーション用のJava開発環境を構築する -- 希望する開発環境（Codespacesを使用したクラウドファースト、ローカル開発コンテナ、または完全なローカル環境）を選択して構成する -- GitHub Modelsに接続して設定をテストする +- AIアプリケーション用のJava開発環境のセットアップ +- お好みの開発環境の選択と設定（Codespacesでのクラウドファースト、ローカルの開発コンテナ、もしくは完全なローカルセットアップ） +- GitHubモデルへの接続テスト ## 目次 -- [学習内容](#what-youll-learn) -- [概要](#introduction) -- [ステップ 1: 開発環境のセットアップ](#step-1-set-up-your-development-environment) -- [オプション A: GitHub Codespaces (推奨)](#option-a-github-codespaces-recommended) -- [オプション B: ローカル開発コンテナ](#option-b-local-dev-container) -- [オプション C: 既存のローカルインストールの使用](#option-c-use-your-existing-local-installation) -- [ステップ 2: GitHub 個人アクセストークンの作成](#step-2-create-a-github-personal-access-token) -- [ステップ 3: セットアップのテスト](#step-3-test-your-setup-with-the-github-models-example) -- [トラブルシューティング](#troubleshooting) -- [概要](#summary) -- [次のステップ](#next-steps) +- [学べること](../../../02-SetupDevEnvironment) +- [紹介](../../../02-SetupDevEnvironment) +- [ステップ1: 開発環境のセットアップ](../../../02-SetupDevEnvironment) + - [オプションA: GitHub Codespaces（推奨）](../../../02-SetupDevEnvironment) + - [オプションB: ローカル開発コンテナ](../../../02-SetupDevEnvironment) + - [オプションC: 既存のローカルインストールを使う](../../../02-SetupDevEnvironment) +- [ステップ2: GitHub個人アクセストークンの作成](../../../02-SetupDevEnvironment) +- [ステップ3: セットアップのテスト](../../../02-SetupDevEnvironment) +- [トラブルシューティング](../../../02-SetupDevEnvironment) +- [まとめ](../../../02-SetupDevEnvironment) +- [次のステップ](../../../02-SetupDevEnvironment) -## はじめに +## 紹介 -この章では、開発環境の設定手順を説明します。主な例として **GitHub Models** を使用します。これは無料で、GitHub アカウントだけで簡単に設定でき、クレジットカードも不要で、複数のモデルにアクセスして実験できるためです。 +この章では開発環境のセットアップ方法について説明します。主な例として **GitHub Models** を使用します。無料でGitHubアカウントだけで簡単にセットアップでき、クレジットカード不要で複数のモデルにアクセスして試すことができるためです。 -**ローカル環境での設定は不要です！** ブラウザで完全な開発環境を提供する GitHub Codespaces を使用すれば、すぐにコーディングを開始できます。 +**ローカルセットアップは不要！** GitHub Codespacesを使えばブラウザ上にフル開発環境が準備され、すぐにコーディングを始められます。 -スクリーンショット: GitHub モデル +Screenshot: GitHub Models -このコースでは、[**GitHub モデル**](https://github.com/marketplace?type=models) の使用をお勧めします。その理由は以下のとおりです。 -- **無料で** 開始可能 -- GitHub アカウントだけで**簡単に** セットアップ可能 -- **クレジットカードは不要** -- **複数のモデル** を実験に利用可能 +このコースでは [**GitHub Models**](https://github.com/marketplace?type=models) の利用を推奨します。理由は： +- **無料**で開始可能 +- GitHubアカウントのみで**簡単**にセットアップできる +- **クレジットカード不要** +- 複数のモデルを**試せる** -> **注**: このトレーニングで使用する GitHub モデルには、以下の無料制限があります。 -> - 1分あたり15リクエスト（1日あたり150リクエスト） -> - 1リクエストあたり約8,000ワードの受信、約4,000ワードの送信 -> - 同時リクエスト数 5 -> -> 本番環境でご利用の場合は、Azure アカウントを使用して Azure AI Foundry モデルにアップグレードしてください。コードを変更する必要はありません。 [Azure AI Foundry のドキュメント](https://learn.microsoft.com/azure/ai-foundry/foundry-models/how-to/quickstart-github-models)をご覧ください。 +> **注意**: このトレーニングで使うGitHub Modelsの無料制限： +> - 1分あたり15リクエスト（1日150リクエスト） +> - 1リクエストあたり約8,000語入力、約4,000語出力 +> - 同時リクエスト数5件 +> +> 本番用途の場合はAzure AI Foundry Modelsにアップグレードしてください。コードの変更は不要です。[Azure AI Foundryのドキュメント](https://learn.microsoft.com/azure/ai-foundry/foundry-models/how-to/quickstart-github-models)を参照。 -## ステップ 1: 開発環境のセットアップ +## ステップ1: 開発環境のセットアップ -セットアップ時間を最小限に抑え、この Java 向け Generative AI コースに必要なツールをすべて揃えるために、構成済みの開発コンテナーを作成しました。ご希望の開発アプローチを選択してください: +このJava向け生成AIコースのために必要なツールをすべて備えた事前構成済みの開発コンテナを用意しました。お好みの開発方法を選択してください。 -### 環境設定オプション: +### 環境セットアップオプション -#### オプション A: GitHub Codespaces (推奨) +#### オプションA: GitHub Codespaces（推奨） -**2 分でコーディングを開始 - ローカル環境の設定は不要です!** +**ローカルセットアップ不要で2分でコーディング開始！** -1. このリポジトリを GitHub アカウントにフォークします。 -> **注**: 基本設定を編集する場合は、[開発コンテナ構成](../.devcontainer/devcontainer.json) をご確認ください。 -2. **コード** → **コードスペース** タブ → **...** → **オプション付きで新規作成...** をクリックします。 -3. デフォルト設定を使用します。これにより、**開発コンテナ構成** が選択されます: **Generative AI Java 開発環境** このコース用に作成されたカスタム開発コンテナ -4. **コードスペースを作成** をクリックします。 -5. 環境の準備ができるまで約 2 分待ちます。 -6. [ステップ 2: GitHub トークンの作成](#step-2-create-a-github-personal-access-token) に進みます。 +1. このリポジトリをGitHubアカウントにフォークする + > **注意**: 基本設定を編集する場合は[開発コンテナ設定](../../../.devcontainer/devcontainer.json)を参照してください +2. **Code** → **Codespaces**タブ → **...** → **New with options...** をクリック +3. デフォルト設定を使うと、コース専用の **生成AI Java開発環境** devcontainer設定が選択される +4. **Create codespace** をクリック +5. ~2分待って環境が準備されるのを待つ +6. [ステップ2: GitHubトークンの作成](../../../02-SetupDevEnvironment)へ進む -スクリーンショット: Codespaces サブメニュー +Screenshot: Codespaces submenu -スクリーンショット: オプション付き新規作成 +Screenshot: New with options -スクリーンショット: Codespaces 作成オプション +Screenshot: Create codespace options -> **Codespaces のメリット**: -> - ローカルインストールは不要 -> - ブラウザ搭載のあらゆるデバイスで動作 -> - すべてのツールと依存関係が事前設定済み -> - 個人アカウントで月60時間の無料利用が可能 -> - すべての学習者に一貫した環境を提供 -#### オプション B: ローカル開発コンテナ +> **Codespacesの利点**: +> - ローカルインストール不要 +> - ブラウザが使えるどのデバイスでも動作 +> - 必要なツールと依存関係が事前セットアップ済み +> - 個人アカウントは月60時間無料 +> - すべての受講者で一貫した環境を提供 -**Docker を使用したローカル開発を希望する開発者向け** +#### オプションB: ローカル開発コンテナ -1. このリポジトリをフォークしてローカルマシンにクローンします -> **注**: 基本設定を編集する場合は、 [開発コンテナの構成](../.devcontainer/devcontainer.json) -2. [Docker Desktop](https://www.docker.com/products/docker-desktop/)と[VS Code](https://code.visualstudio.com/)をインストールします。 -3. VS Codeに[開発コンテナ拡張機能](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers)をインストールします。 -4. VS Codeでリポジトリフォルダを開きます。 -5. プロンプトが表示されたら、[**コンテナで再度開く**]をクリックします（またはCtrl+Shift+Pを押して[開発コンテナ: コンテナで再度開く]を選択します）。 -6. コンテナがビルドされて起動するまで待ちます。 -7. [ステップ2: GitHubトークンの作成](#step-2-create-a-github-per) に進みます。 +**Dockerによるローカル開発を好む方向け** -スクリーンショット: 開発コンテナのセットアップ +1. このリポジトリをフォークしてローカルにクローンする + > **注意**: 基本設定を編集する場合は[開発コンテナ設定](../../../.devcontainer/devcontainer.json)を参照してください +2. [Docker Desktop](https://www.docker.com/products/docker-desktop/)と[VS Code](https://code.visualstudio.com/)をインストール +3. VS Codeに[Dev Containers拡張機能](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers)をインストール +4. リポジトリフォルダーをVS Codeで開く +5. プロンプトが表示されたら**Reopen in Container**をクリック（または`Ctrl+Shift+P` → 「Dev Containers: Reopen in Container」） +6. コンテナのビルド・起動が完了するのを待つ +7. [ステップ2: GitHubトークンの作成](../../../02-SetupDevEnvironment)へ進む -スクリーンショット: 開発コンテナのビルド完了 +Screenshot: Dev container setup -#### オプション C: 既存のローカルインストールを使用する +Screenshot: Dev container build complete -**既存の Java 環境をお持ちの開発者向け** +#### オプションC: 既存のローカルインストールを使う -前提条件: -- [Java 21 以上](https://www.oracle.com/java/technologies/javase/jdk21-archive-downloads.html) -- [Maven 3.9 以上](https://maven.apache.org/download.cgi) -- [VS Code](https://code.visualstudio.com) またはお好みの IDE +**すでにJava環境がある開発者向け** -手順: -1. このリポジトリをローカルマシンにクローンします。 -2. IDE でプロジェクトを開きます。 -3. [手順 2: GitHub トークンの作成](#step-2-create-a-github-personal-access-token) +前提条件： +- [Java 21+](https://www.oracle.com/java/technologies/javase/jdk21-archive-downloads.html) +- [Maven 3.9+](https://maven.apache.org/download.cgi) +- [VS Code](https://code.visualstudio.com) またはお好みのIDE -> **プロのヒント**: 低スペックのマシンを使っているけれど、VS Code をローカルで使いたい場合は、GitHub Codespaces をご利用ください。ローカルの VS Code をクラウドホストの Codespace に接続することで、両方のメリットを享受できます。 +手順： +1. このリポジトリをローカルにクローン +2. IDEでプロジェクトを開く +3. [ステップ2: GitHubトークンの作成](../../../02-SetupDevEnvironment)へ進む -スクリーンショット: ローカルの devcontainer インスタンスを作成 +> **プロのヒント**: 低スペックマシンでローカルにVS Codeを使いたい場合は、GitHub Codespacesを利用しましょう。ローカルのVS CodeからクラウドホストされたCodespaceに接続でき、最良の環境が得られます。 -## ステップ 2: GitHub 個人アクセストークンの作成 +Screenshot: created local devcontainer instance -1. [GitHub 設定](https://github.com/settings/profile) に移動し、プロフィールメニューから [**設定**] を選択します。 -2. 左側のサイドバーで、[**開発者設定**] をクリックします (通常は一番下にあります)。 -3. [**個人アクセストークン**] の下にある 「**きめ細かなトークン**」をクリックします（または、こちらの直接リンク [リンク](https://github.com/settings/personal-access-tokens) にアクセスしてください）。 -4. 「**新しいトークンを生成**」をクリックします。 -5. 「トークン名」に、わかりやすい名前を入力します（例：`GenAI-Java-Course-Token`）。 -6. 有効期限を設定します（セキュリティのベストプラクティスとして、7日間を推奨）。 -7. 「リソースオーナー」で、ユーザーアカウントを選択します。 -8. 「リポジトリアクセス」で、GitHub モデルで使用するリポジトリを選択します（必要に応じて「すべてのリポジトリ」を選択することもできます）。 -9. 「アカウント権限」で、「**モデル**」を見つけて、「**読み取り専用**」に設定します。 -10. 「**トークンを生成**」をクリックします。 -11. **トークンをコピーして保存してください** – 二度と表示されなくなります！ -> **セキュリティのヒント**: アクセストークンには、必要最小限のスコープと、実用的な最短の有効期限を使用してください。 +## ステップ2: GitHub個人アクセストークンの作成 -## ステップ 3: GitHub Models サンプルで設定をテストする +1. [GitHub設定](https://github.com/settings/profile)にアクセスし、プロフィールメニューから**Settings**を選択。 +2. 左サイドバーの下部付近にある**Developer settings**をクリック。 +3. **Personal access tokens**の下の**Fine-grained tokens**をクリック（またはこの直接リンクを利用：[https://github.com/settings/personal-access-tokens](https://github.com/settings/personal-access-tokens)）。 +4. **Generate new token**をクリック。 +5. 「Token name」に分かりやすい名前を付ける（例：`GenAI-Java-Course-Token`）。 +6. 有効期限を設定（推奨：セキュリティのため7日間）。 +7. 「Resource owner」はご自身のユーザーアカウントを選択。 +8. 「Repository access」でGitHub Modelsで使いたいリポジトリ、または「All repositories」を選ぶ。 +9. 「Account permissions」で**Models**を探し、**Read-only**に設定。 +10. **Generate token**をクリック。 +11. 作成されたトークンを**必ずコピーし保存**してください。後で再度表示されません！ -開発環境の準備が整ったら、[`02-SetupDevEnvironment/examples/github-models`](./examples/github-models/) にあるサンプルアプリケーションで GitHub Models の統合をテストしましょう。 +> **セキュリティのヒント**: アクセストークンは最低限必要な権限と最短の有効期限を設定しましょう。 -1. 開発環境でターミナルを開きます。 -2. GitHub Models のサンプルに移動します。 -```bash -cd 02-SetupDevEnvironment/examples/github-models -``` -3. GitHub トークンを環境変数として設定します。 -```bash -# macOS/Linux -export GITHUB_TOKEN=your_token_here +## ステップ3: GitHubモデルの例でセットアップをテスト -# Windows (コマンドプロンプト) -set GITHUB_TOKEN=your_token_here +開発環境が準備できたら、[`02-SetupDevEnvironment/examples/github-models`](../../../02-SetupDevEnvironment/examples/github-models) の例でGitHub Models連携を試してみましょう。 -# Windows (PowerShell) -$env:GITHUB_TOKEN="your_token_here" -``` +1. 開発環境のターミナルを開く。 +2. GitHub Modelsのサンプルディレクトリへ移動： + ```bash + cd 02-SetupDevEnvironment/examples/github-models + ``` +3. 環境変数にGitHubトークンを設定： + ```bash + # macOS/Linux + export GITHUB_TOKEN=your_token_here + + # Windows（コマンドプロンプト） + set GITHUB_TOKEN=your_token_here + + # Windows（PowerShell） + $env:GITHUB_TOKEN="your_token_here" + ``` -4. アプリケーションを実行します。 -```bash -mvn compile exec:java -Dexec.mainClass="com.example.githubmodels.App" -``` +4. アプリケーションを実行： + ```bash + mvn compile exec:java -Dexec.mainClass="com.example.githubmodels.App" + ``` -次のような出力が表示されます。 +以下のような出力が表示されるはずです： ```text Using model: gpt-4.1-nano Sending request to GitHub Models... Response: Hello World! ``` -### サンプルコードの理解 +### 例のコードの理解 -まず、実行した内容を理解しましょう。`examples/github-models` にあるサンプルコードは、OpenAI Java SDK を使用して GitHub モデルに接続します。 +まず、実行した内容を理解しましょう。`examples/github-models`内の例はOpenAI Java SDKを使いGitHub Modelsに接続しています。 -**このコードの動作:** -- 個人アクセストークンを使用して GitHub モデルに **接続** します。 -- シンプルな「Say Hello World!」を **送信** します。 AI モデルへのメッセージ -- AI の応答を **受信** して表示します -- セットアップが正しく動作していることを **検証** します +**このコードの動作：** +- 個人アクセストークンを使ってGitHub Modelsに**接続** +- AIモデルに「Say Hello World!」という単純なメッセージを**送信** +- AIの応答を**受信**して表示 +- セットアップが正しく機能しているか**検証** -**キー依存関係** (`pom.xml` 内): +**重要な依存関係**（`pom.xml`内）： ```xml com.openai @@ -190,67 +183,71 @@ Response: Hello World! ``` -**メインコード** (`App.java`): +**メインコード**（`App.java`）： ```java -// Connect to GitHub Models using OpenAI Java SDK +// OpenAI Java SDKを使用してGitHubモデルに接続する OpenAIClient client = OpenAIOkHttpClient.builder() .apiKey(pat) .baseUrl("https://models.inference.ai.azure.com") .build(); -// Create chat completion request +// チャット補完リクエストを作成する ChatCompletionCreateParams params = ChatCompletionCreateParams.builder() .model(modelId) .addSystemMessage("You are a concise assistant.") .addUserMessage("Say Hello World!") .build(); -// Get AI response +// AIの応答を取得する ChatCompletion response = client.chat().completions().create(params); System.out.println("Response: " + response.choices().get(0).message().content().orElse("No response content")); ``` ## まとめ -素晴らしい！これですべての設定が完了しました。 +お疲れさまでした！これで以下が完了しています： -- AIモデルへのアクセスに必要な権限を持つGitHub Personal Access Tokenを作成しました。 -- Java開発環境（Codespaces、開発コンテナ、ローカル）を起動しました。 -- OpenAI Java SDKを使用してGitHub Modelsに接続しました。（無料AI開発環境） -- AIモデルと通信する簡単なサンプルで動作を確認しました。 +- AIモデルアクセスのための適切なGitHub個人アクセストークン作成 +- Java開発環境の構築（Codespaces、開発コンテナ、ローカルどれでもOK） +- OpenAI Java SDKでGitHub Modelsに接続し無料でAI開発可能 +- シンプルな例でAIモデルと通信し動作確認済み ## 次のステップ -[第3章：コアGenerative AIテクニック](../03-CoreGenerativeAITechniques/README.md) +[第3章: コアとなる生成AI技術](../03-CoreGenerativeAITechniques/README.md) ## トラブルシューティング -問題がありますか?よくある問題と解決策を以下に示します。 +問題が発生したら、よくある問題と解決策はこちら： -- **トークンが機能していませんか？** -- 余分なスペースを含めずにトークン全体をコピーしたことを確認してください。 -- トークンが環境変数として正しく設定されていることを確認してください。 -- トークンに適切な権限（モデル：読み取りと書き込み）が付与されていることを確認してください。 +- **トークンが動作しない？** + - トークンを余計なスペースなしで正確にコピーしたか確認 + - 環境変数に正しく設定されているか再確認 + - トークンに正しい権限（Models: Read-only）があるかチェック -- **Maven が見つかりませんか？** -- 開発コンテナ/Codespaces を使用する場合は、Maven が事前にインストールされている必要があります。 -- ローカルセットアップの場合は、Java 21 以上と Maven 3.9 以上がインストールされていることを確認してください。 -- インストールを確認するには、`mvn --version` を実行してみてください。 +- **Mavenが見つからない？** + - devコンテナやCodespacesならMavenは事前インストール済み + - ローカルセットアップの場合はJava 21+とMaven 3.9+がインストール済みか確認 + - `mvn --version`でバージョン確認 -- **接続に問題がありますか？** -- インターネット接続を確認してください。 -- ネットワークから GitHub にアクセスできることを確認してください。 -- GitHub Models エンドポイントをブロックするファイアウォールの内側にいないことを確認してください。 +- **接続に問題？** + - インターネット接続を確認 + - GitHubへアクセス可能かネットワークをチェック + - GitHub Modelsエンドポイントをブロックするファイアウォールがないか確認 -- **開発コンテナが起動していませんか？** -- Docker Desktop が実行されていることを確認してください（ローカル開発の場合）。 -- コンテナを再構築してみてください。`Ctrl+Shift+P` → "開発コンテナ：コンテナの再構築" +- **Devコンテナが起動しない？** + - Docker Desktopが起動しているか確認（ローカル開発時） + - コンテナの再ビルドを試す：`Ctrl+Shift+P` → 「Dev Containers: Rebuild Container」 -- **アプリケーションのコンパイルエラーですか？** -- 正しい場所にいることを確認してください。ディレクトリ: `02-SetupDevEnvironment/examples/github-models` -- クリーンアップとリビルドをお試しください: `mvn clean compile` +- **アプリケーションのコンパイルエラー？** + - ディレクトリが正しいか確認：`02-SetupDevEnvironment/examples/github-models` + - クリーン＆ビルドを試す：`mvn clean compile` -> **ヘルプが必要ですか？**: 問題が解決しない場合は、リポジトリで問題を開いてください。サポートいたします。 +> **ヘルプが必要ですか？**：問題が解決しない場合はリポジトリにIssueを開いてください。サポートします。 --- + +**免責事項**： +本書類はAI翻訳サービス「Co-op Translator」（https://github.com/Azure/co-op-translator）を使用して翻訳されました。正確性を期しておりますが、自動翻訳には誤りや不正確な箇所が含まれる可能性があることをご了承ください。原文の言語による文書が正式な情報源とみなされます。重要な内容については、専門の人間による翻訳を推奨します。本翻訳の利用による誤解や誤訳に関して当方は一切の責任を負いかねます。 + \ No newline at end of file diff --git a/translations/ja/02-SetupDevEnvironment/examples/basic-chat-azure/README.md b/translations/ja/02-SetupDevEnvironment/examples/basic-chat-azure/README.md index 64a81bbf..0aa57f4a 100644 --- a/translations/ja/02-SetupDevEnvironment/examples/basic-chat-azure/README.md +++ b/translations/ja/02-SetupDevEnvironment/examples/basic-chat-azure/README.md @@ -1,12 +1,3 @@ - # Azure OpenAIとの基本的なチャット - エンドツーエンドの例 この例では、Azure OpenAIに接続し、セットアップをテストするシンプルなSpring Bootアプリケーションを作成する方法を示します。 diff --git a/translations/ja/02-SetupDevEnvironment/getting-started-azure-openai.md b/translations/ja/02-SetupDevEnvironment/getting-started-azure-openai.md index ec4d9b31..a0f620ae 100644 --- a/translations/ja/02-SetupDevEnvironment/getting-started-azure-openai.md +++ b/translations/ja/02-SetupDevEnvironment/getting-started-azure-openai.md @@ -1,12 +1,3 @@ - # Azure OpenAI 開発環境のセットアップ > **クイックスタート**: このガイドは Azure OpenAI のセットアップ用です。無料モデルで即開始したい場合は [GitHub Models with Codespaces](./README.md#quick-start-cloud) を使用してください。 diff --git a/translations/ja/03-CoreGenerativeAITechniques/README.md b/translations/ja/03-CoreGenerativeAITechniques/README.md index f7b73cd8..99f366f7 100644 --- a/translations/ja/03-CoreGenerativeAITechniques/README.md +++ b/translations/ja/03-CoreGenerativeAITechniques/README.md @@ -1,12 +1,3 @@ - # コア生成AI技術チュートリアル ## 目次 diff --git a/translations/ja/04-PracticalSamples/README.md b/translations/ja/04-PracticalSamples/README.md index 6097dff1..a18711e7 100644 --- a/translations/ja/04-PracticalSamples/README.md +++ b/translations/ja/04-PracticalSamples/README.md @@ -1,12 +1,3 @@ - # 実践的な応用とプロジェクト ## 学べること diff --git a/translations/ja/04-PracticalSamples/calculator/README.md b/translations/ja/04-PracticalSamples/calculator/README.md index 315c6afa..0fca90e6 100644 --- a/translations/ja/04-PracticalSamples/calculator/README.md +++ b/translations/ja/04-PracticalSamples/calculator/README.md @@ -1,12 +1,3 @@ - # MCP計算機チュートリアル初心者向け ## 目次 diff --git a/translations/ja/04-PracticalSamples/foundrylocal/README.md b/translations/ja/04-PracticalSamples/foundrylocal/README.md index 198dd6c0..7605ce0d 100644 --- a/translations/ja/04-PracticalSamples/foundrylocal/README.md +++ b/translations/ja/04-PracticalSamples/foundrylocal/README.md @@ -1,12 +1,3 @@ - # Foundry Local Spring Boot チュートリアル ## 目次 diff --git a/translations/ja/04-PracticalSamples/petstory/README.md b/translations/ja/04-PracticalSamples/petstory/README.md index 77754451..d21633e0 100644 --- a/translations/ja/04-PracticalSamples/petstory/README.md +++ b/translations/ja/04-PracticalSamples/petstory/README.md @@ -1,12 +1,3 @@ - # ペットストーリー生成チュートリアル（初心者向け） ## 目次 diff --git a/translations/ja/05-ResponsibleGenAI/README.md b/translations/ja/05-ResponsibleGenAI/README.md index f67407d2..b9f0f54f 100644 --- a/translations/ja/05-ResponsibleGenAI/README.md +++ b/translations/ja/05-ResponsibleGenAI/README.md @@ -1,12 +1,3 @@ - # 責任ある生成AI ## 学べること diff --git a/translations/ja/AGENTS.md b/translations/ja/AGENTS.md index 285eb45a..a4bcbbec 100644 --- a/translations/ja/AGENTS.md +++ b/translations/ja/AGENTS.md @@ -1,12 +1,3 @@ - # AGENTS.md ## プロジェクト概要 diff --git a/translations/ja/CODE_OF_CONDUCT.md b/translations/ja/CODE_OF_CONDUCT.md index 17f7f3d8..40c71ca5 100644 --- a/translations/ja/CODE_OF_CONDUCT.md +++ b/translations/ja/CODE_OF_CONDUCT.md @@ -1,12 +1,3 @@ - # マイクロソフト オープンソース行動規範 このプロジェクトは、[マイクロソフト オープンソース行動規範](https://opensource.microsoft.com/codeofconduct/)を採用しています。 diff --git a/translations/ja/README.md b/translations/ja/README.md index c099abe8..7d85cfe4 100644 --- a/translations/ja/README.md +++ b/translations/ja/README.md @@ -1,141 +1,133 @@ - -# ジェネレーティブAI入門 - Javaエディション +# 初心者のための生成AI - Java版 [![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) -![ジェネレーティブAI入門 - Javaエディション](../../translated_images/ja/beg-genai-series.8b48be9951cc574c.webp) +![初心者のための生成AI - Java版](../../translated_images/ja/beg-genai-series.8b48be9951cc574c.webp) -**所要時間**: ワークショップ全体はローカル環境設定なしでオンラインで完了できます。環境設定には2分、サンプルの探索には探索の深さに応じて1〜3時間かかります。 +**所要時間**: ワークショップ全体はローカルセットアップなしでオンラインで完了できます。環境セットアップに2分、サンプルの探索に1〜3時間（探索の深さによる）かかります。 > **クイックスタート** -1. このリポジトリをあなたのGitHubアカウントにフォークしてください -2. **Code** → **Codespaces** タブ → **...** → **New with options...** をクリック -3. デフォルト設定を使用してください — これによりこのコース用に作成された開発コンテナが選択されます +1. このリポジトリをあなたのGitHubアカウントにフォークします +2. **Code** → **Codespaces** タブ → **...** → **新規オプションで作成...** をクリック +3. デフォルトを使用します – これにより本コース用に作成された開発コンテナが選択されます 4. **Create codespace** をクリック -5. 環境が準備されるまで約2分待ちます -6. 直接 [最初の例](./02-SetupDevEnvironment/README.md#step-2-create-a-github-personal-access-token) にジャンプできます +5. 環境の準備が整うまで約2分待ちます +6. 直接 [最初の例へ](./02-SetupDevEnvironment/README.md#step-2-create-a-github-personal-access-token) ジャンプ -> **ローカルでクローンしたいですか？** +> **ローカルでクローンする場合？** > -> このリポジトリには50以上の言語翻訳が含まれており、ダウンロードサイズが大幅に増加します。翻訳なしでクローンするには、スパースチェックアウトを使用してください： +> 本リポジトリには50以上の言語翻訳が含まれており、ダウンロードサイズが大幅に増加します。翻訳なしでクローンするには、スパースチェックアウトを使ってください： > ```bash > git clone --filter=blob:none --sparse https://github.com/microsoft/Generative-AI-for-beginners-java.git > cd Generative-AI-for-beginners-java > git sparse-checkout set --no-cone '/*' '!translations' '!translated_images' > ``` -> これにより、コース完了に必要なすべてがより高速なダウンロードで得られます。 +> これによりコース完了に必要なものだけが高速にダウンロードできます。 ## 多言語サポート -### GitHub Actionsでサポート（自動かつ常に最新） +### GitHubアクションによるサポート（自動＆常に最新） -[アラビア語](../ar/README.md) | [ベンガル語](../bn/README.md) | [ブルガリア語](../bg/README.md) | [ビルマ語 (ミャンマー)](../my/README.md) | [中国語（簡体）](../zh/README.md) | [中国語（繁体・香港）](../hk/README.md) | [中国語（繁体・マカオ）](../mo/README.md) | [中国語（繁体・台湾）](../tw/README.md) | [クロアチア語](../hr/README.md) | [チェコ語](../cs/README.md) | [デンマーク語](../da/README.md) | [オランダ語](../nl/README.md) | [エストニア語](../et/README.md) | [フィンランド語](../fi/README.md) | [フランス語](../fr/README.md) | [ドイツ語](../de/README.md) | [ギリシャ語](../el/README.md) | [ヘブライ語](../he/README.md) | [ヒンディー語](../hi/README.md) | [ハンガリー語](../hu/README.md) | [インドネシア語](../id/README.md) | [イタリア語](../it/README.md) | [日本語](./README.md) | [カンナダ語](../kn/README.md) | [韓国語](../ko/README.md) | [リトアニア語](../lt/README.md) | [マレー語](../ms/README.md) | [マラヤーラム語](../ml/README.md) | [マラーティー語](../mr/README.md) | [ネパール語](../ne/README.md) | [ナイジェリア・ピジン語](../pcm/README.md) | [ノルウェー語](../no/README.md) | [ペルシア語（ファルシー）](../fa/README.md) | [ポーランド語](../pl/README.md) | [ポルトガル語（ブラジル）](../br/README.md) | [ポルトガル語（ポルトガル）](../pt/README.md) | [パンジャブ語（グルムキー）](../pa/README.md) | [ルーマニア語](../ro/README.md) | [ロシア語](../ru/README.md) | [セルビア語（キリル）](../sr/README.md) | [スロバキア語](../sk/README.md) | [スロベニア語](../sl/README.md) | [スペイン語](../es/README.md) | [スワヒリ語](../sw/README.md) | [スウェーデン語](../sv/README.md) | [タガログ語（フィリピン）](../tl/README.md) | [タミル語](../ta/README.md) | [テルグ語](../te/README.md) | [タイ語](../th/README.md) | [トルコ語](../tr/README.md) | [ウクライナ語](../uk/README.md) | [ウルドゥー語](../ur/README.md) | [ベトナム語](../vi/README.md) +[アラビア語](../ar/README.md) | [ベンガル語](../bn/README.md) | [ブルガリア語](../bg/README.md) | [ビルマ語（ミャンマー）](../my/README.md) | [中国語（簡体）](../zh-CN/README.md) | [中国語（繁体、香港）](../zh-HK/README.md) | [中国語（繁体、マカオ）](../zh-MO/README.md) | [中国語（繁体、台湾）](../zh-TW/README.md) | [クロアチア語](../hr/README.md) | [チェコ語](../cs/README.md) | [デンマーク語](../da/README.md) | [オランダ語](../nl/README.md) | [エストニア語](../et/README.md) | [フィンランド語](../fi/README.md) | [フランス語](../fr/README.md) | [ドイツ語](../de/README.md) | [ギリシャ語](../el/README.md) | [ヘブライ語](../he/README.md) | [ヒンディー語](../hi/README.md) | [ハンガリー語](../hu/README.md) | [インドネシア語](../id/README.md) | [イタリア語](../it/README.md) | [日本語](./README.md) | [カンナダ語](../kn/README.md) | [韓国語](../ko/README.md) | [リトアニア語](../lt/README.md) | [マレー語](../ms/README.md) | [マラヤーラム語](../ml/README.md) | [マラーティー語](../mr/README.md) | [ネパール語](../ne/README.md) | [ナイジェリアピジン語](../pcm/README.md) | [ノルウェー語](../no/README.md) | [ペルシャ語（ファルシ）](../fa/README.md) | [ポーランド語](../pl/README.md) | [ポルトガル語（ブラジル）](../pt-BR/README.md) | [ポルトガル語（ポルトガル）](../pt-PT/README.md) | [パンジャブ語（グルムキー）](../pa/README.md) | [ルーマニア語](../ro/README.md) | [ロシア語](../ru/README.md) | [セルビア語（キリル）](../sr/README.md) | [スロバキア語](../sk/README.md) | [スロベニア語](../sl/README.md) | [スペイン語](../es/README.md) | [スワヒリ語](../sw/README.md) | [スウェーデン語](../sv/README.md) | [タガログ語（フィリピン）](../tl/README.md) | [タミル語](../ta/README.md) | [テルグ語](../te/README.md) | [タイ語](../th/README.md) | [トルコ語](../tr/README.md) | [ウクライナ語](../uk/README.md) | [ウルドゥー語](../ur/README.md) | [ベトナム語](../vi/README.md) -> **ローカルでクローンしたいですか？** +> **ローカルでクローンする場合？** -> このリポジトリには50以上の言語翻訳が含まれており、ダウンロードサイズが大幅に増加します。翻訳なしでクローンするには、スパースチェックアウトを使用してください： +> 本リポジトリには50以上の言語翻訳が含まれており、ダウンロードサイズが大幅に増加します。翻訳なしでクローンするには、スパースチェックアウトを使ってください： > ```bash > git clone --filter=blob:none --sparse https://github.com/microsoft/Generative-AI-for-beginners-java.git > cd Generative-AI-for-beginners-java > git sparse-checkout set --no-cone '/*' '!translations' '!translated_images' > ``` -> これにより、コース完了に必要なすべてがより高速なダウンロードで得られます。 +> これによりコース完了に必要なものだけが高速にダウンロードできます。 -## コースの構成と学習経路 +## コース構成と学習パス -### **第1章: ジェネレーティブAIの導入** +### **第1章：生成AI入門** - **コアコンセプト**: 大規模言語モデル、トークン、埋め込み、AIの能力の理解 -- **Java AIエコシステム**: Spring AI と OpenAI SDKの概要 +- **JavaのAIエコシステム**: Spring AI と OpenAI SDK の概要 - **モデルコンテキストプロトコル**: MCPの紹介とAIエージェント間通信における役割 -- **実用例**: チャットボットやコンテンツ生成などの現実的シナリオ -- **[→ 第1章を開始](./01-IntroToGenAI/README.md)** +- **実践的応用**: チャットボットやコンテンツ生成などの実例 +- **[→ 第1章を始める](./01-IntroToGenAI/README.md)** -### **第2章: 開発環境の設定** +### **第2章：開発環境セットアップ** - **マルチプロバイダー設定**: GitHubモデル、Azure OpenAI、OpenAI Java SDKの統合設定 -- **Spring Boot + Spring AI**: エンタープライズAIアプリケーション開発のベストプラクティス -- **GitHubモデル**: プロトタイピングや学習用の無料AIモデルアクセス（クレジットカード不要） +- **Spring Boot + Spring AI**: エンタープライズAIアプリ開発のベストプラクティス +- **GitHubモデル**: プロトタイプと学習のための無料AIモデルアクセス（クレジットカード不要） - **開発ツール**: Dockerコンテナ、VS Code、GitHub Codespacesの設定 -- **[→ 第2章を開始](./02-SetupDevEnvironment/README.md)** +- **[→ 第2章を始める](./02-SetupDevEnvironment/README.md)** -### **第3章: ジェネレーティブAIのコア技術** -- **プロンプトエンジニアリング**: 最適なAIモデル応答の技法 -- **埋め込みとベクトル処理**: セマンティック検索および類似性マッチングの実装 -- **情報検索拡張生成（RAG）**: AIと独自データソースの組み合わせ +### **第3章：生成AIの核心技術** +- **プロンプトエンジニアリング**: 最適なAIモデル応答の技術 +- **埋め込みとベクトル操作**: セマンティック検索と類似性マッチングの実装 +- **情報取得強化生成（RAG）**: 自身のデータソースとAIの結合 - **関数呼び出し**: カスタムツールやプラグインによるAI機能拡張 -- **[→ 第3章を開始](./03-CoreGenerativeAITechniques/README.md)** +- **[→ 第3章を始める](./03-CoreGenerativeAITechniques/README.md)** -### **第4章: 実用的応用とプロジェクト** -- **ペットストーリー生成器** (`petstory/`): GitHubモデルを使った創造的コンテンツ生成 -- **Foundryローカルデモ** (`foundrylocal/`): OpenAI Java SDKを使ったローカルAIモデル統合 -- **MCP計算機サービス** (`calculator/`): Spring AIを使用した基礎的なモデルコンテキストプロトコル実装 -- **[→ 第4章を開始](./04-PracticalSamples/README.md)** +### **第4章：実践的応用とプロジェクト** +- **ペットストーリージェネレーター** (`petstory/`): GitHubモデルによる創造的コンテンツ生成 +- **Foundryローカルデモ** (`foundrylocal/`): OpenAI Java SDKとのローカルAIモデル統合 +- **MCP計算サービス** (`calculator/`): Spring AIを用いた基本的なモデルコンテキストプロトコル実装 +- **[→ 第4章を始める](./04-PracticalSamples/README.md)** -### **第5章: 責任あるAI開発** -- **GitHubモデルの安全性**: 組み込みコンテンツフィルタリングと安全機構（ハードブロックおよびソフト拒否）をテスト -- **責任あるAIデモ**: 最新のAI安全システムの実践例 -- **ベストプラクティス**: 倫理的なAI開発と展開のための必須ガイドライン -- **[→ 第5章を開始](./05-ResponsibleGenAI/README.md)** +### **第5章：責任あるAI開発** +- **GitHubモデルの安全性**: 組み込みのコンテンツフィルタリングと安全機構のテスト（ハードブロックとソフト拒否） +- **責任あるAIデモ**: 現代のAI安全システムが実際にどのように機能するかのハンズオン例 +- **ベストプラクティス**: 倫理的なAI開発と展開のための基本ガイドライン +- **[→ 第5章を始める](./05-ResponsibleGenAI/README.md)** ## 追加リソース ### LangChain -[![LangChain4j 入門](https://img.shields.io/badge/LangChain4j%20for%20Beginners-22C55E?style=for-the-badge&&labelColor=E5E7EB&color=0553D6)](https://aka.ms/langchain4j-for-beginners) -[![LangChain.js 入門](https://img.shields.io/badge/LangChain.js%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=0553D6)](https://aka.ms/langchainjs-for-beginners?WT.mc_id=m365-94501-dwahlin) +[![初心者のためのLangChain4j](https://img.shields.io/badge/LangChain4j%20for%20Beginners-22C55E?style=for-the-badge&&labelColor=E5E7EB&color=0553D6)](https://aka.ms/langchain4j-for-beginners) +[![初心者のためのLangChain.js](https://img.shields.io/badge/LangChain.js%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=0553D6)](https://aka.ms/langchainjs-for-beginners?WT.mc_id=m365-94501-dwahlin) --- ### Azure / Edge / MCP / エージェント -[![AZD 入門](https://img.shields.io/badge/AZD%20for%20Beginners-0078D4?style=for-the-badge&labelColor=E5E7EB&color=0078D4)](https://github.com/microsoft/AZD-for-beginners?WT.mc_id=academic-105485-koreyst) -[![Edge AI 入門](https://img.shields.io/badge/Edge%20AI%20for%20Beginners-00B8E4?style=for-the-badge&labelColor=E5E7EB&color=00B8E4)](https://github.com/microsoft/edgeai-for-beginners?WT.mc_id=academic-105485-koreyst) -[![MCP 入門](https://img.shields.io/badge/MCP%20for%20Beginners-009688?style=for-the-badge&labelColor=E5E7EB&color=009688)](https://github.com/microsoft/mcp-for-beginners?WT.mc_id=academic-105485-koreyst) -[![AIエージェント 入門](https://img.shields.io/badge/AI%20Agents%20for%20Beginners-00C49A?style=for-the-badge&labelColor=E5E7EB&color=00C49A)](https://github.com/microsoft/ai-agents-for-beginners?WT.mc_id=academic-105485-koreyst) +[![初心者のためのAZD](https://img.shields.io/badge/AZD%20for%20Beginners-0078D4?style=for-the-badge&labelColor=E5E7EB&color=0078D4)](https://github.com/microsoft/AZD-for-beginners?WT.mc_id=academic-105485-koreyst) +[![初心者のためのEdge AI](https://img.shields.io/badge/Edge%20AI%20for%20Beginners-00B8E4?style=for-the-badge&labelColor=E5E7EB&color=00B8E4)](https://github.com/microsoft/edgeai-for-beginners?WT.mc_id=academic-105485-koreyst) +[![初心者のためのMCP](https://img.shields.io/badge/MCP%20for%20Beginners-009688?style=for-the-badge&labelColor=E5E7EB&color=009688)](https://github.com/microsoft/mcp-for-beginners?WT.mc_id=academic-105485-koreyst) +[![初心者のためのAIエージェント](https://img.shields.io/badge/AI%20Agents%20for%20Beginners-00C49A?style=for-the-badge&labelColor=E5E7EB&color=00C49A)](https://github.com/microsoft/ai-agents-for-beginners?WT.mc_id=academic-105485-koreyst) --- - -### ジェネレーティブAIシリーズ -[![ジェネレーティブAI入門](https://img.shields.io/badge/Generative%20AI%20for%20Beginners-8B5CF6?style=for-the-badge&labelColor=E5E7EB&color=8B5CF6)](https://github.com/microsoft/generative-ai-for-beginners?WT.mc_id=academic-105485-koreyst) -[![ジェネレーティブAI (.NET)](https://img.shields.io/badge/Generative%20AI%20(.NET)-9333EA?style=for-the-badge&labelColor=E5E7EB&color=9333EA)](https://github.com/microsoft/Generative-AI-for-beginners-dotnet?WT.mc_id=academic-105485-koreyst) -[![ジェネレーティブAI (Java)](https://img.shields.io/badge/Generative%20AI%20(Java)-C084FC?style=for-the-badge&labelColor=E5E7EB&color=C084FC)](https://github.com/microsoft/generative-ai-for-beginners-java?WT.mc_id=academic-105485-koreyst) -[![ジェネレーティブAI (JavaScript)](https://img.shields.io/badge/Generative%20AI%20(JavaScript)-E879F9?style=for-the-badge&labelColor=E5E7EB&color=E879F9)](https://github.com/microsoft/generative-ai-with-javascript?WT.mc_id=academic-105485-koreyst) + +### 生成AIシリーズ +[![初心者のための生成AI](https://img.shields.io/badge/Generative%20AI%20for%20Beginners-8B5CF6?style=for-the-badge&labelColor=E5E7EB&color=8B5CF6)](https://github.com/microsoft/generative-ai-for-beginners?WT.mc_id=academic-105485-koreyst) +[![生成AI (.NET)](https://img.shields.io/badge/Generative%20AI%20(.NET)-9333EA?style=for-the-badge&labelColor=E5E7EB&color=9333EA)](https://github.com/microsoft/Generative-AI-for-beginners-dotnet?WT.mc_id=academic-105485-koreyst) +[![生成AI (Java)](https://img.shields.io/badge/Generative%20AI%20(Java)-C084FC?style=for-the-badge&labelColor=E5E7EB&color=C084FC)](https://github.com/microsoft/generative-ai-for-beginners-java?WT.mc_id=academic-105485-koreyst) +[![生成AI (JavaScript)](https://img.shields.io/badge/Generative%20AI%20(JavaScript)-E879F9?style=for-the-badge&labelColor=E5E7EB&color=E879F9)](https://github.com/microsoft/generative-ai-with-javascript?WT.mc_id=academic-105485-koreyst) --- - -### コアラーニング -[![初心者向け機械学習](https://img.shields.io/badge/ML%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=22C55E)](https://aka.ms/ml-beginners?WT.mc_id=academic-105485-koreyst) -[![初心者向けデータサイエンス](https://img.shields.io/badge/Data%20Science%20for%20Beginners-84CC16?style=for-the-badge&labelColor=E5E7EB&color=84CC16)](https://aka.ms/datascience-beginners?WT.mc_id=academic-105485-koreyst) -[![初心者向けAI](https://img.shields.io/badge/AI%20for%20Beginners-A3E635?style=for-the-badge&labelColor=E5E7EB&color=A3E635)](https://aka.ms/ai-beginners?WT.mc_id=academic-105485-koreyst) -[![初心者向けサイバーセキュリティ](https://img.shields.io/badge/Cybersecurity%20for%20Beginners-F97316?style=for-the-badge&labelColor=E5E7EB&color=F97316)](https://github.com/microsoft/Security-101?WT.mc_id=academic-96948-sayoung) -[![初心者向けWeb開発](https://img.shields.io/badge/Web%20Dev%20for%20Beginners-EC4899?style=for-the-badge&labelColor=E5E7EB&color=EC4899)](https://aka.ms/webdev-beginners?WT.mc_id=academic-105485-koreyst) + +### コア学習 +[![初心者のためのML](https://img.shields.io/badge/ML%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=22C55E)](https://aka.ms/ml-beginners?WT.mc_id=academic-105485-koreyst) +[![初心者のためのデータサイエンス](https://img.shields.io/badge/Data%20Science%20for%20Beginners-84CC16?style=for-the-badge&labelColor=E5E7EB&color=84CC16)](https://aka.ms/datascience-beginners?WT.mc_id=academic-105485-koreyst) +[![初心者のためのAI](https://img.shields.io/badge/AI%20for%20Beginners-A3E635?style=for-the-badge&labelColor=E5E7EB&color=A3E635)](https://aka.ms/ai-beginners?WT.mc_id=academic-105485-koreyst) +[![初心者のためのサイバーセキュリティ](https://img.shields.io/badge/Cybersecurity%20for%20Beginners-F97316?style=for-the-badge&labelColor=E5E7EB&color=F97316)](https://github.com/microsoft/Security-101?WT.mc_id=academic-96948-sayoung) + +[![Web Dev for Beginners](https://img.shields.io/badge/Web%20Dev%20for%20Beginners-EC4899?style=for-the-badge&labelColor=E5E7EB&color=EC4899)](https://aka.ms/webdev-beginners?WT.mc_id=academic-105485-koreyst) [![IoT for Beginners](https://img.shields.io/badge/IoT%20for%20Beginners-14B8A6?style=for-the-badge&labelColor=E5E7EB&color=14B8A6)](https://aka.ms/iot-beginners?WT.mc_id=academic-105485-koreyst) [![XR Development for Beginners](https://img.shields.io/badge/XR%20Development%20for%20Beginners-38BDF8?style=for-the-badge&labelColor=E5E7EB&color=38BDF8)](https://github.com/microsoft/xr-development-for-beginners?WT.mc_id=academic-105485-koreyst) --- - + ### Copilot シリーズ [![Copilot for AI Paired Programming](https://img.shields.io/badge/Copilot%20for%20AI%20Paired%20Programming-FACC15?style=for-the-badge&labelColor=E5E7EB&color=FACC15)](https://aka.ms/GitHubCopilotAI?WT.mc_id=academic-105485-koreyst) [![Copilot for C#/.NET](https://img.shields.io/badge/Copilot%20for%20C%23/.NET-FBBF24?style=for-the-badge&labelColor=E5E7EB&color=FBBF24)](https://github.com/microsoft/mastering-github-copilot-for-dotnet-csharp-developers?WT.mc_id=academic-105485-koreyst) [![Copilot Adventure](https://img.shields.io/badge/Copilot%20Adventure-FDE68A?style=for-the-badge&labelColor=E5E7EB&color=FDE68A)](https://github.com/microsoft/CopilotAdventures?WT.mc_id=academic-105485-koreyst) -## ヘルプを得るには +## ヘルプを得る -AIアプリの構築でつまずいたり質問がある場合は、学習者や経験豊富な開発者と共にMCPについてのディスカッションに参加してください。質問が歓迎され、知識が自由に共有されるサポートコミュニティです。 +AIアプリの構築で行き詰まったり質問がある場合は、MCPに関する議論に参加してください。ここは質問が歓迎され、知識が自由に共有されるサポート力のあるコミュニティです。 [![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) -製品のフィードバックや構築中のエラーについては、以下を訪問してください： +製品のフィードバックや構築中のエラーがある場合は、以下にアクセスしてください: [![Microsoft Foundry Developer Forum](https://img.shields.io/badge/GitHub-Microsoft_Foundry_Developer_Forum-blue?style=for-the-badge&logo=github&color=000000&logoColor=fff)](https://aka.ms/foundry/forum) @@ -143,5 +135,5 @@ AIアプリの構築でつまずいたり質問がある場合は、学習者や **免責事項**： -本書類はAI翻訳サービス「Co-op Translator」（https://github.com/Azure/co-op-translator）を使用して翻訳されています。正確性の向上に努めておりますが、自動翻訳には誤りや不正確な箇所が含まれる可能性があります。正式な情報は原文（母国語文書）を公式な情報源としてご参照ください。重要な情報に関しては、専門の人間翻訳者による翻訳を推奨します。本翻訳の利用により生じたいかなる誤解や誤訳についても、当方は一切の責任を負いかねます。 +本書類はAI翻訳サービス「Co-op Translator」（https://github.com/Azure/co-op-translator）を用いて翻訳されました。正確性には努めておりますが、自動翻訳には誤りや不正確な箇所が含まれる場合があります。原文の元の言語版が権威ある正式な情報源とみなされます。重要な情報については、専門の人間による翻訳を推奨します。本翻訳の利用により生じた誤解や誤訳について、当方は一切の責任を負いかねます。 \ No newline at end of file diff --git a/translations/ja/SECURITY.md b/translations/ja/SECURITY.md index 9d9d5a81..2b92422c 100644 --- a/translations/ja/SECURITY.md +++ b/translations/ja/SECURITY.md @@ -1,12 +1,3 @@ - ## セキュリティ Microsoftは、ソフトウェア製品やサービスのセキュリティを非常に重要視しています。これには、[Microsoft](https://github.com/Microsoft)、[Azure](https://github.com/Azure)、[DotNet](https://github.com/dotnet)、[AspNet](https://github.com/aspnet)、[Xamarin](https://github.com/xamarin)など、GitHub組織を通じて管理されているすべてのソースコードリポジトリが含まれます。 diff --git a/translations/ja/SUPPORT.md b/translations/ja/SUPPORT.md index db427044..1696d669 100644 --- a/translations/ja/SUPPORT.md +++ b/translations/ja/SUPPORT.md @@ -1,12 +1,3 @@ - # サポート ## 問題の報告とサポートの受け方 diff --git a/translations/kn/.co-op-translator.json b/translations/kn/.co-op-translator.json new file mode 100644 index 00000000..df7867df --- /dev/null +++ b/translations/kn/.co-op-translator.json @@ -0,0 +1,92 @@ +{ + "01-IntroToGenAI/README.md": { + "original_hash": "75bfb080ca725e8a9aa9c80cae25fba1", + "translation_date": "2025-12-01T09:48:20+00:00", + "source_file": "01-IntroToGenAI/README.md", + "language_code": "kn" + }, + "02-SetupDevEnvironment/README.md": { + "original_hash": "96a30d42b9751a3d4e4b20e28d29d459", + "translation_date": "2026-01-28T05:40:42+00:00", + "source_file": "02-SetupDevEnvironment/README.md", + "language_code": "kn" + }, + "02-SetupDevEnvironment/examples/basic-chat-azure/README.md": { + "original_hash": "efd82efe50711d7e257eb943151d682c", + "translation_date": "2025-12-01T09:38:47+00:00", + "source_file": "02-SetupDevEnvironment/examples/basic-chat-azure/README.md", + "language_code": "kn" + }, + "02-SetupDevEnvironment/getting-started-azure-openai.md": { + "original_hash": "bfdb4b4eadbee3a59ef742439f58326a", + "translation_date": "2025-12-01T09:33:23+00:00", + "source_file": "02-SetupDevEnvironment/getting-started-azure-openai.md", + "language_code": "kn" + }, + "03-CoreGenerativeAITechniques/README.md": { + "original_hash": "685f55cb07de19b52a30ce6e8b6d889e", + "translation_date": "2025-12-01T09:44:03+00:00", + "source_file": "03-CoreGenerativeAITechniques/README.md", + "language_code": "kn" + }, + "04-PracticalSamples/README.md": { + "original_hash": "14c0a61ecc1cd2012a9c129236dfdf71", + "translation_date": "2025-12-01T09:16:14+00:00", + "source_file": "04-PracticalSamples/README.md", + "language_code": "kn" + }, + "04-PracticalSamples/calculator/README.md": { + "original_hash": "b6c16b5514d524e415a94f6097ee7d4c", + "translation_date": "2025-12-01T09:19:56+00:00", + "source_file": "04-PracticalSamples/calculator/README.md", + "language_code": "kn" + }, + "04-PracticalSamples/foundrylocal/README.md": { + "original_hash": "f787307400de59adc25a1404466a35f3", + "translation_date": "2025-12-01T09:24:01+00:00", + "source_file": "04-PracticalSamples/foundrylocal/README.md", + "language_code": "kn" + }, + "04-PracticalSamples/petstory/README.md": { + "original_hash": "0cbf68d605615a1e602c832a24616859", + "translation_date": "2025-12-01T09:28:05+00:00", + "source_file": "04-PracticalSamples/petstory/README.md", + "language_code": "kn" + }, + "05-ResponsibleGenAI/README.md": { + "original_hash": "301c05c2f57e60a6950b8c665b8bdbba", + "translation_date": "2025-12-01T09:32:01+00:00", + "source_file": "05-ResponsibleGenAI/README.md", + "language_code": "kn" + }, + "AGENTS.md": { + "original_hash": "afc90918d008cf77fd1982691f681306", + "translation_date": "2025-12-01T09:08:20+00:00", + "source_file": "AGENTS.md", + "language_code": "kn" + }, + "CODE_OF_CONDUCT.md": { + "original_hash": "442b123d034f92f7c384d2bbd28f99f1", + "translation_date": "2025-12-01T09:13:42+00:00", + "source_file": "CODE_OF_CONDUCT.md", + "language_code": "kn" + }, + "README.md": { + "original_hash": "125a08948d881c95628094f4dd1fbd43", + "translation_date": "2026-01-29T16:31:52+00:00", + "source_file": "README.md", + "language_code": "kn" + }, + "SECURITY.md": { + "original_hash": "57f14126c1c6add76b3aef3844dfe4e3", + "translation_date": "2025-12-01T09:14:38+00:00", + "source_file": "SECURITY.md", + "language_code": "kn" + }, + "SUPPORT.md": { + "original_hash": "b8ef73cc49dec68e2c885ee9df545129", + "translation_date": "2025-12-01T09:13:04+00:00", + "source_file": "SUPPORT.md", + "language_code": "kn" + } +} \ No newline at end of file diff --git a/translations/kn/01-IntroToGenAI/README.md b/translations/kn/01-IntroToGenAI/README.md index e1db6091..0d57ada3 100644 --- a/translations/kn/01-IntroToGenAI/README.md +++ b/translations/kn/01-IntroToGenAI/README.md @@ -1,12 +1,3 @@ - # ಜನರೇಟಿವ್ AI ಗೆ ಪರಿಚಯ - ಜಾವಾ ಆವೃತ್ತಿ ## ನೀವು ಏನು ಕಲಿಯುತ್ತೀರಿ diff --git a/translations/kn/02-SetupDevEnvironment/README.md b/translations/kn/02-SetupDevEnvironment/README.md index 3e4e88e7..28106075 100644 --- a/translations/kn/02-SetupDevEnvironment/README.md +++ b/translations/kn/02-SetupDevEnvironment/README.md @@ -1,187 +1,178 @@ - -# ಜಾವಾ ಜನರೇಟಿವ್ AI ಅಭಿವೃದ್ಧಿ ಪರಿಸರವನ್ನು ಸೆಟ್ ಅಪ್ ಮಾಡುವುದು +# ಜನರೇಟಿವ್ AI ನಿಗಾಗಿ Java ವಿಕಾಸ ಪರಿಸರವನ್ನು ಸജ್ಜುಗೊಳಿಸುವುದು -> **ತ್ವರಿತ ಪ್ರಾರಂಭ**: 2 ನಿಮಿಷಗಳಲ್ಲಿ ಕ್ಲೌಡ್‌ನಲ್ಲಿ ಕೋಡ್ ಬರೆಯಿರಿ - [GitHub Codespaces ಸೆಟ್ ಅಪ್](../../../02-SetupDevEnvironment) ಗೆ ಹೋಗಿ - ಸ್ಥಳೀಯ ಇನ್‌ಸ್ಟಾಲೇಶನ್ ಅಗತ್ಯವಿಲ್ಲ ಮತ್ತು GitHub ಮಾದರಿಗಳನ್ನು ಬಳಸುತ್ತದೆ! +> **ತ್ವರಿತ ಪ್ರಾರಂಭ**: 2 ನಿಮಿಷಗಳಲ್ಲಿ ಕ್ಲೌಡ್‌ನಲ್ಲಿ ಕೋಡ್ ಮಾಡಿ - [GitHub Codespaces ಸೆಟ್‌ಅಪ್](../../../02-SetupDevEnvironment) ಗೆ ಹೊಕ್ಕೆ - ಯಾವುದೇ ಸ್ಥಳೀಯ ಸ್ಥಾಪನೆ ಅವಶ್ಯಕತೆ ಇಲ್ಲ ಮತ್ತು github ಮಾದರಿಗಳನ್ನು ಬಳಸುತ್ತದೆ! -> **Azure OpenAI ಬಗ್ಗೆ ಆಸಕ್ತಿ ಇದೆಯೇ?**, ಹೊಸ Azure OpenAI ಸಂಪತ್ತನ್ನು ರಚಿಸಲು ನಮ್ಮ [Azure OpenAI ಸೆಟ್ ಅಪ್ ಗೈಡ್](getting-started-azure-openai.md) ನೋಡಿ. +> **Azure OpenAIನಲ್ಲಿ ಆಸಕ್ತಿ ಇದೆ?**, ಹೊಸ Azure OpenAI ಸಂಪನ್ಮೂಲವನ್ನು ರಚಿಸುವ ಹಂತಗಳನ್ನು ಹೊಂದಿರುವ ನಮ್ಮ [Azure OpenAI ಸೆಟ್‌ಅಪ್ ಮಾರ್ಗದರ್ಶಿಯನ್ನು](getting-started-azure-openai.md) ನೋಡಿ. -## ನೀವು ಏನು ಕಲಿಯುತ್ತೀರಿ +## ನೀವು ಕಲಿಯುವದ್ದು -- AI ಅಪ್ಲಿಕೇಶನ್‌ಗಳಿಗೆ ಜಾವಾ ಅಭಿವೃದ್ಧಿ ಪರಿಸರವನ್ನು ಸೆಟ್ ಅಪ್ ಮಾಡುವುದು -- ನಿಮ್ಮ ಇಷ್ಟದ ಅಭಿವೃದ್ಧಿ ಪರಿಸರವನ್ನು ಆಯ್ಕೆ ಮಾಡಿ ಮತ್ತು ಕಾನ್ಫಿಗರ್ ಮಾಡುವುದು (Codespaces ಮೂಲಕ ಕ್ಲೌಡ್-ಫಸ್ಟ್, ಸ್ಥಳೀಯ ಡೆವ್ ಕಂಟೈನರ್, ಅಥವಾ ಸಂಪೂರ್ಣ ಸ್ಥಳೀಯ ಸೆಟ್ ಅಪ್) -- GitHub ಮಾದರಿಗಳಿಗೆ ಸಂಪರ್ಕಿಸುವ ಮೂಲಕ ನಿಮ್ಮ ಸೆಟ್ ಅಪ್ ಅನ್ನು ಪರೀಕ್ಷಿಸಿ +- AI ಅಪ್ಲಿಕೇಶನ್‌ಗಳಿಗಾಗಿ Java ವಿಕಾಸ ಪರಿಸರವನ್ನು ಸಜ್ಜುಗೊಳಿಸುವುದು +- ನೀವು ಇಷ್ಟಪಡುವ ವಿಕಾಸ ಪರಿಸರವನ್ನು ಆರಿಸಿ ಮತ್ತು ಕಾನ್ಫಿಗರ್ ಮಾಡು (Codespaces ಜೊತೆ ಕ್ಲೌಡ್-ಪ್ರಥಮ, ಸ್ಥಳೀಯ ಡೆವ್ ಕಾಂಟೇನರ್ ಅಥವಾ ಸಂಪೂರ್ಣ ಸ್ಥಳೀಯ ಸೆಟ್‌ಅಪ್) +- GitHub ಮಾದರಿಗಳಿಗೆ ಸಂಪರ್ಕ ಸಾಧಿಸಿ ನಿಮ್ಮ ಸೆಟ್‌ಅಪ್ ಪರೀಕ್ಷಿಸಿ -## ವಿಷಯಗಳ ಪಟ್ಟಿಯು +## ವಿಷಯ ಸೂಚಿ -- [ನೀವು ಏನು ಕಲಿಯುತ್ತೀರಿ](../../../02-SetupDevEnvironment) +- [ನೀವು ಕಲಿಯುವದ್ದು](../../../02-SetupDevEnvironment) - [ಪರಿಚಯ](../../../02-SetupDevEnvironment) -- [ಹಂತ 1: ನಿಮ್ಮ ಅಭಿವೃದ್ಧಿ ಪರಿಸರವನ್ನು ಸೆಟ್ ಅಪ್ ಮಾಡುವುದು](../../../02-SetupDevEnvironment) - - [ಆಯ್ಕೆ A: GitHub Codespaces (ಶಿಫಾರಸು)](../../../02-SetupDevEnvironment) - - [ಆಯ್ಕೆ B: ಸ್ಥಳೀಯ ಡೆವ್ ಕಂಟೈನರ್](../../../02-SetupDevEnvironment) - - [ಆಯ್ಕೆ C: ನಿಮ್ಮ ಇತ್ತೀಚಿನ ಸ್ಥಳೀಯ ಇನ್‌ಸ್ಟಾಲೇಶನ್ ಅನ್ನು ಬಳಸುವುದು](../../../02-SetupDevEnvironment) +- [ಹಂತ 1: ನಿಮ್ಮ ವಿಕಾಸ ಪರಿಸರವನ್ನು ಸೆಟ್‌ಅಪ್ ಮಾಡಿ](../../../02-SetupDevEnvironment) + - [ಆಪ್ಷನ್ A: GitHub Codespaces (ಭಾಗ್ಯಶಾಲಿ)](../../../02-SetupDevEnvironment) + - [ಆಪ್ಷನ್ B: ಸ್ಥಳೀಯ ಡೆವ್ ಕಾಂಟೇನರ್](../../../02-SetupDevEnvironment) + - [ಆಪ್ಷನ್ C: ನಿಮ್ಮ ಇರುತ್ತದೆ ಸ್ಥಳೀಯ ಸ್ಥಾಪನೆಯನ್ನು ಬಳಸಿ](../../../02-SetupDevEnvironment) - [ಹಂತ 2: GitHub ವೈಯಕ್ತಿಕ ಪ್ರವೇಶ ಟೋಕನ್ ರಚಿಸಿ](../../../02-SetupDevEnvironment) -- [ಹಂತ 3: ನಿಮ್ಮ ಸೆಟ್ ಅಪ್ ಅನ್ನು ಪರೀಕ್ಷಿಸಿ](../../../02-SetupDevEnvironment) -- [ತೊಂದರೆ ಪರಿಹಾರ](../../../02-SetupDevEnvironment) +- [ಹಂತ 3: GitHub ಮಾದರಿಗಳ ಉದಾಹರಣೆಯೊಂದಿಗೆ ನಿಮ್ಮ ಸೆಟ್‌ಅಪ್ ಪರೀಕ್ಷಿಸಿ](../../../02-SetupDevEnvironment) +- [ಸಮಸ್ಯೆ ಪರಿಹಾರ](../../../02-SetupDevEnvironment) - [ಸಾರಾಂಶ](../../../02-SetupDevEnvironment) - [ಮುಂದಿನ ಹಂತಗಳು](../../../02-SetupDevEnvironment) ## ಪರಿಚಯ -ಈ ಅಧ್ಯಾಯವು ಅಭಿವೃದ್ಧಿ ಪರಿಸರವನ್ನು ಸೆಟ್ ಅಪ್ ಮಾಡುವ ಮೂಲಕ ನಿಮಗೆ ಮಾರ್ಗದರ್ಶನ ನೀಡುತ್ತದೆ. **GitHub ಮಾದರಿಗಳು** ನಮ್ಮ ಪ್ರಾಥಮಿಕ ಉದಾಹರಣೆಯಾಗಿ ಬಳಸಲಾಗುತ್ತದೆ ಏಕೆಂದರೆ ಇದು ಉಚಿತ, GitHub ಖಾತೆಯೊಂದಿಗೆ ಸುಲಭವಾಗಿ ಸೆಟ್ ಅಪ್ ಮಾಡಬಹುದು, ಕ್ರೆಡಿಟ್ ಕಾರ್ಡ್ ಅಗತ್ಯವಿಲ್ಲ, ಮತ್ತು ಪ್ರಯೋಗಕ್ಕಾಗಿ ಅನೇಕ ಮಾದರಿಗಳನ್ನು ಒದಗಿಸುತ್ತದೆ. +ಈ ಅಧ್ಯಾಯವು ನಿಮಗೆ ವಿಕಾಸ ಪರಿಸರವನ್ನು ಸಜ್ಜುಗೊಳಿಸುವಲ್ಲಿ ಮಾರ್ಗದರ್ಶನ ನೀಡುತ್ತದೆ. ನಾವು **GitHub ಮಾದರಿಗಳನ್ನು** ನಮ್ಮ ಪ್ರಾಥಮಿಕ ಉದಾಹರಣೆಯಾಗಿ ಬಳಸುತ್ತೇವೆ ಏಕೆಂದರೆ ಇದು ಉಚಿತ, GitHub ಖಾತೆ ಬಳಸಿ ಸಜ್ಜುಗೊಳಿಸಲು ಸುಲಭ, ಕ್ರೆಡಿಟ್ ಕಾರ್ಡ್ ಅವಶ್ಯಕತೆ ಇಲ್ಲ, ಮತ್ತು ಪ್ರಯೋಗಕ್ಕಾಗಿ ಹಲವಾರು ಮಾದರಿಗಳ ಪ್ರವೇಶ ನೀಡುತ್ತದೆ. -**ಸ್ಥಳೀಯ ಸೆಟ್ ಅಪ್ ಅಗತ್ಯವಿಲ್ಲ!** GitHub Codespaces ಬಳಸಿ ತಕ್ಷಣವೇ ಕೋಡಿಂಗ್ ಪ್ರಾರಂಭಿಸಬಹುದು, ಇದು ನಿಮ್ಮ ಬ್ರೌಸರ್‌ನಲ್ಲಿ ಸಂಪೂರ್ಣ ಅಭಿವೃದ್ಧಿ ಪರಿಸರವನ್ನು ಒದಗಿಸುತ್ತದೆ. +**ಯಾವುದೇ ಸ್ಥಳೀಯ ಸೆಟ್‌ಅಪ್ ಅಗತ್ಯವಿಲ್ಲ!** GitHub Codespaces ಬಳಸಿ ತಕ್ಷಣವೇ ಬ್ರೌಸರ್‌ನಲ್ಲಿ ಸಂಪೂರ್ಣ ವಿಕಾಸ ಪರಿಸರವನ್ನು ಪಡೆಯಿರಿ. -ಸ್ಕ್ರೀನ್‌ಶಾಟ್: GitHub ಮಾದರಿಗಳು +ತೇಜಃಚಿತ್ರ: GitHub Models -ಈ ಕೋರ್ಸ್‌ಗೆ ನಾವು [**GitHub ಮಾದರಿಗಳನ್ನು**](https://github.com/marketplace?type=models) ಶಿಫಾರಸು ಮಾಡುತ್ತೇವೆ ಏಕೆಂದರೆ ಇದು: -- **ಉಚಿತ**ವಾಗಿ ಪ್ರಾರಂಭಿಸಲು -- **ಸುಲಭ**ವಾಗಿ GitHub ಖಾತೆಯೊಂದಿಗೆ ಸೆಟ್ ಅಪ್ ಮಾಡಬಹುದು +ನಾವು ಈ ಕೋರ್ಸ್‌ಗೆ [**GitHub Models**](https://github.com/marketplace?type=models) ಬಳಸುವುದನ್ನು ಶಿಫಾರಸು ಮಾಡುತ್ತೇವೆ ಏಕೆಂದರೆ ಅದು: +- ಪ್ರಾರಂಭಿಸಲು **ಉಚಿತ** +- ಕೇವಲ GitHub ಖಾತೆ ಇದ್ದರೆ **ಸುಲಭವಾಗಿ** ಸಜ್ಜಾಗುತ್ತದೆ - **ಕ್ರೆಡಿಟ್ ಕಾರ್ಡ್** ಅಗತ್ಯವಿಲ್ಲ -- **ಅನೇಕ ಮಾದರಿಗಳು** ಪ್ರಯೋಗಕ್ಕಾಗಿ ಲಭ್ಯವಿದೆ +- **ಪ್ರಯೋಗಕ್ಕಾಗಿ ಹಲವಾರು ಮಾದರಿಗಳು** ಲಭ್ಯವಿವೆ -> **ಗಮನಿಸಿ**: ಈ ತರಬೇತಿಯಲ್ಲಿ ಬಳಸುವ GitHub ಮಾದರಿಗಳಿಗೆ ಈ ಉಚಿತ ಮಿತಿಗಳು ಇವೆ: -> - 15 ವಿನಂತಿಗಳು ಪ್ರತಿ ನಿಮಿಷ (150 ಪ್ರತಿ ದಿನ) -> - ~8,000 ಪದಗಳು ಒಳಗೆ, ~4,000 ಪದಗಳು ಹೊರಗೆ ಪ್ರತಿ ವಿನಂತಿಗೆ -> - 5 ಸಮಕಾಲೀನ ವಿನಂತಿಗಳು +> **ಸೂಚನೆ**: ಈ ತರಬೇತಿಯಲ್ಲಿ ಬಳಸುತ್ತಿರುವ GitHub Modelsನ ಉಚಿತ ಮಿತಿಗಳು ಇವು: +> - ಪ್ರತಿ ನಿಮಿಷಕ್ಕೆ 15 ವಿನಂತಿಗಳು (ಪ್ರತಿ ದಿನ 150) +> - ಪ್ರತಿ ವಿನಂತಿಗೆ ~8,000 ಪದಗಳು ಒಳಗೆ, ~4,000 ಪದಗಳು ಹೊರಗೆ +> - 5 ಸೋರೊವಿನ ವಿನಂತಿಗಳು > -> ಉತ್ಪಾದನಾ ಬಳಕೆಗಾಗಿ, ನಿಮ್ಮ Azure ಖಾತೆಯೊಂದಿಗೆ Azure AI Foundry ಮಾದರಿಗಳಿಗೆ ಅಪ್‌ಗ್ರೇಡ್ ಮಾಡಿ. ನಿಮ್ಮ ಕೋಡ್ ಬದಲಾಯಿಸಲು ಅಗತ್ಯವಿಲ್ಲ. [Azure AI Foundry ಡಾಕ್ಯುಮೆಂಟೇಶನ್](https://learn.microsoft.com/azure/ai-foundry/foundry-models/how-to/quickstart-github-models) ನೋಡಿ. +> ಉತ್ಪಾದನಾ ಬಳಕೆಗೆ, ನಿಮ್ಮ Azure ಖಾತೆಯೊಂದಿಗೆ Azure AI Foundry Models ಗೆ ಅಪ್‌ಗ್ರೇಡ್ ಮಾಡಿ. ನಿಮ್ಮ ಕೋಡ್ ಬದಲಾವಣೆ ಅಗತ್ಯವಿಲ್ಲ. ನೋಡಿ [Azure AI Foundry ದಸ್ತಾವೇಜು](https://learn.microsoft.com/azure/ai-foundry/foundry-models/how-to/quickstart-github-models). -## ಹಂತ 1: ನಿಮ್ಮ ಅಭಿವೃದ್ಧಿ ಪರಿಸರವನ್ನು ಸೆಟ್ ಅಪ್ ಮಾಡುವುದು +## ಹಂತ 1: ನಿಮ್ಮ ವಿಕಾಸ ಪರಿಸರವನ್ನು ಸೆಟ್‌ಅಪ್ ಮಾಡಿ -ನಾವು ಈ ಜನರೇಟಿವ್ AI ಜಾವಾ ಕೋರ್ಸ್‌ಗಾಗಿ ಅಗತ್ಯವಿರುವ ಎಲ್ಲಾ ಸಾಧನಗಳನ್ನು ಹೊಂದಿರುವ ಪೂರ್ವ-ಕಾನ್ಫಿಗರ್ ಮಾಡಿದ ಅಭಿವೃದ್ಧಿ ಕಂಟೈನರ್ ಅನ್ನು ರಚಿಸಿದ್ದೇವೆ. ನಿಮ್ಮ ಇಷ್ಟದ ಅಭಿವೃದ್ಧಿ ವಿಧಾನವನ್ನು ಆಯ್ಕೆಮಾಡಿ: +ನಾವು ಈ ಜನರೇಟಿವ್ AI Java ಕೋರ್ಸ್‌ಗೆ ಅಗತ್ಯವಿರುವ ಎಲ್ಲಾ ಉಪಕರಣಗಳನ್ನು ಹೊಂದಿರುವ ಪೂರ್ವಕಾನ್ಫಿಗರ್ ಮಾಡಲಾದ ಡೆವ್ ಕಾಂಟೇನರ್ ರಚಿಸಿದ್ದೇವೆ, ಇದರಿಂದ ಸೆಟ್‌ಅಪ್ ಸಮಯವಳೆಯಬಹುದು. ನಿಮ್ಮ ಇಷ್ಟದ ವಿಕಾಸ ವಿಧಾನವನ್ನು ಆರಿಸಿ: -### ಪರಿಸರ ಸೆಟ್ ಅಪ್ ಆಯ್ಕೆಗಳು: +### ಪರಿಸರ ಸೆಟ್‌ಅಪ್ ಆಯ್ಕೆಗಳು: -#### ಆಯ್ಕೆ A: GitHub Codespaces (ಶಿಫಾರಸು) +#### ಆಪ್ಷನ್ A: GitHub Codespaces (ಭಾಗ್ಯಶಾಲಿ) -**2 ನಿಮಿಷಗಳಲ್ಲಿ ಕೋಡಿಂಗ್ ಪ್ರಾರಂಭಿಸಿ - ಸ್ಥಳೀಯ ಸೆಟ್ ಅಪ್ ಅಗತ್ಯವಿಲ್ಲ!** +**2 ನಿಮಿಷಗಳಲ್ಲಿ ಕೋಡ್ ಪ್ರಾರಂಭಿಸಿ - ಯಾವುದೇ ಸ್ಥಳೀಯ ಸ್ಥಾಪನೆಯ ಅಗತ್ಯವಿಲ್ಲ!** -1. ಈ ರೆಪೊಸಿಟರಿಯನ್ನು ನಿಮ್ಮ GitHub ಖಾತೆಗೆ ಫೋರ್ಕ್ ಮಾಡಿ - > **ಗಮನಿಸಿ**: ನೀವು ಮೂಲಭೂತ ಕಾನ್ಫಿಗ್ ಅನ್ನು ಸಂಪಾದಿಸಲು ಬಯಸಿದರೆ [Dev Container Configuration](../../../.devcontainer/devcontainer.json) ನೋಡಿ +1. ಈ ರೆಪೊಸಿಟರಿಯನ್ನು ನಿಮ್ಮ GitHub ಖಾತೆಗೆ Fork ಮಾಡಿ + > **ಸೂಚನೆ**: ಮೂಲಭೂತ ಕಾನ್ಫಿಗ್ ಸಂಪಾದಿಸಲು ಬಯಸಿದರೆ [Dev Container Configuration](../../../.devcontainer/devcontainer.json) ನೋಡಿ 2. **Code** → **Codespaces** ಟ್ಯಾಬ್ → **...** → **New with options...** ಕ್ಲಿಕ್ ಮಾಡಿ -3. ಡೀಫಾಲ್ಟ್‌ಗಳನ್ನು ಬಳಸಿರಿ – ಇದು ಈ ಕೋರ್ಸ್‌ಗಾಗಿ ರಚಿಸಲಾದ **Generative AI Java Development Environment** ಕಸ್ಟಮ್ ಡೆವ್‌ಕಂಟೈನರ್ ಅನ್ನು ಆಯ್ಕೆಮಾಡುತ್ತದೆ +3. ಪೂರ್ವನಿಯೋಜಿತವನ್ನು ಬಳಸಿ – ಇದು ಈ ಕೋರ್ಸ್‌ಗೆ ಕಸ್ಟಮ್ ಡೆವ್ ಕಾಂಟೇನರ್ ಹೊಂದಿ **Generative AI Java Development Environment** ಆಯ್ಕೆಯನ್ನು ಆರಿಸುತ್ತದೆ 4. **Create codespace** ಕ್ಲಿಕ್ ಮಾಡಿ -5. ಪರಿಸರ ಸಿದ್ಧವಾಗಲು ~2 ನಿಮಿಷ ಕಾಯಿರಿ -6. [ಹಂತ 2: GitHub ಟೋಕನ್ ರಚಿಸಿ](../../../02-SetupDevEnvironment) ಗೆ ಮುಂದುವರಿಯಿರಿ +5. ಪರಿಸರದ ತಯಾರಿ ತಲುಪಲು ಸುಮಾರು 2 ನಿಮಿಷ ಕಾಯಿರಿ +6. ಮುಂದಕ್ಕೆ [ಹಂತ 2: GitHub Token ರಚಿಸಿ](../../../02-SetupDevEnvironment) ಗೆ ಸಾಗಿರಿ -ಸ್ಕ್ರೀನ್‌ಶಾಟ್: Codespaces ಉಪಮೆನು +ತೇಜಃಚಿತ್ರ: Codespaces ಉಪಮೆನು -ಸ್ಕ್ರೀನ್‌ಶಾಟ್: New with options +ತೇಜಃಚಿತ್ರ: New with options -ಸ್ಕ್ರೀನ್‌ಶಾಟ್: Create codespace options +ತೇಜಃಚಿತ್ರ: Create codespace ಆಯ್ಕೆಗಳು -> **Codespaces ನ ಲಾಭಗಳು**: -> - ಸ್ಥಳೀಯ ಇನ್‌ಸ್ಟಾಲೇಶನ್ ಅಗತ್ಯವಿಲ್ಲ -> - ಯಾವುದೇ ಬ್ರೌಸರ್‌ನೊಂದಿಗೆ ಯಾವುದೇ ಸಾಧನದಲ್ಲಿ ಕೆಲಸ ಮಾಡುತ್ತದೆ -> - ಎಲ್ಲಾ ಸಾಧನಗಳು ಮತ್ತು ಅವಲಂಬನೆಗಳೊಂದಿಗೆ ಪೂರ್ವ-ಕಾನ್ಫಿಗರ್ ಮಾಡಲಾಗಿದೆ -> - ವೈಯಕ್ತಿಕ ಖಾತೆಗಳಿಗೆ ತಿಂಗಳಿಗೆ ಉಚಿತ 60 ಗಂಟೆಗಳು -> - ಎಲ್ಲಾ ಕಲಿಯುವವರಿಗೆ ಸತತ ಪರಿಸರ +> **Codespacesನ ಪ್ರಯೋಜನಗಳು**: +> - ಸ್ಥಳೀಯ ಸ್ಥಾಪನೆ ಅಗತ್ಯವಿಲ್ಲ +> - ಯಾವುದಾದರೂ ಬ್ರೌಸರ್ ಇರುವ ಸಾಧನದಲ್ಲಿ ಕಾರ್ಯನಿರ್ವಹಿಸುತ್ತದೆ +> - ಎಲ್ಲಾ ಉಪಕರಣಗಳು ಮತ್ತು ಅವಲಂಬನೆಗಳು ಪೂರ್ವಕಾನ್ಫಿಗರ್ ಆಗಿವೆ +> - ವೈಯಕ್ತಿಕ ಖಾತೆಗಳಿಗೆ ಪ್ರತಿ ತಿಂಗಳು 60 ಗಂಟೆಗಳ ಉಚಿತ ಬಳಕೆ +> - ಎಲ್ಲಾ ಕಲಿತವರಿಗೆ ಸತತ ಅನುಭವ -#### ಆಯ್ಕೆ B: ಸ್ಥಳೀಯ ಡೆವ್ ಕಂಟೈನರ್ +#### ಆಪ್ಷನ್ B: ಸ್ಥಳೀಯ ಡೆವ್ ಕಾಂಟೇನರ್ -**ಡಾಕರ್‌ನೊಂದಿಗೆ ಸ್ಥಳೀಯ ಅಭಿವೃದ್ಧಿಯನ್ನು ಇಷ್ಟಪಡುವ ಡೆವಲಪರ್‌ಗಳಿಗೆ** +**ಡೋಕರ್ ಬಳಸಿ ಸ್ಥಳೀಯ ವಿಕಾಸವನ್ನು ಪ್ರಥಮ ಚಿತ್ರಿಸುವ ಡೆವಲಪರ್‌ಗಳಿಗೆ** -1. ಈ ರೆಪೊಸಿಟರಿಯನ್ನು ನಿಮ್ಮ ಸ್ಥಳೀಯ ಯಂತ್ರಕ್ಕೆ ಫೋರ್ಕ್ ಮಾಡಿ ಮತ್ತು ಕ್ಲೋನ್ ಮಾಡಿ - > **ಗಮನಿಸಿ**: ನೀವು ಮೂಲಭೂತ ಕಾನ್ಫಿಗ್ ಅನ್ನು ಸಂಪಾದಿಸಲು ಬಯಸಿದರೆ [Dev Container Configuration](../../../.devcontainer/devcontainer.json) ನೋಡಿ +1. ಈ ರೆಪೊಸಿಟರಿಯನ್ನು Fork ಮಾಡಿ ಮತ್ತು ನಿಮ್ಮ ಸ್ಥಳೀಯ ಯಂತ್ರಕ್ಕೆ ಕ್ಲೋನ್ ಮಾಡಿ + > **ಸೂಚನೆ**: ಮೂಲಭೂತ ಕಾನ್ಫಿಗ್ ಸಂಪಾದಿಸಲು ಬಯಸಿದರೆ [Dev Container Configuration](../../../.devcontainer/devcontainer.json) ನೋಡಿ 2. [Docker Desktop](https://www.docker.com/products/docker-desktop/) ಮತ್ತು [VS Code](https://code.visualstudio.com/) ಅನ್ನು ಇನ್‌ಸ್ಟಾಲ್ ಮಾಡಿ -3. VS Code ನಲ್ಲಿ [Dev Containers extension](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers) ಅನ್ನು ಇನ್‌ಸ್ಟಾಲ್ ಮಾಡಿ -4. ರೆಪೊಸಿಟರಿ ಫೋಲ್ಡರ್ ಅನ್ನು VS Code ನಲ್ಲಿ ತೆರೆಯಿರಿ -5. ಸೂಚನೆ ನೀಡಿದಾಗ, **Reopen in Container** ಕ್ಲಿಕ್ ಮಾಡಿ (ಅಥವಾ `Ctrl+Shift+P` → "Dev Containers: Reopen in Container" ಬಳಸಿ) -6. ಕಂಟೈನರ್ ನಿರ್ಮಿಸಲು ಮತ್ತು ಪ್ರಾರಂಭಿಸಲು ಕಾಯಿರಿ -7. [ಹಂತ 2: GitHub ಟೋಕನ್ ರಚಿಸಿ](../../../02-SetupDevEnvironment) ಗೆ ಮುಂದುವರಿಯಿರಿ +3. VS Code ನಲ್ಲಿ [Dev Containers ವಿಸ್ತರಣೆ](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers) ಅನ್ನು ಇನ್‌ಸ್ಟಾಲ್ ಮಾಡಿ +4. VS Code ನಲ್ಲಿ ರೆಪೊಸಿಟರಿ ಫೋಲ್ಡರನ್ನು ತೆರೆಯಿರಿ +5. ಕೇಳಿದಾಗ, **Reopen in Container** ಕ್ಲಿಕ್ ಮಾಡಿ (ಅಥವಾ `Ctrl+Shift+P` → "Dev Containers: Reopen in Container" ಬಳಸಿ) +6. ಕಾಂಟೇನರ್ ನಿರ್ಮಿಸಿ ಪ್ರಾರಂಭವಾಗಲು ಕಾಯಿರಿ +7. ಮುಂದಕ್ಕೆ [ಹಂತ 2: GitHub Token ರಚಿಸಿ](../../../02-SetupDevEnvironment) ಗೆ ಸಾಗಿರಿ -ಸ್ಕ್ರೀನ್‌ಶಾಟ್: Dev container setup +ತೇಜಃಚಿತ್ರ: ಡೆವ್ ಕಾಂಟೇನರ್ ಸೆಟ್‌ಅಪ್ -ಸ್ಕ್ರೀನ್‌ಶಾಟ್: Dev container build complete +ತೇಜಃಚಿತ್ರ: ಡೆವ್ ಕಾಂಟೇನರ್ ನಿರ್ಮಾಣ ಪೂರ್ಣ -#### ಆಯ್ಕೆ C: ನಿಮ್ಮ ಇತ್ತೀಚಿನ ಸ್ಥಳೀಯ ಇನ್‌ಸ್ಟಾಲೇಶನ್ ಅನ್ನು ಬಳಸುವುದು +#### ಆಪ್ಷನ್ C: ನಿಮ್ಮ ಇರುತ್ತದೆ ಸ್ಥಳೀಯ ಸ್ಥಾಪನೆಯನ್ನು ಬಳಸಿ -**ಇತ್ತೀಚಿನ ಜಾವಾ ಪರಿಸರಗಳನ್ನು ಹೊಂದಿರುವ ಡೆವಲಪರ್‌ಗಳಿಗೆ** +**ಸ್ಥಳೀಯ Java ವಾತಾವರಣ ಹೊಂದಿರುವ ಡೆವಲಪರ್‌ಗಳಿಗೆ** -ಪೂರ್ವಾಪೇಕ್ಷಿತಗಳು: +ಆವಶ್ಯಕತೆಗಳು: - [Java 21+](https://www.oracle.com/java/technologies/javase/jdk21-archive-downloads.html) - [Maven 3.9+](https://maven.apache.org/download.cgi) -- [VS Code](https://code.visualstudio.com) ಅಥವಾ ನಿಮ್ಮ ಇಷ್ಟದ IDE +- [VS Code](https://code.visualstudio.com) ಅಥವಾ ನಿಮ್ಮ ಇಷ್ಟದ ಐಡಿಇ ಹಂತಗಳು: 1. ಈ ರೆಪೊಸಿಟರಿಯನ್ನು ನಿಮ್ಮ ಸ್ಥಳೀಯ ಯಂತ್ರಕ್ಕೆ ಕ್ಲೋನ್ ಮಾಡಿ -2. ನಿಮ್ಮ IDE ನಲ್ಲಿ ಪ್ರಾಜೆಕ್ಟ್ ಅನ್ನು ತೆರೆಯಿರಿ -3. [ಹಂತ 2: GitHub ಟೋಕನ್ ರಚಿಸಿ](../../../02-SetupDevEnvironment) ಗೆ ಮುಂದುವರಿಯಿರಿ +2. ಯೋಜನೆಯನ್ನು ನಿಮ್ಮ ಐಡಿಇನಲ್ಲಿ ತೆರೆಯಿರಿ +3. ಮುಂದಕ್ಕೆ [ಹಂತ 2: GitHub Token ರಚಿಸಿ](../../../02-SetupDevEnvironment) ಗೆ ಸಾಗಿರಿ -> **ಪ್ರೊ ಟಿಪ್**: ನೀವು ಕಡಿಮೆ-ವಿಶೇಷಣಾ ಯಂತ್ರವನ್ನು ಹೊಂದಿದ್ದರೆ ಆದರೆ ಸ್ಥಳೀಯವಾಗಿ VS Code ಅನ್ನು ಬಯಸಿದರೆ, GitHub Codespaces ಅನ್ನು ಬಳಸಿ! ಕ್ಲೌಡ್-ಹೋಸ್ಟೆಡ್ Codespace ಗೆ ನಿಮ್ಮ ಸ್ಥಳೀಯ VS Code ಅನ್ನು ಸಂಪರ್ಕಿಸಿ. +> **ಸೂಪರ್ ಟಿಪ್**: ಕಡಿಮೆ ವಿಷಿಷ್ಟತೆ ಇರುವ ಯಂತ್ರವಿದ್ದರೆ ಆದರೆ ಸ್ಥಳೀಯ VS Code ಬಳಕೆ ಮಾಡಲು ಬಯಸಿದರೆ GitHub Codespaces ಬಳಸಿ! ಉತ್ತಮ ಅನುಭವಕ್ಕಾಗಿ ನಿಮ್ಮ ಸ್ಥಳೀಯ VS Code ಅನ್ನು ಕ್ಲೌಡ್ ಆಧಾರಿತ Codespace ಗೆ ಸಂಪರ್ಕಿಸಿ. -ಸ್ಕ್ರೀನ್‌ಶಾಟ್: created local devcontainer instance +ತೇಜಃಚಿತ್ರ: ರಚಿಸಲಾದ ಸ್ಥಳೀಯ ಡೆವ್ ಕಾಂಟೇನರ್ ಉದಾಹರಣೆ ## ಹಂತ 2: GitHub ವೈಯಕ್ತಿಕ ಪ್ರವೇಶ ಟೋಕನ್ ರಚಿಸಿ -1. [GitHub ಸೆಟ್ಟಿಂಗ್‌ಗಳು](https://github.com/settings/profile) ಗೆ ಹೋಗಿ ಮತ್ತು ನಿಮ್ಮ ಪ್ರೊಫೈಲ್ ಮೆನುದಿಂದ **Settings** ಆಯ್ಕೆಮಾಡಿ. -2. ಎಡ ಪಾರ್ಶ್ವದ ಬಾರ್‌ನಲ್ಲಿ, **Developer settings** ಕ್ಲಿಕ್ ಮಾಡಿ (ಸಾಮಾನ್ಯವಾಗಿ ಕೆಳಭಾಗದಲ್ಲಿ). -3. **Personal access tokens** ಅಡಿಯಲ್ಲಿ, **Fine-grained tokens** ಕ್ಲಿಕ್ ಮಾಡಿ (ಅಥವಾ ಈ ನೇರ [ಲಿಂಕ್](https://github.com/settings/personal-access-tokens) ಅನುಸರಿಸಿ). +1. [GitHub Settings](https://github.com/settings/profile) ಗೆ ಹೋಗಿ ಮತ್ತು ನಿಮ್ಮ ಪ್ರೊಫೈಲ್ ಮೆನುಗಳಿಂದ **Settings** ಆಯ್ಕೆಮಾಡಿ. +2. ಎಡ ಬದಿಯ ಸೈಡ್‌ಬಾರ್‌ನಲ್ಲಿ **Developer settings** ಕ್ಲಿಕ್ ಮಾಡಿ (ಸಾಮಾನ್ಯವಾಗಿ ತಡದಲ್ಲಿ ಇರುತ್ತದೆ). +3. **Personal access tokens** ಅಡಿ, **Fine-grained tokens** ಕ್ಲಿಕ್ ಮಾಡಿ (ಅಥವಾ ನೀರಿಕ್ಷಣೆಗಾಗಿ ಈ ನೇರ [ಲಿಂಕ್](https://github.com/settings/personal-access-tokens) ಬಳಸಿ). 4. **Generate new token** ಕ್ಲಿಕ್ ಮಾಡಿ. -5. "Token name" ಅಡಿಯಲ್ಲಿ, ವಿವರಣಾತ್ಮಕ ಹೆಸರನ್ನು ನೀಡಿ (ಉದಾ., `GenAI-Java-Course-Token`). -6. ಅವಧಿ ಮುಗಿಯುವ ದಿನಾಂಕವನ್ನು ಹೊಂದಿಸಿ (ಶಿಫಾರಸು: ಭದ್ರತಾ ಉತ್ತಮ ಅಭ್ಯಾಸಗಳಿಗಾಗಿ 7 ದಿನಗಳು). -7. "Resource owner" ಅಡಿಯಲ್ಲಿ, ನಿಮ್ಮ ಬಳಕೆದಾರ ಖಾತೆಯನ್ನು ಆಯ್ಕೆಮಾಡಿ. -8. "Repository access" ಅಡಿಯಲ್ಲಿ, GitHub ಮಾದರಿಗಳೊಂದಿಗೆ ಬಳಸಲು ಬಯಸುವ ರೆಪೊಸಿಟರಿಗಳನ್ನು ಆಯ್ಕೆಮಾಡಿ (ಅಥವಾ ಅಗತ್ಯವಿದ್ದರೆ "All repositories"). -9. "Account permissions" ಅಡಿಯಲ್ಲಿ, **Models** ಅನ್ನು ಹುಡುಕಿ ಮತ್ತು ಅದನ್ನು **Read-only** ಗೆ ಹೊಂದಿಸಿ. +5. "Token name" ಅಡಿಯಲ್ಲಿ ವಿವರಣಾತ್ಮಕ ಹೆಸರು ನೀಡಿ (ಉದಾ: `GenAI-Java-Course-Token`). +6. ಮುಕ್ತಾಯ ದಿನಾಂಕವನ್ನು ಹೊಂದಿಸಿ (ಶಿಫಾರಸು: 7 ದಿನಗಳು ಸಾಂದರ್ಭಿಕ ಭದ್ರತೆ ಉದ್ದೇಶಕ್ಕಾಗಿ). +7. "Resource owner" ಅಡಿಯಲ್ಲಿ ನಿಮ್ಮ ಬಳಕೆದಾರ ಖಾತೆಯನ್ನು ಆಯ್ಕೆಮಾಡಿ. +8. "Repository access" ಅಡಿಯಲ್ಲಿ GitHub ಮಾದರಿಗಳು ಬಳಸಬೇಕಾದ ರೆಪೊಸಿಟರಿಗಳನ್ನು ಆಯ್ಕೆಮಾಡಿ (ಅಥವಾ ಅಗತ್ಯವಿದ್ದರೆ "All repositories"). +9. "Account permissions" ನಲ್ಲಿ **Models** ಪಡಕೊಳ್ಳಿ ಮತ್ತು ಅದನ್ನು **Read-only** ಗೆ ಸಿದ್ಧಪಡಿಸಿ. 10. **Generate token** ಕ್ಲಿಕ್ ಮಾಡಿ. -11. **ನಿಮ್ಮ ಟೋಕನ್ ಅನ್ನು ಈಗ ಕಾಪಿ ಮಾಡಿ ಮತ್ತು ಉಳಿಸಿ** – ನೀವು ಇದನ್ನು ಮತ್ತೆ ನೋಡಲು ಸಾಧ್ಯವಿಲ್ಲ! +11. **ನಿಮ್ಮ ಟೋಕನ್ ಅನ್ನು ಈಗ ನಕಲಿಸಿ ಮತ್ತು ಉಳಿಸಿ** – ಇದು ಮರುಕಾಣಿಸುವುದಿಲ್ಲ! -> **ಭದ್ರತಾ ಟಿಪ್**: ನಿಮ್ಮ ಪ್ರವೇಶ ಟೋಕನ್‌ಗಳಿಗೆ ಕನಿಷ್ಠ ಅಗತ್ಯವಿರುವ ವ್ಯಾಪ್ತಿಯನ್ನು ಮತ್ತು ಅಲ್ಪಾವಧಿಯ ಅವಧಿಯನ್ನು ಬಳಸಿರಿ. +> **ಭದ್ರತಾ ಸಲಹೆ**: ನಿಮ್ಮ ಪ್ರವೇಶ ಟೋಕನ್‌ಗಳಿಗೆ ಕನಿಷ್ಠ ಅಗತ್ಯ ವ್ಯಾಪ್ತಿಯನ್ನು ಮತ್ತು ಅತ್ಯಂತ ಕಡಿಮೆ ಪರಿಣಾಮಕಾರಿಯಾದ ಅವಧಿಯನ್ನು ಬಳಸಿ. -## ಹಂತ 3: GitHub ಮಾದರಿಗಳ ಉದಾಹರಣೆಯೊಂದಿಗೆ ನಿಮ್ಮ ಸೆಟ್ ಅಪ್ ಅನ್ನು ಪರೀಕ್ಷಿಸಿ +## ಹಂತ 3: GitHub ಮಾದರಿಗಳ ಉದಾಹರಣೆಯೊಂದಿಗೆ ನಿಮ್ಮ ಸೆಟ್‌ಅಪ್ ಪರೀಕ್ಷಿಸಿ -ನಿಮ್ಮ ಅಭಿವೃದ್ಧಿ ಪರಿಸರ ಸಿದ್ಧವಾದ ನಂತರ, [`02-SetupDevEnvironment/examples/github-models`](../../../02-SetupDevEnvironment/examples/github-models) ನಲ್ಲಿ ನಮ್ಮ ಉದಾಹರಣೆ ಅಪ್ಲಿಕೇಶನ್‌ನೊಂದಿಗೆ GitHub ಮಾದರಿಗಳ ಏಕೀಕರಣವನ್ನು ಪರೀಕ್ಷಿಸೋಣ. +ನಿಮ್ಮ ವಿಕಾಸ ಪರಿಸರ ಸಿದ್ಧವಾಗುತ್ತಿದ್ದಂತೆ, ನಮ್ಮ ಉದಾಹರಣಾ ಅಪ್ಲಿಕೇಶನ್ [`02-SetupDevEnvironment/examples/github-models`](../../../02-SetupDevEnvironment/examples/github-models) ನಲ್ಲಿ GitHub Models ಸಂಯೋಜನೆಯನ್ನು ಪರೀಕ್ಷಿಸೋಣ. -1. ನಿಮ್ಮ ಅಭಿವೃದ್ಧಿ ಪರಿಸರದಲ್ಲಿ ಟರ್ಮಿನಲ್ ಅನ್ನು ತೆರೆಯಿರಿ. -2. GitHub ಮಾದರಿಗಳ ಉದಾಹರಣೆಗೆ ಹೋಗಿ: +1. ನಿಮ್ಮ ಡೆವಲಪ್‌ಮೆಂಟ್ ಪರಿಸರದ ಟರ್ಮಿನಲ್ ತೆರೆಯಿರಿ. +2. GitHub Models ಉದಾಹರಣೆಗೆ ಹೋಗಿ: ```bash cd 02-SetupDevEnvironment/examples/github-models ``` -3. ನಿಮ್ಮ GitHub ಟೋಕನ್ ಅನ್ನು ಪರಿಸರ ವ್ಯತ್ಯಯವಾಗಿ ಸೆಟ್ ಮಾಡಿ: +3. ನಿಮ್ಮ GitHub ಟೋಕನ್ ಅನ್ನು ಪರಿಸರ ಚರ ಅಗ್ಗವಾಗಿ ಹೊಂದಿಸಿ: ```bash # ಮ್ಯಾಕ್‌ಒಎಸ್/ಲಿನಕ್ಸ್ export GITHUB_TOKEN=your_token_here - # ವಿಂಡೋಸ್ (ಕಮಾಂಡ್ ಪ್ರಾಂಪ್ಟ್) + # ವಿಂಡೋуз್ (ಕಮಾಂಡ್ ಪ್ರಾಂಪ್ಟ್) set GITHUB_TOKEN=your_token_here - # ವಿಂಡೋಸ್ (ಪವರ್‌ಶೆಲ್) + # ವಿಂಡೋуз್ (ಪವರ್‌ಶೆಲ್) $env:GITHUB_TOKEN="your_token_here" ``` -4. ಅಪ್ಲಿಕೇಶನ್ ಅನ್ನು ಚಲಾಯಿಸಿ: +4. ಅಪ್ಲಿಕೇಶನನ್ನು ಚಾಲನೆ ಮಾಡಿ: ```bash mvn compile exec:java -Dexec.mainClass="com.example.githubmodels.App" ``` -ನೀವು ಈ ರೀತಿಯ ಔಟ್‌ಪುಟ್ ಅನ್ನು ನೋಡಬಹುದು: +ಈ ರೀತಿ output ಕಾಣಬಹುದು: ```text Using model: gpt-4.1-nano Sending request to GitHub Models... Response: Hello World! ``` -### ಉದಾಹರಣೆ ಕೋಡ್ ಅನ್ನು ಅರ್ಥಮಾಡಿಕೊಳ್ಳುವುದು +### ಉದಾಹರಣಾ ಕೋಡ್ ಅನ್ನು ಅರ್ಥಮಾಡಿಕೊಳ್ಳುವುದು -ಮೊದಲು, ನಾವು ಏನು ಚಲಾಯಿಸಿದ್ದೇವೆ ಎಂಬುದನ್ನು ಅರ್ಥಮಾಡಿಕೊಳ್ಳೋಣ. `examples/github-models` ಅಡಿಯಲ್ಲಿ ಇರುವ ಉದಾಹರಣೆ OpenAI Java SDK ಅನ್ನು ಬಳಸಿಕೊಂಡು GitHub ಮಾದರಿಗಳಿಗೆ ಸಂಪರ್ಕಿಸುತ್ತದೆ: +ಮೊದಲು, ನಾವು ಯಾವ ಕೋಡ್ ಅನ್ನು ಓಡಿಸಿದ್ದಾರೆಂದು ಅರ್ಥಮಾಡಿಕೊಳ್ಳೋಣ. `examples/github-models` ಅಡಿಯಲ್ಲಿ ಉದಾಹರಣೆ OpenAI Java SDK ಬಳಸಿ GitHub Models ಗೆ ಸಂಪರ್ಕ ಕಲ್ಪಿಸುತ್ತದೆ: -**ಈ ಕೋಡ್ ಏನು ಮಾಡುತ್ತದೆ:** -- ನಿಮ್ಮ ವೈಯಕ್ತಿಕ ಪ್ರವೇಶ ಟೋಕನ್ ಬಳಸಿ GitHub ಮಾದರಿಗಳಿಗೆ **ಸಂಪರ್ಕಿಸುತ್ತದೆ** -- AI ಮಾದರಿಗೆ ಸರಳ "Say Hello World!" ಸಂದೇಶವನ್ನು **ಕಳುಹಿಸುತ್ತದೆ** -- AI ನ ಪ್ರತಿಕ್ರಿಯೆಯನ್ನು **ಸ್ವೀಕರಿಸುತ್ತದೆ** ಮತ್ತು ಪ್ರದರ್ಶಿಸುತ್ತದೆ -- ನಿಮ್ಮ ಸೆಟ್ ಅಪ್ ಸರಿಯಾಗಿ ಕೆಲಸ ಮಾಡುತ್ತಿದೆ ಎಂಬುದನ್ನು **ಪರಿಶೀಲಿಸುತ್ತದೆ** +**ಈ ಕೋಡ್ ಮಾಡುವುದು:** +- ನಿಮ್ಮ ವೈಯಕ್ತಿಕ ಪ್ರವೇಶ ಟೋಕನ್ ಬಳಸಿ GitHub Models ಗೆ **ಸಂಪರ್ಕಿಸುತ್ತದೆ** +- ಸರಳ "Say Hello World!" ಸಂದೇಶವನ್ನು AI ಮಾದರಿಗೆ **ಹೇಳುತ್ತದೆ** +- AI ಪ್ರತಿಕ್ರಿಯೆಯನ್ನು **ಸ್ವೀಕರಿಸಿ** ಮತ್ತು ಪ್ರದರ್ಶಿಸುತ್ತದೆ +- ನಿಮ್ಮ ಸೆಟ್‌ಅಪ್ ಸರಿಯಾಗಿ ಕಾರ್ಯನಿರ್ವಹಿಸುತ್ತಿದೆ ಎಂದು **ಪರಿಶೀಲಿಸುತ್ತದೆ** -**ಮುಖ್ಯ ಅವಲಂಬನೆ** (`pom.xml` ನಲ್ಲಿ): +**ಮੁੱਖ ಅವಲಂಬನೆ** (`pom.xml` ನಲ್ಲಿ): ```xml com.openai @@ -190,71 +181,71 @@ Response: Hello World! ``` -**ಮುಖ್ಯ ಕೋಡ್** (`App.java`): +**ಪ್ರಮುಖ ಕೋಡ್** (`App.java`): ```java -// OpenAI Java SDK ಬಳಸಿ GitHub ಮಾದರಿಗಳೊಂದಿಗೆ ಸಂಪರ್ಕಿಸಿ +// OpenAI ಜावा SDK ಬಳಸಿ GitHub ಮಾದರಿಗಳೊಂದಿಗೆ ಸಂಪರ್ಕ ಸ್ಥಾಪಿಸಿ OpenAIClient client = OpenAIOkHttpClient.builder() .apiKey(pat) .baseUrl("https://models.inference.ai.azure.com") .build(); -// ಚಾಟ್ ಪೂರ್ಣಗೊಳಿಸುವ ವಿನಂತಿಯನ್ನು ರಚಿಸಿ +// ಚಾಟ್ ಪೂರ್ಣಗೊಂಡ ವಿನಂತಿಯನ್ನು ತಯಾರಿಸಿ ChatCompletionCreateParams params = ChatCompletionCreateParams.builder() .model(modelId) .addSystemMessage("You are a concise assistant.") .addUserMessage("Say Hello World!") .build(); -// AI ಪ್ರತಿಕ್ರಿಯೆಯನ್ನು ಪಡೆಯಿರಿ +// AI ಉತ್ತರವನ್ನು ಪಡೆಯಿರಿ ChatCompletion response = client.chat().completions().create(params); System.out.println("Response: " + response.choices().get(0).message().content().orElse("No response content")); ``` ## ಸಾರಾಂಶ -ಅದ್ಭುತ! ನೀವು ಈಗ ಎಲ್ಲವನ್ನೂ ಸೆಟ್ ಅಪ್ ಮಾಡಿದ್ದೀರಿ: +ಅದ್ಭುತ! ಈಗ ಎಲ್ಲವನ್ನೂ ಸಜ್ಜುಗೊಳಿಸಿದ್ದೀರಿ: -- AI ಮಾದರಿಗಳ ಪ್ರವೇಶಕ್ಕಾಗಿ ಸರಿಯಾದ ಅನುಮತಿಗಳೊಂದಿಗೆ GitHub ವೈಯಕ್ತಿಕ ಪ್ರವೇಶ ಟೋಕನ್ ರಚಿಸಲಾಗಿದೆ -- ನಿಮ್ಮ ಜಾವಾ ಅಭಿವೃದ್ಧಿ ಪರಿಸರವನ್ನು (Codespaces, ಡೆವ್ ಕಂಟೈನರ್‌ಗಳು, ಅಥವಾ ಸ್ಥಳೀಯ) ಚಲಾಯಿಸಲಾಗಿದೆ -- ಉಚಿತ AI ಅಭಿವೃದ್ಧಿಗಾಗಿ OpenAI Java SDK ಬಳಸಿ GitHub ಮಾದರಿಗಳಿಗೆ ಸಂಪರ್ಕಿಸಲಾಗಿದೆ -- AI ಮಾದರಿಗಳೊಂದಿಗೆ ಮಾತನಾಡುವ ಸರಳ ಉದಾಹರಣೆಯೊಂದಿಗೆ ಎಲ್ಲವೂ ಕೆಲಸ ಮಾಡುತ್ತಿದೆ ಎಂದು ಪರೀಕ್ಷಿಸಲಾಗಿದೆ +- AI ಮಾದರಿ ಪ್ರವೇಶಕ್ಕಾಗಿ ಸರಿಯಾದ ಅನುಮತಿಗಳೊಂದಿಗೆ GitHub ವೈಯಕ್ತಿಕ ಪ್ರವೇಶ ಟೋಕನ್ ರಚಿಸಲಾಗಿದೆ +- ನಿಮ್ಮ Java ವಿಕಾಸ ಪರಿಸರ (Codespaces, ಡೆವ್ ಕಾಂಟೇನರ್ ಅಥವಾ ಸ್ಥಳೀಯವಾಗಿ) ಚಾಲನೆ ತುಂಬಿಸಿದೆ +- ಉಚಿತ AI ವಿಕಾಸಕ್ಕಾಗಿ OpenAI Java SDK ಬಳಸಿ GitHub Models ಗೆ ಸಂಪರ್ಕ ಸಾಧಿಸಿಕೊಂಡಿರುತ್ತೀರಿ +- AI ಮಾದರಿಗಳೊಂದಿಗೆ ಮಾತನಾಡುವ ಸರಳ ಉದಾಹರಣೆ ಮೂಲಕ ಎಲ್ಲವನು ಪರೀಕ್ಷಿಸಿದ್ದೀರಿ ## ಮುಂದಿನ ಹಂತಗಳು -[ಅಧ್ಯಾಯ 3: ಮೂಲ ಜನರೇಟಿವ್ AI ತಂತ್ರಗಳು](../03-CoreGenerativeAITechniques/README.md) +[ಅಧ್ಯಾಯ 3: ಕೋರ್ ಜನರೇಟಿವ್ AI ತಂತ್ರಗಳು](../03-CoreGenerativeAITechniques/README.md) -## ತೊಂದರೆ ಪರಿಹಾರ +## ಸಮಸ್ಯೆಗಳ ಪರಿಹಾರ -ಸಮಸ್ಯೆಗಳನ್ನು ಎದುರಿಸುತ್ತಿದ್ದೀರಾ? ಇಲ್ಲಿ ಸಾಮಾನ್ಯ ಸಮಸ್ಯೆಗಳು ಮತ್ತು ಪರಿಹಾರಗಳಿವೆ: +ಸಮಸ್ಯೆಗಳಿವೆಯಾ? ಇಲ್ಲಿ ಸಾಮಾನ್ಯ ಸಮಸ್ಯೆಗಳು ಮತ್ತು ಪರಿಹಾರಗಳು: -- **ಟೋಕನ್ ಕೆಲಸ ಮಾಡುತ್ತಿಲ್ಲವೇ?** - - ನೀವು ಸಂಪೂರ್ಣ ಟೋಕನ್ ಅನ್ನು ಯಾವುದೇ ಹೆಚ್ಚುವರಿ ಖಾಲಿ ಸ್ಥಳಗಳಿಲ್ಲದೆ ಕಾಪಿ ಮಾಡಿದ್ದೀರಾ ಎಂದು ಖಚಿತಪಡಿಸಿಕೊಳ್ಳಿ - - ಟೋಕನ್ ಅನ್ನು ಪರಿಸರ ವ್ಯತ್ಯಯವಾಗಿ ಸರಿಯಾಗಿ ಸೆಟ್ ಮಾಡಲಾಗಿದೆ ಎಂದು ಪರಿಶೀಲಿಸಿ - - ನಿಮ್ಮ ಟೋಕನ್ ಸರಿಯಾದ ಅನುಮತಿಗಳನ್ನು ಹೊಂದಿದೆಯೇ (Models: Read and write) ಎಂದು ಪರಿಶೀಲಿಸಿ +- **ಟೋಕನ್ ಕಾರ್ಯನಿರತರಾಗುತ್ತಿಲ್ಲ?** + - ಯಾವ ಅನಗತ್ಯ ಸ್ಪೇಸ್ ಇಲ್ಲದೆ ಸಂಪೂರ್ಣ ಟೋಕನ್ ನಕಲಿಸಿಕೊಂಡಿದ್ದೀರಾ ಎಂದು ಖಚಿತಪಡಿಸಿಕೊಳ್ಳಿ + - ಟೋಕನ್ ಸರಿಯಾಗಿ ಪರಿಸರ ಚರ ಘೋಷಿತವಾಗಿದೆ ಎಂದು ಪರಿಶೀಲಿಸಿ + - ನಿಮ್ಮ ಟೋಕನ್ ಸರಿಯಾದ ಅನುಮತಿಗಳನ್ನು ಹೊಂದಿದೆಯಾ (Models: ಓದಲು ಮಾತ್ರ) ಎಂಬುದನ್ನು ನೋಡಿಕೊಳ್ಳಿ -- **Maven ಕಂಡುಬರುತ್ತಿಲ್ಲವೇ?** - - ಡೆವ್ ಕಂಟೈನರ್‌ಗಳು/Codespaces ಬಳಸಿದರೆ, Maven ಪೂರ್ವ-ಇನ್‌ಸ್ಟಾಲ್ಡ್ ಆಗಿರುತ್ತದೆ - - ಸ್ಥಳೀಯ ಸೆಟ್ ಅಪ್‌ಗಾಗಿ, Java 21+ ಮತ್ತು Maven 3.9+ ಇನ್‌ಸ್ಟಾಲ್ಡ್ ಆಗಿವೆ ಎಂದು ಖಚಿತಪಡಿಸಿಕೊಳ್ಳಿ - - `mvn --version` ಪ್ರಯತ್ನಿಸಿ ಇನ್‌ಸ್ಟಾಲೇಶನ್ ಪರಿಶೀಲಿಸಲು +- **Maven ಕಂಡುಬಂದಿಲ್ಲ?** + - ಡೆವ್ ಕಾಂಟೇನರ್/ Codespaces ನಲ್ಲಿ Maven ಪೂರ್ವನಿಯೋಜಿತವಾಗಿದೆ + - ಸ್ಥಳೀಯ ಸೆಟ್‌ಅಪ್‌ನಿಗೆ, Java 21+ ಮತ್ತು Maven 3.9+ ಸ್ಥಾಪನೆಯಾಗಿರುವುದಾಗಿ ಖಚಿತಪಡಿಸಿಕೊಳ್ಳಿ + - ಸ್ಥಾಪನೆ ಪರಿಶೀಲಿಸಲು `mvn --version` ಪ್ರಯತ್ನಿಸಿ -- **ಸಂಪರ್ಕ ಸಮಸ್ಯೆಗಳೇ?** - - ನಿಮ್ಮ ಇಂಟರ್ನೆಟ್ ಸಂಪರ್ಕವನ್ನು ಪರಿಶೀಲಿಸಿ - - GitHub ನಿಮ್ಮ ನೆಟ್‌ವರ್ಕ್‌ನಿಂದ ಪ್ರವೇಶಿಸಬಹುದೇ ಎಂದು ಪರಿಶೀಲಿಸಿ - - GitHub ಮಾದರಿಗಳ ಎಂಡ್‌ಪಾಯಿಂಟ್ ಅನ್ನು ತಡೆಗಟ್ಟುವ ಫೈರ್‌ವಾಲ್‌ನ ಹಿಂದೆ ನೀವು ಇಲ್ಲವೇ ಎಂದು ಖಚಿತಪಡಿಸಿಕೊಳ್ಳಿ +- **ಕನೆಕ್ಷನ್ ಸಮಸ್ಯೆಗಳು?** + - ನಿಮ್ಮ ಇಂಟರ್‌ನೆಟ್ ಸಂಪರ್ಕವನ್ನು ಪರಿಶೀಲಿಸಿ + - GitHub ನಿಮ್ಮ ನೆಟ್‌ವರ್ಕ್‌ನಿಂದ ಲಭ್ಯವಿದೆಯೇ ಎಂದು ಪರಿಶೀಲಿಸಿ + - GitHub Models ಅಂತಿಮ ಬಿಂದುವನ್ನು ತಡೆಹಿಡಿಯುವ ಫೈರ್ವಾಲ್ ಹಿಂತಿರುಗಿಲ್ಲ ಎಂದು ಖಚಿತಪಡಿಸಿಕೊಳ್ಳಿ -- **ಡೆವ್ ಕಂಟೈನರ್ ಪ್ರಾರಂಭವಾಗುತ್ತಿಲ್ಲವೇ?** - - ಡಾಕರ್ ಡೆಸ್ಕ್‌ಟಾಪ್ ಚಲಿಸುತ್ತಿದೆಯೇ ಎಂದು ಖಚಿತಪಡಿಸಿಕೊಳ್ಳಿ (ಸ್ಥಳೀಯ ಅಭಿವೃದ್ಧಿಗಾಗಿ) - - ಕಂಟೈನರ್ ಅನ್ನು ಪುನಃ ನಿರ್ಮಿಸಲು ಪ್ರಯತ್ನಿಸಿ: `Ctrl+Shift+P` → "Dev Containers: Rebuild Container" +- **ಡೆವ್ ಕಾಂಟೇನರ್ ಆರಂಭವಾಗುತ್ತಿಲ್ಲ?** + - ಡೋಕರ್ ಡೆಸ್ಕ್‌ಟಾಪ್ ನಡೆದುತ್ತಿದೆಯೇ ಎಂದು ಖಚಿತಪಡಿಸಿಕೊಳ್ಳಿ (ಸ್ಥಳೀಯ ವಿಕಾಸಕ್ಕಾಗಿ) + - ಕಾಂಟೇನರ್ ಪುನರ್‌ನಿರ್ಮಿಸಲು ಪ್ರಯತ್ನಿಸಿ: `Ctrl+Shift+P` → "Dev Containers: Rebuild Container" -- **ಅಪ್ಲಿಕೇಶನ್ ಸಂಗ್ರಹಣಾ ದೋಷಗಳೇ?** - - ನೀವು ಸರಿಯಾದ ಡೈರೆಕ್ಟರಿಯಲ್ಲಿದ್ದೀರಾ ಎಂದು ಖಚಿತಪಡಿಸಿಕೊಳ್ಳಿ: `02-SetupDevEnvironment/examples/github-models` - - `mvn clean compile` ಪ್ರಯತ್ನಿಸಿ ಶುದ್ಧೀಕರಿಸಿ ಮತ್ತು ಪುನಃ ಸಂಗ್ರಹಿಸಲು +- **ಅಪ್ಲಿಕೇಶನ್ ಸಂಯೋಜನೆ ತಪ್ಪುಗಳು?** + - ನೀವು ಸರಿಯಾದ ಡೈರಕ್ಟರಿಯಲ್ಲಿ ಇದ್ದೀರಾ ಎಂದು ಖಚಿತಪಡಿಸಿಕೊಳ್ಳಿ: `02-SetupDevEnvironment/examples/github-models` + - ಸ್ವಚ್ಛಗೊಳಿಸಿ ಮತ್ತು ಪುನಃ ನಿರ್ಮಿಸಲು ಪ್ರಯತ್ನಿಸಿ: `mvn clean compile` -> **ಸಹಾಯ ಬೇಕೇ?**: ಇನ್ನೂ ಸಮಸ್ಯೆಗಳನ್ನು ಎದುರಿಸುತ್ತಿದ್ದೀರಾ? ರೆಪೊಸಿಟರಿಯಲ್ಲಿ ಒಂದು ಸಮಸ್ಯೆಯನ್ನು ತೆರೆಯಿರಿ, ನಾವು ನಿಮಗೆ ಸಹಾಯ ಮಾಡುತ್ತೇವೆ. +> **ಸಹಾಯ ಬೇಕೆ?**: ಸಮಸ್ಯೆಗಳು ಇನ್ನೂ ಇದೆಯೇ? ರೆಪೊಸಿಟರಿಯಲ್ಲಿ ಸಮಸ್ಯೆ ತೆರೆಯಿರಿ, ನಾವು ನಿಮಗೆ ಸಹಾಯ ಮಾಡುತ್ತೇವೆ. --- -**ಅಸಮಾಕ್ಷ್ಯತೆ**: -ಈ ದಸ್ತಾವೇಜನ್ನು AI ಅನುವಾದ ಸೇವೆ [Co-op Translator](https://github.com/Azure/co-op-translator) ಬಳಸಿ ಅನುವಾದಿಸಲಾಗಿದೆ. ನಾವು ನಿಖರತೆಯನ್ನು ಸಾಧಿಸಲು ಪ್ರಯತ್ನಿಸುತ್ತಿದ್ದರೂ, ದಯವಿಟ್ಟು ಗಮನಿಸಿ, ಸ್ವಯಂಚಾಲಿತ ಅನುವಾದಗಳಲ್ಲಿ ತಪ್ಪುಗಳು ಅಥವಾ ಅಸಡ್ಡೆಗಳು ಇರಬಹುದು. ಮೂಲ ಭಾಷೆಯಲ್ಲಿರುವ ಮೂಲ ದಸ್ತಾವೇಜು ಪ್ರಾಮಾಣಿಕ ಮೂಲವೆಂದು ಪರಿಗಣಿಸಬೇಕು. ಮಹತ್ವದ ಮಾಹಿತಿಗಾಗಿ, ವೃತ್ತಿಪರ ಮಾನವ ಅನುವಾದವನ್ನು ಶಿಫಾರಸು ಮಾಡಲಾಗುತ್ತದೆ. ಈ ಅನುವಾದವನ್ನು ಬಳಸುವ ಮೂಲಕ ಉಂಟಾಗುವ ಯಾವುದೇ ತಪ್ಪು ಅರ್ಥಗಳ ಅಥವಾ ತಪ್ಪು ವ್ಯಾಖ್ಯಾನಗಳ ಬಗ್ಗೆ ನಾವು ಹೊಣೆಗಾರರಲ್ಲ. +**ಅಸ್ವೀಕಾರ**: +ಈ ದಾಖಲೆ [ಕೊ-ಆಪ ಟ್ರಾನ್ಸ್ಲೇಟರ್](https://github.com/Azure/co-op-translator) ಎಂಬ ಎಐ ಅನುವಾದ ಸೇವೆಯನ್ನು ಬಳಸಿ ಅನುವಾದಿಸಲಾಗಿದೆ. ನಾವು ನಿಖರತೆಯನ್ನು ಸಾಧಿಸಲು ಪ್ರಯತ್ನಿಸುವರುವಾದರೂ, ಸ್ವಯಂಕ್ರಿಯ ಅನುವಾದಗಳು ತಪ್ಪುಗಳು ಅಥವಾ ಅಸತ್ಯತೆಗಳನ್ನು ಒಳಗೊಂಡಿರಬಹುದು ಎಂದು ದಯವಿಟ್ಟು ಗಮನಿಸಿ. ಮೂಲ ಭಾಷೆಯಲ್ಲಿರುವ ಮೂಲ ದಾಖಲೆ ಮುಖ್ಯವಾದ ಮೂಲವಾಗಿ ಪರಿಗಣಿಸಬೇಕು. ಪ್ರಮುಖ ಮಾಹಿತಿಗಾಗಿ, ವೃತ್ತಿಪರ ಮಾನವ ಅನುವಾದವನ್ನು ಶಿಫಾರಸು ಮಾಡಲಾಗುತ್ತದೆ. ಈ ಅನುವಾದ ಬಳಕೆಯಿಂದ ಹುಟ್ಟಿಸಬಹುದಾದ ಯಾವುದೇ ತೊಂದರೆಗಳು ಅಥವಾ ತ್ವಚನಾವಕಾಶಗಳಿಗಾಗಿ ನಾವು ಜವಾಬ್ದಾರರಾಗುವುದಿಲ್ಲ. \ No newline at end of file diff --git a/translations/kn/02-SetupDevEnvironment/examples/basic-chat-azure/README.md b/translations/kn/02-SetupDevEnvironment/examples/basic-chat-azure/README.md index 341241d2..d3848e5a 100644 --- a/translations/kn/02-SetupDevEnvironment/examples/basic-chat-azure/README.md +++ b/translations/kn/02-SetupDevEnvironment/examples/basic-chat-azure/README.md @@ -1,12 +1,3 @@ - # Azure OpenAI ಜೊತೆ ಮೂಲಭೂತ ಚಾಟ್ - ಸಂಪೂರ್ಣ ಉದಾಹರಣೆ ಈ ಉದಾಹರಣೆ, Azure OpenAI ಗೆ ಸಂಪರ್ಕಿಸುವ ಮತ್ತು ನಿಮ್ಮ ಸೆಟಪ್ ಅನ್ನು ಪರೀಕ್ಷಿಸುವ ಸರಳ Spring Boot ಅಪ್ಲಿಕೇಶನ್ ಅನ್ನು ಹೇಗೆ ರಚಿಸಬೇಕೆಂದು ತೋರಿಸುತ್ತದೆ. diff --git a/translations/kn/02-SetupDevEnvironment/getting-started-azure-openai.md b/translations/kn/02-SetupDevEnvironment/getting-started-azure-openai.md index 242573ae..9aebfc85 100644 --- a/translations/kn/02-SetupDevEnvironment/getting-started-azure-openai.md +++ b/translations/kn/02-SetupDevEnvironment/getting-started-azure-openai.md @@ -1,12 +1,3 @@ - # Azure OpenAI ಅಭಿವೃದ್ಧಿ ಪರಿಸರವನ್ನು ಸೆಟ್ ಅಪ್ ಮಾಡುವುದು > **ತ್ವರಿತ ಪ್ರಾರಂಭ**: ಈ ಮಾರ್ಗದರ್ಶಿ Azure OpenAI ಸೆಟ್ ಅಪ್‌ಗಾಗಿ. ಉಚಿತ ಮಾದರಿಗಳೊಂದಿಗೆ ತಕ್ಷಣ ಪ್ರಾರಂಭಿಸಲು, [GitHub Models with Codespaces](./README.md#quick-start-cloud) ಬಳಸಿ. diff --git a/translations/kn/03-CoreGenerativeAITechniques/README.md b/translations/kn/03-CoreGenerativeAITechniques/README.md index 9c6def2a..b88a03d9 100644 --- a/translations/kn/03-CoreGenerativeAITechniques/README.md +++ b/translations/kn/03-CoreGenerativeAITechniques/README.md @@ -1,12 +1,3 @@ - # ಕೋರ್ ಜನರೇಟಿವ್ AI ತಂತ್ರಗಳ ಟ್ಯುಟೋರಿಯಲ್ ## ವಿಷಯಗಳ ಪಟ್ಟಿಯು diff --git a/translations/kn/04-PracticalSamples/README.md b/translations/kn/04-PracticalSamples/README.md index 4ce7fab4..cd3e6cf0 100644 --- a/translations/kn/04-PracticalSamples/README.md +++ b/translations/kn/04-PracticalSamples/README.md @@ -1,12 +1,3 @@ - # ಪ್ರಾಯೋಗಿಕ ಅನ್ವಯಗಳು ಮತ್ತು ಯೋಜನೆಗಳು ## ನೀವು ಕಲಿಯುವದು ಏನು diff --git a/translations/kn/04-PracticalSamples/calculator/README.md b/translations/kn/04-PracticalSamples/calculator/README.md index ab9e9785..34544d46 100644 --- a/translations/kn/04-PracticalSamples/calculator/README.md +++ b/translations/kn/04-PracticalSamples/calculator/README.md @@ -1,12 +1,3 @@ - # MCP ಕ್ಯಾಲ್ಕುಲೇಟರ್ ಟ್ಯುಟೋರಿಯಲ್ ಪ್ರಾರಂಭಿಕರಿಗಾಗಿ ## ವಿಷಯಗಳ ಪಟ್ಟಿಯು diff --git a/translations/kn/04-PracticalSamples/foundrylocal/README.md b/translations/kn/04-PracticalSamples/foundrylocal/README.md index 30c7a0c0..24c1008c 100644 --- a/translations/kn/04-PracticalSamples/foundrylocal/README.md +++ b/translations/kn/04-PracticalSamples/foundrylocal/README.md @@ -1,12 +1,3 @@ - # ಫೌಂಡ್ರಿ ಲೋಕಲ್ ಸ್ಪ್ರಿಂಗ್ ಬೂಟ್ ಟ್ಯುಟೋರಿಯಲ್ ## ವಿಷಯಗಳ ಪಟ್ಟಿಯು diff --git a/translations/kn/04-PracticalSamples/petstory/README.md b/translations/kn/04-PracticalSamples/petstory/README.md index b69fe0ce..db97c08a 100644 --- a/translations/kn/04-PracticalSamples/petstory/README.md +++ b/translations/kn/04-PracticalSamples/petstory/README.md @@ -1,12 +1,3 @@ - # ಪೆಟ್ ಸ್ಟೋರಿ ಜನರೇಟರ್ ಟ್ಯುಟೋರಿಯಲ್ ಪ್ರಾರಂಭಿಕರಿಗಾಗಿ ## ವಿಷಯಗಳ ಪಟ್ಟಿಯು diff --git a/translations/kn/05-ResponsibleGenAI/README.md b/translations/kn/05-ResponsibleGenAI/README.md index 697716fb..508bc16d 100644 --- a/translations/kn/05-ResponsibleGenAI/README.md +++ b/translations/kn/05-ResponsibleGenAI/README.md @@ -1,12 +1,3 @@ - # ಜವಾಬ್ದಾರಿಯುತ ಜನರೇಟಿವ್ AI ## ನೀವು ಏನು ಕಲಿಯುತ್ತೀರಿ diff --git a/translations/kn/AGENTS.md b/translations/kn/AGENTS.md index fc20edff..aaaae51f 100644 --- a/translations/kn/AGENTS.md +++ b/translations/kn/AGENTS.md @@ -1,12 +1,3 @@ - # AGENTS.md ## ಯೋಜನೆಯ ಅವಲೋಕನ diff --git a/translations/kn/CODE_OF_CONDUCT.md b/translations/kn/CODE_OF_CONDUCT.md index 5b825604..0af3f403 100644 --- a/translations/kn/CODE_OF_CONDUCT.md +++ b/translations/kn/CODE_OF_CONDUCT.md @@ -1,12 +1,3 @@ - # ಮೈಕ್ರೋಸಾಫ್ಟ್ ಓಪನ್ ಸೋರ್ಸ್ ನಡವಳಿಕೆ ನಿಯಮಾವಳಿ ಈ ಯೋಜನೆ [ಮೈಕ್ರೋಸಾಫ್ಟ್ ಓಪನ್ ಸೋರ್ಸ್ ನಡವಳಿಕೆ ನಿಯಮಾವಳಿ](https://opensource.microsoft.com/codeofconduct/) ಅನ್ನು ಅಳವಡಿಸಿಕೊಂಡಿದೆ. diff --git a/translations/kn/README.md b/translations/kn/README.md index decda888..52f86118 100644 --- a/translations/kn/README.md +++ b/translations/kn/README.md @@ -1,89 +1,80 @@ - -# ಆರಂಭಿಕರಿಗೆ ಜನರೇಟಿವ್ AI - ಜಾವಾ ಆವೃತ್ತಿ +# ಪ್ರಾರಂಭಿಕರಿಗೆ ಜನರೇಟಿವ್ AI - ಜಾವಾ ಆವೃತ್ತಿ [![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) ![Generative AI for Beginners - Java Edition](../../translated_images/kn/beg-genai-series.8b48be9951cc574c.webp) -**ಸಮಯ ಬದ್ಧತೆ**: ಸಂಪೂರ್ಣ ಕಾರ್ಯಾಗಾರವನ್ನು ಸ್ಥಳೀಯ ವ್ಯವಸ್ಥಾಪನೆ ಇಲ್ಲದೆ ಆನ್‌ಲೈನ್‌ನಲ್ಲಿ ಪೂರ್ಣಗೊಳಿಸಬಹುದು. ಪರಿಸರ ವ್ಯವಸ್ಥೆಯನ್ನು ಸ್ಥಾಪಿಸಲು 2 ನಿಮಿಷಗಳು ಬೇಕಾಗಿದ್ದು, ಉದಾಹರಣೆಗಳನ್ನು ಪರಿಶೀಲಿಸಲು ಅನುಸರಿಸುವ ಆಳತೆಗೆ ಅವಲಂಬಿಸಿದಂತೆ 1-3 ಗಂಟೆಗಳು ಬೇಕಾಗಬಹುದು. +**ಸಮಯ ಬದ್ಧತೆ**: ಸಂಪೂರ್ಣ ಕಾರ್ಯಾಗಾರವನ್ನು ಸ್ಥಳೀಯ ಸೆಟ್‌ಅಪ್ ಇಲ್ಲದೆ ಆನ್‌ಲೈನ್‌ನಲ್ಲಿ ಪೂರ್ಣಗೊಳಿಸಬಹುದು. ಪರಿಸರ ಸೆಟ್‌ಅಪ್‌ಗೆ 2 ನಿಮಿಷಗಳು ಬೇಕಾಗುತ್ತದೆ, ಮತ್ತು ಮಾದರಿಗಳನ್ನು ಅನ್ವೇಷಿಸಲು 1-3 ಗಂಟೆಗಳ ತನಕ ಪೊಲೀಸರು ಅವಲಂಬಿಸಿ ಹೋದುತ್ತದೆ. -> **ತ್ವರಿತ ಪ್ರಾರಂಭ** +> **ವೇಗದ ಪ್ರಾರಂಭ** -1. ಈ ರೆಪೊಸಿಟರಿಯನ್ನು ನಿಮ್ಮ GitHub ಖಾತೆಗೆ ಫೋರ್ಕ್ ಮಾಡಿ -2. ಕ್ಲಿಕ್ ಮಾಡಿ **Code** → **Codespaces** ಟ್ಯಾಬ್ → **...** → **New with options...** -3. ಡೀಫಾಲ್ಟ್ ಬಳಸಿ – ಇದು ಈ ಕೋರ್ಸ್‌ಗಾಗಿ ರಚಿಸಲಾದ ಡೆವಲಪ್‌ಮೆಂಟ್ ಕಂಟೇನರ್ ಆಯ್ಕೆಮಾಡುತ್ತದೆ -4. ಕ್ಲಿಕ್ ಮಾಡಿ **Create codespace** -5. ಪರಿಸರ ಸಿದ್ಧವಾಗಲು ~2 ನಿಮಿಷಗಳ ಕಾಲ ಕಾಯಿರಿ -6. ನೇರವಾಗಿ [ಮೊದಲ ಉದಾಹರಣೆಗೆ](./02-SetupDevEnvironment/README.md#step-2-create-a-github-personal-access-token) ಸರಿಸಿ +1. ಈ ರೆಪೊಸಿಟೋರಿಯನ್ನು ನಿಮ್ಮ GitHub ಖಾತೆಗೆ ಫೋರ್ಕ್ ಮಾಡಿ +2. **Code** → **Codespaces** ಟ್ಯಾಬ್ → **...** → **New with options...** ಕ್ಲಿಕ್ ಮಾಡಿ +3. ಡೀಫಾಲ್ಟ್ ಆಯ್ಕೆಗಳನ್ನು ಬಳಸಿ – ಇದರಿಂದ ಈ ಕೋರ್ಸ್‌ಗಾಗಿ ರಚಿಸಲಾಗಿರುವ ಡೆವಲಪ್‌ಮೆಂಟ್ ಕಂಟೇನರ್ ಆಯ್ಕೆ ಆಗುತ್ತದೆ +4. **Create codespace** ಕ್ಲಿಕ್ ಮಾಡಿ +5. ಪರಿಸರ ತಯಾರಾಗಲು ಸುಮಾರು 2 ನಿಮಿಷ ಕಾಯಿರಿ +6. ನೇರವಾಗಿ [ಮೊದಲ ಉದಾಹರಣೆ](./02-SetupDevEnvironment/README.md#step-2-create-a-github-personal-access-token) ಗೆ ಹೋಗಿ -> **ಸ್ಥಳೀಯವಾಗಿ ಕ್ಲೋನ್ ಮಾಡಲು ಇಚ್ಛಿಸುವಿರಾ?** +> **ಸ್ಥಳೀಯವಾಗಿ ಕ್ಲೋನ್ ಮಾಡಬೇಕೆ?** > -> ಈ ರೆಪೊಸಿಟರಿಯಲ್ಲಿ 50+ ಭಾಷಾ ಅನುವಾದಗಳು ಇವೆ, ಇದು ಡೌನ್‌ಲೋಡ್ ಗಾತ್ರವನ್ನು ಬಹಳ ಹೆಚ್ಚಿಸುತ್ತದೆ. ಅನುವಾದಗಳಿಲ್ಲದೆ ಕ್ಲೋನ್ ಮಾಡಲು ಸ್ಪಾರ್ಸ್ ಔಟ್‌ಚೆಕ್ ಬಳಸಿ: +> ಈ ರೆಪೊಸಿಟೋರಿಯಲ್ಲಿ 50+ ಭಾಷಾ ಅನುವಾದಗಳಿರುತ್ತವೆ, ಇದರಿಂದ ಡೌನ್‌ಲೋಡ್ ಗಾತ್ರ ಹೆಚ್ಚಾಗುತ್ತದೆ. ಅನುವಾದಗಳು ಇಲ್ಲದೆ ಕ್ಲೋನ್ ಮಾಡಲು sparse checkout ಬಳಸಿರಿ: > ```bash > git clone --filter=blob:none --sparse https://github.com/microsoft/Generative-AI-for-beginners-java.git > cd Generative-AI-for-beginners-java > git sparse-checkout set --no-cone '/*' '!translations' '!translated_images' > ``` -> ಇದರಿಂದ ಕೋರ್ಸ್‌ ಪೂರ್ಣಗೊಳಿಸಲು ಬೇಕಾದ ಎಲ್ಲಾ ವಿಷಯಗಳನ್ನು ಮತ್ತಷ್ಟು ವೇಗವಾಗಿ ಡೌನ್‌ಲೋಡ್ ಮಾಡಬಹುದು. +> ಇದರಿಂದ ವೇಗವಾಗಿ ಡೌನ್‌ಲೋಡ್ ಆಗಿ ಕೋರ್ಸ್ ಪೂರ್ಣಗೊಳಿಸಲು ಬೇಕಾದ ಎಲ್ಲಾ ವಿಷಯಗಳು ಲಭ್ಯವೆಂದು ಖಚಿತವಾಗುತ್ತದೆ. -## ಬಹು-ಭಾಷಾ ಬೆಂಬಲ +## ಬಹುಭಾಷಾ ಬೆಂಬಲ -### GitHub Action ಮೂಲಕ ಬೆಂಬಲಿತ (ಸ್ವಯಂಚಾಲಿತ & ಸದಾ ನವೀಕರಿಸಿದ) +### GitHub ಕಾರ್ಯಾಚರಣೆ (ಸ್ವಚಾಲಿತ ಮತ್ತು ಸದಾ ನವೀಕರಣವಾಗಿದೆ) ಮೂಲಕ ಬೆಂಬಲಿಸಲಾಗಿದೆ -[ಅರೇಬಿಕ್](../ar/README.md) | [ಬಂಗಾಳಿ](../bn/README.md) | [ಬಲ್ಗೇರಿಯನ್](../bg/README.md) | [ಬರ್ಮೀಸ್ (ಮಯಾನ್ಮಾರ್)](../my/README.md) | [ಚೀನೀಸ್ (ಸರಳೀಕೃತ)](../zh/README.md) | [ಚೀನೀಸ್ (ಪಾರಂಪರಿಕ, ಹಾಂಗ್ ಕಾಂಗ್)](../hk/README.md) | [ಚೀನೀಸ್ (ಪಾರಂಪರಿಕ, ಮಾರಾಕ್ಯು)](../mo/README.md) | [ಚೀನೀಸ್ (ಪಾರಂಪರಿಕ, ತೈವಾನ್)](../tw/README.md) | [ಕ್ರೋಯೇಷಿಯನ್](../hr/README.md) | [ಸೆಕ್](../cs/README.md) | [ಡ್ಯಾನಿಶ್](../da/README.md) | [ಡಚ್](../nl/README.md) | [ಎಸ್ಟೋನಿಯನ್](../et/README.md) | [ಫಿನ್ನಿಶ್](../fi/README.md) | [ಫ್ರೆಂಚ್](../fr/README.md) | [ಜರ್ಮನ್](../de/README.md) | [ಗ್ರೀಕ್](../el/README.md) | [ಹೀಬ್ರೂ](../he/README.md) | [ಹಿಂದಿ](../hi/README.md) | [ಹಂಗೇರಿಯನ್](../hu/README.md) | [ಇಂಡೋನೇಶಿಯನ್](../id/README.md) | [ಇಟಾಲಿಯನ್](../it/README.md) | [ಜಪಾನೀಸ್](../ja/README.md) | [ಕನ್ನಡ](./README.md) | [ಕೊರಿಯನ್](../ko/README.md) | [ಲಿಥೋನಿಯನ್](../lt/README.md) | [ಮಲೇ](../ms/README.md) | [ಮಲಯಾಳಂ](../ml/README.md) | [ಮರಾಠಿ](../mr/README.md) | [ನೆಪಾಳಿ](../ne/README.md) | [ನಿಜೀರಿಯನ್ ಪಿಡ್ಗಿನ್](../pcm/README.md) | [ನಾರ್ವೇಜಿಯನ್](../no/README.md) | [ಪರ್ಷಿಯನ್ (ಫಾರ್ಸಿ)](../fa/README.md) | [ಪೋಲಿಷ್](../pl/README.md) | [ಪೋರ್ಚುಗೀಸ್ (ಬ್ರೆಜಿಲ್)](../br/README.md) | [ಪೋರ್ಚುಗೀಸ್ (ಪೋರ್ಚುಗಲ್)](../pt/README.md) | [ಪಂಜಾಬಿ (ಗುರ್ಮುಖಿ)](../pa/README.md) | [ರೊಮಾನಿಯನ್](../ro/README.md) | [ರಷ್ಯನ್](../ru/README.md) | [ಸರ್ಬಿಯನ್ (ಸಿರಿಲಿಕ್)](../sr/README.md) | [ಸ್ಲೋವಾಕ್](../sk/README.md) | [ಸ್ಲೋವೇನಿಯನ್](../sl/README.md) | [ಸ್ಪ್ಯಾನಿಷ್](../es/README.md) | [ಸ್ವಾಹಿಲಿ](../sw/README.md) | [ಸ್ವೀಡಿಷ್](../sv/README.md) | [ಟಾಗಾಲೋಗ್ (ಫಿಲಿಪಿನೋ)](../tl/README.md) | [ತಮಿಳು](../ta/README.md) | [ತೆಲುಗು](../te/README.md) | [ಥಾಯ್](../th/README.md) | [ಟರ್ಕಿಶ್](../tr/README.md) | [ಉಕ್ರೇನಿಯನ್](../uk/README.md) | [ಉರ್ದು](../ur/README.md) | [ವಿಯೆಟ್ನಾಮೀಸ್](../vi/README.md) +[ಅರಬಿಕ್](../ar/README.md) | [ಬೆಂಗಾಲಿ](../bn/README.md) | [ಬಲ್ಗೇರಿಯನ್](../bg/README.md) | [ಬರ್ಮೀಸ್ (ಮಯನ್ಮಾರ್)](../my/README.md) | [ಚೀನಿ (ಸರಳೀಕೃತ)](../zh-CN/README.md) | [ಚೀನಿ (ಸಾಂಪ್ರದಾಯಿಕ, ಹಾಂಗ್ ಕಾಂಗ್)](../zh-HK/README.md) | [ಚೀನಿ (ಸಾಂಪ್ರದಾಯಿಕ, ಮಕಾವು)](../zh-MO/README.md) | [ಚೀನಿ (ಸಾಂಪ್ರದಾಯಿಕ, ತೈವಾನ್)](../zh-TW/README.md) | [ಕ್ರೊಯೇಶಿಯನ್](../hr/README.md) | [ಸೆಕ್](../cs/README.md) | [ಡ್ಯಾನಿಷ್](../da/README.md) | [ಡಚ್](../nl/README.md) | [ಎಸ್ಟೋನಿಯನ್](../et/README.md) | [ಫಿನ್ನಿಷ್](../fi/README.md) | [ಫ್ರೆಂಚ್](../fr/README.md) | [ಜರ್ಮನ್](../de/README.md) | [ಗ್ರೀಕ್](../el/README.md) | [ಹೆಬ್ರೂ](../he/README.md) | [ಹಿಂದಿ](../hi/README.md) | [ಹಂಗೇರಿಯನ್](../hu/README.md) | [ಇಂಡೋನೀಷಿಯನ್](../id/README.md) | [ಇಟಾಲಿಯನ್](../it/README.md) | [ಜಪಾನೀಸ್](../ja/README.md) | [ಕನ್ನಡ](./README.md) | [ಕೊರಿಯನ್](../ko/README.md) | [ಲಿಥುವೇನಿಯನ್](../lt/README.md) | [ಮಲಯ್](../ms/README.md) | [ಮಲಯಾಳಂ](../ml/README.md) | [ಮರಾಠಿ](../mr/README.md) | [ನೇಪಾಳಿ](../ne/README.md) | [ನೈಜೀರೀಯನ್ ಪಿಡ್ಗಿನ್](../pcm/README.md) | [ನಾರ್ವೀಜಿಯನ್](../no/README.md) | [ಪರ್ಶನ್ಸ್ (ಫಾರ್ಸಿ)](../fa/README.md) | [ಪೋಲಿಷ್](../pl/README.md) | [ಪೋರ್ಟುಗೀಸ್ (ಬ್ರಾಜಿಲ್)](../pt-BR/README.md) | [ಪೋರ್ಟುಗೀಸ್ (ಪೋರ್ಟುಗಾಲ್)](../pt-PT/README.md) | [ಪಂಜಾಬಿ (ಗੁਰुमುಖಿ)](../pa/README.md) | [ರೊಮೇನಿಯನ್](../ro/README.md) | [ರಷ್ಯನ್](../ru/README.md) | [ಸರ್ಬಿಯನ್ (ಸಿರಿಲಿಕ್)](../sr/README.md) | [ಸ್ಲೋವಾಕ್](../sk/README.md) | [ಸ್ಲೋವೇನಿಯನ್](../sl/README.md) | [ಸ್ಪ್ಯಾನಿಷ್](../es/README.md) | [ಸ್ವಾಹಿಲಿ](../sw/README.md) | [ಸ್ವೀಡಿಶ್](../sv/README.md) | [ತಗಾಲೊಗ್ (ಫಿಲಿಪಿನೋ)](../tl/README.md) | [ತಮಿಳು](../ta/README.md) | [ತೆಲುಗು](../te/README.md) | [ಥಾಯಿ](../th/README.md) | [ತುರ್ಕಿಷ್](../tr/README.md) | [ಉಕ್ರೇನಿಯನ್](../uk/README.md) | [ಉರ್ದು](../ur/README.md) | [ವಿಯೆಟ್ನಾಮಿ](../vi/README.md) -> **ಸ್ಥಳೀಯವಾಗಿ ಕ್ಲೋನ್ ಮಾಡಲು ಇಚ್ಛಿಸುವಿರಾ?** +> **ಸ್ಥಳೀಯವಾಗಿ ಕ್ಲೋನ್ ಮಾಡಬೇಕೆ?** -> ಈ ರೆಪೊಸಿಟರಿಯಲ್ಲಿ 50+ ಭಾಷಾ ಅನುವಾದಗಳು ಇವೆ, ಇದು ಡೌನ್‌ಲೋಡ್ ಗಾತ್ರವನ್ನು ಬಹಳ ಹೆಚ್ಚಿಸುತ್ತದೆ. ಅನುವಾದಗಳಿಲ್ಲದೆ ಕ್ಲೋನ್ ಮಾಡಲು ಸ್ಪಾರ್ಸ್ ಔಟ್‌ಚೆಕ್ ಬಳಸಿ: +> ಈ ರೆಪೊಸಿಟೋರಿಯಲ್ಲಿ 50+ ಭಾಷಾ ಅನುವಾದಗಳಿರುತ್ತವೆ, ಇದರಿಂದ ಡೌನ್‌ಲೋಡ್ ಗಾತ್ರ ಹೆಚ್ಚಾಗುತ್ತದೆ. ಅನುವಾದಗಳು ಇಲ್ಲದೆ ಕ್ಲೋನ್ ಮಾಡಲು sparse checkout ಬಳಸಿರಿ: > ```bash > git clone --filter=blob:none --sparse https://github.com/microsoft/Generative-AI-for-beginners-java.git > cd Generative-AI-for-beginners-java > git sparse-checkout set --no-cone '/*' '!translations' '!translated_images' > ``` -> ಇದರಿಂದ ಕೋರ್ಸ್‌ ಪೂರ್ಣಗೊಳಿಸಲು ಬೇಕಾದ ಎಲ್ಲಾ ವಿಷಯಗಳನ್ನು ಮತ್ತಷ್ಟು ವೇಗವಾಗಿ ಡೌನ್‌ಲೋಡ್ ಮಾಡಬಹುದು. +> ಇದರಿಂದ ವೇಗವಾಗಿ ಡೌನ್‌ಲೋಡ್ ಆಗಿ ಕೋರ್ಸ್ ಪೂರ್ಣಗೊಳಿಸಲು ಬೇಕಾದ ಎಲ್ಲಾ ವಿಷಯಗಳು ಲಭ್ಯವೆಂದು ಖಚಿತವಾಗುತ್ತದೆ. -## ಕೋರ್ಸ್ ರಚನೆ ಮತ್ತು ಕಲಿಕೋದ್ದೇಶ +## ಕೋರ್ಸ್ ರಚನೆ ಮತ್ತು ಕಲಿಕೆ ಮಾರ್ಗ ### **ಅಧ್ಯಾಯ 1: ಜನರೇಟಿವ್ AI ಗೆ ಪರಿಚಯ** -- **ಮૂಲೋತ್ಪತ್ತಿ ತತ್ವಗಳು**: ದೊಡ್ಡ ಭಾಷಾ ಮಾದರಿಗಳ, ಟೋಕನ್ಸ್, ಎಂಬರ್‍ಡಿಂಗ್‌ಗಳು ಮತ್ತು AI ಸಾಮರ್ಥ್ಯಗಳ ಅರ್ಥ -- **ಜಾವಾ AI ಪರಿಸರ**: ಸ್ಪ್ರಿಂಗ್ AI ಮತ್ತು OpenAI SDK ಗಳ ಪರಿಚಯ -- **ಮಾದರಿ ಸಾಂದರ್ಭಿಕ ಪ್ರೋಟೋಕಾಲ್**: MCP ಮತ್ತು AI ಏಜೆಂಟ್ ಸಂವಹನದಲ್ಲಿ ಅದರ ಪಾತ್ರ -- **ಪ್ರಾಯೋಗಿಕ ಅನ್ವಯಗಳು**: ಚಾಟ್‌ಬಾಟ್‌ಗಳು ಮತ್ತು ವಿಷಯ ಉತ್ಪಾದನೆহಾಗಾದ ವಾಸ್ತವಿಕ ಪರಿಸ್ಥಿತಿಗಳು +- **ಮೂಲ ತತ್ವಗಳು**: ದೊಡ್ಡ ಭಾಷಾ ಮಾದರಿಗಳು, ಟೋಕನ್ಗಳು, ಎಂಬರ್‌ಡಿಂಗ್‌ಗಳು ಮತ್ತು AI ಸಾಮರ್ಥ್ಯಗಳನ್ನು ಅರ್ಥಮಾಡಿಕೊಳ್ಳುವುದು +- **ಜಾವಾ AI ಪರಿಸರ**: ಸ್ಪ್ರಿಂಗ್ AI ಮತ್ತು OpenAI SDK ಗಳ ಮಾದರಿಯ ಅವಲೋಕನ +- **ಮಾದರಿ ಸಂದರ್ಭ ಪ್ರೋಟೋಕಾಲ್**: MCP ಪರಿಚಯ ಮತ್ತು AI ಏಜೆಂಟ್ ಸಂವಹನದಲ್ಲಿ ಅದರ ಪಾತ್ರ +- **ವ್ಯವಹಾರಿಕ ಅನ್ವಯಗಳು**: ಚಾಟ್‌ಬಾಟ್‌ಗಳು ಮತ್ತು ವಿಷಯ ನಿರ್ಮಾಣ ಸೇರಿದಂತೆ ನೈಜ ಪ್ರಪಂಚದ ದೃಶ್ಯಗಳು - **[→ ಅಧ್ಯಾಯ 1 ಪ್ರಾರಂಭಿಸಿ](./01-IntroToGenAI/README.md)** -### **ಅಧ್ಯಾಯ 2: ಡೆವಲಪ್‌ಮೆಂಟ್ ಪರಿಸರ ಸ್ಥಾಪನೆ** -- **ಬಹು-ಪ್ರದಾತೃ ಸಂರಚನೆ**: GitHub Models, Azure OpenAI, ಮತ್ತು OpenAI Java SDK ಸಂಯೋಜನೆ -- **ಸ್ಪ್ರಿಂಗ್ ಬೂಟ್ + ಸ್ಪ್ರಿಂಗ್ AI**: ಎಂಟರ್ಪ್ರೈಸ್ AI ಅನ್ವಯದ ಉತ್ತಮ ಅಭ್ಯಾಸಗಳು +### **ಅಧ್ಯಾಯ 2: ಅಭಿವೃದ್ಧಿ ಪರಿಸರ ಸೆಟ್‌ಅಪ್** +- **ಬಹು-ಪ್ರದಾನಗಾರ ಕಾನ್ಫಿಗರೇಶನ್**: GitHub Models, Azure OpenAI ಮತ್ತು OpenAI ಜಾವಾ SDK ಏಕರೂಪಗೊಳಿಸುವಿಕೆ +- **ಸ್ಪ್ರಿಂಗ್ ಬೂಟ್ + ಸ್ಪ್ರಿಂಗ್ AI**: ಉದ್ಯಮ AI ಆಪ್ ಅಭಿವೃದ್ಧಿಗಾಗಿ ಉತ್ತಮ ಅಭ್ಯಾಸಗಳು - **GitHub Models**: ಪ್ರೋಟೋಟೈಪಿಂಗ್ ಮತ್ತು ಕಲಿಕೆಗೆ ಉಚಿತ AI ಮಾದರಿ ಪ್ರವೇಶ (ಕ್ರೆಡಿಟ್ ಕಾರ್ಡ್ ಅಗತ್ಯವಿಲ್ಲ) -- **ಡೆವಲಪ್‌ಮೆಂಟ್ ಸಾಧನಗಳು**: ಡಾಕರ್ ಕಂಟೇನರ್‌ಗಳು, VS ಕೋಡ್ ಮತ್ತು GitHub Codespaces ಸಂರಚನೆ +- **ಅಭಿವೃದ್ಧಿ ಸಾಧನಗಳು**: ಡಾಕರ್ ಕಂಟೇನರ್‌ಗಳು, VS ಕೋಡ್ ಮತ್ತು GitHub Codespaces ಕಾನ್ಫಿಗರೇಶನ್ - **[→ ಅಧ್ಯಾಯ 2 ಪ್ರಾರಂಭಿಸಿ](./02-SetupDevEnvironment/README.md)** -### **ಅಧ್ಯಾಯ 3: ಮುಖ್ಯ ಜನರೇಟಿವ್ AI ತಂತ್ರಗಳು** -- **ಪ್ರಾಂಪ್ಟ್ ಎಂಜಿನಿಯರಿಂಗ್**: ಪರಿಪೂರ್ಣ AI ಮಾದರಿ ಪ್ರತಿಕ್ರಿಯೆಗಾಗಿ ತಂತ್ರಗಳು -- **ಎಂಬರ್‍ಡಿಂಗ್‌ಗಳು ಮತ್ತು ವೆಕ್ಟರ್ ಕಾರ್ಯಾಚರಣೆಗಳು**: ಅರ್ಥಪೂರ್ಣ ಹುಡುಕಾಟ ಮತ್ತು ಸ್ಪಷ್ಟತಾ ಹೊಂದಾಣಿಕೆ -- **ಪುನರುದ್ಧಾರ-ಸಂಬಂಧಿತ ಉತ್ಪಾದನೆ (RAG)**: ನಿಮ್ಮ ಸ್ವಂತ ಡೇಟಾ ಸಂಪನ್ಮೂಲಗಳೊಂದಿಗೆ AI ಸಂಯೋಜನೆ -- **ಫಂಕ್ಷನ್ ಕರೆ**: ಕಸ್ಟಮ್ ಸಾಧನಗಳು ಮತ್ತು ಪ್ಲಗ್ ಇನ್‌ಗಳೊಂದಿಗೆ AI ಸಾಮರ್ಥ್ಯ ವಿಸ್ತರಣೆ +### **ಅಧ್ಯಾಯ 3: ಮೂಲ ಜನರೇಟಿವ್ AI ತಂತ್ರಜ್ಞಾನಗಳು** +- **ಪ್ರಾಂಪ್ಟ್ ಎಂಜನಿಯರಿಂಗ್**: ಉತ್ತಮ AI ಮಾದರಿ ಪ್ರತಿಕ್ರಿಯೆಗಳ ತಂತ್ರಗಳು +- **ಎಂಬರ್‌ಡಿಂಗ್‌ಗಳು ಮತ್ತು ವೆಕ್ಟರ್ ಕಾರ್ಯಾಚರಣೆಗಳು**: ಅರ್ಥವಂತ ಹುಡುಕಾಟ ಮತ್ತು ಸಾದೃಶ್ಯ ಹೊಂದಾಣಿಕೆ +- **ರಿಟ್ರಿವಲ್-ಆಗ್ಮೆಂಟೆಡ್ ಜನರೇಶನ್ (RAG)**: ನಿಮ್ಮದೇ ಡೇಟಾ ಮೂಲಗಳೊಂದಿಗೆ AI ಸಂಯೋಜನೆ +- **ಫಂಕ್ಷನ್ ಕಾಲಿಂಗ್**: ಕಸ್ಟಮ್ ಸಾಧನಗಳು ಮತ್ತು ಪ್ಲಗಿನ್‌ಗಳೊಂದಿಗೆ AI ಸಾಮರ್ಥ್ಯ ವಿಸ್ತರಣೆ - **[→ ಅಧ್ಯಾಯ 3 ಪ್ರಾರಂಭಿಸಿ](./03-CoreGenerativeAITechniques/README.md)** -### **ಅಧ್ಯಾಯ 4: ಪ್ರಾಯೋಗಿಕ ಅನ್ವಯಗಳು ಮತ್ತು ಪ್ರಾಜೆಕ್ಟ್ಗಳು** -- **ಪೆಟ್ ಕಥೆ ಜನರೇಟರ್** (`petstory/`): GitHub Models ಬಳಸಿ ಸೃಜನಾತ್ಮಕ ವಿಷಯ ರಚನೆ -- **ಫೌಂಡರಿ ಸ್ಥಳೀಯ ಪ್ರದರ್ಶನ** (`foundrylocal/`): OpenAI Java SDK ಬಳಸಿ ಸ್ಥಳೀಯ AI ಮಾದರಿ ಸಂಯೋಜನೆ -- **MCP ಕ್ಯಾಲ್ಕ್ಯುಲೇಟರ್ ಸೇವೆ** (`calculator/`): ಸ್ಪ್ರಿಂಗ್ AI ಸಹಿತ ಮೂಲ Model Context ಪ್ರೋಟೋಕಾಲ್ ಅನ್ವಯ +### **ಅಧ್ಯಾಯ 4: ವ್ಯಾಪಾರಿಕ ಅನ್ವಯಗಳು ಮತ್ತು ಯೋಜನೆಗಳು** +- **ಪೆಟ್ ಸ್ಟೋರಿ ಜನರೇಟರ್** (`petstory/`): GitHub Models ಮೂಲಕ ಸೃಜನಾತ್ಮಕ ವಿಷಯ ನಿರ್ಮಾಣ +- **ಫೌಂಡ್ರಿ ಲೋಕಲ್ ಡೆಮೋ** (`foundrylocal/`): OpenAI ಜಾವಾ SDK ಜೊತೆಗೆ ಸ್ಥಳೀಯ AI ಮಾದರಿ ಏಕರೂಪಗೊಳಿಸುವಿಕೆ +- **MCP ಕ್ಯಾಲ್ಕ್ಯುಲೇಟರ್ ಸರ್ವಿಸ್** (`calculator/`): ಸ್ಪ್ರಿಂಗ್ AI ಜೊತೆಗೆ ಮೂಲ Model Context Protocol ಅನುಷ್ಠಾನ - **[→ ಅಧ್ಯಾಯ 4 ಪ್ರಾರಂಭಿಸಿ](./04-PracticalSamples/README.md)** -### **ಅಧ್ಯಾಯ 5: ಜವಾಬ್ದಾರಿಯುತ AI ಅಭಿವೃದ್ಧಿ** -- **GitHub Models ಸುರಕ್ಷತೆ**: ನಿರ್ಮಿತ ವಿಷಯ ಪರಿಸರೀಕರಣ ಮತ್ತು ಸುರಕ್ಷತಾ ಯಂತ್ರಗಳನ್ನು ಪರೀಕ್ಷೆ ಮಾಡಲಾಗುತ್ತದೆ (ಕಠಿಣ ತಡೆಗಳು ಮತ್ತು ಮೃದು ನಿರಾಕರಣೆಗಳು) -- **ಜವಾಬ್ದಾರಿಯುತ AI ಪ್ರದರ್ಶನ**: ಆಧುನಿಕ AI ಸುರಕ್ಷತಾ ವ್ಯವಸ್ಥೆಗಳು ಪ್ರಾಯೋಗಿಕವಾಗಿ ಹೇಗೆ ಕೆಲಸಮಾಡುತ್ತವೆ ಎಂಬ ಉದಾಹರಣೆ -- **ಉತ್ತಮ ಅಭ್ಯಾಸಗಳು**: ನೈತಿಕ AI ಅಭಿವೃದ್ಧಿ ಮತ್ತು ನಿಯೋಜನೆಗಾಗಿ ಅಗತ್ಯ ಮಾರ್ಗಸೂಚಿಗಳು +### **ಅಧ್ಯಾಯ 5: ಹೊಣೆಗಾರ AI ಅಭಿವೃದ್ಧಿ** +- **GitHub Models ಸುರಕ್ಷತೆ**: ಒಳಗಿರುವ ವಿಷಯ ಶೋಧನೆ ಮತ್ತು ಸುರಕ್ಷತಾ ಯಂತ್ರಗಳನ್ನು ಪರೀಕ್ಷೆ (ಕಠಿಣ ತಡೆ ಮತ್ತು ಮೃದು ನಿರಾಕರಣೆಗಳು) +- **ಒತ್ತಾಯದ AI ಡೆಮೋ**: ಆಧುನಿಕ AI ಸುರಕ್ಷತಾ ವ್ಯವಸ್ಥೆಗಳು ಹೇಗೆ ಕೆಲಸ ಮಾಡುತ್ತವೆ ಎಂಬ ಲೈವ್ ಉದಾಹರಣೆ +- **ಅತ್ಯುತ್ತಮ ಅಭ್ಯಾಸಗಳು**: ನೈತಿಕ AI ಅಭಿವೃದ್ಧಿ ಮತ್ತು ನಿಯೋಜನೆಗಾಗಿ ಅಗತ್ಯ ಮಾರ್ಗದರ್ಶಕಗಳು - **[→ ಅಧ್ಯಾಯ 5 ಪ್ರಾರಂಭಿಸಿ](./05-ResponsibleGenAI/README.md)** ## ಹೆಚ್ಚುವರಿ ಸಂಪನ್ಮೂಲಗಳು @@ -95,7 +86,7 @@ CO_OP_TRANSLATOR_METADATA: --- -### ಅಜೂರ್ / ಎಡ್ಜ್ / MCP / ಏಜೆಂಟ್‌ಗಳು +### ಅಜೂರ್ / ಎಡ್ಜ್ / MCP / ಏಜೆಂಟ್ಸ್ [![AZD for Beginners](https://img.shields.io/badge/AZD%20for%20Beginners-0078D4?style=for-the-badge&labelColor=E5E7EB&color=0078D4)](https://github.com/microsoft/AZD-for-beginners?WT.mc_id=academic-105485-koreyst) [![Edge AI for Beginners](https://img.shields.io/badge/Edge%20AI%20for%20Beginners-00B8E4?style=for-the-badge&labelColor=E5E7EB&color=00B8E4)](https://github.com/microsoft/edgeai-for-beginners?WT.mc_id=academic-105485-koreyst) [![MCP for Beginners](https://img.shields.io/badge/MCP%20for%20Beginners-009688?style=for-the-badge&labelColor=E5E7EB&color=009688)](https://github.com/microsoft/mcp-for-beginners?WT.mc_id=academic-105485-koreyst) @@ -116,31 +107,32 @@ CO_OP_TRANSLATOR_METADATA: [![Data Science for Beginners](https://img.shields.io/badge/Data%20Science%20for%20Beginners-84CC16?style=for-the-badge&labelColor=E5E7EB&color=84CC16)](https://aka.ms/datascience-beginners?WT.mc_id=academic-105485-koreyst) [![AI for Beginners](https://img.shields.io/badge/AI%20for%20Beginners-A3E635?style=for-the-badge&labelColor=E5E7EB&color=A3E635)](https://aka.ms/ai-beginners?WT.mc_id=academic-105485-koreyst) [![Cybersecurity for Beginners](https://img.shields.io/badge/Cybersecurity%20for%20Beginners-F97316?style=for-the-badge&labelColor=E5E7EB&color=F97316)](https://github.com/microsoft/Security-101?WT.mc_id=academic-96948-sayoung) -[![Web Dev for Beginners](https://img.shields.io/badge/Web%20Dev%20for%20Beginners-EC4899?style=for-the-badge&labelColor=E5E7EB&color=EC4899)](https://aka.ms/webdev-beginners?WT.mc_id=academic-105485-koreyst) -[![ಆರಂಭಿಕರಿಗೆ ಐಒಟಿ](https://img.shields.io/badge/IoT%20for%20Beginners-14B8A6?style=for-the-badge&labelColor=E5E7EB&color=14B8A6)](https://aka.ms/iot-beginners?WT.mc_id=academic-105485-koreyst) -[![ಆರಂಭಿಕರಿಗೆ XR ಅಭಿವೃದ್ಧಿ](https://img.shields.io/badge/XR%20Development%20for%20Beginners-38BDF8?style=for-the-badge&labelColor=E5E7EB&color=38BDF8)](https://github.com/microsoft/xr-development-for-beginners?WT.mc_id=academic-105485-koreyst) + +[![ಸೂತ್ರಕಾರರಿಗೆ ವೆಬ್ ಡೆವ್](https://img.shields.io/badge/Web%20Dev%20for%20Beginners-EC4899?style=for-the-badge&labelColor=E5E7EB&color=EC4899)](https://aka.ms/webdev-beginners?WT.mc_id=academic-105485-koreyst) +[![ಸೂತ್ರಕಾರರಿಗೆ ಇಂಟರ್ನೆಟ್ ಆಫ್ ಥಿಂಗ್ಸ್](https://img.shields.io/badge/IoT%20for%20Beginners-14B8A6?style=for-the-badge&labelColor=E5E7EB&color=14B8A6)](https://aka.ms/iot-beginners?WT.mc_id=academic-105485-koreyst) +[![ಸೂತ್ರಕಾರರಿಗೆ XR ಅಭಿವೃದ್ಧಿ](https://img.shields.io/badge/XR%20Development%20for%20Beginners-38BDF8?style=for-the-badge&labelColor=E5E7EB&color=38BDF8)](https://github.com/microsoft/xr-development-for-beginners?WT.mc_id=academic-105485-koreyst) --- -### ಕೋಪೈಲಟ್ ಸರಣಿ -[![AI ಜೋಡಣೆ ಕಾರ್ಯಕ್ರಮಕ್ಕಾಗಿ ಕೋಪೈಲಟ್](https://img.shields.io/badge/Copilot%20for%20AI%20Paired%20Programming-FACC15?style=for-the-badge&labelColor=E5E7EB&color=FACC15)](https://aka.ms/GitHubCopilotAI?WT.mc_id=academic-105485-koreyst) -[![C#/.NETಗಾಗಿ ಕೋಪೈಲಟ್](https://img.shields.io/badge/Copilot%20for%20C%23/.NET-FBBF24?style=for-the-badge&labelColor=E5E7EB&color=FBBF24)](https://github.com/microsoft/mastering-github-copilot-for-dotnet-csharp-developers?WT.mc_id=academic-105485-koreyst) -[![ಕೋಪೈಲಟ್ ಸಾಹಸ](https://img.shields.io/badge/Copilot%20Adventure-FDE68A?style=for-the-badge&labelColor=E5E7EB&color=FDE68A)](https://github.com/microsoft/CopilotAdventures?WT.mc_id=academic-105485-koreyst) +### ಸಹ ಚಾಲಕರು ಸರಣಿ +[![ಕೃತ್ರಿಮ ಬುದ್ಧಿಮತ್ತೆ ಜೊತೆಯ ಪ್ರೋಗ್ರಾಮಿಂಗ್‌ಗಾಗಿ ಸಹ ಚಾಲಕ](https://img.shields.io/badge/Copilot%20for%20AI%20Paired%20Programming-FACC15?style=for-the-badge&labelColor=E5E7EB&color=FACC15)](https://aka.ms/GitHubCopilotAI?WT.mc_id=academic-105485-koreyst) +[![C#/.NET ಗೆ ಸಹ ಚಾಲಕ](https://img.shields.io/badge/Copilot%20for%20C%23/.NET-FBBF24?style=for-the-badge&labelColor=E5E7EB&color=FBBF24)](https://github.com/microsoft/mastering-github-copilot-for-dotnet-csharp-developers?WT.mc_id=academic-105485-koreyst) +[![ಸಹ ಚಾಲಕರು ಸಾಹಸ](https://img.shields.io/badge/Copilot%20Adventure-FDE68A?style=for-the-badge&labelColor=E5E7EB&color=FDE68A)](https://github.com/microsoft/CopilotAdventures?WT.mc_id=academic-105485-koreyst) ## ಸಹಾಯ ಪಡೆಯುವುದು -ನೀವು ಅಡಗಿದಿದ್ದರೆ ಅಥವಾ AI ಅಪ್ಲಿಕೇಷನ್ಸ್ ನಿರ್ಮಿಸುವ ಬಗ್ಗೆ ಯಾವುದೇ ಪ್ರಶ್ನೆಗಳಿದ್ದರೆ, MCP ಕುರಿತು ಸಹರಸಿ ಕಲಿಯುವವರು ಮತ್ತು ಅನುಭವೀ ಡೆವಲಪರ್‌ಗಳ ચર્ચೆಗಳಲ್ಲಿ ಸೇರಿ. ಇದು ಪ್ರೊತ್ಸಾಹಕಾರಿ ಸಮುದಾಯವಾಗಿದ್ದು, ಇಲ್ಲಿ ಪ್ರಶ್ನೆಗಳನ್ನು ಸ್ವಾಗತಿಸಲಾಗುತ್ತದೆ ಮತ್ತು ಜ್ಞಾನವನ್ನು ಮುಕ್ತವಾಗಿ ಹಂಚಿಕೊಳ್ಳಲಾಗುತ್ತದೆ. +ನೀವು ಅडकಿದಾಗ ಅಥವಾ AI ಅಪ್ಲಿಕೇಶನ್ಗಳು ನಿರ್ಮಿಸುವ ಬಗ್ಗೆ ಯಾವುದೇ ಪ್ರಶ್ನೆಗಳಿದ್ದರೆ. MCP ಕುರಿತು ಚರ್ಚೆಗಳಲ್ಲಿ ಸಹ ಕಲಿಯುವರು ಮತ್ತು ಅನುಭವ ಹೊಂದಿರುವ ಡೆವಲಪರ್‌ಗಳுடன் ಸೇರಿ. ಇದು ಬರವಣಿಗೆಯ ಒಪ್ಪಿಗೆಯ ಸಮುದಾಯವಾಗಿದ್ದು, ಪ್ರಶ್ನೆಗಳನ್ನು ಸ್ವಾಗತಿಸುತ್ತದೆ ಮತ್ತು ಜ್ಞಾನವನ್ನು ಮುಕ್ತವಾಗಿ ಹಂಚಿಕೊಳ್ಳಲಾಗುತ್ತದೆ. [![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) -ನಿಮ್ಮ ಲೇಖನ ಅಭಿಪ್ರಾಯ ಅಥವಾ ನಿರ್ಮಾಣ ಸಂದರ್ಭದಲ್ಲಿ ದೋಷಗಳಿದ್ದರೆ ಸಂಗ್ರಹಿಸಿ ಭೇಟಿ ನೀಡಿ: +ನೀವು ಉತ್ಪನ್ನ ಪ್ರತಿಕ್ರಿಯೆ ಅಥವಾ ದೋಷಗಳನ್ನು ಹೊಂದಿದ್ದರೆ, ನಿರ್ಮಿಸುವಾಗ ಭೇಟಿ ನೀಡಿ: -[![Microsoft Foundry ಡೆವಲಪರ್ ಫೋರಂ](https://img.shields.io/badge/GitHub-Microsoft_Foundry_Developer_Forum-blue?style=for-the-badge&logo=github&color=000000&logoColor=fff)](https://aka.ms/foundry/forum) +[![Microsoft Foundry Developer Forum](https://img.shields.io/badge/GitHub-Microsoft_Foundry_Developer_Forum-blue?style=for-the-badge&logo=github&color=000000&logoColor=fff)](https://aka.ms/foundry/forum) --- -**ಒಪ್ಪಿಕಾ**: -ಈ ದಾಖಲೆ AI ಭಾಷಾಂತರ ಸೇವೆ [Co-op Translator](https://github.com/Azure/co-op-translator) ಬಳಸಿ ಅನುವಾದಿಸಲಾಯಿತು. ನಾವು ಶುದ್ದತೆಯಿಗಾಗಿ ಪ್ರಯತ್ನಿಸಿದ್ದರೂ, ಸ್ವಯಂಕ್ರಿಯ ಭಾಷಾಂತರಗಳಲ್ಲಿ ದೋಷಗಳ ಅಥವಾ ತಪ್ಪುಗಳಿದ್ದುಕಡೆಗೂ ಮನಸ್ಸಿನಲ್ಲಿ ಇಟ್ಟುಕೊಳ್ಳಿ. ಮೂಲ ದಾಖಲೆ ತನ್ನ ಮೂಲ ಭಾಷೆಯಲ್ಲಿ ಪ್ರಾಮಾಣಿಕ ಮೂಲವಾಗಿ ಪರಿಗಣಿಸುವುದು ಉತ್ಕೃಷ್ಟ. ಪ್ರಮುಖ ಮಾಹಿತಿಗಾಗಿ, ವೃತ್ತಿಪರ ಮಾನವ ಭಾಷಾಂತರವನ್ನು ಶಿಫಾರಸು ಮಾಡಲಾಗಿದೆ. ಈ ಭಾಷಾಂತರ ಬಳಕೆಯಿಂದ ಉಂಟಾಗುವ ಯಾವುದೇ ಅರ್ಥಗುಂಜಲಿಕೆ ಅಥವಾ ತಪ್ಪು ಅರ್ಥಗಳನ್ನು ನಾವು ಹೊಣೆ ಹೊಲಿಸಾಮಾಡುವುದಿಲ್ಲ. +**ಹೆಚ್ಚಿನ ಮಾಹಿತಿ**: +ಈ ಡಾಕ್ಯುಮೆಂಟ್ ಅನ್ನು AI ಭಾಷಾಂತರ ಸೇವೆ [Co-op Translator](https://github.com/Azure/co-op-translator) ಬಳಸಿಕೊಂಡು ಭಾಷಾಂತರಿಸಲಾಗಿದೆ. ನಾವು ಶುದ್ಧತೆಯನ್ನು ಉದ್ದೇಶಿಸುವುದಾದರೂ, ಸ್ವಯಂಕ್ರಿಯ ಭಾಷಾಂತರಗಳಲ್ಲಿ ದೋಷಗಳು ಅಥವಾ ಅಸತ್ಯತೆಗಳಿರಬಹುದು ಎಂದು ದಯವಿಟ್ಟು ಗಮನಿಸಿ. ಮೂಲ ಡಾಕ್ಯುಮೆಂಟ್ ಅದರ ಸ್ವದೇಶಿ ಭಾಷೆಯಲ್ಲಿ ಪ್ರಾಮಾಣಿಕ ಮೂಲವಾಗಿದ್ದು ಪರಿಗಣಿಸಬೇಕು. ಗಂಭೀರ ಮಾಹಿತಿಗಾಗಿ ವೃತ್ತಿಪರ ಮಾನವ ಭಾಷಾಂತರವನ್ನು ಶಿಫಾರಸು ಮಾಡಲಾಗುತ್ತದೆ. ಈ ಭಾಷಾಂತರ ಬಳಕೆಯಿಂದ ಉಂಟಾಗುವ ಯಾವುದೇ ತಪ್ಪುಅರ್ಥგಾರಿಕೆಗಳಿಗೆ ನಾವು ಜವಾಬ್ದಾರಿಯಾಗಿ ಇರಲ್ಲ. \ No newline at end of file diff --git a/translations/kn/SECURITY.md b/translations/kn/SECURITY.md index 183fbd2c..ec51ae05 100644 --- a/translations/kn/SECURITY.md +++ b/translations/kn/SECURITY.md @@ -1,12 +1,3 @@ - ## ಭದ್ರತೆ ಮೈಕ್ರೋಸಾಫ್ಟ್ ನಮ್ಮ ಸಾಫ್ಟ್‌ವೇರ್ ಉತ್ಪನ್ನಗಳು ಮತ್ತು ಸೇವೆಗಳ ಭದ್ರತೆಯನ್ನು ಗಂಭೀರವಾಗಿ ಪರಿಗಣಿಸುತ್ತದೆ, ಇದರಲ್ಲಿ ನಮ್ಮ GitHub ಸಂಸ್ಥೆಗಳ ಮೂಲಕ ನಿರ್ವಹಿಸಲ್ಪಡುವ ಎಲ್ಲಾ ಮೂಲ ಕೋಡ್ ರೆಪೊಸಿಟರಿಗಳು ಸೇರಿವೆ, ಉದಾಹರಣೆಗೆ [Microsoft](https://github.com/Microsoft), [Azure](https://github.com/Azure), [DotNet](https://github.com/dotnet), [AspNet](https://github.com/aspnet) ಮತ್ತು [Xamarin](https://github.com/xamarin). diff --git a/translations/kn/SUPPORT.md b/translations/kn/SUPPORT.md index e41e573c..0590b9d7 100644 --- a/translations/kn/SUPPORT.md +++ b/translations/kn/SUPPORT.md @@ -1,12 +1,3 @@ - # ಬೆಂಬಲ ## ಸಮಸ್ಯೆಗಳನ್ನು ದಾಖಲಿಸುವುದು ಮತ್ತು ಸಹಾಯ ಪಡೆಯುವುದು ಹೇಗೆ diff --git a/translations/ko/.co-op-translator.json b/translations/ko/.co-op-translator.json new file mode 100644 index 00000000..0b308464 --- /dev/null +++ b/translations/ko/.co-op-translator.json @@ -0,0 +1,92 @@ +{ + "01-IntroToGenAI/README.md": { + "original_hash": "75bfb080ca725e8a9aa9c80cae25fba1", + "translation_date": "2025-07-29T08:35:27+00:00", + "source_file": "01-IntroToGenAI/README.md", + "language_code": "ko" + }, + "02-SetupDevEnvironment/README.md": { + "original_hash": "96a30d42b9751a3d4e4b20e28d29d459", + "translation_date": "2026-01-28T04:48:27+00:00", + "source_file": "02-SetupDevEnvironment/README.md", + "language_code": "ko" + }, + "02-SetupDevEnvironment/examples/basic-chat-azure/README.md": { + "original_hash": "efd82efe50711d7e257eb943151d682c", + "translation_date": "2025-07-27T13:36:59+00:00", + "source_file": "02-SetupDevEnvironment/examples/basic-chat-azure/README.md", + "language_code": "ko" + }, + "02-SetupDevEnvironment/getting-started-azure-openai.md": { + "original_hash": "bfdb4b4eadbee3a59ef742439f58326a", + "translation_date": "2025-07-27T12:59:22+00:00", + "source_file": "02-SetupDevEnvironment/getting-started-azure-openai.md", + "language_code": "ko" + }, + "03-CoreGenerativeAITechniques/README.md": { + "original_hash": "685f55cb07de19b52a30ce6e8b6d889e", + "translation_date": "2025-08-28T21:59:31+00:00", + "source_file": "03-CoreGenerativeAITechniques/README.md", + "language_code": "ko" + }, + "04-PracticalSamples/README.md": { + "original_hash": "14c0a61ecc1cd2012a9c129236dfdf71", + "translation_date": "2025-07-29T08:35:13+00:00", + "source_file": "04-PracticalSamples/README.md", + "language_code": "ko" + }, + "04-PracticalSamples/calculator/README.md": { + "original_hash": "b6c16b5514d524e415a94f6097ee7d4c", + "translation_date": "2025-09-18T15:27:32+00:00", + "source_file": "04-PracticalSamples/calculator/README.md", + "language_code": "ko" + }, + "04-PracticalSamples/foundrylocal/README.md": { + "original_hash": "f787307400de59adc25a1404466a35f3", + "translation_date": "2025-11-04T07:18:12+00:00", + "source_file": "04-PracticalSamples/foundrylocal/README.md", + "language_code": "ko" + }, + "04-PracticalSamples/petstory/README.md": { + "original_hash": "0cbf68d605615a1e602c832a24616859", + "translation_date": "2025-07-25T11:01:13+00:00", + "source_file": "04-PracticalSamples/petstory/README.md", + "language_code": "ko" + }, + "05-ResponsibleGenAI/README.md": { + "original_hash": "301c05c2f57e60a6950b8c665b8bdbba", + "translation_date": "2025-07-29T15:45:12+00:00", + "source_file": "05-ResponsibleGenAI/README.md", + "language_code": "ko" + }, + "AGENTS.md": { + "original_hash": "afc90918d008cf77fd1982691f681306", + "translation_date": "2025-10-03T08:31:27+00:00", + "source_file": "AGENTS.md", + "language_code": "ko" + }, + "CODE_OF_CONDUCT.md": { + "original_hash": "442b123d034f92f7c384d2bbd28f99f1", + "translation_date": "2025-07-21T15:58:43+00:00", + "source_file": "CODE_OF_CONDUCT.md", + "language_code": "ko" + }, + "README.md": { + "original_hash": "125a08948d881c95628094f4dd1fbd43", + "translation_date": "2026-01-29T15:31:22+00:00", + "source_file": "README.md", + "language_code": "ko" + }, + "SECURITY.md": { + "original_hash": "57f14126c1c6add76b3aef3844dfe4e3", + "translation_date": "2025-07-21T15:56:50+00:00", + "source_file": "SECURITY.md", + "language_code": "ko" + }, + "SUPPORT.md": { + "original_hash": "b8ef73cc49dec68e2c885ee9df545129", + "translation_date": "2025-07-21T15:59:52+00:00", + "source_file": "SUPPORT.md", + "language_code": "ko" + } +} \ No newline at end of file diff --git a/translations/ko/01-IntroToGenAI/README.md b/translations/ko/01-IntroToGenAI/README.md index 815e9a23..2b886f7e 100644 --- a/translations/ko/01-IntroToGenAI/README.md +++ b/translations/ko/01-IntroToGenAI/README.md @@ -1,12 +1,3 @@ - # 생성형 AI 입문 - Java 에디션 ## 학습 목표 diff --git a/translations/ko/02-SetupDevEnvironment/README.md b/translations/ko/02-SetupDevEnvironment/README.md index 38e9d474..e3a84744 100644 --- a/translations/ko/02-SetupDevEnvironment/README.md +++ b/translations/ko/02-SetupDevEnvironment/README.md @@ -1,13 +1,254 @@ - +# Java용 생성 AI 개발 환경 설정 +> **빠른 시작**: 2분 안에 클라우드에서 코딩 - [GitHub Codespaces 설정](../../../02-SetupDevEnvironment)으로 바로 이동 - 로컬 설치 불필요하며 GitHub 모델 사용! + +> **Azure OpenAI에 관심 있으신가요?** 새 Azure OpenAI 리소스 생성 단계를 담은 [Azure OpenAI 설정 가이드](getting-started-azure-openai.md)를 확인하세요. + +## 배울 내용 + +- AI 애플리케이션용 Java 개발 환경 설정 +- 선호하는 개발 환경 선택 및 구성(Cloud-first Codespaces, 로컬 개발 컨테이너, 전체 로컬 설치) +- GitHub 모델 연결하여 설정 테스트 + +## 목차 + +- [배울 내용](../../../02-SetupDevEnvironment) +- [소개](../../../02-SetupDevEnvironment) +- [1단계: 개발 환경 설정](../../../02-SetupDevEnvironment) + - [옵션 A: GitHub Codespaces (권장)](../../../02-SetupDevEnvironment) + - [옵션 B: 로컬 개발 컨테이너](../../../02-SetupDevEnvironment) + - [옵션 C: 기존 로컬 설치 사용](../../../02-SetupDevEnvironment) +- [2단계: GitHub 개인 액세스 토큰 생성](../../../02-SetupDevEnvironment) +- [3단계: GitHub 모델 예제로 설정 테스트](../../../02-SetupDevEnvironment) +- [문제 해결](../../../02-SetupDevEnvironment) +- [요약](../../../02-SetupDevEnvironment) +- [다음 단계](../../../02-SetupDevEnvironment) + +## 소개 + +이 장에서는 개발 환경 설정 방법을 안내합니다. 주요 예제로 **GitHub Models**를 사용합니다. GitHub 계정만 있으면 무료로 쉽게 설정할 수 있고 신용카드가 필요 없으며 다양한 모델을 실험할 수 있기 때문입니다. + +**로컬 설정 불필요!** GitHub Codespaces를 사용하면 브라우저에서 바로 전체 개발 환경으로 코딩을 시작할 수 있습니다. + +스크린샷: GitHub Models + +이 과정에는 [**GitHub Models**](https://github.com/marketplace?type=models)를 권장합니다. 이유는: +- **무료**로 시작 가능 +- GitHub 계정만 있으면 **간편**하게 설정 가능 +- **신용카드 불필요** +- 다양한 **모델 실험** 가능 + +> **참고**: 본 교육에서 사용하는 GitHub Models에는 다음과 같은 무료 제한이 있습니다: +> - 분당 15회 요청(일 150회) +> - 요청당 약 8,000 단어 입력, 약 4,000 단어 출력 +> - 동시 요청 5개 +> +> 프로덕션용으로는 Azure 계정으로 Azure AI Foundry Models로 업그레이드하세요. 코드는 변경할 필요 없습니다. [Azure AI Foundry 문서](https://learn.microsoft.com/azure/ai-foundry/foundry-models/how-to/quickstart-github-models)를 참고하세요. + + +## 1단계: 개발 환경 설정 + + + +Generative AI for Java 과정을 위한 모든 필수 도구를 갖춘 미리 구성된 개발 컨테이너를 제공하여 설정 시간을 최소화했습니다. 원하는 개발 방식을 선택하세요: + +### 환경 설정 옵션: + +#### 옵션 A: GitHub Codespaces (권장) + +**2분 안에 코딩 시작 — 로컬 설치 필요 없음!** + +1. 이 저장소를 GitHub 계정으로 포크하세요 + > **참고**: 기본 구성을 수정하려면 [개발 컨테이너 구성](../../../.devcontainer/devcontainer.json)을 참고하세요 +2. **Code** → **Codespaces** 탭 → **...** → **New with options...** 클릭 +3. 기본값을 사용하세요 – 이 과정용으로 만든 **Generative AI Java Development Environment** 커스텀 개발 컨테이너 구성이 선택됩니다 +4. **Create codespace** 클릭 +5. 환경 준비까지 약 2분 기다리기 +6. [2단계: GitHub 토큰 생성](../../../02-SetupDevEnvironment)으로 진행 + +스크린샷: Codespaces 하위 메뉴 + +스크린샷: New with options + +스크린샷: Create codespace 옵션 + + +> **Codespaces의 장점**: +> - 로컬 설치 불필요 +> - 브라우저가 있는 모든 기기에서 사용 가능 +> - 모든 도구와 의존성을 미리 구성 +> - 개인 계정에 월 60시간 무료 제공 +> - 모든 학습자에게 일관된 환경 제공 + +#### 옵션 B: 로컬 개발 컨테이너 + +**Docker를 이용한 로컬 개발 선호자용** + +1. 이 저장소를 포크하고 로컬로 클론하세요 + > **참고**: 기본 구성을 수정하려면 [개발 컨테이너 구성](../../../.devcontainer/devcontainer.json)을 참고하세요 +2. [Docker Desktop](https://www.docker.com/products/docker-desktop/)과 [VS Code](https://code.visualstudio.com/) 설치 +3. VS Code에서 [Dev Containers 확장](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers) 설치 +4. VS Code로 저장소 폴더 열기 +5. 프롬프트가 표시되면 **Reopen in Container** 클릭(또는 `Ctrl+Shift+P` → "Dev Containers: Reopen in Container" 명령 사용) +6. 컨테이너 빌드 및 시작 대기 +7. [2단계: GitHub 토큰 생성](../../../02-SetupDevEnvironment)으로 진행 + +스크린샷: 개발 컨테이너 설정 + +스크린샷: 개발 컨테이너 빌드 완료 + +#### 옵션 C: 기존 로컬 설치 사용 + +**기존 Java 환경 사용 개발자용** + +필수 조건: +- [Java 21+](https://www.oracle.com/java/technologies/javase/jdk21-archive-downloads.html) +- [Maven 3.9+](https://maven.apache.org/download.cgi) +- [VS Code](https://code.visualstudio.com) 또는 원하는 IDE + +절차: +1. 저장소를 로컬로 클론 +2. IDE에서 프로젝트 열기 +3. [2단계: GitHub 토큰 생성](../../../02-SetupDevEnvironment)으로 진행 + +> **활용 팁**: 사양이 낮은 PC에서 로컬 VS Code를 사용하고 싶다면 GitHub Codespaces를 이용하세요! 로컬 VS Code를 클라우드 호스팅 Codespace에 연결해 두 환경의 장점을 모두 누릴 수 있습니다. + +스크린샷: 생성된 로컬 개발 컨테이너 인스턴스 + + +## 2단계: GitHub 개인 액세스 토큰 생성 + +1. [GitHub 설정](https://github.com/settings/profile)으로 가서 프로필 메뉴에서 **Settings** 선택 +2. 왼쪽 사이드바에서 **Developer settings** 클릭(보통 하단) +3. **Personal access tokens** 아래에서 **Fine-grained tokens** 클릭(또는 직접 [링크](https://github.com/settings/personal-access-tokens) 사용) +4. **Generate new token** 클릭 +5. "Token name"에 설명적인 이름 입력(예: `GenAI-Java-Course-Token`) +6. 만료 날짜 설정(권장: 보안상 7일) +7. "Resource owner"에 사용자 계정 선택 +8. "Repository access"에 GitHub Models 사용하고자 하는 저장소 선택(또는 필요 시 "All repositories") +9. "Account permissions"에서 **Models**를 **Read-only**로 설정 +10. **Generate token** 클릭 +11. 토큰을 **지금 복사하고 안전하게 저장**하세요 — 다시 볼 수 없습니다! + +> **보안 팁**: 액세스 토큰은 최소 권한 범위와 가능한 짧은 만료 기간을 사용하세요. + +## 3단계: GitHub 모델 예제로 설정 테스트 + +개발 환경이 준비되면 [`02-SetupDevEnvironment/examples/github-models`](../../../02-SetupDevEnvironment/examples/github-models)에 있는 예제 애플리케이션으로 GitHub Models 연동을 테스트해 봅시다. + +1. 개발 환경에서 터미널을 엽니다. +2. GitHub Models 예제로 이동: + ```bash + cd 02-SetupDevEnvironment/examples/github-models + ``` +3. GitHub 토큰을 환경 변수로 설정: + ```bash + # macOS/리눅스 + export GITHUB_TOKEN=your_token_here + + # 윈도우 (명령 프롬프트) + set GITHUB_TOKEN=your_token_here + + # 윈도우 (파워셸) + $env:GITHUB_TOKEN="your_token_here" + ``` + +4. 애플리케이션 실행: + ```bash + mvn compile exec:java -Dexec.mainClass="com.example.githubmodels.App" + ``` + +아래와 같은 출력이 표시됩니다: +```text +Using model: gpt-4.1-nano +Sending request to GitHub Models... +Response: Hello World! +``` + +### 예제 코드 이해하기 + +먼저 방금 실행한 코드를 이해해 봅니다. `examples/github-models` 폴더의 예제는 OpenAI Java SDK로 GitHub Models에 연결합니다: + +**이 코드가 하는 일:** +- 개인 액세스 토큰으로 GitHub Models에 **연결** +- "Say Hello World!" 메시지를 AI 모델에 **전송** +- AI의 응답을 **수신 및 출력** +- 환경 구성이 올바른지 **검증** + +**주요 의존성**(`pom.xml`): +```xml + + com.openai + openai-java + 2.12.0 + +``` + +**핵심 코드**(`App.java`): +```java +// OpenAI Java SDK를 사용하여 GitHub 모델에 연결 +OpenAIClient client = OpenAIOkHttpClient.builder() + .apiKey(pat) + .baseUrl("https://models.inference.ai.azure.com") + .build(); + +// 채팅 완성 요청 생성 +ChatCompletionCreateParams params = ChatCompletionCreateParams.builder() + .model(modelId) + .addSystemMessage("You are a concise assistant.") + .addUserMessage("Say Hello World!") + .build(); + +// AI 응답 받기 +ChatCompletion response = client.chat().completions().create(params); +System.out.println("Response: " + response.choices().get(0).message().content().orElse("No response content")); +``` + +## 요약 + +잘 하셨습니다! 이제 모두 준비됐습니다: + +- AI 모델 접속 권한을 위한 적절한 권한을 가진 GitHub 개인 액세스 토큰 생성 +- Java 개발 환경 실행(코드스페이스, 개발 컨테이너, 로컬 중 선택) +- OpenAI Java SDK를 사용해 GitHub Models 연결하여 무료 AI 개발 +- AI 모델과 대화하는 간단한 예제로 모든 것이 잘 작동하는지 테스트 + +## 다음 단계 + +[3장: 핵심 생성 AI 기법](../03-CoreGenerativeAITechniques/README.md) + +## 문제 해결 + +문제가 있나요? 자주 발생하는 문제와 해결책은 다음과 같습니다: + +- **토큰이 작동하지 않나요?** + - 토큰 전체를 공백 없이 정확히 복사했는지 확인 + - 환경 변수로 올바르게 설정했는지 확인 + - 권한(Models: Read-only)이 올바른지 검토 + +- **Maven을 찾을 수 없나요?** + - 개발 컨테이너/코드스페이스에서는 Maven이 미리 설치되어 있음 + - 로컬 설정은 Java 21+ 및 Maven 3.9+가 설치되었는지 확인 + - `mvn --version` 명령어로 설치 여부 확인 + +- **연결 문제 발생?** + - 인터넷 연결 점검 + - 네트워크에서 GitHub 접속 가능한지 확인 + - 방화벽이 GitHub Models 엔드포인트를 차단하지 않는지 확인 + +- **개발 컨테이너가 시작되지 않나요?** + - Docker Desktop이 실행 중인지 확인(로컬 개발 시) + - 컨테이너 재빌드 시도: `Ctrl+Shift+P` → "Dev Containers: Rebuild Container" + +- **애플리케이션 컴파일 오류?** + - 디렉터리가 올바른지 확인: `02-SetupDevEnvironment/examples/github-models` + - 클린 빌드 시도: `mvn clean compile` + +> **도움이 더 필요하신가요?** 문제 발생 시 저장소에 이슈를 등록해 주세요. 도와드리겠습니다. --- + +**면책 조항**: +이 문서는 AI 번역 서비스 [Co-op Translator](https://github.com/Azure/co-op-translator)를 사용하여 번역되었습니다. 정확성을 위해 노력하고 있으나, 자동 번역에는 오류나 부정확성이 포함될 수 있음을 유의하시기 바랍니다. 원본 문서의 원어 버전이 권위 있는 출처로 간주되어야 합니다. 중요한 정보의 경우 전문 인력에 의한 번역을 권장합니다. 본 번역 사용으로 인해 발생하는 오해나 해석상의 문제에 대해서는 책임을 지지 않습니다. + \ No newline at end of file diff --git a/translations/ko/02-SetupDevEnvironment/examples/basic-chat-azure/README.md b/translations/ko/02-SetupDevEnvironment/examples/basic-chat-azure/README.md index 3ddc4354..42c63f2b 100644 --- a/translations/ko/02-SetupDevEnvironment/examples/basic-chat-azure/README.md +++ b/translations/ko/02-SetupDevEnvironment/examples/basic-chat-azure/README.md @@ -1,12 +1,3 @@ - # Azure OpenAI와의 기본 채팅 - 엔드 투 엔드 예제 이 예제는 Azure OpenAI에 연결하고 설정을 테스트하는 간단한 Spring Boot 애플리케이션을 만드는 방법을 보여줍니다. diff --git a/translations/ko/02-SetupDevEnvironment/getting-started-azure-openai.md b/translations/ko/02-SetupDevEnvironment/getting-started-azure-openai.md index c9c1c3ac..53ce7507 100644 --- a/translations/ko/02-SetupDevEnvironment/getting-started-azure-openai.md +++ b/translations/ko/02-SetupDevEnvironment/getting-started-azure-openai.md @@ -1,12 +1,3 @@ - # Azure OpenAI 개발 환경 설정 > **빠른 시작**: 이 가이드는 Azure OpenAI 설정을 위한 것입니다. 무료 모델로 바로 시작하려면 [GitHub Models with Codespaces](./README.md#quick-start-cloud)를 사용하세요. diff --git a/translations/ko/03-CoreGenerativeAITechniques/README.md b/translations/ko/03-CoreGenerativeAITechniques/README.md index b2ce3e68..bae2b3ed 100644 --- a/translations/ko/03-CoreGenerativeAITechniques/README.md +++ b/translations/ko/03-CoreGenerativeAITechniques/README.md @@ -1,12 +1,3 @@ - # 핵심 생성형 AI 기술 튜토리얼 ## 목차 diff --git a/translations/ko/04-PracticalSamples/README.md b/translations/ko/04-PracticalSamples/README.md index c10e4f23..94b9c4d9 100644 --- a/translations/ko/04-PracticalSamples/README.md +++ b/translations/ko/04-PracticalSamples/README.md @@ -1,12 +1,3 @@ - # 실용적인 응용 프로그램 및 프로젝트 ## 학습 목표 diff --git a/translations/ko/04-PracticalSamples/calculator/README.md b/translations/ko/04-PracticalSamples/calculator/README.md index 5ae661c2..e71ac130 100644 --- a/translations/ko/04-PracticalSamples/calculator/README.md +++ b/translations/ko/04-PracticalSamples/calculator/README.md @@ -1,12 +1,3 @@ - # MCP 계산기 튜토리얼 초보자용 ## 목차 diff --git a/translations/ko/04-PracticalSamples/foundrylocal/README.md b/translations/ko/04-PracticalSamples/foundrylocal/README.md index a01f8d44..7eb63c12 100644 --- a/translations/ko/04-PracticalSamples/foundrylocal/README.md +++ b/translations/ko/04-PracticalSamples/foundrylocal/README.md @@ -1,12 +1,3 @@ - # Foundry Local Spring Boot 튜토리얼 ## 목차 diff --git a/translations/ko/04-PracticalSamples/petstory/README.md b/translations/ko/04-PracticalSamples/petstory/README.md index 06512bd5..bde41c92 100644 --- a/translations/ko/04-PracticalSamples/petstory/README.md +++ b/translations/ko/04-PracticalSamples/petstory/README.md @@ -1,12 +1,3 @@ - # 초보자를 위한 Pet Story Generator 튜토리얼 ## 목차 diff --git a/translations/ko/05-ResponsibleGenAI/README.md b/translations/ko/05-ResponsibleGenAI/README.md index 63d8fb49..71e8b7ad 100644 --- a/translations/ko/05-ResponsibleGenAI/README.md +++ b/translations/ko/05-ResponsibleGenAI/README.md @@ -1,12 +1,3 @@ - # 책임 있는 생성형 AI ## 학습 목표 diff --git a/translations/ko/AGENTS.md b/translations/ko/AGENTS.md index c3a29cee..70437f51 100644 --- a/translations/ko/AGENTS.md +++ b/translations/ko/AGENTS.md @@ -1,12 +1,3 @@ - # AGENTS.md ## 프로젝트 개요 diff --git a/translations/ko/CODE_OF_CONDUCT.md b/translations/ko/CODE_OF_CONDUCT.md index f4d42299..116f5693 100644 --- a/translations/ko/CODE_OF_CONDUCT.md +++ b/translations/ko/CODE_OF_CONDUCT.md @@ -1,12 +1,3 @@ - # Microsoft 오픈 소스 행동 강령 이 프로젝트는 [Microsoft 오픈 소스 행동 강령](https://opensource.microsoft.com/codeofconduct/)을 채택했습니다. diff --git a/translations/ko/README.md b/translations/ko/README.md index eae247d6..02021265 100644 --- a/translations/ko/README.md +++ b/translations/ko/README.md @@ -1,147 +1,139 @@ - -# 초보자를 위한 생성 AI - Java 에디션 +# Generative AI for Beginners - Java Edition [![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) -![초보자를 위한 생성 AI - Java 에디션](../../translated_images/ko/beg-genai-series.8b48be9951cc574c.webp) +![Generative AI for Beginners - Java Edition](../../translated_images/ko/beg-genai-series.8b48be9951cc574c.webp) -**소요 시간**: 전체 워크숍은 로컬 설정 없이 온라인으로 완료할 수 있습니다. 환경 설정은 2분이 걸리며, 샘플 탐색은 탐색 깊이에 따라 1-3시간이 소요됩니다. +**소요 시간**: 전체 워크숍은 온라인으로 로컬 설정 없이 완료할 수 있습니다. 환경 설정은 2분이 소요되며, 샘플 탐색은 탐색 깊이에 따라 1~3시간이 걸립니다. > **빠른 시작** -1. 이 저장소를 GitHub 계정에 포크합니다. +1. 이 리포지토리를 GitHub 계정으로 포크하세요 2. **Code** → **Codespaces** 탭 → **...** → **New with options...** 클릭 -3. 기본 설정을 사용합니다 – 이 과정에서 생성된 개발 컨테이너가 선택됩니다. +3. 기본값 사용 – 이 옵션은 이 과정에 맞춰 생성된 개발 컨테이너를 선택합니다 4. **Create codespace** 클릭 5. 환경 준비를 위해 약 2분 대기 -6. 바로 [첫 번째 예제](./02-SetupDevEnvironment/README.md#step-2-create-a-github-personal-access-token)로 이동합니다. +6. 바로 [첫 번째 예제](./02-SetupDevEnvironment/README.md#step-2-create-a-github-personal-access-token)로 이동 > **로컬에서 클론하는 것을 선호하나요?** > -> 이 저장소는 50개 이상의 언어 번역을 포함하고 있어 다운로드 크기가 크게 증가합니다. 번역 없이 클론하려면 sparse checkout을 사용하세요: +> 이 리포지토리는 50개 이상의 언어 번역을 포함하여 다운로드 크기가 크게 증가합니다. 번역 없이 클론하려면 sparse checkout을 사용하세요: > ```bash > git clone --filter=blob:none --sparse https://github.com/microsoft/Generative-AI-for-beginners-java.git > cd Generative-AI-for-beginners-java > git sparse-checkout set --no-cone '/*' '!translations' '!translated_images' > ``` -> 이렇게 하면 훨씬 빠른 다운로드로 과정을 완료하는 데 필요한 모든 것을 얻을 수 있습니다. +> 이 방법으로 훨씬 빠른 다운로드로 코스를 완료하는 데 필요한 모든 것을 얻을 수 있습니다. ## 다국어 지원 -### GitHub Action을 통한 지원 (자동화 및 항상 최신 상태) +### GitHub Action을 통해 지원 (자동화 및 항상 최신 상태 유지) -[아랍어](../ar/README.md) | [벵골어](../bn/README.md) | [불가리아어](../bg/README.md) | [버마어 (미얀마)](../my/README.md) | [중국어 (간체)](../zh/README.md) | [중국어 (번체, 홍콩)](../hk/README.md) | [중국어 (번체, 마카오)](../mo/README.md) | [중국어 (번체, 대만)](../tw/README.md) | [크로아티아어](../hr/README.md) | [체코어](../cs/README.md) | [덴마크어](../da/README.md) | [네덜란드어](../nl/README.md) | [에스토니아어](../et/README.md) | [핀란드어](../fi/README.md) | [프랑스어](../fr/README.md) | [독일어](../de/README.md) | [그리스어](../el/README.md) | [히브리어](../he/README.md) | [힌디어](../hi/README.md) | [헝가리어](../hu/README.md) | [인도네시아어](../id/README.md) | [이탈리아어](../it/README.md) | [일본어](../ja/README.md) | [칸나다어](../kn/README.md) | [한국어](./README.md) | [리투아니아어](../lt/README.md) | [말레이어](../ms/README.md) | [말라얄람어](../ml/README.md) | [마라티어](../mr/README.md) | [네팔어](../ne/README.md) | [나이지리아 피진어](../pcm/README.md) | [노르웨이어](../no/README.md) | [페르시아어 (파르시)](../fa/README.md) | [폴란드어](../pl/README.md) | [포르투갈어 (브라질)](../br/README.md) | [포르투갈어 (포르투갈)](../pt/README.md) | [펀자브어 (구르무키)](../pa/README.md) | [루마니아어](../ro/README.md) | [러시아어](../ru/README.md) | [세르비아어 (키릴문자)](../sr/README.md) | [슬로바키아어](../sk/README.md) | [슬로베니아어](../sl/README.md) | [스페인어](../es/README.md) | [스와힐리어](../sw/README.md) | [스웨덴어](../sv/README.md) | [따갈로그어 (필리피노)](../tl/README.md) | [타밀어](../ta/README.md) | [텔루구어](../te/README.md) | [태국어](../th/README.md) | [터키어](../tr/README.md) | [우크라이나어](../uk/README.md) | [우르두어](../ur/README.md) | [베트남어](../vi/README.md) +[아랍어](../ar/README.md) | [벵골어](../bn/README.md) | [불가리아어](../bg/README.md) | [버마어 (미얀마)](../my/README.md) | [중국어 (간체)](../zh-CN/README.md) | [중국어 (번체, 홍콩)](../zh-HK/README.md) | [중국어 (번체, 마카오)](../zh-MO/README.md) | [중국어 (번체, 대만)](../zh-TW/README.md) | [크로아티아어](../hr/README.md) | [체코어](../cs/README.md) | [덴마크어](../da/README.md) | [네덜란드어](../nl/README.md) | [에스토니아어](../et/README.md) | [핀란드어](../fi/README.md) | [프랑스어](../fr/README.md) | [독일어](../de/README.md) | [그리스어](../el/README.md) | [히브리어](../he/README.md) | [힌디어](../hi/README.md) | [헝가리어](../hu/README.md) | [인도네시아어](../id/README.md) | [이탈리아어](../it/README.md) | [일본어](../ja/README.md) | [칸나다어](../kn/README.md) | [한국어](./README.md) | [리투아니아어](../lt/README.md) | [말레이어](../ms/README.md) | [말라얄람어](../ml/README.md) | [마라티어](../mr/README.md) | [네팔어](../ne/README.md) | [나이지리아 피진](../pcm/README.md) | [노르웨이어](../no/README.md) | [페르시아어 (파르시)](../fa/README.md) | [폴란드어](../pl/README.md) | [포르투갈어 (브라질)](../pt-BR/README.md) | [포르투갈어 (포르투갈)](../pt-PT/README.md) | [펀자브어 (구르무키)](../pa/README.md) | [루마니아어](../ro/README.md) | [러시아어](../ru/README.md) | [세르비아어 (키릴문자)](../sr/README.md) | [슬로바키아어](../sk/README.md) | [슬로베니아어](../sl/README.md) | [스페인어](../es/README.md) | [스와힐리어](../sw/README.md) | [스웨덴어](../sv/README.md) | [타갈로그어 (필리핀)](../tl/README.md) | [타밀어](../ta/README.md) | [텔루구어](../te/README.md) | [태국어](../th/README.md) | [터키어](../tr/README.md) | [우크라이나어](../uk/README.md) | [우르두어](../ur/README.md) | [베트남어](../vi/README.md) > **로컬에서 클론하는 것을 선호하나요?** -> 이 저장소는 50개 이상의 언어 번역을 포함하고 있어 다운로드 크기가 크게 증가합니다. 번역 없이 클론하려면 sparse checkout을 사용하세요: +> 이 리포지토리는 50개 이상의 언어 번역을 포함하여 다운로드 크기가 크게 증가합니다. 번역 없이 클론하려면 sparse checkout을 사용하세요: > ```bash > git clone --filter=blob:none --sparse https://github.com/microsoft/Generative-AI-for-beginners-java.git > cd Generative-AI-for-beginners-java > git sparse-checkout set --no-cone '/*' '!translations' '!translated_images' > ``` -> 이렇게 하면 훨씬 빠른 다운로드로 과정을 완료하는 데 필요한 모든 것을 얻을 수 있습니다. +> 이 방법으로 훨씬 빠른 다운로드로 코스를 완료하는 데 필요한 모든 것을 얻을 수 있습니다. -## 과정 구성 및 학습 경로 +## 코스 구조 및 학습 경로 -### **제1장: 생성 AI 소개** -- **핵심 개념**: 대형 언어 모델, 토큰, 임베딩, AI 역량 이해 +### **1장: 생성형 AI 소개** +- **핵심 개념**: 대규모 언어 모델, 토큰, 임베딩, AI 기능 이해 - **Java AI 생태계**: Spring AI 및 OpenAI SDK 개요 -- **모델 컨텍스트 프로토콜**: MCP 소개와 AI 에이전트 통신에서의 역할 -- **실용 응용**: 챗봇 및 콘텐츠 생성 등 실제 사례 -- **[→ 제1장 시작](./01-IntroToGenAI/README.md)** +- **모델 컨텍스트 프로토콜**: MCP 소개 및 AI 에이전트 통신에서의 역할 +- **실용 사례**: 챗봇 및 콘텐츠 생성 등 실제 시나리오 +- **[→ 1장 시작](./01-IntroToGenAI/README.md)** -### **제2장: 개발 환경 설정** -- **다중 제공자 구성**: GitHub Models, Azure OpenAI, OpenAI Java SDK 통합 설정 +### **2장: 개발 환경 설정** +- **다중 공급자 구성**: GitHub Models, Azure OpenAI, OpenAI Java SDK 통합 설정 - **Spring Boot + Spring AI**: 엔터프라이즈 AI 애플리케이션 개발 모범 사례 -- **GitHub Models**: 프로토타입과 학습을 위한 무료 AI 모델 액세스 (신용카드 불필요) -- **개발 도구**: Docker 컨테이너, VS Code, GitHub Codespaces 구성 -- **[→ 제2장 시작](./02-SetupDevEnvironment/README.md)** +- **GitHub Models**: 프로토타입 및 학습을 위한 무료 AI 모델 접근 (신용카드 필요 없음) +- **개발 도구**: 도커 컨테이너, VS Code, GitHub Codespaces 구성 +- **[→ 2장 시작](./02-SetupDevEnvironment/README.md)** -### **제3장: 핵심 생성 AI 기법** -- **프롬프트 엔지니어링**: AI 모델 응답 최적화 기술 +### **3장: 핵심 생성형 AI 기술** +- **프롬프트 엔지니어링**: 최적 AI 모델 응답을 위한 기법 - **임베딩 및 벡터 연산**: 의미 기반 검색 및 유사도 매칭 구현 -- **검색 강화 생성 (RAG)**: AI와 자체 데이터 소스 결합 -- **함수 호출**: 커스텀 도구 및 플러그인으로 AI 기능 확장 -- **[→ 제3장 시작](./03-CoreGenerativeAITechniques/README.md)** - -### **제4장: 실용 응용 및 프로젝트** -- **반려동물 이야기 생성기** (`petstory/`): GitHub Models로 창의적 콘텐츠 생성 -- **Foundry 로컬 데모** (`foundrylocal/`): OpenAI Java SDK와 로컬 AI 모델 통합 -- **MCP 계산기 서비스** (`calculator/`): Spring AI로 기본 Model Context Protocol 구현 -- **[→ 제4장 시작](./04-PracticalSamples/README.md)** - -### **제5장: 책임 있는 AI 개발** -- **GitHub Models 안전성**: 내장 내용 필터링 및 안전 메커니즘 테스트 (차단 및 거부) -- **책임 있는 AI 데모**: 최신 AI 안전 시스템 작동 방식 실습 예제 -- **모범 사례**: 윤리적 AI 개발과 배포를 위한 필수 지침 -- **[→ 제5장 시작](./05-ResponsibleGenAI/README.md)** +- **검색 증강 생성 (RAG)**: AI와 자체 데이터 소스 결합 +- **함수 호출**: 사용자 도구 및 플러그인으로 AI 기능 확장 +- **[→ 3장 시작](./03-CoreGenerativeAITechniques/README.md)** + +### **4장: 실용 응용 및 프로젝트** +- **Pet Story Generator** (`petstory/`): GitHub Models를 활용한 창의적 콘텐츠 생성 +- **Foundry Local Demo** (`foundrylocal/`): OpenAI Java SDK를 이용한 로컬 AI 모델 통합 +- **MCP 계산기 서비스** (`calculator/`): Spring AI를 활용한 기본 모델 컨텍스트 프로토콜 구현 +- **[→ 4장 시작](./04-PracticalSamples/README.md)** + +### **5장: 책임감 있는 AI 개발** +- **GitHub Models 안전 기능**: 내장 콘텐츠 필터링 및 안전 메커니즘 테스트 (강제 차단과 소프트 거부) +- **책임감 있는 AI 데모**: 최신 AI 안전 시스템의 실제 작동 방식 예제 +- **모범 사례**: 윤리적 AI 개발 및 배포를 위한 필수 가이드라인 +- **[→ 5장 시작](./05-ResponsibleGenAI/README.md)** ## 추가 자료 ### LangChain -[![초보자를 위한 LangChain4j](https://img.shields.io/badge/LangChain4j%20for%20Beginners-22C55E?style=for-the-badge&&labelColor=E5E7EB&color=0553D6)](https://aka.ms/langchain4j-for-beginners) -[![초보자를 위한 LangChain.js](https://img.shields.io/badge/LangChain.js%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=0553D6)](https://aka.ms/langchainjs-for-beginners?WT.mc_id=m365-94501-dwahlin) +[![LangChain4j for Beginners](https://img.shields.io/badge/LangChain4j%20for%20Beginners-22C55E?style=for-the-badge&&labelColor=E5E7EB&color=0553D6)](https://aka.ms/langchain4j-for-beginners) +[![LangChain.js for Beginners](https://img.shields.io/badge/LangChain.js%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=0553D6)](https://aka.ms/langchainjs-for-beginners?WT.mc_id=m365-94501-dwahlin) --- -### Azure / Edge / MCP / 에이전트 -[![초보자를 위한 AZD](https://img.shields.io/badge/AZD%20for%20Beginners-0078D4?style=for-the-badge&labelColor=E5E7EB&color=0078D4)](https://github.com/microsoft/AZD-for-beginners?WT.mc_id=academic-105485-koreyst) -[![초보자를 위한 Edge AI](https://img.shields.io/badge/Edge%20AI%20for%20Beginners-00B8E4?style=for-the-badge&labelColor=E5E7EB&color=00B8E4)](https://github.com/microsoft/edgeai-for-beginners?WT.mc_id=academic-105485-koreyst) -[![초보자를 위한 MCP](https://img.shields.io/badge/MCP%20for%20Beginners-009688?style=for-the-badge&labelColor=E5E7EB&color=009688)](https://github.com/microsoft/mcp-for-beginners?WT.mc_id=academic-105485-koreyst) -[![초보자를 위한 AI 에이전트](https://img.shields.io/badge/AI%20Agents%20for%20Beginners-00C49A?style=for-the-badge&labelColor=E5E7EB&color=00C49A)](https://github.com/microsoft/ai-agents-for-beginners?WT.mc_id=academic-105485-koreyst) +### Azure / Edge / MCP / Agents +[![AZD for Beginners](https://img.shields.io/badge/AZD%20for%20Beginners-0078D4?style=for-the-badge&labelColor=E5E7EB&color=0078D4)](https://github.com/microsoft/AZD-for-beginners?WT.mc_id=academic-105485-koreyst) +[![Edge AI for Beginners](https://img.shields.io/badge/Edge%20AI%20for%20Beginners-00B8E4?style=for-the-badge&labelColor=E5E7EB&color=00B8E4)](https://github.com/microsoft/edgeai-for-beginners?WT.mc_id=academic-105485-koreyst) +[![MCP for Beginners](https://img.shields.io/badge/MCP%20for%20Beginners-009688?style=for-the-badge&labelColor=E5E7EB&color=009688)](https://github.com/microsoft/mcp-for-beginners?WT.mc_id=academic-105485-koreyst) +[![AI Agents for Beginners](https://img.shields.io/badge/AI%20Agents%20for%20Beginners-00C49A?style=for-the-badge&labelColor=E5E7EB&color=00C49A)](https://github.com/microsoft/ai-agents-for-beginners?WT.mc_id=academic-105485-koreyst) --- -### 생성 AI 시리즈 -[![초보자를 위한 생성 AI](https://img.shields.io/badge/Generative%20AI%20for%20Beginners-8B5CF6?style=for-the-badge&labelColor=E5E7EB&color=8B5CF6)](https://github.com/microsoft/generative-ai-for-beginners?WT.mc_id=academic-105485-koreyst) -[![생성 AI (.NET)](https://img.shields.io/badge/Generative%20AI%20(.NET)-9333EA?style=for-the-badge&labelColor=E5E7EB&color=9333EA)](https://github.com/microsoft/Generative-AI-for-beginners-dotnet?WT.mc_id=academic-105485-koreyst) -[![생성 AI (Java)](https://img.shields.io/badge/Generative%20AI%20(Java)-C084FC?style=for-the-badge&labelColor=E5E7EB&color=C084FC)](https://github.com/microsoft/generative-ai-for-beginners-java?WT.mc_id=academic-105485-koreyst) -[![생성 AI (JavaScript)](https://img.shields.io/badge/Generative%20AI%20(JavaScript)-E879F9?style=for-the-badge&labelColor=E5E7EB&color=E879F9)](https://github.com/microsoft/generative-ai-with-javascript?WT.mc_id=academic-105485-koreyst) +### 생성형 AI 시리즈 +[![Generative AI for Beginners](https://img.shields.io/badge/Generative%20AI%20for%20Beginners-8B5CF6?style=for-the-badge&labelColor=E5E7EB&color=8B5CF6)](https://github.com/microsoft/generative-ai-for-beginners?WT.mc_id=academic-105485-koreyst) +[![Generative AI (.NET)](https://img.shields.io/badge/Generative%20AI%20(.NET)-9333EA?style=for-the-badge&labelColor=E5E7EB&color=9333EA)](https://github.com/microsoft/Generative-AI-for-beginners-dotnet?WT.mc_id=academic-105485-koreyst) +[![Generative AI (Java)](https://img.shields.io/badge/Generative%20AI%20(Java)-C084FC?style=for-the-badge&labelColor=E5E7EB&color=C084FC)](https://github.com/microsoft/generative-ai-for-beginners-java?WT.mc_id=academic-105485-koreyst) +[![Generative AI (JavaScript)](https://img.shields.io/badge/Generative%20AI%20(JavaScript)-E879F9?style=for-the-badge&labelColor=E5E7EB&color=E879F9)](https://github.com/microsoft/generative-ai-with-javascript?WT.mc_id=academic-105485-koreyst) --- ### 핵심 학습 -[![초보자를 위한 ML](https://img.shields.io/badge/ML%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=22C55E)](https://aka.ms/ml-beginners?WT.mc_id=academic-105485-koreyst) -[![초보자를 위한 데이터 과학](https://img.shields.io/badge/Data%20Science%20for%20Beginners-84CC16?style=for-the-badge&labelColor=E5E7EB&color=84CC16)](https://aka.ms/datascience-beginners?WT.mc_id=academic-105485-koreyst) -[![초보자를 위한 AI](https://img.shields.io/badge/AI%20for%20Beginners-A3E635?style=for-the-badge&labelColor=E5E7EB&color=A3E635)](https://aka.ms/ai-beginners?WT.mc_id=academic-105485-koreyst) -[![초보자를 위한 사이버보안](https://img.shields.io/badge/Cybersecurity%20for%20Beginners-F97316?style=for-the-badge&labelColor=E5E7EB&color=F97316)](https://github.com/microsoft/Security-101?WT.mc_id=academic-96948-sayoung) +[![ML for Beginners](https://img.shields.io/badge/ML%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=22C55E)](https://aka.ms/ml-beginners?WT.mc_id=academic-105485-koreyst) +[![Data Science for Beginners](https://img.shields.io/badge/Data%20Science%20for%20Beginners-84CC16?style=for-the-badge&labelColor=E5E7EB&color=84CC16)](https://aka.ms/datascience-beginners?WT.mc_id=academic-105485-koreyst) +[![AI for Beginners](https://img.shields.io/badge/AI%20for%20Beginners-A3E635?style=for-the-badge&labelColor=E5E7EB&color=A3E635)](https://aka.ms/ai-beginners?WT.mc_id=academic-105485-koreyst) +[![Cybersecurity for Beginners](https://img.shields.io/badge/Cybersecurity%20for%20Beginners-F97316?style=for-the-badge&labelColor=E5E7EB&color=F97316)](https://github.com/microsoft/Security-101?WT.mc_id=academic-96948-sayoung) + [![초보자를 위한 웹 개발](https://img.shields.io/badge/Web%20Dev%20for%20Beginners-EC4899?style=for-the-badge&labelColor=E5E7EB&color=EC4899)](https://aka.ms/webdev-beginners?WT.mc_id=academic-105485-koreyst) [![초보자를 위한 IoT](https://img.shields.io/badge/IoT%20for%20Beginners-14B8A6?style=for-the-badge&labelColor=E5E7EB&color=14B8A6)](https://aka.ms/iot-beginners?WT.mc_id=academic-105485-koreyst) [![초보자를 위한 XR 개발](https://img.shields.io/badge/XR%20Development%20for%20Beginners-38BDF8?style=for-the-badge&labelColor=E5E7EB&color=38BDF8)](https://github.com/microsoft/xr-development-for-beginners?WT.mc_id=academic-105485-koreyst) --- -### 코파일럿 시리즈 -[![AI 페어 프로그래밍을 위한 코파일럿](https://img.shields.io/badge/Copilot%20for%20AI%20Paired%20Programming-FACC15?style=for-the-badge&labelColor=E5E7EB&color=FACC15)](https://aka.ms/GitHubCopilotAI?WT.mc_id=academic-105485-koreyst) -[![C#/.NET용 코파일럿](https://img.shields.io/badge/Copilot%20for%20C%23/.NET-FBBF24?style=for-the-badge&labelColor=E5E7EB&color=FBBF24)](https://github.com/microsoft/mastering-github-copilot-for-dotnet-csharp-developers?WT.mc_id=academic-105485-koreyst) -[![코파일럿 어드벤처](https://img.shields.io/badge/Copilot%20Adventure-FDE68A?style=for-the-badge&labelColor=E5E7EB&color=FDE68A)](https://github.com/microsoft/CopilotAdventures?WT.mc_id=academic-105485-koreyst) +### Copilot 시리즈 +[![AI 페어 프로그래밍용 Copilot](https://img.shields.io/badge/Copilot%20for%20AI%20Paired%20Programming-FACC15?style=for-the-badge&labelColor=E5E7EB&color=FACC15)](https://aka.ms/GitHubCopilotAI?WT.mc_id=academic-105485-koreyst) +[![C#/.NET용 Copilot](https://img.shields.io/badge/Copilot%20for%20C%23/.NET-FBBF24?style=for-the-badge&labelColor=E5E7EB&color=FBBF24)](https://github.com/microsoft/mastering-github-copilot-for-dotnet-csharp-developers?WT.mc_id=academic-105485-koreyst) +[![Copilot 어드벤처](https://img.shields.io/badge/Copilot%20Adventure-FDE68A?style=for-the-badge&labelColor=E5E7EB&color=FDE68A)](https://github.com/microsoft/CopilotAdventures?WT.mc_id=academic-105485-koreyst) -## 도움받기 +## 도움 받기 -AI 앱 개발 중 막히거나 질문이 있을 경우, MCP에 대해 토론하는 다른 학습자 및 경험 많은 개발자들과 함께하세요. 질문이 환영받고 지식이 자유롭게 공유되는 지원 커뮤니티입니다. +AI 앱 개발 중 막히거나 질문이 생기면 MCP에 대해 학습하는 다른 학습자 및 경험 많은 개발자들과 토론에 참여하세요. 질문이 환영받고 지식이 자유롭게 공유되는 서포트 커뮤니티입니다. [![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) -제품 피드백이나 개발 중 오류가 있을 경우 방문하세요: +제품 피드백이 있거나 빌드 중 오류가 발생하면 다음을 방문하세요: -[![Microsoft Foundry Developer Forum](https://img.shields.io/badge/GitHub-Microsoft_Foundry_Developer_Forum-blue?style=for-the-badge&logo=github&color=000000&logoColor=fff)](https://aka.ms/foundry/forum) +[![Microsoft Foundry 개발자 포럼](https://img.shields.io/badge/GitHub-Microsoft_Foundry_Developer_Forum-blue?style=for-the-badge&logo=github&color=000000&logoColor=fff)](https://aka.ms/foundry/forum) --- **면책 조항**: -이 문서는 AI 번역 서비스 [Co-op Translator](https://github.com/Azure/co-op-translator)를 사용하여 번역되었습니다. 정확성을 기하기 위해 노력하고 있으나, 자동 번역은 오류나 부정확성이 포함될 수 있음을 알려드립니다. 원문은 해당 언어로 작성된 원본 문서를 권위 있는 자료로 간주해야 합니다. 중요한 정보의 경우, 전문적인 인간 번역을 권장합니다. 본 번역의 사용으로 발생하는 오해나 잘못된 해석에 대해 당사는 책임을 지지 않습니다. +이 문서는 AI 번역 서비스 [Co-op Translator](https://github.com/Azure/co-op-translator)를 사용하여 번역되었습니다. 정확성을 위해 노력하고 있으나, 자동 번역은 오류나 부정확성이 포함될 수 있음을 유의하시기 바랍니다. 원문 문서가 권위 있는 출처로 간주되어야 합니다. 중요한 정보의 경우 전문 인력에 의한 번역을 권장합니다. 본 번역 사용으로 인한 어떠한 오해나 잘못된 해석에 대해서도 당사는 책임을 지지 않습니다. \ No newline at end of file diff --git a/translations/ko/SECURITY.md b/translations/ko/SECURITY.md index 738194cd..fb99ffac 100644 --- a/translations/ko/SECURITY.md +++ b/translations/ko/SECURITY.md @@ -1,12 +1,3 @@ - ## 보안 Microsoft는 소프트웨어 제품과 서비스의 보안을 매우 중요하게 생각하며, 여기에는 [Microsoft](https://github.com/Microsoft), [Azure](https://github.com/Azure), [DotNet](https://github.com/dotnet), [AspNet](https://github.com/aspnet), [Xamarin](https://github.com/xamarin) GitHub 조직을 통해 관리되는 모든 소스 코드 저장소가 포함됩니다. diff --git a/translations/ko/SUPPORT.md b/translations/ko/SUPPORT.md index 26f7f4d4..53dbfa89 100644 --- a/translations/ko/SUPPORT.md +++ b/translations/ko/SUPPORT.md @@ -1,12 +1,3 @@ - # 지원 ## 문제 제기 및 도움 받는 방법 diff --git a/translations/lt/.co-op-translator.json b/translations/lt/.co-op-translator.json new file mode 100644 index 00000000..f9c3d39e --- /dev/null +++ b/translations/lt/.co-op-translator.json @@ -0,0 +1,92 @@ +{ + "01-IntroToGenAI/README.md": { + "original_hash": "75bfb080ca725e8a9aa9c80cae25fba1", + "translation_date": "2025-08-27T13:21:30+00:00", + "source_file": "01-IntroToGenAI/README.md", + "language_code": "lt" + }, + "02-SetupDevEnvironment/README.md": { + "original_hash": "96a30d42b9751a3d4e4b20e28d29d459", + "translation_date": "2026-01-28T05:30:57+00:00", + "source_file": "02-SetupDevEnvironment/README.md", + "language_code": "lt" + }, + "02-SetupDevEnvironment/examples/basic-chat-azure/README.md": { + "original_hash": "efd82efe50711d7e257eb943151d682c", + "translation_date": "2025-08-27T13:22:03+00:00", + "source_file": "02-SetupDevEnvironment/examples/basic-chat-azure/README.md", + "language_code": "lt" + }, + "02-SetupDevEnvironment/getting-started-azure-openai.md": { + "original_hash": "bfdb4b4eadbee3a59ef742439f58326a", + "translation_date": "2025-08-27T13:21:52+00:00", + "source_file": "02-SetupDevEnvironment/getting-started-azure-openai.md", + "language_code": "lt" + }, + "03-CoreGenerativeAITechniques/README.md": { + "original_hash": "685f55cb07de19b52a30ce6e8b6d889e", + "translation_date": "2025-08-28T22:20:56+00:00", + "source_file": "03-CoreGenerativeAITechniques/README.md", + "language_code": "lt" + }, + "04-PracticalSamples/README.md": { + "original_hash": "14c0a61ecc1cd2012a9c129236dfdf71", + "translation_date": "2025-08-27T13:22:08+00:00", + "source_file": "04-PracticalSamples/README.md", + "language_code": "lt" + }, + "04-PracticalSamples/calculator/README.md": { + "original_hash": "b6c16b5514d524e415a94f6097ee7d4c", + "translation_date": "2025-09-18T15:45:19+00:00", + "source_file": "04-PracticalSamples/calculator/README.md", + "language_code": "lt" + }, + "04-PracticalSamples/foundrylocal/README.md": { + "original_hash": "f787307400de59adc25a1404466a35f3", + "translation_date": "2025-11-04T07:38:00+00:00", + "source_file": "04-PracticalSamples/foundrylocal/README.md", + "language_code": "lt" + }, + "04-PracticalSamples/petstory/README.md": { + "original_hash": "0cbf68d605615a1e602c832a24616859", + "translation_date": "2025-08-27T13:22:14+00:00", + "source_file": "04-PracticalSamples/petstory/README.md", + "language_code": "lt" + }, + "05-ResponsibleGenAI/README.md": { + "original_hash": "301c05c2f57e60a6950b8c665b8bdbba", + "translation_date": "2025-08-27T13:21:41+00:00", + "source_file": "05-ResponsibleGenAI/README.md", + "language_code": "lt" + }, + "AGENTS.md": { + "original_hash": "afc90918d008cf77fd1982691f681306", + "translation_date": "2025-10-03T08:47:00+00:00", + "source_file": "AGENTS.md", + "language_code": "lt" + }, + "CODE_OF_CONDUCT.md": { + "original_hash": "442b123d034f92f7c384d2bbd28f99f1", + "translation_date": "2025-08-27T13:21:20+00:00", + "source_file": "CODE_OF_CONDUCT.md", + "language_code": "lt" + }, + "README.md": { + "original_hash": "125a08948d881c95628094f4dd1fbd43", + "translation_date": "2026-01-29T16:22:09+00:00", + "source_file": "README.md", + "language_code": "lt" + }, + "SECURITY.md": { + "original_hash": "57f14126c1c6add76b3aef3844dfe4e3", + "translation_date": "2025-08-27T13:21:25+00:00", + "source_file": "SECURITY.md", + "language_code": "lt" + }, + "SUPPORT.md": { + "original_hash": "b8ef73cc49dec68e2c885ee9df545129", + "translation_date": "2025-08-27T13:21:17+00:00", + "source_file": "SUPPORT.md", + "language_code": "lt" + } +} \ No newline at end of file diff --git a/translations/lt/01-IntroToGenAI/README.md b/translations/lt/01-IntroToGenAI/README.md index 1ceec2d3..c9d889ce 100644 --- a/translations/lt/01-IntroToGenAI/README.md +++ b/translations/lt/01-IntroToGenAI/README.md @@ -1,12 +1,3 @@ - --- diff --git a/translations/lt/02-SetupDevEnvironment/README.md b/translations/lt/02-SetupDevEnvironment/README.md index b56fb95b..e8dbb202 100644 --- a/translations/lt/02-SetupDevEnvironment/README.md +++ b/translations/lt/02-SetupDevEnvironment/README.md @@ -1,13 +1,254 @@ - +# Generatyvinio DI kūrimo aplinkos sąranka Java kalba +> **Greitas pradžios vadovas**: Kodavimas debesyje per 2 minutes – pereikite prie [GitHub Codespaces sąrankos](../../../02-SetupDevEnvironment) – nereikia diegti lokaliai, naudojami GitHub modeliai! + +> **Domina Azure OpenAI?** Peržiūrėkite mūsų [Azure OpenAI sąrankos vadovą](getting-started-azure-openai.md) su žingsniais, kaip sukurti naują Azure OpenAI išteklių. + +## Ko išmoksite + +- Sukurti Java kūrimo aplinką DI programoms +- Pasirinkti ir sukonfigūruoti norimą kūrimo aplinką (pirmiausia debesyje su Codespaces, vietinis kūrimo konteineris arba pilnas vietinis nustatymas) +- Patikrinti sąranką prisijungus prie GitHub modelių + +## Turinys + +- [Ko išmoksite](../../../02-SetupDevEnvironment) +- [Įvadas](../../../02-SetupDevEnvironment) +- [1 žingsnis: Sukurkite kūrimo aplinką](../../../02-SetupDevEnvironment) + - [A variantas: GitHub Codespaces (rekomenduojama)](../../../02-SetupDevEnvironment) + - [B variantas: Vietinis kūrimo konteineris](../../../02-SetupDevEnvironment) + - [C variantas: Naudokite esamą vietinę įdiegimą](../../../02-SetupDevEnvironment) +- [2 žingsnis: Sukurkite GitHub asmeninį prieigos raktą](../../../02-SetupDevEnvironment) +- [3 žingsnis: Patikrinkite sąranką](../../../02-SetupDevEnvironment) +- [Trikčių šalinimas](../../../02-SetupDevEnvironment) +- [Santrauka](../../../02-SetupDevEnvironment) +- [Tolimesni žingsniai](../../../02-SetupDevEnvironment) + +## Įvadas + +Šiame skyriuje vedame jus per kūrimo aplinkos sukūrimą. Pagrindiniu pavyzdžiu naudosime **GitHub modelius**, nes jie yra nemokami, lengvai įdiegiami su GitHub paskyra, nereikalauja kreditinės kortelės ir suteikia prieigą prie kelių modelių eksperimentams. + +**Nereikia vietinio diegimo!** Galite iškart rašyti kodą naudodami GitHub Codespaces – tai visavertė kūrimo aplinka jūsų naršyklėje. + +Ekrano nuotrauka: GitHub modeliai + +Rekomenduojame naudoti [**GitHub modelius**](https://github.com/marketplace?type=models) šiame kurse, nes jie: +- **Nemokami** pradėti +- **Lengva** sukurti vos su GitHub paskyra +- **Nereikia kreditinės kortelės** +- **Keli modeliai** eksperimentams + +> **Pastaba**: GitHub modeliai, naudojami šiame mokyme, turi šiuos nemokamus apribojimus: +> - 15 užklausų per minutę (150 per dieną) +> - Apie 8 000 žodžių įvesties, apie 4 000 žodžių išvesties per užklausą +> - 5 vienalaikės užklausos +> +> Produkcijai naudoti atnaujinkite į Azure AI Foundry modelius su savo Azure paskyra. Jūsų kodas nekeistos. Žr. [Azure AI Foundry dokumentaciją](https://learn.microsoft.com/azure/ai-foundry/foundry-models/how-to/quickstart-github-models). + + +## 1 žingsnis: Sukurkite kūrimo aplinką + + + +Sukūrėme iš anksto sukonfigūruotą kūrimo konteinerį, kad sumažintume sąrankos laiką ir užtikrintume, jog turite visus būtinus įrankius šiam Generatyvinio DI Java kursui. Pasirinkite jums tinkamiausią kūrimo būdą: + +### Aplinkos sąrankos variantai: + +#### A variantas: GitHub Codespaces (rekomenduojama) + +**Pradėkite koduoti per 2 minutes – nereikia lokalaus diegimo!** + +1. Atšakokite šią saugyklą į savo GitHub paskyrą + > **Pastaba**: Jei norite redaguoti pagrindinę konfigūraciją, peržiūrėkite [Kūrimo konteinerio konfigūraciją](../../../.devcontainer/devcontainer.json) +2. Spustelėkite **Code** → skirtuką **Codespaces** → **...** → **Naujas su pasirinktimis...** +3. Naudokite numatytuosius nustatymus – bus pasirinkta **Kūrimo konteinerio konfigūracija**: **Generatyvinio DI Java kūrimo aplinka** – kursui sukurta pritaikyta kūrimo konteinerio konfigūracija +4. Spustelėkite **Sukurti codespace** +5. Palaukite ~2 minutes, kol aplinka bus paruošta +6. Pereikite prie [2 žingsnis: Sukurkite GitHub raktą](../../../02-SetupDevEnvironment) + +Ekrano nuotrauka: Codespaces poskirtis + +Ekrano nuotrauka: Naujas su pasirinktimis + +Ekrano nuotrauka: Kūrimasis Codespace pasirinkimai + + +> **Codespaces privalumai**: +> - Nereikia vietinės instaliacijos +> - Veikia bet kuriame įrenginyje su naršykle +> - Iš anksto sukonfigūruota su visais įrankiais ir priklausomybėmis +> - Nemokamai 60 valandų per mėnesį asmeninėms paskyroms +> - Nuosekli aplinka visiems besimokantiesiems + +#### B variantas: Vietinis kūrimo konteineris + +**Skirta programuotojams, kurie nori dirbti vietoje su Docker** + +1. Atšakokite ir nuklonuokite šią saugyklą į savo vietinį kompiuterį + > **Pastaba**: Jei norite redaguoti pagrindinę konfigūraciją, peržiūrėkite [Kūrimo konteinerio konfigūraciją](../../../.devcontainer/devcontainer.json) +2. Įdiekite [Docker Desktop](https://www.docker.com/products/docker-desktop/) ir [VS Code](https://code.visualstudio.com/) +3. Įdiekite [Dev Containers plėtinį](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers) VS Code aplinkoje +4. Atverkite saugyklos aplanką VS Code +5. Kai būsite paraginti, spustelėkite **Vėl atidaryti konteineryje** (arba naudokite `Ctrl+Shift+P` → "Dev Containers: Reopen in Container") +6. Palaukite, kol konteineris bus sukomplektuotas ir paleistas +7. Pereikite prie [2 žingsnis: Sukurkite GitHub raktą](../../../02-SetupDevEnvironment) + +Ekrano nuotrauka: Kūrimo konteinerio sąranka + +Ekrano nuotrauka: Kūrimo konteinerio kūrimo pabaiga + +#### C variantas: Naudokite esamą vietinę įdiegimą + +**Skirta programuotojams, turintiems esamą Java aplinką** + +Reikalingi dalykai: +- [Java 21+](https://www.oracle.com/java/technologies/javase/jdk21-archive-downloads.html) +- [Maven 3.9+](https://maven.apache.org/download.cgi) +- [VS Code](https://code.visualstudio.com) arba jūsų mėgstama IDE + +Veiksmai: +1. Nuklonuokite šią saugyklą į savo vietinį kompiuterį +2. Atidarykite projektą savo IDE +3. Pereikite prie [2 žingsnis: Sukurkite GitHub raktą](../../../02-SetupDevEnvironment) + +> **Profesionalus patarimas**: Jei jūsų įrenginys silpnos konfigūracijos, bet norite naudoti VS Code lokaliai, naudokite GitHub Codespaces! Galite prijungti vietinį VS Code prie debesyje talpinamo Codespace ir turėti geriausius abiejų pasaulių privalumus. + +Ekrano nuotrauka: sukurtas vietinis kūrimo konteinerio egzempliorius + + +## 2 žingsnis: Sukurkite GitHub asmeninį prieigos raktą + +1. Eikite į [GitHub nustatymus](https://github.com/settings/profile) ir pasirinkite **Settings** iš savo profilio meniu. +2. Kairėje šoninėje juostoje spustelėkite **Developer settings** (dažniausiai apačioje). +3. Skiltyje **Personal access tokens** spustelėkite **Fine-grained tokens** (arba sekite šią tiesioginę [nuorodą](https://github.com/settings/personal-access-tokens)). +4. Spustelėkite **Generate new token**. +5. Lauke „Token name“ įveskite aprašomą pavadinimą (pvz., `GenAI-Java-Course-Token`). +6. Nustatykite galiojimo laiką (rekomenduojama: 7 dienos saugumo sumetimais). +7. Lauke „Resource owner“ pasirinkite savo vartotojo paskyrą. +8. Lauke „Repository access“ pasirinkite saugyklas, kurias norite naudoti su GitHub modeliais (arba „All repositories“, jei reikia). +9. Lauke „Account permissions“ raskite **Models** ir nustatykite į **Read-only**. +10. Spustelėkite **Generate token**. +11. **Kopijuokite ir išsaugokite savo raktą dabar** – vėliau jo nematysite! + +> **Saugumo patarimas**: Naudokite mažiausią reikiamą apimtį ir trumpiausią praktiką atitinkantį galiojimo laiką savo prieigos raktams. + +## 3 žingsnis: Patikrinkite sąranką su GitHub modelių pavyzdžiu + +Kai jūsų kūrimo aplinka paruošta, patikrinkime GitHub modelių integraciją su mūsų pavyzdine programa [`02-SetupDevEnvironment/examples/github-models`](../../../02-SetupDevEnvironment/examples/github-models). + +1. Atidarykite terminalą savo kūrimo aplinkoje. +2. Eikite į GitHub modelių pavyzdžio katalogą: + ```bash + cd 02-SetupDevEnvironment/examples/github-models + ``` +3. Nustatykite savo GitHub raktą kaip aplinkos kintamąjį: + ```bash + # macOS/Linux + export GITHUB_TOKEN=your_token_here + + # Windows (Komandų eilutė) + set GITHUB_TOKEN=your_token_here + + # Windows (PowerShell) + $env:GITHUB_TOKEN="your_token_here" + ``` + +4. Paleiskite programą: + ```bash + mvn compile exec:java -Dexec.mainClass="com.example.githubmodels.App" + ``` + +Turėtumėte matyti panašų išvestį: +```text +Using model: gpt-4.1-nano +Sending request to GitHub Models... +Response: Hello World! +``` + +### Pavyzdinio kodo supratimas + +Pirma, supraskime ką tik paleistą programą. Pavyzdyje kataloge `examples/github-models` naudojama OpenAI Java SDK prisijungimui prie GitHub modelių: + +**Šis kodas daro:** +- **Prisijungia** prie GitHub modelių naudodamas jūsų asmeninį prieigos raktą +- **Siunčia** paprastą žinutę „Say Hello World!“ DI modeliui +- **Gauja** ir rodo DI atsakymą +- **Patikrina**, kad jūsų sąranka veikia tinkamai + +**Pagrindinė priklausomybė** (faile `pom.xml`): +```xml + + com.openai + openai-java + 2.12.0 + +``` + +**Pagrindinis kodas** (`App.java`): +```java +// Prisijunkite prie GitHub modelių naudodami OpenAI Java SDK +OpenAIClient client = OpenAIOkHttpClient.builder() + .apiKey(pat) + .baseUrl("https://models.inference.ai.azure.com") + .build(); + +// Sukurkite pokalbio užbaigimo užklausą +ChatCompletionCreateParams params = ChatCompletionCreateParams.builder() + .model(modelId) + .addSystemMessage("You are a concise assistant.") + .addUserMessage("Say Hello World!") + .build(); + +// Gaukite DI atsakymą +ChatCompletion response = client.chat().completions().create(params); +System.out.println("Response: " + response.choices().get(0).message().content().orElse("No response content")); +``` + +## Santrauka + +Puiku! Jūs turite viską: + +- Sukūrėte GitHub asmeninį prieigos raktą su tinkamomis teisėmis DI modelių prieigai +- Paleidote savo Java kūrimo aplinką (ar tai būtų Codespaces, kūrimo konteineriai arba vietinė) +- Prisijungėte prie GitHub modelių naudodami OpenAI Java SDK nemokamam DI kūrimui +- Patikrinote, kad viskas veikia paprastu pavyzdžiu, kuris bendrauja su DI modeliais + +## Tolimesni žingsniai + +[3 skyrius: Pagrindinės generatyvinio DI technikos](../03-CoreGenerativeAITechniques/README.md) + +## Trikčių šalinimas + +Turite problemų? Štai dažniausios problemos ir sprendimai: + +- **Raktas neveikia?** + - Įsitikinkite, kad nukopijavote pilną raktą be papildomų tarpų + - Patikrinkite, ar raktas tinkamai nustatytas kaip aplinkos kintamasis + - Patikrinkite, ar raktas turi tinkamas teises (Models: Read-only) + +- **Maven nerandamas?** + - Jei naudojate kūrimo konteinerius ar Codespaces, Maven turėtų būti iš anksto įdiegtas + - Vietinei saugai įsitikinkite, kad Java 21+ ir Maven 3.9+ yra įdiegti + - Patikrinkite komandą `mvn --version` + +- **Ryšio problemos?** + - Patikrinkite interneto ryšį + - Įsitikinkite, kad GitHub yra pasiekiamas jūsų tinkle + - Patikrinkite, ar nesate už ugniasienės, blokuojančios GitHub modelių galinį tašką + +- **Kūrimo konteineris neįsijungia?** + - Patikrinkite, ar Docker Desktop veikia (vietiniam kūrimui) + - Pabandykite iš naujo sukurti konteinerį: `Ctrl+Shift+P` → "Dev Containers: Rebuild Container" + +- **Programos kompiliavimo klaidos?** + - Įsitikinkite, kad esate teisingame kataloge: `02-SetupDevEnvironment/examples/github-models` + - Pabandykite valyti ir iš naujo sukompiluoti: `mvn clean compile` + +> **Reikia pagalbos?**: Jei vis dar kyla problemų, sukurkite problemą šioje saugykloje ir mes jums padėsime. --- + +**Atsakomybės apribojimas**: +Šis dokumentas buvo išverstas naudojant dirbtinio intelekto vertimo paslaugą [Co-op Translator](https://github.com/Azure/co-op-translator). Nors siekiame tikslumo, prašome atkreipti dėmesį, kad automatizuoti vertimai gali turėti klaidų ar netikslumų. Originalus dokumentas gimtąja kalba turėtų būti laikomas autoritetingu šaltiniu. Kritinei informacijai rekomenduojamas profesionalus žmogaus vertimas. Mes neatsakome už jokius nesusipratimus ar neteisingas interpretacijas, kilusias naudojant šį vertimą. + \ No newline at end of file diff --git a/translations/lt/02-SetupDevEnvironment/examples/basic-chat-azure/README.md b/translations/lt/02-SetupDevEnvironment/examples/basic-chat-azure/README.md index 51b3f23c..c9d889ce 100644 --- a/translations/lt/02-SetupDevEnvironment/examples/basic-chat-azure/README.md +++ b/translations/lt/02-SetupDevEnvironment/examples/basic-chat-azure/README.md @@ -1,12 +1,3 @@ - --- diff --git a/translations/lt/02-SetupDevEnvironment/getting-started-azure-openai.md b/translations/lt/02-SetupDevEnvironment/getting-started-azure-openai.md index 6748046d..c9d889ce 100644 --- a/translations/lt/02-SetupDevEnvironment/getting-started-azure-openai.md +++ b/translations/lt/02-SetupDevEnvironment/getting-started-azure-openai.md @@ -1,12 +1,3 @@ - --- diff --git a/translations/lt/03-CoreGenerativeAITechniques/README.md b/translations/lt/03-CoreGenerativeAITechniques/README.md index 6d2ccf79..0f5cf91f 100644 --- a/translations/lt/03-CoreGenerativeAITechniques/README.md +++ b/translations/lt/03-CoreGenerativeAITechniques/README.md @@ -1,12 +1,3 @@ - # Pagrindinių Generatyviosios AI Technikų Pamoka ## Turinys diff --git a/translations/lt/04-PracticalSamples/README.md b/translations/lt/04-PracticalSamples/README.md index 891fc6e8..c9d889ce 100644 --- a/translations/lt/04-PracticalSamples/README.md +++ b/translations/lt/04-PracticalSamples/README.md @@ -1,12 +1,3 @@ - --- diff --git a/translations/lt/04-PracticalSamples/calculator/README.md b/translations/lt/04-PracticalSamples/calculator/README.md index 9dc7d76d..569afd95 100644 --- a/translations/lt/04-PracticalSamples/calculator/README.md +++ b/translations/lt/04-PracticalSamples/calculator/README.md @@ -1,12 +1,3 @@ - # MCP skaičiuoklės pamoka pradedantiesiems ## Turinys diff --git a/translations/lt/04-PracticalSamples/foundrylocal/README.md b/translations/lt/04-PracticalSamples/foundrylocal/README.md index f7dffed9..70c7efe6 100644 --- a/translations/lt/04-PracticalSamples/foundrylocal/README.md +++ b/translations/lt/04-PracticalSamples/foundrylocal/README.md @@ -1,12 +1,3 @@ - # Foundry Local Spring Boot Pamoka ## Turinys diff --git a/translations/lt/04-PracticalSamples/petstory/README.md b/translations/lt/04-PracticalSamples/petstory/README.md index 27746711..c9d889ce 100644 --- a/translations/lt/04-PracticalSamples/petstory/README.md +++ b/translations/lt/04-PracticalSamples/petstory/README.md @@ -1,12 +1,3 @@ - --- diff --git a/translations/lt/05-ResponsibleGenAI/README.md b/translations/lt/05-ResponsibleGenAI/README.md index 6048f6e0..c9d889ce 100644 --- a/translations/lt/05-ResponsibleGenAI/README.md +++ b/translations/lt/05-ResponsibleGenAI/README.md @@ -1,12 +1,3 @@ - --- diff --git a/translations/lt/AGENTS.md b/translations/lt/AGENTS.md index 4b118e06..979ed425 100644 --- a/translations/lt/AGENTS.md +++ b/translations/lt/AGENTS.md @@ -1,12 +1,3 @@ - # AGENTS.md ## Projekto apžvalga diff --git a/translations/lt/CODE_OF_CONDUCT.md b/translations/lt/CODE_OF_CONDUCT.md index 4c0d8281..c9d889ce 100644 --- a/translations/lt/CODE_OF_CONDUCT.md +++ b/translations/lt/CODE_OF_CONDUCT.md @@ -1,12 +1,3 @@ - --- diff --git a/translations/lt/README.md b/translations/lt/README.md index 78561891..e6519054 100644 --- a/translations/lt/README.md +++ b/translations/lt/README.md @@ -1,140 +1,132 @@ - -# Generatyvinis DI pradedantiesiems – Java leidimas +# Generatyvioji dirbtinis intelektas pradedantiesiems – Java leidimas [![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) -![Generatyvinis DI pradedantiesiems – Java leidimas](../../translated_images/lt/beg-genai-series.8b48be9951cc574c.webp) +![Generatyvioji dirbtinis intelektas pradedantiesiems – Java leidimas](../../translated_images/lt/beg-genai-series.8b48be9951cc574c.webp) -**Laiko sąnaudų kiekis**: Visa dirbtuvė gali būti atlikta internetu be vietinės aplinkos konfigūracijos. Aplinkos paruošimas užtrunka 2 minutes, o pavyzdžių tyrinėjimas – nuo 1 iki 3 valandų, priklausomai nuo tyrinėjimo gylio. +**Laiko sąnaudos**: Visą dirbtuves galima baigti internetu be vietinio nustatymo. Aplinkos paruošimas trunka 2 minutes, o pavyzdžių tyrinėjimas užtrunka 1–3 valandas priklausomai nuo tyrinėjimo gylio. -> **Greitas pradėjimas** +> **Greitas pradėjimas** -1. Padarykite šio saugyklos šaką (fork) į savo GitHub paskyrą -2. Paspauskite **Code** → **Codespaces** skirtuką → **...** → **New with options...** -3. Naudokite numatytuosius nustatymus – tai pasirinkti šiam kursui sukurtą kūrimo konteinerį -4. Paspauskite **Create codespace** -5. Palaukite ~2 minutes, kol aplinka bus paruošta -6. Eikite tiesiai į [Pirmąjį pavyzdį](./02-SetupDevEnvironment/README.md#step-2-create-a-github-personal-access-token) +1. Padarykite šio saugyklos šaką savo GitHub paskyroje +2. Spustelėkite **Code** → skirtuką **Codespaces** → **...** → **New with options...** +3. Naudokite numatytuosius nustatymus – bus pasirinkta šiam kursui sukurta kūrimo konteineris +4. Spustelėkite **Create codespace** +5. Laukite ~2 minutes, kol aplinka bus paruošta +6. Tiesiogiai pereikite prie [Pirmojo pavyzdžio](./02-SetupDevEnvironment/README.md#step-2-create-a-github-personal-access-token) > **Norite klonuoti vietoje?** - -> Ši saugykla apima daugiau nei 50 kalbų vertimų, todėl reikšmingai padidėja atsisiuntimo dydis. Kad galėtumėte klonuoti be vertimų, naudokite sparse checkout: +> +> Ši saugykla turi daugiau kaip 50 kalbų vertimų, kurie gerokai padidina atsisiuntimo dydį. Norėdami klonuoti be vertimų, naudokite sparse checkout: > ```bash > git clone --filter=blob:none --sparse https://github.com/microsoft/Generative-AI-for-beginners-java.git > cd Generative-AI-for-beginners-java > git sparse-checkout set --no-cone '/*' '!translations' '!translated_images' > ``` -> Tai suteikia viską, ko reikia kursui įveikti, ir atsisiuntimas vyksta žymiai greičiau. +> Tai suteiks jums viską, ko reikia kursui baigti, žymiai greičiau atsisiųsiant. + -## Daugiakalbė palaikymas +## Daugiakalbė parama -### Palaikoma per GitHub Action (automatizuota ir visada atnaujinama) +### Palaikoma per GitHub Action (automatizuota ir visada atnaujinta) -[Arabų](../ar/README.md) | [Bengalų](../bn/README.md) | [Bulgarų](../bg/README.md) | [Birmos (Mjanmaras)](../my/README.md) | [Kinų (supaprastinta)](../zh/README.md) | [Kinų (tradicinė, Honkongas)](../hk/README.md) | [Kinų (tradicinė, Makao)](../mo/README.md) | [Kinų (tradicinė, Taivanas)](../tw/README.md) | [Kroatų](../hr/README.md) | [Čekų](../cs/README.md) | [Danų](../da/README.md) | [Olandų](../nl/README.md) | [Estų](../et/README.md) | [Suomių](../fi/README.md) | [Prancūzų](../fr/README.md) | [Vokiečių](../de/README.md) | [Graikų](../el/README.md) | [Hebrajų](../he/README.md) | [Hindi](../hi/README.md) | [Vengrų](../hu/README.md) | [Indoneziečių](../id/README.md) | [Italų](../it/README.md) | [Japonų](../ja/README.md) | [Kannadų](../kn/README.md) | [Korėjiečių](../ko/README.md) | [Lietuvių](./README.md) | [Malajų](../ms/README.md) | [Malajalamų](../ml/README.md) | [Marati](../mr/README.md) | [Nepaliečių](../ne/README.md) | [Nigerijos pidžino](../pcm/README.md) | [Norvegų](../no/README.md) | [Persų (farsų)](../fa/README.md) | [Lenkų](../pl/README.md) | [Portugalų (Brazilija)](../br/README.md) | [Portugalų (Portugalija)](../pt/README.md) | [Pandžabų (Gurmukhi)](../pa/README.md) | [Rumunų](../ro/README.md) | [Rusų](../ru/README.md) | [Serbų (kirilica)](../sr/README.md) | [Slovakų](../sk/README.md) | [Slovėnų](../sl/README.md) | [Ispanų](../es/README.md) | [Suahelių](../sw/README.md) | [Švedų](../sv/README.md) | [Tagalogų (filipiniečių)](../tl/README.md) | [Tamilų](../ta/README.md) | [Telugų](../te/README.md) | [Tailando](../th/README.md) | [Turkų](../tr/README.md) | [Ukrainiečių](../uk/README.md) | [Urdu](../ur/README.md) | [Vietnamiečių](../vi/README.md) +[Arabų](../ar/README.md) | [Bengalų](../bn/README.md) | [Bulgarų](../bg/README.md) | [Birmos (Mianmaras)](../my/README.md) | [Kinų (supaprastinta)](../zh-CN/README.md) | [Kinų (tradicinė, Honkongas)](../zh-HK/README.md) | [Kinų (tradicinė, Makao)](../zh-MO/README.md) | [Kinų (tradicinė, Taivanas)](../zh-TW/README.md) | [Kroatų](../hr/README.md) | [Čekų](../cs/README.md) | [Danų](../da/README.md) | [Olandų](../nl/README.md) | [Estų](../et/README.md) | [Suomių](../fi/README.md) | [Prancūzų](../fr/README.md) | [Vokiečių](../de/README.md) | [Graikų](../el/README.md) | [Hebrajų](../he/README.md) | [Hindi](../hi/README.md) | [Vengrų](../hu/README.md) | [Indoneziečių](../id/README.md) | [Italų](../it/README.md) | [Japonų](../ja/README.md) | [Kannados](../kn/README.md) | [Korėjiečių](../ko/README.md) | [Lietuvių](./README.md) | [Malajų](../ms/README.md) | [Malajalių](../ml/README.md) | [Maratų](../mr/README.md) | [Nepaliečių](../ne/README.md) | [Nigerijos pidžino](../pcm/README.md) | [Norvegų](../no/README.md) | [Persų (Farsi)](../fa/README.md) | [Lenkų](../pl/README.md) | [Portugalų (Brazilija)](../pt-BR/README.md) | [Portugalų (Portugalija)](../pt-PT/README.md) | [Pandžabių (Gurmukhi)](../pa/README.md) | [Rumunų](../ro/README.md) | [Rusų](../ru/README.md) | [Serbų (kirilica)](../sr/README.md) | [Slovakų](../sk/README.md) | [Slovėnų](../sl/README.md) | [Ispanų](../es/README.md) | [Svahilių](../sw/README.md) | [Švedų](../sv/README.md) | [Tagalogų (Filipinų)](../tl/README.md) | [Tamilų](../ta/README.md) | [Telugų](../te/README.md) | [Tajų](../th/README.md) | [Turkų](../tr/README.md) | [Ukrainiečių](../uk/README.md) | [Urdu](../ur/README.md) | [Vietnamiečių](../vi/README.md) > **Norite klonuoti vietoje?** -> Ši saugykla apima daugiau nei 50 kalbų vertimų, todėl reikšmingai padidėja atsisiuntimo dydis. Kad galėtumėte klonuoti be vertimų, naudokite sparse checkout: +> Ši saugykla turi daugiau kaip 50 kalbų vertimų, kurie gerokai padidina atsisiuntimo dydį. Norėdami klonuoti be vertimų, naudokite sparse checkout: > ```bash > git clone --filter=blob:none --sparse https://github.com/microsoft/Generative-AI-for-beginners-java.git > cd Generative-AI-for-beginners-java > git sparse-checkout set --no-cone '/*' '!translations' '!translated_images' > ``` -> Tai suteikia viską, ko reikia kursui įveikti, ir atsisiuntimas vyksta žymiai greičiau. +> Tai suteiks jums viską, ko reikia kursui baigti, žymiai greičiau atsisiųsiant. ## Kurso struktūra ir mokymosi kelias -### **1 skyrius: Įvadas į generatyvinį DI** -- **Pagrindinės sąvokos**: Didelių kalbos modelių, žetonų, įterpimų ir DI galimybių supratimas -- **Java DI ekosistema**: Apžvalga apie Spring AI ir OpenAI SDK -- **Modelio konteksto protokolas**: MCP pristatymas ir jo vaidmuo DI agentų komunikacijoje -- **Praktinės taikymo sritys**: Tikri scenarijai, įskaitant pokalbių robotus ir turinio generavimą +### **1 skyrius: Įvadas į generatyviąją dirbtinį intelektą** +- **Pagrindinės sąvokos**: Didžiųjų kalbos modelių, žetonų, įterpimų ir DI galimybių supratimas +- **Java DI ekosistema**: Apžvalga apie Spring AI ir OpenAI SDK +- **Modelio konteksto protokolas**: MCP pristatymas ir jo vaidmuo DI agentų komunikacijoje +- **Praktinės taikymo sritys**: Realių gyvenimo scenarijų apžvalga, įskaitant pokalbių robotus ir turinio generavimą - **[→ Pradėti 1 skyrių](./01-IntroToGenAI/README.md)** -### **2 skyrius: Kūrimo aplinkos paruošimas** -- **Daugiaproveidinių paslaugų konfiguracija**: GitHub Modelių, Azure OpenAI ir OpenAI Java SDK integracijos -- **Spring Boot + Spring AI**: Geriausios praktikos įmonių DI programų kūrimui -- **GitHub Modeliai**: Nemokamas DI modelių prieinamumas prototipams ir mokymuisi (be kreditinės kortelės) -- **Kūrimo įrankiai**: Docker konteineriai, VS Code ir GitHub Codespaces konfigūracija +### **2 skyrius: Kūrimo aplinkos nustatymas** +- **Daugelio tiekėjų konfigūracija**: GitHub Modelių, Azure OpenAI ir OpenAI Java SDK integracijos nustatymas +- **Spring Boot + Spring AI**: Geriausios praktikos įmonių DI programų kūrimui +- **GitHub Modeliai**: Nemokamas DI modelių prieinamumas prototipavimui ir mokymuisi (kredito kortelė nereikalinga) +- **Kūrimo įrankiai**: Docker konteineriai, VS Code ir GitHub Codespaces konfigūracija - **[→ Pradėti 2 skyrių](./02-SetupDevEnvironment/README.md)** -### **3 skyrius: Pagrindinės generatyvinio DI technikos** -- **Promptų inžinerija**: Optimizuoti DI modelių atsakymai -- **Įterpimai ir vektoriniai veiksmai**: Semantinė paieška ir panašumo atitikimas -- **Retrieval-Augmented Generation (RAG)**: Derinti DI su savo duomenų šaltiniais -- **Funkcijų kvietimas**: Išplėsti DI galimybes su individualiais įrankiais ir įskiepių palaikymu +### **3 skyrius: Pagrindinės generatyvios DI technikos** +- **Užklausų inžinerija**: Technikos optimaliam DI modelių atsakymui +- **Įterpimai ir vektorinės operacijos**: Semantinės paieškos ir panašumo atitikimo įgyvendinimas +- **Retrieval-Augmented Generation (RAG)**: DI derinimas su jūsų pačių duomenų šaltiniais +- **Funkcijų kvietimas**: DI galimybių išplėtimas su suasmenintais įrankiais ir papildiniais - **[→ Pradėti 3 skyrių](./03-CoreGenerativeAITechniques/README.md)** ### **4 skyrius: Praktinės taikymo sritys ir projektai** -- **Augintinių pasakų generatorius** (`petstory/`): Kūrybinis turinio generavimas su GitHub Modeliais -- **Foundry vietinė demonstracija** (`foundrylocal/`): Vietinė DI modelio integracija su OpenAI Java SDK -- **MCP skaičiuoklio paslauga** (`calculator/`): Bazinė Modelio konteksto protokolo įgyvendinimas su Spring AI +- **Augintinių istorijos generatorius** (`petstory/`): Kūrybinis turinio generavimas su GitHub Modeliais +- **Foundry vietinė demonstracija** (`foundrylocal/`): Vietinė DI modelių integracija su OpenAI Java SDK +- **MCP skaičiuoklio paslauga** (`calculator/`): Pagrindinė Modelio konteksto protokolo įgyvendinimas su Spring AI - **[→ Pradėti 4 skyrių](./04-PracticalSamples/README.md)** -### **5 skyrius: Atsakingas DI kūrimas** -- **GitHub Modelių saugumas**: Išbandyti įmontuotus turinio filtrus ir saugumo mechanizmus (griežti blokavimai ir minkšti atsisakymai) -- **Atsakingo DI demonstracija**: Praktinis pavyzdys, kaip veikia šiuolaikinės DI saugumo sistemos -- **Geriausios praktikos**: Esminės gairės etiškam DI kūrimui ir diegimui +### **5 skyrius: Atsakingas DI vystymas** +- **GitHub Modelių saugumas**: Integruoto turinio filtravimo ir saugumo mechanizmų (griežtos blokados ir švelnios atsisakymo) testavimas +- **Atsakingo DI demonstracija**: Praktinis pavyzdys, kaip veikia šiuolaikinės DI saugumo sistemos +- **Geriausios praktikos**: Esminės gairės etiškam DI kūrimui ir diegimui - **[→ Pradėti 5 skyrių](./05-ResponsibleGenAI/README.md)** ## Papildomi ištekliai -### LangChain -[![LangChain4j pradedantiesiems](https://img.shields.io/badge/LangChain4j%20for%20Beginners-22C55E?style=for-the-badge&&labelColor=E5E7EB&color=0553D6)](https://aka.ms/langchain4j-for-beginners) -[![LangChain.js pradedantiesiems](https://img.shields.io/badge/LangChain.js%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=0553D6)](https://aka.ms/langchainjs-for-beginners?WT.mc_id=m365-94501-dwahlin) +### LangChain +[![LangChain4j pradedantiesiems](https://img.shields.io/badge/LangChain4j%20pradedantiesiems-22C55E?style=for-the-badge&&labelColor=E5E7EB&color=0553D6)](https://aka.ms/langchain4j-for-beginners) +[![LangChain.js pradedantiesiems](https://img.shields.io/badge/LangChain.js%20pradedantiesiems-22C55E?style=for-the-badge&labelColor=E5E7EB&color=0553D6)](https://aka.ms/langchainjs-for-beginners?WT.mc_id=m365-94501-dwahlin) --- -### Azure / Edge / MCP / Agentai -[![AZD pradedantiesiems](https://img.shields.io/badge/AZD%20for%20Beginners-0078D4?style=for-the-badge&labelColor=E5E7EB&color=0078D4)](https://github.com/microsoft/AZD-for-beginners?WT.mc_id=academic-105485-koreyst) -[![Edge DI pradedantiesiems](https://img.shields.io/badge/Edge%20AI%20for%20Beginners-00B8E4?style=for-the-badge&labelColor=E5E7EB&color=00B8E4)](https://github.com/microsoft/edgeai-for-beginners?WT.mc_id=academic-105485-koreyst) -[![MCP pradedantiesiems](https://img.shields.io/badge/MCP%20for%20Beginners-009688?style=for-the-badge&labelColor=E5E7EB&color=009688)](https://github.com/microsoft/mcp-for-beginners?WT.mc_id=academic-105485-koreyst) -[![DI agentai pradedantiesiems](https://img.shields.io/badge/AI%20Agents%20for%20Beginners-00C49A?style=for-the-badge&labelColor=E5E7EB&color=00C49A)](https://github.com/microsoft/ai-agents-for-beginners?WT.mc_id=academic-105485-koreyst) +### Azure / Edge / MCP / Agentai +[![AZD pradedantiesiems](https://img.shields.io/badge/AZD%20pradedantiesiems-0078D4?style=for-the-badge&labelColor=E5E7EB&color=0078D4)](https://github.com/microsoft/AZD-for-beginners?WT.mc_id=academic-105485-koreyst) +[![Edge DI pradedantiesiems](https://img.shields.io/badge/Edge%20DI%20pradedantiesiems-00B8E4?style=for-the-badge&labelColor=E5E7EB&color=00B8E4)](https://github.com/microsoft/edgeai-for-beginners?WT.mc_id=academic-105485-koreyst) +[![MCP pradedantiesiems](https://img.shields.io/badge/MCP%20pradedantiesiems-009688?style=for-the-badge&labelColor=E5E7EB&color=009688)](https://github.com/microsoft/mcp-for-beginners?WT.mc_id=academic-105485-koreyst) +[![DI agentai pradedantiesiems](https://img.shields.io/badge/DI%20agentai%20pradedantiesiems-00C49A?style=for-the-badge&labelColor=E5E7EB&color=00C49A)](https://github.com/microsoft/ai-agents-for-beginners?WT.mc_id=academic-105485-koreyst) --- - -### Generatyvinio DI serija -[![Generatyvinis DI pradedantiesiems](https://img.shields.io/badge/Generative%20AI%20for%20Beginners-8B5CF6?style=for-the-badge&labelColor=E5E7EB&color=8B5CF6)](https://github.com/microsoft/generative-ai-for-beginners?WT.mc_id=academic-105485-koreyst) -[![Generatyvinis DI (.NET)](https://img.shields.io/badge/Generative%20AI%20(.NET)-9333EA?style=for-the-badge&labelColor=E5E7EB&color=9333EA)](https://github.com/microsoft/Generative-AI-for-beginners-dotnet?WT.mc_id=academic-105485-koreyst) -[![Generatyvinis DI (Java)](https://img.shields.io/badge/Generative%20AI%20(Java)-C084FC?style=for-the-badge&labelColor=E5E7EB&color=C084FC)](https://github.com/microsoft/generative-ai-for-beginners-java?WT.mc_id=academic-105485-koreyst) -[![Generatyvinis DI (JavaScript)](https://img.shields.io/badge/Generative%20AI%20(JavaScript)-E879F9?style=for-the-badge&labelColor=E5E7EB&color=E879F9)](https://github.com/microsoft/generative-ai-with-javascript?WT.mc_id=academic-105485-koreyst) + +### Generatyvios DI serija +[![Generatyvioji DI pradedantiesiems](https://img.shields.io/badge/Generatyvioji%20DI%20pradedantiesiems-8B5CF6?style=for-the-badge&labelColor=E5E7EB&color=8B5CF6)](https://github.com/microsoft/generative-ai-for-beginners?WT.mc_id=academic-105485-koreyst) +[![Generatyvioji DI (.NET)](https://img.shields.io/badge/Generatyvioji%20DI%20(.NET)-9333EA?style=for-the-badge&labelColor=E5E7EB&color=9333EA)](https://github.com/microsoft/Generative-AI-for-beginners-dotnet?WT.mc_id=academic-105485-koreyst) +[![Generatyvioji DI (Java)](https://img.shields.io/badge/Generatyvioji%20DI%20(Java)-C084FC?style=for-the-badge&labelColor=E5E7EB&color=C084FC)](https://github.com/microsoft/generative-ai-for-beginners-java?WT.mc_id=academic-105485-koreyst) +[![Generatyvioji DI (JavaScript)](https://img.shields.io/badge/Generatyvioji%20DI%20(JavaScript)-E879F9?style=for-the-badge&labelColor=E5E7EB&color=E879F9)](https://github.com/microsoft/generative-ai-with-javascript?WT.mc_id=academic-105485-koreyst) --- - -### Pagrindinis mokymasis -[![ML pradedantiesiems](https://img.shields.io/badge/ML%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=22C55E)](https://aka.ms/ml-beginners?WT.mc_id=academic-105485-koreyst) -[![Duomenų mokslas pradedantiesiems](https://img.shields.io/badge/Data%20Science%20for%20Beginners-84CC16?style=for-the-badge&labelColor=E5E7EB&color=84CC16)](https://aka.ms/datascience-beginners?WT.mc_id=academic-105485-koreyst) -[![DI pradedantiesiems](https://img.shields.io/badge/AI%20for%20Beginners-A3E635?style=for-the-badge&labelColor=E5E7EB&color=A3E635)](https://aka.ms/ai-beginners?WT.mc_id=academic-105485-koreyst) -[![Kibernetinis saugumas pradedantiesiems](https://img.shields.io/badge/Cybersecurity%20for%20Beginners-F97316?style=for-the-badge&labelColor=E5E7EB&color=F97316)](https://github.com/microsoft/Security-101?WT.mc_id=academic-96948-sayoung) -[![Tinklapių kūrimas pradedantiesiems](https://img.shields.io/badge/Web%20Dev%20for%20Beginners-EC4899?style=for-the-badge&labelColor=E5E7EB&color=EC4899)](https://aka.ms/webdev-beginners?WT.mc_id=academic-105485-koreyst) -[![IoT pradedantiesiems](https://img.shields.io/badge/IoT%20for%20Beginners-14B8A6?style=for-the-badge&labelColor=E5E7EB&color=14B8A6)](https://aka.ms/iot-beginners?WT.mc_id=academic-105485-koreyst) -[![XR plėtra pradedantiesiems](https://img.shields.io/badge/XR%20Development%20for%20Beginners-38BDF8?style=for-the-badge&labelColor=E5E7EB&color=38BDF8)](https://github.com/microsoft/xr-development-for-beginners?WT.mc_id=academic-105485-koreyst) + +### Pagrindiniai mokymai +[![ML pradedantiesiems](https://img.shields.io/badge/ML%20pradedantiesiems-22C55E?style=for-the-badge&labelColor=E5E7EB&color=22C55E)](https://aka.ms/ml-beginners?WT.mc_id=academic-105485-koreyst) +[![Duomenų mokslas pradedantiesiems](https://img.shields.io/badge/Duomenų%20mokslas%20pradedantiesiems-84CC16?style=for-the-badge&labelColor=E5E7EB&color=84CC16)](https://aka.ms/datascience-beginners?WT.mc_id=academic-105485-koreyst) +[![DI pradedantiesiems](https://img.shields.io/badge/DI%20pradedantiesiems-A3E635?style=for-the-badge&labelColor=E5E7EB&color=A3E635)](https://aka.ms/ai-beginners?WT.mc_id=academic-105485-koreyst) +[![Kibernetinis saugumas pradedantiesiems](https://img.shields.io/badge/Kibernetinis%20saugumas%20pradedantiesiems-F97316?style=for-the-badge&labelColor=E5E7EB&color=F97316)](https://github.com/microsoft/Security-101?WT.mc_id=academic-96948-sayoung) +[![Web Dev pradedantiesiems](https://img.shields.io/badge/Web%20Dev%20for%20Beginners-EC4899?style=for-the-badge&labelColor=E5E7EB&color=EC4899)](https://aka.ms/webdev-beginners?WT.mc_id=academic-105485-koreyst) +[![Daiktų internetas pradedantiesiems](https://img.shields.io/badge/IoT%20for%20Beginners-14B8A6?style=for-the-badge&labelColor=E5E7EB&color=14B8A6)](https://aka.ms/iot-beginners?WT.mc_id=academic-105485-koreyst) +[![XR kūrimas pradedantiesiems](https://img.shields.io/badge/XR%20Development%20for%20Beginners-38BDF8?style=for-the-badge&labelColor=E5E7EB&color=38BDF8)](https://github.com/microsoft/xr-development-for-beginners?WT.mc_id=academic-105485-koreyst) --- -### Copilot Serija -[![Copilot AI poriniam programavimui](https://img.shields.io/badge/Copilot%20for%20AI%20Paired%20Programming-FACC15?style=for-the-badge&labelColor=E5E7EB&color=FACC15)](https://aka.ms/GitHubCopilotAI?WT.mc_id=academic-105485-koreyst) -[![Copilot C#/.NET](https://img.shields.io/badge/Copilot%20for%20C%23/.NET-FBBF24?style=for-the-badge&labelColor=E5E7EB&color=FBBF24)](https://github.com/microsoft/mastering-github-copilot-for-dotnet-csharp-developers?WT.mc_id=academic-105485-koreyst) -[![Copilot Nuotykiai](https://img.shields.io/badge/Copilot%20Adventure-FDE68A?style=for-the-badge&labelColor=E5E7EB&color=FDE68A)](https://github.com/microsoft/CopilotAdventures?WT.mc_id=academic-105485-koreyst) +### Copilot serija +[![Copilot dirbant kartu su AI](https://img.shields.io/badge/Copilot%20for%20AI%20Paired%20Programming-FACC15?style=for-the-badge&labelColor=E5E7EB&color=FACC15)](https://aka.ms/GitHubCopilotAI?WT.mc_id=academic-105485-koreyst) +[![Copilot C#/.NET kalbai](https://img.shields.io/badge/Copilot%20for%20C%23/.NET-FBBF24?style=for-the-badge&labelColor=E5E7EB&color=FBBF24)](https://github.com/microsoft/mastering-github-copilot-for-dotnet-csharp-developers?WT.mc_id=academic-105485-koreyst) +[![Copilot nuotykiai](https://img.shields.io/badge/Copilot%20Adventure-FDE68A?style=for-the-badge&labelColor=E5E7EB&color=FDE68A)](https://github.com/microsoft/CopilotAdventures?WT.mc_id=academic-105485-koreyst) -## Pagalbos gavimas +## Gaunate pagalbą -Jei užstringate arba turite klausimų apie AI programėlių kūrimą. Prisijunkite prie kitų mokinių ir patyrusių programuotojų diskusijų MCP. Tai palaikanti bendruomenė, kur klausimai yra laukiami, o žinios dalijamasi laisvai. +Jei sustojate ar turite klausimų apie dirbtinio intelekto programų kūrimą. Prisijunkite prie kitų mokytis norinčių ir patyrusių kūrėjų diskusijose apie MCP. Tai palaikanti bendruomenė, kurioje klausimai yra laukiami ir žinios laisvai dalijamos. [![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) -Jei turite produktų atsiliepimų ar klaidų kūrimo metu, apsilankykite: +Jei turite pastabų apie produktą ar pastebite klaidų kūrimo metu, apsilankykite: [![Microsoft Foundry Developer Forum](https://img.shields.io/badge/GitHub-Microsoft_Foundry_Developer_Forum-blue?style=for-the-badge&logo=github&color=000000&logoColor=fff)](https://aka.ms/foundry/forum) @@ -142,5 +134,5 @@ Jei turite produktų atsiliepimų ar klaidų kūrimo metu, apsilankykite: **Atsakomybės apribojimas**: -Šis dokumentas buvo išverstas naudojant AI vertimo paslaugą [Co-op Translator](https://github.com/Azure/co-op-translator). Nors siekiame tikslumo, prašome atkreipti dėmesį, kad automatizuoti vertimai gali turėti klaidų ar netikslumų. Originalus dokumentas jo gimtąja kalba turėtų būti laikomas pagrindiniu šaltiniu. Svarbiai informacijai rekomenduojama naudotis profesionalaus žmogaus vertimu. Mes neatsakome už bet kokius nesusipratimus ar klaidingas interpretacijas, atsiradusias naudojantis šiuo vertimu. +Šis dokumentas buvo išverstas naudojant dirbtinio intelekto vertimo paslaugą [Co-op Translator](https://github.com/Azure/co-op-translator). Nors siekiame tikslumo, prašome atkreipti dėmesį, kad automatiniai vertimai gali turėti klaidų ar netikslumų. Pirminis dokumentas originalia kalba turėtų būti laikomas autoritetingu šaltiniu. Svarbiai informacijai rekomenduojamas profesionalus žmogaus vertimas. Mes neatsakome už bet kokius nesusipratimus ar neteisingus vertimus, kylančius dėl šio vertimo naudojimo. \ No newline at end of file diff --git a/translations/lt/SECURITY.md b/translations/lt/SECURITY.md index 4c4651b6..c9d889ce 100644 --- a/translations/lt/SECURITY.md +++ b/translations/lt/SECURITY.md @@ -1,12 +1,3 @@ - --- diff --git a/translations/lt/SUPPORT.md b/translations/lt/SUPPORT.md index 1272d581..c9d889ce 100644 --- a/translations/lt/SUPPORT.md +++ b/translations/lt/SUPPORT.md @@ -1,12 +1,3 @@ - --- diff --git a/translations/ml/.co-op-translator.json b/translations/ml/.co-op-translator.json new file mode 100644 index 00000000..6b2dca96 --- /dev/null +++ b/translations/ml/.co-op-translator.json @@ -0,0 +1,92 @@ +{ + "01-IntroToGenAI/README.md": { + "original_hash": "75bfb080ca725e8a9aa9c80cae25fba1", + "translation_date": "2025-12-01T09:46:32+00:00", + "source_file": "01-IntroToGenAI/README.md", + "language_code": "ml" + }, + "02-SetupDevEnvironment/README.md": { + "original_hash": "96a30d42b9751a3d4e4b20e28d29d459", + "translation_date": "2026-01-28T05:39:07+00:00", + "source_file": "02-SetupDevEnvironment/README.md", + "language_code": "ml" + }, + "02-SetupDevEnvironment/examples/basic-chat-azure/README.md": { + "original_hash": "efd82efe50711d7e257eb943151d682c", + "translation_date": "2025-12-01T09:37:48+00:00", + "source_file": "02-SetupDevEnvironment/examples/basic-chat-azure/README.md", + "language_code": "ml" + }, + "02-SetupDevEnvironment/getting-started-azure-openai.md": { + "original_hash": "bfdb4b4eadbee3a59ef742439f58326a", + "translation_date": "2025-12-01T09:33:02+00:00", + "source_file": "02-SetupDevEnvironment/getting-started-azure-openai.md", + "language_code": "ml" + }, + "03-CoreGenerativeAITechniques/README.md": { + "original_hash": "685f55cb07de19b52a30ce6e8b6d889e", + "translation_date": "2025-12-01T09:42:19+00:00", + "source_file": "03-CoreGenerativeAITechniques/README.md", + "language_code": "ml" + }, + "04-PracticalSamples/README.md": { + "original_hash": "14c0a61ecc1cd2012a9c129236dfdf71", + "translation_date": "2025-12-01T09:15:46+00:00", + "source_file": "04-PracticalSamples/README.md", + "language_code": "ml" + }, + "04-PracticalSamples/calculator/README.md": { + "original_hash": "b6c16b5514d524e415a94f6097ee7d4c", + "translation_date": "2025-12-01T09:18:44+00:00", + "source_file": "04-PracticalSamples/calculator/README.md", + "language_code": "ml" + }, + "04-PracticalSamples/foundrylocal/README.md": { + "original_hash": "f787307400de59adc25a1404466a35f3", + "translation_date": "2025-12-01T09:22:29+00:00", + "source_file": "04-PracticalSamples/foundrylocal/README.md", + "language_code": "ml" + }, + "04-PracticalSamples/petstory/README.md": { + "original_hash": "0cbf68d605615a1e602c832a24616859", + "translation_date": "2025-12-01T09:26:40+00:00", + "source_file": "04-PracticalSamples/petstory/README.md", + "language_code": "ml" + }, + "05-ResponsibleGenAI/README.md": { + "original_hash": "301c05c2f57e60a6950b8c665b8bdbba", + "translation_date": "2025-12-01T09:30:26+00:00", + "source_file": "05-ResponsibleGenAI/README.md", + "language_code": "ml" + }, + "AGENTS.md": { + "original_hash": "afc90918d008cf77fd1982691f681306", + "translation_date": "2025-12-01T09:06:25+00:00", + "source_file": "AGENTS.md", + "language_code": "ml" + }, + "CODE_OF_CONDUCT.md": { + "original_hash": "442b123d034f92f7c384d2bbd28f99f1", + "translation_date": "2025-12-01T09:13:30+00:00", + "source_file": "CODE_OF_CONDUCT.md", + "language_code": "ml" + }, + "README.md": { + "original_hash": "125a08948d881c95628094f4dd1fbd43", + "translation_date": "2026-01-29T16:30:45+00:00", + "source_file": "README.md", + "language_code": "ml" + }, + "SECURITY.md": { + "original_hash": "57f14126c1c6add76b3aef3844dfe4e3", + "translation_date": "2025-12-01T09:14:18+00:00", + "source_file": "SECURITY.md", + "language_code": "ml" + }, + "SUPPORT.md": { + "original_hash": "b8ef73cc49dec68e2c885ee9df545129", + "translation_date": "2025-12-01T09:12:57+00:00", + "source_file": "SUPPORT.md", + "language_code": "ml" + } +} \ No newline at end of file diff --git a/translations/ml/01-IntroToGenAI/README.md b/translations/ml/01-IntroToGenAI/README.md index dc993c56..5dfb0eb3 100644 --- a/translations/ml/01-IntroToGenAI/README.md +++ b/translations/ml/01-IntroToGenAI/README.md @@ -1,12 +1,3 @@ - # ജനറേറ്റീവ് AI - ജാവ എഡിഷൻ പരിചയം ## നിങ്ങൾ പഠിക്കുന്നതെന്താണ് diff --git a/translations/ml/02-SetupDevEnvironment/README.md b/translations/ml/02-SetupDevEnvironment/README.md index 0595d9da..e197de1b 100644 --- a/translations/ml/02-SetupDevEnvironment/README.md +++ b/translations/ml/02-SetupDevEnvironment/README.md @@ -1,187 +1,180 @@ - -# ജാവയ്ക്കുള്ള ജനറേറ്റീവ് AI വികസന പരിസ്ഥിതി സജ്ജമാക്കൽ +# ജാവയ്ക്കായുള്ള ജനറേറ്റീവ് എഐ വികസന പരിസ്ഥിതി സജ്ജമാക്കൽ -> **ക്വിക്ക് സ്റ്റാർട്ട്**: ക്ലൗഡിൽ 2 മിനിറ്റിൽ കോഡ് ചെയ്യുക - [GitHub Codespaces Setup](../../../02-SetupDevEnvironment) എന്ന ഭാഗത്തേക്ക് ചാടുക - പ്രാദേശിക ഇൻസ്റ്റലേഷൻ ആവശ്യമില്ല, GitHub മോഡലുകൾ ഉപയോഗിക്കുന്നു! +> **ത്വരിതാരംഭം**: 2 മിനിറ്റിനുള്ളിൽ ക്ലൗഡിൽ കോഡ് ചെയ്യാം - [GitHub Codespaces സെറ്റപ്പ്](../../../02-SetupDevEnvironment) എന്നതിലേക്ക് ഓടുക - ലൊക്കൽ ഇൻസ്റ്റാളേഷൻ ആവശ്യമില്ല, github മോഡലുകൾ ഉപയോഗിക്കുന്നു! -> **Azure OpenAI-ൽ താൽപ്പര്യമുണ്ടോ?**, പുതിയ Azure OpenAI റിസോഴ്സ് സൃഷ്ടിക്കുന്നതിനുള്ള ഘട്ടങ്ങൾക്കായി [Azure OpenAI Setup Guide](getting-started-azure-openai.md) കാണുക. +> **Azure OpenAI-ൽ താൽപര്യമുണ്ടോ?**, പുതിയ Azure OpenAI റിസോഴ്‌സ് സൃഷ്‌ടിക്കുന്ന കാര്യങ്ങൾ അടങ്ങിയ [Azure OpenAI സെറ്റപ്പ് ഗൈഡ്](getting-started-azure-openai.md) കാണുക. -## നിങ്ങൾ പഠിക്കുന്നതെന്താണ് +## നിങ്ങൾക്ക് എന്നെക്കുറിച്ച് പഠിക്കാനാകുന്നത് -- AI ആപ്ലിക്കേഷനുകൾക്കായി ഒരു ജാവ വികസന പരിസ്ഥിതി സജ്ജമാക്കുക -- നിങ്ങളുടെ ഇഷ്ടാനുസൃത വികസന പരിസ്ഥിതി തിരഞ്ഞെടുക്കുക, ക്രമീകരിക്കുക (Codespaces ഉപയോഗിച്ച് ക്ലൗഡ്-ഫസ്റ്റ്, പ്രാദേശിക ഡെവ് കണ്ടെയ്നർ, അല്ലെങ്കിൽ പൂർണ്ണ പ്രാദേശിക സജ്ജീകരണം) -- GitHub മോഡലുകളുമായി ബന്ധപ്പെടുന്നതിലൂടെ നിങ്ങളുടെ സജ്ജീകരണം പരീക്ഷിക്കുക +- എഐ ആപ്ലിക്കേഷനുകൾക്കായി ജാവ ഡെവലപ്പ്മെന്റ് എൻവയോൺമെന്റ് സജ്ജമാക്കുക +- നിങ്ങളുടെ ഇഷ്ടാനുസൃത ഡെവലപ്പ്മെന്റ് പരിസ്ഥിതിയെ തെരഞ്ഞെടുത്തു കോൺഫിഗർ ചെയ്യുക (Codespaces ഉപയോഗിച്ച് ക്ലൗഡ്-ഫസ്റ്റ്, ലോക്കൽ ഡെവ് കണ്ടെയ്‌നർ, അല്ലെങ്കിൽ പൂർണ്ണ ലോക്കൽ സെറ്റപ്പ്) +- GitHub മോഡലുകളുമായി എളുപ്പത്തിൽ കണക്ട് ചെയ്ത് നിങ്ങളുടെ സെറ്റപ്പ് പരീക്ഷിക്കുക ## ഉള്ളടക്ക പട്ടിക -- [നിങ്ങൾ പഠിക്കുന്നതെന്താണ്](../../../02-SetupDevEnvironment) +- [നിങ്ങൾക്ക് പഠിക്കാനാകുന്നത്](../../../02-SetupDevEnvironment) - [പരിചയം](../../../02-SetupDevEnvironment) -- [ഘട്ടം 1: നിങ്ങളുടെ വികസന പരിസ്ഥിതി സജ്ജമാക്കുക](../../../02-SetupDevEnvironment) - - [ഓപ്ഷൻ A: GitHub Codespaces (ശുപാർശ ചെയ്യുന്നു)](../../../02-SetupDevEnvironment) - - [ഓപ്ഷൻ B: പ്രാദേശിക ഡെവ് കണ്ടെയ്നർ](../../../02-SetupDevEnvironment) - - [ഓപ്ഷൻ C: നിങ്ങളുടെ നിലവിലെ പ്രാദേശിക ഇൻസ്റ്റലേഷൻ ഉപയോഗിക്കുക](../../../02-SetupDevEnvironment) -- [ഘട്ടം 2: GitHub Personal Access Token സൃഷ്ടിക്കുക](../../../02-SetupDevEnvironment) -- [ഘട്ടം 3: നിങ്ങളുടെ സജ്ജീകരണം പരീക്ഷിക്കുക](../../../02-SetupDevEnvironment) -- [പ്രശ്നപരിഹാരം](../../../02-SetupDevEnvironment) +- [പടി 1: നിങ്ങളുടെ ഡെവലപ്പ്മെന്റ് എൻവയോൺമെന്റ് സജ്ജമാക്കുക](../../../02-SetupDevEnvironment) + - [ഓപ്ഷൻ A: GitHub Codespaces (ശുപാർശ ചെയ്‌തത്)](../../../02-SetupDevEnvironment) + - [ഓപ്ഷൻ B: ലോക്കൽ ഡെവ് കണ്ടെയ്‌നർ](../../../02-SetupDevEnvironment) + - [ഓപ്ഷൻ C: നിങ്ങളുടെ നിലവിലുള്ള ലോക്കൽ ഇൻസ്റ്റാളേഷൻ ഉപയോഗിക്കുക](../../../02-SetupDevEnvironment) +- [പടി 2: GitHub പേഴ്‌സണൽ ആക്സസ് ടോക്കൺ സൃഷ്‌ടിക്കുക](../../../02-SetupDevEnvironment) +- [പടി 3: GitHub മോഡലുകളുടെ ഉദാഹരണത്തോടെ നിങ്ങളുടെ സെറ്റപ്പ് പരീക്ഷിക്കുക](../../../02-SetupDevEnvironment) +- [സമസ്യാനിവാരണങ്ങൾ](../../../02-SetupDevEnvironment) - [സംഗ്രഹം](../../../02-SetupDevEnvironment) - [അടുത്ത ഘട്ടങ്ങൾ](../../../02-SetupDevEnvironment) ## പരിചയം -ഈ അധ്യായം ഒരു വികസന പരിസ്ഥിതി സജ്ജമാക്കുന്നതിലൂടെ നിങ്ങളെ നയിക്കും. **GitHub മോഡലുകൾ** പ്രധാന ഉദാഹരണമായി ഉപയോഗിക്കും, കാരണം ഇത് സൗജന്യമാണ്, GitHub അക്കൗണ്ട് ഉപയോഗിച്ച് എളുപ്പത്തിൽ സജ്ജമാക്കാം, ക്രെഡിറ്റ് കാർഡ് ആവശ്യമില്ല, പരീക്ഷണത്തിനായി നിരവധി മോഡലുകൾ ലഭ്യമാണ്. +ഈ അധ്യായം വികസന പരിസ്ഥിതിയുടെ സജ്ജീകരണത്തിൽ നിങ്ങൾക്ക് വഴികാട്ടിയാണ്. ഞങ്ങൾ പ്രാഥമിക ഉദാഹരണമായി **GitHub Models** ഉപയോഗിക്കാം കാരണം ഇത് സൗജന്യമാണ്, ലളിതമായി GitHub അക്കൗണ്ട് മാത്രം ഉപയോഗിച്ച് സജ്ജമാക്കാം, ക്രെഡിറ്റ് കാർഡ് ആവശ്യമില്ല, പരീക്ഷണങ്ങൾക്ക് പല മോഡലുകളിലേക്കും ആക്സസ് നൽകുന്നു. -**പ്രാദേശിക സജ്ജീകരണം ആവശ്യമില്ല!** GitHub Codespaces ഉപയോഗിച്ച് നിങ്ങളുടെ ബ്രൗസറിൽ ഒരു പൂർണ്ണ വികസന പരിസ്ഥിതി ലഭ്യമാക്കി ഉടൻ കോഡിംഗ് ആരംഭിക്കാം. +**ലോക്കൽ സെറ്റപ്പ് ആവശ്യമില്ല!** GitHub Codespaces ഉപയോഗിച്ച് നിങ്ങളെത്തന്നെ ബ്രൗസറില്‍ പൂർണ്ണ ഡെവലപ്പ്മെന്റ് എൻവയോൺമെന്റ് ഉപയോഗിച്ച് കോഡിങ് ഉടൻ തന്നെ ആരംഭിക്കാം. -സ്ക്രീൻഷോട്ട്: GitHub മോഡലുകൾ +സ്ക്രീൻഷോട്ട്: GitHub മോഡലുകൾ -ഈ കോഴ്സിനായി [**GitHub മോഡലുകൾ**](https://github.com/marketplace?type=models) ഉപയോഗിക്കാൻ ഞങ്ങൾ ശുപാർശ ചെയ്യുന്നു, കാരണം: -- **സൗജന്യമായി** ആരംഭിക്കാം -- **എളുപ്പത്തിൽ** GitHub അക്കൗണ്ട് ഉപയോഗിച്ച് സജ്ജമാക്കാം -- **ക്രെഡിറ്റ് കാർഡ്** ആവശ്യമില്ല -- **നിരവധി മോഡലുകൾ** പരീക്ഷണത്തിനായി ലഭ്യമാണ് +ഈ കോഴ്‌സിനായി [**GitHub Models**](https://github.com/marketplace?type=models) ഉപയോഗിക്കാൻ ഞങ്ങൾ ശുപാർശ ചെയ്യുന്നു കാരണം ഇത്: +- **സൗജന്യം** ആരംഭിക്കാൻ +- **വളരെ ലളിതം** GitHub അക്കൗണ്ട് മാത്രം കൊണ്ട് സജ്ജീകരിക്കാൻ +- **ക്രെഡിറ്റ് കാർഡ് ആവശ്യമില്ല** +- **പല മോഡലുകൾ** പരീക്ഷണങ്ങൾക്ക് ലഭ്യമാണ് -> **കുറിപ്പ്**: ഈ പരിശീലനത്തിൽ ഉപയോഗിക്കുന്ന GitHub മോഡലുകൾക്ക് ഈ സൗജന്യ പരിധികളുണ്ട്: -> - മിനിറ്റിൽ 15 അഭ്യർത്ഥനകൾ (ദിവസത്തിൽ 150) -> - ~8,000 വാക്കുകൾ ഇൻപുട്ട്, ~4,000 വാക്കുകൾ ഔട്ട്പുട്ട് ഓരോ അഭ്യർത്ഥനയിലും -> - 5 സമകാലിക അഭ്യർത്ഥനകൾ -> -> ഉത്പാദന ഉപയോഗത്തിനായി, നിങ്ങളുടെ Azure അക്കൗണ്ടുമായി Azure AI Foundry മോഡലുകൾ അപ്ഗ്രേഡ് ചെയ്യുക. നിങ്ങളുടെ കോഡ് മാറ്റേണ്ടതില്ല. [Azure AI Foundry ഡോക്യുമെന്റേഷൻ](https://learn.microsoft.com/azure/ai-foundry/foundry-models/how-to/quickstart-github-models) കാണുക. +> **ഗమనിക്കുക**: ഈ പരിശീലനത്തിൽ ഉപയോഗിക്കുന്ന GitHub മോഡലുകൾക്ക് താഴെപ്പറഞ്ഞ സൗജന്യ പരിമിതികൾ ഉണ്ട്: +> - മിനിറ്റിനു 15 അഭ്യർത്ഥനകൾ (ദിവസത്തിൽ 150) +> - ഏക അഭ്യർത്ഥനയ്ക്ക് ഏകദേശം 8,000 വാക്ക് ഇൻപുട്ട്, 4,000 വാക്ക് ഔട്ട്പുട്ട് +> - 5 സമാന്തര അഭ്യർത്ഥനകൾ +> +> പ്രോഡക്ഷൻ ഉപയോഗത്തിനായി, Azure അക്കൗണ്ടും ഉപയോഗിച്ച് Azure AI Foundry മോഡലിലേക്ക് അപ്ഗ്രേഡ് ചെയ്യാം. നിങ്ങളുടെ കോഡ് മാറ്റേണ്ടതില്ല. [Azure AI Foundry ഡോക്യുമെന്റേഷൻ](https://learn.microsoft.com/azure/ai-foundry/foundry-models/how-to/quickstart-github-models) കാണുക. -## ഘട്ടം 1: നിങ്ങളുടെ വികസന പരിസ്ഥിതി സജ്ജമാക്കുക +## പടി 1: നിങ്ങളുടെ ഡെവലപ്പ്മെന്റ് എൻവയോൺമെന്റ് സജ്ജമാക്കുക -ഈ Generative AI for Java കോഴ്സിനായി ആവശ്യമായ എല്ലാ ഉപകരണങ്ങളും ഉൾക്കൊള്ളുന്ന ഒരു മുൻകൂട്ടി ക്രമീകരിച്ച വികസന കണ്ടെയ്നർ ഞങ്ങൾ സൃഷ്ടിച്ചിട്ടുണ്ട്. നിങ്ങളുടെ ഇഷ്ടാനുസൃത വികസന സമീപനം തിരഞ്ഞെടുക്കുക: +ഈ ജനറേറ്റീവ് എഐ ജാവ കോഴ്‌സിനായി ആവശ്യമായ എല്ലാ ടൂൾസും ഉൾപ്പെടുത്തിയ ഒരു മുമ്പ് കോൺഫിഗർ ചെയ്ത ഡെവ് കണ്ടെയ്‌നർ ഞങ്ങൾ സൃഷ്‌ടിച്ചു. നിങ്ങളുടെ ഇഷ്ടാനുസൃത ഡെവലപ്പ്മെന്റ് രീതിയെ തിരഞ്ഞെടുക്കാം: ### പരിസ്ഥിതി സജ്ജീകരണ ഓപ്ഷനുകൾ: -#### ഓപ്ഷൻ A: GitHub Codespaces (ശുപാർശ ചെയ്യുന്നു) +#### ഓപ്ഷൻ A: GitHub Codespaces (ശുപാർശ ചെയ്യുന്നത്) -**2 മിനിറ്റിൽ കോഡിംഗ് ആരംഭിക്കുക - പ്രാദേശിക സജ്ജീകരണം ആവശ്യമില്ല!** +**2 മിനിറ്റിനുള്ളിൽ കോഡിങ് തുടങ്ങാം - ലോക്കൽ സെറ്റ് അപ് വേണ്ട!** -1. ഈ റിപോസിറ്ററി നിങ്ങളുടെ GitHub അക്കൗണ്ടിലേക്ക് Fork ചെയ്യുക - > **കുറിപ്പ്**: അടിസ്ഥാന കോൺഫിഗറേഷൻ എഡിറ്റ് ചെയ്യാൻ ആഗ്രഹിക്കുന്നുവെങ്കിൽ [Dev Container Configuration](../../../.devcontainer/devcontainer.json) കാണുക -2. **Code** → **Codespaces** tab → **...** → **New with options...** ക്ലിക്ക് ചെയ്യുക -3. ഡീഫോൾട്ടുകൾ ഉപയോഗിക്കുക – ഇത് **Generative AI Java Development Environment** എന്ന കസ്റ്റം ഡെവ് കണ്ടെയ്നർ തിരഞ്ഞെടുക്കും -4. **Create codespace** ക്ലിക്ക് ചെയ്യുക -5. പരിസ്ഥിതി സജ്ജമാകാൻ ~2 മിനിറ്റ് കാത്തിരിക്കുക -6. [Step 2: Create GitHub Token](../../../02-SetupDevEnvironment) ഭാഗത്തേക്ക് മുന്നോട്ട് പോകുക +1. ഈ റിപ്പോസിറ്ററി നിങ്ങളുടെ GitHub അക്കൗണ്ടിലേക്ക് ഫോർക്ക് ചെയ്യുക + > **ഗమనിച്ച്**: അടിസ്ഥാന കോൺഫിഗറేషన్ എഡിറ്റ് ചെയ്യേണ്ടുവെങ്കിൽ [Dev Container Configuration](../../../.devcontainer/devcontainer.json) കാണുക +2. **Code** → **Codespaces** ടാബ് → **...** → **New with options...** ക്ലിക്ക് ചെയ്യുക +3. ഡിഫോൾട്ടുകൾ ഉപയോഗിക്കുക – ഇത് ഈ കോഴ്‌സിനായി കസ്റ്റം സൃഷ്‌ടിച്ച **Generative AI Java Development Environment** ഡെവ് കണ്ടെയ്‌നർ കോൺഫിഗറേഷൻ തിരഞ്ഞെടുക്കും +4. **Create codespace** ക്ലിക്ക് ചെയ്യുക +5. ഏകദേശം 2 മിനിറ്റ് പരിസ്ഥിതി തയാറാക്കുക എത്താൻ കാത്തിരിക്കുക +6. [പടി 2: GitHub ടോക്കൺ സൃഷ്‌ടിക്കുക](../../../02-SetupDevEnvironment) ലേക്ക് മുന്നോട്ട് -സ്ക്രീൻഷോട്ട്: Codespaces സബ്‌മെനു +സ്ക്രീൻഷോട്ട്: Codespaces സബ്മെനു സ്ക്രീൻഷോട്ട്: New with options -സ്ക്രീൻഷോട്ട്: Create codespace options +സ്ക്രീൻഷോട്ട്: Create codespace ഓപ്ഷനുകൾ -> **Codespaces-ന്റെ ഗുണങ്ങൾ**: -> - പ്രാദേശിക ഇൻസ്റ്റലേഷൻ ആവശ്യമില്ല -> - ബ്രൗസർ ഉള്ള ഏതെങ്കിലും ഉപകരണത്തിൽ പ്രവർത്തിക്കുന്നു -> - എല്ലാ ഉപകരണങ്ങളും ആശ്രിതങ്ങളും മുൻകൂട്ടി ക്രമീകരിച്ചിരിക്കുന്നു -> - വ്യക്തിഗത അക്കൗണ്ടുകൾക്ക് സൗജന്യമായി 60 മണിക്കൂർ -> - എല്ലാ പഠിതാക്കൾക്കും സ്ഥിരമായ പരിസ്ഥിതി +> **Codespaces-ന്റെ ഗുണങ്ങൾ**: +> - ലോക്കൽ ഇൻസ്റ്റാളേഷൻ ആവശ്യമില്ല +> - ഏതേതെങ്കിലും ബ്രൗസർ ഉള്ള ഉപകരണത്തിൽ പ്രവർത്തിക്കും +> - എല്ലാ ടൂൾസും ഡിപ്പെൻഡൻസികളും മുൻകൂട്ടി കോൺഫിഗർ ചെയ്തിരിക്കുന്നു +> - വ്യക്തിഗത അക്കൗണ്ടുകൾക്ക് മാസത്തിലൊരിക്കൽ 60 സൗജന്യ മണിക്കൂറുകൾ +> - എല്ലാ പഠിതാക്കൾക്കും ഒരുമിച്ചുള്ള സ്ഥിരമായ പരിസ്ഥിതി -#### ഓപ്ഷൻ B: പ്രാദേശിക ഡെവ് കണ്ടെയ്നർ +#### ഓപ്ഷൻ B: ലോക്കൽ ഡെവ് കണ്ടെയ്‌നർ -**Docker ഉപയോഗിച്ച് പ്രാദേശിക വികസനം ഇഷ്ടപ്പെടുന്ന ഡെവലപ്പർമാർക്കായി** +**Docker ഉപയോഗിച്ച് ലോക്കൽ ഡെവലപ്പ്മെന്റ് ഇഷ്ടപ്പെടുന്നവർക്കായി** -1. ഈ റിപോസിറ്ററി നിങ്ങളുടെ പ്രാദേശിക മെഷീനിലേക്ക് Fork ചെയ്ത് Clone ചെയ്യുക - > **കുറിപ്പ്**: അടിസ്ഥാന കോൺഫിഗറേഷൻ എഡിറ്റ് ചെയ്യാൻ [Dev Container Configuration](../../../.devcontainer/devcontainer.json) കാണുക -2. [Docker Desktop](https://www.docker.com/products/docker-desktop/)യും [VS Code](https://code.visualstudio.com/)യും ഇൻസ്റ്റാൾ ചെയ്യുക -3. VS Code-ൽ [Dev Containers extension](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers) ഇൻസ്റ്റാൾ ചെയ്യുക -4. റിപോസിറ്ററി ഫോൾഡർ VS Code-ൽ തുറക്കുക -5. **Reopen in Container** ക്ലിക്ക് ചെയ്യുക (അല്ലെങ്കിൽ `Ctrl+Shift+P` → "Dev Containers: Reopen in Container" ഉപയോഗിക്കുക) -6. കണ്ടെയ്നർ നിർമ്മിച്ച് ആരംഭിക്കാൻ കാത്തിരിക്കുക -7. [Step 2: Create GitHub Token](../../../02-SetupDevEnvironment) ഭാഗത്തേക്ക് മുന്നോട്ട് പോകുക +1. ഈ റിപ്പോസിറ്ററിയെ നിങ്ങളുടെloko സിസ്റ്റത്തിലേക്ക് ഫോർക്ക് ചെയ്ത് ക്ലോൺ ചെയ്യുക + > **ഗമായിക്കൽ**: അടിസ്ഥാന കോൺഫിഗറേഷൻ എഡിറ്റ് ചെയ്യേണ്ടുവെങ്കിൽ [Dev Container Configuration](../../../.devcontainer/devcontainer.json) കാണുക +2. [Docker Desktop](https://www.docker.com/products/docker-desktop/) ۽ [VS Code](https://code.visualstudio.com/) ഇൻസ്റ്റാൾ ചെയ്യുക +3. VS Code-ൽ [Dev Containers extension](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers) ഇൻസ്റ്റാൾ ചെയ്യുക +4. റിപ്പോസിറ്ററി ഫോൾഡർ VS Code-ൽ തുറക്കുക +5. പ്രോംപ്റ്റ് ചെയ്യുമ്പോൾ **Reopen in Container** (അല്ലെങ്കിൽ `Ctrl+Shift+P` → "Dev Containers: Reopen in Container") ക്ലിക്ക് ചെയ്യുക +6. കണ്ടെയ്‌നർ നിർമാണവും സ്റ്റാർട്ടും സജ്ജമാകുന്നത് കാത്തിരിക്കുക +7. [പടി 2: GitHub ടോക്കൺ സൃഷ്‌ടിക്കുക](../../../02-SetupDevEnvironment) സമ്മർദ്ദിക്കുക -സ്ക്രീൻഷോട്ട്: Dev container setup +സ്ക്രീൻഷോട്ട്: ഡെവ് കണ്ടെയ്‌നർ സജ്ജീകരണം -സ്ക്രീൻഷോട്ട്: Dev container build complete +സ്ക്രീൻഷോട്ട്: ഡെവ് കണ്ടെയ്‌നർ നിർമാണം പൂർത്തിയായി -#### ഓപ്ഷൻ C: നിങ്ങളുടെ നിലവിലെ പ്രാദേശിക ഇൻസ്റ്റലേഷൻ ഉപയോഗിക്കുക +#### ഓപ്ഷൻ C: നിങ്ങളുടെ നിലവിലുള്ള ലോക്കൽ ഇൻസ്റ്റാളേഷൻ ഉപയോഗിക്കുക -**നിലവിലെ ജാവ പരിസ്ഥിതികൾ ഉള്ള ഡെവലപ്പർമാർക്കായി** +**ഇതുപോലെ ജാവ എൻവയോൺമെന്റ് ഉള്ള ഡെവലപ്പർമാർക്കായി** -ആവശ്യകതകൾ: -- [Java 21+](https://www.oracle.com/java/technologies/javase/jdk21-archive-downloads.html) -- [Maven 3.9+](https://maven.apache.org/download.cgi) -- [VS Code](https://code.visualstudio.com) അല്ലെങ്കിൽ നിങ്ങളുടെ ഇഷ്ടാനുസൃത IDE +ആവശ്യകതകൾ: +- [Java 21+](https://www.oracle.com/java/technologies/javase/jdk21-archive-downloads.html) +- [Maven 3.9+](https://maven.apache.org/download.cgi) +- [VS Code](https://code.visualstudio.com) അല്ലെങ്കിൽ ഇഷ്ടമുള്ള ഐഡിഇ -ഘട്ടങ്ങൾ: -1. ഈ റിപോസിറ്ററി നിങ്ങളുടെ പ്രാദേശിക മെഷീനിലേക്ക് Clone ചെയ്യുക -2. നിങ്ങളുടെ IDE-ൽ പ്രോജക്റ്റ് തുറക്കുക -3. [Step 2: Create GitHub Token](../../../02-SetupDevEnvironment) ഭാഗത്തേക്ക് മുന്നോട്ട് പോകുക +സാങ്കേതിക ചുവടുകൾ: +1. ഈ റിപ്പോസിറ്ററി നിങ്ങളുടെloko സിസ്റ്റത്തിലേക്ക് ക്ലോൺ ചെയ്യുക +2. പ്രോജക്ട് നിങ്ങളുടെ ഐഡി.ഐൽ തുറക്കുക +3. [പടി 2: GitHub ടോക്കൺ സൃഷ്‌ടിക്കുക](../../../02-SetupDevEnvironment) ആരംഭിക്കുക -> **പ്രൊ ടിപ്പ്**: നിങ്ങളുടെ മെഷീൻ കുറഞ്ഞ സ്പെക്കുകൾ ഉള്ളതാണെങ്കിൽ, GitHub Codespaces ഉപയോഗിച്ച് പ്രാദേശിക VS Code ഉപയോഗിക്കുക! ക്ലൗഡ്-ഹോസ്റ്റുചെയ്ത Codespace-നെ പ്രാദേശിക VS Code-യുമായി ബന്ധിപ്പിച്ച് ഇരുവരുടെയും മികച്ച അനുഭവം നേടുക. +> **പ്രോ ടിപ്പ്**: കുറഞ്ഞ സ്പെക്കുള്ള മെഷീൻ ഉള്ളതായി നിങ്ങൾക്ക് VS Code ഉപയോഗിക്കാൻ ആഗ്രഹമുണ്ടെങ്കിൽ GitHub Codespaces ഉപയോഗിക്കുക! നിങ്ങളുടെ പ്രാദേശിക VS Code ക്ലൗഡിൽ ഹോസ്റ്റ് ചെയ്ത Codespace-നു കണക്ട് ചെയ്ത് ഇരട്ട ഗുണം നേടാം. -സ്ക്രീൻഷോട്ട്: created local devcontainer instance +സ്ക്രീൻഷോട്ട്: സൃഷ്‌ടിച്ച ലോക്കൽ ഡെവ് കണ്ടെയ്‌നർ ഇൻസ്റ്റൻസ് -## ഘട്ടം 2: GitHub Personal Access Token സൃഷ്ടിക്കുക +## പടി 2: GitHub പേഴ്‌സണൽ ആക്സസ് ടോക്കൺ സൃഷ്‌ടിക്കുക -1. [GitHub Settings](https://github.com/settings/profile) ഭാഗത്തേക്ക് പോകുക, നിങ്ങളുടെ പ്രൊഫൈൽ മെനുവിൽ നിന്ന് **Settings** തിരഞ്ഞെടുക്കുക. -2. ഇടത് സൈഡ്ബാറിൽ **Developer settings** (സാധാരണയായി താഴെ) ക്ലിക്ക് ചെയ്യുക. -3. **Personal access tokens** വിഭാഗത്തിൽ **Fine-grained tokens** ക്ലിക്ക് ചെയ്യുക (അല്ലെങ്കിൽ ഈ [ലിങ്ക്](https://github.com/settings/personal-access-tokens) പിന്തുടരുക). -4. **Generate new token** ക്ലിക്ക് ചെയ്യുക. -5. "Token name" എന്നതിൽ ഒരു വിവരണാത്മകമായ പേര് നൽകുക (ഉദാ., `GenAI-Java-Course-Token`). -6. കാലാവധി തീയതി സജ്ജമാക്കുക (സുരക്ഷാ മികച്ച രീതികൾക്കായി: 7 ദിവസം ശുപാർശ ചെയ്യുന്നു). -7. "Resource owner" എന്നതിൽ നിങ്ങളുടെ ഉപയോക്തൃ അക്കൗണ്ട് തിരഞ്ഞെടുക്കുക. -8. "Repository access" എന്നതിൽ GitHub മോഡലുകൾ ഉപയോഗിക്കാൻ നിങ്ങൾ ആഗ്രഹിക്കുന്ന റിപോസിറ്ററികൾ തിരഞ്ഞെടുക്കുക (അല്ലെങ്കിൽ "All repositories" ആവശ്യമെങ്കിൽ). -9. "Account permissions" എന്നതിൽ **Models** കണ്ടെത്തി **Read-only** ആയി സജ്ജമാക്കുക. -10. **Generate token** ക്ലിക്ക് ചെയ്യുക. -11. **നിങ്ങളുടെ ടോക്കൺ ഇപ്പോൾ കോപ്പി ചെയ്ത് സംരക്ഷിക്കുക** – ഇത് വീണ്ടും കാണാൻ കഴിയില്ല! +1. [GitHub കൂടിയാലോചനകൾ (Settings)](https://github.com/settings/profile) തുറന്നിട്ട് പ്രൊഫൈൽ മെനുവിൽ നിന്നു **Settings** തിരഞ്ഞെടുക്കുക +2. ഇടതുവശം പാനലിൽ താഴെ, **Developer settings** ക്ലിക്ക് ചെയ്യുക +3. **Personal access tokens** കീഴിൽ **Fine-grained tokens** ക്ലിക്ക് ചെയ്യുക (അല്ലെങ്കിൽ [ഒറ്റകാഴ്ച link](https://github.com/settings/personal-access-tokens) പിന്തുടരുക) +4. **Generate new token** ക്ലിക്ക് ചെയ്യുക +5. "Token name" എന്നിടത്ത് വിവരണപരമായ പേര് നൽകുക (ഉദാ., `GenAI-Java-Course-Token`) +6. അവസാനിച്ചത് ഊഹിപ്പിക്കുന്ന തീയതി നൽകുക (7 ദിവസം ഒന്നാംശം ശുപാർശ ചെയ്യുന്നു) +7. "Resource owner" എന്നിടത്ത് നിങ്ങളുടെ യൂസർ അക്കൗണ്ട് തിരഞ്ഞെടുക്കുക +8. "Repository access" ന് താഴെ GitHub മോഡലുകളുമായി ഉപയോഗിക്കാൻ ആഗ്രഹിക്കുന്ന റിപ്പോസിറ്ററികൾ തിരഞ്ഞെടുക്കുക ("All repositories" വേണ്ടെങ്കിൽ) +9. "Account permissions" ൽ **Models** കണ്ടെത്തി അതിനെ **Read-only** ആക്കി സജ്ജമാക്കുക +10. **Generate token** ക്ലിക്ക് ചെയ്യുക +11. **നിങ്ങളുടെ ടോക്കൺ ഇപ്പോൾ കോപ്പി ചെയ്ത് സുരക്ഷിത ഇടത്ത് സൂക്ഷിക്കുക** — വീണ്ടും കാണാൻ സാധിക്കില്ല! -> **സുരക്ഷാ ടിപ്പ്**: നിങ്ങളുടെ ആക്സസ് ടോക്കണുകൾക്കായി ആവശ്യമായ കുറഞ്ഞ സ്കോപ്പ്, ഏറ്റവും കുറഞ്ഞ പ്രായോഗിക കാലാവധി ഉപയോഗിക്കുക. +> **സുരക്ഷാ സൂചന**: നിങ്ങളുടെ ആക്സസ് ടോക്കൺക്ക് ഏറ്റവും കുറഞ്ഞ ആവശ്യമായ സ്കോപ്പും ഏറ്റവും കുരച്ചു സാധ്യമായ കാലാവധി സജ്ജീകരിക്കുക. -## ഘട്ടം 3: GitHub മോഡലുകളുടെ ഉദാഹരണത്തോടെ നിങ്ങളുടെ സജ്ജീകരണം പരീക്ഷിക്കുക +## പടി 3: GitHub മോഡലുകളുടെ ഉദാഹരണത്തോടെ നിങ്ങളുടെ സെറ്റപ്പ് പരീക്ഷിക്കുക -നിങ്ങളുടെ വികസന പരിസ്ഥിതി സജ്ജമായ ശേഷം, [`02-SetupDevEnvironment/examples/github-models`](../../../02-SetupDevEnvironment/examples/github-models) എന്ന ഭാഗത്തെ GitHub മോഡലുകളുടെ സംയോജനം പരീക്ഷിക്കാം. +നിങ്ങളുടെ ഡെവലപ്പ്മെന്റ് പരിസ്ഥിതി സജ്ജമായപ്പോൾ, നമ്മളും GitHub മോഡലുകളുമായി സംയോജനം ശരിയാണെന്ന് `02-SetupDevEnvironment/examples/github-models` എന്ന ഉദാഹരണ അപ്ലിക്കേഷന് പരിശോധിക്കാം. -1. നിങ്ങളുടെ വികസന പരിസ്ഥിതിയിലെ ടെർമിനൽ തുറക്കുക. -2. GitHub മോഡലുകളുടെ ഉദാഹരണത്തിലേക്ക് പോകുക: +1. ഡെവലപ്പ്മെന്റ് എൻവയോൺമെന്റിലെ ടർമിനൽ തുറക്കുക +2. GitHub മോഡലുകൾ ഉള്ള ഉദാഹരണത്തിലേക്ക് കടക്കുക: ```bash cd 02-SetupDevEnvironment/examples/github-models ``` -3. നിങ്ങളുടെ GitHub ടോക്കൺ ഒരു പരിസ്ഥിതി ചാരമായി സജ്ജമാക്കുക: + +3. നിങ്ങളുടെ GitHub ടോക്കൺ എൻവയോൺമെന്റ് വേരിബിൾ ആയി സജ്ജമാക്കുക: ```bash - # മാക്‌ഒഎസ്/ലിനക്സ് + # macOS/Linux export GITHUB_TOKEN=your_token_here - # വിൻഡോസ് (കമാൻഡ് പ്രോംപ്റ്റ്) + # വിൻഡോസ് (കমান്റ് പ്രോംപ്റ്റ്) set GITHUB_TOKEN=your_token_here # വിൻഡോസ് (പവർഷെൽ) $env:GITHUB_TOKEN="your_token_here" ``` - -4. ആപ്ലിക്കേഷൻ പ്രവർത്തിപ്പിക്കുക: + +4. ആപ്ലിക്കേഷൻ റണുചെയ്യുക: ```bash mvn compile exec:java -Dexec.mainClass="com.example.githubmodels.App" ``` - -നിങ്ങൾക്ക് ഇതിന് സമാനമായ ഔട്ട്പുട്ട് കാണാൻ കഴിയും: + +താങ്കൾക്ക് ഇപ്രകാരം ഔട്ട്പുട്ട് കാണാം: ```text Using model: gpt-4.1-nano Sending request to GitHub Models... Response: Hello World! ``` + -### ഉദാഹരണ കോഡ് മനസ്സിലാക്കുക +### ഉദാഹരണ കോഡ് മനസിലാക്കുക -ആദ്യം, നിങ്ങൾ എന്താണ് പ്രവർത്തിപ്പിച്ചതെന്ന് മനസ്സിലാക്കാം. `examples/github-models` എന്ന ഭാഗത്തെ ഉദാഹരണം OpenAI Java SDK ഉപയോഗിച്ച് GitHub മോഡലുകളുമായി ബന്ധപ്പെടുന്നു: +തുടങ്ങുന്നതിന്, ഞങ്ങൾ റൺ ചെയ്ത തത് എന്താണെന്ന് വെളിപ്പെടുത്താം. `examples/github-models` എന്നതിൽ കാണുന്ന ഉദാഹരണം OpenAI Java SDK ഉപയോഗിച്ച് GitHub മോഡലുകളുമായി കണക്ട് ചെയ്യുന്നു: -**ഈ കോഡ് എന്താണ് ചെയ്യുന്നത്:** -- **GitHub മോഡലുകളുമായി** നിങ്ങളുടെ Personal Access Token ഉപയോഗിച്ച് ബന്ധപ്പെടുന്നു -- AI മോഡലിലേക്ക് "Say Hello World!" എന്ന ഒരു ലളിതമായ സന്ദേശം **അയയ്ക്കുന്നു** -- AI-യുടെ പ്രതികരണം **സ്വീകരിച്ച്** പ്രദർശിപ്പിക്കുന്നു -- നിങ്ങളുടെ സജ്ജീകരണം ശരിയായി പ്രവർത്തിക്കുന്നുണ്ടെന്ന് **സാധൂകരിക്കുന്നു** +**ഈ കോഡ് ചെയ്യുന്നത്:** +- നിങ്ങളുടെ വ്യക്തിഗത ആക്സസ് ടോക്കൺ ഉപയോഗിച്ച് GitHub മോഡലുകളുമായി **കണക്ട്** ചെയ്യുന്നു +- "സെ പറയൂ Hello World!" എന്ന് എളുപ്പമൊരു സന്ദേശം AI മോഡലിന് **സമർപ്പിക്കുന്നു** +- AI-യുടെ പ്രതികരണം സ്വീകരിച്ച് പ്രദർശിപ്പിക്കുന്നു +- നിങ്ങളുടെ സെറ്റപ്പ് ശരിയായി പ്രവർത്തിക്കുന്നുവെന്ന് **സ്ഥിരീകരിക്കുന്നു** -**പ്രധാന ആശ്രിതം** (`pom.xml`): +**പ്രധാന ഡിപ്പെൻഡൻസി** (`pom.xml`): ```xml com.openai @@ -189,72 +182,72 @@ Response: Hello World! 2.12.0 ``` - -**പ്രധാന കോഡ്** (`App.java`): + +**പ്രധാന കോഡ്** (`App.java`): ```java -// OpenAI Java SDK ഉപയോഗിച്ച് GitHub മോഡലുകളുമായി ബന്ധപ്പെടുക +// OpenAI ജാവ SDK ഉപയോഗിച്ച് GitHub മോഡലുകളുമായി കണക്ടുചെയ്യുക OpenAIClient client = OpenAIOkHttpClient.builder() .apiKey(pat) .baseUrl("https://models.inference.ai.azure.com") .build(); -// ചാറ്റ് പൂർത്തീകരണ അഭ്യർത്ഥന സൃഷ്ടിക്കുക +// ചാറ്റ് പൂർത്തീകരണത്തിനുള്ള അഭ്യർത്ഥന സൃഷ്‌ടിക്കുക ChatCompletionCreateParams params = ChatCompletionCreateParams.builder() .model(modelId) .addSystemMessage("You are a concise assistant.") .addUserMessage("Say Hello World!") .build(); -// AI പ്രതികരണം നേടുക +// എഐ പ്രതികരണം നേടുക ChatCompletion response = client.chat().completions().create(params); System.out.println("Response: " + response.choices().get(0).message().content().orElse("No response content")); ``` + ## സംഗ്രഹം -ശ്രേമിച്ച്! നിങ്ങൾ ഇപ്പോൾ എല്ലാം സജ്ജമാക്കിയിരിക്കുന്നു: +ശ്രേഷ്ഠം! നിങ്ങൾക്ക് എല്ലാം സജ്ജമാണ്: -- AI മോഡൽ ആക്സസിനായി ശരിയായ അനുമതികളുള്ള GitHub Personal Access Token സൃഷ്ടിച്ചു -- നിങ്ങളുടെ ജാവ വികസന പരിസ്ഥിതി പ്രവർത്തനക്ഷമമാക്കി (Codespaces, ഡെവ് കണ്ടെയ്നറുകൾ, അല്ലെങ്കിൽ പ്രാദേശിക) -- GitHub മോഡലുകളുമായി OpenAI Java SDK ഉപയോഗിച്ച് സൗജന്യ AI വികസനത്തിനായി ബന്ധപ്പെട്ടു -- AI മോഡലുകളുമായി സംസാരിക്കുന്ന ലളിതമായ ഉദാഹരണത്തോടെ എല്ലാം പ്രവർത്തിക്കുന്നുണ്ടെന്ന് പരീക്ഷിച്ചു +- AI മോഡലുകളിലേക്കുള്ള GitHub പേഴ്‌സണൽ ആക്സസ് ടോക്കൺ ആവശ്യമായ അനുമതികളോടെ സൃഷ്‌ടിച്ചു +- നിങ്ങളുടെ ജാവ ഡെവലപ്പ്മെന്റ് എൻവയോൺമെന്റ് ഓടുവാൻ സാധിച്ചു (Codespaces, ഡെവ് കണ്ടെയ്‌നർ, അല്ലെങ്കിൽ ലോക്കൽ മൂന്ന് വഴികൾ ഏത് ആണെങ്കിലും) +- GitHub മോഡലുകളുമായി OpenAI Java SDK ഉപയോഗിച്ചു സൗജന്യ AI വികസനം നടത്തുന്നു +- AI മോഡലിൽ സംവദിക്കുന്ന ഒരു ലളിതമായ ഉദാഹരണത്തോടെ എല്ലാം പരീക്ഷിച്ചു ## അടുത്ത ഘട്ടങ്ങൾ -[Chapter 3: Core Generative AI Techniques](../03-CoreGenerativeAITechniques/README.md) +[അദ്ധ്യായം 3: കോർ ജനറേറ്റീവ് എഐ തന്ത്രങ്ങൾ](../03-CoreGenerativeAITechniques/README.md) -## പ്രശ്നപരിഹാരം +## പ്രശ്നപരിഹാരങ്ങൾ -പ്രശ്നങ്ങൾ ഉണ്ടോ? ഇവിടെ സാധാരണ പ്രശ്നങ്ങളും പരിഹാരങ്ങളും: +പ്രശ്നങ്ങളുണ്ടോ? സാധാരണ പ്രശ്നങ്ങളും പരിഹാരങ്ങളും ഇവിടെ: -- **ടോക്കൺ പ്രവർത്തിക്കുന്നില്ല?** - - നിങ്ങൾ മുഴുവൻ ടോക്കൺ കോപ്പി ചെയ്തിട്ടുണ്ടെന്ന് ഉറപ്പാക്കുക, അധിക സ്പേസുകൾ ഇല്ലാതെ - - ടോക്കൺ ശരിയായി പരിസ്ഥിതി ചാരമായി സജ്ജമാക്കിയിട്ടുണ്ടെന്ന് സ്ഥിരീകരിക്കുക - - നിങ്ങളുടെ ടോക്കണിന് ശരിയായ അനുമതികളുണ്ടെന്ന് (Models: Read and write) പരിശോധിക്കുക +- **ടോക്കൺ പ്രവർത്തിക്കുന്നില്ല എങ്കിൽ?** + - ടോക്കൺ പൂർണ്ണമായി കൂടാതെ വേരിയബിൾ ആയി ശരിയായി ചേർത്തിട്ടുണ്ടോ പരിശോധിക്കുക + - അനുമതികൾ (Models: Read-only) ശരിയാണെന്ന് ഉറപ്പാക്കുക -- **Maven കണ്ടെത്തുന്നില്ല?** - - ഡെവ് കണ്ടെയ്നറുകൾ/Codespaces ഉപയോഗിക്കുന്നുവെങ്കിൽ, Maven മുൻകൂട്ടി ഇൻസ്റ്റാൾ ചെയ്തിരിക്കണം - - പ്രാദേശിക സജ്ജീകരണത്തിനായി, Java 21+യും Maven 3.9+യും ഇൻസ്റ്റാൾ ചെയ്തിട്ടുണ്ടെന്ന് ഉറപ്പാക്കുക - - ഇൻസ്റ്റലേഷൻ സ്ഥിരീകരിക്കാൻ `mvn --version` പരീക്ഷിക്കുക +- **മേവൻ കണ്ടെത്താനായില്ല എന്ന് വരുന്നുണ്ടോ?** + - ഡെവ് കണ്ടെയ്‌നറുകളിലും Codespaces-ൽ മുമ്പേ ഇൻസ്റ്റാൾ ചെയ്തതാണ് + - ലോക്കൽ സെറ്റപ്പിൽ Java 21+ ഉം Maven 3.9+ ഉം ഇൻസ്റ്റാൾ ചെയ്തിട്ടുണ്ടോ നോക്കുക + - `mvn --version` റൺ ചെയ്ത് ഇൻസ്റ്റാളേഷൻ പരിശോധിക്കുക -- **ബന്ധം പ്രശ്നങ്ങൾ?** - - നിങ്ങളുടെ ഇന്റർനെറ്റ് കണക്ഷൻ പരിശോധിക്കുക - - GitHub നിങ്ങളുടെ നെറ്റ്വർക്കിൽ നിന്ന് ആക്സസ് ചെയ്യാൻ കഴിയുന്നുണ്ടെന്ന് ഉറപ്പാക്കുക - - GitHub മോഡലുകളുടെ എൻഡ്പോയിന്റ് ബ്ലോക്ക് ചെയ്യുന്ന ഫയർവാളിന്റെ പിന്നിൽ നിങ്ങൾ ഇല്ലെന്ന് ഉറപ്പാക്കുക +- **കണക്ഷൻ പ്രശ്നമുണ്ടോ?** + - ഇന്റർനെറ്റ് കണക്ഷൻ ശരിയാണോ നോക്കുക + - GitHub നിങ്ങളുടെ നെറ്റ്‌വർക്കിൽ ആക്സസിബിളാണോ പരിശോധിക്കുക + - GitHub Models എന്റ്പോയിന്റ് ബ്ലോക്ക് ചെയ്യുന്ന ഫയർവാൾ ഇല്ലെന്ന് ഉറപ്പാക്കുക -- **ഡെവ് കണ്ടെയ്നർ ആരംഭിക്കുന്നില്ല?** - - Docker Desktop പ്രവർത്തിക്കുന്നുണ്ടെന്ന് ഉറപ്പാക്കുക (പ്രാദേശിക വികസനത്തിനായി) - - കണ്ടെയ്നർ പുനർനിർമ്മിക്കാൻ ശ്രമിക്കുക: `Ctrl+Shift+P` → "Dev Containers: Rebuild Container" +- **ഡെവ് കണ്ടെയ്‌നർ സ്റ്റാർട്ട് ചെയ്യുന്നതിൽ പ്രശ്നമോ?** + - Docker Desktop പ്രവർത്തിക്കുന്നുണ്ടോ കാണണം (ലൊക്കൽ ഡെവലപ്പ്മെന്റിന്) + - കണ്ടെയ്‌നർ വീണ്ടും നിർമിക്കുക: `Ctrl+Shift+P` → "Dev Containers: Rebuild Container" -- **ആപ്ലിക്കേഷൻ കംപൈലേഷൻ പിഴവുകൾ?** - - നിങ്ങൾ ശരിയായ ഡയറക്ടറിയിൽ ഉണ്ടെന്ന് ഉറപ്പാക്കുക: `02-SetupDevEnvironment/examples/github-models` - - ക്ലീൻ ചെയ്ത് പുനർനിർമ്മിക്കാൻ ശ്രമിക്കുക: `mvn clean compile` +- **ആപ്ലിക്കേഷൻ കോംപൈൽ പിശകുകൾ വരുന്നു?** + - ശരിയായ ഡയറക്ടറിയിൽ പ്രവർത്തിക്കുന്നുവെന്ന് ഉറപ്പ് വരുത്തുക: `02-SetupDevEnvironment/examples/github-models` + - `mvn clean compile` പ്രവർത്തിപ്പിച്ച് ക്ലീൻ ആൻഡ് ബിൽഡ് ചെയ്യുക -> **സഹായം ആവശ്യമുണ്ടോ?**: ഇപ്പോഴും പ്രശ്നങ്ങൾ ഉണ്ടോ? റിപോസിറ്ററിയിൽ ഒരു ഇഷ്യൂ തുറക്കുക, ഞങ്ങൾ നിങ്ങളെ സഹായിക്കും. +> **സഹായം വേണമോ?**: പ്രശ്നങ്ങൾ തുടരുന്നുണ്ടെങ്കിൽ ഈ റിപ്പോസിറ്ററിയിൽ ഒരു ഇഷ്യൂ തുറക്കൂ, ഞങ്ങൾ സഹായിക്കും. --- -**അറിയിപ്പ്**: -ഈ രേഖ AI വിവർത്തന സേവനമായ [Co-op Translator](https://github.com/Azure/co-op-translator) ഉപയോഗിച്ച് വിവർത്തനം ചെയ്തതാണ്. ഞങ്ങൾ കൃത്യതയ്ക്കായി ശ്രമിക്കുന്നുവെങ്കിലും, ഓട്ടോമേറ്റഡ് വിവർത്തനങ്ങളിൽ പിഴവുകൾ അല്ലെങ്കിൽ തെറ്റായ വിവരങ്ങൾ ഉണ്ടാകാൻ സാധ്യതയുണ്ട്. അതിന്റെ സ്വഭാവ ഭാഷയിലുള്ള അസൽ രേഖയാണ് പ്രാമാണികമായ ഉറവിടമായി പരിഗണിക്കേണ്ടത്. നിർണായകമായ വിവരങ്ങൾക്ക്, പ്രൊഫഷണൽ മനുഷ്യ വിവർത്തനം ശുപാർശ ചെയ്യുന്നു. ഈ വിവർത്തനം ഉപയോഗിച്ച് ഉണ്ടാകുന്ന തെറ്റിദ്ധാരണകൾ അല്ലെങ്കിൽ തെറ്റായ വ്യാഖ്യാനങ്ങൾക്കായി ഞങ്ങൾ ഉത്തരവാദികളല്ല. +**വിവരണക്കുറിപ്പ്**: +ഈ ദസ്താവേജ് AI വിവർത്തന സേവനമായ [Co-op Translator](https://github.com/Azure/co-op-translator) ഉപയോഗിച്ച് വിവർത്തനം ചെയ്തതാണ്. നാം കൃത്യത നിഷ്ടമായി പരിശ്രമിച്ചുവെങ്കിലും, ഓട്ടോമാറ്റഡ് വിവർത്തനങ്ങളിലെ പിഴവുകൾ അല്ലെങ്കിൽ തെറ്റുകൂടിയ വിവരങ്ങൾ ഉണ്ടായിരിക്കാവുന്നതാണ്. അതിനാൽ, യഥാർത്ഥ ഭാഷയിൽ ഉള്ള അദ്ധ്യായനപ്രമാണം ആയതിനാൽ പൊതുവായ ഉറവിടമായി കണക്കാക്കപ്പെടണം. മുഖ്യമായ വിവരങ്ങൾക്ക്, പ്രൊഫഷണൽ മനുഷ്യവിവർത്തനം ശിപാർശ ചെയ്യപ്പെടുന്നു. ഈ വിവർത്തനത്തെ അടിസ്ഥാനമാക്കി ഉണ്ടാകുന്ന ഏതെങ്കിലും തെറ്റായ അർത്ഥം പിടിപ്പുകൾക്കോ തെറ്റായ വ്യാഖ്യാനങ്ങൾക്കോ ഞങ്ങൾ ബാധ്യത വഹിക്കുന്നില്ല. \ No newline at end of file diff --git a/translations/ml/02-SetupDevEnvironment/examples/basic-chat-azure/README.md b/translations/ml/02-SetupDevEnvironment/examples/basic-chat-azure/README.md index e786d0d2..4b6989ed 100644 --- a/translations/ml/02-SetupDevEnvironment/examples/basic-chat-azure/README.md +++ b/translations/ml/02-SetupDevEnvironment/examples/basic-chat-azure/README.md @@ -1,12 +1,3 @@ - # Azure OpenAI ഉപയോഗിച്ച് അടിസ്ഥാന ചാറ്റ് - എന്റു-ടു-എന്റ് ഉദാഹരണം ഈ ഉദാഹരണം Azure OpenAI-യുമായി ബന്ധിപ്പിക്കുന്ന ഒരു ലളിതമായ Spring Boot ആപ്ലിക്കേഷൻ സൃഷ്ടിക്കുകയും നിങ്ങളുടെ സജ്ജീകരണം പരിശോധിക്കുകയും ചെയ്യുന്നതാണ്. diff --git a/translations/ml/02-SetupDevEnvironment/getting-started-azure-openai.md b/translations/ml/02-SetupDevEnvironment/getting-started-azure-openai.md index 69b8492c..5420de5c 100644 --- a/translations/ml/02-SetupDevEnvironment/getting-started-azure-openai.md +++ b/translations/ml/02-SetupDevEnvironment/getting-started-azure-openai.md @@ -1,12 +1,3 @@ - # Azure OpenAI വികസന പരിസ്ഥിതി സജ്ജമാക്കൽ > **Quick Start**: ഈ ഗൈഡ് Azure OpenAI സജ്ജീകരണത്തിനാണ്. സൗജന്യ മോഡലുകൾ ഉപയോഗിച്ച് ഉടൻ ആരംഭിക്കാൻ, [GitHub Models with Codespaces](./README.md#quick-start-cloud) ഉപയോഗിക്കുക. diff --git a/translations/ml/03-CoreGenerativeAITechniques/README.md b/translations/ml/03-CoreGenerativeAITechniques/README.md index ef93e851..90f9b30a 100644 --- a/translations/ml/03-CoreGenerativeAITechniques/README.md +++ b/translations/ml/03-CoreGenerativeAITechniques/README.md @@ -1,12 +1,3 @@ - # കോർ ജനറേറ്റീവ് AI ടെക്നിക്‌സ് ട്യൂട്ടോറിയൽ ## ഉള്ളടക്ക പട്ടിക diff --git a/translations/ml/04-PracticalSamples/README.md b/translations/ml/04-PracticalSamples/README.md index 25dcebbc..223f8a24 100644 --- a/translations/ml/04-PracticalSamples/README.md +++ b/translations/ml/04-PracticalSamples/README.md @@ -1,12 +1,3 @@ - # പ്രായോഗിക പ്രയോഗങ്ങളും പ്രോജക്റ്റുകളും ## നിങ്ങൾ എന്താണ് പഠിക്കുക diff --git a/translations/ml/04-PracticalSamples/calculator/README.md b/translations/ml/04-PracticalSamples/calculator/README.md index 852fbc0a..72d69717 100644 --- a/translations/ml/04-PracticalSamples/calculator/README.md +++ b/translations/ml/04-PracticalSamples/calculator/README.md @@ -1,12 +1,3 @@ - # MCP കാൽക്കുലേറ്റർ ട്യൂട്ടോറിയൽ ആരംഭക്കാർക്കായി ## ഉള്ളടക്കസൂചിക diff --git a/translations/ml/04-PracticalSamples/foundrylocal/README.md b/translations/ml/04-PracticalSamples/foundrylocal/README.md index 3b1c3947..7799bce1 100644 --- a/translations/ml/04-PracticalSamples/foundrylocal/README.md +++ b/translations/ml/04-PracticalSamples/foundrylocal/README.md @@ -1,12 +1,3 @@ - # Foundry Local Spring Boot ട്യൂട്ടോറിയൽ ## ഉള്ളടക്കം diff --git a/translations/ml/04-PracticalSamples/petstory/README.md b/translations/ml/04-PracticalSamples/petstory/README.md index 8c9e5d34..c6549273 100644 --- a/translations/ml/04-PracticalSamples/petstory/README.md +++ b/translations/ml/04-PracticalSamples/petstory/README.md @@ -1,12 +1,3 @@ - # പെട്ട് സ്റ്റോറി ജനറേറ്റർ ട്യൂട്ടോറിയൽ ആരംഭക്കാർക്കായി ## ഉള്ളടക്കം diff --git a/translations/ml/05-ResponsibleGenAI/README.md b/translations/ml/05-ResponsibleGenAI/README.md index ea77388c..4999e390 100644 --- a/translations/ml/05-ResponsibleGenAI/README.md +++ b/translations/ml/05-ResponsibleGenAI/README.md @@ -1,12 +1,3 @@ - # ഉത്തരവാദിത്വമുള്ള ജനറേറ്റീവ് AI ## നിങ്ങൾ എന്താണ് പഠിക്കുക diff --git a/translations/ml/AGENTS.md b/translations/ml/AGENTS.md index a761530c..031d7f17 100644 --- a/translations/ml/AGENTS.md +++ b/translations/ml/AGENTS.md @@ -1,12 +1,3 @@ - # AGENTS.md ## പ്രോജക്റ്റ് അവലോകനം diff --git a/translations/ml/CODE_OF_CONDUCT.md b/translations/ml/CODE_OF_CONDUCT.md index eea6ce1e..9462b734 100644 --- a/translations/ml/CODE_OF_CONDUCT.md +++ b/translations/ml/CODE_OF_CONDUCT.md @@ -1,12 +1,3 @@ - # മൈക്രോസോഫ്റ്റ് ഓപ്പൺ സോഴ്‌സ് പെരുമാറ്റച്ചട്ടം ഈ പ്രോജക്റ്റ് [മൈക്രോസോഫ്റ്റ് ഓപ്പൺ സോഴ്‌സ് പെരുമാറ്റച്ചട്ടം](https://opensource.microsoft.com/codeofconduct/) സ്വീകരിച്ചിട്ടുണ്ട്. diff --git a/translations/ml/README.md b/translations/ml/README.md index c30d429b..ec3fb394 100644 --- a/translations/ml/README.md +++ b/translations/ml/README.md @@ -1,129 +1,121 @@ - -# ജെനറേറ്റീവ് AI ആരംഭക്കാർക്ക് - ജावा പതിപ്പ് +# തുടക്കക്കാർക്കായുള്ള ജനറേറ്റീവ് എഐ - ജാവ എഡിഷൻ [![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) -![ജെനറേറ്റീവ് AI ആരംഭക്കാർക്ക് - ജावा പതിപ്പ്](../../translated_images/ml/beg-genai-series.8b48be9951cc574c.webp) +![Generative AI for Beginners - Java Edition](../../translated_images/ml/beg-genai-series.8b48be9951cc574c.webp) -**സമയം:** മുഴുവൻ വർക്ക്ഷോപ്പ് ഓൺലൈനിൽ സജ്ജീകരണമില്ലാതെ പൂർത്തിയാക്കാം. പരിസ്ഥിതി സജ്ജീകരണം 2 മിനിറ്റ് വേണ്ടി വരും, സാമ്പിളുകൾ അന്വേഷിക്കാനുള്ള സമയം 1-3 മണിക്കൂർ വരെ കൂടുതല്‍ ആഴത്തിൽ നോക്കുന്നതിന് അനുസരിച്ചായി. +**സമയം സമർപ്പണം**: ലോക്കൽ സെറ്റപ്പ് ഇല്ലാതെ മുഴുവൻ വർക്‌ഷോപ്പ് ഓൺലൈനിൽ കഴിയാവുന്നതാണ്. എൻവയോൺമെന്റ് സെറ്റപ്പ് നേടാൻ 2 മിനിട്ടും സാമ്പിളുകൾ പരിശോധിക്കാൻ 1-3 മണിക്കൂറുമാണ് ആഴ കുറിച്ചറിയുന്നതിന് ആവശ്യമായ സമയം. -> **വേഗത്തിലുള്ള തുടക്കം** +> **വേഗം ആരംഭിക്കുക** -1. ഈ റിപ്പോസിറ്ററി നിങ്ങളുടെ GitHub അക്കൗണ്ടിലേക്ക് ഫോർക്കുചെയ്യുക +1. ഈ റെപ്പോസിറ്ററി നിങ്ങളുടെ GitHub അക്കൗണ്ടിലേക്ക് ഫോർക്ക് ചെയ്യുക 2. **Code** → **Codespaces** ടാബ് → **...** → **New with options...** ക്ലിക്ക് ചെയ്യുക -3. ഡിഫോൾട്ടുകൾ ഉപയോഗിക്കുക – ഇത് ഈ കോഴ്‌സിനായി സൃഷ്ടിച്ച ഡെവലപ്പ്മെന്റ് കണ്ടെയ്നറാണ് തിരഞ്ഞെടുക്കുക +3. ഡിഫോൾട്ടുകൾ ഉപയോഗിക്കുക – ഇതിലൂടെ ഈ കോഴ്സിന് രൂപകല്പന ചെയ്ത ഡെവലപ്പ്മെന്റ് കൺടെയ്‌നർ തിരഞ്ഞെടുക്കും 4. **Create codespace** ക്ലിക്ക് ചെയ്യുക -5. പരിസ്ഥിതി സജ്ജമാകാൻ ~2 മിനിറ്റ് കാത്തിരിക്കുക -6. നേരിട്ട് [മുതൽ ഉദാഹരണം](./02-SetupDevEnvironment/README.md#step-2-create-a-github-personal-access-token) കാണുക +5. എൻവയോൺമെന്റ് സജ്ജമാകാൻ ഏകദേശം 2 മിനിറ്റ് കാത്തിരിക്കുക +6. നേരിട്ട് ചാടുക [ആദ്യ ഉദാഹരണത്തിലേക്ക്](./02-SetupDevEnvironment/README.md#step-2-create-a-github-personal-access-token) -> **പ്രാദേശികമായി ക്ലോൺ ചെയ്യാൻ ആഗ്രഹിക്കുന്നുണ്ടോ?** +> **ലോക്കലായി ക്ലോൺ ചെയ്യാൻ താത്പര്യമുണ്ടോ?** > -> ഈ റിപ്പോസിറ്ററിയിൽ 50+ ഭാഷാ പരിഭാഷകൾ ഉൾപ്പെടുന്നു, ഇത് ഡൗൺലോഡ് വലുതാക്കും. പരിഭാഷകൾ ഇല്ലാതെ ക്ലോൺ ചെയ്യാൻ sparse checkout ഉപയോഗിക്കുക: +> ഈ റെപ്പോസിറ്ററിയിൽ 50 ലധികം ഭാഷാ പരിഭാഷകൾ ഉൾക്കൊള്ളുന്നു, ഇത് ഡൗൺലോഡ് വലുപ്പം വൻമാക്കുന്നു. പരിഭാഷകൾ ഇല്ലാതെ ക്ലോൺ ചെയ്യാൻ sparse checkout ഉപയോഗിക്കുക: > ```bash > git clone --filter=blob:none --sparse https://github.com/microsoft/Generative-AI-for-beginners-java.git > cd Generative-AI-for-beginners-java > git sparse-checkout set --no-cone '/*' '!translations' '!translated_images' > ``` -> ഇതോടെ കോഴ്സ് പൂർത്തിയാക്കാൻ വേണ്ടതെല്ലാം വളരെ വേഗത്തിൽ ലഭിക്കും. +> ഇതിലൂടെ കോഴ്സ് പൂർത്തിയാക്കാൻ ആവശ്യമായ എല്ലാ സാമഗ്രികളും വളരെ വേഗത്തിൽ ലഭിക്കും. -## ബഹुभാഷാ പിന്തുണ +## ബഹുഭാഷാ പിന്തുണ -### GitHub ആക്ഷൻ വഴി പിന്തുണ (സ്വയം പ്രവർത്തനക്ഷമവും എപ്പൊഴും അപ്പ്‌ടുഡേറ്റും) +### GitHub ആക്ഷൻ മുഖേന പിന്തുണ (സ്വയംപ്രവർത്തകരായും ചെറുതായി അപ്‌ഡേറ്റായും) -[അറബി](../ar/README.md) | [ബംഗാളി](../bn/README.md) | [ബൾഗേറിയൻ](../bg/README.md) | [ബർമീസ് (മ്യാൻമാർ)](../my/README.md) | [ചൈനീസ് (ലഘുകൃതം)](../zh/README.md) | [ചൈനീസ് (പരമ്പരാഗതം, ഹോങ്കോംഗ്)](../hk/README.md) | [ചൈനീസ് (പരമ്പരാഗതം, മക്കാവ്)](../mo/README.md) | [ചൈനീസ് (പരമ്പരാഗതം, തായ്‌വാൻ)](../tw/README.md) | [ക്രൊയേഷ്യൻ](../hr/README.md) | [ചെക്ക്](../cs/README.md) | [ഡാനിഷ്](../da/README.md) | [ഡച്ച്](../nl/README.md) | [എസ്റ്റോണിയൻ](../et/README.md) | [ഫിന്നിഷ്](../fi/README.md) | [ഫ്രഞ്ച്](../fr/README.md) | [ജർമ്മൻ](../de/README.md) | [ഗ്രീക്ക്](../el/README.md) | [ഹീബ്രു](../he/README.md) | [ഹിന്ദി](../hi/README.md) | [ഹംഗേറിയൻ](../hu/README.md) | [ഇന്തോനേഷ്യൻ](../id/README.md) | [ഇറ്റാലിയൻ](../it/README.md) | [ജാപ്പനീസ്](../ja/README.md) | [കന്നഡ](../kn/README.md) | [കൊറിയൻ](../ko/README.md) | [ലിതൗനിയൻ](../lt/README.md) | [മലായ്](../ms/README.md) | [മലയാളം](./README.md) | [മറാത്തി](../mr/README.md) | [നെപ്പാളി](../ne/README.md) | [നൈജീരിയൻ പിഡ്‌ജിൻ](../pcm/README.md) | [നോർവീജിയൻ](../no/README.md) | [പേർഷ്യൻ (ഫാർസി)](../fa/README.md) | [പോളിഷ്](../pl/README.md) | [പോർചുഗീസ് (ബ്രസീൽ)](../br/README.md) | [പോർചുഗീസ് (പോർച്ചുഗൽ)](../pt/README.md) | [പഞ്ചാബി (ഗുരുമുഖി)](../pa/README.md) | [റൊമാനിയൻ](../ro/README.md) | [റഷ്യൻ](../ru/README.md) | [സെർബിയൻ (സിറിലിക്)](../sr/README.md) | [സ്ലോവാക്](../sk/README.md) | [സ്ലോവേനിയൻ](../sl/README.md) | [സ്‌പാനിഷ്](../es/README.md) | [സ്വാഹിലി](../sw/README.md) | [സ്വീഡിഷ്](../sv/README.md) | [ടാഗാലോഗ് (ഫിലിപ്പീൻ)](../tl/README.md) | [തമിഴ്](../ta/README.md) | [तेलुगു](../te/README.md) | [തായ്](../th/README.md) | [ടർക്കിഷ്](../tr/README.md) | [ഉക്രൈനിൻ](../uk/README.md) | [ഉർദു](../ur/README.md) | [വിയറ്റ്നാമീസ്](../vi/README.md) +[അറബി](../ar/README.md) | [ബംഗാളി](../bn/README.md) | [ബൾഗേറിയൻ](../bg/README.md) | [ബർമീസ് (മയാൻമാർ)](../my/README.md) | [ചൈനീസ് (സിംപ്ലിഫൈഡ്)](../zh-CN/README.md) | [ചൈനീസ് (രെഗുലർ, ഹോങ്കോങ്ക്)](../zh-HK/README.md) | [ചൈനീസ് (രെഗുലർ, മാക്കാവു)](../zh-MO/README.md) | [ചൈനീസ് (രെഗുലർ, തായ്‌വാൻ)](../zh-TW/README.md) | [ക്രൊയേഷ്യൻ](../hr/README.md) | [ചെക്ക്](../cs/README.md) | [ഡാനിഷ്](../da/README.md) | [ഡച്ച്](../nl/README.md) | [എസ്റ്റോണിയൻ](../et/README.md) | [ഫിന്നിഷ്](../fi/README.md) | [ഫ്രഞ്ച്](../fr/README.md) | [ജർമ്മൻ](../de/README.md) | [ഗ്രീക്ക്](../el/README.md) | [ഹീബ്രു](../he/README.md) | [ഹിന്ദി](../hi/README.md) | [ഹംഗേറിയൻ](../hu/README.md) | [ഇന്തോനേഷ്യൻ](../id/README.md) | [ഇറ്റാലിയൻ](../it/README.md) | [ജാപ്പനീസ്](../ja/README.md) | [കന്നഡ](../kn/README.md) | [കൊറിയൻ](../ko/README.md) | [ലിത്വേനിയൻ](../lt/README.md) | [മലയ്‌](../ms/README.md) | [മലയാളം](./README.md) | [മറാത്തി](../mr/README.md) | [നേപ്പാൾ](../ne/README.md) | [നൈജീരിയൻ പിബ്ജിൻ](../pcm/README.md) | [നോർവീജിയൻ](../no/README.md) | [പെർഷ്യൻ (ഫാർസി)](../fa/README.md) | [പോളിഷ്](../pl/README.md) | [പോർച്ചുഗീസ് (ബ്രസീൽ)](../pt-BR/README.md) | [പോർച്ചുഗീസ് (പോർച്ചുഗൽ)](../pt-PT/README.md) | [പാൻജാബി (ഗുരുമുഖി)](../pa/README.md) | [റൊമാനിയൻ](../ro/README.md) | [റഷ്യൻ](../ru/README.md) | [സെർബിയൻ (സിറിലിക്ഗ്രാഫി)](../sr/README.md) | [സ്ലൊവാക്](../sk/README.md) | [സ്ലോവേനിയൻ](../sl/README.md) | [സ്പാനിഷ്](../es/README.md) | [സ്വാഹിലി](../sw/README.md) | [സ്വീഡിഷ്](../sv/README.md) | [തഗാലോഗ് (ഫിലിപ്പീനോ)](../tl/README.md) | [തമിഴ്](../ta/README.md) | [തെലുങ്ക്](../te/README.md) | [തായ്](../th/README.md) | [തുർക്കി](../tr/README.md) | [ഉക്രേനിയൻ](../uk/README.md) | [ഉർදු](../ur/README.md) | [വിയറ്റ്നാമീസ്](../vi/README.md) -> **പ്രാദേശികമായി ക്ലോൺ ചെയ്യാൻ ആഗ്രഹിക്കുന്നുണ്ടോ?** +> **ലോക്കലായി ക്ലോൺ ചെയ്യാൻ താത്പര്യമുണ്ടോ?** -> ഈ റിപ്പോസിറ്ററിയിൽ 50+ ഭാഷാ പരിഭാഷകൾ ഉൾപ്പെടുന്നു, ഇത് ഡൗൺലോഡ് വലുതാക്കും. പരിഭാഷകൾ ഇല്ലാതെ ക്ലോൺ ചെയ്യാൻ sparse checkout ഉപയോഗിക്കുക: +> ഈ റെപ്പോസിറ്ററിയിൽ 50 ലധികം ഭാഷാ പരിഭാഷകൾ ഉൾക്കൊള്ളുന്നു, ഇത് ഡൗൺലോഡ് വലുപ്പം വൻമാക്കുന്നു. പരിഭാഷകൾ ഇല്ലാതെ ക്ലോൺ ചെയ്യാൻ sparse checkout ഉപയോഗിക്കുക: > ```bash > git clone --filter=blob:none --sparse https://github.com/microsoft/Generative-AI-for-beginners-java.git > cd Generative-AI-for-beginners-java > git sparse-checkout set --no-cone '/*' '!translations' '!translated_images' > ``` -> ഇതോടെ കോഴ്സ് പൂർത്തിയാക്കാൻ വേണ്ടതെല്ലാം വളരെ വേഗത്തിൽ ലഭിക്കും. +> ഇതിലൂടെ കോഴ്സ് പൂർത്തിയാക്കാൻ ആവശ്യമായ എല്ലാ സാമഗ്രികളും വളരെ വേഗത്തിൽ ലഭിക്കും. -## കോഴ്‌സ് ഘടനയും പഠനപാതയും - -### **അദ്ധ്യായം 1: ജെനറേറ്റീവ് AI-യുടെ പരിചയം** -- **കോർ ധാരണകൾ**: വലിയ ഭാഷ മോഡലുകൾ, ടോക്കണുകൾ, എംബെഡിംഗുകൾ, AI കഴിവുകൾ മനസിലാക്കൽ -- **ജാവ AI പരിസ്ഥിതി**: Spring AI-യും OpenAI SDK-കളും അവലോകനം -- **മോഡൽ കോൺറ്റെക്സ് പ്രോട്ടോക്കോൾ**: MCP-യുടെ പരിചയം, AI ഏജന്റുകളുടെ ബന്ധപ്പെട്ട ആവിശ്യ -- **പ്രായോഗിക ഉപയോഗങ്ങൾ**: ചാറ്റ്ബോട്ടുകൾ, ഉള്ളടക്കം സൃഷ്ടിക്കൽ തുടങ്ങിയ യഥാർത്ഥ ലോക സാഹചര്യങ്ങൾ -- **[→ അദ്ധ്യായം 1 ആരംഭിക്കുക](./01-IntroToGenAI/README.md)** - -### **അദ്ധ്യായം 2: ഡെവലപ്പ്മെന്റ് പരിസ്ഥിതി സജ്ജീകരണം** -- **ബഹുസ്ഥാപക കോൺഫിഗറേഷൻ**: GitHub മോഡലുകൾ, Azure OpenAI, OpenAI ജावा SDK ഇന്റഗ്രേഷൻ സജ്ജീകരിക്കുക -- **Spring Boot + Spring AI**: എന്റർപ്രൈസ് AI അപ്ലിക്കേഷൻ വികസനത്തിനായുള്ള മികച്ച രീതികൾ -- **GitHub മോഡലുകൾ**: പ്രോട്ടോടെപിംഗ്, പഠനത്തിനായി സൗജന്യ AI മോഡൽ ആക്‌സസ് (ക്രെഡിറ്റ് കാർഡ് ആവശ്യമില്ല) -- **ഡെവലപ്പ്മെന്റ് ടൂളുകൾ**: Docker കണ്ടെയ്നറുകൾ, VS Code, GitHub Codespaces കോൺഫിഗറേഷൻ -- **[→ അദ്ധ്യായം 2 ആരംഭിക്കുക](./02-SetupDevEnvironment/README.md)** - -### **അദ്ധ്യായം 3: പ്രധാന ജെനറേറ്റീവ് AI സാങ്കേതിക വിദ്യകൾ** -- **പ്രോമ്പ്റ്റ് എഞ്ചിനീയറിംഗ്**: AI മോഡലുകളെ മികച്ച മറുപടി നൽകാൻ സാങ്കേതിക വിദ്യകൾ -- **എംബെഡിംഗുകളും വെക്ടർ പ്രവർത്തനങ്ങളും**: സെമാന്റിക് തിരയലും സാമ്യമുള്ള പൊരുത്തം കണ്ടെത്തലും നടപ്പാക്കുക -- **റിട്രീവൽ-ഓഗ്മെന്റഡ് ജനറേഷൻ (RAG)**: നിങ്ങളുടെ സ്വന്തം വിവര സംഭരണികളുമായി AI സംയോജിപ്പിക്കുക -- **ഫങ്ക്ഷൻ കോളിംഗ്**: കസ്റ്റം ടൂളുകളുമായി AI കഴിവുകൾ വർദ്ധിപ്പിക്കുക -- **[→ അദ്ധ്യായം 3 ആരംഭിക്കുക](./03-CoreGenerativeAITechniques/README.md)** - -### **അദ്ധ്യായം 4: പ്രായോഗിക ഉപയോഗങ്ങളും പ്രോജക്ടുകളും** -- **പെറ്റ് സ്റ്റോറി ജനറേറ്റർ** (`petstory/`): GitHub മോഡലുകളുമായി സൃഷ്ടിമാന ഉള്ളടക്കം -- **ഫൗണ്ട്രി ലോക്കൽ ഡെമോ** (`foundrylocal/`): OpenAI ജावा SDK ഉപയോഗിച്ച് പ്രാദേശിക AI മോഡൽ സംയോജനം -- **MCP കാൽക്കുലേറ്റർ സർവീസ്** (`calculator/`): Spring AI ഉപയോഗിച്ച് അടിസ്ഥാന മോഡൽ കോൺറ്റെക്സ് പ്രോട്ടോക്കോൾ നടപ്പാക്കൽ -- **[→ അദ്ധ്യായം 4 ആരംഭിക്കുക](./04-PracticalSamples/README.md)** - -### **അദ്ധ്യായം 5: ഉത്തരവാദിത്വമുള്ള AI വികസനം** -- **GitHub മോഡലുകളുടെ സുരക്ഷ**: കോണ്ടന്റ് ഫിൽട്ടറിംഗ്, ഹാർഡ് ബ്ലോക്കുകളും സോഫ്റ്റ് നിരാകരണങ്ങളും പരീക്ഷിക്കുക -- **ഉത്തരവാദിത്വമുള്ള AI ഡെമോ**: ആധുനിക AI സുരക്ഷാ സംവിധാനങ്ങൾ പ്രായോഗികമായി കാണിക്കുന്ന ഹാൻഡ്‌സ്-ഓൺ ഉദാഹരണം -- **മികച്ച പ്രാക്ടീസുകൾ**: നയപരമായ AI വികസനത്തിനും വിനിയോഗത്തിനും ആവശ്യമായ മാർഗ്ഗനിർദ്ദേശങ്ങൾ -- **[→ അദ്ധ്യായം 5 ആരംഭിക്കുക](./05-ResponsibleGenAI/README.md)** - -## അധിക വിവരസ്രോതസ്സുകൾ +## കോഴ്‌സ് ഘടനയും പഠന മാർഗ്ഗവും + +### **അധ്യായം 1: ജനറേറ്റീവ് എഐക്ക് പ്രവേശനം** +- **പ്രധാന ആശയങ്ങൾ**: വലിയ ഭാഷാ മോഡലുകൾ, ടോക്കൺസ്, എംബെഡിംഗ്സ്, എഐ ശേഷികൾ മനസ്സിലാക്കൽ +- **ജാവ എഐ വ്യവസ്ഥ**: സ്പ്രിംഗ് എഐയും ഓപ്പൺഎഐ SDKകളും അവലോകനം +- **മോഡൽ കോൺടെക്സ്റ്റ് പ്രോട്ടോക്കോൾ**: MCP പരിചയം, എഐ ഏജൻസിന്റെ ആശയവിനിമയത്തിലെ പങ്ക് +- **പ്രായോഗിക പ്രയോഗങ്ങൾ**: ചാറ്റ്ബോറ്റുകളും ഉള്ളടക്ക സൃഷ്ടികളും ഉൾപ്പെടുന്ന യഥാർത്ഥ സാന്ദർഭങ്ങൾ +- **[→ അധ്യായം 1 ആരംഭിക്കുക](./01-IntroToGenAI/README.md)** + +### **അധ്യായം 2: വികസന പരിസരസജ്ജീകരണം** +- **ബഹുമൂല്യദായക കൺഫിഗറേഷൻ**: GitHub മോഡലുകൾ, ആസ്യൂർ ഓപ്പൺഎഐ, ഓപ്പൺഎഐ ജാവ SDK സംയോജനം +- **സ്പ്രിംഗ് ബൂട്ട് + സ്പ്രിംഗ് എഐ**: എൻറപ്രൈസ് എഐ ആപ്ലിക്കേഷൻ വികസനത്തിന് മികച്ച രീതികൾ +- **GitHub മോഡലുകൾ**: പ്രോട്ടോട്ടൈപ്പിംഗിനും പഠനത്തിനും സൗജന്യ എഐ മോഡലുകൾ (ക്രെഡിറ്റ് കാർഡ് വേണ്ട) +- **വികസന ഉപകരണങ്ങൾ**: ഡോക്കർ കൺടെയ്‌നറുകൾ, VS കോഡ്, GitHub കോഡ്സ്പേസുകൾ സജ്ജീകരണം +- **[→ അധ്യായം 2 ആരംഭിക്കുക](./02-SetupDevEnvironment/README.md)** + +### **അധ്യായം 3: കോർ ജനറേറ്റീവ് എഐ സാങ്കേതിക വിദ്യകൾ** +- **പ്രോംപ്‌റ്റ് എഞ്ചിനിയറിങ്**: എഐ മോഡലുകളുടെ മികച്ച പ്രതികരണങ്ങളും നടപടികളും +- **എംബെഡിംഗ്സ് & വെക്ടർ ഓപ്പറേഷനുകൾ**: സെമാന്റിക് തേടൽ, സാമ്യം കണ്ടെത്തൽ നടപ്പിലാക്കൽ +- **റിട്രീവൽ-ഓഗ്മെന്റഡ് ജനറേഷൻ (RAG)**: നിങ്ങളുടെ താൻറിയുമായി എഐ സംയോജനം +- **ഫംഗ്ഷൻ കോല്ലിംഗ്**: കസ്റ്റം ഉപകരണങ്ങളോടും പ്ലഗിൻസോടും എഐ ശേഷി വർദ്ധിപ്പിക്കൽ +- **[→ അധ്യായം 3 ആരംഭിക്കുക](./03-CoreGenerativeAITechniques/README.md)** + +### **അധ്യായം 4: പ്രായോഗിക പ്രയോഗങ്ങളും പ്രോജക്റ്റുകളും** +- **പെറ്റ് സ്റ്റോറി ജനറേറ്റർ** (`petstory/`): GitHub മോഡലുകൾ ഉപയോഗിച്ചുള്ള സൃഷ്ടിപരമായ ഉള്ളടക്ക സൃഷ്ടി +- **ഫൗണ്ട്രി ലോക്കൽ ഡെമോ** (`foundrylocal/`): ഓപ്പൺഎഐ ജാവ SDK ഉപയോഗിച്ച് ലോക്കൽ എഐ മോഡൽ സംയോജനം +- **MCP കാൽക്കുലേറ്റർ സേവനം** (`calculator/`): സ്പ്രിംഗ് എഐ ഉപയോഗിച്ച് അടിസ്ഥാന മോഡൽ കോൺടെക്സ്റ്റ് പ്രോട്ടോക്കോൾ നടപ്പാക്കൽ +- **[→ അധ്യായം 4 ആരംഭിക്കുക](./04-PracticalSamples/README.md)** + +### **അധ്യായം 5: ഉത്തരവാദിത്വമുള്ള എഐ വികസനം** +- **GitHub മോഡലുകളുടെ സുരക്ഷ**: ഇൻ-ബിൽറ്റ് ഉള്ളടക്ക ഫിൽട്ടറിംഗ്, സുരക്ഷാ സംവിധാനം (കഠിന നിരോധനങ്ങൾ, മൃദുവായ നിരസനങ്ങൾ) പരീക്ഷിച്ചു കാണുക +- **ഉത്തരവാദിത്വമുള്ള എഐ ഡെമോ**: ആധുനിക എഐ സുരക്ഷാ സംവിധാനങ്ങൾ എങ്ങനെ പ്രവർത്തിക്കുന്നു എന്നതിന്റെ പ്രായോഗിക ഉദാഹരണം +- **മികച്ച രീതികൾ**: എഥിക്കൽ എഐ വികസനത്തിനും വിന്യാസത്തിനും ആവശ്യമായ നിർദ്ദേശങ്ങൾ +- **[→ അധ്യായം 5 ആരംഭിക്കുക](./05-ResponsibleGenAI/README.md)** + +## അധിക ഉപാധികൾ -### LangChain -[![മുതിർന്നവർക്കുള്ള LangChain4j](https://img.shields.io/badge/LangChain4j%20for%20Beginners-22C55E?style=for-the-badge&&labelColor=E5E7EB&color=0553D6)](https://aka.ms/langchain4j-for-beginners) -[![മുതിർന്നവർക്കുള്ള LangChain.js](https://img.shields.io/badge/LangChain.js%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=0553D6)](https://aka.ms/langchainjs-for-beginners?WT.mc_id=m365-94501-dwahlin) +### ലാംഗ്‌ചെയിൻ +[![LangChain4j for Beginners](https://img.shields.io/badge/LangChain4j%20for%20Beginners-22C55E?style=for-the-badge&&labelColor=E5E7EB&color=0553D6)](https://aka.ms/langchain4j-for-beginners) +[![LangChain.js for Beginners](https://img.shields.io/badge/LangChain.js%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=0553D6)](https://aka.ms/langchainjs-for-beginners?WT.mc_id=m365-94501-dwahlin) --- -### Azure / Edge / MCP / ഏജന്റുകൾ -[![മുതിർന്നവർക്കുള്ള AZD](https://img.shields.io/badge/AZD%20for%20Beginners-0078D4?style=for-the-badge&labelColor=E5E7EB&color=0078D4)](https://github.com/microsoft/AZD-for-beginners?WT.mc_id=academic-105485-koreyst) -[![മുതിർന്നവർക്കുള്ള Edge AI](https://img.shields.io/badge/Edge%20AI%20for%20Beginners-00B8E4?style=for-the-badge&labelColor=E5E7EB&color=00B8E4)](https://github.com/microsoft/edgeai-for-beginners?WT.mc_id=academic-105485-koreyst) -[![മുതിർന്നവർക്കുള്ള MCP](https://img.shields.io/badge/MCP%20for%20Beginners-009688?style=for-the-badge&labelColor=E5E7EB&color=009688)](https://github.com/microsoft/mcp-for-beginners?WT.mc_id=academic-105485-koreyst) -[![മുതിർന്നവർക്കുള്ള AI ഏജന്റുകൾ](https://img.shields.io/badge/AI%20Agents%20for%20Beginners-00C49A?style=for-the-badge&labelColor=E5E7EB&color=00C49A)](https://github.com/microsoft/ai-agents-for-beginners?WT.mc_id=academic-105485-koreyst) +### ആസ്യൂർ / എഡ്ജ് / MCP / ഏജൻറുകൾ +[![AZD for Beginners](https://img.shields.io/badge/AZD%20for%20Beginners-0078D4?style=for-the-badge&labelColor=E5E7EB&color=0078D4)](https://github.com/microsoft/AZD-for-beginners?WT.mc_id=academic-105485-koreyst) +[![Edge AI for Beginners](https://img.shields.io/badge/Edge%20AI%20for%20Beginners-00B8E4?style=for-the-badge&labelColor=E5E7EB&color=00B8E4)](https://github.com/microsoft/edgeai-for-beginners?WT.mc_id=academic-105485-koreyst) +[![MCP for Beginners](https://img.shields.io/badge/MCP%20for%20Beginners-009688?style=for-the-badge&labelColor=E5E7EB&color=009688)](https://github.com/microsoft/mcp-for-beginners?WT.mc_id=academic-105485-koreyst) +[![AI Agents for Beginners](https://img.shields.io/badge/AI%20Agents%20for%20Beginners-00C49A?style=for-the-badge&labelColor=E5E7EB&color=00C49A)](https://github.com/microsoft/ai-agents-for-beginners?WT.mc_id=academic-105485-koreyst) --- -### ജെനറേറ്റീവ് AI സീരീസ് -[![ജെനറേറ്റീവ് AI ആരംഭക്കാർക്ക്](https://img.shields.io/badge/Generative%20AI%20for%20Beginners-8B5CF6?style=for-the-badge&labelColor=E5E7EB&color=8B5CF6)](https://github.com/microsoft/generative-ai-for-beginners?WT.mc_id=academic-105485-koreyst) -[![ജെനറേറ്റീവ് AI (.NET)](https://img.shields.io/badge/Generative%20AI%20(.NET)-9333EA?style=for-the-badge&labelColor=E5E7EB&color=9333EA)](https://github.com/microsoft/Generative-AI-for-beginners-dotnet?WT.mc_id=academic-105485-koreyst) -[![ജെനറേറ്റീവ് AI (ജാവ)](https://img.shields.io/badge/Generative%20AI%20(Java)-C084FC?style=for-the-badge&labelColor=E5E7EB&color=C084FC)](https://github.com/microsoft/generative-ai-for-beginners-java?WT.mc_id=academic-105485-koreyst) -[![ജെനറേറ്റീവ് AI (ജാവസ്‌ക്രിപ്റ്റ്)](https://img.shields.io/badge/Generative%20AI%20(JavaScript)-E879F9?style=for-the-badge&labelColor=E5E7EB&color=E879F9)](https://github.com/microsoft/generative-ai-with-javascript?WT.mc_id=academic-105485-koreyst) +### ജനറേറ്റീവ് എഐ സീരീസ് +[![Generative AI for Beginners](https://img.shields.io/badge/Generative%20AI%20for%20Beginners-8B5CF6?style=for-the-badge&labelColor=E5E7EB&color=8B5CF6)](https://github.com/microsoft/generative-ai-for-beginners?WT.mc_id=academic-105485-koreyst) +[![Generative AI (.NET)](https://img.shields.io/badge/Generative%20AI%20(.NET)-9333EA?style=for-the-badge&labelColor=E5E7EB&color=9333EA)](https://github.com/microsoft/Generative-AI-for-beginners-dotnet?WT.mc_id=academic-105485-koreyst) +[![Generative AI (Java)](https://img.shields.io/badge/Generative%20AI%20(Java)-C084FC?style=for-the-badge&labelColor=E5E7EB&color=C084FC)](https://github.com/microsoft/generative-ai-for-beginners-java?WT.mc_id=academic-105485-koreyst) +[![Generative AI (JavaScript)](https://img.shields.io/badge/Generative%20AI%20(JavaScript)-E879F9?style=for-the-badge&labelColor=E5E7EB&color=E879F9)](https://github.com/microsoft/generative-ai-with-javascript?WT.mc_id=academic-105485-koreyst) --- -### കോർ പഠനം -[![മുതിർന്നവർക്കുള്ള ML](https://img.shields.io/badge/ML%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=22C55E)](https://aka.ms/ml-beginners?WT.mc_id=academic-105485-koreyst) -[![മുതിർന്നവർക്കുള്ള ഡാറ്റാ സയൻസ്](https://img.shields.io/badge/Data%20Science%20for%20Beginners-84CC16?style=for-the-badge&labelColor=E5E7EB&color=84CC16)](https://aka.ms/datascience-beginners?WT.mc_id=academic-105485-koreyst) -[![മുതിർന്നവർക്കുള്ള AI](https://img.shields.io/badge/AI%20for%20Beginners-A3E635?style=for-the-badge&labelColor=E5E7EB&color=A3E635)](https://aka.ms/ai-beginners?WT.mc_id=academic-105485-koreyst) -[![മുതിർന്നവർക്കുള്ള സൈബർസെക്യൂരിറ്റി](https://img.shields.io/badge/Cybersecurity%20for%20Beginners-F97316?style=for-the-badge&labelColor=E5E7EB&color=F97316)](https://github.com/microsoft/Security-101?WT.mc_id=academic-96948-sayoung) -[![മുതിർന്നവർക്കുള്ള വെബ് ഡെവ്](https://img.shields.io/badge/Web%20Dev%20for%20Beginners-EC4899?style=for-the-badge&labelColor=E5E7EB&color=EC4899)](https://aka.ms/webdev-beginners?WT.mc_id=academic-105485-koreyst) +### പ്രാഥമിക പഠനം +[![ML for Beginners](https://img.shields.io/badge/ML%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=22C55E)](https://aka.ms/ml-beginners?WT.mc_id=academic-105485-koreyst) +[![Data Science for Beginners](https://img.shields.io/badge/Data%20Science%20for%20Beginners-84CC16?style=for-the-badge&labelColor=E5E7EB&color=84CC16)](https://aka.ms/datascience-beginners?WT.mc_id=academic-105485-koreyst) +[![AI for Beginners](https://img.shields.io/badge/AI%20for%20Beginners-A3E635?style=for-the-badge&labelColor=E5E7EB&color=A3E635)](https://aka.ms/ai-beginners?WT.mc_id=academic-105485-koreyst) +[![Cybersecurity for Beginners](https://img.shields.io/badge/Cybersecurity%20for%20Beginners-F97316?style=for-the-badge&labelColor=E5E7EB&color=F97316)](https://github.com/microsoft/Security-101?WT.mc_id=academic-96948-sayoung) + +[![Web Dev for Beginners](https://img.shields.io/badge/Web%20Dev%20for%20Beginners-EC4899?style=for-the-badge&labelColor=E5E7EB&color=EC4899)](https://aka.ms/webdev-beginners?WT.mc_id=academic-105485-koreyst) [![IoT for Beginners](https://img.shields.io/badge/IoT%20for%20Beginners-14B8A6?style=for-the-badge&labelColor=E5E7EB&color=14B8A6)](https://aka.ms/iot-beginners?WT.mc_id=academic-105485-koreyst) [![XR Development for Beginners](https://img.shields.io/badge/XR%20Development%20for%20Beginners-38BDF8?style=for-the-badge&labelColor=E5E7EB&color=38BDF8)](https://github.com/microsoft/xr-development-for-beginners?WT.mc_id=academic-105485-koreyst) --- -### കോപിലട്ട് ശ്രേണി +### കോപൈലറ്റ് പരമ്പര [![Copilot for AI Paired Programming](https://img.shields.io/badge/Copilot%20for%20AI%20Paired%20Programming-FACC15?style=for-the-badge&labelColor=E5E7EB&color=FACC15)](https://aka.ms/GitHubCopilotAI?WT.mc_id=academic-105485-koreyst) [![Copilot for C#/.NET](https://img.shields.io/badge/Copilot%20for%20C%23/.NET-FBBF24?style=for-the-badge&labelColor=E5E7EB&color=FBBF24)](https://github.com/microsoft/mastering-github-copilot-for-dotnet-csharp-developers?WT.mc_id=academic-105485-koreyst) [![Copilot Adventure](https://img.shields.io/badge/Copilot%20Adventure-FDE68A?style=for-the-badge&labelColor=E5E7EB&color=FDE68A)](https://github.com/microsoft/CopilotAdventures?WT.mc_id=academic-105485-koreyst) @@ -131,17 +123,17 @@ CO_OP_TRANSLATOR_METADATA: ## സഹായം നേടൽ -നിങ്ങൾ കുടുങ്ങിയാൽ അല്ലെങ്കിൽ AI ആപ്ലിക്കേഷനുകൾ നിർമ്മിക്കുന്നതിനെപ്പറ്റി ഏതൊന്നെങ്കിലും ചോദ്യങ്ങൾ ഉണ്ടെങ്കിൽ. MCP-യെക്കുറിച്ച് fellow learners-ഉം പരിചയസമ്പന്നരായ ഡെവലപ്പർമാരും ചേർന്നുള്ള ചർച്ചകളിൽ പങ്കെടുക്കുക. ഇത് ചോദ്യങ്ങൾ സ്വാഗതം ചെയ്യപ്പെടുന്ന ഒരു പിന്തുണയുള്ള സമുദായമാണ്, അവിടെ അറിവ് സ്വതന്ത്രമായി തരുൽപ്പെടുന്നു. +എന്റെ AI ആപ്ലിക്കേഷനുകൾ നിർമ്മിക്കുന്നതിന് പാടുപെടുകയാണെങ്കിൽ അല്ലെങ്കിൽ എന്തെങ്കിലും ചോദ്യങ്ങളുണ്ടെങ്കിൽ. MCP-യെക്കുറിച്ച് fellow learners and experienced developers-ഉടൻ ചർച്ചകളിൽ പങ്കെടുക്കുക. ചോദ്യങ്ങൾക്ക് സ്വാഗതം നൽകുന്ന കൂടാതെ അറിവ് സ്വതന്ത്രമായി പങ്കിടുന്ന ഒരു സഹായകമായ സമൂഹമാണ് അത്. [![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) -നിങ്ങൾക്ക് ഉൽപ്പന്ന ഫീഡ്ബാക്ക് അല്ലെങ്കിൽ പിഴവുകൾ ഉണ്ടെങ്കിൽ നിർമ്മിക്കുന്ന സമയത്ത് സന്ദർശിക്കുക: +നിങ്ങൾക്ക് ഉൽപ്പന്ന നടപടിക്രമങ്ങളിൽ ഫീഡ്‌ബാക്ക് അല്ലെങ്കിൽ പിഴവുകൾ ഉണ്ടെങ്കിൽ സന്ദർശിക്കുക: [![Microsoft Foundry Developer Forum](https://img.shields.io/badge/GitHub-Microsoft_Foundry_Developer_Forum-blue?style=for-the-badge&logo=github&color=000000&logoColor=fff)](https://aka.ms/foundry/forum) --- -**ഡിസ്ക്ലെയിമർ**: -ഈ രേഖ AI വിവർത്തന సేవയായ [Co-op Translator](https://github.com/Azure/co-op-translator) ഉപയോഗിച്ച് വിവർത്തനം ചെയ്തതാണ്. ഞങ്ങൾ ശരിയായ വിവർത്തനത്തിനായി പരിശ്രമിക്കുന്നിട്ടും, സ്വയമേറ്റം വിവർത്തനങ്ങളിൽ പിഴവുകൾ അല്ലെങ്കിൽ അപൂർവതകൾ ഉണ്ടായേക്കാമെന്ന് ദയവായി ശ്രദ്ധിക്കണം. അടിസ്ഥാനഭാഷയിലുള്ള സാഹചര്യം പരിഗണിച്ച് ആ യഥാർത്ഥ രേഖയാണ് പ്രമുഖമായ സ്രോതസം. महत्वपूर्णവും സാരമാണാത്ത വിവരങ്ങൾക്കായി പ്രൊഫഷണൽ മനുഷ്യവിവർത്തനം ശിപാർശ ചെയ്യപ്പെടുന്നു. ഈ വിവർത്തനം ഉപയോഗിച്ചതിൽ നിന്നുണ്ടാകുന്ന എന്തെങ്കിലും അർത്ഥവ്യത്യാസങ്ങളോ തെറ്റിദ്ധാരണങ്ങളോ സംബന്ധിച്ചുള്ള ബാധ്യത ഞങ്ങൾ ഏറ്റെടുക്കുന്നില്ല. +**അസ്പഷ്ടതാ കുറിപ്പ്**: +ഈ ലേഖനം AI വിവർത്തന സേവനം [Co-op Translator](https://github.com/Azure/co-op-translator) ഉപയോഗിച്ച് വിവർത്തനം ചെയ്തതാണ്. നാം കൃത്യതിക്കറ്റ് ശ്രമിച്ചെങ്കിലും, യന്ത്ര വിവർത്തനങ്ങളിൽ പിശകുകളോ അസംബന്ധതകളോ ഉണ്ടാകാനുള്ള സാധ്യതയുണ്ട് എന്ന 점 ദയവായി ശ്രദ്ധിക്കുക. പ്രമാണത്തിന്റെ യഥാർത്ഥ ഭാഷയിലെ പതിപ്പ് സാക്ഷ്യസ്ഥതയുള്ള ഉറവിടമായി പരിഗണിക്കണം. നിർണായകമായ വിവരങ്ങൾക്ക്, പ്രൊഫഷണൽ മനുഷ്യ വിവർത്തനം നിർദ്ദേശിക്കുന്നു. ഈ വിവർത്തനം ഉപയോഗിച്ചതിനെത്തുടർന്ന് ഉണ്ടാകാവുന്ന തെറ്റിദ്ധാരണകൾക്കോ തെറ്റായ വ്യാഖ്യാനങ്ങൾക്കോ ഞങ്ങൾ ഉത്തരവാദിത്വം ഉണ്ടാക്കുന്നില്ല. \ No newline at end of file diff --git a/translations/ml/SECURITY.md b/translations/ml/SECURITY.md index f99c973b..22d30571 100644 --- a/translations/ml/SECURITY.md +++ b/translations/ml/SECURITY.md @@ -1,12 +1,3 @@ - ## സുരക്ഷ diff --git a/translations/ml/SUPPORT.md b/translations/ml/SUPPORT.md index 3fd7bb4a..9fd0f413 100644 --- a/translations/ml/SUPPORT.md +++ b/translations/ml/SUPPORT.md @@ -1,12 +1,3 @@ - # പിന്തുണ ## പ്രശ്നങ്ങൾ റിപ്പോർട്ട് ചെയ്യാനും സഹായം നേടാനും എങ്ങനെ diff --git a/translations/mo/02-SetupDevEnvironment/README.md b/translations/mo/02-SetupDevEnvironment/README.md deleted file mode 100644 index 748a67b1..00000000 --- a/translations/mo/02-SetupDevEnvironment/README.md +++ /dev/null @@ -1,13 +0,0 @@ - - - ---- - diff --git a/translations/mo/README.md b/translations/mo/README.md deleted file mode 100644 index 8b495f80..00000000 --- a/translations/mo/README.md +++ /dev/null @@ -1,147 +0,0 @@ - -# 入門生成式 AI - Java 版本 -[![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) - -![入門生成式 AI - Java 版本](../../translated_images/mo/beg-genai-series.8b48be9951cc574c.webp) - -**所需時間**：整個工作坊可線上完成，無需本地設置。環境設置約需 2 分鐘，探索範例所需時間為 1-3 小時，視探索深度而定。 - -> **快速開始** - -1. 將本存儲庫複製到你的 GitHub 帳戶 -2. 點擊 **Code** → **Codespaces** 標籤 → **...** → **New with options...** -3. 使用預設值 — 這會選擇為本課程建立的開發容器 -4. 點擊 **Create codespace** -5. 等候約 2 分鐘，直至環境準備好 -6. 直接跳轉至 [第一個範例](./02-SetupDevEnvironment/README.md#step-2-create-a-github-personal-access-token) - -> **喜歡本地 Clone？** -> -> 本存儲庫包含 50 多種語言翻譯，會大幅增加下載大小。如想不包含翻譯進行 Clone，請使用稀疏簽出： -> ```bash -> git clone --filter=blob:none --sparse https://github.com/microsoft/Generative-AI-for-beginners-java.git -> cd Generative-AI-for-beginners-java -> git sparse-checkout set --no-cone '/*' '!translations' '!translated_images' -> ``` -> 這樣可以讓你以更快速度下載，且擁有完成課程所需的一切內容。 - - -## 多語言支援 - -### 透過 GitHub Action 支援（自動且常保更新） - - -[阿拉伯語](../ar/README.md) | [孟加拉語](../bn/README.md) | [保加利亞語](../bg/README.md) | [緬甸語 (Myanmar)](../my/README.md) | [中文 (簡體)](../zh/README.md) | [中文 (繁體，香港)](../hk/README.md) | [中文 (繁體，澳門)](./README.md) | [中文 (繁體，台灣)](../tw/README.md) | [克羅地亞語](../hr/README.md) | [捷克語](../cs/README.md) | [丹麥語](../da/README.md) | [荷蘭語](../nl/README.md) | [愛沙尼亞語](../et/README.md) | [芬蘭語](../fi/README.md) | [法語](../fr/README.md) | [德語](../de/README.md) | [希臘語](../el/README.md) | [希伯來語](../he/README.md) | [印地語](../hi/README.md) | [匈牙利語](../hu/README.md) | [印尼語](../id/README.md) | [義大利語](../it/README.md) | [日語](../ja/README.md) | [坎納達語](../kn/README.md) | [韓語](../ko/README.md) | [立陶宛語](../lt/README.md) | [馬來語](../ms/README.md) | [馬拉雅拉姆語](../ml/README.md) | [馬拉地語](../mr/README.md) | [尼泊爾語](../ne/README.md) | [尼日利亞皮欽語](../pcm/README.md) | [挪威語](../no/README.md) | [波斯語 (Farsi)](../fa/README.md) | [波蘭語](../pl/README.md) | [葡萄牙語 (巴西)](../br/README.md) | [葡萄牙語 (葡萄牙)](../pt/README.md) | [旁遮普語 (Gurmukhi)](../pa/README.md) | [羅馬尼亞語](../ro/README.md) | [俄羅斯語](../ru/README.md) | [塞爾維亞語 (西里爾字母)](../sr/README.md) | [斯洛伐克語](../sk/README.md) | [斯洛文尼亞語](../sl/README.md) | [西班牙語](../es/README.md) | [斯瓦希里語](../sw/README.md) | [瑞典語](../sv/README.md) | [塔加洛語 (菲律賓語)](../tl/README.md) | [泰米爾語](../ta/README.md) | [泰盧固語](../te/README.md) | [泰語](../th/README.md) | [土耳其語](../tr/README.md) | [烏克蘭語](../uk/README.md) | [烏爾都語](../ur/README.md) | [越南語](../vi/README.md) - -> **喜歡本地 Clone？** - -> 本存儲庫包含 50 多種語言翻譯，會大幅增加下載大小。如想不包含翻譯進行 Clone，請使用稀疏簽出： -> ```bash -> git clone --filter=blob:none --sparse https://github.com/microsoft/Generative-AI-for-beginners-java.git -> cd Generative-AI-for-beginners-java -> git sparse-checkout set --no-cone '/*' '!translations' '!translated_images' -> ``` -> 這樣可以讓你以更快速度下載，且擁有完成課程所需的一切內容。 - - -## 課程結構與學習路徑 - -### **第一章：生成式 AI 簡介** -- **核心概念**：理解大型語言模型、標記、嵌入向量及 AI 能力 -- **Java AI 生態系統**：Spring AI 與 OpenAI SDK 概述 -- **模型上下文協議**：介紹 MCP 及其於 AI 代理之通訊中的角色 -- **實務應用**：真實場景包含聊天機器人與內容生成 -- **[→ 開始第一章](./01-IntroToGenAI/README.md)** - -### **第二章：開發環境設置** -- **多供應商配置**：設定 GitHub Models、Azure OpenAI 及 OpenAI Java SDK 整合 -- **Spring Boot + Spring AI**：企業 AI 應用程式開發的最佳實踐 -- **GitHub Models**：免費 AI 模型存取，用於原型設計與學習（無需信用卡） -- **開發工具**：Docker 容器、VS Code 與 GitHub Codespaces 配置 -- **[→ 開始第二章](./02-SetupDevEnvironment/README.md)** - -### **第三章：生成式 AI 核心技術** -- **提示工程**：取得最佳 AI 模型回應的技巧 -- **嵌入與向量操作**：實作語義搜尋與相似度比對 -- **檢索增強生成 (RAG)**：結合 AI 與自有資料來源 -- **函數呼叫**：使用自訂工具與插件擴展 AI 功能 -- **[→ 開始第三章](./03-CoreGenerativeAITechniques/README.md)** - -### **第四章：實務應用與專案** -- **寵物故事生成器** (`petstory/`)：利用 GitHub Models 進行創意內容生成 -- **Foundry 本地示範** (`foundrylocal/`)：使用 OpenAI Java SDK 本地 AI 模型整合 -- **MCP 計算器服務** (`calculator/`)：以 Spring AI 實作基本模型上下文協議 -- **[→ 開始第四章](./04-PracticalSamples/README.md)** - -### **第五章：負責任的 AI 開發** -- **GitHub Models 安全性**：測試內建內容過濾與安全機制（嚴格封鎖與軟性拒絕） -- **負責任 AI 示範**：實作範例展現現代 AI 安全系統實務運作 -- **最佳實務**：倫理 AI 開發及部署的必備指南 -- **[→ 開始第五章](./05-ResponsibleGenAI/README.md)** - -## 額外資源 - - -### LangChain -[![LangChain4j 入門](https://img.shields.io/badge/LangChain4j%20for%20Beginners-22C55E?style=for-the-badge&&labelColor=E5E7EB&color=0553D6)](https://aka.ms/langchain4j-for-beginners) -[![LangChain.js 入門](https://img.shields.io/badge/LangChain.js%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=0553D6)](https://aka.ms/langchainjs-for-beginners?WT.mc_id=m365-94501-dwahlin) - ---- - -### Azure / Edge / MCP / Agents -[![AZD 入門](https://img.shields.io/badge/AZD%20for%20Beginners-0078D4?style=for-the-badge&labelColor=E5E7EB&color=0078D4)](https://github.com/microsoft/AZD-for-beginners?WT.mc_id=academic-105485-koreyst) -[![Edge AI 入門](https://img.shields.io/badge/Edge%20AI%20for%20Beginners-00B8E4?style=for-the-badge&labelColor=E5E7EB&color=00B8E4)](https://github.com/microsoft/edgeai-for-beginners?WT.mc_id=academic-105485-koreyst) -[![MCP 入門](https://img.shields.io/badge/MCP%20for%20Beginners-009688?style=for-the-badge&labelColor=E5E7EB&color=009688)](https://github.com/microsoft/mcp-for-beginners?WT.mc_id=academic-105485-koreyst) -[![AI Agents 入門](https://img.shields.io/badge/AI%20Agents%20for%20Beginners-00C49A?style=for-the-badge&labelColor=E5E7EB&color=00C49A)](https://github.com/microsoft/ai-agents-for-beginners?WT.mc_id=academic-105485-koreyst) - ---- - -### 生成式 AI 系列 -[![入門生成式 AI](https://img.shields.io/badge/Generative%20AI%20for%20Beginners-8B5CF6?style=for-the-badge&labelColor=E5E7EB&color=8B5CF6)](https://github.com/microsoft/generative-ai-for-beginners?WT.mc_id=academic-105485-koreyst) -[![生成式 AI (.NET)](https://img.shields.io/badge/Generative%20AI%20(.NET)-9333EA?style=for-the-badge&labelColor=E5E7EB&color=9333EA)](https://github.com/microsoft/Generative-AI-for-beginners-dotnet?WT.mc_id=academic-105485-koreyst) -[![生成式 AI (Java)](https://img.shields.io/badge/Generative%20AI%20(Java)-C084FC?style=for-the-badge&labelColor=E5E7EB&color=C084FC)](https://github.com/microsoft/generative-ai-for-beginners-java?WT.mc_id=academic-105485-koreyst) -[![生成式 AI (JavaScript)](https://img.shields.io/badge/Generative%20AI%20(JavaScript)-E879F9?style=for-the-badge&labelColor=E5E7EB&color=E879F9)](https://github.com/microsoft/generative-ai-with-javascript?WT.mc_id=academic-105485-koreyst) - ---- - -### 核心學習 -[![機器學習入門](https://img.shields.io/badge/ML%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=22C55E)](https://aka.ms/ml-beginners?WT.mc_id=academic-105485-koreyst) -[![數據科學入門](https://img.shields.io/badge/Data%20Science%20for%20Beginners-84CC16?style=for-the-badge&labelColor=E5E7EB&color=84CC16)](https://aka.ms/datascience-beginners?WT.mc_id=academic-105485-koreyst) -[![AI 入門](https://img.shields.io/badge/AI%20for%20Beginners-A3E635?style=for-the-badge&labelColor=E5E7EB&color=A3E635)](https://aka.ms/ai-beginners?WT.mc_id=academic-105485-koreyst) -[![資安入門](https://img.shields.io/badge/Cybersecurity%20for%20Beginners-F97316?style=for-the-badge&labelColor=E5E7EB&color=F97316)](https://github.com/microsoft/Security-101?WT.mc_id=academic-96948-sayoung) -[![網頁開發入門](https://img.shields.io/badge/Web%20Dev%20for%20Beginners-EC4899?style=for-the-badge&labelColor=E5E7EB&color=EC4899)](https://aka.ms/webdev-beginners?WT.mc_id=academic-105485-koreyst) -[![IoT for Beginners](https://img.shields.io/badge/IoT%20for%20Beginners-14B8A6?style=for-the-badge&labelColor=E5E7EB&color=14B8A6)](https://aka.ms/iot-beginners?WT.mc_id=academic-105485-koreyst) -[![XR Development for Beginners](https://img.shields.io/badge/XR%20Development%20for%20Beginners-38BDF8?style=for-the-badge&labelColor=E5E7EB&color=38BDF8)](https://github.com/microsoft/xr-development-for-beginners?WT.mc_id=academic-105485-koreyst) - ---- - -### Copilot 系列 -[![Copilot for AI Paired Programming](https://img.shields.io/badge/Copilot%20for%20AI%20Paired%20Programming-FACC15?style=for-the-badge&labelColor=E5E7EB&color=FACC15)](https://aka.ms/GitHubCopilotAI?WT.mc_id=academic-105485-koreyst) -[![Copilot for C#/.NET](https://img.shields.io/badge/Copilot%20for%20C%23/.NET-FBBF24?style=for-the-badge&labelColor=E5E7EB&color=FBBF24)](https://github.com/microsoft/mastering-github-copilot-for-dotnet-csharp-developers?WT.mc_id=academic-105485-koreyst) -[![Copilot Adventure](https://img.shields.io/badge/Copilot%20Adventure-FDE68A?style=for-the-badge&labelColor=E5E7EB&color=FDE68A)](https://github.com/microsoft/CopilotAdventures?WT.mc_id=academic-105485-koreyst) - - -## 獲取支援 - -如果你遇到困難或在建立 AI 應用程式時有任何疑問，歡迎加入其他學習者及經驗豐富的開發者討論 MCP。這是一個支持性的社群，歡迎提問並自由分享知識。 - -[![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) - -如果你有產品回饋或在開發過程中遇到錯誤，請造訪： - -[![Microsoft Foundry Developer Forum](https://img.shields.io/badge/GitHub-Microsoft_Foundry_Developer_Forum-blue?style=for-the-badge&logo=github&color=000000&logoColor=fff)](https://aka.ms/foundry/forum) - ---- - - -**免責聲明**： -本文件乃使用人工智能翻譯服務 [Co-op Translator](https://github.com/Azure/co-op-translator) 進行翻譯。儘管我們致力於確保翻譯準確無誤，請注意自動翻譯或會存在錯誤或不準確之處。原文文件的母語版本應視為權威來源。對於重要資訊，建議尋求專業人工翻譯。我們對因使用本翻譯而產生的任何誤解或曲解概不負責。 - \ No newline at end of file diff --git a/translations/mr/.co-op-translator.json b/translations/mr/.co-op-translator.json new file mode 100644 index 00000000..83fb75c4 --- /dev/null +++ b/translations/mr/.co-op-translator.json @@ -0,0 +1,92 @@ +{ + "01-IntroToGenAI/README.md": { + "original_hash": "75bfb080ca725e8a9aa9c80cae25fba1", + "translation_date": "2025-07-29T08:47:39+00:00", + "source_file": "01-IntroToGenAI/README.md", + "language_code": "mr" + }, + "02-SetupDevEnvironment/README.md": { + "original_hash": "96a30d42b9751a3d4e4b20e28d29d459", + "translation_date": "2026-01-28T04:50:41+00:00", + "source_file": "02-SetupDevEnvironment/README.md", + "language_code": "mr" + }, + "02-SetupDevEnvironment/examples/basic-chat-azure/README.md": { + "original_hash": "efd82efe50711d7e257eb943151d682c", + "translation_date": "2025-07-27T13:38:09+00:00", + "source_file": "02-SetupDevEnvironment/examples/basic-chat-azure/README.md", + "language_code": "mr" + }, + "02-SetupDevEnvironment/getting-started-azure-openai.md": { + "original_hash": "bfdb4b4eadbee3a59ef742439f58326a", + "translation_date": "2025-07-27T13:02:10+00:00", + "source_file": "02-SetupDevEnvironment/getting-started-azure-openai.md", + "language_code": "mr" + }, + "03-CoreGenerativeAITechniques/README.md": { + "original_hash": "685f55cb07de19b52a30ce6e8b6d889e", + "translation_date": "2025-08-28T22:01:28+00:00", + "source_file": "03-CoreGenerativeAITechniques/README.md", + "language_code": "mr" + }, + "04-PracticalSamples/README.md": { + "original_hash": "14c0a61ecc1cd2012a9c129236dfdf71", + "translation_date": "2025-07-29T08:46:31+00:00", + "source_file": "04-PracticalSamples/README.md", + "language_code": "mr" + }, + "04-PracticalSamples/calculator/README.md": { + "original_hash": "b6c16b5514d524e415a94f6097ee7d4c", + "translation_date": "2025-09-18T15:28:51+00:00", + "source_file": "04-PracticalSamples/calculator/README.md", + "language_code": "mr" + }, + "04-PracticalSamples/foundrylocal/README.md": { + "original_hash": "f787307400de59adc25a1404466a35f3", + "translation_date": "2025-11-04T07:20:14+00:00", + "source_file": "04-PracticalSamples/foundrylocal/README.md", + "language_code": "mr" + }, + "04-PracticalSamples/petstory/README.md": { + "original_hash": "0cbf68d605615a1e602c832a24616859", + "translation_date": "2025-07-25T11:08:09+00:00", + "source_file": "04-PracticalSamples/petstory/README.md", + "language_code": "mr" + }, + "05-ResponsibleGenAI/README.md": { + "original_hash": "301c05c2f57e60a6950b8c665b8bdbba", + "translation_date": "2025-07-29T15:46:37+00:00", + "source_file": "05-ResponsibleGenAI/README.md", + "language_code": "mr" + }, + "AGENTS.md": { + "original_hash": "afc90918d008cf77fd1982691f681306", + "translation_date": "2025-10-03T08:32:49+00:00", + "source_file": "AGENTS.md", + "language_code": "mr" + }, + "CODE_OF_CONDUCT.md": { + "original_hash": "442b123d034f92f7c384d2bbd28f99f1", + "translation_date": "2025-07-21T17:36:46+00:00", + "source_file": "CODE_OF_CONDUCT.md", + "language_code": "mr" + }, + "README.md": { + "original_hash": "125a08948d881c95628094f4dd1fbd43", + "translation_date": "2026-01-29T15:35:51+00:00", + "source_file": "README.md", + "language_code": "mr" + }, + "SECURITY.md": { + "original_hash": "57f14126c1c6add76b3aef3844dfe4e3", + "translation_date": "2025-07-21T17:35:01+00:00", + "source_file": "SECURITY.md", + "language_code": "mr" + }, + "SUPPORT.md": { + "original_hash": "b8ef73cc49dec68e2c885ee9df545129", + "translation_date": "2025-07-21T17:37:50+00:00", + "source_file": "SUPPORT.md", + "language_code": "mr" + } +} \ No newline at end of file diff --git a/translations/mr/01-IntroToGenAI/README.md b/translations/mr/01-IntroToGenAI/README.md index 1c25ffe9..12cd3786 100644 --- a/translations/mr/01-IntroToGenAI/README.md +++ b/translations/mr/01-IntroToGenAI/README.md @@ -1,12 +1,3 @@ - # जनरेटिव AI - जावा संस्करणाची ओळख ## तुम्ही काय शिकाल diff --git a/translations/mr/02-SetupDevEnvironment/README.md b/translations/mr/02-SetupDevEnvironment/README.md index ddeaef12..bb172f0e 100644 --- a/translations/mr/02-SetupDevEnvironment/README.md +++ b/translations/mr/02-SetupDevEnvironment/README.md @@ -1,13 +1,252 @@ - +# Java साठी जनरेटिव्ह AI साठी विकास वातावरण सेट करणे +> **जलद प्रारंभ**: 2 मिनिटांत क्लाउडमध्ये कोड करा - [GitHub Codespaces सेटअप](../../../02-SetupDevEnvironment) येथे जा - कुठलीही लोकल इंस्टॉलेशन आवश्यक नाही आणि GitHub मॉडेल्स वापरतो! + +> **Azure OpenAI मध्ये रस आहे?**, आमचा [Azure OpenAI सेटअप मार्गदर्शक](getting-started-azure-openai.md) पहा ज्यात नवीन Azure OpenAI संसाधन तयार करण्याच्या टप्प्यांचा समावेश आहे. + +## आपण काय शिकाल + +- AI अनुप्रयोगांसाठी Java विकास वातावरण सेट करणे +- आपले प्राधान्यक्रमानुसार विकास वातावरण निवडणे आणि कॉन्फिगर करणे (Codespaces सह क्लाउड-प्रथम, लोकल डेव कंटेनर, किंवा पूर्ण लोकल सेटअप) +- GitHub मॉडेल्सशी कनेक्ट होऊन आपल्या सेटअपची चाचणी करणे + +## अनुक्रमणिका + +- [आपण काय शिकाल](../../../02-SetupDevEnvironment) +- [परिचय](../../../02-SetupDevEnvironment) +- [टप्पा 1: आपले विकास वातावरण सेट करा](../../../02-SetupDevEnvironment) + - [पर्याय A: GitHub Codespaces (शिफारस)](../../../02-SetupDevEnvironment) + - [पर्याय B: लोकल डेव कंटेनर](../../../02-SetupDevEnvironment) + - [पर्याय C: आपल्या विद्यमान लोकल इंस्टॉलेशनचा वापर करा](../../../02-SetupDevEnvironment) +- [टप्पा 2: GitHub वैयक्तिक प्रवेश टोकन तयार करा](../../../02-SetupDevEnvironment) +- [टप्पा 3: GitHub मॉडेल्स उदाहरणाने आपल्या सेटअपची चाचणी करा](../../../02-SetupDevEnvironment) +- [समस्या निवारण](../../../02-SetupDevEnvironment) +- [सारांश](../../../02-SetupDevEnvironment) +- [पुढील टप्पे](../../../02-SetupDevEnvironment) + +## परिचय + +हा अध्याय तुम्हाला विकास वातावरण सेट करण्यास मार्गदर्शन करील. आपण **GitHub मॉडेल्स** आपला मुख्य उदाहरण म्हणून वापरणार आहोत कारण ते मुक्त आहे, फक्त GitHub खात्यासह सहज सेट करता येते, क्रेडिट कार्ड आवश्यक नाही आणि प्रयोगासाठी अनेक मॉडेल्सवर प्रवेश देते. + +**कोणतेही लोकल सेटअप आवश्यक नाही!** आपण GitHub Codespaces वापरून आपल्या ब्राउझरमध्ये पूर्ण विकास वातावरणात त्वरित कोडिंग सुरू करू शकता. + +स्क्रीनशॉट: GitHub मॉडेल्स + +आम्ही या कोर्ससाठी [**GitHub मॉडेल्स**](https://github.com/marketplace?type=models) वापरण्याचा सल्ला देतो कारण ते: +- प्रारंभ करण्यासाठी **मुक्त** +- फक्त GitHub खात्यासह **सुलभ** सेटअप +- **क्रेडिट कार्ड आवश्यक नाही** +- **एकाधिक मॉडेल्स** प्रयोगासाठी उपलब्ध + +> **टीप**: या प्रशिक्षणात वापरल्या जाणार्‍या GitHub मॉडेल्ससाठी खालील मोफत मर्यादा आहेत: +> - प्रति मिनिट 15 विनंत्या (दररोज 150) +> - एका विनंतीत साधारणपणे 8,000 शब्द इन आणि 4,000 शब्द आउट +> - 5 समांतर विनंत्या +> +> व्यावसायिक वापरासाठी, आपल्या Azure खात्याने Azure AI Foundry मॉडेल्समध्ये अपग्रेड करा. आपला कोड बदलण्याची गरज नाही. पाहा [Azure AI Foundry दस्तऐवज](https://learn.microsoft.com/azure/ai-foundry/foundry-models/how-to/quickstart-github-models). + +## टप्पा 1: आपले विकास वातावरण सेट करा + + + +आम्ही या Generative AI for Java कोर्ससाठी आवश्यक साधने आणि सेटअप वेळ कमी करण्यासाठी एक पूर्व-कॉन्फिगर केलेला विकास कंटेनर तयार केला आहे. आपला प्राधान्यक्रम निवडा: + +### वातावरण सेटअप पर्याय: + +#### पर्याय A: GitHub Codespaces (शिफारस) + +**2 मिनिटांत कोडिंग सुरू करा - कोणताही लोकल सेटअप आवश्यक नाही!** + +1. हा रेपॉझिटरी आपल्या GitHub खात्यावर Fork करा + > **टीप**: मूलभूत कॉन्फिग संपादित करायची असल्यास कृपया [Dev Container Configuration](../../../.devcontainer/devcontainer.json) पहा +2. क्लिक करा **Code** → **Codespaces** टॅब → **...** → **New with options...** +3. डीफॉल्ट्स वापरा – यामुळे निवडले जाईल **Dev container configuration**: या कोर्ससाठी तयार केलेले **Generative AI Java Development Environment** कस्टम devcontainer +4. क्लिक करा **Create codespace** +5. साधारण 2 मिनिटे प्रतीक्षा करा जेव्हा पर्यावरण तयार होईल +6. पुढे जा [टप्पा 2: GitHub टोकन तयार करा](../../../02-SetupDevEnvironment) + +स्क्रीनशॉट: Codespaces सबमेन्यू + +स्क्रीनशॉट: New with options + +स्क्रीनशॉट: Create codespace पर्याय + +> **Codespaces चे फायदे**: +> - कोणतीही लोकल इंस्टॉलेशन आवश्यक नाही +> - कोणीही ब्राउझर असलेल्या कोणत्याही डिव्हाइसवर चालते +> - सर्व साधने आणि अवलंबनांसह पूर्व-कॉन्फिगर केलेले +> - वैयक्तिक खात्यांसाठी दरमहा 60 मोफत तास +> - सर्व विद्यार्थ्यांसाठी सुसंगत वातावरण + +#### पर्याय B: लोकल डेव कंटेनर + +**डॉकरे वापरून लोकल विकास प्राधान्य देणाऱ्या विकसकांसाठी** + +1. हा रेपॉझिटरी Fork करा आणि क्लोन करा आपल्या लोकल मशीनवर + > **टीप**: मूलभूत कॉन्फिग संपादित करायची असल्यास कृपया [Dev Container Configuration](../../../.devcontainer/devcontainer.json) पहा +2. [Docker Desktop](https://www.docker.com/products/docker-desktop/) आणि [VS Code](https://code.visualstudio.com/) इंस्टॉल करा +3. VS Code मध्ये [Dev Containers विस्तार](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers) इंस्टॉल करा +4. VS Code मध्ये रेपॉझिटरी फोल्डर उघडा +5. जेव्हा सूचना येईल, तेव्हा क्लिक करा **Reopen in Container** (किंवा `Ctrl+Shift+P` → "Dev Containers: Reopen in Container" वापरा) +6. कंटेनर तयार होईपर्यंत आणि सुरू होईपर्यंत प्रतीक्षा करा +7. पुढे जा [टप्पा 2: GitHub टोकन तयार करा](../../../02-SetupDevEnvironment) + +स्क्रीनशॉट: डेव कंटेनर सेटअप + +स्क्रीनशॉट: डेव कंटेनर बिल्ड पूर्ण + +#### पर्याय C: आपल्या विद्यमान लोकल इंस्टॉलेशनचा वापर करा + +**विद्यमान Java वातावरण असलेल्या विकसकांसाठी** + +पूर्वापेक्षा: +- [Java 21+](https://www.oracle.com/java/technologies/javase/jdk21-archive-downloads.html) +- [Maven 3.9+](https://maven.apache.org/download.cgi) +- [VS Code](https://code.visualstudio.com) किंवा आपला प्राधान्यक्रम असलेले IDE + +टप्पे: +1. हा रेपॉझिटरी आपल्या लोकल मशीनवर क्लोन करा +2. प्रकल्प आपल्या IDE मध्ये उघडा +3. पुढे जा [टप्पा 2: GitHub टोकन तयार करा](../../../02-SetupDevEnvironment) + +> **प्रो टिप**: तुमच्याकडे कमी कॉन्फिगरेशन असलेली मशीन आहे पण लोकल VS Code हवे आहे? GitHub Codespaces वापरा! तुम्ही तुमच्या लोकल VS Code ला क्लाउड-होस्टेड Codespace शी कनेक्ट करू शकता, दोन्ही जगांच्या सर्वोत्तमांचा वापर करून. + +स्क्रीनशॉट: तयार केलेल्या लोकल डेव कंटेनर इन्स्टन्स + +## टप्पा 2: GitHub वैयक्तिक प्रवेश टोकन तयार करा + +1. [GitHub सेटिंग्ज](https://github.com/settings/profile) वर जा आणि आपल्या प्रोफाइल मेन्यूमधून **Settings** निवडा. +2. डाव्या साइडबारमध्ये, क्लिक करा **Developer settings** (साधारणतः खालील बाजूला). +3. **Personal access tokens** अंतर्गत, क्लिक करा **Fine-grained tokens** (किंवा थेट हा [दुवा](https://github.com/settings/personal-access-tokens) वापरा). +4. क्लिक करा **Generate new token**. +5. "Token name" अंतर्गत, एक वर्णनात्मक नाव द्या (उदा. `GenAI-Java-Course-Token`). +6. एक कालावधी सेट करा (शिफारस: सुरक्षा चांगल्या साठी 7 दिवस). +7. "Resource owner" अंतर्गत, आपले वापरकर्ता खाते निवडा. +8. "Repository access" अंतर्गत, GitHub मॉडेल्ससाठी वापरल्या जाणार्‍या रेपॉझिटरीज निवडा (किंवा "सर्व रेपॉझिटरीज" आवश्यक असल्यास). +9. "Account permissions" मध्ये **Models** शोधा आणि ते **Read-only** सेट करा. +10. क्लिक करा **Generate token**. +11. **आपला टोकन आता कॉपी करा आणि सुरक्षित ठिकाणी जतन करा** – आपण पुन्हा ते पाहू शकणार नाही! + +> **सुरक्षा टिप**: आपल्या प्रवेश टोकन्ससाठी आवश्यक त्या किमान अधिकारांचा आणि शक्य तितक्या कमी कालावधीचा वापर करा. + +## टप्पा 3: GitHub मॉडेल्स उदाहरणाने आपल्या सेटअपची चाचणी करा + +एकदा आपले विकास वातावरण तयार झाले की, चला GitHub मॉडेल्सच्या एक उदाहरण अनुप्रयोगाद्वारे एकत्रीकरण तपासू या [`02-SetupDevEnvironment/examples/github-models`](../../../02-SetupDevEnvironment/examples/github-models) मध्ये. + +1. आपल्या विकास वातावरणात टर्मिनल उघडा. +2. GitHub मॉडेल्स उदाहरणाकडे जा: + ```bash + cd 02-SetupDevEnvironment/examples/github-models + ``` +3. आपला GitHub टोकन पर्यावरण चल म्हणून सेट करा: + ```bash + # macOS/Linux + export GITHUB_TOKEN=your_token_here + + # Windows (कमांड प्रॉम्प्ट) + set GITHUB_TOKEN=your_token_here + + # Windows (पॉवरशेल) + $env:GITHUB_TOKEN="your_token_here" + ``` + +4. अनुप्रयोग चालवा: + ```bash + mvn compile exec:java -Dexec.mainClass="com.example.githubmodels.App" + ``` + +आपल्याला खालीलप्रमाणे आउटपुट दिसले पाहिजे: +```text +Using model: gpt-4.1-nano +Sending request to GitHub Models... +Response: Hello World! +``` + +### उदाहरण कोड समजून घेणे + +प्रथम, आपण काय चालवले ते समजूया. `examples/github-models` अंतर्गत उदाहरण OpenAI Java SDK वापरून GitHub मॉडेल्सशी कनेक्ट करते: + +**हा कोड काय करतो:** +- आपला वैयक्तिक प्रवेश टोकन वापरून GitHub मॉडेल्सशी **कनेक्ट** करतो +- AI मॉडेलला "Say Hello World!" असा साधा संदेश **पाठवतो** +- AI चा प्रतिसाद **प्राप्त** करतो आणि प्रदर्शित करतो +- आपला सेटअप योग्यरित्या कार्यरत आहे का ते **चाचणी** करतो + +**महत्वाचा अवलंब (pom.xml मध्ये):** +```xml + + com.openai + openai-java + 2.12.0 + +``` + +**मुख्य कोड** (`App.java`): +```java +// OpenAI Java SDK वापरून GitHub मॉडेल्सशी कनेक्ट करा +OpenAIClient client = OpenAIOkHttpClient.builder() + .apiKey(pat) + .baseUrl("https://models.inference.ai.azure.com") + .build(); + +// चॅट पूर्णत्व विनंती तयार करा +ChatCompletionCreateParams params = ChatCompletionCreateParams.builder() + .model(modelId) + .addSystemMessage("You are a concise assistant.") + .addUserMessage("Say Hello World!") + .build(); + +// AI प्रतिसाद मिळवा +ChatCompletion response = client.chat().completions().create(params); +System.out.println("Response: " + response.choices().get(0).message().content().orElse("No response content")); +``` + + +## सारांश + +छान! आता आपल्याकडे सर्व काही सेट आहे: + +- AI मॉडेल्ससाठी योग्य परवानग्यांसह GitHub वैयक्तिक प्रवेश टोकन तयार केले +- आपले Java विकास वातावरण चालू केले (Codespaces, डेव कंटेनर्स किंवा लोकल) +- OpenAI Java SDK वापरून GitHub मॉडेल्सशी कनेक्ट केले मुक्त AI विकासासाठी +- AI मॉडेल्सशी बोलणाऱ्या साध्या उदाहरणासह सर्व काही कार्यरत असल्याची चाचणी केली + +## पुढील टप्पे + +[अध्याय 3: मुख्य जनरेटिव्ह AI तंत्रे](../03-CoreGenerativeAITechniques/README.md) + +## समस्या निवारण + +काही अडचणी येत आहेत? येथे सामान्य समस्या आणि उपाय आहेत: + +- **टोकन कार्य करत नाही?** + - खात्री करा की आपण टोकन संपूर्ण आणि कोणतेही अतिरिक्त स्पेशल चिह्नांशिवाय कॉपी केले आहे + - पर्यावरण चल म्हणून टोकन योग्यरित्या सेट आहे की नाही ते तपासा + - आपल्या टोकनला योग्य परवानगी आहेत का तपासा (Models: Read-only) + +- **Maven सापडत नाही?** + - Dev कंटेनर/ Codespaces वापरत असाल तर Maven पूर्वच स्थापित असावा + - लोकल सेटअपसाठी Java 21+ आणि Maven 3.9+ स्थापित आहे का तपासा + - तपासा `mvn --version` चालवून स्थापना + +- **कनेक्शन समस्या?** + - इंटरनेट कनेक्शन तपासा + - GitHub आपल्या नेटवर्कवर पोहोचण्यायोग्य आहे का ते तपासा + - GitHub मॉडेल्स एंडपॉइंट ब्लॉक करणारा फायरवॉल नाही ना ते तपासा + +- **Dev कंटेनर सुरू होत नाही?** + - Docker Desktop चालू आहे का ते पहा (लोकल विकासासाठी) + - कंटेनर पुन्हा तयार करण्याचा प्रयत्न करा: `Ctrl+Shift+P` → "Dev Containers: Rebuild Container" + +- **अॅप्लिकेशन कंपाईल त्रुटी?** + - योग्य निर्देशिकेत आहात का तपासा: `02-SetupDevEnvironment/examples/github-models` + - प्रयत्न करा क्लीन आणि रीबिल्ड: `mvn clean compile` + +> **मदतीची गरज आहे?** अजूनही अडचण येत असल्यास? रेपॉझिटरीत एक इश्यू ओपन करा, आम्ही मदत करू. --- + +**अस्वीकरण**: +हा दस्तऐवज AI अनुवाद सेवा [Co-op Translator](https://github.com/Azure/co-op-translator) वापरून अनुवादित केला आहे. आम्ही अचूकतेसाठी प्रयत्नशील असलो तरी, कृपया लक्षात घ्या की स्वयंचलित अनुवादांमध्ये चुका किंवा अपूर्णता असू शकते. मूळ दस्तऐवज आपल्या स्थानिक भाषेत अधिकृत स्रोत म्हणून मान्य केला पाहिजे. महत्त्वपूर्ण माहितीसाठी व्यावसायिक मानवी अनुवाद घेणे शिफारसीय आहे. या अनुवादाच्या वापरामुळे उद्भवलेल्या गैरसमजुती किंवा चुकीच्या अर्थाप्रती आम्ही जबाबदार नाही. + \ No newline at end of file diff --git a/translations/mr/02-SetupDevEnvironment/examples/basic-chat-azure/README.md b/translations/mr/02-SetupDevEnvironment/examples/basic-chat-azure/README.md index 48b9dd54..2d32695c 100644 --- a/translations/mr/02-SetupDevEnvironment/examples/basic-chat-azure/README.md +++ b/translations/mr/02-SetupDevEnvironment/examples/basic-chat-azure/README.md @@ -1,12 +1,3 @@ - # Azure OpenAI सह बेसिक चॅट - एंड-टू-एंड उदाहरण हे उदाहरण Azure OpenAI शी कनेक्ट होणारे एक साधे Spring Boot अॅप्लिकेशन कसे तयार करायचे आणि तुमची सेटअप कशी तपासायची हे दाखवते. diff --git a/translations/mr/02-SetupDevEnvironment/getting-started-azure-openai.md b/translations/mr/02-SetupDevEnvironment/getting-started-azure-openai.md index 8d6c8561..4172a17c 100644 --- a/translations/mr/02-SetupDevEnvironment/getting-started-azure-openai.md +++ b/translations/mr/02-SetupDevEnvironment/getting-started-azure-openai.md @@ -1,12 +1,3 @@ - # Azure OpenAI साठी विकास वातावरण सेट करणे > **जलद प्रारंभ**: हा मार्गदर्शक Azure OpenAI सेटअपसाठी आहे. विनामूल्य मॉडेल्ससह त्वरित प्रारंभासाठी, [GitHub Models with Codespaces](./README.md#quick-start-cloud) वापरा. diff --git a/translations/mr/03-CoreGenerativeAITechniques/README.md b/translations/mr/03-CoreGenerativeAITechniques/README.md index 2e918729..75cebbb4 100644 --- a/translations/mr/03-CoreGenerativeAITechniques/README.md +++ b/translations/mr/03-CoreGenerativeAITechniques/README.md @@ -1,12 +1,3 @@ - # कोर जनरेटिव AI तंत्रज्ञान ट्यूटोरियल ## विषय सूची diff --git a/translations/mr/04-PracticalSamples/README.md b/translations/mr/04-PracticalSamples/README.md index 8aa0df24..cfba8a5b 100644 --- a/translations/mr/04-PracticalSamples/README.md +++ b/translations/mr/04-PracticalSamples/README.md @@ -1,12 +1,3 @@ - # व्यावहारिक उपयोग आणि प्रकल्प ## तुम्ही काय शिकाल diff --git a/translations/mr/04-PracticalSamples/calculator/README.md b/translations/mr/04-PracticalSamples/calculator/README.md index b53418e6..958763b9 100644 --- a/translations/mr/04-PracticalSamples/calculator/README.md +++ b/translations/mr/04-PracticalSamples/calculator/README.md @@ -1,12 +1,3 @@ - # MCP कॅल्क्युलेटर ट्यूटोरियल नवशिक्यांसाठी ## विषय सूची diff --git a/translations/mr/04-PracticalSamples/foundrylocal/README.md b/translations/mr/04-PracticalSamples/foundrylocal/README.md index e7661e12..4c33e042 100644 --- a/translations/mr/04-PracticalSamples/foundrylocal/README.md +++ b/translations/mr/04-PracticalSamples/foundrylocal/README.md @@ -1,12 +1,3 @@ - # फाउंड्री लोकल स्प्रिंग बूट ट्युटोरियल ## विषय सूची diff --git a/translations/mr/04-PracticalSamples/petstory/README.md b/translations/mr/04-PracticalSamples/petstory/README.md index 30de17de..704cf9e6 100644 --- a/translations/mr/04-PracticalSamples/petstory/README.md +++ b/translations/mr/04-PracticalSamples/petstory/README.md @@ -1,12 +1,3 @@ - # पाळीव प्राणी कथा जनरेटर ट्यूटोरियल नवशिक्यांसाठी ## विषय सूची diff --git a/translations/mr/05-ResponsibleGenAI/README.md b/translations/mr/05-ResponsibleGenAI/README.md index 1d92246a..73e8a481 100644 --- a/translations/mr/05-ResponsibleGenAI/README.md +++ b/translations/mr/05-ResponsibleGenAI/README.md @@ -1,12 +1,3 @@ - # जबाबदार जनरेटिव AI ## तुम्ही काय शिकाल diff --git a/translations/mr/AGENTS.md b/translations/mr/AGENTS.md index 03e5d87f..2740e43a 100644 --- a/translations/mr/AGENTS.md +++ b/translations/mr/AGENTS.md @@ -1,12 +1,3 @@ - # AGENTS.md ## प्रकल्पाचा आढावा diff --git a/translations/mr/CODE_OF_CONDUCT.md b/translations/mr/CODE_OF_CONDUCT.md index cbe68071..9b3becaf 100644 --- a/translations/mr/CODE_OF_CONDUCT.md +++ b/translations/mr/CODE_OF_CONDUCT.md @@ -1,12 +1,3 @@ - # Microsoft ओपन सोर्स आचारसंहिता या प्रकल्पाने [Microsoft ओपन सोर्स आचारसंहिता](https://opensource.microsoft.com/codeofconduct/) स्वीकारली आहे. diff --git a/translations/mr/README.md b/translations/mr/README.md index f3e82075..bd618758 100644 --- a/translations/mr/README.md +++ b/translations/mr/README.md @@ -1,91 +1,81 @@ - -# नवीनांसाठी जनरेटिव्ह AI - जावा संस्करण +# जनरेटिव AI सुरुवातीसाठी - जावा आवृत्ती [![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) -![Generative AI for Beginners - Java Edition](../../translated_images/mr/beg-genai-series.8b48be9951cc574c.webp) +![जनरेटिव AI सुरुवातीसाठी - जावा आवृत्ती](../../translated_images/mr/beg-genai-series.8b48be9951cc574c.webp) -**वेळेची बांधणी**: संपूर्ण कार्यशाळा ऑनलाईन पूर्ण करता येते, स्थानिक सेटअपशिवाय. पर्यावरण सेटअपसाठी 2 मिनिटे लागतात, आणि नमुन्यांचा अभ्यास करण्यासाठी 1-3 तासांचा वेगळेपणा आहे जो अभ्यासाच्या खोलीवर अवलंबून आहे. +**वेळ प्रतिबद्धता**: संपूर्ण कार्यशाळा ऑनलाईन पूर्ण केली जाऊ शकते, स्थानिक सेटअपशिवाय. पर्यावरण सेटअपसाठी २ मिनिटे लागतात, आणि नमुन्यांचे अन्वेषण करण्यासाठी १-३ तास लागू शकतात, अन्वेषणाच्या खोलीनुसार. -> **लवकर सुरूवात** +> **त्वरित प्रारंभ** 1. हा रेपॉझिटरी आपल्या GitHub खात्यावर Fork करा 2. क्लिक करा **Code** → **Codespaces** टॅब → **...** → **New with options...** -3. डीफॉल्ट्स वापरा – यामुळे या कोर्ससाठी तयार केलेल्या Development कंटेनरची निवड होईल +3. डीफॉल्ट वापरा – हे या कोर्ससाठी तयार केलेल्या विकास कंटेनरची निवड करेल 4. क्लिक करा **Create codespace** -5. सुमारे 2 मिनिटे प्रतीक्षा करा पर्यावरण तयार होईपर्यंत -6. थेट [पहिला उदाहरण](./02-SetupDevEnvironment/README.md#step-2-create-a-github-personal-access-token) यावर जा +5. सुमारे २ मिनिटे प्रतीक्षा करा पर्यावरण तयार होईपर्यंत +6. थेट जाऊन बघा [पहिले उदाहरण](./02-SetupDevEnvironment/README.md#step-2-create-a-github-personal-access-token) -> **स्थानिकरित्या Clone करायचे प्राधान्य द्यायचे?** +> **स्थानिक क्लोन करायला प्राधान्य देता का?** > -> या रेपॉझिटरीमध्ये 50+ भाषेतले भाषांतर आहे ज्यामुळे डाउनलोड साईज लक्षणीय वाढते. भाषांतरांशिवाय clone करण्यासाठी sparse checkout वापरा: +> या रेपॉझिटरीमध्ये ५०+ भाषा अनुवादांचा समावेश आहे ज्यामुळे डाउनलोड आकार मोठा होतो. अनुवादांशिवाय क्लोन करण्यासाठी, sparse checkout वापरा: > ```bash > git clone --filter=blob:none --sparse https://github.com/microsoft/Generative-AI-for-beginners-java.git > cd Generative-AI-for-beginners-java > git sparse-checkout set --no-cone '/*' '!translations' '!translated_images' > ``` -> यामुळे आपण कोर्स पूर्ण करण्यासाठी आवश्यक सर्वकाही खूप जलद डाउनलोड मिळेल. +> हे आपल्याला कोर्स पूर्ण करण्यासाठी आवश्यक सर्व काही अधिक वेगवान डाउनलोडसह देते. +## बहुभाषी समर्थन -## बहुभाषिक समर्थन - -### GitHub Action द्वारे समर्थित (स्वयंचलित आणि सदैव अद्ययावत) +### GitHub Action मधून समर्थित (स्वयंचलित व नेहमी अद्ययावत) -[अरबी](../ar/README.md) | [बंगाली](../bn/README.md) | [बल्गेरियन](../bg/README.md) | [म्यानमार (बर्मीज)](../my/README.md) | [चिनी (सोपे केलेले)](../zh/README.md) | [चिनी (परंपरागत, हॉंगकॉंग)](../hk/README.md) | [चिनी (परंपरागत, मकाऊ)](../mo/README.md) | [चिनी (परंपरागत, तैवान)](../tw/README.md) | [क्रोएशियन](../hr/README.md) | [झेक](../cs/README.md) | [डॅनिश](../da/README.md) | [डच](../nl/README.md) | [एस्टोनियन](../et/README.md) | [फिन्निश](../fi/README.md) | [फ्रेंच](../fr/README.md) | [जर्मन](../de/README.md) | [ग्रीक](../el/README.md) | [हिब्रू](../he/README.md) | [हिंदी](../hi/README.md) | [हंगेरियन](../hu/README.md) | [इंडोनेशियन](../id/README.md) | [इटालियन](../it/README.md) | [जपानी](../ja/README.md) | [कन्नड](../kn/README.md) | [कोंगली](../ko/README.md) | [लिथुआनियन](../lt/README.md) | [मलय](../ms/README.md) | [मलयाळम](../ml/README.md) | [मराठी](./README.md) | [नेपाली](../ne/README.md) | [नायजेरियन पिजिन](../pcm/README.md) | [नॉर्वेजियन](../no/README.md) | [फारशी (पर्शियन)](../fa/README.md) | [पोलिश](../pl/README.md) | [ब्राझीलियन पोर्तुगीज](../br/README.md) | [पोर्तुगीज (पोर्तुगाल)](../pt/README.md) | [पंजाबी (गुरुमुखी)](../pa/README.md) | [रोमानियन](../ro/README.md) | [रशियन](../ru/README.md) | [सर्बियन (सिरिलिक)](../sr/README.md) | [स्लोव्हाक](../sk/README.md) | [स्लोव्हेनियन](../sl/README.md) | [स्पॅनिश](../es/README.md) | [स्वाहिली](../sw/README.md) | [स्वीडिश](../sv/README.md) | [तागालॉग (फिलीपिनो)](../tl/README.md) | [तमिळ](../ta/README.md) | [तेलुगू](../te/README.md) | [थाई](../th/README.md) | [तुर्की](../tr/README.md) | [युक्रेनी](../uk/README.md) | [उर्दू](../ur/README.md) | [विएतनामी](../vi/README.md) +[अरबी](../ar/README.md) | [बंगाली](../bn/README.md) | [बुलगेरियन](../bg/README.md) | [बर्मी (म्यानमार)](../my/README.md) | [चिनी (सरळ)](../zh-CN/README.md) | [चिनी (परंपरागत, हॉन्ग कॉंग)](../zh-HK/README.md) | [चिनी (परंपरागत, मकाव)](../zh-MO/README.md) | [चिनी (परंपरागत, तैवान)](../zh-TW/README.md) | [क्रोएशियन](../hr/README.md) | [झेक](../cs/README.md) | [डेनेशियन](../da/README.md) | [डच](../nl/README.md) | [एस्तोनीयन](../et/README.md) | [फिनिश](../fi/README.md) | [फ्रेंच](../fr/README.md) | [जर्मन](../de/README.md) | [ग्रीक](../el/README.md) | [हिब्रू](../he/README.md) | [हिंदी](../hi/README.md) | [हंगेरीयन](../hu/README.md) | [इंडोनेशियन](../id/README.md) | [इटालियन](../it/README.md) | [जपानी](../ja/README.md) | [कन्नड](../kn/README.md) | [कोरियन](../ko/README.md) | [लिथुआनियन](../lt/README.md) | [मलय](../ms/README.md) | [मलयाळम](../ml/README.md) | [मराठी](./README.md) | [नेपाली](../ne/README.md) | [नायजेरियन पिजिन](../pcm/README.md) | [नॉर्वेजियन](../no/README.md) | [फारसी (पर्शियन)](../fa/README.md) | [पोलिश](../pl/README.md) | [पॉर्तुगाली (ब्राझील)](../pt-BR/README.md) | [पॉर्तुगाली (पोर्तुगाल)](../pt-PT/README.md) | [पंजाबी (गुरमुखी)](../pa/README.md) | [रोमानीयन](../ro/README.md) | [रशियन](../ru/README.md) | [सर्बियन (सिरिलिक)](../sr/README.md) | [स्लोव्हाक](../sk/README.md) | [स्लोव्हेनियन](../sl/README.md) | [स्पॅनिश](../es/README.md) | [स्वाहिली](../sw/README.md) | [स्वीडिश](../sv/README.md) | [टागालॉग (फिलिपिनो)](../tl/README.md) | [तमिळ](../ta/README.md) | [तेलुगू](../te/README.md) | [थाई](../th/README.md) | [टर्किश](../tr/README.md) | [युक्रेनियन](../uk/README.md) | [उर्दू](../ur/README.md) | [व्हिएतनामी](../vi/README.md) -> **स्थानिकरित्या Clone करायचे प्राधान्य द्यायचे?** +> **स्थानिक क्लोन करायला प्राधान्य देता का?** -> या रेपॉझिटरीमध्ये 50+ भाषांतर आहे ज्यामुळे डाउनलोड साईज लक्षणीय वाढते. भाषांतरांशिवाय clone करण्यासाठी sparse checkout वापरा: +> या रेपॉझिटरीमध्ये ५०+ भाषा अनुवादांचा समावेश आहे ज्यामुळे डाउनलोड आकार मोठा होतो. अनुवादांशिवाय क्लोन करण्यासाठी, sparse checkout वापरा: > ```bash > git clone --filter=blob:none --sparse https://github.com/microsoft/Generative-AI-for-beginners-java.git > cd Generative-AI-for-beginners-java > git sparse-checkout set --no-cone '/*' '!translations' '!translated_images' > ``` -> यामुळे आपण कोर्स पूर्ण करण्यासाठी आवश्यक सर्वकाही खूप जलद डाउनलोड मिळेल. +> हे आपल्याला कोर्स पूर्ण करण्यासाठी आवश्यक सर्व काही अधिक वेगवान डाउनलोडसह देते. -## कोर्स रचना आणि शिक्षणाचा मार्ग - -### **अध्याय 1: जनरेटिव्ह AI ची ओळख** -- **मुळ संकल्पना**: Large Language Models, tokens, embeddings, आणि AI क्षमतांचा समज -- **जावा AI इकोसिस्टम**: Spring AI आणि OpenAI SDK चे विहंगावलोकन -- **मॉडेल संदर्भ प्रोटोकॉल**: MCP ची ओळख आणि AI एजंट संवादामध्ये त्याची भूमिका -- **व्यावहारिक अनुप्रयोग**: चैटबॉट्स आणि कंटेंट जनरेशन यांसारख्या वास्तविक जगातील परिस्थिती -- **[→ पहिला अध्याय सुरू करा](./01-IntroToGenAI/README.md)** - -### **अध्याय 2: विकास पर्यावरण सेटअप** -- **मल्टि-प्रोव्हायडर कॉन्फिगरेशन**: GitHub Models, Azure OpenAI, आणि OpenAI Java SDK एकत्रीकरण सेट करा -- **Spring Boot + Spring AI**: एंटरप्राइझ AI अनुप्रयोग विकासासाठी सर्वोत्तम पद्धती -- **GitHub Models**: प्रोटोटायपिंग आणि शिक्षणासाठी मोफत AI मॉडेल वापर (क्रेडिट कार्ड आवश्यक नाही) -- **विकास साधने**: Docker कंटेनर, VS Code, आणि GitHub Codespaces सेटअप -- **[→ दुसरा अध्याय सुरू करा](./02-SetupDevEnvironment/README.md)** - -### **अध्याय 3: मुख्य जनरेटिव्ह AI तंत्रे** -- **प्रॉम्प्ट इंजिनीअरिंग**: AI मॉडेल प्रतिसादासाठी उत्कृष्ट तंत्र -- **_embeddings_ आणि वेक्टर ऑपरेशन्स**: सेमॅंटिक सर्च आणि सादृश्यता जुळणी अंमलात आणा -- **रिट्रीव्हल-ऑगमेंटेड जनरेशन (RAG)**: AI ला आपल्या स्वतःच्या डेटा स्रोतांसह जोडा -- **फंक्शन कॉलिंग**: कस्टम टूल्स आणि प्लगइन्ससह AI क्षमतांचा विस्तार करा -- **[→ तिसरा अध्याय सुरू करा](./03-CoreGenerativeAITechniques/README.md)** - -### **अध्याय 4: व्यावहारिक अनुप्रयोग आणि प्रकल्प** -- **पेट स्टोरी जनरेटर** (`petstory/`): GitHub Models वापरून सर्जनशील सामग्री निर्मिती -- **Foundry Local Demo** (`foundrylocal/`): OpenAI Java SDK सह स्थानिक AI मॉडेल समाकलन -- **MCP कॅल्क्युलेटर सेवा** (`calculator/`): Spring AI सह मूलभूत Model Context Protocol अंमलबजावणी -- **[→ चौथा अध्याय सुरू करा](./04-PracticalSamples/README.md)** - -### **अध्याय 5: जबाबदार AI विकास** -- **GitHub Models सुरक्षा**: अंगभूत कंटेंट फिल्टरिंग आणि संरक्षण व्यवस्था तपासा (हार्ड ब्लॉक्स आणि सॉफ्ट नाकार) -- **जबाबदार AI डेमो**: आधुनिक AI सुरक्षा व्यवस्थेवर प्रत्यक्ष उदाहरण -- **सर्वोत्तम पद्धती**: नैतिक AI विकास आणि अंमलबजावणीसाठी आवश्यक मार्गदर्शक तत्त्वे -- **[→ पाचवा अध्याय सुरू करा](./05-ResponsibleGenAI/README.md)** +## अभ्यासक्रम रचना व शिकण्याचा मार्ग + +### **अध्याय १: जनरेटिव AI परिचय** +- **मूळ संकल्पना**: मोठ्या भाषा मॉडेल्स, टोकन्स, एम्बेडिंग्ज आणि AI क्षमतांचा समज +- **जावा AI पर्यावरण**: स्प्रिंग AI आणि OpenAI SDK ची ओळख +- **मॉडेल कॉन्टेक्स्ट प्रोटोकॉल**: MCP ची ओळख आणि AI एजंट संप्रेषणातील भूमिका +- **प्रायोगिक अनुप्रयोग**: चाटबॉट्स आणि कंटेंट निर्मिती यांसारख्या वास्तव जगातील अवस्था +- **[→ सुरुवात करा अध्याय १](./01-IntroToGenAI/README.md)** + +### **अध्याय २: विकास पर्यावरण सेटअप** +- **बहु-प्रदाता कॉन्फिगरेशन**: GitHub मॉडेल्स, Azure OpenAI आणि OpenAI जावा SDK इंटिग्रेशन +- **स्प्रिंग बूट + स्प्रिंग AI**: एंटरप्राईज AI अॅप्लिकेशन विकासासाठी उत्तम प्रथांचा वापर +- **GitHub मॉडेल्स**: झीजासाठी व शिकण्यासाठी मोफत AI मॉडेल प्रवेश (क्रेडिट कार्ड नको) +- **विकास साधने**: डॉकर कंटेनर्स, VS कोड, आणि GitHub Codespaces सेटअप +- **[→ सुरुवात करा अध्याय २](./02-SetupDevEnvironment/README.md)** + +### **अध्याय ३: मुख्य जनरेटिव AI तंत्रे** +- **प्रॉम्प्ट इंजिनिअरिंग**: AI मॉडेल प्रतिक्रियेसाठी तंत्रे +- **एम्बेडिंग्ज व व्हेक्टर ऑपरेशन्स**: सेमॅंटिक शोध व सादृश्यता जुळवणीची अंमलबजावणी +- **रिट्रीव्हल-अगमेंटेड जनरेशन (RAG)**: AI चे आपल्या डेटा स्रोतांसह संयोजन +- **फंक्शन कॉलिंग**: कस्टम साधने आणि प्लगइन्ससह AI क्षमता वाढवा +- **[→ सुरुवात करा अध्याय ३](./03-CoreGenerativeAITechniques/README.md)** + +### **अध्याय ४: व्यावहारिक अनुप्रयोग व प्रकल्प** +- **पाळीव कथा जनरेटर** (`petstory/`): GitHub मॉडेल्ससह सर्जनशील कंटेंट निर्मिती +- **Foundry स्थानिक डेमो** (`foundrylocal/`): OpenAI जावा SDK सह स्थानिक AI मॉडेल इंटिग्रेशन +- **MCP कॅल्क्युलेटर सेवा** (`calculator/`): स्प्रिंग AI सह बेसिक मॉडेल कॉन्टेक्स्ट प्रोटोकॉलची अंमलबजावणी +- **[→ सुरुवात करा अध्याय ४](./04-PracticalSamples/README.md)** + +### **अध्याय ५: जबाबदार AI विकास** +- **GitHub मॉडेल्स सुरक्षा**: अंगभूत कंटेंट फिल्टरेशन आणि सुरक्षा यंत्रणा (कठोर रोखणे आणि सौम्य नकार) +- **जबाबदार AI डेमो**: आधुनिक AI सुरक्षा प्रणाली कशी कार्य करते हे दाखवणारे प्रत्यक्ष उदाहरण +- **अत्यावश्यक मार्गदर्शक तत्त्वे**: नैतिक AI विकास व तैनातीसाठी आवश्यक मार्गदर्शन +- **[→ सुरुवात करा अध्याय ५](./05-ResponsibleGenAI/README.md)** ## अतिरिक्त संसाधने @@ -104,7 +94,7 @@ CO_OP_TRANSLATOR_METADATA: --- -### जनरेटिव्ह AI मालिका +### जनरेटिव AI सिरीज [![Generative AI for Beginners](https://img.shields.io/badge/Generative%20AI%20for%20Beginners-8B5CF6?style=for-the-badge&labelColor=E5E7EB&color=8B5CF6)](https://github.com/microsoft/generative-ai-for-beginners?WT.mc_id=academic-105485-koreyst) [![Generative AI (.NET)](https://img.shields.io/badge/Generative%20AI%20(.NET)-9333EA?style=for-the-badge&labelColor=E5E7EB&color=9333EA)](https://github.com/microsoft/Generative-AI-for-beginners-dotnet?WT.mc_id=academic-105485-koreyst) [![Generative AI (Java)](https://img.shields.io/badge/Generative%20AI%20(Java)-C084FC?style=for-the-badge&labelColor=E5E7EB&color=C084FC)](https://github.com/microsoft/generative-ai-for-beginners-java?WT.mc_id=academic-105485-koreyst) @@ -117,31 +107,32 @@ CO_OP_TRANSLATOR_METADATA: [![Data Science for Beginners](https://img.shields.io/badge/Data%20Science%20for%20Beginners-84CC16?style=for-the-badge&labelColor=E5E7EB&color=84CC16)](https://aka.ms/datascience-beginners?WT.mc_id=academic-105485-koreyst) [![AI for Beginners](https://img.shields.io/badge/AI%20for%20Beginners-A3E635?style=for-the-badge&labelColor=E5E7EB&color=A3E635)](https://aka.ms/ai-beginners?WT.mc_id=academic-105485-koreyst) [![Cybersecurity for Beginners](https://img.shields.io/badge/Cybersecurity%20for%20Beginners-F97316?style=for-the-badge&labelColor=E5E7EB&color=F97316)](https://github.com/microsoft/Security-101?WT.mc_id=academic-96948-sayoung) + [![Web Dev for Beginners](https://img.shields.io/badge/Web%20Dev%20for%20Beginners-EC4899?style=for-the-badge&labelColor=E5E7EB&color=EC4899)](https://aka.ms/webdev-beginners?WT.mc_id=academic-105485-koreyst) -[![नवशिक्यांसाठी IoT](https://img.shields.io/badge/IoT%20for%20Beginners-14B8A6?style=for-the-badge&labelColor=E5E7EB&color=14B8A6)](https://aka.ms/iot-beginners?WT.mc_id=academic-105485-koreyst) -[![नवशिक्यांसाठी XR विकास](https://img.shields.io/badge/XR%20Development%20for%20Beginners-38BDF8?style=for-the-badge&labelColor=E5E7EB&color=38BDF8)](https://github.com/microsoft/xr-development-for-beginners?WT.mc_id=academic-105485-koreyst) +[![IoT for Beginners](https://img.shields.io/badge/IoT%20for%20Beginners-14B8A6?style=for-the-badge&labelColor=E5E7EB&color=14B8A6)](https://aka.ms/iot-beginners?WT.mc_id=academic-105485-koreyst) +[![XR Development for Beginners](https://img.shields.io/badge/XR%20Development%20for%20Beginners-38BDF8?style=for-the-badge&labelColor=E5E7EB&color=38BDF8)](https://github.com/microsoft/xr-development-for-beginners?WT.mc_id=academic-105485-koreyst) --- -### कॉपायलट मालिका -[![AI जोडवलेले प्रोग्रामिंगसाठी कॉपायलट](https://img.shields.io/badge/Copilot%20for%20AI%20Paired%20Programming-FACC15?style=for-the-badge&labelColor=E5E7EB&color=FACC15)](https://aka.ms/GitHubCopilotAI?WT.mc_id=academic-105485-koreyst) -[![C#/.NET साठी कॉपायलट](https://img.shields.io/badge/Copilot%20for%20C%23/.NET-FBBF24?style=for-the-badge&labelColor=E5E7EB&color=FBBF24)](https://github.com/microsoft/mastering-github-copilot-for-dotnet-csharp-developers?WT.mc_id=academic-105485-koreyst) -[![कॉपायलट साहस](https://img.shields.io/badge/Copilot%20Adventure-FDE68A?style=for-the-badge&labelColor=E5E7EB&color=FDE68A)](https://github.com/microsoft/CopilotAdventures?WT.mc_id=academic-105485-koreyst) +### Copilot मालिका +[![Copilot for AI Paired Programming](https://img.shields.io/badge/Copilot%20for%20AI%20Paired%20Programming-FACC15?style=for-the-badge&labelColor=E5E7EB&color=FACC15)](https://aka.ms/GitHubCopilotAI?WT.mc_id=academic-105485-koreyst) +[![Copilot for C#/.NET](https://img.shields.io/badge/Copilot%20for%20C%23/.NET-FBBF24?style=for-the-badge&labelColor=E5E7EB&color=FBBF24)](https://github.com/microsoft/mastering-github-copilot-for-dotnet-csharp-developers?WT.mc_id=academic-105485-koreyst) +[![Copilot Adventure](https://img.shields.io/badge/Copilot%20Adventure-FDE68A?style=for-the-badge&labelColor=E5E7EB&color=FDE68A)](https://github.com/microsoft/CopilotAdventures?WT.mc_id=academic-105485-koreyst) ## मदत मिळवा -जर तुम्हाला अडचण येत असेल किंवा AI अॅप्स तयार करताना काही प्रश्न असतील. तर MCP विषयी चर्चेत सहभागी व्हा जिथे सहशिक्षार्थी आणि अनुभवी विकासक असतात. ही एक आधारभूत समुदाय आहे जिथे प्रश्न विचारले जातात आणि ज्ञान मोकळेपणाने शेअर केले जाते. +जर आपण अडकले असाल किंवा AI अ‍ॅप्स तयार करताना काही प्रश्न असतील तर MCP विषयी चर्चा करण्यासाठी सहकार्य शिकणारे आणि अनुभवी विकासकांमध्ये सामील व्हा. ही एक सहकार्यशील समुदाय आहे जिथे प्रश्न विचारले जातात आणि ज्ञान मोकळेपणाने शेअर केले जाते. [![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) -तुमच्याकडे उत्पादन संबंधित अभिप्राय किंवा चुका असल्यास येथे भेट द्या: +आपल्याकडे उत्पादनाबाबत अभिप्राय किंवा तयार करताना त्रुटी असतील तर भेट द्या: [![Microsoft Foundry Developer Forum](https://img.shields.io/badge/GitHub-Microsoft_Foundry_Developer_Forum-blue?style=for-the-badge&logo=github&color=000000&logoColor=fff)](https://aka.ms/foundry/forum) --- -**अस्वीकरण**: -हा दस्तावेज AI अनुवाद सेवा [Co-op Translator](https://github.com/Azure/co-op-translator) वापरुन अनुवादित करण्यात आला आहे. आम्ही अचूकतेसाठी प्रयत्नशील असलो तरी, कृपया लक्षात ठेवा की स्वयंचलित अनुवादांमध्ये चुका किंवा अचूकतेच्या त्रुटी असू शकतात. मूळ दस्तावेज त्याच्या मूळ भाषेत अधिकृत स्रोत म्हणून घ्यावा. महत्त्वाच्या माहिती साठी व्यावसायिक मानवी अनुवादाची शिफारस केली जाते. या अनुवादाच्या वापरामुळे उद्भवलेल्या कोणत्याही गैरसमजात किंवा चुकीच्या समजुतीस आम्ही जबाबदार नाही. +**विज्ञप्ती**: +हा दस्तऐवज AI अनुवाद सेवा [Co-op Translator](https://github.com/Azure/co-op-translator) चा वापर करून अनुवादित केला आहे. आम्ही अचूकतेसाठी प्रयत्न करत असलो तरी, कृपया लक्षात घ्या की स्वयंचलित अनुवादांमध्ये चुका किंवा अचूकतेची कमतरता असू शकते. मूळ दस्तऐवज त्याच्या स्थानिक भाषेत अधिकृत स्रोत मानला जावा. महत्त्वाच्या माहितीसाठी व्यावसायिक मानवी अनुवाद शिफारसीय आहे. या अनुवादाच्या वापरामुळे उद्भवणाऱ्या कोणत्याही गैरसमजुती किंवा चुकीच्या अर्थसाधनेच्या जबाबदारी आम्ही स्वीकारत नाही. \ No newline at end of file diff --git a/translations/mr/SECURITY.md b/translations/mr/SECURITY.md index 53a04b4f..6a6fc2a0 100644 --- a/translations/mr/SECURITY.md +++ b/translations/mr/SECURITY.md @@ -1,12 +1,3 @@ - ## सुरक्षा मायक्रोसॉफ्ट आपल्या सॉफ्टवेअर उत्पादने आणि सेवांच्या सुरक्षेला गंभीरपणे घेतो, ज्यामध्ये आमच्या GitHub संस्थांद्वारे व्यवस्थापित केलेल्या सर्व स्रोत कोड रिपॉझिटरीजचा समावेश होतो, ज्यामध्ये [Microsoft](https://github.com/Microsoft), [Azure](https://github.com/Azure), [DotNet](https://github.com/dotnet), [AspNet](https://github.com/aspnet) आणि [Xamarin](https://github.com/xamarin) यांचा समावेश आहे. diff --git a/translations/mr/SUPPORT.md b/translations/mr/SUPPORT.md index 2d826af5..57c38ad8 100644 --- a/translations/mr/SUPPORT.md +++ b/translations/mr/SUPPORT.md @@ -1,12 +1,3 @@ - # समर्थन ## समस्या नोंदवणे आणि मदत कशी मिळवायची diff --git a/translations/ms/.co-op-translator.json b/translations/ms/.co-op-translator.json new file mode 100644 index 00000000..684c36cb --- /dev/null +++ b/translations/ms/.co-op-translator.json @@ -0,0 +1,92 @@ +{ + "01-IntroToGenAI/README.md": { + "original_hash": "75bfb080ca725e8a9aa9c80cae25fba1", + "translation_date": "2025-07-29T09:49:06+00:00", + "source_file": "01-IntroToGenAI/README.md", + "language_code": "ms" + }, + "02-SetupDevEnvironment/README.md": { + "original_hash": "96a30d42b9751a3d4e4b20e28d29d459", + "translation_date": "2026-01-28T05:13:10+00:00", + "source_file": "02-SetupDevEnvironment/README.md", + "language_code": "ms" + }, + "02-SetupDevEnvironment/examples/basic-chat-azure/README.md": { + "original_hash": "efd82efe50711d7e257eb943151d682c", + "translation_date": "2025-07-27T13:44:42+00:00", + "source_file": "02-SetupDevEnvironment/examples/basic-chat-azure/README.md", + "language_code": "ms" + }, + "02-SetupDevEnvironment/getting-started-azure-openai.md": { + "original_hash": "bfdb4b4eadbee3a59ef742439f58326a", + "translation_date": "2025-07-27T13:20:07+00:00", + "source_file": "02-SetupDevEnvironment/getting-started-azure-openai.md", + "language_code": "ms" + }, + "03-CoreGenerativeAITechniques/README.md": { + "original_hash": "685f55cb07de19b52a30ce6e8b6d889e", + "translation_date": "2025-08-28T22:12:21+00:00", + "source_file": "03-CoreGenerativeAITechniques/README.md", + "language_code": "ms" + }, + "04-PracticalSamples/README.md": { + "original_hash": "14c0a61ecc1cd2012a9c129236dfdf71", + "translation_date": "2025-07-29T09:48:51+00:00", + "source_file": "04-PracticalSamples/README.md", + "language_code": "ms" + }, + "04-PracticalSamples/calculator/README.md": { + "original_hash": "b6c16b5514d524e415a94f6097ee7d4c", + "translation_date": "2025-09-18T15:37:09+00:00", + "source_file": "04-PracticalSamples/calculator/README.md", + "language_code": "ms" + }, + "04-PracticalSamples/foundrylocal/README.md": { + "original_hash": "f787307400de59adc25a1404466a35f3", + "translation_date": "2025-11-04T07:30:31+00:00", + "source_file": "04-PracticalSamples/foundrylocal/README.md", + "language_code": "ms" + }, + "04-PracticalSamples/petstory/README.md": { + "original_hash": "0cbf68d605615a1e602c832a24616859", + "translation_date": "2025-07-25T11:44:56+00:00", + "source_file": "04-PracticalSamples/petstory/README.md", + "language_code": "ms" + }, + "05-ResponsibleGenAI/README.md": { + "original_hash": "301c05c2f57e60a6950b8c665b8bdbba", + "translation_date": "2025-07-29T15:55:59+00:00", + "source_file": "05-ResponsibleGenAI/README.md", + "language_code": "ms" + }, + "AGENTS.md": { + "original_hash": "afc90918d008cf77fd1982691f681306", + "translation_date": "2025-10-03T08:40:30+00:00", + "source_file": "AGENTS.md", + "language_code": "ms" + }, + "CODE_OF_CONDUCT.md": { + "original_hash": "442b123d034f92f7c384d2bbd28f99f1", + "translation_date": "2025-07-21T19:09:00+00:00", + "source_file": "CODE_OF_CONDUCT.md", + "language_code": "ms" + }, + "README.md": { + "original_hash": "125a08948d881c95628094f4dd1fbd43", + "translation_date": "2026-01-29T16:01:42+00:00", + "source_file": "README.md", + "language_code": "ms" + }, + "SECURITY.md": { + "original_hash": "57f14126c1c6add76b3aef3844dfe4e3", + "translation_date": "2025-07-21T19:07:40+00:00", + "source_file": "SECURITY.md", + "language_code": "ms" + }, + "SUPPORT.md": { + "original_hash": "b8ef73cc49dec68e2c885ee9df545129", + "translation_date": "2025-07-21T19:10:12+00:00", + "source_file": "SUPPORT.md", + "language_code": "ms" + } +} \ No newline at end of file diff --git a/translations/ms/01-IntroToGenAI/README.md b/translations/ms/01-IntroToGenAI/README.md index aa6fc0e2..bc229f3b 100644 --- a/translations/ms/01-IntroToGenAI/README.md +++ b/translations/ms/01-IntroToGenAI/README.md @@ -1,12 +1,3 @@ - # Pengenalan kepada Generative AI - Edisi Java ## Apa yang Anda Akan Pelajari diff --git a/translations/ms/02-SetupDevEnvironment/README.md b/translations/ms/02-SetupDevEnvironment/README.md index 9b8ddb05..c376b442 100644 --- a/translations/ms/02-SetupDevEnvironment/README.md +++ b/translations/ms/02-SetupDevEnvironment/README.md @@ -1,13 +1,254 @@ - +# Menyediakan Persekitaran Pembangunan untuk Generative AI bagi Java +> **Mula Cepat**: Kod dalam Awan dalam 2 minit - Lompat ke [Persediaan GitHub Codespaces](../../../02-SetupDevEnvironment) - tiada pemasangan tempatan diperlukan dan menggunakan model github! + +> **Berminat dengan Azure OpenAI?**, lihat [Panduan Persediaan Azure OpenAI](getting-started-azure-openai.md) kami dengan langkah untuk mencipta sumber Azure OpenAI baru. + +## Apa yang Anda Akan Pelajari + +- Menyediakan persekitaran pembangunan Java untuk aplikasi AI +- Memilih dan mengkonfigurasi persekitaran pembangunan pilihan anda (utamakan awan dengan Codespaces, bekas dev tempatan, atau persediaan tempatan penuh) +- Uji persediaan anda dengan menyambung ke Model GitHub + +## Jadual Kandungan + +- [Apa yang Anda Akan Pelajari](../../../02-SetupDevEnvironment) +- [Pengenalan](../../../02-SetupDevEnvironment) +- [Langkah 1: Sediakan Persekitaran Pembangunan Anda](../../../02-SetupDevEnvironment) + - [Pilihan A: GitHub Codespaces (Disyorkan)](../../../02-SetupDevEnvironment) + - [Pilihan B: Bekas Dev Tempatan](../../../02-SetupDevEnvironment) + - [Pilihan C: Gunakan Pemasangan Tempatan Sedia Ada Anda](../../../02-SetupDevEnvironment) +- [Langkah 2: Cipta Token Akses Peribadi GitHub](../../../02-SetupDevEnvironment) +- [Langkah 3: Uji Persediaan Anda](../../../02-SetupDevEnvironment) +- [Menyelesaikan Masalah](../../../02-SetupDevEnvironment) +- [Ringkasan](../../../02-SetupDevEnvironment) +- [Langkah Seterusnya](../../../02-SetupDevEnvironment) + +## Pengenalan + +Bab ini akan memandu anda melalui penyediaan persekitaran pembangunan. Kami akan menggunakan **Model GitHub** sebagai contoh utama kerana ia percuma, mudah disediakan dengan hanya akaun GitHub, tidak memerlukan kad kredit, dan menyediakan akses kepada pelbagai model untuk eksperimen. + +**Tiada persediaan tempatan diperlukan!** Anda boleh mula menulis kod serta-merta menggunakan GitHub Codespaces, yang menyediakan persekitaran pembangunan penuh dalam pelayar anda. + +Tangkapan skrin: Model GitHub + +Kami mengesyorkan menggunakan [**Model GitHub**](https://github.com/marketplace?type=models) untuk kursus ini kerana ia: +- **Percuma** untuk bermula +- **Mudah** disediakan hanya dengan akaun GitHub +- **Tiada kad kredit** diperlukan +- **Banyak model** tersedia untuk eksperimen + +> **Nota**: Model GitHub yang digunakan dalam latihan ini mempunyai had percuma berikut: +> - 15 permintaan setiap minit (150 sehari) +> - ~8,000 perkataan masuk, ~4,000 perkataan keluar setiap permintaan +> - 5 permintaan serentak +> +> Untuk penggunaan pengeluaran, naik taraf ke Model Azure AI Foundry dengan akaun Azure anda. Kod anda tidak perlu diubah. Lihat [dokumentasi Azure AI Foundry](https://learn.microsoft.com/azure/ai-foundry/foundry-models/how-to/quickstart-github-models). + + +## Langkah 1: Sediakan Persekitaran Pembangunan Anda + + + +Kami telah mencipta bekas pembangunan yang sudah dikonfigurasikan untuk meminimumkan masa persediaan dan memastikan anda mempunyai semua alat yang diperlukan untuk kursus Generative AI bagi Java ini. Pilih pendekatan pembangunan anda yang disukai: + +### Pilihan Persediaan Persekitaran: + +#### Pilihan A: GitHub Codespaces (Disyorkan) + +**Mula menulis kod dalam 2 minit - tiada persediaan tempatan diperlukan!** + +1. Fork repositori ini ke akaun GitHub anda + > **Nota**: Jika anda mahu mengubah suai konfigurasi asas sila lihat [Konfigurasi Bekas Dev](../../../.devcontainer/devcontainer.json) +2. Klik **Code** → tab **Codespaces** → **...** → **New with options...** +3. Gunakan tetapan default – ini akan memilih **Konfigurasi bekas Dev**: **Persekitaran Pembangunan Generative AI Java** devcontainer khas yang dibuat untuk kursus ini +4. Klik **Create codespace** +5. Tunggu kira-kira 2 minit untuk persekitaran bersedia +6. Teruskan ke [Langkah 2: Cipta Token GitHub](../../../02-SetupDevEnvironment) + +Tangkapan skrin: submenu Codespaces + +Tangkapan skrin: New with options + +Tangkapan skrin: pilihan buat codespace + + +> **Kelebihan Codespaces**: +> - Tiada pemasangan tempatan diperlukan +> - Boleh digunakan pada mana-mana peranti dengan pelayar +> - Telah dikonfigurasikan dengan semua alat dan kebergantungan +> - 60 jam percuma setiap bulan untuk akaun peribadi +> - Persekitaran konsisten bagi semua pelajar + +#### Pilihan B: Bekas Dev Tempatan + +**Untuk pembangun yang memilih pembangunan tempatan dengan Docker** + +1. Fork dan klon repositori ini ke mesin tempatan anda + > **Nota**: Jika anda mahu mengubah suai konfigurasi asas sila lihat [Konfigurasi Bekas Dev](../../../.devcontainer/devcontainer.json) +2. Pasang [Docker Desktop](https://www.docker.com/products/docker-desktop/) dan [VS Code](https://code.visualstudio.com/) +3. Pasang [sambungan Dev Containers](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers) dalam VS Code +4. Buka folder repositori dalam VS Code +5. Apabila diminta, klik **Reopen in Container** (atau gunakan `Ctrl+Shift+P` → "Dev Containers: Reopen in Container") +6. Tunggu bekas dibina dan dimulakan +7. Teruskan ke [Langkah 2: Cipta Token GitHub](../../../02-SetupDevEnvironment) + +Tangkapan skrin: persediaan bekas Dev + +Tangkapan skrin: siap bina bekas Dev + +#### Pilihan C: Gunakan Pemasangan Tempatan Sedia Ada Anda + +**Untuk pembangun yang sudah ada persekitaran Java** + +Keperluan: +- [Java 21+](https://www.oracle.com/java/technologies/javase/jdk21-archive-downloads.html) +- [Maven 3.9+](https://maven.apache.org/download.cgi) +- [VS Code](https://code.visualstudio.com) atau IDE pilihan anda + +Langkah: +1. Klon repositori ini ke mesin tempatan anda +2. Buka projek dalam IDE anda +3. Teruskan ke [Langkah 2: Cipta Token GitHub](../../../02-SetupDevEnvironment) + +> **Petua Pro**: Jika mesin anda berspesifikasi rendah tetapi mahu VS Code secara tempatan, gunakan GitHub Codespaces! Anda boleh sambungkan VS Code tempatan anda ke Codespace yang dihos di awan untuk gabungan terbaik. + +Tangkapan skrin: instans devcontainer tempatan yang dibuat + + +## Langkah 2: Cipta Token Akses Peribadi GitHub + +1. Navigasi ke [Tetapan GitHub](https://github.com/settings/profile) dan pilih **Settings** dari menu profil anda. +2. Dalam bar sisi kiri, klik **Developer settings** (biasanya di bawah sekali). +3. Di bawah **Personal access tokens**, klik **Fine-grained tokens** (atau ikut [pautan](https://github.com/settings/personal-access-tokens) terus). +4. Klik **Generate new token**. +5. Di bawah "Token name", berikan nama yang menerangkan (contohnya, `GenAI-Java-Course-Token`). +6. Tetapkan tarikh luput (disyorkan: 7 hari untuk amalan keselamatan terbaik). +7. Di bawah "Resource owner", pilih akaun pengguna anda. +8. Di bawah "Repository access", pilih repositori yang anda mahu gunakan dengan Model GitHub (atau "All repositories" jika perlu). +9. Di bawah "Account permissions", cari **Models** dan tetapkan kepada **Read-only**. +10. Klik **Generate token**. +11. **Salin dan simpan token anda sekarang** – anda tidak akan melihatnya lagi! + +> **Petua Keselamatan**: Gunakan skop minimum yang diperlukan dan tempoh luput paling singkat yang praktikal untuk token akses anda. + +## Langkah 3: Uji Persediaan Anda dengan Contoh Model GitHub + +Setelah persekitaran pembangunan anda sedia, mari uji integrasi Model GitHub dengan aplikasi contoh kami dalam [`02-SetupDevEnvironment/examples/github-models`](../../../02-SetupDevEnvironment/examples/github-models). + +1. Buka terminal dalam persekitaran pembangunan anda. +2. Navigasi ke contoh Model GitHub: + ```bash + cd 02-SetupDevEnvironment/examples/github-models + ``` +3. Tetapkan token GitHub anda sebagai pembolehubah persekitaran: + ```bash + # macOS/Linux + export GITHUB_TOKEN=your_token_here + + # Windows (Command Prompt) + set GITHUB_TOKEN=your_token_here + + # Windows (PowerShell) + $env:GITHUB_TOKEN="your_token_here" + ``` + +4. Jalankan aplikasi: + ```bash + mvn compile exec:java -Dexec.mainClass="com.example.githubmodels.App" + ``` + +Anda harus melihat output yang serupa dengan: +```text +Using model: gpt-4.1-nano +Sending request to GitHub Models... +Response: Hello World! +``` + +### Memahami Kod Contoh + +Pertama, mari fahami apa yang kita jalankan. Contoh di bawah `examples/github-models` menggunakan OpenAI Java SDK untuk sambung ke Model GitHub: + +**Apa yang kod ini lakukan:** +- **Menyambung** ke Model GitHub menggunakan token akses peribadi anda +- **Menghantar** mesej mudah "Say Hello World!" ke model AI +- **Menerima** dan memaparkan respons AI +- **Memastikan** persediaan anda berfungsi dengan betul + +**Kebergantungan Utama** (dalam `pom.xml`): +```xml + + com.openai + openai-java + 2.12.0 + +``` + +**Kod Utama** (`App.java`): +```java +// Sambungkan ke Model GitHub menggunakan OpenAI Java SDK +OpenAIClient client = OpenAIOkHttpClient.builder() + .apiKey(pat) + .baseUrl("https://models.inference.ai.azure.com") + .build(); + +// Cipta permintaan penyempurnaan perbualan +ChatCompletionCreateParams params = ChatCompletionCreateParams.builder() + .model(modelId) + .addSystemMessage("You are a concise assistant.") + .addUserMessage("Say Hello World!") + .build(); + +// Dapatkan respons AI +ChatCompletion response = client.chat().completions().create(params); +System.out.println("Response: " + response.choices().get(0).message().content().orElse("No response content")); +``` + +## Ringkasan + +Bagus! Kini anda sudah menyediakan segala-galanya: + +- Mencipta Token Akses Peribadi GitHub dengan kebenaran yang betul untuk akses model AI +- Menjalankan persekitaran pembangunan Java anda (sama ada Codespaces, bekas dev, atau tempatan) +- Menyambung ke Model GitHub menggunakan OpenAI Java SDK untuk pembangunan AI percuma +- Menguji semuanya berfungsi dengan contoh mudah yang berinteraksi dengan model AI + +## Langkah Seterusnya + +[Bab 3: Teknik Asas Generative AI](../03-CoreGenerativeAITechniques/README.md) + +## Menyelesaikan Masalah + +Ada masalah? Berikut adalah masalah biasa dan penyelesaiannya: + +- **Token tidak berfungsi?** + - Pastikan anda menyalin token sepenuhnya tanpa ruang tambahan + - Sahkan token ditetapkan dengan betul sebagai pembolehubah persekitaran + - Semak token mempunyai kebenaran yang betul (Models: Read-only) + +- **Maven tidak ditemui?** + - Jika menggunakan bekas dev/Codespaces, Maven harus sudah dipasang + - Untuk persediaan tempatan, pastikan Java 21+ dan Maven 3.9+ dipasang + - Cuba `mvn --version` untuk semak pemasangan + +- **Isu sambungan?** + - Semak sambungan internet anda + - Pastikan GitHub boleh dicapai dari rangkaian anda + - Pastikan anda tidak berada di belakang firewall yang menyekat titik akhir Model GitHub + +- **Bekas dev tidak bermula?** + - Pastikan Docker Desktop sedang berjalan (untuk pembangunan tempatan) + - Cuba bina semula bekas: `Ctrl+Shift+P` → "Dev Containers: Rebuild Container" + +- **Ralat kompilasi aplikasi?** + - Pastikan anda berada dalam direktori yang betul: `02-SetupDevEnvironment/examples/github-models` + - Cuba bersih dan bina semula: `mvn clean compile` + +> **Perlukan bantuan?**: Masih ada isu? Buka isu dalam repositori dan kami akan bantu anda. --- + +**Penafian**: +Dokumen ini telah diterjemahkan menggunakan perkhidmatan terjemahan AI [Co-op Translator](https://github.com/Azure/co-op-translator). Walaupun kami berusaha untuk mencapai ketepatan, sila ambil perhatian bahawa terjemahan automatik mungkin mengandungi kesilapan atau ketidaktepatan. Dokumen asal dalam bahasa asalnya hendaklah dianggap sebagai sumber yang sahih. Untuk maklumat penting, terjemahan profesional oleh manusia adalah disyorkan. Kami tidak bertanggungjawab atas sebarang salah faham atau salah tafsir yang timbul daripada penggunaan terjemahan ini. + \ No newline at end of file diff --git a/translations/ms/02-SetupDevEnvironment/examples/basic-chat-azure/README.md b/translations/ms/02-SetupDevEnvironment/examples/basic-chat-azure/README.md index 788d2acf..3a8dfb58 100644 --- a/translations/ms/02-SetupDevEnvironment/examples/basic-chat-azure/README.md +++ b/translations/ms/02-SetupDevEnvironment/examples/basic-chat-azure/README.md @@ -1,12 +1,3 @@ - # Contoh Asas Chat dengan Azure OpenAI - End-to-End Contoh ini menunjukkan cara untuk mencipta aplikasi Spring Boot yang mudah, yang berhubung dengan Azure OpenAI dan menguji tetapan anda. diff --git a/translations/ms/02-SetupDevEnvironment/getting-started-azure-openai.md b/translations/ms/02-SetupDevEnvironment/getting-started-azure-openai.md index 871e5f6e..a9d8e099 100644 --- a/translations/ms/02-SetupDevEnvironment/getting-started-azure-openai.md +++ b/translations/ms/02-SetupDevEnvironment/getting-started-azure-openai.md @@ -1,12 +1,3 @@ - # Menyediakan Persekitaran Pembangunan untuk Azure OpenAI > **Permulaan Pantas**: Panduan ini adalah untuk persediaan Azure OpenAI. Untuk memulakan dengan model percuma, gunakan [GitHub Models with Codespaces](./README.md#quick-start-cloud). diff --git a/translations/ms/03-CoreGenerativeAITechniques/README.md b/translations/ms/03-CoreGenerativeAITechniques/README.md index 955d32ab..43142a4c 100644 --- a/translations/ms/03-CoreGenerativeAITechniques/README.md +++ b/translations/ms/03-CoreGenerativeAITechniques/README.md @@ -1,12 +1,3 @@ - # Tutorial Teknik Teras AI Generatif ## Kandungan diff --git a/translations/ms/04-PracticalSamples/README.md b/translations/ms/04-PracticalSamples/README.md index 5b022311..efc62d0b 100644 --- a/translations/ms/04-PracticalSamples/README.md +++ b/translations/ms/04-PracticalSamples/README.md @@ -1,12 +1,3 @@ - # Aplikasi Praktikal & Projek ## Apa Yang Akan Anda Pelajari diff --git a/translations/ms/04-PracticalSamples/calculator/README.md b/translations/ms/04-PracticalSamples/calculator/README.md index ed4c7590..ba2e6bdd 100644 --- a/translations/ms/04-PracticalSamples/calculator/README.md +++ b/translations/ms/04-PracticalSamples/calculator/README.md @@ -1,12 +1,3 @@ - # Tutorial MCP Calculator untuk Pemula ## Kandungan diff --git a/translations/ms/04-PracticalSamples/foundrylocal/README.md b/translations/ms/04-PracticalSamples/foundrylocal/README.md index 1718a4cb..684c5717 100644 --- a/translations/ms/04-PracticalSamples/foundrylocal/README.md +++ b/translations/ms/04-PracticalSamples/foundrylocal/README.md @@ -1,12 +1,3 @@ - # Tutorial Spring Boot Tempatan Foundry ## Kandungan diff --git a/translations/ms/04-PracticalSamples/petstory/README.md b/translations/ms/04-PracticalSamples/petstory/README.md index 7b96d21c..9dc107bf 100644 --- a/translations/ms/04-PracticalSamples/petstory/README.md +++ b/translations/ms/04-PracticalSamples/petstory/README.md @@ -1,12 +1,3 @@ - # Tutorial Penjana Cerita Haiwan Peliharaan untuk Pemula ## Kandungan diff --git a/translations/ms/05-ResponsibleGenAI/README.md b/translations/ms/05-ResponsibleGenAI/README.md index 10ec53fe..6bc5f7f3 100644 --- a/translations/ms/05-ResponsibleGenAI/README.md +++ b/translations/ms/05-ResponsibleGenAI/README.md @@ -1,12 +1,3 @@ - # AI Generatif yang Bertanggungjawab ## Apa yang Akan Anda Pelajari diff --git a/translations/ms/AGENTS.md b/translations/ms/AGENTS.md index 00ed3f9e..befc2a31 100644 --- a/translations/ms/AGENTS.md +++ b/translations/ms/AGENTS.md @@ -1,12 +1,3 @@ - # AGENTS.md ## Gambaran Projek diff --git a/translations/ms/CODE_OF_CONDUCT.md b/translations/ms/CODE_OF_CONDUCT.md index ed245937..44483b7c 100644 --- a/translations/ms/CODE_OF_CONDUCT.md +++ b/translations/ms/CODE_OF_CONDUCT.md @@ -1,12 +1,3 @@ - # Kod Etika Sumber Terbuka Microsoft Projek ini telah mengguna pakai [Kod Etika Sumber Terbuka Microsoft](https://opensource.microsoft.com/codeofconduct/). diff --git a/translations/ms/README.md b/translations/ms/README.md index 1949f5fe..321770ff 100644 --- a/translations/ms/README.md +++ b/translations/ms/README.md @@ -1,90 +1,81 @@ - -# AI Generatif untuk Pemula - Edisi Java +# Generative AI untuk Pemula - Edisi Java [![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) -![AI Generatif untuk Pemula - Edisi Java](../../translated_images/ms/beg-genai-series.8b48be9951cc574c.webp) +![Generative AI untuk Pemula - Edisi Java](../../translated_images/ms/beg-genai-series.8b48be9951cc574c.webp) -**Komitmen Masa**: Keseluruhan bengkel boleh diselesaikan secara dalam talian tanpa persediaan tempatan. Persediaan persekitaran mengambil masa 2 minit, dengan meneroka contoh memerlukan 1-3 jam bergantung kepada kedalaman penerokaan. +**Komitmen Masa**: Keseluruhan bengkel boleh diselesaikan secara dalam talian tanpa penyediaan tempatan. Penyediaan persekitaran mengambil masa 2 minit, dengan meneroka sampel memerlukan 1-3 jam bergantung pada kedalaman penerokaan. -> **Mula Cepat** +> **Mula dengan Pantas** 1. Fork repositori ini ke akaun GitHub anda 2. Klik **Code** → tab **Codespaces** → **...** → **New with options...** -3. Gunakan nilai lalai – ini akan memilih bekas Pembangunan yang dibuat untuk kursus ini +3. Gunakan tetapan lalai – ini akan memilih bekas Pembangunan yang dicipta untuk kursus ini 4. Klik **Create codespace** -5. Tunggu kira-kira 2 minit untuk persekitaran bersedia +5. Tunggu ~2 minit supaya persekitaran sedia 6. Teruskan ke [Contoh pertama](./02-SetupDevEnvironment/README.md#step-2-create-a-github-personal-access-token) > **Lebih Suka Clone Secara Tempatan?** - -> Repositori ini termasuk lebih 50 terjemahan bahasa yang meningkatkan saiz muat turun dengan ketara. Untuk clone tanpa terjemahan, gunakan sparse checkout: +> +> Repositori ini termasuk lebih 50 terjemahan bahasa yang secara signifikan meningkatkan saiz muat turun. Untuk clone tanpa terjemahan, gunakan sparse checkout: > ```bash > git clone --filter=blob:none --sparse https://github.com/microsoft/Generative-AI-for-beginners-java.git > cd Generative-AI-for-beginners-java > git sparse-checkout set --no-cone '/*' '!translations' '!translated_images' > ``` -> Ini memberikan semua yang anda perlukan untuk menyelesaikan kursus dengan muat turun yang jauh lebih pantas. +> Ini memberi anda segala yang diperlukan untuk menyelesaikan kursus dengan muat turun yang jauh lebih pantas. -## Sokongan Multi-Bahasa +## Sokongan Pelbagai Bahasa -### Disokong melalui Tindakan GitHub (Automatik & Sentiasa Terkini) +### Disokong melalui GitHub Action (Automatik & Sentiasa Dikemas Kini) -[Arab](../ar/README.md) | [Benggali](../bn/README.md) | [Bulgaria](../bg/README.md) | [Burma (Myanmar)](../my/README.md) | [Cina (Ringkas)](../zh/README.md) | [Cina (Tradisional, Hong Kong)](../hk/README.md) | [Cina (Tradisional, Macau)](../mo/README.md) | [Cina (Tradisional, Taiwan)](../tw/README.md) | [Kroasia](../hr/README.md) | [Ceko](../cs/README.md) | [Denmark](../da/README.md) | [Belanda](../nl/README.md) | [Estonia](../et/README.md) | [Finland](../fi/README.md) | [Perancis](../fr/README.md) | [Jerman](../de/README.md) | [Greek](../el/README.md) | [Ibrani](../he/README.md) | [Hindi](../hi/README.md) | [Hungary](../hu/README.md) | [Indonesia](../id/README.md) | [Itali](../it/README.md) | [Jepun](../ja/README.md) | [Kannada](../kn/README.md) | [Korea](../ko/README.md) | [Lithuania](../lt/README.md) | [Melayu](./README.md) | [Malayalam](../ml/README.md) | [Marathi](../mr/README.md) | [Nepali](../ne/README.md) | [Pidgin Nigeria](../pcm/README.md) | [Norwegia](../no/README.md) | [Parsi (Farsi)](../fa/README.md) | [Poland](../pl/README.md) | [Portugis (Brazil)](../br/README.md) | [Portugis (Portugal)](../pt/README.md) | [Punjabi (Gurmukhi)](../pa/README.md) | [Romania](../ro/README.md) | [Rusia](../ru/README.md) | [Serbia (Sirilik)](../sr/README.md) | [Slovak](../sk/README.md) | [Slovenia](../sl/README.md) | [Sepanyol](../es/README.md) | [Swahili](../sw/README.md) | [Sweden](../sv/README.md) | [Tagalog (Filipina)](../tl/README.md) | [Tamil](../ta/README.md) | [Telugu](../te/README.md) | [Thai](../th/README.md) | [Turki](../tr/README.md) | [Ukraine](../uk/README.md) | [Urdu](../ur/README.md) | [Vietnam](../vi/README.md) +[Arab](../ar/README.md) | [Bengali](../bn/README.md) | [Bulgaria](../bg/README.md) | [Burma (Myanmar)](../my/README.md) | [Cina (Ringkas)](../zh-CN/README.md) | [Cina (Tradisional, Hong Kong)](../zh-HK/README.md) | [Cina (Tradisional, Macau)](../zh-MO/README.md) | [Cina (Tradisional, Taiwan)](../zh-TW/README.md) | [Kroasia](../hr/README.md) | [Ceko](../cs/README.md) | [Denmark](../da/README.md) | [Belanda](../nl/README.md) | [Estonia](../et/README.md) | [Finland](../fi/README.md) | [Perancis](../fr/README.md) | [Jerman](../de/README.md) | [Greek](../el/README.md) | [Ibrani](../he/README.md) | [Hindi](../hi/README.md) | [Hungary](../hu/README.md) | [Indonesia](../id/README.md) | [Itali](../it/README.md) | [Jepun](../ja/README.md) | [Kannada](../kn/README.md) | [Korea](../ko/README.md) | [Lithuania](../lt/README.md) | [Melayu](./README.md) | [Malayalam](../ml/README.md) | [Marathi](../mr/README.md) | [Nepali](../ne/README.md) | [Pidgin Nigeria](../pcm/README.md) | [Norwegia](../no/README.md) | [Parsi (Farsi)](../fa/README.md) | [Poland](../pl/README.md) | [Portugis (Brazil)](../pt-BR/README.md) | [Portugis (Portugal)](../pt-PT/README.md) | [Punjabi (Gurmukhi)](../pa/README.md) | [Romania](../ro/README.md) | [Rusia](../ru/README.md) | [Serbia (Cyrillic)](../sr/README.md) | [Slovakia](../sk/README.md) | [Slovenia](../sl/README.md) | [Sepanyol](../es/README.md) | [Swahili](../sw/README.md) | [Sweden](../sv/README.md) | [Tagalog (Filipina)](../tl/README.md) | [Tamil](../ta/README.md) | [Telugu](../te/README.md) | [Thai](../th/README.md) | [Turki](../tr/README.md) | [Ukraine](../uk/README.md) | [Urdu](../ur/README.md) | [Vietnam](../vi/README.md) > **Lebih Suka Clone Secara Tempatan?** -> Repositori ini termasuk lebih 50 terjemahan bahasa yang meningkatkan saiz muat turun dengan ketara. Untuk clone tanpa terjemahan, gunakan sparse checkout: +> Repositori ini termasuk lebih 50 terjemahan bahasa yang secara signifikan meningkatkan saiz muat turun. Untuk clone tanpa terjemahan, gunakan sparse checkout: > ```bash > git clone --filter=blob:none --sparse https://github.com/microsoft/Generative-AI-for-beginners-java.git > cd Generative-AI-for-beginners-java > git sparse-checkout set --no-cone '/*' '!translations' '!translated_images' > ``` -> Ini memberikan semua yang anda perlukan untuk menyelesaikan kursus dengan muat turun yang jauh lebih pantas. +> Ini memberi anda segala yang diperlukan untuk menyelesaikan kursus dengan muat turun yang jauh lebih pantas. ## Struktur Kursus & Laluan Pembelajaran -### **Bab 1: Pengenalan kepada AI Generatif** -- **Konsep Teras**: Memahami Model Bahasa Besar, token, embeddings, dan kebolehan AI -- **Ekosistem AI Java**: Gambaran keseluruhan Spring AI dan OpenAI SDK +### **Bab 1: Pengenalan kepada Generative AI** +- **Konsep Teras**: Memahami Model Bahasa Besar, token, embedding, dan keupayaan AI +- **Ekosistem AI Java**: Gambaran keseluruhan Spring AI dan SDK OpenAI - **Protokol Konteks Model**: Pengenalan MCP dan peranannya dalam komunikasi agen AI - **Aplikasi Praktikal**: Senario dunia sebenar termasuk chatbot dan penjanaan kandungan - **[→ Mula Bab 1](./01-IntroToGenAI/README.md)** -### **Bab 2: Persediaan Persekitaran Pembangunan** -- **Konfigurasi Multi-Penyedia**: Sediakan Model GitHub, Azure OpenAI, dan integrasi OpenAI Java SDK +### **Bab 2: Penyediaan Persekitaran Pembangunan** +- **Konfigurasi Pelbagai Penyedia**: Sediakan Model GitHub, Azure OpenAI, dan integrasi OpenAI Java SDK - **Spring Boot + Spring AI**: Amalan terbaik untuk pembangunan aplikasi AI perusahaan -- **Model GitHub**: Akses model AI percuma untuk prototaip dan pembelajaran (tidak memerlukan kad kredit) +- **Model GitHub**: Akses model AI percuma untuk prototaip dan pembelajaran (tiada kad kredit diperlukan) - **Alat Pembangunan**: Bekas Docker, VS Code, dan konfigurasi GitHub Codespaces - **[→ Mula Bab 2](./02-SetupDevEnvironment/README.md)** -### **Bab 3: Teknik Teras AI Generatif** +### **Bab 3: Teknik Teras Generative AI** - **Reka Bentuk Prompt**: Teknik untuk respons model AI yang optimum -- **Embeddings & Operasi Vektor**: Laksanakan carian semantik dan pemadanan kesamaan -- **Retrieval-Augmented Generation (RAG)**: Gabungkan AI dengan sumber data anda sendiri -- **Panggilan Fungsi**: Luaskan keupayaan AI dengan alat tersuai dan plugin +- **Embedding & Operasi Vektor**: Laksanakan carian semantik dan padanan kesamaan +- **Generasi Dipertingkatkan Pemulihan (RAG)**: Gabungkan AI dengan sumber data anda sendiri +- **Panggilan Fungsi**: Luaskan keupayaan AI dengan alat dan plugin tersuai - **[→ Mula Bab 3](./03-CoreGenerativeAITechniques/README.md)** -### **Bab 4: Aplikasi & Projek Praktikal** +### **Bab 4: Aplikasi Praktikal & Projek** - **Penjana Cerita Haiwan Peliharaan** (`petstory/`): Penjanaan kandungan kreatif dengan Model GitHub - **Demo Foundry Tempatan** (`foundrylocal/`): Integrasi model AI tempatan dengan OpenAI Java SDK -- **Perkhidmatan Kalkulator MCP** (`calculator/`): Pelaksanaan asas Model Context Protocol dengan Spring AI +- **Perkhidmatan Kalkulator MCP** (`calculator/`): Pelaksanaan asas Protokol Konteks Model dengan Spring AI - **[→ Mula Bab 4](./04-PracticalSamples/README.md)** ### **Bab 5: Pembangunan AI Bertanggungjawab** -- **Keselamatan Model GitHub**: Uji penapisan kandungan terbina dalam dan mekanisme keselamatan (blok keras dan penolakan lembut) +- **Keselamatan Model GitHub**: Uji penapisan kandungan terbina dan mekanisme keselamatan (sekat keras dan penolakan lembut) - **Demo AI Bertanggungjawab**: Contoh praktikal menunjukkan bagaimana sistem keselamatan AI moden berfungsi -- **Amalan Terbaik**: Garis panduan penting untuk pembangunan dan penyebaran AI yang etikal +- **Amalan Terbaik**: Panduan penting untuk pembangunan dan pelaksanaan AI yang beretika - **[→ Mula Bab 5](./05-ResponsibleGenAI/README.md)** ## Sumber Tambahan @@ -104,44 +95,45 @@ CO_OP_TRANSLATOR_METADATA: --- -### Siri AI Generatif -[![AI Generatif untuk Pemula](https://img.shields.io/badge/Generative%20AI%20for%20Beginners-8B5CF6?style=for-the-badge&labelColor=E5E7EB&color=8B5CF6)](https://github.com/microsoft/generative-ai-for-beginners?WT.mc_id=academic-105485-koreyst) -[![AI Generatif (.NET)](https://img.shields.io/badge/Generative%20AI%20(.NET)-9333EA?style=for-the-badge&labelColor=E5E7EB&color=9333EA)](https://github.com/microsoft/Generative-AI-for-beginners-dotnet?WT.mc_id=academic-105485-koreyst) -[![AI Generatif (Java)](https://img.shields.io/badge/Generative%20AI%20(Java)-C084FC?style=for-the-badge&labelColor=E5E7EB&color=C084FC)](https://github.com/microsoft/generative-ai-for-beginners-java?WT.mc_id=academic-105485-koreyst) -[![AI Generatif (JavaScript)](https://img.shields.io/badge/Generative%20AI%20(JavaScript)-E879F9?style=for-the-badge&labelColor=E5E7EB&color=E879F9)](https://github.com/microsoft/generative-ai-with-javascript?WT.mc_id=academic-105485-koreyst) +### Siri Generative AI +[![Generative AI untuk Pemula](https://img.shields.io/badge/Generative%20AI%20for%20Beginners-8B5CF6?style=for-the-badge&labelColor=E5E7EB&color=8B5CF6)](https://github.com/microsoft/generative-ai-for-beginners?WT.mc_id=academic-105485-koreyst) +[![Generative AI (.NET)](https://img.shields.io/badge/Generative%20AI%20(.NET)-9333EA?style=for-the-badge&labelColor=E5E7EB&color=9333EA)](https://github.com/microsoft/Generative-AI-for-beginners-dotnet?WT.mc_id=academic-105485-koreyst) +[![Generative AI (Java)](https://img.shields.io/badge/Generative%20AI%20(Java)-C084FC?style=for-the-badge&labelColor=E5E7EB&color=C084FC)](https://github.com/microsoft/generative-ai-for-beginners-java?WT.mc_id=academic-105485-koreyst) +[![Generative AI (JavaScript)](https://img.shields.io/badge/Generative%20AI%20(JavaScript)-E879F9?style=for-the-badge&labelColor=E5E7EB&color=E879F9)](https://github.com/microsoft/generative-ai-with-javascript?WT.mc_id=academic-105485-koreyst) --- ### Pembelajaran Teras [![ML untuk Pemula](https://img.shields.io/badge/ML%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=22C55E)](https://aka.ms/ml-beginners?WT.mc_id=academic-105485-koreyst) -[![Sains Data untuk Pemula](https://img.shields.io/badge/Data%20Science%20for%20Beginners-84CC16?style=for-the-badge&labelColor=E5E7EB&color=84CC16)](https://aka.ms/datascience-beginners?WT.mc_id=academic-105485-koreyst) +[![Data Sains untuk Pemula](https://img.shields.io/badge/Data%20Science%20for%20Beginners-84CC16?style=for-the-badge&labelColor=E5E7EB&color=84CC16)](https://aka.ms/datascience-beginners?WT.mc_id=academic-105485-koreyst) [![AI untuk Pemula](https://img.shields.io/badge/AI%20for%20Beginners-A3E635?style=for-the-badge&labelColor=E5E7EB&color=A3E635)](https://aka.ms/ai-beginners?WT.mc_id=academic-105485-koreyst) [![Keselamatan Siber untuk Pemula](https://img.shields.io/badge/Cybersecurity%20for%20Beginners-F97316?style=for-the-badge&labelColor=E5E7EB&color=F97316)](https://github.com/microsoft/Security-101?WT.mc_id=academic-96948-sayoung) -[![Pembangunan Web untuk Pemula](https://img.shields.io/badge/Web%20Dev%20for%20Beginners-EC4899?style=for-the-badge&labelColor=E5E7EB&color=EC4899)](https://aka.ms/webdev-beginners?WT.mc_id=academic-105485-koreyst) -[![IoT for Beginners](https://img.shields.io/badge/IoT%20for%20Beginners-14B8A6?style=for-the-badge&labelColor=E5E7EB&color=14B8A6)](https://aka.ms/iot-beginners?WT.mc_id=academic-105485-koreyst) -[![XR Development for Beginners](https://img.shields.io/badge/XR%20Development%20for%20Beginners-38BDF8?style=for-the-badge&labelColor=E5E7EB&color=38BDF8)](https://github.com/microsoft/xr-development-for-beginners?WT.mc_id=academic-105485-koreyst) + +[![Web Dev untuk Pemula](https://img.shields.io/badge/Web%20Dev%20for%20Beginners-EC4899?style=for-the-badge&labelColor=E5E7EB&color=EC4899)](https://aka.ms/webdev-beginners?WT.mc_id=academic-105485-koreyst) +[![IoT untuk Pemula](https://img.shields.io/badge/IoT%20for%20Beginners-14B8A6?style=for-the-badge&labelColor=E5E7EB&color=14B8A6)](https://aka.ms/iot-beginners?WT.mc_id=academic-105485-koreyst) +[![Pembangunan XR untuk Pemula](https://img.shields.io/badge/XR%20Development%20for%20Beginners-38BDF8?style=for-the-badge&labelColor=E5E7EB&color=38BDF8)](https://github.com/microsoft/xr-development-for-beginners?WT.mc_id=academic-105485-koreyst) --- ### Siri Copilot -[![Copilot for AI Paired Programming](https://img.shields.io/badge/Copilot%20for%20AI%20Paired%20Programming-FACC15?style=for-the-badge&labelColor=E5E7EB&color=FACC15)](https://aka.ms/GitHubCopilotAI?WT.mc_id=academic-105485-koreyst) -[![Copilot for C#/.NET](https://img.shields.io/badge/Copilot%20for%20C%23/.NET-FBBF24?style=for-the-badge&labelColor=E5E7EB&color=FBBF24)](https://github.com/microsoft/mastering-github-copilot-for-dotnet-csharp-developers?WT.mc_id=academic-105485-koreyst) -[![Copilot Adventure](https://img.shields.io/badge/Copilot%20Adventure-FDE68A?style=for-the-badge&labelColor=E5E7EB&color=FDE68A)](https://github.com/microsoft/CopilotAdventures?WT.mc_id=academic-105485-koreyst) +[![Copilot untuk Pengaturcaraan Berpasangan AI](https://img.shields.io/badge/Copilot%20for%20AI%20Paired%20Programming-FACC15?style=for-the-badge&labelColor=E5E7EB&color=FACC15)](https://aka.ms/GitHubCopilotAI?WT.mc_id=academic-105485-koreyst) +[![Copilot untuk C#/.NET](https://img.shields.io/badge/Copilot%20for%20C%23/.NET-FBBF24?style=for-the-badge&labelColor=E5E7EB&color=FBBF24)](https://github.com/microsoft/mastering-github-copilot-for-dotnet-csharp-developers?WT.mc_id=academic-105485-koreyst) +[![Pengembaraan Copilot](https://img.shields.io/badge/Copilot%20Adventure-FDE68A?style=for-the-badge&labelColor=E5E7EB&color=FDE68A)](https://github.com/microsoft/CopilotAdventures?WT.mc_id=academic-105485-koreyst) ## Mendapatkan Bantuan -Jika anda tersekat atau mempunyai sebarang pertanyaan mengenai membina aplikasi AI. Sertai para pelajar dan pembangun berpengalaman dalam perbincangan mengenai MCP. Ia adalah komuniti yang menyokong di mana soalan dialu-alukan dan pengetahuan dikongsi dengan bebas. +Jika anda tersekat atau mempunyai sebarang soalan tentang membina aplikasi AI. Sertai pelajar lain dan pembangun berpengalaman dalam perbincangan tentang MCP. Ia adalah komuniti yang menyokong di mana soalan dialu-alukan dan ilmu dikongsi dengan bebas. [![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) Jika anda mempunyai maklum balas produk atau ralat semasa membina, lawati: -[![Microsoft Foundry Developer Forum](https://img.shields.io/badge/GitHub-Microsoft_Foundry_Developer_Forum-blue?style=for-the-badge&logo=github&color=000000&logoColor=fff)](https://aka.ms/foundry/forum) +[![Forum Pembangun Microsoft Foundry](https://img.shields.io/badge/GitHub-Microsoft_Foundry_Developer_Forum-blue?style=for-the-badge&logo=github&color=000000&logoColor=fff)](https://aka.ms/foundry/forum) --- **Penafian**: -Dokumen ini telah diterjemahkan menggunakan perkhidmatan terjemahan AI [Co-op Translator](https://github.com/Azure/co-op-translator). Walaupun kami berusaha untuk ketepatan, sila ambil maklum bahawa terjemahan automatik mungkin mengandungi kesilapan atau ketidaktepatan. Dokumen asal dalam bahasa asalnya harus dianggap sebagai sumber yang sahih. Untuk maklumat penting, terjemahan profesional oleh manusia adalah disyorkan. Kami tidak bertanggungjawab atas sebarang salah faham atau salah tafsir yang timbul daripada penggunaan terjemahan ini. +Dokumen ini telah diterjemahkan menggunakan perkhidmatan terjemahan AI [Co-op Translator](https://github.com/Azure/co-op-translator). Walaupun kami berusaha untuk ketepatan, sila maklum bahawa terjemahan automatik mungkin mengandungi ralat atau ketidaktepatan. Dokumen asal dalam bahasa asalnya harus dianggap sebagai sumber rasmi. Untuk maklumat penting, terjemahan profesional oleh manusia adalah disyorkan. Kami tidak bertanggungjawab atas sebarang salah faham atau salah tafsir yang timbul daripada penggunaan terjemahan ini. \ No newline at end of file diff --git a/translations/ms/SECURITY.md b/translations/ms/SECURITY.md index 85c3fb94..7fa47134 100644 --- a/translations/ms/SECURITY.md +++ b/translations/ms/SECURITY.md @@ -1,12 +1,3 @@ - ## Keselamatan Microsoft mengambil serius keselamatan produk dan perkhidmatan perisian kami, termasuk semua repositori kod sumber yang diuruskan melalui organisasi GitHub kami, yang merangkumi [Microsoft](https://github.com/Microsoft), [Azure](https://github.com/Azure), [DotNet](https://github.com/dotnet), [AspNet](https://github.com/aspnet) dan [Xamarin](https://github.com/xamarin). diff --git a/translations/ms/SUPPORT.md b/translations/ms/SUPPORT.md index 17793347..8ff0c0e0 100644 --- a/translations/ms/SUPPORT.md +++ b/translations/ms/SUPPORT.md @@ -1,12 +1,3 @@ - # Sokongan ## Cara untuk melaporkan isu dan mendapatkan bantuan diff --git a/translations/my/.co-op-translator.json b/translations/my/.co-op-translator.json new file mode 100644 index 00000000..7f68634a --- /dev/null +++ b/translations/my/.co-op-translator.json @@ -0,0 +1,92 @@ +{ + "01-IntroToGenAI/README.md": { + "original_hash": "75bfb080ca725e8a9aa9c80cae25fba1", + "translation_date": "2025-07-29T10:28:10+00:00", + "source_file": "01-IntroToGenAI/README.md", + "language_code": "my" + }, + "02-SetupDevEnvironment/README.md": { + "original_hash": "96a30d42b9751a3d4e4b20e28d29d459", + "translation_date": "2026-01-28T05:28:25+00:00", + "source_file": "02-SetupDevEnvironment/README.md", + "language_code": "my" + }, + "02-SetupDevEnvironment/examples/basic-chat-azure/README.md": { + "original_hash": "efd82efe50711d7e257eb943151d682c", + "translation_date": "2025-07-27T13:48:57+00:00", + "source_file": "02-SetupDevEnvironment/examples/basic-chat-azure/README.md", + "language_code": "my" + }, + "02-SetupDevEnvironment/getting-started-azure-openai.md": { + "original_hash": "bfdb4b4eadbee3a59ef742439f58326a", + "translation_date": "2025-07-27T13:30:54+00:00", + "source_file": "02-SetupDevEnvironment/getting-started-azure-openai.md", + "language_code": "my" + }, + "03-CoreGenerativeAITechniques/README.md": { + "original_hash": "685f55cb07de19b52a30ce6e8b6d889e", + "translation_date": "2025-08-28T22:19:33+00:00", + "source_file": "03-CoreGenerativeAITechniques/README.md", + "language_code": "my" + }, + "04-PracticalSamples/README.md": { + "original_hash": "14c0a61ecc1cd2012a9c129236dfdf71", + "translation_date": "2025-07-29T10:27:48+00:00", + "source_file": "04-PracticalSamples/README.md", + "language_code": "my" + }, + "04-PracticalSamples/calculator/README.md": { + "original_hash": "b6c16b5514d524e415a94f6097ee7d4c", + "translation_date": "2025-09-18T15:44:12+00:00", + "source_file": "04-PracticalSamples/calculator/README.md", + "language_code": "my" + }, + "04-PracticalSamples/foundrylocal/README.md": { + "original_hash": "f787307400de59adc25a1404466a35f3", + "translation_date": "2025-11-04T07:37:10+00:00", + "source_file": "04-PracticalSamples/foundrylocal/README.md", + "language_code": "my" + }, + "04-PracticalSamples/petstory/README.md": { + "original_hash": "0cbf68d605615a1e602c832a24616859", + "translation_date": "2025-07-25T12:08:44+00:00", + "source_file": "04-PracticalSamples/petstory/README.md", + "language_code": "my" + }, + "05-ResponsibleGenAI/README.md": { + "original_hash": "301c05c2f57e60a6950b8c665b8bdbba", + "translation_date": "2025-07-29T16:01:26+00:00", + "source_file": "05-ResponsibleGenAI/README.md", + "language_code": "my" + }, + "AGENTS.md": { + "original_hash": "afc90918d008cf77fd1982691f681306", + "translation_date": "2025-10-03T08:45:50+00:00", + "source_file": "AGENTS.md", + "language_code": "my" + }, + "CODE_OF_CONDUCT.md": { + "original_hash": "442b123d034f92f7c384d2bbd28f99f1", + "translation_date": "2025-07-21T20:38:14+00:00", + "source_file": "CODE_OF_CONDUCT.md", + "language_code": "my" + }, + "README.md": { + "original_hash": "125a08948d881c95628094f4dd1fbd43", + "translation_date": "2026-01-29T16:19:58+00:00", + "source_file": "README.md", + "language_code": "my" + }, + "SECURITY.md": { + "original_hash": "57f14126c1c6add76b3aef3844dfe4e3", + "translation_date": "2025-07-21T20:36:37+00:00", + "source_file": "SECURITY.md", + "language_code": "my" + }, + "SUPPORT.md": { + "original_hash": "b8ef73cc49dec68e2c885ee9df545129", + "translation_date": "2025-07-21T20:39:24+00:00", + "source_file": "SUPPORT.md", + "language_code": "my" + } +} \ No newline at end of file diff --git a/translations/my/01-IntroToGenAI/README.md b/translations/my/01-IntroToGenAI/README.md index 5ca4f719..41bd64c2 100644 --- a/translations/my/01-IntroToGenAI/README.md +++ b/translations/my/01-IntroToGenAI/README.md @@ -1,12 +1,3 @@ - # Generative AI - Java Edition အကြောင်းအကျဉ်း ## သင်လေ့လာမည့်အရာများ diff --git a/translations/my/02-SetupDevEnvironment/README.md b/translations/my/02-SetupDevEnvironment/README.md index 6ef2e729..11cbf1fe 100644 --- a/translations/my/02-SetupDevEnvironment/README.md +++ b/translations/my/02-SetupDevEnvironment/README.md @@ -1,13 +1,251 @@ - +# Java အတွက် Generative AI အတွက် ဖွံ့ဖြိုးရေးပတ်ဝန်းကျင် တပ်ဆင်ခြင်း +> **အမြန်စတင်ရန်**: ၂ မိနစ်အတွင်း Cloud မှာ ကုဒ်ရေးပါ - [GitHub Codespaces Setup](../../../02-SetupDevEnvironment) ကို ရောက်ပါ - ဒါဟာ ဒေသတွင်း တပ်ဆင်မှုမလိုအပ်ဘဲ github မော်ဒယ်တွေကို အသုံးပြုပါတယ်! + +> **Azure OpenAI စိတ်ဝင်စားပါသလား?**, ကျွန်ုပ်တို့ရဲ့ [Azure OpenAI Setup Guide](getting-started-azure-openai.md) ကို ကြည့်ပါ၊ Azure OpenAI အရင်းအမြစ်အသစ် တည်ဆောက်ခြင်းအဆင့်များနှင့်အတူ။ + +## သင်ယူမည့်အရာများ + +- AI အပလီကေးရှင်းများအတွက် Java ဖွံ့ဖြိုးရေးပတ်ဝန်းကျင် တပ်ဆင်ခြင်း +- သင့်ကြိုက်နှစ်သက်ရာ ဖွံ့ဖြိုးရေးပတ်ဝန်းကျင်ကို (Codespaces နဲ့ cloud-first, ဒေသတွင်း dev container, ဒါမှမဟုတ် လုံးဝ ဒေသတွင်း ပတ်ဝန်းကျင်) ရွေးချယ်ပြီး အပြင်အဆင် ပြုလုပ်ခြင်း +- သင့်စနစ်ကို GitHub မော်ဒယ်များနှင့် တွဲဖက် စမ်းသပ်ခြင်း + +## အကြောင်းအရာဇယား + +- [သင်ယူမည့်အရာများ](../../../02-SetupDevEnvironment) +- [နိဒါန်း](../../../02-SetupDevEnvironment) +- [အဆင့် ၁: သင့်ဖွံ့ဖြိုးရေးပတ်ဝန်းကျင် တပ်ဆင်ခြင်း](../../../02-SetupDevEnvironment) + - [ရွေးချယ်မှု A: GitHub Codespaces (အကြံပြု)](../../../02-SetupDevEnvironment) + - [ရွေးချယ်မှု B: ဒေသတွင်း Dev Container](../../../02-SetupDevEnvironment) + - [ရွေးချယ်မှု C: သင့်ရှိပြီးသား ဒေသတွင်း တပ်ဆင်မှုကို အသုံးပြုရန်](../../../02-SetupDevEnvironment) +- [အဆင့် ၂: GitHub ကိုယ်ပိုင် Access Token ကို ဖန်တီးခြင်း](../../../02-SetupDevEnvironment) +- [အဆင့် ၃: သင့်စနစ်ကို စမ်းသပ်ခြင်း](../../../02-SetupDevEnvironment) +- [ပြဿနာဖြေရှင်းခြင်း](../../../02-SetupDevEnvironment) +- [အနှစ်ချုပ်](../../../02-SetupDevEnvironment) +- [နောက်တစ်ဆင့်များ](../../../02-SetupDevEnvironment) + +## နိဒါန်း + +ဒီအခန်းမှာ ဖွံ့ဖြိုးရေးပတ်ဝန်းကျင်တစ်ခုကို တပ်ဆင်ပုံကို လမ်းညွှန်ပါမယ်။ ကျွန်ုပ်တို့အတွက် အဓိက ဥပမာအနေနဲ့ **GitHub Models** ကို အသုံးပြုမှာဖြစ်ပြီး၊ ဒါဟာ အခမဲ့ ဖြစ်ပြီး GitHub အကောင့်တစ်ခုသာ လိုအပ်ပြီး ကုဒ်ကတ်မလိုအပ်၊ စမ်းသပ်နိုင်စွမ်းရှိတဲ့ မော်ဒယ်များစွာ အသုံးပြုခွင့်ရှိပါတယ်။ + +**ဒေသတွင်း တပ်ဆင်မှု မလိုအပ်ပါ!** GitHub Codespaces ကို အသုံးပြု၍ ဘရောက်ဇာတစ်ခုလုံးထဲမှာ အပြည့်အဝ ဖွံ့ဖြိုးရေးပတ်ဝန်းကျင် တစ်ခုရရှိနိုင်ပြီး ချက်ချင်း ကုဒ်ရေးသားနိုင်ပါတယ်။ + +Screenshot: GitHub Models + +ဒီသင်တန်းအတွက် [**GitHub Models**](https://github.com/marketplace?type=models) ကို အသုံးပြုခွင့် ပေးတာမှာ အောက်ပါအချက်တွေကြောင့် အကြံပြုပါတယ် – +- စတင်ဖို့ **အခမဲ့** +- GitHub အကောင့်တစ်ခုနဲ့ စတင်ဖို့ **လွယ်ကူ** +- **ကုဒ်ကတ် မလိုအပ်ပါ** +- စမ်းသပ်ရန် **မော်ဒယ်များစွာ** ရရှိနိုင် + +> **မှတ်ချက်**: ဒီသင်တန်းမှာ အသုံးပြုမယ့် GitHub Models များတွင် အခမဲ့ အကန့်အသတ်များမှာ: +> - မိနစ်တိုင်း ၁၅ ကြိမ် (တနေ့လျှင် ၁၅၀ ကြိမ်) +> - တစ်ချက်တည်းမှာ စာလုံး ~၈၀၀၀ ထည့်၊ ~၄၀၀၀ ထွက် +> - တပြိုင်နက် ၅ ချက်တင် +> +> ထုတ်လုပ်မှုအတွက် အသုံးပြုမယ်ဆို Azure AI Foundry Models ကို သင့် Azure အကောင့် နဲ့ ပြောင်းလဲသုံးရန်။ သင့်ကုဒ်ကို ပြောင်းလဲရန် မလိုအပ်ပါ။ [Azure AI Foundry စာရွက်စာတမ်း](https://learn.microsoft.com/azure/ai-foundry/foundry-models/how-to/quickstart-github-models) ကို ကြည့်ပါ။ + +## အဆင့် ၁: သင့်ဖွံ့ဖြိုးရေးပတ်ဝန်းကျင် တပ်ဆင်ခြင်း + + + +Generative AI for Java သင်တန်းအတွက် လိုအပ်တဲ့ ကိရိယာများအားလုံးပါရှိစေရန်၊ တပ်ဆင်ချိန်ကို လျော့နည်းစေရန် ကြိုတင်ပြင်ဆင်ထားတဲ့ ဖွံ့ဖြိုးရေး ကွန်တိန်နာတစ်ခုကို ဖန်တီးပေးထားပါတယ်။ သင့်နှစ်သက်ရာ ဖွံ့ဖြိုးရေးနည်းလမ်းကိုရွေးချယ်ပါ။ + +### ပတ်ဝန်းကျင် တပ်ဆင်မှု ရွေးချယ်မှုများ + +#### ရွေးချယ်မှု A: GitHub Codespaces (အကြံပြု) + +**၂ မိနစ်အတွင်း ကုဒ်ရေးသားစတင်နိုင်သည် - ဒေသတွင်း တပ်ဆင်မှု မလိုပါ!** + +1. ဤrepository ကို သင့် GitHub အကောင့်ထဲသို့ fork လုပ်ပါ + > **မှတ်ချက်**: မူလ config ကို ပြင်ချင်ပါက [Dev Container Configuration](../../../.devcontainer/devcontainer.json) ကို ကြည့်ပါ +2. **Code** → **Codespaces** tabs → **...** → **New with options...** ကိုနှိပ်ပါ +3. မူလထားပေးထားသည့် Dev container configuration ကို အသုံးပြုပါ – ဒီသင်တန်းအတွက် ဖန်တီးထားတဲ့ **Generative AI Java Development Environment** custom devcontainer ကို ရွေးပါ +4. **Create codespace** ကို နှိပ်ပါ +5. ပတ်ဝန်းကျင် ပြင်ဆင်မှု ပြီးမြောက်ရန် ~၂ မိနစ် ခဏစောင့်ပါ +6. [အဆင့် ၂: GitHub Token ဖန်တီးခြင်း](../../../02-SetupDevEnvironment) ထိ ရောက်ပါ + +Screenshot: Codespaces submenu + +Screenshot: New with options + +Screenshot: Create codespace options + +> **Codespaces ၏ အကျိုးကျေးဇူးများ**: +> - ဒေသတွင်း ထည့်သွင်းစရာ မလိုပါ +> - ဘရောက်ဇာရှိမည့် မည်သည့် စက်လည်း အလုပ်လုပ်နိုင်သည် +> - ကိရိယာများနှင့် အားလုံး ကြိုတင်ပြင်ဆင်ထားသည် +> - တစ်လလျှင် ကိုယ်ပိုင် အကောင့်များအတွက် ၆၀ နာရီ အခမဲ့ +> - စီမံခန့်ခွဲမှု အဆင်ပြေသော ပတ်ဝန်းကျင် + +#### ရွေးချယ်မှု B: ဒေသတွင်း Dev Container + +**Docker ထည့်သွင်း၍ ဒေသတွင်း ဖွံ့ဖြိုးသူများအတွက်** + +1. ဤ repository ကို သင့် ဒေသတွင်း စက်သို့ fork နှင့် clone လုပ်ပါ + > **မှတ်ချက်**: မူလ config ကို ပြင်ချင်ပါက [Dev Container Configuration](../../../.devcontainer/devcontainer.json) ကို ကြည့်ပါ +2. [Docker Desktop](https://www.docker.com/products/docker-desktop/) နှင့် [VS Code](https://code.visualstudio.com/) ကို ထည့်သွင်းပါ +3. VS Code မှာ [Dev Containers extension](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers) ကို ထည့်သွင်းပါ +4. Repository ဖိုလ်ဒါကို VS Code မှာ ဖွင့်ပါ +5. Prompt ဆိုင်ရာမှာ **Reopen in Container** ကိုနှိပ်ပါ (သို့မဟုတ် `Ctrl+Shift+P` → "Dev Containers: Reopen in Container" ကို သုံးပါ) +6. ကွန်တိန်နာ တည်ဆောက်ခြင်းနှင့် စတင်ခြင်း ပြီးမြောက်ရန် ခဏစောင့်ပါ +7. [အဆင့် ၂: GitHub Token ဖန်တီးခြင်း](../../../02-SetupDevEnvironment) ထိ ရောက်ပါ + +Screenshot: Dev container setup + +Screenshot: Dev container build complete + +#### ရွေးချယ်မှု C: သင့်ရှိပြီးသား ဒေသတွင်း တပ်ဆင်မှုကို အသုံးပြုရန် + +**ရှိပြီးသား Java ပတ်ဝန်းကျင်ဖြင့် ဖွံ့ဖြိုးသူများအတွက်** + +လိုအပ်ချက်များ: +- [Java 21+](https://www.oracle.com/java/technologies/javase/jdk21-archive-downloads.html) +- [Maven 3.9+](https://maven.apache.org/download.cgi) +- [VS Code](https://code.visualstudio.com) သို့မဟုတ် သင့်နှစ်သက်ရာ IDE + +အဆင့်များ: +1. ဤ repository ကို သင့် ဒေသတွင်းစက်သို့ clone လုပ်ပါ +2. သင့် IDE မှာ ပရောဂျက်ကို ဖွင့်ပါ +3. [အဆင့် ၂: GitHub Token ဖန်တီးခြင်း](../../../02-SetupDevEnvironment) ထိ ရောက်ပါ + +> **အကြံပြုချက်**: သင့်မှာ low-spec စက်ရှိပြီး local မှာ VS Code အသုံးပြုချင်လျှင် GitHub Codespaces ကို သုံးပါ။ ဒါမှတဆင့် သင့် local VS Code ကို cloud မှ Codespace နဲ့ ချိတ်ဆက်ပြီး အကောင်းဆုံးနှစ်ခုလုံးရရှိနိုင်ပါသည်။ + +Screenshot: created local devcontainer instance + +## အဆင့် ၂: GitHub ကိုယ်ပိုင် Access Token ဖန်တီးခြင်း + +1. [GitHub Settings](https://github.com/settings/profile) သို့ သွားရောက်ပြီး ကိုယ်ရေးအချက်အလက် မီနူးမှ **Settings** ကို ရွေးချယ်ပါ။ +2. ဘယ်ဘက်ဘားဆိုင်ကာနဲ့ **Developer settings** (အောက်ဆုံးတွင် တစ်ခါတစ်ရံရှိ) ကို နှိပ်ပါ။ +3. **Personal access tokens** အောက်မှ **Fine-grained tokens** (သို့မဟုတ် ဒီတိုက်ရိုက် [လင့်ခ်](https://github.com/settings/personal-access-tokens)) ကို နှိပ်ပါ။ +4. **Generate new token** ကို နှိပ်ပါ။ +5. "Token name" အောက်မှာ အဓိပ္ပာယ်ရှိတဲ့ နာမည်တစ်ခုရေးပါ (ဥပမာ `GenAI-Java-Course-Token`)။ +6. ကာလကုန်သေဆုံးရက် ရွေးချယ်ပါ (အကြံပြုချက်: လုံခြုံရေးအတွက် ၇ ရက်)။ +7. "Resource owner" အောက်မှာ သင့်အသုံးပြုသူ အကောင့်ကို ရွေးချယ်ပါ။ +8. "Repository access" မှာ GitHub Models နဲ့ အသုံးပြုမည့် repository များကို ရွေးပါ (သို့မဟုတ် လိုအပ်ပါက "All repositories")။ +9. "Account permissions" အောက်မှ **Models** ကို ရွေးပြီး **Read-only** သတ်မှတ်ပါ။ +10. **Generate token** ကို နှိပ်ပါ။ +11. **ယခု token ကို ကူးယူပြီး သိမ်းဆည်းပါ** – နောက်ထပ်မမြင်ရတော့ပါ။ + +> **လုံခြုံရေးအကြံပြုချက်**: သင့်ရဲ့ access token များအတွက် လိုအပ်သည့် scope နည်းဆုံးနဲ့ သုံးနိုင်သမျှ အတိုင်းဆုံး သတ်မှတ်ပါ။ + +## အဆင့် ၃: GitHub Models ဥပမာနဲ့ သင့်စနစ်ကို စမ်းသပ်ခြင်း + +ဖွံ့ဖြိုးရေးပတ်ဝန်းကျင် ပြင်ဆင်ပြီး ဖြစ်သောအခါ၊ GitHub Models ပေါင်းစပ်အသုံးပြုမှုကို [examples/github-models](../../../02-SetupDevEnvironment/examples/github-models) ထဲက ဥပမာအပလီကေးရှင်းဖြင့် စမ်းသပ်ကြည့်ပါ။ + +1. ဖွံ့ဖြိုးရေးပတ်ဝန်းကျင်ထဲမှာ terminal ကို ဖွင့်ပါ။ +2. GitHub Models ဥပမာ directory သို့ သွားပါ: + ```bash + cd 02-SetupDevEnvironment/examples/github-models + ``` +3. သင့် GitHub token ကို environment variable အနေနဲ့ သတ်မှတ်ပါ: + ```bash + # macOS/Linux + export GITHUB_TOKEN=your_token_here + + # Windows (Command Prompt) + set GITHUB_TOKEN=your_token_here + + # Windows (PowerShell) + $env:GITHUB_TOKEN="your_token_here" + ``` + +4. အပလီကေးရှင်းကို run ပါ: + ```bash + mvn compile exec:java -Dexec.mainClass="com.example.githubmodels.App" + ``` + +အောက်ပါအတိုင်း output ပြပါလိမ့်မယ်: +```text +Using model: gpt-4.1-nano +Sending request to GitHub Models... +Response: Hello World! +``` + +### ဥပမာကုဒ်ကို နားလည်ခြင်း + +ပထမဦးဆုံး၊ ကျွန်ုပ်တို့ အခု run လိုက်သော အရာကို နားလည်ကြည့်ပါ။ `examples/github-models` အောက်တာက ဥပမာဟာ OpenAI Java SDK ကို သုံးပြီး GitHub Models နဲ့ ချိတ်ဆက်တာဖြစ်ပါတယ်။ + +**ဒီကုဒ်ရဲ့ လုပ်ဆောင်ချက်များ:** +- ကိုယ်ပိုင် access token နဲ့ GitHub Models ကို **ချိတ်ဆက်သည်** +- AI မော်ဒယ်ထံသို့ “Say Hello World!” ဆိုတဲ့ စာသား ရိုးရှင်းတဲ့ စကားပို့သည် +- AI မှ ပြန်လာတဲ့ ဖြေကြားချက်ကို **လက်ခံနှင့် ပြသသည်** +- သင့်စနစ် တပ်ဆင်မှုမှန်ကန်မှုကို **စစ်ဆေးပါသည်** + +**အဓိက မူလ code မှာ ပါဝင်သော Dependency** (`pom.xml`): +```xml + + com.openai + openai-java + 2.12.0 + +``` + +**အဓိက ကုဒ်** (`App.java`): +```java +// OpenAI Java SDK ကို အသုံးပြု၍ GitHub မော်ဒယ်များနှင့် ချိတ်ဆက်ပါ +OpenAIClient client = OpenAIOkHttpClient.builder() + .apiKey(pat) + .baseUrl("https://models.inference.ai.azure.com") + .build(); + +// စကားဝိုင်း ပြီးဆုံးခြင်း တောင်းဆိုချက်ကို ဖန်တီးပါ +ChatCompletionCreateParams params = ChatCompletionCreateParams.builder() + .model(modelId) + .addSystemMessage("You are a concise assistant.") + .addUserMessage("Say Hello World!") + .build(); + +// AI တုံ့ပြန်မှုကို ရယူပါ +ChatCompletion response = client.chat().completions().create(params); +System.out.println("Response: " + response.choices().get(0).message().content().orElse("No response content")); +``` + +## အနှစ်ချုပ် + +ကောင်းမွန်သည်! သင့်မှာ အောက်ပါအရာအားလုံး ရှိပြီးသား ဖြစ်ပါပြီ – + +- AI မော်ဒယ် အသုံးပြုခွင့် အတွက် မှန်ကန်သော GitHub Personal Access Token ဖန်တီးပြီး +- Java ဖွံ့ဖြိုးရေး ပတ်ဝန်းကျင် တပ်ဆင်ထားပြီး (Codespaces, dev containers, ဒေသတွင်း လုံးဝ တပ်ဆင်မှု အနက်မှ မည်သည့်နည်းဖြင့်ဖြစ်စေ) +- OpenAI Java SDK ဖြင့် GitHub Models နဲ့ ချိတ်ဆက်ပြီး အခမဲ့ AI ဖွံ့ဖြိုးမှု ရရှိနိုင် +- AI မော်ဒယ်များနှင့် စကားပြောတဲ့ ရိုးရှင်းတဲ့ ဥပမာနဲ့ စမ်းသပ်ပြီး အလုပ်လုပ်မှုပြည့်စုံမှု စစ်ဆေးပြီး + +## နောက်တစ်ဆင့်များ + +[အခန်း ၃: Core Generative AI Techniques](../03-CoreGenerativeAITechniques/README.md) + +## ပြဿနာဖြေရှင်းခြင်း + +ပြဿနာတွေ ရင်ဆိုင်နေရင် အောက်ပါ ပြဿနာများနှင့် ဖြေရှင်းနည်းများကို ကြည့်ပါ- + +- **Token အလုပ်မလုပ်?** + - Token ကို အပြည့်အစုံ ကူးယူထားကြောင်း၊ ထူးခြားတဲ့ အနားဝန်း နေရာများ မပါဝင်ကြောင်း သေချာပါစေ + - Token ကို environment variable အနေနဲ့ မှန်ကန်စွာ သတ်မှတ်ထားကြောင်း စစ်ဆေးပါ + - Token permissions မဟုတ်ကြောင်းစစ်ပါ (Models: Read-only ဖြစ်သင့်သည်) + +- **Maven မတွေ့?** + - dev containers/Codespaces အသုံးပြုလျှင် Maven ကြိုတင် ထည့်သွင်းထားသည် + - ဒေသတွင်း တပ်ဆင်မှုတွင် Java 21+ နဲ့ Maven 3.9+ ထည့်သွင်းထားမှန်းစစ်ဆေးပါ + - `mvn --version` ဖြင့်ထည့်သွင်းမှုစစ်ဆေးပါ + +- **ချိတ်ဆက်မှု ပြဿနာ?** + - အင်တာနက်ချိတ်ဆက်မှု ရှိကြောင်း သေချာပါ + - GitHub ကို ကွန်ယက်မှ ဝင်ရောက်နိုင်ကြောင်း စစ်ဆေးပါ + - GitHub Models endpoint ကို ပိတ်ထားတဲ့ firewall မရှိကြောင်း ဖော်ပြပါ + +- **Dev container မစခင်ဘူး?** + - ဒေသတွင်း ဖွံ့ဖြိုးရေးအတွက် Docker Desktop အလုပ်လုပ်နေကြောင်း သေချာပါ + - Container ကို ပြန်လည်တည်ဆောက်ကြည့်ပါ: `Ctrl+Shift+P` → "Dev Containers: Rebuild Container" + +- **အပလီကေးရှင်း compile error?** + - မှန်ကန်တဲ့ ဒိုင်ရেকတရီတွင် ရှိကြောင်း စိစစ်ပါ: `02-SetupDevEnvironment/examples/github-models` + - `mvn clean compile` ဖြင့် သန့်ရှင်းရေးနှင့် ပြန်လည် တည်ဆောက်မှု လုပ်ပါ + +> **အကူအညီလိုပါသလား?**: ပြဿနာများ ရှိနေသေးလျှင် Repo မှာ issue ဖွင့်ပြီး ကျွန်ုပ်တို့ကူညီပေးပါမည်။ --- + +**တောင်းပန်ချက်**: +ဤစာတမ်းကို AI ဘာသာပြန်စနစ် [Co-op Translator](https://github.com/Azure/co-op-translator) အသုံးပြုပြီးဘာသာပြန်ထားပါသည်။ ကျွန်ုပ်တို့ သေချာမှန်ကန်မှုကို ကြိုးစားဆောင်ရွက်သော်လည်း၊ အလိုအလျောက်ဘာသာပြန်မှုများတွင် အမှားများ သို့မဟုတ် မမှန်ကန်မှုများ ပါဝင်နိုင်ကြောင်း သတိပြုရန်လိုအပ်ပါသည်။ မူလစာတမ်းကို မူရင်းဘာသာဖြင့် အဆင့်မြင့် အရင်းအမြစ်အဖြစ် ယူဆသင့်ပါသည်။ အရေးကြီးသည့် သတင်းအချက်အလက်များအတွက် ပရော်ဖက်ရှင်နယ် လူသားဘာသာပြန်သူ၏ ဘာသာပြန်ချက်ကို အကြံပြုပါသည်။ ဤဘာသာပြန်ချက်အသုံးပြုရာမှ ဖြစ်ပေါ်လာနိုင်သည့် နားလည်မှုမှားယွင်းမှုများနှင့် ဖော်ပြချက်များအတွက် ကျွန်ုပ်တို့ တာဝန်မယူပါ။ + \ No newline at end of file diff --git a/translations/my/02-SetupDevEnvironment/examples/basic-chat-azure/README.md b/translations/my/02-SetupDevEnvironment/examples/basic-chat-azure/README.md index 0b01da16..06f4d52a 100644 --- a/translations/my/02-SetupDevEnvironment/examples/basic-chat-azure/README.md +++ b/translations/my/02-SetupDevEnvironment/examples/basic-chat-azure/README.md @@ -1,12 +1,3 @@ - # Azure OpenAI နှင့် Basic Chat - အဆုံးမှအဆုံးအထိ နမူနာ ဒီနမူနာက Azure OpenAI နဲ့ ချိတ်ဆက်ပြီး သင့် setup ကို စမ်းသပ်နိုင်တဲ့ ရိုးရှင်းတဲ့ Spring Boot အက်ပ်လီကေးရှင်း တစ်ခုကို ဘယ်လို ဖန်တီးရမလဲ ပြသပေးမှာ ဖြစ်ပါတယ်။ diff --git a/translations/my/02-SetupDevEnvironment/getting-started-azure-openai.md b/translations/my/02-SetupDevEnvironment/getting-started-azure-openai.md index 35e2eb61..de2c1ce9 100644 --- a/translations/my/02-SetupDevEnvironment/getting-started-azure-openai.md +++ b/translations/my/02-SetupDevEnvironment/getting-started-azure-openai.md @@ -1,12 +1,3 @@ - # Azure OpenAI အတွက် Development Environment ကို Set Up လုပ်ခြင်း > **Quick Start**: ဒီလမ်းညွှန်ချက်က Azure OpenAI setup အတွက်ဖြစ်ပါတယ်။ အခမဲ့မော်ဒယ်များကို အမြန်စတင်လိုပါက [GitHub Models with Codespaces](./README.md#quick-start-cloud) ကို အသုံးပြုပါ။ diff --git a/translations/my/03-CoreGenerativeAITechniques/README.md b/translations/my/03-CoreGenerativeAITechniques/README.md index 0ecdacb5..cc845b39 100644 --- a/translations/my/03-CoreGenerativeAITechniques/README.md +++ b/translations/my/03-CoreGenerativeAITechniques/README.md @@ -1,12 +1,3 @@ - # Core Generative AI Techniques Tutorial ## အကြောင်းအရာများ diff --git a/translations/my/04-PracticalSamples/README.md b/translations/my/04-PracticalSamples/README.md index 3dfd190c..1a14439a 100644 --- a/translations/my/04-PracticalSamples/README.md +++ b/translations/my/04-PracticalSamples/README.md @@ -1,12 +1,3 @@ - # လက်တွေ့အသုံးချမှုများနှင့် ပရောဂျက်များ ## သင်လေ့လာမည့်အရာများ diff --git a/translations/my/04-PracticalSamples/calculator/README.md b/translations/my/04-PracticalSamples/calculator/README.md index d351fc8b..af802de6 100644 --- a/translations/my/04-PracticalSamples/calculator/README.md +++ b/translations/my/04-PracticalSamples/calculator/README.md @@ -1,12 +1,3 @@ - # MCP Calculator Tutorial for Beginners ## အကြောင်းအရာများ diff --git a/translations/my/04-PracticalSamples/foundrylocal/README.md b/translations/my/04-PracticalSamples/foundrylocal/README.md index b182717b..715351b4 100644 --- a/translations/my/04-PracticalSamples/foundrylocal/README.md +++ b/translations/my/04-PracticalSamples/foundrylocal/README.md @@ -1,12 +1,3 @@ - # Foundry Local Spring Boot Tutorial ## အကြောင်းအရာများ diff --git a/translations/my/04-PracticalSamples/petstory/README.md b/translations/my/04-PracticalSamples/petstory/README.md index 64d43c88..34192682 100644 --- a/translations/my/04-PracticalSamples/petstory/README.md +++ b/translations/my/04-PracticalSamples/petstory/README.md @@ -1,12 +1,3 @@ - # သင်ကြားမှုအတွက် စတင်သူများအတွက် အိမ်မွေးတိရစ္ဆာန်ပုံပြင် ဖန်တီးရေးစနစ် ## အကြောင်းအရာများ diff --git a/translations/my/05-ResponsibleGenAI/README.md b/translations/my/05-ResponsibleGenAI/README.md index fad1e3d0..955245fc 100644 --- a/translations/my/05-ResponsibleGenAI/README.md +++ b/translations/my/05-ResponsibleGenAI/README.md @@ -1,12 +1,3 @@ - # တာဝန်ရှိသော Generative AI ## သင်လေ့လာမည့်အရာများ diff --git a/translations/my/AGENTS.md b/translations/my/AGENTS.md index 8e64ac87..59477681 100644 --- a/translations/my/AGENTS.md +++ b/translations/my/AGENTS.md @@ -1,12 +1,3 @@ - # AGENTS.md ## ပရောဂျက်အကြောင်းအရာ diff --git a/translations/my/CODE_OF_CONDUCT.md b/translations/my/CODE_OF_CONDUCT.md index b78cf38a..4b302385 100644 --- a/translations/my/CODE_OF_CONDUCT.md +++ b/translations/my/CODE_OF_CONDUCT.md @@ -1,12 +1,3 @@ - # Microsoft Open Source Code of Conduct ဒီပရောဂျက်သည် [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/) ကို လက်ခံအသုံးပြုထားပါသည်။ diff --git a/translations/my/README.md b/translations/my/README.md index 9166271d..1526f6d3 100644 --- a/translations/my/README.md +++ b/translations/my/README.md @@ -1,92 +1,83 @@ - # Generative AI for Beginners - Java Edition [![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) ![Generative AI for Beginners - Java Edition](../../translated_images/my/beg-genai-series.8b48be9951cc574c.webp) -**အချိန်စွန့်မှု**: အလုပ်ရုံသင်တန်းတစ်ခုလုံးကို ဒေသဆိုင်ရာပြင်ဆင်မှုမလိုဘဲ အွန်လိုင်းတွင် ပြီးမြောက်နိုင်သည်။ ပတ်ဝန်းကျင်ရဲ့ပြင်ဆင်ခြင်းကို ၂ မိနစ်ယူပြီး နမူနာတွေကို လေ့လာဖို့မှာ ၁ မှ ၃ နာရီကြား ရှိနိုင်သည်။ +**အချိန်ဝန်ခံချက်**: စုပေါင်း အလုပ်ရုံဆွေးနွေးပွဲကို တိုက်ရိုက် ပြင်ပဖြစ်စေပြီး ဒေသတွင်း ပြင်ဆင်မှုမလိုအပ်ပါ။ ပတ်ဝန်းကျင်ပြင်ဆင်ခြင်း အချိန် ၂ မိနစ်ခန့် စေပြီး နမူနာများကို ရှာဖွေဖတ်ရှုရန် ၁-၃ နာရီ ကြာမြင့်နိုင်ပါသည်။ -> **လျင်မြန်စတင်ခြင်း** +> **လျင်မြန်စွာ စတင်ရန်** -1. ဤဂစ်ဟပ် လောကည်ကို သင့် GitHub အကောင့်သို့ Fork လုပ်ပါ။ -2. **Code** ကိုနှိပ်ပြီး → **Codespaces** tab → **...** → **New with options...** ကိုနှိပ်ပါ။ -3. ပုံမှန် များကိုအသုံးပြုပါ – ဤသည်မှာ ဒီသင်တန်းအတွက် ဖန်တီးထားသော Development container ကို ရွေးချယ်မည်ဖြစ်သည်။ -4. **Create codespace** ကိုနှိပ်ပါ။ -5. ပတ်ဝန်းကျင် အသင့်ဖြစ်ရန် ~၂ မိနစ် စောင့်ပါ။ -6. တိုက်ရိုက် [ပထမဥပမာ](./02-SetupDevEnvironment/README.md#step-2-create-a-github-personal-access-token) သို့ အက်​​ဇ်ပါ။ +1. ဤ repository ကို သင့် GitHub အကောင့်သို့ Fork လုပ်ပါ +2. **Code** → **Codespaces** tab → **...** → **New with options...** ကို နှိပ်ပါ +3. ပုံမှန်များကို အသုံးပြုပါ – ဒါဟာ ဒီသင်ခန်းစာအတွက် ဖန်တီးထားသော Development container ကို ရွေးချယ်ပေးပါလိမ့်မည် +4. **Create codespace** ကို နှိပ်ပါ +5. ပတ်ဝန်းကျင် ပြင်ဆင်မှုအတွက် ~၂ မိနစ် စောင့်ပါ +6. တိုက်ရိုက် [ပထမ ဥပမာ](./02-SetupDevEnvironment/README.md#step-2-create-a-github-personal-access-token) သို့ ခုန်ပါ -> **ဒေသဆိုင်ရာ ကို Clone လုပ်ချင်ပါသလား?** +> **ဒေသတွင်း မှ Cloning လုပ်ချင်ပါသလား?** > -> ဤဂစ်ဟပ် လောကည်တွင် ဘာသာစကား ၅၀ ကျော်ကို ထည့်သွင်းထားခြင်းကြောင့် ဒေါင်းလုဒ် အရွယ်အစား စုစုပေါင်း တိုးပွားသွားပါသည်။ ဘာသာပြန်ချက် မပါပါက ဆော့ပါက တိုတောင်းသော sparse checkout ကို အသုံးပြုပါ: +> ဤ repository သည် ဘာသာစကား ၅၀ ကျော် အပြန်အလှန်စာတမ်းများပါဝင်ပြီး ဒေါင်းလုဒ်အရွယ်အစားကို တော်တော်များများ တိုးမြှင့်သည်။ ဘာသာပြန်ချက်များမပါဝင်ဘဲ Clone လုပ်ရန် sparse checkout ကို အသုံးပြုပါ: > ```bash > git clone --filter=blob:none --sparse https://github.com/microsoft/Generative-AI-for-beginners-java.git > cd Generative-AI-for-beginners-java > git sparse-checkout set --no-cone '/*' '!translations' '!translated_images' > ``` -> သင်သင်တန်းကို အားလုံးပြီးမြောက်ရန်လိုအပ်သည့် အရာအားလုံးကောင်းမွန်စွာ ရရှိမည်ဖြစ်ပြီး ဒေါင်းလုဒ် လျင်မြန်ပါသည်။ +> ဒါက သင်ကောစီကို မြန်ဆန်စွာ ပြီးမြောက်နိုင်စေရန် လိုအပ်သည့် အရာအားလုံးကို ပေးပါသည်။ -## ဘာသာစကား မျိုးစုံ အထောက်အပံ့ +## ဘာသာစကား များစွာအတွက် ထောက်ပံ့မှု -### GitHub Action မှတဆင့် ထောက်ပံ့သည် (အလိုအလျောက် နှင့် အမြဲတမ်း အပ်ဒိတ်ဖြစ်နေသည်) +### GitHub Action မှတဆင့် ထောက်ပံ့သည် (အလိုအလျောက် & အမြဲသစ်လုံလောက်) -[Arabic](../ar/README.md) | [Bengali](../bn/README.md) | [Bulgarian](../bg/README.md) | [Burmese (Myanmar)](./README.md) | [Chinese (Simplified)](../zh/README.md) | [Chinese (Traditional, Hong Kong)](../hk/README.md) | [Chinese (Traditional, Macau)](../mo/README.md) | [Chinese (Traditional, Taiwan)](../tw/README.md) | [Croatian](../hr/README.md) | [Czech](../cs/README.md) | [Danish](../da/README.md) | [Dutch](../nl/README.md) | [Estonian](../et/README.md) | [Finnish](../fi/README.md) | [French](../fr/README.md) | [German](../de/README.md) | [Greek](../el/README.md) | [Hebrew](../he/README.md) | [Hindi](../hi/README.md) | [Hungarian](../hu/README.md) | [Indonesian](../id/README.md) | [Italian](../it/README.md) | [Japanese](../ja/README.md) | [Kannada](../kn/README.md) | [Korean](../ko/README.md) | [Lithuanian](../lt/README.md) | [Malay](../ms/README.md) | [Malayalam](../ml/README.md) | [Marathi](../mr/README.md) | [Nepali](../ne/README.md) | [Nigerian Pidgin](../pcm/README.md) | [Norwegian](../no/README.md) | [Persian (Farsi)](../fa/README.md) | [Polish](../pl/README.md) | [Portuguese (Brazil)](../br/README.md) | [Portuguese (Portugal)](../pt/README.md) | [Punjabi (Gurmukhi)](../pa/README.md) | [Romanian](../ro/README.md) | [Russian](../ru/README.md) | [Serbian (Cyrillic)](../sr/README.md) | [Slovak](../sk/README.md) | [Slovenian](../sl/README.md) | [Spanish](../es/README.md) | [Swahili](../sw/README.md) | [Swedish](../sv/README.md) | [Tagalog (Filipino)](../tl/README.md) | [Tamil](../ta/README.md) | [Telugu](../te/README.md) | [Thai](../th/README.md) | [Turkish](../tr/README.md) | [Ukrainian](../uk/README.md) | [Urdu](../ur/README.md) | [Vietnamese](../vi/README.md) +[Arabic](../ar/README.md) | [Bengali](../bn/README.md) | [Bulgarian](../bg/README.md) | [Burmese (Myanmar)](./README.md) | [Chinese (Simplified)](../zh-CN/README.md) | [Chinese (Traditional, Hong Kong)](../zh-HK/README.md) | [Chinese (Traditional, Macau)](../zh-MO/README.md) | [Chinese (Traditional, Taiwan)](../zh-TW/README.md) | [Croatian](../hr/README.md) | [Czech](../cs/README.md) | [Danish](../da/README.md) | [Dutch](../nl/README.md) | [Estonian](../et/README.md) | [Finnish](../fi/README.md) | [French](../fr/README.md) | [German](../de/README.md) | [Greek](../el/README.md) | [Hebrew](../he/README.md) | [Hindi](../hi/README.md) | [Hungarian](../hu/README.md) | [Indonesian](../id/README.md) | [Italian](../it/README.md) | [Japanese](../ja/README.md) | [Kannada](../kn/README.md) | [Korean](../ko/README.md) | [Lithuanian](../lt/README.md) | [Malay](../ms/README.md) | [Malayalam](../ml/README.md) | [Marathi](../mr/README.md) | [Nepali](../ne/README.md) | [Nigerian Pidgin](../pcm/README.md) | [Norwegian](../no/README.md) | [Persian (Farsi)](../fa/README.md) | [Polish](../pl/README.md) | [Portuguese (Brazil)](../pt-BR/README.md) | [Portuguese (Portugal)](../pt-PT/README.md) | [Punjabi (Gurmukhi)](../pa/README.md) | [Romanian](../ro/README.md) | [Russian](../ru/README.md) | [Serbian (Cyrillic)](../sr/README.md) | [Slovak](../sk/README.md) | [Slovenian](../sl/README.md) | [Spanish](../es/README.md) | [Swahili](../sw/README.md) | [Swedish](../sv/README.md) | [Tagalog (Filipino)](../tl/README.md) | [Tamil](../ta/README.md) | [Telugu](../te/README.md) | [Thai](../th/README.md) | [Turkish](../tr/README.md) | [Ukrainian](../uk/README.md) | [Urdu](../ur/README.md) | [Vietnamese](../vi/README.md) -> **ဒေသဆိုင်ရာ ကို Clone လုပ်ချင်ပါသလား?** +> **ဒေသတွင်း မှ Cloning လုပ်ချင်ပါသလား?** -> ဤဂစ်ဟပ် လောကည်တွင် ဘာသာစကား ၅၀ ကျော်ကို ထည့်သွင်းထားခြင်းကြောင့် ဒေါင်းလုဒ် အရွယ်အစား စုစုပေါင်း တိုးပွားသွားပါသည်။ ဘာသာပြန်ချက် မပါပါက ဆော့ပါက တိုတောင်းသော sparse checkout ကို အသုံးပြုပါ: +> ဤ repository သည် ဘာသာစကား ၅၀ ကျော် အပြန်အလှန်စာတမ်းများပါဝင်ပြီး ဒေါင်းလုဒ်အရွယ်အစားကို တော်တော်များများ တိုးမြှင့်သည်။ ဘာသာပြန်ချက်များမပါဝင်ဘဲ Clone လုပ်ရန် sparse checkout ကို အသုံးပြုပါ: > ```bash > git clone --filter=blob:none --sparse https://github.com/microsoft/Generative-AI-for-beginners-java.git > cd Generative-AI-for-beginners-java > git sparse-checkout set --no-cone '/*' '!translations' '!translated_images' > ``` -> သင်သင်တန်းကို အားလုံးပြီးမြောက်ရန်လိုအပ်သည့် အရာအားလုံးကောင်းမွန်စွာ ရရှိမည်ဖြစ်ပြီး ဒေါင်းလုဒ် လျင်မြန်ပါသည်။ +> ဒါက သင်ကောစီကို မြန်ဆန်စွာ ပြီးမြောက်နိုင်စေရန် လိုအပ်သည့် အရာအားလုံးကို ပေးပါသည်။ -## သင်တန်းဖွဲ့စည်းမှု & သင်ယူနည်းလမ်းကြောင်း - -### **အပိုင်း ၁: Generative AI အစိတ်အပိုင်း မိတ်ဆက်ခြင်း** -- **အခြေခံအယူအဆများ**: ကြီးမားသောဘာသာစကားမော်ဒယ်များ၊ tokens, embeddings နှင့် AI စွမ်းရည်များကို နားလည်ခြင်း -- **Java AI ပတ်ဝန်းကျင်**: Spring AI နှင့် OpenAI SDK များအကြောင်း အခြေခံ သိရှိခြင်း -- **Model Context Protocol**: MCP မိတ်ဆက်ခြင်းနှင့် AI အေးဂျင့်စာဆက်ဆံမှုတွင် အလုပ်လုပ်ပုံ -- **လက်တွေ့အသုံးချမှုများ**: စကားပြောခြင်းစက်များနှင့် တိုက်ရိုက် အကြောင်းအရာဖန်တီးခြင်းကဲ့သို့သော ကိစ္စရပ်များ -- **[→ အပိုင်း ၁ စတင်ရန်](./01-IntroToGenAI/README.md)** - -### **အပိုင်း ၂: ဖန်တီးရေးပတ်ဝန်းကျင် တည်ဆောက်ခြင်း** -- **မူလကျပါသော Provider များ ပေါင်းစပ်ခြင်း**: GitHub Models, Azure OpenAI နှင့် OpenAI Java SDK တို့ကို တပ်ဆင်ခြင်း -- **Spring Boot + Spring AI**: စီးပွားရေး AI အက်ပလီကေးရှင်း ဖန်တီးရာတွင် အကောင်းဆုံးလမ်းညွှန်ချက်များ -- **GitHub Models**: prototype များနှင့် သင်ယူရန်အတွက် အခမဲ့ AI မော်ဒယ် အသုံးပြုခွင့် (credit card မလိုအပ်ပါ) -- **ဖန်တီးရေးကိရိယာများ**: Docker containers, VS Code နှင့် GitHub Codespaces တပ်ဆင်မှုများ -- **[→ အပိုင်း ၂ စတင်ရန်](./02-SetupDevEnvironment/README.md)** - -### **အပိုင်း ၃: Core Generative AI နည်းပညာများ** -- **Prompt Engineering**: AI မော်ဒယ်တုံ့ပြန်မှုအတွက် ထိထိမိမိနည်းပညာများ -- **Embeddings & Vector လုပ်ဆောင်ခြင်းများ**: စာအဓိပ္ပာယ်ရှာဖွေရေးနှင့် ဆင်တူမှုကို တိုက်ဆိုင်စွာ လုပ်ဆောင်ခြင်း -- **Retrieval-Augmented Generation (RAG)**: သင့်ဒေတာအရင်းအမြစ်များဖြင့် AI ပေါင်းစပ်ခြင်း -- **Function Calling**: AI စွမ်းရည်များကို စိတ်ကြိုက်ကိရိယာများနှင့် plugin များဖြင့် ဖြည့်စည်းခြင်း -- **[→ အပိုင်း ၃ စတင်ရန်](./03-CoreGenerativeAITechniques/README.md)** - -### **အပိုင်း ၄: လက်တွေ့အသုံးချခြင်းများနှင့် ပြုလုပ်မှုများ** -- **ခွေးမွေးပုံပြောဆိုခြင်း ဖန်တီးစက်** (`petstory/`): GitHub Models ဖြင့် ဖန်တီးမှုအကြောင်းအရာများထုတ်ပေးခြင်း -- **Foundry Local Demo** (`foundrylocal/`): OpenAI Java SDK နှင့် ဒေသတွင်း AI မော်ဒယ် ပေါင်းစပ်ခြင်း -- **MCP ကိန်းဂဏန်းတွက်စက် စီမံခန့်ခွဲခြင်း** (`calculator/`): Model Context Protocol ရိုးရှင်းစွာ Spring AI ဖြင့် တပ်ဆင်ခြင်း -- **[→ အပိုင်း ၄ စတင်ရန်](./04-PracticalSamples/README.md)** - -### **အပိုင်း ၅: တာဝန်ယူရမည့် AI ဖန်တီးခြင်း** -- **GitHub Models ဘေးကင်းခြင်း**: အတွင်းတပ်ထားသော အကြောင်းအရာစစ်ထုတ်မှုနှင့် ဘေးကင်းမှုမှုစနစ်များ စမ်းသပ်ခြင်း (ခဲတံခွန်နှင့် နူးညံ့သောစနစ်များ) -- **တာဝန်ယူမှု AI အသုံးပြုမှု စမ်းသပ်မှု**: မှီဝဲဆက်ဆံမှု အမှုဖေါ်ပြချက် များ -- **အကောင်းဆုံး လမ်းညွှန်ချက်များ**: တာဝန်ယူမှု AI ဖန်တီးခြင်းနှင့် ထုတ်လွှင့်ခြင်းအတွက် မရှိမဖြစ်လိုအပ်သော ညွှန်ကြားချက်များ -- **[→ အပိုင်း ၅ စတင်ရန်](./05-ResponsibleGenAI/README.md)** - -## အပိုဆောင်း ရင်းမြစ်များ +## သင်ခန်းစာ ဖွဲ့စည်းမှု & သင်ယူနိုင်ရာ လမ်းညွှန် + +### **ပိုင်း ၁: Generative AI မိတ်ဆက်ခြင်း** +- **အခြေခံအယူအဆများ**: အကြီးစားဘာသာစကားမော်ဒယ်များကို နားလည်ခြင်း၊ tokens, embeddings နှင့် AI လုပ်ဆောင်နိုင်စွမ်းများ +- **Java AI ပတ်ဝန်းကျင်**: Spring AI နှင့် OpenAI SDK များ အကြောင်းအရာ +- **Model Context Protocol**: MCP နှင့် AI ကိုယ်စားလှယ်များ ဆက်သွယ်မှုအတွက် မိတ်ဆက်ခြင်း +- **လက်တွေ့လျောက်ထားမှုများ**: ဒီဇိုင်း ဆွဲရေးစနစ်များပါဝင်သည့် ရှေ့ပြေးအခြေအနေများ (chatbots, အကြောင်းအရာဖန်တီးမှု) +- **[→ ပထမပိုင်း စတင်ရန်](./01-IntroToGenAI/README.md)** + +### **ပိုင်း ၂: ဖွံ့ဖြိုးရေး ပတ်ဝန်းကျင် ပြင်ဆင်ခြင်း** +- **Multi-Provider ဖွဲ့စည်းမှု**: GitHub Models, Azure OpenAI, နှင့် OpenAI Java SDK တွဲဖက် အသုံးပြုခြင်း +- **Spring Boot + Spring AI**: လုပ်ငန်းအသုံး AI application ဖွံ့ဖြိုးမှုအတွက် အကောင်းဆုံး အကျင့် +- **GitHub Models**: စမ်းသပ်မှုနှင့် သင်ယူမှုအတွက် အခမဲ့ AI မော်ဒယ်များ (credit card မလိုအပ်ပါ) +- **ဖွံ့ဖြိုးရေးကိရိယာများ**: Docker containers, VS Code, နှင့် GitHub Codespaces တပ်ဆင်ခြင်း +- **[→ ဒုတိယပိုင်း စတင်ရန်](./02-SetupDevEnvironment/README.md)** + +### **ပိုင်း ၃: အခြေခံ Generative AI နည်းပညာများ** +- **Prompt Engineering**: AI မော်ဒယ် တုံ့ပြန်မှုများ အကောင်းဆုံးရရှိရန် နည်းလမ်းများ +- **Embeddings & Vector လုပ်ဆောင်ချက်များ**: semantic ရှာဖွေရေး နှင့် similarity တွဲဖက်ခြင်း +- **Retrieval-Augmented Generation (RAG)**: သင့်ကိုယ်ပိုင် ဒေတာစမ်းတင်မှုနှင့် AI ကိုပေါင်းစပ်ခြင်း +- **Function Calling**: စိတ်ကြိုက် ကိရိယာများနှင့် plugin များဖြင့် AI လုပ်ဆောင်နိုင်စွမ်း တိုးချဲ့ခြင်း +- **[→ တတိယပိုင်း စတင်ရန်](./03-CoreGenerativeAITechniques/README.md)** + +### **ပိုင်း ၄: လက်တွေ့လျောက်ထားမှုများနှင့် စီမံကိန်းများ** +- **Pet Story Generator** (`petstory/`): GitHub Models ဖြင့် ဖန်တီးမှုအကြောင်းအရာ များ +- **Foundry Local Demo** (`foundrylocal/`): OpenAI Java SDK ဖြင့် ဒေသတွင်း AI မော်ဒယ် စမ်းသပ်ခြင်း +- **MCP Calculator Service** (`calculator/`): Spring AI နှင့် အခြေခံ Model Context Protocol ကျင့်သုံးမှု +- **[→ စတင်ရန် ပိုင်း ၄](./04-PracticalSamples/README.md)** + +### **ပိုင်း ၅: တာဝန်ယူနိုင်သော AI ဖန်တီးခြင်း** +- **GitHub Models အရေးကြီးမှု**: အတွင်းစိတ် စစ်ဆေးမှု၊ safety လုပ်ဆောင်ချက်များ စမ်းသပ်ခြင်း (hard block နှင့် soft refusal စနစ်များ) +- **တာဝန်ယူနိုင်သော AI ဒေမို**: ခေတ်မီသော AI လုံခြုံမှုစနစ်များ လက်တွေ့ ပြသမှု +- **အကောင်းဆုံး လေ့လာအကြံပြုချက်များ**: သကျဖွံ့ဖြိုးမှုနှင့် ထုတ်လုပ်မှုအတွက် လိုအပ်သော စည်းကမ်းများ +- **[→ စတင်ရန် ပိုင်း ၅](./05-ResponsibleGenAI/README.md)** + +## အထပ်ထပ် အရင်းအမြစ်များ ### LangChain @@ -117,30 +108,30 @@ CO_OP_TRANSLATOR_METADATA: [![AI for Beginners](https://img.shields.io/badge/AI%20for%20Beginners-A3E635?style=for-the-badge&labelColor=E5E7EB&color=A3E635)](https://aka.ms/ai-beginners?WT.mc_id=academic-105485-koreyst) [![Cybersecurity for Beginners](https://img.shields.io/badge/Cybersecurity%20for%20Beginners-F97316?style=for-the-badge&labelColor=E5E7EB&color=F97316)](https://github.com/microsoft/Security-101?WT.mc_id=academic-96948-sayoung) [![Web Dev for Beginners](https://img.shields.io/badge/Web%20Dev%20for%20Beginners-EC4899?style=for-the-badge&labelColor=E5E7EB&color=EC4899)](https://aka.ms/webdev-beginners?WT.mc_id=academic-105485-koreyst) -[![စက်ပစ္စည်းများအတွက် လူသစ်များ](https://img.shields.io/badge/IoT%20for%20Beginners-14B8A6?style=for-the-badge&labelColor=E5E7EB&color=14B8A6)](https://aka.ms/iot-beginners?WT.mc_id=academic-105485-koreyst) -[![XR ဖွံ့ဖြိုးတိုးတက်မှု လူသစ်များအတွက်](https://img.shields.io/badge/XR%20Development%20for%20Beginners-38BDF8?style=for-the-badge&labelColor=E5E7EB&color=38BDF8)](https://github.com/microsoft/xr-development-for-beginners?WT.mc_id=academic-105485-koreyst) +[![IoT for Beginners](https://img.shields.io/badge/IoT%20for%20Beginners-14B8A6?style=for-the-badge&labelColor=E5E7EB&color=14B8A6)](https://aka.ms/iot-beginners?WT.mc_id=academic-105485-koreyst) +[![XR Development for Beginners](https://img.shields.io/badge/XR%20Development%20for%20Beginners-38BDF8?style=for-the-badge&labelColor=E5E7EB&color=38BDF8)](https://github.com/microsoft/xr-development-for-beginners?WT.mc_id=academic-105485-koreyst) --- -### Copilot Series -[![AI တွဲဖက်ပရိုဂရမ်မင်းအတွက် Copilot](https://img.shields.io/badge/Copilot%20for%20AI%20Paired%20Programming-FACC15?style=for-the-badge&labelColor=E5E7EB&color=FACC15)](https://aka.ms/GitHubCopilotAI?WT.mc_id=academic-105485-koreyst) -[![C#/.NET အတွက် Copilot](https://img.shields.io/badge/Copilot%20for%20C%23/.NET-FBBF24?style=for-the-badge&labelColor=E5E7EB&color=FBBF24)](https://github.com/microsoft/mastering-github-copilot-for-dotnet-csharp-developers?WT.mc_id=academic-105485-koreyst) -[![Copilot စွန့်စားမှု](https://img.shields.io/badge/Copilot%20Adventure-FDE68A?style=for-the-badge&labelColor=E5E7EB&color=FDE68A)](https://github.com/microsoft/CopilotAdventures?WT.mc_id=academic-105485-koreyst) +### Copilot မျိုးဆက်များ +[![Copilot for AI Paired Programming](https://img.shields.io/badge/Copilot%20for%20AI%20Paired%20Programming-FACC15?style=for-the-badge&labelColor=E5E7EB&color=FACC15)](https://aka.ms/GitHubCopilotAI?WT.mc_id=academic-105485-koreyst) +[![Copilot for C#/.NET](https://img.shields.io/badge/Copilot%20for%20C%23/.NET-FBBF24?style=for-the-badge&labelColor=E5E7EB&color=FBBF24)](https://github.com/microsoft/mastering-github-copilot-for-dotnet-csharp-developers?WT.mc_id=academic-105485-koreyst) +[![Copilot Adventure](https://img.shields.io/badge/Copilot%20Adventure-FDE68A?style=for-the-badge&labelColor=E5E7EB&color=FDE68A)](https://github.com/microsoft/CopilotAdventures?WT.mc_id=academic-105485-koreyst) ## အကူအညီရယူခြင်း -AI အက်ပ်များ ဖန်တီးရာတွင် အဆင်မပြေမဖြစ်ပါက သို့မဟုတ် မေးခွန်းများရှိပါက MCP အကြောင်း ဆွေးနွေးရာတွင် ပညာရှင်များနှင့် အတွေ့အကြုံရှိသော ဖွံ့ဖြိုးသူများနှင့် တွဲဖက်ပါ။ မေးခွန်းများကို ကြိုဆိုသော နှင့် အသိပညာများကို အခမဲ့ဝေမျှသော ပံ့ပိုးကူညီမှု အဖွဲ့အစည်းတစ်ခု ဖြစ်သည်။ +AI အက်ပ်များဖန်တီးရာတွင် အခက်အခဲများ ဖြစ်ပေါ်ခဲ့လျှင် သို့မဟုတ် မေးခွန်းများရှိပါက MCP အကြောင်း လေ့လာသူများနှင့် အတွေ့အကြုံရှိသော ဖန်တီးသူများနှင့် ဆွေးနွေးပွဲများတွင် ပါဝင်နိုင်ပါသည်။ ဤနေရာတွင် မေးခွန်းများကို ကြိုဆိုပြီး သိပ္ပံပညာများကို ပြန်လည်မျှဝေသည့် ကူညီမှုများ ပြုလုပ်နေသော ပတ်ဝန်းကျင်တစ်ခု ဖြစ်ပါသည်။ [![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) -ထုတ်ကုန်ရဲ့ တုံ့ပြန်ချက်များ သို့မဟုတ် ဖန်တီးခြင်း ကြားတွင် အမှားများရှိပါက အောက်ပါလိပ်စာကို သွားရောက်ကြည့်ပါ။ +ထုတ်ကုန်အကြံပြုချက်များ သို့မဟုတ် တည်ဆောက်ခြင်းအတွင်း ဖြစ်ပွားသော အမှားများရှိပါက အောက်ပါရန်ပုံကြည့်ရန်: [![Microsoft Foundry Developer Forum](https://img.shields.io/badge/GitHub-Microsoft_Foundry_Developer_Forum-blue?style=for-the-badge&logo=github&color=000000&logoColor=fff)](https://aka.ms/foundry/forum) --- -**အငြင်းပွားချက် မပါသောကြေညာချက်** -ဤစာရွက်စာတမ်းကို AI ဘာသာပြန်ဝန်ဆောင်မှုဖြစ်သော [Co-op Translator](https://github.com/Azure/co-op-translator) ကိုအသုံးပြု၍ ဘာသာပြန်ထားပါသည်။ ကျွန်ုပ်တို့သည် တိကျမှန်ကန်မှုအတွက် ကြိုးစားပေမယ့် အလိုအလျောက် ဘာသာပြန်မှုတွင် အမှားများ သို့မဟုတ် မှားယွင်းချက်များဖြစ်ပေါ်နိုင်သည်ကို လေးစားစွာအသိပေးပါသည်။ မူလစာရွက်စာတမ်းကို သက်ဆိုင်ရာ မူရင်းဘာသာဖြင့်သာ မှန်ကန်မှုအာမခံချက် အဖြစ် ယူဆသင့်ပါသည်။ အရေးကြီးသည့် သတင်းအချက်အလက်များအတွက် ကျွမ်းကျင် လက်တွေ့ ဘာသာပြန်ခြင်းကို အကြံပြုပါသည်။ ဤဘာသာပြန်ချက် အသုံးပြုမှုမှ ဆက်စပ်ပြီး ဖြစ်ပေါ်နိုင်သည့် နားလည်မှုမှားမှုများ သို့မဟုတ် မမှန်ကန်မှု၏ တာဝန်ကို ကျွန်ုပ်တို့ မယူဆောင်ပါ။ +**အသိပေးချက်** +ဤစာတမ်းကို AI ဘာသာပြန်ခြင်းဝန်ဆောင်မှု [Co-op Translator](https://github.com/Azure/co-op-translator) မှ အသုံးပြု၍ ဘာသာပြန်ထားပါသည်။ ကျွန်ုပ်တို့သည် တိကျမှန်ကန်မှုအတွက် ကြိုးပမ်းပေမယ့် ကိုယ်ပိုင်အလိုအလျောက် ဘာသာပြန်ခြင်းများတွင် လွဲမှားချက်များ သို့မဟုတ် မှားယွင်းချက်များ ပါဝင်နိုင်ခြင်းကို သတိပြုပါရန် တိုက်တွန်းပါသည်။ မူရင်းစာတမ်းကို နိုင်ငံဘာသာဖြင့်သာ အာဏာပိုင်အဖြစ် သတ်မှတ်စဉ်းစားရမည်ဖြစ်သည်။ အရေးကြီးသော သတင်းအချက်အလက်များအတွက် မည်သည့်ဘက်မှ လူ့ဘာသာပြန်ကို အကြံပြုပါသည်။ ဤဘာသာပြန်ချက်အသုံးပြုမှုကြောင့် ဖြစ်ပေါ်မည့် အနှောင့်အယွင်းများ သို့မဟုတ် အလွဲသုံးစားမှုများအတွက် ကျွန်ုပ်တို့သည် တာဝန်မယူပါ။ \ No newline at end of file diff --git a/translations/my/SECURITY.md b/translations/my/SECURITY.md index abff30b7..4841b1c1 100644 --- a/translations/my/SECURITY.md +++ b/translations/my/SECURITY.md @@ -1,12 +1,3 @@ - ## လုံခြုံရေး Microsoft သည် ၎င်း၏ ဆော့ဖ်ဝဲထုတ်ကုန်များနှင့် ဝန်ဆောင်မှုများ၏ လုံခြုံရေးကို အလေးထားဆောင်ရွက်ပြီး၊ ၎င်းတွင် GitHub အဖွဲ့အစည်းများမှ စီမံခန့်ခွဲထားသော အရင်းအမြစ်ကုဒ်ရုံများလည်း ပါဝင်သည်။ ဤအဖွဲ့အစည်းများတွင် [Microsoft](https://github.com/Microsoft), [Azure](https://github.com/Azure), [DotNet](https://github.com/dotnet), [AspNet](https://github.com/aspnet) နှင့် [Xamarin](https://github.com/xamarin) တို့ ပါဝင်ပါသည်။ diff --git a/translations/my/SUPPORT.md b/translations/my/SUPPORT.md index 18a04ec9..c7ec0a90 100644 --- a/translations/my/SUPPORT.md +++ b/translations/my/SUPPORT.md @@ -1,12 +1,3 @@ - # အထောက်အပံ့ ## ပြဿနာများကို တင်ပြခြင်းနှင့် အကူအညီရယူရန် diff --git a/translations/ne/.co-op-translator.json b/translations/ne/.co-op-translator.json new file mode 100644 index 00000000..00abc645 --- /dev/null +++ b/translations/ne/.co-op-translator.json @@ -0,0 +1,92 @@ +{ + "01-IntroToGenAI/README.md": { + "original_hash": "75bfb080ca725e8a9aa9c80cae25fba1", + "translation_date": "2025-07-29T08:51:23+00:00", + "source_file": "01-IntroToGenAI/README.md", + "language_code": "ne" + }, + "02-SetupDevEnvironment/README.md": { + "original_hash": "96a30d42b9751a3d4e4b20e28d29d459", + "translation_date": "2026-01-28T04:51:26+00:00", + "source_file": "02-SetupDevEnvironment/README.md", + "language_code": "ne" + }, + "02-SetupDevEnvironment/examples/basic-chat-azure/README.md": { + "original_hash": "efd82efe50711d7e257eb943151d682c", + "translation_date": "2025-07-27T13:38:35+00:00", + "source_file": "02-SetupDevEnvironment/examples/basic-chat-azure/README.md", + "language_code": "ne" + }, + "02-SetupDevEnvironment/getting-started-azure-openai.md": { + "original_hash": "bfdb4b4eadbee3a59ef742439f58326a", + "translation_date": "2025-07-27T13:03:06+00:00", + "source_file": "02-SetupDevEnvironment/getting-started-azure-openai.md", + "language_code": "ne" + }, + "03-CoreGenerativeAITechniques/README.md": { + "original_hash": "685f55cb07de19b52a30ce6e8b6d889e", + "translation_date": "2025-08-28T22:02:05+00:00", + "source_file": "03-CoreGenerativeAITechniques/README.md", + "language_code": "ne" + }, + "04-PracticalSamples/README.md": { + "original_hash": "14c0a61ecc1cd2012a9c129236dfdf71", + "translation_date": "2025-07-29T08:51:06+00:00", + "source_file": "04-PracticalSamples/README.md", + "language_code": "ne" + }, + "04-PracticalSamples/calculator/README.md": { + "original_hash": "b6c16b5514d524e415a94f6097ee7d4c", + "translation_date": "2025-09-18T15:29:21+00:00", + "source_file": "04-PracticalSamples/calculator/README.md", + "language_code": "ne" + }, + "04-PracticalSamples/foundrylocal/README.md": { + "original_hash": "f787307400de59adc25a1404466a35f3", + "translation_date": "2025-11-04T07:21:00+00:00", + "source_file": "04-PracticalSamples/foundrylocal/README.md", + "language_code": "ne" + }, + "04-PracticalSamples/petstory/README.md": { + "original_hash": "0cbf68d605615a1e602c832a24616859", + "translation_date": "2025-07-25T11:10:27+00:00", + "source_file": "04-PracticalSamples/petstory/README.md", + "language_code": "ne" + }, + "05-ResponsibleGenAI/README.md": { + "original_hash": "301c05c2f57e60a6950b8c665b8bdbba", + "translation_date": "2025-07-29T15:47:20+00:00", + "source_file": "05-ResponsibleGenAI/README.md", + "language_code": "ne" + }, + "AGENTS.md": { + "original_hash": "afc90918d008cf77fd1982691f681306", + "translation_date": "2025-10-03T08:33:18+00:00", + "source_file": "AGENTS.md", + "language_code": "ne" + }, + "CODE_OF_CONDUCT.md": { + "original_hash": "442b123d034f92f7c384d2bbd28f99f1", + "translation_date": "2025-07-21T17:36:51+00:00", + "source_file": "CODE_OF_CONDUCT.md", + "language_code": "ne" + }, + "README.md": { + "original_hash": "125a08948d881c95628094f4dd1fbd43", + "translation_date": "2026-01-29T15:36:46+00:00", + "source_file": "README.md", + "language_code": "ne" + }, + "SECURITY.md": { + "original_hash": "57f14126c1c6add76b3aef3844dfe4e3", + "translation_date": "2025-07-21T17:35:14+00:00", + "source_file": "SECURITY.md", + "language_code": "ne" + }, + "SUPPORT.md": { + "original_hash": "b8ef73cc49dec68e2c885ee9df545129", + "translation_date": "2025-07-21T17:37:56+00:00", + "source_file": "SUPPORT.md", + "language_code": "ne" + } +} \ No newline at end of file diff --git a/translations/ne/01-IntroToGenAI/README.md b/translations/ne/01-IntroToGenAI/README.md index f8a7c089..9f40c2ac 100644 --- a/translations/ne/01-IntroToGenAI/README.md +++ b/translations/ne/01-IntroToGenAI/README.md @@ -1,12 +1,3 @@ - # जेनेरेटिभ एआईमा परिचय - जाभा संस्करण ## तपाईंले के सिक्नुहुनेछ diff --git a/translations/ne/02-SetupDevEnvironment/README.md b/translations/ne/02-SetupDevEnvironment/README.md index 353f783d..fcbde624 100644 --- a/translations/ne/02-SetupDevEnvironment/README.md +++ b/translations/ne/02-SetupDevEnvironment/README.md @@ -1,13 +1,253 @@ - +# जनरेटिभ एआईका लागि जाभा विकास वातावरण सेटअप गर्दै +> **द्रुत सुरु:** २ मिनेटमै क्लाउडमा कोड लेख्न थाल्नुहोस् - [GitHub Codespaces सेटअप](../../../02-SetupDevEnvironment) मा जानुहोस् - कुनै स्थानीय इन्स्टलेसन आवश्यक छैन र GitHub मोडेलहरू प्रयोग गर्छ! + +> **Azure OpenAI मा रुचि छ?**, नयाँ Azure OpenAI स्रोत बनाउनका लागि हाम्रो [Azure OpenAI सेटअप गाइड](getting-started-azure-openai.md) हेर्नुहोस्। + +## तपाईं के सिक्नुहुनेछ + +- AI अनुप्रयोगका लागि जाभा विकास वातावरण सेटअप गर्ने +- तपाइँको रोजाइको विकास वातावरण चयन र कन्फिगर गर्ने (Codespaces सहित क्लाउड-प्रथम, स्थानीय dev container, वा पूर्ण स्थानीय सेटअप) +- GitHub मोडेलसँग जडान गरेर तपाईंको सेटअप परीक्षण गर्ने + +## सामग्री तालिका + +- [तपाईं के सिक्नुहुनेछ](../../../02-SetupDevEnvironment) +- [परिचय](../../../02-SetupDevEnvironment) +- [चरण १: विकास वातावरण सेटअप गर्नुहोस्](../../../02-SetupDevEnvironment) + - [विकल्प ए: GitHub Codespaces (सिफारिस गरिएको)](../../../02-SetupDevEnvironment) + - [विकल्प B: स्थानीय Dev Container](../../../02-SetupDevEnvironment) + - [विकल्प C: तपाइँको अवस्थित स्थानीय इन्स्टलेसन प्रयोग गर्नुहोस्](../../../02-SetupDevEnvironment) +- [चरण २: GitHub व्यक्तिगत पहुँच टोकन बनाउनुहोस्](../../../02-SetupDevEnvironment) +- [चरण ३: तपाईंको सेटअप परीक्षण गर्नुहोस्](../../../02-SetupDevEnvironment) +- [समस्या समाधान](../../../02-SetupDevEnvironment) +- [सारांश](../../../02-SetupDevEnvironment) +- [अर्को कदम](../../../02-SetupDevEnvironment) + +## परिचय + +यो अध्यायले तपाइँलाई विकास वातावरण सेटअप गर्न मार्गदर्शन गर्नेछ। हामी **GitHub Models** लाई हाम्रो प्रमुख उदाहरणको रूपमा प्रयोग गर्नेछौं किनकि यो निःशुल्क छ, केवल GitHub खाता भए गरेकाले सजिलो छ, कुनै क्रेडिट कार्ड आवश्यक पर्दैन, र प्रयोगका लागि धेरै मोडेलहरू उपलब्ध छन्। + +**कुनै स्थानीय सेटअप आवश्यक छैन!** तपाइँ तुरुन्तै GitHub Codespaces प्रयोग गरी ब्राउजरमा पूर्ण विकास वातावरण प्रदान गर्दै कोड लेख्न सुरु गर्न सक्नुहुन्छ। + +स्क्रीनशट: GitHub Models + +हामी यस कोर्सका लागि [**GitHub Models**](https://github.com/marketplace?type=models) प्रयोग गर्न सिफारिस गर्छौं किनकि यो: +- सुरु गर्नका लागि **निःशुल्क** +- केवल GitHub खातासँग सेटअप गर्न **सजिलो** +- **क्रेडिट कार्ड आवश्यक छैन** +- प्रयोगका लागि **धेरै मोडेलहरू** उपलब्ध छन् + +> **टिप्पणी:** यस तालिममा प्रयोग गरिएका GitHub Models मा यस्ता निःशुल्क सीमा छन्: +> - प्रति मिनेट १५ अनुरोध (प्रति दिन १५०) +> - प्रति अनुरोध ~८,००० शब्द इनपुट, ~४,००० शब्द आउटपुट +> - ५ समानान्तर अनुरोधहरू +> +> उत्पादनको लागि, Azure खातासँग Azure AI Foundry Models मा अपग्रेड गर्नुहोस्। तपाइँको कोड परिवर्तन गर्न आवश्यक छैन। हेर्नुहोस् [Azure AI Foundry दस्तावेज](https://learn.microsoft.com/azure/ai-foundry/foundry-models/how-to/quickstart-github-models)। + +## चरण १: विकास वातावरण सेटअप गर्नुहोस् + + + +हामीले यस जनरेटिभ एआई जाभा कोर्सका लागि आवश्यक सबै उपकरणहरू सहज बनाउन पूर्वकन्फिगर गरिएको विकास कन्टेनर तयार गरेका छौं। तपाइँको मनपर्ने विकास विधि चयन गर्नुहोस्: + +### वातावरण सेटअप विकल्पहरू: + +#### विकल्प ए: GitHub Codespaces (सिफारिस गरिएको) + +**२ मिनेटमै कोड लेख्न सुरु गर्नुहोस् - कुनै स्थानीय सेटअप आवश्यक छैन!** + +1. यो रिपोजिटोरी आफ्नो GitHub खातामा Fork गर्नुहोस् + > **टिप्पणी:** यदि तपाइँ बेसिक कन्फिग सम्पादन गर्न चाहनुहुन्छ भने [Dev Container Configuration](../../../.devcontainer/devcontainer.json) हेर्नुहोस्। +2. क्लिक गर्नुहोस् **Code** → **Codespaces** ट्याब → **...** → **New with options...** +3. पूर्वनिर्धारित सेटिङहरू प्रयोग गर्नुहोस् – यसले यस कोर्सका लागि तयार गरिएको **Generative AI Java Development Environment** कस्टम devcontainer चयन गर्नेछ +4. क्लिक गर्नुहोस् **Create codespace** +5. वातावरण तयार हुन लगभग २ मिनेट पर्खनुहोस् +6. अगाडि बढ्नुहोस् [चरण २: GitHub टोकन बनाउनुहोस्](../../../02-SetupDevEnvironment) + +स्क्रीनशट: Codespaces सबमेनु + +स्क्रीनशट: New with options + +स्क्रीनशट: Create codespace विकल्पहरू + +> **Codespaces का फाइदा**: +> - कुनै स्थानीय इन्स्टलेसन आवश्यक छैन +> - ब्राउजर भएको कुनै पनि उपकरणमा चल्छ +> - सबै उपकरण र निर्भरता पूर्व-कन्फिगर गरिएको छ +> - व्यक्तिगत खाताका लागि महिनाेमा निःशुल्क ६० घण्टा +> - सबै सिक्नेलाई एकरूप वातावरण + +#### विकल्प B: स्थानीय Dev Container + +** Docker सहित स्थानीय विकास प्राथमिकताहरूका लागि** + +1. यो रिपोजिटोरी आफ्नो स्थानीय मेसिनमा Fork र क्लोन गर्नुहोस् + > **टिप्पणी:** यदि बेसिक कन्फिग सम्पादन गर्न चाहनुहुन्छ भने [Dev Container Configuration](../../../.devcontainer/devcontainer.json) हेर्नुहोस्। +2. [Docker Desktop](https://www.docker.com/products/docker-desktop/) र [VS Code](https://code.visualstudio.com/) इन्स्टल गर्नुहोस् +3. VS Code मा [Dev Containers विस्तार](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers) स्थापना गर्नुहोस् +4. VS Code मा रिपोजिटोरी फोल्डर खोल्नुहोस् +5. सोधिएमा, क्लिक गर्नुहोस् **Reopen in Container** (वा प्रयोग गर्नुहोस् `Ctrl+Shift+P` → "Dev Containers: Reopen in Container") +6. कन्टेनर बनेर सुरु हुन पर्खनुहोस् +7. अगाडि बढ्नुहोस् [चरण २: GitHub टोकन बनाउनुहोस्](../../../02-SetupDevEnvironment) + +स्क्रीनशट: Dev container सेटअप + +स्क्रीनशट: Dev container निर्माण पूरा + +#### विकल्प C: तपाइँको अवस्थित स्थानीय इन्स्टलेसन प्रयोग गर्नुहोस् + +**पहिले देखि रहेको जाभा वातावरण भएका विकासकर्ताहरूका लागि** + +पूर्वशर्तहरू: +- [Java 21+](https://www.oracle.com/java/technologies/javase/jdk21-archive-downloads.html) +- [Maven 3.9+](https://maven.apache.org/download.cgi) +- [VS Code](https://code.visualstudio.com) वा तपाइँको मनपर्ने IDE + +चरणहरू: +1. यो रिपोजिटोरी आफ्नो स्थानीय मेसिनमा क्लोन गर्नुहोस् +2. आफ्नो IDE मा प्रोजेक्ट खोल्नुहोस् +3. अगाडि बढ्नुहोस् [चरण २: GitHub टोकन बनाउनुहोस्](../../../02-SetupDevEnvironment) + +> **पेशेवर सुझाव**: यदि तपाइँको मेशिन कम क्षमताको छ तर स्थानीय VS Code चाहनुहुन्छ भने GitHub Codespaces प्रयोग गर्नुहोस्! तपाइँ आफ्नो स्थानीय VS Code लाई क्लाउड होस्ट गरिएको Codespace सँग जडान गर्न सक्नुहुन्छ। + +स्क्रीनशट: बनाइएको स्थानीय devcontainer उदाहरण + + +## चरण २: GitHub व्यक्तिगत पहुँच टोकन बनाउनुहोस् + +1. जानुहोस् [GitHub Settings](https://github.com/settings/profile) र तपाइँको प्रोफाइल मेनूबाट **Settings** चयन गर्नुहोस्। +2. बायाँ साइडबारमा, क्लिक गर्नुहोस् **Developer settings** (सामान्यतया तल हुन्छ)। +3. **Personal access tokens** अन्तर्गत, क्लिक गर्नुहोस् **Fine-grained tokens** (वा यो सिधा [लिंक](https://github.com/settings/personal-access-tokens) पछ्याउनुहोस्)। +4. क्लिक गर्नुहोस् **Generate new token**। +5. "Token name" अन्तर्गत स्पष्ट नाम दिनुहोस् (उदाहरण: `GenAI-Java-Course-Token`)। +6. समाप्ति मिति सेट गर्नुहोस् (सिफारिस गरिएको: सुरक्षा खातिर ७ दिन)। +7. "Resource owner" अन्तर्गत तपाइँको प्रयोगकर्ता खाता चयन गर्नुहोस्। +8. "Repository access" अन्तर्गत GitHub Models सँग प्रयोग गर्ने रिपोजिटोरीहरू चयन गर्नुहोस् (वा "All repositories" यदि आवश्यक हो)। +9. "Account permissions" अन्तर्गत **Models** लाई **Read-only**मा सेट गर्नुहोस्। +10. क्लिक गर्नुहोस् **Generate token**। +11. **अब टोकन कपी गरी सुरक्षित राख्नुहोस्** – यो पुन: देखिने छैन! + +> **सुरक्षा सुझाव**: पहुँच टोकनहरूका लागि न्यूनतम आवश्यक दायरा र सबैभन्दा छोटो व्यावहारिक समाप्ति समय प्रयोग गर्नुहोस्। + +## चरण ३: GitHub Models उदाहरणसँग तपाईंको सेटअप परीक्षण गर्नुहोस् + +तपाइँको विकास वातावरण तयार भएपछि, हाम्रो उदाहरण एप्लिकेसन [`02-SetupDevEnvironment/examples/github-models`](../../../02-SetupDevEnvironment/examples/github-models) मा GitHub Models इंटेग्रेशन परीक्षण गरौं। + +1. आफ्नो विकास वातावरणमा टर्मिनल खोल्नुहोस्। +2. GitHub Models उदाहरण फोल्डरमा जानुहोस्: + ```bash + cd 02-SetupDevEnvironment/examples/github-models + ``` + +3. तपाइँको GitHub टोकन पर्यावरण चरको रूपमा सेट गर्नुहोस्: + ```bash + # macOS/Linux + export GITHUB_TOKEN=your_token_here + + # विन्डोज (कमाण्ड प्रम्प्ट) + set GITHUB_TOKEN=your_token_here + + # विन्डोज (पावरशेल) + $env:GITHUB_TOKEN="your_token_here" + ``` + +4. एप्लिकेसन चलाउनुहोस्: + ```bash + mvn compile exec:java -Dexec.mainClass="com.example.githubmodels.App" + ``` + +यसरी आउटपुट देखिनु पर्छ: +```text +Using model: gpt-4.1-nano +Sending request to GitHub Models... +Response: Hello World! +``` + +### उदाहरण कोड बुझ्नुहोस् + +पहिले, हामीले के चलायौं भनी बुझौं। `examples/github-models` भित्रको उदाहरणले OpenAI Java SDK प्रयोग गरी GitHub Models सँग जडान गर्दछ: + +**यो कोड के गर्छ:** +- तपाइँको व्यक्तिगत पहुँच टोकन प्रयोग गरी GitHub Models सँग **जडान** गर्छ +- AI मोडेललाई "Say Hello World!" सन्देश **पठाउँछ** +- AI को प्रतिक्रिया **प्राप्त** गरी देखाउँछ +- तपाइँको सेटअप सहि छ कि छैन **मान्य गर्छ** + +**मुख्य निर्भरता** (`pom.xml` मा): +```xml + + com.openai + openai-java + 2.12.0 + +``` + +**मुख्य कोड** (`App.java`): +```java +// OpenAI Java SDK प्रयोग गरेर GitHub मोडेलसँग जडान गर्नुहोस् +OpenAIClient client = OpenAIOkHttpClient.builder() + .apiKey(pat) + .baseUrl("https://models.inference.ai.azure.com") + .build(); + +// च्याट कम्प्लिशन अनुरोध सिर्जना गर्नुहोस् +ChatCompletionCreateParams params = ChatCompletionCreateParams.builder() + .model(modelId) + .addSystemMessage("You are a concise assistant.") + .addUserMessage("Say Hello World!") + .build(); + +// AI प्रतिक्रिया प्राप्त गर्नुहोस् +ChatCompletion response = client.chat().completions().create(params); +System.out.println("Response: " + response.choices().get(0).message().content().orElse("No response content")); +``` + +## सारांश + +शानदार! अब तपाइँसँग सबै तयार छ: + +- AI मोडेल पहुँचका लागि सही अनुमति भएको GitHub व्यक्तिगत पहुँच टोकन बनाउनु भयो +- आफ्नो जाभा विकास वातावरण चलाउनुभयो (Codespaces, dev container वा स्थानीय) +- निःशुल्क AI विकासका लागि OpenAI Java SDK प्रयोग गरी GitHub Models सँग जडान गर्नुभयो +- AI मोडेलहरूलाई कुरा गराउने सरल उदाहरणसँग सबै काम चलाउनु भयो + +## अर्को कदम + +[अध्याय ३: कोर जनरेटिभ एआई प्राविधिहरू](../03-CoreGenerativeAITechniques/README.md) + +## समस्या समाधान + +समस्या छ? यहाँ सामान्य समस्या र समाधानहरू छन्: + +- **टोकन काम नगरेको छ?** + - टोकन पूरै कपी गर्नुभयो कि छैन जाँच्नुस् + - टोकनलाई सही तरिकाले पर्यावरण चरमा सेट गर्नुभएको छ कि छैन जाँच्नुस् + - टोकनमा सही अनुमति (Models: Read-only) छ कि छैन हेरौं + +- **Maven नभेटियो?** + - dev containers/Codespaces मा Maven पहिले नै इन्स्टल हुन्छ + - स्थानीय सेटअपमा Java 21+ र Maven 3.9+ इन्स्टल गर्नुभयो कि छैन जाँच्नुस् + - `mvn --version` चलाएर परीक्षण गर्न सक्नुहुन्छ + +- **जडान समस्या छ?** + - इन्टरनेट जडान ठिक छ कि छैन जाँच्नुस् + - तपाइँको नेटवर्कबाट GitHub पहुँच योग्य छ कि छैन पक्का गर्नुस् + - GitHub Models अन्त्यबिन्दु अवरुद्ध गर्ने फायरवाल छैन भनेर सुनिश्चित गर्नुस् + +- **Dev container सुरु भएको छैन?** + - Docker Desktop चलिरहेको छ कि छैन जाँच्नुस् (स्थानीय विकासका लागि) + - कन्टेनर पुनःनिर्माण प्रयास गर्नुहोस्: `Ctrl+Shift+P` → "Dev Containers: Rebuild Container" + +- **एप्लिकेसन कम्पाइल त्रुटि?** + - सही डायरेक्टरीमा हुनुहुन्छ: `02-SetupDevEnvironment/examples/github-models` + - सफा र पुनःनिर्माण प्रयास गर्नुहोस्: `mvn clean compile` + +> **मद्दत चाहिन्छ?**: समस्या जारी छ? रिपोजिटोरीमा एक Issue खोल्नुहोस्, हामी मद्दत गर्नेछौं। --- + +**अस्वीकरण**: +यो दस्तावेज AI अनुवाद सेवा [Co-op Translator](https://github.com/Azure/co-op-translator) प्रयोग गरी अनुवाद गरिएको हो। हामी शुद्धताको लागि प्रयासरत भए तापनि, कृपया बुझ्नुहोस् कि स्वचालित अनुवादहरूमा त्रुटि वा असत्यताहरू हुन सक्दछन्। मूल दस्तावेजलाई यसको मूल भाषामा आधिकारिक स्रोतको रूपमा मान्नु पर्नेछ। महत्वपूर्ण जानकारीको लागि व्यावसायिक मानव अनुवाद सिफारिस गरिन्छ। यस अनुवादको प्रयोगबाट उत्पन्न हुने कुनै पनि गलतफहमी वा गलत व्याख्याका लागि हामी जिम्मेवार छैनौं। + \ No newline at end of file diff --git a/translations/ne/02-SetupDevEnvironment/examples/basic-chat-azure/README.md b/translations/ne/02-SetupDevEnvironment/examples/basic-chat-azure/README.md index e43bb330..e26fdddf 100644 --- a/translations/ne/02-SetupDevEnvironment/examples/basic-chat-azure/README.md +++ b/translations/ne/02-SetupDevEnvironment/examples/basic-chat-azure/README.md @@ -1,12 +1,3 @@ - # Azure OpenAI सँग आधारभूत च्याट - अन्त-देखि-अन्त उदाहरण यो उदाहरणले कसरी एक साधारण Spring Boot एप्लिकेसन बनाउने र Azure OpenAI सँग जडान गर्ने तथा आफ्नो सेटअप परीक्षण गर्ने देखाउँछ। diff --git a/translations/ne/02-SetupDevEnvironment/getting-started-azure-openai.md b/translations/ne/02-SetupDevEnvironment/getting-started-azure-openai.md index 37a37af2..c20b3092 100644 --- a/translations/ne/02-SetupDevEnvironment/getting-started-azure-openai.md +++ b/translations/ne/02-SetupDevEnvironment/getting-started-azure-openai.md @@ -1,12 +1,3 @@ - # Azure OpenAI को विकास वातावरण सेटअप गर्ने > **छिटो सुरु**: यो मार्गदर्शन Azure OpenAI सेटअपको लागि हो। निःशुल्क मोडेलहरू प्रयोग गरेर तुरुन्त सुरु गर्न [GitHub Models with Codespaces](./README.md#quick-start-cloud) प्रयोग गर्नुहोस्। diff --git a/translations/ne/03-CoreGenerativeAITechniques/README.md b/translations/ne/03-CoreGenerativeAITechniques/README.md index f5c7dd61..d45907ad 100644 --- a/translations/ne/03-CoreGenerativeAITechniques/README.md +++ b/translations/ne/03-CoreGenerativeAITechniques/README.md @@ -1,12 +1,3 @@ - # कोर जेनेरेटिभ एआई प्रविधिहरू ट्युटोरियल ## सामग्री सूची diff --git a/translations/ne/04-PracticalSamples/README.md b/translations/ne/04-PracticalSamples/README.md index b116af01..30540090 100644 --- a/translations/ne/04-PracticalSamples/README.md +++ b/translations/ne/04-PracticalSamples/README.md @@ -1,12 +1,3 @@ - # व्यावहारिक अनुप्रयोगहरू र परियोजनाहरू ## तपाईंले के सिक्नुहुनेछ diff --git a/translations/ne/04-PracticalSamples/calculator/README.md b/translations/ne/04-PracticalSamples/calculator/README.md index e769ae1d..537ceb2d 100644 --- a/translations/ne/04-PracticalSamples/calculator/README.md +++ b/translations/ne/04-PracticalSamples/calculator/README.md @@ -1,12 +1,3 @@ - # MCP क्यालकुलेटर ट्युटोरियल शुरुवातकर्ताहरूका लागि ## सामग्री तालिका diff --git a/translations/ne/04-PracticalSamples/foundrylocal/README.md b/translations/ne/04-PracticalSamples/foundrylocal/README.md index 17642cd8..eb7731cc 100644 --- a/translations/ne/04-PracticalSamples/foundrylocal/README.md +++ b/translations/ne/04-PracticalSamples/foundrylocal/README.md @@ -1,12 +1,3 @@ - # Foundry Local Spring Boot ट्यूटोरियल ## सामग्री तालिका diff --git a/translations/ne/04-PracticalSamples/petstory/README.md b/translations/ne/04-PracticalSamples/petstory/README.md index 9f2c8d14..c3953b59 100644 --- a/translations/ne/04-PracticalSamples/petstory/README.md +++ b/translations/ne/04-PracticalSamples/petstory/README.md @@ -1,12 +1,3 @@ - # पेट स्टोरी जनरेटर ट्युटोरियल शुरुवातका लागि ## सामग्री सूची diff --git a/translations/ne/05-ResponsibleGenAI/README.md b/translations/ne/05-ResponsibleGenAI/README.md index b7aabbec..92bfbfa6 100644 --- a/translations/ne/05-ResponsibleGenAI/README.md +++ b/translations/ne/05-ResponsibleGenAI/README.md @@ -1,12 +1,3 @@ - # जिम्मेवार जेनेरेटिभ एआई ## तपाईंले के सिक्नुहुनेछ diff --git a/translations/ne/AGENTS.md b/translations/ne/AGENTS.md index ee2486a4..3f82f50f 100644 --- a/translations/ne/AGENTS.md +++ b/translations/ne/AGENTS.md @@ -1,12 +1,3 @@ - # AGENTS.md ## परियोजना अवलोकन diff --git a/translations/ne/CODE_OF_CONDUCT.md b/translations/ne/CODE_OF_CONDUCT.md index 97cb8a13..b4d62a06 100644 --- a/translations/ne/CODE_OF_CONDUCT.md +++ b/translations/ne/CODE_OF_CONDUCT.md @@ -1,12 +1,3 @@ - # माइक्रोसफ्ट ओपन सोर्स आचारसंहिता यस परियोजनाले [माइक्रोसफ्ट ओपन सोर्स आचारसंहिता](https://opensource.microsoft.com/codeofconduct/) अपनाएको छ। diff --git a/translations/ne/README.md b/translations/ne/README.md index a0eb323b..c26293c2 100644 --- a/translations/ne/README.md +++ b/translations/ne/README.md @@ -1,146 +1,139 @@ - -# शूरुआतीहरूका लागि जनरेटिव एआई - जाभा संस्करण +# शुरुवातीहरूको लागि जेनेरेटिभ AI - जाभा संस्करण [![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) -![शूरुआतीहरूका लागि जनरेटिव एआई - जाभा संस्करण](../../translated_images/ne/beg-genai-series.8b48be9951cc574c.webp) +![Generative AI for Beginners - Java Edition](../../translated_images/ne/beg-genai-series.8b48be9951cc574c.webp) -**समय प्रतिबद्धता**: सम्पूर्ण कार्यशाला अनलाइन कुनै स्थानीय सेटअप बिना पूरा गर्न सकिन्छ। वातावरण सेटअप गर्न २ मिनेट लाग्छ, नमूनाहरू अन्वेषण गर्न १-३ घण्टा लाग्छ खोजी गहिराइ अनुसार। +**समय प्रतिबद्धता**: सम्पूर्ण कार्यशाला अनलाइन सम्पूर्ण रूपमा स्थानीय सेटअप बिना सम्पन्न गर्न सकिन्छ। वातावरण सेटअपमा २ मिनेट लाग्छ, नमूनाहरू अन्वेषण गर्न १-३ घण्टा लाग्न सक्छ जसले अन्वेषणको गहिराईमा निर्भर गर्दछ। -> **छिटो सुरुवात** +> **छिटो सुरु गर्ने तरिका** -1. यो रिपोजिटरी आफ्नो GitHub खातामा फोर्क गर्नुहोस् -2. क्लिक गर्नुहोस् **Code** → **Codespaces** ट्याब → **...** → **New with options...** -3. पूर्वनिर्धारितहरू प्रयोग गर्नुहोस् – यसले यस कोर्सको लागि सिर्जना गरिएको विकास कन्टेनर चयन गर्दछ -4. क्लिक गर्नुहोस् **Create codespace** -5. वातावरण तयार हुन करिब ~२ मिनेट पर्खनुहोस् -6. सिधै जानुहोस् [पहिलो उदाहरण](./02-SetupDevEnvironment/README.md#step-2-create-a-github-personal-access-token) +१. यो रिपोजिटरीलाई आफ्नो GitHub खातामा Fork गर्नुहोस् +२. Click **Code** → **Codespaces** ट्याब → **...** → **New with options...** +३. पूर्वनिर्धारित सेटिङहरू प्रयोग गर्नुहोस् – यसले यस कोर्सका लागि बनाइएको विकास कन्टेनर चयन गर्नेछ +४. Click **Create codespace** +५. ~२ मिनेट पर्खनुहोस्, वातावरण तयार हुनेछ +६. सिधै [पहिलो उदाहरण](./02-SetupDevEnvironment/README.md#step-2-create-a-github-personal-access-token) मा जानुहोस् -> **स्थानीय क्लोन गर्न रुचाउनुहुन्छ?** -> -> यो रिपोजिटरीमा ५०+ भाषा अनुवादहरू समावेश छन् जसले डाउनलोड साइज बढाउँछ। अनुवादहरू बिना क्लोन गर्न, स्पार्स चेकआउट प्रयोग गर्नुहोस्: +> **स्थानीय क्लोन गर्न चाहनुहुन्छ?** +> +> यो रिपोजिटरीमा ५०+ भाषा अनुवादहरू छन् जसले डाउनलोड आकार धेरै बढाउँछ। अनुवाद बिना क्लोन गर्न sparse checkout प्रयोग गर्नुहोस्: > ```bash > git clone --filter=blob:none --sparse https://github.com/microsoft/Generative-AI-for-beginners-java.git > cd Generative-AI-for-beginners-java > git sparse-checkout set --no-cone '/*' '!translations' '!translated_images' > ``` -> यसले तपाईंलाई कोर्स पूरा गर्न आवश्यक सबै कुरा छिटो डाउनलोडसँग दिन्छ। +> यसले कोर्स पूरा गर्न आवश्यक सबै सामग्री छिटो डाउनलोड गर्न दिन्छ। + ## बहु-भाषा समर्थन -### GitHub Action मार्फत समर्थित (स्वचालित र सधैं अद्यावधिक) +### GitHub Action मार्फत समर्थन (स्वचालित र सधैं अद्यावधिक) -[अरेबिक](../ar/README.md) | [बङ्गाली](../bn/README.md) | [बुल्गेरियन](../bg/README.md) | [बर्मिज (म्यानमार)](../my/README.md) | [चिनी (सरलीकृत)](../zh/README.md) | [चिनी (पारम्परिक, होङकङ)](../hk/README.md) | [चिनी (पारम्परिक, मकाउ)](../mo/README.md) | [चिनी (पारम्परिक, ताइवान)](../tw/README.md) | [क्रोएशियन्](../hr/README.md) | [चेक](../cs/README.md) | [ड्यानीश](../da/README.md) | [डच](../nl/README.md) | [एस्टोनियन](../et/README.md) | [फिन्निश](../fi/README.md) | [फ्रेन्च](../fr/README.md) | [जर्मन](../de/README.md) | [ग्रीक](../el/README.md) | [हेब्रू](../he/README.md) | [हिन्दी](../hi/README.md) | [हंगेरियन](../hu/README.md) | [इन्डोनेसियन](../id/README.md) | [इटालियन](../it/README.md) | [जापानी](../ja/README.md) | [कन्नड](../kn/README.md) | [कोरियन](../ko/README.md) | [लिथुनियन](../lt/README.md) | [मलय](../ms/README.md) | [मलयालम](../ml/README.md) | [मराठी](../mr/README.md) | [नेपाली](./README.md) | [नाइजेरियन पिडगिन](../pcm/README.md) | [नर्वेजियन](../no/README.md) | [फारसी (पर्सियन)](../fa/README.md) | [पोलीश](../pl/README.md) | [पोर्चुगिज (ब्राजिल)](../br/README.md) | [पोर्चुगिज (पुर्तगाल)](../pt/README.md) | [पंजाबी (गुरमुखी)](../pa/README.md) | [रोमानियन](../ro/README.md) | [रशियन](../ru/README.md) | [सर्बियन् (सिरिलिक)](../sr/README.md) | [स्लोभाक](../sk/README.md) | [स्लोभेनियन्](../sl/README.md) | [स्पेनी](../es/README.md) | [स्वाहिली](../sw/README.md) | [स्विडिश](../sv/README.md) | [टागालग (फिलिपिनो)](../tl/README.md) | [तमिल](../ta/README.md) | [तेलुगु](../te/README.md) | [थाई](../th/README.md) | [टर्किश](../tr/README.md) | [युक्रेनीयन](../uk/README.md) | [उर्दु](../ur/README.md) | [भियतनामी](../vi/README.md) +[अरबी](../ar/README.md) | [बङ्गाली](../bn/README.md) | [बल्गेरियन](../bg/README.md) | [बर्मी (म्यानमार)](../my/README.md) | [चीनियाँ (सरलीकृत)](../zh-CN/README.md) | [चीनियाँ (परम्परागत, होङकङ)](../zh-HK/README.md) | [चीनियाँ (परम्परागत, मकाउ)](../zh-MO/README.md) | [चीनियाँ (परम्परागत, ताइवान)](../zh-TW/README.md) | [क्रोएशियाली](../hr/README.md) | [चेख](../cs/README.md) | [डेनिश](../da/README.md) | [डच](../nl/README.md) | [एस्टोनियन](../et/README.md) | [फिनिश](../fi/README.md) | [फ्रेन्च](../fr/README.md) | [जर्मन](../de/README.md) | [ग्रिक](../el/README.md) | [हिब्रु](../he/README.md) | [हिन्दी](../hi/README.md) | [हंगेरीयन](../hu/README.md) | [इन्डोनेशियन](../id/README.md) | [इटालियन](../it/README.md) | [जापानी](../ja/README.md) | [कन्नड](../kn/README.md) | [कोरियन](../ko/README.md) | [लिथुआनियन](../lt/README.md) | [मालय](../ms/README.md) | [मलयालम](../ml/README.md) | [मराठी](../mr/README.md) | [नेपाली](./README.md) | [नाइजेरियन पिजिन](../pcm/README.md) | [नर्वेजियन](../no/README.md) | [फारसी (पर्सियन)](../fa/README.md) | [पोलिश](../pl/README.md) | [पोर्चुगिज (ब्राजिल)](../pt-BR/README.md) | [पोर्चुगिज (पोर्चुगल)](../pt-PT/README.md) | [पञ्जाबी (गुरमुखी)](../pa/README.md) | [रोमानियन](../ro/README.md) | [रूसी](../ru/README.md) | [सर्बियन (सिरिलिक)](../sr/README.md) | [स्लोभाक](../sk/README.md) | [स्लोभेनियन](../sl/README.md) | [स्पेनी](../es/README.md) | [स्वाहिली](../sw/README.md) | [स्विडिश](../sv/README.md) | [टागालोग (फिलिपिनो)](../tl/README.md) | [तमिल](../ta/README.md) | [तेलुगु](../te/README.md) | [थाई](../th/README.md) | [टर्किस](../tr/README.md) | [युक्रेनी](../uk/README.md) | [उर्दू](../ur/README.md) | [भियतनामी](../vi/README.md) -> **स्थानीय क्लोन गर्न रुचाउनुहुन्छ?** +> **स्थानीय क्लोन गर्न चाहनुहुन्छ?** -> यो रिपोजिटरीमा ५०+ भाषा अनुवादहरू समावेश छन् जसले डाउनलोड साइज बढाउँछ। अनुवादहरू बिना क्लोन गर्न, स्पार्स चेकआउट प्रयोग गर्नुहोस्: +> यो रिपोजिटरीमा ५०+ भाषा अनुवादहरू छन् जसले डाउनलोड आकार धेरै बढाउँछ। अनुवाद बिना क्लोन गर्न sparse checkout प्रयोग गर्नुहोस्: > ```bash > git clone --filter=blob:none --sparse https://github.com/microsoft/Generative-AI-for-beginners-java.git > cd Generative-AI-for-beginners-java > git sparse-checkout set --no-cone '/*' '!translations' '!translated_images' > ``` -> यसले तपाईंलाई कोर्स पूरा गर्न आवश्यक सबै कुरा छिटो डाउनलोडसँग दिन्छ। +> यसले कोर्स पूरा गर्न आवश्यक सबै सामग्री छिटो डाउनलोड गर्न दिन्छ। -## कोर्स संरचना र सिकाइ मार्ग +## कोर्सको संरचना र सिकाई मार्ग -### **अध्याय १: जनरेटिव एआई परिचय** -- **मुख्य अवधारणाहरू**: ठूलो भाषा मोडेलहरू, टोकनहरू, इम्बेडिङहरू, र एआई क्षमता बुझ्न -- **जाभा एआई इकोसिस्टम**: स्प्रिङ एआई र OpenAI SDKs को अवलोकन -- **मोडेल कन्टेक्स्ट प्रोटोकल**: MCP परिचय र यसको एआई एजेन्ट संचारमा भूमिका -- **व्यावहारिक प्रयोगहरू**: वास्तविक संसारका परिदृश्यहरू जस्तै च्याटबोट र सामग्री उत्पादन +### **अध्याय १: जेनेरेटिभ AI परिचय** +- **मूल अवधारणाहरू**: ठूलो भाषा मोडेल, टोकनहरू, एम्बेडिङहरू, र AI क्षमताहरू बुझ्नुहोस् +- **जाभा AI इकोसिस्टम**: Spring AI र OpenAI SDKs को अवलोकन +- **मोडेल कन्टेक्स्ट प्रोटोकल**: MCP परिचय र AI एजेन्ट संवादमा यसको भूमिका +- **व्यावहारिक अनुप्रयोगहरू**: च्याटबोट्स र सामग्री उत्पादन लगायत वास्तविक संसारका परिदृश्यहरू - **[→ अध्याय १ सुरु गर्नुहोस्](./01-IntroToGenAI/README.md)** ### **अध्याय २: विकास वातावरण सेटअप** -- **बहु-प्रदाता कन्फिगरेसन**: GitHub मोडेलहरू, Azure OpenAI, र OpenAI जाभा SDK संयोजन सेटअप -- **स्प्रिङ बूट + स्प्रिङ एआई**: उद्यम एआई एप विकासका लागि राम्रो अभ्यासहरू -- **GitHub मोडेलहरू**: प्रोटोटाइप तथा सिकाइका लागि निःशुल्क AI मोडेल पहुँच (क्रेडिट कार्ड आवश्यक छैन) -- **विकास उपकरणहरू**: डोकर कन्टेनर, VS Code, र GitHub Codespaces कन्फिगरेसन +- **बहु-प्रदायक कन्फिगरेसन**: GitHub मोडेलहरू, Azure OpenAI, र OpenAI Java SDK एकीकरणहरू सेटअप गर्नुहोस् +- **Spring Boot + Spring AI**: उद्यम AI अनुप्रयोग विकासका लागि सर्वोत्तम अभ्यासहरू +- **GitHub मोडेलहरू**: प्रोटोटाइप र सिक्नको लागि निःशुल्क AI मोडेल पहुँच (क्रेडिट कार्ड आवश्यक छैन) +- **विकास उपकरणहरू**: Docker कन्टेनरहरू, VS Code, र GitHub Codespaces कन्फिगरेसन - **[→ अध्याय २ सुरु गर्नुहोस्](./02-SetupDevEnvironment/README.md)** -### **अध्याय ३: मुख्य जनरेटिव एआई प्रविधिहरू** -- **प्रॉम्प्ट इन्जिनियरिङ**: उत्तम AI मोडेल प्रतिक्रियाहरूका विधिहरू -- **इम्बेडिङ र भेक्टर अपरेसनहरू**: सिमेन्टिक खोज र समानता मिलान कार्यान्वयन -- **रिट्रिभल-अग्मेन्टेड जेनेरेसन (RAG)**: आफ्नो डाटासँग एआई जोड्ने -- **फङ्क्शन कलिङ**: कस्टम उपकरण र प्लगइनहरूसँग एआई क्षमता विस्तार गर्ने +### **अध्याय ३: मुख्य जेनेरेटिभ AI प्रविधिहरू** +- **प्रम्प्ट इन्जिनियरिङ**: उत्तम AI मोडेल प्रतिक्रियाका लागि प्रविधिहरू +- **एम्बेडिङ र भेक्टर अपरेसन**: सिमान्टिक खोज र समानता मिलान कार्यान्वयन गर्नुहोस् +- **रिट्रीभल-अग्मेण्टेड जेनेरेसन (RAG)**: AI र आफ्नो डेटा स्रोतहरू संयोजन गर्नुहोस् +- **फंक्शन कलिङ**: कस्टम उपकरणहरू र प्लगइन्समार्फत AI क्षमताहरू विस्तार गर्नुहोस् - **[→ अध्याय ३ सुरु गर्नुहोस्](./03-CoreGenerativeAITechniques/README.md)** -### **अध्याय ४: व्यावहारिक प्रयोगहरू र प्रोजेक्टहरू** -- **पेट स्टोरी जेनेरेटर** (`petstory/`): GitHub मोडेलहरूसँग रचनात्मक सामग्री उत्पादन -- **फाउन्ड्री लोकल डेमो** (`foundrylocal/`): OpenAI जाभा SDK का साथ स्थानीय AI मोडेल संयोजन -- **MCP क्याल्कुलेटर सेवा** (`calculator/`): स्प्रिङ एआईसँग आधारभूत मोडेल कन्टेक्स्ट प्रोटोकल कार्यान्वयन +### **अध्याय ४: व्यावहारिक अनुप्रयोगहरू र परियोजनाहरू** +- **पाल्तु कथा जेनेरेटर** (`petstory/`): GitHub मोडेलहरूसँग सिर्जनात्मक सामग्री उत्पादन +- **फाउन्ड्री लोकल डेमो** (`foundrylocal/`): OpenAI Java SDK सँग स्थानीय AI मोडेल एकीकरण +- **MCP क्याल्कुलेटर सेवा** (`calculator/`): Spring AI सँग आधारभूत मोडेल कन्टेक्स्ट प्रोटोकल कार्यान्वयन - **[→ अध्याय ४ सुरु गर्नुहोस्](./04-PracticalSamples/README.md)** -### **अध्याय ५: उत्तरदायी एआई विकास** -- **GitHub मोडेलहरू सुरक्षा**: निर्मित सामग्री फिल्टरिङ र सुरक्षा मेकानिजमहरू परीक्षण (कडा ब्लक र मन्द अस्वीकृति) -- **उत्तरदायी एआई डेमो**: आधुनिक एआई सुरक्षा प्रणाली कसरी काम गर्छ भन्ने व्यवहारिक उदाहरण -- **सर्वोत्तम अभ्यासहरू**: नैतिक एआई विकास र परिनियोजनका लागि आवश्यक निर्देशनहरू +### **अध्याय ५: जिम्मेवार AI विकास** +- **GitHub मोडेलहरूको सुरक्षा**: इनबिल्ट सामग्री फिल्टरिङ र सुरक्षा प्रणालीहरू (कडा अवरोध र मृदु अस्वीकृति) परीक्षण गर्नुहोस् +- **जिम्मेवार AI डेमो**: आधुनिक AI सुरक्षा प्रणालीहरू कसरी काम गर्छन् भन्ने व्यावहारिक उदाहरण +- **सर्वोत्तम अभ्यासहरू**: नैतिक AI विकास र परिनियोजनका लागि आवश्यक निर्देशहरू - **[→ अध्याय ५ सुरु गर्नुहोस्](./05-ResponsibleGenAI/README.md)** ## अतिरिक्त स्रोतहरू -### LangChain -[![शूरुआतीहरूका लागि LangChain4j](https://img.shields.io/badge/LangChain4j%20for%20Beginners-22C55E?style=for-the-badge&&labelColor=E5E7EB&color=0553D6)](https://aka.ms/langchain4j-for-beginners) -[![शूरुआतीहरूका लागि LangChain.js](https://img.shields.io/badge/LangChain.js%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=0553D6)](https://aka.ms/langchainjs-for-beginners?WT.mc_id=m365-94501-dwahlin) +### LangChain +[![LangChain4j for Beginners](https://img.shields.io/badge/LangChain4j%20for%20Beginners-22C55E?style=for-the-badge&&labelColor=E5E7EB&color=0553D6)](https://aka.ms/langchain4j-for-beginners) +[![LangChain.js for Beginners](https://img.shields.io/badge/LangChain.js%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=0553D6)](https://aka.ms/langchainjs-for-beginners?WT.mc_id=m365-94501-dwahlin) --- -### Azure / Edge / MCP / Agents -[![शूरुआतीहरूका लागि AZD](https://img.shields.io/badge/AZD%20for%20Beginners-0078D4?style=for-the-badge&labelColor=E5E7EB&color=0078D4)](https://github.com/microsoft/AZD-for-beginners?WT.mc_id=academic-105485-koreyst) -[![शूरुआतीहरूका लागि Edge AI](https://img.shields.io/badge/Edge%20AI%20for%20Beginners-00B8E4?style=for-the-badge&labelColor=E5E7EB&color=00B8E4)](https://github.com/microsoft/edgeai-for-beginners?WT.mc_id=academic-105485-koreyst) -[![शूरुआतीहरूका लागि MCP](https://img.shields.io/badge/MCP%20for%20Beginners-009688?style=for-the-badge&labelColor=E5E7EB&color=009688)](https://github.com/microsoft/mcp-for-beginners?WT.mc_id=academic-105485-koreyst) -[![शूरुआतीहरूका लागि AI एजेन्टहरू](https://img.shields.io/badge/AI%20Agents%20for%20Beginners-00C49A?style=for-the-badge&labelColor=E5E7EB&color=00C49A)](https://github.com/microsoft/ai-agents-for-beginners?WT.mc_id=academic-105485-koreyst) +### Azure / Edge / MCP / एजेन्टहरू +[![AZD for Beginners](https://img.shields.io/badge/AZD%20for%20Beginners-0078D4?style=for-the-badge&labelColor=E5E7EB&color=0078D4)](https://github.com/microsoft/AZD-for-beginners?WT.mc_id=academic-105485-koreyst) +[![Edge AI for Beginners](https://img.shields.io/badge/Edge%20AI%20for%20Beginners-00B8E4?style=for-the-badge&labelColor=E5E7EB&color=00B8E4)](https://github.com/microsoft/edgeai-for-beginners?WT.mc_id=academic-105485-koreyst) +[![MCP for Beginners](https://img.shields.io/badge/MCP%20for%20Beginners-009688?style=for-the-badge&labelColor=E5E7EB&color=009688)](https://github.com/microsoft/mcp-for-beginners?WT.mc_id=academic-105485-koreyst) +[![AI Agents for Beginners](https://img.shields.io/badge/AI%20Agents%20for%20Beginners-00C49A?style=for-the-badge&labelColor=E5E7EB&color=00C49A)](https://github.com/microsoft/ai-agents-for-beginners?WT.mc_id=academic-105485-koreyst) --- - -### जनरेटिव एआई सिरिज -[![शूरुआतीहरूका लागि जनरेटिव एआई](https://img.shields.io/badge/Generative%20AI%20for%20Beginners-8B5CF6?style=for-the-badge&labelColor=E5E7EB&color=8B5CF6)](https://github.com/microsoft/generative-ai-for-beginners?WT.mc_id=academic-105485-koreyst) -[![जनरेटिव एआई (.NET)](https://img.shields.io/badge/Generative%20AI%20(.NET)-9333EA?style=for-the-badge&labelColor=E5E7EB&color=9333EA)](https://github.com/microsoft/Generative-AI-for-beginners-dotnet?WT.mc_id=academic-105485-koreyst) -[![जनरेटिव एआई (जाभा)](https://img.shields.io/badge/Generative%20AI%20(Java)-C084FC?style=for-the-badge&labelColor=E5E7EB&color=C084FC)](https://github.com/microsoft/generative-ai-for-beginners-java?WT.mc_id=academic-105485-koreyst) -[![जनरेटिव एआई (जाभास्क्रिप्ट)](https://img.shields.io/badge/Generative%20AI%20(JavaScript)-E879F9?style=for-the-badge&labelColor=E5E7EB&color=E879F9)](https://github.com/microsoft/generative-ai-with-javascript?WT.mc_id=academic-105485-koreyst) + +### जेनेरेटिभ AI श्रृंखला +[![Generative AI for Beginners](https://img.shields.io/badge/Generative%20AI%20for%20Beginners-8B5CF6?style=for-the-badge&labelColor=E5E7EB&color=8B5CF6)](https://github.com/microsoft/generative-ai-for-beginners?WT.mc_id=academic-105485-koreyst) +[![Generative AI (.NET)](https://img.shields.io/badge/Generative%20AI%20(.NET)-9333EA?style=for-the-badge&labelColor=E5E7EB&color=9333EA)](https://github.com/microsoft/Generative-AI-for-beginners-dotnet?WT.mc_id=academic-105485-koreyst) +[![Generative AI (Java)](https://img.shields.io/badge/Generative%20AI%20(Java)-C084FC?style=for-the-badge&labelColor=E5E7EB&color=C084FC)](https://github.com/microsoft/generative-ai-for-beginners-java?WT.mc_id=academic-105485-koreyst) +[![Generative AI (JavaScript)](https://img.shields.io/badge/Generative%20AI%20(JavaScript)-E879F9?style=for-the-badge&labelColor=E5E7EB&color=E879F9)](https://github.com/microsoft/generative-ai-with-javascript?WT.mc_id=academic-105485-koreyst) --- - -### मुख्य सिकाइ -[![शूरुआतीहरूका लागि ML](https://img.shields.io/badge/ML%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=22C55E)](https://aka.ms/ml-beginners?WT.mc_id=academic-105485-koreyst) -[![शूरुआतीहरूका लागि डाटा साइन्स](https://img.shields.io/badge/Data%20Science%20for%20Beginners-84CC16?style=for-the-badge&labelColor=E5E7EB&color=84CC16)](https://aka.ms/datascience-beginners?WT.mc_id=academic-105485-koreyst) -[![शूरुआतीहरूका लागि एआई](https://img.shields.io/badge/AI%20for%20Beginners-A3E635?style=for-the-badge&labelColor=E5E7EB&color=A3E635)](https://aka.ms/ai-beginners?WT.mc_id=academic-105485-koreyst) -[![शूरुआतीहरूका लागि साइबरसुरक्षा](https://img.shields.io/badge/Cybersecurity%20for%20Beginners-F97316?style=for-the-badge&labelColor=E5E7EB&color=F97316)](https://github.com/microsoft/Security-101?WT.mc_id=academic-96948-sayoung) -[![शूरुआतीहरूका लागि वेब विकास](https://img.shields.io/badge/Web%20Dev%20for%20Beginners-EC4899?style=for-the-badge&labelColor=E5E7EB&color=EC4899)](https://aka.ms/webdev-beginners?WT.mc_id=academic-105485-koreyst) -[![IoT for Beginners](https://img.shields.io/badge/IoT%20for%20Beginners-14B8A6?style=for-the-badge&labelColor=E5E7EB&color=14B8A6)](https://aka.ms/iot-beginners?WT.mc_id=academic-105485-koreyst) -[![XR Development for Beginners](https://img.shields.io/badge/XR%20Development%20for%20Beginners-38BDF8?style=for-the-badge&labelColor=E5E7EB&color=38BDF8)](https://github.com/microsoft/xr-development-for-beginners?WT.mc_id=academic-105485-koreyst) + +### मुख्य सिकाई +[![ML for Beginners](https://img.shields.io/badge/ML%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=22C55E)](https://aka.ms/ml-beginners?WT.mc_id=academic-105485-koreyst) +[![Data Science for Beginners](https://img.shields.io/badge/Data%20Science%20for%20Beginners-84CC16?style=for-the-badge&labelColor=E5E7EB&color=84CC16)](https://aka.ms/datascience-beginners?WT.mc_id=academic-105485-koreyst) +[![AI for Beginners](https://img.shields.io/badge/AI%20for%20Beginners-A3E635?style=for-the-badge&labelColor=E5E7EB&color=A3E635)](https://aka.ms/ai-beginners?WT.mc_id=academic-105485-koreyst) +[![Cybersecurity for Beginners](https://img.shields.io/badge/Cybersecurity%20for%20Beginners-F97316?style=for-the-badge&labelColor=E5E7EB&color=F97316)](https://github.com/microsoft/Security-101?WT.mc_id=academic-96948-sayoung) + +[![शुरुआतीहरूको लागि वेब विकास](https://img.shields.io/badge/Web%20Dev%20for%20Beginners-EC4899?style=for-the-badge&labelColor=E5E7EB&color=EC4899)](https://aka.ms/webdev-beginners?WT.mc_id=academic-105485-koreyst) +[![शुरुआतीहरूको लागि IoT](https://img.shields.io/badge/IoT%20for%20Beginners-14B8A6?style=for-the-badge&labelColor=E5E7EB&color=14B8A6)](https://aka.ms/iot-beginners?WT.mc_id=academic-105485-koreyst) +[![शुरुआतीहरूको लागि XR विकास](https://img.shields.io/badge/XR%20Development%20for%20Beginners-38BDF8?style=for-the-badge&labelColor=E5E7EB&color=38BDF8)](https://github.com/microsoft/xr-development-for-beginners?WT.mc_id=academic-105485-koreyst) --- -### Copilot श्रृंखला -[![Copilot for AI Paired Programming](https://img.shields.io/badge/Copilot%20for%20AI%20Paired%20Programming-FACC15?style=for-the-badge&labelColor=E5E7EB&color=FACC15)](https://aka.ms/GitHubCopilotAI?WT.mc_id=academic-105485-koreyst) -[![Copilot for C#/.NET](https://img.shields.io/badge/Copilot%20for%20C%23/.NET-FBBF24?style=for-the-badge&labelColor=E5E7EB&color=FBBF24)](https://github.com/microsoft/mastering-github-copilot-for-dotnet-csharp-developers?WT.mc_id=academic-105485-koreyst) -[![Copilot Adventure](https://img.shields.io/badge/Copilot%20Adventure-FDE68A?style=for-the-badge&labelColor=E5E7EB&color=FDE68A)](https://github.com/microsoft/CopilotAdventures?WT.mc_id=academic-105485-koreyst) +### कोपाइलट सिरिज +[![AI जोडी प्रोग्रामिङको लागि कोपाइलट](https://img.shields.io/badge/Copilot%20for%20AI%20Paired%20Programming-FACC15?style=for-the-badge&labelColor=E5E7EB&color=FACC15)](https://aka.ms/GitHubCopilotAI?WT.mc_id=academic-105485-koreyst) +[![C#/.NET कोपाइलट](https://img.shields.io/badge/Copilot%20for%20C%23/.NET-FBBF24?style=for-the-badge&labelColor=E5E7EB&color=FBBF24)](https://github.com/microsoft/mastering-github-copilot-for-dotnet-csharp-developers?WT.mc_id=academic-105485-koreyst) +[![कोपाइलट साहसिक](https://img.shields.io/badge/Copilot%20Adventure-FDE68A?style=for-the-badge&labelColor=E5E7EB&color=FDE68A)](https://github.com/microsoft/CopilotAdventures?WT.mc_id=academic-105485-koreyst) -## मद्दत पाउनुहोस् +## सहायता प्राप्त गर्ने -यदि तपाईं अल्झनुहुन्छ वा AI अनुप्रयोगहरू निर्माण गर्दा कुनै पनि प्रश्नहरू छन् भने। MCP सम्बन्धी छलफलहरूमा सहभागी हुनुहोस् जहाँ अन्य सिक्नेहरु र अनुभवी विकासकर्ताहरू छन्। यो एक सहयोगी समुदाय हो जहाँ प्रश्नहरू स्वागतयोग्य छन् र ज्ञान स्वतन्त्र रूपमा साझा गरिन्छ। +यदि तपाईं अल्झनु भयो वा AI एपहरू बनाउने बारे कुनै प्रश्न छ भने। अन्य सिक्नेहरू र अनुभवी विकासकर्ताहरूसँग MCP सम्बन्धी छलफलमा सामेल हुनुहोस्। यो एक सहयोगी समुदाय हो जहाँ प्रश्नहरू स्वागतयोग्य छन् र ज्ञान स्वतन्त्र रूपमा साझा गरिन्छ। [![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) -यदि तपाईंलाई उत्पादन प्रतिक्रियाहरू वा त्रुटिहरू छन् भने निर्माण गर्दा यहाँ जानुहोस्: +यदि तपाईंलाई उत्पादन प्रतिक्रिया वा बनाउने क्रममा त्रुटिहरू भएमा भ्रमण गर्नुहोस्: [![Microsoft Foundry Developer Forum](https://img.shields.io/badge/GitHub-Microsoft_Foundry_Developer_Forum-blue?style=for-the-badge&logo=github&color=000000&logoColor=fff)](https://aka.ms/foundry/forum) --- -**अस्वीकरण**: -यो दस्तावेज एआई अनुवाद सेवा [Co-op Translator](https://github.com/Azure/co-op-translator) प्रयोग गरी अनुवाद गरिएको हो। हामी सटीकता को लागी प्रयास गर्छौ, तर कृपया बुझ्नुहोस् कि स्वचालित अनुवादमा त्रुटि वा अशुद्धि हुन सक्छ। मूल दस्तावेज यसको मूल भाषामा आधिकारिक स्रोत मानिनु पर्छ। महत्त्वपूर्ण जानकारीको लागि, व्यावसायिक मानव अनुवाद सिफारिस गरिन्छ। यस अनुवाद प्रयोगबाट हुने कुनै पनि गलतफहमी वा गलत व्याख्याको जिम्मेवारी हामी लिँदैनौं। +**अस्वीकरण**: +यो दस्तावेज़ AI अनुवाद सेवा [Co-op Translator](https://github.com/Azure/co-op-translator) प्रयोग गरी अनुवाद गरिएको हो। हामी शुद्धताको प्रयास गर्छौं, तर कृपया बुझ्नुहोस् कि स्वचालित अनुवादमा त्रुटि वा अशुद्धता हुन सक्दछ। मूल दस्तावेज़ यसको मूल भाषामा नै आधिकारिक स्रोत मानिनेछ। महत्वपूर्ण जानकारीको लागि व्यावसायिक मानव अनुवाद सिफारिस गरिन्छ। यस अनुवादको प्रयोगबाट हुने कुनै पनि गलतफहमी वा गलत व्याख्याका लागि हामी जिम्मेवार हुनेछैनौं। \ No newline at end of file diff --git a/translations/ne/SECURITY.md b/translations/ne/SECURITY.md index e0c9e92f..ec171845 100644 --- a/translations/ne/SECURITY.md +++ b/translations/ne/SECURITY.md @@ -1,12 +1,3 @@ - ## सुरक्षा माइक्रोसफ्टले आफ्ना सफ्टवेयर उत्पादन र सेवाहरूको सुरक्षा गम्भीरताका साथ लिन्छ, जसमा हाम्रो GitHub संगठनहरू मार्फत व्यवस्थापन गरिएका सबै स्रोत कोड रिपोजिटरीहरू समावेश छन्, जस्तै [Microsoft](https://github.com/Microsoft), [Azure](https://github.com/Azure), [DotNet](https://github.com/dotnet), [AspNet](https://github.com/aspnet) र [Xamarin](https://github.com/xamarin)। diff --git a/translations/ne/SUPPORT.md b/translations/ne/SUPPORT.md index 81184975..646443a0 100644 --- a/translations/ne/SUPPORT.md +++ b/translations/ne/SUPPORT.md @@ -1,12 +1,3 @@ - # समर्थन ## समस्या दर्ता गर्ने र सहयोग प्राप्त गर्ने तरिका diff --git a/translations/nl/.co-op-translator.json b/translations/nl/.co-op-translator.json new file mode 100644 index 00000000..be939f4c --- /dev/null +++ b/translations/nl/.co-op-translator.json @@ -0,0 +1,92 @@ +{ + "01-IntroToGenAI/README.md": { + "original_hash": "75bfb080ca725e8a9aa9c80cae25fba1", + "translation_date": "2025-07-29T09:36:18+00:00", + "source_file": "01-IntroToGenAI/README.md", + "language_code": "nl" + }, + "02-SetupDevEnvironment/README.md": { + "original_hash": "96a30d42b9751a3d4e4b20e28d29d459", + "translation_date": "2026-01-28T05:07:14+00:00", + "source_file": "02-SetupDevEnvironment/README.md", + "language_code": "nl" + }, + "02-SetupDevEnvironment/examples/basic-chat-azure/README.md": { + "original_hash": "efd82efe50711d7e257eb943151d682c", + "translation_date": "2025-07-27T13:43:30+00:00", + "source_file": "02-SetupDevEnvironment/examples/basic-chat-azure/README.md", + "language_code": "nl" + }, + "02-SetupDevEnvironment/getting-started-azure-openai.md": { + "original_hash": "bfdb4b4eadbee3a59ef742439f58326a", + "translation_date": "2025-07-27T13:16:19+00:00", + "source_file": "02-SetupDevEnvironment/getting-started-azure-openai.md", + "language_code": "nl" + }, + "03-CoreGenerativeAITechniques/README.md": { + "original_hash": "685f55cb07de19b52a30ce6e8b6d889e", + "translation_date": "2025-08-28T22:09:50+00:00", + "source_file": "03-CoreGenerativeAITechniques/README.md", + "language_code": "nl" + }, + "04-PracticalSamples/README.md": { + "original_hash": "14c0a61ecc1cd2012a9c129236dfdf71", + "translation_date": "2025-07-29T09:36:03+00:00", + "source_file": "04-PracticalSamples/README.md", + "language_code": "nl" + }, + "04-PracticalSamples/calculator/README.md": { + "original_hash": "b6c16b5514d524e415a94f6097ee7d4c", + "translation_date": "2025-09-18T15:35:35+00:00", + "source_file": "04-PracticalSamples/calculator/README.md", + "language_code": "nl" + }, + "04-PracticalSamples/foundrylocal/README.md": { + "original_hash": "f787307400de59adc25a1404466a35f3", + "translation_date": "2025-11-04T07:28:22+00:00", + "source_file": "04-PracticalSamples/foundrylocal/README.md", + "language_code": "nl" + }, + "04-PracticalSamples/petstory/README.md": { + "original_hash": "0cbf68d605615a1e602c832a24616859", + "translation_date": "2025-07-25T11:37:22+00:00", + "source_file": "04-PracticalSamples/petstory/README.md", + "language_code": "nl" + }, + "05-ResponsibleGenAI/README.md": { + "original_hash": "301c05c2f57e60a6950b8c665b8bdbba", + "translation_date": "2025-07-29T15:54:11+00:00", + "source_file": "05-ResponsibleGenAI/README.md", + "language_code": "nl" + }, + "AGENTS.md": { + "original_hash": "afc90918d008cf77fd1982691f681306", + "translation_date": "2025-10-03T08:38:50+00:00", + "source_file": "AGENTS.md", + "language_code": "nl" + }, + "CODE_OF_CONDUCT.md": { + "original_hash": "442b123d034f92f7c384d2bbd28f99f1", + "translation_date": "2025-07-21T19:08:38+00:00", + "source_file": "CODE_OF_CONDUCT.md", + "language_code": "nl" + }, + "README.md": { + "original_hash": "125a08948d881c95628094f4dd1fbd43", + "translation_date": "2026-01-29T15:56:45+00:00", + "source_file": "README.md", + "language_code": "nl" + }, + "SECURITY.md": { + "original_hash": "57f14126c1c6add76b3aef3844dfe4e3", + "translation_date": "2025-07-21T19:06:49+00:00", + "source_file": "SECURITY.md", + "language_code": "nl" + }, + "SUPPORT.md": { + "original_hash": "b8ef73cc49dec68e2c885ee9df545129", + "translation_date": "2025-07-21T19:09:46+00:00", + "source_file": "SUPPORT.md", + "language_code": "nl" + } +} \ No newline at end of file diff --git a/translations/nl/01-IntroToGenAI/README.md b/translations/nl/01-IntroToGenAI/README.md index c639c519..86d6984a 100644 --- a/translations/nl/01-IntroToGenAI/README.md +++ b/translations/nl/01-IntroToGenAI/README.md @@ -1,12 +1,3 @@ - # Introductie tot Generatieve AI - Java Editie ## Wat Je Gaat Leren diff --git a/translations/nl/02-SetupDevEnvironment/README.md b/translations/nl/02-SetupDevEnvironment/README.md index 515c0d70..966858ea 100644 --- a/translations/nl/02-SetupDevEnvironment/README.md +++ b/translations/nl/02-SetupDevEnvironment/README.md @@ -1,13 +1,254 @@ - +# Het opzetten van de ontwikkelomgeving voor Generatieve AI voor Java +> **Snel aan de slag**: codeer in de cloud binnen 2 minuten - Ga naar [GitHub Codespaces Setup](../../../02-SetupDevEnvironment) - geen lokale installatie nodig en gebruikt GitHub-modellen! + +> **Geïnteresseerd in Azure OpenAI?**, zie onze [Azure OpenAI Setup Guide](getting-started-azure-openai.md) met stappen om een nieuwe Azure OpenAI-resource aan te maken. + +## Wat je zult leren + +- Een Java-ontwikkelomgeving opzetten voor AI-toepassingen +- Kies en configureer je voorkeursontwikkelomgeving (cloud-first met Codespaces, lokale devcontainer of volledige lokale setup) +- Test je setup door verbinding te maken met GitHub Models + +## Inhoudsopgave + +- [Wat je zult leren](../../../02-SetupDevEnvironment) +- [Introductie](../../../02-SetupDevEnvironment) +- [Stap 1: Zet je ontwikkelomgeving op](../../../02-SetupDevEnvironment) + - [Optie A: GitHub Codespaces (Aanbevolen)](../../../02-SetupDevEnvironment) + - [Optie B: Lokale Dev Container](../../../02-SetupDevEnvironment) + - [Optie C: Gebruik je bestaande lokale installatie](../../../02-SetupDevEnvironment) +- [Stap 2: Maak een GitHub Personal Access Token aan](../../../02-SetupDevEnvironment) +- [Stap 3: Test je setup](../../../02-SetupDevEnvironment) +- [Probleemoplossing](../../../02-SetupDevEnvironment) +- [Samenvatting](../../../02-SetupDevEnvironment) +- [Volgende stappen](../../../02-SetupDevEnvironment) + +## Introductie + +Dit hoofdstuk leidt je door het opzetten van een ontwikkelomgeving. We gebruiken **GitHub Models** als ons belangrijkste voorbeeld omdat het gratis is, gemakkelijk op te zetten met alleen een GitHub-account, geen creditcard vereist en toegang biedt tot meerdere modellen om te experimenteren. + +**Geen lokale installatie nodig!** Je kunt meteen beginnen met coderen via GitHub Codespaces, die een volledige ontwikkelomgeving in je browser levert. + +Screenshot: GitHub Models + +We raden aan om [**GitHub Models**](https://github.com/marketplace?type=models) te gebruiken voor deze cursus omdat het: +- **Gratis** is om te starten +- **Gemakkelijk** op te zetten met alleen een GitHub-account +- **Geen creditcard** nodig heeft +- **Meerdere modellen** beschikbaar heeft om mee te experimenteren + +> **Opmerking**: De GitHub Models die in deze training worden gebruikt hebben deze gratis limieten: +> - 15 verzoeken per minuut (150 per dag) +> - ~8.000 woorden in, ~4.000 woorden uit per verzoek +> - 5 gelijktijdige verzoeken +> +> Voor productiegebruik upgrade je naar Azure AI Foundry Models met je Azure-account. Je code hoeft niet te worden aangepast. Zie de [Azure AI Foundry documentatie](https://learn.microsoft.com/azure/ai-foundry/foundry-models/how-to/quickstart-github-models). + + +## Stap 1: Zet je ontwikkelomgeving op + + + +We hebben een vooraf geconfigureerde ontwikkelcontainer gemaakt om de setup tijd te minimaliseren en ervoor te zorgen dat je alle benodigde tools hebt voor deze Generatieve AI voor Java cursus. Kies je voorkeursontwikkelwijze: + +### Opties voor omgevingssetup: + +#### Optie A: GitHub Codespaces (Aanbevolen) + +**Begin met coderen in 2 minuten - geen lokale setup nodig!** + +1. Fork deze repository naar je GitHub-account + > **Opmerking**: Als je de basisconfiguratie wilt bewerken, kijk dan naar de [Dev Container Configuration](../../../.devcontainer/devcontainer.json) +2. Klik op **Code** → tabblad **Codespaces** → **...** → **Nieuw met opties...** +3. Gebruik de standaardinstellingen – dit selecteert de **Dev container configuratie**: **Generative AI Java Development Environment** custom devcontainer gemaakt voor deze cursus +4. Klik op **Codespace aanmaken** +5. Wacht ~2 minuten tot de omgeving klaar is +6. Ga verder naar [Stap 2: Maak GitHub Token aan](../../../02-SetupDevEnvironment) + +Screenshot: Codespaces submenu + +Screenshot: Nieuw met opties + +Screenshot: Maak codespace opties + + +> **Voordelen van Codespaces**: +> - Geen lokale installatie nodig +> - Werkt op elk apparaat met een browser +> - Vooraf geconfigureerd met alle tools en afhankelijkheden +> - Gratis 60 uur per maand voor persoonlijke accounts +> - Consistente omgeving voor alle cursisten + +#### Optie B: Lokale Dev Container + +**Voor ontwikkelaars die lokaal met Docker willen werken** + +1. Fork en clone deze repository naar je lokale machine + > **Opmerking**: Als je de basisconfiguratie wilt bewerken, kijk dan naar de [Dev Container Configuration](../../../.devcontainer/devcontainer.json) +2. Installeer [Docker Desktop](https://www.docker.com/products/docker-desktop/) en [VS Code](https://code.visualstudio.com/) +3. Installeer de [Dev Containers-extensie](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers) in VS Code +4. Open de repository-map in VS Code +5. Wanneer gevraagd, klik op **Opnieuw openen in container** (of gebruik `Ctrl+Shift+P` → "Dev Containers: Opnieuw openen in container") +6. Wacht tot de container wordt opgebouwd en gestart +7. Ga verder naar [Stap 2: Maak GitHub Token aan](../../../02-SetupDevEnvironment) + +Screenshot: Dev container setup + +Screenshot: Dev container build compleet + +#### Optie C: Gebruik je bestaande lokale installatie + +**Voor ontwikkelaars met bestaande Java-omgevingen** + +Vereisten: +- [Java 21+](https://www.oracle.com/java/technologies/javase/jdk21-archive-downloads.html) +- [Maven 3.9+](https://maven.apache.org/download.cgi) +- [VS Code](https://code.visualstudio.com) of je favoriete IDE + +Stappen: +1. Clone deze repository naar je lokale machine +2. Open het project in je IDE +3. Ga verder naar [Stap 2: Maak GitHub Token aan](../../../02-SetupDevEnvironment) + +> **Protip**: Heb je een low-spec machine maar wil je VS Code lokaal gebruiken? Gebruik dan GitHub Codespaces! Je kunt je lokale VS Code verbinden met een cloud-gehoste Codespace voor het beste van twee werelden. + +Screenshot: aangemaakte lokale devcontainer instance + + +## Stap 2: Maak een GitHub Personal Access Token aan + +1. Ga naar [GitHub Settings](https://github.com/settings/profile) en selecteer **Settings** in je profielmenu. +2. Klik in de linkerzijbalk op **Developer settings** (meestal onderaan). +3. Onder **Personal access tokens**, klik op **Fine-grained tokens** (of volg deze directe [link](https://github.com/settings/personal-access-tokens)). +4. Klik op **Generate new token**. +5. Geef onder "Token name" een beschrijvende naam op (bijv. `GenAI-Java-Course-Token`). +6. Stel een vervaldatum in (aanbevolen: 7 dagen voor beveiligingsredenen). +7. Onder "Resource owner" selecteer je je gebruikersaccount. +8. Onder "Repository access" selecteer je de repositories die je wilt gebruiken met GitHub Models (of "All repositories" indien nodig). +9. Onder "Account permissions" zoek **Models** en zet dit op **Read-only**. +10. Klik op **Generate token**. +11. **Kopieer en sla je token nu op** – je zult het daarna niet meer zien! + +> **Beveiligingstip**: Gebruik de minimaal vereiste scope en de kortst mogelijke vervaltijd voor je toegangstokens. + +## Stap 3: Test je setup met het GitHub Models voorbeeld + +Zodra je ontwikkelomgeving klaar is, testen we de GitHub Models-integratie met onze voorbeeldapplicatie in [`02-SetupDevEnvironment/examples/github-models`](../../../02-SetupDevEnvironment/examples/github-models). + +1. Open de terminal in je ontwikkelomgeving. +2. Navigeer naar het GitHub Models voorbeeld: + ```bash + cd 02-SetupDevEnvironment/examples/github-models + ``` +3. Stel je GitHub-token in als omgevingsvariabele: + ```bash + # macOS/Linux + export GITHUB_TOKEN=your_token_here + + # Windows (Opdrachtprompt) + set GITHUB_TOKEN=your_token_here + + # Windows (PowerShell) + $env:GITHUB_TOKEN="your_token_here" + ``` + +4. Start de applicatie: + ```bash + mvn compile exec:java -Dexec.mainClass="com.example.githubmodels.App" + ``` + +Je zou een output moeten zien zoals: +```text +Using model: gpt-4.1-nano +Sending request to GitHub Models... +Response: Hello World! +``` + +### Het voorbeeldcode begrijpen + +Laten we eerst begrijpen wat we zojuist draaiden. Het voorbeeld in `examples/github-models` gebruikt de OpenAI Java SDK om verbinding te maken met GitHub Models: + +**Wat deze code doet:** +- **Verbindt** met GitHub Models met je personal access token +- **Stuurt** een simpele "Say Hello World!"-boodschap naar het AI-model +- **Ontvangt** en toont het antwoord van de AI +- **Verifieert** dat je setup correct werkt + +**Belangrijke afhankelijkheid** (in `pom.xml`): +```xml + + com.openai + openai-java + 2.12.0 + +``` + +**Hoofdcode** (`App.java`): +```java +// Verbinden met GitHub-modellen met behulp van OpenAI Java SDK +OpenAIClient client = OpenAIOkHttpClient.builder() + .apiKey(pat) + .baseUrl("https://models.inference.ai.azure.com") + .build(); + +// Maak een chatvoltooiingsverzoek aan +ChatCompletionCreateParams params = ChatCompletionCreateParams.builder() + .model(modelId) + .addSystemMessage("You are a concise assistant.") + .addUserMessage("Say Hello World!") + .build(); + +// Krijg AI-antwoord +ChatCompletion response = client.chat().completions().create(params); +System.out.println("Response: " + response.choices().get(0).message().content().orElse("No response content")); +``` + +## Samenvatting + +Geweldig! Je hebt nu alles opgezet: + +- Een GitHub Personal Access Token aangemaakt met de juiste permissies voor AI-modeltoegang +- Je Java-ontwikkelomgeving draaiende gekregen (of dat nu Codespaces, devcontainers of lokaal is) +- Verbonden met GitHub Models via de OpenAI Java SDK voor gratis AI-ontwikkeling +- Getest dat alles werkt met een eenvoudig voorbeeld dat met AI-modellen communiceert + +## Volgende stappen + +[Hoofdstuk 3: Kerntechnieken van Generatieve AI](../03-CoreGenerativeAITechniques/README.md) + +## Probleemoplossing + +Problemen? Hier zijn veelvoorkomende problemen en oplossingen: + +- **Token werkt niet?** + - Controleer of je de volledige token hebt gekopieerd zonder extra spaties + - Controleer of de token correct als omgevingsvariabele is ingesteld + - Controleer of je token de juiste permissies heeft (Models: Read-only) + +- **Maven niet gevonden?** + - Bij gebruik van devcontainers/Codespaces zou Maven vooraf geïnstalleerd moeten zijn + - Voor lokale setup, zorg dat Java 21+ en Maven 3.9+ geïnstalleerd zijn + - Probeer `mvn --version` om de installatie te verifiëren + +- **Verbindingsproblemen?** + - Controleer je internetverbinding + - Controleer of GitHub bereikbaar is vanaf je netwerk + - Zorg dat je niet achter een firewall zit die het GitHub Models endpoint blokkeert + +- **Dev container start niet?** + - Zorg dat Docker Desktop draait (voor lokale ontwikkeling) + - Probeer de container opnieuw te bouwen: `Ctrl+Shift+P` → "Dev Containers: Rebuild Container" + +- **Applicatie compileerfouten?** + - Zorg dat je in de juiste map zit: `02-SetupDevEnvironment/examples/github-models` + - Probeer schoon te maken en opnieuw te bouwen: `mvn clean compile` + +> **Hulp nodig?**: Heb je nog steeds problemen? Maak een issue aan in de repository en we helpen je graag verder. --- + +**Disclaimer**: +Dit document is vertaald met behulp van de AI-vertalingsdienst [Co-op Translator](https://github.com/Azure/co-op-translator). Hoewel wij streven naar nauwkeurigheid, dient u er rekening mee te houden dat geautomatiseerde vertalingen fouten of onjuistheden kunnen bevatten. Het originele document in de oorspronkelijke taal wordt beschouwd als de gezaghebbende bron. Voor kritieke informatie wordt een professionele menselijke vertaling aanbevolen. Wij zijn niet aansprakelijk voor eventuele misverstanden of verkeerde interpretaties die voortvloeien uit het gebruik van deze vertaling. + \ No newline at end of file diff --git a/translations/nl/02-SetupDevEnvironment/examples/basic-chat-azure/README.md b/translations/nl/02-SetupDevEnvironment/examples/basic-chat-azure/README.md index 725c34cc..55e21016 100644 --- a/translations/nl/02-SetupDevEnvironment/examples/basic-chat-azure/README.md +++ b/translations/nl/02-SetupDevEnvironment/examples/basic-chat-azure/README.md @@ -1,12 +1,3 @@ - # Basis Chat met Azure OpenAI - End-to-End Voorbeeld Dit voorbeeld laat zien hoe je een eenvoudige Spring Boot-applicatie maakt die verbinding maakt met Azure OpenAI en je setup test. diff --git a/translations/nl/02-SetupDevEnvironment/getting-started-azure-openai.md b/translations/nl/02-SetupDevEnvironment/getting-started-azure-openai.md index 1e304fb4..77599e6d 100644 --- a/translations/nl/02-SetupDevEnvironment/getting-started-azure-openai.md +++ b/translations/nl/02-SetupDevEnvironment/getting-started-azure-openai.md @@ -1,12 +1,3 @@ - # Het Instellen van de Ontwikkelomgeving voor Azure OpenAI > **Snelle Start**: Deze handleiding is bedoeld voor het instellen van Azure OpenAI. Voor een directe start met gratis modellen, gebruik [GitHub Models met Codespaces](./README.md#quick-start-cloud). diff --git a/translations/nl/03-CoreGenerativeAITechniques/README.md b/translations/nl/03-CoreGenerativeAITechniques/README.md index 076a6b5a..d7977adc 100644 --- a/translations/nl/03-CoreGenerativeAITechniques/README.md +++ b/translations/nl/03-CoreGenerativeAITechniques/README.md @@ -1,12 +1,3 @@ - # Core Generatieve AI Technieken Tutorial ## Inhoudsopgave diff --git a/translations/nl/04-PracticalSamples/README.md b/translations/nl/04-PracticalSamples/README.md index c8b3d53e..fef5759e 100644 --- a/translations/nl/04-PracticalSamples/README.md +++ b/translations/nl/04-PracticalSamples/README.md @@ -1,12 +1,3 @@ - # Praktische Toepassingen & Projecten ## Wat Je Gaat Leren diff --git a/translations/nl/04-PracticalSamples/calculator/README.md b/translations/nl/04-PracticalSamples/calculator/README.md index 77a197e5..ef7e3c6a 100644 --- a/translations/nl/04-PracticalSamples/calculator/README.md +++ b/translations/nl/04-PracticalSamples/calculator/README.md @@ -1,12 +1,3 @@ - # MCP Calculator Tutorial voor Beginners ## Inhoudsopgave diff --git a/translations/nl/04-PracticalSamples/foundrylocal/README.md b/translations/nl/04-PracticalSamples/foundrylocal/README.md index 658af837..2bbd4482 100644 --- a/translations/nl/04-PracticalSamples/foundrylocal/README.md +++ b/translations/nl/04-PracticalSamples/foundrylocal/README.md @@ -1,12 +1,3 @@ - # Foundry Local Spring Boot Tutorial ## Inhoudsopgave diff --git a/translations/nl/04-PracticalSamples/petstory/README.md b/translations/nl/04-PracticalSamples/petstory/README.md index a7719bdd..52a5ddd5 100644 --- a/translations/nl/04-PracticalSamples/petstory/README.md +++ b/translations/nl/04-PracticalSamples/petstory/README.md @@ -1,12 +1,3 @@ - # Handleiding voor beginners: Pet Story Generator ## Inhoudsopgave diff --git a/translations/nl/05-ResponsibleGenAI/README.md b/translations/nl/05-ResponsibleGenAI/README.md index 7699daa2..05366aa4 100644 --- a/translations/nl/05-ResponsibleGenAI/README.md +++ b/translations/nl/05-ResponsibleGenAI/README.md @@ -1,12 +1,3 @@ - # Verantwoordelijke Generatieve AI ## Wat Je Gaat Leren diff --git a/translations/nl/AGENTS.md b/translations/nl/AGENTS.md index f78dfb79..40704fed 100644 --- a/translations/nl/AGENTS.md +++ b/translations/nl/AGENTS.md @@ -1,12 +1,3 @@ - # AGENTS.md ## Projectoverzicht diff --git a/translations/nl/CODE_OF_CONDUCT.md b/translations/nl/CODE_OF_CONDUCT.md index f8e86b4f..6e1b8284 100644 --- a/translations/nl/CODE_OF_CONDUCT.md +++ b/translations/nl/CODE_OF_CONDUCT.md @@ -1,12 +1,3 @@ - # Microsoft Open Source Gedragscode Dit project heeft de [Microsoft Open Source Gedragscode](https://opensource.microsoft.com/codeofconduct/) aangenomen. diff --git a/translations/nl/README.md b/translations/nl/README.md index 55c6feb1..7704bc36 100644 --- a/translations/nl/README.md +++ b/translations/nl/README.md @@ -1,31 +1,22 @@ - # Generatieve AI voor Beginners - Java Editie [![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) ![Generatieve AI voor Beginners - Java Editie](../../translated_images/nl/beg-genai-series.8b48be9951cc574c.webp) -**Tijdsduur**: De hele workshop kan online worden voltooid zonder lokale installatie. Het opzetten van de omgeving duurt 2 minuten, het verkennen van de voorbeelden neemt 1-3 uur in beslag afhankelijk van de diepgang. +**Tijdbesteding**: De hele workshop kan online worden afgerond zonder lokale setup. Het opzetten van de omgeving duurt 2 minuten, het verkennen van de voorbeelden vereist 1-3 uur afhankelijk van de diepgang. -> **Snelle Start** +> **Snel Starten** 1. Fork deze repository naar je GitHub-account -2. Klik op **Code** → **Codespaces** tab → **...** → **Nieuw met opties...** -3. Gebruik de standaardinstellingen – hiermee wordt de Development-container geselecteerd die voor deze cursus is gemaakt +2. Klik op **Code** → tab **Codespaces** → **...** → **Nieuw met opties...** +3. Gebruik de standaardinstellingen – hiermee wordt de ontwikkelcontainer geselecteerd die voor deze cursus is gemaakt 4. Klik op **Codespace maken** -5. Wacht ~2 minuten totdat de omgeving klaar is +5. Wacht ~2 minuten tot de omgeving klaar is 6. Ga direct naar [Het eerste voorbeeld](./02-SetupDevEnvironment/README.md#step-2-create-a-github-personal-access-token) -> **Lieveling het liever lokaal klonen?** +> **Wil je liever lokaal klonen?** > -> Deze repository bevat 50+ taalvertalingen die de downloadgrootte aanzienlijk vergroten. Om te klonen zonder vertalingen, gebruik sparse checkout: +> Deze repository bevat meer dan 50 taalvertalingen, wat de downloadgrootte aanzienlijk vergroot. Om zonder vertalingen te klonen, gebruik sparse checkout: > ```bash > git clone --filter=blob:none --sparse https://github.com/microsoft/Generative-AI-for-beginners-java.git > cd Generative-AI-for-beginners-java @@ -36,14 +27,14 @@ CO_OP_TRANSLATOR_METADATA: ## Meertalige Ondersteuning -### Ondersteund via GitHub Action (Geautomatiseerd & Altijd Up-to-Date) +### Ondersteund via GitHub Action (Geautomatiseerd & Altijd Up-to-date) -[Arabisch](../ar/README.md) | [Bengaals](../bn/README.md) | [Bulgaars](../bg/README.md) | [Bobrees (Myanmar)](../my/README.md) | [Chinees (vereenvoudigd)](../zh/README.md) | [Chinees (traditioneel, Hong Kong)](../hk/README.md) | [Chinees (traditioneel, Macau)](../mo/README.md) | [Chinees (traditioneel, Taiwan)](../tw/README.md) | [Kroatisch](../hr/README.md) | [Tsjechisch](../cs/README.md) | [Deens](../da/README.md) | [Nederlands](./README.md) | [Ests](../et/README.md) | [Fins](../fi/README.md) | [Frans](../fr/README.md) | [Duits](../de/README.md) | [Grieks](../el/README.md) | [Hebreeuws](../he/README.md) | [Hindi](../hi/README.md) | [Hongaars](../hu/README.md) | [Indonesisch](../id/README.md) | [Italiaans](../it/README.md) | [Japans](../ja/README.md) | [Kannada](../kn/README.md) | [Koreaans](../ko/README.md) | [Litouws](../lt/README.md) | [Maleis](../ms/README.md) | [Malayalam](../ml/README.md) | [Marathi](../mr/README.md) | [Nepalees](../ne/README.md) | [Nigeriaans Pidgin](../pcm/README.md) | [Noors](../no/README.md) | [Perzisch (Farsi)](../fa/README.md) | [Pools](../pl/README.md) | [Portugees (Brazilië)](../br/README.md) | [Portugees (Portugal)](../pt/README.md) | [Punjabi (Gurmukhi)](../pa/README.md) | [Roemeens](../ro/README.md) | [Russisch](../ru/README.md) | [Servisch (Cyrillisch)](../sr/README.md) | [Slowaaks](../sk/README.md) | [Sloveens](../sl/README.md) | [Spaans](../es/README.md) | [Swahili](../sw/README.md) | [Zweeds](../sv/README.md) | [Tagalog (Filipijns)](../tl/README.md) | [Tamil](../ta/README.md) | [Telugu](../te/README.md) | [Thai](../th/README.md) | [Turks](../tr/README.md) | [Oekraïens](../uk/README.md) | [Urdu](../ur/README.md) | [Vietnamees](../vi/README.md) +[Arabisch](../ar/README.md) | [Bengaals](../bn/README.md) | [Bulgaars](../bg/README.md) | [Birmaans (Myanmar)](../my/README.md) | [Chinees (Vereenvoudigd)](../zh-CN/README.md) | [Chinees (Traditioneel, Hong Kong)](../zh-HK/README.md) | [Chinees (Traditioneel, Macau)](../zh-MO/README.md) | [Chinees (Traditioneel, Taiwan)](../zh-TW/README.md) | [Kroatisch](../hr/README.md) | [Tsjechisch](../cs/README.md) | [Deens](../da/README.md) | [Nederlands](./README.md) | [Ests](../et/README.md) | [Fins](../fi/README.md) | [Frans](../fr/README.md) | [Duits](../de/README.md) | [Grieks](../el/README.md) | [Hebreeuws](../he/README.md) | [Hindi](../hi/README.md) | [Hongaars](../hu/README.md) | [Indonesisch](../id/README.md) | [Italiaans](../it/README.md) | [Japans](../ja/README.md) | [Kannada](../kn/README.md) | [Koreaans](../ko/README.md) | [Litouws](../lt/README.md) | [Maleis](../ms/README.md) | [Malayalam](../ml/README.md) | [Marathi](../mr/README.md) | [Nepalees](../ne/README.md) | [Nigeriaans Pidgin](../pcm/README.md) | [Noors](../no/README.md) | [Perzisch (Farsi)](../fa/README.md) | [Pools](../pl/README.md) | [Portugees (Brazilië)](../pt-BR/README.md) | [Portugees (Portugal)](../pt-PT/README.md) | [Punjabi (Gurmukhi)](../pa/README.md) | [Roemeens](../ro/README.md) | [Russisch](../ru/README.md) | [Servisch (Cyrillisch)](../sr/README.md) | [Slowaaks](../sk/README.md) | [Sloveens](../sl/README.md) | [Spaans](../es/README.md) | [Swahili](../sw/README.md) | [Zweeds](../sv/README.md) | [Tagalog (Filipijns)](../tl/README.md) | [Tamil](../ta/README.md) | [Telugu](../te/README.md) | [Thais](../th/README.md) | [Turks](../tr/README.md) | [ Oekraïens](../uk/README.md) | [Urdu](../ur/README.md) | [Vietnamees](../vi/README.md) -> **Lieveling het liever lokaal klonen?** +> **Wil je liever lokaal klonen?** -> Deze repository bevat 50+ taalvertalingen die de downloadgrootte aanzienlijk vergroten. Om te klonen zonder vertalingen, gebruik sparse checkout: +> Deze repository bevat meer dan 50 taalvertalingen, wat de downloadgrootte aanzienlijk vergroot. Om zonder vertalingen te klonen, gebruik sparse checkout: > ```bash > git clone --filter=blob:none --sparse https://github.com/microsoft/Generative-AI-for-beginners-java.git > cd Generative-AI-for-beginners-java @@ -55,37 +46,37 @@ CO_OP_TRANSLATOR_METADATA: ## Cursusstructuur & Leerpad ### **Hoofdstuk 1: Introductie tot Generatieve AI** -- **Kernconcepten**: Begrip van Grote Taalmodellen, tokens, embeddings en AI-mogelijkheden +- **Kernconcepten**: Begrip van grote taalmodellen, tokens, embeddings en AI-mogelijkheden - **Java AI-ecosysteem**: Overzicht van Spring AI en OpenAI SDK's -- **Model Context Protocol**: Introductie tot MCP en de rol ervan in AI-agentcommunicatie -- **Praktische Toepassingen**: Reële scenario's inclusief chatbots en contentgeneratie -- **[→ Start Hoofdstuk 1](./01-IntroToGenAI/README.md)** +- **Model Context Protocol**: Introductie tot MCP en de rol ervan in AI-agent communicatie +- **Praktische toepassingen**: Scenario's uit de praktijk, waaronder chatbots en contentgeneratie +- **[→ Begin Hoofdstuk 1](./01-IntroToGenAI/README.md)** -### **Hoofdstuk 2: Ontwikkelomgeving Installatie** -- **Multi-provider Configuratie**: Instellen van GitHub Models, Azure OpenAI, en OpenAI Java SDK-integraties +### **Hoofdstuk 2: Ontwikkelomgeving Opzetten** +- **Multi-provider configuratie**: Instellen van GitHub Models, Azure OpenAI en OpenAI Java SDK-integraties - **Spring Boot + Spring AI**: Best practices voor enterprise AI-applicatieontwikkeling -- **GitHub Models**: Gratis toegang tot AI-modellen voor prototyping en leren (geen creditcard vereist) +- **GitHub Models**: Gratis AI-modeltoegang voor prototyping en leren (geen creditcard nodig) - **Ontwikkeltools**: Docker containers, VS Code en GitHub Codespaces configuratie -- **[→ Start Hoofdstuk 2](./02-SetupDevEnvironment/README.md)** +- **[→ Begin Hoofdstuk 2](./02-SetupDevEnvironment/README.md)** ### **Hoofdstuk 3: Kerntechnieken van Generatieve AI** - **Prompt Engineering**: Technieken voor optimale AI-modelreacties -- **Embeddings & Vectorbewerkingen**: Implementeer semantisch zoeken en gelijkenisvergelijking -- **Retrieval-Augmented Generation (RAG)**: Combineer AI met je eigen gegevensbronnen -- **Functieaanroep**: Breid AI-mogelijkheden uit met aangepaste tools en plugins -- **[→ Start Hoofdstuk 3](./03-CoreGenerativeAITechniques/README.md)** +- **Embeddings & Vectorbewerkingen**: Implementeer semantisch zoeken en gelijkenismatching +- **Retrieval-Augmented Generation (RAG)**: Combineer AI met je eigen databronnen +- **Function Calling**: Breid AI-mogelijkheden uit met aangepaste tools en plugins +- **[→ Begin Hoofdstuk 3](./03-CoreGenerativeAITechniques/README.md)** ### **Hoofdstuk 4: Praktische Toepassingen & Projecten** -- **Dierenverhalen Generator** (`petstory/`): Creatieve contentgeneratie met GitHub Models -- **Foundry Local Demo** (`foundrylocal/`): Lokale AI-modelintegratie met OpenAI Java SDK +- **Pet Story Generator** (`petstory/`): Creatieve content generatie met GitHub Models +- **Foundry Local Demo** (`foundrylocal/`): Lokale AI-model integratie met OpenAI Java SDK - **MCP Calculator Service** (`calculator/`): Basisimplementatie van Model Context Protocol met Spring AI -- **[→ Start Hoofdstuk 4](./04-PracticalSamples/README.md)** +- **[→ Begin Hoofdstuk 4](./04-PracticalSamples/README.md)** ### **Hoofdstuk 5: Verantwoordelijke AI-ontwikkeling** -- **GitHub Models Veiligheid**: Test ingebouwde contentfilters en veiligheidsmechanismen (harde blokkades en zachte weigeringen) -- **Verantwoordelijke AI Demo**: Praktijkvoorbeeld dat laat zien hoe moderne AI-veiligheidssystemen werken -- **Best Practices**: Essentiële richtlijnen voor ethische AI-ontwikkeling en uitrol -- **[→ Start Hoofdstuk 5](./05-ResponsibleGenAI/README.md)** +- **GitHub Models Veiligheid**: Test ingebouwde contentfiltering en veiligheidsmechanismen (harde blokkades en zachte weigeringen) +- **Verantwoordelijke AI Demo**: Praktijkvoorbeeld van hoe moderne AI-veiligheidssystemen werken +- **Best Practices**: Essentiële richtlijnen voor ethische AI-ontwikkeling en implementatie +- **[→ Begin Hoofdstuk 5](./05-ResponsibleGenAI/README.md)** ## Extra Bronnen @@ -117,21 +108,22 @@ CO_OP_TRANSLATOR_METADATA: [![Datawetenschap voor Beginners](https://img.shields.io/badge/Data%20Science%20for%20Beginners-84CC16?style=for-the-badge&labelColor=E5E7EB&color=84CC16)](https://aka.ms/datascience-beginners?WT.mc_id=academic-105485-koreyst) [![AI voor Beginners](https://img.shields.io/badge/AI%20for%20Beginners-A3E635?style=for-the-badge&labelColor=E5E7EB&color=A3E635)](https://aka.ms/ai-beginners?WT.mc_id=academic-105485-koreyst) [![Cybersecurity voor Beginners](https://img.shields.io/badge/Cybersecurity%20for%20Beginners-F97316?style=for-the-badge&labelColor=E5E7EB&color=F97316)](https://github.com/microsoft/Security-101?WT.mc_id=academic-96948-sayoung) -[![Webontwikkeling voor Beginners](https://img.shields.io/badge/Web%20Dev%20for%20Beginners-EC4899?style=for-the-badge&labelColor=E5E7EB&color=EC4899)](https://aka.ms/webdev-beginners?WT.mc_id=academic-105485-koreyst) -[![IoT voor Beginners](https://img.shields.io/badge/IoT%20for%20Beginners-14B8A6?style=for-the-badge&labelColor=E5E7EB&color=14B8A6)](https://aka.ms/iot-beginners?WT.mc_id=academic-105485-koreyst) -[![XR Ontwikkeling voor Beginners](https://img.shields.io/badge/XR%20Development%20for%20Beginners-38BDF8?style=for-the-badge&labelColor=E5E7EB&color=38BDF8)](https://github.com/microsoft/xr-development-for-beginners?WT.mc_id=academic-105485-koreyst) + +[![Web Dev for Beginners](https://img.shields.io/badge/Web%20Dev%20for%20Beginners-EC4899?style=for-the-badge&labelColor=E5E7EB&color=EC4899)](https://aka.ms/webdev-beginners?WT.mc_id=academic-105485-koreyst) +[![IoT for Beginners](https://img.shields.io/badge/IoT%20for%20Beginners-14B8A6?style=for-the-badge&labelColor=E5E7EB&color=14B8A6)](https://aka.ms/iot-beginners?WT.mc_id=academic-105485-koreyst) +[![XR Development for Beginners](https://img.shields.io/badge/XR%20Development%20for%20Beginners-38BDF8?style=for-the-badge&labelColor=E5E7EB&color=38BDF8)](https://github.com/microsoft/xr-development-for-beginners?WT.mc_id=academic-105485-koreyst) --- ### Copilot Serie -[![Copilot voor AI Geassisteerd Programmeren](https://img.shields.io/badge/Copilot%20for%20AI%20Paired%20Programming-FACC15?style=for-the-badge&labelColor=E5E7EB&color=FACC15)](https://aka.ms/GitHubCopilotAI?WT.mc_id=academic-105485-koreyst) -[![Copilot voor C#/.NET](https://img.shields.io/badge/Copilot%20for%20C%23/.NET-FBBF24?style=for-the-badge&labelColor=E5E7EB&color=FBBF24)](https://github.com/microsoft/mastering-github-copilot-for-dotnet-csharp-developers?WT.mc_id=academic-105485-koreyst) -[![Copilot Avontuur](https://img.shields.io/badge/Copilot%20Adventure-FDE68A?style=for-the-badge&labelColor=E5E7EB&color=FDE68A)](https://github.com/microsoft/CopilotAdventures?WT.mc_id=academic-105485-koreyst) +[![Copilot for AI Paired Programming](https://img.shields.io/badge/Copilot%20for%20AI%20Paired%20Programming-FACC15?style=for-the-badge&labelColor=E5E7EB&color=FACC15)](https://aka.ms/GitHubCopilotAI?WT.mc_id=academic-105485-koreyst) +[![Copilot for C#/.NET](https://img.shields.io/badge/Copilot%20for%20C%23/.NET-FBBF24?style=for-the-badge&labelColor=E5E7EB&color=FBBF24)](https://github.com/microsoft/mastering-github-copilot-for-dotnet-csharp-developers?WT.mc_id=academic-105485-koreyst) +[![Copilot Adventure](https://img.shields.io/badge/Copilot%20Adventure-FDE68A?style=for-the-badge&labelColor=E5E7EB&color=FDE68A)](https://github.com/microsoft/CopilotAdventures?WT.mc_id=academic-105485-koreyst) -## Hulp Krijgen +## Hulp krijgen -Als je vastloopt of vragen hebt over het bouwen van AI-apps. Sluit je aan bij mede-leerlingen en ervaren ontwikkelaars in discussies over MCP. Het is een ondersteunende gemeenschap waar vragen welkom zijn en kennis vrijelijk wordt gedeeld. +Als je vastloopt of vragen hebt over het bouwen van AI-apps. Doe mee met mede-leerlingen en ervaren ontwikkelaars in discussies over MCP. Het is een ondersteunende gemeenschap waar vragen welkom zijn en kennis vrijelijk wordt gedeeld. [![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) @@ -142,6 +134,6 @@ Als je productfeedback hebt of fouten tegenkomt tijdens het bouwen, bezoek dan: --- -**Disclaimer**: -Dit document is vertaald met behulp van de AI-vertalingsdienst [Co-op Translator](https://github.com/Azure/co-op-translator). Hoewel we streven naar nauwkeurigheid, dient u zich ervan bewust te zijn dat geautomatiseerde vertalingen fouten of onnauwkeurigheden kunnen bevatten. Het originele document in de oorspronkelijke taal dient als de gezaghebbende bron te worden beschouwd. Voor belangrijke informatie wordt een professionele menselijke vertaling aanbevolen. Wij zijn niet aansprakelijk voor eventuele misverstanden of verkeerde interpretaties die voortvloeien uit het gebruik van deze vertaling. +**Disclaimer**: +Dit document is vertaald met behulp van de AI-vertalingsdienst [Co-op Translator](https://github.com/Azure/co-op-translator). Hoewel we streven naar nauwkeurigheid, dient u er rekening mee te houden dat automatische vertalingen fouten of onjuistheden kunnen bevatten. Het originele document in de oorspronkelijke taal dient als gezaghebbende bron te worden beschouwd. Voor cruciale informatie wordt professionele menselijke vertaling aanbevolen. Wij zijn niet aansprakelijk voor enige misverstanden of verkeerde interpretaties voortvloeiend uit het gebruik van deze vertaling. \ No newline at end of file diff --git a/translations/nl/SECURITY.md b/translations/nl/SECURITY.md index 909aa09f..6c790f4f 100644 --- a/translations/nl/SECURITY.md +++ b/translations/nl/SECURITY.md @@ -1,12 +1,3 @@ - ## Beveiliging Microsoft neemt de beveiliging van onze softwareproducten en -diensten serieus, inclusief alle broncoderepositories die worden beheerd via onze GitHub-organisaties, waaronder [Microsoft](https://github.com/Microsoft), [Azure](https://github.com/Azure), [DotNet](https://github.com/dotnet), [AspNet](https://github.com/aspnet) en [Xamarin](https://github.com/xamarin). diff --git a/translations/nl/SUPPORT.md b/translations/nl/SUPPORT.md index e63d3daa..ee8361ef 100644 --- a/translations/nl/SUPPORT.md +++ b/translations/nl/SUPPORT.md @@ -1,12 +1,3 @@ - # Ondersteuning ## Hoe problemen te melden en hulp te krijgen diff --git a/translations/no/.co-op-translator.json b/translations/no/.co-op-translator.json new file mode 100644 index 00000000..83ffc8f3 --- /dev/null +++ b/translations/no/.co-op-translator.json @@ -0,0 +1,92 @@ +{ + "01-IntroToGenAI/README.md": { + "original_hash": "75bfb080ca725e8a9aa9c80cae25fba1", + "translation_date": "2025-07-29T09:30:07+00:00", + "source_file": "01-IntroToGenAI/README.md", + "language_code": "no" + }, + "02-SetupDevEnvironment/README.md": { + "original_hash": "96a30d42b9751a3d4e4b20e28d29d459", + "translation_date": "2026-01-28T05:05:11+00:00", + "source_file": "02-SetupDevEnvironment/README.md", + "language_code": "no" + }, + "02-SetupDevEnvironment/examples/basic-chat-azure/README.md": { + "original_hash": "efd82efe50711d7e257eb943151d682c", + "translation_date": "2025-07-27T13:42:39+00:00", + "source_file": "02-SetupDevEnvironment/examples/basic-chat-azure/README.md", + "language_code": "no" + }, + "02-SetupDevEnvironment/getting-started-azure-openai.md": { + "original_hash": "bfdb4b4eadbee3a59ef742439f58326a", + "translation_date": "2025-07-27T13:14:23+00:00", + "source_file": "02-SetupDevEnvironment/getting-started-azure-openai.md", + "language_code": "no" + }, + "03-CoreGenerativeAITechniques/README.md": { + "original_hash": "685f55cb07de19b52a30ce6e8b6d889e", + "translation_date": "2025-08-28T22:08:44+00:00", + "source_file": "03-CoreGenerativeAITechniques/README.md", + "language_code": "no" + }, + "04-PracticalSamples/README.md": { + "original_hash": "14c0a61ecc1cd2012a9c129236dfdf71", + "translation_date": "2025-07-29T09:29:53+00:00", + "source_file": "04-PracticalSamples/README.md", + "language_code": "no" + }, + "04-PracticalSamples/calculator/README.md": { + "original_hash": "b6c16b5514d524e415a94f6097ee7d4c", + "translation_date": "2025-09-18T15:34:44+00:00", + "source_file": "04-PracticalSamples/calculator/README.md", + "language_code": "no" + }, + "04-PracticalSamples/foundrylocal/README.md": { + "original_hash": "f787307400de59adc25a1404466a35f3", + "translation_date": "2025-11-04T07:27:03+00:00", + "source_file": "04-PracticalSamples/foundrylocal/README.md", + "language_code": "no" + }, + "04-PracticalSamples/petstory/README.md": { + "original_hash": "0cbf68d605615a1e602c832a24616859", + "translation_date": "2025-07-25T11:33:49+00:00", + "source_file": "04-PracticalSamples/petstory/README.md", + "language_code": "no" + }, + "05-ResponsibleGenAI/README.md": { + "original_hash": "301c05c2f57e60a6950b8c665b8bdbba", + "translation_date": "2025-07-29T15:53:03+00:00", + "source_file": "05-ResponsibleGenAI/README.md", + "language_code": "no" + }, + "AGENTS.md": { + "original_hash": "afc90918d008cf77fd1982691f681306", + "translation_date": "2025-10-03T08:37:55+00:00", + "source_file": "AGENTS.md", + "language_code": "no" + }, + "CODE_OF_CONDUCT.md": { + "original_hash": "442b123d034f92f7c384d2bbd28f99f1", + "translation_date": "2025-07-21T19:08:27+00:00", + "source_file": "CODE_OF_CONDUCT.md", + "language_code": "no" + }, + "README.md": { + "original_hash": "125a08948d881c95628094f4dd1fbd43", + "translation_date": "2026-01-29T15:53:31+00:00", + "source_file": "README.md", + "language_code": "no" + }, + "SECURITY.md": { + "original_hash": "57f14126c1c6add76b3aef3844dfe4e3", + "translation_date": "2025-07-21T19:06:26+00:00", + "source_file": "SECURITY.md", + "language_code": "no" + }, + "SUPPORT.md": { + "original_hash": "b8ef73cc49dec68e2c885ee9df545129", + "translation_date": "2025-07-21T19:09:35+00:00", + "source_file": "SUPPORT.md", + "language_code": "no" + } +} \ No newline at end of file diff --git a/translations/no/01-IntroToGenAI/README.md b/translations/no/01-IntroToGenAI/README.md index 0adc82e0..92a3bc6e 100644 --- a/translations/no/01-IntroToGenAI/README.md +++ b/translations/no/01-IntroToGenAI/README.md @@ -1,12 +1,3 @@ - # Introduksjon til Generativ AI - Java-utgave ## Hva du vil lære diff --git a/translations/no/02-SetupDevEnvironment/README.md b/translations/no/02-SetupDevEnvironment/README.md index d9f8518f..62fe78c4 100644 --- a/translations/no/02-SetupDevEnvironment/README.md +++ b/translations/no/02-SetupDevEnvironment/README.md @@ -1,13 +1,251 @@ - +# Sette opp utviklingsmiljøet for Generativ AI for Java +> **Rask start**: Kode i skyen på 2 minutter - hopp til [GitHub Codespaces-oppsett](../../../02-SetupDevEnvironment) - ingen lokal installasjon kreves og bruker GitHub-modeller! + +> **Interessert i Azure OpenAI?**, se vår [Azure OpenAI-oppsettguide](getting-started-azure-openai.md) med trinn for å opprette en ny Azure OpenAI-ressurs. + +## Hva du vil lære + +- Sette opp et Java-utviklingsmiljø for AI-applikasjoner +- Velge og konfigurere ditt foretrukne utviklingsmiljø (sky-først med Codespaces, lokal dev container, eller full lokal oppsett) +- Teste oppsettet ditt ved å koble til GitHub-modeller + +## Innholdsfortegnelse + +- [Hva du vil lære](../../../02-SetupDevEnvironment) +- [Introduksjon](../../../02-SetupDevEnvironment) +- [Trinn 1: Sett opp utviklingsmiljøet ditt](../../../02-SetupDevEnvironment) + - [Alternativ A: GitHub Codespaces (anbefalt)](../../../02-SetupDevEnvironment) + - [Alternativ B: Lokal dev container](../../../02-SetupDevEnvironment) + - [Alternativ C: Bruk din eksisterende lokale installasjon](../../../02-SetupDevEnvironment) +- [Trinn 2: Lag en GitHub-personlig tilgangstoken](../../../02-SetupDevEnvironment) +- [Trinn 3: Test oppsettet ditt](../../../02-SetupDevEnvironment) +- [Feilsøking](../../../02-SetupDevEnvironment) +- [Oppsummering](../../../02-SetupDevEnvironment) +- [Neste steg](../../../02-SetupDevEnvironment) + +## Introduksjon + +Dette kapitlet vil veilede deg gjennom å sette opp et utviklingsmiljø. Vi bruker **GitHub Models** som vårt hovedeksempel fordi det er gratis, enkelt å sette opp med bare en GitHub-konto, krever ikke kredittkort, og gir tilgang til flere modeller for eksperimentering. + +**Ingen lokal oppsett kreves!** Du kan begynne å kode umiddelbart ved hjelp av GitHub Codespaces, som gir et fullt utviklingsmiljø i nettleseren din. + +Skjermbilde: GitHub Models + +Vi anbefaler å bruke [**GitHub Models**](https://github.com/marketplace?type=models) for dette kurset fordi det er: +- **Gratis** å komme i gang +- **Enkelt** å sette opp med bare en GitHub-konto +- **Ingen kredittkort** kreves +- **Flere modeller** tilgjengelig for eksperimentering + +> **Merk**: GitHub Models som brukes i dette kurset har disse gratisgrensene: +> - 15 forespørsler per minutt (150 per dag) +> - ~8.000 ord inn, ~4.000 ord ut per forespørsel +> - 5 samtidige forespørsler +> +> For produksjonsbruk, oppgrader til Azure AI Foundry Models med din Azure-konto. Koden din trenger ikke å endres. Se [Azure AI Foundry dokumentasjonen](https://learn.microsoft.com/azure/ai-foundry/foundry-models/how-to/quickstart-github-models). + +## Trinn 1: Sett opp utviklingsmiljøet ditt + + + +Vi har laget en forhåndskonfigurert utviklingscontainer for å minimere oppsettstid og sikre at du har alle nødvendige verktøy for dette Generative AI for Java-kurset. Velg din foretrukne utviklingsmetode: + +### Miljøoppsett-alternativer: + +#### Alternativ A: GitHub Codespaces (anbefalt) + +**Start koding på 2 minutter - ingen lokal oppsett kreves!** + +1. Fork dette repoet til din GitHub-konto + > **Merk**: Hvis du ønsker å redigere grunnkonfigurasjonen, ta en titt på [Dev Container Configuration](../../../.devcontainer/devcontainer.json) +2. Klikk **Code** → fanen **Codespaces** → **...** → **New with options...** +3. Bruk standardverdiene – dette velger **Dev container configuration**: **Generative AI Java Development Environment**, en tilpasset devcontainer laget for dette kurset +4. Klikk **Create codespace** +5. Vent ~2 minutter til miljøet er klart +6. Fortsett til [Trinn 2: Lag GitHub Token](../../../02-SetupDevEnvironment) + +Skjermbilde: Codespaces undermeny + +Skjermbilde: New with options + +Skjermbilde: Opprett codespace-alternativer + +> **Fordeler med Codespaces**: +> - Ingen lokal installasjon kreves +> - Fungerer på hvilken som helst enhet med nettleser +> - Forhåndskonfigurert med alle verktøy og avhengigheter +> - Gratis 60 timer per måned for personlige kontoer +> - Konsistent miljø for alle elever + +#### Alternativ B: Lokal dev container + +**For utviklere som foretrekker lokal utvikling med Docker** + +1. Fork og klon dette repoet til din lokale maskin + > **Merk**: Hvis du ønsker å redigere grunnkonfigurasjonen, ta en titt på [Dev Container Configuration](../../../.devcontainer/devcontainer.json) +2. Installer [Docker Desktop](https://www.docker.com/products/docker-desktop/) og [VS Code](https://code.visualstudio.com/) +3. Installer [Dev Containers-utvidelsen](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers) i VS Code +4. Åpne repo-mappen i VS Code +5. Når du blir spurt, klikk **Reopen in Container** (eller bruk `Ctrl+Shift+P` → "Dev Containers: Reopen in Container") +6. Vent til containeren bygges og starter +7. Fortsett til [Trinn 2: Lag GitHub Token](../../../02-SetupDevEnvironment) + +Skjermbilde: Dev container-oppsett + +Skjermbilde: Dev container bygging fullført + +#### Alternativ C: Bruk din eksisterende lokale installasjon + +**For utviklere med eksisterende Java-miljøer** + +Forutsetninger: +- [Java 21+](https://www.oracle.com/java/technologies/javase/jdk21-archive-downloads.html) +- [Maven 3.9+](https://maven.apache.org/download.cgi) +- [VS Code](https://code.visualstudio.com) eller din foretrukne IDE + +Steg: +1. Klon dette repoet til din lokale maskin +2. Åpne prosjektet i din IDE +3. Fortsett til [Trinn 2: Lag GitHub Token](../../../02-SetupDevEnvironment) + +> **Profftips**: Har du maskinvare med lav spesifikasjon men vil kjøre VS Code lokalt? Bruk GitHub Codespaces! Du kan koble din lokale VS Code til en cloud-hosted Codespace og få det beste fra begge verdener. + +Skjermbilde: opprettet lokal devcontainer-instans + +## Trinn 2: Lag en GitHub-personlig tilgangstoken + +1. Gå til [GitHub-innstillinger](https://github.com/settings/profile) og velg **Settings** i profilmenyen. +2. Klikk på **Developer settings** i venstremenyen (vanligvis nederst). +3. Under **Personal access tokens**, klikk **Fine-grained tokens** (eller følg denne direkte [lenken](https://github.com/settings/personal-access-tokens)). +4. Klikk **Generate new token**. +5. Under "Token name", gi tokenet et beskrivende navn (f.eks. `GenAI-Java-Course-Token`). +6. Sett en utløpsdato (anbefalt: 7 dager for sikkerhets skyld). +7. Under "Resource owner", velg din brukerkonto. +8. Under "Repository access", velg repoene du vil bruke med GitHub Models (eller "All repositories" om nødvendig). +9. Under "Account permissions", finn **Models** og sett den til **Read-only**. +10. Klikk **Generate token**. +11. **Kopier og lagre tokenet nå** – du får ikke se det igjen! + +> **Sikkerhetstips**: Bruk bare den nødvendige minste rettigheten og kortest mulig utløpstid på dine tilgangstokener. + +## Trinn 3: Test oppsettet ditt med GitHub Models-eksempelet + +Når utviklingsmiljøet ditt er klart, la oss teste GitHub Models-integrasjonen med vårt eksempelprogram i [`02-SetupDevEnvironment/examples/github-models`](../../../02-SetupDevEnvironment/examples/github-models). + +1. Åpne terminalen i utviklingsmiljøet ditt. +2. Naviger til GitHub Models-eksempelet: + ```bash + cd 02-SetupDevEnvironment/examples/github-models + ``` +3. Sett din GitHub-token som en miljøvariabel: + ```bash + # macOS/Linux + export GITHUB_TOKEN=your_token_here + + # Windows (Kommandoprompt) + set GITHUB_TOKEN=your_token_here + + # Windows (PowerShell) + $env:GITHUB_TOKEN="your_token_here" + ``` + +4. Kjør applikasjonen: + ```bash + mvn compile exec:java -Dexec.mainClass="com.example.githubmodels.App" + ``` + +Du skal se output lik: +```text +Using model: gpt-4.1-nano +Sending request to GitHub Models... +Response: Hello World! +``` + +### Forstå eksempelkoden + +Først, la oss forstå hva vi nettopp kjørte. Eksempelet under `examples/github-models` bruker OpenAI Java SDK for å koble til GitHub Models: + +**Hva denne koden gjør:** +- **Kobler** til GitHub Models med din personlige tilgangstoken +- **Sender** en enkel "Say Hello World!" melding til AI-modellen +- **Mottar** og viser AI-modellens svar +- **Validerer** at oppsettet ditt fungerer korrekt + +**Viktig avhengighet** (i `pom.xml`): +```xml + + com.openai + openai-java + 2.12.0 + +``` + +**Hovedkode** (`App.java`): +```java +// Koble til GitHub-modeller ved hjelp av OpenAI Java SDK +OpenAIClient client = OpenAIOkHttpClient.builder() + .apiKey(pat) + .baseUrl("https://models.inference.ai.azure.com") + .build(); + +// Opprett forespørsel om chatfullføring +ChatCompletionCreateParams params = ChatCompletionCreateParams.builder() + .model(modelId) + .addSystemMessage("You are a concise assistant.") + .addUserMessage("Say Hello World!") + .build(); + +// Hent AI-respons +ChatCompletion response = client.chat().completions().create(params); +System.out.println("Response: " + response.choices().get(0).message().content().orElse("No response content")); +``` + +## Oppsummering + +Flott! Nå har du alt satt opp: + +- Opprettet en GitHub-personlig tilgangstoken med riktige rettigheter for AI-modell-tilgang +- Fått Java-utviklingsmiljøet ditt i gang (enten det er Codespaces, dev containere eller lokalt) +- Koblet til GitHub Models via OpenAI Java SDK for gratis AI-utvikling +- Testet at alt fungerer med et enkelt eksempel som kommuniserer med AI-modeller + +## Neste steg + +[Kapittel 3: Kjerneteknikker for Generativ AI](../03-CoreGenerativeAITechniques/README.md) + +## Feilsøking + +Har du problemer? Her er vanlige problemer og løsninger: + +- **Token fungerer ikke?** + - Sørg for at du kopierte hele tokenet uten ekstra mellomrom + - Bekreft at tokenet er satt riktig som miljøvariabel + - Sjekk at tokenet har korrekt tillatelse (Models: Read-only) + +- **Maven ikke funnet?** + - Hvis du bruker dev containere/Codespaces, skal Maven være forhåndsinstallert + - For lokal oppsett, sørg for at Java 21+ og Maven 3.9+ er installert + - Prøv `mvn --version` for å verifisere installasjonen + +- **Tilkoblingsproblemer?** + - Sjekk internettilkoblingen din + - Verifiser at GitHub er tilgjengelig fra ditt nettverk + - Sørg for at du ikke er bak en brannmur som blokkerer GitHub Models-endepunktet + +- **Dev container starter ikke?** + - Sørg for at Docker Desktop kjører (for lokal utvikling) + - Prøv å bygge containeren på nytt: `Ctrl+Shift+P` → "Dev Containers: Rebuild Container" + +- **Kompileringsfeil i applikasjonen?** + - Sørg for at du er i riktig mappe: `02-SetupDevEnvironment/examples/github-models` + - Prøv å rense og bygge på nytt: `mvn clean compile` + +> **Trenger du hjelp?**: Har du fortsatt problemer? Opprett en issue i repositoriet så hjelper vi deg. --- + +**Ansvarsfraskrivelse**: +Dette dokumentet er oversatt ved bruk av AI-oversettelsestjenesten [Co-op Translator](https://github.com/Azure/co-op-translator). Selv om vi streber etter nøyaktighet, vennligst vær oppmerksom på at automatiske oversettelser kan inneholde feil eller unøyaktigheter. Det opprinnelige dokumentet på dets opprinnelige språk skal betraktes som den autoritative kilden. For kritisk informasjon anbefales profesjonell menneskelig oversettelse. Vi påtar oss ikke ansvar for eventuelle misforståelser eller feiltolkninger som oppstår ved bruk av denne oversettelsen. + \ No newline at end of file diff --git a/translations/no/02-SetupDevEnvironment/examples/basic-chat-azure/README.md b/translations/no/02-SetupDevEnvironment/examples/basic-chat-azure/README.md index 9147d881..c9b653df 100644 --- a/translations/no/02-SetupDevEnvironment/examples/basic-chat-azure/README.md +++ b/translations/no/02-SetupDevEnvironment/examples/basic-chat-azure/README.md @@ -1,12 +1,3 @@ - # Grunnleggende Chat med Azure OpenAI - Eksempel fra Start til Slutt Dette eksemplet viser hvordan du kan lage en enkel Spring Boot-applikasjon som kobler til Azure OpenAI og tester oppsettet ditt. diff --git a/translations/no/02-SetupDevEnvironment/getting-started-azure-openai.md b/translations/no/02-SetupDevEnvironment/getting-started-azure-openai.md index b8219f0d..36b8f981 100644 --- a/translations/no/02-SetupDevEnvironment/getting-started-azure-openai.md +++ b/translations/no/02-SetupDevEnvironment/getting-started-azure-openai.md @@ -1,12 +1,3 @@ - # Sette opp utviklingsmiljøet for Azure OpenAI > **Rask start**: Denne veiledningen er for oppsett av Azure OpenAI. For en umiddelbar start med gratis modeller, bruk [GitHub Models with Codespaces](./README.md#quick-start-cloud). diff --git a/translations/no/03-CoreGenerativeAITechniques/README.md b/translations/no/03-CoreGenerativeAITechniques/README.md index aa2f33de..cf0d7fa4 100644 --- a/translations/no/03-CoreGenerativeAITechniques/README.md +++ b/translations/no/03-CoreGenerativeAITechniques/README.md @@ -1,12 +1,3 @@ - # Core Generative AI Techniques Tutorial ## Innholdsfortegnelse diff --git a/translations/no/04-PracticalSamples/README.md b/translations/no/04-PracticalSamples/README.md index bbf99dd4..a4ac65d7 100644 --- a/translations/no/04-PracticalSamples/README.md +++ b/translations/no/04-PracticalSamples/README.md @@ -1,12 +1,3 @@ - # Praktiske Applikasjoner og Prosjekter ## Hva Du Vil Lære diff --git a/translations/no/04-PracticalSamples/calculator/README.md b/translations/no/04-PracticalSamples/calculator/README.md index 876dfdec..e25701c9 100644 --- a/translations/no/04-PracticalSamples/calculator/README.md +++ b/translations/no/04-PracticalSamples/calculator/README.md @@ -1,12 +1,3 @@ - # MCP Kalkulatorveiledning for Nybegynnere ## Innholdsfortegnelse diff --git a/translations/no/04-PracticalSamples/foundrylocal/README.md b/translations/no/04-PracticalSamples/foundrylocal/README.md index 59786f27..85bb1756 100644 --- a/translations/no/04-PracticalSamples/foundrylocal/README.md +++ b/translations/no/04-PracticalSamples/foundrylocal/README.md @@ -1,12 +1,3 @@ - # Foundry Local Spring Boot Veiledning ## Innholdsfortegnelse diff --git a/translations/no/04-PracticalSamples/petstory/README.md b/translations/no/04-PracticalSamples/petstory/README.md index 0b2470f6..7e95dd52 100644 --- a/translations/no/04-PracticalSamples/petstory/README.md +++ b/translations/no/04-PracticalSamples/petstory/README.md @@ -1,12 +1,3 @@ - # Veiledning for nybegynnere: Generering av dyrehistorier ## Innholdsfortegnelse diff --git a/translations/no/05-ResponsibleGenAI/README.md b/translations/no/05-ResponsibleGenAI/README.md index e1b12355..5c908385 100644 --- a/translations/no/05-ResponsibleGenAI/README.md +++ b/translations/no/05-ResponsibleGenAI/README.md @@ -1,12 +1,3 @@ - # Ansvarlig Generativ AI ## Hva du vil lære diff --git a/translations/no/AGENTS.md b/translations/no/AGENTS.md index 7e65bd25..8d4ad0b8 100644 --- a/translations/no/AGENTS.md +++ b/translations/no/AGENTS.md @@ -1,12 +1,3 @@ - # AGENTS.md ## Prosjektoversikt diff --git a/translations/no/CODE_OF_CONDUCT.md b/translations/no/CODE_OF_CONDUCT.md index 0652b570..5c27ea72 100644 --- a/translations/no/CODE_OF_CONDUCT.md +++ b/translations/no/CODE_OF_CONDUCT.md @@ -1,12 +1,3 @@ - # Microsoft Open Source Code of Conduct Dette prosjektet har tatt i bruk [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/). diff --git a/translations/no/README.md b/translations/no/README.md index f2839d05..60817090 100644 --- a/translations/no/README.md +++ b/translations/no/README.md @@ -1,31 +1,22 @@ - -# Generativ AI for Nybegynnere - Java-utgave +# Generativ AI for nybegynnere - Java-utgave [![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) -![Generativ AI for Nybegynnere - Java-utgave](../../translated_images/no/beg-genai-series.8b48be9951cc574c.webp) +![Generativ AI for nybegynnere - Java-utgave](../../translated_images/no/beg-genai-series.8b48be9951cc574c.webp) -**Tid brukt**: Hele workshoppen kan gjennomføres online uten lokal oppsett. Miljøoppsettet tar 2 minutter, med utforsking av eksemplene som krever 1–3 timer avhengig av utforskningsdybde. +**Tidsbruk**: Hele workshoppen kan fullføres online uten lokal oppsett. Oppsett av miljø tar 2 minutter, og utforsking av eksemplene krever 1-3 timer avhengig av utforskingsdybde. > **Rask start** -1. Fork dette repositoriet til din GitHub-konto -2. Klikk **Code** → **Codespaces**-fanen → **...** → **New with options...** +1. Forgrener dette depotet til din GitHub-konto +2. Klikk **Code** → **Codespaces**-fanen → **...** → **Ny med alternativer...** 3. Bruk standardinnstillingene – dette vil velge utviklingscontaineren opprettet for dette kurset 4. Klikk **Create codespace** -5. Vent ~2 minutter på at miljøet skal være klart +5. Vent ~2 minutter for at miljøet skal være klart 6. Gå rett til [Det første eksempelet](./02-SetupDevEnvironment/README.md#step-2-create-a-github-personal-access-token) > **Foretrekker du å klone lokalt?** > -> Dette repositoriet inkluderer 50+ språkoversettelser som betydelig øker nedlastingsstørrelsen. For å klone uten oversettelser, bruk sparsamt utvalg: +> Dette depotet inkluderer 50+ språkoppsett som øker nedlastingsstørrelsen betydelig. For å klone uten oversettelser, bruk sparse checkout: > ```bash > git clone --filter=blob:none --sparse https://github.com/microsoft/Generative-AI-for-beginners-java.git > cd Generative-AI-for-beginners-java @@ -36,14 +27,14 @@ CO_OP_TRANSLATOR_METADATA: ## Flerspråklig støtte -### Støttet via GitHub Action (Automatisert og Alltid Oppdatert) +### Støttet via GitHub Action (Automatisert og alltid oppdatert) -[Arabisk](../ar/README.md) | [Bengali](../bn/README.md) | [Bulgarsk](../bg/README.md) | [Burmese (Myanmar)](../my/README.md) | [Kinesisk (forenklet)](../zh/README.md) | [Kinesisk (tradisjonell, Hong Kong)](../hk/README.md) | [Kinesisk (tradisjonell, Macau)](../mo/README.md) | [Kinesisk (tradisjonell, Taiwan)](../tw/README.md) | [Kroatisk](../hr/README.md) | [Tsjekkisk](../cs/README.md) | [Dansk](../da/README.md) | [Nederlandsk](../nl/README.md) | [Estisk](../et/README.md) | [Finsk](../fi/README.md) | [Fransk](../fr/README.md) | [Tysk](../de/README.md) | [Gresk](../el/README.md) | [Hebraisk](../he/README.md) | [Hindi](../hi/README.md) | [Ungarsk](../hu/README.md) | [Indonesisk](../id/README.md) | [Italiensk](../it/README.md) | [Japansk](../ja/README.md) | [Kannada](../kn/README.md) | [Koreansk](../ko/README.md) | [Litauisk](../lt/README.md) | [Malayisk](../ms/README.md) | [Malayalam](../ml/README.md) | [Marathi](../mr/README.md) | [Nepali](../ne/README.md) | [Nigeriansk Pidgin](../pcm/README.md) | [Norsk](./README.md) | [Persisk (Farsi)](../fa/README.md) | [Polsk](../pl/README.md) | [Portugisisk (Brasil)](../br/README.md) | [Portugisisk (Portugal)](../pt/README.md) | [Punjabi (Gurmukhi)](../pa/README.md) | [Rumensk](../ro/README.md) | [Russisk](../ru/README.md) | [Serbisk (kyrillisk)](../sr/README.md) | [Slovakisk](../sk/README.md) | [Slovensk](../sl/README.md) | [Spansk](../es/README.md) | [Swahili](../sw/README.md) | [Svensk](../sv/README.md) | [Tagalog (Filipino)](../tl/README.md) | [Tamil](../ta/README.md) | [Telugu](../te/README.md) | [Thailandsk](../th/README.md) | [Tyrkisk](../tr/README.md) | [Ukrainsk](../uk/README.md) | [Urdu](../ur/README.md) | [Vietnamesisk](../vi/README.md) +[Arabisk](../ar/README.md) | [Bengali](../bn/README.md) | [Bulgarsk](../bg/README.md) | [Burmesisk (Myanmar)](../my/README.md) | [Kinesisk (forenklet)](../zh-CN/README.md) | [Kinesisk (tradisjonell, Hong Kong)](../zh-HK/README.md) | [Kinesisk (tradisjonell, Macau)](../zh-MO/README.md) | [Kinesisk (tradisjonell, Taiwan)](../zh-TW/README.md) | [Kroatisk](../hr/README.md) | [Tsjekkisk](../cs/README.md) | [Dansk](../da/README.md) | [Nederlandsk](../nl/README.md) | [Estisk](../et/README.md) | [Finsk](../fi/README.md) | [Fransk](../fr/README.md) | [Tysk](../de/README.md) | [Gresk](../el/README.md) | [Hebraisk](../he/README.md) | [Hindi](../hi/README.md) | [Ungarsk](../hu/README.md) | [Indonesisk](../id/README.md) | [Italiensk](../it/README.md) | [Japansk](../ja/README.md) | [Kannada](../kn/README.md) | [Koreansk](../ko/README.md) | [Litauisk](../lt/README.md) | [Malayisk](../ms/README.md) | [Malayalam](../ml/README.md) | [Marathi](../mr/README.md) | [Nepalesisk](../ne/README.md) | [Nigeriansk Pidgin](../pcm/README.md) | [Norsk](./README.md) | [Persisk (Farsi)](../fa/README.md) | [Polsk](../pl/README.md) | [Portugisisk (Brasil)](../pt-BR/README.md) | [Portugisisk (Portugal)](../pt-PT/README.md) | [Punjabi (Gurmukhi)](../pa/README.md) | [Rumensk](../ro/README.md) | [Russisk](../ru/README.md) | [Serbisk (kyrillisk)](../sr/README.md) | [Slovakisk](../sk/README.md) | [Slovensk](../sl/README.md) | [Spansk](../es/README.md) | [Swahili](../sw/README.md) | [Svensk](../sv/README.md) | [Tagalog (Filippinsk)](../tl/README.md) | [Tamil](../ta/README.md) | [Telugu](../te/README.md) | [Thailandsk](../th/README.md) | [Tyrkisk](../tr/README.md) | [Ukrainsk](../uk/README.md) | [Urdu](../ur/README.md) | [Vietnamesisk](../vi/README.md) > **Foretrekker du å klone lokalt?** -> Dette repositoriet inkluderer 50+ språkoversettelser som betydelig øker nedlastingsstørrelsen. For å klone uten oversettelser, bruk sparsamt utvalg: +> Dette depotet inkluderer 50+ språkoppsett som øker nedlastingsstørrelsen betydelig. For å klone uten oversettelser, bruk sparse checkout: > ```bash > git clone --filter=blob:none --sparse https://github.com/microsoft/Generative-AI-for-beginners-java.git > cd Generative-AI-for-beginners-java @@ -52,40 +43,40 @@ CO_OP_TRANSLATOR_METADATA: > Dette gir deg alt du trenger for å fullføre kurset med en mye raskere nedlasting. -## Kursstruktur og læringssti +## Kursstruktur og læringsvei -### **Kapittel 1: Introduksjon til Generativ AI** -- **Kjernebegreper**: Forstå store språkmodeller, tokens, embedding og AI-kapasiteter -- **Java AI-økosystemet**: Oversikt over Spring AI og OpenAI SDK-er -- **Modell Kontekst Protokoll**: Introduksjon til MCP og dens rolle i AI-agentkommunikasjon +### **Kapittel 1: Introduksjon til generativ AI** +- **Kjernebegreper**: Forstå Large Language Models, tokens, embeddings og AI-muligheter +- **Java AI-økosystem**: Oversikt over Spring AI og OpenAI SDK-er +- **Model Context Protocol**: Introduksjon til MCP og dens rolle i AI-agentkommunikasjon - **Praktiske anvendelser**: Virkelige scenarier inkludert chatboter og innholdsgenerering -- **[→ Start Kapittel 1](./01-IntroToGenAI/README.md)** +- **[→ Start kapittel 1](./01-IntroToGenAI/README.md)** ### **Kapittel 2: Oppsett av utviklingsmiljø** -- **Multi-leverandør konfigurasjon**: Sett opp GitHub-modeller, Azure OpenAI og OpenAI Java SDK-integrasjoner -- **Spring Boot + Spring AI**: Beste praksis for utvikling av AI-applikasjoner i virksomheter -- **GitHub-modeller**: Gratis AI-modelltilgang for prototyping og læring (krever ikke kredittkort) +- **Multi-leverandørkonfigurasjon**: Sett opp GitHub Models, Azure OpenAI og OpenAI Java SDK-integrasjoner +- **Spring Boot + Spring AI**: Beste praksis for utvikling av bedrifts-AI-applikasjoner +- **GitHub Models**: Gratis AI-modelltilgang for prototyping og læring (ingen kredittkort kreves) - **Utviklingsverktøy**: Docker-containere, VS Code og GitHub Codespaces-konfigurasjon -- **[→ Start Kapittel 2](./02-SetupDevEnvironment/README.md)** +- **[→ Start kapittel 2](./02-SetupDevEnvironment/README.md)** -### **Kapittel 3: Kjerne Generativ AI-teknikker** -- **Prompt Engineering**: Teknikker for optimale AI-modellresponser -- **Embedding og vektoroperasjoner**: Implementer semantisk søk og likhetsmatching +### **Kapittel 3: Kjerne teknikker for generativ AI** +- **Prompt Engineering**: Teknikker for optimale AI-modellsvar +- **Embeddings og vektoroperasjoner**: Implementer semantisk søk og likhetsmatching - **Retrieval-Augmented Generation (RAG)**: Kombiner AI med egne datakilder -- **Funksjonskalling**: Utvid AI-kapasiteter med egendefinerte verktøy og plugins -- **[→ Start Kapittel 3](./03-CoreGenerativeAITechniques/README.md)** +- **Funksjonsanrop**: Utvid AI-muligheter med egendefinerte verktøy og plugins +- **[→ Start kapittel 3](./03-CoreGenerativeAITechniques/README.md)** ### **Kapittel 4: Praktiske anvendelser og prosjekter** -- **Forteller om kjæledyr** (`petstory/`): Kreativ innholdsgenerering med GitHub-modeller +- **Pet Story Generator** (`petstory/`): Kreativ innholdsgenerering med GitHub Models - **Foundry Local Demo** (`foundrylocal/`): Lokal AI-modellintegrasjon med OpenAI Java SDK -- **MCP Kalkulatortjeneste** (`calculator/`): Grunnleggende Modell Kontekst Protokoll-implementasjon med Spring AI -- **[→ Start Kapittel 4](./04-PracticalSamples/README.md)** +- **MCP Calculator Service** (`calculator/`): Enkel implementering av Model Context Protocol med Spring AI +- **[→ Start kapittel 4](./04-PracticalSamples/README.md)** ### **Kapittel 5: Ansvarlig AI-utvikling** -- **GitHub-modellers sikkerhet**: Test innebygde innholdsfiltreringer og sikkerhetsmekanismer (hard blokkering og myke avslag) +- **GitHub Models sikkerhet**: Test innebygd innholdsfiltrering og sikkerhetsmekanismer (hard blokker og myke avslag) - **Ansvarlig AI-demo**: Praktisk eksempel som viser hvordan moderne AI-sikkerhetssystemer fungerer i praksis -- **Beste praksis**: Essensielle retningslinjer for etisk AI-utvikling og utrulling -- **[→ Start Kapittel 5](./05-ResponsibleGenAI/README.md)** +- **Beste praksis**: Viktige retningslinjer for etisk AI-utvikling og distribusjon +- **[→ Start kapittel 5](./05-ResponsibleGenAI/README.md)** ## Ekstra ressurser @@ -112,18 +103,18 @@ CO_OP_TRANSLATOR_METADATA: --- -### Kjerne-læring +### Kjerneopplæring [![ML for nybegynnere](https://img.shields.io/badge/ML%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=22C55E)](https://aka.ms/ml-beginners?WT.mc_id=academic-105485-koreyst) [![Data Science for nybegynnere](https://img.shields.io/badge/Data%20Science%20for%20Beginners-84CC16?style=for-the-badge&labelColor=E5E7EB&color=84CC16)](https://aka.ms/datascience-beginners?WT.mc_id=academic-105485-koreyst) [![AI for nybegynnere](https://img.shields.io/badge/AI%20for%20Beginners-A3E635?style=for-the-badge&labelColor=E5E7EB&color=A3E635)](https://aka.ms/ai-beginners?WT.mc_id=academic-105485-koreyst) -[![Cybersecurity for nybegynnere](https://img.shields.io/badge/Cybersecurity%20for%20Beginners-F97316?style=for-the-badge&labelColor=E5E7EB&color=F97316)](https://github.com/microsoft/Security-101?WT.mc_id=academic-96948-sayoung) -[![Web-utvikling for nybegynnere](https://img.shields.io/badge/Web%20Dev%20for%20Beginners-EC4899?style=for-the-badge&labelColor=E5E7EB&color=EC4899)](https://aka.ms/webdev-beginners?WT.mc_id=academic-105485-koreyst) +[![Cybersikkerhet for nybegynnere](https://img.shields.io/badge/Cybersecurity%20for%20Beginners-F97316?style=for-the-badge&labelColor=E5E7EB&color=F97316)](https://github.com/microsoft/Security-101?WT.mc_id=academic-96948-sayoung) +[![Web Dev for Beginners](https://img.shields.io/badge/Web%20Dev%20for%20Beginners-EC4899?style=for-the-badge&labelColor=E5E7EB&color=EC4899)](https://aka.ms/webdev-beginners?WT.mc_id=academic-105485-koreyst) [![IoT for Beginners](https://img.shields.io/badge/IoT%20for%20Beginners-14B8A6?style=for-the-badge&labelColor=E5E7EB&color=14B8A6)](https://aka.ms/iot-beginners?WT.mc_id=academic-105485-koreyst) [![XR Development for Beginners](https://img.shields.io/badge/XR%20Development%20for%20Beginners-38BDF8?style=for-the-badge&labelColor=E5E7EB&color=38BDF8)](https://github.com/microsoft/xr-development-for-beginners?WT.mc_id=academic-105485-koreyst) --- -### Copilot Series +### Copilot-serien [![Copilot for AI Paired Programming](https://img.shields.io/badge/Copilot%20for%20AI%20Paired%20Programming-FACC15?style=for-the-badge&labelColor=E5E7EB&color=FACC15)](https://aka.ms/GitHubCopilotAI?WT.mc_id=academic-105485-koreyst) [![Copilot for C#/.NET](https://img.shields.io/badge/Copilot%20for%20C%23/.NET-FBBF24?style=for-the-badge&labelColor=E5E7EB&color=FBBF24)](https://github.com/microsoft/mastering-github-copilot-for-dotnet-csharp-developers?WT.mc_id=academic-105485-koreyst) [![Copilot Adventure](https://img.shields.io/badge/Copilot%20Adventure-FDE68A?style=for-the-badge&labelColor=E5E7EB&color=FDE68A)](https://github.com/microsoft/CopilotAdventures?WT.mc_id=academic-105485-koreyst) @@ -131,7 +122,7 @@ CO_OP_TRANSLATOR_METADATA: ## Få hjelp -Hvis du sitter fast eller har spørsmål om å bygge AI-apper. Bli med andre lærende og erfarne utviklere i diskusjoner om MCP. Det er et støttende fellesskap hvor spørsmål er velkomne og kunnskap deles fritt. +Hvis du står fast eller har spørsmål om å bygge AI-apper. Bli med andre lærende og erfarne utviklere i diskusjoner om MCP. Det er et støttende fellesskap hvor spørsmål er velkomne og kunnskap deles fritt. [![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) @@ -143,5 +134,5 @@ Hvis du har produktinnspill eller feil mens du bygger, besøk: **Ansvarsfraskrivelse**: -Dette dokumentet er oversatt ved hjelp av AI-oversettelsestjenesten [Co-op Translator](https://github.com/Azure/co-op-translator). Selv om vi streber etter nøyaktighet, vær oppmerksom på at automatiske oversettelser kan inneholde feil eller unøyaktigheter. Det opprinnelige dokumentet på originalspråket bør betraktes som den autoritative kilden. For kritisk informasjon anbefales profesjonell menneskelig oversettelse. Vi er ikke ansvarlige for misforståelser eller feiltolkninger som oppstår ved bruk av denne oversettelsen. +Dette dokumentet er oversatt ved hjelp av AI-oversettelsestjenesten [Co-op Translator](https://github.com/Azure/co-op-translator). Selv om vi streber etter nøyaktighet, vennligst vær oppmerksom på at automatiske oversettelser kan inneholde feil eller unøyaktigheter. Det originale dokumentet på dets opprinnelige språk bør betraktes som den autoritative kilden. For kritisk informasjon anbefales profesjonell menneskelig oversettelse. Vi er ikke ansvarlige for eventuelle misforståelser eller feiltolkninger som oppstår ved bruk av denne oversettelsen. \ No newline at end of file diff --git a/translations/no/SECURITY.md b/translations/no/SECURITY.md index b183e001..cceeec04 100644 --- a/translations/no/SECURITY.md +++ b/translations/no/SECURITY.md @@ -1,12 +1,3 @@ - ## Sikkerhet Microsoft tar sikkerheten til våre programvareprodukter og tjenester på alvor, inkludert alle kildekoderepositorier som administreres gjennom våre GitHub-organisasjoner, som inkluderer [Microsoft](https://github.com/Microsoft), [Azure](https://github.com/Azure), [DotNet](https://github.com/dotnet), [AspNet](https://github.com/aspnet) og [Xamarin](https://github.com/xamarin). diff --git a/translations/no/SUPPORT.md b/translations/no/SUPPORT.md index aeaef316..6611034b 100644 --- a/translations/no/SUPPORT.md +++ b/translations/no/SUPPORT.md @@ -1,12 +1,3 @@ - # Støtte ## Hvordan rapportere problemer og få hjelp diff --git a/translations/pa/.co-op-translator.json b/translations/pa/.co-op-translator.json new file mode 100644 index 00000000..d96ae886 --- /dev/null +++ b/translations/pa/.co-op-translator.json @@ -0,0 +1,92 @@ +{ + "01-IntroToGenAI/README.md": { + "original_hash": "75bfb080ca725e8a9aa9c80cae25fba1", + "translation_date": "2025-07-29T08:56:00+00:00", + "source_file": "01-IntroToGenAI/README.md", + "language_code": "pa" + }, + "02-SetupDevEnvironment/README.md": { + "original_hash": "96a30d42b9751a3d4e4b20e28d29d459", + "translation_date": "2026-01-28T04:53:07+00:00", + "source_file": "02-SetupDevEnvironment/README.md", + "language_code": "pa" + }, + "02-SetupDevEnvironment/examples/basic-chat-azure/README.md": { + "original_hash": "efd82efe50711d7e257eb943151d682c", + "translation_date": "2025-07-27T13:38:54+00:00", + "source_file": "02-SetupDevEnvironment/examples/basic-chat-azure/README.md", + "language_code": "pa" + }, + "02-SetupDevEnvironment/getting-started-azure-openai.md": { + "original_hash": "bfdb4b4eadbee3a59ef742439f58326a", + "translation_date": "2025-07-27T13:04:16+00:00", + "source_file": "02-SetupDevEnvironment/getting-started-azure-openai.md", + "language_code": "pa" + }, + "03-CoreGenerativeAITechniques/README.md": { + "original_hash": "685f55cb07de19b52a30ce6e8b6d889e", + "translation_date": "2025-08-28T22:02:48+00:00", + "source_file": "03-CoreGenerativeAITechniques/README.md", + "language_code": "pa" + }, + "04-PracticalSamples/README.md": { + "original_hash": "14c0a61ecc1cd2012a9c129236dfdf71", + "translation_date": "2025-07-29T08:55:37+00:00", + "source_file": "04-PracticalSamples/README.md", + "language_code": "pa" + }, + "04-PracticalSamples/calculator/README.md": { + "original_hash": "b6c16b5514d524e415a94f6097ee7d4c", + "translation_date": "2025-09-18T15:29:50+00:00", + "source_file": "04-PracticalSamples/calculator/README.md", + "language_code": "pa" + }, + "04-PracticalSamples/foundrylocal/README.md": { + "original_hash": "f787307400de59adc25a1404466a35f3", + "translation_date": "2025-11-04T07:21:52+00:00", + "source_file": "04-PracticalSamples/foundrylocal/README.md", + "language_code": "pa" + }, + "04-PracticalSamples/petstory/README.md": { + "original_hash": "0cbf68d605615a1e602c832a24616859", + "translation_date": "2025-07-25T11:13:17+00:00", + "source_file": "04-PracticalSamples/petstory/README.md", + "language_code": "pa" + }, + "05-ResponsibleGenAI/README.md": { + "original_hash": "301c05c2f57e60a6950b8c665b8bdbba", + "translation_date": "2025-07-29T15:47:49+00:00", + "source_file": "05-ResponsibleGenAI/README.md", + "language_code": "pa" + }, + "AGENTS.md": { + "original_hash": "afc90918d008cf77fd1982691f681306", + "translation_date": "2025-10-03T08:33:43+00:00", + "source_file": "AGENTS.md", + "language_code": "pa" + }, + "CODE_OF_CONDUCT.md": { + "original_hash": "442b123d034f92f7c384d2bbd28f99f1", + "translation_date": "2025-07-21T17:36:57+00:00", + "source_file": "CODE_OF_CONDUCT.md", + "language_code": "pa" + }, + "README.md": { + "original_hash": "125a08948d881c95628094f4dd1fbd43", + "translation_date": "2026-01-29T15:39:22+00:00", + "source_file": "README.md", + "language_code": "pa" + }, + "SECURITY.md": { + "original_hash": "57f14126c1c6add76b3aef3844dfe4e3", + "translation_date": "2025-07-21T17:35:26+00:00", + "source_file": "SECURITY.md", + "language_code": "pa" + }, + "SUPPORT.md": { + "original_hash": "b8ef73cc49dec68e2c885ee9df545129", + "translation_date": "2025-07-21T17:38:03+00:00", + "source_file": "SUPPORT.md", + "language_code": "pa" + } +} \ No newline at end of file diff --git a/translations/pa/01-IntroToGenAI/README.md b/translations/pa/01-IntroToGenAI/README.md index b0a19946..cc8e8f06 100644 --- a/translations/pa/01-IntroToGenAI/README.md +++ b/translations/pa/01-IntroToGenAI/README.md @@ -1,12 +1,3 @@ - # ਜਨਰੇਟਿਵ AI - ਜਾਵਾ ਐਡੀਸ਼ਨ ਦਾ ਪਰਚੇ ## ਤੁਸੀਂ ਕੀ ਸਿੱਖੋਗੇ diff --git a/translations/pa/02-SetupDevEnvironment/README.md b/translations/pa/02-SetupDevEnvironment/README.md index 4d70f26c..96989fcc 100644 --- a/translations/pa/02-SetupDevEnvironment/README.md +++ b/translations/pa/02-SetupDevEnvironment/README.md @@ -1,13 +1,254 @@ - +# ਜੇਨੇਰੇਟਿਵ ਏਆਈ ਲਈ ਜਾਵਾ ਦੇ ਵਿਕਾਸਕਾਰੀ ਮਾਹੌਲ ਨੂੰ ਸੈਟਅਪ ਕਰਨਾ +> **ਥੋੜ੍ਹੀ ਦੇਰ ਵਿੱਚ ਸ਼ੁਰੂ ਕਰੋ**: 2 ਮਿੰਟਾਂ ਵਿੱਚ ਕਲਾਉਡ ਵਿੱਚ ਕੋਡ ਕਰੋ - [GitHub ਕੋਡਸਪੇਸ ਸੈਟਅਪ](../../../02-SetupDevEnvironment) ਤੇ ਜਾਓ - ਕੋਈ ਸਥਾਨਕ ਇੰਸਟਾਲੇਸ਼ਨ ਲੋੜੀਂਦੀ ਨਹੀਂ ਅਤੇ github ਮਾਡਲ ਉਪਯੋਗ ਕਰਦਾ ਹੈ! + +> **Azure OpenAI ਵਿੱਚ ਦਿਲਚਸਪੀ ਹੈ?**, ਸਾਡੇ [Azure OpenAI ਸੈਟਅਪ ਗਾਈਡ](getting-started-azure-openai.md) ਵਿੱਚ ਵੇਖੋ ਜਿੱਦੇ ਵਿੱਚ ਨਵਾਂ Azure OpenAI ਰਿਸੋਰਸ ਬਣਾਉਣ ਦੇ ਕਦਮ ਹਨ। + +## ਤੁਸੀਂ ਕੀ ਸਿੱਖੋਗੇ + +- AI ਐਪਲੀਕੇਸ਼ਨਾਂ ਲਈ ਜਾਵਾ ਦੇ ਵਿਕਾਸਕਾਰੀ ਮਾਹੌਲ ਦੀ ਸੈਟਅਪ ਕਰਨਾ +- ਆਪਣੀ ਪਸੰਦ ਨੁਸਰ ਵਿਕਾਸਕਾਰੀ ਮਾਹੌਲ ਚੁਣੋ ਅਤੇ ਅਨੁਕੂਲਿਤ ਕਰੋ (Codespaces ਨਾਲ ਕਲਾਉਡ-ਪਹਿਲਾ, ਸਥਾਨਕ ਡੇਵ ਕਨਟੇਨਰ, ਜਾਂ ਪੂਰੀ ਸਥਾਨਕ ਸੈਟਅਪ) +- GitHub ਮਾਡਲ ਨਾਲ ਕਨੈਕਟ ਕਰਕੇ ਆਪਣੀ ਸੈਟਅਪ ਦੀ ਜਾਂਚ ਕਰੋ + +## ਮਾਹਿਰ ਸੂਚੀ + +- [ਤੁਸੀਂ ਕੀ ਸਿੱਖੋਗੇ](../../../02-SetupDevEnvironment) +- [ਪਰਿਚਇ](../../../02-SetupDevEnvironment) +- [ਕਦਮ 1: ਆਪਣਾ ਵਿਕਾਸਕਾਰੀ ਮਾਹੌਲ ਸੈਟਅਪ ਕਰੋ](../../../02-SetupDevEnvironment) + - [ਵਿਕਲਪ ਏ: GitHub ਕੋਡਸਪੇਸ (ਸਿਫਾਰਸ਼ੀ)](../../../02-SetupDevEnvironment) + - [ਵਿਕਲਪ ਬੀ: ਸਥਾਨਕ ਡੇਵ ਕਨਟੇਨਰ](../../../02-SetupDevEnvironment) + - [ਵਿਕਲਪ ਸੀ: ਆਪਣੀ ਮੌਜੂਦਾ ਸਥਾਨਕ ਇੰਸਟਾਲੇਸ਼ਨ ਵਰਤੋਂ](../../../02-SetupDevEnvironment) +- [ਕਦਮ 2: GitHub ਪ੍ਰਸਨਲ ਐਕਸੈਸ ਟੋਕਨ ਬਣਾਓ](../../../02-SetupDevEnvironment) +- [ਕਦਮ 3: GitHub ਮਾਡਲਾਂ ਨਾਲ ਆਪਣੀ ਸੈਟਅਪ ਦੀ ਜਾਂਚ ਕਰੋ](../../../02-SetupDevEnvironment) +- [ਸਮੱਸਿਆ ਸਮਾਧਾਨ](../../../02-SetupDevEnvironment) +- [ਸਾਰ](../../../02-SetupDevEnvironment) +- [ਅਗਲੇ ਕਦਮ](../../../02-SetupDevEnvironment) + +## ਪਰਿਚਇ + +ਇਹ ਅਧਿਆਇ ਤੁਹਾਨੂੰ ਵਿਕਾਸਕਾਰੀ ਮਾਹੌਲ ਸੈਟਅਪ ਕਰਨ ਵਿੱਚ ਮਦਦ ਦੇਵੇਗਾ। ਅਸੀਂ ਆਪਣਾ ਮੁੱਖ ਉਦਾਹਰਨ ਵਜੋਂ **GitHub Models** ਨੂੰ ਉਪਯੋਗ ਕਰਾਂਗੇ ਕਿਉਂਕਿ ਇਹ ਮੁਫਤ ਹੈ, ਸਿਰਫ ਇੱਕ GitHub ਅਕਾਉਂਟ ਨਾਲ ਆਸਾਨੀ ਨਾਲ ਸੈਟਅਪ ਹੁੰਦਾ ਹੈ, ਕਿਸੇ ਕਰੈਡਿਟ ਕਾਰਡ ਦੀ ਲੋੜ ਨਹੀਂ ਹੈ, ਅਤੇ ਪ੍ਰਯੋਗ ਲਈ ਇਕੱਠੇ ਕਈ ਮਾਡਲ ਮੁਹੱਈਆ ਕਰਵਾਉਂਦਾ ਹੈ। + +**ਕੋਈ ਸਥਾਨਕ ਸੈਟਅਪ ਲੋੜੀਂਦੀ ਨਹੀਂ!** ਤੁਸੀਂ ਤੁਰੰਤ GitHub Codespaces ਦੀ ਵਰਤੋਂ ਕਰਕੇ ਬ੍ਰਾਊਜ਼ਰ ਵਿੱਚ ਪੂਰਾ ਵਿਕਾਸਕਾਰੀ ਮਾਹੌਲ ਵਰਤ ਸਕਦੇ ਹੋ। + +ਸਕਰੀਨਸ਼ਾਟ: GitHub Models + +ਅਸੀਂ ਇਸ ਕੋਰਸ ਲਈ [**GitHub Models**](https://github.com/marketplace?type=models) ਵਰਤੋਂ ਦੀ ਸਿਫਾਰਸ਼ ਕਰਦੇ ਹਾਂ ਕਿਉਂਕਿ ਇਹ: +- ਸ਼ੁਰੂ ਕਰਨ ਲਈ **ਮੁਫਤ** ਹੈ +- ਸਿਰਫ ਇੱਕ GitHub ਅਕਾਉਂਟ ਨਾਲ **ਆਸਾਨ** ਸੈਟਅਪ +- **ਕੋਈ ਕਰੈਡਿਟ ਕਾਰਡ ਚਾਹੀਦਾ ਨਹੀਂ** +- **ਕਈ ਮਾਡਲ** ਪ੍ਰਯੋਗ ਲਈ ਉਪਲਬਧ + +> **ਨੋਟ**: ਇਸ ਟ੍ਰੇਨਿੰਗ ਵਿੱਚ ਵਰਤੇ GitHub Models ਲਈ ਮੁਫਤ ਸੀਮਾਵਾਂ ਹਨ: +> - 15 ਬੇਨਤੀਆਂ ਪ੍ਰਤੀ ਮਿੰਟ (150 ਪ੍ਰਤੀ ਦਿਨ) +> - ਹਰ ਬੇਨਤੀ ਵਿੱਚ ਲਗਭਗ 8,000 ਸ਼ਬਦ ਇਹਨਾਂ 'ਚ, ਲਗਭਗ 4,000 ਸ਼ਬਦ ਬਾਹਰ +> - 5 ਇਕਸਾਰ ਬੇਨਤੀਆਂ +> +> ਉਤਪਾਦਨ ਲਈ, Azure ਖਾਤੇ ਨਾਲ Azure AI Foundry ਮਾਡਲਾਂ ਵਿੱਚ ਅੱਪਗਰੇਡ ਕਰੋ। ਤੁਹਾਡੇ ਕੋਡ ਵਿੱਚ ਕੋਈ ਬਦਲਾਅ ਦੀ ਲੋੜ ਨਹੀਂ। ਵੇਖੋ [Azure AI Foundry ਡੌਕਯੂਮੈਂਟੇਸ਼ਨ](https://learn.microsoft.com/azure/ai-foundry/foundry-models/how-to/quickstart-github-models)। + +## ਕਦਮ 1: ਆਪਣਾ ਵਿਕਾਸਕਾਰੀ ਮਾਹੌਲ ਸੈਟਅਪ ਕਰੋ + + + +ਅਸੀਂ ਇੱਕ ਪਹਿਲਾਂ ਤਿਆਰ ਕੀਤਾ ਡੇਵ ਕਨਟੇਨਰ ਬਣਾਇਆ ਹੈ ਤਾਂ ਜੋ ਸੈਟਅਪ ਦਾ ਸਮਾਂ ਘੱਟ ਹੋਵੇ ਅਤੇ ਤੁਹਾਡੇ ਕੋਲ ਜ਼ਰੂਰੀ ਟੂਲ ਹੋਣ। ਆਪਣੀ ਪਸੰਦ ਦਾ ਵਿਕਾਸਕਾਰੀ ਤਰੀਕਾ ਚੁਣੋ: + +### ਮਾਹੌਲ ਸੈਟਅਪ ਦੇ ਵਿਕਲਪ: + +#### ਵਿਕਲਪ ਏ: GitHub ਕੋਡਸਪੇਸ (ਸਿਫਾਰਸ਼ੀ) + +**2 ਮਿੰਟਾਂ ਵਿੱਚ ਕੋਡਿੰਗ ਸ਼ੁਰੂ ਕਰੋ - ਕੋਈ ਸਥਾਨਕ ਸੈਟਅਪ ਲੋੜੀਂਦੀ ਨਹੀਂ!** + +1. ਇਸ ਰਿਪੋਜਿਟਰੀ ਨੂੰ ਆਪਣੇ GitHub ਅਕਾਉਂਟ ਤੇ fork ਕਰੋ + > **ਨੋਟ**: ਜੇ ਤੁਸੀਂ ਮੂਲ ਕੰਫਿਗਰੇਸ਼ਨ ਸੋਧਣਾ ਚਾਹੁੰਦੇ ਹੋ ਤਾਂ [Dev Container Configuration](../../../.devcontainer/devcontainer.json) ਵੇਖੋ +2. **Code** → **Codespaces** ਟੈਬ → **...** → **New with options...** ਤੇ ਕਲਿਕ ਕਰੋ +3. ਡੀਫੌਲਟ ਵਰਤੋਂ – ਇਹ **Dev container configuration** ਚੁਣੇਗਾ: **Generative AI Java Development Environment** ਕਸਟਮ devcontainer ਜੋ ਇਸ ਕੋਰਸ ਲਈ ਬਣਾਇਆ ਗਿਆ ਹੈ +4. **Create codespace** ਤੇ ਕਲਿਕ ਕਰੋ +5. ਮਾਹੌਲ ਤਿਆਰ ਹੋਣ ਲਈ ਲਗਭਗ 2 ਮਿੰਟ ਉਡੀਕ ਕਰੋ +6. [ਕਦਮ 2: GitHub ਟੋਕਨ ਬਣਾਓ](../../../02-SetupDevEnvironment) ਤੇ ਜਾਓ + +ਸਕਰੀਨਸ਼ਾਟ: Codespaces ਸਬਮੇਨੂ + +ਸਕਰੀਨਸ਼ਾਟ: New with options + +ਸਕਰੀਨਸ਼ਾਟ: ਕੋਡਸਪੇਸ ਬਣਾਓ ਵਿਕਲਪ + +> **Codespaces ਦੇ ਫਾਇਦੇ**: +> - ਕੋਈ ਸਥਾਨਕ ਇੰਸਟਾਲੇਸ਼ਨ ਨਹੀਂ +> - ਕਿਸੇ ਵੀ ਡਿਵਾਈਸ ਤੇ ਜੋ ਬ੍ਰਾਊਜਰ ਰੱਖਦਾ ਹੈ ਉਹ ਕੰਮ ਕਰਦਾ ਹੈ +> - ਸਾਰੇ ਟੂਲ ਅਤੇ ਡਿਪੈਂਡਨਸੀਆਂ ਨਾਲ ਪਹਿਲਾਂ ਤੋਂ ਕਨਫਿਗਰਡ +> - ਨਿੱਜੀ ਅਕਾਉਂਟਾਂ ਲਈ ਮਾਸਿਕ 60 ਘੰਟੇ ਮੁਫ਼ਤ +> - ਸਾਰੇ ਵਿਦਿਆਰਥੀਆਂ ਲਈ ਇੱਕਸਾਰ ਮਾਹੌਲ + +#### ਵਿਕਲਪ ਬੀ: ਸਥਾਨਕ ਡੇਵ ਕਨਟੇਨਰ + +**ਉਹ ਵਿਕਾਸਕਾਰ ਜਿਹੜੇ Docker ਨਾਲ ਸਥਾਨਕ ਵਿਕਾਸ ਪਸੰਦ ਕਰਦੇ ਹਨ** + +1. ਇਸ ਰਿਪੋਜਿਟਰੀ ਨੂੰ fork ਅਤੇ clone ਕਰੋ ਆਪਣੇ ਸਥਾਨਕ ਮਸ਼ੀਨ 'ਤੇ + > **ਨੋਟ**: ਜੇ ਤੁਸੀਂ ਮੂਲ ਕੰਫਿਗਰੇਸ਼ਨ ਸੋਧਣਾ ਚਾਹੁੰਦੇ ਹੋ ਤਾਂ [Dev Container Configuration](../../../.devcontainer/devcontainer.json) ਵੇਖੋ +2. [Docker Desktop](https://www.docker.com/products/docker-desktop/) ਅਤੇ [VS Code](https://code.visualstudio.com/) ਇੰਸਟਾਲ ਕਰੋ +3. VS Code ਵਿੱਚ [Dev Containers ਐਕਸਟੈਂਸ਼ਨ](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers) ਇੰਸਟਾਲ ਕਰੋ +4. VS Code ਵਿੱਚ ਰਿਪੋਜਿਟਰੀ ਫੋਲਡਰ ਖੋਲ੍ਹੋ +5. ਪ੍ਰੰਪਟ ਆਉਣ 'ਤੇ, **Reopen in Container** 'ਤੇ ਕਲਿਕ ਕਰੋ (ਜਾਂ `Ctrl+Shift+P` → "Dev Containers: Reopen in Container" ਵਰਤੋਂ) +6. ਕਨਟੇਨਰ ਬਣਨ ਅਤੇ ਸਟਾਰਟ ਹੋਣ ਲਈ ਉਡੀਕ ਕਰੋ +7. [ਕਦਮ 2: GitHub ਟੋਕਨ ਬਣਾਓ](../../../02-SetupDevEnvironment) ਤੇ ਜਾਓ + +ਸਕਰੀਨਸ਼ਾਟ: ਡੇਵ ਕਨਟੇਨਰ ਸੈਟਅਪ + +ਸਕਰੀਨਸ਼ਾਟ: ਡੇਵ ਕਨਟੇਨਰ ਬਣਾਉਣ ਮੁਕੰਮਲ + +#### ਵਿਕਲਪ ਸੀ: ਆਪਣੀ ਮੌਜੂਦਾ ਸਥਾਨਕ ਇੰਸਟਾਲੇਸ਼ਨ ਵਰਤੋਂ + +**ਜਿਨ੍ਹਾਂ ਵਿਕਾਸਕਾਰਾਂ ਕੋਲ ਮੌਜੂਦਾ ਜਾਵਾ ਮਾਹੌਲ ਹੈ** + +ਜ਼ਰੂਰੀ ਸਮੱਗਰੀ: +- [Java 21+](https://www.oracle.com/java/technologies/javase/jdk21-archive-downloads.html) +- [Maven 3.9+](https://maven.apache.org/download.cgi) +- [VS Code](https://code.visualstudio.com) ਜਾਂ ਆਪਣਾ ਪਸੰਦੀਦਾ IDE + +ਕਦਮ: +1. ਇਸ ਰਿਪੋਜਿਟਰੀ ਨੂੰ ਸਥਾਨਕ ਮਸ਼ੀਨ 'ਤੇ clone ਕਰੋ +2. ਆਪਣੇ IDE ਵਿੱਚ ਪ੍ਰੋਜੈਕਟ ਖੋਲ੍ਹੋ +3. [ਕਦਮ 2: GitHub ਟੋਕਨ ਬਣਾਓ](../../../02-SetupDevEnvironment) ਤੇ ਜਾਓ + +> **ਪ੍ਰੋ ਟਿੱਪ**: ਜੇ ਤੁਹਾਡੇ ਕੋਲ ਘੱਟ-ਸਮਰੱਥਾ ਵਾਲਾ ਮਸ਼ੀਨ ਹੈ ਪਰ VS Code ਸਥਾਨਕ ਚਾਹੁੰਦੇ ਹੋ ਤਾਂ GitHub ਕੋਡਸਪੇਸ ਵਰਤੋ! ਤੁਸੀਂ ਆਪਣੇ ਸਥਾਨਕ VS Code ਨੂੰ ਇੱਕ ਕਲਾਉਡ-ਹੋਸਟੇਡ ਕੋਡਸਪੇਸ ਨਾਲ ਜੋੜ ਸਕਦੇ ਹੋ ਜੋ ਦੋਹਾਂ ਦੁਨੀਆਂ ਦਾ ਵਧੀਆ ਹੈ। + +ਸਕਰੀਨਸ਼ਾਟ: ਬਣਾਇਆ ਹੋਇਆ ਸਥਾਨਕ ਡੇਵਕੰਟੇਨਰ ਇੰਸਟੈਂਸ + +## ਕਦਮ 2: GitHub ਪ੍ਰਸਨਲ ਐਕਸੈਸ ਟੋਕਨ ਬਣਾਓ + +1. [GitHub ਸੈਟਿੰਗਜ਼](https://github.com/settings/profile) 'ਤੇ ਜਾਓ ਅਤੇ ਆਪਣੇ ਪ੍ਰੋਫਾਈਲ ਮੀਨੂ ਵਿੱਚੋਂ **Settings** ਚੁਣੋ। +2. ਖੱਬੇ ਫਲੈਸ਼ਤਰ ਵਿੱਚ **Developer settings** 'ਤੇ ਕਲਿਕ ਕਰੋ (ਆਮਤੌਰ 'ਤੇ ਹੇਠਾਂ) +3. **Personal access tokens** ਹੇਠਾਂ, **Fine-grained tokens** 'ਤੇ ਕਲਿਕ ਕਰੋ (ਜਾਂ ਇਹ [ਸਿੱਧਾ ਲਿੰਕ](https://github.com/settings/personal-access-tokens) ਵਰਤੋਂ) +4. **Generate new token** 'ਤੇ ਕਲਿਕ ਕਰੋ +5. "ਟੋਕਨ ਨਾਮ" ਵਿੱਚ ਵਰਣਨਾਤਮਕ ਨਾਮ ਦਿਓ (ਜਿਵੇਂ `GenAI-Java-Course-Token`) +6. ਇੱਕ ਮਿਆਦ-ਅੰਤ ਦੀ ਤਾਰੀਖ ਸੈੱਟ ਕਰੋ (ਸੁਰੱਖਿਆ ਲਈ 7 ਦਿਨ ਸੁਝਾਏ ਗਏ ਹਨ) +7. "Resource owner" ਹੇਠ ਆਪਣੇ ਯੂਜ਼ਰ ਅਕਾਉਂਟ ਨੂੰ ਚੁਣੋ +8. "Repository access" ਵਿੱਚ ਆਪਣੀ ਵਰਤੋਂ ਲਈ ਰਿਪੋਜਿਟਰੀਆਂ ਚੁਣੋ (ਜਾਂ ਸਾਰੇ ਰਿਪੋ 'ਚਾਵੋ) +9. "Account permissions" ਵਿੱਚ **Models** ਨੂੰ **Read-only** ਸੈੱਟ ਕਰੋ +10. **Generate token** 'ਤੇ ਕਲਿਕ ਕਰੋ +11. ਹੁਣੇ ਹੀ ਆਪਣੇ ਟੋਕਨ ਨੂੰ ਕਾਪੀ ਅਤੇ ਸੰਭਾਲੋ – ਇਹ ਫਿਰ ਨਹੀਂ ਦਿਖਾਇਆ ਜਾਵੇਗਾ! + +> **ਸੁਰੱਖਿਆ ਟਿੱਪ**: ਆਪਣੀ ਐਕਸੈਸ ਟੋਕਨ ਲਈ ਘੱਟੋ-ਘੱਟ ਲੋੜੀਂਦਾ ਸਕੋਪ ਅਤੇ ਸਭ ਤੋਂ ਛੋਟਾ ਕਾਰਗਰ ਮਿਆਦ ਅੰਤ ਵਰਤੋਂ। + +## ਕਦਮ 3: GitHub ਮਾਡਲ ਨਾਲ ਆਪਣੀ ਸੈਟਅਪ ਦੀ ਜਾਂਚ ਕਰੋ + +ਜਦੋਂ ਤੁਹਾਡਾ ਵਿਕਾਸਕਾਰੀ ਮਾਹੌਲ ਤਿਆਰ ਹੋ ਜਾਵੇ, ਤਾਂ ਆਓ ਇੱਕ ਸਧਾਰਣ ਐਪਲੀਕੇਸ਼ਨ ਵਿੱਚ GitHub Models ਇন্টੈਗਰੇਸ਼ਨ ਦੀ ਜਾਂਚ ਕਰੀਏ ਜਾਂ [examples/github-models](../../../02-SetupDevEnvironment/examples/github-models) ਵਿੱਚ। + +1. ਆਪਣੀ ਵਿਕਾਸਕਾਰੀ ਮਾਹੌਲ ਵਿੱਚ ਟਰਮੀਨਲ ਖੋਲੋ। +2. GitHub Models ਉਦਾਹਰਨ ਵਾਲੇ ਫੋਲਡਰ ਵਿਚ ਜਾਓ: + ```bash + cd 02-SetupDevEnvironment/examples/github-models + ``` +3. ਆਪਣਾ GitHub ਟੋਕਨ ਇੱਕ ਵਾਤਾਵਰਣ ਵੈਰੀਏਬਲ ਵਜੋਂ ਸੈੱਟ ਕਰੋ: + ```bash + # ਮੈਕਓਐਸ/ਲਿਨਕਸ + export GITHUB_TOKEN=your_token_here + + # ਵਿੰਡੋਜ਼ (ਕਮਾਂਡ ਪ੍ਰਾਂਪਟ) + set GITHUB_TOKEN=your_token_here + + # ਵਿੰਡੋਜ਼ (ਪਾਵਰਸ਼ੈੱਲ) + $env:GITHUB_TOKEN="your_token_here" + ``` + +4. ਐਪਲੀਕੇਸ਼ਨ ਚਲਾਓ: + ```bash + mvn compile exec:java -Dexec.mainClass="com.example.githubmodels.App" + ``` + +ਤੁਸੀਂ ਇਸ ਤਰ੍ਹਾਂ ਦਾ ਆਉਟਪੁੱਟ ਵੇਖੋਗੇ: +```text +Using model: gpt-4.1-nano +Sending request to GitHub Models... +Response: Hello World! +``` + + +### ਉਦਾਹਰਨ ਕੋਡ ਨੂੰ ਸਮਝਣਾ + +ਸਭ ਤੋਂ ਪਹਿਲਾਂ, ਦੇਖੀਏ ਅਸੀਂ ਜੋ ਚਲਾਇਆ ਉਹ ਕੀ ਕਰਦਾ ਹੈ। `examples/github-models` ਹੇਠ ਦਿੱਤਾ ਉਦਾਹਰਨ OpenAI Java SDK ਵਰਤ ਕੇ GitHub Models ਨਾਲ ਕਨੈਕਟ ਕਰਦਾ ਹੈ: + +**ਇਹ ਕੋਡ ਕੀ ਕਰਦਾ ਹੈ:** +- ਤੁਹਾਡੇ ਪ੍ਰਸਨਲ ਐਕਸੈਸ ਟੋਕਨ ਦੀ ਵਰਤੋਂ ਕਰਕੇ GitHub Models ਨਾਲ **ਕਨੈਕਟ ਹੋਣਾ** +- AI ਮਾਡਲ ਨੂੰ ਇੱਕ ਸਧਾਰਣ "Say Hello World!" ਸੁਨੇਹਾ ਭੇਜਣਾ +- AI ਦਾ ਪ੍ਰਤਿਕਿਰਿਆ ਪ੍ਰਾਪਤ ਕਰਨਾ ਅਤੇ ਦਿਖਾਉਣਾ +- ਤੁਹਾਡੀ ਸੈਟਅਪ ਦੀ ਸਹੀ ਕਾਰਗੁਜ਼ਾਰੀ ਦੀ ਪੁਸ਼ਟੀ ਕਰਨਾ + +**ਮੁੱਖ ਡਿਪੈਂਡੈਂਸੀ** (`pom.xml` ਵਿੱਚ): +```xml + + com.openai + openai-java + 2.12.0 + +``` + + +**ਮੁੱਖ ਕੋਡ** (`App.java`): +```java +// OpenAI ਜਾਵਾ SDK ਦੀ ਵਰਤੋਂ ਕਰਕੇ GitHub ਮਾਡਲਾਂ ਨਾਲ ਜੁੜੋ +OpenAIClient client = OpenAIOkHttpClient.builder() + .apiKey(pat) + .baseUrl("https://models.inference.ai.azure.com") + .build(); + +// ਚੈਟ ਮੁਕੰਮਲ ਕਰਨ ਦੀ ਬੇਨਤੀ ਬਣਾਓ +ChatCompletionCreateParams params = ChatCompletionCreateParams.builder() + .model(modelId) + .addSystemMessage("You are a concise assistant.") + .addUserMessage("Say Hello World!") + .build(); + +// AI ਜਵਾਬ ਪ੍ਰਾਪਤ ਕਰੋ +ChatCompletion response = client.chat().completions().create(params); +System.out.println("Response: " + response.choices().get(0).message().content().orElse("No response content")); +``` + + +## ਸਾਰ + +ਸ਼ਾਬਾਸ਼! ਹੁਣ ਤੁਹਾਡੇ ਕੋਲ ਸਾਰੇ ਕੁਝ ਸੈਟਅਪ ਹੈ: + +- AI ਮਾਡਲ ਦੀ ਪਹੁੰਚ ਲਈ ਉਚਿਤ ਅਧਿਕਾਰਾਂ ਨਾਲ GitHub ਪ੍ਰਸਨਲ ਐਕਸੈਸ ਟੋਕਨ ਬਣਾਇਆ +- ਆਪਣਾ ਜਾਵਾ ਵਿਕਾਸਕਾਰੀ ਮਾਹੌਲ ਚਲਾਇਆ (ਚਾਹੇ Codespaces ਹੋਵੇ, ਡੇਵ ਕਨਟੇਨਰ, ਜਾਂ ਸਥਾਨਕ) +- ਮੁਫ਼ਤ AI ਵਿਕਾਸ ਲਈ OpenAI Java SDK ਨਾਲ GitHub Models ਨਾਲ ਕਨੈਕਟ ਕੀਤਾ +- ਇੱਕ ਸਾਦਾ ਉਦਾਹਰਨ ਨਾਲ ਟੈਸਟ ਕੀਤਾ ਜੋ AI ਮਾਡਲਾਂ ਨਾਲ ਗੱਲ ਕਰਦਾ ਹੈ + +## ਅਗਲੇ ਕਦਮ + +[ਅਧਿਆਇ 3: ਕੋਰ ਜੇਨੇਰੇਟਿਵ ਏਆਈ ਤਕਨੀਕਾਂ](../03-CoreGenerativeAITechniques/README.md) + +## ਸਮੱਸਿਆ ਸਮਾਧਾਨ + +ਮੁਸ਼ਕਿਲ ਹੋ ਰਹੀ ਹੈ? ਇਹ ਸਭ ਤੋਂ ਆਮ ਸਮੱਸਿਆਵਾਂ ਅਤੇ ਹੱਲ ਹਨ: + +- **ਟੋਕਨ ਕੰਮ ਨਹੀਂ ਕਰ ਰਿਹਾ?** + - ਪੂਰਾ ਟੋਕਨ ਕਾਪੀ ਕੀਤਾ ਹੈ ਬਿਨਾਂ ਕਿਸੇ ਵਾਧੂ ਖਾਲੀ ਥਾਂ ਦੇ + - ਟੋਕਨ ਸਹੀ ਤਰ੍ਹਾਂ ਵਾਤਾਵਰਣ ਵੈਰੀਏਬਲ ਵਿੱਚ ਸੈਟ ਹੈ ਜਾਂ ਨਹੀਂ ਜਾਂਚ ਕਰੋ + - ਆਪਣੇ ਟੋਕਨ ਦੀ ਅਧਿਕਾਰਾਂ (Models: Read-only) ਨੂੰ ਵੇਰੀਫਾਈ ਕਰੋ + +- **Maven ਨਹੀਂ ਮਿਲ ਰਿਹਾ?** + - ਜੇ dev ਕਨਟੇਨਰ/ਕੋਡਸਪੇਸ ਵਰਤ ਰਹੇ ਹੋ ਤਾਂ Maven ਪਹਿਲਾਂ ਤੋਂ ਇੰਸਟਾਲ ਹੋਣਾ ਚਾਹੀਦਾ ਹੈ + - ਸਥਾਨਕ ਸੈਟਅਪ ਲਈ, Java 21+ ਅਤੇ Maven 3.9+ ਇੰਸਟਾਲ ਹੈ ਯਕੀਨੀ ਬਣਾਓ + - `mvn --version` ਚਲਾਕੇ ਇੰਸਟਾਲੇਸ਼ਨ ਚੈੱਕ ਕਰੋ + +- **ਕਨੈਕਸ਼ਨ ਸਮੱਸਿਆ?** + - ਇੰਟਰਨੈੱਟ ਕਨੈਕਸ਼ਨ ਚੈੱਕ ਕਰੋ + - ਜਾਂਚੋ ਕਿ ਤੁਹਾਡੀ ਨੈੱਟਵਰਕ ਤੋਂ GitHub ਐਕਸੈਸਬਲ ਹੈ + - ਯਕੀਨ ਕਰੋ ਕਿ ਤੁਰੰਤ GitHub Models ਐਂਡਪੌਇੰਟ ਬੰਦ ਕਰਨ ਵਾਲਾ ਕੋਈ ਫਾਇਰਵਾਲ ਨਹੀਂ ਹੈ + +- **ਡੇਵ ਕਨਟੇਨਰ ਸਟਾਰਟ ਨਹੀਂ ਹੋ ਰਿਹਾ?** + - ਯਕੀਨ ਕਰੋ Docker Desktop ਚੱਲ ਰਿਹਾ ਹੈ (ਸਥਾਨਕ ਵਿਖਸਾਸ ਲਈ) + - ਕਨਟੇਨਰ ਨੂੰ ਦੁਬਾਰਾ ਬਣਾਉਣ ਦੀ ਕੋਸ਼ਿਸ਼ ਕਰੋ: `Ctrl+Shift+P` → "Dev Containers: Rebuild Container" + +- **ਐਪਲੀਕੇਸ਼ਨ ਕੰਪਾਈਲ ਕਰਨ 'ਚ ਗਲਤੀਆਂ?** + - ਯਕੀਨ ਕਰੋ ਕਿ ਤੁਸੀਂ ਸਹੀ ਡਾਇਰੈਕਟਰੀ 'ਚ ਹੋ: `02-SetupDevEnvironment/examples/github-models` + - ਸਾਫ਼ ਅਤੇ ਦੁਬਾਰਾ ਬਣਾਉਣ ਦੀ ਕੋਸ਼ਿਸ਼ ਕਰੋ: `mvn clean compile` + +> **ਮਦਦ ਚਾਹੀਦੀ ਹੈ?**: ਅਜੇ ਵੀ ਪ੍ਰਸ਼ਨ ਹਨ? ਰਿਪੋਜਿਟਰੀ ਵਿੱਚ ਇੱਕ ਮੁੱਦਾ ਖੋਲ੍ਹੋ ਅਤੇ ਅਸੀਂ ਤੁਹਾਡੀ ਮਦਦ ਕਰਾਂਗੇ। --- + +**ਅਸਵੀਕਾਰੋਕ্তੀ**: +ਇਹ ਦਸਤਾਵੇਜ਼ AI ਅਨੁਵਾਦ ਸੇਵਾ [Co-op Translator](https://github.com/Azure/co-op-translator) ਦੀ ਵਰਤੋਂ ਕਰਕੇ ਅਨੁਵਾਦਿਤ ਕੀਤਾ ਗਿਆ ਹੈ। ਜਦੋਂ ਕਿ ਅਸੀਂ ਸਹੀਤਾ ਲਈ ਯਤਨਸ਼ੀਲ ਹਾਂ, ਕਿਰਪਾ ਕਰਕੇ ਧਿਆਨ ਦੇਵੋ ਕਿ ਆਟੋਮੈਟਿਕ ਅਨੁਵਾਦਾਂ ਵਿੱਚ ਗਲਤੀਆਂ ਜਾਂ ਅਣਸੁਚਿਤਤਾ ਹੋ ਸਕਦੀ ਹੈ। ਮੂਲ ਦਸਤਾਵੇਜ਼ ਆਪਣੀ ਮੂਲ ਭਾਸ਼ਾ ਵਿੱਚ ਹੀ ਪ੍ਰਮਾਣਿਕ ਸਰੋਤ ਮੰਨਿਆ ਜਾਣਾ ਚਾਹੀਦਾ ਹੈ। ਮਹੱਤਵਪੂਰਨ ਜਾਣਕਾਰੀ ਲਈ, ਪ੍ਰੋਫੈਸ਼ਨਲ ਮਨੁੱਖੀ ਅਨੁਵਾਦ ਦੀ ਸਿਫ਼ਾਰਸ਼ ਕੀਤੀ ਜਾਂਦੀ ਹੈ। ਇਸ ਅਨੁਵਾਦ ਦੀ ਵਰਤੋਂ ਕਰਕੇ ਪੈਦਾ ਹੋਣ ਵਾਲੇ ਕਿਸੇ ਵੀ ਗਲਤਫ਼ਹਮੀਆਂ ਜਾਂ ਵਿਵਾਦਾਂ ਲਈ ਅਸੀਂ ਜਵਾਬਦੇਹ ਨਹੀਂ ਹਾਂ। + \ No newline at end of file diff --git a/translations/pa/02-SetupDevEnvironment/examples/basic-chat-azure/README.md b/translations/pa/02-SetupDevEnvironment/examples/basic-chat-azure/README.md index a89c4c69..416323ca 100644 --- a/translations/pa/02-SetupDevEnvironment/examples/basic-chat-azure/README.md +++ b/translations/pa/02-SetupDevEnvironment/examples/basic-chat-azure/README.md @@ -1,12 +1,3 @@ - # ਬੇਸਿਕ ਚੈਟ ਨਾਲ Azure OpenAI - ਐਂਡ-ਟੂ-ਐਂਡ ਉਦਾਹਰਨ ਇਹ ਉਦਾਹਰਨ ਦਿਖਾਉਂਦੀ ਹੈ ਕਿ ਕਿਵੇਂ ਇੱਕ ਸਧਾਰਨ ਸਪ੍ਰਿੰਗ ਬੂਟ ਐਪਲੀਕੇਸ਼ਨ ਬਣਾਈ ਜਾ ਸਕਦੀ ਹੈ ਜੋ Azure OpenAI ਨਾਲ ਜੁੜਦੀ ਹੈ ਅਤੇ ਤੁਹਾਡੇ ਸੈਟਅੱਪ ਦੀ ਜਾਂਚ ਕਰਦੀ ਹੈ। diff --git a/translations/pa/02-SetupDevEnvironment/getting-started-azure-openai.md b/translations/pa/02-SetupDevEnvironment/getting-started-azure-openai.md index 60389042..72fa290d 100644 --- a/translations/pa/02-SetupDevEnvironment/getting-started-azure-openai.md +++ b/translations/pa/02-SetupDevEnvironment/getting-started-azure-openai.md @@ -1,12 +1,3 @@ - # ਐਜ਼ਰ ਓਪਨਏਆਈ ਲਈ ਡਿਵੈਲਪਮੈਂਟ ਵਾਤਾਵਰਣ ਸੈਟਅੱਪ ਕਰਨਾ > **ਤੁਰੰਤ ਸ਼ੁਰੂਆਤ**: ਇਹ ਗਾਈਡ ਐਜ਼ਰ ਓਪਨਏਆਈ ਸੈਟਅੱਪ ਲਈ ਹੈ। ਮੁਫ਼ਤ ਮਾਡਲਾਂ ਨਾਲ ਤੁਰੰਤ ਸ਼ੁਰੂਆਤ ਲਈ, [GitHub ਮਾਡਲਜ਼ ਵਿਥ ਕੋਡਸਪੇਸਜ਼](./README.md#quick-start-cloud) ਵਰਤੋ। diff --git a/translations/pa/03-CoreGenerativeAITechniques/README.md b/translations/pa/03-CoreGenerativeAITechniques/README.md index 38c72ee4..5c913698 100644 --- a/translations/pa/03-CoreGenerativeAITechniques/README.md +++ b/translations/pa/03-CoreGenerativeAITechniques/README.md @@ -1,12 +1,3 @@ - # ਕੋਰ ਜਨਰੇਟਿਵ AI ਤਕਨੀਕਾਂ ਟਿਊਟੋਰਿਅਲ ## ਸੂਚੀ diff --git a/translations/pa/04-PracticalSamples/README.md b/translations/pa/04-PracticalSamples/README.md index 23f79790..f67cf2cc 100644 --- a/translations/pa/04-PracticalSamples/README.md +++ b/translations/pa/04-PracticalSamples/README.md @@ -1,12 +1,3 @@ - # ਪ੍ਰੈਕਟਿਕਲ ਐਪਲੀਕੇਸ਼ਨ ਅਤੇ ਪ੍ਰੋਜੈਕਟ ## ਤੁਸੀਂ ਕੀ ਸਿੱਖੋਗੇ diff --git a/translations/pa/04-PracticalSamples/calculator/README.md b/translations/pa/04-PracticalSamples/calculator/README.md index df7352bb..d35bb30e 100644 --- a/translations/pa/04-PracticalSamples/calculator/README.md +++ b/translations/pa/04-PracticalSamples/calculator/README.md @@ -1,12 +1,3 @@ - # MCP ਕੈਲਕੁਲੇਟਰ ਟਿਊਟੋਰਿਅਲ ਸ਼ੁਰੂਆਤੀ ਲਈ ## ਸੂਚੀ diff --git a/translations/pa/04-PracticalSamples/foundrylocal/README.md b/translations/pa/04-PracticalSamples/foundrylocal/README.md index 3003cf2c..46a71b53 100644 --- a/translations/pa/04-PracticalSamples/foundrylocal/README.md +++ b/translations/pa/04-PracticalSamples/foundrylocal/README.md @@ -1,12 +1,3 @@ - # Foundry Local Spring Boot ਟਿਊਟੋਰਿਅਲ ## ਸੂਚੀ diff --git a/translations/pa/04-PracticalSamples/petstory/README.md b/translations/pa/04-PracticalSamples/petstory/README.md index 6843a677..6b49253b 100644 --- a/translations/pa/04-PracticalSamples/petstory/README.md +++ b/translations/pa/04-PracticalSamples/petstory/README.md @@ -1,12 +1,3 @@ - # ਪਾਲਤੂ ਕਹਾਣੀ ਜਨਰੇਟਰ ਟਿਊਟੋਰਿਯਲ ਸ਼ੁਰੂਆਤੀਆਂ ਲਈ ## ਸੂਚੀ diff --git a/translations/pa/05-ResponsibleGenAI/README.md b/translations/pa/05-ResponsibleGenAI/README.md index 0ca41c5e..68d83fbb 100644 --- a/translations/pa/05-ResponsibleGenAI/README.md +++ b/translations/pa/05-ResponsibleGenAI/README.md @@ -1,12 +1,3 @@ - # ਜ਼ਿੰਮੇਵਾਰ ਜਨਰੇਟਿਵ AI ## ਤੁਸੀਂ ਕੀ ਸਿੱਖੋਗੇ diff --git a/translations/pa/AGENTS.md b/translations/pa/AGENTS.md index 5440df36..1a3ed4c6 100644 --- a/translations/pa/AGENTS.md +++ b/translations/pa/AGENTS.md @@ -1,12 +1,3 @@ - # AGENTS.md ## ਪ੍ਰੋਜੈਕਟ ਝਲਕ diff --git a/translations/pa/CODE_OF_CONDUCT.md b/translations/pa/CODE_OF_CONDUCT.md index cbafdef3..8b946129 100644 --- a/translations/pa/CODE_OF_CONDUCT.md +++ b/translations/pa/CODE_OF_CONDUCT.md @@ -1,12 +1,3 @@ - # ਮਾਈਕਰੋਸਾਫਟ ਖੁੱਲ੍ਹੇ ਸਰੋਤ ਦੇ ਆਚਰਣ ਕੋਡ ਇਸ ਪ੍ਰੋਜੈਕਟ ਨੇ [ਮਾਈਕਰੋਸਾਫਟ ਖੁੱਲ੍ਹੇ ਸਰੋਤ ਦੇ ਆਚਰਣ ਕੋਡ](https://opensource.microsoft.com/codeofconduct/) ਨੂੰ ਅਪਨਾਇਆ ਹੈ। diff --git a/translations/pa/README.md b/translations/pa/README.md index c3bce914..8e8cedf8 100644 --- a/translations/pa/README.md +++ b/translations/pa/README.md @@ -1,101 +1,93 @@ - -# ਸ਼ੁਰੂਆਤੀ ਲਈ ਜਨਰੇਟਿਵ ਏਆਈ - ਜਾਵਾ ਐਡੀਸ਼ਨ +# ਜਨੇਰੇਟਿਵ ਏਆਈ ਫਾਰ ਬਿਗਿਨਰਜ਼ - ਜਾਵਾ ਐਡੀਸ਼ਨ [![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) ![Generative AI for Beginners - Java Edition](../../translated_images/pa/beg-genai-series.8b48be9951cc574c.webp) -**ਸਮਾਂ ਸਮਰਪਣ**: ਸਾਰਾ ਵਰਕਸ਼ਾਪ ਆਨਲਾਈਨ ਬਿਨਾਂ ਕਿਸੇ ਲੋਕਲ ਸੈਟਅਪ ਦੇ ਮੁਕੰਮਲ ਕੀਤਾ ਜਾ ਸਕਦਾ ਹੈ। ਵਾਤਾਵਰਨ ਸੈਟਅਪ ਵਿੱਚ 2 ਮਿੰਟ ਲੱਗਦੇ ਹਨ, ਅਤੇ ਨਮੂਨੇ ਖੰਗਾਲਣ ਵਿੱਚ ਵਿਅਕਤੀਗਤ ਗਹਿਰਾਈ ਮੁਤਾਬਕ 1-3 ਘੰਟੇ ਲੱਗ ਸਕਦੇ ਹਨ। +**ਸਮਾਂ ਬੱਝਤ**: ਪੂਰਾ ਵਰਕਸ਼ਾਪ ਔਨਲਾਈਨ ਬਿਨਾਂ ਲੋਕਲ ਸੈਟਅਪ ਦੇ ਮੁਕੰਮਲ ਕੀਤਾ ਜਾ ਸਕਦਾ ਹੈ। ਪਰਿਵੇਸ਼ ਸੈਟਅਪ ਕਰਨ ਵਿੱਚ 2 ਮਿੰਟ ਲੱਗਦੇ ਹਨ, ਅਤੇ ਸੈਂਪਲ ਦੀ ਖੋਜ ਕਰਨ ਲਈ ਅਨੁਸੰਧਾਨ ਦੀ ਗਹਿਰਾਈ ਦੇ ਅਧਾਰ 'ਤੇ 1-3 ਘੰਟੇ ਲੱਗ ਸਕਦੇ ਹਨ। -> **ਤੇਜ਼ ਸ਼ੁਰੂਆਤ** +> **ਤੁਰੰਤ ਸ਼ੁਰੂਆਤ** -1. ਇਸ ਰਿਪੋਜ਼ਟਰੀ ਨੂੰ ਆਪਣੇ GitHub ਖਾਤੇ ਤੇ ਫੋਰਕ ਕਰੋ -2. **Code** → **Codespaces** ਟੈਬ → **...** → **New with options...** 'ਤੇ ਕਲਿਕ ਕਰੋ -3. ਡਿਫਾਲਟ ਦੀ ਵਰਤੋਂ ਕਰੋ – ਇਹ ਕੋਰਸ ਲਈ ਬਣਾਈ ਗਈ ਡਿਵੈਲਪਮੈਂਟ ਕੰਟੇਨਰ ਨੂੰ ਚੁਣੇਗਾ -4. **Create codespace** 'ਤੇ ਕਲਿਕ ਕਰੋ -5. ਵਾਤਾਵਰਨ ਦੀ ਤਿਆਰੀ ਲਈ ਲਗਭਗ 2 ਮਿੰਟ ਉਡੀਕ ਕਰੋ -6. ਸਿੱਧਾ [ਪਹਿਲਾ ਉਦਾਹਰਨ](./02-SetupDevEnvironment/README.md#step-2-create-a-github-personal-access-token) ਤੇ ਜਾਓ +1. ਇਸ ਰਿਪੋਜ਼ਟਰੀ ਨੂੰ ਆਪਣੇ GitHub ਅਕਾਉਂਟ 'ਤੇ ਫੋਰਕ ਕਰੋ +2. **Code** → **Codespaces** ਟੈਬ → **...** → **New with options...** 'ਤੇ ਕਲਿੱਕ ਕਰੋ +3. ਡੀਫੌਲਟ ਵਰਤੋਂ – ਇਹ ਕੋਰਸ ਲਈ ਬਣਾਈ ਗਈ ਵਿਕਾਸ ਕਂਟੇਨਰ ਸਿਲੈਕਟ ਕਰੇਗਾ +4. **Create codespace** 'ਤੇ ਕਲਿੱਕ ਕਰੋ +5. ਪਰਿਵੇਸ਼ ਤਿਆਰ ਹੋਣ ਲਈ ਲਗਭਗ 2 ਮਿੰਟ ਰੁਕੋ +6. ਸਿੱਧਾ [ਪਹਿਲਾ ਉਦਾਹਰਨ](./02-SetupDevEnvironment/README.md#step-2-create-a-github-personal-access-token) 'ਤੇ ਜਾਓ -> **ਸਥਾਨਕ ਕਲੋਨ ਕਰਨਾ ਪਸੰਦ ਕਰਦੇ ਹੋ?** +> **ਲੋਕਲ ਕਲੋਨ ਕਰਨਾ ਪਸੰਦ ਹੈ?** > -> ਇਹ ਰਿਪੋਜ਼ਟਰੀ 50+ ਭਾਸ਼ਾਈ ਅਨੁਵਾਦ ਸ਼ਾਮਲ ਕਰਦਾ ਹੈ ਜੋ ਡਾਉਨਲੋਡ ਸਾਈਜ਼ ਵਿੱਚ ਕਾਫੀ ਵਾਧਾ ਕਰਦਾ ਹੈ। ਬਿਨਾਂ ਅਨੁਵਾਦਾਂ ਦੇ ਕਲੋਨ ਕਰਨ ਲਈ, sparse checkout ਦੀ ਵਰਤੋਂ ਕਰੋ: +> ਇਸ ਰਿਪੋਜ਼ਟਰੀ ਵਿੱਚ 50+ ਭਾਸ਼ਾਈ ਅਨੁਵਾਦ ਸ਼ਾਮਲ ਹਨ ਜੋ ਡਾਊਨਲੋਡ ਸਾਈਜ਼ ਨੂੰ ਬਹੁਤ ਵਧਾ ਦਿੰਦੇ ਹਨ। ਅਨੁਵਾਦ ਬਿਨਾਂ ਕਲੋਨ ਕਰਨ ਲਈ sparse checkout ਵਰਤੋ: > ```bash > git clone --filter=blob:none --sparse https://github.com/microsoft/Generative-AI-for-beginners-java.git > cd Generative-AI-for-beginners-java > git sparse-checkout set --no-cone '/*' '!translations' '!translated_images' > ``` -> ਇਸ ਨਾਲ ਤੁਹਾਨੂੰ ਕੋਰਸ ਪੂਰਾ ਕਰਨ ਲਈ ਸਾਰਾ ਕੁਝ ਮਿਲੇਗਾ ਅਤੇ ਡਾਉਨਲੋਡ ਬਹੁਤ ਤੇਜ਼ ਹੋਵੇਗਾ। +> ਇਹ ਤੁਹਾਨੂੰ ਕੋਰਸ ਨੂੰ ਪੂਰਾ ਕਰਨ ਲਈ ਸਾਰਾ ਕੁਝ ਬਹੁਤ ਤੇਜ਼ ਡਾਊਨਲੋਡ ਦੇ ਨਾਲ ਦਿੰਦਾ ਹੈ। -## ਬਹੁ-ਭਾਸ਼ਾ ਸਹਾਇਤਾ -### GitHub Action ਰਾਹੀਂ ਸਹਾਇਤਿਤ (ਆਟੋਮੇਟਿਕ ਅਤੇ ਹਮੇਸ਼ਾਂ ਅੱਪ-ਟੂ-ਡੇਟ) +## ਬਹੁ-ਭਾਸ਼ੀ ਸਮਰਥਨ + +### GitHub ਐਕਸ਼ਨ ਰਾਹੀਂ ਸਮਰਥਿਤ (ਆਟੋਮੈਟਿਕ ਅਤੇ ਹਮੇਸ਼ਾਂ ਨਵੀਨਤਮ) -[ਅਰਬੀ](../ar/README.md) | [ਬੰਗਾਲੀ](../bn/README.md) | [ਬਲਗੇਰੀਆਈ](../bg/README.md) | [ਬੁਰਮੀ (ਮਿਆਨਮਾਰ)](../my/README.md) | [ਚੀਨੀ (ਸਰਲ)](../zh/README.md) | [ਚੀਨੀ (ਰਵਾਇਤੀ, ਹਾਂਗ ਕਾਂਗ)](../hk/README.md) | [ਚੀਨੀ (ਰਵਾਇਤੀ, ਮਕਾਉ)](../mo/README.md) | [ਚੀਨੀ (ਰਵਾਇਤੀ, ਤਾਈਵਾਨ)](../tw/README.md) | [ਕਰੋਏਸ਼ੀਆਈ](../hr/README.md) | [ਚੈਕ](../cs/README.md) | [ਡੈਨਿਸ਼](../da/README.md) | [ਡੱਚ](../nl/README.md) | [ਐਸਟੋਨੀਆਈ](../et/README.md) | [ਫਿਨਿਸ਼](../fi/README.md) | [ਫ੍ਰੈਂਚ](../fr/README.md) | [ਜਰਮਨ](../de/README.md) | [ਗ੍ਰੀਕ](../el/README.md) | [ਹਿਬ੍ਰੂ](../he/README.md) | [ਹਿੰਦੀ](../hi/README.md) | [ਹੰਗੇਰੀਆਈ](../hu/README.md) | [ਇੰਡੋਨੇਸ਼ੀਆਈ](../id/README.md) | [ਇਟਾਲੀਅਨ](../it/README.md) | [ਜਾਪਾਨੀ](../ja/README.md) | [ਕੰਨੜ](../kn/README.md) | [ਕੋਰੀਅਨ](../ko/README.md) | [ਲਿੱਥੂਆਨੀਆਈ](../lt/README.md) | [ਮਲਈ](../ms/README.md) | [ਮਲਯਾਲਮ](../ml/README.md) | [ਮਰਾਠੀ](../mr/README.md) | [ਨੇਪਾਲੀ](../ne/README.md) | [ਨਾਈਜੀਰੀਆਈ ਪਿੱਡਜਿਨ](../pcm/README.md) | [ਨਾਰਵੇਜੀਆਈ](../no/README.md) | [ਫ਼ਾਰਸੀ (ਪਰਸੀਆਈ)](../fa/README.md) | [ਪੋਲਿਸ਼](../pl/README.md) | [ਪੋਰਤੁਗਾਲੀ (ਬ੍ਰਾਜ਼ੀਲ)](../br/README.md) | [ਪੋਰਤੁਗਾਲੀ (ਪੋਰਚਗਾਲ)](../pt/README.md) | [ਪੰਜਾਬੀ (ਗੁਰਮੁਖੀ)](./README.md) | [ਰੋਮਾਨੀਆਈ](../ro/README.md) | [ਰੂਸੀ](../ru/README.md) | [ਸੇਰਬੀਆਈ (ਸਿਰਿਲਿਕ)](../sr/README.md) | [ਸਲੋਵਾਕ](../sk/README.md) | [ਸਲੋਵੇਨੀਆਈ](../sl/README.md) | [ਸਪੈਨਿਸ਼](../es/README.md) | [ਸਵਾਹਿਲੀ](../sw/README.md) | [ਸਵੀਡੀਸ਼](../sv/README.md) | [ਟਾਗਾਲੋਗ (ਫਿਲਿਪੀਨੀ)](../tl/README.md) | [ਤਮਿਲ](../ta/README.md) | [ਤੇਲਗੂ](../te/README.md) | [ਥਾਈ](../th/README.md) | [ਤੁਰਕੀ](../tr/README.md) | [ਯੂਕਰੇਨੀਅਨ](../uk/README.md) | [ਉਰਦੂ](../ur/README.md) | [ਵਿਯਤਨਾਮੀ](../vi/README.md) +[Arabic](../ar/README.md) | [Bengali](../bn/README.md) | [Bulgarian](../bg/README.md) | [Burmese (Myanmar)](../my/README.md) | [Chinese (Simplified)](../zh-CN/README.md) | [Chinese (Traditional, Hong Kong)](../zh-HK/README.md) | [Chinese (Traditional, Macau)](../zh-MO/README.md) | [Chinese (Traditional, Taiwan)](../zh-TW/README.md) | [Croatian](../hr/README.md) | [Czech](../cs/README.md) | [Danish](../da/README.md) | [Dutch](../nl/README.md) | [Estonian](../et/README.md) | [Finnish](../fi/README.md) | [French](../fr/README.md) | [German](../de/README.md) | [Greek](../el/README.md) | [Hebrew](../he/README.md) | [Hindi](../hi/README.md) | [Hungarian](../hu/README.md) | [Indonesian](../id/README.md) | [Italian](../it/README.md) | [Japanese](../ja/README.md) | [Kannada](../kn/README.md) | [Korean](../ko/README.md) | [Lithuanian](../lt/README.md) | [Malay](../ms/README.md) | [Malayalam](../ml/README.md) | [Marathi](../mr/README.md) | [Nepali](../ne/README.md) | [Nigerian Pidgin](../pcm/README.md) | [Norwegian](../no/README.md) | [Persian (Farsi)](../fa/README.md) | [Polish](../pl/README.md) | [Portuguese (Brazil)](../pt-BR/README.md) | [Portuguese (Portugal)](../pt-PT/README.md) | [Punjabi (Gurmukhi)](./README.md) | [Romanian](../ro/README.md) | [Russian](../ru/README.md) | [Serbian (Cyrillic)](../sr/README.md) | [Slovak](../sk/README.md) | [Slovenian](../sl/README.md) | [Spanish](../es/README.md) | [Swahili](../sw/README.md) | [Swedish](../sv/README.md) | [Tagalog (Filipino)](../tl/README.md) | [Tamil](../ta/README.md) | [Telugu](../te/README.md) | [Thai](../th/README.md) | [Turkish](../tr/README.md) | [Ukrainian](../uk/README.md) | [Urdu](../ur/README.md) | [Vietnamese](../vi/README.md) -> **ਸਥਾਨਕ ਕਲੋਨ ਕਰਨਾ ਪਸੰਦ ਕਰਦੇ ਹੋ?** +> **ਲੋਕਲ ਕਲੋਨ ਕਰਨਾ ਪਸੰਦ ਹੈ?** -> ਇਹ ਰਿਪੋਜ਼ਟਰੀ 50+ ਭਾਸ਼ਾਈ ਅਨੁਵਾਦ ਸ਼ਾਮਲ ਕਰਦਾ ਹੈ ਜੋ ਡਾਉਨਲੋਡ ਸਾਈਜ਼ ਵਿੱਚ ਕਾਫੀ ਵਾਧਾ ਕਰਦਾ ਹੈ। ਬਿਨਾਂ ਅਨੁਵਾਦਾਂ ਦੇ ਕਲੋਨ ਕਰਨ ਲਈ, sparse checkout ਦੀ ਵਰਤੋਂ ਕਰੋ: +> ਇਸ ਰਿਪੋਜ਼ਟਰੀ ਵਿੱਚ 50+ ਭਾਸ਼ਾਈ ਅਨੁਵਾਦ ਸ਼ਾਮਲ ਹਨ ਜੋ ਡਾਊਨਲੋਡ ਸਾਈਜ਼ ਨੂੰ ਬਹੁਤ ਵਧਾ ਦਿੰਦੇ ਹਨ। ਅਨੁਵਾਦ ਬਿਨਾਂ ਕਲੋਨ ਕਰਨ ਲਈ sparse checkout ਵਰਤੋ: > ```bash > git clone --filter=blob:none --sparse https://github.com/microsoft/Generative-AI-for-beginners-java.git > cd Generative-AI-for-beginners-java > git sparse-checkout set --no-cone '/*' '!translations' '!translated_images' > ``` -> ਇਸ ਨਾਲ ਤੁਹਾਨੂੰ ਕੋਰਸ ਪੂਰਾ ਕਰਨ ਲਈ ਸਾਰਾ ਕੁਝ ਮਿਲੇਗਾ ਅਤੇ ਡਾਉਨਲੋਡ ਬਹੁਤ ਤੇਜ਼ ਹੋਵੇਗਾ। +> ਇਹ ਤੁਹਾਨੂੰ ਕੋਰਸ ਨੂੰ ਪੂਰਾ ਕਰਨ ਲਈ ਸਾਰਾ ਕੁਝ ਬਹੁਤ ਤੇਜ਼ ਡਾਊਨਲੋਡ ਦੇ ਨਾਲ ਦਿੰਦਾ ਹੈ। -## ਕੋਰਸ ਸਤਰਾਂਚਨਾ ਅਤੇ ਸਿੱਖਣ ਦਾ ਰਾਸ਼ਤਾ +## ਕੋਰਸ ਢਾਂਚਾ ਅਤੇ ਸਿੱਖਣ ਦਾ ਰਸਤਾ -### **ਅਧਿਆਇ 1: ਜਨਰੇਟਿਵ ਏਆਈ ਦਾ ਪਰਿਚਯ** -- **ਮੁੱਖ ਧਾਰਣਾਵਾਂ**: ਵੱਡੇ ਭਾਸ਼ਾ ਮਾਡਲਾਂ, ਟੋਕਨ, ਐਮਬੈੱਡੀੰਗ, ਅਤੇ ਏਆਈ ਸਮਰੱਥਾਵਾਂ ਦੀ ਸਮਝ -- **ਜਾਵਾ ਏਆਈ ਪਰਿਸਰ**: Spring AI ਅਤੇ OpenAI SDKs ਦੀ ਸਮੀਖਿਆ +### **ਅਧਿਆਇ 1: ਜਨੇਰੇਟਿਵ ਏਆਈ ਨਾਲ ਜਾਣ-ਪਛਾਣ** +- **ਮੁੱਖ ਧਾਰਨਾਵਾਂ**: ਵੱਡੇ ਭਾਸ਼ਾਈ ਮਾਡਲਜ਼, ਟੋਕਨ, ਐਮਬੈੱਡਿੰਗਜ਼ ਅਤੇ ਏਆਈ ਯੋਗਤਾਵਾਂ ਦੀ ਸਮਝ +- **ਜਾਵਾ ਏਆਈ ਪ੍ਰਣਾਲੀ**: Spring AI ਅਤੇ OpenAI SDKs ਦਾ ਜਾਇਜ਼ਾ - **ਮਾਡਲ ਕਾਂਟੈਕਸਟ ਪ੍ਰੋਟੋਕੋਲ**: MCP ਦਾ ਪਰਿਚਯ ਅਤੇ ਏਆਈ ਏਜੰਟ ਸੰਚਾਰ ਵਿੱਚ ਇਸ ਦੀ ਭੂਮਿਕਾ -- **ਅਮਲਾਤਮਕ ਅਰਜ਼ੀ**: ਚੈਟਬੋਟ ਅਤੇ ਸਮੱਗਰੀ ਸਿਰਜਣਾ ਸਮੇਤ ਅਸਲੀ ਦੁਨੀਆ ਦੇ ਸਿਨਾਰਿਓ +- **ਵਿਆਵਹਾਰਕ ਪ੍ਰਭਾਵ**: ਰੀਅਲ-ਵਰਲਡ ਸਥਿਤੀਆਂ ਜਿਵੇਂ ਚੈਟਬੋਟ ਅਤੇ ਸਮੱਗਰੀ ਸਿਰਜਣਾ - **[→ ਅਧਿਆਇ 1 ਸ਼ੁਰੂ ਕਰੋ](./01-IntroToGenAI/README.md)** -### **ਅਧਿਆਇ 2: ਵਿਕਾਸ ਵਾਤਾਵਰਨ ਸੈਟਅਪ** -- **ਮੁਲਟੀ ਪ੍ਰੋਵਾਇਡਰ ਕਨਫ਼ਿਗਰੇਸ਼ਨ**: GitHub Models, Azure OpenAI, ਅਤੇ OpenAI ਜਾਵਾ SDK ਇੰਟੀਗ੍ਰੇਸ਼ਨ ਸੈਟਅਪ ਕਰੋ -- **Spring Boot + Spring AI**: ਐਨਟਰਪ੍ਰਾਈਜ਼ ਏਆਈ ਐਪਲੀਕੇਸ਼ਨ ਵਿਕਾਸ ਲਈ ਵਧੀਆ ਤਰੀਕੇ -- **GitHub Models**: ਪ੍ਰੋਟੋਟਾਈਪਿੰਗ ਅਤੇ ਸਿੱਖਣ ਲਈ ਮੁਫ਼ਤ ਏਆਈ ਮਾਡਲ ਐਕਸੈਸ (ਕੋਈ ਕਰੈਡਿਟ ਕਾਰਡ ਲੋੜ ਨਹੀਂ) -- **ਵਿਕਾਸ ਸੰਦ**: Docker ਕੰਟੇਨਰ, VS Code, ਅਤੇ GitHub Codespaces ਕਨਫ਼ਿਗਰੇਸ਼ਨ +### **ਅਧਿਆਇ 2: ਵਿਕਾਸ ਪਰਿਵੇਸ਼ ਸੈਟਅਪ** +- **ਮਲਟੀ-ਪ੍ਰੋਵਾਈਡਰ ਕੰਫਿਗੁਰੇਸ਼ਨ**: GitHub ਮਾਡਲਜ਼, Azure OpenAI ਅਤੇ OpenAI ਜਾਵਾ SDK ਇੰਟੇਗ੍ਰੇਸ਼ਨ ਸੈਟਅਪ ਕਰੋ +- **Spring Boot + Spring AI**: ਐਂਟਰਪ੍ਰਾਈਜ਼ ਏਆਈ ਐਪਲੀਕੇਸ਼ਨ ਵਿਕਾਸ ਲਈ ਵਧੀਆ ਅਭਿਆਸ +- **GitHub ਮਾਡਲਜ਼**: ਪ੍ਰੋਟੋਟਾਈਪਿੰਗ ਅਤੇ ਸਿੱਖਣ ਲਈ ਮੁਫ਼ਤ ਏਆਈ ਮਾਡਲ ਐਕਸੈਸ (ਕੋਈ ਕਰੈਡਿਟ ਕਾਰਡ ਜ਼ਰੂਰੀ ਨਹੀਂ) +- **ਵਿਕਾਸ ਸਾਧਨ**: ਡਾਕਰ ਕੰਟੇਨਰ, VS ਕੋਡ ਅਤੇ GitHub ਕੋਡਸਪੇਸ ਕੰਫਿਗੁਰੇਸ਼ਨ - **[→ ਅਧਿਆਇ 2 ਸ਼ੁਰੂ ਕਰੋ](./02-SetupDevEnvironment/README.md)** -### **ਅਧਿਆਇ 3: ਮੁੱਖ ਜਨਰੇਟਿਵ ਏਆਈ ਤਕਨੀਕਾਂ** -- **ਪ੍ਰੋਮਪਟ ਇੰਜੀਨੀਅਰਿੰਗ**: ਉੱਤਮ ਏਆਈ ਮਾਡਲ ਜਵਾਬ ਲਈ ਤਕਨੀਕਾਂ -- **ਐਮਬੈੱਡੀੰਗ ਅਤੇ ਵੇਕਟਰ ਓਪਰੇਸ਼ਨ**: ਸੈਮੈਂਟਿਕ ਖੋਜ ਅਤੇ ਸਮਾਨਤਾ ਮੇਲ ਦੀ ਨਿਰਮਾਣ -- **ਰੀਟਰੀਵੱਲ-ਆਗਮੈਂਟਡ ਜਨਰੇਸ਼ਨ (RAG)**: ਆਪਣੀ ਡਾਟਾ ਸਰੋਤਾਂ ਨਾਲ ਏਆਈ ਨੂੰ ਜੋੜੋ -- **ਫੰਕਸ਼ਨ ਕਾਲਿੰਗ**: ਕਸਟਮ ਔਜ਼ਾਰ ਅਤੇ ਪਲੱਗਇਨਾਂ ਨਾਲ ਏਆਈ ਸਮਰੱਥਾਵਾਂ ਦਾ ਵਿਸ਼ਤਾਰ +### **ਅਧਿਆਇ 3: ਮੁੱਖ ਜਨੇਰੇਟਿਵ ਏਆਈ ਤਕਨੀਕਾਂ** +- **ਪ੍ਰਾਂਪਟ ਇੰਜੀਨੀਅਰਿੰਗ**: ਵਧੀਆ ਏਆਈ ਮਾਡਲ ਜਵਾਬ ਲਈ ਤਕਨੀਕਾਂ +- **ਐਮਬੈੱਡਿੰਗਜ਼ ਅਤੇ ਵੈਕਟਰ ਕਾਰਜ**: ਸੈਮਾਂਟਿਕ ਖੋਜ ਅਤੇ ਮਿਲਾਪ ਅਮਲ ਕਰੋ +- **ਰੀਟਰੀਵਲ-ਆਗਮੈਂਟਿਡ ਜਨੇਰੇਸ਼ਨ (RAG)**: ਆਪਣੇ ਡਾਟਾ ਸੋਰਸ ਨਾਲ ਏਆਈ ਨੂੰ ਜੋੜੋ +- **ਫੰਕਸ਼ਨ ਕਾਲਿੰਗ**: ਕਸਟਮ ਸਾਧਨਾਂ ਅਤੇ ਪਲੱਗਇਨਜ਼ ਨਾਲ ਏਆਈ ਯੋਗਤਾਵਾਂ ਵਧਾਓ - **[→ ਅਧਿਆਇ 3 ਸ਼ੁਰੂ ਕਰੋ](./03-CoreGenerativeAITechniques/README.md)** -### **ਅਧਿਆਇ 4: ਅਮਲਾਤਮਕ ਅਰਜ਼ੀਆਂ ਅਤੇ ਪ੍ਰੋਜੈਕਟ** -- **ਪਾਲਤੂ ਕਹਾਣੀ ਸਿਰਜਣਹਾਰ** (`petstory/`): GitHub Models ਨਾਲ ਰਚਨਾਤਮਕ ਸਮੱਗਰੀ ਸਿਰਜਣਾ -- **Foundry Local ਡੈਮੋ** (`foundrylocal/`): OpenAI ਜਾਵਾ SDK ਨਾਲ ਸਥਾਨਕ ਏਆਈ ਮਾਡਲ ਇੰਟੀਗ੍ਰੇਸ਼ਨ -- **MCP ਕੈਲਕੂਲੇਟਰ ਸੇਵਾ** (`calculator/`): Spring AI ਨਾਲ ਬੁਨਿਆਦੀ ਮਾਡਲ ਕਾਂਟੈਕਸਟ ਪ੍ਰੋਟੋਕੋਲ ਲਾਗੂ +### **ਅਧਿਆਇ 4: ਵਿਆਵਹਾਰਕ ਅਰਜ਼ੀਆਂ ਅਤੇ ਪ੍ਰੋਜੈਕਟ** +- **ਪੈਟ ਸਟੋਰੀ ਜਨੇਰੇਟਰ** (`petstory/`): GitHub ਮਾਡਲਜ਼ ਨਾਲ ਰਚਨਾਤਮਕ ਸਮੱਗਰੀ ਜਨੇਰੇਸ਼ਨ +- **ਫਾਊਂਡਰੀ ਲੋਕਲ ਡੈਮੋ** (`foundrylocal/`): OpenAI ਜਾਵਾ SDK ਨਾਲ ਲੋਕਲ ਏਆਈ ਮਾਡਲ ਇੰਟੇਗਰੇਸ਼ਨ +- **MCP ਕੈלקੂਲੇਟਰ ਸਰਵਿਸ** (`calculator/`): Spring AI ਨਾਲ ਮਾਡਲ ਕਾਂਟੈਕਸਟ ਪ੍ਰੋਟੋਕੋਲ ਦੀ ਬੁਨਿਆਦੀ ਲਾਗੂਆਇੀ - **[→ ਅਧਿਆਇ 4 ਸ਼ੁਰੂ ਕਰੋ](./04-PracticalSamples/README.md)** -### **ਅਧਿਆਇ 5: ਜ਼ਿੰਮੇਵਾਰ ਏਆਈ ਵਿਕਾਸ** -- **GitHub Models ਸੁਰੱਖਿਆ**: ਬਣੇ-ਬਣਾਏ ਸਮੱਗਰੀ ਛਾਂਟਣ ਅਤੇ ਸੁਰੱਖਿਆ ਤੰਤਰਾਂ ਦਾ ਟੈਸਟ (ਕਠੋਰ ਰੋਕ ਅਤੇ ਨਰਮ ਇਨਕਾਰ) -- **ਜ਼ਿੰਮੇਵਾਰ ਏਆਈ ਡੈਮੋ**: ਤਤਕਾਲ ਉਦਾਹਰਨ ਜੋ ਦਿਖਾਉਂਦੀ ਹੈ ਕਿ ਆਧੁਨਿਕ ਏਆਈ ਸੁਰੱਖਿਆ ਪ੍ਰਣਾਲੀਆਂ ਕਿਵੇਂ ਕੰਮ ਕਰਦੀਆਂ ਹਨ -- **ਸਰੋਤ ਸੰਭਾਲ**: ਨੈਤਿਕ ਏਆਈ ਵਿਕਾਸ ਅਤੇ ਤਾਇਨਾਤੀ ਲਈ ਜ਼ਰੂਰੀ ਗਾਈਡਲਾਈਨਜ਼ +### **ਅਧਿਆਇ 5: ਜਵਾਬਦੇਹ ਏਆਈ ਵਿਕਾਸ** +- **GitHub ਮਾਡਲਜ਼ ਸੁਰੱਖਿਆ**: ਬਿਲਟ-ਇਨ ਸਮੱਗਰੀ ਫਿਲਟਰੀਂਗ ਅਤੇ ਸੁਰੱਖਿਆ ਪ੍ਰਣਾਲੀਆਂ ਦਾ ਟੈਸਟ (ਹਾਰਡ ਬਲਾਕ ਅਤੇ ਨਰਮ ਇਨਕਾਰ) +- **ਜਵਾਬਦੇਹ ਏਆਈ ਡੈਮੋ**: ਹੱਥੋਂ-ਹੱਥ ਉਦਾਹਰਨ ਜਿਹੜੀ ਦਿਖਾਉਂਦੀ ਹੈ ਕਿ ਕਿਵੇਂ ਆਧੁਨਿਕ ਏਆਈ ਸੁਰੱਖਿਆ ਪ੍ਰਣਾਲੀਆਂ ਕੰਮ ਕਰਦੀਆਂ ਹਨ +- **ਵਧੀਆ ਅਭਿਆਸ**: ਨੈਤਿਕ ਏਆਈ ਵਿਕਾਸ ਅਤੇ ਤਿਆਰ ਕਰਨ ਲਈ ਮੂਲ ਨਿਯਮ - **[→ ਅਧਿਆਇ 5 ਸ਼ੁਰੂ ਕਰੋ](./05-ResponsibleGenAI/README.md)** -## ਵਾਧੂ ਸਰੋਤ +## ਹੋਰ ਸਰੋਤ -### ਲੈੰਗਚੇਨ +### LangChain [![LangChain4j for Beginners](https://img.shields.io/badge/LangChain4j%20for%20Beginners-22C55E?style=for-the-badge&&labelColor=E5E7EB&color=0553D6)](https://aka.ms/langchain4j-for-beginners) [![LangChain.js for Beginners](https://img.shields.io/badge/LangChain.js%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=0553D6)](https://aka.ms/langchainjs-for-beginners?WT.mc_id=m365-94501-dwahlin) --- -### ਐਜ਼ੂਰ / ਐਜ / MCP / ਏਜੰਟ +### Azure / Edge / MCP / Agents [![AZD for Beginners](https://img.shields.io/badge/AZD%20for%20Beginners-0078D4?style=for-the-badge&labelColor=E5E7EB&color=0078D4)](https://github.com/microsoft/AZD-for-beginners?WT.mc_id=academic-105485-koreyst) [![Edge AI for Beginners](https://img.shields.io/badge/Edge%20AI%20for%20Beginners-00B8E4?style=for-the-badge&labelColor=E5E7EB&color=00B8E4)](https://github.com/microsoft/edgeai-for-beginners?WT.mc_id=academic-105485-koreyst) [![MCP for Beginners](https://img.shields.io/badge/MCP%20for%20Beginners-009688?style=for-the-badge&labelColor=E5E7EB&color=009688)](https://github.com/microsoft/mcp-for-beginners?WT.mc_id=academic-105485-koreyst) @@ -103,7 +95,7 @@ CO_OP_TRANSLATOR_METADATA: --- -### ਜਨਰੇਟਿਵ ਏਆਈ ਸੀਰੀਜ਼ +### ਜਨੇਰੇਟਿਵ ਏਆਈ ਸੀਰੀਜ਼ [![Generative AI for Beginners](https://img.shields.io/badge/Generative%20AI%20for%20Beginners-8B5CF6?style=for-the-badge&labelColor=E5E7EB&color=8B5CF6)](https://github.com/microsoft/generative-ai-for-beginners?WT.mc_id=academic-105485-koreyst) [![Generative AI (.NET)](https://img.shields.io/badge/Generative%20AI%20(.NET)-9333EA?style=for-the-badge&labelColor=E5E7EB&color=9333EA)](https://github.com/microsoft/Generative-AI-for-beginners-dotnet?WT.mc_id=academic-105485-koreyst) [![Generative AI (Java)](https://img.shields.io/badge/Generative%20AI%20(Java)-C084FC?style=for-the-badge&labelColor=E5E7EB&color=C084FC)](https://github.com/microsoft/generative-ai-for-beginners-java?WT.mc_id=academic-105485-koreyst) @@ -111,18 +103,19 @@ CO_OP_TRANSLATOR_METADATA: --- -### ਮੁੱਖ ਸਿੱਖਿਆ +### ਕੋਰ ਸਿੱਖਿਆ [![ML for Beginners](https://img.shields.io/badge/ML%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=22C55E)](https://aka.ms/ml-beginners?WT.mc_id=academic-105485-koreyst) [![Data Science for Beginners](https://img.shields.io/badge/Data%20Science%20for%20Beginners-84CC16?style=for-the-badge&labelColor=E5E7EB&color=84CC16)](https://aka.ms/datascience-beginners?WT.mc_id=academic-105485-koreyst) [![AI for Beginners](https://img.shields.io/badge/AI%20for%20Beginners-A3E635?style=for-the-badge&labelColor=E5E7EB&color=A3E635)](https://aka.ms/ai-beginners?WT.mc_id=academic-105485-koreyst) [![Cybersecurity for Beginners](https://img.shields.io/badge/Cybersecurity%20for%20Beginners-F97316?style=for-the-badge&labelColor=E5E7EB&color=F97316)](https://github.com/microsoft/Security-101?WT.mc_id=academic-96948-sayoung) + [![Web Dev for Beginners](https://img.shields.io/badge/Web%20Dev%20for%20Beginners-EC4899?style=for-the-badge&labelColor=E5E7EB&color=EC4899)](https://aka.ms/webdev-beginners?WT.mc_id=academic-105485-koreyst) [![IoT for Beginners](https://img.shields.io/badge/IoT%20for%20Beginners-14B8A6?style=for-the-badge&labelColor=E5E7EB&color=14B8A6)](https://aka.ms/iot-beginners?WT.mc_id=academic-105485-koreyst) [![XR Development for Beginners](https://img.shields.io/badge/XR%20Development%20for%20Beginners-38BDF8?style=for-the-badge&labelColor=E5E7EB&color=38BDF8)](https://github.com/microsoft/xr-development-for-beginners?WT.mc_id=academic-105485-koreyst) --- -### ਕੌਪਾਇਲਟ ਸੀਰੀਜ਼ +### ਕੋਪਾਇਲਟ ਸੀਰੀਜ਼ [![Copilot for AI Paired Programming](https://img.shields.io/badge/Copilot%20for%20AI%20Paired%20Programming-FACC15?style=for-the-badge&labelColor=E5E7EB&color=FACC15)](https://aka.ms/GitHubCopilotAI?WT.mc_id=academic-105485-koreyst) [![Copilot for C#/.NET](https://img.shields.io/badge/Copilot%20for%20C%23/.NET-FBBF24?style=for-the-badge&labelColor=E5E7EB&color=FBBF24)](https://github.com/microsoft/mastering-github-copilot-for-dotnet-csharp-developers?WT.mc_id=academic-105485-koreyst) [![Copilot Adventure](https://img.shields.io/badge/Copilot%20Adventure-FDE68A?style=for-the-badge&labelColor=E5E7EB&color=FDE68A)](https://github.com/microsoft/CopilotAdventures?WT.mc_id=academic-105485-koreyst) @@ -130,17 +123,17 @@ CO_OP_TRANSLATOR_METADATA: ## ਸਹਾਇਤਾ ਪ੍ਰਾਪਤ ਕਰਨਾ -ਜੇ ਤੁਸੀਂ ਫਸ ਜਾਂਦੇ ਹੋ ਜਾਂ AI ਐਪ ਬਣਾਉਣ ਬਾਰੇ ਕੋਈ ਵੀ ਸਵਾਲ ਹੋਵੇ। MCP ਬਾਰੇ ਚਰਚਾ ਵਿੱਚ ਸਹਿਆੋਗੀ ਸਿੱਖਣ ਵਾਲਿਆਂ ਅਤੇ ਅਨੁਭਵੀ ਵਿਕਾਸਕਾਰਾਂ ਦੇ ਨਾਲ ਜੁੜੋ। ਇਹ ਇੱਕ ਸਹਾਇਕ ਕਮਿਊਨਿਟੀ ਹੈ ਜਿਥੇ ਸਵਾਲ ਸੁਆਗਤਯੋਗ ਹਨ ਅਤੇ ਗਿਆਨ ਖੁੱਲ੍ਹਾ ਸਾਂਝਾ ਕੀਤਾ ਜਾਂਦਾ ਹੈ। +ਜੇ ਤੁਸੀਂ ਫਸ ਜਾਂਦੇ ਹੋ ਜਾਂ AI ਐਪਸ ਬਣਾਉਣ ਬਾਰੇ ਕਿਸੇ ਵੀ ਪ੍ਰਸ਼ਨ ਹਨ। ਸਾਥੀ ਸਿੱਖਿਆਰਥੀਆਂ ਅਤੇ ਅਨੁਭਵੀ ਡਿਵੈਲਪਰਾਂ ਨਾਲ MCP ਬਾਰੇ ਗੱਲਬਾਤ ਵਿੱਚ ਸ਼ਾਮਿਲ ਹੋਵੋ। ਇਹ ਇੱਕ ਮੇਹਰਬਾਨ ਕਮਿਊਨਿਟੀ ਹੈ ਜਿੱਥੇ ਪ੍ਰਸ਼ਨਾਂ ਦਾ ਸਵਾਗਤ ਕੀਤਾ ਜਾਂਦਾ ਹੈ ਅਤੇ ਗਿਆਨ ਖੁੱਲ੍ਹੇ ਤੌਰ ਤੇ ਸਾਂਝਾ ਕੀਤਾ ਜਾਂਦਾ ਹੈ। [![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) -ਜੇ ਤੁਹਾਡੇ ਕੋਲ ਉਤਪਾਦ ਫੀਡਬੈਕ ਜਾਂ ਗਲਤੀਆਂ ਹਨ ਜੋ ਬਣਾਉਣ ਸਮੇਂ ਆਈਆਂ ਹਨ ਤਾਂ ਦੌਰਾ ਕਰੋ: +ਜੇ ਤੁਹਾਡੇ ਕੋਲ ਪ੍ਰੋਡਕਟ ਫੀਡਬੈਕ ਹੈ ਜਾਂ ਬਣਾਉਂਦੇ ਸਮੇਂ ਕੋਈ ਗਲਤੀਆਂ ਹਨ ਤਾਂ ਦਰਜ ਕਰੋ: [![Microsoft Foundry Developer Forum](https://img.shields.io/badge/GitHub-Microsoft_Foundry_Developer_Forum-blue?style=for-the-badge&logo=github&color=000000&logoColor=fff)](https://aka.ms/foundry/forum) --- -**ਅਸਪੱਸ਼ਟੀਕਰਨ**: -ਇਹ ਦਸਤਾਵੇਜ਼ AI ਅਨੁਵਾਦ ਸੇਵਾ [Co-op Translator](https://github.com/Azure/co-op-translator) ਦੀ ਵਰਤੋਂ ਕਰਕੇ ਅਨੁਵਾਦ ਕੀਤਾ ਗਿਆ ਹੈ। ਜਦੋਂ ਕਿ ਅਸੀਂ ਸਹੀਅਤ ਲਈ ਕੋਸ਼ਿਸ਼ ਕਰਦੇ ਹਾਂ, ਕਿਰਪਾ ਕਰਕੇ ਜਾਣੋ ਕਿ ਸਵੈਚਲਿਤ ਅਨੁਵਾਦਾਂ ਵਿੱਚ ਗਲਤੀਆਂ ਜਾਂ ਅਣਸਹੀਤੀਆਂ ਹੋ ਸਕਦੀਆਂ ਹਨ। ਮੂਲ ਦਸਤਾਵੇਜ਼ ਆਪਣੀ ਮੂਲ ਭਾਸ਼ਾ ਵਿੱਚ ਪ੍ਰਮਾਣਿਤ ਸਰੋਤ ਮੰਨਿਆ ਜਾਣਾ ਚਾਹੀਦਾ ਹੈ। ਜਰੂਰੀ ਜਾਣਕਾਰੀ ਲਈ, ਵਿਸ਼ੇਸ਼ਗਿਆਨ ਵਾਲੇ ਮਨੁੱਖੀ ਅਨੁਵਾਦ ਦੀ ਸਿਫ਼ਾਰਸ਼ ਕੀਤੀ ਜਾਂਦੀ ਹੈ। ਇਸ ਅਨੁਵਾਦ ਦੇ ਉਪਯੋਗ ਨਾਲ ਉੱਪਜਣ ਵਾਲੀਆਂ ਕਿਸੇ ਵੀ ਗਲਤਫਹਿਮੀਆਂ ਜਾਂ ਗਲਤ ਵਿਆਖਿਆਵਾਂ ਲਈ ਅਸੀਂ ਜ਼ਿੰਮੇਵਾਰ ਨਹੀਂ ਹਾਂ। +**ਅਸਵੀਕਾਰੋਪਤਰ**: +ਇਹ ਦਸਤਾਵੇਜ਼ AI ਅਨੁਵਾਦ ਸੇਵਾ [Co-op Translator](https://github.com/Azure/co-op-translator) ਦੀ ਵਰਤੋਂ ਕਰਕੇ ਅਨੁਵਾਦ ਕੀਤਾ ਗਿਆ ਹੈ। ਜਦੋਂ ਕਿ ਅਸੀਂ ਸ਼ੁੱਧਤਾ ਲਈ ਕੋਸ਼ਿਸ਼ ਕਰਦੇ ਹਾਂ, ਕਿਰਪਾ ਕਰਕੇ ਧਿਆਨ ਵਿੱਚ ਰੱਖੋ ਕਿ ਸਵੈਚਾਲਿਤ ਅਨੁਵਾਦਾਂ ਵਿੱਚ ਗਲਤੀਆਂ ਜਾਂ ਭੁੱਲਾਂ ਹੋ ਸਕਦੀਆਂ ਹਨ। ਮੂਲ ਦਸਤਾਵੇਜ਼ ਜਿਸ ਭਾਸ਼ਾ ਵਿੱਚ ਹੈ, ਉਸਨੂੰ ਪ੍ਰਮਾਣਿਕ ਸਰੋਤ ਮੰਨਿਆ ਜਾਣਾ ਚਾਹੀਦਾ ਹੈ। ਜਰੂਰੀ ਜਾਣਕਾਰੀ ਲਈ, ਪ੍ਰੋਫੈਸ਼ਨਲ ਮਨੁੱਖੀ ਅਨੁਵਾਦ ਦੀ ਸਿਫਾਰਸ਼ ਕੀਤੀ ਜਾਂਦੀ ਹੈ। ਇਸ ਅਨੁਵਾਦ ਦੇ ਇਸਤੇਮਾਲ ਨਾਲ ਹੋਣ ਵਾਲੀਆਂ ਕਿਸੇ ਵੀ ਗਲਤਫਹਮੀਆਂ ਜਾਂ ਭੂਲਾਂ ਲਈ ਅਸੀਂ ਜਵਾਬਦੇਹ ਨਹੀਂ ਹਾਂ। \ No newline at end of file diff --git a/translations/pa/SECURITY.md b/translations/pa/SECURITY.md index d9213ab0..7275d357 100644 --- a/translations/pa/SECURITY.md +++ b/translations/pa/SECURITY.md @@ -1,12 +1,3 @@ - ## ਸੁਰੱਖਿਆ ਮਾਈਕਰੋਸਾਫਟ ਆਪਣੇ ਸੌਫਟਵੇਅਰ ਉਤਪਾਦਾਂ ਅਤੇ ਸੇਵਾਵਾਂ ਦੀ ਸੁਰੱਖਿਆ ਨੂੰ ਗੰਭੀਰਤਾ ਨਾਲ ਲੈਂਦਾ ਹੈ, ਜਿਸ ਵਿੱਚ ਸਾਰੇ ਸਰੋਤ ਕੋਡ ਰਿਪੋਜ਼ਿਟਰੀਜ਼ ਸ਼ਾਮਲ ਹਨ ਜੋ ਸਾਡੇ GitHub ਸੰਸਥਾਵਾਂ ਦੁਆਰਾ ਪ੍ਰਬੰਧਿਤ ਕੀਤੇ ਜਾਂਦੇ ਹਨ, ਜਿਵੇਂ ਕਿ [Microsoft](https://github.com/Microsoft), [Azure](https://github.com/Azure), [DotNet](https://github.com/dotnet), [AspNet](https://github.com/aspnet) ਅਤੇ [Xamarin](https://github.com/xamarin)। diff --git a/translations/pa/SUPPORT.md b/translations/pa/SUPPORT.md index 2a3b410b..c60d634d 100644 --- a/translations/pa/SUPPORT.md +++ b/translations/pa/SUPPORT.md @@ -1,12 +1,3 @@ - # ਸਹਾਇਤਾ ## ਸਮੱਸਿਆਵਾਂ ਦਰਜ ਕਰਨਾ ਅਤੇ ਮਦਦ ਪ੍ਰਾਪਤ ਕਰਨੀ diff --git a/translations/pcm/.co-op-translator.json b/translations/pcm/.co-op-translator.json new file mode 100644 index 00000000..7f0dd186 --- /dev/null +++ b/translations/pcm/.co-op-translator.json @@ -0,0 +1,92 @@ +{ + "01-IntroToGenAI/README.md": { + "original_hash": "75bfb080ca725e8a9aa9c80cae25fba1", + "translation_date": "2025-11-18T18:01:53+00:00", + "source_file": "01-IntroToGenAI/README.md", + "language_code": "pcm" + }, + "02-SetupDevEnvironment/README.md": { + "original_hash": "96a30d42b9751a3d4e4b20e28d29d459", + "translation_date": "2026-01-28T05:35:47+00:00", + "source_file": "02-SetupDevEnvironment/README.md", + "language_code": "pcm" + }, + "02-SetupDevEnvironment/examples/basic-chat-azure/README.md": { + "original_hash": "efd82efe50711d7e257eb943151d682c", + "translation_date": "2025-11-18T17:59:50+00:00", + "source_file": "02-SetupDevEnvironment/examples/basic-chat-azure/README.md", + "language_code": "pcm" + }, + "02-SetupDevEnvironment/getting-started-azure-openai.md": { + "original_hash": "bfdb4b4eadbee3a59ef742439f58326a", + "translation_date": "2025-11-18T17:58:06+00:00", + "source_file": "02-SetupDevEnvironment/getting-started-azure-openai.md", + "language_code": "pcm" + }, + "03-CoreGenerativeAITechniques/README.md": { + "original_hash": "685f55cb07de19b52a30ce6e8b6d889e", + "translation_date": "2025-11-18T18:00:40+00:00", + "source_file": "03-CoreGenerativeAITechniques/README.md", + "language_code": "pcm" + }, + "04-PracticalSamples/README.md": { + "original_hash": "14c0a61ecc1cd2012a9c129236dfdf71", + "translation_date": "2025-11-18T17:54:23+00:00", + "source_file": "04-PracticalSamples/README.md", + "language_code": "pcm" + }, + "04-PracticalSamples/calculator/README.md": { + "original_hash": "b6c16b5514d524e415a94f6097ee7d4c", + "translation_date": "2025-11-18T17:54:57+00:00", + "source_file": "04-PracticalSamples/calculator/README.md", + "language_code": "pcm" + }, + "04-PracticalSamples/foundrylocal/README.md": { + "original_hash": "f787307400de59adc25a1404466a35f3", + "translation_date": "2025-11-18T17:55:53+00:00", + "source_file": "04-PracticalSamples/foundrylocal/README.md", + "language_code": "pcm" + }, + "04-PracticalSamples/petstory/README.md": { + "original_hash": "0cbf68d605615a1e602c832a24616859", + "translation_date": "2025-11-18T17:56:46+00:00", + "source_file": "04-PracticalSamples/petstory/README.md", + "language_code": "pcm" + }, + "05-ResponsibleGenAI/README.md": { + "original_hash": "301c05c2f57e60a6950b8c665b8bdbba", + "translation_date": "2025-11-18T17:57:48+00:00", + "source_file": "05-ResponsibleGenAI/README.md", + "language_code": "pcm" + }, + "AGENTS.md": { + "original_hash": "afc90918d008cf77fd1982691f681306", + "translation_date": "2025-11-18T17:52:38+00:00", + "source_file": "AGENTS.md", + "language_code": "pcm" + }, + "CODE_OF_CONDUCT.md": { + "original_hash": "442b123d034f92f7c384d2bbd28f99f1", + "translation_date": "2025-11-18T17:53:43+00:00", + "source_file": "CODE_OF_CONDUCT.md", + "language_code": "pcm" + }, + "README.md": { + "original_hash": "125a08948d881c95628094f4dd1fbd43", + "translation_date": "2026-01-29T16:26:50+00:00", + "source_file": "README.md", + "language_code": "pcm" + }, + "SECURITY.md": { + "original_hash": "57f14126c1c6add76b3aef3844dfe4e3", + "translation_date": "2025-11-18T17:53:51+00:00", + "source_file": "SECURITY.md", + "language_code": "pcm" + }, + "SUPPORT.md": { + "original_hash": "b8ef73cc49dec68e2c885ee9df545129", + "translation_date": "2025-11-18T17:53:28+00:00", + "source_file": "SUPPORT.md", + "language_code": "pcm" + } +} \ No newline at end of file diff --git a/translations/pcm/01-IntroToGenAI/README.md b/translations/pcm/01-IntroToGenAI/README.md index f14f7e8a..dfef2f4b 100644 --- a/translations/pcm/01-IntroToGenAI/README.md +++ b/translations/pcm/01-IntroToGenAI/README.md @@ -1,12 +1,3 @@ - # Introduction to Generative AI - Java Edition ## Wetin You Go Learn diff --git a/translations/pcm/02-SetupDevEnvironment/README.md b/translations/pcm/02-SetupDevEnvironment/README.md index bea33c92..0c88ceeb 100644 --- a/translations/pcm/02-SetupDevEnvironment/README.md +++ b/translations/pcm/02-SetupDevEnvironment/README.md @@ -1,22 +1,13 @@ - -# How to Set Up Development Environment for Generative AI for Java +# Setting Up the Development Environment for Generative AI for Java -> **Quick Start**: Code for cloud in 2 minutes - Go check [GitHub Codespaces Setup](../../../02-SetupDevEnvironment) - no need to install anything for your computer and e dey use github models! +> **Quick Start**: Code for Cloud for 2 minutes - Jump go [GitHub Codespaces Setup](../../../02-SetupDevEnvironment) - no need install for local and e dey use github models! -> **You wan try Azure OpenAI?**, check our [Azure OpenAI Setup Guide](getting-started-azure-openai.md) wey get steps to create new Azure OpenAI resource. +> **You dey interested for Azure OpenAI?**, see our [Azure OpenAI Setup Guide](getting-started-azure-openai.md) with steps to create new Azure OpenAI resource. ## Wetin You Go Learn -- How to set up Java development environment for AI apps -- Choose and configure the development environment wey you like (cloud-first with Codespaces, local dev container, or full local setup) +- How to set up Java development environment for AI applications +- How to select and arrange your preferred development environment (cloud-first with Codespaces, local dev container, or full local setup) - Test your setup by connecting to GitHub Models ## Table of Contents @@ -35,45 +26,45 @@ CO_OP_TRANSLATOR_METADATA: ## Introduction -This chapter go show you how to set up development environment. We go use **GitHub Models** as example because e dey free, easy to set up with just GitHub account, no need credit card, and e dey give access to plenty models wey you fit use test. +Dis chapter go guide you how to set up development environment. We go use **GitHub Models** be our main example because e dey free, e easy to set up with just GitHub account, no need credit card, and e dey give access to plenty models for testing. -**No need local setup!** You fit start to code straight away with GitHub Codespaces wey dey give full development environment inside your browser. +**No need set up anything for local!** You fit start to code sharp sharp using GitHub Codespaces, wey dey provide full development environment for your browser. -Screenshot: GitHub Models +Screenshot: GitHub Models -We dey recommend [**GitHub Models**](https://github.com/marketplace?type=models) for this course because e: +We recommend make you use [**GitHub Models**](https://github.com/marketplace?type=models) for dis course because e be: - **Free** to start - **Easy** to set up with just GitHub account - **No credit card** needed -- **Plenty models** dey available for testing +- **Plenty models** dey for testing -> **Note**: The GitHub Models wey we dey use for this training get these free limits: +> **Note**: The GitHub Models wey dem dey use for this training get dis free limits: > - 15 requests per minute (150 per day) -> - ~8,000 words in, ~4,000 words out per request -> - 5 concurrent requests +> - ~8,000 words input, ~4,000 words output per request +> - 5 requests fit run at the same time > -> For production use, upgrade to Azure AI Foundry Models with your Azure account. Your code no need change. Check the [Azure AI Foundry documentation](https://learn.microsoft.com/azure/ai-foundry/foundry-models/how-to/quickstart-github-models). +> For production use, upgrade to Azure AI Foundry Models with your Azure account. Your code no need change. See the [Azure AI Foundry documentation](https://learn.microsoft.com/azure/ai-foundry/foundry-models/how-to/quickstart-github-models). ## Step 1: Set Up Your Development Environment -We don create preconfigured development container to make setup easy and make sure you get all the tools wey you need for this Generative AI for Java course. Choose the development approach wey you like: +We don create preconfigured development container to make setup quick and make sure say you get all di tools you need for dis Generative AI for Java course. Choose di development method wey you like: ### Environment Setup Options: #### Option A: GitHub Codespaces (Recommended) -**Start to code in 2 minutes - no need local setup!** +**Start to code for 2 minutes - no need to install anything for local!** 1. Fork this repository go your GitHub account - > **Note**: If you wan edit the basic config, check the [Dev Container Configuration](../../../.devcontainer/devcontainer.json) + > **Note**: If you want edit basic config make you check the [Dev Container Configuration](../../../.devcontainer/devcontainer.json) 2. Click **Code** → **Codespaces** tab → **...** → **New with options...** -3. Use the defaults – this go select the **Dev container configuration**: **Generative AI Java Development Environment** custom devcontainer wey we create for this course +3. Use di defaults – e go pick di **Dev container configuration**: **Generative AI Java Development Environment** custom devcontainer wey dem create for dis course 4. Click **Create codespace** -5. Wait ~2 minutes make the environment ready -6. Go [Step 2: Create GitHub Token](../../../02-SetupDevEnvironment) +5. Wait about 2 minutes to make environment ready +6. Continue go [Step 2: Create GitHub Token](../../../02-SetupDevEnvironment) Screenshot: Codespaces submenu @@ -87,20 +78,20 @@ We don create preconfigured development container to make setup easy and make su > - E dey work for any device wey get browser > - Pre-configured with all tools and dependencies > - Free 60 hours per month for personal accounts -> - Consistent environment for all learners +> - Environment dey consistent for all learners #### Option B: Local Dev Container -**For developers wey prefer local development with Docker** +**For developers who like local development with Docker** 1. Fork and clone this repository go your local machine - > **Note**: If you wan edit the basic config, check the [Dev Container Configuration](../../../.devcontainer/devcontainer.json) + > **Note**: If you want edit basic config make you check the [Dev Container Configuration](../../../.devcontainer/devcontainer.json) 2. Install [Docker Desktop](https://www.docker.com/products/docker-desktop/) and [VS Code](https://code.visualstudio.com/) 3. Install the [Dev Containers extension](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers) for VS Code 4. Open the repository folder for VS Code -5. When e ask you, click **Reopen in Container** (or use `Ctrl+Shift+P` → "Dev Containers: Reopen in Container") -6. Wait make the container build and start -7. Go [Step 2: Create GitHub Token](../../../02-SetupDevEnvironment) +5. When prompt show, click **Reopen in Container** (or use `Ctrl+Shift+P` → "Dev Containers: Reopen in Container") +6. Wait make container build and start +7. Continue go [Step 2: Create GitHub Token](../../../02-SetupDevEnvironment) Screenshot: Dev container setup @@ -108,44 +99,44 @@ We don create preconfigured development container to make setup easy and make su #### Option C: Use Your Existing Local Installation -**For developers wey don already get Java environment** +**For developers wey get Java environment already** Prerequisites: - [Java 21+](https://www.oracle.com/java/technologies/javase/jdk21-archive-downloads.html) - [Maven 3.9+](https://maven.apache.org/download.cgi) -- [VS Code](https://code.visualstudio.com) or any IDE wey you like +- [VS Code](https://code.visualstudio.com) or your preferred IDE Steps: 1. Clone this repository go your local machine -2. Open the project for your IDE -3. Go [Step 2: Create GitHub Token](../../../02-SetupDevEnvironment) +2. Open di project for your IDE +3. Continue go [Step 2: Create GitHub Token](../../../02-SetupDevEnvironment) -> **Pro Tip**: If your machine no strong but you wan use VS Code locally, try GitHub Codespaces! You fit connect your local VS Code to cloud-hosted Codespace for better experience. +> **Pro Tip**: If your machine no strong well but you want VS Code for local, just use GitHub Codespaces! You fit connect your local VS Code to cloud-hosted Codespace to enjoy best of both worlds. Screenshot: created local devcontainer instance ## Step 2: Create a GitHub Personal Access Token -1. Go [GitHub Settings](https://github.com/settings/profile) and select **Settings** from your profile menu. -2. For the left sidebar, click **Developer settings** (e dey usually for bottom). -3. Under **Personal access tokens**, click **Fine-grained tokens** (or follow this direct [link](https://github.com/settings/personal-access-tokens)). +1. Go [GitHub Settings](https://github.com/settings/profile) then select **Settings** from your profile menu. +2. For the left side, click **Developer settings** (usually for bottom). +3. Under **Personal access tokens**, click **Fine-grained tokens** (or use this direct [link](https://github.com/settings/personal-access-tokens)). 4. Click **Generate new token**. -5. For "Token name", give am descriptive name (e.g., `GenAI-Java-Course-Token`). -6. Set expiration date (we recommend 7 days for security). -7. For "Resource owner", select your user account. -8. For "Repository access", select the repositories wey you wan use with GitHub Models (or "All repositories" if e dey necessary). -9. For "Account permissions", find **Models** and set am to **Read-only**. +5. Under "Token name", put name wey fit describe am (like `GenAI-Java-Course-Token`). +6. Set expiration date (recommended: 7 days to keep am secure). +7. Under "Resource owner", select your user account. +8. Under "Repository access", choose repositories wey you want use for GitHub Models (or choose "All repositories" if you want). +9. Under "Account permissions", find **Models** and set am to **Read-only**. 10. Click **Generate token**. -11. **Copy and save your token now** – you no go fit see am again! +11. **Copy and save your token now** – you no go see am again after! -> **Security Tip**: Use the minimum scope wey you need and shortest expiration time wey you fit use for your access tokens. +> **Security Tip**: Use smallest scope wey you need and shortest possible expiration time for your tokens. ## Step 3: Test Your Setup with the GitHub Models Example -Once your development environment don ready, make we test the GitHub Models integration with our example app wey dey [`02-SetupDevEnvironment/examples/github-models`](../../../02-SetupDevEnvironment/examples/github-models). +Once your development environment ready, make we test GitHub Models integration with our example app inside [`02-SetupDevEnvironment/examples/github-models`](../../../02-SetupDevEnvironment/examples/github-models). -1. Open the terminal for your development environment. +1. Open terminal inside your development environment. 2. Go the GitHub Models example: ```bash cd 02-SetupDevEnvironment/examples/github-models @@ -162,29 +153,29 @@ Once your development environment don ready, make we test the GitHub Models inte $env:GITHUB_TOKEN="your_token_here" ``` -4. Run the app: +4. Run the application: ```bash mvn compile exec:java -Dexec.mainClass="com.example.githubmodels.App" ``` -You go see output wey be like: +You go see output like this: ```text Using model: gpt-4.1-nano Sending request to GitHub Models... Response: Hello World! ``` -### Wetin the Example Code Mean +### Understanding the Example Code -First, make we understand wetin we just run. The example wey dey `examples/github-models` dey use OpenAI Java SDK to connect to GitHub Models: +First, make we understand wetin we run just now. The example inside `examples/github-models` dey use OpenAI Java SDK to connect with GitHub Models: -**Wetin this code dey do:** +**Wetindis code dey do:** - **Connect** to GitHub Models with your personal access token -- **Send** simple "Say Hello World!" message to the AI model -- **Receive** and show the AI response -- **Validate** say your setup dey work well +- **Send** simple "Say Hello World!" message to AI model +- **Receive** and show AI response +- **Confirm** say your setup dey work well -**Key Dependency** (for `pom.xml`): +**Main Dependency** (inside `pom.xml`): ```xml com.openai @@ -201,26 +192,26 @@ OpenAIClient client = OpenAIOkHttpClient.builder() .baseUrl("https://models.inference.ai.azure.com") .build(); -// Create chat completion request +// Make chat completion request ChatCompletionCreateParams params = ChatCompletionCreateParams.builder() .model(modelId) .addSystemMessage("You are a concise assistant.") .addUserMessage("Say Hello World!") .build(); -// Get AI response +// Collect AI response ChatCompletion response = client.chat().completions().create(params); System.out.println("Response: " + response.choices().get(0).message().content().orElse("No response content")); ``` ## Summary -Nice one! You don set everything up: +Great! You don set everything: -- Create GitHub Personal Access Token wey get correct permissions for AI model access -- Get your Java development environment ready (whether na Codespaces, dev containers, or local) -- Connect to GitHub Models with OpenAI Java SDK for free AI development -- Test say everything dey work with simple example wey dey talk to AI models +- You don create GitHub Personal Access Token with right AI model permissions +- Your Java development environment dey run (whether na Codespaces, dev containers, or local) +- You don connect to GitHub Models using OpenAI Java SDK for free AI development +- You test am with simple example wey dey talk to AI models ## Next Steps @@ -228,36 +219,36 @@ Nice one! You don set everything up: ## Troubleshooting -You dey face wahala? Check these common problems and solutions: +Get wahala? Here be common problems and how you fit solve dem: - **Token no dey work?** - - Make sure say you copy the full token without extra space - - Confirm say the token dey set well as environment variable - - Check say your token get correct permissions (Models: Read and write) + - Check say you copy full token with no space inside + - Make sure token dey set well as environment variable + - Confirm your token get correct permissions (Models: Read-only) -- **Maven no dey?** - - If you dey use dev containers/Codespaces, Maven suppose don dey pre-installed - - For local setup, make sure say Java 21+ and Maven 3.9+ dey installed - - Try `mvn --version` to confirm installation +- **Maven no show?** + - If you dey use dev containers/Codespaces, Maven suppose dey pre-installed + - For local setup, make sure Java 21+ and Maven 3.9+ don install + - Try run `mvn --version` to confirm e dey - **Connection wahala?** - Check your internet connection - - Confirm say GitHub dey accessible from your network - - Make sure say firewall no dey block GitHub Models endpoint + - Confirm say GitHub fit open from your network + - Make sure firewall no dey block GitHub Models endpoint - **Dev container no dey start?** - - Make sure say Docker Desktop dey run (for local development) - - Try rebuild the container: `Ctrl+Shift+P` → "Dev Containers: Rebuild Container" + - Make sure Docker Desktop dey run (for local) + - Try rebuild container: `Ctrl+Shift+P` → "Dev Containers: Rebuild Container" -- **App dey show compilation errors?** - - Make sure say you dey inside correct directory: `02-SetupDevEnvironment/examples/github-models` +- **App compile error?** + - Make sure you dey correct directory: `02-SetupDevEnvironment/examples/github-models` - Try clean and rebuild: `mvn clean compile` -> **Need help?**: You still dey face wahala? Open issue for the repository and we go help you. +> **Need help?**: If you still get wahala, open issue for the repository and we go help you. --- -**Disclaimer**: -Dis dokyument don translate wit AI translation service [Co-op Translator](https://github.com/Azure/co-op-translator). Even as we dey try make am accurate, abeg no forget say machine translation fit get mistake or no dey correct well. Di original dokyument for im native language na di main source wey you go trust. For important information, e better make professional human translator check am. We no go fit take blame for any misunderstanding or wrong interpretation wey fit happen because you use dis translation. +**Disclaimer**: +Dis document na wetin AI translation service [Co-op Translator](https://github.com/Azure/co-op-translator) translate. Even though we try make e correct, abeg sabi say automated translation fit get mistakes or no too correct. Di original document wey dem write for im own language na di correct one wey you suppose rely on. If na serious matter, e better make human professional translate am. We no go responsible if pesin misunderstand or misinterpret anything because of dis translation. \ No newline at end of file diff --git a/translations/pcm/02-SetupDevEnvironment/examples/basic-chat-azure/README.md b/translations/pcm/02-SetupDevEnvironment/examples/basic-chat-azure/README.md index f25092ce..f4ff36c6 100644 --- a/translations/pcm/02-SetupDevEnvironment/examples/basic-chat-azure/README.md +++ b/translations/pcm/02-SetupDevEnvironment/examples/basic-chat-azure/README.md @@ -1,12 +1,3 @@ - # Basic Chat wit Azure OpenAI - End-to-End Example Dis example go show how you fit take create simple Spring Boot app wey go connect to Azure OpenAI and test your setup. diff --git a/translations/pcm/02-SetupDevEnvironment/getting-started-azure-openai.md b/translations/pcm/02-SetupDevEnvironment/getting-started-azure-openai.md index 5ac29ddc..e92cac0d 100644 --- a/translations/pcm/02-SetupDevEnvironment/getting-started-azure-openai.md +++ b/translations/pcm/02-SetupDevEnvironment/getting-started-azure-openai.md @@ -1,12 +1,3 @@ - # How to Set Up Di Development Environment for Azure OpenAI > **Quick Start**: Dis guide na for Azure OpenAI setup. If you wan start quick-quick with free models, use [GitHub Models with Codespaces](./README.md#quick-start-cloud). diff --git a/translations/pcm/03-CoreGenerativeAITechniques/README.md b/translations/pcm/03-CoreGenerativeAITechniques/README.md index d99b098b..f0204b95 100644 --- a/translations/pcm/03-CoreGenerativeAITechniques/README.md +++ b/translations/pcm/03-CoreGenerativeAITechniques/README.md @@ -1,12 +1,3 @@ - # Core Generative AI Techniques Tutorial ## Table of Contents diff --git a/translations/pcm/04-PracticalSamples/README.md b/translations/pcm/04-PracticalSamples/README.md index b48f0dc4..e761151c 100644 --- a/translations/pcm/04-PracticalSamples/README.md +++ b/translations/pcm/04-PracticalSamples/README.md @@ -1,12 +1,3 @@ - # Practical Applications & Projects ## Wetin You Go Learn diff --git a/translations/pcm/04-PracticalSamples/calculator/README.md b/translations/pcm/04-PracticalSamples/calculator/README.md index 1887f560..9d258280 100644 --- a/translations/pcm/04-PracticalSamples/calculator/README.md +++ b/translations/pcm/04-PracticalSamples/calculator/README.md @@ -1,12 +1,3 @@ - # MCP Calculator Tutorial for Beginners ## Table of Contents diff --git a/translations/pcm/04-PracticalSamples/foundrylocal/README.md b/translations/pcm/04-PracticalSamples/foundrylocal/README.md index 79616edf..9d03a28f 100644 --- a/translations/pcm/04-PracticalSamples/foundrylocal/README.md +++ b/translations/pcm/04-PracticalSamples/foundrylocal/README.md @@ -1,12 +1,3 @@ - # Foundry Local Spring Boot Tutorial ## Table of Contents diff --git a/translations/pcm/04-PracticalSamples/petstory/README.md b/translations/pcm/04-PracticalSamples/petstory/README.md index 8bb1dafb..a221b7ba 100644 --- a/translations/pcm/04-PracticalSamples/petstory/README.md +++ b/translations/pcm/04-PracticalSamples/petstory/README.md @@ -1,12 +1,3 @@ - # Pet Story Generator Tutorial for Beginners ## Table of Contents diff --git a/translations/pcm/05-ResponsibleGenAI/README.md b/translations/pcm/05-ResponsibleGenAI/README.md index 9b9048c7..f572cbdd 100644 --- a/translations/pcm/05-ResponsibleGenAI/README.md +++ b/translations/pcm/05-ResponsibleGenAI/README.md @@ -1,12 +1,3 @@ - # Responsible Generative AI ## Wetin You Go Learn diff --git a/translations/pcm/AGENTS.md b/translations/pcm/AGENTS.md index 701cee53..7a96b263 100644 --- a/translations/pcm/AGENTS.md +++ b/translations/pcm/AGENTS.md @@ -1,12 +1,3 @@ - # AGENTS.md ## Project Overview diff --git a/translations/pcm/CODE_OF_CONDUCT.md b/translations/pcm/CODE_OF_CONDUCT.md index c66e7878..18ea8330 100644 --- a/translations/pcm/CODE_OF_CONDUCT.md +++ b/translations/pcm/CODE_OF_CONDUCT.md @@ -1,12 +1,3 @@ - # Microsoft Open Source Code of Conduct Dis project don adopt di [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/). diff --git a/translations/pcm/README.md b/translations/pcm/README.md index 502e4aca..22cb609c 100644 --- a/translations/pcm/README.md +++ b/translations/pcm/README.md @@ -1,18 +1,9 @@ - # Generative AI for Beginners - Java Edition [![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) ![Generative AI for Beginners - Java Edition](../../translated_images/pcm/beg-genai-series.8b48be9951cc574c.webp) -**Time Commitment**: Di whole workshop fit finish online without local setup. Di environment setup go take 2 minutes, and di samples exploration go take 1-3 hours based on how deep you wan explore. +**Time Commitment**: Di whole workshop fit finish online without local setup. Di environment setup go take 2 minutes, and to explore di samples go take 1-3 hours depending on how deep you wan explore. > **Quick Start** @@ -20,18 +11,18 @@ CO_OP_TRANSLATOR_METADATA: 2. Click **Code** → **Codespaces** tab → **...** → **New with options...** 3. Use di defaults – dis one go select di Development container wey dem create for dis course 4. Click **Create codespace** -5. Wait ~2 minutes make di environment ready -6. Jump straight go [Di first example](./02-SetupDevEnvironment/README.md#step-2-create-a-github-personal-access-token) +5. Wait ~2 minutes make environment ready +6. Jump straight to [The first example](./02-SetupDevEnvironment/README.md#step-2-create-a-github-personal-access-token) > **Prefer to Clone Locally?** > -> Dis repository get 50+ language translations wey mean say e go increase di download size. If you wan clone without translations, use sparse checkout: +> Dis repository get 50+ language translations wey dey increase the size wey you go download. To clone without di translations, use sparse checkout: > ```bash > git clone --filter=blob:none --sparse https://github.com/microsoft/Generative-AI-for-beginners-java.git > cd Generative-AI-for-beginners-java > git sparse-checkout set --no-cone '/*' '!translations' '!translated_images' > ``` -> Dis dey give you everytin wey you need to finish di course with faster download. +> Dis one go give you everything wey you need to complete di course with faster download. ## Multi-Language Support @@ -39,17 +30,17 @@ CO_OP_TRANSLATOR_METADATA: ### Supported via GitHub Action (Automated & Always Up-to-Date) -[Arabic](../ar/README.md) | [Bengali](../bn/README.md) | [Bulgarian](../bg/README.md) | [Burmese (Myanmar)](../my/README.md) | [Chinese (Simplified)](../zh/README.md) | [Chinese (Traditional, Hong Kong)](../hk/README.md) | [Chinese (Traditional, Macau)](../mo/README.md) | [Chinese (Traditional, Taiwan)](../tw/README.md) | [Croatian](../hr/README.md) | [Czech](../cs/README.md) | [Danish](../da/README.md) | [Dutch](../nl/README.md) | [Estonian](../et/README.md) | [Finnish](../fi/README.md) | [French](../fr/README.md) | [German](../de/README.md) | [Greek](../el/README.md) | [Hebrew](../he/README.md) | [Hindi](../hi/README.md) | [Hungarian](../hu/README.md) | [Indonesian](../id/README.md) | [Italian](../it/README.md) | [Japanese](../ja/README.md) | [Kannada](../kn/README.md) | [Korean](../ko/README.md) | [Lithuanian](../lt/README.md) | [Malay](../ms/README.md) | [Malayalam](../ml/README.md) | [Marathi](../mr/README.md) | [Nepali](../ne/README.md) | [Nigerian Pidgin](./README.md) | [Norwegian](../no/README.md) | [Persian (Farsi)](../fa/README.md) | [Polish](../pl/README.md) | [Portuguese (Brazil)](../br/README.md) | [Portuguese (Portugal)](../pt/README.md) | [Punjabi (Gurmukhi)](../pa/README.md) | [Romanian](../ro/README.md) | [Russian](../ru/README.md) | [Serbian (Cyrillic)](../sr/README.md) | [Slovak](../sk/README.md) | [Slovenian](../sl/README.md) | [Spanish](../es/README.md) | [Swahili](../sw/README.md) | [Swedish](../sv/README.md) | [Tagalog (Filipino)](../tl/README.md) | [Tamil](../ta/README.md) | [Telugu](../te/README.md) | [Thai](../th/README.md) | [Turkish](../tr/README.md) | [Ukrainian](../uk/README.md) | [Urdu](../ur/README.md) | [Vietnamese](../vi/README.md) +[Arabic](../ar/README.md) | [Bengali](../bn/README.md) | [Bulgarian](../bg/README.md) | [Burmese (Myanmar)](../my/README.md) | [Chinese (Simplified)](../zh-CN/README.md) | [Chinese (Traditional, Hong Kong)](../zh-HK/README.md) | [Chinese (Traditional, Macau)](../zh-MO/README.md) | [Chinese (Traditional, Taiwan)](../zh-TW/README.md) | [Croatian](../hr/README.md) | [Czech](../cs/README.md) | [Danish](../da/README.md) | [Dutch](../nl/README.md) | [Estonian](../et/README.md) | [Finnish](../fi/README.md) | [French](../fr/README.md) | [German](../de/README.md) | [Greek](../el/README.md) | [Hebrew](../he/README.md) | [Hindi](../hi/README.md) | [Hungarian](../hu/README.md) | [Indonesian](../id/README.md) | [Italian](../it/README.md) | [Japanese](../ja/README.md) | [Kannada](../kn/README.md) | [Korean](../ko/README.md) | [Lithuanian](../lt/README.md) | [Malay](../ms/README.md) | [Malayalam](../ml/README.md) | [Marathi](../mr/README.md) | [Nepali](../ne/README.md) | [Nigerian Pidgin](./README.md) | [Norwegian](../no/README.md) | [Persian (Farsi)](../fa/README.md) | [Polish](../pl/README.md) | [Portuguese (Brazil)](../pt-BR/README.md) | [Portuguese (Portugal)](../pt-PT/README.md) | [Punjabi (Gurmukhi)](../pa/README.md) | [Romanian](../ro/README.md) | [Russian](../ru/README.md) | [Serbian (Cyrillic)](../sr/README.md) | [Slovak](../sk/README.md) | [Slovenian](../sl/README.md) | [Spanish](../es/README.md) | [Swahili](../sw/README.md) | [Swedish](../sv/README.md) | [Tagalog (Filipino)](../tl/README.md) | [Tamil](../ta/README.md) | [Telugu](../te/README.md) | [Thai](../th/README.md) | [Turkish](../tr/README.md) | [Ukrainian](../uk/README.md) | [Urdu](../ur/README.md) | [Vietnamese](../vi/README.md) > **Prefer to Clone Locally?** -> Dis repository get 50+ language translations wey mean say e go increase di download size. If you wan clone without translations, use sparse checkout: +> Dis repository get 50+ language translations wey dey increase di download size well well. To clone without di translations, use sparse checkout: > ```bash > git clone --filter=blob:none --sparse https://github.com/microsoft/Generative-AI-for-beginners-java.git > cd Generative-AI-for-beginners-java > git sparse-checkout set --no-cone '/*' '!translations' '!translated_images' > ``` -> Dis dey give you everytin wey you need to finish di course with faster download. +> Dis one go give you everything wey you need to complete di course with faster download. ## Course Structure & Learning Path @@ -57,22 +48,22 @@ CO_OP_TRANSLATOR_METADATA: ### **Chapter 1: Introduction to Generative AI** - **Core Concepts**: Understand Large Language Models, tokens, embeddings, and AI capabilities - **Java AI Ecosystem**: Overview of Spring AI and OpenAI SDKs -- **Model Context Protocol**: Introduction to MCP and how e dey help AI agent communication -- **Practical Applications**: Real-world tins like chatbots and content generation +- **Model Context Protocol**: Introduction to MCP and how e dey help AI agents talk +- **Practical Applications**: Real-life scenarios like chatbots and content generation - **[→ Start Chapter 1](./01-IntroToGenAI/README.md)** ### **Chapter 2: Development Environment Setup** - **Multi-Provider Configuration**: Set up GitHub Models, Azure OpenAI, and OpenAI Java SDK integrations -- **Spring Boot + Spring AI**: Best way dem dey do enterprise AI application development -- **GitHub Models**: Free AI model access for prototyping and learning (no credit card needed) +- **Spring Boot + Spring AI**: Best practices for enterprise AI application development +- **GitHub Models**: Free AI model access for prototyping and learning (no need credit card) - **Development Tools**: Docker containers, VS Code, and GitHub Codespaces setup - **[→ Start Chapter 2](./02-SetupDevEnvironment/README.md)** ### **Chapter 3: Core Generative AI Techniques** - **Prompt Engineering**: Techniques to get better AI model responses -- **Embeddings & Vector Operations**: Fit do semantic search and similarity matching +- **Embeddings & Vector Operations**: How to run semantic search and similarity matching - **Retrieval-Augmented Generation (RAG)**: Combine AI with your own data sources -- **Function Calling**: Make AI more powerful with custom tools and plugins +- **Function Calling**: Extend AI powers with custom tools and plugins - **[→ Start Chapter 3](./03-CoreGenerativeAITechniques/README.md)** ### **Chapter 4: Practical Applications & Projects** @@ -82,9 +73,9 @@ CO_OP_TRANSLATOR_METADATA: - **[→ Start Chapter 4](./04-PracticalSamples/README.md)** ### **Chapter 5: Responsible AI Development** -- **GitHub Models Safety**: Test built-in content filtering and safety mechanisms (hard blocks and soft refusals) -- **Responsible AI Demo**: Hands-on example how modern AI safety systems dey work for real life -- **Best Practices**: Important guidelines for ethical AI development and deployment +- **GitHub Models Safety**: Test built-in content filtering and safety mechanics (hard blocks plus soft refusals) +- **Responsible AI Demo**: Hands-on example wey show how modern AI safety systems dey work +- **Best Practices**: Important guidelines to do ethical AI development and deployment - **[→ Start Chapter 5](./05-ResponsibleGenAI/README.md)** ## Additional Resources @@ -131,17 +122,17 @@ CO_OP_TRANSLATOR_METADATA: ## Getting Help -If you get stuck or get any question about building AI apps. Join other learners and experienced developers for talks about MCP. Na community wey dey help, where questions dey welcome and knowledge dey share freely. +If you dey jam wahala or get any question about how to build AI apps. Na so you fit join oda learners and beta developers for talk about MCP. Na community wey dey supportive, where questions dey welcome and dem dey share knowledge freely. [![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) -If you get product feedback or you see errors when you dey build, waka go: +If you get feedback about product or you see error wen you dey build, waka go: [![Microsoft Foundry Developer Forum](https://img.shields.io/badge/GitHub-Microsoft_Foundry_Developer_Forum-blue?style=for-the-badge&logo=github&color=000000&logoColor=fff)](https://aka.ms/foundry/forum) --- -**Disclaimer**: -Dis document na wetin AI translation service [Co-op Translator](https://github.com/Azure/co-op-translator) translate. Even though we try make e correct, abeg sabi say automated translation fit get some mistakes or no clear well. The original document wey dem write for im own language na im carry true info. If na serious matter, e better make person wey sabi translate am human translate am. We no go take responsibility if person no understand or waka wrong because of dis translation. +**Disclaimer**: +Dis document don translate wit AI translation service [Co-op Translator](https://github.com/Azure/co-op-translator). Even though we dey try make am correct, abeg sabi say machine translation fit get mistake or no too correct. Di original document for im own language na di correct one. If na serious matter, e good make human professional translator do am. We no go take responsibility if person misunderstand or misinterpret anything from dis translation. \ No newline at end of file diff --git a/translations/pcm/SECURITY.md b/translations/pcm/SECURITY.md index 608bb456..b1401a4b 100644 --- a/translations/pcm/SECURITY.md +++ b/translations/pcm/SECURITY.md @@ -1,12 +1,3 @@ - ## Security Microsoft dey take di security of dia software products and services serious, wey include all di source code repositories wey dem dey manage through dia GitHub organizations, wey include [Microsoft](https://github.com/Microsoft), [Azure](https://github.com/Azure), [DotNet](https://github.com/dotnet), [AspNet](https://github.com/aspnet) and [Xamarin](https://github.com/xamarin). diff --git a/translations/pcm/SUPPORT.md b/translations/pcm/SUPPORT.md index 8afd8c45..90ea2b78 100644 --- a/translations/pcm/SUPPORT.md +++ b/translations/pcm/SUPPORT.md @@ -1,12 +1,3 @@ - # Support ## How you go fit report wahala and get help diff --git a/translations/pl/.co-op-translator.json b/translations/pl/.co-op-translator.json new file mode 100644 index 00000000..d6ed3875 --- /dev/null +++ b/translations/pl/.co-op-translator.json @@ -0,0 +1,92 @@ +{ + "01-IntroToGenAI/README.md": { + "original_hash": "75bfb080ca725e8a9aa9c80cae25fba1", + "translation_date": "2025-07-29T09:08:55+00:00", + "source_file": "01-IntroToGenAI/README.md", + "language_code": "pl" + }, + "02-SetupDevEnvironment/README.md": { + "original_hash": "96a30d42b9751a3d4e4b20e28d29d459", + "translation_date": "2026-01-28T04:57:55+00:00", + "source_file": "02-SetupDevEnvironment/README.md", + "language_code": "pl" + }, + "02-SetupDevEnvironment/examples/basic-chat-azure/README.md": { + "original_hash": "efd82efe50711d7e257eb943151d682c", + "translation_date": "2025-07-27T13:40:21+00:00", + "source_file": "02-SetupDevEnvironment/examples/basic-chat-azure/README.md", + "language_code": "pl" + }, + "02-SetupDevEnvironment/getting-started-azure-openai.md": { + "original_hash": "bfdb4b4eadbee3a59ef742439f58326a", + "translation_date": "2025-07-27T13:08:23+00:00", + "source_file": "02-SetupDevEnvironment/getting-started-azure-openai.md", + "language_code": "pl" + }, + "03-CoreGenerativeAITechniques/README.md": { + "original_hash": "685f55cb07de19b52a30ce6e8b6d889e", + "translation_date": "2025-08-28T22:05:11+00:00", + "source_file": "03-CoreGenerativeAITechniques/README.md", + "language_code": "pl" + }, + "04-PracticalSamples/README.md": { + "original_hash": "14c0a61ecc1cd2012a9c129236dfdf71", + "translation_date": "2025-07-29T09:08:36+00:00", + "source_file": "04-PracticalSamples/README.md", + "language_code": "pl" + }, + "04-PracticalSamples/calculator/README.md": { + "original_hash": "b6c16b5514d524e415a94f6097ee7d4c", + "translation_date": "2025-09-18T15:31:40+00:00", + "source_file": "04-PracticalSamples/calculator/README.md", + "language_code": "pl" + }, + "04-PracticalSamples/foundrylocal/README.md": { + "original_hash": "f787307400de59adc25a1404466a35f3", + "translation_date": "2025-11-04T07:24:03+00:00", + "source_file": "04-PracticalSamples/foundrylocal/README.md", + "language_code": "pl" + }, + "04-PracticalSamples/petstory/README.md": { + "original_hash": "0cbf68d605615a1e602c832a24616859", + "translation_date": "2025-07-25T11:21:06+00:00", + "source_file": "04-PracticalSamples/petstory/README.md", + "language_code": "pl" + }, + "05-ResponsibleGenAI/README.md": { + "original_hash": "301c05c2f57e60a6950b8c665b8bdbba", + "translation_date": "2025-07-29T15:49:53+00:00", + "source_file": "05-ResponsibleGenAI/README.md", + "language_code": "pl" + }, + "AGENTS.md": { + "original_hash": "afc90918d008cf77fd1982691f681306", + "translation_date": "2025-10-03T08:35:23+00:00", + "source_file": "AGENTS.md", + "language_code": "pl" + }, + "CODE_OF_CONDUCT.md": { + "original_hash": "442b123d034f92f7c384d2bbd28f99f1", + "translation_date": "2025-07-21T15:59:14+00:00", + "source_file": "CODE_OF_CONDUCT.md", + "language_code": "pl" + }, + "README.md": { + "original_hash": "125a08948d881c95628094f4dd1fbd43", + "translation_date": "2026-01-29T15:44:44+00:00", + "source_file": "README.md", + "language_code": "pl" + }, + "SECURITY.md": { + "original_hash": "57f14126c1c6add76b3aef3844dfe4e3", + "translation_date": "2025-07-21T15:57:47+00:00", + "source_file": "SECURITY.md", + "language_code": "pl" + }, + "SUPPORT.md": { + "original_hash": "b8ef73cc49dec68e2c885ee9df545129", + "translation_date": "2025-07-21T16:00:18+00:00", + "source_file": "SUPPORT.md", + "language_code": "pl" + } +} \ No newline at end of file diff --git a/translations/pl/01-IntroToGenAI/README.md b/translations/pl/01-IntroToGenAI/README.md index 1eac5f27..7f65b620 100644 --- a/translations/pl/01-IntroToGenAI/README.md +++ b/translations/pl/01-IntroToGenAI/README.md @@ -1,12 +1,3 @@ - # Wprowadzenie do Generatywnej Sztucznej Inteligencji - Edycja Java ## Czego się nauczysz diff --git a/translations/pl/02-SetupDevEnvironment/README.md b/translations/pl/02-SetupDevEnvironment/README.md index a8ccb20d..de329bc2 100644 --- a/translations/pl/02-SetupDevEnvironment/README.md +++ b/translations/pl/02-SetupDevEnvironment/README.md @@ -1,13 +1,253 @@ - +# Konfiguracja środowiska programistycznego dla Generative AI dla Java +> **Szybki start**: Koduj w chmurze w 2 minuty – przejdź do [Konfiguracja GitHub Codespaces](../../../02-SetupDevEnvironment) – brak instalacji lokalnej, korzysta z modeli GitHub! + +> **Zainteresowany Azure OpenAI?**, zobacz nasz [Przewodnik konfiguracji Azure OpenAI](getting-started-azure-openai.md) z krokami tworzenia nowego zasobu Azure OpenAI. + +## Czego się nauczysz + +- Skonfigurować środowisko programistyczne Java dla aplikacji AI +- Wybrać i skonfigurować preferowane środowisko programistyczne (priorytet chmura z Codespaces, lokalny dev container lub pełna lokalna konfiguracja) +- Przetestować konfigurację, łącząc się z modelami GitHub + +## Spis treści + +- [Czego się nauczysz](../../../02-SetupDevEnvironment) +- [Wprowadzenie](../../../02-SetupDevEnvironment) +- [Krok 1: Skonfiguruj środowisko programistyczne](../../../02-SetupDevEnvironment) + - [Opcja A: GitHub Codespaces (zalecane)](../../../02-SetupDevEnvironment) + - [Opcja B: Lokalny Dev Container](../../../02-SetupDevEnvironment) + - [Opcja C: Użyj swojej istniejącej lokalnej instalacji](../../../02-SetupDevEnvironment) +- [Krok 2: Utwórz token dostępu osobistego GitHub](../../../02-SetupDevEnvironment) +- [Krok 3: Przetestuj konfigurację](../../../02-SetupDevEnvironment) +- [Rozwiązywanie problemów](../../../02-SetupDevEnvironment) +- [Podsumowanie](../../../02-SetupDevEnvironment) +- [Następne kroki](../../../02-SetupDevEnvironment) + +## Wprowadzenie + +Ten rozdział przeprowadzi Cię przez proces konfiguracji środowiska programistycznego. Użyjemy **GitHub Models** jako naszego głównego przykładu, ponieważ jest darmowy, łatwy do konfiguracji z użyciem tylko konta GitHub, nie wymaga karty kredytowej i oferuje dostęp do wielu modeli do eksperymentów. + +**Brak konieczności lokalnej instalacji!** Możesz zacząć kodować od razu, używając GitHub Codespaces, które zapewnia pełne środowisko programistyczne w przeglądarce. + +Zrzut ekranu: GitHub Models + +Polecamy korzystać z [**GitHub Models**](https://github.com/marketplace?type=models) na ten kurs, ponieważ jest to: +- **Darmowe** aby zacząć +- **Łatwe** do skonfigurowania tylko z kontem GitHub +- **Bez karty kredytowej** +- **Wiele modeli** dostępnych do eksperymentów + +> **Uwaga**: Modele GitHub używane w tym szkoleniu mają następujące darmowe limity: +> - 15 zapytań na minutę (150 dziennie) +> - ~8 000 słów wejściowych, ~4 000 słów wyjściowych na zapytanie +> - 5 zapytań jednocześnie +> +> Do zastosowań produkcyjnych zaktualizuj do Azure AI Foundry Models z kontem Azure. Twój kod nie musi być modyfikowany. Zobacz [dokumentację Azure AI Foundry](https://learn.microsoft.com/azure/ai-foundry/foundry-models/how-to/quickstart-github-models). + + +## Krok 1: Skonfiguruj swoje środowisko programistyczne + + + +Utworzyliśmy prekonfigurowany kontener developerski, aby zminimalizować czas konfiguracji i zapewnić, że masz wszystkie potrzebne narzędzia do kursu Generative AI dla Java. Wybierz preferowany sposób pracy: + +### Opcje konfiguracji środowiska: + +#### Opcja A: GitHub Codespaces (zalecane) + +**Zacznij kodować w 2 minuty – bez lokalnej instalacji!** + +1. Zforkuj to repozytorium na swoje konto GitHub + > **Uwaga**: Jeśli chcesz edytować podstawową konfigurację, zobacz [Konfigurację Dev Container](../../../.devcontainer/devcontainer.json) +2. Kliknij **Code** → zakładka **Codespaces** → **...** → **New with options...** +3. Użyj domyślnych ustawień – wybierze to konfigurację **Dev container**: **Generative AI Java Development Environment** utworzony na ten kurs +4. Kliknij **Create codespace** +5. Poczekaj około 2 minut na gotowość środowiska +6. Przejdź do [Kroku 2: Utwórz token GitHub](../../../02-SetupDevEnvironment) + +Zrzut ekranu: podmenu Codespaces + +Zrzut ekranu: New with options + +Zrzut ekranu: opcje tworzenia codespaces + +> **Zalety Codespaces**: +> - Brak konieczności instalacji lokalnej +> - Działa na dowolnym urządzeniu z przeglądarką +> - Wstępnie skonfigurowane ze wszystkimi narzędziami i zależnościami +> - Darmowe 60 godzin miesięcznie dla kont osobistych +> - Spójne środowisko dla wszystkich uczących się + +#### Opcja B: Lokalny Dev Container + +**Dla programistów preferujących lokalny rozwój z Dockerem** + +1. Zforkuj i sklonuj to repozytorium na swoją maszynę lokalną + > **Uwaga**: Jeśli chcesz edytować podstawową konfigurację, zobacz [Konfigurację Dev Container](../../../.devcontainer/devcontainer.json) +2. Zainstaluj [Docker Desktop](https://www.docker.com/products/docker-desktop/) i [VS Code](https://code.visualstudio.com/) +3. Zainstaluj rozszerzenie [Dev Containers](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers) w VS Code +4. Otwórz folder repozytorium w VS Code +5. Po wyświetleniu monitu kliknij **Reopen in Container** (lub użyj `Ctrl+Shift+P` → "Dev Containers: Reopen in Container") +6. Poczekaj na zbudowanie i uruchomienie kontenera +7. Przejdź do [Kroku 2: Utwórz token GitHub](../../../02-SetupDevEnvironment) + +Zrzut ekranu: konfiguracja dev container + +Zrzut ekranu: zakończona budowa dev container + +#### Opcja C: Użyj swojej istniejącej lokalnej instalacji + +**Dla programistów z istniejącym środowiskiem Java** + +Wymagania: +- [Java 21+](https://www.oracle.com/java/technologies/javase/jdk21-archive-downloads.html) +- [Maven 3.9+](https://maven.apache.org/download.cgi) +- [VS Code](https://code.visualstudio.com) lub preferowane IDE + +Kroki: +1. Sklonuj to repozytorium na swoją maszynę lokalną +2. Otwórz projekt w swoim IDE +3. Przejdź do [Kroku 2: Utwórz token GitHub](../../../02-SetupDevEnvironment) + +> **Porada**: Jeśli masz mało wydajny sprzęt, ale chcesz używać VS Code lokalnie, korzystaj z GitHub Codespaces! Możesz połączyć lokalne VS Code z chmurowym Codespace, łącząc zalety obu środowisk. + +Zrzut ekranu: utworzona lokalna instancja devcontainer + + +## Krok 2: Utwórz GitHub Personal Access Token + +1. Przejdź do [Ustawień GitHub](https://github.com/settings/profile) i wybierz **Settings** z menu profilu. +2. W lewym pasku bocznym kliknij **Developer settings** (zazwyczaj na dole). +3. W sekcji **Personal access tokens** kliknij **Fine-grained tokens** (lub użyj tego bezpośredniego [linku](https://github.com/settings/personal-access-tokens)). +4. Kliknij **Generate new token**. +5. W polu „Token name” podaj opisową nazwę (np. `GenAI-Java-Course-Token`). +6. Ustaw datę wygaśnięcia (zalecane: 7 dni dla najlepszych praktyk bezpieczeństwa). +7. W sekcji „Resource owner” wybierz swoje konto użytkownika. +8. W sekcji „Repository access” wybierz repozytoria, których chcesz używać z GitHub Models (lub „All repositories”, jeśli potrzebne). +9. W sekcji „Account permissions” znajdź **Models** i ustaw na **Read-only**. +10. Kliknij **Generate token**. +11. **Skopiuj i zapisz swój token teraz** – nie zobaczysz go ponownie! + +> **Wskazówka bezpieczeństwa**: Używaj minimalnego wymaganego zakresu i jak najkrótszego praktycznego czasu ważności tokenów dostępowych. + +## Krok 3: Przetestuj konfigurację na przykładzie GitHub Models + +Gdy środowisko programistyczne jest gotowe, przetestuj integrację z GitHub Models za pomocą przykładowej aplikacji w [`02-SetupDevEnvironment/examples/github-models`](../../../02-SetupDevEnvironment/examples/github-models). + +1. Otwórz terminal w środowisku programistycznym. +2. Przejdź do przykładu GitHub Models: + ```bash + cd 02-SetupDevEnvironment/examples/github-models + ``` +3. Ustaw token GitHub jako zmienną środowiskową: + ```bash + # macOS/Linux + export GITHUB_TOKEN=your_token_here + + # Windows (Wiersz poleceń) + set GITHUB_TOKEN=your_token_here + + # Windows (PowerShell) + $env:GITHUB_TOKEN="your_token_here" + ``` + +4. Uruchom aplikację: + ```bash + mvn compile exec:java -Dexec.mainClass="com.example.githubmodels.App" + ``` + +Powinieneś zobaczyć podobne wyjście: +```text +Using model: gpt-4.1-nano +Sending request to GitHub Models... +Response: Hello World! +``` + +### Zrozumienie przykładowego kodu + +Najpierw zrozummy, co właśnie uruchomiliśmy. Przykład w `examples/github-models` używa Java SDK OpenAI, aby połączyć się z GitHub Models: + +**Co robi ten kod:** +- **Łączy się** z GitHub Models za pomocą twojego tokena dostępu osobistego +- **Wysyła** prostą wiadomość "Say Hello World!" do modelu AI +- **Odbiera** i wyświetla odpowiedź AI +- **Sprawdza**, czy konfiguracja działa poprawnie + +**Kluczowa zależność** (w pliku `pom.xml`): +```xml + + com.openai + openai-java + 2.12.0 + +``` + +**Główny kod** (`App.java`): +```java +// Połącz się z modelami GitHub za pomocą OpenAI Java SDK +OpenAIClient client = OpenAIOkHttpClient.builder() + .apiKey(pat) + .baseUrl("https://models.inference.ai.azure.com") + .build(); + +// Utwórz żądanie uzupełnienia czatu +ChatCompletionCreateParams params = ChatCompletionCreateParams.builder() + .model(modelId) + .addSystemMessage("You are a concise assistant.") + .addUserMessage("Say Hello World!") + .build(); + +// Pobierz odpowiedź AI +ChatCompletion response = client.chat().completions().create(params); +System.out.println("Response: " + response.choices().get(0).message().content().orElse("No response content")); +``` + +## Podsumowanie + +Świetnie! Masz teraz wszystko skonfigurowane: + +- Utworzono GitHub Personal Access Token z odpowiednimi uprawnieniami do dostępu do modelu AI +- Twoje środowisko Java jest uruchomione (czy to Codespaces, dev containers czy lokalne) +- Połączyłeś się z GitHub Models używając OpenAI Java SDK do darmowego rozwoju AI +- Przetestowałeś wszystko za pomocą prostego przykładu rozmawiającego z modelami AI + +## Następne kroki + +[Rozdział 3: Kluczowe techniki Generative AI](../03-CoreGenerativeAITechniques/README.md) + +## Rozwiązywanie problemów + +Masz problemy? Oto typowe problemy i rozwiązania: + +- **Token nie działa?** + - Upewnij się, że skopiowałeś cały token bez dodatkowych spacji + - Sprawdź, czy token jest poprawnie ustawiony jako zmienna środowiskowa + - Zweryfikuj, że token ma właściwe uprawnienia (Models: Read-only) + +- **Maven nie znaleziony?** + - Jeśli używasz dev containers/Codespaces, Maven powinien być preinstalowany + - W przypadku lokalnej instalacji upewnij się, że masz Java 21+ i Maven 3.9+ + - Sprawdź instalację poleceniem `mvn --version` + +- **Problemy z połączeniem?** + - Sprawdź połączenie internetowe + - Upewnij się, że GitHub jest dostępny w twojej sieci + - Sprawdź, czy nie masz zapory, która blokuje endpoint GitHub Models + +- **Dev container nie startuje?** + - Upewnij się, że Docker Desktop działa (dla rozwoju lokalnego) + - Spróbuj przebudować kontener: `Ctrl+Shift+P` → "Dev Containers: Rebuild Container" + +- **Błędy kompilacji aplikacji?** + - Sprawdź, czy jesteś w poprawnym katalogu: `02-SetupDevEnvironment/examples/github-models` + - Spróbuj wykonać czyszczenie i kompilację: `mvn clean compile` + +> **Potrzebujesz pomocy?**: Nadal masz problemy? Otwórz zgłoszenie w repozytorium, a pomożemy Ci. --- + +**Zastrzeżenie**: +Niniejszy dokument został przetłumaczony za pomocą usługi tłumaczeniowej AI [Co-op Translator](https://github.com/Azure/co-op-translator). Mimo że dokładamy wszelkich starań, aby tłumaczenie było jak najdokładniejsze, prosimy pamiętać, że automatyczne tłumaczenia mogą zawierać błędy lub nieścisłości. Oryginalny dokument w języku źródłowym powinien być traktowany jako źródło autorytatywne. W przypadku ważnych informacji zalecane jest skorzystanie z profesjonalnego, ludzkiego tłumaczenia. Nie ponosimy odpowiedzialności za jakiekolwiek nieporozumienia lub błędne interpretacje wynikające z korzystania z tego tłumaczenia. + \ No newline at end of file diff --git a/translations/pl/02-SetupDevEnvironment/examples/basic-chat-azure/README.md b/translations/pl/02-SetupDevEnvironment/examples/basic-chat-azure/README.md index 1a855a04..ab9ab7a1 100644 --- a/translations/pl/02-SetupDevEnvironment/examples/basic-chat-azure/README.md +++ b/translations/pl/02-SetupDevEnvironment/examples/basic-chat-azure/README.md @@ -1,12 +1,3 @@ - # Podstawowy Chat z Azure OpenAI - Przykład End-to-End Ten przykład pokazuje, jak stworzyć prostą aplikację Spring Boot, która łączy się z Azure OpenAI i testuje Twoją konfigurację. diff --git a/translations/pl/02-SetupDevEnvironment/getting-started-azure-openai.md b/translations/pl/02-SetupDevEnvironment/getting-started-azure-openai.md index 0465272d..b9ddf421 100644 --- a/translations/pl/02-SetupDevEnvironment/getting-started-azure-openai.md +++ b/translations/pl/02-SetupDevEnvironment/getting-started-azure-openai.md @@ -1,12 +1,3 @@ - # Konfigurowanie środowiska deweloperskiego dla Azure OpenAI > **Szybki start**: Ten przewodnik dotyczy konfiguracji Azure OpenAI. Aby szybko rozpocząć pracę z darmowymi modelami, skorzystaj z [GitHub Models with Codespaces](./README.md#quick-start-cloud). diff --git a/translations/pl/03-CoreGenerativeAITechniques/README.md b/translations/pl/03-CoreGenerativeAITechniques/README.md index d995a644..bb568ab9 100644 --- a/translations/pl/03-CoreGenerativeAITechniques/README.md +++ b/translations/pl/03-CoreGenerativeAITechniques/README.md @@ -1,12 +1,3 @@ - # Podstawowe Techniki Generatywnej AI - Tutorial ## Spis Treści diff --git a/translations/pl/04-PracticalSamples/README.md b/translations/pl/04-PracticalSamples/README.md index cb581126..ba548943 100644 --- a/translations/pl/04-PracticalSamples/README.md +++ b/translations/pl/04-PracticalSamples/README.md @@ -1,12 +1,3 @@ - # Praktyczne Zastosowania i Projekty ## Czego się nauczysz diff --git a/translations/pl/04-PracticalSamples/calculator/README.md b/translations/pl/04-PracticalSamples/calculator/README.md index 03123563..95026163 100644 --- a/translations/pl/04-PracticalSamples/calculator/README.md +++ b/translations/pl/04-PracticalSamples/calculator/README.md @@ -1,12 +1,3 @@ - # Samouczek MCP Calculator dla Początkujących ## Spis Treści diff --git a/translations/pl/04-PracticalSamples/foundrylocal/README.md b/translations/pl/04-PracticalSamples/foundrylocal/README.md index 84f1246a..9973fbee 100644 --- a/translations/pl/04-PracticalSamples/foundrylocal/README.md +++ b/translations/pl/04-PracticalSamples/foundrylocal/README.md @@ -1,12 +1,3 @@ - # Samouczek Foundry Local Spring Boot ## Spis treści diff --git a/translations/pl/04-PracticalSamples/petstory/README.md b/translations/pl/04-PracticalSamples/petstory/README.md index 29ee6311..93826423 100644 --- a/translations/pl/04-PracticalSamples/petstory/README.md +++ b/translations/pl/04-PracticalSamples/petstory/README.md @@ -1,12 +1,3 @@ - # Samouczek Generatora Opowieści o Zwierzętach dla Początkujących ## Spis Treści diff --git a/translations/pl/05-ResponsibleGenAI/README.md b/translations/pl/05-ResponsibleGenAI/README.md index 28508052..eb08a149 100644 --- a/translations/pl/05-ResponsibleGenAI/README.md +++ b/translations/pl/05-ResponsibleGenAI/README.md @@ -1,12 +1,3 @@ - # Odpowiedzialna Generatywna AI ## Czego się nauczysz diff --git a/translations/pl/AGENTS.md b/translations/pl/AGENTS.md index e7186208..57fb7800 100644 --- a/translations/pl/AGENTS.md +++ b/translations/pl/AGENTS.md @@ -1,12 +1,3 @@ - # AGENTS.md ## Przegląd projektu diff --git a/translations/pl/CODE_OF_CONDUCT.md b/translations/pl/CODE_OF_CONDUCT.md index f267c391..106014b2 100644 --- a/translations/pl/CODE_OF_CONDUCT.md +++ b/translations/pl/CODE_OF_CONDUCT.md @@ -1,12 +1,3 @@ - # Kodeks postępowania Microsoft Open Source Ten projekt przyjął [Kodeks postępowania Microsoft Open Source](https://opensource.microsoft.com/codeofconduct/). diff --git a/translations/pl/README.md b/translations/pl/README.md index 1199a6c7..53075b17 100644 --- a/translations/pl/README.md +++ b/translations/pl/README.md @@ -1,90 +1,80 @@ - -# Generatywna AI dla początkujących - wersja Java +# Generatywna SI dla początkujących - wydanie Java [![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) -![Generatywna AI dla początkujących - wersja Java](../../translated_images/pl/beg-genai-series.8b48be9951cc574c.webp) +![Generatywna SI dla początkujących - wydanie Java](../../translated_images/pl/beg-genai-series.8b48be9951cc574c.webp) -**Czas potrzebny**: Cały warsztat można ukończyć online bez lokalnej instalacji. Konfiguracja środowiska zajmuje 2 minuty, a eksploracja przykładów wymaga 1-3 godzin, w zależności od głębokości poznawania. +**Czas zaangażowania**: Cały warsztat można ukończyć online bez lokalnej instalacji. Konfiguracja środowiska zajmuje 2 minuty, a eksploracja przykładów wymaga 1-3 godzin w zależności od głębokości eksploracji. -> **Szybki start** +> **Szybki start** -1. Wykonaj fork tego repozytorium na swoje konto GitHub -2. Kliknij **Code** → zakładka **Codespaces** → **...** → **Nowy z opcjami...** +1. "Forknij" to repozytorium na swoje konto GitHub +2. Kliknij **Code** → zakładka **Codespaces** → **...** → **New with options...** 3. Użyj domyślnych ustawień – wybierze to kontener developerski stworzony dla tego kursu -4. Kliknij **Utwórz codespace** -5. Poczekaj około 2 minut, aż środowisko będzie gotowe +4. Kliknij **Create codespace** +5. Poczekaj ~2 minuty na gotowość środowiska 6. Przejdź bezpośrednio do [Pierwszego przykładu](./02-SetupDevEnvironment/README.md#step-2-create-a-github-personal-access-token) > **Wolisz klonować lokalnie?** > -> To repozytorium zawiera ponad 50 tłumaczeń językowych, co znacznie zwiększa rozmiar pobierania. Aby sklonować bez tłumaczeń, użyj sparse checkout: +> To repozytorium zawiera więcej niż 50 tłumaczeń językowych, co znacznie zwiększa rozmiar pobierania. Aby sklonować bez tłumaczeń, użyj sparse checkout: > ```bash > git clone --filter=blob:none --sparse https://github.com/microsoft/Generative-AI-for-beginners-java.git > cd Generative-AI-for-beginners-java > git sparse-checkout set --no-cone '/*' '!translations' '!translated_images' > ``` -> Dzięki temu otrzymasz wszystko, co potrzebne do ukończenia kursu, a pobieranie będzie dużo szybsze. - +> Daje to wszystko, czego potrzebujesz do ukończenia kursu, z dużo szybkim pobieraniem. ## Wsparcie wielojęzyczne -### Obsługiwane przez GitHub Action (Automatyczne i zawsze aktualne) +### Obsługiwane przez GitHub Action (Automatyczne i Zawsze Aktualne) -[Arabski](../ar/README.md) | [Bengalski](../bn/README.md) | [Bułgarski](../bg/README.md) | [Birmański (Myanmar)](../my/README.md) | [Chiński (uproszczony)](../zh/README.md) | [Chiński (tradycyjny, Hongkong)](../hk/README.md) | [Chiński (tradycyjny, Makau)](../mo/README.md) | [Chiński (tradycyjny, Tajwan)](../tw/README.md) | [Chorwacki](../hr/README.md) | [Czeski](../cs/README.md) | [Duński](../da/README.md) | [Niderlandzki](../nl/README.md) | [Estoński](../et/README.md) | [Fiński](../fi/README.md) | [Francuski](../fr/README.md) | [Niemiecki](../de/README.md) | [Grecki](../el/README.md) | [Hebrajski](../he/README.md) | [Hindi](../hi/README.md) | [Węgierski](../hu/README.md) | [Indonezyjski](../id/README.md) | [Włoski](../it/README.md) | [Japoński](../ja/README.md) | [Kannada](../kn/README.md) | [Koreański](../ko/README.md) | [Litewski](../lt/README.md) | [Malajski](../ms/README.md) | [Malajalam](../ml/README.md) | [Marathi](../mr/README.md) | [Nepalski](../ne/README.md) | [Pidgin nigeryjski](../pcm/README.md) | [Norweski](../no/README.md) | [Perski (Farsi)](../fa/README.md) | [Polski](./README.md) | [Portugalski (Brazylia)](../br/README.md) | [Portugalski (Portugalia)](../pt/README.md) | [Pendżabski (Gurmukhi)](../pa/README.md) | [Rumuński](../ro/README.md) | [Rosyjski](../ru/README.md) | [Serbski (cyrylica)](../sr/README.md) | [Słowacki](../sk/README.md) | [Słoweński](../sl/README.md) | [Hiszpański](../es/README.md) | [Suahili](../sw/README.md) | [Szwedzki](../sv/README.md) | [Tagalog (Filipiński)](../tl/README.md) | [Tamilski](../ta/README.md) | [Telugu](../te/README.md) | [Tajski](../th/README.md) | [Turecki](../tr/README.md) | [Ukraiński](../uk/README.md) | [Urdu](../ur/README.md) | [Wietnamski](../vi/README.md) +[Arabski](../ar/README.md) | [Bengalski](../bn/README.md) | [Bułgarski](../bg/README.md) | [Birmański (Myanmar)](../my/README.md) | [Chiński (uproszczony)](../zh-CN/README.md) | [Chiński (tradycyjny, Hongkong)](../zh-HK/README.md) | [Chiński (tradycyjny, Makau)](../zh-MO/README.md) | [Chiński (tradycyjny, Tajwan)](../zh-TW/README.md) | [Chorwacki](../hr/README.md) | [Czeski](../cs/README.md) | [Duński](../da/README.md) | [Niderlandzki](../nl/README.md) | [Estoński](../et/README.md) | [Fiński](../fi/README.md) | [Francuski](../fr/README.md) | [Niemiecki](../de/README.md) | [Grecki](../el/README.md) | [Hebrajski](../he/README.md) | [Hindi](../hi/README.md) | [Węgierski](../hu/README.md) | [Indonezyjski](../id/README.md) | [Włoski](../it/README.md) | [Japoński](../ja/README.md) | [Kannada](../kn/README.md) | [Koreański](../ko/README.md) | [Litewski](../lt/README.md) | [Malajski](../ms/README.md) | [Malajalam](../ml/README.md) | [Marathi](../mr/README.md) | [Nepalski](../ne/README.md) | [Nigerski pidgin](../pcm/README.md) | [Norweski](../no/README.md) | [Perski (Farsi)](../fa/README.md) | [Polski](./README.md) | [Portugalski (Brazylia)](../pt-BR/README.md) | [Portugalski (Portugalia)](../pt-PT/README.md) | [Pendżabski (Gurmukhi)](../pa/README.md) | [Rumuński](../ro/README.md) | [Rosyjski](../ru/README.md) | [Serbski (cyrylica)](../sr/README.md) | [Słowacki](../sk/README.md) | [Słoweński](../sl/README.md) | [Hiszpański](../es/README.md) | [Suahili](../sw/README.md) | [Szwedzki](../sv/README.md) | [Tagalog (Filipiński)](../tl/README.md) | [Tamilski](../ta/README.md) | [Telugu](../te/README.md) | [Tajski](../th/README.md) | [Turecki](../tr/README.md) | [Ukraiński](../uk/README.md) | [Urdu](../ur/README.md) | [Wietnamski](../vi/README.md) > **Wolisz klonować lokalnie?** -> To repozytorium zawiera ponad 50 tłumaczeń językowych, co znacznie zwiększa rozmiar pobierania. Aby sklonować bez tłumaczeń, użyj sparse checkout: +> To repozytorium zawiera więcej niż 50 tłumaczeń językowych, co znacznie zwiększa rozmiar pobierania. Aby sklonować bez tłumaczeń, użyj sparse checkout: > ```bash > git clone --filter=blob:none --sparse https://github.com/microsoft/Generative-AI-for-beginners-java.git > cd Generative-AI-for-beginners-java > git sparse-checkout set --no-cone '/*' '!translations' '!translated_images' > ``` -> Dzięki temu otrzymasz wszystko, co potrzebne do ukończenia kursu, a pobieranie będzie dużo szybsze. +> Daje to wszystko, czego potrzebujesz do ukończenia kursu, z dużo szybkim pobieraniem. ## Struktura kursu i ścieżka nauki -### **Rozdział 1: Wprowadzenie do generatywnej AI** -- **Podstawowe koncepcje**: Poznanie dużych modeli językowych, tokenów, reprezentacji wektorowych i możliwości AI -- **Ekosystem AI w Javie**: Przegląd Spring AI oraz SDK OpenAI -- **Model Context Protocol**: Wprowadzenie do MCP i jego roli w komunikacji agentów AI -- **Praktyczne zastosowania**: Scenariusze z życia, takie jak chatboty i generowanie treści +### **Rozdział 1: Wprowadzenie do Generatywnej SI** +- **Podstawowe pojęcia**: zrozumienie dużych modeli językowych, tokenów, osadzeń i możliwości SI +- **Ekosystem SI w Javie**: przegląd Spring AI i OpenAI SDK +- **Protokół kontekstu modelu**: wprowadzenie do MCP i jego roli w komunikacji agentów SI +- **Zastosowania praktyczne**: scenariusze rzeczywiste, w tym chatboty i generowanie treści - **[→ Rozpocznij rozdział 1](./01-IntroToGenAI/README.md)** -### **Rozdział 2: Konfiguracja środowiska programistycznego** -- **Konfiguracja multi-dostawców**: Ustawienia modeli GitHub, Azure OpenAI oraz OpenAI Java SDK -- **Spring Boot + Spring AI**: Najlepsze praktyki tworzenia aplikacji korporacyjnych AI -- **Modele GitHub**: Darmowy dostęp do modeli AI do prototypowania i nauki (bez potrzeby karty kredytowej) -- **Narzędzia developerskie**: Kontenery Docker, VS Code oraz konfiguracja GitHub Codespaces +### **Rozdział 2: Konfiguracja środowiska developerskiego** +- **Konfiguracja multi-dostawcy**: integracja GitHub Models, Azure OpenAI i OpenAI Java SDK +- **Spring Boot + Spring AI**: najlepsze praktyki tworzenia aplikacji SI dla przedsiębiorstw +- **GitHub Models**: darmowy dostęp do modeli SI do prototypowania i nauki (bez karty kredytowej) +- **Narzędzia developerskie**: kontenery Docker, VS Code i konfiguracja GitHub Codespaces - **[→ Rozpocznij rozdział 2](./02-SetupDevEnvironment/README.md)** -### **Rozdział 3: Podstawowe techniki generatywnej AI** -- **Inżynieria promptów**: Techniki uzyskiwania optymalnych odpowiedzi od modeli AI -- **Reprezentacje wektorowe i operacje na nich**: Implementacja semantycznego wyszukiwania i dopasowania podobieństw -- **Retrieval-Augmented Generation (RAG)**: Łączenie AI z własnymi źródłami danych -- **Wywołania funkcji**: Rozszerzanie możliwości AI za pomocą narzędzi i wtyczek +### **Rozdział 3: Podstawowe techniki generatywnej SI** +- **Inżynieria promptów**: techniki optymalnego tworzenia odpowiedzi modeli SI +- **Osadzenia i operacje na wektorach**: implementacja wyszukiwania semantycznego i dopasowywania podobieństwa +- **Retrieval-Augmented Generation (RAG)**: łączenie SI z własnymi źródłami danych +- **Wywoływanie funkcji**: rozszerzanie możliwości SI własnymi narzędziami i wtyczkami - **[→ Rozpocznij rozdział 3](./03-CoreGenerativeAITechniques/README.md)** ### **Rozdział 4: Praktyczne zastosowania i projekty** -- **Generator historii o zwierzętach** (`petstory/`): Kreatywne generowanie treści za pomocą modeli GitHub -- **Demonstracja Foundry lokalnie** (`foundrylocal/`): Lokalna integracja modeli AI z OpenAI Java SDK -- **Serwis kalkulatora MCP** (`calculator/`): Podstawowa implementacja Model Context Protocol ze Spring AI +- **Generator opowieści o zwierzętach** (`petstory/`): kreatywne generowanie treści z GitHub Models +- **Demonstracja Foundry lokalnie** (`foundrylocal/`): lokalna integracja modelu SI z OpenAI Java SDK +- **Usługa kalkulator MCP** (`calculator/`): podstawowa implementacja Model Context Protocol ze Spring AI - **[→ Rozpocznij rozdział 4](./04-PracticalSamples/README.md)** -### **Rozdział 5: Odpowiedzialne tworzenie AI** -- **Bezpieczeństwo modeli GitHub**: Testowanie wbudowanych filtrów treści i mechanizmów bezpieczeństwa (blokady twarde i miękkie odrzuty) -- **Demo odpowiedzialnej AI**: Praktyczny przykład działania nowoczesnych systemów bezpieczeństwa AI -- **Najlepsze praktyki**: Kluczowe wytyczne etycznego tworzenia i wdrażania AI +### **Rozdział 5: Odpowiedzialny rozwój SI** +- **Bezpieczeństwo GitHub Models**: testowanie wbudowanych mechanizmów filtrowania treści i zabezpieczeń (twarde blokady i miękkie odmowy) +- **Demo odpowiedzialnej SI**: praktyczny przykład działania nowoczesnych systemów bezpieczeństwa SI +- **Najlepsze praktyki**: kluczowe wytyczne dla etycznego rozwoju i wdrażania SI - **[→ Rozpocznij rozdział 5](./05-ResponsibleGenAI/README.md)** ## Dodatkowe zasoby @@ -100,24 +90,25 @@ CO_OP_TRANSLATOR_METADATA: [![AZD dla początkujących](https://img.shields.io/badge/AZD%20for%20Beginners-0078D4?style=for-the-badge&labelColor=E5E7EB&color=0078D4)](https://github.com/microsoft/AZD-for-beginners?WT.mc_id=academic-105485-koreyst) [![Edge AI dla początkujących](https://img.shields.io/badge/Edge%20AI%20for%20Beginners-00B8E4?style=for-the-badge&labelColor=E5E7EB&color=00B8E4)](https://github.com/microsoft/edgeai-for-beginners?WT.mc_id=academic-105485-koreyst) [![MCP dla początkujących](https://img.shields.io/badge/MCP%20for%20Beginners-009688?style=for-the-badge&labelColor=E5E7EB&color=009688)](https://github.com/microsoft/mcp-for-beginners?WT.mc_id=academic-105485-koreyst) -[![Agenci AI dla początkujących](https://img.shields.io/badge/AI%20Agents%20for%20Beginners-00C49A?style=for-the-badge&labelColor=E5E7EB&color=00C49A)](https://github.com/microsoft/ai-agents-for-beginners?WT.mc_id=academic-105485-koreyst) +[![Agenci SI dla początkujących](https://img.shields.io/badge/AI%20Agents%20for%20Beginners-00C49A?style=for-the-badge&labelColor=E5E7EB&color=00C49A)](https://github.com/microsoft/ai-agents-for-beginners?WT.mc_id=academic-105485-koreyst) --- - -### Seria Generatywna AI -[![Generatywna AI dla początkujących](https://img.shields.io/badge/Generative%20AI%20for%20Beginners-8B5CF6?style=for-the-badge&labelColor=E5E7EB&color=8B5CF6)](https://github.com/microsoft/generative-ai-for-beginners?WT.mc_id=academic-105485-koreyst) -[![Generatywna AI (.NET)](https://img.shields.io/badge/Generative%20AI%20(.NET)-9333EA?style=for-the-badge&labelColor=E5E7EB&color=9333EA)](https://github.com/microsoft/Generative-AI-for-beginners-dotnet?WT.mc_id=academic-105485-koreyst) -[![Generatywna AI (Java)](https://img.shields.io/badge/Generative%20AI%20(Java)-C084FC?style=for-the-badge&labelColor=E5E7EB&color=C084FC)](https://github.com/microsoft/generative-ai-for-beginners-java?WT.mc_id=academic-105485-koreyst) -[![Generatywna AI (JavaScript)](https://img.shields.io/badge/Generative%20AI%20(JavaScript)-E879F9?style=for-the-badge&labelColor=E5E7EB&color=E879F9)](https://github.com/microsoft/generative-ai-with-javascript?WT.mc_id=academic-105485-koreyst) + +### Seria Generatywna SI +[![Generatywna SI dla początkujących](https://img.shields.io/badge/Generative%20AI%20for%20Beginners-8B5CF6?style=for-the-badge&labelColor=E5E7EB&color=8B5CF6)](https://github.com/microsoft/generative-ai-for-beginners?WT.mc_id=academic-105485-koreyst) +[![Generatywna SI (.NET)](https://img.shields.io/badge/Generative%20AI%20(.NET)-9333EA?style=for-the-badge&labelColor=E5E7EB&color=9333EA)](https://github.com/microsoft/Generative-AI-for-beginners-dotnet?WT.mc_id=academic-105485-koreyst) +[![Generatywna SI (Java)](https://img.shields.io/badge/Generative%20AI%20(Java)-C084FC?style=for-the-badge&labelColor=E5E7EB&color=C084FC)](https://github.com/microsoft/generative-ai-for-beginners-java?WT.mc_id=academic-105485-koreyst) +[![Generatywna SI (JavaScript)](https://img.shields.io/badge/Generative%20AI%20(JavaScript)-E879F9?style=for-the-badge&labelColor=E5E7EB&color=E879F9)](https://github.com/microsoft/generative-ai-with-javascript?WT.mc_id=academic-105485-koreyst) --- - -### Podstawowe nauki + +### Podstawy nauki [![ML dla początkujących](https://img.shields.io/badge/ML%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=22C55E)](https://aka.ms/ml-beginners?WT.mc_id=academic-105485-koreyst) [![Data Science dla początkujących](https://img.shields.io/badge/Data%20Science%20for%20Beginners-84CC16?style=for-the-badge&labelColor=E5E7EB&color=84CC16)](https://aka.ms/datascience-beginners?WT.mc_id=academic-105485-koreyst) -[![AI dla początkujących](https://img.shields.io/badge/AI%20for%20Beginners-A3E635?style=for-the-badge&labelColor=E5E7EB&color=A3E635)](https://aka.ms/ai-beginners?WT.mc_id=academic-105485-koreyst) +[![SI dla początkujących](https://img.shields.io/badge/AI%20for%20Beginners-A3E635?style=for-the-badge&labelColor=E5E7EB&color=A3E635)](https://aka.ms/ai-beginners?WT.mc_id=academic-105485-koreyst) [![Cyberbezpieczeństwo dla początkujących](https://img.shields.io/badge/Cybersecurity%20for%20Beginners-F97316?style=for-the-badge&labelColor=E5E7EB&color=F97316)](https://github.com/microsoft/Security-101?WT.mc_id=academic-96948-sayoung) -[![Web Dev dla początkujących](https://img.shields.io/badge/Web%20Dev%20for%20Beginners-EC4899?style=for-the-badge&labelColor=E5E7EB&color=EC4899)](https://aka.ms/webdev-beginners?WT.mc_id=academic-105485-koreyst) + +[![Web Dev for Beginners](https://img.shields.io/badge/Web%20Dev%20for%20Beginners-EC4899?style=for-the-badge&labelColor=E5E7EB&color=EC4899)](https://aka.ms/webdev-beginners?WT.mc_id=academic-105485-koreyst) [![IoT for Beginners](https://img.shields.io/badge/IoT%20for%20Beginners-14B8A6?style=for-the-badge&labelColor=E5E7EB&color=14B8A6)](https://aka.ms/iot-beginners?WT.mc_id=academic-105485-koreyst) [![XR Development for Beginners](https://img.shields.io/badge/XR%20Development%20for%20Beginners-38BDF8?style=for-the-badge&labelColor=E5E7EB&color=38BDF8)](https://github.com/microsoft/xr-development-for-beginners?WT.mc_id=academic-105485-koreyst) @@ -131,11 +122,11 @@ CO_OP_TRANSLATOR_METADATA: ## Uzyskiwanie pomocy -Jeśli utkniesz lub masz pytania dotyczące tworzenia aplikacji AI, dołącz do innych uczących się i doświadczonych programistów w dyskusjach na temat MCP. To wspierająca społeczność, gdzie pytania są mile widziane, a wiedza jest swobodnie dzielona. +Jeśli utkniesz lub masz jakiekolwiek pytania dotyczące tworzenia aplikacji AI, dołącz do innych uczestników kursu oraz doświadczonych programistów w dyskusjach na temat MCP. To wspierająca społeczność, gdzie pytania są mile widziane, a wiedza jest chętnie dzielona. [![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) -Jeśli masz uwagi dotyczące produktu lub błędy podczas tworzenia, odwiedź: +Jeśli masz uwagi dotyczące produktu lub napotykasz błędy podczas tworzenia, odwiedź: [![Microsoft Foundry Developer Forum](https://img.shields.io/badge/GitHub-Microsoft_Foundry_Developer_Forum-blue?style=for-the-badge&logo=github&color=000000&logoColor=fff)](https://aka.ms/foundry/forum) @@ -143,5 +134,5 @@ Jeśli masz uwagi dotyczące produktu lub błędy podczas tworzenia, odwiedź: **Zastrzeżenie**: -Niniejszy dokument został przetłumaczony przy użyciu usługi tłumaczeniowej AI [Co-op Translator](https://github.com/Azure/co-op-translator). Chociaż dokładamy wszelkich starań, aby zapewnić poprawność, prosimy mieć na uwadze, że tłumaczenia automatyczne mogą zawierać błędy lub niedokładności. Oryginalny dokument w języku źródłowym należy traktować jako źródło wiarygodne. W przypadku informacji o kluczowym znaczeniu zalecane jest skorzystanie z profesjonalnego tłumaczenia wykonanego przez człowieka. Nie ponosimy odpowiedzialności za jakiekolwiek nieporozumienia lub błędne interpretacje wynikające z wykorzystania tego tłumaczenia. +Dokument ten został przetłumaczony przy użyciu usługi tłumaczenia AI [Co-op Translator](https://github.com/Azure/co-op-translator). Mimo że dążymy do dokładności, prosimy o świadomość, że tłumaczenia automatyczne mogą zawierać błędy lub niedokładności. Oryginalny dokument w jego rodzimym języku powinien być traktowany jako źródło nadrzędne. W przypadku informacji krytycznych zalecane jest skorzystanie z profesjonalnego, ludzkiego tłumaczenia. Nie ponosimy odpowiedzialności za jakiekolwiek nieporozumienia lub błędne interpretacje wynikające z użycia tego tłumaczenia. \ No newline at end of file diff --git a/translations/pl/SECURITY.md b/translations/pl/SECURITY.md index 8dc82c4f..478f021d 100644 --- a/translations/pl/SECURITY.md +++ b/translations/pl/SECURITY.md @@ -1,12 +1,3 @@ - ## Bezpieczeństwo Microsoft traktuje bezpieczeństwo swoich produktów i usług programistycznych bardzo poważnie, w tym wszystkich repozytoriów kodu źródłowego zarządzanych w ramach naszych organizacji na GitHubie, takich jak [Microsoft](https://github.com/Microsoft), [Azure](https://github.com/Azure), [DotNet](https://github.com/dotnet), [AspNet](https://github.com/aspnet) i [Xamarin](https://github.com/xamarin). diff --git a/translations/pl/SUPPORT.md b/translations/pl/SUPPORT.md index 2ef98f64..ed11e412 100644 --- a/translations/pl/SUPPORT.md +++ b/translations/pl/SUPPORT.md @@ -1,12 +1,3 @@ - # Wsparcie ## Jak zgłaszać problemy i uzyskiwać pomoc diff --git a/translations/pt-BR/.co-op-translator.json b/translations/pt-BR/.co-op-translator.json new file mode 100644 index 00000000..744ac2a3 --- /dev/null +++ b/translations/pt-BR/.co-op-translator.json @@ -0,0 +1,92 @@ +{ + "01-IntroToGenAI/README.md": { + "original_hash": "75bfb080ca725e8a9aa9c80cae25fba1", + "translation_date": "2025-07-29T09:01:58+00:00", + "source_file": "01-IntroToGenAI/README.md", + "language_code": "pt-BR" + }, + "02-SetupDevEnvironment/README.md": { + "original_hash": "96a30d42b9751a3d4e4b20e28d29d459", + "translation_date": "2026-01-28T04:55:23+00:00", + "source_file": "02-SetupDevEnvironment/README.md", + "language_code": "pt-BR" + }, + "02-SetupDevEnvironment/examples/basic-chat-azure/README.md": { + "original_hash": "efd82efe50711d7e257eb943151d682c", + "translation_date": "2025-07-27T13:39:41+00:00", + "source_file": "02-SetupDevEnvironment/examples/basic-chat-azure/README.md", + "language_code": "pt-BR" + }, + "02-SetupDevEnvironment/getting-started-azure-openai.md": { + "original_hash": "bfdb4b4eadbee3a59ef742439f58326a", + "translation_date": "2025-07-27T13:06:26+00:00", + "source_file": "02-SetupDevEnvironment/getting-started-azure-openai.md", + "language_code": "pt-BR" + }, + "03-CoreGenerativeAITechniques/README.md": { + "original_hash": "685f55cb07de19b52a30ce6e8b6d889e", + "translation_date": "2025-08-28T22:04:06+00:00", + "source_file": "03-CoreGenerativeAITechniques/README.md", + "language_code": "pt-BR" + }, + "04-PracticalSamples/README.md": { + "original_hash": "14c0a61ecc1cd2012a9c129236dfdf71", + "translation_date": "2025-07-29T09:01:45+00:00", + "source_file": "04-PracticalSamples/README.md", + "language_code": "pt-BR" + }, + "04-PracticalSamples/calculator/README.md": { + "original_hash": "b6c16b5514d524e415a94f6097ee7d4c", + "translation_date": "2025-09-18T15:30:49+00:00", + "source_file": "04-PracticalSamples/calculator/README.md", + "language_code": "pt-BR" + }, + "04-PracticalSamples/foundrylocal/README.md": { + "original_hash": "f787307400de59adc25a1404466a35f3", + "translation_date": "2025-11-04T07:22:52+00:00", + "source_file": "04-PracticalSamples/foundrylocal/README.md", + "language_code": "pt-BR" + }, + "04-PracticalSamples/petstory/README.md": { + "original_hash": "0cbf68d605615a1e602c832a24616859", + "translation_date": "2025-07-25T11:17:00+00:00", + "source_file": "04-PracticalSamples/petstory/README.md", + "language_code": "pt-BR" + }, + "05-ResponsibleGenAI/README.md": { + "original_hash": "301c05c2f57e60a6950b8c665b8bdbba", + "translation_date": "2025-07-29T15:48:56+00:00", + "source_file": "05-ResponsibleGenAI/README.md", + "language_code": "pt-BR" + }, + "AGENTS.md": { + "original_hash": "afc90918d008cf77fd1982691f681306", + "translation_date": "2025-10-03T08:34:35+00:00", + "source_file": "AGENTS.md", + "language_code": "pt-BR" + }, + "CODE_OF_CONDUCT.md": { + "original_hash": "442b123d034f92f7c384d2bbd28f99f1", + "translation_date": "2025-07-21T17:37:06+00:00", + "source_file": "CODE_OF_CONDUCT.md", + "language_code": "pt-BR" + }, + "README.md": { + "original_hash": "125a08948d881c95628094f4dd1fbd43", + "translation_date": "2026-01-29T15:41:24+00:00", + "source_file": "README.md", + "language_code": "pt-BR" + }, + "SECURITY.md": { + "original_hash": "57f14126c1c6add76b3aef3844dfe4e3", + "translation_date": "2025-07-21T17:35:44+00:00", + "source_file": "SECURITY.md", + "language_code": "pt-BR" + }, + "SUPPORT.md": { + "original_hash": "b8ef73cc49dec68e2c885ee9df545129", + "translation_date": "2025-07-21T17:38:11+00:00", + "source_file": "SUPPORT.md", + "language_code": "pt-BR" + } +} \ No newline at end of file diff --git a/translations/br/01-IntroToGenAI/README.md b/translations/pt-BR/01-IntroToGenAI/README.md similarity index 96% rename from translations/br/01-IntroToGenAI/README.md rename to translations/pt-BR/01-IntroToGenAI/README.md index 4c1e0afb..4b2f813f 100644 --- a/translations/br/01-IntroToGenAI/README.md +++ b/translations/pt-BR/01-IntroToGenAI/README.md @@ -1,12 +1,3 @@ - # Introdução à IA Generativa - Edição Java ## O que você vai aprender @@ -44,7 +35,7 @@ Ao desenvolver suas aplicações de IA em Java, você trabalhará com **modelos Existem tipos específicos de modelos otimizados para diferentes tarefas. Por exemplo, tanto **Modelos de Linguagem Pequenos (SLMs)** quanto **Modelos de Linguagem de Grande Escala (LLMs)** podem lidar com geração de texto, sendo que os LLMs geralmente oferecem melhor desempenho para tarefas complexas. Para tarefas relacionadas a imagens, você usaria modelos de visão especializados ou modelos multimodais. -![Figura: Tipos de modelos de IA generativa e casos de uso.](../../../translated_images/br/llms.225ca2b8a0d34473.webp) +![Figura: Tipos de modelos de IA generativa e casos de uso.](../../../translated_images/pt-BR/llms.225ca2b8a0d34473.webp) É claro que as respostas desses modelos nem sempre são perfeitas. Você provavelmente já ouviu falar sobre modelos "alucinando" ou gerando informações incorretas de maneira autoritária. Mas você pode ajudar a orientar o modelo para gerar melhores respostas fornecendo instruções claras e contexto. É aqui que entra a **engenharia de prompts**. @@ -79,13 +70,13 @@ Tokenização é o processo de dividir o texto em essas unidades menores. Isso - **Embeddings**: Embeddings são representações vetoriais de tokens que capturam o significado semântico. São representações numéricas (normalmente arrays de números de ponto flutuante) que permitem aos modelos entender relações entre palavras e gerar respostas contextualmente relevantes. Palavras semelhantes têm embeddings semelhantes, permitindo que o modelo entenda conceitos como sinônimos e relações semânticas. -![Figura: Embeddings](../../../translated_images/br/embedding.398e50802c0037f9.webp) +![Figura: Embeddings](../../../translated_images/pt-BR/embedding.398e50802c0037f9.webp) Em Java, você pode gerar embeddings usando o OpenAI SDK ou outras bibliotecas que suportam geração de embeddings. Esses embeddings são essenciais para tarefas como busca semântica, onde você deseja encontrar conteúdo semelhante com base no significado, em vez de correspondências exatas de texto. - **Bancos de dados vetoriais**: Bancos de dados vetoriais são sistemas de armazenamento especializados otimizados para embeddings. Eles permitem buscas eficientes por similaridade e são cruciais para padrões de Geração Aumentada por Recuperação (RAG), onde você precisa encontrar informações relevantes em grandes conjuntos de dados com base na similaridade semântica, em vez de correspondências exatas. -![Figura: Arquitetura de banco de dados vetorial mostrando como embeddings são armazenados e recuperados para busca por similaridade.](../../../translated_images/br/vector.f12f114934e223df.webp) +![Figura: Arquitetura de banco de dados vetorial mostrando como embeddings são armazenados e recuperados para busca por similaridade.](../../../translated_images/pt-BR/vector.f12f114934e223df.webp) > **Nota**: Neste curso, não abordaremos bancos de dados vetoriais, mas achamos que vale a pena mencioná-los, pois são comumente usados em aplicações do mundo real. @@ -93,7 +84,7 @@ Tokenização é o processo de dividir o texto em essas unidades menores. Isso Em aplicações de IA em Java, você usará tokens para processamento de texto, embeddings para busca semântica e RAG, bancos de dados vetoriais para recuperação de dados e agentes com MCP para construir sistemas inteligentes que utilizam ferramentas. -![Figura: como um prompt se torna uma resposta—tokens, vetores, busca opcional RAG, raciocínio LLM e um agente MCP, tudo em um fluxo rápido.](../../../translated_images/br/flow.f4ef62c3052d12a8.webp) +![Figura: como um prompt se torna uma resposta—tokens, vetores, busca opcional RAG, raciocínio LLM e um agente MCP, tudo em um fluxo rápido.](../../../translated_images/pt-BR/flow.f4ef62c3052d12a8.webp) ### Ferramentas e bibliotecas de desenvolvimento de IA para Java diff --git a/translations/pt-BR/02-SetupDevEnvironment/README.md b/translations/pt-BR/02-SetupDevEnvironment/README.md new file mode 100644 index 00000000..b911dbd8 --- /dev/null +++ b/translations/pt-BR/02-SetupDevEnvironment/README.md @@ -0,0 +1,255 @@ +# Configurando o Ambiente de Desenvolvimento para IA Generativa para Java + +> **Início Rápido**: Codifique na nuvem em 2 minutos - Vá para [Configuração do GitHub Codespaces](../../../02-SetupDevEnvironment) - não é necessário instalar localmente e usa modelos do GitHub! + +> **Interessado em Azure OpenAI?**, veja nosso [Guia de Configuração do Azure OpenAI](getting-started-azure-openai.md) com passos para criar um novo recurso Azure OpenAI. + +## O que você vai aprender + +- Configurar um ambiente de desenvolvimento Java para aplicações de IA +- Escolher e configurar seu ambiente de desenvolvimento preferido (priorizando nuvem com Codespaces, contêiner dev local ou configuração local completa) +- Testar sua configuração conectando-se aos Modelos do GitHub + +## Sumário + +- [O que você vai aprender](../../../02-SetupDevEnvironment) +- [Introdução](../../../02-SetupDevEnvironment) +- [Passo 1: Configure seu Ambiente de Desenvolvimento](../../../02-SetupDevEnvironment) + - [Opção A: GitHub Codespaces (Recomendado)](../../../02-SetupDevEnvironment) + - [Opção B: Contêiner Dev Local](../../../02-SetupDevEnvironment) + - [Opção C: Use sua Instalação Local Existente](../../../02-SetupDevEnvironment) +- [Passo 2: Crie um Token de Acesso Pessoal do GitHub](../../../02-SetupDevEnvironment) +- [Passo 3: Teste sua Configuração](../../../02-SetupDevEnvironment) +- [Resolução de Problemas](../../../02-SetupDevEnvironment) +- [Resumo](../../../02-SetupDevEnvironment) +- [Próximos Passos](../../../02-SetupDevEnvironment) + +## Introdução + +Este capítulo irá guiá-lo na configuração de um ambiente de desenvolvimento. Usaremos **Modelos do GitHub** como nosso exemplo principal porque são gratuitos, fáceis de configurar com apenas uma conta GitHub, não exigem cartão de crédito e fornecem acesso a múltiplos modelos para experimentação. + +**Nenhuma configuração local necessária!** Você pode começar a programar imediatamente usando GitHub Codespaces, que oferece um ambiente de desenvolvimento completo no seu navegador. + +Captura de tela: Modelos do GitHub + +Recomendamos usar [**Modelos do GitHub**](https://github.com/marketplace?type=models) para este curso porque são: +- **Gratuitos** para começar +- **Fáceis** de configurar com apenas uma conta GitHub +- **Sem cartão de crédito** necessário +- **Vários modelos** disponíveis para experimentação + +> **Nota**: Os Modelos do GitHub usados neste treinamento possuem estes limites gratuitos: +> - 15 requisições por minuto (150 por dia) +> - ~8.000 palavras de entrada, ~4.000 palavras de saída por requisição +> - 5 requisições simultâneas +> +> Para uso em produção, faça upgrade para Modelos Azure AI Foundry com sua conta Azure. Seu código não precisa mudar. Veja a [documentação Azure AI Foundry](https://learn.microsoft.com/azure/ai-foundry/foundry-models/how-to/quickstart-github-models). + + +## Passo 1: Configure seu Ambiente de Desenvolvimento + + + +Criamos um contêiner de desenvolvimento pré-configurado para minimizar o tempo de configuração e garantir que você tenha todas as ferramentas necessárias para este curso de IA Generativa para Java. Escolha a abordagem de desenvolvimento preferida: + +### Opções de Configuração do Ambiente: + +#### Opção A: GitHub Codespaces (Recomendado) + +**Comece a programar em 2 minutos - sem necessidade de instalação local!** + +1. Faça fork deste repositório para sua conta GitHub + > **Nota**: Se quiser editar a configuração básica, dê uma olhada na [Configuração do Contêiner Dev](../../../.devcontainer/devcontainer.json) +2. Clique em **Code** → aba **Codespaces** → **...** → **Novo com opções...** +3. Use os padrões – isso selecionará a **configuração do Contêiner Dev**: **Ambiente de Desenvolvimento IA Generativa Java**, contêiner personalizado criado para este curso +4. Clique em **Create codespace** +5. Aguarde cerca de 2 minutos até o ambiente ficar pronto +6. Proceda para [Passo 2: Criar Token GitHub](../../../02-SetupDevEnvironment) + +Captura de tela: submenu Codespaces + +Captura de tela: Novo com opções + +Captura de tela: opções para criar codespace + + +> **Benefícios dos Codespaces**: +> - Nenhuma instalação local necessária +> - Funciona em qualquer dispositivo com navegador +> - Pré-configurado com todas as ferramentas e dependências +> - 60 horas grátis por mês para contas pessoais +> - Ambiente consistente para todos os alunos + +#### Opção B: Contêiner Dev Local + +**Para desenvolvedores que preferem desenvolvimento local com Docker** + +1. Faça fork e clone este repositório na sua máquina local + > **Nota**: Se quiser editar a configuração básica, dê uma olhada na [Configuração do Contêiner Dev](../../../.devcontainer/devcontainer.json) +2. Instale [Docker Desktop](https://www.docker.com/products/docker-desktop/) e [VS Code](https://code.visualstudio.com/) +3. Instale a [extensão Dev Containers](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers) no VS Code +4. Abra a pasta do repositório no VS Code +5. Quando solicitado, clique em **Reabrir no Contêiner** (ou use `Ctrl+Shift+P` → "Dev Containers: Reopen in Container") +6. Aguarde o contêiner ser construído e iniciado +7. Proceda para [Passo 2: Criar Token GitHub](../../../02-SetupDevEnvironment) + +Captura de tela: configuração do contêiner dev + +Captura de tela: contêiner dev construído + +#### Opção C: Use sua Instalação Local Existente + +**Para desenvolvedores com ambientes Java já existentes** + +Pré-requisitos: +- [Java 21+](https://www.oracle.com/java/technologies/javase/jdk21-archive-downloads.html) +- [Maven 3.9+](https://maven.apache.org/download.cgi) +- [VS Code](https://code.visualstudio.com) ou sua IDE preferida + +Passos: +1. Clone este repositório na sua máquina local +2. Abra o projeto na sua IDE +3. Proceda para [Passo 2: Criar Token GitHub](../../../02-SetupDevEnvironment) + +> **Dica profissional**: Se você tem uma máquina com pouca capacidade mas quer usar VS Code localmente, use GitHub Codespaces! Você pode conectar seu VS Code local a um Codespace hospedado na nuvem para aproveitar o melhor dos dois mundos. + +Captura de tela: instância local de contêiner dev criada + + +## Passo 2: Crie um Token de Acesso Pessoal do GitHub + +1. Navegue para [Configurações do GitHub](https://github.com/settings/profile) e selecione **Settings** no menu do seu perfil. +2. Na barra lateral esquerda, clique em **Developer settings** (geralmente no final). +3. Em **Personal access tokens**, clique em **Fine-grained tokens** (ou siga este [link direto](https://github.com/settings/personal-access-tokens)). +4. Clique em **Generate new token**. +5. Em "Token name", forneça um nome descritivo (ex: `GenAI-Java-Course-Token`). +6. Defina uma data de expiração (recomendado: 7 dias para melhores práticas de segurança). +7. Em "Resource owner", selecione sua conta de usuário. +8. Em "Repository access", selecione os repositórios que deseja usar com os Modelos do GitHub (ou "All repositories" se necessário). +9. Em "Account permissions", encontre **Models** e defina como **Somente leitura**. +10. Clique em **Generate token**. +11. **Copie e salve seu token agora** – você não verá ele novamente! + +> **Dica de Segurança**: Use o escopo mínimo necessário e o menor tempo de expiração viável para seus tokens de acesso. + +## Passo 3: Teste sua Configuração com o Exemplo dos Modelos do GitHub + +Quando seu ambiente de desenvolvimento estiver pronto, vamos testar a integração com os Modelos do GitHub usando nossa aplicação exemplo em [`02-SetupDevEnvironment/examples/github-models`](../../../02-SetupDevEnvironment/examples/github-models). + +1. Abra o terminal no seu ambiente de desenvolvimento. +2. Navegue para o exemplo dos Modelos do GitHub: + ```bash + cd 02-SetupDevEnvironment/examples/github-models + ``` + +3. Defina seu token GitHub como variável de ambiente: + ```bash + # macOS/Linux + export GITHUB_TOKEN=your_token_here + + # Windows (Prompt de Comando) + set GITHUB_TOKEN=your_token_here + + # Windows (PowerShell) + $env:GITHUB_TOKEN="your_token_here" + ``` + +4. Execute a aplicação: + ```bash + mvn compile exec:java -Dexec.mainClass="com.example.githubmodels.App" + ``` + +Você deverá ver uma saída semelhante a: +```text +Using model: gpt-4.1-nano +Sending request to GitHub Models... +Response: Hello World! +``` + +### Entendendo o Código Exemplo + +Primeiro, vamos entender o que acabamos de executar. O exemplo em `examples/github-models` usa o SDK Java OpenAI para conectar-se aos Modelos do GitHub: + +**O que este código faz:** +- **Conecta** aos Modelos do GitHub usando seu token de acesso pessoal +- **Envia** uma mensagem simples "Say Hello World!" para o modelo de IA +- **Recebe** e exibe a resposta da IA +- **Valida** que sua configuração está funcionando corretamente + +**Dependência Principal** (em `pom.xml`): +```xml + + com.openai + openai-java + 2.12.0 + +``` + +**Código Principal** (`App.java`): +```java +// Conectar aos Modelos do GitHub usando o SDK Java do OpenAI +OpenAIClient client = OpenAIOkHttpClient.builder() + .apiKey(pat) + .baseUrl("https://models.inference.ai.azure.com") + .build(); + +// Criar solicitação de conclusão de chat +ChatCompletionCreateParams params = ChatCompletionCreateParams.builder() + .model(modelId) + .addSystemMessage("You are a concise assistant.") + .addUserMessage("Say Hello World!") + .build(); + +// Obter resposta da IA +ChatCompletion response = client.chat().completions().create(params); +System.out.println("Response: " + response.choices().get(0).message().content().orElse("No response content")); +``` + +## Resumo + +Ótimo! Agora você tem tudo configurado: + +- Criou um Token de Acesso Pessoal do GitHub com as permissões corretas para acesso a modelos de IA +- Colocou seu ambiente de desenvolvimento Java para funcionar (seja Codespaces, contêineres dev ou local) +- Conectou-se aos Modelos do GitHub usando o SDK Java OpenAI para desenvolvimento gratuito de IA +- Testou se tudo funciona com um exemplo simples que conversa com modelos de IA + +## Próximos Passos + +[Capítulo 3: Técnicas de IA Generativa Core](../03-CoreGenerativeAITechniques/README.md) + +## Resolução de Problemas + +Está com problemas? Aqui estão problemas comuns e soluções: + +- **Token não está funcionando?** + - Certifique-se de que copiou todo o token sem espaços extras + - Verifique se o token está corretamente definido como variável de ambiente + - Confira se seu token tem as permissões corretas (Models: Somente leitura) + +- **Maven não encontrado?** + - Se estiver usando contêineres dev/Codespaces, Maven já vem pré-instalado + - Para configuração local, certifique-se de ter Java 21+ e Maven 3.9+ instalados + - Tente `mvn --version` para verificar a instalação + +- **Problemas de conexão?** + - Verifique sua conexão de internet + - Confirme que o GitHub está acessível a partir da sua rede + - Assegure-se de que não está atrás de firewall bloqueando o endpoint dos Modelos GitHub + +- **Contêiner dev não inicia?** + - Garanta que o Docker Desktop está rodando (para desenvolvimento local) + - Tente reconstruir o contêiner: `Ctrl+Shift+P` → "Dev Containers: Rebuild Container" + +- **Erros de compilação da aplicação?** + - Verifique se você está no diretório correto: `02-SetupDevEnvironment/examples/github-models` + - Tente limpar e compilar novamente: `mvn clean compile` + +> **Precisa de ajuda?**: Ainda com problemas? Abra uma issue no repositório e ajudaremos você. + +--- + + +**Aviso Legal**: +Este documento foi traduzido utilizando o serviço de tradução automática [Co-op Translator](https://github.com/Azure/co-op-translator). Embora nos esforcemos para garantir a precisão, esteja ciente de que traduções automatizadas podem conter erros ou imprecisões. O documento original em seu idioma nativo deve ser considerado a fonte autorizada. Para informações críticas, recomenda-se tradução profissional humana. Não nos responsabilizamos por quaisquer mal-entendidos ou interpretações incorretas decorrentes do uso desta tradução. + \ No newline at end of file diff --git a/translations/br/02-SetupDevEnvironment/examples/basic-chat-azure/README.md b/translations/pt-BR/02-SetupDevEnvironment/examples/basic-chat-azure/README.md similarity index 97% rename from translations/br/02-SetupDevEnvironment/examples/basic-chat-azure/README.md rename to translations/pt-BR/02-SetupDevEnvironment/examples/basic-chat-azure/README.md index 3125ade7..39169909 100644 --- a/translations/br/02-SetupDevEnvironment/examples/basic-chat-azure/README.md +++ b/translations/pt-BR/02-SetupDevEnvironment/examples/basic-chat-azure/README.md @@ -1,12 +1,3 @@ - # Chat Básico com Azure OpenAI - Exemplo Completo Este exemplo demonstra como criar uma aplicação simples em Spring Boot que se conecta ao Azure OpenAI e testa sua configuração. diff --git a/translations/br/02-SetupDevEnvironment/getting-started-azure-openai.md b/translations/pt-BR/02-SetupDevEnvironment/getting-started-azure-openai.md similarity index 96% rename from translations/br/02-SetupDevEnvironment/getting-started-azure-openai.md rename to translations/pt-BR/02-SetupDevEnvironment/getting-started-azure-openai.md index 03e01798..248c9140 100644 --- a/translations/br/02-SetupDevEnvironment/getting-started-azure-openai.md +++ b/translations/pt-BR/02-SetupDevEnvironment/getting-started-azure-openai.md @@ -1,12 +1,3 @@ - # Configurando o Ambiente de Desenvolvimento para Azure OpenAI > **Início Rápido**: Este guia é para configuração do Azure OpenAI. Para começar imediatamente com modelos gratuitos, use [Modelos do GitHub com Codespaces](./README.md#quick-start-cloud). @@ -75,7 +66,7 @@ Este guia ajudará você a configurar os modelos do Azure AI Foundry para seus a > **Nota**: Se você quiser editar a configuração básica, veja a [Configuração do Contêiner de Desenvolvimento](../../../.devcontainer/devcontainer.json) 2. No repositório que você fez fork, clique em **Code** → aba **Codespaces** 3. Clique em **...** → **Novo com opções...** -![criando um codespace com opções](../../../translated_images/br/codespaces.9945ded8ceb431a5.webp) +![criando um codespace com opções](../../../translated_images/pt-BR/codespaces.9945ded8ceb431a5.webp) 4. Selecione **Configuração do contêiner de desenvolvimento**: - **Ambiente de Desenvolvimento Java para IA Generativa** 5. Clique em **Criar codespace** diff --git a/translations/br/03-CoreGenerativeAITechniques/README.md b/translations/pt-BR/03-CoreGenerativeAITechniques/README.md similarity index 98% rename from translations/br/03-CoreGenerativeAITechniques/README.md rename to translations/pt-BR/03-CoreGenerativeAITechniques/README.md index 41d660cf..ee760b9a 100644 --- a/translations/br/03-CoreGenerativeAITechniques/README.md +++ b/translations/pt-BR/03-CoreGenerativeAITechniques/README.md @@ -1,12 +1,3 @@ - # Tutorial de Técnicas Fundamentais de IA Generativa ## Índice diff --git a/translations/br/04-PracticalSamples/README.md b/translations/pt-BR/04-PracticalSamples/README.md similarity index 94% rename from translations/br/04-PracticalSamples/README.md rename to translations/pt-BR/04-PracticalSamples/README.md index bd4c86d0..c1ffb877 100644 --- a/translations/br/04-PracticalSamples/README.md +++ b/translations/pt-BR/04-PracticalSamples/README.md @@ -1,12 +1,3 @@ - # Aplicações Práticas & Projetos ## O que Você Vai Aprender diff --git a/translations/br/04-PracticalSamples/calculator/README.md b/translations/pt-BR/04-PracticalSamples/calculator/README.md similarity index 98% rename from translations/br/04-PracticalSamples/calculator/README.md rename to translations/pt-BR/04-PracticalSamples/calculator/README.md index a37dcb08..70d4dd4e 100644 --- a/translations/br/04-PracticalSamples/calculator/README.md +++ b/translations/pt-BR/04-PracticalSamples/calculator/README.md @@ -1,12 +1,3 @@ - # Tutorial do MCP Calculator para Iniciantes ## Índice diff --git a/translations/br/04-PracticalSamples/foundrylocal/README.md b/translations/pt-BR/04-PracticalSamples/foundrylocal/README.md similarity index 98% rename from translations/br/04-PracticalSamples/foundrylocal/README.md rename to translations/pt-BR/04-PracticalSamples/foundrylocal/README.md index 4b4c0d8c..020c7d25 100644 --- a/translations/br/04-PracticalSamples/foundrylocal/README.md +++ b/translations/pt-BR/04-PracticalSamples/foundrylocal/README.md @@ -1,12 +1,3 @@ - # Tutorial Local do Foundry com Spring Boot ## Índice diff --git a/translations/br/04-PracticalSamples/petstory/README.md b/translations/pt-BR/04-PracticalSamples/petstory/README.md similarity index 98% rename from translations/br/04-PracticalSamples/petstory/README.md rename to translations/pt-BR/04-PracticalSamples/petstory/README.md index d8e180eb..a2f1f5f4 100644 --- a/translations/br/04-PracticalSamples/petstory/README.md +++ b/translations/pt-BR/04-PracticalSamples/petstory/README.md @@ -1,12 +1,3 @@ - # Tutorial do Gerador de Histórias de Pets para Iniciantes ## Índice diff --git a/translations/br/05-ResponsibleGenAI/README.md b/translations/pt-BR/05-ResponsibleGenAI/README.md similarity index 96% rename from translations/br/05-ResponsibleGenAI/README.md rename to translations/pt-BR/05-ResponsibleGenAI/README.md index caf999ac..874dfbaa 100644 --- a/translations/br/05-ResponsibleGenAI/README.md +++ b/translations/pt-BR/05-ResponsibleGenAI/README.md @@ -1,12 +1,3 @@ - # IA Generativa Responsável ## O Que Você Vai Aprender @@ -58,7 +49,7 @@ A classe `ResponsibleGithubModels` segue este fluxo: 5. Exibe os resultados mostrando quais conteúdos foram bloqueados, recusados ou permitidos 6. Testa conteúdos seguros para comparação -![Demonstração de Segurança em IA Responsável](../../../translated_images/br/responsible.e4f51a917bafa4bf.webp) +![Demonstração de Segurança em IA Responsável](../../../translated_images/pt-BR/responsible.e4f51a917bafa4bf.webp) ### Instruções de Configuração @@ -164,7 +155,7 @@ Este exemplo utiliza prompts intencionalmente problemáticos apenas para fins ed Parabéns por concluir o curso de IA Generativa para Iniciantes! -![Conclusão do Curso](../../../translated_images/br/image.73c7e2ff4a652e77.webp) +![Conclusão do Curso](../../../translated_images/pt-BR/image.73c7e2ff4a652e77.webp) **O que você realizou:** - Configurou seu ambiente de desenvolvimento diff --git a/translations/br/AGENTS.md b/translations/pt-BR/AGENTS.md similarity index 98% rename from translations/br/AGENTS.md rename to translations/pt-BR/AGENTS.md index d43d5ab3..18a014c1 100644 --- a/translations/br/AGENTS.md +++ b/translations/pt-BR/AGENTS.md @@ -1,12 +1,3 @@ - # AGENTS.md ## Visão Geral do Projeto diff --git a/translations/br/CODE_OF_CONDUCT.md b/translations/pt-BR/CODE_OF_CONDUCT.md similarity index 83% rename from translations/br/CODE_OF_CONDUCT.md rename to translations/pt-BR/CODE_OF_CONDUCT.md index e4f16f0a..9e17a7ba 100644 --- a/translations/br/CODE_OF_CONDUCT.md +++ b/translations/pt-BR/CODE_OF_CONDUCT.md @@ -1,12 +1,3 @@ - # Código de Conduta de Código Aberto da Microsoft Este projeto adotou o [Código de Conduta de Código Aberto da Microsoft](https://opensource.microsoft.com/codeofconduct/). diff --git a/translations/pt-BR/README.md b/translations/pt-BR/README.md new file mode 100644 index 00000000..8083be5e --- /dev/null +++ b/translations/pt-BR/README.md @@ -0,0 +1,139 @@ +# IA Generativa para Iniciantes - Edição Java +[![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) + +![IA Generativa para Iniciantes - Edição Java](../../translated_images/pt-BR/beg-genai-series.8b48be9951cc574c.webp) + +**Compromisso de Tempo**: O workshop inteiro pode ser realizado online sem configuração local. A configuração do ambiente leva 2 minutos, com a exploração dos exemplos demandando de 1 a 3 horas, dependendo da profundidade da exploração. + +> **Início Rápido** + +1. Faça um fork deste repositório para sua conta no GitHub +2. Clique em **Code** → aba **Codespaces** → **...** → **Novo com opções...** +3. Use as configurações padrão – isto selecionará o container de Desenvolvimento criado para este curso +4. Clique em **Criar codespace** +5. Aguarde cerca de 2 minutos para o ambiente ficar pronto +6. Vá diretamente para [O primeiro exemplo](./02-SetupDevEnvironment/README.md#step-2-create-a-github-personal-access-token) + +> **Prefere Clonar Localmente?** +> +> Este repositório inclui mais de 50 traduções de idiomas que aumentam significativamente o tamanho do download. Para clonar sem traduções, use sparse checkout: +> ```bash +> git clone --filter=blob:none --sparse https://github.com/microsoft/Generative-AI-for-beginners-java.git +> cd Generative-AI-for-beginners-java +> git sparse-checkout set --no-cone '/*' '!translations' '!translated_images' +> ``` +> Isso fornece tudo que você precisa para completar o curso com um download muito mais rápido. + + +## Suporte Multilíngue + +### Suportado via GitHub Action (Automatizado e Sempre Atualizado) + + +[Árabe](../ar/README.md) | [Bengali](../bn/README.md) | [Búlgaro](../bg/README.md) | [Birmanês (Myanmar)](../my/README.md) | [Chinês (Simplificado)](../zh-CN/README.md) | [Chinês (Tradicional, Hong Kong)](../zh-HK/README.md) | [Chinês (Tradicional, Macau)](../zh-MO/README.md) | [Chinês (Tradicional, Taiwan)](../zh-TW/README.md) | [Croata](../hr/README.md) | [Tcheco](../cs/README.md) | [Dinamarquês](../da/README.md) | [Holandês](../nl/README.md) | [Estoniano](../et/README.md) | [Finlandês](../fi/README.md) | [Francês](../fr/README.md) | [Alemão](../de/README.md) | [Grego](../el/README.md) | [Hebraico](../he/README.md) | [Hindi](../hi/README.md) | [Húngaro](../hu/README.md) | [Indonésio](../id/README.md) | [Italiano](../it/README.md) | [Japonês](../ja/README.md) | [Canarês](../kn/README.md) | [Coreano](../ko/README.md) | [Lituano](../lt/README.md) | [Malaio](../ms/README.md) | [Malaiala](../ml/README.md) | [Marati](../mr/README.md) | [Nepali](../ne/README.md) | [Pidgin Nigeriano](../pcm/README.md) | [Norueguês](../no/README.md) | [Persa (Farsi)](../fa/README.md) | [Polonês](../pl/README.md) | [Português (Brasil)](./README.md) | [Português (Portugal)](../pt-PT/README.md) | [Punjabi (Gurmukhi)](../pa/README.md) | [Romeno](../ro/README.md) | [Russo](../ru/README.md) | [Sérvio (Cirílico)](../sr/README.md) | [Eslovaco](../sk/README.md) | [Esloveno](../sl/README.md) | [Espanhol](../es/README.md) | [Suaíli](../sw/README.md) | [Sueco](../sv/README.md) | [Tagalo (Filipino)](../tl/README.md) | [Tâmil](../ta/README.md) | [Telugu](../te/README.md) | [Tailandês](../th/README.md) | [Turco](../tr/README.md) | [Ucraniano](../uk/README.md) | [Urdu](../ur/README.md) | [Vietnamita](../vi/README.md) + +> **Prefere Clonar Localmente?** + +> Este repositório inclui mais de 50 traduções de idiomas que aumentam significativamente o tamanho do download. Para clonar sem traduções, use sparse checkout: +> ```bash +> git clone --filter=blob:none --sparse https://github.com/microsoft/Generative-AI-for-beginners-java.git +> cd Generative-AI-for-beginners-java +> git sparse-checkout set --no-cone '/*' '!translations' '!translated_images' +> ``` +> Isso fornece tudo que você precisa para completar o curso com um download muito mais rápido. + + +## Estrutura do Curso & Caminho de Aprendizado + +### **Capítulo 1: Introdução à IA Generativa** +- **Conceitos Básicos**: Compreensão de Grandes Modelos de Linguagem, tokens, embeddings e capacidades da IA +- **Ecossistema de IA em Java**: Visão geral do Spring AI e SDKs OpenAI +- **Protocolo de Contexto de Modelo**: Introdução ao MCP e seu papel na comunicação de agentes de IA +- **Aplicações Práticas**: Cenários reais incluindo chatbots e geração de conteúdo +- **[→ Começar Capítulo 1](./01-IntroToGenAI/README.md)** + +### **Capítulo 2: Configuração do Ambiente de Desenvolvimento** +- **Configuração Multi-Provedor**: Configure GitHub Models, Azure OpenAI e integrações com OpenAI Java SDK +- **Spring Boot + Spring AI**: Melhores práticas para desenvolvimento empresarial de IA +- **GitHub Models**: Acesso gratuito a modelos de IA para prototipagem e aprendizado (sem necessidade de cartão de crédito) +- **Ferramentas de Desenvolvimento**: Containers Docker, VS Code e configuração GitHub Codespaces +- **[→ Começar Capítulo 2](./02-SetupDevEnvironment/README.md)** + +### **Capítulo 3: Técnicas Principais de IA Generativa** +- **Engenharia de Prompt**: Técnicas para respostas ótimas dos modelos de IA +- **Embeddings & Operações Vetoriais**: Implementar busca semântica e correspondência de similaridade +- **Geração com Recuperação (RAG)**: Combine IA com suas próprias fontes de dados +- **Chamada de Funções**: Estenda as capacidades da IA com ferramentas personalizadas e plugins +- **[→ Começar Capítulo 3](./03-CoreGenerativeAITechniques/README.md)** + +### **Capítulo 4: Aplicações Práticas & Projetos** +- **Gerador de Histórias de Animais de Estimação** (`petstory/`): Geração criativa de conteúdo com GitHub Models +- **Demo Foundry Local** (`foundrylocal/`): Integração local de modelo IA com OpenAI Java SDK +- **Serviço Calculadora MCP** (`calculator/`): Implementação básica do Protocolo de Contexto de Modelo com Spring AI +- **[→ Começar Capítulo 4](./04-PracticalSamples/README.md)** + +### **Capítulo 5: Desenvolvimento Responsável de IA** +- **Segurança em GitHub Models**: Teste filtros de conteúdo embutidos e mecanismos de segurança (bloqueios rígidos e recusas suaves) +- **Demo de IA Responsável**: Exemplo prático mostrando como sistemas modernos de segurança em IA funcionam na prática +- **Melhores Práticas**: Diretrizes essenciais para desenvolvimento e implantação ética de IA +- **[→ Começar Capítulo 5](./05-ResponsibleGenAI/README.md)** + +## Recursos Adicionais + + +### LangChain +[![LangChain4j para Iniciantes](https://img.shields.io/badge/LangChain4j%20for%20Beginners-22C55E?style=for-the-badge&&labelColor=E5E7EB&color=0553D6)](https://aka.ms/langchain4j-for-beginners) +[![LangChain.js para Iniciantes](https://img.shields.io/badge/LangChain.js%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=0553D6)](https://aka.ms/langchainjs-for-beginners?WT.mc_id=m365-94501-dwahlin) + +--- + +### Azure / Edge / MCP / Agentes +[![AZD para Iniciantes](https://img.shields.io/badge/AZD%20for%20Beginners-0078D4?style=for-the-badge&labelColor=E5E7EB&color=0078D4)](https://github.com/microsoft/AZD-for-beginners?WT.mc_id=academic-105485-koreyst) +[![Edge AI para Iniciantes](https://img.shields.io/badge/Edge%20AI%20for%20Beginners-00B8E4?style=for-the-badge&labelColor=E5E7EB&color=00B8E4)](https://github.com/microsoft/edgeai-for-beginners?WT.mc_id=academic-105485-koreyst) +[![MCP para Iniciantes](https://img.shields.io/badge/MCP%20for%20Beginners-009688?style=for-the-badge&labelColor=E5E7EB&color=009688)](https://github.com/microsoft/mcp-for-beginners?WT.mc_id=academic-105485-koreyst) +[![Agentes de IA para Iniciantes](https://img.shields.io/badge/AI%20Agents%20for%20Beginners-00C49A?style=for-the-badge&labelColor=E5E7EB&color=00C49A)](https://github.com/microsoft/ai-agents-for-beginners?WT.mc_id=academic-105485-koreyst) + +--- + +### Série IA Generativa +[![IA Generativa para Iniciantes](https://img.shields.io/badge/Generative%20AI%20for%20Beginners-8B5CF6?style=for-the-badge&labelColor=E5E7EB&color=8B5CF6)](https://github.com/microsoft/generative-ai-for-beginners?WT.mc_id=academic-105485-koreyst) +[![IA Generativa (.NET)](https://img.shields.io/badge/Generative%20AI%20(.NET)-9333EA?style=for-the-badge&labelColor=E5E7EB&color=9333EA)](https://github.com/microsoft/Generative-AI-for-beginners-dotnet?WT.mc_id=academic-105485-koreyst) +[![IA Generativa (Java)](https://img.shields.io/badge/Generative%20AI%20(Java)-C084FC?style=for-the-badge&labelColor=E5E7EB&color=C084FC)](https://github.com/microsoft/generative-ai-for-beginners-java?WT.mc_id=academic-105485-koreyst) +[![IA Generativa (JavaScript)](https://img.shields.io/badge/Generative%20AI%20(JavaScript)-E879F9?style=for-the-badge&labelColor=E5E7EB&color=E879F9)](https://github.com/microsoft/generative-ai-with-javascript?WT.mc_id=academic-105485-koreyst) + +--- + +### Aprendizado Fundamental +[![ML para Iniciantes](https://img.shields.io/badge/ML%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=22C55E)](https://aka.ms/ml-beginners?WT.mc_id=academic-105485-koreyst) +[![Ciência de Dados para Iniciantes](https://img.shields.io/badge/Data%20Science%20for%20Beginners-84CC16?style=for-the-badge&labelColor=E5E7EB&color=84CC16)](https://aka.ms/datascience-beginners?WT.mc_id=academic-105485-koreyst) +[![IA para Iniciantes](https://img.shields.io/badge/AI%20for%20Beginners-A3E635?style=for-the-badge&labelColor=E5E7EB&color=A3E635)](https://aka.ms/ai-beginners?WT.mc_id=academic-105485-koreyst) +[![Cibersegurança para Iniciantes](https://img.shields.io/badge/Cybersecurity%20for%20Beginners-F97316?style=for-the-badge&labelColor=E5E7EB&color=F97316)](https://github.com/microsoft/Security-101?WT.mc_id=academic-96948-sayoung) + +[![Desenvolvimento Web para Iniciantes](https://img.shields.io/badge/Web%20Dev%20for%20Beginners-EC4899?style=for-the-badge&labelColor=E5E7EB&color=EC4899)](https://aka.ms/webdev-beginners?WT.mc_id=academic-105485-koreyst) +[![IoT para Iniciantes](https://img.shields.io/badge/IoT%20for%20Beginners-14B8A6?style=for-the-badge&labelColor=E5E7EB&color=14B8A6)](https://aka.ms/iot-beginners?WT.mc_id=academic-105485-koreyst) +[![Desenvolvimento XR para Iniciantes](https://img.shields.io/badge/XR%20Development%20for%20Beginners-38BDF8?style=for-the-badge&labelColor=E5E7EB&color=38BDF8)](https://github.com/microsoft/xr-development-for-beginners?WT.mc_id=academic-105485-koreyst) + +--- + +### Série Copilot +[![Copilot para Programação em Par com IA](https://img.shields.io/badge/Copilot%20for%20AI%20Paired%20Programming-FACC15?style=for-the-badge&labelColor=E5E7EB&color=FACC15)](https://aka.ms/GitHubCopilotAI?WT.mc_id=academic-105485-koreyst) +[![Copilot para C#/.NET](https://img.shields.io/badge/Copilot%20for%20C%23/.NET-FBBF24?style=for-the-badge&labelColor=E5E7EB&color=FBBF24)](https://github.com/microsoft/mastering-github-copilot-for-dotnet-csharp-developers?WT.mc_id=academic-105485-koreyst) +[![Aventura Copilot](https://img.shields.io/badge/Copilot%20Adventure-FDE68A?style=for-the-badge&labelColor=E5E7EB&color=FDE68A)](https://github.com/microsoft/CopilotAdventures?WT.mc_id=academic-105485-koreyst) + + +## Obter Ajuda + +Se você ficar preso ou tiver qualquer dúvida sobre como criar aplicativos de IA, junte-se a outros aprendizes e desenvolvedores experientes nas discussões sobre MCP. É uma comunidade acolhedora onde perguntas são bem-vindas e o conhecimento é compartilhado livremente. + +[![Discord Microsoft Foundry](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) + +Se você tiver feedback sobre o produto ou encontrar erros durante o desenvolvimento, visite: + +[![Fórum de Desenvolvedores Microsoft Foundry](https://img.shields.io/badge/GitHub-Microsoft_Foundry_Developer_Forum-blue?style=for-the-badge&logo=github&color=000000&logoColor=fff)](https://aka.ms/foundry/forum) + +--- + + +**Aviso Legal**: +Este documento foi traduzido utilizando o serviço de tradução por IA [Co-op Translator](https://github.com/Azure/co-op-translator). Embora nos esforcemos para garantir a precisão, esteja ciente de que traduções automáticas podem conter erros ou imprecisões. O documento original em seu idioma nativo deve ser considerado a fonte autoritativa. Para informações críticas, recomenda-se a tradução profissional realizada por humanos. Não nos responsabilizamos por quaisquer mal-entendidos ou interpretações errôneas decorrentes do uso desta tradução. + \ No newline at end of file diff --git a/translations/br/SECURITY.md b/translations/pt-BR/SECURITY.md similarity index 94% rename from translations/br/SECURITY.md rename to translations/pt-BR/SECURITY.md index ff8fad5d..81392e38 100644 --- a/translations/br/SECURITY.md +++ b/translations/pt-BR/SECURITY.md @@ -1,12 +1,3 @@ - ## Segurança A Microsoft leva a segurança de seus produtos e serviços de software muito a sério, o que inclui todos os repositórios de código-fonte gerenciados por meio de nossas organizações no GitHub, que incluem [Microsoft](https://github.com/Microsoft), [Azure](https://github.com/Azure), [DotNet](https://github.com/dotnet), [AspNet](https://github.com/aspnet) e [Xamarin](https://github.com/xamarin). diff --git a/translations/br/SUPPORT.md b/translations/pt-BR/SUPPORT.md similarity index 83% rename from translations/br/SUPPORT.md rename to translations/pt-BR/SUPPORT.md index ab74c5d0..a53d19c1 100644 --- a/translations/br/SUPPORT.md +++ b/translations/pt-BR/SUPPORT.md @@ -1,12 +1,3 @@ - # Suporte ## Como relatar problemas e obter ajuda diff --git a/translations/pt-PT/.co-op-translator.json b/translations/pt-PT/.co-op-translator.json new file mode 100644 index 00000000..8842ba60 --- /dev/null +++ b/translations/pt-PT/.co-op-translator.json @@ -0,0 +1,92 @@ +{ + "01-IntroToGenAI/README.md": { + "original_hash": "75bfb080ca725e8a9aa9c80cae25fba1", + "translation_date": "2025-07-29T08:59:08+00:00", + "source_file": "01-IntroToGenAI/README.md", + "language_code": "pt-PT" + }, + "02-SetupDevEnvironment/README.md": { + "original_hash": "96a30d42b9751a3d4e4b20e28d29d459", + "translation_date": "2026-01-28T04:53:58+00:00", + "source_file": "02-SetupDevEnvironment/README.md", + "language_code": "pt-PT" + }, + "02-SetupDevEnvironment/examples/basic-chat-azure/README.md": { + "original_hash": "efd82efe50711d7e257eb943151d682c", + "translation_date": "2025-07-27T13:39:17+00:00", + "source_file": "02-SetupDevEnvironment/examples/basic-chat-azure/README.md", + "language_code": "pt-PT" + }, + "02-SetupDevEnvironment/getting-started-azure-openai.md": { + "original_hash": "bfdb4b4eadbee3a59ef742439f58326a", + "translation_date": "2025-07-27T13:05:34+00:00", + "source_file": "02-SetupDevEnvironment/getting-started-azure-openai.md", + "language_code": "pt-PT" + }, + "03-CoreGenerativeAITechniques/README.md": { + "original_hash": "685f55cb07de19b52a30ce6e8b6d889e", + "translation_date": "2025-08-28T22:03:35+00:00", + "source_file": "03-CoreGenerativeAITechniques/README.md", + "language_code": "pt-PT" + }, + "04-PracticalSamples/README.md": { + "original_hash": "14c0a61ecc1cd2012a9c129236dfdf71", + "translation_date": "2025-07-29T08:58:55+00:00", + "source_file": "04-PracticalSamples/README.md", + "language_code": "pt-PT" + }, + "04-PracticalSamples/calculator/README.md": { + "original_hash": "b6c16b5514d524e415a94f6097ee7d4c", + "translation_date": "2025-09-18T15:30:26+00:00", + "source_file": "04-PracticalSamples/calculator/README.md", + "language_code": "pt-PT" + }, + "04-PracticalSamples/foundrylocal/README.md": { + "original_hash": "f787307400de59adc25a1404466a35f3", + "translation_date": "2025-11-04T07:22:36+00:00", + "source_file": "04-PracticalSamples/foundrylocal/README.md", + "language_code": "pt-PT" + }, + "04-PracticalSamples/petstory/README.md": { + "original_hash": "0cbf68d605615a1e602c832a24616859", + "translation_date": "2025-07-25T11:15:20+00:00", + "source_file": "04-PracticalSamples/petstory/README.md", + "language_code": "pt-PT" + }, + "05-ResponsibleGenAI/README.md": { + "original_hash": "301c05c2f57e60a6950b8c665b8bdbba", + "translation_date": "2025-07-29T15:48:24+00:00", + "source_file": "05-ResponsibleGenAI/README.md", + "language_code": "pt-PT" + }, + "AGENTS.md": { + "original_hash": "afc90918d008cf77fd1982691f681306", + "translation_date": "2025-10-03T08:34:12+00:00", + "source_file": "AGENTS.md", + "language_code": "pt-PT" + }, + "CODE_OF_CONDUCT.md": { + "original_hash": "442b123d034f92f7c384d2bbd28f99f1", + "translation_date": "2025-07-21T15:58:53+00:00", + "source_file": "CODE_OF_CONDUCT.md", + "language_code": "pt-PT" + }, + "README.md": { + "original_hash": "125a08948d881c95628094f4dd1fbd43", + "translation_date": "2026-01-29T15:40:17+00:00", + "source_file": "README.md", + "language_code": "pt-PT" + }, + "SECURITY.md": { + "original_hash": "57f14126c1c6add76b3aef3844dfe4e3", + "translation_date": "2025-07-21T15:57:02+00:00", + "source_file": "SECURITY.md", + "language_code": "pt-PT" + }, + "SUPPORT.md": { + "original_hash": "b8ef73cc49dec68e2c885ee9df545129", + "translation_date": "2025-07-21T15:59:57+00:00", + "source_file": "SUPPORT.md", + "language_code": "pt-PT" + } +} \ No newline at end of file diff --git a/translations/pt/01-IntroToGenAI/README.md b/translations/pt-PT/01-IntroToGenAI/README.md similarity index 96% rename from translations/pt/01-IntroToGenAI/README.md rename to translations/pt-PT/01-IntroToGenAI/README.md index df4b0194..dcd1ab21 100644 --- a/translations/pt/01-IntroToGenAI/README.md +++ b/translations/pt-PT/01-IntroToGenAI/README.md @@ -1,12 +1,3 @@ - # Introdução à IA Generativa - Edição Java ## O que vais aprender @@ -44,7 +35,7 @@ Ao desenvolveres as tuas aplicações de IA em Java, vais trabalhar com **modelo Existem tipos específicos de modelos otimizados para diferentes tarefas. Por exemplo, tanto os **Modelos de Linguagem Pequenos (SLMs)** como os **Modelos de Linguagem de Grande Escala (LLMs)** podem lidar com a geração de texto, sendo que os LLMs geralmente oferecem melhor desempenho para tarefas complexas. Para tarefas relacionadas a imagens, utilizarias modelos de visão especializados ou modelos multimodais. -![Figura: Tipos de modelos de IA generativa e casos de uso.](../../../translated_images/pt/llms.225ca2b8a0d34473.webp) +![Figura: Tipos de modelos de IA generativa e casos de uso.](../../../translated_images/pt-PT/llms.225ca2b8a0d34473.webp) Claro que as respostas destes modelos nem sempre são perfeitas. Provavelmente já ouviste falar de modelos que "alucinam" ou geram informações incorretas de forma autoritária. No entanto, podes ajudar a guiar o modelo para gerar melhores respostas fornecendo instruções e contexto claros. É aqui que entra a **engenharia de prompts**. @@ -79,13 +70,13 @@ A tokenização é o processo de dividir o texto nestas unidades menores. Isto - **Embeddings**: Embeddings são representações vetoriais de tokens que capturam o significado semântico. São representações numéricas (tipicamente arrays de números de ponto flutuante) que permitem aos modelos compreender relações entre palavras e gerar respostas contextualmente relevantes. Palavras semelhantes têm embeddings semelhantes, permitindo ao modelo compreender conceitos como sinónimos e relações semânticas. -![Figura: Embeddings](../../../translated_images/pt/embedding.398e50802c0037f9.webp) +![Figura: Embeddings](../../../translated_images/pt-PT/embedding.398e50802c0037f9.webp) Em Java, podes gerar embeddings usando o OpenAI SDK ou outras bibliotecas que suportem a geração de embeddings. Estes embeddings são essenciais para tarefas como pesquisa semântica, onde queres encontrar conteúdos semelhantes com base no significado em vez de correspondências exatas de texto. - **Bases de dados vetoriais**: Bases de dados vetoriais são sistemas de armazenamento especializados otimizados para embeddings. Permitem uma pesquisa eficiente por similaridade e são cruciais para padrões de Geração Aumentada por Recuperação (RAG), onde precisas encontrar informações relevantes em grandes conjuntos de dados com base na similaridade semântica em vez de correspondências exatas. -![Figura: Arquitetura de base de dados vetorial mostrando como os embeddings são armazenados e recuperados para pesquisa por similaridade.](../../../translated_images/pt/vector.f12f114934e223df.webp) +![Figura: Arquitetura de base de dados vetorial mostrando como os embeddings são armazenados e recuperados para pesquisa por similaridade.](../../../translated_images/pt-PT/vector.f12f114934e223df.webp) > **Nota**: Neste curso, não abordaremos bases de dados vetoriais, mas achamos que vale a pena mencioná-las, pois são comumente usadas em aplicações do mundo real. @@ -93,7 +84,7 @@ A tokenização é o processo de dividir o texto nestas unidades menores. Isto Nas aplicações de IA em Java, vais usar tokens para processamento de texto, embeddings para pesquisa semântica e RAG, bases de dados vetoriais para recuperação de dados e agentes com MCP para construir sistemas inteligentes que utilizam ferramentas. -![Figura: como um prompt se torna uma resposta—tokens, vetores, pesquisa opcional RAG, raciocínio do LLM e um agente MCP num fluxo rápido.](../../../translated_images/pt/flow.f4ef62c3052d12a8.webp) +![Figura: como um prompt se torna uma resposta—tokens, vetores, pesquisa opcional RAG, raciocínio do LLM e um agente MCP num fluxo rápido.](../../../translated_images/pt-PT/flow.f4ef62c3052d12a8.webp) ### Ferramentas e bibliotecas de desenvolvimento de IA para Java diff --git a/translations/pt-PT/02-SetupDevEnvironment/README.md b/translations/pt-PT/02-SetupDevEnvironment/README.md new file mode 100644 index 00000000..812a1f07 --- /dev/null +++ b/translations/pt-PT/02-SetupDevEnvironment/README.md @@ -0,0 +1,251 @@ +# Configurar o Ambiente de Desenvolvimento para IA Generativa em Java + +> **Início Rápido**: Código na Nuvem em 2 minutos - Passe para a secção [Configuração do GitHub Codespaces](../../../02-SetupDevEnvironment) - não é necessária instalação local e usa modelos do github! + +> **Interessado no Azure OpenAI?**, veja o nosso [Guia de Configuração Azure OpenAI](getting-started-azure-openai.md) com os passos para criar um novo recurso Azure OpenAI. + +## O que Vai Aprender + +- Configurar um ambiente de desenvolvimento Java para aplicações de IA +- Escolher e configurar o seu ambiente de desenvolvimento preferido (cloud-first com Codespaces, contentor de desenvolvimento local ou configuração local completa) +- Testar a sua configuração ligando aos Modelos GitHub + +## Índice + +- [O que Vai Aprender](../../../02-SetupDevEnvironment) +- [Introdução](../../../02-SetupDevEnvironment) +- [Passo 1: Configure o Seu Ambiente de Desenvolvimento](../../../02-SetupDevEnvironment) + - [Opção A: GitHub Codespaces (Recomendado)](../../../02-SetupDevEnvironment) + - [Opção B: Contentor Dev Local](../../../02-SetupDevEnvironment) + - [Opção C: Use a Sua Instalação Local Existente](../../../02-SetupDevEnvironment) +- [Passo 2: Crie um Token de Acesso Pessoal do GitHub](../../../02-SetupDevEnvironment) +- [Passo 3: Teste a Sua Configuração](../../../02-SetupDevEnvironment) +- [Resolução de Problemas](../../../02-SetupDevEnvironment) +- [Sumário](../../../02-SetupDevEnvironment) +- [Próximos Passos](../../../02-SetupDevEnvironment) + +## Introdução + +Este capítulo irá guiá-lo na configuração de um ambiente de desenvolvimento. Usaremos os **Modelos GitHub** como nosso exemplo principal porque são gratuitos, fáceis de configurar com apenas uma conta GitHub, não requerem cartão de crédito e fornecem acesso a múltiplos modelos para experimentação. + +**Não é necessária configuração local!** Pode começar a programar imediatamente usando o GitHub Codespaces, que fornece um ambiente de desenvolvimento completo no seu navegador. + +Screenshot: GitHub Models + +Recomendamos o uso dos [**Modelos GitHub**](https://github.com/marketplace?type=models) para este curso porque são: +- **Grátis** para começar +- **Fáceis** de configurar com apenas uma conta GitHub +- **Não requerem cartão de crédito** +- **Múltiplos modelos** disponíveis para experimentação + +> **Nota**: Os Modelos GitHub usados neste treino têm os seguintes limites gratuitos: +> - 15 pedidos por minuto (150 por dia) +> - ~8.000 palavras de entrada, ~4.000 palavras de saída por pedido +> - 5 pedidos simultâneos +> +> Para utilização em produção, atualize para os Modelos Azure AI Foundry com a sua conta Azure. O seu código não precisa de mudar. Veja a [documentação Azure AI Foundry](https://learn.microsoft.com/azure/ai-foundry/foundry-models/how-to/quickstart-github-models). + +## Passo 1: Configure o Seu Ambiente de Desenvolvimento + + + +Criámos um contentor de desenvolvimento pré-configurado para minimizar o tempo de configuração e garantir que tem todas as ferramentas necessárias para este curso de IA Generativa para Java. Escolha a sua abordagem de desenvolvimento preferida: + +### Opções de Configuração do Ambiente: + +#### Opção A: GitHub Codespaces (Recomendado) + +**Comece a programar em 2 minutos - não é necessária configuração local!** + +1. Faça fork deste repositório para a sua conta GitHub + > **Nota**: Se desejar editar a configuração básica, veja a [Configuração do Contentor Dev](../../../.devcontainer/devcontainer.json) +2. Clique em **Code** → separador **Codespaces** → **...** → **Novo com opções...** +3. Use os valores por defeito – isto irá selecionar a **Configuração do contentor Dev**: **Ambiente de Desenvolvimento IA Generativa Java** contentor dev personalizado criado para este curso +4. Clique em **Create codespace** +5. Aguarde cerca de 2 minutos para o ambiente ficar pronto +6. Prossiga para [Passo 2: Criar Token GitHub](../../../02-SetupDevEnvironment) + +Screenshot: Codespaces submenu + +Screenshot: New with options + +Screenshot: Create codespace options + +> **Vantagens dos Codespaces**: +> - Não requer instalação local +> - Funciona em qualquer dispositivo com navegador +> - Pré-configurado com todas as ferramentas e dependências +> - 60 horas grátis por mês para contas pessoais +> - Ambiente consistente para todos os formandos + +#### Opção B: Contentor Dev Local + +**Para programadores que preferem desenvolvimento local com Docker** + +1. Faça fork e clone este repositório para a sua máquina local + > **Nota**: Se desejar editar a configuração básica, veja a [Configuração do Contentor Dev](../../../.devcontainer/devcontainer.json) +2. Instale o [Docker Desktop](https://www.docker.com/products/docker-desktop/) e o [VS Code](https://code.visualstudio.com/) +3. Instale a extensão [Dev Containers](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers) no VS Code +4. Abra a pasta do repositório no VS Code +5. Quando for indicado, clique em **Reabrir no Contentor** (ou use `Ctrl+Shift+P` → "Dev Containers: Reopen in Container") +6. Aguarde o contentor ser construído e iniciado +7. Prossiga para [Passo 2: Criar Token GitHub](../../../02-SetupDevEnvironment) + +Screenshot: Dev container setup + +Screenshot: Dev container build complete + +#### Opção C: Use a Sua Instalação Local Existente + +**Para programadores com ambientes Java existentes** + +Pré-requisitos: +- [Java 21+](https://www.oracle.com/java/technologies/javase/jdk21-archive-downloads.html) +- [Maven 3.9+](https://maven.apache.org/download.cgi) +- [VS Code](https://code.visualstudio.com) ou o seu IDE preferido + +Passos: +1. Clone este repositório para a sua máquina local +2. Abra o projeto no seu IDE +3. Prossiga para [Passo 2: Criar Token GitHub](../../../02-SetupDevEnvironment) + +> **Dica Profissional**: Se tiver uma máquina com especificações baixas mas quiser usar VS Code localmente, use GitHub Codespaces! Pode ligar o seu VS Code local a um Codespace alojado na nuvem para o melhor dos dois mundos. + +Screenshot: created local devcontainer instance + +## Passo 2: Crie um Token de Acesso Pessoal do GitHub + +1. Navegue para as [Definições GitHub](https://github.com/settings/profile) e selecione **Settings** no menu do seu perfil. +2. Na barra lateral esquerda, clique em **Developer settings** (geralmente em baixo). +3. Em **Personal access tokens**, clique em **Fine-grained tokens** (ou siga este [link direto](https://github.com/settings/personal-access-tokens)). +4. Clique em **Generate new token**. +5. Em "Token name", forneça um nome descritivo (ex.: `GenAI-Java-Course-Token`). +6. Defina uma data de expiração (recomendado: 7 dias para melhores práticas de segurança). +7. Em "Resource owner", selecione a sua conta de utilizador. +8. Em "Repository access", selecione os repositórios que quer usar com os Modelos GitHub (ou "All repositories" se necessário). +9. Em "Account permissions", encontre **Models** e defina para **Read-only**. +10. Clique em **Generate token**. +11. **Copie e guarde o seu token agora** – não o verá novamente! + +> **Dica de Segurança**: Use o escopo mínimo requerido e o menor tempo prático de expiração para os seus tokens de acesso. + +## Passo 3: Teste a Sua Configuração com o Exemplo dos Modelos GitHub + +Uma vez que o seu ambiente de desenvolvimento esteja pronto, vamos testar a integração dos Modelos GitHub com o nosso exemplo de aplicação em [`02-SetupDevEnvironment/examples/github-models`](../../../02-SetupDevEnvironment/examples/github-models). + +1. Abra o terminal no seu ambiente de desenvolvimento. +2. Navegue até ao exemplo dos Modelos GitHub: + ```bash + cd 02-SetupDevEnvironment/examples/github-models + ``` +3. Defina o seu token GitHub como variável de ambiente: + ```bash + # macOS/Linux + export GITHUB_TOKEN=your_token_here + + # Windows (Prompt de Comando) + set GITHUB_TOKEN=your_token_here + + # Windows (PowerShell) + $env:GITHUB_TOKEN="your_token_here" + ``` + +4. Execute a aplicação: + ```bash + mvn compile exec:java -Dexec.mainClass="com.example.githubmodels.App" + ``` + +Deve ver uma saída semelhante a: +```text +Using model: gpt-4.1-nano +Sending request to GitHub Models... +Response: Hello World! +``` + +### Compreender o Código de Exemplo + +Primeiro, vamos compreender o que acabámos de executar. O exemplo em `examples/github-models` usa o OpenAI Java SDK para se ligar aos Modelos GitHub: + +**O que este código faz:** +- **Liga-se** aos Modelos GitHub usando o seu token de acesso pessoal +- **Envia** uma mensagem simples "Say Hello World!" para o modelo de IA +- **Recebe** e mostra a resposta da IA +- **Valida** que a sua configuração está a funcionar corretamente + +**Dependência Principal** (em `pom.xml`): +```xml + + com.openai + openai-java + 2.12.0 + +``` + +**Código Principal** (`App.java`): +```java +// Ligar aos Modelos do GitHub usando o SDK Java da OpenAI +OpenAIClient client = OpenAIOkHttpClient.builder() + .apiKey(pat) + .baseUrl("https://models.inference.ai.azure.com") + .build(); + +// Criar pedido de completamento de chat +ChatCompletionCreateParams params = ChatCompletionCreateParams.builder() + .model(modelId) + .addSystemMessage("You are a concise assistant.") + .addUserMessage("Say Hello World!") + .build(); + +// Obter resposta da IA +ChatCompletion response = client.chat().completions().create(params); +System.out.println("Response: " + response.choices().get(0).message().content().orElse("No response content")); +``` + +## Sumário + +Ótimo! Agora tem tudo configurado: + +- Criou um Token de Acesso Pessoal do GitHub com as permissões certas para acesso ao modelo de IA +- Tem o seu ambiente de desenvolvimento Java a funcionar (seja Codespaces, contentores dev ou local) +- Ligou-se aos Modelos GitHub usando o OpenAI Java SDK para desenvolvimento IA grátis +- Testou que tudo funciona com um exemplo simples que comunica com modelos de IA + +## Próximos Passos + +[Capítulo 3: Técnicas Básicas de IA Generativa](../03-CoreGenerativeAITechniques/README.md) + +## Resolução de Problemas + +Está a ter problemas? Aqui estão problemas comuns e soluções: + +- **Token não funciona?** + - Certifique-se que copiou o token completo sem espaços extras + - Verifique que o token está configurado corretamente como variável de ambiente + - Confirme que o token tem as permissões corretas (Models: Read-only) + +- **Maven não encontrado?** + - Se usar contentores dev/Codespaces, o Maven deve estar pré-instalado + - Para configuração local, assegure que o Java 21+ e Maven 3.9+ estão instalados + - Tente `mvn --version` para verificar a instalação + +- **Problemas de ligação?** + - Verifique a sua ligação à internet + - Confirme que o GitHub é acessível a partir da sua rede + - Assegure que não está atrás de um firewall que bloqueie o endpoint dos Modelos GitHub + +- **O contentor dev não inicia?** + - Certifique-se que o Docker Desktop está a funcionar (para desenvolvimento local) + - Tente reconstruir o contentor: `Ctrl+Shift+P` → "Dev Containers: Rebuild Container" + +- **Erros na compilação da aplicação?** + - Assegure-se que está na diretoria correta: `02-SetupDevEnvironment/examples/github-models` + - Tente limpar e reconstruir: `mvn clean compile` + +> **Precisa de ajuda?**: Continua com problemas? Abra uma issue no repositório e ajudaremos. + +--- + + +**Aviso Legal**: +Este documento foi traduzido utilizando o serviço de tradução automática [Co-op Translator](https://github.com/Azure/co-op-translator). Embora nos esforcemos pela precisão, por favor tenha em conta que traduções automatizadas podem conter erros ou imprecisões. O documento original na sua língua nativa deve ser considerado a fonte autorizada. Para informações críticas, recomenda-se a tradução profissional humana. Não nos responsabilizamos por quaisquer mal-entendidos ou interpretações incorretas decorrentes do uso desta tradução. + \ No newline at end of file diff --git a/translations/pt/02-SetupDevEnvironment/examples/basic-chat-azure/README.md b/translations/pt-PT/02-SetupDevEnvironment/examples/basic-chat-azure/README.md similarity index 97% rename from translations/pt/02-SetupDevEnvironment/examples/basic-chat-azure/README.md rename to translations/pt-PT/02-SetupDevEnvironment/examples/basic-chat-azure/README.md index 05e19de8..31fa658b 100644 --- a/translations/pt/02-SetupDevEnvironment/examples/basic-chat-azure/README.md +++ b/translations/pt-PT/02-SetupDevEnvironment/examples/basic-chat-azure/README.md @@ -1,12 +1,3 @@ - # Chat Básico com Azure OpenAI - Exemplo Completo Este exemplo demonstra como criar uma aplicação simples em Spring Boot que se conecta ao Azure OpenAI e testa a sua configuração. diff --git a/translations/pt/02-SetupDevEnvironment/getting-started-azure-openai.md b/translations/pt-PT/02-SetupDevEnvironment/getting-started-azure-openai.md similarity index 96% rename from translations/pt/02-SetupDevEnvironment/getting-started-azure-openai.md rename to translations/pt-PT/02-SetupDevEnvironment/getting-started-azure-openai.md index a7c2a392..2853141a 100644 --- a/translations/pt/02-SetupDevEnvironment/getting-started-azure-openai.md +++ b/translations/pt-PT/02-SetupDevEnvironment/getting-started-azure-openai.md @@ -1,12 +1,3 @@ - # Configurar o Ambiente de Desenvolvimento para Azure OpenAI > **Início Rápido**: Este guia é para configuração do Azure OpenAI. Para começar imediatamente com modelos gratuitos, utilize [Modelos GitHub com Codespaces](./README.md#quick-start-cloud). @@ -75,7 +66,7 @@ Este guia irá ajudá-lo a configurar os modelos do Azure AI Foundry para as sua > **Nota**: Se quiser editar a configuração básica, consulte a [Configuração do Container de Desenvolvimento](../../../.devcontainer/devcontainer.json). 2. No seu repositório com fork, clique em **Code** → separador **Codespaces**. 3. Clique em **...** → **Novo com opções...** -![criar um codespace com opções](../../../translated_images/pt/codespaces.9945ded8ceb431a5.webp) +![criar um codespace com opções](../../../translated_images/pt-PT/codespaces.9945ded8ceb431a5.webp) 4. Selecione **Configuração do container de desenvolvimento**: - **Ambiente de Desenvolvimento Java para IA Generativa** 5. Clique em **Criar codespace**. diff --git a/translations/pt/03-CoreGenerativeAITechniques/README.md b/translations/pt-PT/03-CoreGenerativeAITechniques/README.md similarity index 98% rename from translations/pt/03-CoreGenerativeAITechniques/README.md rename to translations/pt-PT/03-CoreGenerativeAITechniques/README.md index b0cb4378..d47b2dc4 100644 --- a/translations/pt/03-CoreGenerativeAITechniques/README.md +++ b/translations/pt-PT/03-CoreGenerativeAITechniques/README.md @@ -1,12 +1,3 @@ - # Tutorial de Técnicas Fundamentais de IA Generativa ## Índice diff --git a/translations/pt/04-PracticalSamples/README.md b/translations/pt-PT/04-PracticalSamples/README.md similarity index 94% rename from translations/pt/04-PracticalSamples/README.md rename to translations/pt-PT/04-PracticalSamples/README.md index 698a95d7..6fe6869d 100644 --- a/translations/pt/04-PracticalSamples/README.md +++ b/translations/pt-PT/04-PracticalSamples/README.md @@ -1,12 +1,3 @@ - # Aplicações Práticas & Projetos ## O Que Vais Aprender diff --git a/translations/pt/04-PracticalSamples/calculator/README.md b/translations/pt-PT/04-PracticalSamples/calculator/README.md similarity index 98% rename from translations/pt/04-PracticalSamples/calculator/README.md rename to translations/pt-PT/04-PracticalSamples/calculator/README.md index 7af91e84..ed9ae187 100644 --- a/translations/pt/04-PracticalSamples/calculator/README.md +++ b/translations/pt-PT/04-PracticalSamples/calculator/README.md @@ -1,12 +1,3 @@ - # Tutorial do MCP Calculator para Iniciantes ## Índice diff --git a/translations/pt/04-PracticalSamples/foundrylocal/README.md b/translations/pt-PT/04-PracticalSamples/foundrylocal/README.md similarity index 98% rename from translations/pt/04-PracticalSamples/foundrylocal/README.md rename to translations/pt-PT/04-PracticalSamples/foundrylocal/README.md index 7377be25..3c1e29e5 100644 --- a/translations/pt/04-PracticalSamples/foundrylocal/README.md +++ b/translations/pt-PT/04-PracticalSamples/foundrylocal/README.md @@ -1,12 +1,3 @@ - # Tutorial Local do Foundry com Spring Boot ## Índice diff --git a/translations/pt/04-PracticalSamples/petstory/README.md b/translations/pt-PT/04-PracticalSamples/petstory/README.md similarity index 98% rename from translations/pt/04-PracticalSamples/petstory/README.md rename to translations/pt-PT/04-PracticalSamples/petstory/README.md index c3acc05b..a96fb8cc 100644 --- a/translations/pt/04-PracticalSamples/petstory/README.md +++ b/translations/pt-PT/04-PracticalSamples/petstory/README.md @@ -1,12 +1,3 @@ - # Tutorial do Gerador de Histórias de Animais de Estimação para Iniciantes ## Índice diff --git a/translations/pt/05-ResponsibleGenAI/README.md b/translations/pt-PT/05-ResponsibleGenAI/README.md similarity index 96% rename from translations/pt/05-ResponsibleGenAI/README.md rename to translations/pt-PT/05-ResponsibleGenAI/README.md index 23a7bee6..af0cb859 100644 --- a/translations/pt/05-ResponsibleGenAI/README.md +++ b/translations/pt-PT/05-ResponsibleGenAI/README.md @@ -1,12 +1,3 @@ - # IA Generativa Responsável ## O Que Vai Aprender @@ -58,7 +49,7 @@ A classe `ResponsibleGithubModels` segue este fluxo: 5. Exibe os resultados mostrando qual conteúdo foi bloqueado, recusado ou permitido 6. Testa conteúdo seguro para comparação -![Demonstração de Segurança em IA Responsável](../../../translated_images/pt/responsible.e4f51a917bafa4bf.webp) +![Demonstração de Segurança em IA Responsável](../../../translated_images/pt-PT/responsible.e4f51a917bafa4bf.webp) ### Instruções de Configuração @@ -164,7 +155,7 @@ Este exemplo utiliza prompts intencionalmente problemáticos apenas para fins ed Parabéns por concluir o curso de IA Generativa para Iniciantes! -![Conclusão do Curso](../../../translated_images/pt/image.73c7e2ff4a652e77.webp) +![Conclusão do Curso](../../../translated_images/pt-PT/image.73c7e2ff4a652e77.webp) **O que alcançou:** - Configurou o seu ambiente de desenvolvimento diff --git a/translations/pt/AGENTS.md b/translations/pt-PT/AGENTS.md similarity index 98% rename from translations/pt/AGENTS.md rename to translations/pt-PT/AGENTS.md index 2ee243be..153978e1 100644 --- a/translations/pt/AGENTS.md +++ b/translations/pt-PT/AGENTS.md @@ -1,12 +1,3 @@ - # AGENTS.md ## Visão Geral do Projeto diff --git a/translations/pt/CODE_OF_CONDUCT.md b/translations/pt-PT/CODE_OF_CONDUCT.md similarity index 83% rename from translations/pt/CODE_OF_CONDUCT.md rename to translations/pt-PT/CODE_OF_CONDUCT.md index cbd048b4..d822c633 100644 --- a/translations/pt/CODE_OF_CONDUCT.md +++ b/translations/pt-PT/CODE_OF_CONDUCT.md @@ -1,12 +1,3 @@ - # Código de Conduta de Código Aberto da Microsoft Este projeto adotou o [Código de Conduta de Código Aberto da Microsoft](https://opensource.microsoft.com/codeofconduct/). diff --git a/translations/pt-PT/README.md b/translations/pt-PT/README.md new file mode 100644 index 00000000..f8ac7fd4 --- /dev/null +++ b/translations/pt-PT/README.md @@ -0,0 +1,139 @@ +# Generative AI para Iniciantes - Edição Java +[![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) + +![Generative AI para Iniciantes - Edição Java](../../translated_images/pt-PT/beg-genai-series.8b48be9951cc574c.webp) + +**Compromisso de Tempo**: O workshop completo pode ser realizado online sem necessidade de configuração local. A configuração do ambiente demora 2 minutos, explorando os exemplos requer entre 1 a 3 horas dependendo da profundidade da exploração. + +> **Início Rápido** + +1. Faça um fork deste repositório para a sua conta GitHub +2. Clique em **Code** → separador **Codespaces** → **...** → **Novo com opções...** +3. Utilize as opções pré-definidas – isto selecionará o contentor de Desenvolvimento criado para este curso +4. Clique em **Criar codespace** +5. Aguarde cerca de 2 minutos para o ambiente estar pronto +6. Vá diretamente para [O primeiro exemplo](./02-SetupDevEnvironment/README.md#step-2-create-a-github-personal-access-token) + +> **Prefere Clonar Localmente?** +> +> Este repositório inclui mais de 50 traduções de idiomas que aumentam significativamente o tamanho do download. Para clonar sem traduções, use o sparse checkout: +> ```bash +> git clone --filter=blob:none --sparse https://github.com/microsoft/Generative-AI-for-beginners-java.git +> cd Generative-AI-for-beginners-java +> git sparse-checkout set --no-cone '/*' '!translations' '!translated_images' +> ``` +> Isto oferece tudo o que necessita para completar o curso com um download muito mais rápido. + + +## Suporte Multilíngue + +### Suportado via GitHub Action (Automatizado e Sempre Atualizado) + + +[Árabe](../ar/README.md) | [Bengali](../bn/README.md) | [Búlgaro](../bg/README.md) | [Birmanês (Myanmar)](../my/README.md) | [Chinês (Simplificado)](../zh-CN/README.md) | [Chinês (Tradicional, Hong Kong)](../zh-HK/README.md) | [Chinês (Tradicional, Macau)](../zh-MO/README.md) | [Chinês (Tradicional, Taiwan)](../zh-TW/README.md) | [Croata](../hr/README.md) | [Checo](../cs/README.md) | [Dinamarquês](../da/README.md) | [Holandês](../nl/README.md) | [Estónio](../et/README.md) | [Finlandês](../fi/README.md) | [Francês](../fr/README.md) | [Alemão](../de/README.md) | [Grego](../el/README.md) | [Hebraico](../he/README.md) | [Hindi](../hi/README.md) | [Húngaro](../hu/README.md) | [Indonésio](../id/README.md) | [Italiano](../it/README.md) | [Japonês](../ja/README.md) | [Kannada](../kn/README.md) | [Coreano](../ko/README.md) | [Lituano](../lt/README.md) | [Malaio](../ms/README.md) | [Malaiala](../ml/README.md) | [Marata](../mr/README.md) | [Nepalês](../ne/README.md) | [Pidgin Nigeriano](../pcm/README.md) | [Norueguês](../no/README.md) | [Persa (Farsi)](../fa/README.md) | [Polaco](../pl/README.md) | [Português (Brasil)](../pt-BR/README.md) | [Português (Portugal)](./README.md) | [Punjabi (Gurmukhi)](../pa/README.md) | [Romeno](../ro/README.md) | [Russo](../ru/README.md) | [Sérvio (Cirílico)](../sr/README.md) | [Eslovaco](../sk/README.md) | [Esloveno](../sl/README.md) | [Espanhol](../es/README.md) | [Suaíli](../sw/README.md) | [Sueco](../sv/README.md) | [Tagalo (Filipino)](../tl/README.md) | [Tâmil](../ta/README.md) | [Telugu](../te/README.md) | [Tailandês](../th/README.md) | [Turco](../tr/README.md) | [Ucraniano](../uk/README.md) | [Urdu](../ur/README.md) | [Vietnamita](../vi/README.md) + +> **Prefere Clonar Localmente?** + +> Este repositório inclui mais de 50 traduções de idiomas que aumentam significativamente o tamanho do download. Para clonar sem traduções, use o sparse checkout: +> ```bash +> git clone --filter=blob:none --sparse https://github.com/microsoft/Generative-AI-for-beginners-java.git +> cd Generative-AI-for-beginners-java +> git sparse-checkout set --no-cone '/*' '!translations' '!translated_images' +> ``` +> Isto oferece tudo o que necessita para completar o curso com um download muito mais rápido. + + +## Estrutura do Curso & Caminho de Aprendizagem + +### **Capítulo 1: Introdução à IA Generativa** +- **Conceitos Básicos**: Compreensão dos Grandes Modelos de Linguagem, tokens, embeddings e capacidades da IA +- **Ecossistema Java AI**: Visão geral dos SDKs Spring AI e OpenAI +- **Protocolo de Contexto do Modelo**: Introdução ao MCP e seu papel na comunicação de agentes de IA +- **Aplicações Práticas**: Cenários do mundo real incluindo chatbots e geração de conteúdo +- **[→ Começar Capítulo 1](./01-IntroToGenAI/README.md)** + +### **Capítulo 2: Configuração do Ambiente de Desenvolvimento** +- **Configuração Multi-Provedores**: Configurar GitHub Models, Azure OpenAI e OpenAI Java SDK +- **Spring Boot + Spring AI**: Boas práticas para desenvolvimento de aplicações empresariais de IA +- **GitHub Models**: Acesso gratuito a modelos de IA para prototipagem e aprendizagem (não é necessário cartão de crédito) +- **Ferramentas de Desenvolvimento**: Contentores Docker, VS Code e configuração de GitHub Codespaces +- **[→ Começar Capítulo 2](./02-SetupDevEnvironment/README.md)** + +### **Capítulo 3: Técnicas Centrais de IA Generativa** +- **Engenharia de Prompt**: Técnicas para respostas ótimas dos modelos de IA +- **Embeddings & Operações Vetoriais**: Aplicar pesquisa semântica e correspondência de similaridade +- **Geração Aumentada por Recuperação (RAG)**: Combinar IA com as suas próprias fontes de dados +- **Chamada de Função**: Expandir as capacidades da IA com ferramentas e plugins personalizados +- **[→ Começar Capítulo 3](./03-CoreGenerativeAITechniques/README.md)** + +### **Capítulo 4: Aplicações Práticas & Projetos** +- **Gerador de Histórias de Animais de Estimação** (`petstory/`): Geração criativa de conteúdo com GitHub Models +- **Demo Local Foundry** (`foundrylocal/`): Integração local de modelos IA com OpenAI Java SDK +- **Serviço Calculadora MCP** (`calculator/`): Implementação básica do Protocolo de Contexto do Modelo com Spring AI +- **[→ Começar Capítulo 4](./04-PracticalSamples/README.md)** + +### **Capítulo 5: Desenvolvimento Responsável de IA** +- **Segurança em GitHub Models**: Testar filtros de conteúdo incorporados e mecanismos de segurança (bloqueios rígidos e recusas suaves) +- **Demo de IA Responsável**: Exemplo prático mostrando como os sistemas modernos de segurança de IA funcionam na prática +- **Melhores Práticas**: Diretrizes essenciais para desenvolvimento e implementação ética de IA +- **[→ Começar Capítulo 5](./05-ResponsibleGenAI/README.md)** + +## Recursos Adicionais + + +### LangChain +[![LangChain4j para Iniciantes](https://img.shields.io/badge/LangChain4j%20for%20Beginners-22C55E?style=for-the-badge&&labelColor=E5E7EB&color=0553D6)](https://aka.ms/langchain4j-for-beginners) +[![LangChain.js para Iniciantes](https://img.shields.io/badge/LangChain.js%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=0553D6)](https://aka.ms/langchainjs-for-beginners?WT.mc_id=m365-94501-dwahlin) + +--- + +### Azure / Edge / MCP / Agentes +[![AZD para Iniciantes](https://img.shields.io/badge/AZD%20for%20Beginners-0078D4?style=for-the-badge&labelColor=E5E7EB&color=0078D4)](https://github.com/microsoft/AZD-for-beginners?WT.mc_id=academic-105485-koreyst) +[![Edge AI para Iniciantes](https://img.shields.io/badge/Edge%20AI%20for%20Beginners-00B8E4?style=for-the-badge&labelColor=E5E7EB&color=00B8E4)](https://github.com/microsoft/edgeai-for-beginners?WT.mc_id=academic-105485-koreyst) +[![MCP para Iniciantes](https://img.shields.io/badge/MCP%20for%20Beginners-009688?style=for-the-badge&labelColor=E5E7EB&color=009688)](https://github.com/microsoft/mcp-for-beginners?WT.mc_id=academic-105485-koreyst) +[![Agentes de IA para Iniciantes](https://img.shields.io/badge/AI%20Agents%20for%20Beginners-00C49A?style=for-the-badge&labelColor=E5E7EB&color=00C49A)](https://github.com/microsoft/ai-agents-for-beginners?WT.mc_id=academic-105485-koreyst) + +--- + +### Série de IA Generativa +[![Generative AI para Iniciantes](https://img.shields.io/badge/Generative%20AI%20for%20Beginners-8B5CF6?style=for-the-badge&labelColor=E5E7EB&color=8B5CF6)](https://github.com/microsoft/generative-ai-for-beginners?WT.mc_id=academic-105485-koreyst) +[![Generative AI (.NET)](https://img.shields.io/badge/Generative%20AI%20(.NET)-9333EA?style=for-the-badge&labelColor=E5E7EB&color=9333EA)](https://github.com/microsoft/Generative-AI-for-beginners-dotnet?WT.mc_id=academic-105485-koreyst) +[![Generative AI (Java)](https://img.shields.io/badge/Generative%20AI%20(Java)-C084FC?style=for-the-badge&labelColor=E5E7EB&color=C084FC)](https://github.com/microsoft/generative-ai-for-beginners-java?WT.mc_id=academic-105485-koreyst) +[![Generative AI (JavaScript)](https://img.shields.io/badge/Generative%20AI%20(JavaScript)-E879F9?style=for-the-badge&labelColor=E5E7EB&color=E879F9)](https://github.com/microsoft/generative-ai-with-javascript?WT.mc_id=academic-105485-koreyst) + +--- + +### Aprendizagem Base +[![ML para Iniciantes](https://img.shields.io/badge/ML%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=22C55E)](https://aka.ms/ml-beginners?WT.mc_id=academic-105485-koreyst) +[![Ciência de Dados para Iniciantes](https://img.shields.io/badge/Data%20Science%20for%20Beginners-84CC16?style=for-the-badge&labelColor=E5E7EB&color=84CC16)](https://aka.ms/datascience-beginners?WT.mc_id=academic-105485-koreyst) +[![IA para Iniciantes](https://img.shields.io/badge/AI%20for%20Beginners-A3E635?style=for-the-badge&labelColor=E5E7EB&color=A3E635)](https://aka.ms/ai-beginners?WT.mc_id=academic-105485-koreyst) +[![Cibersegurança para Iniciantes](https://img.shields.io/badge/Cybersecurity%20for%20Beginners-F97316?style=for-the-badge&labelColor=E5E7EB&color=F97316)](https://github.com/microsoft/Security-101?WT.mc_id=academic-96948-sayoung) + +[![Web Dev para Iniciantes](https://img.shields.io/badge/Web%20Dev%20for%20Beginners-EC4899?style=for-the-badge&labelColor=E5E7EB&color=EC4899)](https://aka.ms/webdev-beginners?WT.mc_id=academic-105485-koreyst) +[![IoT para Iniciantes](https://img.shields.io/badge/IoT%20for%20Beginners-14B8A6?style=for-the-badge&labelColor=E5E7EB&color=14B8A6)](https://aka.ms/iot-beginners?WT.mc_id=academic-105485-koreyst) +[![Desenvolvimento XR para Iniciantes](https://img.shields.io/badge/XR%20Development%20for%20Beginners-38BDF8?style=for-the-badge&labelColor=E5E7EB&color=38BDF8)](https://github.com/microsoft/xr-development-for-beginners?WT.mc_id=academic-105485-koreyst) + +--- + +### Série Copilot +[![Copilot para Programação Emparelhada com IA](https://img.shields.io/badge/Copilot%20for%20AI%20Paired%20Programming-FACC15?style=for-the-badge&labelColor=E5E7EB&color=FACC15)](https://aka.ms/GitHubCopilotAI?WT.mc_id=academic-105485-koreyst) +[![Copilot para C#/.NET](https://img.shields.io/badge/Copilot%20for%20C%23/.NET-FBBF24?style=for-the-badge&labelColor=E5E7EB&color=FBBF24)](https://github.com/microsoft/mastering-github-copilot-for-dotnet-csharp-developers?WT.mc_id=academic-105485-koreyst) +[![Aventura Copilot](https://img.shields.io/badge/Copilot%20Adventure-FDE68A?style=for-the-badge&labelColor=E5E7EB&color=FDE68A)](https://github.com/microsoft/CopilotAdventures?WT.mc_id=academic-105485-koreyst) + + +## Obter Ajuda + +Se ficar bloqueado ou tiver alguma questão sobre desenvolver aplicações de IA, junte-se a outros aprendizes e desenvolvedores experientes nas discussões sobre MCP. É uma comunidade solidária onde as perguntas são bem-vindas e o conhecimento é partilhado gratuitamente. + +[![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) + +Se tiver feedback sobre produto ou erros durante o desenvolvimento visite: + +[![Microsoft Foundry Developer Forum](https://img.shields.io/badge/GitHub-Microsoft_Foundry_Developer_Forum-blue?style=for-the-badge&logo=github&color=000000&logoColor=fff)](https://aka.ms/foundry/forum) + +--- + + +**Aviso Legal**: +Este documento foi traduzido utilizando o serviço de tradução automática [Co-op Translator](https://github.com/Azure/co-op-translator). Embora nos esforcemos por garantir a precisão, por favor tenha em conta que traduções automáticas podem conter erros ou imprecisões. O documento original no seu idioma nativo deverá ser considerado a fonte autorizada. Para informações críticas, recomenda-se a tradução profissional humana. Não nos responsabilizamos por quaisquer mal-entendidos ou interpretações erradas decorrentes do uso desta tradução. + \ No newline at end of file diff --git a/translations/pt/SECURITY.md b/translations/pt-PT/SECURITY.md similarity index 94% rename from translations/pt/SECURITY.md rename to translations/pt-PT/SECURITY.md index 3e02f864..3c8d6330 100644 --- a/translations/pt/SECURITY.md +++ b/translations/pt-PT/SECURITY.md @@ -1,12 +1,3 @@ - ## Segurança A Microsoft leva a segurança dos seus produtos de software e serviços muito a sério, incluindo todos os repositórios de código fonte geridos através das nossas organizações no GitHub, que incluem [Microsoft](https://github.com/Microsoft), [Azure](https://github.com/Azure), [DotNet](https://github.com/dotnet), [AspNet](https://github.com/aspnet) e [Xamarin](https://github.com/xamarin). diff --git a/translations/pt/SUPPORT.md b/translations/pt-PT/SUPPORT.md similarity index 83% rename from translations/pt/SUPPORT.md rename to translations/pt-PT/SUPPORT.md index 94eef43c..14a6955d 100644 --- a/translations/pt/SUPPORT.md +++ b/translations/pt-PT/SUPPORT.md @@ -1,12 +1,3 @@ - # Suporte ## Como reportar problemas e obter ajuda diff --git a/translations/pt/02-SetupDevEnvironment/README.md b/translations/pt/02-SetupDevEnvironment/README.md deleted file mode 100644 index 804ed2d4..00000000 --- a/translations/pt/02-SetupDevEnvironment/README.md +++ /dev/null @@ -1,13 +0,0 @@ - - - ---- - diff --git a/translations/pt/README.md b/translations/pt/README.md deleted file mode 100644 index 4208c3fa..00000000 --- a/translations/pt/README.md +++ /dev/null @@ -1,147 +0,0 @@ - -# Inteligência Artificial Generativa para Iniciantes - Edição Java -[![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) - -![Inteligência Artificial Generativa para Iniciantes - Edição Java](../../translated_images/pt/beg-genai-series.8b48be9951cc574c.webp) - -**Compromisso de Tempo**: O workshop completo pode ser realizado online sem configuração local. A configuração do ambiente leva 2 minutos, sendo que explorar os exemplos requer 1-3 horas, dependendo da profundidade da exploração. - -> **Início Rápido** - -1. Crie um fork deste repositório para a sua conta GitHub -2. Clique em **Code** → separador **Codespaces** → **...** → **Novo com opções...** -3. Utilize as predefinições – isto selecionará o contentor de Desenvolvimento criado para este curso -4. Clique em **Create codespace** -5. Aguarde cerca de 2 minutos para o ambiente estar pronto -6. Vá diretamente para [O primeiro exemplo](./02-SetupDevEnvironment/README.md#step-2-create-a-github-personal-access-token) - -> **Prefere Clonar Localmente?** -> -> Este repositório inclui mais de 50 traduções para idiomas, o que aumenta significativamente o tamanho do download. Para clonar sem traduções, use sparse checkout: -> ```bash -> git clone --filter=blob:none --sparse https://github.com/microsoft/Generative-AI-for-beginners-java.git -> cd Generative-AI-for-beginners-java -> git sparse-checkout set --no-cone '/*' '!translations' '!translated_images' -> ``` -> Isto dá-lhe tudo o que precisa para completar o curso com um download muito mais rápido. - - -## Suporte Multilíngue - -### Suportado via GitHub Action (Automatizado e Sempre Atualizado) - - -[Árabe](../ar/README.md) | [Bengali](../bn/README.md) | [Búlgaro](../bg/README.md) | [Birmanês (Myanmar)](../my/README.md) | [Chinês (Simplificado)](../zh/README.md) | [Chinês (Tradicional, Hong Kong)](../hk/README.md) | [Chinês (Tradicional, Macau)](../mo/README.md) | [Chinês (Tradicional, Taiwan)](../tw/README.md) | [Croata](../hr/README.md) | [Checo](../cs/README.md) | [Dinamarquês](../da/README.md) | [Holandês](../nl/README.md) | [Estónio](../et/README.md) | [Finlandês](../fi/README.md) | [Francês](../fr/README.md) | [Alemão](../de/README.md) | [Grego](../el/README.md) | [Hebraico](../he/README.md) | [Hindi](../hi/README.md) | [Húngaro](../hu/README.md) | [Indonésio](../id/README.md) | [Italiano](../it/README.md) | [Japonês](../ja/README.md) | [Kannada](../kn/README.md) | [Coreano](../ko/README.md) | [Lituano](../lt/README.md) | [Malaio](../ms/README.md) | [Malaiala](../ml/README.md) | [Marati](../mr/README.md) | [Nepali](../ne/README.md) | [Pidgin Nigeriano](../pcm/README.md) | [Norueguês](../no/README.md) | [Persa (Farsi)](../fa/README.md) | [Polaco](../pl/README.md) | [Português (Brasil)](../br/README.md) | [Português (Portugal)](./README.md) | [Punjabi (Gurmukhi)](../pa/README.md) | [Romeno](../ro/README.md) | [Russo](../ru/README.md) | [Sérvio (Cirílico)](../sr/README.md) | [Eslovaco](../sk/README.md) | [Esloveno](../sl/README.md) | [Espanhol](../es/README.md) | [Suaíli](../sw/README.md) | [Sueco](../sv/README.md) | [Tagalog (Filipino)](../tl/README.md) | [Tamil](../ta/README.md) | [Telugu](../te/README.md) | [Tailandês](../th/README.md) | [Turco](../tr/README.md) | [Ucraniano](../uk/README.md) | [Urdu](../ur/README.md) | [Vietnamita](../vi/README.md) - -> **Prefere Clonar Localmente?** - -> Este repositório inclui mais de 50 traduções para idiomas, o que aumenta significativamente o tamanho do download. Para clonar sem traduções, use sparse checkout: -> ```bash -> git clone --filter=blob:none --sparse https://github.com/microsoft/Generative-AI-for-beginners-java.git -> cd Generative-AI-for-beginners-java -> git sparse-checkout set --no-cone '/*' '!translations' '!translated_images' -> ``` -> Isto dá-lhe tudo o que precisa para completar o curso com um download muito mais rápido. - - -## Estrutura do Curso & Roteiro de Aprendizagem - -### **Capítulo 1: Introdução à Inteligência Artificial Generativa** -- **Conceitos Fundamentais**: Compreender Grandes Modelos de Linguagem, tokens, embeddings, e capacidades da IA -- **Ecossistema Java AI**: Visão geral dos SDKs Spring AI e OpenAI -- **Protocolo de Contexto de Modelo**: Introdução ao MCP e o seu papel na comunicação de agentes IA -- **Aplicações Práticas**: Cenários do mundo real incluindo chatbots e geração de conteúdo -- **[→ Começar Capítulo 1](./01-IntroToGenAI/README.md)** - -### **Capítulo 2: Configuração do Ambiente de Desenvolvimento** -- **Configuração Multi-Provedor**: Configurar GitHub Models, Azure OpenAI, e integrações do OpenAI Java SDK -- **Spring Boot + Spring AI**: Melhores práticas para desenvolvimento de aplicações empresariais com IA -- **GitHub Models**: Acesso gratuito a modelos de IA para prototipagem e aprendizagem (não requer cartão de crédito) -- **Ferramentas de Desenvolvimento**: Contentores Docker, VS Code, e configuração GitHub Codespaces -- **[→ Começar Capítulo 2](./02-SetupDevEnvironment/README.md)** - -### **Capítulo 3: Técnicas Essenciais de Inteligência Artificial Generativa** -- **Engenharia de Prompt**: Técnicas para respostas ótimas dos modelos de IA -- **Embeddings & Operações com Vetores**: Implementar pesquisa semântica e comparação de similaridade -- **Geração Recuperada Aumentada (RAG)**: Combinar IA com as suas próprias fontes de dados -- **Chamada de Funções**: Estender as capacidades da IA com ferramentas e plugins personalizados -- **[→ Começar Capítulo 3](./03-CoreGenerativeAITechniques/README.md)** - -### **Capítulo 4: Aplicações Práticas & Projetos** -- **Gerador de Histórias de Animais** (`petstory/`): Geração criativa de conteúdos com GitHub Models -- **Demonstração Foundry Local** (`foundrylocal/`): Integração local de modelos IA com OpenAI Java SDK -- **Serviço Calculadora MCP** (`calculator/`): Implementação básica do Protocolo de Contexto de Modelo com Spring AI -- **[→ Começar Capítulo 4](./04-PracticalSamples/README.md)** - -### **Capítulo 5: Desenvolvimento Responsável de IA** -- **Segurança em GitHub Models**: Testar filtragem de conteúdo incluída e mecanismos de segurança (bloqueios rígidos e recusas suaves) -- **Demonstração de IA Responsável**: Exemplo prático de como funcionam sistemas modernos de segurança em IA -- **Melhores Práticas**: Diretrizes essenciais para desenvolvimento e implementação ética de IA -- **[→ Começar Capítulo 5](./05-ResponsibleGenAI/README.md)** - -## Recursos Adicionais - - -### LangChain -[![LangChain4j para Iniciantes](https://img.shields.io/badge/LangChain4j%20for%20Beginners-22C55E?style=for-the-badge&&labelColor=E5E7EB&color=0553D6)](https://aka.ms/langchain4j-for-beginners) -[![LangChain.js para Iniciantes](https://img.shields.io/badge/LangChain.js%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=0553D6)](https://aka.ms/langchainjs-for-beginners?WT.mc_id=m365-94501-dwahlin) - ---- - -### Azure / Edge / MCP / Agentes -[![AZD para Iniciantes](https://img.shields.io/badge/AZD%20for%20Beginners-0078D4?style=for-the-badge&labelColor=E5E7EB&color=0078D4)](https://github.com/microsoft/AZD-for-beginners?WT.mc_id=academic-105485-koreyst) -[![Edge AI para Iniciantes](https://img.shields.io/badge/Edge%20AI%20for%20Beginners-00B8E4?style=for-the-badge&labelColor=E5E7EB&color=00B8E4)](https://github.com/microsoft/edgeai-for-beginners?WT.mc_id=academic-105485-koreyst) -[![MCP para Iniciantes](https://img.shields.io/badge/MCP%20for%20Beginners-009688?style=for-the-badge&labelColor=E5E7EB&color=009688)](https://github.com/microsoft/mcp-for-beginners?WT.mc_id=academic-105485-koreyst) -[![Agentes de IA para Iniciantes](https://img.shields.io/badge/AI%20Agents%20for%20Beginners-00C49A?style=for-the-badge&labelColor=E5E7EB&color=00C49A)](https://github.com/microsoft/ai-agents-for-beginners?WT.mc_id=academic-105485-koreyst) - ---- - -### Série Inteligência Artificial Generativa -[![Inteligência Artificial Generativa para Iniciantes](https://img.shields.io/badge/Generative%20AI%20for%20Beginners-8B5CF6?style=for-the-badge&labelColor=E5E7EB&color=8B5CF6)](https://github.com/microsoft/generative-ai-for-beginners?WT.mc_id=academic-105485-koreyst) -[![Inteligência Artificial Generativa (.NET)](https://img.shields.io/badge/Generative%20AI%20(.NET)-9333EA?style=for-the-badge&labelColor=E5E7EB&color=9333EA)](https://github.com/microsoft/Generative-AI-for-beginners-dotnet?WT.mc_id=academic-105485-koreyst) -[![Inteligência Artificial Generativa (Java)](https://img.shields.io/badge/Generative%20AI%20(Java)-C084FC?style=for-the-badge&labelColor=E5E7EB&color=C084FC)](https://github.com/microsoft/generative-ai-for-beginners-java?WT.mc_id=academic-105485-koreyst) -[![Inteligência Artificial Generativa (JavaScript)](https://img.shields.io/badge/Generative%20AI%20(JavaScript)-E879F9?style=for-the-badge&labelColor=E5E7EB&color=E879F9)](https://github.com/microsoft/generative-ai-with-javascript?WT.mc_id=academic-105485-koreyst) - ---- - -### Aprendizagem Fundamental -[![Aprendizagem Máquina para Iniciantes](https://img.shields.io/badge/ML%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=22C55E)](https://aka.ms/ml-beginners?WT.mc_id=academic-105485-koreyst) -[![Ciência de Dados para Iniciantes](https://img.shields.io/badge/Data%20Science%20for%20Beginners-84CC16?style=for-the-badge&labelColor=E5E7EB&color=84CC16)](https://aka.ms/datascience-beginners?WT.mc_id=academic-105485-koreyst) -[![IA para Iniciantes](https://img.shields.io/badge/AI%20for%20Beginners-A3E635?style=for-the-badge&labelColor=E5E7EB&color=A3E635)](https://aka.ms/ai-beginners?WT.mc_id=academic-105485-koreyst) -[![Cibersegurança para Iniciantes](https://img.shields.io/badge/Cybersecurity%20for%20Beginners-F97316?style=for-the-badge&labelColor=E5E7EB&color=F97316)](https://github.com/microsoft/Security-101?WT.mc_id=academic-96948-sayoung) -[![Desenvolvimento Web para Iniciantes](https://img.shields.io/badge/Web%20Dev%20for%20Beginners-EC4899?style=for-the-badge&labelColor=E5E7EB&color=EC4899)](https://aka.ms/webdev-beginners?WT.mc_id=academic-105485-koreyst) -[![IoT para Iniciantes](https://img.shields.io/badge/IoT%20for%20Beginners-14B8A6?style=for-the-badge&labelColor=E5E7EB&color=14B8A6)](https://aka.ms/iot-beginners?WT.mc_id=academic-105485-koreyst) -[![Desenvolvimento XR para Iniciantes](https://img.shields.io/badge/XR%20Development%20for%20Beginners-38BDF8?style=for-the-badge&labelColor=E5E7EB&color=38BDF8)](https://github.com/microsoft/xr-development-for-beginners?WT.mc_id=academic-105485-koreyst) - ---- - -### Série Copilot -[![Copilot para Programação em Par com IA](https://img.shields.io/badge/Copilot%20for%20AI%20Paired%20Programming-FACC15?style=for-the-badge&labelColor=E5E7EB&color=FACC15)](https://aka.ms/GitHubCopilotAI?WT.mc_id=academic-105485-koreyst) -[![Copilot para C#/.NET](https://img.shields.io/badge/Copilot%20for%20C%23/.NET-FBBF24?style=for-the-badge&labelColor=E5E7EB&color=FBBF24)](https://github.com/microsoft/mastering-github-copilot-for-dotnet-csharp-developers?WT.mc_id=academic-105485-koreyst) -[![Aventura Copilot](https://img.shields.io/badge/Copilot%20Adventure-FDE68A?style=for-the-badge&labelColor=E5E7EB&color=FDE68A)](https://github.com/microsoft/CopilotAdventures?WT.mc_id=academic-105485-koreyst) - - -## Obter Ajuda - -Se ficar bloqueado ou tiver alguma dúvida sobre como criar aplicações de IA. Junte-se a outros aprendizes e programadores experientes nas discussões sobre MCP. É uma comunidade de apoio onde as perguntas são bem-vindas e o conhecimento é partilhado livremente. - -[![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) - -Se tiver feedback sobre produtos ou erros durante a construção, visite: - -[![Microsoft Foundry Developer Forum](https://img.shields.io/badge/GitHub-Microsoft_Foundry_Developer_Forum-blue?style=for-the-badge&logo=github&color=000000&logoColor=fff)](https://aka.ms/foundry/forum) - ---- - - -**Aviso Legal**: -Este documento foi traduzido utilizando o serviço de tradução automática [Co-op Translator](https://github.com/Azure/co-op-translator). Embora nos esforcemos por garantir a precisão, tenha em atenção que traduções automáticas podem conter erros ou imprecisões. O documento original na sua língua nativa deve ser considerado a fonte autorizada. Para informações críticas, recomenda-se a tradução profissional humana. Não nos responsabilizamos por quaisquer mal-entendidos ou interpretações erradas decorrentes do uso desta tradução. - \ No newline at end of file diff --git a/translations/ro/.co-op-translator.json b/translations/ro/.co-op-translator.json new file mode 100644 index 00000000..c7c299b1 --- /dev/null +++ b/translations/ro/.co-op-translator.json @@ -0,0 +1,92 @@ +{ + "01-IntroToGenAI/README.md": { + "original_hash": "75bfb080ca725e8a9aa9c80cae25fba1", + "translation_date": "2025-07-29T10:09:48+00:00", + "source_file": "01-IntroToGenAI/README.md", + "language_code": "ro" + }, + "02-SetupDevEnvironment/README.md": { + "original_hash": "96a30d42b9751a3d4e4b20e28d29d459", + "translation_date": "2026-01-28T05:22:13+00:00", + "source_file": "02-SetupDevEnvironment/README.md", + "language_code": "ro" + }, + "02-SetupDevEnvironment/examples/basic-chat-azure/README.md": { + "original_hash": "efd82efe50711d7e257eb943151d682c", + "translation_date": "2025-07-27T13:47:01+00:00", + "source_file": "02-SetupDevEnvironment/examples/basic-chat-azure/README.md", + "language_code": "ro" + }, + "02-SetupDevEnvironment/getting-started-azure-openai.md": { + "original_hash": "bfdb4b4eadbee3a59ef742439f58326a", + "translation_date": "2025-07-27T13:25:57+00:00", + "source_file": "02-SetupDevEnvironment/getting-started-azure-openai.md", + "language_code": "ro" + }, + "03-CoreGenerativeAITechniques/README.md": { + "original_hash": "685f55cb07de19b52a30ce6e8b6d889e", + "translation_date": "2025-08-28T22:16:18+00:00", + "source_file": "03-CoreGenerativeAITechniques/README.md", + "language_code": "ro" + }, + "04-PracticalSamples/README.md": { + "original_hash": "14c0a61ecc1cd2012a9c129236dfdf71", + "translation_date": "2025-07-29T10:09:34+00:00", + "source_file": "04-PracticalSamples/README.md", + "language_code": "ro" + }, + "04-PracticalSamples/calculator/README.md": { + "original_hash": "b6c16b5514d524e415a94f6097ee7d4c", + "translation_date": "2025-09-18T15:40:09+00:00", + "source_file": "04-PracticalSamples/calculator/README.md", + "language_code": "ro" + }, + "04-PracticalSamples/foundrylocal/README.md": { + "original_hash": "f787307400de59adc25a1404466a35f3", + "translation_date": "2025-11-04T07:34:06+00:00", + "source_file": "04-PracticalSamples/foundrylocal/README.md", + "language_code": "ro" + }, + "04-PracticalSamples/petstory/README.md": { + "original_hash": "0cbf68d605615a1e602c832a24616859", + "translation_date": "2025-07-25T11:57:31+00:00", + "source_file": "04-PracticalSamples/petstory/README.md", + "language_code": "ro" + }, + "05-ResponsibleGenAI/README.md": { + "original_hash": "301c05c2f57e60a6950b8c665b8bdbba", + "translation_date": "2025-07-29T15:58:56+00:00", + "source_file": "05-ResponsibleGenAI/README.md", + "language_code": "ro" + }, + "AGENTS.md": { + "original_hash": "afc90918d008cf77fd1982691f681306", + "translation_date": "2025-10-03T08:43:14+00:00", + "source_file": "AGENTS.md", + "language_code": "ro" + }, + "CODE_OF_CONDUCT.md": { + "original_hash": "442b123d034f92f7c384d2bbd28f99f1", + "translation_date": "2025-07-21T20:37:38+00:00", + "source_file": "CODE_OF_CONDUCT.md", + "language_code": "ro" + }, + "README.md": { + "original_hash": "125a08948d881c95628094f4dd1fbd43", + "translation_date": "2026-01-29T16:11:06+00:00", + "source_file": "README.md", + "language_code": "ro" + }, + "SECURITY.md": { + "original_hash": "57f14126c1c6add76b3aef3844dfe4e3", + "translation_date": "2025-07-21T20:35:36+00:00", + "source_file": "SECURITY.md", + "language_code": "ro" + }, + "SUPPORT.md": { + "original_hash": "b8ef73cc49dec68e2c885ee9df545129", + "translation_date": "2025-07-21T20:38:55+00:00", + "source_file": "SUPPORT.md", + "language_code": "ro" + } +} \ No newline at end of file diff --git a/translations/ro/01-IntroToGenAI/README.md b/translations/ro/01-IntroToGenAI/README.md index 81f1d0fe..5612288b 100644 --- a/translations/ro/01-IntroToGenAI/README.md +++ b/translations/ro/01-IntroToGenAI/README.md @@ -1,12 +1,3 @@ - # Introducere în AI Generativ - Ediția Java ## Ce vei învăța diff --git a/translations/ro/02-SetupDevEnvironment/README.md b/translations/ro/02-SetupDevEnvironment/README.md index cd3f6f5f..19c47c45 100644 --- a/translations/ro/02-SetupDevEnvironment/README.md +++ b/translations/ro/02-SetupDevEnvironment/README.md @@ -1,13 +1,251 @@ - +# Configurarea mediului de dezvoltare pentru Generative AI pentru Java +> **Început rapid**: Codifică în cloud în 2 minute - Sari la [Configurarea GitHub Codespaces](../../../02-SetupDevEnvironment) - nu este necesară nicio instalare locală și folosește modelele GitHub! + +> **Interesat de Azure OpenAI?**, vezi [Ghidul nostru de configurare Azure OpenAI](getting-started-azure-openai.md) cu pașii pentru a crea o nouă resursă Azure OpenAI. + +## Ce vei învăța + +- Configurarea unui mediu de dezvoltare Java pentru aplicații AI +- Alegerea și configurarea mediului de dezvoltare preferat (cloud-first cu Codespaces, container de dezvoltare local sau configurare locală completă) +- Testarea configurației conectându-te la GitHub Models + +## Cuprins + +- [Ce vei învăța](../../../02-SetupDevEnvironment) +- [Introducere](../../../02-SetupDevEnvironment) +- [Pasul 1: Configurarea mediului de dezvoltare](../../../02-SetupDevEnvironment) + - [Opțiunea A: GitHub Codespaces (Recomandat)](../../../02-SetupDevEnvironment) + - [Opțiunea B: Container de dezvoltare local](../../../02-SetupDevEnvironment) + - [Opțiunea C: Folosește-ți instalarea locală existentă](../../../02-SetupDevEnvironment) +- [Pasul 2: Creează un token personal de acces GitHub](../../../02-SetupDevEnvironment) +- [Pasul 3: Testează configurația ta](../../../02-SetupDevEnvironment) +- [Depanare](../../../02-SetupDevEnvironment) +- [Rezumat](../../../02-SetupDevEnvironment) +- [Pașii următori](../../../02-SetupDevEnvironment) + +## Introducere + +Acest capitol te va ghida prin configurarea unui mediu de dezvoltare. Vom folosi **GitHub Models** ca exemplu principal deoarece este gratuit, ușor de configurat cu un cont GitHub, nu necesită card de credit și oferă acces la mai multe modele pentru experimentare. + +**Nu este necesară configurarea locală!** Poți începe codarea imediat folosind GitHub Codespaces, care oferă un mediu complet de dezvoltare în browserul tău. + +Captură de ecran: GitHub Models + +Recomandăm folosirea [**GitHub Models**](https://github.com/marketplace?type=models) pentru acest curs pentru că este: +- **Gratuit** pentru a începe +- **Ușor** de configurat doar cu un cont GitHub +- **Fără card de credit** necesar +- **Mai multe modele** disponibile pentru experimentare + +> **Notă**: Modelele GitHub folosite în acest training au aceste limite gratuite: +> - 15 cereri pe minut (150 pe zi) +> - ~8.000 de cuvinte intrare, ~4.000 cuvinte ieșire per cerere +> - 5 cereri concurente +> +> Pentru utilizare în producție, treceți la Azure AI Foundry Models cu contul Azure. Codul tău nu trebuie să se schimbe. Vezi [documentația Azure AI Foundry](https://learn.microsoft.com/azure/ai-foundry/foundry-models/how-to/quickstart-github-models). + +## Pasul 1: Configurarea mediului de dezvoltare + + + +Am creat un container de dezvoltare preconfigurat pentru a minimiza timpul de configurare și pentru a asigura că ai toate uneltele necesare pentru acest curs Generative AI pentru Java. Alege abordarea de dezvoltare preferată: + +### Opțiuni pentru configurarea mediului: + +#### Opțiunea A: GitHub Codespaces (Recomandat) + +**Începe să codezi în 2 minute - fără configurare locală!** + +1. Fă fork la acest depozit în contul tău GitHub + > **Notă**: Dacă vrei să modifici configurația de bază, vezi [Configurația containerului de dezvoltare](../../../.devcontainer/devcontainer.json) +2. Click pe **Code** → fila **Codespaces** → **...** → **New with options...** +3. Lasă setările implicite – va selecta **Configurarea containerului de dezvoltare**: **Generative AI Java Development Environment**, un devcontainer personalizat creat pentru acest curs +4. Click pe **Create codespace** +5. Așteaptă ~2 minute până când mediul este pregătit +6. Continuă la [Pasul 2: Creează token-ul GitHub](../../../02-SetupDevEnvironment) + +Captură de ecran: submeniul Codespaces + +Captură de ecran: New with options + +Captură de ecran: Opțiuni creare codespace + +> **Beneficiile Codespaces**: +> - Nu necesită instalare locală +> - Funcționează pe orice dispozitiv cu browser +> - Preconfigurat cu toate uneltele și dependențele +> - Gratuit 60 de ore pe lună pentru conturi personale +> - Mediu consistent pentru toți cursanții + +#### Opțiunea B: Container de dezvoltare local + +**Pentru dezvoltatori care preferă dezvoltarea locală cu Docker** + +1. Fă fork și clonează acest depozit pe mașina ta locală + > **Notă**: Dacă vrei să modifici configurația de bază, vezi [Configurația containerului de dezvoltare](../../../.devcontainer/devcontainer.json) +2. Instalează [Docker Desktop](https://www.docker.com/products/docker-desktop/) și [VS Code](https://code.visualstudio.com/) +3. Instalează extensia [Dev Containers](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers) în VS Code +4. Deschide folderul depozitului în VS Code +5. Când ți se cere, click pe **Reopen in Container** (sau folosește `Ctrl+Shift+P` → "Dev Containers: Reopen in Container") +6. Așteaptă să se construiască și să pornească containerul +7. Continuă la [Pasul 2: Creează token-ul GitHub](../../../02-SetupDevEnvironment) + +Captură de ecran: configurare container de dezvoltare + +Captură de ecran: construire container dezvolare completă + +#### Opțiunea C: Folosește-ți instalarea locală existentă + +**Pentru dezvoltatori cu medii Java existente** + +Precondiții: +- [Java 21+](https://www.oracle.com/java/technologies/javase/jdk21-archive-downloads.html) +- [Maven 3.9+](https://maven.apache.org/download.cgi) +- [VS Code](https://code.visualstudio.com) sau IDE-ul preferat + +Pași: +1. Clonează acest depozit pe mașina ta locală +2. Deschide proiectul în IDE-ul tău +3. Continuă la [Pasul 2: Creează token-ul GitHub](../../../02-SetupDevEnvironment) + +> **Sfat Pro**: Dacă ai o mașină cu specificații reduse dar vrei VS Code local, folosește GitHub Codespaces! Poți conecta VS Code local la un Codespace găzduit în cloud pentru a avea ce e mai bun din ambele lumi. + +Captură de ecran: instanță locală creată de devcontainer + +## Pasul 2: Creează un token personal de acces GitHub + +1. Accesează [Setările GitHub](https://github.com/settings/profile) și selectează **Settings** din meniul profilului tău. +2. În bara laterală stângă, click pe **Developer settings** (de regulă în partea de jos). +3. Sub **Personal access tokens**, click pe **Fine-grained tokens** (sau urmează acest [link direct](https://github.com/settings/personal-access-tokens)). +4. Click pe **Generate new token**. +5. Sub "Token name", oferă un nume descriptiv (de ex., `GenAI-Java-Course-Token`). +6. Setează o dată de expirare (recomandat: 7 zile pentru bune practici de securitate). +7. Sub "Resource owner", selectează contul tău de utilizator. +8. Sub "Repository access", selectează depozitele pe care vrei să le folosești cu GitHub Models (sau "All repositories" dacă este necesar). +9. Sub "Account permissions", găsește **Models** și setează pe **Read-only**. +10. Click pe **Generate token**. +11. **Copiază și salvează token-ul acum** – nu îl vei mai vedea din nou! + +> **Sfaturi de securitate**: Folosește cel mai mic nivel necesar de permisiuni și cea mai scurtă expirare practică pentru token-urile tale de acces. + +## Pasul 3: Testează configurația ta cu exemplul GitHub Models + +Odată ce mediul tău de dezvoltare este pregătit, hai să testăm integrarea GitHub Models cu aplicația noastră exemplu din [`02-SetupDevEnvironment/examples/github-models`](../../../02-SetupDevEnvironment/examples/github-models). + +1. Deschide terminalul în mediul tău de dezvoltare. +2. Navighează către exemplul GitHub Models: + ```bash + cd 02-SetupDevEnvironment/examples/github-models + ``` +3. Setează token-ul GitHub ca variabilă de mediu: + ```bash + # macOS/Linux + export GITHUB_TOKEN=your_token_here + + # Windows (Prompt de comandă) + set GITHUB_TOKEN=your_token_here + + # Windows (PowerShell) + $env:GITHUB_TOKEN="your_token_here" + ``` + +4. Rulează aplicația: + ```bash + mvn compile exec:java -Dexec.mainClass="com.example.githubmodels.App" + ``` + +Ar trebui să vezi o ieșire similară cu: +```text +Using model: gpt-4.1-nano +Sending request to GitHub Models... +Response: Hello World! +``` + +### Înțelegerea codului exemplu + +Mai întâi, hai să înțelegem ce am rulat. Exemplul din `examples/github-models` folosește OpenAI Java SDK pentru a se conecta la GitHub Models: + +**Ce face acest cod:** +- **Se conectează** la GitHub Models folosind token-ul tău personal de acces +- **Trimite** un mesaj simplu "Say Hello World!" către modelul AI +- **Primește** și afișează răspunsul AI +- **Verifică** că setup-ul tău funcționează corect + +**Dependența principală** (în `pom.xml`): +```xml + + com.openai + openai-java + 2.12.0 + +``` + +**Codul principal** (`App.java`): +```java +// Conectează-te la modelele GitHub folosind OpenAI Java SDK +OpenAIClient client = OpenAIOkHttpClient.builder() + .apiKey(pat) + .baseUrl("https://models.inference.ai.azure.com") + .build(); + +// Creează cererea de completare chat +ChatCompletionCreateParams params = ChatCompletionCreateParams.builder() + .model(modelId) + .addSystemMessage("You are a concise assistant.") + .addUserMessage("Say Hello World!") + .build(); + +// Obține răspunsul AI +ChatCompletion response = client.chat().completions().create(params); +System.out.println("Response: " + response.choices().get(0).message().content().orElse("No response content")); +``` + +## Rezumat + +Excelent! Ai totul acum configurat: + +- Ai creat un token personal de acces GitHub cu permisiunile corecte pentru acces AI +- Mediul tău de dezvoltare Java funcționează (fie că este Codespaces, container de dezvoltare sau local) +- Te-ai conectat la GitHub Models folosind OpenAI Java SDK pentru dezvoltare AI gratuită +- Ai testat că totul funcționează cu un exemplu simplu care comunică cu modelele AI + +## Pașii următori + +[Capitolul 3: Tehnici de bază Generative AI](../03-CoreGenerativeAITechniques/README.md) + +## Depanare + +Ai probleme? Iată probleme comune și soluții: + +- **Tokenul nu funcționează?** + - Asigură-te că ai copiat token-ul complet fără spații în plus + - Verifică dacă token-ul este setat corect ca variabilă de mediu + - Verifică dacă token-ul are permisiunile corecte (Models: Read-only) + +- **Maven nu este găsit?** + - Dacă folosești containere dev/Codespaces, Maven ar trebui să fie preinstalat + - Pentru configurare locală, asigură-te că Java 21+ și Maven 3.9+ sunt instalate + - Încearcă `mvn --version` pentru a verifica instalarea + +- **Probleme de conexiune?** + - Verifică conexiunea la internet + - Asigură-te că GitHub este accesibil din rețeaua ta + - Verifică dacă nu ești în spatele unui firewall care blochează endpoint-ul GitHub Models + +- **Containerul dev nu pornește?** + - Asigură-te că Docker Desktop rulează (pentru dezvoltare locală) + - Încearcă să refaci containerul: `Ctrl+Shift+P` → "Dev Containers: Rebuild Container" + +- **Eroare la compilarea aplicației?** + - Asigură-te că ești în directorul corect: `02-SetupDevEnvironment/examples/github-models` + - Încearcă să cureți și să reconstruiești: `mvn clean compile` + +> **Ai nevoie de ajutor?**: Dacă încă întâmpini probleme, deschide un issue în depozit și te vom ajuta. --- + +**Declinare de responsabilitate**: +Acest document a fost tradus folosind serviciul de traducere automată AI [Co-op Translator](https://github.com/Azure/co-op-translator). Deși ne străduim pentru acuratețe, vă rugăm să țineți cont că traducerile automatizate pot conține erori sau inexactități. Documentul original, în limba sa nativă, ar trebui considerat sursa de autoritate. Pentru informații critice, se recomandă traducerea profesională realizată de un specialist uman. Nu ne asumăm răspunderea pentru eventualele neînțelegeri sau interpretări eronate rezultate din utilizarea acestei traduceri. + \ No newline at end of file diff --git a/translations/ro/02-SetupDevEnvironment/examples/basic-chat-azure/README.md b/translations/ro/02-SetupDevEnvironment/examples/basic-chat-azure/README.md index 39af31ec..6abc9d4b 100644 --- a/translations/ro/02-SetupDevEnvironment/examples/basic-chat-azure/README.md +++ b/translations/ro/02-SetupDevEnvironment/examples/basic-chat-azure/README.md @@ -1,12 +1,3 @@ - # Chat de bază cu Azure OpenAI - Exemplu complet Acest exemplu demonstrează cum să creezi o aplicație simplă Spring Boot care se conectează la Azure OpenAI și testează configurația ta. diff --git a/translations/ro/02-SetupDevEnvironment/getting-started-azure-openai.md b/translations/ro/02-SetupDevEnvironment/getting-started-azure-openai.md index 108b9743..9080e77c 100644 --- a/translations/ro/02-SetupDevEnvironment/getting-started-azure-openai.md +++ b/translations/ro/02-SetupDevEnvironment/getting-started-azure-openai.md @@ -1,12 +1,3 @@ - # Configurarea Mediului de Dezvoltare pentru Azure OpenAI > **Start Rapid**: Acest ghid este pentru configurarea Azure OpenAI. Pentru un început imediat cu modele gratuite, folosiți [Modele GitHub cu Codespaces](./README.md#quick-start-cloud). diff --git a/translations/ro/03-CoreGenerativeAITechniques/README.md b/translations/ro/03-CoreGenerativeAITechniques/README.md index ba39b564..a7505846 100644 --- a/translations/ro/03-CoreGenerativeAITechniques/README.md +++ b/translations/ro/03-CoreGenerativeAITechniques/README.md @@ -1,12 +1,3 @@ - # Tutorial Tehnici de Bază în AI Generativ ## Cuprins diff --git a/translations/ro/04-PracticalSamples/README.md b/translations/ro/04-PracticalSamples/README.md index 3e0a08c1..91a99bdf 100644 --- a/translations/ro/04-PracticalSamples/README.md +++ b/translations/ro/04-PracticalSamples/README.md @@ -1,12 +1,3 @@ - # Aplicații Practice și Proiecte ## Ce Vei Învăța diff --git a/translations/ro/04-PracticalSamples/calculator/README.md b/translations/ro/04-PracticalSamples/calculator/README.md index f94f22ad..2f0e54c3 100644 --- a/translations/ro/04-PracticalSamples/calculator/README.md +++ b/translations/ro/04-PracticalSamples/calculator/README.md @@ -1,12 +1,3 @@ - # Tutorial MCP Calculator pentru Începători ## Cuprins diff --git a/translations/ro/04-PracticalSamples/foundrylocal/README.md b/translations/ro/04-PracticalSamples/foundrylocal/README.md index 54633198..fa275787 100644 --- a/translations/ro/04-PracticalSamples/foundrylocal/README.md +++ b/translations/ro/04-PracticalSamples/foundrylocal/README.md @@ -1,12 +1,3 @@ - # Tutorial Local Foundry Spring Boot ## Cuprins diff --git a/translations/ro/04-PracticalSamples/petstory/README.md b/translations/ro/04-PracticalSamples/petstory/README.md index 2ee6b6c8..bdf86d77 100644 --- a/translations/ro/04-PracticalSamples/petstory/README.md +++ b/translations/ro/04-PracticalSamples/petstory/README.md @@ -1,12 +1,3 @@ - # Tutorial pentru Generatorul de Povești cu Animale de Companie pentru Începători ## Cuprins diff --git a/translations/ro/05-ResponsibleGenAI/README.md b/translations/ro/05-ResponsibleGenAI/README.md index ca0d7755..59d74040 100644 --- a/translations/ro/05-ResponsibleGenAI/README.md +++ b/translations/ro/05-ResponsibleGenAI/README.md @@ -1,12 +1,3 @@ - # Inteligență Artificială Generativă Responsabilă ## Ce Vei Învăța diff --git a/translations/ro/AGENTS.md b/translations/ro/AGENTS.md index 91e8b7d9..c85e94e0 100644 --- a/translations/ro/AGENTS.md +++ b/translations/ro/AGENTS.md @@ -1,12 +1,3 @@ - # AGENTS.md ## Prezentare Generală a Proiectului diff --git a/translations/ro/CODE_OF_CONDUCT.md b/translations/ro/CODE_OF_CONDUCT.md index 0d0de749..cb4eb2e5 100644 --- a/translations/ro/CODE_OF_CONDUCT.md +++ b/translations/ro/CODE_OF_CONDUCT.md @@ -1,12 +1,3 @@ - # Codul de Conduită pentru Proiectele Open Source Microsoft Acest proiect a adoptat [Codul de Conduită pentru Proiectele Open Source Microsoft](https://opensource.microsoft.com/codeofconduct/). diff --git a/translations/ro/README.md b/translations/ro/README.md index d2b2f13b..bccc6b90 100644 --- a/translations/ro/README.md +++ b/translations/ro/README.md @@ -1,31 +1,22 @@ - # Inteligență Artificială Generativă pentru Începători - Ediția Java [![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) ![Inteligență Artificială Generativă pentru Începători - Ediția Java](../../translated_images/ro/beg-genai-series.8b48be9951cc574c.webp) -**Timp de dedicare**: Întregul workshop poate fi finalizat online fără configurare locală. Configurarea mediului durează 2 minute, explorarea exemplelor necesitând 1-3 ore în funcție de adâncimea explorării. +**Timp estimat**: Întregul workshop poate fi finalizat online fără configurare locală. Configurarea mediului durează 2 minute, iar explorarea exemplelor necesită 1-3 ore în funcție de adâncimea explorării. -> **Pornire rapidă** +> **Pornire Rapidă** -1. Fă un fork acestui depozit în contul tău GitHub -2. Fă clic pe **Code** → fila **Codespaces** → **...** → **New with options...** -3. Folosește valorile implicite – aceasta va selecta containerul de dezvoltare creat pentru acest curs -4. Fă clic pe **Create codespace** -5. Așteaptă ~2 minute până când mediul este pregătit -6. Trece direct la [Primul exemplu](./02-SetupDevEnvironment/README.md#step-2-create-a-github-personal-access-token) +1. Fă fork la acest depozit în contul tău de GitHub +2. Apasă pe **Code** → fila **Codespaces** → **...** → **New with options...** +3. Folosește setările implicite – aceasta va selecta containerul de dezvoltare creat pentru acest curs +4. Apasă **Create codespace** +5. Așteaptă ~2 minute pentru pregătirea mediului +6. Mergi direct la [Primul exemplu](./02-SetupDevEnvironment/README.md#step-2-create-a-github-personal-access-token) -> **Preferi să clonezi local?** +> **Preferi să Clonezi Local?** > -> Acest depozit include peste 50 de traduceri în diferite limbi, ceea ce mărește semnificativ dimensiunea descărcării. Pentru a clona fără traduceri, folosește sparse checkout: +> Acest depozit include peste 50 de traduceri de limbă care cresc semnificativ dimensiunea de descărcare. Pentru a clona fără traduceri, folosește sparse checkout: > ```bash > git clone --filter=blob:none --sparse https://github.com/microsoft/Generative-AI-for-beginners-java.git > cd Generative-AI-for-beginners-java @@ -36,14 +27,14 @@ CO_OP_TRANSLATOR_METADATA: ## Suport Multilingv -### Susținut prin GitHub Action (Automatizat & Întotdeauna Actualizat) +### Susținut prin GitHub Action (Automatizat și Întotdeauna Actualizat) -[Arabă](../ar/README.md) | [Bengaleză](../bn/README.md) | [Bulgară](../bg/README.md) | [Burmese (Myanmar)](../my/README.md) | [Chineză (Simplificată)](../zh/README.md) | [Chineză (Tradițională, Hong Kong)](../hk/README.md) | [Chineză (Tradițională, Macau)](../mo/README.md) | [Chineză (Tradițională, Taiwan)](../tw/README.md) | [Croată](../hr/README.md) | [Cehă](../cs/README.md) | [Daneză](../da/README.md) | [Olandeză](../nl/README.md) | [Estonă](../et/README.md) | [Finlandeză](../fi/README.md) | [Franceză](../fr/README.md) | [Germană](../de/README.md) | [Greacă](../el/README.md) | [Ebraică](../he/README.md) | [Hindi](../hi/README.md) | [Maghiară](../hu/README.md) | [Indoneziană](../id/README.md) | [Italiană](../it/README.md) | [Japoneză](../ja/README.md) | [Kannada](../kn/README.md) | [Coreeană](../ko/README.md) | [Lituaniană](../lt/README.md) | [Malay](../ms/README.md) | [Malalam](../ml/README.md) | [Marathi](../mr/README.md) | [Nepaleză](../ne/README.md) | [Pidgin Nigerian](../pcm/README.md) | [Norvegiană](../no/README.md) | [Persană (Farsi)](../fa/README.md) | [Poloneză](../pl/README.md) | [Portugheză (Brazilia)](../br/README.md) | [Portugheză (Portugalia)](../pt/README.md) | [Punjabi (Gurmukhi)](../pa/README.md) | [Română](./README.md) | [Rusă](../ru/README.md) | [Sârbă (Chirilic)](../sr/README.md) | [Slovacă](../sk/README.md) | [Slovenă](../sl/README.md) | [Spaniolă](../es/README.md) | [Swahili](../sw/README.md) | [Suedeză](../sv/README.md) | [Tagalog (Filipineză)](../tl/README.md) | [Tamil](../ta/README.md) | [Telugu](../te/README.md) | [Thailandeză](../th/README.md) | [Turcă](../tr/README.md) | [Ucraineană](../uk/README.md) | [Urdu](../ur/README.md) | [Vietnameză](../vi/README.md) +[Arabă](../ar/README.md) | [Bengaleză](../bn/README.md) | [Bulgară](../bg/README.md) | [Burmese (Myanmar)](../my/README.md) | [Chineză (Simplificată)](../zh-CN/README.md) | [Chineză (Tradițională, Hong Kong)](../zh-HK/README.md) | [Chineză (Tradițională, Macau)](../zh-MO/README.md) | [Chineză (Tradițională, Taiwan)](../zh-TW/README.md) | [Croată](../hr/README.md) | [Cehă](../cs/README.md) | [Daneză](../da/README.md) | [Olandeză](../nl/README.md) | [Estonă](../et/README.md) | [Finlandeză](../fi/README.md) | [Franceză](../fr/README.md) | [Germană](../de/README.md) | [Greacă](../el/README.md) | [Ebraică](../he/README.md) | [Hindi](../hi/README.md) | [Maghiară](../hu/README.md) | [Indoneziană](../id/README.md) | [Italiană](../it/README.md) | [Japoneză](../ja/README.md) | [Kannada](../kn/README.md) | [Coreeană](../ko/README.md) | [Lituaniană](../lt/README.md) | [Malaysiană](../ms/README.md) | [Malayalam](../ml/README.md) | [Marathi](../mr/README.md) | [Nepaleză](../ne/README.md) | [Pidgin Nigerian](../pcm/README.md) | [Norvegiană](../no/README.md) | [Persană (Farsi)](../fa/README.md) | [Poloneză](../pl/README.md) | [Portugheză (Brazilia)](../pt-BR/README.md) | [Portugheză (Portugalia)](../pt-PT/README.md) | [Punjabi (Gurmukhi)](../pa/README.md) | [Română](./README.md) | [Rusă](../ru/README.md) | [Sârbă (Chirilică)](../sr/README.md) | [Slovacă](../sk/README.md) | [Slovenă](../sl/README.md) | [Spaniolă](../es/README.md) | [Swahili](../sw/README.md) | [Suedeză](../sv/README.md) | [Tagalog (Filipineză)](../tl/README.md) | [Tamil](../ta/README.md) | [Telugu](../te/README.md) | [Thailandeză](../th/README.md) | [Turcă](../tr/README.md) | [Ucraineană](../uk/README.md) | [Urdu](../ur/README.md) | [Vietnameză](../vi/README.md) -> **Preferi să clonezi local?** +> **Preferi să Clonezi Local?** -> Acest depozit include peste 50 de traduceri în diferite limbi, ceea ce mărește semnificativ dimensiunea descărcării. Pentru a clona fără traduceri, folosește sparse checkout: +> Acest depozit include peste 50 de traduceri de limbă care cresc semnificativ dimensiunea de descărcare. Pentru a clona fără traduceri, folosește sparse checkout: > ```bash > git clone --filter=blob:none --sparse https://github.com/microsoft/Generative-AI-for-beginners-java.git > cd Generative-AI-for-beginners-java @@ -52,42 +43,42 @@ CO_OP_TRANSLATOR_METADATA: > Acest lucru îți oferă tot ce ai nevoie pentru a finaliza cursul cu o descărcare mult mai rapidă. -## Structura Cursului și Parcursul de Învățare +## Structura Cursului & Parcursul de Învățare ### **Capitolul 1: Introducere în Inteligența Artificială Generativă** -- **Concepte de bază**: Înțelegerea modelelor lingvistice mari, a tokenilor, embedding-urilor și capacităților AI -- **Ecosistemul Java AI**: Prezentare generală a Spring AI și SDK-urilor OpenAI +- **Concepte de Bază**: Înțelegerea modelelor mari de limbaj, tokeni, embeddings și capacitățile AI +- **Ecosistemul AI în Java**: Prezentare generală a SDK-urilor Spring AI și OpenAI - **Protocolul Contextului Modelului**: Introducere în MCP și rolul său în comunicarea agenților AI -- **Aplicații practice**: Scenarii din lumea reală, incluzând chatboți și generare de conținut +- **Aplicații Practice**: Scenarii din lumea reală inclusiv chatbots și generare de conținut - **[→ Începe Capitolul 1](./01-IntroToGenAI/README.md)** ### **Capitolul 2: Configurarea Mediului de Dezvoltare** -- **Configurare multi-furnizor**: Configurarea GitHub Models, Azure OpenAI și integrarea SDK-ului OpenAI Java +- **Configurare Multi-Provider**: Setarea integrărilor GitHub Models, Azure OpenAI și OpenAI Java SDK - **Spring Boot + Spring AI**: Cele mai bune practici pentru dezvoltarea aplicațiilor AI enterprise -- **GitHub Models**: Acces gratuit la modele AI pentru prototipare și învățare (fără nevoie de card de credit) -- **Unelte de dezvoltare**: Containere Docker, VS Code și configurarea GitHub Codespaces +- **GitHub Models**: Acces gratuit la modele AI pentru prototipare și învățare (fără card de credit) +- **Instrumente de Dezvoltare**: Containere Docker, VS Code și configurarea GitHub Codespaces - **[→ Începe Capitolul 2](./02-SetupDevEnvironment/README.md)** -### **Capitolul 3: Tehnici de bază în Inteligența Artificială Generativă** -- **Ingineria promptului**: Tehnici pentru răspunsuri optime ale modelului AI -- **Embedding-uri & operațiuni vectoriale**: Implementarea căutării semantice și a potrivirii de similaritate -- **Generare augmentată prin recuperare (RAG)**: Combinarea AI cu sursele proprii de date -- **Apelarea funcțiilor**: Extinderea capabilităților AI cu unelte și plugin-uri personalizate +### **Capitolul 3: Tehnici de Bază pentru Inteligența Artificială Generativă** +- **Ingineria Prompturilor**: Tehnici pentru răspunsuri optime ale modelelor AI +- **Embeddings și Operațiuni Vectoriale**: Implementarea căutării semantice și potrivirii similitudinii +- **Retrieval-Augmented Generation (RAG)**: Combină AI cu sursele tale proprii de date +- **Apelarea Funcțiilor**: Extinde capabilitățile AI cu unelte și pluginuri personalizate - **[→ Începe Capitolul 3](./03-CoreGenerativeAITechniques/README.md)** ### **Capitolul 4: Aplicații Practice și Proiecte** -- **Generator de povestiri despre animale de companie** (`petstory/`): Generare creativă de conținut cu GitHub Models -- **Demo local Foundry** (`foundrylocal/`): Integrarea locală a modelului AI cu SDK-ul OpenAI Java -- **Serviciul calculator MCP** (`calculator/`): Implementare de bază a Protocolului Contextului Modelului cu Spring AI +- **Generator de Povestiri cu Animale de Companie** (`petstory/`): Generare creativă de conținut cu GitHub Models +- **Demo Local Foundry** (`foundrylocal/`): Integrare locală a modelului AI cu OpenAI Java SDK +- **Serviciu Calculator MCP** (`calculator/`): Implementare de bază a Protocolului Contextului Modelului cu Spring AI - **[→ Începe Capitolul 4](./04-PracticalSamples/README.md)** -### **Capitolul 5: Dezvoltarea Responsabilă a Inteligenței Artificiale** -- **Siguranța GitHub Models**: Testarea filtrării încorporate a conținutului și a mecanismelor de siguranță (blocări dure și refuzuri blânde) -- **Demo AI responsabil**: Exemplu practic care arată cum funcționează sistemele moderne de siguranță AI -- **Cele mai bune practici**: Ghiduri esențiale pentru dezvoltarea și implementarea etică a AI +### **Capitolul 5: Dezvoltare Responsabilă a AI** +- **Siguranța GitHub Models**: Testarea filtrării conținutului și a mecanismelor de siguranță integrate (blocaje dure și refuzuri soft) +- **Demo AI Responsabil**: Exemplu practic care arată cum funcționează sistemele moderne de siguranță AI +- **Cele Mai Bune Practici**: Ghiduri esențiale pentru dezvoltarea și implementarea etică a AI - **[→ Începe Capitolul 5](./05-ResponsibleGenAI/README.md)** -## Resurse suplimentare +## Resurse Suplimentare ### LangChain @@ -104,7 +95,7 @@ CO_OP_TRANSLATOR_METADATA: --- -### Seria de Inteligență Artificială Generativă +### Seria Inteligență Artificială Generativă [![Inteligență Artificială Generativă pentru Începători](https://img.shields.io/badge/Generative%20AI%20for%20Beginners-8B5CF6?style=for-the-badge&labelColor=E5E7EB&color=8B5CF6)](https://github.com/microsoft/generative-ai-for-beginners?WT.mc_id=academic-105485-koreyst) [![Inteligență Artificială Generativă (.NET)](https://img.shields.io/badge/Generative%20AI%20(.NET)-9333EA?style=for-the-badge&labelColor=E5E7EB&color=9333EA)](https://github.com/microsoft/Generative-AI-for-beginners-dotnet?WT.mc_id=academic-105485-koreyst) [![Inteligență Artificială Generativă (Java)](https://img.shields.io/badge/Generative%20AI%20(Java)-C084FC?style=for-the-badge&labelColor=E5E7EB&color=C084FC)](https://github.com/microsoft/generative-ai-for-beginners-java?WT.mc_id=academic-105485-koreyst) @@ -112,36 +103,37 @@ CO_OP_TRANSLATOR_METADATA: --- -### Învățare de bază +### Învățare de Bază [![ML pentru Începători](https://img.shields.io/badge/ML%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=22C55E)](https://aka.ms/ml-beginners?WT.mc_id=academic-105485-koreyst) [![Data Science pentru Începători](https://img.shields.io/badge/Data%20Science%20for%20Beginners-84CC16?style=for-the-badge&labelColor=E5E7EB&color=84CC16)](https://aka.ms/datascience-beginners?WT.mc_id=academic-105485-koreyst) [![AI pentru Începători](https://img.shields.io/badge/AI%20for%20Beginners-A3E635?style=for-the-badge&labelColor=E5E7EB&color=A3E635)](https://aka.ms/ai-beginners?WT.mc_id=academic-105485-koreyst) -[![Securitate cibernetică pentru Începători](https://img.shields.io/badge/Cybersecurity%20for%20Beginners-F97316?style=for-the-badge&labelColor=E5E7EB&color=F97316)](https://github.com/microsoft/Security-101?WT.mc_id=academic-96948-sayoung) -[![Dezvoltare web pentru Începători](https://img.shields.io/badge/Web%20Dev%20for%20Beginners-EC4899?style=for-the-badge&labelColor=E5E7EB&color=EC4899)](https://aka.ms/webdev-beginners?WT.mc_id=academic-105485-koreyst) +[![Securitate Cibernetică pentru Începători](https://img.shields.io/badge/Cybersecurity%20for%20Beginners-F97316?style=for-the-badge&labelColor=E5E7EB&color=F97316)](https://github.com/microsoft/Security-101?WT.mc_id=academic-96948-sayoung) + +[![Web Dev pentru Începători](https://img.shields.io/badge/Web%20Dev%20for%20Beginners-EC4899?style=for-the-badge&labelColor=E5E7EB&color=EC4899)](https://aka.ms/webdev-beginners?WT.mc_id=academic-105485-koreyst) [![IoT pentru Începători](https://img.shields.io/badge/IoT%20for%20Beginners-14B8A6?style=for-the-badge&labelColor=E5E7EB&color=14B8A6)](https://aka.ms/iot-beginners?WT.mc_id=academic-105485-koreyst) [![Dezvoltare XR pentru Începători](https://img.shields.io/badge/XR%20Development%20for%20Beginners-38BDF8?style=for-the-badge&labelColor=E5E7EB&color=38BDF8)](https://github.com/microsoft/xr-development-for-beginners?WT.mc_id=academic-105485-koreyst) --- ### Seria Copilot -[![Copilot pentru Programare în Pereche cu AI](https://img.shields.io/badge/Copilot%20for%20AI%20Paired%20Programming-FACC15?style=for-the-badge&labelColor=E5E7EB&color=FACC15)](https://aka.ms/GitHubCopilotAI?WT.mc_id=academic-105485-koreyst) +[![Copilot pentru Programare în Pereche AI](https://img.shields.io/badge/Copilot%20for%20AI%20Paired%20Programming-FACC15?style=for-the-badge&labelColor=E5E7EB&color=FACC15)](https://aka.ms/GitHubCopilotAI?WT.mc_id=academic-105485-koreyst) [![Copilot pentru C#/.NET](https://img.shields.io/badge/Copilot%20for%20C%23/.NET-FBBF24?style=for-the-badge&labelColor=E5E7EB&color=FBBF24)](https://github.com/microsoft/mastering-github-copilot-for-dotnet-csharp-developers?WT.mc_id=academic-105485-koreyst) [![Aventură Copilot](https://img.shields.io/badge/Copilot%20Adventure-FDE68A?style=for-the-badge&labelColor=E5E7EB&color=FDE68A)](https://github.com/microsoft/CopilotAdventures?WT.mc_id=academic-105485-koreyst) -## Obținerea Ajutorului +## Obținerea de Ajutor -Dacă întâmpini dificultăți sau ai întrebări despre construirea aplicațiilor AI. Alătură-te altor cursanți și dezvoltatori cu experiență în discuțiile despre MCP. Este o comunitate sprijinitoare unde întrebările sunt binevenite și cunoștințele sunt împărtășite liber. +Dacă întâmpini probleme sau ai întrebări despre construirea aplicațiilor AI. Alătură-te altor cursanți și dezvoltatori cu experiență în discuții despre MCP. Este o comunitate suportivă unde întrebările sunt binevenite și cunoștințele sunt împărtășite liber. -[![Discord Microsoft Foundry](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) +[![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) -Dacă ai feedback despre produs sau întâmpini erori în timpul dezvoltării, vizitează: +Dacă ai feedback despre produs sau erori în timpul construcției, vizitează: -[![Forumul Dezvoltatorilor Microsoft Foundry](https://img.shields.io/badge/GitHub-Microsoft_Foundry_Developer_Forum-blue?style=for-the-badge&logo=github&color=000000&logoColor=fff)](https://aka.ms/foundry/forum) +[![Microsoft Foundry Developer Forum](https://img.shields.io/badge/GitHub-Microsoft_Foundry_Developer_Forum-blue?style=for-the-badge&logo=github&color=000000&logoColor=fff)](https://aka.ms/foundry/forum) --- -**Declinare de responsabilitate**: -Acest document a fost tradus folosind serviciul de traducere AI [Co-op Translator](https://github.com/Azure/co-op-translator). Deși ne străduim pentru acuratețe, vă rugăm să rețineți că traducerile automate pot conține erori sau inexactități. Documentul original, în limba sa nativă, trebuie considerat sursa autorizată. Pentru informații critice, se recomandă o traducere profesională realizată de un specialist. Nu ne asumăm responsabilitatea pentru eventualele neînțelegeri sau interpretări greșite rezultate din utilizarea acestei traduceri. +**Declinare de responsabilitate**: +Acest document a fost tradus folosind serviciul de traducere AI [Co-op Translator](https://github.com/Azure/co-op-translator). Deși ne străduim pentru acuratețe, vă rugăm să fiți conștienți că traducerile automate pot conține erori sau inexactități. Documentul original în limba sa nativă trebuie considerat sursa autorizată. Pentru informații critice, se recomandă traducerea profesională realizată de un traducător uman. Nu ne asumăm responsabilitatea pentru eventualele neînțelegeri sau interpretări greșite rezultate din utilizarea acestei traduceri. \ No newline at end of file diff --git a/translations/ro/SECURITY.md b/translations/ro/SECURITY.md index a900ae72..5830592d 100644 --- a/translations/ro/SECURITY.md +++ b/translations/ro/SECURITY.md @@ -1,12 +1,3 @@ - ## Securitate Microsoft tratează cu maximă seriozitate securitatea produselor și serviciilor noastre software, inclusiv toate depozitele de cod sursă gestionate prin organizațiile noastre GitHub, care includ [Microsoft](https://github.com/Microsoft), [Azure](https://github.com/Azure), [DotNet](https://github.com/dotnet), [AspNet](https://github.com/aspnet) și [Xamarin](https://github.com/xamarin). diff --git a/translations/ro/SUPPORT.md b/translations/ro/SUPPORT.md index e215267e..c8b2547b 100644 --- a/translations/ro/SUPPORT.md +++ b/translations/ro/SUPPORT.md @@ -1,12 +1,3 @@ - # Suport ## Cum să raportezi probleme și să obții ajutor diff --git a/translations/ru/.co-op-translator.json b/translations/ru/.co-op-translator.json new file mode 100644 index 00000000..29218e91 --- /dev/null +++ b/translations/ru/.co-op-translator.json @@ -0,0 +1,92 @@ +{ + "01-IntroToGenAI/README.md": { + "original_hash": "75bfb080ca725e8a9aa9c80cae25fba1", + "translation_date": "2025-07-29T08:05:17+00:00", + "source_file": "01-IntroToGenAI/README.md", + "language_code": "ru" + }, + "02-SetupDevEnvironment/README.md": { + "original_hash": "96a30d42b9751a3d4e4b20e28d29d459", + "translation_date": "2026-01-28T04:38:22+00:00", + "source_file": "02-SetupDevEnvironment/README.md", + "language_code": "ru" + }, + "02-SetupDevEnvironment/examples/basic-chat-azure/README.md": { + "original_hash": "efd82efe50711d7e257eb943151d682c", + "translation_date": "2025-07-27T13:33:38+00:00", + "source_file": "02-SetupDevEnvironment/examples/basic-chat-azure/README.md", + "language_code": "ru" + }, + "02-SetupDevEnvironment/getting-started-azure-openai.md": { + "original_hash": "bfdb4b4eadbee3a59ef742439f58326a", + "translation_date": "2025-07-27T12:51:01+00:00", + "source_file": "02-SetupDevEnvironment/getting-started-azure-openai.md", + "language_code": "ru" + }, + "03-CoreGenerativeAITechniques/README.md": { + "original_hash": "685f55cb07de19b52a30ce6e8b6d889e", + "translation_date": "2025-08-28T21:53:36+00:00", + "source_file": "03-CoreGenerativeAITechniques/README.md", + "language_code": "ru" + }, + "04-PracticalSamples/README.md": { + "original_hash": "14c0a61ecc1cd2012a9c129236dfdf71", + "translation_date": "2025-07-29T08:05:02+00:00", + "source_file": "04-PracticalSamples/README.md", + "language_code": "ru" + }, + "04-PracticalSamples/calculator/README.md": { + "original_hash": "b6c16b5514d524e415a94f6097ee7d4c", + "translation_date": "2025-09-18T15:23:44+00:00", + "source_file": "04-PracticalSamples/calculator/README.md", + "language_code": "ru" + }, + "04-PracticalSamples/foundrylocal/README.md": { + "original_hash": "f787307400de59adc25a1404466a35f3", + "translation_date": "2025-11-04T07:13:13+00:00", + "source_file": "04-PracticalSamples/foundrylocal/README.md", + "language_code": "ru" + }, + "04-PracticalSamples/petstory/README.md": { + "original_hash": "0cbf68d605615a1e602c832a24616859", + "translation_date": "2025-07-25T10:43:52+00:00", + "source_file": "04-PracticalSamples/petstory/README.md", + "language_code": "ru" + }, + "05-ResponsibleGenAI/README.md": { + "original_hash": "301c05c2f57e60a6950b8c665b8bdbba", + "translation_date": "2025-07-29T15:40:54+00:00", + "source_file": "05-ResponsibleGenAI/README.md", + "language_code": "ru" + }, + "AGENTS.md": { + "original_hash": "afc90918d008cf77fd1982691f681306", + "translation_date": "2025-10-03T08:25:40+00:00", + "source_file": "AGENTS.md", + "language_code": "ru" + }, + "CODE_OF_CONDUCT.md": { + "original_hash": "442b123d034f92f7c384d2bbd28f99f1", + "translation_date": "2025-07-21T17:36:18+00:00", + "source_file": "CODE_OF_CONDUCT.md", + "language_code": "ru" + }, + "README.md": { + "original_hash": "125a08948d881c95628094f4dd1fbd43", + "translation_date": "2026-01-29T15:18:33+00:00", + "source_file": "README.md", + "language_code": "ru" + }, + "SECURITY.md": { + "original_hash": "57f14126c1c6add76b3aef3844dfe4e3", + "translation_date": "2025-07-21T17:33:55+00:00", + "source_file": "SECURITY.md", + "language_code": "ru" + }, + "SUPPORT.md": { + "original_hash": "b8ef73cc49dec68e2c885ee9df545129", + "translation_date": "2025-07-21T17:37:22+00:00", + "source_file": "SUPPORT.md", + "language_code": "ru" + } +} \ No newline at end of file diff --git a/translations/ru/01-IntroToGenAI/README.md b/translations/ru/01-IntroToGenAI/README.md index 86de46f0..d4b8b442 100644 --- a/translations/ru/01-IntroToGenAI/README.md +++ b/translations/ru/01-IntroToGenAI/README.md @@ -1,12 +1,3 @@ - # Введение в генеративный ИИ - версия для Java ## Что вы узнаете diff --git a/translations/ru/02-SetupDevEnvironment/README.md b/translations/ru/02-SetupDevEnvironment/README.md index 92298e9d..7082d911 100644 --- a/translations/ru/02-SetupDevEnvironment/README.md +++ b/translations/ru/02-SetupDevEnvironment/README.md @@ -1,13 +1,251 @@ - +# Настройка среды разработки для Generative AI на Java +> **Быстрый старт**: кодируйте в облаке за 2 минуты — перейдите к [настройке GitHub Codespaces](../../../02-SetupDevEnvironment) — установка на локальный компьютер не требуется, используются модели GitHub! + +> **Интересует Azure OpenAI?** Смотрите наше [руководство по настройке Azure OpenAI](getting-started-azure-openai.md) с шагами для создания нового ресурса Azure OpenAI. + +## Что вы узнаете + +- Настроите среду разработки Java для AI-приложений +- Выберете и сконфигурируете предпочитаемую среду разработки (преимущественно облачную с Codespaces, локальный dev-контейнер или полную локальную установку) +- Протестируете настройку, подключившись к моделям GitHub + +## Оглавление + +- [Что вы узнаете](../../../02-SetupDevEnvironment) +- [Введение](../../../02-SetupDevEnvironment) +- [Шаг 1: Настройте среду разработки](../../../02-SetupDevEnvironment) + - [Вариант A: GitHub Codespaces (рекомендуется)](../../../02-SetupDevEnvironment) + - [Вариант B: Локальный dev-контейнер](../../../02-SetupDevEnvironment) + - [Вариант C: Используйте существующую локальную установку](../../../02-SetupDevEnvironment) +- [Шаг 2: Создайте персональный токен доступа GitHub](../../../02-SetupDevEnvironment) +- [Шаг 3: Проверьте настройку](../../../02-SetupDevEnvironment) +- [Устранение неполадок](../../../02-SetupDevEnvironment) +- [Итог](../../../02-SetupDevEnvironment) +- [Следующие шаги](../../../02-SetupDevEnvironment) + +## Введение + +В этой главе вы узнаете, как настроить среду разработки. В качестве основного примера мы используем **GitHub Models**, поскольку это бесплатно, просто настроить с учетной записью GitHub, не требуется кредитная карта, и предоставляется доступ к множеству моделей для экспериментов. + +**Локальная установка не нужна!** Вы можете сразу же начать кодировать, используя GitHub Codespaces — полноценную среду разработки прямо в браузере. + +Screenshot: GitHub Models + +Мы рекомендуем использовать [**GitHub Models**](https://github.com/marketplace?type=models) для этого курса, потому что это: +- **Бесплатно** для начала работы +- **Просто** настроить, достаточно учетной записи GitHub +- **Без кредитной карты** +- **Множество моделей** для экспериментов + +> **Примечание**: GitHub Models, используемые в этом обучении, имеют следующие бесплатные лимиты: +> - 15 запросов в минуту (150 в день) +> - ~8,000 слов на вход и ~4,000 слов на выход в одном запросе +> - 5 одновременных запросов +> +> Для производственного использования перейдите на модели Azure AI Foundry с вашей учетной записью Azure. Ваш код менять не нужно. См. [документацию Azure AI Foundry](https://learn.microsoft.com/azure/ai-foundry/foundry-models/how-to/quickstart-github-models). + +## Шаг 1: Настройте среду разработки + + + +Мы подготовили преднастроенный контейнер разработки, чтобы минимизировать время настройки и обеспечить наличие всех необходимых инструментов для этого курса по Generative AI на Java. Выберите предпочитаемый способ разработки: + +### Варианты настройки среды: + +#### Вариант A: GitHub Codespaces (рекомендуется) + +**Начните кодировать за 2 минуты — установка на локальный компьютер не требуется!** + +1. Форкните этот репозиторий в свой аккаунт GitHub + > **Примечание**: если хотите изменить базовую конфигурацию, ознакомьтесь с [настройками Dev контейнера](../../../.devcontainer/devcontainer.json) +2. Нажмите **Code** → вкладка **Codespaces** → **...** → **New with options...** +3. Используйте настройки по умолчанию – будет выбран **Dev container configuration**: **Generative AI Java Development Environment** — кастомный devcontainer, созданный для этого курса +4. Нажмите **Create codespace** +5. Подождите около 2 минут, пока среда не будет готова +6. Перейдите к [Шагу 2: Создайте GitHub Token](../../../02-SetupDevEnvironment) + +Screenshot: Codespaces submenu + +Screenshot: New with options + +Screenshot: Create codespace options + +> **Преимущества Codespaces**: +> - Нет необходимости в локальной установке +> - Работает на любом устройстве с браузером +> - Преднастроено со всеми инструментами и зависимостями +> - Бесплатно 60 часов в месяц для личных аккаунтов +> - Единая среда для всех обучающихся + +#### Вариант B: Локальный dev-контейнер + +**Для разработчиков, предпочитающих локальную разработку с Docker** + +1. Форкните и клонируйте этот репозиторий на локальный компьютер + > **Примечание**: если хотите изменить базовую конфигурацию, ознакомьтесь с [настройками Dev контейнера](../../../.devcontainer/devcontainer.json) +2. Установите [Docker Desktop](https://www.docker.com/products/docker-desktop/) и [VS Code](https://code.visualstudio.com/) +3. Установите расширение [Dev Containers](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers) в VS Code +4. Откройте папку репозитория в VS Code +5. При появлении запроса нажмите **Reopen in Container** (или используйте `Ctrl+Shift+P` → "Dev Containers: Reopen in Container") +6. Дождитесь сборки и запуска контейнера +7. Перейдите к [Шагу 2: Создайте GitHub Token](../../../02-SetupDevEnvironment) + +Screenshot: Dev container setup + +Screenshot: Dev container build complete + +#### Вариант C: Используйте существующую локальную установку + +**Для разработчиков с уже настроенной средой Java** + +Требования: +- [Java 21+](https://www.oracle.com/java/technologies/javase/jdk21-archive-downloads.html) +- [Maven 3.9+](https://maven.apache.org/download.cgi) +- [VS Code](https://code.visualstudio.com) или предпочитаемая IDE + +Шаги: +1. Клонируйте этот репозиторий на локальный компьютер +2. Откройте проект в вашей IDE +3. Перейдите к [Шагу 2: Создайте GitHub Token](../../../02-SetupDevEnvironment) + +> **Полезный совет**: Если у вас слабый компьютер, но хочется использовать VS Code локально, используйте GitHub Codespaces! Вы можете подключить локальный VS Code к облачному Codespace и объединить преимущества обоих вариантов. + +Screenshot: created local devcontainer instance + +## Шаг 2: Создайте персональный токен доступа GitHub + +1. Перейдите в [Настройки GitHub](https://github.com/settings/profile) и в меню профиля выберите **Settings**. +2. В левой панели выберите **Developer settings** (обычно внизу). +3. В разделе **Personal access tokens** нажмите **Fine-grained tokens** (или перейдите по прямой [ссылке](https://github.com/settings/personal-access-tokens)). +4. Нажмите **Generate new token**. +5. В поле «Token name» укажите описательное имя (например, `GenAI-Java-Course-Token`). +6. Установите срок действия токена (рекомендуется 7 дней для безопасности). +7. В разделе «Resource owner» выберите свою учетную запись. +8. В разделе «Repository access» выберите репозитории, которые планируете использовать с GitHub Models (или «All repositories», если нужно). +9. В разделе «Account permissions» найдите **Models** и установите значение **Read-only**. +10. Нажмите **Generate token**. +11. **Скопируйте и сохраните токен сейчас** – после этого он больше не будет отображаться! + +> **Совет по безопасности**: используйте минимально необходимый диапазон доступа и кратчайший практический срок действия для токенов. + +## Шаг 3: Проверьте настройку на примере GitHub Models + +После того, как среда разработки готова, протестируем интеграцию с GitHub Models с помощью примерного приложения в [`02-SetupDevEnvironment/examples/github-models`](../../../02-SetupDevEnvironment/examples/github-models). + +1. Откройте терминал в вашей среде разработки. +2. Перейдите в каталог примера GitHub Models: + ```bash + cd 02-SetupDevEnvironment/examples/github-models + ``` +3. Установите ваш GitHub токен в качестве переменной окружения: + ```bash + # macOS/Linux + export GITHUB_TOKEN=your_token_here + + # Windows (Командная строка) + set GITHUB_TOKEN=your_token_here + + # Windows (PowerShell) + $env:GITHUB_TOKEN="your_token_here" + ``` + +4. Запустите приложение: + ```bash + mvn compile exec:java -Dexec.mainClass="com.example.githubmodels.App" + ``` + +Вы должны увидеть примерно следующий вывод: +```text +Using model: gpt-4.1-nano +Sending request to GitHub Models... +Response: Hello World! +``` + +### Понимание примерного кода + +Сначала разберёмся, что мы запустили. Пример в `examples/github-models` использует OpenAI Java SDK для подключения к GitHub Models: + +**Что делает этот код:** +- **Подключается** к GitHub Models, используя ваш персональный токен доступа +- **Отправляет** простое сообщение «Say Hello World!» модели AI +- **Получает** и отображает ответ AI +- **Проверяет**, что настройка работает корректно + +**Ключевая зависимость** (в `pom.xml`): +```xml + + com.openai + openai-java + 2.12.0 + +``` + +**Основной код** (`App.java`): +```java +// Подключение к моделям GitHub с использованием OpenAI Java SDK +OpenAIClient client = OpenAIOkHttpClient.builder() + .apiKey(pat) + .baseUrl("https://models.inference.ai.azure.com") + .build(); + +// Создать запрос на завершение чата +ChatCompletionCreateParams params = ChatCompletionCreateParams.builder() + .model(modelId) + .addSystemMessage("You are a concise assistant.") + .addUserMessage("Say Hello World!") + .build(); + +// Получить ответ ИИ +ChatCompletion response = client.chat().completions().create(params); +System.out.println("Response: " + response.choices().get(0).message().content().orElse("No response content")); +``` + +## Итог + +Отлично! Теперь у вас есть всё, что нужно: + +- Создан персональный токен доступа GitHub с нужными правами для доступа к AI-моделям +- Запущена среда разработки Java (будь то Codespaces, dev-контейнер или локальная установка) +- Установлено подключение к GitHub Models с помощью OpenAI Java SDK для бесплатной разработки AI +- Протестировано на простом примере, который общается с AI-моделями + +## Следующие шаги + +[Глава 3: Основные техники Generative AI](../03-CoreGenerativeAITechniques/README.md) + +## Устранение неполадок + +Проблемы? Вот распространённые ошибки и способы их решения: + +- **Токен не работает?** + - Убедитесь, что скопировали весь токен без лишних пробелов + - Проверьте, что токен корректно установлен как переменная окружения + - Убедитесь, что у токена правильные права (Models: Read-only) + +- **Maven не найден?** + - При использовании dev-контейнеров или Codespaces Maven должен быть предустановлен + - Для локальной установки убедитесь, что установлены Java 21+ и Maven 3.9+ + - Проверьте установку командой `mvn --version` + +- **Проблемы с подключением?** + - Проверьте интернет-соединение + - Убедитесь, что GitHub доступен из вашей сети + - Проверьте, не блокирует ли брандмауэр доступ к endpoint GitHub Models + +- **Dev-контейнер не запускается?** + - Убедитесь, что Docker Desktop запущен (для локальной разработки) + - Попробуйте перестроить контейнер: `Ctrl+Shift+P` → "Dev Containers: Rebuild Container" + +- **Ошибки компиляции приложения?** + - Проверьте, что вы находитесь в нужной директории: `02-SetupDevEnvironment/examples/github-models` + - Попробуйте очистить и пересобрать: `mvn clean compile` + +> **Нужна помощь?** Если проблемы сохраняются, создайте issue в репозитории — мы поможем. --- + +**Отказ от ответственности**: +Этот документ был переведен с использованием сервиса автоматического перевода [Co-op Translator](https://github.com/Azure/co-op-translator). Несмотря на наши усилия обеспечить точность, просим учитывать, что машинные переводы могут содержать ошибки или неточности. Оригинальный документ на его исходном языке следует считать официальным и авторитетным источником. Для получения критически важной информации рекомендуется использовать профессиональный человеческий перевод. Мы не несем ответственности за любые недоразумения или неправильные толкования, возникшие в результате использования данного перевода. + \ No newline at end of file diff --git a/translations/ru/02-SetupDevEnvironment/examples/basic-chat-azure/README.md b/translations/ru/02-SetupDevEnvironment/examples/basic-chat-azure/README.md index 3b55d8c5..6c607a2c 100644 --- a/translations/ru/02-SetupDevEnvironment/examples/basic-chat-azure/README.md +++ b/translations/ru/02-SetupDevEnvironment/examples/basic-chat-azure/README.md @@ -1,12 +1,3 @@ - # Базовый чат с Azure OpenAI - Пример от начала до конца Этот пример демонстрирует, как создать простое приложение Spring Boot, которое подключается к Azure OpenAI и проверяет вашу настройку. diff --git a/translations/ru/02-SetupDevEnvironment/getting-started-azure-openai.md b/translations/ru/02-SetupDevEnvironment/getting-started-azure-openai.md index fe07107f..adfde591 100644 --- a/translations/ru/02-SetupDevEnvironment/getting-started-azure-openai.md +++ b/translations/ru/02-SetupDevEnvironment/getting-started-azure-openai.md @@ -1,12 +1,3 @@ - # Настройка среды разработки для Azure OpenAI > **Быстрый старт**: Это руководство предназначено для настройки Azure OpenAI. Для быстрого начала с бесплатными моделями используйте [GitHub Models with Codespaces](./README.md#quick-start-cloud). diff --git a/translations/ru/03-CoreGenerativeAITechniques/README.md b/translations/ru/03-CoreGenerativeAITechniques/README.md index 7e15c4d1..2d4eb56f 100644 --- a/translations/ru/03-CoreGenerativeAITechniques/README.md +++ b/translations/ru/03-CoreGenerativeAITechniques/README.md @@ -1,12 +1,3 @@ - # Основные техники генеративного ИИ: Учебное пособие ## Содержание diff --git a/translations/ru/04-PracticalSamples/README.md b/translations/ru/04-PracticalSamples/README.md index b5abf49d..6bb5bcee 100644 --- a/translations/ru/04-PracticalSamples/README.md +++ b/translations/ru/04-PracticalSamples/README.md @@ -1,12 +1,3 @@ - # Практические приложения и проекты ## Чему вы научитесь diff --git a/translations/ru/04-PracticalSamples/calculator/README.md b/translations/ru/04-PracticalSamples/calculator/README.md index 1cc9f8eb..a7d0c8c3 100644 --- a/translations/ru/04-PracticalSamples/calculator/README.md +++ b/translations/ru/04-PracticalSamples/calculator/README.md @@ -1,12 +1,3 @@ - # Учебник по MCP-калькулятору для начинающих ## Содержание diff --git a/translations/ru/04-PracticalSamples/foundrylocal/README.md b/translations/ru/04-PracticalSamples/foundrylocal/README.md index 7c6f15fe..596defa1 100644 --- a/translations/ru/04-PracticalSamples/foundrylocal/README.md +++ b/translations/ru/04-PracticalSamples/foundrylocal/README.md @@ -1,12 +1,3 @@ - # Учебник по Foundry Local и Spring Boot ## Содержание diff --git a/translations/ru/04-PracticalSamples/petstory/README.md b/translations/ru/04-PracticalSamples/petstory/README.md index c2aa64c1..34ef0d3d 100644 --- a/translations/ru/04-PracticalSamples/petstory/README.md +++ b/translations/ru/04-PracticalSamples/petstory/README.md @@ -1,12 +1,3 @@ - # Руководство для начинающих по генератору историй о питомцах ## Содержание diff --git a/translations/ru/05-ResponsibleGenAI/README.md b/translations/ru/05-ResponsibleGenAI/README.md index 75bfcaa4..02462faf 100644 --- a/translations/ru/05-ResponsibleGenAI/README.md +++ b/translations/ru/05-ResponsibleGenAI/README.md @@ -1,12 +1,3 @@ - # Ответственная генеративная ИИ ## Чему вы научитесь diff --git a/translations/ru/AGENTS.md b/translations/ru/AGENTS.md index e1b992fa..9ea0260b 100644 --- a/translations/ru/AGENTS.md +++ b/translations/ru/AGENTS.md @@ -1,12 +1,3 @@ - # AGENTS.md ## Обзор проекта diff --git a/translations/ru/CODE_OF_CONDUCT.md b/translations/ru/CODE_OF_CONDUCT.md index 18fbc0ee..48e626c2 100644 --- a/translations/ru/CODE_OF_CONDUCT.md +++ b/translations/ru/CODE_OF_CONDUCT.md @@ -1,12 +1,3 @@ - # Кодекс поведения Microsoft для проектов с открытым исходным кодом Этот проект принял [Кодекс поведения Microsoft для проектов с открытым исходным кодом](https://opensource.microsoft.com/codeofconduct/). diff --git a/translations/ru/README.md b/translations/ru/README.md index 0b1f167f..47e39649 100644 --- a/translations/ru/README.md +++ b/translations/ru/README.md @@ -1,90 +1,81 @@ - -# Генеративный ИИ для начинающих - Java версия +# Генеративный ИИ для начинающих - издание на Java [![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) -![Генеративный ИИ для начинающих - Java версия](../../translated_images/ru/beg-genai-series.8b48be9951cc574c.webp) +![Генеративный ИИ для начинающих - издание на Java](../../translated_images/ru/beg-genai-series.8b48be9951cc574c.webp) -**Временные затраты**: Весь воркшоп можно пройти онлайн без локальной настройки. Настройка среды занимает 2 минуты, а изучение примеров — от 1 до 3 часов в зависимости от глубины изучения. +**Временные затраты**: Весь мастер-класс можно пройти онлайн без локальной настройки. Настройка среды занимает 2 минуты, изучение примеров требует от 1 до 3 часов в зависимости от глубины изучения. > **Быстрый старт** -1. Форкните этот репозиторий на свой аккаунт GitHub -2. Нажмите **Code** → вкладка **Codespaces** → **...** → **New with options...** -3. Используйте настройки по умолчанию – будет выбран Development контейнер, созданный для этого курса +1. Сделайте форк этого репозитория в свой аккаунт GitHub +2. Нажмите **Code** → вкладку **Codespaces** → **...** → **New with options...** +3. Используйте настройки по умолчанию – это выберет контейнер разработки, созданный для этого курса 4. Нажмите **Create codespace** -5. Подождите около 2 минут, пока среда подготовится +5. Подождите около 2 минут, пока среда будет готова 6. Перейдите сразу к [первому примеру](./02-SetupDevEnvironment/README.md#step-2-create-a-github-personal-access-token) > **Предпочитаете клонировать локально?** > -> В этом репозитории есть 50+ языковых переводов, что значительно увеличивает размер загрузки. Чтобы клонировать без переводов, используйте sparse checkout: +> Этот репозиторий включает более 50 языковых переводов, что значительно увеличивает размер загрузки. Чтобы клонировать без переводов, используйте sparse checkout: > ```bash > git clone --filter=blob:none --sparse https://github.com/microsoft/Generative-AI-for-beginners-java.git > cd Generative-AI-for-beginners-java > git sparse-checkout set --no-cone '/*' '!translations' '!translated_images' > ``` -> Это даст вам всё необходимое для прохождения курса с намного более быстрой загрузкой. +> Это даст вам всё необходимое для прохождения курса с гораздо более быстрой загрузкой. ## Поддержка нескольких языков -### Поддерживается через GitHub Action (автоматизировано и всегда актуально) +### Поддерживается через GitHub Action (автоматически и всегда актуально) -[Арабский](../ar/README.md) | [Бенгальский](../bn/README.md) | [Болгарский](../bg/README.md) | [Бирманский (Мьянма)](../my/README.md) | [Китайский (упрощённый)](../zh/README.md) | [Китайский (традиционный, Гонконг)](../hk/README.md) | [Китайский (традиционный, Макао)](../mo/README.md) | [Китайский (традиционный, Тайвань)](../tw/README.md) | [Хорватский](../hr/README.md) | [Чешский](../cs/README.md) | [Датский](../da/README.md) | [Нидерландский](../nl/README.md) | [Эстонский](../et/README.md) | [Финский](../fi/README.md) | [Французский](../fr/README.md) | [Немецкий](../de/README.md) | [Греческий](../el/README.md) | [Иврит](../he/README.md) | [Хинди](../hi/README.md) | [Венгерский](../hu/README.md) | [Индонезийский](../id/README.md) | [Итальянский](../it/README.md) | [Японский](../ja/README.md) | [Каннада](../kn/README.md) | [Корейский](../ko/README.md) | [Литовский](../lt/README.md) | [Малайский](../ms/README.md) | [Малаялам](../ml/README.md) | [Маратхи](../mr/README.md) | [Непальский](../ne/README.md) | [Нигерийский пиджин](../pcm/README.md) | [Норвежский](../no/README.md) | [Персидский (фарси)](../fa/README.md) | [Польский](../pl/README.md) | [Португальский (Бразилия)](../br/README.md) | [Португальский (Португалия)](../pt/README.md) | [Панджаби (Гурмукхи)](../pa/README.md) | [Румынский](../ro/README.md) | [Русский](./README.md) | [Сербский (кириллица)](../sr/README.md) | [Словацкий](../sk/README.md) | [Словенский](../sl/README.md) | [Испанский](../es/README.md) | [Свахили](../sw/README.md) | [Шведский](../sv/README.md) | [Тагальский (филиппинский)](../tl/README.md) | [Тамильский](../ta/README.md) | [Телугу](../te/README.md) | [Тайский](../th/README.md) | [Турецкий](../tr/README.md) | [Украинский](../uk/README.md) | [Урду](../ur/README.md) | [Вьетнамский](../vi/README.md) +[Арабский](../ar/README.md) | [Бенгальский](../bn/README.md) | [Болгарский](../bg/README.md) | [Бирманский (Мьянма)](../my/README.md) | [Китайский (упрощённый)](../zh-CN/README.md) | [Китайский (традиционный, Гонконг)](../zh-HK/README.md) | [Китайский (традиционный, Макао)](../zh-MO/README.md) | [Китайский (традиционный, Тайвань)](../zh-TW/README.md) | [Хорватский](../hr/README.md) | [Чешский](../cs/README.md) | [Датский](../da/README.md) | [Голландский](../nl/README.md) | [Эстонский](../et/README.md) | [Финский](../fi/README.md) | [Французский](../fr/README.md) | [Немецкий](../de/README.md) | [Греческий](../el/README.md) | [Иврит](../he/README.md) | [Хинди](../hi/README.md) | [Венгерский](../hu/README.md) | [Индонезийский](../id/README.md) | [Итальянский](../it/README.md) | [Японский](../ja/README.md) | [Каннада](../kn/README.md) | [Корейский](../ko/README.md) | [Литовский](../lt/README.md) | [Малайский](../ms/README.md) | [Малаялам](../ml/README.md) | [Маратхи](../mr/README.md) | [Непальский](../ne/README.md) | [Нигерийский пиджин](../pcm/README.md) | [Норвежский](../no/README.md) | [Персидский (фарси)](../fa/README.md) | [Польский](../pl/README.md) | [Португальский (Бразилия)](../pt-BR/README.md) | [Португальский (Португалия)](../pt-PT/README.md) | [Пенджаби (гурмукхи)](../pa/README.md) | [Румынский](../ro/README.md) | [Русский](./README.md) | [Сербский (кириллица)](../sr/README.md) | [Словацкий](../sk/README.md) | [Словенский](../sl/README.md) | [Испанский](../es/README.md) | [Свахили](../sw/README.md) | [Шведский](../sv/README.md) | [Тагалог (филиппинский)](../tl/README.md) | [Тамильский](../ta/README.md) | [Телугу](../te/README.md) | [Тайский](../th/README.md) | [Турецкий](../tr/README.md) | [Украинский](../uk/README.md) | [Урду](../ur/README.md) | [Вьетнамский](../vi/README.md) > **Предпочитаете клонировать локально?** -> В этом репозитории есть 50+ языковых переводов, что значительно увеличивает размер загрузки. Чтобы клонировать без переводов, используйте sparse checkout: +> Этот репозиторий включает более 50 языковых переводов, что значительно увеличивает размер загрузки. Чтобы клонировать без переводов, используйте sparse checkout: > ```bash > git clone --filter=blob:none --sparse https://github.com/microsoft/Generative-AI-for-beginners-java.git > cd Generative-AI-for-beginners-java > git sparse-checkout set --no-cone '/*' '!translations' '!translated_images' > ``` -> Это даст вам всё необходимое для прохождения курса с намного более быстрой загрузкой. +> Это даст вам всё необходимое для прохождения курса с гораздо более быстрой загрузкой. -## Структура курса и учебный план +## Структура курса и учебный путь ### **Глава 1: Введение в генеративный ИИ** -- **Основные понятия**: Понимание больших языковых моделей, токенов, эмбеддингов и возможностей ИИ -- **Экосистема ИИ на Java**: Обзор Spring AI и OpenAI SDK -- **Протокол контекста модели**: Введение в MCP и его роль в коммуникации ИИ-агентов -- **Практические применения**: Реальные сценарии, включая чат-боты и генерацию контента +- **Основные концепции**: понимание больших языковых моделей, токенов, эмбеддингов и возможностей ИИ +- **Экосистема Java AI**: обзор Spring AI и OpenAI SDK +- **Протокол контекста модели**: введение в MCP и его роль в коммуникации ИИ-агентов +- **Практические применения**: реальные сценарии, включая чатботов и генерацию контента - **[→ Начать главу 1](./01-IntroToGenAI/README.md)** ### **Глава 2: Настройка среды разработки** -- **Мультипровайдерская конфигурация**: Настройка GitHub Models, Azure OpenAI и OpenAI Java SDK интеграций -- **Spring Boot + Spring AI**: Лучшие практики разработки корпоративных AI приложений -- **GitHub Models**: Бесплатный доступ к AI моделям для прототипирования и обучения (без необходимости кредитной карты) -- **Инструменты разработки**: Docker контейнеры, VS Code и настройка GitHub Codespaces +- **Настройка для нескольких провайдеров**: интеграция GitHub Models, Azure OpenAI и OpenAI Java SDK +- **Spring Boot + Spring AI**: лучшие практики разработки корпоративных AI-приложений +- **GitHub Models**: бесплатный доступ к AI моделям для прототипирования и обучения (без кредитной карты) +- **Инструменты разработки**: контейнеры Docker, VS Code и настройка GitHub Codespaces - **[→ Начать главу 2](./02-SetupDevEnvironment/README.md)** ### **Глава 3: Основные техники генеративного ИИ** -- **Промпт-инжиниринг**: Техники для оптимальных ответов AI модели -- **Эмбеддинги и векторные операции**: Реализация семантического поиска и поиска по сходству -- **Генерация с повышением с помощью извлечения (RAG)**: Комбинация ИИ и ваших собственных источников данных -- **Вызов функций**: Расширение возможностей ИИ с помощью пользовательских инструментов и плагинов +- **Промпт-инжиниринг**: техники для получения оптимальных ответов AI модели +- **Эмбеддинги и векторные операции**: реализация семантического поиска и сопоставления по сходству +- **Retrieval-Augmented Generation (RAG)**: сочетание AI с собственными источниками данных +- **Вызов функций**: расширение возможностей AI с помощью пользовательских инструментов и плагинов - **[→ Начать главу 3](./03-CoreGenerativeAITechniques/README.md)** ### **Глава 4: Практические приложения и проекты** -- **Генератор историй о питомцах** (`petstory/`): Креативное создание контента с GitHub Models -- **Локальная демонстрация Foundry** (`foundrylocal/`): Локальная интеграция AI модели с OpenAI Java SDK -- **Сервис калькулятора MCP** (`calculator/`): Базовая реализация протокола контекста модели с Spring AI +- **Генератор историй о питомцах** (`petstory/`): творческая генерация контента с GitHub Models +- **Демонстрация Foundry local** (`foundrylocal/`): локальная интеграция AI модели с OpenAI Java SDK +- **Сервис калькулятора MCP** (`calculator/`): базовая реализация протокола контекста модели с Spring AI - **[→ Начать главу 4](./04-PracticalSamples/README.md)** ### **Глава 5: Ответственная разработка ИИ** -- **Безопасность GitHub Models**: Тестирование встроенной фильтрации контента и механизмов безопасности (жёсткие блокировки и мягкие отказы) -- **Демонстрация ответственного ИИ**: Практический пример работы современных систем безопасности ИИ -- **Лучшие практики**: Основные рекомендации для этичной разработки и внедрения ИИ +- **Безопасность GitHub Models**: тестирование встроенных механизмов фильтрации контента и безопасности (жёсткие блокировки и мягкие отказы) +- **Демонстрация ответственного ИИ**: практический пример работы современных систем безопасности ИИ +- **Лучшие практики**: основные рекомендации по этичной разработке и развёртыванию ИИ - **[→ Начать главу 5](./05-ResponsibleGenAI/README.md)** ## Дополнительные ресурсы @@ -112,12 +103,13 @@ CO_OP_TRANSLATOR_METADATA: --- -### Основное обучение -[![ML для начинающих](https://img.shields.io/badge/ML%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=22C55E)](https://aka.ms/ml-beginners?WT.mc_id=academic-105485-koreyst) -[![Data Science для начинающих](https://img.shields.io/badge/Data%20Science%20for%20Beginners-84CC16?style=for-the-badge&labelColor=E5E7EB&color=84CC16)](https://aka.ms/datascience-beginners?WT.mc_id=academic-105485-koreyst) +### Основные области обучения +[![Машинное обучение для начинающих](https://img.shields.io/badge/ML%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=22C55E)](https://aka.ms/ml-beginners?WT.mc_id=academic-105485-koreyst) +[![Наука о данных для начинающих](https://img.shields.io/badge/Data%20Science%20for%20Beginners-84CC16?style=for-the-badge&labelColor=E5E7EB&color=84CC16)](https://aka.ms/datascience-beginners?WT.mc_id=academic-105485-koreyst) [![ИИ для начинающих](https://img.shields.io/badge/AI%20for%20Beginners-A3E635?style=for-the-badge&labelColor=E5E7EB&color=A3E635)](https://aka.ms/ai-beginners?WT.mc_id=academic-105485-koreyst) [![Кибербезопасность для начинающих](https://img.shields.io/badge/Cybersecurity%20for%20Beginners-F97316?style=for-the-badge&labelColor=E5E7EB&color=F97316)](https://github.com/microsoft/Security-101?WT.mc_id=academic-96948-sayoung) -[![Веб-разработка для начинающих](https://img.shields.io/badge/Web%20Dev%20for%20Beginners-EC4899?style=for-the-badge&labelColor=E5E7EB&color=EC4899)](https://aka.ms/webdev-beginners?WT.mc_id=academic-105485-koreyst) + +[![Web Dev for Beginners](https://img.shields.io/badge/Web%20Dev%20for%20Beginners-EC4899?style=for-the-badge&labelColor=E5E7EB&color=EC4899)](https://aka.ms/webdev-beginners?WT.mc_id=academic-105485-koreyst) [![IoT for Beginners](https://img.shields.io/badge/IoT%20for%20Beginners-14B8A6?style=for-the-badge&labelColor=E5E7EB&color=14B8A6)](https://aka.ms/iot-beginners?WT.mc_id=academic-105485-koreyst) [![XR Development for Beginners](https://img.shields.io/badge/XR%20Development%20for%20Beginners-38BDF8?style=for-the-badge&labelColor=E5E7EB&color=38BDF8)](https://github.com/microsoft/xr-development-for-beginners?WT.mc_id=academic-105485-koreyst) @@ -131,7 +123,7 @@ CO_OP_TRANSLATOR_METADATA: ## Получение помощи -Если вы застряли или у вас есть вопросы по созданию AI-приложений. Присоединяйтесь к другим учащимся и опытным разработчикам в обсуждениях о MCP. Это поддерживающее сообщество, где приветствуются вопросы и свободно делятся знаниями. +Если вы застряли или у вас есть вопросы по созданию AI-приложений, присоединяйтесь к другим учащимся и опытным разработчикам в обсуждениях MCP. Это поддерживающее сообщество, где вопросы приветствуются, а знания свободно делятся. [![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) @@ -143,5 +135,5 @@ CO_OP_TRANSLATOR_METADATA: **Отказ от ответственности**: -Этот документ был переведен с помощью сервиса автоматического перевода [Co-op Translator](https://github.com/Azure/co-op-translator). Несмотря на наши усилия обеспечить точность, просим учитывать, что машинный перевод может содержать ошибки или неточности. Оригинальный документ на его исходном языке следует считать авторитетным источником. Для критически важной информации рекомендуется обращаться к профессиональному переводу, выполненному человеком. Мы не несем ответственности за любые недоразумения или неверные толкования, возникающие при использовании данного перевода. +Этот документ был переведен с использованием сервиса автоматического перевода [Co-op Translator](https://github.com/Azure/co-op-translator). Несмотря на наши усилия по обеспечению точности, имейте в виду, что автоматический перевод может содержать ошибки или неточности. Оригинальный документ на его исходном языке следует считать авторитетным источником. Для критически важной информации рекомендуется воспользоваться профессиональным переводом, выполненным человеком. Мы не несем ответственности за любые недоразумения или неправильные истолкования, возникшие в результате использования данного перевода. \ No newline at end of file diff --git a/translations/ru/SECURITY.md b/translations/ru/SECURITY.md index dc08aeaa..26411a2b 100644 --- a/translations/ru/SECURITY.md +++ b/translations/ru/SECURITY.md @@ -1,12 +1,3 @@ - ## Безопасность Microsoft уделяет серьезное внимание безопасности своих программных продуктов и услуг, включая все репозитории исходного кода, управляемые через наши организации на GitHub, такие как [Microsoft](https://github.com/Microsoft), [Azure](https://github.com/Azure), [DotNet](https://github.com/dotnet), [AspNet](https://github.com/aspnet) и [Xamarin](https://github.com/xamarin). diff --git a/translations/ru/SUPPORT.md b/translations/ru/SUPPORT.md index 00162e15..051c976d 100644 --- a/translations/ru/SUPPORT.md +++ b/translations/ru/SUPPORT.md @@ -1,12 +1,3 @@ - # Поддержка ## Как сообщить о проблемах и получить помощь diff --git a/translations/sk/.co-op-translator.json b/translations/sk/.co-op-translator.json new file mode 100644 index 00000000..b37b189b --- /dev/null +++ b/translations/sk/.co-op-translator.json @@ -0,0 +1,92 @@ +{ + "01-IntroToGenAI/README.md": { + "original_hash": "75bfb080ca725e8a9aa9c80cae25fba1", + "translation_date": "2025-07-29T10:06:21+00:00", + "source_file": "01-IntroToGenAI/README.md", + "language_code": "sk" + }, + "02-SetupDevEnvironment/README.md": { + "original_hash": "96a30d42b9751a3d4e4b20e28d29d459", + "translation_date": "2026-01-28T05:20:41+00:00", + "source_file": "02-SetupDevEnvironment/README.md", + "language_code": "sk" + }, + "02-SetupDevEnvironment/examples/basic-chat-azure/README.md": { + "original_hash": "efd82efe50711d7e257eb943151d682c", + "translation_date": "2025-07-27T13:46:40+00:00", + "source_file": "02-SetupDevEnvironment/examples/basic-chat-azure/README.md", + "language_code": "sk" + }, + "02-SetupDevEnvironment/getting-started-azure-openai.md": { + "original_hash": "bfdb4b4eadbee3a59ef742439f58326a", + "translation_date": "2025-07-27T13:24:54+00:00", + "source_file": "02-SetupDevEnvironment/getting-started-azure-openai.md", + "language_code": "sk" + }, + "03-CoreGenerativeAITechniques/README.md": { + "original_hash": "685f55cb07de19b52a30ce6e8b6d889e", + "translation_date": "2025-08-28T22:15:39+00:00", + "source_file": "03-CoreGenerativeAITechniques/README.md", + "language_code": "sk" + }, + "04-PracticalSamples/README.md": { + "original_hash": "14c0a61ecc1cd2012a9c129236dfdf71", + "translation_date": "2025-07-29T10:06:05+00:00", + "source_file": "04-PracticalSamples/README.md", + "language_code": "sk" + }, + "04-PracticalSamples/calculator/README.md": { + "original_hash": "b6c16b5514d524e415a94f6097ee7d4c", + "translation_date": "2025-09-18T15:39:42+00:00", + "source_file": "04-PracticalSamples/calculator/README.md", + "language_code": "sk" + }, + "04-PracticalSamples/foundrylocal/README.md": { + "original_hash": "f787307400de59adc25a1404466a35f3", + "translation_date": "2025-11-04T07:33:28+00:00", + "source_file": "04-PracticalSamples/foundrylocal/README.md", + "language_code": "sk" + }, + "04-PracticalSamples/petstory/README.md": { + "original_hash": "0cbf68d605615a1e602c832a24616859", + "translation_date": "2025-07-25T11:55:28+00:00", + "source_file": "04-PracticalSamples/petstory/README.md", + "language_code": "sk" + }, + "05-ResponsibleGenAI/README.md": { + "original_hash": "301c05c2f57e60a6950b8c665b8bdbba", + "translation_date": "2025-07-29T15:58:07+00:00", + "source_file": "05-ResponsibleGenAI/README.md", + "language_code": "sk" + }, + "AGENTS.md": { + "original_hash": "afc90918d008cf77fd1982691f681306", + "translation_date": "2025-10-03T08:42:44+00:00", + "source_file": "AGENTS.md", + "language_code": "sk" + }, + "CODE_OF_CONDUCT.md": { + "original_hash": "442b123d034f92f7c384d2bbd28f99f1", + "translation_date": "2025-07-21T20:37:32+00:00", + "source_file": "CODE_OF_CONDUCT.md", + "language_code": "sk" + }, + "README.md": { + "original_hash": "125a08948d881c95628094f4dd1fbd43", + "translation_date": "2026-01-29T16:09:55+00:00", + "source_file": "README.md", + "language_code": "sk" + }, + "SECURITY.md": { + "original_hash": "57f14126c1c6add76b3aef3844dfe4e3", + "translation_date": "2025-07-21T20:35:22+00:00", + "source_file": "SECURITY.md", + "language_code": "sk" + }, + "SUPPORT.md": { + "original_hash": "b8ef73cc49dec68e2c885ee9df545129", + "translation_date": "2025-07-21T20:38:49+00:00", + "source_file": "SUPPORT.md", + "language_code": "sk" + } +} \ No newline at end of file diff --git a/translations/sk/01-IntroToGenAI/README.md b/translations/sk/01-IntroToGenAI/README.md index 14809cfd..adf342ff 100644 --- a/translations/sk/01-IntroToGenAI/README.md +++ b/translations/sk/01-IntroToGenAI/README.md @@ -1,12 +1,3 @@ - # Úvod do Generatívnej AI - Java Edition ## Čo sa naučíte diff --git a/translations/sk/02-SetupDevEnvironment/README.md b/translations/sk/02-SetupDevEnvironment/README.md index acce0a99..165cacb8 100644 --- a/translations/sk/02-SetupDevEnvironment/README.md +++ b/translations/sk/02-SetupDevEnvironment/README.md @@ -1,13 +1,254 @@ - +# Nastavenie vývojového prostredia pre Generatívnu AI pre Java +> **Rýchly začiatok**: Kódovanie v cloude za 2 minúty – prejdite na [GitHub Codespaces Setup](../../../02-SetupDevEnvironment) – nie je potrebná lokálna inštalácia a využíva github modely! + +> **Zaujíma vás Azure OpenAI?**, pozrite si náš [Sprievodca nastavením Azure OpenAI](getting-started-azure-openai.md) s krokmi na vytvorenie nového Azure OpenAI zdroja. + +## Čo sa naučíte + +- Nastaviť vývojové prostredie Java pre AI aplikácie +- Vybrať a nakonfigurovať preferované vývojové prostredie (cloud-first s Codespaces, lokálny dev kontajner alebo plné lokálne nastavenie) +- Otestovať nastavenie pripojením na GitHub Modely + +## Obsah + +- [Čo sa naučíte](../../../02-SetupDevEnvironment) +- [Úvod](../../../02-SetupDevEnvironment) +- [Krok 1: Nastavte si vývojové prostredie](../../../02-SetupDevEnvironment) + - [Možnosť A: GitHub Codespaces (Odporúčané)](../../../02-SetupDevEnvironment) + - [Možnosť B: Lokálny Dev Kontajner](../../../02-SetupDevEnvironment) + - [Možnosť C: Použite existujúcu lokálnu inštaláciu](../../../02-SetupDevEnvironment) +- [Krok 2: Vytvorte si GitHub osobný prístupový token](../../../02-SetupDevEnvironment) +- [Krok 3: Otestujte nastavenie](../../../02-SetupDevEnvironment) +- [Riešenie problémov](../../../02-SetupDevEnvironment) +- [Zhrnutie](../../../02-SetupDevEnvironment) +- [Ďalšie kroky](../../../02-SetupDevEnvironment) + +## Úvod + +Táto kapitola vás prevedie nastavením vývojového prostredia. Ako primárny príklad použijeme **GitHub Modely**, pretože sú bezplatné, ľahko sa nastavia iba s GitHub účtom, nepotrebujete kreditnú kartu a poskytujú prístup k viacerým modelom na experimentovanie. + +**Nie je potrebné lokálne nastavenie!** Môžete začať kódovať okamžite pomocou GitHub Codespaces, ktoré poskytuje plné vývojové prostredie vo vašom prehliadači. + +Snímka obrazovky: GitHub Modely + +Odporúčame používať [**GitHub Modely**](https://github.com/marketplace?type=models) pre tento kurz, pretože sú: +- **Bezplatné** na začiatok +- **Jednoduché** na nastavenie iba s GitHub účtom +- **Bez potreby kreditnej karty** +- **Viacero modelov** na experimentovanie + +> **Poznámka**: GitHub Modely použité v tomto školení majú tieto bezplatné limity: +> - 15 požiadaviek za minútu (150 za deň) +> - ~8 000 slov vstup, ~4 000 slov výstup na požiadavku +> - 5 súbežných požiadaviek +> +> Pre produkčné použitie si upgradujte na Azure AI Foundry Modely so svojím Azure účtom. Váš kód nie je potrebné meniť. Pozrite si [dokumentáciu Azure AI Foundry](https://learn.microsoft.com/azure/ai-foundry/foundry-models/how-to/quickstart-github-models). + + +## Krok 1: Nastavte si vývojové prostredie + + + +Vytvorili sme predkonfigurovaný vývojový kontajner, aby sme minimalizovali čas nastavenia a zabezpečili, že máte všetky potrebné nástroje pre tento kurz Generatívnej AI pre Java. Vyberte si preferovaný spôsob vývoja: + +### Možnosti nastavenia prostredia: + +#### Možnosť A: GitHub Codespaces (Odporúčané) + +**Začnite kódovať za 2 minúty – nie je potrebná lokálna inštalácia!** + +1. Vytvorte fork tohto repozitára do svojho GitHub účtu + > **Poznámka**: Ak chcete upraviť základnú konfiguráciu, pozrite si prosím [Konfiguráciu Dev Kontajnera](../../../.devcontainer/devcontainer.json) +2. Kliknite na **Code** → kartu **Codespaces** → **...** → **New with options...** +3. Použite predvolené nastavenia – vyberie sa **Konfigurácia Dev kontajnera**: **Generatívne AI Java vývojové prostredie** predpripravený devcontainer pre tento kurz +4. Kliknite na **Create codespace** +5. Počkajte približne 2 minúty, kým bude prostredie pripravené +6. Pokračujte na [Krok 2: Vytvorte GitHub token](../../../02-SetupDevEnvironment) + +Snímka obrazovky: Codespaces menu + +Snímka obrazovky: New with options + +Snímka obrazovky: Create codespace možnosti + + +> **Výhody Codespaces**: +> - Nie je potrebná lokálna inštalácia +> - Funguje na akomkoľvek zariadení s prehliadačom +> - Predkonfigurované so všetkými nástrojmi a závislosťami +> - Bezplatných 60 hodín mesačne pre osobné účty +> - Konzistentné prostredie pre všetkých študentov + +#### Možnosť B: Lokálny Dev Kontajner + +**Pre vývojárov, ktorí preferujú lokálny vývoj pomocou Dockeru** + +1. Vytvorte fork a naklonujte tento repozitár do svojho lokálneho počítača + > **Poznámka**: Ak chcete upraviť základnú konfiguráciu, pozrite si prosím [Konfiguráciu Dev Kontajnera](../../../.devcontainer/devcontainer.json) +2. Nainštalujte [Docker Desktop](https://www.docker.com/products/docker-desktop/) a [VS Code](https://code.visualstudio.com/) +3. Nainštalujte rozšírenie [Dev Containers](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers) do VS Code +4. Otvorte priečinok repozitára vo VS Code +5. Keď sa zobrazí výzva, kliknite na **Reopen in Container** (alebo použite `Ctrl+Shift+P` → "Dev Containers: Reopen in Container") +6. Počkajte, kým sa kontajner zostaví a spustí +7. Pokračujte na [Krok 2: Vytvorte GitHub token](../../../02-SetupDevEnvironment) + +Snímka obrazovky: Nastavenie dev kontajnera + +Snímka obrazovky: Dokončenie zostavenia dev kontajnera + +#### Možnosť C: Použite existujúcu lokálnu inštaláciu + +**Pre vývojárov s existujúcimi Java prostrediami** + +Predpoklady: +- [Java 21+](https://www.oracle.com/java/technologies/javase/jdk21-archive-downloads.html) +- [Maven 3.9+](https://maven.apache.org/download.cgi) +- [VS Code](https://code.visualstudio.com) alebo preferované IDE + +Kroky: +1. Naklonujte tento repozitár do svojho lokálneho počítača +2. Otvorte projekt vo svojom IDE +3. Pokračujte na [Krok 2: Vytvorte GitHub token](../../../02-SetupDevEnvironment) + +> **Tip**: Ak máte slabý počítač, ale chcete VS Code lokálne, použite GitHub Codespaces! Môžete pripojiť svoj lokálny VS Code ku cloud-hostovanému Codespace pre to najlepšie z oboch svetov. + +Snímka obrazovky: Vytvorená lokálna inštancia dev kontajnera + + +## Krok 2: Vytvorte si GitHub osobný prístupový token + +1. Prejdite do [GitHub Nastavení](https://github.com/settings/profile) a vyberte **Settings** z ponuky svojho profilu. +2. V ľavom bočnom paneli kliknite na **Developer settings** (zvyčajne na spodku). +3. Pod **Personal access tokens** kliknite na **Fine-grained tokens** (alebo použite tento priamy [odkaz](https://github.com/settings/personal-access-tokens)). +4. Kliknite na **Generate new token**. +5. Pod „Token name“ zadajte popisný názov (napr. `GenAI-Java-Course-Token`). +6. Nastavte dátum vypršania platnosti (odporúčané: 7 dní pre bezpečnostné postupy). +7. Pod „Resource owner“ vyberte svoj používateľský účet. +8. Pod „Repository access“ vyberte repozitáre, ktoré chcete používať s GitHub Modelmi (alebo „All repositories“, ak treba). +9. Pod „Account permissions“ nájdite **Models** a nastavte na **Read-only**. +10. Kliknite na **Generate token**. +11. **Skopírujte a uložte svoj token hneď teraz** – už ho neuvidíte! + +> **Bezpečnostný tip**: Používajte minimálne potrebný rozsah a najkratšiu praktickú dobu platnosti pre svoje prístupové tokeny. + +## Krok 3: Otestujte nastavenie s príkladom GitHub Modely + +Akonáhle je vaše vývojové prostredie pripravené, otestujme integráciu GitHub Modelov s našou príkladovou aplikáciou v [`02-SetupDevEnvironment/examples/github-models`](../../../02-SetupDevEnvironment/examples/github-models). + +1. Otvorte terminál vo svojom vývojovom prostredí. +2. Prejdite do príkladu GitHub Modely: + ```bash + cd 02-SetupDevEnvironment/examples/github-models + ``` +3. Nastavte svoj GitHub token ako premennú prostredia: + ```bash + # macOS/Linux + export GITHUB_TOKEN=your_token_here + + # Windows (Príkazový riadok) + set GITHUB_TOKEN=your_token_here + + # Windows (PowerShell) + $env:GITHUB_TOKEN="your_token_here" + ``` + +4. Spustite aplikáciu: + ```bash + mvn compile exec:java -Dexec.mainClass="com.example.githubmodels.App" + ``` + +Mali by ste vidieť výstup podobný tomuto: +```text +Using model: gpt-4.1-nano +Sending request to GitHub Models... +Response: Hello World! +``` + +### Pochopenie príkladového kódu + +Najprv si vysvetlime, čo sme práve spustili. Príklad v `examples/github-models` používa OpenAI Java SDK na pripojenie k GitHub Modelom: + +**Čo tento kód robí:** +- **Pripojí sa** k GitHub Modelom pomocou vášho osobného prístupového tokenu +- **Odošle** jednoduchú správu "Say Hello World!" AI modelu +- **Prijme** a zobrazí odpoveď od AI +- **Overí**, že vaše nastavenie funguje správne + +**Kľúčová závislosť** (v `pom.xml`): +```xml + + com.openai + openai-java + 2.12.0 + +``` + +**Hlavný kód** (`App.java`): +```java +// Pripojiť sa k modelom GitHub pomocou OpenAI Java SDK +OpenAIClient client = OpenAIOkHttpClient.builder() + .apiKey(pat) + .baseUrl("https://models.inference.ai.azure.com") + .build(); + +// Vytvoriť požiadavku na dokončenie chatu +ChatCompletionCreateParams params = ChatCompletionCreateParams.builder() + .model(modelId) + .addSystemMessage("You are a concise assistant.") + .addUserMessage("Say Hello World!") + .build(); + +// Získať odpoveď AI +ChatCompletion response = client.chat().completions().create(params); +System.out.println("Response: " + response.choices().get(0).message().content().orElse("No response content")); +``` + +## Zhrnutie + +Výborne! Teraz máte všetko nastavené: + +- Vytvorili ste GitHub osobný prístupový token so správnymi právami pre prístup k AI modelu +- Rozbehli ste si prostredie Java vývoja (či už Codespaces, dev kontajnery alebo lokálne) +- Pripojili ste sa ku GitHub Modelom pomocou OpenAI Java SDK pre bezplatný AI vývoj +- Otestovali ste, že všetko funguje na jednoduchom príklade komunikujúcim s AI modelmi + +## Ďalšie kroky + +[Kapitola 3: Základné techniky Generatívnej AI](../03-CoreGenerativeAITechniques/README.md) + +## Riešenie problémov + +Máte problémy? Tu sú bežné problémy a ich riešenia: + +- **Token nefunguje?** + - Uistite sa, že ste skopírovali celý token bez ďalších medzier + - Skontrolujte, či je token správne nastavený ako premenná prostredia + - Overte, že token má správne oprávnenia (Models: Read-only) + +- **Maven sa nenašiel?** + - Ak používate dev kontajnery/Codespaces, Maven by mal byť predinštalovaný + - Pri lokálnom nastavení sa uistite, že máte nainštalované Java 21+ a Maven 3.9+ + - Skúste `mvn --version` na overenie inštalácie + +- **Problémy s pripojením?** + - Skontrolujte vaše internetové pripojenie + - Overte, že môžete pristupovať ku GitHub zo siete + - Uistite sa, že nie ste za firewallom, ktorý blokuje endpoint GitHub Modelov + +- **Dev kontajner sa nespúšťa?** + - Uistite sa, že Docker Desktop beží (pre lokálny vývoj) + - Skúste znovu zostaviť kontajner: `Ctrl+Shift+P` → "Dev Containers: Rebuild Container" + +- **Chyby kompilácie aplikácie?** + - Uistite sa, že ste v správnom adresári: `02-SetupDevEnvironment/examples/github-models` + - Skúste vyčistiť a znovu zostaviť: `mvn clean compile` + +> **Potrebujete pomoc?**: Stále máte problémy? Otvorte issue v repozitári a radi vám pomôžeme. --- + +**Vyhlásenie o zodpovednosti**: +Tento dokument bol preložený pomocou služby automatického prekladu [Co-op Translator](https://github.com/Azure/co-op-translator). Aj keď sa snažíme o presnosť, prosím berte na vedomie, že automatické preklady môžu obsahovať chyby alebo nepresnosti. Originálny dokument v jeho pôvodnom jazyku by sa mal považovať za autoritatívny zdroj. Pre kritické informácie odporúčame profesionálny ľudský preklad. Nezodpovedáme za žiadne nedorozumenia alebo nesprávne výklady vyplývajúce z použitia tohto prekladu. + \ No newline at end of file diff --git a/translations/sk/02-SetupDevEnvironment/examples/basic-chat-azure/README.md b/translations/sk/02-SetupDevEnvironment/examples/basic-chat-azure/README.md index bfc56006..59b23796 100644 --- a/translations/sk/02-SetupDevEnvironment/examples/basic-chat-azure/README.md +++ b/translations/sk/02-SetupDevEnvironment/examples/basic-chat-azure/README.md @@ -1,12 +1,3 @@ - # Základný Chat s Azure OpenAI - Kompletný Príklad Tento príklad ukazuje, ako vytvoriť jednoduchú aplikáciu Spring Boot, ktorá sa pripojí k Azure OpenAI a otestuje vaše nastavenie. diff --git a/translations/sk/02-SetupDevEnvironment/getting-started-azure-openai.md b/translations/sk/02-SetupDevEnvironment/getting-started-azure-openai.md index d7a8eac0..5457ea71 100644 --- a/translations/sk/02-SetupDevEnvironment/getting-started-azure-openai.md +++ b/translations/sk/02-SetupDevEnvironment/getting-started-azure-openai.md @@ -1,12 +1,3 @@ - # Nastavenie vývojového prostredia pre Azure OpenAI > **Rýchly štart**: Táto príručka je určená na nastavenie Azure OpenAI. Ak chcete okamžite začať s bezplatnými modelmi, použite [GitHub Models with Codespaces](./README.md#quick-start-cloud). diff --git a/translations/sk/03-CoreGenerativeAITechniques/README.md b/translations/sk/03-CoreGenerativeAITechniques/README.md index 68fc56ed..b4ee17ee 100644 --- a/translations/sk/03-CoreGenerativeAITechniques/README.md +++ b/translations/sk/03-CoreGenerativeAITechniques/README.md @@ -1,12 +1,3 @@ - # Návod na základné techniky generatívnej AI ## Obsah diff --git a/translations/sk/04-PracticalSamples/README.md b/translations/sk/04-PracticalSamples/README.md index 31dc477a..536a3860 100644 --- a/translations/sk/04-PracticalSamples/README.md +++ b/translations/sk/04-PracticalSamples/README.md @@ -1,12 +1,3 @@ - # Praktické aplikácie a projekty ## Čo sa naučíte diff --git a/translations/sk/04-PracticalSamples/calculator/README.md b/translations/sk/04-PracticalSamples/calculator/README.md index 55a029a8..cd91dcb0 100644 --- a/translations/sk/04-PracticalSamples/calculator/README.md +++ b/translations/sk/04-PracticalSamples/calculator/README.md @@ -1,12 +1,3 @@ - # Návod na MCP kalkulačku pre začiatočníkov ## Obsah diff --git a/translations/sk/04-PracticalSamples/foundrylocal/README.md b/translations/sk/04-PracticalSamples/foundrylocal/README.md index 8dae2674..53587fc4 100644 --- a/translations/sk/04-PracticalSamples/foundrylocal/README.md +++ b/translations/sk/04-PracticalSamples/foundrylocal/README.md @@ -1,12 +1,3 @@ - # Lokálny tutoriál Foundry pre Spring Boot ## Obsah diff --git a/translations/sk/04-PracticalSamples/petstory/README.md b/translations/sk/04-PracticalSamples/petstory/README.md index 0e48f076..7a1340c8 100644 --- a/translations/sk/04-PracticalSamples/petstory/README.md +++ b/translations/sk/04-PracticalSamples/petstory/README.md @@ -1,12 +1,3 @@ - # Návod na generátor príbehov o domácich miláčikoch pre začiatočníkov ## Obsah diff --git a/translations/sk/05-ResponsibleGenAI/README.md b/translations/sk/05-ResponsibleGenAI/README.md index 08ba8c52..1149fab9 100644 --- a/translations/sk/05-ResponsibleGenAI/README.md +++ b/translations/sk/05-ResponsibleGenAI/README.md @@ -1,12 +1,3 @@ - # Zodpovedná generatívna AI ## Čo sa naučíte diff --git a/translations/sk/AGENTS.md b/translations/sk/AGENTS.md index 13d39d93..1280d03d 100644 --- a/translations/sk/AGENTS.md +++ b/translations/sk/AGENTS.md @@ -1,12 +1,3 @@ - # AGENTS.md ## Prehľad projektu diff --git a/translations/sk/CODE_OF_CONDUCT.md b/translations/sk/CODE_OF_CONDUCT.md index ff0ac356..9d2f5025 100644 --- a/translations/sk/CODE_OF_CONDUCT.md +++ b/translations/sk/CODE_OF_CONDUCT.md @@ -1,12 +1,3 @@ - # Kódex správania pre otvorený zdroj od Microsoftu Tento projekt prijal [Kódex správania pre otvorený zdroj od Microsoftu](https://opensource.microsoft.com/codeofconduct/). diff --git a/translations/sk/README.md b/translations/sk/README.md index 3baee93b..6835151f 100644 --- a/translations/sk/README.md +++ b/translations/sk/README.md @@ -1,37 +1,28 @@ - -# Generatívna AI pre začiatočníkov - Java edícia +# Generatívna AI pre začiatočníkov - edícia Java [![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) -![Generatívna AI pre začiatočníkov - Java edícia](../../translated_images/sk/beg-genai-series.8b48be9951cc574c.webp) +![Generatívna AI pre začiatočníkov - edícia Java](../../translated_images/sk/beg-genai-series.8b48be9951cc574c.webp) -**Časová náročnosť**: Celý workshop je možné dokončiť online bez miestnej inštalácie. Nastavenie prostredia trvá 2 minúty, prezeranie príkladov vyžaduje 1-3 hodiny podľa hĺbky skúmania. +**Časová náročnosť**: Celý workshop môžete dokončiť online bez miestnej inštalácie. Nastavenie prostredia trvá 2 minúty, prezretie si ukážok vyžaduje 1-3 hodiny v závislosti od hĺbky prieskumu. > **Rýchly štart** -1. Vytvorte fork tohto repozitára do svojho GitHub účtu -2. Kliknite na **Code** → kartu **Codespaces** → **...** → **New with options...** -3. Použite predvolené nastavenia – to vyberie Development kontajner vytvorený pre tento kurz +1. Vytvorte fork tohto repozitára na svoj GitHub účet +2. Kliknite na **Code** → záložka **Codespaces** → **...** → **New with options...** +3. Použite predvolené nastavenia – vyberie sa Vývojový kontajner vytvorený pre tento kurz 4. Kliknite na **Create codespace** 5. Počkajte ~2 minúty, kým bude prostredie pripravené 6. Prejdite priamo na [Prvý príklad](./02-SetupDevEnvironment/README.md#step-2-create-a-github-personal-access-token) > **Radšej klonovať lokálne?** > -> Tento repozitár obsahuje viac než 50 jazykových prekladov, ktoré výrazne zvyšujú veľkosť sťahovania. Ak chcete klonovať bez prekladov, použite sparse checkout: +> Tento repozitár obsahuje viac ako 50 jazykových prekladov, čo výrazne zväčšuje veľkosť sťahovania. Ak chcete klonovať bez prekladov, použite spars checkout: > ```bash > git clone --filter=blob:none --sparse https://github.com/microsoft/Generative-AI-for-beginners-java.git > cd Generative-AI-for-beginners-java > git sparse-checkout set --no-cone '/*' '!translations' '!translated_images' > ``` -> Toto vám poskytne všetko potrebné na dokončenie kurzu a oveľa rýchlejší download. +> To vám poskytne všetko potrebné na dokončenie kurzu so oveľa rýchlejším stiahnutím. ## Podpora viacerých jazykov @@ -39,55 +30,55 @@ CO_OP_TRANSLATOR_METADATA: ### Podporované cez GitHub Action (automatizované a vždy aktuálne) -[Arabčina](../ar/README.md) | [Bengálčina](../bn/README.md) | [Bulharčina](../bg/README.md) | [Barmčina (Myanmar)](../my/README.md) | [Čínština (zjednodušená)](../zh/README.md) | [Čínština (tradičná, Hong Kong)](../hk/README.md) | [Čínština (tradičná, Macau)](../mo/README.md) | [Čínština (tradičná, Taiwan)](../tw/README.md) | [Chorvátčina](../hr/README.md) | [Čeština](../cs/README.md) | [Dánčina](../da/README.md) | [Holandčina](../nl/README.md) | [Estónčina](../et/README.md) | [Fínčina](../fi/README.md) | [Francúzština](../fr/README.md) | [Nemčina](../de/README.md) | [Gréčtina](../el/README.md) | [Hebrejčina](../he/README.md) | [Hindčina](../hi/README.md) | [Maďarčina](../hu/README.md) | [Indonézština](../id/README.md) | [Taliančina](../it/README.md) | [Japončina](../ja/README.md) | [Kannadčina](../kn/README.md) | [Kórejčina](../ko/README.md) | [Litovčina](../lt/README.md) | [Malajčina](../ms/README.md) | [Malayalam](../ml/README.md) | [Maráthčina](../mr/README.md) | [Nepálčina](../ne/README.md) | [Nigérijský pidžin](../pcm/README.md) | [Nórčina](../no/README.md) | [Perzština (Farsi)](../fa/README.md) | [Poľština](../pl/README.md) | [Portugalčina (Brazília)](../br/README.md) | [Portugalčina (Portugalsko)](../pt/README.md) | [Pandžábčina (Gurmukhi)](../pa/README.md) | [Rumunčina](../ro/README.md) | [Ruština](../ru/README.md) | [Srbčina (Cyrilika)](../sr/README.md) | [Slovenčina](./README.md) | [Slovinčina](../sl/README.md) | [Španielčina](../es/README.md) | [Svahilčina](../sw/README.md) | [Švédčina](../sv/README.md) | [Tagalog (Filipínčina)](../tl/README.md) | [Tamilčina](../ta/README.md) | [Telugčina](../te/README.md) | [Thajčina](../th/README.md) | [Turečtina](../tr/README.md) | [Ukrajinčina](../uk/README.md) | [Urdu](../ur/README.md) | [Vietnamčina](../vi/README.md) +[Arabčina](../ar/README.md) | [Bengálčina](../bn/README.md) | [Bulharčina](../bg/README.md) | [Barmčina (Myanmar)](../my/README.md) | [Čínština (zjednodušená)](../zh-CN/README.md) | [Čínština (tradičná, Hongkong)](../zh-HK/README.md) | [Čínština (tradičná, Macao)](../zh-MO/README.md) | [Čínština (tradičná, Taiwan)](../zh-TW/README.md) | [Chorvátčina](../hr/README.md) | [Čeština](../cs/README.md) | [Dánčina](../da/README.md) | [Holandčina](../nl/README.md) | [Estónčina](../et/README.md) | [Fínčina](../fi/README.md) | [Francúzština](../fr/README.md) | [Nemčina](../de/README.md) | [Gréčtina](../el/README.md) | [Hebrejčina](../he/README.md) | [Hindčina](../hi/README.md) | [Maďarčina](../hu/README.md) | [Indonézština](../id/README.md) | [Taliančina](../it/README.md) | [Japončina](../ja/README.md) | [Kannadčina](../kn/README.md) | [Kórejčina](../ko/README.md) | [Litovčina](../lt/README.md) | [Malajčina](../ms/README.md) | [Malajálamčina](../ml/README.md) | [Maráthčina](../mr/README.md) | [Nepálčina](../ne/README.md) | [Nigérijský pidžin](../pcm/README.md) | [Nórčina](../no/README.md) | [Perzština (Farsi)](../fa/README.md) | [Poľština](../pl/README.md) | [Portugalčina (Brazília)](../pt-BR/README.md) | [Portugalčina (Portugalsko)](../pt-PT/README.md) | [Pandžábčina (Gurmukhí)](../pa/README.md) | [Rumunčina](../ro/README.md) | [Ruština](../ru/README.md) | [Srbčina (cyrilika)](../sr/README.md) | [Slovenčina](./README.md) | [Slovinčina](../sl/README.md) | [Španielčina](../es/README.md) | [Svahilčina](../sw/README.md) | [Švédčina](../sv/README.md) | [Tagalog (Filipínčina)](../tl/README.md) | [Tamilčina](../ta/README.md) | [Telugčina](../te/README.md) | [Thajčina](../th/README.md) | [Turečtina](../tr/README.md) | [Ukrajinčina](../uk/README.md) | [Urdu](../ur/README.md) | [Vietnamčina](../vi/README.md) > **Radšej klonovať lokálne?** -> Tento repozitár obsahuje viac než 50 jazykových prekladov, ktoré výrazne zvyšujú veľkosť sťahovania. Ak chcete klonovať bez prekladov, použite sparse checkout: +> Tento repozitár obsahuje viac ako 50 jazykových prekladov, čo výrazne zväčšuje veľkosť sťahovania. Ak chcete klonovať bez prekladov, použite spars checkout: > ```bash > git clone --filter=blob:none --sparse https://github.com/microsoft/Generative-AI-for-beginners-java.git > cd Generative-AI-for-beginners-java > git sparse-checkout set --no-cone '/*' '!translations' '!translated_images' > ``` -> Toto vám poskytne všetko potrebné na dokončenie kurzu a oveľa rýchlejší download. +> To vám poskytne všetko potrebné na dokončenie kurzu so oveľa rýchlejším stiahnutím. -## Štruktúra kurzu a učebná cesta +## Štruktúra kurzu a vzdelávacia cesta ### **Kapitola 1: Úvod do generatívnej AI** - **Základné koncepty**: Pochopenie veľkých jazykových modelov, tokenov, embeddingov a schopností AI -- **Java AI ekosystém**: Prehľad Spring AI a OpenAI SDK +- **Ekosystém Java AI**: Prehľad Spring AI a OpenAI SDK knižníc - **Protokol kontextu modelu**: Úvod do MCP a jeho úloha v komunikácii AI agentov -- **Praktické aplikácie**: Reálne scenáre vrátane chatbotov a generovania obsahu +- **Praktické použitia**: Reálne scenáre vrátane chatbotov a generovania obsahu - **[→ Začať kapitolu 1](./01-IntroToGenAI/README.md)** ### **Kapitola 2: Nastavenie vývojového prostredia** -- **Konfigurácia viacerých poskytovateľov**: Nastavenie GitHub modelov, Azure OpenAI a OpenAI Java SDK integrácií +- **Konfigurácia viacerých poskytovateľov**: Nastavenie GitHub Models, Azure OpenAI a OpenAI Java SDK integrácií - **Spring Boot + Spring AI**: Najlepšie praktiky pre vývoj podnikových AI aplikácií -- **GitHub modely**: Bezplatný prístup k AI modelom na prototypovanie a učenie (bez potreby kreditnej karty) -- **Vývojové nástroje**: Docker kontajnery, VS Code a konfigurácia GitHub Codespaces +- **GitHub Models**: Bezplatný prístup k AI modelom na prototypovanie a učenie (bez potreby kreditnej karty) +- **Nástroje pre vývoj**: Docker kontajnery, VS Code a konfigurácia GitHub Codespaces - **[→ Začať kapitolu 2](./02-SetupDevEnvironment/README.md)** ### **Kapitola 3: Základné techniky generatívnej AI** -- **Prompt engineering**: Techniky pre optimálne odpovede AI modelov -- **Embeddingy a vektorové operácie**: Implementácia semantického vyhľadávania a porovnávania podobnosti -- **Retrieval-Augmented Generation (RAG)**: Kombinovanie AI s vlastnými dátovými zdrojmi -- **Volanie funkcií**: Rozšírenie schopností AI vlastnými nástrojmi a pluginmi +- **Prompt Engineering**: Techniky pre optimálne odpovede AI modelov +- **Embeddings a vektorové operácie**: Implementácia sémantického vyhľadávania a porovnávania podobnosti +- **Retrieval-Augmented Generation (RAG)**: Kombinácia AI s vlastnými zdrojmi dát +- **Volanie funkcií**: Rozšírenie schopností AI pomocou vlastných nástrojov a pluginov - **[→ Začať kapitolu 3](./03-CoreGenerativeAITechniques/README.md)** -### **Kapitola 4: Praktické aplikácie a projekty** -- **Generátor príbehov o domácich zvieratách** (`petstory/`): Kreatívne generovanie obsahu pomocou GitHub modelov +### **Kapitola 4: Praktické použitia a projekty** +- **Generátor príbehov o zvieratkách** (`petstory/`): Kreatívne generovanie obsahu s GitHub Models - **Foundry lokálna demo** (`foundrylocal/`): Lokálna integrácia AI modelu s OpenAI Java SDK -- **MCP kalkulačná služba** (`calculator/`): Základná implementácia Model Context Protocol s Spring AI +- **Služba kalkulačky MCP** (`calculator/`): Základná implementácia Model Context Protocol so Spring AI - **[→ Začať kapitolu 4](./04-PracticalSamples/README.md)** ### **Kapitola 5: Zodpovedný vývoj AI** -- **Bezpečnosť GitHub modelov**: Testovanie zabudovaného filtrovania obsahu a bezpečnostných mechanizmov (tvrdé blokovania a mäkké odmietnutia) -- **Demo zodpovednej AI**: Praktický príklad ukazujúci, ako fungujú moderné bezpečnostné systémy AI -- **Najlepšie praktiky**: Kľúčové usmernenia pre etický vývoj a nasadzovanie AI +- **Bezpečnosť GitHub Models**: Testovanie vstavaných filtrov obsahu a bezpečnostných mechanizmov (tvrdé bloky a jemné odmietnutia) +- **Demo zodpovednej AI**: Praktický príklad ukazujúci, ako fungujú moderné bezpečnostné systémy AI v praxi +- **Najlepšie praktiky**: Zásadné usmernenia pre etický vývoj a nasadenie AI - **[→ Začať kapitolu 5](./05-ResponsibleGenAI/README.md)** -## Ďalšie zdroje +## Dodatočné zdroje ### LangChain @@ -96,15 +87,15 @@ CO_OP_TRANSLATOR_METADATA: --- -### Azure / Edge / MCP / Agenti +### Azure / Edge / MCP / Agentúry [![AZD pre začiatočníkov](https://img.shields.io/badge/AZD%20for%20Beginners-0078D4?style=for-the-badge&labelColor=E5E7EB&color=0078D4)](https://github.com/microsoft/AZD-for-beginners?WT.mc_id=academic-105485-koreyst) [![Edge AI pre začiatočníkov](https://img.shields.io/badge/Edge%20AI%20for%20Beginners-00B8E4?style=for-the-badge&labelColor=E5E7EB&color=00B8E4)](https://github.com/microsoft/edgeai-for-beginners?WT.mc_id=academic-105485-koreyst) [![MCP pre začiatočníkov](https://img.shields.io/badge/MCP%20for%20Beginners-009688?style=for-the-badge&labelColor=E5E7EB&color=009688)](https://github.com/microsoft/mcp-for-beginners?WT.mc_id=academic-105485-koreyst) -[![AI agenti pre začiatočníkov](https://img.shields.io/badge/AI%20Agents%20for%20Beginners-00C49A?style=for-the-badge&labelColor=E5E7EB&color=00C49A)](https://github.com/microsoft/ai-agents-for-beginners?WT.mc_id=academic-105485-koreyst) +[![AI Agentúry pre začiatočníkov](https://img.shields.io/badge/AI%20Agents%20for%20Beginners-00C49A?style=for-the-badge&labelColor=E5E7EB&color=00C49A)](https://github.com/microsoft/ai-agents-for-beginners?WT.mc_id=academic-105485-koreyst) --- -### Generatívna AI séria +### Séria generatívnej AI [![Generatívna AI pre začiatočníkov](https://img.shields.io/badge/Generative%20AI%20for%20Beginners-8B5CF6?style=for-the-badge&labelColor=E5E7EB&color=8B5CF6)](https://github.com/microsoft/generative-ai-for-beginners?WT.mc_id=academic-105485-koreyst) [![Generatívna AI (.NET)](https://img.shields.io/badge/Generative%20AI%20(.NET)-9333EA?style=for-the-badge&labelColor=E5E7EB&color=9333EA)](https://github.com/microsoft/Generative-AI-for-beginners-dotnet?WT.mc_id=academic-105485-koreyst) [![Generatívna AI (Java)](https://img.shields.io/badge/Generative%20AI%20(Java)-C084FC?style=for-the-badge&labelColor=E5E7EB&color=C084FC)](https://github.com/microsoft/generative-ai-for-beginners-java?WT.mc_id=academic-105485-koreyst) @@ -112,12 +103,12 @@ CO_OP_TRANSLATOR_METADATA: --- -### Základné vzdelávanie +### Základné učenie [![ML pre začiatočníkov](https://img.shields.io/badge/ML%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=22C55E)](https://aka.ms/ml-beginners?WT.mc_id=academic-105485-koreyst) [![Data Science pre začiatočníkov](https://img.shields.io/badge/Data%20Science%20for%20Beginners-84CC16?style=for-the-badge&labelColor=E5E7EB&color=84CC16)](https://aka.ms/datascience-beginners?WT.mc_id=academic-105485-koreyst) [![AI pre začiatočníkov](https://img.shields.io/badge/AI%20for%20Beginners-A3E635?style=for-the-badge&labelColor=E5E7EB&color=A3E635)](https://aka.ms/ai-beginners?WT.mc_id=academic-105485-koreyst) -[![Kyberbezpečnosť pre začiatočníkov](https://img.shields.io/badge/Cybersecurity%20for%20Beginners-F97316?style=for-the-badge&labelColor=E5E7EB&color=F97316)](https://github.com/microsoft/Security-101?WT.mc_id=academic-96948-sayoung) -[![Webový vývoj pre začiatočníkov](https://img.shields.io/badge/Web%20Dev%20for%20Beginners-EC4899?style=for-the-badge&labelColor=E5E7EB&color=EC4899)](https://aka.ms/webdev-beginners?WT.mc_id=academic-105485-koreyst) +[![Kybernetická bezpečnosť pre začiatočníkov](https://img.shields.io/badge/Cybersecurity%20for%20Beginners-F97316?style=for-the-badge&labelColor=E5E7EB&color=F97316)](https://github.com/microsoft/Security-101?WT.mc_id=academic-96948-sayoung) +[![Web Dev for Beginners](https://img.shields.io/badge/Web%20Dev%20for%20Beginners-EC4899?style=for-the-badge&labelColor=E5E7EB&color=EC4899)](https://aka.ms/webdev-beginners?WT.mc_id=academic-105485-koreyst) [![IoT for Beginners](https://img.shields.io/badge/IoT%20for%20Beginners-14B8A6?style=for-the-badge&labelColor=E5E7EB&color=14B8A6)](https://aka.ms/iot-beginners?WT.mc_id=academic-105485-koreyst) [![XR Development for Beginners](https://img.shields.io/badge/XR%20Development%20for%20Beginners-38BDF8?style=for-the-badge&labelColor=E5E7EB&color=38BDF8)](https://github.com/microsoft/xr-development-for-beginners?WT.mc_id=academic-105485-koreyst) @@ -131,17 +122,17 @@ CO_OP_TRANSLATOR_METADATA: ## Získanie pomoci -Ak máte problém alebo máte otázky ohľadom tvorby AI aplikácií, pripojte sa k ostatným študentom a skúseným vývojárom v diskusiách o MCP. Je to podporná komunita, kde sú otázky vítané a vedomosti sa slobodne zdieľajú. +Ak sa zaseknete alebo máte akékoľvek otázky ohľadom tvorby AI aplikácií. Pridajte sa ku komunite študentov a skúsených vývojárov, ktorí diskutujú o MCP. Je to podporná komunita, kde sú otázky vítané a znalosti sa slobodne zdieľajú. [![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) -Ak máte spätnú väzbu k produktu alebo narazíte na chyby počas vývoja, navštívte: +Ak máte spätnú väzbu k produktu alebo chyby počas vývoja, navštívte: [![Microsoft Foundry Developer Forum](https://img.shields.io/badge/GitHub-Microsoft_Foundry_Developer_Forum-blue?style=for-the-badge&logo=github&color=000000&logoColor=fff)](https://aka.ms/foundry/forum) --- -**Upozornenie**: -Tento dokument bol preložený pomocou AI prekladateľskej služby [Co-op Translator](https://github.com/Azure/co-op-translator). Aj keď sa snažíme o presnosť, prosíme, berte na vedomie, že automatizované preklady môžu obsahovať chyby alebo nepresnosti. Pôvodný dokument v jeho natívnom jazyku by mal byť považovaný za autoritatívny zdroj. Pre dôležité informácie sa odporúča profesionálny ľudský preklad. Nie sme zodpovední za žiadne nedorozumenia alebo nesprávne interpretácie vyplývajúce z použitia tohto prekladu. +**Vyhlásenie o zodpovednosti**: +Tento dokument bol preložený pomocou AI prekladateľskej služby [Co-op Translator](https://github.com/Azure/co-op-translator). Aj keď sa snažíme o presnosť, berte prosím na vedomie, že automatizované preklady môžu obsahovať chyby alebo nepresnosti. Originálny dokument v pôvodnom jazyku by mal byť považovaný za autoritatívny zdroj. Pre kľúčové informácie sa odporúča profesionálny ľudský preklad. Nie sme zodpovední za akékoľvek nepochopenia alebo nesprávne interpretácie vyplývajúce z používania tohto prekladu. \ No newline at end of file diff --git a/translations/sk/SECURITY.md b/translations/sk/SECURITY.md index f0661a7e..ce51dd66 100644 --- a/translations/sk/SECURITY.md +++ b/translations/sk/SECURITY.md @@ -1,12 +1,3 @@ - ## Bezpečnosť Spoločnosť Microsoft berie bezpečnosť svojich softvérových produktov a služieb vážne, čo zahŕňa aj všetky repozitáre zdrojového kódu spravované prostredníctvom našich GitHub organizácií, medzi ktoré patria [Microsoft](https://github.com/Microsoft), [Azure](https://github.com/Azure), [DotNet](https://github.com/dotnet), [AspNet](https://github.com/aspnet) a [Xamarin](https://github.com/xamarin). diff --git a/translations/sk/SUPPORT.md b/translations/sk/SUPPORT.md index 1448fc4c..a25f8ee6 100644 --- a/translations/sk/SUPPORT.md +++ b/translations/sk/SUPPORT.md @@ -1,12 +1,3 @@ - # Podpora ## Ako nahlásiť problémy a získať pomoc diff --git a/translations/sl/.co-op-translator.json b/translations/sl/.co-op-translator.json new file mode 100644 index 00000000..ff305f52 --- /dev/null +++ b/translations/sl/.co-op-translator.json @@ -0,0 +1,92 @@ +{ + "01-IntroToGenAI/README.md": { + "original_hash": "75bfb080ca725e8a9aa9c80cae25fba1", + "translation_date": "2025-07-29T10:24:20+00:00", + "source_file": "01-IntroToGenAI/README.md", + "language_code": "sl" + }, + "02-SetupDevEnvironment/README.md": { + "original_hash": "96a30d42b9751a3d4e4b20e28d29d459", + "translation_date": "2026-01-28T05:26:48+00:00", + "source_file": "02-SetupDevEnvironment/README.md", + "language_code": "sl" + }, + "02-SetupDevEnvironment/examples/basic-chat-azure/README.md": { + "original_hash": "efd82efe50711d7e257eb943151d682c", + "translation_date": "2025-07-27T13:48:30+00:00", + "source_file": "02-SetupDevEnvironment/examples/basic-chat-azure/README.md", + "language_code": "sl" + }, + "02-SetupDevEnvironment/getting-started-azure-openai.md": { + "original_hash": "bfdb4b4eadbee3a59ef742439f58326a", + "translation_date": "2025-07-27T13:29:49+00:00", + "source_file": "02-SetupDevEnvironment/getting-started-azure-openai.md", + "language_code": "sl" + }, + "03-CoreGenerativeAITechniques/README.md": { + "original_hash": "685f55cb07de19b52a30ce6e8b6d889e", + "translation_date": "2025-08-28T22:18:57+00:00", + "source_file": "03-CoreGenerativeAITechniques/README.md", + "language_code": "sl" + }, + "04-PracticalSamples/README.md": { + "original_hash": "14c0a61ecc1cd2012a9c129236dfdf71", + "translation_date": "2025-07-29T10:24:05+00:00", + "source_file": "04-PracticalSamples/README.md", + "language_code": "sl" + }, + "04-PracticalSamples/calculator/README.md": { + "original_hash": "b6c16b5514d524e415a94f6097ee7d4c", + "translation_date": "2025-09-18T15:43:44+00:00", + "source_file": "04-PracticalSamples/calculator/README.md", + "language_code": "sl" + }, + "04-PracticalSamples/foundrylocal/README.md": { + "original_hash": "f787307400de59adc25a1404466a35f3", + "translation_date": "2025-11-04T07:36:23+00:00", + "source_file": "04-PracticalSamples/foundrylocal/README.md", + "language_code": "sl" + }, + "04-PracticalSamples/petstory/README.md": { + "original_hash": "0cbf68d605615a1e602c832a24616859", + "translation_date": "2025-07-25T12:06:13+00:00", + "source_file": "04-PracticalSamples/petstory/README.md", + "language_code": "sl" + }, + "05-ResponsibleGenAI/README.md": { + "original_hash": "301c05c2f57e60a6950b8c665b8bdbba", + "translation_date": "2025-07-29T16:01:01+00:00", + "source_file": "05-ResponsibleGenAI/README.md", + "language_code": "sl" + }, + "AGENTS.md": { + "original_hash": "afc90918d008cf77fd1982691f681306", + "translation_date": "2025-10-03T08:45:20+00:00", + "source_file": "AGENTS.md", + "language_code": "sl" + }, + "CODE_OF_CONDUCT.md": { + "original_hash": "442b123d034f92f7c384d2bbd28f99f1", + "translation_date": "2025-07-21T20:38:03+00:00", + "source_file": "CODE_OF_CONDUCT.md", + "language_code": "sl" + }, + "README.md": { + "original_hash": "125a08948d881c95628094f4dd1fbd43", + "translation_date": "2026-01-29T16:17:20+00:00", + "source_file": "README.md", + "language_code": "sl" + }, + "SECURITY.md": { + "original_hash": "57f14126c1c6add76b3aef3844dfe4e3", + "translation_date": "2025-07-21T20:36:24+00:00", + "source_file": "SECURITY.md", + "language_code": "sl" + }, + "SUPPORT.md": { + "original_hash": "b8ef73cc49dec68e2c885ee9df545129", + "translation_date": "2025-07-21T20:39:19+00:00", + "source_file": "SUPPORT.md", + "language_code": "sl" + } +} \ No newline at end of file diff --git a/translations/sl/01-IntroToGenAI/README.md b/translations/sl/01-IntroToGenAI/README.md index f04b610c..3a2e9541 100644 --- a/translations/sl/01-IntroToGenAI/README.md +++ b/translations/sl/01-IntroToGenAI/README.md @@ -1,12 +1,3 @@ - # Uvod v generativno umetno inteligenco - Java izdaja ## Kaj boste spoznali diff --git a/translations/sl/02-SetupDevEnvironment/README.md b/translations/sl/02-SetupDevEnvironment/README.md index cc32dcec..54552e53 100644 --- a/translations/sl/02-SetupDevEnvironment/README.md +++ b/translations/sl/02-SetupDevEnvironment/README.md @@ -1,13 +1,254 @@ - +# Nastavitev razvojnega okolja za Generativno umetno inteligenco za Javo +> **Hiter začetek**: Kodirajte v oblaku v 2 minutah - Pojdite na [Nastavitev GitHub Codespaces](../../../02-SetupDevEnvironment) - ni potrebno lokalno nameščanje in uporablja github modele! + +> **Vas zanima Azure OpenAI?**, oglejte si naš [Vodnik za nastavitev Azure OpenAI](getting-started-azure-openai.md) z navodili za ustvarjanje nove Azure OpenAI storitve. + +## Kaj boste izvedeli + +- Nastavitev razvojnega okolja za AI aplikacije v Javi +- Izbira in konfiguracija vašega priljubljenega razvojnega okolja (oblak z Codespaces, lokalni razvojni kontejner ali popolna lokalna nastavitev) +- Testiranje nastavitve z povezavo do GitHub modelov + +## Kazalo + +- [Kaj boste izvedeli](../../../02-SetupDevEnvironment) +- [Uvod](../../../02-SetupDevEnvironment) +- [Korak 1: Nastavite razvojno okolje](../../../02-SetupDevEnvironment) + - [Možnost A: GitHub Codespaces (priporočeno)](../../../02-SetupDevEnvironment) + - [Možnost B: Lokalni razvojni kontejner](../../../02-SetupDevEnvironment) + - [Možnost C: Uporabite obstoječo lokalno namestitev](../../../02-SetupDevEnvironment) +- [Korak 2: Ustvarite osebni dostopni žeton GitHub](../../../02-SetupDevEnvironment) +- [Korak 3: Testirajte svojo nastavitev](../../../02-SetupDevEnvironment) +- [Reševanje težav](../../../02-SetupDevEnvironment) +- [Povzetek](../../../02-SetupDevEnvironment) +- [Nadaljnji koraki](../../../02-SetupDevEnvironment) + +## Uvod + +Ta poglavje vas bo vodilo pri nastavitvi razvojnega okolja. Za naš glavni primer bomo uporabili **GitHub Models**, saj je brezplačen, enostaven za nastavitev z le GitHub računom, ne zahteva kreditne kartice in omogoča dostop do več modelov za eksperimentiranje. + +**Ni potrebna lokalna namestitev!** Takoj lahko začnete kodirati z uporabo GitHub Codespaces, ki zagotavlja popolno razvojno okolje v vašem brskalniku. + +Posnetek zaslona: GitHub Models + +Priporočamo uporabo [**GitHub Models**](https://github.com/marketplace?type=models) za ta tečaj, ker je: +- **Brezplačen** za začetek +- **Enostaven** za nastavitev z le GitHub računom +- **Ni potrebna kreditna kartica** +- Na voljo je **več modelov** za eksperimentiranje + +> **Opomba**: GitHub Models uporabljeni v tem usposabljanju imajo te brezplačne omejitve: +> - 15 zahtevkov na minuto (150 na dan) +> - približno 8.000 besed vhodnih, približno 4.000 besed izhodnih na zahtevek +> - 5 sočasnih zahtevkov +> +> Za produkcijsko uporabo nadgradite na Azure AI Foundry Models z vašim Azure računom. Vaša koda ni potreben spreminjati. Oglejte si [dokumentacijo Azure AI Foundry](https://learn.microsoft.com/azure/ai-foundry/foundry-models/how-to/quickstart-github-models). + + +## Korak 1: Nastavite razvojno okolje + + + +Ustvarili smo prednastavljen razvojni kontejner, da skrajšamo čas nastavitve in zagotovimo, da imate vse potrebne programe za ta tečaj Generativne AI za Javo. Izberite svoj priljubljeni način razvoja: + +### Možnosti nastavitev okolja: + +#### Možnost A: GitHub Codespaces (priporočeno) + +**Začnite kodirati v 2 minutah - ni potrebna lokalna namestitev!** + +1. Forkajte to repozitorij na svoj GitHub račun + > **Opomba**: Če želite spremeniti osnovno konfiguracijo, si oglejte [Dev Container Configuration](../../../.devcontainer/devcontainer.json) +2. Kliknite **Code** → zavihek **Codespaces** → **...** → **Novo z možnostmi...** +3. Uporabite privzete nastavitve – izbrana bo **Dev container konfiguracija**: **Generative AI Java Development Environment** po meri ustvarjen za ta tečaj +4. Kliknite **Ustvari codespace** +5. Počakajte približno 2 minuti, da je okolje pripravljeno +6. Nadaljujte na [Korak 2: Ustvarite GitHub žeton](../../../02-SetupDevEnvironment) + +Posnetek zaslona: Podmeni Codespaces + +Posnetek zaslona: Novo z možnostmi + +Posnetek zaslona: Možnosti ustvarjanja codespace + + +> **Prednosti Codespaces:** +> - Ni potrebna lokalna namestitev +> - Deluje na kateri koli napravi z brskalnikom +> - Prednastavljeno z vsemi orodji in odvisnostmi +> - Brezplačno 60 ur na mesec za osebne račune +> - Konsistentno okolje za vse udeležence + +#### Možnost B: Lokalni razvojni kontejner + +**Za razvijalce, ki imajo raje lokalni razvoj z Dockerjem** + +1. Forkajte in klonirajte ta repozitorij na svoj lokalni računalnik + > **Opomba**: Če želite spremeniti osnovno konfiguracijo, si oglejte [Dev Container Configuration](../../../.devcontainer/devcontainer.json) +2. Namestite [Docker Desktop](https://www.docker.com/products/docker-desktop/) in [VS Code](https://code.visualstudio.com/) +3. Namestite [razširitev Dev Containers](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers) v VS Code +4. Odprite mapo repozitorija v VS Code +5. Ko ste pozvani, kliknite **Ponovno odpri v kontejnerju** (ali uporabite `Ctrl+Shift+P` → "Dev Containers: Reopen in Container") +6. Počakajte, da se kontejner zgradi in zažene +7. Nadaljujte na [Korak 2: Ustvarite GitHub žeton](../../../02-SetupDevEnvironment) + +Posnetek zaslona: Nastavitev razvojnega kontejnerja + +Posnetek zaslona: Kontejner zgrajen + +#### Možnost C: Uporabite obstoječo lokalno namestitev + +**Za razvijalce z obstoječimi Java okolji** + +Pogoji: +- [Java 21+](https://www.oracle.com/java/technologies/javase/jdk21-archive-downloads.html) +- [Maven 3.9+](https://maven.apache.org/download.cgi) +- [VS Code](https://code.visualstudio.com) ali vaš priljubljeni IDE + +Koraki: +1. Klonirajte ta repozitorij na svoj lokalni računalnik +2. Odprite projekt v vašem IDE-ju +3. Nadaljujte na [Korak 2: Ustvarite GitHub žeton](../../../02-SetupDevEnvironment) + +> **Pameten nasvet**: Če imate računalnik z nizko zmogljivostjo, a želite lokalni VS Code, uporabite GitHub Codespaces! Vaš lokalni VS Code lahko povežete na oblak gostujoči Codespace za najboljše iz obeh svetov. + +Posnetek zaslona: Ustvarjen lokalni devcontainer primer + + +## Korak 2: Ustvarite osebni dostopni žeton GitHub + +1. Pojdite na [GitHub Nastavitve](https://github.com/settings/profile) in izberite **Settings** v meniju vašega profila. +2. V levem stranskem meniju kliknite **Developer settings** (običajno na dnu). +3. Pod **Personal access tokens**, kliknite **Fine-grained tokens** (ali sledite tej neposredni [povezavi](https://github.com/settings/personal-access-tokens)). +4. Kliknite **Generate new token**. +5. Pod "Token name" vnesite opisno ime (npr. `GenAI-Java-Course-Token`). +6. Nastavite datum poteka (priporočeno: 7 dni za varnostne prakse). +7. Pod "Resource owner" izberite svoj uporabniški račun. +8. Pod "Repository access" izberite repozitorije, ki jih želite uporabljati z GitHub modeli (ali "All repositories", če je potrebno). +9. Pod "Account permissions" poiščite **Models** in nastavite na **Samo za branje**. +10. Kliknite **Generate token**. +11. **Kopirajte in shranite svoj žeton zdaj** – ne boste ga več videli! + +> **Varnostni nasvet**: Uporabite najmanjšo potrebno obseg in najkrajši praktični čas poteka za vaše žetone dostopa. + +## Korak 3: Testirajte svojo nastavitev z GitHub Models primerom + +Ko je razvojno okolje pripravljeno, preizkusimo integracijo GitHub Modelov z našo primer aplikacijo v [`02-SetupDevEnvironment/examples/github-models`](../../../02-SetupDevEnvironment/examples/github-models). + +1. Odprite terminal v vašem razvojnem okolju. +2. Pojdite do GitHub Models primera: + ```bash + cd 02-SetupDevEnvironment/examples/github-models + ``` +3. Nastavite svoj GitHub žeton kot okoljsko spremenljivko: + ```bash + # macOS/Linux + export GITHUB_TOKEN=your_token_here + + # Windows (Ukazni poziv) + set GITHUB_TOKEN=your_token_here + + # Windows (PowerShell) + $env:GITHUB_TOKEN="your_token_here" + ``` + +4. Zaženite aplikacijo: + ```bash + mvn compile exec:java -Dexec.mainClass="com.example.githubmodels.App" + ``` + +Videli boste izhod, podoben temu: +```text +Using model: gpt-4.1-nano +Sending request to GitHub Models... +Response: Hello World! +``` + +### Razumevanje primerne kode + +Najprej razumimo, kaj smo pravkar zagnali. Primer pod `examples/github-models` uporablja OpenAI Java SDK za povezavo z GitHub Models: + +**Kaj ta koda počne:** +- **Poveže** se do GitHub Modelov z vašim osebnim dostopnim žetonom +- **Pošlje** preprosto sporočilo "Say Hello World!" AI modelu +- **Prejme** in prikaže odziv AI-ja +- **Preveri**, da vaša nastavitev deluje pravilno + +**Ključna odvisnost** (v `pom.xml`): +```xml + + com.openai + openai-java + 2.12.0 + +``` + +**Glavna koda** (`App.java`): +```java +// Povežite se z GitHub Modeli s pomočjo OpenAI Java SDK +OpenAIClient client = OpenAIOkHttpClient.builder() + .apiKey(pat) + .baseUrl("https://models.inference.ai.azure.com") + .build(); + +// Ustvarite zahtevek za dokončanje klepeta +ChatCompletionCreateParams params = ChatCompletionCreateParams.builder() + .model(modelId) + .addSystemMessage("You are a concise assistant.") + .addUserMessage("Say Hello World!") + .build(); + +// Pridobite AI odgovor +ChatCompletion response = client.chat().completions().create(params); +System.out.println("Response: " + response.choices().get(0).message().content().orElse("No response content")); +``` + +## Povzetek + +Super! Zdaj imate vse pripravljeno: + +- Ustvarjen osebni dostopni žeton GitHub z ustreznimi dovoljenji za dostop do AI modelov +- Tekne razvojno okolje Jave (ne glede na to, ali je to Codespaces, dev container ali lokalno) +- Povezali ste se z GitHub Models z uporabo OpenAI Java SDK za brezplačni AI razvoj +- Preizkusili ste, da vse deluje s preprostim primerom, ki komunicira z AI modeli + +## Nadaljnji koraki + +[Poglavje 3: Osnovne tehnike generativne umetne inteligence](../03-CoreGenerativeAITechniques/README.md) + +## Reševanje težav + +Imate težave? Tukaj so pogoste težave in rešitve: + +- **Žeton ne deluje?** + - Prepričajte se, da ste kopirali celoten žeton brez dodatnih presledkov + - Preverite, da je žeton pravilno nastavljen kot okoljska spremenljivka + - Preverite, ali ima vaš žeton pravilna dovoljenja (Models: samo za branje) + +- **Maven ni najden?** + - Če uporabljate dev containerje/Codespaces, bi moral biti Maven prednameščen + - Za lokalno nastavitev zagotovite, da imate nameščen Java 21+ in Maven 3.9+ + - Poskusite `mvn --version` za preverjanje namestitve + +- **Težave s povezavo?** + - Preverite internetno povezavo + - Preverite, ali je GitHub dostopen iz vašega omrežja + - Preverite, da niste za požarnim zidom, ki blokira GitHub Models endpoint + +- **Dev container se ne zažene?** + - Prepričajte se, da je Docker Desktop zagnan (za lokalni razvoj) + - Poskusite znova zgraditi kontejner: `Ctrl+Shift+P` → "Dev Containers: Rebuild Container" + +- **Napake pri prevajanju aplikacije?** + - Preverite, da ste v pravi mapi: `02-SetupDevEnvironment/examples/github-models` + - Poskusite počistiti in ponovno zgraditi: `mvn clean compile` + +> **Potrebujete pomoč?**: Če imate še vedno težave, odprite zadevo v repozitoriju in pomagali vam bomo. --- + +**Opozorilo**: +Ta dokument je bil preveden z uporabo AI prevajalske storitve [Co-op Translator](https://github.com/Azure/co-op-translator). Čeprav si prizadevamo za natančnost, bodite pozorni, da avtomatizirani prevodi lahko vsebujejo napake ali netočnosti. Izvirni dokument v njegovem izvornega jeziku velja za zavezujoč vir. Za ključne informacije priporočamo profesionalni človeški prevod. Nismo odgovorni za morebitne nesporazume ali napačne interpretacije, ki izhajajo iz uporabe tega prevoda. + \ No newline at end of file diff --git a/translations/sl/02-SetupDevEnvironment/examples/basic-chat-azure/README.md b/translations/sl/02-SetupDevEnvironment/examples/basic-chat-azure/README.md index c96b33d6..abe83c74 100644 --- a/translations/sl/02-SetupDevEnvironment/examples/basic-chat-azure/README.md +++ b/translations/sl/02-SetupDevEnvironment/examples/basic-chat-azure/README.md @@ -1,12 +1,3 @@ - # Osnovni klepet z Azure OpenAI - Primer od začetka do konca Ta primer prikazuje, kako ustvariti preprosto Spring Boot aplikacijo, ki se poveže z Azure OpenAI in preveri vašo nastavitev. diff --git a/translations/sl/02-SetupDevEnvironment/getting-started-azure-openai.md b/translations/sl/02-SetupDevEnvironment/getting-started-azure-openai.md index 27814f43..9e2ca1d2 100644 --- a/translations/sl/02-SetupDevEnvironment/getting-started-azure-openai.md +++ b/translations/sl/02-SetupDevEnvironment/getting-started-azure-openai.md @@ -1,12 +1,3 @@ - # Nastavitev razvojnega okolja za Azure OpenAI > **Hitri začetek**: Ta vodič je namenjen nastavitvi Azure OpenAI. Za takojšnji začetek z brezplačnimi modeli uporabite [GitHub Models with Codespaces](./README.md#quick-start-cloud). diff --git a/translations/sl/03-CoreGenerativeAITechniques/README.md b/translations/sl/03-CoreGenerativeAITechniques/README.md index a7cd7a22..2ca1f3bc 100644 --- a/translations/sl/03-CoreGenerativeAITechniques/README.md +++ b/translations/sl/03-CoreGenerativeAITechniques/README.md @@ -1,12 +1,3 @@ - # Vadnica o osnovnih tehnikah generativne umetne inteligence ## Kazalo diff --git a/translations/sl/04-PracticalSamples/README.md b/translations/sl/04-PracticalSamples/README.md index cd7934e9..f3bf189b 100644 --- a/translations/sl/04-PracticalSamples/README.md +++ b/translations/sl/04-PracticalSamples/README.md @@ -1,12 +1,3 @@ - # Praktične aplikacije in projekti ## Kaj se boste naučili diff --git a/translations/sl/04-PracticalSamples/calculator/README.md b/translations/sl/04-PracticalSamples/calculator/README.md index 78825e62..7104bae5 100644 --- a/translations/sl/04-PracticalSamples/calculator/README.md +++ b/translations/sl/04-PracticalSamples/calculator/README.md @@ -1,12 +1,3 @@ - # Vadnica za začetnike: MCP kalkulator ## Kazalo diff --git a/translations/sl/04-PracticalSamples/foundrylocal/README.md b/translations/sl/04-PracticalSamples/foundrylocal/README.md index 4045480e..b2d50bc1 100644 --- a/translations/sl/04-PracticalSamples/foundrylocal/README.md +++ b/translations/sl/04-PracticalSamples/foundrylocal/README.md @@ -1,12 +1,3 @@ - # Foundry Local Spring Boot Vadnica ## Kazalo diff --git a/translations/sl/04-PracticalSamples/petstory/README.md b/translations/sl/04-PracticalSamples/petstory/README.md index 362a161d..e2c6dc13 100644 --- a/translations/sl/04-PracticalSamples/petstory/README.md +++ b/translations/sl/04-PracticalSamples/petstory/README.md @@ -1,12 +1,3 @@ - # Vadnica za začetnike: Generator zgodb o hišnih ljubljenčkih ## Kazalo diff --git a/translations/sl/05-ResponsibleGenAI/README.md b/translations/sl/05-ResponsibleGenAI/README.md index 00616417..2bb5fca8 100644 --- a/translations/sl/05-ResponsibleGenAI/README.md +++ b/translations/sl/05-ResponsibleGenAI/README.md @@ -1,12 +1,3 @@ - # Odgovorna generativna umetna inteligenca ## Kaj se boste naučili diff --git a/translations/sl/AGENTS.md b/translations/sl/AGENTS.md index 5fce8b54..3d1abf20 100644 --- a/translations/sl/AGENTS.md +++ b/translations/sl/AGENTS.md @@ -1,12 +1,3 @@ - # AGENTS.md ## Pregled projekta diff --git a/translations/sl/CODE_OF_CONDUCT.md b/translations/sl/CODE_OF_CONDUCT.md index 10c0775a..4f8f72cf 100644 --- a/translations/sl/CODE_OF_CONDUCT.md +++ b/translations/sl/CODE_OF_CONDUCT.md @@ -1,12 +1,3 @@ - # Microsoftov kodeks ravnanja za odprtokodno programsko opremo Ta projekt je sprejel [Microsoftov kodeks ravnanja za odprtokodno programsko opremo](https://opensource.microsoft.com/codeofconduct/). diff --git a/translations/sl/README.md b/translations/sl/README.md index d426d9f9..caaa3959 100644 --- a/translations/sl/README.md +++ b/translations/sl/README.md @@ -1,90 +1,81 @@ - -# Generativna umetna inteligenca za začetnike - izdaja Java +# Generativna umetna inteligenca za začetnike - Java izdaja [![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) -![Generativna umetna inteligenca za začetnike - izdaja Java](../../translated_images/sl/beg-genai-series.8b48be9951cc574c.webp) +![Generativna umetna inteligenca za začetnike - Java izdaja](../../translated_images/sl/beg-genai-series.8b48be9951cc574c.webp) -**Časovna obveza**: Celoten delavnico je mogoče dokončati prek spleta brez lokalne namestitve. Nastavitev okolja traja 2 minuti, raziskovanje primerov pa zahteva 1–3 ure, odvisno od globine raziskovanja. +**Časovna zahteva**: Celoten delavnico lahko opravite na spletu brez lokalne namestitve. Nastavitev okolja traja 2 minuti, raziskovanje primerov pa 1–3 ure, odvisno od globine raziskovanja. -> **Hitri začetek** +> **Hiter začetek** -1. Ustvari fork tega repozitorija na svoj GitHub račun -2. Klikni **Code** → zavihek **Codespaces** → **...** → **New with options...** -3. Uporabi privzete nastavitve – to bo izbralo razvojni kontejner, ustvarjen za ta tečaj -4. Klikni **Create codespace** -5. Počakaj približno 2 minuti, da je okolje pripravljeno -6. Pojdi takoj na [Prvi primer](./02-SetupDevEnvironment/README.md#step-2-create-a-github-personal-access-token) +1. Razvejajte to repozitorij na svoj GitHub račun +2. Kliknite **Code** → zavihek **Codespaces** → **...** → **New with options...** +3. Uporabite privzete nastavitve – izbralo bo razvojno okolje ustvarjeno za ta tečaj +4. Kliknite **Create codespace** +5. Počakajte približno 2 minuti, da bo okolje pripravljeno +6. Takoj skočite na [Prvi primer](./02-SetupDevEnvironment/README.md#step-2-create-a-github-personal-access-token) -> **Raje kloniraš lokalno?** -> -> Ta repozitorij vključuje več kot 50 jezikovnih prevodov, kar občutno poveča velikost prenosa. Če želiš klonirati brez prevodov, uporabi sparse checkout: +> **Raje klonirate lokalno?** + +> Ta repozitorij vsebuje več kot 50 prevodov jezikov, kar znatno poveča velikost prenosa. Za kloniranje brez prevodov uporabite sparse checkout: > ```bash > git clone --filter=blob:none --sparse https://github.com/microsoft/Generative-AI-for-beginners-java.git > cd Generative-AI-for-beginners-java > git sparse-checkout set --no-cone '/*' '!translations' '!translated_images' > ``` -> Tako dobiš vse, kar potrebuješ za dokončanje tečaja, z veliko hitrejšim prenosom. +> To vam zagotovi vse, kar potrebujete za dokončanje tečaja z veliko hitrejšim prenosom. -## Podpora več jezikom +## Podpora več jezikov -### Podprto prek GitHub akcije (avtomatsko in vedno posodobljeno) +### Podprto preko GitHub Action (avtomatizirano in vedno posodobljeno) -[Arabščina](../ar/README.md) | [Bengalščina](../bn/README.md) | [Bolgarščina](../bg/README.md) | [Burmanski (Myanmar)](../my/README.md) | [Kitajščina (poenostavljena)](../zh/README.md) | [Kitajščina (tradicionalna, Hong Kong)](../hk/README.md) | [Kitajščina (tradicionalna, Macau)](../mo/README.md) | [Kitajščina (tradicionalna, Tajvan)](../tw/README.md) | [Hrvaščina](../hr/README.md) | [Češčina](../cs/README.md) | [Danščina](../da/README.md) | [Nizozemščina](../nl/README.md) | [Estonščina](../et/README.md) | [Finščina](../fi/README.md) | [Francoščina](../fr/README.md) | [Nemščina](../de/README.md) | [Grščina](../el/README.md) | [Hebrejščina](../he/README.md) | [Hindi](../hi/README.md) | [Madžarščina](../hu/README.md) | [Indonezijščina](../id/README.md) | [Italijanščina](../it/README.md) | [Japonščina](../ja/README.md) | [Kannada](../kn/README.md) | [Korejščina](../ko/README.md) | [Litovščina](../lt/README.md) | [Malajščina](../ms/README.md) | [Malajalščina](../ml/README.md) | [Maratščina](../mr/README.md) | [Nepalščina](../ne/README.md) | [Nigerijski pidžin](../pcm/README.md) | [Norveščina](../no/README.md) | [Perzijščina (Farsi)](../fa/README.md) | [Poljščina](../pl/README.md) | [Portugalščina (Brazilija)](../br/README.md) | [Portugalščina (Portugalska)](../pt/README.md) | [Pandžabščina (Gurmukhi)](../pa/README.md) | [Romunščina](../ro/README.md) | [Ruščina](../ru/README.md) | [Srbščina (cirilica)](../sr/README.md) | [Slovaščina](../sk/README.md) | [Slovenščina](./README.md) | [Španščina](../es/README.md) | [Svahili](../sw/README.md) | [Švedščina](../sv/README.md) | [Tagalog (Filipino)](../tl/README.md) | [Tamilščina](../ta/README.md) | [Telugu](../te/README.md) | [Tajščina](../th/README.md) | [Turščina](../tr/README.md) | [Ukrajinščina](../uk/README.md) | [Urdu](../ur/README.md) | [Vietnamščina](../vi/README.md) +[Arabščina](../ar/README.md) | [Bengalščina](../bn/README.md) | [Bolgarščina](../bg/README.md) | [Burmanski (Myanmar)](../my/README.md) | [Kitajščina (poenostavljena)](../zh-CN/README.md) | [Kitajščina (tradicionalna, Hong Kong)](../zh-HK/README.md) | [Kitajščina (tradicionalna, Macao)](../zh-MO/README.md) | [Kitajščina (tradicionalna, Tajvan)](../zh-TW/README.md) | [Hrvaščina](../hr/README.md) | [Češčina](../cs/README.md) | [Danščina](../da/README.md) | [Nizozemščina](../nl/README.md) | [Estonščina](../et/README.md) | [Finščina](../fi/README.md) | [Francoščina](../fr/README.md) | [Nemščina](../de/README.md) | [Grščina](../el/README.md) | [Hebrejščina](../he/README.md) | [Hindijščina](../hi/README.md) | [Madžarščina](../hu/README.md) | [Indonezijščina](../id/README.md) | [Italijanščina](../it/README.md) | [Japonščina](../ja/README.md) | [Kannada](../kn/README.md) | [Korejščina](../ko/README.md) | [Litovščina](../lt/README.md) | [Malajščina](../ms/README.md) | [Malajalščina](../ml/README.md) | [Maratščina](../mr/README.md) | [Nepalščina](../ne/README.md) | [Nigerijski pidžin](../pcm/README.md) | [Norveščina](../no/README.md) | [Perzijščina (Farsi)](../fa/README.md) | [Poljščina](../pl/README.md) | [Portugalščina (Brazilija)](../pt-BR/README.md) | [Portugalščina (Portugalska)](../pt-PT/README.md) | [Punjabi (Gurmukhi)](../pa/README.md) | [Romunščina](../ro/README.md) | [Ruščina](../ru/README.md) | [Srbščina (cirilica)](../sr/README.md) | [Slovaščina](../sk/README.md) | [Slovenščina](./README.md) | [Španščina](../es/README.md) | [Svahili](../sw/README.md) | [Švedščina](../sv/README.md) | [Tagalog (Filipino)](../tl/README.md) | [Tamil](../ta/README.md) | [Telugu](../te/README.md) | [Tajščina](../th/README.md) | [Turščina](../tr/README.md) | [Ukrajinščina](../uk/README.md) | [Urdu](../ur/README.md) | [Vietnamščina](../vi/README.md) -> **Raje kloniraš lokalno?** +> **Raje klonirate lokalno?** -> Ta repozitorij vključuje več kot 50 jezikovnih prevodov, kar občutno poveča velikost prenosa. Če želiš klonirati brez prevodov, uporabi sparse checkout: +> Ta repozitorij vsebuje več kot 50 prevodov jezikov, kar znatno poveča velikost prenosa. Za kloniranje brez prevodov uporabite sparse checkout: > ```bash > git clone --filter=blob:none --sparse https://github.com/microsoft/Generative-AI-for-beginners-java.git > cd Generative-AI-for-beginners-java > git sparse-checkout set --no-cone '/*' '!translations' '!translated_images' > ``` -> Tako dobiš vse, kar potrebuješ za dokončanje tečaja, z veliko hitrejšim prenosom. +> To vam zagotovi vse, kar potrebujete za dokončanje tečaja z veliko hitrejšim prenosom. ## Struktura tečaja in učna pot ### **Poglavje 1: Uvod v generativno umetno inteligenco** -- **Osnovni pojmi**: Razumevanje velikih jezikovnih modelov, tokenov, vdelav in zmogljivosti AI -- **Java AI ekosistem**: Pregled Spring AI in OpenAI SDK -- **Protokol konteksta modela**: Uvod v MCP in njegova vloga v komunikaciji AI agentov -- **Praktične uporabe**: Resnični scenariji, vključno s klepetalnimi roboti in generiranjem vsebine +- **Osnovni pojmi**: Razumevanje velikih jezikovnih modelov, tokenov, vdelav (embeddings) in zmogljivosti UI +- **Java AI ekosistem**: Pregled Spring AI in OpenAI SDK-jev +- **Protokol konteksta modela**: Uvod v MCP in njegova vloga pri komunikaciji UI agentov +- **Praktične uporabe**: Resnični primeri vključno s klepetalnimi roboti in generiranjem vsebin - **[→ Začni poglavje 1](./01-IntroToGenAI/README.md)** ### **Poglavje 2: Nastavitev razvojnega okolja** -- **Konfiguracija več ponudnikov**: Nastavi GitHub modele, Azure OpenAI in OpenAI Java SDK integracije -- **Spring Boot + Spring AI**: Najboljše prakse za razvoj podjetniških AI aplikacij -- **GitHub modeli**: Brezplačen dostop do AI modelov za prototipiranje in učenje (brez kreditne kartice) -- **Razvojna orodja**: Docker kontejnerji, VS Code in GitHub Codespaces nastavitev +- **Konfiguracija za več ponudnikov**: Nastavitev GitHub modelov, Azure OpenAI in OpenAI Java SDK integracij +- **Spring Boot + Spring AI**: Najboljše prakse za razvoj UI aplikacij za podjetja +- **GitHub modeli**: Brezplačen dostop do UI modelov za prototipe in učenje (brez kreditne kartice) +- **Razvojna orodja**: Konfiguracija Docker vsebnikov, VS Code in GitHub Codespaces - **[→ Začni poglavje 2](./02-SetupDevEnvironment/README.md)** -### **Poglavje 3: Osnovne tehnike generativne AI** -- **Projektiranje pozivov (Prompt Engineering)**: Tehnike za optimalne odgovore AI modelov -- **Vdelave in vektorske operacije**: Izvedi semantično iskanje in ujemanje podobnosti -- **Pridobivanje-podprto generiranje (RAG)**: Poveži AI z lastnimi viri podatkov -- **Klic funkcij**: Razširi zmogljivosti AI s prilagojenimi orodji in vtičniki +### **Poglavje 3: Osnovne tehnike generativne UI** +- **Inženiring pozivov**: Tehnike za optimalne odzive UI modelov +- **Vdelave in vektorske operacije**: Izvedba semantičnega iskanja in primerjave podobnosti +- **Generiranje, podprto z iskanjem (RAG)**: Kombiniranje UI z vašimi podatkovnimi viri +- **Klicanje funkcij**: Razširitev zmogljivosti UI s prilagojenimi orodji in vtičniki - **[→ Začni poglavje 3](./03-CoreGenerativeAITechniques/README.md)** -### **Poglavje 4: Praktične uporabe in projekti** -- **Generator zgodb o ljubljenčkih** (`petstory/`): Ustvarjalno generiranje vsebin z GitHub modeli -- **Foundry lokalna predstavitev** (`foundrylocal/`): Lokalna integracija AI modela z OpenAI Java SDK -- **MCP kalkulator storitev** (`calculator/`): Osnovna implementacija Model Context Protocol s Spring AI +### **Poglavje 4: Praktične aplikacije in projekti** +- **Generator zgodb o hišnih ljubljenčkih** (`petstory/`): Kreativno generiranje vsebin z GitHub modeli +- **Foundry lokalna predstavitev** (`foundrylocal/`): Lokalna integracija UI modelov z OpenAI Java SDK +- **MCP kalkulatorska storitev** (`calculator/`): Osnovna implementacija protokola konteksta modela s Spring AI - **[→ Začni poglavje 4](./04-PracticalSamples/README.md)** -### **Poglavje 5: Odgovoren razvoj umetne inteligence** -- **Varnost GitHub modelov**: Preizkusi vgrajeno filtriranje vsebin in varnostne mehanizme (trdi bloki in mehka zavrnitve) -- **Demonstracija odgovorne AI**: Praktičen primer prikaza delovanja sodobnih varnostnih sistemov AI -- **Najboljše prakse**: Ključna navodila za etičen razvoj in uvajanje AI +### **Poglavje 5: Odgovorni razvoj UI** +- **Varnost GitHub modelov**: Testiranje vgrajenih filtrov vsebin in varnostnih mehanizmov (trdi blokadi in mehki zavrnitvi) +- **Demo odgovorne UI**: Praktičen primer delovanja sodobnih sistemov varnosti UI +- **Najboljše prakse**: Ključna navodila za etični razvoj in uvajanje UI - **[→ Začni poglavje 5](./05-ResponsibleGenAI/README.md)** ## Dodatni viri @@ -100,23 +91,24 @@ CO_OP_TRANSLATOR_METADATA: [![AZD za začetnike](https://img.shields.io/badge/AZD%20for%20Beginners-0078D4?style=for-the-badge&labelColor=E5E7EB&color=0078D4)](https://github.com/microsoft/AZD-for-beginners?WT.mc_id=academic-105485-koreyst) [![Edge AI za začetnike](https://img.shields.io/badge/Edge%20AI%20for%20Beginners-00B8E4?style=for-the-badge&labelColor=E5E7EB&color=00B8E4)](https://github.com/microsoft/edgeai-for-beginners?WT.mc_id=academic-105485-koreyst) [![MCP za začetnike](https://img.shields.io/badge/MCP%20for%20Beginners-009688?style=for-the-badge&labelColor=E5E7EB&color=009688)](https://github.com/microsoft/mcp-for-beginners?WT.mc_id=academic-105485-koreyst) -[![AI agenti za začetnike](https://img.shields.io/badge/AI%20Agents%20for%20Beginners-00C49A?style=for-the-badge&labelColor=E5E7EB&color=00C49A)](https://github.com/microsoft/ai-agents-for-beginners?WT.mc_id=academic-105485-koreyst) +[![UI agenti za začetnike](https://img.shields.io/badge/AI%20Agents%20for%20Beginners-00C49A?style=for-the-badge&labelColor=E5E7EB&color=00C49A)](https://github.com/microsoft/ai-agents-for-beginners?WT.mc_id=academic-105485-koreyst) --- -### Serija generativne AI -[![Generativna AI za začetnike](https://img.shields.io/badge/Generative%20AI%20for%20Beginners-8B5CF6?style=for-the-badge&labelColor=E5E7EB&color=8B5CF6)](https://github.com/microsoft/generative-ai-for-beginners?WT.mc_id=academic-105485-koreyst) -[![Generativna AI (.NET)](https://img.shields.io/badge/Generative%20AI%20(.NET)-9333EA?style=for-the-badge&labelColor=E5E7EB&color=9333EA)](https://github.com/microsoft/Generative-AI-for-beginners-dotnet?WT.mc_id=academic-105485-koreyst) -[![Generativna AI (Java)](https://img.shields.io/badge/Generative%20AI%20(Java)-C084FC?style=for-the-badge&labelColor=E5E7EB&color=C084FC)](https://github.com/microsoft/generative-ai-for-beginners-java?WT.mc_id=academic-105485-koreyst) -[![Generativna AI (JavaScript)](https://img.shields.io/badge/Generative%20AI%20(JavaScript)-E879F9?style=for-the-badge&labelColor=E5E7EB&color=E879F9)](https://github.com/microsoft/generative-ai-with-javascript?WT.mc_id=academic-105485-koreyst) +### Serija generativne UI +[![Generativna UI za začetnike](https://img.shields.io/badge/Generative%20AI%20for%20Beginners-8B5CF6?style=for-the-badge&labelColor=E5E7EB&color=8B5CF6)](https://github.com/microsoft/generative-ai-for-beginners?WT.mc_id=academic-105485-koreyst) +[![Generativna UI (.NET)](https://img.shields.io/badge/Generative%20AI%20(.NET)-9333EA?style=for-the-badge&labelColor=E5E7EB&color=9333EA)](https://github.com/microsoft/Generative-AI-for-beginners-dotnet?WT.mc_id=academic-105485-koreyst) +[![Generativna UI (Java)](https://img.shields.io/badge/Generative%20AI%20(Java)-C084FC?style=for-the-badge&labelColor=E5E7EB&color=C084FC)](https://github.com/microsoft/generative-ai-for-beginners-java?WT.mc_id=academic-105485-koreyst) +[![Generativna UI (JavaScript)](https://img.shields.io/badge/Generative%20AI%20(JavaScript)-E879F9?style=for-the-badge&labelColor=E5E7EB&color=E879F9)](https://github.com/microsoft/generative-ai-with-javascript?WT.mc_id=academic-105485-koreyst) --- ### Osnovno učenje -[![ML za začetnike](https://img.shields.io/badge/ML%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=22C55E)](https://aka.ms/ml-beginners?WT.mc_id=academic-105485-koreyst) +[![Strojno učenje za začetnike](https://img.shields.io/badge/ML%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=22C55E)](https://aka.ms/ml-beginners?WT.mc_id=academic-105485-koreyst) [![Podatkovna znanost za začetnike](https://img.shields.io/badge/Data%20Science%20for%20Beginners-84CC16?style=for-the-badge&labelColor=E5E7EB&color=84CC16)](https://aka.ms/datascience-beginners?WT.mc_id=academic-105485-koreyst) -[![AI za začetnike](https://img.shields.io/badge/AI%20for%20Beginners-A3E635?style=for-the-badge&labelColor=E5E7EB&color=A3E635)](https://aka.ms/ai-beginners?WT.mc_id=academic-105485-koreyst) +[![UI za začetnike](https://img.shields.io/badge/AI%20for%20Beginners-A3E635?style=for-the-badge&labelColor=E5E7EB&color=A3E635)](https://aka.ms/ai-beginners?WT.mc_id=academic-105485-koreyst) [![Kibernetska varnost za začetnike](https://img.shields.io/badge/Cybersecurity%20for%20Beginners-F97316?style=for-the-badge&labelColor=E5E7EB&color=F97316)](https://github.com/microsoft/Security-101?WT.mc_id=academic-96948-sayoung) + [![Spletni razvoj za začetnike](https://img.shields.io/badge/Web%20Dev%20for%20Beginners-EC4899?style=for-the-badge&labelColor=E5E7EB&color=EC4899)](https://aka.ms/webdev-beginners?WT.mc_id=academic-105485-koreyst) [![IoT za začetnike](https://img.shields.io/badge/IoT%20for%20Beginners-14B8A6?style=for-the-badge&labelColor=E5E7EB&color=14B8A6)](https://aka.ms/iot-beginners?WT.mc_id=academic-105485-koreyst) [![XR razvoj za začetnike](https://img.shields.io/badge/XR%20Development%20for%20Beginners-38BDF8?style=for-the-badge&labelColor=E5E7EB&color=38BDF8)](https://github.com/microsoft/xr-development-for-beginners?WT.mc_id=academic-105485-koreyst) @@ -124,18 +116,18 @@ CO_OP_TRANSLATOR_METADATA: --- ### Serija Copilot -[![Copilot za AI-programiranje v paru](https://img.shields.io/badge/Copilot%20for%20AI%20Paired%20Programming-FACC15?style=for-the-badge&labelColor=E5E7EB&color=FACC15)](https://aka.ms/GitHubCopilotAI?WT.mc_id=academic-105485-koreyst) +[![Copilot za AI povezano programiranje](https://img.shields.io/badge/Copilot%20for%20AI%20Paired%20Programming-FACC15?style=for-the-badge&labelColor=E5E7EB&color=FACC15)](https://aka.ms/GitHubCopilotAI?WT.mc_id=academic-105485-koreyst) [![Copilot za C#/.NET](https://img.shields.io/badge/Copilot%20for%20C%23/.NET-FBBF24?style=for-the-badge&labelColor=E5E7EB&color=FBBF24)](https://github.com/microsoft/mastering-github-copilot-for-dotnet-csharp-developers?WT.mc_id=academic-105485-koreyst) -[![Copilot dogodivščina](https://img.shields.io/badge/Copilot%20Adventure-FDE68A?style=for-the-badge&labelColor=E5E7EB&color=FDE68A)](https://github.com/microsoft/CopilotAdventures?WT.mc_id=academic-105485-koreyst) +[![Copilot pustolovščina](https://img.shields.io/badge/Copilot%20Adventure-FDE68A?style=for-the-badge&labelColor=E5E7EB&color=FDE68A)](https://github.com/microsoft/CopilotAdventures?WT.mc_id=academic-105485-koreyst) ## Pridobivanje pomoči -Če se zataknete ali imate kakršnakoli vprašanja o ustvarjanju AI aplikacij, se pridružite ostalim učencem in izkušenim razvijalcem v razpravah o MCP. To je podporna skupnost, kjer so vprašanja dobrodošla in se znanje prosto deli. +Če se zataknete ali imate vprašanja o ustvarjanju AI aplikacij. Pridružite se sošolcem in izkušenim razvijalcem v pogovorih o MCP. To je podporna skupnost, kjer so vprašanja dobrodošla in kjer se znanje prosto deli. [![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) -Če imate povratne informacije o izdelku ali napake med razvojem, obiščite: +Če imate povratne informacije o izdelku ali napake med gradnjo, obiščite: [![Microsoft Foundry Developer Forum](https://img.shields.io/badge/GitHub-Microsoft_Foundry_Developer_Forum-blue?style=for-the-badge&logo=github&color=000000&logoColor=fff)](https://aka.ms/foundry/forum) @@ -143,5 +135,5 @@ CO_OP_TRANSLATOR_METADATA: **Omejitev odgovornosti**: -To besedilo je bilo prevedeno z uporabo storitve za strojno prevajanje AI [Co-op Translator](https://github.com/Azure/co-op-translator). Čeprav si prizadevamo za natančnost, vas opozarjamo, da lahko avtomatizirani prevodi vsebujejo napake ali netočnosti. Izvirni dokument v njegovem izvorne jeziku je treba šteti za avtoritativni vir. Za kritične informacije priporočamo strokovni človeški prevod. Za kakršnekoli nesporazume ali napačne interpretacije, ki izhajajo iz uporabe tega prevoda, ne prevzemamo odgovornosti. +Ta dokument je bil preveden z uporabo storitve za strojno prevajanje AI [Co-op Translator](https://github.com/Azure/co-op-translator). Čeprav si prizadevamo za natančnost, vas opozarjamo, da avtomatski prevodi lahko vsebujejo napake ali netočnosti. Izvirni dokument v njegovem izvorni jezik se šteje za verodostojen vir. Za pomembne informacije priporočamo strokovni človeški prevod. Za morebitne nesporazume ali napačne interpretacije, ki izhajajo iz uporabe tega prevoda, ne prevzemamo odgovornosti. \ No newline at end of file diff --git a/translations/sl/SECURITY.md b/translations/sl/SECURITY.md index decf8529..f3b1931b 100644 --- a/translations/sl/SECURITY.md +++ b/translations/sl/SECURITY.md @@ -1,12 +1,3 @@ - ## Varnost Microsoft jemlje varnost svojih programske opreme in storitev resno, kar vključuje vse repozitorije izvorne kode, ki jih upravljajo naše GitHub organizacije, med katerimi so [Microsoft](https://github.com/Microsoft), [Azure](https://github.com/Azure), [DotNet](https://github.com/dotnet), [AspNet](https://github.com/aspnet) in [Xamarin](https://github.com/xamarin). diff --git a/translations/sl/SUPPORT.md b/translations/sl/SUPPORT.md index 504b8d5d..087c1d56 100644 --- a/translations/sl/SUPPORT.md +++ b/translations/sl/SUPPORT.md @@ -1,12 +1,3 @@ - # Podpora ## Kako prijaviti težave in dobiti pomoč diff --git a/translations/sr/.co-op-translator.json b/translations/sr/.co-op-translator.json new file mode 100644 index 00000000..421a091c --- /dev/null +++ b/translations/sr/.co-op-translator.json @@ -0,0 +1,92 @@ +{ + "01-IntroToGenAI/README.md": { + "original_hash": "75bfb080ca725e8a9aa9c80cae25fba1", + "translation_date": "2025-07-29T10:17:16+00:00", + "source_file": "01-IntroToGenAI/README.md", + "language_code": "sr" + }, + "02-SetupDevEnvironment/README.md": { + "original_hash": "96a30d42b9751a3d4e4b20e28d29d459", + "translation_date": "2026-01-28T05:24:34+00:00", + "source_file": "02-SetupDevEnvironment/README.md", + "language_code": "sr" + }, + "02-SetupDevEnvironment/examples/basic-chat-azure/README.md": { + "original_hash": "efd82efe50711d7e257eb943151d682c", + "translation_date": "2025-07-27T13:47:48+00:00", + "source_file": "02-SetupDevEnvironment/examples/basic-chat-azure/README.md", + "language_code": "sr" + }, + "02-SetupDevEnvironment/getting-started-azure-openai.md": { + "original_hash": "bfdb4b4eadbee3a59ef742439f58326a", + "translation_date": "2025-07-27T13:28:06+00:00", + "source_file": "02-SetupDevEnvironment/getting-started-azure-openai.md", + "language_code": "sr" + }, + "03-CoreGenerativeAITechniques/README.md": { + "original_hash": "685f55cb07de19b52a30ce6e8b6d889e", + "translation_date": "2025-08-28T22:17:35+00:00", + "source_file": "03-CoreGenerativeAITechniques/README.md", + "language_code": "sr" + }, + "04-PracticalSamples/README.md": { + "original_hash": "14c0a61ecc1cd2012a9c129236dfdf71", + "translation_date": "2025-07-29T10:16:58+00:00", + "source_file": "04-PracticalSamples/README.md", + "language_code": "sr" + }, + "04-PracticalSamples/calculator/README.md": { + "original_hash": "b6c16b5514d524e415a94f6097ee7d4c", + "translation_date": "2025-09-18T15:41:05+00:00", + "source_file": "04-PracticalSamples/calculator/README.md", + "language_code": "sr" + }, + "04-PracticalSamples/foundrylocal/README.md": { + "original_hash": "f787307400de59adc25a1404466a35f3", + "translation_date": "2025-11-04T07:35:05+00:00", + "source_file": "04-PracticalSamples/foundrylocal/README.md", + "language_code": "sr" + }, + "04-PracticalSamples/petstory/README.md": { + "original_hash": "0cbf68d605615a1e602c832a24616859", + "translation_date": "2025-07-25T12:01:59+00:00", + "source_file": "04-PracticalSamples/petstory/README.md", + "language_code": "sr" + }, + "05-ResponsibleGenAI/README.md": { + "original_hash": "301c05c2f57e60a6950b8c665b8bdbba", + "translation_date": "2025-07-29T15:59:50+00:00", + "source_file": "05-ResponsibleGenAI/README.md", + "language_code": "sr" + }, + "AGENTS.md": { + "original_hash": "afc90918d008cf77fd1982691f681306", + "translation_date": "2025-10-03T08:44:16+00:00", + "source_file": "AGENTS.md", + "language_code": "sr" + }, + "CODE_OF_CONDUCT.md": { + "original_hash": "442b123d034f92f7c384d2bbd28f99f1", + "translation_date": "2025-07-21T20:37:50+00:00", + "source_file": "CODE_OF_CONDUCT.md", + "language_code": "sr" + }, + "README.md": { + "original_hash": "125a08948d881c95628094f4dd1fbd43", + "translation_date": "2026-01-29T16:15:04+00:00", + "source_file": "README.md", + "language_code": "sr" + }, + "SECURITY.md": { + "original_hash": "57f14126c1c6add76b3aef3844dfe4e3", + "translation_date": "2025-07-21T20:36:01+00:00", + "source_file": "SECURITY.md", + "language_code": "sr" + }, + "SUPPORT.md": { + "original_hash": "b8ef73cc49dec68e2c885ee9df545129", + "translation_date": "2025-07-21T20:39:06+00:00", + "source_file": "SUPPORT.md", + "language_code": "sr" + } +} \ No newline at end of file diff --git a/translations/sr/01-IntroToGenAI/README.md b/translations/sr/01-IntroToGenAI/README.md index 9accecb0..b3dea22b 100644 --- a/translations/sr/01-IntroToGenAI/README.md +++ b/translations/sr/01-IntroToGenAI/README.md @@ -1,12 +1,3 @@ - # Увод у Генеративну Вештачку Интелигенцију - Јава издање ## Шта ћете научити diff --git a/translations/sr/02-SetupDevEnvironment/README.md b/translations/sr/02-SetupDevEnvironment/README.md index a2e3ea09..4c51cc7b 100644 --- a/translations/sr/02-SetupDevEnvironment/README.md +++ b/translations/sr/02-SetupDevEnvironment/README.md @@ -1,13 +1,251 @@ - +# Подешавање развојног окружења за Генеративни AI за Јава +> **Брзи почетак**: Кодирајте у облаку за 2 минута - Пређите на [GitHub Codespaces подешавање](../../../02-SetupDevEnvironment) - није потребна локална инсталација и користи github моделе! + +> **Занимате се за Azure OpenAI?**, видите наш [Azure OpenAI водич за подешавање](getting-started-azure-openai.md) са корацима за креирање новог Azure OpenAI ресурса. + +## Шта ћете научити + +- Подешавање развојног окружења за Java AI апликације +- Избор и конфигурација омиљеног развојног окружења (cloud-first са Codespaces, локални дев контејнер или пуну локалну поставку) +- Тестирање окружења повезивањем са GitHub моделима + +## Табела садржаја + +- [Шта ћете научити](../../../02-SetupDevEnvironment) +- [Увод](../../../02-SetupDevEnvironment) +- [Корак 1: Подешавање развојног окружења](../../../02-SetupDevEnvironment) + - [Опција A: GitHub Codespaces (препоручено)](../../../02-SetupDevEnvironment) + - [Опција B: Локални дев контејнер](../../../02-SetupDevEnvironment) + - [Опција C: Користите постојећу локалну инсталацију](../../../02-SetupDevEnvironment) +- [Корак 2: Креирање GitHub персоналног токена приступа](../../../02-SetupDevEnvironment) +- [Корак 3: Тестирање окружења](../../../02-SetupDevEnvironment) +- [Решавање проблема](../../../02-SetupDevEnvironment) +- [Резиме](../../../02-SetupDevEnvironment) +- [Следећи кораци](../../../02-SetupDevEnvironment) + +## Увод + +У овом поглављу водићемо вас кроз процес подешавања развојног окружења. Користићемо **GitHub Models** као примарни пример јер су бесплатни, лаки за подешавање само са GitHub налогом, нису потребне кредитне картице, и пружају приступ више модела за експериментисање. + +**Није потребна локална инсталација!** Можете одмах почети са кодирањем користећи GitHub Codespaces, који пружа цело развојно окружење у вашем прегледачу. + +Снимак екрана: GitHub Models + +Препоручујемо коришћење [**GitHub Models**](https://github.com/marketplace?type=models) за овај курс јер је: +- **Бесплатно** за почетак +- **Лако** за подешавање само са GitHub налогом +- **Није потребна кредитна картица** +- **Више модела** доступно за експериментисање + +> **Напомена**: GitHub Models коришћени у овом тренингу имају следећа бесплатна ограничења: +> - 15 захтева по минути (150 дневно) +> - око 8,000 речи улазно, око 4,000 речи излазно по захтеву +> - 5 паралелних захтева +> +> За продукциону употребу, надоградите на Azure AI Foundry Models са својим Azure налогом. Ваш код не мора да се мења. Погледајте [Azure AI Foundry документацију](https://learn.microsoft.com/azure/ai-foundry/foundry-models/how-to/quickstart-github-models). + +## Корак 1: Подешавање развојног окружења + + + +Креирали смо претходно конфигурисан дев контејнер како бисмо минимизирали време поставке и осигурали да имате све неопходне алате за овај курс Генеративног AI за Јава. Изаберите жељени приступ развоју: + +### Опције подешавања окружења: + +#### Опција A: GitHub Codespaces (препоручено) + +**Почните кодирање за 2 минута - није потребна локална инсталација!** + +1. Форкујте овај репозиторијум на свој GitHub налог + > **Напомена**: Ако желите да уредите основну конфигурацију, погледајте [Dev Container Configuration](../../../.devcontainer/devcontainer.json) +2. Кликните **Code** → таб **Codespaces** → **...** → **New with options...** +3. Користите подразумеване вредности – ово ће изабрати **Dev container configuration**: **Generative AI Java Development Environment** прилагођени дев контејнер креиран за овај курс +4. Кликните **Create codespace** +5. Сачекајте око 2 минута док се окружење не припреми +6. Наставите на [Корак 2: Креирање GitHub токена](../../../02-SetupDevEnvironment) + +Снимак екрана: Codespaces подмени + +Снимак екрана: New with options + +Снимак екрана: опције за креирање codespace + +> **Предности Codespaces-а**: +> - Није потребна локална инсталација +> - Ради на било ком уређају са прегледачем +> - Предконфигурисан са свим алатима и зависностима +> - Бесплатно 60 сати месечно за личне налоге +> - Конзистентно окружење за све ученике + +#### Опција B: Локални дев контејнер + +**За програмере који преферирају локални развој са Docker-ом** + +1. Форкујте и клонирајте овај репозиторијум на свој локални рачунар + > **Напомена**: Ако желите да уредите основну конфигурацију, погледајте [Dev Container Configuration](../../../.devcontainer/devcontainer.json) +2. Инсталирајте [Docker Desktop](https://www.docker.com/products/docker-desktop/) и [VS Code](https://code.visualstudio.com/) +3. Инсталирајте [Dev Containers проширење](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers) у VS Code +4. Отворите фасциклу репозиторијума у VS Code +5. Када вам се понуди, кликните **Reopen in Container** (или користите `Ctrl+Shift+P` → "Dev Containers: Reopen in Container") +6. Сачекајте да контејнер изгради и покрене се +7. Наставите на [Корак 2: Креирање GitHub токена](../../../02-SetupDevEnvironment) + +Снимак екрана: Подешавање дев контејнера + +Снимак екрана: Дев контејнер изградња завршена + +#### Опција C: Користите постојећу локалну инсталацију + +**За програмере са постојећим Java окружењима** + +Преуслови: +- [Java 21+](https://www.oracle.com/java/technologies/javase/jdk21-archive-downloads.html) +- [Maven 3.9+](https://maven.apache.org/download.cgi) +- [VS Code](https://code.visualstudio.com) или омиљени IDE + +Кораци: +1. Клонирајте овај репозиторијум на свој локални рачунар +2. Отворите пројекат у свом IDE-у +3. Наставите на [Корак 2: Креирање GitHub токена](../../../02-SetupDevEnvironment) + +> **Трик за професионалце**: Ако имате рачунар са слабијим спецификацијама али желите VS Code локално, користите GitHub Codespaces! Можете повезати свој локални VS Code са cloud-hosted Codespace-ом за најбоље из оба света. + +Снимак екрана: креиран локални дев контејнер инстанца + +## Корак 2: Креирање GitHub персоналног токена приступа + +1. Идите на [GitHub Settings](https://github.com/settings/profile) и одаберите **Settings** из свог профил менија. +2. У левом бочној траци кликните на **Developer settings** (обично на дну). +3. Под **Personal access tokens**, кликните на **Fine-grained tokens** (или пратите овај директни [линк](https://github.com/settings/personal-access-tokens)). +4. Кликните на **Generate new token**. +5. Под "Token name", унесите описно име (нпр. `GenAI-Java-Course-Token`). +6. Поставите датум истека (препоручено: 7 дана ради безбедности). +7. Под "Resource owner", изаберите свој кориснички налог. +8. Под "Repository access", изаберите репозиторијуме које желите користити са GitHub Models (или "All repositories" ако је потребно). +9. Под "Account permissions", пронађите **Models** и поставите га на **Read-only**. +10. Кликните **Generate token**. +11. **Сада копирајте и сачувајте свој токен** – нећете га поново видети! + +> **Безбедносни савет**: Користите најмању потребну скалу и најкраћи практичан рок истека за ваше токене приступа. + +## Корак 3: Тестирање окружења са примером GitHub Models + +Када је ваше развојно окружење спремно, тестирајмо GitHub Models интеграцију са нашим примером апликације у [`02-SetupDevEnvironment/examples/github-models`](../../../02-SetupDevEnvironment/examples/github-models). + +1. Отворите терминал у вашем развојном окружењу. +2. Идите у фасциклу са примером GitHub Models: + ```bash + cd 02-SetupDevEnvironment/examples/github-models + ``` +3. Поставите свој GitHub токен као променљиву окружења: + ```bash + # macOS/Linux + export GITHUB_TOKEN=your_token_here + + # Windows (Командна линија) + set GITHUB_TOKEN=your_token_here + + # Windows (PowerShell) + $env:GITHUB_TOKEN="your_token_here" + ``` + +4. Покрените апликацију: + ```bash + mvn compile exec:java -Dexec.mainClass="com.example.githubmodels.App" + ``` + +Видећете сличан излаз као: +```text +Using model: gpt-4.1-nano +Sending request to GitHub Models... +Response: Hello World! +``` + +### Разумевање пример кода + +Прво, разумимо шта смо управо покренули. Пример у `examples/github-models` користи OpenAI Java SDK за повезивање са GitHub Models: + +**Шта овај код ради:** +- **Повезује се** са GitHub Models користећи ваш персонални токен приступа +- **Шаље** једноставну поруку "Say Hello World!" AI моделу +- **Прима** и приказује одговор AI-а +- **Валидација** да ваше окружење исправно ради + +**Кључна зависност** (у `pom.xml`): +```xml + + com.openai + openai-java + 2.12.0 + +``` + +**Главни код** (`App.java`): +```java +// Повежите се са GitHub моделима користећи OpenAI Java SDK +OpenAIClient client = OpenAIOkHttpClient.builder() + .apiKey(pat) + .baseUrl("https://models.inference.ai.azure.com") + .build(); + +// Креирајте захтев за завршетак ћаскања +ChatCompletionCreateParams params = ChatCompletionCreateParams.builder() + .model(modelId) + .addSystemMessage("You are a concise assistant.") + .addUserMessage("Say Hello World!") + .build(); + +// Преузмите одговор вештачке интелигенције +ChatCompletion response = client.chat().completions().create(params); +System.out.println("Response: " + response.choices().get(0).message().content().orElse("No response content")); +``` + +## Резиме + +Сјајно! Сада имате све постављено: + +- Креирали сте GitHub персонални токен приступа са одговарајућим дозволама за приступ AI моделима +- Покренули сте Java развојно окружење (било да користите Codespaces, дев контејнере или локално окружење) +- Повезали сте се са GitHub Models користећи OpenAI Java SDK за бесплатни AI развој +- Тестирали сте да све ради са једноставним примером који комуницира са AI моделима + +## Следећи кораци + +[Поглавље 3: Основне технике генеративног AI-а](../03-CoreGenerativeAITechniques/README.md) + +## Решавање проблема + +Имате проблема? Ево уобичајених проблема и решења: + +- **Токен не ради?** + - Проверите да ли сте у потпуности копирали токен без додатних размака + - Проверите да ли је токен правилно постављен као променљива окружења + - Проверите да токен има исправне дозволе (Models: Read-only) + +- **Maven није пронађен?** + - Ако користите дев контејнере/Codespaces, Maven би требао бити претходно инсталиран + - За локално подешавање, обезбедите да имате Java 21+ и Maven 3.9+ инсталиране + - Покушајте `mvn --version` за верификацију инсталације + +- **Проблеми са везом?** + - Проверите интернет конекцију + - Проверите да ли вам је GitHub доступан са ваше мреже + - Обезбедите да нисте иза заштитног зида који блокира крајњу тачку GitHub Models + +- **Дев контејнер се не покреће?** + - Проверите да ли Docker Desktop ради (за локални развој) + - Покушајте поново да изградите контејнер: `Ctrl+Shift+P` → "Dev Containers: Rebuild Container" + +- **Грешке приликом компилације апликације?** + - Проверите да ли сте у исправном директоријуму: `02-SetupDevEnvironment/examples/github-models` + - Покушајте да очистите и поново изграђујете: `mvn clean compile` + +> **Треба вам помоћ?**: Још увек имате проблема? Отворите issue у репозиторијуму и помоћи ћемо вам. --- + +**Одрицање одговорности**: +Овај документ је преведен помоћу АИ сервиса за превођење [Co-op Translator](https://github.com/Azure/co-op-translator). Иако се трудимо да превод буде прецизан, молимо имајте у виду да аутоматски преводи могу садржати грешке или нетачности. Изворни документ на матерњем језику треба сматрати ауторитетним извором. За критичне информације препоручује се професионални превод од стране човека. Нисмо одговорни за било каква непоразумевања или погрешна тумачења настала коришћењем овог превода. + \ No newline at end of file diff --git a/translations/sr/02-SetupDevEnvironment/examples/basic-chat-azure/README.md b/translations/sr/02-SetupDevEnvironment/examples/basic-chat-azure/README.md index 58206990..7a19e6ca 100644 --- a/translations/sr/02-SetupDevEnvironment/examples/basic-chat-azure/README.md +++ b/translations/sr/02-SetupDevEnvironment/examples/basic-chat-azure/README.md @@ -1,12 +1,3 @@ - # Основни разговор са Azure OpenAI - Пример од почетка до краја Овај пример показује како да направите једноставну Spring Boot апликацију која се повезује са Azure OpenAI и тестира вашу конфигурацију. diff --git a/translations/sr/02-SetupDevEnvironment/getting-started-azure-openai.md b/translations/sr/02-SetupDevEnvironment/getting-started-azure-openai.md index cf09418f..ac13bf91 100644 --- a/translations/sr/02-SetupDevEnvironment/getting-started-azure-openai.md +++ b/translations/sr/02-SetupDevEnvironment/getting-started-azure-openai.md @@ -1,12 +1,3 @@ - # Подешавање Развојног Окружења за Azure OpenAI > **Брзи почетак**: Овај водич је за подешавање Azure OpenAI. За тренутни почетак са бесплатним моделима, користите [GitHub Models with Codespaces](./README.md#quick-start-cloud). diff --git a/translations/sr/03-CoreGenerativeAITechniques/README.md b/translations/sr/03-CoreGenerativeAITechniques/README.md index 15d6f100..a304f398 100644 --- a/translations/sr/03-CoreGenerativeAITechniques/README.md +++ b/translations/sr/03-CoreGenerativeAITechniques/README.md @@ -1,12 +1,3 @@ - # Туторијал о Основним Техникама Генеративне Вештачке Интелигенције ## Садржај diff --git a/translations/sr/04-PracticalSamples/README.md b/translations/sr/04-PracticalSamples/README.md index 5ae8efed..350ec0bc 100644 --- a/translations/sr/04-PracticalSamples/README.md +++ b/translations/sr/04-PracticalSamples/README.md @@ -1,12 +1,3 @@ - # Практичне Примене и Пројекти ## Шта ћете научити diff --git a/translations/sr/04-PracticalSamples/calculator/README.md b/translations/sr/04-PracticalSamples/calculator/README.md index 251ccb15..968e85bd 100644 --- a/translations/sr/04-PracticalSamples/calculator/README.md +++ b/translations/sr/04-PracticalSamples/calculator/README.md @@ -1,12 +1,3 @@ - # Упутство за MCP калкулатор за почетнике ## Садржај diff --git a/translations/sr/04-PracticalSamples/foundrylocal/README.md b/translations/sr/04-PracticalSamples/foundrylocal/README.md index 23c9f928..17144723 100644 --- a/translations/sr/04-PracticalSamples/foundrylocal/README.md +++ b/translations/sr/04-PracticalSamples/foundrylocal/README.md @@ -1,12 +1,3 @@ - # Упутство за локални Foundry Spring Boot ## Садржај diff --git a/translations/sr/04-PracticalSamples/petstory/README.md b/translations/sr/04-PracticalSamples/petstory/README.md index ae078379..12fe90a6 100644 --- a/translations/sr/04-PracticalSamples/petstory/README.md +++ b/translations/sr/04-PracticalSamples/petstory/README.md @@ -1,12 +1,3 @@ - # Туторијал за Генератор Причa о Кућним Љубимцима за Почетнике ## Садржај diff --git a/translations/sr/05-ResponsibleGenAI/README.md b/translations/sr/05-ResponsibleGenAI/README.md index 9b4bdcba..a3588d79 100644 --- a/translations/sr/05-ResponsibleGenAI/README.md +++ b/translations/sr/05-ResponsibleGenAI/README.md @@ -1,12 +1,3 @@ - # Одговорна Генеративна Вештачка Интелигенција ## Шта ћете научити diff --git a/translations/sr/AGENTS.md b/translations/sr/AGENTS.md index 423635d8..7ba5728c 100644 --- a/translations/sr/AGENTS.md +++ b/translations/sr/AGENTS.md @@ -1,12 +1,3 @@ - # AGENTS.md ## Преглед пројекта diff --git a/translations/sr/CODE_OF_CONDUCT.md b/translations/sr/CODE_OF_CONDUCT.md index 65b015c5..6c27b6f1 100644 --- a/translations/sr/CODE_OF_CONDUCT.md +++ b/translations/sr/CODE_OF_CONDUCT.md @@ -1,12 +1,3 @@ - # Microsoft Кодекс понашања за отворени код Овај пројекат је усвојио [Microsoft Кодекс понашања за отворени код](https://opensource.microsoft.com/codeofconduct/). diff --git a/translations/sr/README.md b/translations/sr/README.md index e61db31a..be8ed949 100644 --- a/translations/sr/README.md +++ b/translations/sr/README.md @@ -1,91 +1,81 @@ - -# Генеративни AI за почетнике - Java издање +# Генеративни АИ за почетнике - Јава издање [![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) -![Генеративни AI за почетнике - Java издање](../../translated_images/sr/beg-genai-series.8b48be9951cc574c.webp) +![Генеративни АИ за почетнике - Јава издање](../../translated_images/sr/beg-genai-series.8b48be9951cc574c.webp) -**Време потребно**: Цео радионица се може урадити онлајн без локалне инсталације. Подешавање окружења траје 2 минута, а истраживање примера захтева 1-3 сата у зависности од дубине истраживања. +**Време потребно**: Цели радионица може се завршити онлајн без локалне конфигурације. Подешавање окружења траје 2 минута, а истраживање примера траје 1-3 сата у зависности од дубине истраживања. > **Брзи почетак** -1. Форкујте овај репозиторijум на свој GitHub налог -2. Кликните **Code** → таб **Codespaces** → **...** → **New with options...** -3. Користите подразумеване вредности – ово ће изабрати Development контејнер креиран за овај курс +1. Форкујте овај репозиторијум на свој GitHub налог +2. Кликните на **Code** → картица **Codespaces** → **...** → **New with options...** +3. Користите подразумевана подешавања – ово ће изабрати контејнер за развој направљен за овај курс 4. Кликните **Create codespace** -5. Саčekајте ~2 минута да окружење буде спремно -6. Прескочите директно на [Први пример](./02-SetupDevEnvironment/README.md#step-2-create-a-github-personal-access-token) +5. Сачекајте око 2 минута да окружење буде спремно +6. Одмах пређите на [Први пример](./02-SetupDevEnvironment/README.md#step-2-create-a-github-personal-access-token) -> **Волите да клонирате локално?** +> **Више волите да клонирате локално?** > -> Овај репозиторijум садржи преко 50 превода што значајно повећава величину преузимања. Да бисте клонирали без превода, користите sparse checkout: +> Овај репозиторијум укључује преко 50 превода на језике што значајно повећава величину преузимања. Да бисте клонирали без превода, користите sparse checkout: > ```bash > git clone --filter=blob:none --sparse https://github.com/microsoft/Generative-AI-for-beginners-java.git > cd Generative-AI-for-beginners-java > git sparse-checkout set --no-cone '/*' '!translations' '!translated_images' > ``` -> Ово вам даје све што вам је потребно да завршите курс са знатно бржим преузимањем. - +> Ово вам даје све што је потребно да завршите курс са знатно бржим преузимањем. ## Подршка за више језика -### Подржано преко GitHub Action-а (аутоматски и увек ажурирано) +### Подржано путем GitHub Action (Аутоматизовано и увек ажурирано) -[Арапски](../ar/README.md) | [Бенгалски](../bn/README.md) | [Бугарски](../bg/README.md) | [Бурмански (Мјанмар)](../my/README.md) | [Кинески (поједностављени)](../zh/README.md) | [Кинески (традиционални, Хонг Конг)](../hk/README.md) | [Кинески (традиционални, Макао)](../mo/README.md) | [Кинески (традиционални, Тајван)](../tw/README.md) | [Хрватски](../hr/README.md) | [Чешки](../cs/README.md) | [Дански](../da/README.md) | [Холандски](../nl/README.md) | [Естонски](../et/README.md) | [Фински](../fi/README.md) | [Француски](../fr/README.md) | [Немачки](../de/README.md) | [Грчки](../el/README.md) | [Хебрејски](../he/README.md) | [Хинди](../hi/README.md) | [Мађарски](../hu/README.md) | [Индонежански](../id/README.md) | [Италијански](../it/README.md) | [Јапански](../ja/README.md) | [Канада](../kn/README.md) | [Корски](../ko/README.md) | [Литвански](../lt/README.md) | [Малајски](../ms/README.md) | [Малајалам](../ml/README.md) | [Маратхи](../mr/README.md) | [Непалски](../ne/README.md) | [Нигеријски Пидгин](../pcm/README.md) | [Норвешки](../no/README.md) | [Персијски (фарси)](../fa/README.md) | [Пољски](../pl/README.md) | [Португалски (Бразил)](../br/README.md) | [Португалски (Португал)](../pt/README.md) | [Пунџаби (Гурмукхи)](../pa/README.md) | [Румунски](../ro/README.md) | [Руски](../ru/README.md) | [Српски (ћирилица)](./README.md) | [Словачки](../sk/README.md) | [Словеначки](../sl/README.md) | [Шпански](../es/README.md) | [Свахили](../sw/README.md) | [Шведски](../sv/README.md) | [Тагалог (Филипински)](../tl/README.md) | [Тамилски](../ta/README.md) | [Телугу](../te/README.md) | [Тајландски](../th/README.md) | [Турски](../tr/README.md) | [Украјински](../uk/README.md) | [Урду](../ur/README.md) | [Вијетнамски](../vi/README.md) +[Арапски](../ar/README.md) | [Бенгалски](../bn/README.md) | [Бугарски](../bg/README.md) | [Бурмански (Мјанмар)](../my/README.md) | [Кинески (поједностављени)](../zh-CN/README.md) | [Кинески (традиционални, Хонг Конг)](../zh-HK/README.md) | [Кинески (традиционални, Макао)](../zh-MO/README.md) | [Кинески (традиционални, Тајван)](../zh-TW/README.md) | [Хрватски](../hr/README.md) | [Чешки](../cs/README.md) | [Дански](../da/README.md) | [Холандски](../nl/README.md) | [Естонски](../et/README.md) | [Фински](../fi/README.md) | [Француски](../fr/README.md) | [Немачки](../de/README.md) | [Грчки](../el/README.md) | [Хебрејски](../he/README.md) | [Хинди](../hi/README.md) | [Мађарски](../hu/README.md) | [Индонежански](../id/README.md) | [Италијански](../it/README.md) | [Јапански](../ja/README.md) | [Каннада](../kn/README.md) | [Корейски](../ko/README.md) | [Литвански](../lt/README.md) | [Малајски](../ms/README.md) | [Малајалам](../ml/README.md) | [Маратхи](../mr/README.md) | [Непали](../ne/README.md) | [Нигеријски пидгин](../pcm/README.md) | [Норвешки](../no/README.md) | [Персијски (Фарси)](../fa/README.md) | [Пољски](../pl/README.md) | [Португалски (Бразил)](../pt-BR/README.md) | [Португалски (Португалија)](../pt-PT/README.md) | [Пуњаби (Гурмукхи)](../pa/README.md) | [Румунски](../ro/README.md) | [Руски](../ru/README.md) | [Српски (ћирилица)](./README.md) | [Словачки](../sk/README.md) | [Словеначки](../sl/README.md) | [Шпански](../es/README.md) | [Свахили](../sw/README.md) | [Шведски](../sv/README.md) | [Тагалог (Филипински)](../tl/README.md) | [Тамилски](../ta/README.md) | [Телугу](../te/README.md) | [Тајландски](../th/README.md) | [Турски](../tr/README.md) | [Украјински](../uk/README.md) | [Урду](../ur/README.md) | [Вијетнамски](../vi/README.md) -> **Волите да клонирате локално?** +> **Више волите да клонирате локално?** -> Овај репозиторijум садржи преко 50 превода што значајно повећава величину преузимања. Да бисте клонирали без превода, користите sparse checkout: +> Овај репозиторијум укључује преко 50 превода на језике што значајно повећава величину преузимања. Да бисте клонирали без превода, користите sparse checkout: > ```bash > git clone --filter=blob:none --sparse https://github.com/microsoft/Generative-AI-for-beginners-java.git > cd Generative-AI-for-beginners-java > git sparse-checkout set --no-cone '/*' '!translations' '!translated_images' > ``` -> Ово вам даје све што вам је потребно да завршите курс са знатно бржим преузимањем. +> Ово вам даје све што је потребно да завршите курс са знатно бржим преузимањем. ## Структура курса и пут учења -### **Поглавље 1: Увод у генеративни AI** -- **Основни појмови**: Разумевање великих језичких модела, токена, уградњи (embeddings) и AI способности -- **Java AI екосистем**: Преглед Spring AI и OpenAI SDK-а -- **Протокол за контекст модела**: Увод у MCP и његова улога у комуникацији AI агената -- **Практичне примене**: Сценарији из стварног света укључујући четботове и генерисање садржаја -- **[→ Почни поглавље 1](./01-IntroToGenAI/README.md)** +### **Поглавље 1: Увод у генеративни АИ** +- **Основни појмови**: Разумевање великих језичких модела, токена, уметања и могућности АИ-а +- **Јава АИ екосистем**: Преглед Spring AI и OpenAI SDK-ова +- **Протокол контекста модела**: Увод у MCP и његову улогу у комуникацији АИ агената +- **Практичне примене**: Реални сценарији укључујући чатботове и генерисање садржаја +- **[→ Започни Поглавље 1](./01-IntroToGenAI/README.md)** ### **Поглавље 2: Подешавање развојног окружења** -- **Подешавање код више добављача**: Конфигурисање GitHub модела, Azure OpenAI и OpenAI Java SDK интеграција -- **Spring Boot + Spring AI**: Најбоље праксе за развој корпоративних AI апликација -- **GitHub модели**: Бесплатан приступ AI моделима за прототиповање и учење (без кредитне картице) -- **Развојни алати**: Docker контејнери, VS Code и GitHub Codespaces конфигурација -- **[→ Почни поглавље 2](./02-SetupDevEnvironment/README.md)** - -### **Поглавље 3: Основне технике генеративног AI** -- **Ради са упутствима (Prompt Engineering)**: Технике за оптималне одговоре AI модела -- **Ембединг и операције са векторима**: Имплементација семантичког претраживања и упоређивања сличности -- **Ретривајл-аугментед генерисање (RAG)**: Комбинација AI са властитим изворима података -- **Позивање функција**: Проширите AI могућности помоћу прилагођених алата и додатака -- **[→ Почни поглавље 3](./03-CoreGenerativeAITechniques/README.md)** +- **Конфигурација више провајдера**: Подешавање GitHub модела, Azure OpenAI и OpenAI Java SDK интеграција +- **Spring Boot + Spring AI**: Најбоље праксе за развој АИ апликација у предузећима +- **GitHub модели**: Бесплатан приступ АИ моделима за прототиповање и учење (без кредитне картице) +- **Алати за развој**: Docker контејнери, VS Code и GitHub Codespaces конфигурација +- **[→ Започни Поглавље 2](./02-SetupDevEnvironment/README.md)** + +### **Поглавље 3: Основне технике генеративног АИ** +- **Примена промпт инжењеринга**: Технике за оптималне одговоре АИ модела +- **Уметања & векторске операције**: Имплементација семантичке претраге и упоређивања сличности +- **Retrieval-Augmented Generation (RAG)**: Комбинација АИ са властитим изворима података +- **Позив функција**: Проширење могућности АИ-а прилагођеним алатима и додацима +- **[→ Започни Поглавље 3](./03-CoreGenerativeAITechniques/README.md)** ### **Поглавље 4: Практичне примене и пројекти** -- **Генератор прича о љубимцима** (`petstory/`): Креативно генерисање садржаја помоћу GitHub модела -- **Foundry локална демо** (`foundrylocal/`): Интеграција локалног AI модела помоћу OpenAI Java SDK -- **MCP калкулатор сервис** (`calculator/`): Основна имплементација Протокола за контекст модела са Spring AI-ом -- **[→ Почни поглавље 4](./04-PracticalSamples/README.md)** +- **Генератор прича о кућним љубимцима** (`petstory/`): Креативно генерисање садржаја са GitHub моделима +- **Foundry локална демонстрација** (`foundrylocal/`): Локална интеграција АИ модела са OpenAI Java SDK +- **MCP сервис калкулатора** (`calculator/`): Основна имплементација Model Context Protocol са Spring AI +- **[→ Започни Поглавље 4](./04-PracticalSamples/README.md)** -### **Поглавље 5: Одговоран развој AI** -- **Безбедност GitHub модела**: Тестирање уграђених филтера садржаја и безбедносних механизама (тврде блокаде и меке одбијања) -- **Демо одговорног AI**: Пример који показује како модерни системи безбедности AI функционишу у пракси -- **Најбоље праксе**: Етички водичи за развој и примену AI -- **[→ Почни поглавље 5](./05-ResponsibleGenAI/README.md)** +### **Поглавље 5: Одговоран развој АИ** +- **Безбедност GitHub модела**: Тестирање уграђених механизама филтрирања садржаја и безбедности (тврде блокаде и благе одбијености) +- **Демо одговорног АИ**: Практичан пример како савремени системи АИ безбедности функционишу у пракси +- **Најбоље праксе**: Основне смернице за етички развој и имплементацију АИ-а +- **[→ Започни Поглавље 5](./05-ResponsibleGenAI/README.md)** ## Додатни ресурси @@ -104,44 +94,45 @@ CO_OP_TRANSLATOR_METADATA: --- -### Серии генеративног AI -[![Генеративни AI за почетнике](https://img.shields.io/badge/Generative%20AI%20for%20Beginners-8B5CF6?style=for-the-badge&labelColor=E5E7EB&color=8B5CF6)](https://github.com/microsoft/generative-ai-for-beginners?WT.mc_id=academic-105485-koreyst) -[![Генеративни AI (.NET)](https://img.shields.io/badge/Generative%20AI%20(.NET)-9333EA?style=for-the-badge&labelColor=E5E7EB&color=9333EA)](https://github.com/microsoft/Generative-AI-for-beginners-dotnet?WT.mc_id=academic-105485-koreyst) -[![Генеративни AI (Java)](https://img.shields.io/badge/Generative%20AI%20(Java)-C084FC?style=for-the-badge&labelColor=E5E7EB&color=C084FC)](https://github.com/microsoft/generative-ai-for-beginners-java?WT.mc_id=academic-105485-koreyst) -[![Генеративни AI (JavaScript)](https://img.shields.io/badge/Generative%20AI%20(JavaScript)-E879F9?style=for-the-badge&labelColor=E5E7EB&color=E879F9)](https://github.com/microsoft/generative-ai-with-javascript?WT.mc_id=academic-105485-koreyst) +### Генеративни АИ серија +[![Генеративни АИ за почетнике](https://img.shields.io/badge/Generative%20AI%20for%20Beginners-8B5CF6?style=for-the-badge&labelColor=E5E7EB&color=8B5CF6)](https://github.com/microsoft/generative-ai-for-beginners?WT.mc_id=academic-105485-koreyst) +[![Генеративни АИ (.NET)](https://img.shields.io/badge/Generative%20AI%20(.NET)-9333EA?style=for-the-badge&labelColor=E5E7EB&color=9333EA)](https://github.com/microsoft/Generative-AI-for-beginners-dotnet?WT.mc_id=academic-105485-koreyst) +[![Генеративни АИ (Јава)](https://img.shields.io/badge/Generative%20AI%20(Java)-C084FC?style=for-the-badge&labelColor=E5E7EB&color=C084FC)](https://github.com/microsoft/generative-ai-for-beginners-java?WT.mc_id=academic-105485-koreyst) +[![Генеративни АИ (JavaScript)](https://img.shields.io/badge/Generative%20AI%20(JavaScript)-E879F9?style=for-the-badge&labelColor=E5E7EB&color=E879F9)](https://github.com/microsoft/generative-ai-with-javascript?WT.mc_id=academic-105485-koreyst) --- ### Основно учење [![Машинско учење за почетнике](https://img.shields.io/badge/ML%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=22C55E)](https://aka.ms/ml-beginners?WT.mc_id=academic-105485-koreyst) [![Наука о подацима за почетнике](https://img.shields.io/badge/Data%20Science%20for%20Beginners-84CC16?style=for-the-badge&labelColor=E5E7EB&color=84CC16)](https://aka.ms/datascience-beginners?WT.mc_id=academic-105485-koreyst) -[![AI за почетнике](https://img.shields.io/badge/AI%20for%20Beginners-A3E635?style=for-the-badge&labelColor=E5E7EB&color=A3E635)](https://aka.ms/ai-beginners?WT.mc_id=academic-105485-koreyst) +[![АИ за почетнике](https://img.shields.io/badge/AI%20for%20Beginners-A3E635?style=for-the-badge&labelColor=E5E7EB&color=A3E635)](https://aka.ms/ai-beginners?WT.mc_id=academic-105485-koreyst) [![Кибербезбедност за почетнике](https://img.shields.io/badge/Cybersecurity%20for%20Beginners-F97316?style=for-the-badge&labelColor=E5E7EB&color=F97316)](https://github.com/microsoft/Security-101?WT.mc_id=academic-96948-sayoung) -[![Веб развој за почетнике](https://img.shields.io/badge/Web%20Dev%20for%20Beginners-EC4899?style=for-the-badge&labelColor=E5E7EB&color=EC4899)](https://aka.ms/webdev-beginners?WT.mc_id=academic-105485-koreyst) -[![IoT за почетнике](https://img.shields.io/badge/IoT%20for%20Beginners-14B8A6?style=for-the-badge&labelColor=E5E7EB&color=14B8A6)](https://aka.ms/iot-beginners?WT.mc_id=academic-105485-koreyst) -[![XR развој за почетнике](https://img.shields.io/badge/XR%20Development%20for%20Beginners-38BDF8?style=for-the-badge&labelColor=E5E7EB&color=38BDF8)](https://github.com/microsoft/xr-development-for-beginners?WT.mc_id=academic-105485-koreyst) + +[![Web Dev for Beginners](https://img.shields.io/badge/Web%20Dev%20for%20Beginners-EC4899?style=for-the-badge&labelColor=E5E7EB&color=EC4899)](https://aka.ms/webdev-beginners?WT.mc_id=academic-105485-koreyst) +[![IoT for Beginners](https://img.shields.io/badge/IoT%20for%20Beginners-14B8A6?style=for-the-badge&labelColor=E5E7EB&color=14B8A6)](https://aka.ms/iot-beginners?WT.mc_id=academic-105485-koreyst) +[![XR Development for Beginners](https://img.shields.io/badge/XR%20Development%20for%20Beginners-38BDF8?style=for-the-badge&labelColor=E5E7EB&color=38BDF8)](https://github.com/microsoft/xr-development-for-beginners?WT.mc_id=academic-105485-koreyst) --- -### Сериија Копилот -[![Копилот за ИИ парско програмирање](https://img.shields.io/badge/Copilot%20for%20AI%20Paired%20Programming-FACC15?style=for-the-badge&labelColor=E5E7EB&color=FACC15)](https://aka.ms/GitHubCopilotAI?WT.mc_id=academic-105485-koreyst) -[![Копилот за C#/.NET](https://img.shields.io/badge/Copilot%20for%20C%23/.NET-FBBF24?style=for-the-badge&labelColor=E5E7EB&color=FBBF24)](https://github.com/microsoft/mastering-github-copilot-for-dotnet-csharp-developers?WT.mc_id=academic-105485-koreyst) -[![Копилот авантура](https://img.shields.io/badge/Copilot%20Adventure-FDE68A?style=for-the-badge&labelColor=E5E7EB&color=FDE68A)](https://github.com/microsoft/CopilotAdventures?WT.mc_id=academic-105485-koreyst) +### Серија Копилот +[![Copilot for AI Paired Programming](https://img.shields.io/badge/Copilot%20for%20AI%20Paired%20Programming-FACC15?style=for-the-badge&labelColor=E5E7EB&color=FACC15)](https://aka.ms/GitHubCopilotAI?WT.mc_id=academic-105485-koreyst) +[![Copilot for C#/.NET](https://img.shields.io/badge/Copilot%20for%20C%23/.NET-FBBF24?style=for-the-badge&labelColor=E5E7EB&color=FBBF24)](https://github.com/microsoft/mastering-github-copilot-for-dotnet-csharp-developers?WT.mc_id=academic-105485-koreyst) +[![Copilot Adventure](https://img.shields.io/badge/Copilot%20Adventure-FDE68A?style=for-the-badge&labelColor=E5E7EB&color=FDE68A)](https://github.com/microsoft/CopilotAdventures?WT.mc_id=academic-105485-koreyst) -## Како добити помоћ +## Добијање помоћи -Ако сте заглављени или имате било каква питања о изради ИИ апликација. Придружите се другим ученицима и искусним програмерима у дискусијама о MCP-у. То је подржавајућа заједница у којој су питања добродошла а знање се слободно дели. +Ако застојите или имате било каквих питања о прављењу AI апликација. Придружите се другим ученицима и искусним програмерима у дискусијама о MCP-у. То је подршка заједница где су питања добродошла и знање се слободно дели. [![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) -Ако имате повратну информацију о производу или грешке током израде посетите: +Ако имате повратне информације о производу или грешке током прављења, посетите: [![Microsoft Foundry Developer Forum](https://img.shields.io/badge/GitHub-Microsoft_Foundry_Developer_Forum-blue?style=for-the-badge&logo=github&color=000000&logoColor=fff)](https://aka.ms/foundry/forum) --- -**Одрицање од одговорности**: -Овај документ је преправљен коришћењем АИ преводилачке услуге [Co-op Translator](https://github.com/Azure/co-op-translator). Иако настојимо да превод буде прецизан, имајте у виду да аутоматизовани преводи могу садржати грешке или нетачности. Првобитни документ на његовом изворном језику треба сматрати ауторитетним извором. За критичне информације препоручује се професионални људски превод. Не сносимо одговорност за било какве неспоразуме или погрешна тумачења настала коришћењем овог превода. +**Одрицање од одговорности**: +Овај документ је преведен коришћењем AI услуге за превођење [Co-op Translator](https://github.com/Azure/co-op-translator). Иако настојимо да обезбедимо тачност, имајте у виду да аутоматски преводи могу садржати грешке или нетачности. Изворни документ на његовом оригиналном језику треба посматрати као ауторитативан извор. За критичне информације препоручује се професионални превод од стране људског стручњака. Нисмо одговорни за било какве погрешне интерпретације или неспоразуме настале коришћењем овог превода. \ No newline at end of file diff --git a/translations/sr/SECURITY.md b/translations/sr/SECURITY.md index 9a4cb008..be9749af 100644 --- a/translations/sr/SECURITY.md +++ b/translations/sr/SECURITY.md @@ -1,12 +1,3 @@ - ## Безбедност Мајкрософт озбиљно приступа безбедности својих софтверских производа и услуга, што укључује све репозиторијуме изворног кода којима управљају наше GitHub организације, као што су [Microsoft](https://github.com/Microsoft), [Azure](https://github.com/Azure), [DotNet](https://github.com/dotnet), [AspNet](https://github.com/aspnet) и [Xamarin](https://github.com/xamarin). diff --git a/translations/sr/SUPPORT.md b/translations/sr/SUPPORT.md index 833eb43a..9e51ccc2 100644 --- a/translations/sr/SUPPORT.md +++ b/translations/sr/SUPPORT.md @@ -1,12 +1,3 @@ - # Подршка ## Како пријавити проблеме и добити помоћ diff --git a/translations/sv/.co-op-translator.json b/translations/sv/.co-op-translator.json new file mode 100644 index 00000000..7d1ce148 --- /dev/null +++ b/translations/sv/.co-op-translator.json @@ -0,0 +1,92 @@ +{ + "01-IntroToGenAI/README.md": { + "original_hash": "75bfb080ca725e8a9aa9c80cae25fba1", + "translation_date": "2025-07-29T09:24:13+00:00", + "source_file": "01-IntroToGenAI/README.md", + "language_code": "sv" + }, + "02-SetupDevEnvironment/README.md": { + "original_hash": "96a30d42b9751a3d4e4b20e28d29d459", + "translation_date": "2026-01-28T05:03:04+00:00", + "source_file": "02-SetupDevEnvironment/README.md", + "language_code": "sv" + }, + "02-SetupDevEnvironment/examples/basic-chat-azure/README.md": { + "original_hash": "efd82efe50711d7e257eb943151d682c", + "translation_date": "2025-07-27T13:42:03+00:00", + "source_file": "02-SetupDevEnvironment/examples/basic-chat-azure/README.md", + "language_code": "sv" + }, + "02-SetupDevEnvironment/getting-started-azure-openai.md": { + "original_hash": "bfdb4b4eadbee3a59ef742439f58326a", + "translation_date": "2025-07-27T13:12:22+00:00", + "source_file": "02-SetupDevEnvironment/getting-started-azure-openai.md", + "language_code": "sv" + }, + "03-CoreGenerativeAITechniques/README.md": { + "original_hash": "685f55cb07de19b52a30ce6e8b6d889e", + "translation_date": "2025-08-28T22:07:47+00:00", + "source_file": "03-CoreGenerativeAITechniques/README.md", + "language_code": "sv" + }, + "04-PracticalSamples/README.md": { + "original_hash": "14c0a61ecc1cd2012a9c129236dfdf71", + "translation_date": "2025-07-29T09:23:59+00:00", + "source_file": "04-PracticalSamples/README.md", + "language_code": "sv" + }, + "04-PracticalSamples/calculator/README.md": { + "original_hash": "b6c16b5514d524e415a94f6097ee7d4c", + "translation_date": "2025-09-18T15:33:54+00:00", + "source_file": "04-PracticalSamples/calculator/README.md", + "language_code": "sv" + }, + "04-PracticalSamples/foundrylocal/README.md": { + "original_hash": "f787307400de59adc25a1404466a35f3", + "translation_date": "2025-11-04T07:26:13+00:00", + "source_file": "04-PracticalSamples/foundrylocal/README.md", + "language_code": "sv" + }, + "04-PracticalSamples/petstory/README.md": { + "original_hash": "0cbf68d605615a1e602c832a24616859", + "translation_date": "2025-07-25T11:30:10+00:00", + "source_file": "04-PracticalSamples/petstory/README.md", + "language_code": "sv" + }, + "05-ResponsibleGenAI/README.md": { + "original_hash": "301c05c2f57e60a6950b8c665b8bdbba", + "translation_date": "2025-07-29T15:52:06+00:00", + "source_file": "05-ResponsibleGenAI/README.md", + "language_code": "sv" + }, + "AGENTS.md": { + "original_hash": "afc90918d008cf77fd1982691f681306", + "translation_date": "2025-10-03T08:37:11+00:00", + "source_file": "AGENTS.md", + "language_code": "sv" + }, + "CODE_OF_CONDUCT.md": { + "original_hash": "442b123d034f92f7c384d2bbd28f99f1", + "translation_date": "2025-07-21T19:08:16+00:00", + "source_file": "CODE_OF_CONDUCT.md", + "language_code": "sv" + }, + "README.md": { + "original_hash": "125a08948d881c95628094f4dd1fbd43", + "translation_date": "2026-01-29T15:50:01+00:00", + "source_file": "README.md", + "language_code": "sv" + }, + "SECURITY.md": { + "original_hash": "57f14126c1c6add76b3aef3844dfe4e3", + "translation_date": "2025-07-21T19:06:02+00:00", + "source_file": "SECURITY.md", + "language_code": "sv" + }, + "SUPPORT.md": { + "original_hash": "b8ef73cc49dec68e2c885ee9df545129", + "translation_date": "2025-07-21T19:09:23+00:00", + "source_file": "SUPPORT.md", + "language_code": "sv" + } +} \ No newline at end of file diff --git a/translations/sv/01-IntroToGenAI/README.md b/translations/sv/01-IntroToGenAI/README.md index b88d7f6e..0a884513 100644 --- a/translations/sv/01-IntroToGenAI/README.md +++ b/translations/sv/01-IntroToGenAI/README.md @@ -1,12 +1,3 @@ - # Introduktion till Generativ AI - Java Edition ## Vad du kommer att lära dig diff --git a/translations/sv/02-SetupDevEnvironment/README.md b/translations/sv/02-SetupDevEnvironment/README.md index 2fe7c2ad..c7a85ebd 100644 --- a/translations/sv/02-SetupDevEnvironment/README.md +++ b/translations/sv/02-SetupDevEnvironment/README.md @@ -1,13 +1,251 @@ - +# Ställa in utvecklingsmiljön för Generative AI för Java +> **Snabbstart**: Koda i molnet på 2 minuter - Hoppa till [GitHub Codespaces Setup](../../../02-SetupDevEnvironment) - ingen lokal installation krävs och använder github-modeller! + +> **Intresserad av Azure OpenAI?**, se vår [Azure OpenAI Setup Guide](getting-started-azure-openai.md) med steg för att skapa en ny Azure OpenAI-resurs. + +## Vad du kommer att lära dig + +- Ställa in en Java-utvecklingsmiljö för AI-applikationer +- Välja och konfigurera din föredragna utvecklingsmiljö (cloud-first med Codespaces, lokal dev container eller full lokal installation) +- Testa din installation genom att ansluta till GitHub Models + +## Innehållsförteckning + +- [Vad du kommer att lära dig](../../../02-SetupDevEnvironment) +- [Introduktion](../../../02-SetupDevEnvironment) +- [Steg 1: Ställ in din utvecklingsmiljö](../../../02-SetupDevEnvironment) + - [Alternativ A: GitHub Codespaces (rekommenderas)](../../../02-SetupDevEnvironment) + - [Alternativ B: Lokal Dev Container](../../../02-SetupDevEnvironment) + - [Alternativ C: Använd din befintliga lokala installation](../../../02-SetupDevEnvironment) +- [Steg 2: Skapa GitHub-personligt åtkomsttoken](../../../02-SetupDevEnvironment) +- [Steg 3: Testa din installation](../../../02-SetupDevEnvironment) +- [Felsökning](../../../02-SetupDevEnvironment) +- [Sammanfattning](../../../02-SetupDevEnvironment) +- [Nästa steg](../../../02-SetupDevEnvironment) + +## Introduktion + +Det här kapitlet guidar dig genom att ställa in en utvecklingsmiljö. Vi använder **GitHub Models** som vårt huvudsakliga exempel eftersom det är gratis, enkelt att sätta upp med bara ett GitHub-konto, kräver inget kreditkort och ger tillgång till flera modeller för experimentering. + +**Ingen lokal installation krävs!** Du kan börja koda direkt med GitHub Codespaces, som tillhandahåller en fullständig utvecklingsmiljö i din webbläsare. + +Skärmdump: GitHub Models + +Vi rekommenderar att använda [**GitHub Models**](https://github.com/marketplace?type=models) för den här kursen eftersom det är: +- **Gratis** att komma igång +- **Enkelt** att ställa in med bara ett GitHub-konto +- **Inget kreditkort** krävs +- **Flera modeller** tillgängliga för experimentering + +> **Notera**: De GitHub Models som används i denna träning har dessa gratisgränser: +> - 15 förfrågningar per minut (150 per dag) +> - ~8 000 ord in, ~4 000 ord ut per förfrågan +> - 5 samtidiga förfrågningar +> +> För produktionsanvändning, uppgradera till Azure AI Foundry Models med ditt Azure-konto. Din kod behöver inte ändras. Se dokumentationen för [Azure AI Foundry](https://learn.microsoft.com/azure/ai-foundry/foundry-models/how-to/quickstart-github-models). + +## Steg 1: Ställ in din utvecklingsmiljö + + + +Vi har skapat en förkonfigurerad utvecklingscontainer för att minimera installationstid och säkerställa att du har alla nödvändiga verktyg för denna Generative AI för Java-kurs. Välj din föredragna utvecklingsmetod: + +### Alternativ för miljöinställning: + +#### Alternativ A: GitHub Codespaces (rekommenderas) + +**Börja koda på 2 minuter – ingen lokal installation krävs!** + +1. Forka detta repository till ditt GitHub-konto + > **Notera**: Om du vill redigera den grundläggande konfigurationen, ta en titt på [Dev Container Configuration](../../../.devcontainer/devcontainer.json) +2. Klicka **Code** → fliken **Codespaces** → **...** → **New with options...** +3. Använd standardinställningarna – detta väljer **Dev container configuration**: **Generative AI Java Development Environment** anpassad devcontainer skapad för denna kurs +4. Klicka **Create codespace** +5. Vänta ~2 minuter tills miljön är redo +6. Fortsätt till [Steg 2: Skapa GitHub-token](../../../02-SetupDevEnvironment) + +Skärmdump: Codespaces undermeny + +Skärmdump: New with options + +Skärmdump: Skapa codespace-alternativ + +> **Fördelar med Codespaces**: +> - Ingen lokal installation krävs +> - Fungerar på vilken enhet som helst med en webbläsare +> - Förkonfigurerad med alla verktyg och beroenden +> - Gratis 60 timmar per månad för personliga konton +> - Enhetlig miljö för alla deltagare + +#### Alternativ B: Lokal Dev Container + +**För utvecklare som föredrar lokal utveckling med Docker** + +1. Forka och klona detta repository till din lokala dator + > **Notera**: Om du vill redigera den grundläggande konfigurationen, ta en titt på [Dev Container Configuration](../../../.devcontainer/devcontainer.json) +2. Installera [Docker Desktop](https://www.docker.com/products/docker-desktop/) och [VS Code](https://code.visualstudio.com/) +3. Installera [Dev Containers-tillägget](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers) i VS Code +4. Öppna repository-mappen i VS Code +5. När du uppmanas, klicka på **Reopen in Container** (eller använd `Ctrl+Shift+P` → "Dev Containers: Reopen in Container") +6. Vänta på att containern byggs och startas +7. Fortsätt till [Steg 2: Skapa GitHub-token](../../../02-SetupDevEnvironment) + +Skärmdump: Dev container-setup + +Skärmdump: Färdigbyggd dev container + +#### Alternativ C: Använd din befintliga lokala installation + +**För utvecklare med befintliga Java-miljöer** + +Förutsättningar: +- [Java 21+](https://www.oracle.com/java/technologies/javase/jdk21-archive-downloads.html) +- [Maven 3.9+](https://maven.apache.org/download.cgi) +- [VS Code](https://code.visualstudio.com) eller din föredragna IDE + +Steg: +1. Klona detta repository till din lokala maskin +2. Öppna projektet i din IDE +3. Fortsätt till [Steg 2: Skapa GitHub-token](../../../02-SetupDevEnvironment) + +> **Proffstips**: Om du har en lågpresterande maskin men vill använda VS Code lokalt, använd GitHub Codespaces! Du kan ansluta din lokala VS Code till en molnhostad Codespace och få det bästa av två världar. + +Skärmdump: skapad lokal devcontainer-instans + +## Steg 2: Skapa GitHub-personligt åtkomsttoken + +1. Navigera till [GitHub Settings](https://github.com/settings/profile) och välj **Settings** i din profilmeny. +2. Klicka på **Developer settings** i sidomenyn till vänster (vanligtvis längst ner). +3. Under **Personal access tokens**, klicka på **Fine-grained tokens** (eller följ denna direkta [länk](https://github.com/settings/personal-access-tokens)). +4. Klicka på **Generate new token**. +5. Under "Token name", ange ett beskrivande namn (t.ex. `GenAI-Java-Course-Token`). +6. Ange ett utgångsdatum (rekommenderat: 7 dagar för bästa säkerhetspraxis). +7. Under "Resource owner", välj ditt användarkonto. +8. Under "Repository access", välj de repositories du vill använda med GitHub Models (eller "All repositories" om det behövs). +9. Under "Account permissions", hitta **Models** och ställ in det på **Read-only**. +10. Klicka på **Generate token**. +11. **Kopiera och spara din token nu** – du kommer inte att se den igen! + +> **Säkerhetstips**: Använd minsta nödvändiga behörigheter och kortast praktiska giltighetstid för dina access tokens. + +## Steg 3: Testa din installation med GitHub Models-exemplet + +När din utvecklingsmiljö är redo, låt oss testa GitHub Models-integrationen med vårt exempelprogram i [`02-SetupDevEnvironment/examples/github-models`](../../../02-SetupDevEnvironment/examples/github-models). + +1. Öppna terminalen i din utvecklingsmiljö. +2. Navigera till GitHub Models-exemplet: + ```bash + cd 02-SetupDevEnvironment/examples/github-models + ``` +3. Sätt din GitHub-token som en miljövariabel: + ```bash + # macOS/Linux + export GITHUB_TOKEN=your_token_here + + # Windows (Kommandoprompt) + set GITHUB_TOKEN=your_token_here + + # Windows (PowerShell) + $env:GITHUB_TOKEN="your_token_here" + ``` + +4. Kör applikationen: + ```bash + mvn compile exec:java -Dexec.mainClass="com.example.githubmodels.App" + ``` + +Du bör se en utdata som liknar: +```text +Using model: gpt-4.1-nano +Sending request to GitHub Models... +Response: Hello World! +``` + +### Förstå exempel-koden + +Först, låt oss förstå vad vi just körde. Exemplet under `examples/github-models` använder OpenAI Java SDK för att ansluta till GitHub Models: + +**Vad denna kod gör:** +- **Ansluter** till GitHub Models med din personliga åtkomsttoken +- **Skickar** ett enkelt meddelande "Say Hello World!" till AI-modellen +- **Tar emot** och visar AI:s svar +- **Verifierar** att din setup fungerar korrekt + +**Viktig beroende** (i `pom.xml`): +```xml + + com.openai + openai-java + 2.12.0 + +``` + +**Huvudkod** (`App.java`): +```java +// Anslut till GitHub-modeller med OpenAI Java SDK +OpenAIClient client = OpenAIOkHttpClient.builder() + .apiKey(pat) + .baseUrl("https://models.inference.ai.azure.com") + .build(); + +// Skapa förfrågan om chattfullbordan +ChatCompletionCreateParams params = ChatCompletionCreateParams.builder() + .model(modelId) + .addSystemMessage("You are a concise assistant.") + .addUserMessage("Say Hello World!") + .build(); + +// Hämta AI-svar +ChatCompletion response = client.chat().completions().create(params); +System.out.println("Response: " + response.choices().get(0).message().content().orElse("No response content")); +``` + +## Sammanfattning + +Bra jobbat! Du har nu allt på plats: + +- Skapat en GitHub-personlig åtkomsttoken med rätt behörigheter för AI-modellåtkomst +- Fått din Java-utvecklingsmiljö att köras (oavsett om det är Codespaces, dev containers eller lokal) +- Anslutit till GitHub Models med OpenAI Java SDK för gratis AI-utveckling +- Testat att allt fungerar med ett enkelt exempel som kommunicerar med AI-modeller + +## Nästa steg + +[Kapitel 3: Kärntekniker för Generative AI](../03-CoreGenerativeAITechniques/README.md) + +## Felsökning + +Problem? Här är vanliga problem och lösningar: + +- **Token fungerar inte?** + - Kontrollera att du kopierade hela token utan extra mellanslag + - Verifiera att token är korrekt satt som en miljövariabel + - Kontrollera att din token har rätt behörigheter (Models: Read-only) + +- **Maven hittas inte?** + - Om du använder dev containers/Codespaces bör Maven vara förinstallerat + - För lokal installation, se till att Java 21+ och Maven 3.9+ är installerade + - Testa `mvn --version` för att verifiera installationen + +- **Anslutningsproblem?** + - Kontrollera din internetanslutning + - Verifiera att GitHub är åtkomligt från ditt nätverk + - Säkerställ att du inte är bakom en brandvägg som blockerar GitHub Models-endpoint + +- **Dev container startar inte?** + - Kontrollera att Docker Desktop körs (för lokal utveckling) + - Försök bygga om containern: `Ctrl+Shift+P` → "Dev Containers: Rebuild Container" + +- **Kompileringsfel i applikationen?** + - Kontrollera att du är i rätt katalog: `02-SetupDevEnvironment/examples/github-models` + - Försök rengöra och bygga igen: `mvn clean compile` + +> **Behöver du hjälp?**: Har du fortfarande problem? Öppna ett issue i repositoryn så hjälper vi dig. --- + +**Ansvarsfriskrivning**: +Detta dokument har översatts med hjälp av AI-översättningstjänsten [Co-op Translator](https://github.com/Azure/co-op-translator). Vi strävar efter noggrannhet, men var vänlig observera att automatiska översättningar kan innehålla fel eller felaktigheter. Det ursprungliga dokumentet på dess ursprungsspråk ska betraktas som den auktoritativa källan. För kritisk information rekommenderas professionell manuell översättning. Vi ansvarar ej för eventuella missförstånd eller feltolkningar som uppstår genom användning av denna översättning. + \ No newline at end of file diff --git a/translations/sv/02-SetupDevEnvironment/examples/basic-chat-azure/README.md b/translations/sv/02-SetupDevEnvironment/examples/basic-chat-azure/README.md index 87c34986..adcfd046 100644 --- a/translations/sv/02-SetupDevEnvironment/examples/basic-chat-azure/README.md +++ b/translations/sv/02-SetupDevEnvironment/examples/basic-chat-azure/README.md @@ -1,12 +1,3 @@ - # Grundläggande chatt med Azure OpenAI - Komplett exempel Det här exemplet visar hur du skapar en enkel Spring Boot-applikation som ansluter till Azure OpenAI och testar din installation. diff --git a/translations/sv/02-SetupDevEnvironment/getting-started-azure-openai.md b/translations/sv/02-SetupDevEnvironment/getting-started-azure-openai.md index ccea0142..d9ff70d4 100644 --- a/translations/sv/02-SetupDevEnvironment/getting-started-azure-openai.md +++ b/translations/sv/02-SetupDevEnvironment/getting-started-azure-openai.md @@ -1,12 +1,3 @@ - # Ställa in utvecklingsmiljön för Azure OpenAI > **Snabbstart**: Den här guiden är för att konfigurera Azure OpenAI. För att komma igång direkt med gratis modeller, använd [GitHub Models with Codespaces](./README.md#quick-start-cloud). diff --git a/translations/sv/03-CoreGenerativeAITechniques/README.md b/translations/sv/03-CoreGenerativeAITechniques/README.md index e717e7aa..e2f04962 100644 --- a/translations/sv/03-CoreGenerativeAITechniques/README.md +++ b/translations/sv/03-CoreGenerativeAITechniques/README.md @@ -1,12 +1,3 @@ - # Core Generative AI Techniques Tutorial ## Innehållsförteckning diff --git a/translations/sv/04-PracticalSamples/README.md b/translations/sv/04-PracticalSamples/README.md index 75fe6577..3a879ffc 100644 --- a/translations/sv/04-PracticalSamples/README.md +++ b/translations/sv/04-PracticalSamples/README.md @@ -1,12 +1,3 @@ - # Praktiska Tillämpningar & Projekt ## Vad Du Kommer Lära Dig diff --git a/translations/sv/04-PracticalSamples/calculator/README.md b/translations/sv/04-PracticalSamples/calculator/README.md index 672d9b49..4085b67d 100644 --- a/translations/sv/04-PracticalSamples/calculator/README.md +++ b/translations/sv/04-PracticalSamples/calculator/README.md @@ -1,12 +1,3 @@ - # MCP Kalkylatorhandledning för Nybörjare ## Innehållsförteckning diff --git a/translations/sv/04-PracticalSamples/foundrylocal/README.md b/translations/sv/04-PracticalSamples/foundrylocal/README.md index 77ec856a..a4491ff3 100644 --- a/translations/sv/04-PracticalSamples/foundrylocal/README.md +++ b/translations/sv/04-PracticalSamples/foundrylocal/README.md @@ -1,12 +1,3 @@ - # Foundry Local Spring Boot Tutorial ## Innehållsförteckning diff --git a/translations/sv/04-PracticalSamples/petstory/README.md b/translations/sv/04-PracticalSamples/petstory/README.md index 1ff98e3d..3adb1e1f 100644 --- a/translations/sv/04-PracticalSamples/petstory/README.md +++ b/translations/sv/04-PracticalSamples/petstory/README.md @@ -1,12 +1,3 @@ - # Handledning för nybörjare: Pet Story Generator ## Innehållsförteckning diff --git a/translations/sv/05-ResponsibleGenAI/README.md b/translations/sv/05-ResponsibleGenAI/README.md index 36d4cc11..fcc4fc97 100644 --- a/translations/sv/05-ResponsibleGenAI/README.md +++ b/translations/sv/05-ResponsibleGenAI/README.md @@ -1,12 +1,3 @@ - # Ansvarsfull Generativ AI ## Vad du kommer att lära dig diff --git a/translations/sv/AGENTS.md b/translations/sv/AGENTS.md index 2ee5db8b..6a3fc218 100644 --- a/translations/sv/AGENTS.md +++ b/translations/sv/AGENTS.md @@ -1,12 +1,3 @@ - # AGENTS.md ## Projektöversikt diff --git a/translations/sv/CODE_OF_CONDUCT.md b/translations/sv/CODE_OF_CONDUCT.md index 273f4216..a2d6758d 100644 --- a/translations/sv/CODE_OF_CONDUCT.md +++ b/translations/sv/CODE_OF_CONDUCT.md @@ -1,12 +1,3 @@ - # Microsoft Open Source Uppförandekod Det här projektet har antagit [Microsoft Open Source Uppförandekod](https://opensource.microsoft.com/codeofconduct/). diff --git a/translations/sv/README.md b/translations/sv/README.md index 14f3aea4..d75be6de 100644 --- a/translations/sv/README.md +++ b/translations/sv/README.md @@ -1,111 +1,102 @@ - -# Generativ AI för Nybörjare - Java Edition +# Generativ AI för nybörjare – Java Edition [![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) -![Generativ AI för Nybörjare - Java Edition](../../translated_images/sv/beg-genai-series.8b48be9951cc574c.webp) +![Generativ AI för nybörjare – Java Edition](../../translated_images/sv/beg-genai-series.8b48be9951cc574c.webp) -**Tidsåtgång**: Hela workshoppen kan genomföras online utan lokal installation. Miljöinställningen tar 2 minuter, och att utforska exemplen kräver 1-3 timmar beroende på hur mycket man utforskar. +**Tidsåtgång**: Hela workshopen kan genomföras online utan lokal installation. Installation av miljön tar 2 minuter, och att utforska exemplen kräver 1–3 timmar beroende på djupet i utforskningen. > **Snabbstart** 1. Forka detta repository till ditt GitHub-konto 2. Klicka på **Code** → fliken **Codespaces** → **...** → **New with options...** -3. Använd standardinställningarna – detta väljer utvecklingscontainern som skapats för denna kurs +3. Använd standardinställningarna – detta väljer utvecklingsbehållaren som skapats för denna kurs 4. Klicka på **Create codespace** -5. Vänta ~2 minuter för att miljön ska bli klar -6. Hoppa direkt till [Det första exemplet](./02-SetupDevEnvironment/README.md#step-2-create-a-github-personal-access-token) +5. Vänta ~2 minuter tills miljön är klar +6. Gå direkt till [Det första exemplet](./02-SetupDevEnvironment/README.md#step-2-create-a-github-personal-access-token) > **Föredrar du att klona lokalt?** > -> Detta repository innehåller 50+ språköversättningar som avsevärt ökar nedladdningsstorleken. För att klona utan översättningar, använd sparsamt checkout: +> Detta repository inkluderar 50+ språköversättningar vilket avsevärt ökar nedladdningsstorleken. För att klona utan översättningar, använd sparse checkout: > ```bash > git clone --filter=blob:none --sparse https://github.com/microsoft/Generative-AI-for-beginners-java.git > cd Generative-AI-for-beginners-java > git sparse-checkout set --no-cone '/*' '!translations' '!translated_images' > ``` -> Detta ger dig allt du behöver för att slutföra kursen med mycket snabbare nedladdning. +> Detta ger dig allt du behöver för att slutföra kursen med en mycket snabbare nedladdning. -## Flerspråkigt Stöd +## Fler språkstöd -### Stöds via GitHub Action (Automatiserat & Alltid Uppdaterat) +### Stöds via GitHub Action (Automatiserat & Alltid uppdaterat) -[Arabiska](../ar/README.md) | [Bengaliska](../bn/README.md) | [Bulgariska](../bg/README.md) | [Burmesiska (Myanmar)](../my/README.md) | [Kinesiska (Förenklad)](../zh/README.md) | [Kinesiska (Traditionell, Hong Kong)](../hk/README.md) | [Kinesiska (Traditionell, Macau)](../mo/README.md) | [Kinesiska (Traditionell, Taiwan)](../tw/README.md) | [Kroatiska](../hr/README.md) | [Tjeckiska](../cs/README.md) | [Danska](../da/README.md) | [Holländska](../nl/README.md) | [Estniska](../et/README.md) | [Finska](../fi/README.md) | [Franska](../fr/README.md) | [Tyska](../de/README.md) | [Grekiska](../el/README.md) | [Hebreiska](../he/README.md) | [Hindi](../hi/README.md) | [Ungerska](../hu/README.md) | [Indonesiska](../id/README.md) | [Italienska](../it/README.md) | [Japanska](../ja/README.md) | [Kannada](../kn/README.md) | [Koreanska](../ko/README.md) | [Litauiska](../lt/README.md) | [Malajiska](../ms/README.md) | [Malayalam](../ml/README.md) | [Marathi](../mr/README.md) | [Nepalesiska](../ne/README.md) | [Nigeriansk Pidgin](../pcm/README.md) | [Norska](../no/README.md) | [Persiska (Farsi)](../fa/README.md) | [Polska](../pl/README.md) | [Portugisiska (Brasilien)](../br/README.md) | [Portugisiska (Portugal)](../pt/README.md) | [Punjabi (Gurmukhi)](../pa/README.md) | [Rumänska](../ro/README.md) | [Ryska](../ru/README.md) | [Serbiska (Kyrilliska)](../sr/README.md) | [Slovakiska](../sk/README.md) | [Slovenska](../sl/README.md) | [Spanska](../es/README.md) | [Swahili](../sw/README.md) | [Svenska](./README.md) | [Tagalog (Filippinska)](../tl/README.md) | [Tamil](../ta/README.md) | [Telugu](../te/README.md) | [Thailändska](../th/README.md) | [Turkiska](../tr/README.md) | [Ukrainska](../uk/README.md) | [Urdu](../ur/README.md) | [Vietnamesiska](../vi/README.md) +[Arabiska](../ar/README.md) | [Bengali](../bn/README.md) | [Bulgariska](../bg/README.md) | [Burmese (Myanmar)](../my/README.md) | [Kinesiska (Förenklad)](../zh-CN/README.md) | [Kinesiska (Traditionell, Hongkong)](../zh-HK/README.md) | [Kinesiska (Traditionell, Macau)](../zh-MO/README.md) | [Kinesiska (Traditionell, Taiwan)](../zh-TW/README.md) | [Kroatiska](../hr/README.md) | [Tjeckiska](../cs/README.md) | [Danska](../da/README.md) | [Holländska](../nl/README.md) | [Estniska](../et/README.md) | [Finska](../fi/README.md) | [Franska](../fr/README.md) | [Tyska](../de/README.md) | [Grekiska](../el/README.md) | [Hebreiska](../he/README.md) | [Hindi](../hi/README.md) | [Ungerska](../hu/README.md) | [Indonesiska](../id/README.md) | [Italienska](../it/README.md) | [Japanska](../ja/README.md) | [Kannada](../kn/README.md) | [Koreanska](../ko/README.md) | [Litauiska](../lt/README.md) | [Malajiska](../ms/README.md) | [Malayalam](../ml/README.md) | [Marathi](../mr/README.md) | [Nepalesiska](../ne/README.md) | [Nigeriansk Pidgin](../pcm/README.md) | [Norska](../no/README.md) | [Persiska (Farsi)](../fa/README.md) | [Polska](../pl/README.md) | [Portugisiska (Brasilien)](../pt-BR/README.md) | [Portugisiska (Portugal)](../pt-PT/README.md) | [Punjabi (Gurmukhi)](../pa/README.md) | [Rumänska](../ro/README.md) | [Ryska](../ru/README.md) | [Serbiska (Kyrilliska)](../sr/README.md) | [Slovakiska](../sk/README.md) | [Slovenska](../sl/README.md) | [Spanska](../es/README.md) | [Swahili](../sw/README.md) | [Svenska](./README.md) | [Tagalog (Filippinska)](../tl/README.md) | [Tamil](../ta/README.md) | [Telugu](../te/README.md) | [Thailändska](../th/README.md) | [Turkiska](../tr/README.md) | [Ukrainska](../uk/README.md) | [Urdu](../ur/README.md) | [Vietnamesiska](../vi/README.md) > **Föredrar du att klona lokalt?** -> Detta repository innehåller 50+ språköversättningar som avsevärt ökar nedladdningsstorleken. För att klona utan översättningar, använd sparsamt checkout: +> Detta repository inkluderar 50+ språköversättningar vilket avsevärt ökar nedladdningsstorleken. För att klona utan översättningar, använd sparse checkout: > ```bash > git clone --filter=blob:none --sparse https://github.com/microsoft/Generative-AI-for-beginners-java.git > cd Generative-AI-for-beginners-java > git sparse-checkout set --no-cone '/*' '!translations' '!translated_images' > ``` -> Detta ger dig allt du behöver för att slutföra kursen med mycket snabbare nedladdning. +> Detta ger dig allt du behöver för att slutföra kursen med en mycket snabbare nedladdning. -## Kursstruktur & Lärandebana +## Kursstruktur & Lärväg ### **Kapitel 1: Introduktion till Generativ AI** -- **Grundläggande Begrepp**: Förstå stora språkmodeller, tokens, inbäddningar och AI:s kapabiliteter -- **Java AI-ekosystemet**: Översikt av Spring AI och OpenAI SDKs -- **Model Context Protocol**: Introduktion till MCP och dess roll i AI-agenters kommunikation -- **Praktiska Tillämpningar**: Verkliga scenarier inklusive chatbots och innehållsgenerering -- **[→ Starta Kapitel 1](./01-IntroToGenAI/README.md)** - -### **Kapitel 2: Utvecklingsmiljö Setup** -- **Multi-leverantörskonfiguration**: Ställ in GitHub Models, Azure OpenAI och OpenAI Java SDK-integrationer -- **Spring Boot + Spring AI**: Bästa praxis för företags-AI-applikationsutveckling -- **GitHub Models**: Gratis AI-modelltillgång för prototyper och lärande (kräver inget kreditkort) +- **Grundläggande koncept**: Förstå stora språkmodeller, tokens, embeddings och AI:s kapacitet +- **Java AI-ekosystem**: Översikt över Spring AI och OpenAI SDK:er +- **Model Context Protocol**: Introduktion till MCP och dess roll i AI-agentkommunikation +- **Praktiska tillämpningar**: Verkliga scenarier inklusive chattbotar och innehållsgenerering +- **[→ Starta kapitel 1](./01-IntroToGenAI/README.md)** + +### **Kapitel 2: Installation av utvecklingsmiljö** +- **Flerleverantörskonfiguration**: Sätt upp GitHub Models, Azure OpenAI och OpenAI Java SDK-integrationer +- **Spring Boot + Spring AI**: Bästa praxis för företagsutveckling av AI-applikationer +- **GitHub Models**: Gratis AI-modeller för prototyping och lärande (kräver inget kreditkort) - **Utvecklingsverktyg**: Docker-containrar, VS Code och GitHub Codespaces-konfiguration -- **[→ Starta Kapitel 2](./02-SetupDevEnvironment/README.md)** +- **[→ Starta kapitel 2](./02-SetupDevEnvironment/README.md)** -### **Kapitel 3: Kärntekniker för Generativ AI** -- **Prompt Engineering**: Tekniker för optimala AI-modellsvar -- **Inbäddningar & Vektoroperationer**: Implementera semantisk sökning och likhetsmatchning -- **Retrieval-Augmented Generation (RAG)**: Kombinera AI med dina egna datakällor -- **Funktionsanrop**: Utöka AI-funktioner med egna verktyg och plugins -- **[→ Starta Kapitel 3](./03-CoreGenerativeAITechniques/README.md)** +### **Kapitel 3: Grundläggande generativa AI-tekniker** +- **Prompt engineering**: Tekniker för optimerade AI-modellsvar +- **Embeddings & vektoroperationer**: Implementera semantisk sökning och likhetsmatchning +- **Retrieval-Augmented Generation (RAG)**: Kombinera AI med egna datakällor +- **Funktionsanrop**: Utöka AI:s kapaciteter med anpassade verktyg och plugins +- **[→ Starta kapitel 3](./03-CoreGenerativeAITechniques/README.md)** -### **Kapitel 4: Praktiska Tillämpningar & Projekt** +### **Kapitel 4: Praktiska tillämpningar & projekt** - **Pet Story Generator** (`petstory/`): Kreativ innehållsgenerering med GitHub Models -- **Foundry Local Demo** (`foundrylocal/`): Lokal AI-modellintegration med OpenAI Java SDK -- **MCP Calculator Service** (`calculator/`): Enkel Model Context Protocol-implementering med Spring AI -- **[→ Starta Kapitel 4](./04-PracticalSamples/README.md)** +- **Foundry Local Demo** (`foundrylocal/`): Lokal AI-modellsintegration med OpenAI Java SDK +- **MCP Calculator Service** (`calculator/`): Grundläggande Model Context Protocol-implementering med Spring AI +- **[→ Starta kapitel 4](./04-PracticalSamples/README.md)** ### **Kapitel 5: Ansvarsfull AI-utveckling** -- **GitHub Models Säkerhet**: Testa inbyggd innehållsfiltrering och säkerhetsmekanismer (hårda blockeringar och mjuka avslag) -- **Ansvarsfull AI-demo**: Praktiskt exempel som visar hur moderna AI-säkerhetssystem fungerar i praktiken -- **Bästa Praxis**: Viktiga riktlinjer för etisk AI-utveckling och implementering -- **[→ Starta Kapitel 5](./05-ResponsibleGenAI/README.md)** +- **GitHub Models säkerhet**: Testa inbyggda innehållsfilter och säkerhetsmekanismer (hårda blockerings- och mjuka avvisningsfunktioner) +- **Demo för ansvarsfull AI**: Praktiskt exempel som visar hur moderna AI-säkerhetssystem fungerar i praktiken +- **Bästa praxis**: Viktiga riktlinjer för etisk AI-utveckling och implementering +- **[→ Starta kapitel 5](./05-ResponsibleGenAI/README.md)** -## Ytterligare Resurser +## Ytterligare resurser ### LangChain -[![LangChain4j för Nybörjare](https://img.shields.io/badge/LangChain4j%20for%20Beginners-22C55E?style=for-the-badge&&labelColor=E5E7EB&color=0553D6)](https://aka.ms/langchain4j-for-beginners) -[![LangChain.js för Nybörjare](https://img.shields.io/badge/LangChain.js%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=0553D6)](https://aka.ms/langchainjs-for-beginners?WT.mc_id=m365-94501-dwahlin) +[![LangChain4j för nybörjare](https://img.shields.io/badge/LangChain4j%20for%20Beginners-22C55E?style=for-the-badge&&labelColor=E5E7EB&color=0553D6)](https://aka.ms/langchain4j-for-beginners) +[![LangChain.js för nybörjare](https://img.shields.io/badge/LangChain.js%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=0553D6)](https://aka.ms/langchainjs-for-beginners?WT.mc_id=m365-94501-dwahlin) --- ### Azure / Edge / MCP / Agenter -[![AZD för Nybörjare](https://img.shields.io/badge/AZD%20for%20Beginners-0078D4?style=for-the-badge&labelColor=E5E7EB&color=0078D4)](https://github.com/microsoft/AZD-for-beginners?WT.mc_id=academic-105485-koreyst) -[![Edge AI för Nybörjare](https://img.shields.io/badge/Edge%20AI%20for%20Beginners-00B8E4?style=for-the-badge&labelColor=E5E7EB&color=00B8E4)](https://github.com/microsoft/edgeai-for-beginners?WT.mc_id=academic-105485-koreyst) -[![MCP för Nybörjare](https://img.shields.io/badge/MCP%20for%20Beginners-009688?style=for-the-badge&labelColor=E5E7EB&color=009688)](https://github.com/microsoft/mcp-for-beginners?WT.mc_id=academic-105485-koreyst) -[![AI Agenter för Nybörjare](https://img.shields.io/badge/AI%20Agents%20for%20Beginners-00C49A?style=for-the-badge&labelColor=E5E7EB&color=00C49A)](https://github.com/microsoft/ai-agents-for-beginners?WT.mc_id=academic-105485-koreyst) +[![AZD för nybörjare](https://img.shields.io/badge/AZD%20for%20Beginners-0078D4?style=for-the-badge&labelColor=E5E7EB&color=0078D4)](https://github.com/microsoft/AZD-for-beginners?WT.mc_id=academic-105485-koreyst) +[![Edge AI för nybörjare](https://img.shields.io/badge/Edge%20AI%20for%20Beginners-00B8E4?style=for-the-badge&labelColor=E5E7EB&color=00B8E4)](https://github.com/microsoft/edgeai-for-beginners?WT.mc_id=academic-105485-koreyst) +[![MCP för nybörjare](https://img.shields.io/badge/MCP%20for%20Beginners-009688?style=for-the-badge&labelColor=E5E7EB&color=009688)](https://github.com/microsoft/mcp-for-beginners?WT.mc_id=academic-105485-koreyst) +[![AI-agenter för nybörjare](https://img.shields.io/badge/AI%20Agents%20for%20Beginners-00C49A?style=for-the-badge&labelColor=E5E7EB&color=00C49A)](https://github.com/microsoft/ai-agents-for-beginners?WT.mc_id=academic-105485-koreyst) --- ### Generativ AI-serie -[![Generativ AI för Nybörjare](https://img.shields.io/badge/Generative%20AI%20for%20Beginners-8B5CF6?style=for-the-badge&labelColor=E5E7EB&color=8B5CF6)](https://github.com/microsoft/generative-ai-for-beginners?WT.mc_id=academic-105485-koreyst) +[![Generativ AI för nybörjare](https://img.shields.io/badge/Generative%20AI%20for%20Beginners-8B5CF6?style=for-the-badge&labelColor=E5E7EB&color=8B5CF6)](https://github.com/microsoft/generative-ai-for-beginners?WT.mc_id=academic-105485-koreyst) [![Generativ AI (.NET)](https://img.shields.io/badge/Generative%20AI%20(.NET)-9333EA?style=for-the-badge&labelColor=E5E7EB&color=9333EA)](https://github.com/microsoft/Generative-AI-for-beginners-dotnet?WT.mc_id=academic-105485-koreyst) [![Generativ AI (Java)](https://img.shields.io/badge/Generative%20AI%20(Java)-C084FC?style=for-the-badge&labelColor=E5E7EB&color=C084FC)](https://github.com/microsoft/generative-ai-for-beginners-java?WT.mc_id=academic-105485-koreyst) [![Generativ AI (JavaScript)](https://img.shields.io/badge/Generative%20AI%20(JavaScript)-E879F9?style=for-the-badge&labelColor=E5E7EB&color=E879F9)](https://github.com/microsoft/generative-ai-with-javascript?WT.mc_id=academic-105485-koreyst) @@ -113,25 +104,26 @@ CO_OP_TRANSLATOR_METADATA: --- ### Kärnkunskap -[![ML för Nybörjare](https://img.shields.io/badge/ML%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=22C55E)](https://aka.ms/ml-beginners?WT.mc_id=academic-105485-koreyst) -[![Data Science för Nybörjare](https://img.shields.io/badge/Data%20Science%20for%20Beginners-84CC16?style=for-the-badge&labelColor=E5E7EB&color=84CC16)](https://aka.ms/datascience-beginners?WT.mc_id=academic-105485-koreyst) -[![AI för Nybörjare](https://img.shields.io/badge/AI%20for%20Beginners-A3E635?style=for-the-badge&labelColor=E5E7EB&color=A3E635)](https://aka.ms/ai-beginners?WT.mc_id=academic-105485-koreyst) -[![Cybersäkerhet för Nybörjare](https://img.shields.io/badge/Cybersecurity%20for%20Beginners-F97316?style=for-the-badge&labelColor=E5E7EB&color=F97316)](https://github.com/microsoft/Security-101?WT.mc_id=academic-96948-sayoung) -[![Webbutveckling för Nybörjare](https://img.shields.io/badge/Web%20Dev%20for%20Beginners-EC4899?style=for-the-badge&labelColor=E5E7EB&color=EC4899)](https://aka.ms/webdev-beginners?WT.mc_id=academic-105485-koreyst) +[![ML för nybörjare](https://img.shields.io/badge/ML%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=22C55E)](https://aka.ms/ml-beginners?WT.mc_id=academic-105485-koreyst) +[![Data science för nybörjare](https://img.shields.io/badge/Data%20Science%20for%20Beginners-84CC16?style=for-the-badge&labelColor=E5E7EB&color=84CC16)](https://aka.ms/datascience-beginners?WT.mc_id=academic-105485-koreyst) +[![AI för nybörjare](https://img.shields.io/badge/AI%20for%20Beginners-A3E635?style=for-the-badge&labelColor=E5E7EB&color=A3E635)](https://aka.ms/ai-beginners?WT.mc_id=academic-105485-koreyst) +[![Cybersäkerhet för nybörjare](https://img.shields.io/badge/Cybersecurity%20for%20Beginners-F97316?style=for-the-badge&labelColor=E5E7EB&color=F97316)](https://github.com/microsoft/Security-101?WT.mc_id=academic-96948-sayoung) + +[![Webbutveckling för nybörjare](https://img.shields.io/badge/Web%20Dev%20for%20Beginners-EC4899?style=for-the-badge&labelColor=E5E7EB&color=EC4899)](https://aka.ms/webdev-beginners?WT.mc_id=academic-105485-koreyst) [![IoT för nybörjare](https://img.shields.io/badge/IoT%20for%20Beginners-14B8A6?style=for-the-badge&labelColor=E5E7EB&color=14B8A6)](https://aka.ms/iot-beginners?WT.mc_id=academic-105485-koreyst) [![XR-utveckling för nybörjare](https://img.shields.io/badge/XR%20Development%20for%20Beginners-38BDF8?style=for-the-badge&labelColor=E5E7EB&color=38BDF8)](https://github.com/microsoft/xr-development-for-beginners?WT.mc_id=academic-105485-koreyst) --- ### Copilot-serien -[![Copilot för AI-samarbetsprogrammering](https://img.shields.io/badge/Copilot%20for%20AI%20Paired%20Programming-FACC15?style=for-the-badge&labelColor=E5E7EB&color=FACC15)](https://aka.ms/GitHubCopilotAI?WT.mc_id=academic-105485-koreyst) +[![Copilot för AI-parprogrammering](https://img.shields.io/badge/Copilot%20for%20AI%20Paired%20Programming-FACC15?style=for-the-badge&labelColor=E5E7EB&color=FACC15)](https://aka.ms/GitHubCopilotAI?WT.mc_id=academic-105485-koreyst) [![Copilot för C#/.NET](https://img.shields.io/badge/Copilot%20for%20C%23/.NET-FBBF24?style=for-the-badge&labelColor=E5E7EB&color=FBBF24)](https://github.com/microsoft/mastering-github-copilot-for-dotnet-csharp-developers?WT.mc_id=academic-105485-koreyst) -[![Copilot Adventure](https://img.shields.io/badge/Copilot%20Adventure-FDE68A?style=for-the-badge&labelColor=E5E7EB&color=FDE68A)](https://github.com/microsoft/CopilotAdventures?WT.mc_id=academic-105485-koreyst) +[![Copilot-äventyr](https://img.shields.io/badge/Copilot%20Adventure-FDE68A?style=for-the-badge&labelColor=E5E7EB&color=FDE68A)](https://github.com/microsoft/CopilotAdventures?WT.mc_id=academic-105485-koreyst) ## Få hjälp -Om du kör fast eller har frågor om att bygga AI-appar. Gå med i diskussioner med andra lärande och erfarna utvecklare om MCP. Det är en stödjande gemenskap där frågor är välkomna och kunskap delas fritt. +Om du fastnar eller har frågor om att bygga AI-appar. Gå med i samtal med andra elever och erfarna utvecklare om MCP. Det är en stöttande gemenskap där frågor är välkomna och kunskap delas fritt. [![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) @@ -142,6 +134,6 @@ Om du har produktfeedback eller stöter på fel när du bygger, besök: --- -**Ansvarsfriskrivning**: -Detta dokument har översatts med hjälp av AI-översättningstjänsten [Co-op Translator](https://github.com/Azure/co-op-translator). Trots att vi strävar efter noggrannhet, var vänlig observera att automatiska översättningar kan innehålla fel eller avvikelser. Det ursprungliga dokumentet på dess modersmål bör betraktas som den auktoritativa källan. För kritisk information rekommenderas professionell mänsklig översättning. Vi ansvarar inte för några missförstånd eller felaktiga tolkningar som uppstår vid användning av denna översättning. +**Ansvarsfriskrivning**: +Detta dokument har översatts med hjälp av AI-översättningstjänsten [Co-op Translator](https://github.com/Azure/co-op-translator). Även om vi strävar efter noggrannhet, var god notera att automatiska översättningar kan innehålla fel eller brister. Det ursprungliga dokumentet på dess modersmål bör betraktas som den auktoritativa källan. För kritisk information rekommenderas professionell mänsklig översättning. Vi ansvarar inte för några missförstånd eller feltolkningar som uppstår till följd av användningen av denna översättning. \ No newline at end of file diff --git a/translations/sv/SECURITY.md b/translations/sv/SECURITY.md index ef89e983..d183baf0 100644 --- a/translations/sv/SECURITY.md +++ b/translations/sv/SECURITY.md @@ -1,12 +1,3 @@ - ## Säkerhet Microsoft tar säkerheten för våra mjukvaruprodukter och tjänster på största allvar, vilket inkluderar alla källkodsförråd som hanteras genom våra GitHub-organisationer, som inkluderar [Microsoft](https://github.com/Microsoft), [Azure](https://github.com/Azure), [DotNet](https://github.com/dotnet), [AspNet](https://github.com/aspnet) och [Xamarin](https://github.com/xamarin). diff --git a/translations/sv/SUPPORT.md b/translations/sv/SUPPORT.md index d591ef5c..2ef54268 100644 --- a/translations/sv/SUPPORT.md +++ b/translations/sv/SUPPORT.md @@ -1,12 +1,3 @@ - # Support ## Hur man rapporterar problem och får hjälp diff --git a/translations/sw/.co-op-translator.json b/translations/sw/.co-op-translator.json new file mode 100644 index 00000000..9b216f8a --- /dev/null +++ b/translations/sw/.co-op-translator.json @@ -0,0 +1,92 @@ +{ + "01-IntroToGenAI/README.md": { + "original_hash": "75bfb080ca725e8a9aa9c80cae25fba1", + "translation_date": "2025-07-29T09:55:48+00:00", + "source_file": "01-IntroToGenAI/README.md", + "language_code": "sw" + }, + "02-SetupDevEnvironment/README.md": { + "original_hash": "96a30d42b9751a3d4e4b20e28d29d459", + "translation_date": "2026-01-28T05:15:44+00:00", + "source_file": "02-SetupDevEnvironment/README.md", + "language_code": "sw" + }, + "02-SetupDevEnvironment/examples/basic-chat-azure/README.md": { + "original_hash": "efd82efe50711d7e257eb943151d682c", + "translation_date": "2025-07-27T13:45:27+00:00", + "source_file": "02-SetupDevEnvironment/examples/basic-chat-azure/README.md", + "language_code": "sw" + }, + "02-SetupDevEnvironment/getting-started-azure-openai.md": { + "original_hash": "bfdb4b4eadbee3a59ef742439f58326a", + "translation_date": "2025-07-27T13:21:57+00:00", + "source_file": "02-SetupDevEnvironment/getting-started-azure-openai.md", + "language_code": "sw" + }, + "03-CoreGenerativeAITechniques/README.md": { + "original_hash": "685f55cb07de19b52a30ce6e8b6d889e", + "translation_date": "2025-08-28T22:13:31+00:00", + "source_file": "03-CoreGenerativeAITechniques/README.md", + "language_code": "sw" + }, + "04-PracticalSamples/README.md": { + "original_hash": "14c0a61ecc1cd2012a9c129236dfdf71", + "translation_date": "2025-07-29T09:55:34+00:00", + "source_file": "04-PracticalSamples/README.md", + "language_code": "sw" + }, + "04-PracticalSamples/calculator/README.md": { + "original_hash": "b6c16b5514d524e415a94f6097ee7d4c", + "translation_date": "2025-09-18T15:38:06+00:00", + "source_file": "04-PracticalSamples/calculator/README.md", + "language_code": "sw" + }, + "04-PracticalSamples/foundrylocal/README.md": { + "original_hash": "f787307400de59adc25a1404466a35f3", + "translation_date": "2025-11-04T07:31:50+00:00", + "source_file": "04-PracticalSamples/foundrylocal/README.md", + "language_code": "sw" + }, + "04-PracticalSamples/petstory/README.md": { + "original_hash": "0cbf68d605615a1e602c832a24616859", + "translation_date": "2025-07-25T11:48:48+00:00", + "source_file": "04-PracticalSamples/petstory/README.md", + "language_code": "sw" + }, + "05-ResponsibleGenAI/README.md": { + "original_hash": "301c05c2f57e60a6950b8c665b8bdbba", + "translation_date": "2025-07-29T15:56:44+00:00", + "source_file": "05-ResponsibleGenAI/README.md", + "language_code": "sw" + }, + "AGENTS.md": { + "original_hash": "afc90918d008cf77fd1982691f681306", + "translation_date": "2025-10-03T08:41:19+00:00", + "source_file": "AGENTS.md", + "language_code": "sw" + }, + "CODE_OF_CONDUCT.md": { + "original_hash": "442b123d034f92f7c384d2bbd28f99f1", + "translation_date": "2025-07-21T20:37:16+00:00", + "source_file": "CODE_OF_CONDUCT.md", + "language_code": "sw" + }, + "README.md": { + "original_hash": "125a08948d881c95628094f4dd1fbd43", + "translation_date": "2026-01-29T16:05:20+00:00", + "source_file": "README.md", + "language_code": "sw" + }, + "SECURITY.md": { + "original_hash": "57f14126c1c6add76b3aef3844dfe4e3", + "translation_date": "2025-07-21T20:34:45+00:00", + "source_file": "SECURITY.md", + "language_code": "sw" + }, + "SUPPORT.md": { + "original_hash": "b8ef73cc49dec68e2c885ee9df545129", + "translation_date": "2025-07-21T20:38:31+00:00", + "source_file": "SUPPORT.md", + "language_code": "sw" + } +} \ No newline at end of file diff --git a/translations/sw/01-IntroToGenAI/README.md b/translations/sw/01-IntroToGenAI/README.md index e43f1370..ce120f8a 100644 --- a/translations/sw/01-IntroToGenAI/README.md +++ b/translations/sw/01-IntroToGenAI/README.md @@ -1,12 +1,3 @@ - # Utangulizi wa AI Jenereta - Toleo la Java ## Kile Utakachojifunza diff --git a/translations/sw/02-SetupDevEnvironment/README.md b/translations/sw/02-SetupDevEnvironment/README.md index a1f95ac5..c2dbeef9 100644 --- a/translations/sw/02-SetupDevEnvironment/README.md +++ b/translations/sw/02-SetupDevEnvironment/README.md @@ -1,13 +1,251 @@ - +# Kuweka Mazingira ya Maendeleo kwa AI ya Kizazi kwa Java +> **Anza Haraka**: Andika Msimbo Katika Cloud kwa Dakika 2 - Ruka kwa [Mpangilio wa GitHub Codespaces](../../../02-SetupDevEnvironment) - hakuna usakinishaji wa ndani unahitajika na hutumia mifano ya github! + +> **Una nia ya Azure OpenAI?**, ona [Mwongozo wetu wa Mpangilio wa Azure OpenAI](getting-started-azure-openai.md) na hatua za kuunda rasilimali mpya ya Azure OpenAI. + +## Utajifunza Nini + +- Weka mazingira ya maendeleo ya Java kwa programu za AI +- Chagua na sanifu mazingira yako ya maendeleo unayopendelea (cloud-first na Codespaces, kontena la maendeleo la ndani, au mpangilio kamili wa ndani) +- Jaribu mpangilio wako kwa kuunganishwa na Mifano ya GitHub + +## Jedwali la Maudhui + +- [Utajifunza Nini](../../../02-SetupDevEnvironment) +- [Utangulizi](../../../02-SetupDevEnvironment) +- [Hatua ya 1: Weka Mazingira Yako ya Maendeleo](../../../02-SetupDevEnvironment) + - [Chaguo A: GitHub Codespaces (Inapendekezwa)](../../../02-SetupDevEnvironment) + - [Chaguo B: Kontena la Maendeleo la Ndani](../../../02-SetupDevEnvironment) + - [Chaguo C: Tumia Usakinishaji Wako wa Ndani Ulio Tayari](../../../02-SetupDevEnvironment) +- [Hatua ya 2: Tengeneza Token ya Ufikiaji wa Binafsi GitHub](../../../02-SetupDevEnvironment) +- [Hatua ya 3: Jaribu Mpangilio Wako](../../../02-SetupDevEnvironment) +- [Kutatua Matatizo](../../../02-SetupDevEnvironment) +- [Muhtasari](../../../02-SetupDevEnvironment) +- [Hatua Zifuatazo](../../../02-SetupDevEnvironment) + +## Utangulizi + +Sura hii itakuongoza kupitia kuanzisha mazingira ya maendeleo. Tutatumia **Mifano ya GitHub** kama mfano wetu kuu kwa sababu ni bure, rahisi kuanzisha kwa akaunti ya GitHub tu, haina haja ya kadi ya mkopo, na inatoa ufikiaji wa mifano mingi kwa majaribio. + +**Hakuna usakinishaji wa ndani unahitajika!** Unaweza kuanza kuandika msimbo mara moja ukitumia GitHub Codespaces, inayotoa mazingira kamili ya maendeleo kwenye kivinjari chako. + +Picha ya skrini: Mifano ya GitHub + +Tunapendekeza kutumia [**Mifano ya GitHub**](https://github.com/marketplace?type=models) kwa kozi hii kwa sababu ni: +- **Bure** kuanza +- **Rahisi** kuanzisha kwa akaunti ya GitHub tu +- **Hakuna kadi ya mkopo** inahitajika +- **Mifano mingi** inapatikana kwa majaribio + +> **Kumbuka**: Mifano ya GitHub inayotumiwa katika mafunzo haya ina mipaka hii ya bure: +> - Maombi 15 kwa dakika (150 kwa siku) +> - ~maneno 8,000 ya kuingiza, ~maneno 4,000 ya kutolewa kwa kila ombi +> - Maombi 5 yanayofanya kazi kwa wakati mmoja +> +> Kwa matumizi ya uzalishaji, boresha hadi Azure AI Foundry Models kwa akaunti yako ya Azure. Msimbo wako hauhitaji kubadilika. Angalia [nyaraka za Azure AI Foundry](https://learn.microsoft.com/azure/ai-foundry/foundry-models/how-to/quickstart-github-models). + +## Hatua ya 1: Weka Mazingira Yako ya Maendeleo + + + +Tumetengeneza kontena la maendeleo lililosanifiwa tayari kupunguza muda wa kuanzisha na kuhakikisha una vifaa vyote muhimu kwa kozi hii ya AI ya Kizazi kwa Java. Chagua njia ya maendeleo unayopendelea: + +### Chaguzi za Mpangilio wa Mazingira: + +#### Chaguo A: GitHub Codespaces (Inapendekezwa) + +**Anza kuandika msimbo ndani ya dakika 2 - hakuna usakinishaji wa ndani unahitajika!** + +1. Fanya fork ya hazina hii kwenye akaunti yako ya GitHub + > **Kumbuka**: Ikiwa unataka kuhariri usanidi msingi tafadhali angalia [Mpangilio wa Kontena ya Maendeleo](../../../.devcontainer/devcontainer.json) +2. Bonyeza **Code** → kichupo cha **Codespaces** → **...** → **New with options...** +3. Tumia chaguo-msingi – hii itachagua **Mpangilio wa kontena la maendeleo**: **Maz環ira ya Maendeleo ya AI ya Java ya Kizazi** devcontainer maalum iliyotengenezwa kwa kozi hii +4. Bonyeza **Create codespace** +5. Subiri takriban dakika 2 mpaka mazingira yako yatakapokuwa tayari +6. Endelea kwa [Hatua ya 2: Tengeneza Token ya GitHub](../../../02-SetupDevEnvironment) + +Picha ya skrini: Orodha ndogo ya Codespaces + +Picha ya skrini: New with options + +Picha ya skrini: Chaguzi za kuunda codespace + +> **Manufaa ya Codespaces**: +> - Hakuna usakinishaji wa ndani unahitajika +> - Inafanya kazi kwenye kifaa chochote chenye kivinjari +> - Imesanifiwa kabla na zana na utegemezi zote +> - Saa 60 za bure kwa mwezi kwa akaunti binafsi +> - Mazingira thabiti kwa wanafunzi wote + +#### Chaguo B: Kontena la Maendeleo la Ndani + +**Kwa waendelezaji wanaopendelea maendeleo ya ndani kwa Docker** + +1. Fanya fork na kloni hazina hii kwenye mashine yako ya ndani + > **Kumbuka**: Ikiwa unataka kuhariri usanidi msingi tafadhali angalia [Mpangilio wa Kontena ya Maendeleo](../../../.devcontainer/devcontainer.json) +2. Sakinisha [Docker Desktop](https://www.docker.com/products/docker-desktop/) na [VS Code](https://code.visualstudio.com/) +3. Sakinisha kiendelezi cha [Dev Containers](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers) katika VS Code +4. Fungua folda ya hazina katika VS Code +5. Ukipata arifa, bonyeza **Reopen in Container** (au tumia `Ctrl+Shift+P` → "Dev Containers: Reopen in Container") +6. Subiri kontena lijenge na kuanza +7. Endelea kwa [Hatua ya 2: Tengeneza Token ya GitHub](../../../02-SetupDevEnvironment) + +Picha ya skrini: Mpangilio wa kontena la maendeleo + +Picha ya skrini: Ujenzi wa kontena la maendeleo umekamilika + +#### Chaguo C: Tumia Usakinishaji Wako wa Ndani Ulio Tayari + +**Kwa waendelezaji wenye mazingira ya Java tayari** + +Mahitaji: +- [Java 21+](https://www.oracle.com/java/technologies/javase/jdk21-archive-downloads.html) +- [Maven 3.9+](https://maven.apache.org/download.cgi) +- [VS Code](https://code.visualstudio.com) au IDE unayopendelea + +Hatua: +1. Kloni hazina hii kwenye mashine yako ya ndani +2. Fungua mradi kwenye IDE yako +3. Endelea kwa [Hatua ya 2: Tengeneza Token ya GitHub](../../../02-SetupDevEnvironment) + +> **Ushauri wa Pro**: Kama una mashine yenye sifa za chini lakini unataka kutumia VS Code ndani ya ndani, tumia GitHub Codespaces! Unaweza kuunganisha VS Code yako ya ndani na Codespace iliyohifadhiwa kwenye wingu kwa ubora bora wa pande zote mbili. + +Picha ya skrini: tifauti ya mfano wa devcontainer wa ndani + +## Hatua ya 2: Tengeneza Token ya Ufikiaji wa Binafsi wa GitHub + +1. Nenda kwenye [Mipangilio ya GitHub](https://github.com/settings/profile) na chagua **Settings** kutoka kwenye menyu yako ya wasifu. +2. Kwenye upau wa kushoto, bonyeza **Developer settings** (kawaida iko chini). +3. Chini ya **Personal access tokens**, bonyeza **Fine-grained tokens** (au fuata hii kiungo moja kwa moja [link](https://github.com/settings/personal-access-tokens)). +4. Bonyeza **Generate new token**. +5. Chini ya "Token name", toa jina linaloelezea (mfano: `GenAI-Java-Course-Token`). +6. Weka tarehe ya kumalizika (inapendekezwa: siku 7 kwa mbinu bora za usalama). +7. Chini ya "Resource owner", chagua akaunti yako ya mtumiaji. +8. Chini ya "Repository access", chagua repositori unazotaka kutumia na Mifano ya GitHub (au "All repositories" ikiwa ni lazima). +9. Chini ya "Account permissions", tafuta **Models** na iweze kwa **Read-only**. +10. Bonyeza **Generate token**. +11. **Nakili na uhifadhi token yako sasa** – hautaiwona tena! + +> **Ushauri wa Usalama**: Tumia wigo mdogo unaohitajika na muda mfupi wa kumalizika kwa token zako za ufikiaji. + +## Hatua ya 3: Jaribu Mpangilio Wako kwa Mfano wa Mifano ya GitHub + +Mara mazingira yako ya maendeleo yatakapokuwa tayari, hebu jaribu ushirikiano wa Mifano ya GitHub na mfano wetu wa programu katika [`02-SetupDevEnvironment/examples/github-models`](../../../02-SetupDevEnvironment/examples/github-models). + +1. Fungua terminal katika mazingira yako ya maendeleo. +2. Nenda kwenye mfano wa Mifano ya GitHub: + ```bash + cd 02-SetupDevEnvironment/examples/github-models + ``` +3. Weka token yako ya GitHub kama mazingira ya mazingira: + ```bash + # macOS/Linux + export GITHUB_TOKEN=your_token_here + + # Windows (Kiprompti cha Amri) + set GITHUB_TOKEN=your_token_here + + # Windows (PowerShell) + $env:GITHUB_TOKEN="your_token_here" + ``` + +4. Endesha programu: + ```bash + mvn compile exec:java -Dexec.mainClass="com.example.githubmodels.App" + ``` + +Unapaswa kuona matokeo yanayofanana na: +```text +Using model: gpt-4.1-nano +Sending request to GitHub Models... +Response: Hello World! +``` + +### Kuelewa Msimbo wa Mfano + +Kwanza, tuelewe tulichofanya. Mfano chini ya `examples/github-models` unatumia OpenAI Java SDK kuungana na Mifano ya GitHub: + +**Msimbo huu unafanya:** +- **Kuungana** na Mifano ya GitHub ukitumia token yako ya ufikiaji binafsi +- **Kutuma** ujumbe rahisi "Say Hello World!" kwa mfano wa AI +- **Kupokea** na kuonyeshea majibu ya AI +- **Kuhakikisha** mpangilio wako unafanya kazi vizuri + +**Tegemezi Muhimu** (katika `pom.xml`): +```xml + + com.openai + openai-java + 2.12.0 + +``` + +**Msimbo Mkuu** (`App.java`): +```java +// Unganisha na Modeli za GitHub kwa kutumia OpenAI Java SDK +OpenAIClient client = OpenAIOkHttpClient.builder() + .apiKey(pat) + .baseUrl("https://models.inference.ai.azure.com") + .build(); + +// Unda ombi la kukamilisha mazungumzo +ChatCompletionCreateParams params = ChatCompletionCreateParams.builder() + .model(modelId) + .addSystemMessage("You are a concise assistant.") + .addUserMessage("Say Hello World!") + .build(); + +// Pata jibu la AI +ChatCompletion response = client.chat().completions().create(params); +System.out.println("Response: " + response.choices().get(0).message().content().orElse("No response content")); +``` + +## Muhtasari + +Nzuri! Sasa una kila kitu kimewekwa: + +- Umetengeneza Token ya Ufikiaji wa Binafsi wa GitHub yenye ruhusa sahihi kwa ufikiaji wa mfano wa AI +- Umeendesha mazingira yako ya maendeleo ya Java (iwe Codespaces, kontena la maendeleo, au ndani ya mashine) +- Umeungana na Mifano ya GitHub ukitumia OpenAI Java SDK kwa maendeleo ya bure ya AI +- Umejaribu kila kitu kinavyofanya kazi na mfano rahisi unaozungumza na mifano ya AI + +## Hatua Zifuatazo + +[Sura ya 3: Mbinu za Msingi za AI ya Kizazi](../03-CoreGenerativeAITechniques/README.md) + +## Kutatua Matatizo + +Una matatizo? Hapa kuna matatizo ya kawaida na suluhisho: + +- **Token haifanyi kazi?** + - Hakikisha ume nakili token yote bila nafasi za ziada + - Hakiki token ime wekwa vizuri kama mazingira ya mazingira + - Hakikisha token yako ina ruhusa sahihi (Models: Read-only) + +- **Maven haipatikani?** + - Ikiwa unatumia dev containers/Codespaces, Maven inapaswa kuwa imewekwa kabla + - Kwa mpangilio wa ndani, hakikisha Java 21+ na Maven 3.9+ vimesakinishwa + - Jaribu `mvn --version` kuthibitisha usakinishaji + +- **Masuala ya muunganisho?** + - Hakiki muunganisho wako wa intaneti + - Hakikisha GitHub inapatikana kutoka mtandao wako + - Hakikisha hauko nyuma ya firewall inayozuia mhimili wa Mifano ya GitHub + +- **Kontena la maendeleo halianzi?** + - Hakikisha Docker Desktop inaendesha (kwa maendeleo ya ndani) + - Jaribu kujenga upya kontena: `Ctrl+Shift+P` → "Dev Containers: Rebuild Container" + +- **Makosa ya uundaji wa programu?** + - Hakikisha uko kwenye saraka sahihi: `02-SetupDevEnvironment/examples/github-models` + - Jaribu safisha na uunde tena: `mvn clean compile` + +> **Unahitaji msaada?**: Bado una matatizo? Fungua issue kwenye hazina na tutakusaidia. --- + +**Hati ya Kutolewa Majukumu**: +Hati hii imetafsiriwa kwa kutumia huduma ya tafsiri ya AI [Co-op Translator](https://github.com/Azure/co-op-translator). Ingawa tunajitahidi kupata usahihi, tafadhali fahamu kwamba tafsiri za kiotomatiki zinaweza kuwa na makosa au kutoeleweka kwa usahihi. Hati ya asili katika lugha yake halali inapaswa kuchukuliwa kama chanzo cha mamlaka. Kwa taarifa muhimu, tafsiri ya mtaalamu wa kibinadamu inapendekezwa. Hatuzuiliwi kwa kutoelewana au tafsiri potofu zitokanazo na matumizi ya tafsiri hii. + \ No newline at end of file diff --git a/translations/sw/02-SetupDevEnvironment/examples/basic-chat-azure/README.md b/translations/sw/02-SetupDevEnvironment/examples/basic-chat-azure/README.md index d28f6a60..9c3471cb 100644 --- a/translations/sw/02-SetupDevEnvironment/examples/basic-chat-azure/README.md +++ b/translations/sw/02-SetupDevEnvironment/examples/basic-chat-azure/README.md @@ -1,12 +1,3 @@ - # Mazungumzo ya Msingi na Azure OpenAI - Mfano wa Mwisho kwa Mwisho Mfano huu unaonyesha jinsi ya kuunda programu rahisi ya Spring Boot inayounganisha na Azure OpenAI na kujaribu usanidi wako. diff --git a/translations/sw/02-SetupDevEnvironment/getting-started-azure-openai.md b/translations/sw/02-SetupDevEnvironment/getting-started-azure-openai.md index fd2677a9..a75caf69 100644 --- a/translations/sw/02-SetupDevEnvironment/getting-started-azure-openai.md +++ b/translations/sw/02-SetupDevEnvironment/getting-started-azure-openai.md @@ -1,12 +1,3 @@ - # Kuweka Mazingira ya Maendeleo kwa Azure OpenAI > **Mwongozo wa Haraka**: Mwongozo huu ni kwa ajili ya usanidi wa Azure OpenAI. Kwa kuanza mara moja na mifano ya bure, tumia [GitHub Models with Codespaces](./README.md#quick-start-cloud). diff --git a/translations/sw/03-CoreGenerativeAITechniques/README.md b/translations/sw/03-CoreGenerativeAITechniques/README.md index 59c92eea..4df8cb50 100644 --- a/translations/sw/03-CoreGenerativeAITechniques/README.md +++ b/translations/sw/03-CoreGenerativeAITechniques/README.md @@ -1,12 +1,3 @@ - # Mafunzo ya Mbinu za Msingi za AI Jenereta ## Jedwali la Yaliyomo diff --git a/translations/sw/04-PracticalSamples/README.md b/translations/sw/04-PracticalSamples/README.md index 20617e51..96d7dc18 100644 --- a/translations/sw/04-PracticalSamples/README.md +++ b/translations/sw/04-PracticalSamples/README.md @@ -1,12 +1,3 @@ - # Matumizi ya Kivitendo na Miradi ## Utajifunza Nini diff --git a/translations/sw/04-PracticalSamples/calculator/README.md b/translations/sw/04-PracticalSamples/calculator/README.md index 5b05c114..a498d3f7 100644 --- a/translations/sw/04-PracticalSamples/calculator/README.md +++ b/translations/sw/04-PracticalSamples/calculator/README.md @@ -1,12 +1,3 @@ - # Mafunzo ya MCP Calculator kwa Anayeanza ## Jedwali la Yaliyomo diff --git a/translations/sw/04-PracticalSamples/foundrylocal/README.md b/translations/sw/04-PracticalSamples/foundrylocal/README.md index c2fa966e..0df50240 100644 --- a/translations/sw/04-PracticalSamples/foundrylocal/README.md +++ b/translations/sw/04-PracticalSamples/foundrylocal/README.md @@ -1,12 +1,3 @@ - # Mafunzo ya Foundry Local Spring Boot ## Jedwali la Yaliyomo diff --git a/translations/sw/04-PracticalSamples/petstory/README.md b/translations/sw/04-PracticalSamples/petstory/README.md index ed408717..3b401234 100644 --- a/translations/sw/04-PracticalSamples/petstory/README.md +++ b/translations/sw/04-PracticalSamples/petstory/README.md @@ -1,12 +1,3 @@ - # Mafunzo ya Jenereta ya Hadithi za Wanyama kwa Anayeanza ## Jedwali la Maudhui diff --git a/translations/sw/05-ResponsibleGenAI/README.md b/translations/sw/05-ResponsibleGenAI/README.md index ed0f884e..3d7613b9 100644 --- a/translations/sw/05-ResponsibleGenAI/README.md +++ b/translations/sw/05-ResponsibleGenAI/README.md @@ -1,12 +1,3 @@ - # AI Jenereta Inayowajibika ## Utakachojifunza diff --git a/translations/sw/AGENTS.md b/translations/sw/AGENTS.md index 7de5260d..11b9cef3 100644 --- a/translations/sw/AGENTS.md +++ b/translations/sw/AGENTS.md @@ -1,12 +1,3 @@ - # AGENTS.md ## Muhtasari wa Mradi diff --git a/translations/sw/CODE_OF_CONDUCT.md b/translations/sw/CODE_OF_CONDUCT.md index 27b55ce4..f44cce96 100644 --- a/translations/sw/CODE_OF_CONDUCT.md +++ b/translations/sw/CODE_OF_CONDUCT.md @@ -1,12 +1,3 @@ - # Kanuni za Maadili ya Chanzo Huria ya Microsoft Mradi huu umechukua [Kanuni za Maadili ya Chanzo Huria ya Microsoft](https://opensource.microsoft.com/codeofconduct/). diff --git a/translations/sw/README.md b/translations/sw/README.md index 1a7af1ef..f4b306a4 100644 --- a/translations/sw/README.md +++ b/translations/sw/README.md @@ -1,91 +1,82 @@ - -# AI Inazalisha kwa Waanzilishi - Toleo la Java +# AI Inayozalisha kwa Waanzilishi - Toleo la Java [![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) ![Generative AI for Beginners - Java Edition](../../translated_images/sw/beg-genai-series.8b48be9951cc574c.webp) -**Muda wa Kujitolea**: Warsha yote inaweza kukamilika mtandaoni bila usanidi wa eneo lako. Usanidi wa mazingira unachukua dakika 2, na kuchunguza sampuli kunahitaji masaa 1-3 kulingana na kina cha utafiti. +**Muda wa Kutoa**: Warsha nzima inaweza kukamilishwa mtandaoni bila usanidi wa eneo mahali. Usanidi wa mazingira unachukua dakika 2, na kuchunguza mifano kunahitaji saa 1-3 kulingana na kina cha uchunguzi. > **Anza Haraka** -1. Tenga hifadhidata hii kwenye akaunti yako ya GitHub -2. Bonyeza **Code** → kichupo cha **Codespaces** → **...** → **New with options...** -3. Tumia mipangilio ya msingi – hii itachagua kontena la Maendeleo lililoundwa kwa kozi hii -4. Bonyeza **Create codespace** -5. Subiri ~dakika 2 ili mazingira yawe tayari -6. Nenda moja kwa moja kwenye [Mfano wa kwanza](./02-SetupDevEnvironment/README.md#step-2-create-a-github-personal-access-token) +1. Fikia hifadhidata hii kwenye akaunti yako ya GitHub +2. Bonyeza **Code** → kichupo cha **Codespaces** → **...** → **Mpya na chaguo...** +3. Tumia chaguo-msingi – hii itachagua Kontena la Maendeleo lililotengenezwa kwa kozi hii +4. Bonyeza **Unda codespace** +5. Subiri takriban dakika 2 kwa mazingira kuwa tayari +6. Ruka moja kwa moja kwa [Mfano wa kwanza](./02-SetupDevEnvironment/README.md#step-2-create-a-github-personal-access-token) -> **Unapendelea Kukopa Kwenye Kifaa Chako?** +> **Unapendelea Kukopa Kwenye Eneo Mahali?** > -> Hifadhidata hii ina tafsiri za lugha 50+ ambazo huongeza ukubwa wa kupakua kwa kiasi kikubwa. Ili kukopa bila tafsiri, tumia sparse checkout: +> Hifadhidata hii inajumuisha tafsiri zaidi ya 50 za lugha ambazo huongeza sana ukubwa wa kupakua. Ili kukopa bila tafsiri, tumia sparse checkout: > ```bash > git clone --filter=blob:none --sparse https://github.com/microsoft/Generative-AI-for-beginners-java.git > cd Generative-AI-for-beginners-java > git sparse-checkout set --no-cone '/*' '!translations' '!translated_images' > ``` -> Hii inakupa kila kitu unachohitaji kukamilisha kozi hii kwa upakuaji wa haraka zaidi. +> Hii inakupa kila kitu unachohitaji kukamilisha kozi na upakuaji wa haraka zaidi. ## Msaada wa Lugha Nyingi -### Inasaidiwa kupitia Kitendo cha GitHub (Otomatiki & Kila wakati ni cha Kisasa) +### Imeungwa mkono kupitia GitHub Action (Iliyot automatika na Inasasishwa daima) -[Kiarabu](../ar/README.md) | [Kibengali](../bn/README.md) | [Kibulgaria](../bg/README.md) | [Kiburma (Myanmar)](../my/README.md) | [Kichina (Rahisi)](../zh/README.md) | [Kichina (Mila, Hong Kong)](../hk/README.md) | [Kichina (Mila, Macau)](../mo/README.md) | [Kichina (Mila, Taiwan)](../tw/README.md) | [Kikroeshia](../hr/README.md) | [Kicheki](../cs/README.md) | [Kidenmaki](../da/README.md) | [Kiholanzi](../nl/README.md) | [Kiestonia](../et/README.md) | [Kifini](../fi/README.md) | [Kifaransa](../fr/README.md) | [Kijerumani](../de/README.md) | [Kigiriki](../el/README.md) | [Kiebrania](../he/README.md) | [Kihindi](../hi/README.md) | [Kihungari](../hu/README.md) | [Kiindonesia](../id/README.md) | [Kiitaliano](../it/README.md) | [Kijapani](../ja/README.md) | [Kikannada](../kn/README.md) | [Kikorea](../ko/README.md) | [Kilithuania](../lt/README.md) | [Kimalay](../ms/README.md) | [Kimalayalamu](../ml/README.md) | [Kimarathi](../mr/README.md) | [Kinepali](../ne/README.md) | [Kipidgin cha Nigeria](../pcm/README.md) | [Kinorwe](../no/README.md) | [Kifarsi (Persia)](../fa/README.md) | [Kilahisia](../pl/README.md) | [Kireno (Brazil)](../br/README.md) | [Kireno (Portugal)](../pt/README.md) | [Kipunajabi (Gurmukhi)](../pa/README.md) | [Kiromania](../ro/README.md) | [Kirusi](../ru/README.md) | [Kiserbia (Cyrillic)](../sr/README.md) | [Kislovak](../sk/README.md) | [Kislovenia](../sl/README.md) | [Kihispania](../es/README.md) | [Kiswahili](./README.md) | [Kiswidi](../sv/README.md) | [Kitagalogo (Filipino)](../tl/README.md) | [Kitamili](../ta/README.md) | [Kitelugu](../te/README.md) | [Kithai](../th/README.md) | [Kituruki](../tr/README.md) | [Kiukraini](../uk/README.md) | [Kiurdu](../ur/README.md) | [Kivietinamu](../vi/README.md) +[Kiarabu](../ar/README.md) | [Kibengali](../bn/README.md) | [Kibulgaria](../bg/README.md) | [Kiburma (Myanmar)](../my/README.md) | [Kichina (Rahisi)](../zh-CN/README.md) | [Kichina (Mila, Hong Kong)](../zh-HK/README.md) | [Kichina (Mila, Macau)](../zh-MO/README.md) | [Kichina (Mila, Taiwan)](../zh-TW/README.md) | [Kikroatia](../hr/README.md) | [Kicheki](../cs/README.md) | [Kidenmaki](../da/README.md) | [Kiholanzi](../nl/README.md) | [Kiestonia](../et/README.md) | [Kifini](../fi/README.md) | [Kifaransa](../fr/README.md) | [Kijerumani](../de/README.md) | [Kigiriki](../el/README.md) | [Kiebrania](../he/README.md) | [Kihindi](../hi/README.md) | [Kihungari](../hu/README.md) | [Kiindonesia](../id/README.md) | [Kiitaliano](../it/README.md) | [Kijapani](../ja/README.md) | [Kikannada](../kn/README.md) | [Kikorea](../ko/README.md) | [Kilithuania](../lt/README.md) | [Kimalay](../ms/README.md) | [Kimalayalam](../ml/README.md) | [Kimarathi](../mr/README.md) | [Kinepali](../ne/README.md) | [Kipidgin cha Nijeria](../pcm/README.md) | [Kinorwe](../no/README.md) | [Kiajemi (Farsi)](../fa/README.md) | [Kipolandi](../pl/README.md) | [Kireno (Brazil)](../pt-BR/README.md) | [Kireno (Ureno)](../pt-PT/README.md) | [Kipunia (Gurmukhi)](../pa/README.md) | [Kiromania](../ro/README.md) | [Kirusi](../ru/README.md) | [Kiserbia (Cyrillic)](../sr/README.md) | [Kislovakia](../sk/README.md) | [Kislovenia](../sl/README.md) | [Kihispania](../es/README.md) | [Kiswahili](./README.md) | [Kiswidi](../sv/README.md) | [Kitagalog (Kifilipino)](../tl/README.md) | [Kitamili](../ta/README.md) | [Kitelugu](../te/README.md) | [Kithai](../th/README.md) | [Kituruki](../tr/README.md) | [Kiukraini](../uk/README.md) | [Kiurdu](../ur/README.md) | [Kivietinamu](../vi/README.md) -> **Unapendelea Kukopa Kwenye Kifaa Chako?** +> **Unapendelea Kukopa Kwenye Eneo Mahali?** -> Hifadhidata hii ina tafsiri za lugha 50+ ambazo huongeza ukubwa wa kupakua kwa kiasi kikubwa. Ili kukopa bila tafsiri, tumia sparse checkout: +> Hifadhidata hii inajumuisha tafsiri zaidi ya 50 za lugha ambazo huongeza sana ukubwa wa kupakua. Ili kukopa bila tafsiri, tumia sparse checkout: > ```bash > git clone --filter=blob:none --sparse https://github.com/microsoft/Generative-AI-for-beginners-java.git > cd Generative-AI-for-beginners-java > git sparse-checkout set --no-cone '/*' '!translations' '!translated_images' > ``` -> Hii inakupa kila kitu unachohitaji kukamilisha kozi hii kwa upakuaji wa haraka zaidi. +> Hii inakupa kila kitu unachohitaji kukamilisha kozi na upakuaji wa haraka zaidi. ## Muundo wa Kozi & Njia ya Kujifunza -### **Sura ya 1: Utangulizi wa AI Inazalisha** -- **Dhana Muhimu**: Kuelewa Modeli Kubwa za Lugha, tokeni, embeddings, na uwezo wa AI -- **Mfumo wa AI wa Java**: Muhtasari wa Spring AI na SDK za OpenAI +### **Sura 1: Utangulizi wa AI Inayozalisha** +- **Mafanikio Muhimu**: Kuelewa Modeli Kubwa za Lugha, tokeni, embeddings, na uwezo wa AI +- **Ekosistimu ya AI ya Java**: Muhtasari wa Spring AI na OpenAI SDKs - **Itifaki ya Muktadha wa Modeli**: Utangulizi wa MCP na jukumu lake katika mawasiliano ya mawakala wa AI -- **Matumizi ya Kivitendo**: Mipangilio halisi ikiwa ni pamoja na chatbots na uzalishaji wa maudhui -- **[→ Anza Sura ya 1](./01-IntroToGenAI/README.md)** +- **Matumizi Halisi**: Hali halisi ikiwa ni pamoja na roboti wa mazungumzo na uzalishaji wa maudhui +- **[→ Anza Sura 1](./01-IntroToGenAI/README.md)** -### **Sura ya 2: Usanidi wa Mazingira ya Maendeleo** -- **Usanidi wa Watoaji Wengi**: Tayarisha GitHub Models, Azure OpenAI, na ushirikiano wa OpenAI Java SDK -- **Spring Boot + Spring AI**: Mbinu bora za maendeleo ya programu za AI za biashara -- **GitHub Models**: Ufikiaji wa modeli za AI bure kwa ajili ya majaribio na kujifunza (hakuna kadi ya mkopo inahitajika) +### **Sura 2: Usanidi wa Mazingira ya Maendeleo** +- **Usanidi wa Watoa Huduma Wengi**: Weka GitHub Models, Azure OpenAI, na ushirikiano wa OpenAI Java SDK +- **Spring Boot + Spring AI**: Mbinu bora za maendeleo ya programu za AI za shirika +- **GitHub Models**: Ufikiaji bure wa modeli za AI kwa majaribio na kujifunza (hakuna kadi ya mkopo inayohitajika) - **Zana za Maendeleo**: Kontena za Docker, VS Code, na usanidi wa GitHub Codespaces -- **[→ Anza Sura ya 2](./02-SetupDevEnvironment/README.md)** - -### **Sura ya 3: Mbinu Muhimu za AI Inazalisha** -- **Uhandisi wa Prompt**: Mbinu bora za majibu ya modeli za AI -- **Embeddings & Uendeshaji wa Vector**: Tekeleza utafutaji wa maana na kulinganisha kufanana -- **Uzalishaji Ulioendeshwa na Urejeshaji (RAG)**: Changanya AI na vyanzo vyako vya data -- **Kupiga Simu za Kazi**: Panua uwezo wa AI kwa zana na plugins za kawaida -- **[→ Anza Sura ya 3](./03-CoreGenerativeAITechniques/README.md)** - -### **Sura ya 4: Matumizi na Miradi ya Kivitendo** -- **Mtengenezaji wa Hadithi za Wanyama** (`petstory/`): Uzalishaji wa maudhui ya ubunifu kwa GitHub Models -- **Demo ya Foundry Local** (`foundrylocal/`): Ushirikiano wa modeli ya AI ya eneo la OpenAI Java SDK -- **Huduma ya Kalkuleta MCP** (`calculator/`): Utekelezaji wa msingi wa Itifaki ya Muktadha wa Modeli kwa Spring AI -- **[→ Anza Sura ya 4](./04-PracticalSamples/README.md)** - -### **Sura ya 5: Maendeleo ya AI kwa Uwajibikaji** -- **Usalama wa GitHub Models**: Jaribu vichujio vilivyojengwa na mifumo ya usalama (vizuizi ngumu na kukataa kwa upole) -- **Demo ya AI Inayohusika kwa Uwajibikaji**: Mfano wa vitendo unaoonesha jinsi mifumo ya kisasa ya usalama ya AI inavyofanya kazi -- **Mbinu Bora**: Miongozo muhimu kwa maendeleo na uanzishaji wa AI wa maadili -- **[→ Anza Sura ya 5](./05-ResponsibleGenAI/README.md)** +- **[→ Anza Sura 2](./02-SetupDevEnvironment/README.md)** + +### **Sura 3: Mbinu Muhimu za AI Inayozalisha** +- **Uhandisi wa Mchochezi (Prompt)**: Mbinu za majibu bora za modeli za AI +- **Embeddings & Operesheni za Vector**: Tekeleza utafutaji wa semantiki na ulinganifu wa ushujaa +- **Uzalishaji Ulioboreshwa na Upataji (RAG)**: Changanya AI na vyanzo vyako vya data +- **Kupigia Kifunctioni**: Panua uwezo wa AI kwa zana na viendelezi maalum +- **[→ Anza Sura 3](./03-CoreGenerativeAITechniques/README.md)** + +### **Sura 4: Matumizi Halisi & Miradi** +- **Mzalishaji wa Hadithi za Mbuzi** (`petstory/`): Uzalishaji wa maudhui ya ubunifu kwa kutumia GitHub Models +- **Onyesho la Kielektroniki la Foundry Local** (`foundrylocal/`): Ushirikiano wa modeli za AI za eneo mahali na OpenAI Java SDK +- **Huduma ya Kikokotoo cha MCP** (`calculator/`): Utekelezaji wa msingi wa Itifaki ya Muktadha wa Modeli kwa Spring AI +- **[→ Anza Sura 4](./04-PracticalSamples/README.md)** + +### **Sura 5: Maendeleo ya AI ya Kuwajibika** +- **Usalama wa GitHub Models**: Jaribu vuto kutoka kwa uondoaji wa maudhui uliojengwa na mifumo ya usalama (vizuizi vikali na kukataa laini) +- **Onyesho la AI ya Kuwajibika**: Mfano wa vitendo unaoonyesha jinsi mifumo ya kisasa ya usalama wa AI inavyofanya kazi +- **Mbinu Bora**: Miongozo muhimu ya maendeleo na uanzishaji wa AI yenye maadili +- **[→ Anza Sura 5](./05-ResponsibleGenAI/README.md)** ## Rasilimali Zaidi @@ -104,11 +95,11 @@ CO_OP_TRANSLATOR_METADATA: --- -### Mfululizo wa AI Inazalisha -[![AI Inazalisha kwa Waanzilishi](https://img.shields.io/badge/Generative%20AI%20for%20Beginners-8B5CF6?style=for-the-badge&labelColor=E5E7EB&color=8B5CF6)](https://github.com/microsoft/generative-ai-for-beginners?WT.mc_id=academic-105485-koreyst) -[![AI Inazalisha (.NET)](https://img.shields.io/badge/Generative%20AI%20(.NET)-9333EA?style=for-the-badge&labelColor=E5E7EB&color=9333EA)](https://github.com/microsoft/Generative-AI-for-beginners-dotnet?WT.mc_id=academic-105485-koreyst) -[![AI Inazalisha (Java)](https://img.shields.io/badge/Generative%20AI%20(Java)-C084FC?style=for-the-badge&labelColor=E5E7EB&color=C084FC)](https://github.com/microsoft/generative-ai-for-beginners-java?WT.mc_id=academic-105485-koreyst) -[![AI Inazalisha (JavaScript)](https://img.shields.io/badge/Generative%20AI%20(JavaScript)-E879F9?style=for-the-badge&labelColor=E5E7EB&color=E879F9)](https://github.com/microsoft/generative-ai-with-javascript?WT.mc_id=academic-105485-koreyst) +### Mfululizo wa AI Inayozalisha +[![AI Inayozalisha kwa Waanzilishi](https://img.shields.io/badge/Generative%20AI%20for%20Beginners-8B5CF6?style=for-the-badge&labelColor=E5E7EB&color=8B5CF6)](https://github.com/microsoft/generative-ai-for-beginners?WT.mc_id=academic-105485-koreyst) +[![AI Inayozalisha (.NET)](https://img.shields.io/badge/Generative%20AI%20(.NET)-9333EA?style=for-the-badge&labelColor=E5E7EB&color=9333EA)](https://github.com/microsoft/Generative-AI-for-beginners-dotnet?WT.mc_id=academic-105485-koreyst) +[![AI Inayozalisha (Java)](https://img.shields.io/badge/Generative%20AI%20(Java)-C084FC?style=for-the-badge&labelColor=E5E7EB&color=C084FC)](https://github.com/microsoft/generative-ai-for-beginners-java?WT.mc_id=academic-105485-koreyst) +[![AI Inayozalisha (JavaScript)](https://img.shields.io/badge/Generative%20AI%20(JavaScript)-E879F9?style=for-the-badge&labelColor=E5E7EB&color=E879F9)](https://github.com/microsoft/generative-ai-with-javascript?WT.mc_id=academic-105485-koreyst) --- @@ -117,31 +108,32 @@ CO_OP_TRANSLATOR_METADATA: [![Sayansi ya Data kwa Waanzilishi](https://img.shields.io/badge/Data%20Science%20for%20Beginners-84CC16?style=for-the-badge&labelColor=E5E7EB&color=84CC16)](https://aka.ms/datascience-beginners?WT.mc_id=academic-105485-koreyst) [![AI kwa Waanzilishi](https://img.shields.io/badge/AI%20for%20Beginners-A3E635?style=for-the-badge&labelColor=E5E7EB&color=A3E635)](https://aka.ms/ai-beginners?WT.mc_id=academic-105485-koreyst) [![Usalama wa Mtandao kwa Waanzilishi](https://img.shields.io/badge/Cybersecurity%20for%20Beginners-F97316?style=for-the-badge&labelColor=E5E7EB&color=F97316)](https://github.com/microsoft/Security-101?WT.mc_id=academic-96948-sayoung) -[![Uendelezaji wa Mtandao kwa Waanzilishi](https://img.shields.io/badge/Web%20Dev%20for%20Beginners-EC4899?style=for-the-badge&labelColor=E5E7EB&color=EC4899)](https://aka.ms/webdev-beginners?WT.mc_id=academic-105485-koreyst) -[![IoT kwa Waanzilishi](https://img.shields.io/badge/IoT%20for%20Beginners-14B8A6?style=for-the-badge&labelColor=E5E7EB&color=14B8A6)](https://aka.ms/iot-beginners?WT.mc_id=academic-105485-koreyst) -[![Maendeleo ya XR kwa Waanzilishi](https://img.shields.io/badge/XR%20Development%20for%20Beginners-38BDF8?style=for-the-badge&labelColor=E5E7EB&color=38BDF8)](https://github.com/microsoft/xr-development-for-beginners?WT.mc_id=academic-105485-koreyst) + +[![Web Dev for Beginners](https://img.shields.io/badge/Web%20Dev%20for%20Beginners-EC4899?style=for-the-badge&labelColor=E5E7EB&color=EC4899)](https://aka.ms/webdev-beginners?WT.mc_id=academic-105485-koreyst) +[![IoT for Beginners](https://img.shields.io/badge/IoT%20for%20Beginners-14B8A6?style=for-the-badge&labelColor=E5E7EB&color=14B8A6)](https://aka.ms/iot-beginners?WT.mc_id=academic-105485-koreyst) +[![XR Development for Beginners](https://img.shields.io/badge/XR%20Development%20for%20Beginners-38BDF8?style=for-the-badge&labelColor=E5E7EB&color=38BDF8)](https://github.com/microsoft/xr-development-for-beginners?WT.mc_id=academic-105485-koreyst) --- ### Mfululizo wa Copilot -[![Copilot kwa Kuprogramu Pamoja ya AI](https://img.shields.io/badge/Copilot%20for%20AI%20Paired%20Programming-FACC15?style=for-the-badge&labelColor=E5E7EB&color=FACC15)](https://aka.ms/GitHubCopilotAI?WT.mc_id=academic-105485-koreyst) -[![Copilot kwa C#/.NET](https://img.shields.io/badge/Copilot%20for%20C%23/.NET-FBBF24?style=for-the-badge&labelColor=E5E7EB&color=FBBF24)](https://github.com/microsoft/mastering-github-copilot-for-dotnet-csharp-developers?WT.mc_id=academic-105485-koreyst) +[![Copilot for AI Paired Programming](https://img.shields.io/badge/Copilot%20for%20AI%20Paired%20Programming-FACC15?style=for-the-badge&labelColor=E5E7EB&color=FACC15)](https://aka.ms/GitHubCopilotAI?WT.mc_id=academic-105485-koreyst) +[![Copilot for C#/.NET](https://img.shields.io/badge/Copilot%20for%20C%23/.NET-FBBF24?style=for-the-badge&labelColor=E5E7EB&color=FBBF24)](https://github.com/microsoft/mastering-github-copilot-for-dotnet-csharp-developers?WT.mc_id=academic-105485-koreyst) [![Copilot Adventure](https://img.shields.io/badge/Copilot%20Adventure-FDE68A?style=for-the-badge&labelColor=E5E7EB&color=FDE68A)](https://github.com/microsoft/CopilotAdventures?WT.mc_id=academic-105485-koreyst) ## Kupata Msaada -Iwapo utakumbwa na shida au una maswali yoyote kuhusu jinsi ya kujenga programu za AI. Jiunge na wajifunzaji wenzako na waendelezaji wenye uzoefu katika mijadala kuhusu MCP. Ni jamii yenye msaada ambapo maswali yanakaribishwa na maarifa hugawanywa kwa huru. +Ikiwa unakwama au una maswali yoyote kuhusu kujenga programu za AI. Jiunge na wanafunzi wenzako na waendelezaji wenye uzoefu katika mijadala kuhusu MCP. Ni jumuiya yenye msaada ambapo maswali yanakaribishwa na maarifa yanashirikiwa kwa uhuru. [![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) -Ikiwa una maoni kuhusu bidhaa au hitilafu wakati wa kujenga tembelea: +Ikiwa una maoni kuhusu bidhaa au makosa wakati wa kujenga tembelea: [![Microsoft Foundry Developer Forum](https://img.shields.io/badge/GitHub-Microsoft_Foundry_Developer_Forum-blue?style=for-the-badge&logo=github&color=000000&logoColor=fff)](https://aka.ms/foundry/forum) --- -**Kengele ya Hukumu**: -Hati hii imetafsiriwa kwa kutumia huduma ya utafsiri ya AI [Co-op Translator](https://github.com/Azure/co-op-translator). Wakati tunajitahidi kwa usahihi, tafadhali fahamu kwamba tafsiri za kiotomatiki zinaweza kuwa na makosa au kasoro. Hati asili katika lugha yake ya asili inapaswa kuchukuliwa kama chanzo halali. Kwa taarifa muhimu, tafsiri ya mtaalamu wa binadamu inashauriwa. Hatubeba uwajibikaji wowote kwa kutoelewana au tafsiri zisizo sahihi zinazotokana na matumizi ya tafsiri hii. +**Angalizo**: +Nyaraka hii imetafsiriwa kwa kutumia huduma ya utafsiri wa AI [Co-op Translator](https://github.com/Azure/co-op-translator). Ingawa tunajitahidi kuhakikisha usahihi, tafadhali fahamu kwamba tafsiri za kiotomatiki zinaweza kuwa na makosa au kasoro. Nyaraka ya asili katika lugha yake ya asili inapaswa kuchukuliwa kama chanzo halali. Kwa taarifa muhimu, tafsiri ya kitaalamu inayofanywa na binadamu inapendekezwa. Hatubebwi jukumu kwa maelewano au tafsiri zisizo sahihi zinazotokana na matumizi ya tafsiri hii. \ No newline at end of file diff --git a/translations/sw/SECURITY.md b/translations/sw/SECURITY.md index 66a4bdd6..7c7982b9 100644 --- a/translations/sw/SECURITY.md +++ b/translations/sw/SECURITY.md @@ -1,12 +1,3 @@ - ## Usalama Microsoft inachukua usalama wa bidhaa na huduma zetu za programu kwa uzito, ikijumuisha hifadhi zote za msimbo wa chanzo zinazosimamiwa kupitia mashirika yetu ya GitHub, ambayo ni pamoja na [Microsoft](https://github.com/Microsoft), [Azure](https://github.com/Azure), [DotNet](https://github.com/dotnet), [AspNet](https://github.com/aspnet) na [Xamarin](https://github.com/xamarin). diff --git a/translations/sw/SUPPORT.md b/translations/sw/SUPPORT.md index bae11c38..4fd5e2af 100644 --- a/translations/sw/SUPPORT.md +++ b/translations/sw/SUPPORT.md @@ -1,12 +1,3 @@ - # Msaada ## Jinsi ya kuripoti matatizo na kupata msaada diff --git a/translations/ta/.co-op-translator.json b/translations/ta/.co-op-translator.json new file mode 100644 index 00000000..1b066c42 --- /dev/null +++ b/translations/ta/.co-op-translator.json @@ -0,0 +1,92 @@ +{ + "01-IntroToGenAI/README.md": { + "original_hash": "75bfb080ca725e8a9aa9c80cae25fba1", + "translation_date": "2025-10-11T10:48:28+00:00", + "source_file": "01-IntroToGenAI/README.md", + "language_code": "ta" + }, + "02-SetupDevEnvironment/README.md": { + "original_hash": "96a30d42b9751a3d4e4b20e28d29d459", + "translation_date": "2026-01-28T05:32:22+00:00", + "source_file": "02-SetupDevEnvironment/README.md", + "language_code": "ta" + }, + "02-SetupDevEnvironment/examples/basic-chat-azure/README.md": { + "original_hash": "efd82efe50711d7e257eb943151d682c", + "translation_date": "2025-10-11T10:45:28+00:00", + "source_file": "02-SetupDevEnvironment/examples/basic-chat-azure/README.md", + "language_code": "ta" + }, + "02-SetupDevEnvironment/getting-started-azure-openai.md": { + "original_hash": "bfdb4b4eadbee3a59ef742439f58326a", + "translation_date": "2025-10-11T10:43:46+00:00", + "source_file": "02-SetupDevEnvironment/getting-started-azure-openai.md", + "language_code": "ta" + }, + "03-CoreGenerativeAITechniques/README.md": { + "original_hash": "685f55cb07de19b52a30ce6e8b6d889e", + "translation_date": "2025-10-11T10:46:44+00:00", + "source_file": "03-CoreGenerativeAITechniques/README.md", + "language_code": "ta" + }, + "04-PracticalSamples/README.md": { + "original_hash": "14c0a61ecc1cd2012a9c129236dfdf71", + "translation_date": "2025-10-11T10:39:36+00:00", + "source_file": "04-PracticalSamples/README.md", + "language_code": "ta" + }, + "04-PracticalSamples/calculator/README.md": { + "original_hash": "b6c16b5514d524e415a94f6097ee7d4c", + "translation_date": "2025-10-11T10:40:02+00:00", + "source_file": "04-PracticalSamples/calculator/README.md", + "language_code": "ta" + }, + "04-PracticalSamples/foundrylocal/README.md": { + "original_hash": "f787307400de59adc25a1404466a35f3", + "translation_date": "2025-11-04T07:38:44+00:00", + "source_file": "04-PracticalSamples/foundrylocal/README.md", + "language_code": "ta" + }, + "04-PracticalSamples/petstory/README.md": { + "original_hash": "0cbf68d605615a1e602c832a24616859", + "translation_date": "2025-10-11T10:42:17+00:00", + "source_file": "04-PracticalSamples/petstory/README.md", + "language_code": "ta" + }, + "05-ResponsibleGenAI/README.md": { + "original_hash": "301c05c2f57e60a6950b8c665b8bdbba", + "translation_date": "2025-10-11T10:43:02+00:00", + "source_file": "05-ResponsibleGenAI/README.md", + "language_code": "ta" + }, + "AGENTS.md": { + "original_hash": "afc90918d008cf77fd1982691f681306", + "translation_date": "2025-10-11T10:37:20+00:00", + "source_file": "AGENTS.md", + "language_code": "ta" + }, + "CODE_OF_CONDUCT.md": { + "original_hash": "442b123d034f92f7c384d2bbd28f99f1", + "translation_date": "2025-10-11T10:39:03+00:00", + "source_file": "CODE_OF_CONDUCT.md", + "language_code": "ta" + }, + "README.md": { + "original_hash": "125a08948d881c95628094f4dd1fbd43", + "translation_date": "2026-01-29T16:24:51+00:00", + "source_file": "README.md", + "language_code": "ta" + }, + "SECURITY.md": { + "original_hash": "57f14126c1c6add76b3aef3844dfe4e3", + "translation_date": "2025-10-11T10:39:14+00:00", + "source_file": "SECURITY.md", + "language_code": "ta" + }, + "SUPPORT.md": { + "original_hash": "b8ef73cc49dec68e2c885ee9df545129", + "translation_date": "2025-10-11T10:38:53+00:00", + "source_file": "SUPPORT.md", + "language_code": "ta" + } +} \ No newline at end of file diff --git a/translations/ta/01-IntroToGenAI/README.md b/translations/ta/01-IntroToGenAI/README.md index a2a48dc5..b45c1320 100644 --- a/translations/ta/01-IntroToGenAI/README.md +++ b/translations/ta/01-IntroToGenAI/README.md @@ -1,12 +1,3 @@ - # ஜெனரேட்டிவ் AI - ஜாவா பதிப்பு அறிமுகம் ## நீங்கள் கற்றுக்கொள்ளப்போகிறீர்கள் diff --git a/translations/ta/02-SetupDevEnvironment/README.md b/translations/ta/02-SetupDevEnvironment/README.md index 47eac1f7..67d26e41 100644 --- a/translations/ta/02-SetupDevEnvironment/README.md +++ b/translations/ta/02-SetupDevEnvironment/README.md @@ -1,189 +1,182 @@ - -# ஜெனரேட்டிவ் AI க்கான ஜாவா டெவலப்மென்ட் சூழலை அமைத்தல் +# Java க்கான ஜெனரேட்டிவ் AI வளர்ச்சிக்கான சூழலை அமைத்தல் -> **விரைவான தொடக்கம்**: கிளவுடில் 2 நிமிடங்களில் கோட் செய்யுங்கள் - [GitHub Codespaces அமைப்பு](../../../02-SetupDevEnvironment) பகுதியை நோக்கி செல்லுங்கள் - உள்ளூர் நிறுவல் தேவையில்லை, மேலும் GitHub மாடல்களை பயன்படுத்துகிறது! +> **விரைவான துவக்கம்**: 2 நிமிடங்களில் கிளவுட்டில் குறியீடு - [GitHub Codespaces அமைப்பு](../../../02-SetupDevEnvironment) பார்க்கவும் - உள்ளூர் நிறுவல் தேவையில்லை மற்றும் github மாதிரிகள் பயன்படுத்தப்படும்! -> **Azure OpenAI-ல் ஆர்வமா?**, புதிய Azure OpenAI வளத்தை உருவாக்குவதற்கான படிகள் கொண்ட [Azure OpenAI அமைப்பு வழிகாட்டி](getting-started-azure-openai.md) ஐ பார்க்கவும். +> **Azure OpenAI இல் ஆர்வமா?**, புதிய Azure OpenAI வளத்தை உருவாக்கும் படிகள் உள்ள [Azure OpenAI Setup Guide](getting-started-azure-openai.md) ஐ பாருங்கள். -## நீங்கள் கற்றுக்கொள்ளப்போகிறீர்கள் +## நீங்கள் அறிந்து கொள்வது -- AI பயன்பாடுகளுக்கான ஜாவா டெவலப்மென்ட் சூழலை அமைத்தல் -- உங்கள் விருப்பமான டெவலப்மென்ட் சூழலை தேர்வு செய்து அமைத்தல் (Codespaces மூலம் கிளவுட்-முதலில், உள்ளூர் டெவ் கண்டெய்னர், அல்லது முழுமையான உள்ளூர் அமைப்பு) -- GitHub மாடல்களுடன் இணைந்து உங்கள் அமைப்பை சோதித்தல் +- AI பயன்பாடுகளுக்கான Java வளர்ச்சி சூழலை அமைப்பு செய்யல் +- உங்கள் விருப்பமான வளர்ச்சி சூழலை தேர்வு செய்து கட்டமைத்தல் (Codespaces உடன் கிளவுட் முதலில், உள்ளூர் dev container, அல்லது முழு உள்ளூர் அமைப்பு) +- GitHub மாதிரிகளுடன் இணைத்து உங்கள் அமைப்பை சோதனை செய்தல் -## உள்ளடக்க அட்டவணை +## உள்ளடக்கமேடு -- [நீங்கள் கற்றுக்கொள்ளப்போகிறீர்கள்](../../../02-SetupDevEnvironment) +- [நீங்கள் அறிந்து கொள்வது](../../../02-SetupDevEnvironment) - [அறிமுகம்](../../../02-SetupDevEnvironment) -- [படி 1: உங்கள் டெவலப்மென்ட் சூழலை அமைத்தல்](../../../02-SetupDevEnvironment) - - [விருப்பம் A: GitHub Codespaces (பிரிந்துரைக்கப்படுகிறது)](../../../02-SetupDevEnvironment) - - [விருப்பம் B: உள்ளூர் டெவ் கண்டெய்னர்](../../../02-SetupDevEnvironment) - - [விருப்பம் C: உங்கள் உள்ளூர் நிறுவலை பயன்படுத்துதல்](../../../02-SetupDevEnvironment) -- [படி 2: GitHub தனிப்பட்ட அணுகல் டோக்கனை உருவாக்குதல்](../../../02-SetupDevEnvironment) -- [படி 3: உங்கள் அமைப்பை சோதித்தல்](../../../02-SetupDevEnvironment) -- [சிக்கல்களை தீர்த்தல்](../../../02-SetupDevEnvironment) +- [படி 1: உங்கள் வளர்ச்சி சூழலை அமைத்தல்](../../../02-SetupDevEnvironment) + - [விருப்பம் A: GitHub Codespaces (பரிந்துரைக்கப்பட்டது)](../../../02-SetupDevEnvironment) + - [விருப்பம் B: உள்ளூர் Dev Container](../../../02-SetupDevEnvironment) + - [விருப்பம் C: உங்கள் தற்போதைய உள்ளூர் நிறுவலை பயன்படுத்துக](../../../02-SetupDevEnvironment) +- [படி 2: GitHub Personal Access Token உருவாக்குதல்](../../../02-SetupDevEnvironment) +- [படி 3: GitHub மாதிரிகளுடன் உங்கள் அமைப்பை சோதனை செய்தல்](../../../02-SetupDevEnvironment) +- [சிக்கல் தீர்க்கல்](../../../02-SetupDevEnvironment) - [சுருக்கம்](../../../02-SetupDevEnvironment) - [அடுத்த படிகள்](../../../02-SetupDevEnvironment) ## அறிமுகம் -இந்த அத்தியாயம் உங்கள் டெவலப்மென்ட் சூழலை அமைப்பதற்கான வழிகாட்டுதலை வழங்கும். **GitHub மாடல்கள்** எளிதாக அமைக்க கூடியது, GitHub கணக்குடன் இலவசமாக பயன்படுத்தக்கூடியது, கிரெடிட் கார்டு தேவையில்லை, மேலும் பல மாடல்களை பரிசோதிக்க அனுமதிக்கிறது என்பதால், இதை முதன்மை எடுத்துக்காட்டாக பயன்படுத்துகிறோம். +இந்த அத்தியாயம் உங்கள் வளர்ச்சி சூழலை அமைக்கும் முறையில் உங்களுக்கு வழிகாட்டும். நாங்கள் **GitHub Models** ஐ முக்கிய உதாரணமாக பயன்படுத்துகிறோம் ஏனென்றால் இது இலவசமாக உள்ளது, GitHub கணக்குடன் எளிதாக அமைக்க முடியும், கிரெடிட் கார்டு தேவையில்லை மற்றும் பரிசோதனைக்கான பல மாதிரிகளுக்கு அணுகல் வழங்குகிறது. -**உள்ளூர் அமைப்பு தேவையில்லை!** GitHub Codespaces ஐ பயன்படுத்தி, உங்கள் உலாவியில் முழுமையான டெவலப்மென்ட் சூழலை உடனடியாக தொடங்கலாம். +**எந்த உள்ளூர் அமைப்பும் தேவையில்லை!** GitHub Codespaces ஐப் பயன்படுத்தி உடனடியாக துவக்கம் செய்யலாம், இது உலாவியில் முழுமையான வளர்ச்சி சூழலை வழங்குகிறது. -திரைப்படம்: GitHub மாடல்கள் +திரைபடம்: GitHub Models -இந்த பாடத்திற்காக [**GitHub மாடல்கள்**](https://github.com/marketplace?type=models) ஐ பயன்படுத்த பரிந்துரைக்கிறோம், ஏனெனில் இது: -- **இலவசம்** தொடங்க -- **எளிது** GitHub கணக்குடன் அமைக்க -- **கிரெடிட் கார்டு** தேவையில்லை -- **பல மாடல்கள்** பரிசோதிக்க கிடைக்கின்றன +இந்த பாடத்திட்டத்துக்காக [**GitHub Models**](https://github.com/marketplace?type=models) பயன்படுத்த பரிந்துரைக்கப்படுகிறது: -> **குறிப்பு**: இந்த பயிற்சியில் பயன்படுத்தப்படும் GitHub மாடல்களுக்கு இலவச வரம்புகள் உள்ளன: -> - 15 கோரிக்கைகள் ஒரு நிமிடத்திற்கு (150 ஒரு நாளைக்கு) -> - ~8,000 வார்த்தைகள் உள்ளே, ~4,000 வார்த்தைகள் வெளியே ஒரு கோரிக்கைக்கு -> - 5 ஒரே நேர கோரிக்கைகள் +- துவங்க இலவசம் +- GitHub கணக்குடன் எளிதாக அமைக்கக்கூடியது +- கிரெடிட் கார்டு தேவையில்லை +- பரிசோதனைகளுக்கு பல மாதிரிகள் கிடைக்கும் + +> **குறிப்பு**: இந்த பயிற்சியில் பயன்படுத்தப்படும் GitHub Models இல் இலவச வரம்புகள்: +> - நிமிடத்திற்கு 15 கோரிக்கை (ஒரு நாளுக்கு 150) +> - கோரிக்கைக்கு சுமார் 8,000 வார்த்தைகள் உள்ளீடு, சுமார் 4,000 வார்த்தைகள் வெளியீடு +> - 5 இணை கோரிக்கைகள் > -> உற்பத்தி பயன்பாட்டிற்காக, உங்கள் Azure கணக்குடன் Azure AI Foundry மாடல்களுக்கு மேம்படுத்தவும். உங்கள் கோடு மாற்றம் தேவையில்லை. [Azure AI Foundry ஆவணங்களை](https://learn.microsoft.com/azure/ai-foundry/foundry-models/how-to/quickstart-github-models) பார்க்கவும். +> உற்பத்தி பயன்பாட்டிற்காக உங்கள் Azure கணக்குடன் Azure AI Foundry Models க்கு மேம்படுத்தவும். உங்கள் குறியீடு மாற்றம் தேவையில்லை. [Azure AI Foundry ஆவணங்கள்](https://learn.microsoft.com/azure/ai-foundry/foundry-models/how-to/quickstart-github-models) பார்க்கவும். + -## படி 1: உங்கள் டெவலப்மென்ட் சூழலை அமைத்தல் +## படி 1: உங்கள் வளர்ச்சி சூழலை அமைத்தல் -இந்த ஜெனரேட்டிவ் AI ஜாவா பாடத்திற்கான தேவையான அனைத்து கருவிகளையும் கொண்ட ஒரு முன்கூட்டியமைக்கப்பட்ட டெவலப்மென்ட் கண்டெய்னரை உருவாக்கியுள்ளோம். உங்கள் விருப்பமான டெவலப்மென்ட் அணுகுமுறையை தேர்வு செய்யுங்கள்: +இந்த ஜெனரேட்டிவ் AI Java பாடத்திட்டத்திற்கு தேவையான கருவிகள் அனைத்தும் உட்படுத்தப்பட்ட உருவாக்கப்பட்ட முன்கட்டமைவு dev container ஒன்று உருவாக்கியிருக்கிறோம். உங்கள் விருப்ப வளர்ச்சி முறையை தேர்வு செய்யவும்: ### சூழல் அமைப்பு விருப்பங்கள்: -#### விருப்பம் A: GitHub Codespaces (பிரிந்துரைக்கப்படுகிறது) +#### விருப்பம் A: GitHub Codespaces (பரிந்துரைக்கப்பட்டது) -**2 நிமிடங்களில் கோட் செய்ய தொடங்குங்கள் - உள்ளூர் அமைப்பு தேவையில்லை!** +**2 நிமிடத்தில் குறியீடு துவங்குங்கள் - உள்ளூர் நிறுவல் தேவையில்லை!** -1. இந்த repository ஐ உங்கள் GitHub கணக்கிற்கு Fork செய்யுங்கள் - > **குறிப்பு**: அடிப்படை config ஐ திருத்த விரும்பினால், [Dev Container Configuration](../../../.devcontainer/devcontainer.json) ஐ பார்க்கவும் -2. **Code** → **Codespaces** tab → **...** → **New with options...** ஐ கிளிக் செய்யுங்கள் -3. இயல்புகளை பயன்படுத்துங்கள் – இது **Dev container configuration** ஐ தேர்வு செய்யும்: **Generative AI Java Development Environment** இந்த பாடத்திற்காக உருவாக்கப்பட்ட தனிப்பயன் devcontainer -4. **Create codespace** ஐ கிளிக் செய்யுங்கள் -5. சூழல் தயாராக ~2 நிமிடங்கள் காத்திருக்கவும் -6. [படி 2: GitHub Token உருவாக்குதல்](../../../02-SetupDevEnvironment) பகுதியை நோக்கி செல்லுங்கள் +1. இந்த கோப்பகத்தை உங்கள் GitHub கணக்குக்கு fork செய்யவும் + > **குறிப்பு**: அடிப்படையிலான கட்டமைப்பை மாற்ற விரும்பினால் [Dev Container Configuration](../../../.devcontainer/devcontainer.json) ஐ பார்வையிடவும் +2. **Code** → **Codespaces** டேப் → **...** → **New with options...** ஐ கிளிக் செய்க +3. இயல்புநிலைகளை பயன்படுத்தவும் – இது இந்த பாடத்திட்டத்திற்கு உருவாக்கப்பட்ட **Generative AI Java Development Environment** தனிப்பயன் devcontainer ஐத் தேர்வு செய்யும் +4. **Create codespace** கிளிக் செய்க +5. சூழல் தயார் ஆக ~2 நிமிடங்கள் காத்திருக்கவும் +6. [படி 2: GitHub Token உருவாக்குதல்](../../../02-SetupDevEnvironment)க்கு செல்லவும் -திரைப்படம்: Codespaces submenu +திரைபடம்: Codespaces துணை மெனு -திரைப்படம்: New with options +திரைபடம்: New with options -திரைப்படம்: Create codespace options +திரைபடம்: Create codespace விருப்பங்கள் -> **Codespaces இன் நன்மைகள்**: +> **Codespaces நன்மைகள்**: > - உள்ளூர் நிறுவல் தேவையில்லை -> - உலாவியுடன் எந்த சாதனத்திலும் வேலை செய்கிறது -> - அனைத்து கருவிகளும் சார்புகளும் முன்கூட்டியே அமைக்கப்பட்டுள்ளன -> - தனிப்பட்ட கணக்குகளுக்கு மாதத்திற்கு 60 மணி இலவசம் +> - உலாவியுள்ள எந்த சாதனத்திலும் வேலை செய்கிறது +> - அனைத்து கருவிகளும் மற்றும் சார்ந்திருப்புக்கள் முன்கட்டமைக்கப்பட்டவை +> - 개인 கணக்குகளுக்கு மாதத்திற்கு 60 மணி இலவசம் > - அனைத்து கற்றலாளர்களுக்கும் ஒரே மாதிரியான சூழல் -#### விருப்பம் B: உள்ளூர் டெவ் கண்டெய்னர் +#### விருப்பம் B: உள்ளூர் Dev Container -**Docker உடன் உள்ளூர் டெவலப்மென்ட் விரும்பும் டெவலப்பர்களுக்கு** +**Docker உடன் உள்ளூர் வளர்ச்சிக்கு விருப்பம் உள்ளவர்களுக்கு** -1. இந்த repository ஐ உங்கள் உள்ளூர் கணினிக்கு Fork செய்து Clone செய்யுங்கள் - > **குறிப்பு**: அடிப்படை config ஐ திருத்த விரும்பினால், [Dev Container Configuration](../../../.devcontainer/devcontainer.json) ஐ பார்க்கவும் -2. [Docker Desktop](https://www.docker.com/products/docker-desktop/) மற்றும் [VS Code](https://code.visualstudio.com/) ஐ நிறுவுங்கள் -3. VS Code இல் [Dev Containers extension](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers) ஐ நிறுவுங்கள் -4. Repository கோப்புறையை VS Code இல் திறக்கவும் -5. கேட்கப்பட்டால், **Reopen in Container** ஐ கிளிக் செய்யுங்கள் (அல்லது `Ctrl+Shift+P` → "Dev Containers: Reopen in Container" ஐ பயன்படுத்தவும்) -6. கண்டெய்னர் கட்டமைக்கவும் மற்றும் தொடங்கவும் காத்திருக்கவும் -7. [படி 2: GitHub Token உருவாக்குதல்](../../../02-SetupDevEnvironment) பகுதியை நோக்கி செல்லுங்கள் +1. இந்த கோப்பகத்தை உங்கள் உள்ளூர் இயந்திரத்தில் fork மற்றும் clone செய்யவும் + > **குறிப்பு**: அடிப்படையிலான கட்டமைப்பை மாற்ற விரும்பினால் [Dev Container Configuration](../../../.devcontainer/devcontainer.json) ஒன்றை பார்வையிடவும் +2. [Docker Desktop](https://www.docker.com/products/docker-desktop/) மற்றும் [VS Code](https://code.visualstudio.com/) நிறுவவும் +3. VS Code இல் [Dev Containers விரிவுரையை](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers) நிறுவவும் +4. கோப்பகத்தையும் VS Code இல் திறக்கவும் +5. கேட்கப்பட்டால், **Reopen in Container** ஐ கிளிக் செய்க (அல்லது `Ctrl+Shift+P` → "Dev Containers: Reopen in Container" பயன்படுத்தவும்) +6. container உருவாக்கப்பட்டு துவங்கும் வரை காத்திருங்கள் +7. [படி 2: GitHub Token உருவாக்குதல்](../../../02-SetupDevEnvironment)க்கு செல்லவும் -திரைப்படம்: Dev container அமைப்பு +திரைபடம்: Dev container அமைப்பு -திரைப்படம்: Dev container கட்டமைப்பு முடிந்தது +திரைபடம்: Dev container உருவாக்கம் முழுமை -#### விருப்பம் C: உங்கள் உள்ளூர் நிறுவலை பயன்படுத்துதல் +#### விருப்பம் C: உங்கள் தற்போதைய உள்ளூர் நிறுவலை பயன்படுத்துக -**ஏற்கனவே உள்ள ஜாவா சூழல்களுடன் உள்ள டெவலப்பர்களுக்கு** +**தற்போதைய Java சூழல்கள் உள்ளவர்களுக்கு** -முன்னோட்ட தேவைகள்: -- [Java 21+](https://www.oracle.com/java/technologies/javase/jdk21-archive-downloads.html) +முன் தேவைகள்: +- [Java 21+](https://www.oracle.com/java/technologies/javase/jdk21-archive-downloads.html) - [Maven 3.9+](https://maven.apache.org/download.cgi) -- [VS Code](https://code.visualstudio.com) அல்லது உங்கள் விருப்பமான IDE +- [VS Code](https://code.visualstudio.com) அல்லது உங்கள் விருப்ப IDE படிகள்: -1. இந்த repository ஐ உங்கள் உள்ளூர் கணினிக்கு Clone செய்யுங்கள் -2. IDE இல் திட்டத்தை திறக்கவும் -3. [படி 2: GitHub Token உருவாக்குதல்](../../../02-SetupDevEnvironment) பகுதியை நோக்கி செல்லுங்கள் +1. இந்த கோப்பகத்தை உள்ளூர் இயந்திரத்தில் clone செய்க +2. உங்கள் IDE இல் திட்டத்தை திறக்கவும் +3. [படி 2: GitHub Token உருவாக்குதல்](../../../02-SetupDevEnvironment)க்கு செல்லவும் -> **சிறந்த ஆலோசனை**: உங்கள் கணினி குறைந்த அளவிலான திறனுடன் இருந்தால், ஆனால் உள்ளூர் VS Code ஐ விரும்பினால், GitHub Codespaces ஐ பயன்படுத்துங்கள்! உங்கள் உள்ளூர் VS Code ஐ கிளவுட்-ஹோஸ்டட் Codespace க்கு இணைக்கலாம், இரண்டின் சிறந்த அம்சங்களையும் பெற. +> **திறமை கூர்மை**: உங்கள் இயந்திரம் குறைந்த திறமை கொண்டிருந்தாலும் VS Code உள்ளூரில் விரும்பினால் GitHub Codespaces பயன்படுத்தவும்! உங்கள் உள்ளூர் VS Code ஐ கிளவுடில் இருக்கும் Codespace உடன் இணைக்கலாம், இரு உலகங்களின் சிறந்ததையும் பெறலாம். -திரைப்படம்: உள்ளூர் devcontainer instance உருவாக்கப்பட்டது +திரைபடம்: உருவாக்கிய உள்ளூர் devcontainer நிகழ்ச்சி -## படி 2: GitHub தனிப்பட்ட அணுகல் டோக்கனை உருவாக்குதல் +## படி 2: GitHub Personal Access Token உருவாக்குதல் -1. [GitHub Settings](https://github.com/settings/profile) ஐ நோக்கி செல்லுங்கள் மற்றும் உங்கள் ப்ரொஃபைல் மெனுவில் **Settings** ஐ தேர்வு செய்யுங்கள். -2. இடது பக்க பட்டியில் **Developer settings** ஐ கிளிக் செய்யுங்கள் (சாதாரணமாக கீழே இருக்கும்). -3. **Personal access tokens** கீழ், **Fine-grained tokens** ஐ கிளிக் செய்யுங்கள் (அல்லது இந்த நேரடி [இணைப்பை](https://github.com/settings/personal-access-tokens) பின்பற்றவும்). -4. **Generate new token** ஐ கிளிக் செய்யுங்கள். -5. "Token name" கீழ், விளக்கமான பெயரை வழங்குங்கள் (எ.கா., `GenAI-Java-Course-Token`). -6. காலாவதி தேதியை அமைக்கவும் (பாதுகாப்பு சிறந்த நடைமுறைகளுக்காக: 7 நாட்கள் பரிந்துரைக்கப்படுகிறது). -7. "Resource owner" கீழ், உங்கள் பயனர் கணக்கை தேர்வு செய்யுங்கள். -8. "Repository access" கீழ், GitHub மாடல்களுடன் பயன்படுத்த வேண்டிய repositoryகளை தேர்வு செய்யுங்கள் (அல்லது "All repositories" தேவைப்பட்டால்). -9. "Account permissions" கீழ், **Models** ஐ கண்டுபிடித்து **Read-only** ஆக அமைக்கவும். -10. **Generate token** ஐ கிளிக் செய்யுங்கள். -11. **உங்கள் டோக்கனை இப்போது நகலெடுத்து சேமிக்கவும்** – அதை மீண்டும் பார்க்க முடியாது! +1. [GitHub Settings](https://github.com/settings/profile) சென்று உங்கள் சுயவிவர மெனுவில் இருந்து **Settings** தேர்ந்தெடுக்கவும். +2. இடது பக்க பட்டியில் **Developer settings** இல் கிளிக் செய்க (பொதுவாக கீழே இருக்கும்). +3. **Personal access tokens** கீழ் **Fine-grained tokens** (அல்லது இந்த நேரடி [இணைப்பு](https://github.com/settings/personal-access-tokens)) கிளிக் செய்க. +4. **Generate new token** கிளிக் செய்க. +5. "Token name" கீழ் விளக்கமான பெயர் கொடுக்கவும் (எ.கா., `GenAI-Java-Course-Token`). +6. காலாவதியாகும் தேதி அமைக்கவும் (பாதுகாப்பு சிறந்த நடைமுறைக்காக 7 நாட்கள் பரிந்துரைக்கப்படுகிறது). +7. "Resource owner" கீழ் உங்கள் பயனர் கணக்கை தேர்ந்தெடுக்கவும். +8. "Repository access" கீழ் GitHub மாதிரிகளுடன் பயன்படுத்த தேவையான கோப்பகங்களை தேர்வு செய்யவும் (அல்லது தேவையானால் "All repositories"). +9. "Account permissions" கீழ் **Models** ஐ தேர்ந்து **Read-only** ஆக அமைக்கவும். +10. **Generate token** கிளிக் செய்க. +11. **உங்கள் டோக்கனை இப்போது நகலெடுக்கவும் மற்றும் சேமிக்கவும்** – இது மீண்டும் தெரியாது! -> **பாதுகாப்பு ஆலோசனை**: உங்கள் அணுகல் டோக்கன்களுக்கு தேவையான குறைந்த அளவிலான அளவீடு மற்றும் குறைந்த காலாவதி நேரத்தை பயன்படுத்தவும். +> **பாதுகாப்பு குறிப்புரை**: உங்கள் அணுகல் டோக்கன்களுக்கு குறைந்தபட்ச தேவையான உரிமைகள் மற்றும் குறைந்த காலாவதியாகும் நேரத்தை பயன்படுத்தவும். -## படி 3: GitHub மாடல்கள் எடுத்துக்காட்டுடன் உங்கள் அமைப்பை சோதித்தல் +## படி 3: GitHub மாதிரிகளுடன் உங்கள் அமைப்பை சோதனை செய்தல் -உங்கள் டெவலப்மென்ட் சூழல் தயாராக இருந்தவுடன், [`02-SetupDevEnvironment/examples/github-models`](../../../02-SetupDevEnvironment/examples/github-models) இல் உள்ள எடுத்துக்காட்டுப் பயன்பாட்டுடன் GitHub மாடல்கள் ஒருங்கிணைப்பை சோதிக்கலாம். +உங்கள் வளர்ச்சி சூழல் தயார் ஆனதும், [`02-SetupDevEnvironment/examples/github-models`](../../../02-SetupDevEnvironment/examples/github-models) உள்ள எங்கள் உதாரண செயலியுடன் GitHub Models ஒருங்கிணைப்பை சோதனை செய்யலாம். -1. உங்கள் டெவலப்மென்ட் சூழலில் டெர்மினலை திறக்கவும். -2. GitHub மாடல்கள் எடுத்துக்காட்டை நோக்கி செல்லுங்கள்: +1. உங்கள் வளர்ச்சி சூழலில் டெர்மினலை திறக்கவும். +2. GitHub Models உதாரணத்திற்கு செல்லவும்: ```bash cd 02-SetupDevEnvironment/examples/github-models ``` -3. உங்கள் GitHub டோக்கனை சூழல் மாறியாக அமைக்கவும்: +3. உங்கள் GitHub டோக்கனை சுற்றுச்சூழல் மாறிலியாக அமைக்கவும்: ```bash - # macOS/Linux + # macOS/லினக்ஸ் export GITHUB_TOKEN=your_token_here - # Windows (Command Prompt) + # விண்டோஸ் (கமாண்டு ப்ராம்ப்ட்) set GITHUB_TOKEN=your_token_here - # Windows (PowerShell) + # விண்டோஸ் (பவர் ஷெல்) $env:GITHUB_TOKEN="your_token_here" ``` -4. பயன்பாட்டை இயக்கவும்: +4. செயலியை இயக்கவும்: ```bash mvn compile exec:java -Dexec.mainClass="com.example.githubmodels.App" ``` -நீங்கள் இதற்கு ஒத்த வெளியீட்டை காண வேண்டும்: +அடுத்து இதுபோன்ற வெளியீடு காணப்பட வேண்டும்: ```text Using model: gpt-4.1-nano Sending request to GitHub Models... Response: Hello World! ``` -### எடுத்துக்காட்டுக் கோடுகளை புரிந்துகொள்ளுதல் +### உதாரணக் குறியீட்டை புரிந்துகொள்ளுதல் -முதலில், நாம் என்ன இயக்கினோம் என்பதை புரிந்துகொள்வோம். `examples/github-models` கீழ் உள்ள எடுத்துக்காட்டில் OpenAI Java SDK ஐ பயன்படுத்தி GitHub மாடல்களுடன் இணைக்கிறது: +முதலில், இப்போது நாம் இயக்கியதை புரிந்து கொள்வோம். `examples/github-models` கீழ் உள்ள உதாரணம் OpenAI Java SDK ஐப் பயன்படுத்தி GitHub Models இற்கு இணைகிறது: -**இந்த கோடு என்ன செய்கிறது:** -- **GitHub மாடல்களுடன்** உங்கள் தனிப்பட்ட அணுகல் டோக்கனைப் பயன்படுத்தி இணைக்கிறது -- AI மாடலுக்கு "Say Hello World!" என்ற எளிய செய்தியை **அனுப்புகிறது** -- AI இன் பதிலை **பெறுகிறது** மற்றும் காட்டுகிறது -- உங்கள் அமைப்பு சரியாக செயல்படுகிறது என்பதை **சரிபார்க்கிறது** +**இந்த குறியீடு என்ன செய்கிறது:** +- உங்கள் தனிப்பட்ட அணுகல் டோக்கனைக் கொண்டு GitHub Models ஐ இணைக்கும் +- AI மாதிரிக்கு "Say Hello World!" என்ற எளிய செய்தியை அனுப்பும் +- AI பதிலை பெறும் மற்றும் காட்டும் +- உங்கள் அமைப்பு சரியாக செயல்படுகிறதா என்பதை சரிபார்க்கும் -**முக்கிய சார்பு** (`pom.xml` இல்): +**முக்கிய சார்புத் தொகுதி** (`pom.xml`ல்): ```xml com.openai @@ -192,69 +185,71 @@ Response: Hello World! ``` -**முக்கிய கோடு** (`App.java`): +**முதன்மை குறியீடு** (`App.java`): ```java -// Connect to GitHub Models using OpenAI Java SDK +// OpenAI ஜாவா SDK பயன்படுத்தி GitHub மாடல்களுக்கு இணைக்கவும் OpenAIClient client = OpenAIOkHttpClient.builder() .apiKey(pat) .baseUrl("https://models.inference.ai.azure.com") .build(); -// Create chat completion request +// கோரிக்கை உரையாடல் நிறைவு உருவாக்கவும் ChatCompletionCreateParams params = ChatCompletionCreateParams.builder() .model(modelId) .addSystemMessage("You are a concise assistant.") .addUserMessage("Say Hello World!") .build(); -// Get AI response +// AI பதிலை பெறுக ChatCompletion response = client.chat().completions().create(params); System.out.println("Response: " + response.choices().get(0).message().content().orElse("No response content")); ``` ## சுருக்கம் -அற்புதம்! நீங்கள் இப்போது அனைத்தையும் அமைத்துவிட்டீர்கள்: +நன்று! இப்போது நீங்கள் எல்லாவற்றையும் அமைத்துள்ளீர்கள்: -- AI மாடல் அணுகலுக்கான சரியான அனுமதிகளுடன் GitHub தனிப்பட்ட அணுகல் டோக்கனை உருவாக்கியுள்ளீர்கள் -- உங்கள் ஜாவா டெவலப்மென்ட் சூழலை இயக்கியுள்ளீர்கள் (Codespaces, dev containers, அல்லது உள்ளூர்) -- OpenAI Java SDK ஐ பயன்படுத்தி GitHub மாடல்களுடன் இலவச AI டெவலப்மென்ட்டை இணைத்துள்ளீர்கள் -- AI மாடல்களுடன் பேசும் எளிய எடுத்துக்காட்டுடன் அனைத்தும் செயல்படுகிறது என்பதை சோதித்துள்ளீர்கள் +- AI மாதிரி அணுகலுக்கு GitHub Personal Access Token உரிய அனுமதிகளுடன் உருவாக்கியது +- உங்கள் Java வளர்ச்சி சூழல் (Codespaces, dev containers, அல்லது உள்ளூர்) இயங்க ஆரம்பித்தது +- OpenAI Java SDK மூலம் GitHub Models உடன் இலவச AI வளர்ச்சிக்கு இணைத்தல் +- AI மாதிரிகளுடன் பேசும் எளிய உதாரணத்துடன் தானும் சரிபார்த்தல் ## அடுத்த படிகள் [அத்தியாயம் 3: முக்கிய ஜெனரேட்டிவ் AI தொழில்நுட்பங்கள்](../03-CoreGenerativeAITechniques/README.md) -## சிக்கல்களை தீர்த்தல் +## சிக்கல் தீர்க்கல் -சிக்கல்களா? இங்கே பொதுவான பிரச்சினைகள் மற்றும் தீர்வுகள் உள்ளன: +சிக்கல்கள் உள்ளதா? பொதுவான பிரச்சனைகள் மற்றும் தீர்வுகள்: -- **டோக்கன் வேலை செய்யவில்லையா?** - - முழு டோக்கனை எந்த கூடுதல் இடைவெளிகளும் இல்லாமல் நகலெடுத்தீர்களா என்பதை உறுதிப்படுத்தவும் - - டோக்கன் சரியாக சூழல் மாறியாக அமைக்கப்பட்டுள்ளதா என்பதை சரிபார்க்கவும் - - உங்கள் டோக்கனுக்கு சரியான அனுமதிகள் உள்ளதா (Models: Read and write) என்பதை சரிபார்க்கவும் +- **டோக்கன் வேலை செய்யவில்லை?** + - முழு டோக்கனும் கூடுதலாக இடைவெளி இல்லாமல் நகலெடுக்கப்பட்டுள்ளதா உறுதிப்படுத்துக + - டோக்கன் சரியாக சுற்றுச்சூழல் மாறிலியாக அமைக்கப்பட்டதா சரிபார்க்கவும் + - டோக்கனுக்கு சரியான அனுமதிகள் உள்ளதா பாருங்கள் (Models: Read-only) -- **Maven கிடைக்கவில்லையா?** - - dev containers/Codespaces ஐ பயன்படுத்தினால், Maven முன்கூட்டியே நிறுவப்பட்டிருக்கும் - - உள்ளூர் அமைப்புக்கு, Java 21+ மற்றும் Maven 3.9+ நிறுவப்பட்டுள்ளதா என்பதை உறுதிப்படுத்தவும் - - `mvn --version` ஐ முயற்சித்து நிறுவலை சரிபார்க்கவும் +- **Maven காணாமல் போயிற்றா?** + - dev containers/Codespaces பயன்படுத்தினால் Maven முன்கட்டமைக்கப்பட்டுள்ளது + - உள்ளூர் அமைப்புக்கு Java 21+ மற்றும் Maven 3.9+ இருக்கும் என்பதை உறுதிப்படுத்துக + - நிறுவல் சரிபார்க்க `mvn --version` இயக்கு -- **இணைப்பு பிரச்சினைகள்?** - - உங்கள் இணைய இணைப்பை சரிபார்க்கவும் - - GitHub உங்கள் நெட்வொர்க்கில் அணுகக்கூடியதா என்பதை உறுதிப்படுத்தவும் - - GitHub மாடல்கள் இறுதிப்புள்ளியைத் தடை செய்யும் firewall பின்னால் நீங்கள் இல்லை என்பதை உறுதிப்படுத்தவும் +- **தொடர்பு பிரச்சனை?** + - உங்கள் இணைய இணைப்பு சரியானதா என்பதை பார்க்கவும் + - GitHub உங்கள் நெட்வொர்க்கில் அணுககூடியதா சரிபார்க்கவும் + - GitHub Models கொடுத்துள்ள இடைமுகத்தின் பின்புறம் firewall தடையாக இல்லை என்பதைக் பாருங்கள் -- **Dev container தொடங்கவில்லையா?** - - Docker Desktop இயங்குகிறதா என்பதை உறுதிப்படுத்தவும் (உள்ளூர் டெவலப்மென்ட்டுக்கு) - - கண்டெய்னரை மீண்டும் கட்டமைக்க முயற்சிக்கவும்: `Ctrl+Shift+P` → "Dev Containers: Rebuild Container" +- **Dev container துவங்கவில்லை?** + - Docker Desktop இயங்கி இருக்கிறதா உறுதிப்படுத்துக (உள்ளூர் வளர்ச்சிக்காக) + - container ஐ மறுபடியும் கட்ட முயற்சி செய்க: `Ctrl+Shift+P` → "Dev Containers: Rebuild Container" -- **பயன்பாட்டு தொகுப்பு பிழைகள்?** - - நீங்கள் சரியான கோப்புறையில் உள்ளீர்களா என்பதை உறுதிப்படுத்தவும்: `02-SetupDevEnvironment/examples/github-models` - - சுத்தம் செய்து மீண்டும் கட்டமைக்க முயற்சிக்கவும்: `mvn clean compile` +- **செயலி தொகுப்பு பிழைகள்?** + - நீங்கள் சரியான அடைவில் இருக்கிறீர்களா என்பதை உறுதிப்படுத்துக: `02-SetupDevEnvironment/examples/github-models` + - தூய்மை செய்து மறுபடியும் கட்ட: `mvn clean compile` -> **உதவி தேவை?**: இன்னும் சிக்கல்களா? Repository இல் ஒரு issue ஐ திறக்கவும், நாங்கள் உங்களுக்கு உதவுவோம். +> **உதவி தேவை?**: இன்னும் சிக்கல் இருந்தால், கோப்பகத்தில் ஒரு issue உடைத் திறந்து நாங்கள் உதவுகிறோம். --- -**குறிப்பு**: -இந்த ஆவணம் [Co-op Translator](https://github.com/Azure/co-op-translator) என்ற AI மொழிபெயர்ப்பு சேவையைப் பயன்படுத்தி மொழிபெயர்க்கப்பட்டுள்ளது. நாங்கள் துல்லியத்திற்காக முயற்சிக்கின்றோம், ஆனால் தானியக்க மொழிபெயர்ப்புகளில் பிழைகள் அல்லது தவறான தகவல்கள் இருக்கக்கூடும் என்பதை தயவுசெய்து கவனத்தில் கொள்ளவும். அதன் தாய்மொழியில் உள்ள மூல ஆவணம் அதிகாரப்பூர்வ ஆதாரமாக கருதப்பட வேண்டும். முக்கியமான தகவல்களுக்கு, தொழில்முறை மனித மொழிபெயர்ப்பு பரிந்துரைக்கப்படுகிறது. இந்த மொழிபெயர்ப்பைப் பயன்படுத்துவதால் ஏற்படும் எந்த தவறான புரிதல்கள் அல்லது தவறான விளக்கங்களுக்கு நாங்கள் பொறுப்பல்ல. \ No newline at end of file + +**மறுப்பு**: +இந்த ஆவணம் AI மொழிபெயர்ப்பு சேவை [Co-op Translator](https://github.com/Azure/co-op-translator) பயன்படுத்தி மொழிபெயர்க்கப்பட்டுள்ளது. எங்களது துல்லியத்திற்கான முயற்சிகளை முன்னிட்டு, தானியங்கி மொழிபெயர்ப்புகளில் பிழைகள் அல்லது தவறுகள் இருக்கக்கூடும் என்பதை தயவுசெய்து கவனத்திற்கு எடுத்துகொள்ளவும். பூர்வ ஆவணம் அதன் இயல்புநிலையிலான மொழியில் அதிகாரப்பூர்வமான ஆதாரமாக கருதப்பட வேண்டும். முக்கிய தகவல்களுக்கு, தொழில்முறை மனித மொழிபெயர்ப்பு பரிந்துரைக்கப்படுகிறது. இந்த மொழிபெயர்ப்பின் பயன்பாட்டால் ஏற்படும் எந்தவொரு தவறான புரிதல்கள் அல்லது தவறான விளக்கங்களுக்கு நாங்கள் பொறுப்பேற்கவில்லை. + \ No newline at end of file diff --git a/translations/ta/02-SetupDevEnvironment/examples/basic-chat-azure/README.md b/translations/ta/02-SetupDevEnvironment/examples/basic-chat-azure/README.md index 7129f230..4e8a84b5 100644 --- a/translations/ta/02-SetupDevEnvironment/examples/basic-chat-azure/README.md +++ b/translations/ta/02-SetupDevEnvironment/examples/basic-chat-azure/README.md @@ -1,12 +1,3 @@ - # Azure OpenAI உடன் அடிப்படை உரையாடல் - முழுமையான எடுத்துக்காட்டு இந்த எடுத்துக்காட்டில் Azure OpenAI-க்கு இணைக்கும் ஒரு எளிய Spring Boot பயன்பாட்டை உருவாக்குவது மற்றும் உங்கள் அமைப்பை சோதிப்பது எப்படி என்பதை விளக்குகிறது. diff --git a/translations/ta/02-SetupDevEnvironment/getting-started-azure-openai.md b/translations/ta/02-SetupDevEnvironment/getting-started-azure-openai.md index 0cfb6d4c..0b1ce765 100644 --- a/translations/ta/02-SetupDevEnvironment/getting-started-azure-openai.md +++ b/translations/ta/02-SetupDevEnvironment/getting-started-azure-openai.md @@ -1,12 +1,3 @@ - # Azure OpenAI வளர்ச்சி சூழலை அமைத்தல் > **விரைவான தொடக்கம்**: இந்த வழிகாட்டி Azure OpenAI அமைப்புக்காக. இலவச மாடல்களுடன் உடனடி தொடக்கத்திற்காக [GitHub Models with Codespaces](./README.md#quick-start-cloud) பயன்படுத்தவும். diff --git a/translations/ta/03-CoreGenerativeAITechniques/README.md b/translations/ta/03-CoreGenerativeAITechniques/README.md index 1bc4cd3d..ac32ce81 100644 --- a/translations/ta/03-CoreGenerativeAITechniques/README.md +++ b/translations/ta/03-CoreGenerativeAITechniques/README.md @@ -1,12 +1,3 @@ - # கோர் ஜெனரேட்டிவ் AI தொழில்நுட்பங்கள் பயிற்சி ## உள்ளடக்க அட்டவணை diff --git a/translations/ta/04-PracticalSamples/README.md b/translations/ta/04-PracticalSamples/README.md index 0952b542..f173a41d 100644 --- a/translations/ta/04-PracticalSamples/README.md +++ b/translations/ta/04-PracticalSamples/README.md @@ -1,12 +1,3 @@ - # நடைமுறை பயன்பாடுகள் மற்றும் திட்டங்கள் ## நீங்கள் கற்றுக்கொள்ளப்போகிறீர்கள் diff --git a/translations/ta/04-PracticalSamples/calculator/README.md b/translations/ta/04-PracticalSamples/calculator/README.md index f3fd799a..d3e06b57 100644 --- a/translations/ta/04-PracticalSamples/calculator/README.md +++ b/translations/ta/04-PracticalSamples/calculator/README.md @@ -1,12 +1,3 @@ - # MCP கணக்கீடு டுடோரியல் தொடக்கநிலை பயிற்சி ## உள்ளடக்க அட்டவணை diff --git a/translations/ta/04-PracticalSamples/foundrylocal/README.md b/translations/ta/04-PracticalSamples/foundrylocal/README.md index 7258efeb..44fea733 100644 --- a/translations/ta/04-PracticalSamples/foundrylocal/README.md +++ b/translations/ta/04-PracticalSamples/foundrylocal/README.md @@ -1,12 +1,3 @@ - # Foundry Local Spring Boot பயிற்சி ## உள்ளடக்க அட்டவணை diff --git a/translations/ta/04-PracticalSamples/petstory/README.md b/translations/ta/04-PracticalSamples/petstory/README.md index 17da944b..4690a440 100644 --- a/translations/ta/04-PracticalSamples/petstory/README.md +++ b/translations/ta/04-PracticalSamples/petstory/README.md @@ -1,12 +1,3 @@ - # தொடக்கத்திற்கான செல்லப்பிராணி கதை உருவாக்கி பயிற்சி ## உள்ளடக்க அட்டவணை diff --git a/translations/ta/05-ResponsibleGenAI/README.md b/translations/ta/05-ResponsibleGenAI/README.md index a227e2a6..20c276ab 100644 --- a/translations/ta/05-ResponsibleGenAI/README.md +++ b/translations/ta/05-ResponsibleGenAI/README.md @@ -1,12 +1,3 @@ - # பொறுப்பான ஜெனரேட்டிவ் AI ## நீங்கள் என்ன கற்றுக்கொள்வீர்கள் diff --git a/translations/ta/AGENTS.md b/translations/ta/AGENTS.md index 9690f921..483550d0 100644 --- a/translations/ta/AGENTS.md +++ b/translations/ta/AGENTS.md @@ -1,12 +1,3 @@ - # AGENTS.md ## திட்டத்தின் மேற்பார்வை diff --git a/translations/ta/CODE_OF_CONDUCT.md b/translations/ta/CODE_OF_CONDUCT.md index e86c8cb0..42f09203 100644 --- a/translations/ta/CODE_OF_CONDUCT.md +++ b/translations/ta/CODE_OF_CONDUCT.md @@ -1,12 +1,3 @@ - # மைக்ரோசாஃப்ட் திறந்த மூல நடத்தை விதிமுறை இந்த திட்டம் [மைக்ரோசாஃப்ட் திறந்த மூல நடத்தை விதிமுறையை](https://opensource.microsoft.com/codeofconduct/) ஏற்றுக்கொண்டுள்ளது. diff --git a/translations/ta/README.md b/translations/ta/README.md index 10d1bfd9..ccacae76 100644 --- a/translations/ta/README.md +++ b/translations/ta/README.md @@ -1,93 +1,84 @@ - -# தொடக்கத்தினருக்கான உருவாக்கும் AI - ஜாவா பதிப்பு +# முன்மொழியப்பட்ட செயற்கை நுண்ணறிவு ஆரம்பக்காரர்களுக்கு - ஜாவா பதிப்பு [![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) ![Generative AI for Beginners - Java Edition](../../translated_images/ta/beg-genai-series.8b48be9951cc574c.webp) -**நேரம் ஒதுக்கீடு**: முழு பணியகம் அடிப்படையில் உள்ளமைக்காமல் ஆன்லைனில் முடிக்க முடியும். சுற்றுச்சூழல் அமைப்புக்கு 2 நிமிடங்கள் பிடிக்கும், மாதிரிகளை ஆராய 1-3 மணி நேரம் தேவைப்படும், ஆராய்ச்சி ஆழத்தின்படி. +**நேர அக்கறை**: அனைத்து பணிமனையும் ஆன்லைனில் உள்ளடக்கப்பட்டுள்ளது மற்றும் உள்ளூர் அமைப்பு தேவையில்லை. சுற்றளவு அமைப்பு 2 நிமிடங்கள் ஆகும், எடுத்துக்காட்டு ஆய்வுகள் 1-3 மணி நேரம், ஆய்வு ஆழச் சார்பின்படி. -> **விரைவான தொடக்கம்** +> **விரைவான தொடக்கம்** -1. இந்த நிரல்பெட்டியினை உங்கள் GitHub கணக்கிற்கு Fork செய்யவும் -2. **Code** → **Codespaces** தாவலை → **...** → **New with options...** என்பதை கிளிக் செய்யவும் -3. இயல்புகளை பயன்படுத்தவும் – இது இந்த பாடத்துக்கான Development container ஐ தேர்ந்தெடுக்கும் -4. **Create codespace** คลிக் செய்யவும் -5. சுற்றுச்சூழல் தயார் செய்ய ~2 நிமிடங்கள் காத்திருக்கவும் -6. நேரடியாக [முதற் உதாரணத்துக்கு](./02-SetupDevEnvironment/README.md#step-2-create-a-github-personal-access-token) செல்லவும் +1. இந்த சேமிப்பிடத்தை உங்கள் GitHub கணக்கிற்கு Fork செய்யவும் +2. கிளிக் செய்க **Code** → **Codespaces** தாப் → **...** → **புதிதாக விருப்பங்களில்...** +3. இயல்புகளைப் பயன்படுத்தவும் – இது இந்த பாடத்திட்டம் உருவாக்கியுள்ள வளர்ச்சி కంటెయిన్ தேர்வு செய்யும் +4. கிளிக் செய்க **Create codespace** +5. சூழல் தயாராக ~2 நிமிடங்கள் காத்திருக்கவும் +6. நேரடியாக குதிக்கவும் [முதல் எடுத்துக்காட்டு](./02-SetupDevEnvironment/README.md#step-2-create-a-github-personal-access-token) -> **உள் கணினியில் கிளோன் செய்ய விரும்புகிறீர்களா?** - -> இந்த நிரல்பெட்டி 50+ மொழிபெயர்ப்புகளை உள்ளடக்கியதால் பதிவிறக்கம் அளவு அதிகரிக்கிறது. மொழிபெயர்ப்பு இல்லாமல் கிளோன் செய்ய sparse checkout பயன்படுத்தவும்: +> **உள்நோக்கி கிளோன் செய்ய விரும்புவீர்களா?** +> +> இந்த சேமிப்பிடம் 50+ மொழி மொழிபெயர்ப்புகளை கொண்டுள்ளது, இது பதிவிறக்க அளவை குறிப்பிடத்தக்கமாக அதிகரிக்கிறது. மொழிபெயர்ப்புகள் இல்லாமல் கிளோன் செய்ய sparse checkout பயன்படுத்து: > ```bash > git clone --filter=blob:none --sparse https://github.com/microsoft/Generative-AI-for-beginners-java.git > cd Generative-AI-for-beginners-java > git sparse-checkout set --no-cone '/*' '!translations' '!translated_images' > ``` -> இது பாடம் முடிக்க வேண்டிய அனைத்தையும் வேகமான பதிவிறக்கத்துடன் வழங்குகிறது. +> இதன்மூலம் பாடத்திட்டத்தை முடிக்க தேவையான அனைத்தும் மிக வேகமாக பதிவிறக்கம் செய்ய முடியும். -## பன்மொழி ஆதரவு +## பல மொழி ஆதரவு -### GitHub செயல் மூலம் ஆதரவு (தானாகவும் எப்போதும் புதுப்பிக்கப்படும்) +### GitHub செயல்முறை மூலம் ஆதரிக்கப்பட்டது (தானாகவும் எப்போதும் புதுப்பிக்கப்படும்) -[அரபி](../ar/README.md) | [பெங்காலி](../bn/README.md) | [பல்கேரியன்](../bg/README.md) | [புர்மீஸ் (மியான்மார்)](../my/README.md) | [சீனம் (சமீபத்திய)](../zh/README.md) | [சீனம் (பாரம்பரிய, ஹாங்காங்)](../hk/README.md) | [சீனம் (பாரம்பரிய, மகாவு)](../mo/README.md) | [சீனம் (பாரம்பரிய, தைவான்)](../tw/README.md) | [குரோஷியன்](../hr/README.md) | [செக்](../cs/README.md) | [டேனிஷ்](../da/README.md) | [டச்சு](../nl/README.md) | [எச்டோனியன்](../et/README.md) | [பின்னிஷ்](../fi/README.md) | [பிரெஞ்சு](../fr/README.md) | [ஜெர்மன்](../de/README.md) | [கிரேக்கு](../el/README.md) | [ஹீப்ரூ](../he/README.md) | [இந்தி](../hi/README.md) | [ஹங்கேரியன்](../hu/README.md) | [இந்தோனேஷியன்](../id/README.md) | [இத்தாலியன்](../it/README.md) | [ஜாப்பனீஸ்](../ja/README.md) | [கன்னடம்](../kn/README.md) | [கொரியன்](../ko/README.md) | [லித்துவேனியன்](../lt/README.md) | [மலாய்](../ms/README.md) | [மலையாளம்](../ml/README.md) | [மராத்தி](../mr/README.md) | [நெபாளி](../ne/README.md) | [நைஜீரியன் பிட்ஜின்](../pcm/README.md) | [நார்வேஜியன்](../no/README.md) | [பெர்சியன் (பார்சி)](../fa/README.md) | [போலிஷ்](../pl/README.md) | [போர்ச்சுகீசு (பிரேசில்)](../br/README.md) | [போர்ச்சுகீசு (போர்ச்சுகல்)](../pt/README.md) | [பஞ்சாபி (குருமுகி)](../pa/README.md) | [ரோமாகியன்](../ro/README.md) | [ரஷ்யன்](../ru/README.md) | [செர்பியன் (சிரிலிக்)](../sr/README.md) | [ஸ்லோவாக்](../sk/README.md) | [ஸ்லோவேனியன்](../sl/README.md) | [ஸ்பானிஷ்](../es/README.md) | [ஸ்வாஹிலி](../sw/README.md) | [ஸ்வீடியன்](../sv/README.md) | [தாகாலோக் (பிலிப்பைனோ)](../tl/README.md) | [தமிழ்](./README.md) | [தெலுங்கு](../te/README.md) | [தை](../th/README.md) | [துருக்கிஷ்](../tr/README.md) | [உக்ரைனியன்](../uk/README.md) | [உருது](../ur/README.md) | [வியட்நாம்](../vi/README.md) +[அரபு](../ar/README.md) | [பெங்காலி](../bn/README.md) | [பல்கேரியன்](../bg/README.md) | [பர்மீஸ் (மியன்மார்)](../my/README.md) | [சீனா (சாதாரண)](../zh-CN/README.md) | [சீனா (பாரம்பரிய, ஹாங்காங்)](../zh-HK/README.md) | [சீனா (பாரம்பரிய, மாகாவ்)](../zh-MO/README.md) | [சீனா (பாரம்பரிய, தைவான்)](../zh-TW/README.md) | [கிரோஷியன்](../hr/README.md) | [செக்](../cs/README.md) | [டேனிஷ்](../da/README.md) | [டச்சு](../nl/README.md) | [எஸ்டோனியன்](../et/README.md) | [பின்னிஷ்](../fi/README.md) | [பிரஞ்சு](../fr/README.md) | [ஜெர்மன்](../de/README.md) | [கிரேக்கம்](../el/README.md) | [ஹீப்ரூ](../he/README.md) | [இந்தி](../hi/README.md) | [ஹங்கேரியன்](../hu/README.md) | [இந்தோனேஷியன்](../id/README.md) | [இத்தாலியன்](../it/README.md) | [ஜப்பானியன்](../ja/README.md) | [கன்னடம்](../kn/README.md) | [கொரியன்](../ko/README.md) | [லிதுவேனியன்](../lt/README.md) | [மலாய்](../ms/README.md) | [மலையாளம்](../ml/README.md) | [மராத்தி](../mr/README.md) | [நெபாளி](../ne/README.md) | [நைஜீரியன் பிட்ஜின்](../pcm/README.md) | [நோர்வேஜியன்](../no/README.md) | [பெர்ஷியன் (ஃபார்ஸி)](../fa/README.md) | [போலிஷ்](../pl/README.md) | [போர்ச்சுகீஸ் (பிரேசில்)](../pt-BR/README.md) | [போர்ச்சுகீஸ் (போர்ச்சுகல்)](../pt-PT/README.md) | [பஞ்சாபி (குர்முகி)](../pa/README.md) | [ரோமேனியன்](../ro/README.md) | [ரஷ்யன்](../ru/README.md) | [செர்பியன் (சிரிலிக்)](../sr/README.md) | [ஸ்லோவாக்](../sk/README.md) | [ஸ்லோவேனியன்](../sl/README.md) | [ஸ்பானிஷ்](../es/README.md) | [ஸ்வாஹிலி](../sw/README.md) | [ஸ்வீடிஷ்](../sv/README.md) | [தகாலோக் (பிலிப்பைன்ஸ்)](../tl/README.md) | [தமிழ்](./README.md) | [தேளுகு](../te/README.md) | [தாய்](../th/README.md) | [துருக்கி](../tr/README.md) | [உக்ரைனியன்](../uk/README.md) | [உருது](../ur/README.md) | [வியட்நாமீஸ்](../vi/README.md) -> **உள் கணினியில் கிளோன் செய்ய விரும்புகிறீர்களா?** +> **உள்நோக்கி கிளோன் செய்ய விரும்புவீர்களா?** -> இந்த நிரல்பெட்டி 50+ மொழிபெயர்ப்புகளை உள்ளடக்கியதால் பதிவிறக்கம் அளவு அதிகரிக்கிறது. மொழிபெயர்ப்பு இல்லாமல் கிளோன் செய்ய sparse checkout பயன்படுத்தவும்: +> இந்த சேமிப்பிடம் 50+ மொழி மொழிபெயர்ப்புகளை கொண்டுள்ளது, இது பதிவிறக்க அளவை குறிப்பிடத்தக்கமாக அதிகரிக்கிறது. மொழிபெயர்ப்புகள் இல்லாமல் கிளோன் செய்ய sparse checkout பயன்படுத்து: > ```bash > git clone --filter=blob:none --sparse https://github.com/microsoft/Generative-AI-for-beginners-java.git > cd Generative-AI-for-beginners-java > git sparse-checkout set --no-cone '/*' '!translations' '!translated_images' > ``` -> இது பாடம் முடிக்க வேண்டிய எதையும் வேகமான பதிவிறக்கத்துடன் வழங்குகிறது. +> இதன்மூலம் பாடத்திட்டத்தை முடிக்க தேவையான அனைத்தும் மிக வேகமாக பதிவிறக்கம் செய்ய முடியும். -## பாடத் தொகுப்பு மற்றும் கற்றல் பாதை +## பாடத்திட்ட அமைப்பு மற்றும் கற்றல் பாதை -### **அத்தியாயம் 1: உருவாக்கும் AI அறிமுகம்** -- **மென்பொருள் கருத்துக்கள்**: பெரிய மொழி மாதிரிகள், tokens, embeddings மற்றும் AI திறன்களை புரிந்துகொள்வது -- **ஜாவா AI சூழல்**: Spring AI மற்றும் OpenAI SDK களின் அதிருப்தி -- **மாதிரி உள்ளடக்க நெறிமுறை**: MCP அறிமுகம் மற்றும் AI முகவர் தொடர்பில் அதன் பங்கு -- **பயன்பாட்டு செயலிகள்**: உரையாடலர்கள் மற்றும் உள்ளடக்க உருவாக்கம் உட்பட நடைமுறை சம்பவங்கள் +### **அத்தியாயம் 1: உருவாக்கும் செயற்கை நுண்ணறிவுக்கான அறிமுகம்** +- **முதன்மை கருத்துக்கள்**: பெரிய குறிப்புபடங்கள், டோக்கன்கள், எம்பெட்டிங்குகள் மற்றும் செயற்கை நுண்ணறிவு திறன்கள் புரிதல் +- **ஜாவா AI சூழல்**: Spring AI மற்றும் OpenAI SDK-களின் நிலையான கண்ணோட்டம் +- **மாதிரி சூழல் ஒட்டுமொத்தக் கொள்கை**: MCP அறிமுகமும் AI முகவரிகள் தொடர்பின் பங்கு +- **பயன்முறை பயன்பாடுகள்**: சந்தைபோட்டிகள் மற்றும் உள்ளடக்க உருவாக்கம் உட்பட உண்மையான உலக நிகழ்வுகள் - **[→ அத்தியாயம் 1 தொடங்கு](./01-IntroToGenAI/README.md)** ### **அத்தியாயம் 2: வளர்ச்சி சூழல் அமைப்பு** -- **பன்முக வழங்குனர் கட்டமைப்பு**: GitHub மாதிரிகள், Azure OpenAI மற்றும் OpenAI Java SDK ஒருங்கிணைப்புகள் அமைத்தல் -- **Spring Boot + Spring AI**: நிறுவன AI பயன்பாட்டு மேம்பாட்டுக்கான சிறந்த நடைமுறைகள் -- **GitHub மாதிரிகள்**: மாதிரிப்பெறல் மற்றும் கற்றலுக்கான இலவச AI மாதிரி அணுகல் (கடன் அட்டை தேவையில்லை) -- ** மேம்பாட்டு கருவிகள்**: டாக்கர் கொண்டாளிகள், VS Code மற்றும் GitHub Codespaces கட்டமைப்பு +- **பல வழங்குநர் ஒருங்கிணைப்பு**: GitHub மாதிரிகள், Azure OpenAI மற்றும் OpenAI ஜாவா SDK இணைப்பு அமைக்க +- **Spring Boot + Spring AI**: நிறுவன AI பயன்பாட்டு உருவாக்கதிற்கான சிறந்த நடைமுறைகள் +- **GitHub மாதிரிகள்**: மாதிரிப்பதிவு மற்றும் கற்றலுக்கான இலவச AI மாதிரி அணுகல் (கடன் அட்டை தேவையில்லை) +- **வளர்ச்சி கருவிகள்**: Docker கன்டெய்னர்கள், VS Code மற்றும் GitHub Codespaces அமைப்புகள் - **[→ அத்தியாயம் 2 தொடங்கு](./02-SetupDevEnvironment/README.md)** ### **அத்தியாயம் 3: முக்கிய உருவாக்கும் AI தொழில்நுட்பங்கள்** -- **உதவி விவசாயம்**: சிறந்த AI மாதிரி பதில்களை பெறுவதற்கான தொழில்நுட்பங்கள் -- **Embeddings & வெக்டர் செயலிகள்**: அர்த்தமுள்ள தேடல் மற்றும் ஒத்திசைவு பொருந்துகையை நடைமுறைப்படுத்தல் -- **Retrieval-Augmented Generation (RAG)**: AI யை உங்கள் சொந்த தரவு மூலங்களுடன் இணைத்தல் -- **செயல்பாட்டு அழைப்பு**: தனிப்பயன் கருவிகள் மற்றும் கூடுதல்கள் மூலம் AI திறன்களை விரிவாக்குதல் +- **பிராம்ட் பொறியியல்**: சிறந்த AI மாதிரி பதில்கள் பெறும் தொழில்நுட்பங்கள் +- **எம்பெட்டிங்குகள் மற்றும் வெக்டர் செயல்பாடுகள்**: அர்த்தமுள்ள தேடல் மற்றும் ஒத்திசைவை நடைமுறைப்படுத்துதல் +- **பின்வாங்கல் ஆதரவு உருவாக்கம் (RAG)**: உங்கள் சொந்த தரவு மூலங்கள் உடன் AI இணைத்தல் +- **செயல்பாடு அழைப்பு**: தனிப்பயன் கருவிகள் மற்றும் இணைப்பிகளுடன் AI திறன்களை விரிவாக்குதல் - **[→ அத்தியாயம் 3 தொடங்கு](./03-CoreGenerativeAITechniques/README.md)** -### **அத்தியாயம் 4: நடைமுறை பயன்பாடுகள் மற்றும் திட்டங்கள்** -- **விலங்கு கதை உருவாக்கி** (`petstory/`): GitHub மாதிரிகளோடு படைப்பாற்றல் உள்ளடக்கம் உருவாக்கல் -- **Foundry உள்ளூர் டெமோ** (`foundrylocal/`): OpenAI ஜாவா SDK உடன் உள்ளூர் AI மாதிரி ஒருங்கிணைப்பு -- **MCP கணக்கிடுபவர் சேவை** (`calculator/`): Spring AI உடன் அடிப்படை மாதிரி உள்ளடக்க நெறிமுறை செயலாக்கம் +### **அத்தியாயம் 4: பயன்முறை பயன்பாடுகள் மற்றும் திட்டங்கள்** +- **Pet Story Generator** (`petstory/`): GitHub மாதிரிகளுடன் சிருஷ்டிப்புலமான உள்ளடக்க உருவாக்குதல் +- **Foundry Local Demo** (`foundrylocal/`): OpenAI ஜாவா SDK உடன் உள்ளூர் AI மாதிரி ஒருங்கிணைப்பு +- **MCP கணக்கீட்டாளர் சேவை** (`calculator/`): Spring AI உடன் அடிப்படையிலான மாதிரி சூழல் ஒட்டுமொத்தக் கொள்கை நடைமுறைப்படுத்தல் - **[→ அத்தியாயம் 4 தொடங்கு](./04-PracticalSamples/README.md)** -### **அத்தியாயம் 5: பொறுப்பான AI மேம்பாடு** -- **GitHub மாதிரி பாதுகாப்பு**: உள்ளடக்க வடிகட்டல் மற்றும் பாதுகாப்பு செயல்முறைகளை (கடின தடைகள் மற்றும் மெல்லிய மறுத்துக் கொள்கைகள்) சோதனை செய்வது -- **பொறுப்பான AI டெமோ**: நவீன AI பாதுகாப்பு அமைப்புகளின் செயற்பாடுகளை கையில் கற்றல் -- **சிறந்த நடைமுறைகள்**: ஒழுக்கமான AI மேம்பாடு மற்றும் நிறுவல் வழிகாட்டுதல்கள் +### **அத்தியாயம் 5: பொறுப்பூா்வ AI உருவாக்கல்** +- **GitHub மாதிரிகள் பாதுகாப்பு**: உள்ளீடு வடிகட்டி மற்றும் பாதுகாப்பு நெறிமுறைகள் (கடுமையான தடைகள் மற்றும் மென்மையான மறுப்பு) சோதனை செய்ய +- **பொறுப்பூா்வ AI டெமோ**: நவீன AI பாதுகாப்புக் கண்காணிப்பு அமைப்புகளின் செயல்பாடுகளை நேரடி உதாரணமாக காட்டுதல் +- **சிறந்த நடைமுறைகள்**: நீதி மற்றும் பொறுப்புடன் AI உருவாக்கல் மற்றும் வெளியீட்டு வழிகாட்டு குறிப்புகள் - **[→ அத்தியாயம் 5 தொடங்கு](./05-ResponsibleGenAI/README.md)** -## கூடுதலான வளங்கள் +## கூடுதல் வளங்கள் ### LangChain @@ -103,7 +94,7 @@ CO_OP_TRANSLATOR_METADATA: [![AI Agents for Beginners](https://img.shields.io/badge/AI%20Agents%20for%20Beginners-00C49A?style=for-the-badge&labelColor=E5E7EB&color=00C49A)](https://github.com/microsoft/ai-agents-for-beginners?WT.mc_id=academic-105485-koreyst) --- - + ### உருவாக்கும் AI தொடர் [![Generative AI for Beginners](https://img.shields.io/badge/Generative%20AI%20for%20Beginners-8B5CF6?style=for-the-badge&labelColor=E5E7EB&color=8B5CF6)](https://github.com/microsoft/generative-ai-for-beginners?WT.mc_id=academic-105485-koreyst) [![Generative AI (.NET)](https://img.shields.io/badge/Generative%20AI%20(.NET)-9333EA?style=for-the-badge&labelColor=E5E7EB&color=9333EA)](https://github.com/microsoft/Generative-AI-for-beginners-dotnet?WT.mc_id=academic-105485-koreyst) @@ -111,37 +102,38 @@ CO_OP_TRANSLATOR_METADATA: [![Generative AI (JavaScript)](https://img.shields.io/badge/Generative%20AI%20(JavaScript)-E879F9?style=for-the-badge&labelColor=E5E7EB&color=E879F9)](https://github.com/microsoft/generative-ai-with-javascript?WT.mc_id=academic-105485-koreyst) --- - -### முதன்மை கற்றல் + +### மூலக் கற்றல் [![ML for Beginners](https://img.shields.io/badge/ML%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=22C55E)](https://aka.ms/ml-beginners?WT.mc_id=academic-105485-koreyst) [![Data Science for Beginners](https://img.shields.io/badge/Data%20Science%20for%20Beginners-84CC16?style=for-the-badge&labelColor=E5E7EB&color=84CC16)](https://aka.ms/datascience-beginners?WT.mc_id=academic-105485-koreyst) [![AI for Beginners](https://img.shields.io/badge/AI%20for%20Beginners-A3E635?style=for-the-badge&labelColor=E5E7EB&color=A3E635)](https://aka.ms/ai-beginners?WT.mc_id=academic-105485-koreyst) [![Cybersecurity for Beginners](https://img.shields.io/badge/Cybersecurity%20for%20Beginners-F97316?style=for-the-badge&labelColor=E5E7EB&color=F97316)](https://github.com/microsoft/Security-101?WT.mc_id=academic-96948-sayoung) + [![Web Dev for Beginners](https://img.shields.io/badge/Web%20Dev%20for%20Beginners-EC4899?style=for-the-badge&labelColor=E5E7EB&color=EC4899)](https://aka.ms/webdev-beginners?WT.mc_id=academic-105485-koreyst) -[![ஆரம்பிக்கும் IoT](https://img.shields.io/badge/IoT%20for%20Beginners-14B8A6?style=for-the-badge&labelColor=E5E7EB&color=14B8A6)](https://aka.ms/iot-beginners?WT.mc_id=academic-105485-koreyst) -[![ஆரம்பிக்கும் XR Development](https://img.shields.io/badge/XR%20Development%20for%20Beginners-38BDF8?style=for-the-badge&labelColor=E5E7EB&color=38BDF8)](https://github.com/microsoft/xr-development-for-beginners?WT.mc_id=academic-105485-koreyst) +[![IoT for Beginners](https://img.shields.io/badge/IoT%20for%20Beginners-14B8A6?style=for-the-badge&labelColor=E5E7EB&color=14B8A6)](https://aka.ms/iot-beginners?WT.mc_id=academic-105485-koreyst) +[![XR Development for Beginners](https://img.shields.io/badge/XR%20Development%20for%20Beginners-38BDF8?style=for-the-badge&labelColor=E5E7EB&color=38BDF8)](https://github.com/microsoft/xr-development-for-beginners?WT.mc_id=academic-105485-koreyst) --- -### Copilot தொடர் -[![AI ஜோடி திட்டமிடலுக்கான Copilot](https://img.shields.io/badge/Copilot%20for%20AI%20Paired%20Programming-FACC15?style=for-the-badge&labelColor=E5E7EB&color=FACC15)](https://aka.ms/GitHubCopilotAI?WT.mc_id=academic-105485-koreyst) -[![C#/.NET-க்கான Copilot](https://img.shields.io/badge/Copilot%20for%20C%23/.NET-FBBF24?style=for-the-badge&labelColor=E5E7EB&color=FBBF24)](https://github.com/microsoft/mastering-github-copilot-for-dotnet-csharp-developers?WT.mc_id=academic-105485-koreyst) -[![Copilot சாகசம்](https://img.shields.io/badge/Copilot%20Adventure-FDE68A?style=for-the-badge&labelColor=E5E7EB&color=FDE68A)](https://github.com/microsoft/CopilotAdventures?WT.mc_id=academic-105485-koreyst) +### கோபைலட் தொடர்ச்சி +[![Copilot for AI Paired Programming](https://img.shields.io/badge/Copilot%20for%20AI%20Paired%20Programming-FACC15?style=for-the-badge&labelColor=E5E7EB&color=FACC15)](https://aka.ms/GitHubCopilotAI?WT.mc_id=academic-105485-koreyst) +[![Copilot for C#/.NET](https://img.shields.io/badge/Copilot%20for%20C%23/.NET-FBBF24?style=for-the-badge&labelColor=E5E7EB&color=FBBF24)](https://github.com/microsoft/mastering-github-copilot-for-dotnet-csharp-developers?WT.mc_id=academic-105485-koreyst) +[![Copilot Adventure](https://img.shields.io/badge/Copilot%20Adventure-FDE68A?style=for-the-badge&labelColor=E5E7EB&color=FDE68A)](https://github.com/microsoft/CopilotAdventures?WT.mc_id=academic-105485-koreyst) -## உதவியைப் பெறுதல் +## உதவி பெறுதல் -AI பயன்பாடுகளை உருவாக்க ஆயத்தமடையாதீர்கள் அல்லது உங்களுக்குத் தெரியாத ஏதேனும் கேள்விகள் இருந்தால். MCP-ஐப் பற்றிய விவாதங்களில் மற்ற பயில்கையாளர்களும் அனுபவமான டெவலப்பர்களும் சேருங்கள். இது ஒரு ஆதரவான சமூகமாகும், இங்கு கேள்விகள் வரவேற்கப்படுகின்றன மற்றும் அறிவு சுதந்திரமாக பகிரப்படுகின்றது. +நீங்கள் சிக்கிக்கொண்டிருந்தால் அல்லது AI செயலிகள் உருவாக்குவதற்கான எந்தவொரு கேள்வியும் இருந்தால். MCP பற்றி கூடுதல் பயிலாளர்கள் மற்றும் அனுபவமுள்ள முன்னேற்றுபவர்களுடன் விவாதங்களில் இணைந்து கொள்ளுங்கள். இது கேள்விகள் கேட்கப்பட்டு அறிவு சுதந்திரமாக பகிரப்படும் ஒரு ஆதரவான சமூகமாகும். [![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) -தயாரிப்பு கருத்துகள் அல்லது பிழைகள் இருந்தால் கட்டியெழுதல் போது பார்வையிடவும்: +உங்கள் கருத்துக்கள் அல்லது பிழைகள் இருந்தால் கட்டுமானத்தின் போது பார்வையிடவும்: [![Microsoft Foundry Developer Forum](https://img.shields.io/badge/GitHub-Microsoft_Foundry_Developer_Forum-blue?style=for-the-badge&logo=github&color=000000&logoColor=fff)](https://aka.ms/foundry/forum) --- -**கருத்து மறுப்பு**: -இந்த ஆவணம் AI மொழி மாற்ற சேவை [Co-op Translator](https://github.com/Azure/co-op-translator) பயன்படுத்தி மொழிபெயர்க்கப்பட்டுள்ளது. நாங்கள் துல்லியத்திற்காக முயற்சித்தும் இருந்தாலும், தானியங்கி மொழி மாற்றங்களில் பிழைகள் அல்லது தவறுகள் இருக்கக்கூடும் என்பதை நினைவில் கொள்ளவும். அசல் ஆவணம் அதன் தாய்மொழியில் அதிகாரப்பூர்வமாக கருதப்பட வேண்டும். முக்கியமான தகவலுக்காக, தொழில்முறை மனித மொழிபெயர்ப்பை பரிந்துரைக்கிறோம். இந்த மொழி மாற்றத்தைப் பயன்படுத்தியதன் காரணமாக ஏற்படும் எந்தவொரு தவறான புரிதலுக்கு அல்லது தவறான விளக்கத்திற்கு நாங்கள் பொறுப்பாக இருக்கமாட்டோம். +**ஜரிமாணம்**: +இந்தக் கூற்றுப்பत्रம் AI மொழிபெயர்ப்பு சேவை [Co-op Translator](https://github.com/Azure/co-op-translator) மூலம் மொழி மாற்றப்பட்டுள்ளது. நாங்கள் துல்லியத்தை உறுதிப்படுத்த முயலினாலும், தானாக செய்யப்பட்ட மொழிபெயர்ப்புகளில் பிழைகள் அல்லது தவறான தகவல்கள் இருக்கக்கூடும் என்பதைக் கருத்தில் கொள்ளுங்கள். அசல் ஆவணம் அதன் சொந்த மொழியில் ஆக்கப்பூர்வமான ஆதாரமாகக் கருதப்பட வேண்டும். முக்கியமான தகவல்களுக்கு, மனுஷ்யன் தொழில்முறை மொழிபெயர்ப்பு பரிந்துரைக்கப்படுகிறது. இம்மொழிபெயர்ப்பினால் ஏற்படும் எந்த தவறான புரிதல்கள் அல்லது தவறான விளக்கங்களுக்கு நாங்கள் பொறுப்பார் அல்ல. \ No newline at end of file diff --git a/translations/ta/SECURITY.md b/translations/ta/SECURITY.md index 351e4e1c..39d07afc 100644 --- a/translations/ta/SECURITY.md +++ b/translations/ta/SECURITY.md @@ -1,12 +1,3 @@ - ## பாதுகாப்பு Microsoft தனது மென்பொருள் தயாரிப்புகள் மற்றும் சேவைகளின் பாதுகாப்பை மிகுந்த கவனத்துடன் கையாள்கிறது, இதில் [Microsoft](https://github.com/Microsoft), [Azure](https://github.com/Azure), [DotNet](https://github.com/dotnet), [AspNet](https://github.com/aspnet) மற்றும் [Xamarin](https://github.com/xamarin) ஆகியவற்றின் GitHub அமைப்புகள் மூலம் நிர்வகிக்கப்படும் அனைத்து மூலக் குறியீட்டு களஞ்சியங்களும் அடங்கும். diff --git a/translations/ta/SUPPORT.md b/translations/ta/SUPPORT.md index 1b686b84..420a6298 100644 --- a/translations/ta/SUPPORT.md +++ b/translations/ta/SUPPORT.md @@ -1,12 +1,3 @@ - # ஆதரவு ## பிரச்சினைகளை பதிவு செய்வது மற்றும் உதவி பெறுவது எப்படி diff --git a/translations/te/.co-op-translator.json b/translations/te/.co-op-translator.json new file mode 100644 index 00000000..75480701 --- /dev/null +++ b/translations/te/.co-op-translator.json @@ -0,0 +1,92 @@ +{ + "01-IntroToGenAI/README.md": { + "original_hash": "75bfb080ca725e8a9aa9c80cae25fba1", + "translation_date": "2025-12-01T09:44:59+00:00", + "source_file": "01-IntroToGenAI/README.md", + "language_code": "te" + }, + "02-SetupDevEnvironment/README.md": { + "original_hash": "96a30d42b9751a3d4e4b20e28d29d459", + "translation_date": "2026-01-28T05:37:21+00:00", + "source_file": "02-SetupDevEnvironment/README.md", + "language_code": "te" + }, + "02-SetupDevEnvironment/examples/basic-chat-azure/README.md": { + "original_hash": "efd82efe50711d7e257eb943151d682c", + "translation_date": "2025-12-01T09:36:50+00:00", + "source_file": "02-SetupDevEnvironment/examples/basic-chat-azure/README.md", + "language_code": "te" + }, + "02-SetupDevEnvironment/getting-started-azure-openai.md": { + "original_hash": "bfdb4b4eadbee3a59ef742439f58326a", + "translation_date": "2025-12-01T09:32:40+00:00", + "source_file": "02-SetupDevEnvironment/getting-started-azure-openai.md", + "language_code": "te" + }, + "03-CoreGenerativeAITechniques/README.md": { + "original_hash": "685f55cb07de19b52a30ce6e8b6d889e", + "translation_date": "2025-12-01T09:40:32+00:00", + "source_file": "03-CoreGenerativeAITechniques/README.md", + "language_code": "te" + }, + "04-PracticalSamples/README.md": { + "original_hash": "14c0a61ecc1cd2012a9c129236dfdf71", + "translation_date": "2025-12-01T09:15:11+00:00", + "source_file": "04-PracticalSamples/README.md", + "language_code": "te" + }, + "04-PracticalSamples/calculator/README.md": { + "original_hash": "b6c16b5514d524e415a94f6097ee7d4c", + "translation_date": "2025-12-01T09:17:11+00:00", + "source_file": "04-PracticalSamples/calculator/README.md", + "language_code": "te" + }, + "04-PracticalSamples/foundrylocal/README.md": { + "original_hash": "f787307400de59adc25a1404466a35f3", + "translation_date": "2025-12-01T09:21:08+00:00", + "source_file": "04-PracticalSamples/foundrylocal/README.md", + "language_code": "te" + }, + "04-PracticalSamples/petstory/README.md": { + "original_hash": "0cbf68d605615a1e602c832a24616859", + "translation_date": "2025-12-01T09:25:23+00:00", + "source_file": "04-PracticalSamples/petstory/README.md", + "language_code": "te" + }, + "05-ResponsibleGenAI/README.md": { + "original_hash": "301c05c2f57e60a6950b8c665b8bdbba", + "translation_date": "2025-12-01T09:29:25+00:00", + "source_file": "05-ResponsibleGenAI/README.md", + "language_code": "te" + }, + "AGENTS.md": { + "original_hash": "afc90918d008cf77fd1982691f681306", + "translation_date": "2025-12-01T09:04:29+00:00", + "source_file": "AGENTS.md", + "language_code": "te" + }, + "CODE_OF_CONDUCT.md": { + "original_hash": "442b123d034f92f7c384d2bbd28f99f1", + "translation_date": "2025-12-01T09:13:17+00:00", + "source_file": "CODE_OF_CONDUCT.md", + "language_code": "te" + }, + "README.md": { + "original_hash": "125a08948d881c95628094f4dd1fbd43", + "translation_date": "2026-01-29T16:29:33+00:00", + "source_file": "README.md", + "language_code": "te" + }, + "SECURITY.md": { + "original_hash": "57f14126c1c6add76b3aef3844dfe4e3", + "translation_date": "2025-12-01T09:13:47+00:00", + "source_file": "SECURITY.md", + "language_code": "te" + }, + "SUPPORT.md": { + "original_hash": "b8ef73cc49dec68e2c885ee9df545129", + "translation_date": "2025-12-01T09:12:51+00:00", + "source_file": "SUPPORT.md", + "language_code": "te" + } +} \ No newline at end of file diff --git a/translations/te/01-IntroToGenAI/README.md b/translations/te/01-IntroToGenAI/README.md index 2667242e..ff326b0a 100644 --- a/translations/te/01-IntroToGenAI/README.md +++ b/translations/te/01-IntroToGenAI/README.md @@ -1,12 +1,3 @@ - # జనరేటివ్ AI పరిచయం - జావా ఎడిషన్ ## మీరు నేర్చుకునేది diff --git a/translations/te/02-SetupDevEnvironment/README.md b/translations/te/02-SetupDevEnvironment/README.md index 7e5bd8b7..514059a9 100644 --- a/translations/te/02-SetupDevEnvironment/README.md +++ b/translations/te/02-SetupDevEnvironment/README.md @@ -1,155 +1,147 @@ - -# జెనరేటివ్ AI కోసం Java డెవలప్‌మెంట్ ఎన్విరాన్‌మెంట్ సెటప్ చేయడం +# Java కోసం జనరేటివ్ AI అభివృద్ధి పరిసరాన్ని ఏర్పాటు -> **త్వరిత ప్రారంభం**: క్లౌడ్‌లో 2 నిమిషాల్లో కోడ్ చేయండి - [GitHub Codespaces సెటప్](../../../02-SetupDevEnvironment)కి వెళ్లండి - స్థానిక ఇన్‌స్టాలేషన్ అవసరం లేదు మరియు GitHub మోడల్స్ ఉపయోగిస్తుంది! +> **తక్షణ ప్రారంభం**: 2 నిమిషాల్లో క్లౌడ్‌లో కోడ్ చేయండి - [GitHub Codespaces సెటప్](../../../02-SetupDevEnvironment) కు వెళ్ళండి - స్థానిక ఇన్‌స్టాలేషన్ అవసరం లేదు మరియు github మోడల్స్ ఉపయోగిస్తుంది! -> **Azure OpenAI గురించి ఆసక్తి ఉందా?**, కొత్త Azure OpenAI రిసోర్స్ సృష్టించడానికి దశలతో మా [Azure OpenAI సెటప్ గైడ్](getting-started-azure-openai.md) చూడండి. +> **Azure OpenAI ఆసక్తి ఉన్నవారా?**, మా [Azure OpenAI సెటప్ గైడ్](getting-started-azure-openai.md) చూడండి, కొత్త Azure OpenAI వనరును సృష్టించే దశలతో. -## మీరు నేర్చుకునేది +## మీరు ఏమి నేర్చుకుంటారు -- AI అప్లికేషన్ల కోసం Java డెవలప్‌మెంట్ ఎన్విరాన్‌మెంట్ సెటప్ చేయడం -- మీకు ఇష్టమైన డెవలప్‌మెంట్ ఎన్విరాన్‌మెంట్ (క్లౌడ్-ఫస్ట్ Codespacesతో, స్థానిక డెవ్ కంటైనర్, లేదా పూర్తి స్థానిక సెటప్) ఎంచుకోవడం మరియు కాన్ఫిగర్ చేయడం -- GitHub మోడల్స్‌కు కనెక్ట్ చేయడం ద్వారా మీ సెటప్‌ను పరీక్షించండి +- AI అనువర్తనాల కోసం Java అభివృద్ధి పరిసరాన్ని ఎలా ఏర్పాటు చేయాలో +- మీ ఇష్టమైన అభివృద్ధి పరిసరాన్ని ఎంచుకోవడం మరియు కాన్ఫిగర్ చేయడం (Codespaces తో క్లౌడ్-ఫస్ట్, స్థానిక డెవ్ కంటైనర్, లేదా పూర్తి స్థానిక సెటప్) +- GitHub మోడల్స్‌ను కనెక్ట్ చేసి మీ సెటప్‌ని పరీక్షించడం -## విషయ సూచిక +## కంటెంట్ పట్టిక -- [మీరు నేర్చుకునేది](../../../02-SetupDevEnvironment) +- [మీరు ఏమి నేర్చుకుంటారు](../../../02-SetupDevEnvironment) - [పరిచయం](../../../02-SetupDevEnvironment) -- [దశ 1: మీ డెవలప్‌మెంట్ ఎన్విరాన్‌మెంట్ సెటప్ చేయండి](../../../02-SetupDevEnvironment) - - [ఆప్షన్ A: GitHub Codespaces (సిఫార్సు చేయబడింది)](../../../02-SetupDevEnvironment) - - [ఆప్షన్ B: స్థానిక డెవ్ కంటైనర్](../../../02-SetupDevEnvironment) - - [ఆప్షన్ C: మీ ప్రస్తుత స్థానిక ఇన్‌స్టాలేషన్ ఉపయోగించండి](../../../02-SetupDevEnvironment) -- [దశ 2: GitHub వ్యక్తిగత యాక్సెస్ టోకెన్ సృష్టించండి](../../../02-SetupDevEnvironment) -- [దశ 3: మీ సెటప్‌ను పరీక్షించండి](../../../02-SetupDevEnvironment) -- [ట్రబుల్‌షూటింగ్](../../../02-SetupDevEnvironment) +- [దశ 1: మీ అభివృద్ధి పరిసరాన్ని సెటప్ చేయండి](../../../02-SetupDevEnvironment) + - [ఎంపిక A: GitHub Codespaces (సిఫార్సు)](../../../02-SetupDevEnvironment) + - [ఎంపిక B: స్థానిక డెవ్ కంటైనర్](../../../02-SetupDevEnvironment) + - [ఎంపిక C: మీ ఇప్పటికే ఉన్న స్థానిక ఇన్‌స్టాలేషన్ ఉపయోగించండి](../../../02-SetupDevEnvironment) +- [దశ 2: GitHub పర్సనల్ యాక్సెస్ టోకెన్ సృష్టించండి](../../../02-SetupDevEnvironment) +- [దశ 3: GitHub మోడల్స్ ఉదాహరణతో మీ సెటప్‌ని పరీక్షించండి](../../../02-SetupDevEnvironment) +- [సమస్యల పరిష్కారం](../../../02-SetupDevEnvironment) - [సారాంశం](../../../02-SetupDevEnvironment) -- [తదుపరి దశలు](../../../02-SetupDevEnvironment) +- [తరువాతి దశలు](../../../02-SetupDevEnvironment) ## పరిచయం -ఈ అధ్యాయం మీకు డెవలప్‌మెంట్ ఎన్విరాన్‌మెంట్ సెటప్ చేయడంలో సహాయపడుతుంది. **GitHub మోడల్స్**ను మా ప్రధాన ఉదాహరణగా ఉపయోగిస్తాము ఎందుకంటే ఇది ఉచితం, GitHub ఖాతాతో సులభంగా సెటప్ చేయవచ్చు, క్రెడిట్ కార్డ్ అవసరం లేదు, మరియు అన్వేషణ కోసం అనేక మోడల్స్ అందిస్తుంది. +ఈ అధ్యాయం మీకు అభివృద్ది పరిసరాన్ని ఎలా ఏర్పాటు చేయాలో మార్గదర్శనం చేస్తుంది. మేము **GitHub Models** ను మా ప్రధాన ఉదాహరణగా ఉపయోగిస్తాము ఎందుకంటే ఇది ఉచితం, కేవలం GitHub ఖాతాతో సులభంగా సెటప్ చేయవచ్చు, క్రెడిట్ కార్డ్ అవసరం లేదు, మరియు అనేక మోడల్స్‌ను ప్రయోగం కోసం అందిస్తుంది. -**స్థానిక సెటప్ అవసరం లేదు!** మీరు GitHub Codespaces ఉపయోగించి వెంటనే కోడింగ్ ప్రారంభించవచ్చు, ఇది మీ బ్రౌజర్‌లో పూర్తి డెవలప్‌మెంట్ ఎన్విరాన్‌మెంట్ అందిస్తుంది. +**స్థానిక సెటప్ అవసరం లేదు!** GitHub Codespaces ను ఉపయోగించి బ్రౌజర్‌లోనే పూర్తి అభివృద్ధి పరిసరంతో వెంటనే కోడింగ్ ప్రారంభించవచ్చు. -స్క్రీన్‌షాట్: GitHub మోడల్స్ +స్క్రీన్‌షాట్: GitHub Models -ఈ కోర్సు కోసం [**GitHub మోడల్స్**](https://github.com/marketplace?type=models)ను ఉపయోగించమని మేము సిఫార్సు చేస్తున్నాము ఎందుకంటే: +మేము ఈ కోర్సు కోసం [**GitHub Models**](https://github.com/marketplace?type=models) ఉపయోగించవలసిందిగా సిఫార్సు చేస్తున్నాము ఎందుకంటే: - **ఉచితం** ప్రారంభించడానికి -- **సులభం** GitHub ఖాతాతో సెటప్ చేయడం +- **సులభం** కేవలం GitHub ఖాతాతో సెటప్ చేయడం - **క్రెడిట్ కార్డ్ అవసరం లేదు** -- **అన్వేషణ కోసం అనేక మోడల్స్** +- **చలాయింపుకు అనేక మోడల్స్** అందుబాటులో ఉంటాయి -> **గమనిక**: ఈ శిక్షణలో ఉపయోగించిన GitHub మోడల్స్ ఈ ఉచిత పరిమితులను కలిగి ఉంటాయి: -> - నిమిషానికి 15 అభ్యర్థనలు (రోజుకు 150) -> - ~8,000 పదాలు ఇన్‌పుట్, ~4,000 పదాలు అవుట్‌పుట్ ప్రతి అభ్యర్థనకు -> - 5 సమకాలీన అభ్యర్థనలు +> **గమనించండి**: ఈ శిక్షణలో ఉపయోగించిన GitHub Models కు ఈ ఉచిత పరిమితులు ఉన్నాయి: +> - 1 నిమిషానికి 15 అభ్యర్థనలు (ప్రతి రోజు 150) +> - ఒక్కో అభ్యర్థనకు సుమారు 8,000 పదాలు ఇన్‌పుట్, సుమారు 4,000 పదాలు అవుట్పుట్ +> - 5 సమాంతర అభ్యర్థనలు > -> ఉత్పత్తి ఉపయోగం కోసం, మీ Azure ఖాతాతో Azure AI Foundry మోడల్స్‌కు అప్‌గ్రేడ్ చేయండి. మీ కోడ్ మార్చాల్సిన అవసరం లేదు. [Azure AI Foundry డాక్యుమెంటేషన్](https://learn.microsoft.com/azure/ai-foundry/foundry-models/how-to/quickstart-github-models) చూడండి. +> ఉత్పత్తి వాడుక కోసం, మీ Azure ఖాతాతో Azure AI Foundry Models కి అప్‌గ్రేడ్ చేయండి. మీ కోడ్ మారాల్సిన అవసరం లేదు. [Azure AI Foundry డాక్యుమెంటేషన్](https://learn.microsoft.com/azure/ai-foundry/foundry-models/how-to/quickstart-github-models) చూడండి. -## దశ 1: మీ డెవలప్‌మెంట్ ఎన్విరాన్‌మెంట్ సెటప్ చేయండి + +## దశ 1: మీ అభివృద్ధి పరిసరాన్ని సెటప్ చేయండి -ఈ Generative AI for Java కోర్సు కోసం అవసరమైన అన్ని టూల్స్‌ను కలిగి ఉండే ప్రీకాన్ఫిగర్డ్ డెవలప్‌మెంట్ కంటైనర్‌ను మేము సృష్టించాము. మీకు ఇష్టమైన డెవలప్‌మెంట్ విధానాన్ని ఎంచుకోండి: +మేము ఈ Generative AI for Java కోర్సుకు అవసరమైన అన్ని టూల్స్‌తో ముందుగానే సెటప్ చేసిన అభివృద్ధి కంటైనర్ సృష్టించాము, తద్వారా సెటప్ సమయాన్ని తగ్గించుకోవచ్చు. మీరు మీ ఇష్టమైన అభివృద్ధి విధానాన్ని ఎంచుకోండి: -### ఎన్విరాన్‌మెంట్ సెటప్ ఆప్షన్లు: +### పరిసర సెటప్ ఎంపికలు: -#### ఆప్షన్ A: GitHub Codespaces (సిఫార్సు చేయబడింది) +#### ఎంపిక A: GitHub Codespaces (సిఫార్సు) **2 నిమిషాల్లో కోడింగ్ ప్రారంభించండి - స్థానిక సెటప్ అవసరం లేదు!** -1. ఈ రిపోజిటరీని మీ GitHub ఖాతాకు ఫోర్క్ చేయండి - > **గమనిక**: మీరు ప్రాథమిక కాన్ఫిగరేషన్‌ను సవరించాలనుకుంటే [Dev Container Configuration](../../../.devcontainer/devcontainer.json) చూడండి -2. **Code** → **Codespaces** ట్యాబ్ → **...** → **New with options...** క్లిక్ చేయండి -3. డిఫాల్ట్స్ ఉపయోగించండి – ఇది **Generative AI Java Development Environment** కస్టమ్ డెవ్ కంటైనర్‌ను ఎంచుకుంటుంది +1. ఈ రిపోజిటరీని మీ GitHub ఖాతాకి Fork చేయండి + > **గమనిక**: ప్రాథమిక కాన్ఫిగరేషన్ మార్చాలనుకుంటే దయచేసి [Dev Container Configuration](../../../.devcontainer/devcontainer.json) చూడండి +2. **Code** → **Codespaces** టాబ్ → **...** → **New with options...** క్లిక్ చేయండి +3. డిఫాల్ట్ ఎంపికలు ఉపయోగించండి – ఇది ఈ కోర్సు కోసం సృష్టించిన **Generative AI Java Development Environment** కస్టమ్ డెవ్ కంటైనర్ కాన్ఫిగరేషన్‌ను ఎంచుకుంటుంది 4. **Create codespace** క్లిక్ చేయండి -5. ఎన్విరాన్‌మెంట్ సిద్ధం కావడానికి ~2 నిమిషాలు వేచి ఉండండి -6. [దశ 2: GitHub టోకెన్ సృష్టించండి](../../../02-SetupDevEnvironment)కి కొనసాగండి +5. పరిసరాన్ని సిద్ధం అయ్యేవరకు సుమారు 2 నిమిషాలు వేచి ఉండండి +6. [దశ 2: GitHub టోకెన్ సృష్టించండి](../../../02-SetupDevEnvironment) కు వెళ్లండి -స్క్రీన్‌షాట్: Codespaces ఉపమెను +స్క్రీన్‌షాట్: Codespaces సబ్‌మెనూ స్క్రీన్‌షాట్: New with options -స్క్రీన్‌షాట్: Create codespace options +స్క్రీన్‌షాట్: Codespace ఎంపికలు సృష్టించు -> **Codespaces ప్రయోజనాలు**: +> **Codespaces లాభాలు**: > - స్థానిక ఇన్‌స్టాలేషన్ అవసరం లేదు -> - బ్రౌజర్ ఉన్న ఏ డివైస్‌లోనైనా పనిచేస్తుంది -> - అన్ని టూల్స్ మరియు డిపెండెన్సీలతో ప్రీ-కాన్ఫిగర్డ్ +> - బ్రౌజర్ ఉన్న ఏ డివైస్‌తోనైనా పని చేస్తుంది +> - అన్ని టూల్స్ మరియు డిపెండెన్సీలతో ముందుగానే సెట్ చేయబడింది > - వ్యక్తిగత ఖాతాల కోసం నెలకు 60 గంటలు ఉచితం -> - అన్ని నేర్చుకునే వారికి స్థిరమైన ఎన్విరాన్‌మెంట్ +> - అన్ని అభ్యసనకర్తలకు సమాన పరిసరాలు -#### ఆప్షన్ B: స్థానిక డెవ్ కంటైనర్ +#### ఎంపిక B: స్థానిక డెవ్ కంటైనర్ -**Dockerతో స్థానిక డెవలప్‌మెంట్ ఇష్టపడే డెవలపర్ల కోసం** +**డాకర్‌తో స్థానిక అభివృద్ధిని ఇష్టపడే డెవలపర్ల కోసం** -1. ఈ రిపోజిటరీని మీ స్థానిక యంత్రానికి ఫోర్క్ చేసి క్లోన్ చేయండి - > **గమనిక**: మీరు ప్రాథమిక కాన్ఫిగరేషన్‌ను సవరించాలనుకుంటే [Dev Container Configuration](../../../.devcontainer/devcontainer.json) చూడండి +1. ఈ రిపోజిటరీని ఫోర్క్ చేసి స్థానిక మెషీన్‌లో క్లోన్ చేయండి + > **గమనిక**: ప్రాథమిక కాన్ఫిగరేషన్ మార్చాలనుకుంటే దయచేసి [Dev Container Configuration](../../../.devcontainer/devcontainer.json) చూడండి 2. [Docker Desktop](https://www.docker.com/products/docker-desktop/) మరియు [VS Code](https://code.visualstudio.com/) ఇన్‌స్టాల్ చేయండి -3. VS Codeలో [Dev Containers extension](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers) ఇన్‌స్టాల్ చేయండి -4. రిపోజిటరీ ఫోల్డర్‌ను VS Codeలో ఓపెన్ చేయండి -5. ప్రాంప్ట్ వచ్చినప్పుడు, **Reopen in Container** క్లిక్ చేయండి (లేదా `Ctrl+Shift+P` → "Dev Containers: Reopen in Container" ఉపయోగించండి) -6. కంటైనర్ నిర్మించడానికి మరియు ప్రారంభించడానికి వేచి ఉండండి -7. [దశ 2: GitHub టోకెన్ సృష్టించండి](../../../02-SetupDevEnvironment)కి కొనసాగండి +3. VS Codeలో [Dev Containers ఎక్స్‌టెన్షన్](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers) ఇన్‌స్టాల్ చేయండి +4. రిపోజిటరీ ఫోల్డర్‌ను VS Codeలో తెరవండి +5. ప్రాంప్ట్ వచ్చినప్పుడు **Reopen in Container** క్లిక్ చేయండి (లేదా `Ctrl+Shift+P` → "Dev Containers: Reopen in Container" ఉపయోగించండి) +6. కంటైనర్ నిర్మాణం మరియు స్టార్ట్ అయ్యేవరకు వేచి ఉండండి +7. [దశ 2: GitHub టోకెన్ సృష్టించండి](../../../02-SetupDevEnvironment) కు వెళ్లండి -స్క్రీన్‌షాట్: Dev container సెటప్ +స్క్రీన్‌షాట్: డెవ్ కంటైనర్ సెటప్ -స్క్రీన్‌షాట్: Dev container నిర్మాణం పూర్తయింది +స్క్రీన్‌షాట్: డెవ్ కంటైనర్ నిర్మాణం పూర్తయింది -#### ఆప్షన్ C: మీ ప్రస్తుత స్థానిక ఇన్‌స్టాలేషన్ ఉపయోగించండి +#### ఎంపిక C: మీ ఇప్పటికే ఉన్న స్థానిక ఇన్‌స్టాలేషన్ ఉపయోగించండి -**ఇప్పటికే ఉన్న Java ఎన్విరాన్‌మెంట్ ఉన్న డెవలపర్ల కోసం** +**పూర్వపు Java అభివృద్ధి పరిసరాలతో ఉన్న డెవలపర్ల కోసం** -అవసరమైనవి: +అవసరాలు: - [Java 21+](https://www.oracle.com/java/technologies/javase/jdk21-archive-downloads.html) - [Maven 3.9+](https://maven.apache.org/download.cgi) -- [VS Code](https://code.visualstudio.com) లేదా మీకు ఇష్టమైన IDE +- [VS Code](https://code.visualstudio.com) లేదా మీ ఇష్టమైన IDE దశలు: -1. ఈ రిపోజిటరీని మీ స్థానిక యంత్రానికి క్లోన్ చేయండి -2. ప్రాజెక్ట్‌ను మీ IDEలో ఓపెన్ చేయండి -3. [దశ 2: GitHub టోకెన్ సృష్టించండి](../../../02-SetupDevEnvironment)కి కొనసాగండి +1. ఈ రిపోజిటరీని మీ స్థానిక మెషీన్‌కు క్లోన్ చేయండి +2. ప్రాజెక్ట్‌ను మీ IDE లో తెరవండి +3. [దశ 2: GitHub టోకెన్ సృష్టించండి](../../../02-SetupDevEnvironment) కు వెళ్లండి -> **ప్రో టిప్**: మీకు తక్కువ స్పెక్స్ ఉన్న యంత్రం ఉంటే కానీ స్థానికంగా VS Code కావాలనుకుంటే, GitHub Codespaces ఉపయోగించండి! మీరు మీ స్థానిక VS Codeను క్లౌడ్-హోస్టెడ్ Codespaceకి కనెక్ట్ చేయవచ్చు. +> **ప్రో టిప్**: మీ దగ్గర తక్కువ స్పెక్స్ మెషీన్ అయితే కానీ స్థానికంగా VS Code ఉపయోగించాలనుకుంటే GitHub Codespaces వాడండి! మీ స్థానిక VS Code ను క్లౌడ్‌లో హోస్ట్ చేసిన Codespace కి కనెక్ట్ చేసుకోవచ్చు. -స్క్రీన్‌షాట్: స్థానిక డెవ్ కంటైనర్ ఉదాహరణ సృష్టించబడింది +స్క్రీన్‌షాట్: సృష్టించిన స్థానిక డెవ్‌కంటైనర్ ఇన్‌స్టెన్స్ -## దశ 2: GitHub వ్యక్తిగత యాక్సెస్ టోకెన్ సృష్టించండి +## దశ 2: GitHub పర్సనల్ యాక్సెస్ టోకెన్ సృష్టించండి -1. [GitHub సెట్టింగ్స్](https://github.com/settings/profile)కి వెళ్లి మీ ప్రొఫైల్ మెను నుండి **Settings** ఎంచుకోండి. -2. ఎడమ సైడ్‌బార్‌లో, **Developer settings** క్లిక్ చేయండి (సాధారణంగా దిగువన ఉంటుంది). -3. **Personal access tokens** కింద, **Fine-grained tokens** క్లిక్ చేయండి (లేదా ఈ [లింక్](https://github.com/settings/personal-access-tokens)ను అనుసరించండి). +1. [GitHub సెట్టింగ్స్](https://github.com/settings/profile) కు వెళ్ళి, మీ ప్రొఫైల్ మెనువులోని **Settings** ఎంచుకోండి. +2. ఎడమ సైడ్‌బార్‌లో, **Developer settings** (సాధారణంగా కింద భాగంలో) క్లిక్ చేయండి. +3. **Personal access tokens** లో, **Fine-grained tokens** క్లిక్ చేయండి (లేదా ఈ నేరుగా [లింక్](https://github.com/settings/personal-access-tokens) అనుసరించండి). 4. **Generate new token** క్లిక్ చేయండి. -5. "Token name" కింద, వివరణాత్మక పేరు ఇవ్వండి (ఉదా., `GenAI-Java-Course-Token`). -6. గడువు తేదీని సెట్ చేయండి (భద్రతా ఉత్తమ పద్ధతుల కోసం: 7 రోజులు సిఫార్సు చేయబడింది). -7. "Resource owner" కింద, మీ యూజర్ ఖాతాను ఎంచుకోండి. -8. "Repository access" కింద, GitHub మోడల్స్‌తో ఉపయోగించాలనుకుంటున్న రిపోజిటరీలను ఎంచుకోండి (లేదా అవసరమైతే "All repositories"). -9. "Account permissions" కింద, **Models**ను కనుగొని **Read-only**గా సెట్ చేయండి. +5. "Token name" కింద వివరణాత్మక పేరు పెట్టండి (ఉదా: `GenAI-Java-Course-Token`). +6. గడువు తేదీని సెట్ చేయండి (భద్రతా ఉత్తమ ఆచరణల కోసం 7 రోజులు సిఫార్సు). +7. "Resource owner" కింద మీ యూజర్ ఖాతాను ఎంచుకోండి. +8. "Repository access" కింద GitHub Models ఉపయోగించాలనుకునే రిపోజిటరీలను ఎంచుకోండి (లేదా అవసరమైతే "All repositories"). +9. "Account permissions" లో **Models** చర్యను **Read-only** గా సెట్ చేయండి. 10. **Generate token** క్లిక్ చేయండి. -11. **మీ టోకెన్‌ను ఇప్పుడు కాపీ చేసి సేవ్ చేయండి** – మీరు దీన్ని మళ్లీ చూడలేరు! +11. **మీ టోకెన్ ను ఇప్పటి తానే కాపీ చేసి భద్రపరచండి** – తిరిగి చూడలేరు! -> **భద్రతా సూచన**: మీ యాక్సెస్ టోకెన్ల కోసం అవసరమైన కనీస స్కోప్ మరియు అత్యల్ప గడువు సమయాన్ని ఉపయోగించండి. +> **భద్రతా సూచన**: మీ యాక్సెస్ టోకెన్‌ల కొరకు కనీసం అవసరమైన స్కోప్ మరియు మితమైన గడువు సమయం ఉపయోగించండి. -## దశ 3: GitHub మోడల్స్ ఉదాహరణతో మీ సెటప్‌ను పరీక్షించండి +## దశ 3: GitHub మోడల్స్ ఉదాహరణతో మీ సెటప్‌ని పరీక్షించండి -మీ డెవలప్‌మెంట్ ఎన్విరాన్‌మెంట్ సిద్ధంగా ఉన్న తర్వాత, [`02-SetupDevEnvironment/examples/github-models`](../../../02-SetupDevEnvironment/examples/github-models)లో మా ఉదాహరణ అప్లికేషన్‌తో GitHub మోడల్స్ ఇంటిగ్రేషన్‌ను పరీక్షిద్దాం. +మీ అభివృద్ధి పరిసరమే సిద్ధమైన తర్వాత, మనము [`02-SetupDevEnvironment/examples/github-models`](../../../02-SetupDevEnvironment/examples/github-models) లోని ఉదాహరణ అనువర్తనం తో GitHub Models ఇంటిగ్రేషన్‌ని పరీక్షిద్దాం. -1. మీ డెవలప్‌మెంట్ ఎన్విరాన్‌మెంట్‌లో టెర్మినల్‌ను ఓపెన్ చేయండి. -2. GitHub మోడల్స్ ఉదాహరణకు వెళ్లండి: +1. మీ అభివృద్ధి పరిసరంలో టెర్మినల్ తెరవండి. +2. GitHub Models ఉదాహరణకి నావిగేట్ అవ్వండి: ```bash cd 02-SetupDevEnvironment/examples/github-models ``` -3. మీ GitHub టోకెన్‌ను ఎన్విరాన్‌మెంట్ వేరియబుల్‌గా సెట్ చేయండి: +3. మీ GitHub టోకెన్‌ను ఎన్‌విరాన్‌మెంట్ వేరియబుల్‌గా సెట్ చేయండి: ```bash # మాక్‌ఓఎస్/లినక్స్ export GITHUB_TOKEN=your_token_here @@ -161,12 +153,12 @@ CO_OP_TRANSLATOR_METADATA: $env:GITHUB_TOKEN="your_token_here" ``` -4. అప్లికేషన్‌ను రన్ చేయండి: +4. అనువర్తనాన్ని రన్ చేయండి: ```bash mvn compile exec:java -Dexec.mainClass="com.example.githubmodels.App" ``` -మీకు ఇలాంటి అవుట్‌పుట్ కనిపించాలి: +ఇలాంటిది అవుట్పుట్ కనిపించాలి: ```text Using model: gpt-4.1-nano Sending request to GitHub Models... @@ -175,15 +167,15 @@ Response: Hello World! ### ఉదాహరణ కోడ్‌ను అర్థం చేసుకోవడం -ముందుగా, మేము ఏమి రన్ చేశామో అర్థం చేసుకుందాం. `examples/github-models` కింద ఉన్న ఉదాహరణ OpenAI Java SDKను ఉపయోగించి GitHub మోడల్స్‌కు కనెక్ట్ అవుతుంది: +ముందుగా మనం చేసిన దానిని అర్థం చేసుకుందాం. `examples/github-models` కిందని ఉదాహరణ GitHub Models కు కనెక్ట్ కావడానికి OpenAI Java SDK ను ఉపయోగిస్తుంది: **ఈ కోడ్ ఏమి చేస్తుంది:** -- **GitHub మోడల్స్**కు మీ వ్యక్తిగత యాక్సెస్ టోకెన్ ఉపయోగించి కనెక్ట్ అవుతుంది -- AI మోడల్‌కు "Say Hello World!" అనే సింపుల్ మెసేజ్ పంపుతుంది -- AI యొక్క ప్రతిస్పందనను స్వీకరించి ప్రదర్శిస్తుంది -- మీ సెటప్ సరిగ్గా పనిచేస్తుందో ధృవీకరిస్తుంది +- మీ పర్సనల్ యాక్సెస్ టోకెన్ ఉపయోగించి GitHub Models కు **కనెక్ట్ అవుతుంది** +- AI మోడల్‌కు ఒక సరళమైన "అందరికీ హలో చెప్పండి!" సందేశం **పంపుతుంది** +- AI యొక్క ప్రతిస్పందనని **స్వీకరించి ప్రదర్శిస్తుంది** +- మీ సెటప్ సరిగా పనిచేస్తుందో **ధృవీకరిస్తుంది** -**ముఖ్యమైన డిపెండెన్సీ** (`pom.xml`లో): +**ముఖ్య ఆధారపడే ప్యాకేజీ** (`pom.xml` లో): ```xml com.openai @@ -194,13 +186,13 @@ Response: Hello World! **ప్రధాన కోడ్** (`App.java`): ```java -// OpenAI Java SDK ఉపయోగించి GitHub మోడల్స్‌కు కనెక్ట్ అవ్వండి +// OpenAI జావా SDK ఉపయోగించి GitHub నమూనాలకు కనెక్ట్ అవ్వండి OpenAIClient client = OpenAIOkHttpClient.builder() .apiKey(pat) .baseUrl("https://models.inference.ai.azure.com") .build(); -// చాట్ పూర్తి అభ్యర్థనను సృష్టించండి +// చాట్ పూర్తి చేసే అభ్యర్థనను సృష్టించండి ChatCompletionCreateParams params = ChatCompletionCreateParams.builder() .model(modelId) .addSystemMessage("You are a concise assistant.") @@ -214,49 +206,49 @@ System.out.println("Response: " + response.choices().get(0).message().content(). ## సారాంశం -అద్భుతం! మీరు ఇప్పుడు అన్ని సెటప్ పూర్తి చేసారు: +చాలా బాగుంది! ఇప్పుడు మీ దగ్గర అన్నీ సెట్ అయ్యాయి: -- AI మోడల్ యాక్సెస్ కోసం సరైన అనుమతులతో GitHub వ్యక్తిగత యాక్సెస్ టోకెన్ సృష్టించారు -- మీ Java డెవలప్‌మెంట్ ఎన్విరాన్‌మెంట్ (Codespaces, dev కంటైనర్లు, లేదా స్థానిక) రన్ చేయబడింది -- OpenAI Java SDK ఉపయోగించి GitHub మోడల్స్‌కు కనెక్ట్ అయ్యారు -- AI మోడల్స్‌తో మాట్లాడే సింపుల్ ఉదాహరణతో అన్ని పనిచేస్తున్నాయని పరీక్షించారు +- AI మోడల్ యాక్సెస్ కోసం సరైన అనుమతులతో GitHub Personal Access Token సృష్టించారు +- మీ Java అభివృద్ధి పరిసరాన్ని (Codespaces, డెవ్ కంటైనర్స్, లేదా స్థానికం ఏదైనా) నడుపుతున్నారు +- OpenAI Java SDK ఉపయోగించి GitHub Models తో కనెక్ట్ అయ్యారు ఫ్రీ AI అభివృద్ధి కోసం +- AI మోడల్స్ తో మాట్లాడే సరిగా పనిచేస్తున్న ఒక సరళ ఉదాహరణతో ధృవీకరించారు -## తదుపరి దశలు +## తర్వాతి దశలు -[అధ్యాయం 3: కోర్ జెనరేటివ్ AI టెక్నిక్స్](../03-CoreGenerativeAITechniques/README.md) +[అధ్యాయం 3: కోర్ జనరేటివ్ AI సాంకేతికతలు](../03-CoreGenerativeAITechniques/README.md) -## ట్రబుల్‌షూటింగ్ +## సమస్య పరిష్కారం -సమస్యలు ఎదుర్కొంటున్నారా? ఇక్కడ సాధారణ సమస్యలు మరియు పరిష్కారాలు ఉన్నాయి: +సమస్యలు ఎదురైతే? ఇక్కడ సాధారణ సమస్యలు మరియు పరిష్కారాలు: -- **టోకెన్ పనిచేయడం లేదా?** - - మీరు మొత్తం టోకెన్‌ను ఎటువంటి అదనపు స్పేస్‌లతో కాపీ చేయలేదని నిర్ధారించండి - - టోకెన్ సరైనంగా ఎన్విరాన్‌మెంట్ వేరియబుల్‌గా సెట్ చేయబడిందని ధృవీకరించండి - - మీ టోకెన్ సరైన అనుమతులు కలిగి ఉందని (Models: Read and write) తనిఖీ చేయండి +- **టోకెన్ పనిచేయడంలేదు?** + - మీరు టోకెన్‌ను সম্পూర్ణంగా ఎటువంటి అదనపు స్ధానాలు లేకుండా కాపీ చేసిందో నిర్ధారించండి + - టోకెన్ సరిగ్గా ఎన్‌విరాన్‌మెంట్ వేరియబుల్‌గా సెట్ అయ్యిందో చూసుకోండి + - టోకెన్ సరైన అనుమతులు (Models: పఠన మోడ్‌లో) కలిగి ఉన్నదో తనిఖీ చేయండి -- **Maven కనుగొనబడలేదు?** - - dev కంటైనర్లు/Codespaces ఉపయోగిస్తే, Maven ముందే ఇన్‌స్టాల్ చేయబడుతుంది - - స్థానిక సెటప్ కోసం, Java 21+ మరియు Maven 3.9+ ఇన్‌స్టాల్ చేయబడిందని నిర్ధారించండి - - ఇన్‌స్టాలేషన్ ధృవీకరించడానికి `mvn --version` ప్రయత్నించండి +- **Maven కనిపించట్లేదు?** + - డెవ్ కంటైనర్స్ లేదా Codespaces ఉపయోగిస్తుంటే Maven ముందుగానే ఇన్‌స్టాల్ ఉంటుంది + - స్థానిక సెటప్ లో Java 21+ మరియు Maven 3.9+ ఇన్‌స్టాల్ అయ్యి ఉండాలి + - `mvn --version` తో ఇన్‌స్టాలేషన్ ధృవీకరించండి -- **కనెక్షన్ సమస్యలు?** - - మీ ఇంటర్నెట్ కనెక్షన్ తనిఖీ చేయండి - - GitHub మీ నెట్‌వర్క్ నుండి యాక్సెసిబుల్‌గా ఉందని ధృవీకరించండి - - GitHub మోడల్స్ ఎండ్‌పాయింట్‌ను బ్లాక్ చేసే ఫైర్‌వాల్ వెనుక మీరు లేరని నిర్ధారించండి +- **కనెక్షన్ సమస్యలు?** + - ఇంటర్నెట్ కనెక్షన్ పర్యవేక్షించండి + - GitHub మీ నెట్‌వర్క్ నుండి అందుబాటులో ఉన్నదో తనిఖీ చేయండి + - GitHub Models ఎండ్‌పాయింట్‌ను బ్లాక్ చేసే ఫైర్వాల్ లాంటి বাধలు ఉండవని నిర్ధారించండి -- **Dev కంటైనర్ ప్రారంభం కావడం లేదు?** - - Docker Desktop రన్ అవుతుందని నిర్ధారించండి (స్థానిక డెవలప్‌మెంట్ కోసం) - - కంటైనర్‌ను మళ్లీ నిర్మించడానికి ప్రయత్నించండి: `Ctrl+Shift+P` → "Dev Containers: Rebuild Container" +- **డెవ్ కంటైనర్ ప్రారంభం అవడం లేదు?** + - Docker Desktop నడుస్తుందా చూడండి (స్థానిక అభివృద్ధి కోసం) + - కంటైనర్‌ను తిరిగి నిర్మించండి: `Ctrl+Shift+P` → "Dev Containers: Rebuild Container" -- **అప్లికేషన్ కంపైలేషన్ లోపాలు?** - - మీరు సరైన డైరెక్టరీలో ఉన్నారని నిర్ధారించండి: `02-SetupDevEnvironment/examples/github-models` - - క్లీనింగ్ మరియు రీబిల్డింగ్ ప్రయత్నించండి: `mvn clean compile` +- **అనువర్తన కంపైలేషన్ లో ఎర్రర్లు?** + - మీరు సరైన డైరెక్టరీలో ఉన్నారా చూసుకోండి: `02-SetupDevEnvironment/examples/github-models` + - `mvn clean compile` తో క్లీనింగ్ చేయండి, తిరిగి కంపైల్ చేయండి -> **సహాయం కావాలా?**: ఇంకా సమస్యలు ఎదుర్కొంటున్నారా? రిపోజిటరీలో ఒక ఇష్యూ ఓపెన్ చేయండి, మేము మీకు సహాయం చేస్తాము. +> **సహాయం కావాలా?**: ఇంకా సమస్య ఉంటే? రిపోజిటరీలో ఒక ఇష్యూ తెరిచి మాతో సంప్రదించండి. --- -**అస్వీకరణ**: -ఈ పత్రం AI అనువాద సేవ [Co-op Translator](https://github.com/Azure/co-op-translator) ఉపయోగించి అనువదించబడింది. మేము ఖచ్చితత్వానికి ప్రయత్నిస్తున్నప్పటికీ, ఆటోమేటెడ్ అనువాదాలు తప్పులు లేదా అసమగ్రతలను కలిగి ఉండవచ్చు. దాని స్వస్థల భాషలో ఉన్న అసలు పత్రాన్ని అధికారం కలిగిన మూలంగా పరిగణించాలి. కీలకమైన సమాచారం కోసం, ప్రొఫెషనల్ మానవ అనువాదాన్ని సిఫారసు చేస్తాము. ఈ అనువాదాన్ని ఉపయోగించడం వల్ల కలిగే ఏవైనా అపార్థాలు లేదా తప్పుదారులు కోసం మేము బాధ్యత వహించము. +**అస్పష్టత**: +ఈ డాక్యుమెంట్ [Co-op Translator](https://github.com/Azure/co-op-translator) అనే AI అనువాద సేవ ఉపయోగించి అనువదించబడింది. మేము ఖచ్చితత్వంతో ప్రయత్నిస్తేనూ, ఆటోమెటెడ్ అనువాదాలు తప్పులు లేదా అసత్యతలు కలిగి ఉండవచ్చు అని దయచేసి గమనించండి. స్వదేశ భాషలోున్న మౌలిక డాక్యుమెంట్‌ను అధికారిక మార్గదర్శకంగా భావించాలి. కీలకమైన సమాచారానికైతే, నిపుణుల చేతి అనువాదం సిఫార్సు చేయబడింది. ఈ అనువాదం వలన సంభవించే ఏవైనా అపార్థాలు లేదా తప్పుగా అర్థం చేసుకోవడాలకు మేము బాధ్యులు కాదు. \ No newline at end of file diff --git a/translations/te/02-SetupDevEnvironment/examples/basic-chat-azure/README.md b/translations/te/02-SetupDevEnvironment/examples/basic-chat-azure/README.md index afbfcd4d..0bdb3eef 100644 --- a/translations/te/02-SetupDevEnvironment/examples/basic-chat-azure/README.md +++ b/translations/te/02-SetupDevEnvironment/examples/basic-chat-azure/README.md @@ -1,12 +1,3 @@ - # Azure OpenAI తో బేసిక్ చాట్ - ఎండ్-టు-ఎండ్ ఉదాహరణ ఈ ఉదాహరణ Azure OpenAI కి కనెక్ట్ అయ్యే సింపుల్ స్ప్రింగ్ బూట్ అప్లికేషన్‌ను ఎలా సృష్టించాలో మరియు మీ సెటప్‌ను పరీక్షించాలో చూపిస్తుంది. diff --git a/translations/te/02-SetupDevEnvironment/getting-started-azure-openai.md b/translations/te/02-SetupDevEnvironment/getting-started-azure-openai.md index 53134ed4..c06db5b1 100644 --- a/translations/te/02-SetupDevEnvironment/getting-started-azure-openai.md +++ b/translations/te/02-SetupDevEnvironment/getting-started-azure-openai.md @@ -1,12 +1,3 @@ - # Azure OpenAI కోసం డెవలప్‌మెంట్ ఎన్విరాన్‌మెంట్ సెట్ అప్ చేయడం > **త్వరిత ప్రారంభం**: ఇది Azure OpenAI సెటప్ కోసం గైడ్. ఉచిత మోడల్స్‌తో వెంటనే ప్రారంభించాలంటే, [GitHub Models with Codespaces](./README.md#quick-start-cloud) ఉపయోగించండి. diff --git a/translations/te/03-CoreGenerativeAITechniques/README.md b/translations/te/03-CoreGenerativeAITechniques/README.md index 4b707b28..90f31c55 100644 --- a/translations/te/03-CoreGenerativeAITechniques/README.md +++ b/translations/te/03-CoreGenerativeAITechniques/README.md @@ -1,12 +1,3 @@ - # కోర్ జనరేటివ్ AI టెక్నిక్స్ ట్యుటోరియల్ ## విషయ సూచిక diff --git a/translations/te/04-PracticalSamples/README.md b/translations/te/04-PracticalSamples/README.md index 7cae0cdb..541176a3 100644 --- a/translations/te/04-PracticalSamples/README.md +++ b/translations/te/04-PracticalSamples/README.md @@ -1,12 +1,3 @@ - # ప్రాక్టికల్ అప్లికేషన్స్ & ప్రాజెక్ట్స్ ## మీరు నేర్చుకునేది diff --git a/translations/te/04-PracticalSamples/calculator/README.md b/translations/te/04-PracticalSamples/calculator/README.md index d5f262ff..9b9e4b9b 100644 --- a/translations/te/04-PracticalSamples/calculator/README.md +++ b/translations/te/04-PracticalSamples/calculator/README.md @@ -1,12 +1,3 @@ - # MCP కాలిక్యులేటర్ ట్యుటోరియల్ ప్రారంభికుల కోసం ## విషయ సూచిక diff --git a/translations/te/04-PracticalSamples/foundrylocal/README.md b/translations/te/04-PracticalSamples/foundrylocal/README.md index 744250d0..a60992e1 100644 --- a/translations/te/04-PracticalSamples/foundrylocal/README.md +++ b/translations/te/04-PracticalSamples/foundrylocal/README.md @@ -1,12 +1,3 @@ - # Foundry Local Spring Boot ట్యుటోరియల్ ## విషయ సూచిక diff --git a/translations/te/04-PracticalSamples/petstory/README.md b/translations/te/04-PracticalSamples/petstory/README.md index 9164cbe2..dd1bb695 100644 --- a/translations/te/04-PracticalSamples/petstory/README.md +++ b/translations/te/04-PracticalSamples/petstory/README.md @@ -1,12 +1,3 @@ - # పెట్ స్టోరీ జనరేటర్ ట్యుటోరియల్ ప్రారంభికుల కోసం ## విషయ సూచిక diff --git a/translations/te/05-ResponsibleGenAI/README.md b/translations/te/05-ResponsibleGenAI/README.md index 7b1468cd..8dfec66b 100644 --- a/translations/te/05-ResponsibleGenAI/README.md +++ b/translations/te/05-ResponsibleGenAI/README.md @@ -1,12 +1,3 @@ - # బాధ్యతాయుతమైన జనరేటివ్ AI ## మీరు నేర్చుకునేది diff --git a/translations/te/AGENTS.md b/translations/te/AGENTS.md index 94853ee6..2fd2378d 100644 --- a/translations/te/AGENTS.md +++ b/translations/te/AGENTS.md @@ -1,12 +1,3 @@ - # AGENTS.md ## ప్రాజెక్ట్ అవలోకనం diff --git a/translations/te/CODE_OF_CONDUCT.md b/translations/te/CODE_OF_CONDUCT.md index f6d72c7a..82f857cd 100644 --- a/translations/te/CODE_OF_CONDUCT.md +++ b/translations/te/CODE_OF_CONDUCT.md @@ -1,12 +1,3 @@ - # మైక్రోసాఫ్ట్ ఓపెన్ సోర్స్ ప్రవర్తనా నియమావళి ఈ ప్రాజెక్ట్ [మైక్రోసాఫ్ట్ ఓపెన్ సోర్స్ ప్రవర్తనా నియమావళి](https://opensource.microsoft.com/codeofconduct/)ను స్వీకరించింది. diff --git a/translations/te/README.md b/translations/te/README.md index 8aed6eef..d89740ae 100644 --- a/translations/te/README.md +++ b/translations/te/README.md @@ -1,127 +1,120 @@ - -# జనరేటివ్ AI ప్రారంభకులకు - జావా సంచిక +# ప్రారంభికుల కోసం జనరేటివ్ AI - జావా సంచిక [![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) -![Generative AI for Beginners - Java Edition](../../translated_images/te/beg-genai-series.8b48be9951cc574c.webp) +![ప్రారంభికుల కోసం జనరేటివ్ AI - జావా సంచిక](../../translated_images/te/beg-genai-series.8b48be9951cc574c.webp) -**సమయ కేటాయింపు**: మొత్తం వర్క్‌షాప్‌ను ఆన్‌లైన్‌లో స్థానిక సెటప్ లేకుండా పూర్తి చేయవచ్చు. వాతావరణ సెటప్‌కు 2 నిమిషాలు పట్టుతుంది, నమూనాలను అన్వేషించడం అన్వేషణ లోతు మీద ఆధారపడి 1-3 గంటలు పడుతుంది. +**సమయ వాయిదా**: మొత్తం వర్క్‌షాప్ స్థానిక సెటప్ లేకుండా ఆన్‌లైన్‌లో పూర్తి చేయవచ్చు. పరిసరాన్ని సెట్ చేయడానికి 2 నిమిషాలు పట్టేవి, నమూనాలను అన్వేషించడానికి 1-3 గంటలు అవసరం అన్వేషణ లోతు ఆధారంగా ఉంటుంది. -> **వేగంగా ప్రారంభించండి** +> **త్వరిత ప్రారంభం** -1. ఈ రిపాజిటరీని మీ GitHub ఖాతాకు ఫోర్క్ చేయండి -2. **Code** → **Codespaces** ట్యాబ్ → **...** → **New with options...** క్లిక్ చేయండి -3. డిఫాల్ట్స్‌ను ఉపయోగించండి – ఇది ఈ కోర్సు కోసం సృష్టించిన Development కంటైనర్‌ని ఎంచుకుంటుంది -4. **Create codespace** క్లిక్ చేయండి -5. వాతావరణం తయారుకావడానికి ~2 నిమిషాలు వేచి ఉండండి -6. నేరుగా [మొదటి ఉదాహరణకు](./02-SetupDevEnvironment/README.md#step-2-create-a-github-personal-access-token) వెళ్ళండి +1. ఈ రిపోజిటరీని మీ GitHub ఖాతాకు ఫోర్క్ చేయండి +2. **Code** → **Codespaces** టాబ్ → **...** → **New with options...** క్లిక్ చేయండి +3. డిఫాల్ట్లను ఉపయోగించండి – ఇది ఈ కోర్స్ కోసం రూపొందించిన డెవలప్‌మెంట్ కంటైనర్‌ను ఎంచుకుంటుంది +4. **Create codespace** క్లిక్ చేయండి +5. పరిసరము తయారవ్వడానికి సుమారు ~2 నిమిషాలు వేచి ఉండండి +6. నేరుగా [మొదటి ఉదాహరణకు](./02-SetupDevEnvironment/README.md#step-2-create-a-github-personal-access-token) వెళ్లండి -> **స్థానికంగా క్లోన్ చేసుకోమని ఇష్టపడుతున్నారా?** -> -> ఈ రిపాజిటరీలో 50+ భాషా అనువాదాలు ఉన్నాయి, వలన డౌన్లోడ్ పరిమాణం భారీగా పెరుగుతుంది. అనువాదాలు లేకుండా క్లోన్ చేయడానికి sparse checkout ఉపయోగించండి: +> **స్థానికంగా క్లోన్ చేయాలని ఇష్టం ఉందా?** +> +> ఈ రిపోజిటరీ 50+ భాషా అనువాదాలను కలిగి ఉంది, ఇది డౌన్లోడ్ పరిమాణాన్ని గణనీయంగా పెంచుతుంది. అనువాదాలు లేకుండా క్లోన్ చేయడానికి, స్పార్స్ చెకౌట్ ఉపయోగించండి: > ```bash > git clone --filter=blob:none --sparse https://github.com/microsoft/Generative-AI-for-beginners-java.git > cd Generative-AI-for-beginners-java > git sparse-checkout set --no-cone '/*' '!translations' '!translated_images' > ``` -> ఇది కోర్సును పూర్తి చేయడానికి కావలసిన అన్ని విషయాలను చాలా వేగంగా డౌన్లోడ్ చేస్తుంది. +> ఇది కోర్స్ పూర్తి చేయడానికి మీకు కావలసిన ప్రతిదీ చాలా వేగంగా డౌన్లోడ్ అవుతుంది. -## బహుభాషా మద్దతు -### GitHub Action ద్వారా మద్దతు ఉంది (స్వయంచాలకంగా & ఎప్పుడూ తాజా) +## బహుభాషా మద్దతు + +### GitHub యాక్షన్ ద్వారా మద్దతు (ఆటోమేటెడ్ & ఎప్పటి నుండీ తాజా) -[అరబిక్](../ar/README.md) | [బెంగాలీ](../bn/README.md) | [బుల్‌గేరియన్](../bg/README.md) | [బర్మీస్ (మయన్మార్)](../my/README.md) | [చైనీస్ (సింప్లిఫైడ్)](../zh/README.md) | [చైనీస్ (సాంప్రదాయ, హాంకాంగ్)](../hk/README.md) | [చైనీస్ (సాంప్రదాయ, మాకావు)](../mo/README.md) | [చైనీస్ (సాంప్రదాయ, తైవాన్)](../tw/README.md) | [క్రోయేషియన్](../hr/README.md) | [చెక్](../cs/README.md) | [డాన్‌మిష్](../da/README.md) | [డచ్](../nl/README.md) | [ఎస్తోనియన్](../et/README.md) | [ఫిన్నిష్](../fi/README.md) | [ఫ్రెంచ్](../fr/README.md) | [జర్మన్](../de/README.md) | [గ్రీకు](../el/README.md) | [హీబ్రూ](../he/README.md) | [హిందీ](../hi/README.md) | [హంగేరియన్](../hu/README.md) | [ఇండోనేషియన్](../id/README.md) | [ఇటాలియన్](../it/README.md) | [జపనీస్](../ja/README.md) | [కన్నడ](../kn/README.md) | [కొరియన్](../ko/README.md) | [లిథువానియన్](../lt/README.md) | [మలయ్](../ms/README.md) | [మలయాళం](../ml/README.md) | [మరాఠీ](../mr/README.md) | [నేపాలి](../ne/README.md) | [నైజీరియన్ పిడగినె](../pcm/README.md) | [నార్వేజియన్](../no/README.md) | [పర్షియన్ (ఫార్సీ)](../fa/README.md) | [పోలిష్](../pl/README.md) | [పోర్చుగీసు (బ్రెజిల్)](../br/README.md) | [పోర్చుగీసు (పోర్టుగాల్)](../pt/README.md) | [పంచాబీ (గుర్ముఖీ)](../pa/README.md) | [రోమనియన్](../ro/README.md) | [రష్యన్](../ru/README.md) | [సെర్బియన్ (సిరిలిక్)](../sr/README.md) | [స్లోవాక్](../sk/README.md) | [స్లోవేనియన్](../sl/README.md) | [స్పానిష్](../es/README.md) | [స్వాహిలి](../sw/README.md) | [స్వీడిష్](../sv/README.md) | [టాగాలాగ్ (ఫిలిపినో)](../tl/README.md) | [తమిళ్](../ta/README.md) | [తెలుగు](./README.md) | [థాయి](../th/README.md) | [టర్కిష్](../tr/README.md) | [ఉక్రెయిన్](../uk/README.md) | [ఉర్దూ](../ur/README.md) | [వియత్నామీస్](../vi/README.md) +[అరబిక్](../ar/README.md) | [బెంగాలీ](../bn/README.md) | [బల్గేరియన్](../bg/README.md) | [బర్మీస్ (మయన్మార్)](../my/README.md) | [చైనీస్ (సంప్లిష్డ్)](../zh-CN/README.md) | [చైనీస్ (పారంపర్య, హాంకాంగ్)](../zh-HK/README.md) | [చైనీస్ (పారంపర్య, మకావు)](../zh-MO/README.md) | [చైనీస్ (పారంపర్య, తైవాన్)](../zh-TW/README.md) | [క్రొయేషియన్](../hr/README.md) | [చెక్](../cs/README.md) | [డానిష్](../da/README.md) | [డచ్](../nl/README.md) | [ఎస్టోనియన్](../et/README.md) | [ఫిన్నిష్](../fi/README.md) | [ఫ్రెంచ్](../fr/README.md) | [జర్మన్](../de/README.md) | [గ్రీకు](../el/README.md) | [హిబ్రూ](../he/README.md) | [హిందీ](../hi/README.md) | [హంగేరియన్](../hu/README.md) | [ఇండోనేషియన్](../id/README.md) | [ఇటాలియన్](../it/README.md) | [జపనీస్](../ja/README.md) | [కన్నడ](../kn/README.md) | [కోరియన్](../ko/README.md) | [లిథువేనియన్](../lt/README.md) | [మలయ్](../ms/README.md) | [మలయాళం](../ml/README.md) | [మరాఠీ](../mr/README.md) | [నేపాలీ](../ne/README.md) | [నైజీరియన్ పిడ్జిన్](../pcm/README.md) | [నార్వేజియన్](../no/README.md) | [ఫార్సీ (పర్షియన్)](../fa/README.md) | [పోలిష్](../pl/README.md) | [పొర్చుగీస్ (బ్రెజిల్)](../pt-BR/README.md) | [పొర్చుగీస్ (పొర్చుగల్)](../pt-PT/README.md) | [పంజాబీ (గురుముఖి)](../pa/README.md) | [రోమానియన్](../ro/README.md) | [రష్యన్](../ru/README.md) | [సెర్బియన్ (సిరిలిక్)](../sr/README.md) | [స్లోవక్](../sk/README.md) | [స్లోవేనియన్](../sl/README.md) | [స్పానిష్](../es/README.md) | [స్వాహిలి](../sw/README.md) | [స్వీడిష్](../sv/README.md) | [టాగలోగ్ (ఫిలిపినో)](../tl/README.md) | [తమిళ్](../ta/README.md) | [తెలుగు](./README.md) | [థాయ్](../th/README.md) | [టర్కిష్](../tr/README.md) | [ఉక్రెయిన్](../uk/README.md) | [ఉర్దూ](../ur/README.md) | [వియత్నామీస్](../vi/README.md) -> **స్థానికంగా క్లోన్ చేసుకోమని ఇష్టపడుతున్నారా?** +> **స్థానికంగా క్లోన్ చేయాలని ఇష్టం ఉందా?** -> ఈ రిపాజిటరీలో 50+ భాషా అనువాదాలు ఉన్నాయి, వలన డౌన్లోడ్ పరిమాణం భారీగా పెరుగుతుంది. అనువాదాలు లేకుండా క్లోన్ చేయడానికి sparse checkout ఉపయోగించండి: +> ఈ రిపోజిటరీ 50+ భాషా అనువాదాలను కలిగి ఉంది, ఇది డౌన్లోడ్ పరిమాణాన్ని గణనీయంగా పెంచుతుంది. అనువాదాలు లేకుండా క్లోన్ చేయడానికి, స్పార్స్ చెకౌట్ ఉపయోగించండి: > ```bash > git clone --filter=blob:none --sparse https://github.com/microsoft/Generative-AI-for-beginners-java.git > cd Generative-AI-for-beginners-java > git sparse-checkout set --no-cone '/*' '!translations' '!translated_images' > ``` -> ఇది కోర్సును పూర్తి చేయడానికి కావలసిన అన్ని విషయాలను చాలా వేగంగా డౌన్లోడ్ చేస్తుంది. +> ఇది కోర్స్ పూర్తి చేయడానికి మీకు కావలసిన ప్రతిదీ చాలా వేగంగా డౌన్లోడ్ అవుతుంది. -## కోర్సు నిర్మాణం & నేర్చుకునే మార్గం - -### **అధ్యాయం 1: జనరేటివ్ AI పరిచయం** -- **ప్రధాన భావాలు**: పెద్ద భాషా నమూనాలు, టోకెన్లు, ఎంబెడ్డింగ్లు, AI సామర్థ్యాలు అర్థం చేసుకోవడం -- **జావా AI పరిసరాలు**: Spring AI మరియు OpenAI SDKల అవలోకనం -- **మోడల్ కాంటెక్స్ట్ ప్రోటోకాల్**: MCP పరిచయం మరియు AI ఏజెంట్ కమ్యూనికేషన్‌లో ఆ పాత్ర -- **ప్రాయోగిక అప్లికేషన్లు**: చాట్‌బాట్లు మరియు కంటెంట్ ఉత్పత్తి వంటి వాస్తవ ప్రపంచ సన్నివేశాలు -- **[→ అధ్యాయం 1 ప్రారంభించండి](./01-IntroToGenAI/README.md)** - -### **అధ్యాయం 2: అభివృద్ధి వాతావరణం సెటప్** -- **బహుళ ప్రొవైడర్ కాన్ఫిగరేషన్**: GitHub Models, Azure OpenAI, మరియు OpenAI జావా SDK ఇంటిగ్రేషన్లు సెటప్ చేయడం -- **Spring Boot + Spring AI**: ఎంటర్‌ప్రైజ్ AI అప్లికేషన్ అభివృద్ధికి ఉత్తమ మార్గాలు -- **GitHub Models**: ప్రోటోటైపింగ్ మరియు నేర్చుకోవడానికి ఉచిత AI మోడల్స్ (క్రెడిట్ కార్డు అవసరం లేదు) -- **అభివృద్ధి సాధనాలు**: డోకర్ కంటైనర్లు, VS కోడ్, మరియు GitHub Codespaces కన్‌ఫిగరేషన్ -- **[→ అధ్యాయం 2 ప్రారంభించండి](./02-SetupDevEnvironment/README.md)** - -### **అధ్యాయం 3: ప్రధాన జనరేటివ్ AI సాంకేతికతలు** -- **ప్రాంప్ట్ ఇంజనీరింగ్**: ఉత్తమ AI మోడల్ స్పందనలు కోసం సాంకేతికతలు -- **ఎంబెడ్డింగ్లు & వెక్టర్ ఆపరేషన్లు**: సేమాంటిక్ సర్చ్ మరియు సాదృశ్య సరిపోలింపు అమలు చేయడం -- **రిట్రీవల్-ఆగ్మెంటెడ్ జనరేషన్ (RAG)**: AIని మీ స్వంత డేటా మూలాలతో కలపడం -- **ఫంక్షన్ కాల్లింగ్**: AI సామర్థ్యాలను కస్టమ్ టూల్స్ మరియు ప్లగిన్లతో విస్తరించడం -- **[→ అధ్యాయం 3 ప్రారంభించండి](./03-CoreGenerativeAITechniques/README.md)** - -### **అధ్యాయం 4: ప్రాయోగిక అప్లికేషన్లు & ప్రాజెక్టులు** -- **పెట్ స్టోరి జనరేటర్** (`petstory/`): GitHub మోడల్స్‌తో సృజనాత్మక కంటెంట్ జనరేషన్ -- **ఫౌండ్రీ లోకల్ డెమో** (`foundrylocal/`): OpenAI జావా SDKతో లోకల్ AI మోడల్ ఇంటిగ్రేషన్ -- **MCP క్యాలిక్యులేటర్ సర్వీస్** (`calculator/`): Spring AIతో ప్రాథమిక మోడల్ కాంటెక్స్ట్ ప్రోటోకాల్ అమలు -- **[→ అధ్యాయం 4 ప్రారంభించండి](./04-PracticalSamples/README.md)** - -### **అధ్యాయం 5: బాధ్యతాయుత AI అభివృద్ధి** -- **GitHub Models సురక్షత**: బిల్ట్-ఇన్ కంటెంట్ ఫిల్టర్డ్ మరియు సురక్షత మెకానిజంకులను పరీక్షించండి (హార్డ్ బ్లాక్స్ మరియు సాఫ్ట్ రద్దులు) -- **బాధ్యతాయుత AI డెమో**: ఆధునిక AI సురక్షత వ్యవస్థలు ఎలా పనిచేస్తాయో ప్రాక్టికల్ ఉదాహరణ -- **ఉత్తమ ప్రాథమికాలు**: నైతిక AI అభివృద్ధి మరియు అమలుకు అవసరమైన మార్గదర్శకాలు -- **[→ అధ్యాయం 5 ప్రారంభించండి](./05-ResponsibleGenAI/README.md)** - -## అదనపు వనరులు - - -### LangChain -[![LangChain4j for Beginners](https://img.shields.io/badge/LangChain4j%20for%20Beginners-22C55E?style=for-the-badge&&labelColor=E5E7EB&color=0553D6)](https://aka.ms/langchain4j-for-beginners) -[![LangChain.js for Beginners](https://img.shields.io/badge/LangChain.js%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=0553D6)](https://aka.ms/langchainjs-for-beginners?WT.mc_id=m365-94501-dwahlin) - ---- - -### Azure / Edge / MCP / Agents -[![AZD for Beginners](https://img.shields.io/badge/AZD%20for%20Beginners-0078D4?style=for-the-badge&labelColor=E5E7EB&color=0078D4)](https://github.com/microsoft/AZD-for-beginners?WT.mc_id=academic-105485-koreyst) -[![Edge AI for Beginners](https://img.shields.io/badge/Edge%20AI%20for%20Beginners-00B8E4?style=for-the-badge&labelColor=E5E7EB&color=00B8E4)](https://github.com/microsoft/edgeai-for-beginners?WT.mc_id=academic-105485-koreyst) -[![MCP for Beginners](https://img.shields.io/badge/MCP%20for%20Beginners-009688?style=for-the-badge&labelColor=E5E7EB&color=009688)](https://github.com/microsoft/mcp-for-beginners?WT.mc_id=academic-105485-koreyst) -[![AI Agents for Beginners](https://img.shields.io/badge/AI%20Agents%20for%20Beginners-00C49A?style=for-the-badge&labelColor=E5E7EB&color=00C49A)](https://github.com/microsoft/ai-agents-for-beginners?WT.mc_id=academic-105485-koreyst) - ---- - -### Generative AI సిరీస్ -[![Generative AI for Beginners](https://img.shields.io/badge/Generative%20AI%20for%20Beginners-8B5CF6?style=for-the-badge&labelColor=E5E7EB&color=8B5CF6)](https://github.com/microsoft/generative-ai-for-beginners?WT.mc_id=academic-105485-koreyst) -[![Generative AI (.NET)](https://img.shields.io/badge/Generative%20AI%20(.NET)-9333EA?style=for-the-badge&labelColor=E5E7EB&color=9333EA)](https://github.com/microsoft/Generative-AI-for-beginners-dotnet?WT.mc_id=academic-105485-koreyst) -[![Generative AI (Java)](https://img.shields.io/badge/Generative%20AI%20(Java)-C084FC?style=for-the-badge&labelColor=E5E7EB&color=C084FC)](https://github.com/microsoft/generative-ai-for-beginners-java?WT.mc_id=academic-105485-koreyst) -[![Generative AI (JavaScript)](https://img.shields.io/badge/Generative%20AI%20(JavaScript)-E879F9?style=for-the-badge&labelColor=E5E7EB&color=E879F9)](https://github.com/microsoft/generative-ai-with-javascript?WT.mc_id=academic-105485-koreyst) - ---- - -### ప్రాధమిక అభ్యాసం -[![ML for Beginners](https://img.shields.io/badge/ML%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=22C55E)](https://aka.ms/ml-beginners?WT.mc_id=academic-105485-koreyst) -[![Data Science for Beginners](https://img.shields.io/badge/Data%20Science%20for%20Beginners-84CC16?style=for-the-badge&labelColor=E5E7EB&color=84CC16)](https://aka.ms/datascience-beginners?WT.mc_id=academic-105485-koreyst) -[![AI for Beginners](https://img.shields.io/badge/AI%20for%20Beginners-A3E635?style=for-the-badge&labelColor=E5E7EB&color=A3E635)](https://aka.ms/ai-beginners?WT.mc_id=academic-105485-koreyst) -[![Cybersecurity for Beginners](https://img.shields.io/badge/Cybersecurity%20for%20Beginners-F97316?style=for-the-badge&labelColor=E5E7EB&color=F97316)](https://github.com/microsoft/Security-101?WT.mc_id=academic-96948-sayoung) -[![Web Dev for Beginners](https://img.shields.io/badge/Web%20Dev%20for%20Beginners-EC4899?style=for-the-badge&labelColor=E5E7EB&color=EC4899)](https://aka.ms/webdev-beginners?WT.mc_id=academic-105485-koreyst) +## కోర్స్ నిర్మాణం & నేర్చుకునే మార్గం + +### **అధ్యాయం 1: జనరేటివ్ AI పరిచయం** +- **ముఖ్యాంశాలు**: పెద్ద భాషా నమూనాలు, టోకెన్లు, ఎంబెడింగ్స్, మరియు AI శక్తుల అవగాహన +- **జావా AI పరిసరము**: Spring AI మరియు OpenAI SDKల అవలోకనం +- **మోడల్ కాంటెక్స్ట్ ప్రోటోకాల్**: MCP పరిచయం మరియు AI ఏజెంట్ కమ్యూనికేషన్‌లో పాత్ర +- **ప్రయోజనాత్మక అనువర్తనాలు**: చాట్‌బాట్లు మరియు కంటెంట్ ఉత్పత్తి వంటి వాస్తవ ప్రపంచ దృశ్యాలు +- **[→ అధ్యాయం 1 ప్రారంభించండి](./01-IntroToGenAI/README.md)** + +### **అధ్యాయం 2: డెవలప్‌మెంట్ పరిసర సెటప్** +- **బహుళ-ప్రొవైడర్ కాన్ఫిగరేషన్**: GitHub Models, Azure OpenAI, మరియు OpenAI Java SDK ఇంటిగ్రేషన్ల సెటప్ +- **Spring Boot + Spring AI**: ఎంటర్ప్రైజ్ AI అప్లికేషన్ అభివృద్ధికి మంచిది +- **GitHub Models**: ప్రోటోటైపింగ్ మరియు విద్య కోసం ఉచిత AI మోడల్ యాక్సెస్ (క్రెడిట్ కార్డు అవసరం లేదు) +- **డెవలప్‌మెంట్ టూల్స్**: Docker కంటైనర్లు, VS కోడ్, మరియు GitHub Codespaces కాన్ఫిగరేషన్ +- **[→ అధ్యాయం 2 ప్రారంభించండి](./02-SetupDevEnvironment/README.md)** + +### **అధ్యాయం 3: కోర్ జనరేటివ్ AI సాంకేతికతలు** +- **ప్రాంప్ట్ ఇంజనీరింగ్**: ఉత్తమ AI మోడల్ ప్రతిస్పందనల కోసం సాంకేతికతలు +- **ఎంబెడింగ్స్ & వెక్టర్ ఆపరేషన్స్**: సేమాంటిక్ సెర్చ్ మరియు సమాన్యపు మ్యాచ్ విధానాలు అమలు +- **రిట్రీవల్-ఆగ్మెంటెడ్ జనరేషన్ (RAG)**: మీ స్వంత డేటా వనరులతో AI కలపండి +- **ఫంక్షన్ కాలింగ్**: కస్టమ్ టూల్స్ మరియు ప్లగిన్లతో AI శక్తులను విస్తరించండి +- **[→ అధ్యాయం 3 ప్రారంభించండి](./03-CoreGenerativeAITechniques/README.md)** + +### **అధ్యాయం 4: ప్రాక్టికల్ అనువర్తనాలు & ప్రాజెక్టులు** +- **పెట్ స్టోరీ జనరేటర్** (`petstory/`): GitHub Models తో సృజనాత్మక కంటెంట్ ఉత్పత్తి +- **Foundry స్థానిక డెమో** (`foundrylocal/`): OpenAI Java SDK ద్వారా స్థానిక AI మోడల్ ఇంటిగ్రేషన్ +- **MCP క్యాలిక్యులేటర్ సర్వీస్** (`calculator/`): Spring AI తో ప్రాథమిక మోడల్ కాంటెక్స్ట్ ప్రోటోకాల్ అమలు +- **[→ అధ్యాయం 4 ప్రారంభించండి](./04-PracticalSamples/README.md)** + +### **అధ్యాయం 5: బాధ్యతాయుత AI అభివృద్ధి** +- **GitHub Models భద్రత**: అంతర్లీన కంటెంట్ ఫిల్టరింగ్ మరియు భద్రతా విధానాల పరీక్ష (హార్డ్ బ్లాకులు మరియు సోఫ్ట్ తిరస్కరణలు) +- **బాధ్యతాయుత AI డెమో**: ఆధునిక AI భద్రతా వ్యవస్థలు ఎలా పని చేస్తున్నాయో తెలిసే చేతులలో ఉదాహరణ +- **మంచి ఆచారాలు**: నైతిక AI అభివృద్ధి మరియు పంపిణీకి అవసరమైన మార్గదర్శకాలు +- **[→ అధ్యాయం 5 ప్రారంభించండి](./05-ResponsibleGenAI/README.md)** + +## అదనపు వనరులు + + +### లాంగ్ చైన్ +[![ప్రారంభికుల కోసం LangChain4j](https://img.shields.io/badge/LangChain4j%20for%20Beginners-22C55E?style=for-the-badge&&labelColor=E5E7EB&color=0553D6)](https://aka.ms/langchain4j-for-beginners) +[![ప్రారంభికుల కోసం LangChain.js](https://img.shields.io/badge/LangChain.js%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=0553D6)](https://aka.ms/langchainjs-for-beginners?WT.mc_id=m365-94501-dwahlin) + +--- + +### Azure / Edge / MCP / ఏజెంట్లు +[![ప్రారంభికుల కోసం AZD](https://img.shields.io/badge/AZD%20for%20Beginners-0078D4?style=for-the-badge&labelColor=E5E7EB&color=0078D4)](https://github.com/microsoft/AZD-for-beginners?WT.mc_id=academic-105485-koreyst) +[![ప్రారంభికుల కోసం Edge AI](https://img.shields.io/badge/Edge%20AI%20for%20Beginners-00B8E4?style=for-the-badge&labelColor=E5E7EB&color=00B8E4)](https://github.com/microsoft/edgeai-for-beginners?WT.mc_id=academic-105485-koreyst) +[![ప్రారంభికుల కోసం MCP](https://img.shields.io/badge/MCP%20for%20Beginners-009688?style=for-the-badge&labelColor=E5E7EB&color=009688)](https://github.com/microsoft/mcp-for-beginners?WT.mc_id=academic-105485-koreyst) +[![ప్రారంభికుల కోసం AI ఏజెంట్లు](https://img.shields.io/badge/AI%20Agents%20for%20Beginners-00C49A?style=for-the-badge&labelColor=E5E7EB&color=00C49A)](https://github.com/microsoft/ai-agents-for-beginners?WT.mc_id=academic-105485-koreyst) + +--- + +### జనరేటివ్ AI సిరీస్ +[![ప్రారంభికుల కోసం జనరేటివ్ AI](https://img.shields.io/badge/Generative%20AI%20for%20Beginners-8B5CF6?style=for-the-badge&labelColor=E5E7EB&color=8B5CF6)](https://github.com/microsoft/generative-ai-for-beginners?WT.mc_id=academic-105485-koreyst) +[![జనరేటివ్ AI (.NET)](https://img.shields.io/badge/Generative%20AI%20(.NET)-9333EA?style=for-the-badge&labelColor=E5E7EB&color=9333EA)](https://github.com/microsoft/Generative-AI-for-beginners-dotnet?WT.mc_id=academic-105485-koreyst) +[![జనరేటివ్ AI (జావా)](https://img.shields.io/badge/Generative%20AI%20(Java)-C084FC?style=for-the-badge&labelColor=E5E7EB&color=C084FC)](https://github.com/microsoft/generative-ai-for-beginners-java?WT.mc_id=academic-105485-koreyst) +[![జనరేటివ్ AI (జావాస్క్రిప్ట్)](https://img.shields.io/badge/Generative%20AI%20(JavaScript)-E879F9?style=for-the-badge&labelColor=E5E7EB&color=E879F9)](https://github.com/microsoft/generative-ai-with-javascript?WT.mc_id=academic-105485-koreyst) + +--- + +### కోర్ లెర్నింగ్ +[![ప్రారంభికుల కోసం ML](https://img.shields.io/badge/ML%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=22C55E)](https://aka.ms/ml-beginners?WT.mc_id=academic-105485-koreyst) +[![ప్రారంభికుల కోసం డేటా సైన్స్](https://img.shields.io/badge/Data%20Science%20for%20Beginners-84CC16?style=for-the-badge&labelColor=E5E7EB&color=84CC16)](https://aka.ms/datascience-beginners?WT.mc_id=academic-105485-koreyst) +[![ప్రారంభికుల కోసం AI](https://img.shields.io/badge/AI%20for%20Beginners-A3E635?style=for-the-badge&labelColor=E5E7EB&color=A3E635)](https://aka.ms/ai-beginners?WT.mc_id=academic-105485-koreyst) +[![ప్రారంభికుల కోసం సైబర్‌సెక్యూరిటీ](https://img.shields.io/badge/Cybersecurity%20for%20Beginners-F97316?style=for-the-badge&labelColor=E5E7EB&color=F97316)](https://github.com/microsoft/Security-101?WT.mc_id=academic-96948-sayoung) + +[![Web Dev for Beginners](https://img.shields.io/badge/Web%20Dev%20for%20Beginners-EC4899?style=for-the-badge&labelColor=E5E7EB&color=EC4899)](https://aka.ms/webdev-beginners?WT.mc_id=academic-105485-koreyst) [![IoT for Beginners](https://img.shields.io/badge/IoT%20for%20Beginners-14B8A6?style=for-the-badge&labelColor=E5E7EB&color=14B8A6)](https://aka.ms/iot-beginners?WT.mc_id=academic-105485-koreyst) [![XR Development for Beginners](https://img.shields.io/badge/XR%20Development%20for%20Beginners-38BDF8?style=for-the-badge&labelColor=E5E7EB&color=38BDF8)](https://github.com/microsoft/xr-development-for-beginners?WT.mc_id=academic-105485-koreyst) --- - + ### కొపైలట్ సిరీస్ [![Copilot for AI Paired Programming](https://img.shields.io/badge/Copilot%20for%20AI%20Paired%20Programming-FACC15?style=for-the-badge&labelColor=E5E7EB&color=FACC15)](https://aka.ms/GitHubCopilotAI?WT.mc_id=academic-105485-koreyst) [![Copilot for C#/.NET](https://img.shields.io/badge/Copilot%20for%20C%23/.NET-FBBF24?style=for-the-badge&labelColor=E5E7EB&color=FBBF24)](https://github.com/microsoft/mastering-github-copilot-for-dotnet-csharp-developers?WT.mc_id=academic-105485-koreyst) @@ -130,17 +123,17 @@ CO_OP_TRANSLATOR_METADATA: ## సహాయం పొందడం -మీరు ఇబ్బంది పడితే లేదా AI అనువర్తనాలు నిర్మించడంపై ఏవైనా ప్రశ్నలు ఉంటే. MCP గురించి చర్చల్లో ఇతర అభ్యాసకులు మరియు అనుభవజ్ఞులైన డెవెలపర్లతో చేరండి. ఇది ప్రశ్నలకి స్వాగతం పలుకుతుంది మరియు జ్ఞానం ఉచితంగా పంచుకునే సమర్థించే సమూహం. +మీరు అడ్డంకిలో పడితే లేదా AI యాప్‌లు నిర్మించడంపై ఏవైనా ప్రశ్నలు ఉంటే. MCP గురించి చర్చల్లో సహశిక్షణార్థులు మరియు అనుభవజ్ఞులైన డెవలపర్లతో చేరండి. ఇది ప్రశ్నలు స్వీకరించే, విజ్ఞానాన్ని స్వేచ్ఛగా పంచుకునే ఒక మద్దతుగల సంఘం. [![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) -మీకు ఉత్పత్తి ప్రతిస్పందన లేదా నిర్మిస్తున్న సమయంలో లోపాలు ఉంటే సందర్శించండి: +మీకు ఉత్పత్తి స్పందనలు లేదా నిర్మాణంలో లోపాలు ఉంటే సందర్శించండి: [![Microsoft Foundry Developer Forum](https://img.shields.io/badge/GitHub-Microsoft_Foundry_Developer_Forum-blue?style=for-the-badge&logo=github&color=000000&logoColor=fff)](https://aka.ms/foundry/forum) --- -**విమర్శన**: -ఈ పత్రాన్ని AI అనువాద సేవ [Co-op Translator](https://github.com/Azure/co-op-translator) ఉపయోగిస్తూ అనువదించబడింది. మేము సరిగా తర్జుమా చేయడానికి ప్రయత్నిస్తున్నప్పటికీ, ఆటోమేటెడ్ అనువాదాలలో పొరపాట్లు లేదా నిఖార్సైనత లేకపోవచ్చు. ఈ పత్రం الأصل భాషలో ఉన్నది మార్గదర్శకమైన వనరు గా పరిగణించాలి. అత్యవసర సమాచారం కోసం, వృత్తిపరమైన మానవ అనువాదం మంచిది. ఈ అనువాదం వలన ఏర్పడిన ఏ దోషమూ లేదా వికృత విశ్లేషణల కోసం మేము బాధ్యత కలిగి ఉండము. +**వివరణా సూచన**: +ఈ పత్రాన్ని AI అనువాద సేవ [Co-op Translator](https://github.com/Azure/co-op-translator) ఉపయోగించి అనువదింపబడింది. మేము ఖచ్చితత్వానికి శ్రద్ధ తీసుకుంటున్నా, ఆటోమేటెడ్ అనువాదాలలో పొరపాట్లు లేదా అసత్యతలు ఉండవచ్చు. అసలు పత్రం దాని మాతృభాషలో ఉన్నది అధికారిక వనరు అని పరిగణించాలి. అత్యవసర సమాచారానికి, వృత్తిపరమైన మానవ అనువాదం సూచించబడుతుంది. ఈ అనువాదం వల్ల నెలకొన్న ఏవైనా అవగాహనా లోపాలు లేదా తప్పుడు అర్థాలు కోసం మేము బాధ్యత వహించము. \ No newline at end of file diff --git a/translations/te/SECURITY.md b/translations/te/SECURITY.md index 7eac0e6b..308e3b28 100644 --- a/translations/te/SECURITY.md +++ b/translations/te/SECURITY.md @@ -1,12 +1,3 @@ - ## భద్రత మైక్రోసాఫ్ట్ మా సాఫ్ట్‌వేర్ ఉత్పత్తులు మరియు సేవల భద్రతను గౌరవంగా తీసుకుంటుంది, ఇందులో మా GitHub సంస్థల ద్వారా నిర్వహించబడే అన్ని సోర్స్ కోడ్ రిపోజిటరీలు ఉన్నాయి, వీటిలో [Microsoft](https://github.com/Microsoft), [Azure](https://github.com/Azure), [DotNet](https://github.com/dotnet), [AspNet](https://github.com/aspnet) మరియు [Xamarin](https://github.com/xamarin) ఉన్నాయి. diff --git a/translations/te/SUPPORT.md b/translations/te/SUPPORT.md index fde5d1ea..e2e2d651 100644 --- a/translations/te/SUPPORT.md +++ b/translations/te/SUPPORT.md @@ -1,12 +1,3 @@ - # మద్దతు ## సమస్యలను ఎలా ఫైల్ చేయాలి మరియు సహాయం పొందాలి diff --git a/translations/th/.co-op-translator.json b/translations/th/.co-op-translator.json new file mode 100644 index 00000000..48d98ab4 --- /dev/null +++ b/translations/th/.co-op-translator.json @@ -0,0 +1,92 @@ +{ + "01-IntroToGenAI/README.md": { + "original_hash": "75bfb080ca725e8a9aa9c80cae25fba1", + "translation_date": "2025-07-29T09:20:53+00:00", + "source_file": "01-IntroToGenAI/README.md", + "language_code": "th" + }, + "02-SetupDevEnvironment/README.md": { + "original_hash": "96a30d42b9751a3d4e4b20e28d29d459", + "translation_date": "2026-01-28T05:02:22+00:00", + "source_file": "02-SetupDevEnvironment/README.md", + "language_code": "th" + }, + "02-SetupDevEnvironment/examples/basic-chat-azure/README.md": { + "original_hash": "efd82efe50711d7e257eb943151d682c", + "translation_date": "2025-07-27T13:41:39+00:00", + "source_file": "02-SetupDevEnvironment/examples/basic-chat-azure/README.md", + "language_code": "th" + }, + "02-SetupDevEnvironment/getting-started-azure-openai.md": { + "original_hash": "bfdb4b4eadbee3a59ef742439f58326a", + "translation_date": "2025-07-27T13:11:32+00:00", + "source_file": "02-SetupDevEnvironment/getting-started-azure-openai.md", + "language_code": "th" + }, + "03-CoreGenerativeAITechniques/README.md": { + "original_hash": "685f55cb07de19b52a30ce6e8b6d889e", + "translation_date": "2025-08-28T22:07:06+00:00", + "source_file": "03-CoreGenerativeAITechniques/README.md", + "language_code": "th" + }, + "04-PracticalSamples/README.md": { + "original_hash": "14c0a61ecc1cd2012a9c129236dfdf71", + "translation_date": "2025-07-29T09:20:35+00:00", + "source_file": "04-PracticalSamples/README.md", + "language_code": "th" + }, + "04-PracticalSamples/calculator/README.md": { + "original_hash": "b6c16b5514d524e415a94f6097ee7d4c", + "translation_date": "2025-09-18T15:33:19+00:00", + "source_file": "04-PracticalSamples/calculator/README.md", + "language_code": "th" + }, + "04-PracticalSamples/foundrylocal/README.md": { + "original_hash": "f787307400de59adc25a1404466a35f3", + "translation_date": "2025-11-04T07:25:52+00:00", + "source_file": "04-PracticalSamples/foundrylocal/README.md", + "language_code": "th" + }, + "04-PracticalSamples/petstory/README.md": { + "original_hash": "0cbf68d605615a1e602c832a24616859", + "translation_date": "2025-07-25T11:28:04+00:00", + "source_file": "04-PracticalSamples/petstory/README.md", + "language_code": "th" + }, + "05-ResponsibleGenAI/README.md": { + "original_hash": "301c05c2f57e60a6950b8c665b8bdbba", + "translation_date": "2025-07-29T15:51:24+00:00", + "source_file": "05-ResponsibleGenAI/README.md", + "language_code": "th" + }, + "AGENTS.md": { + "original_hash": "afc90918d008cf77fd1982691f681306", + "translation_date": "2025-10-03T08:36:46+00:00", + "source_file": "AGENTS.md", + "language_code": "th" + }, + "CODE_OF_CONDUCT.md": { + "original_hash": "442b123d034f92f7c384d2bbd28f99f1", + "translation_date": "2025-07-21T19:08:10+00:00", + "source_file": "CODE_OF_CONDUCT.md", + "language_code": "th" + }, + "README.md": { + "original_hash": "125a08948d881c95628094f4dd1fbd43", + "translation_date": "2026-01-29T15:49:09+00:00", + "source_file": "README.md", + "language_code": "th" + }, + "SECURITY.md": { + "original_hash": "57f14126c1c6add76b3aef3844dfe4e3", + "translation_date": "2025-07-21T19:05:50+00:00", + "source_file": "SECURITY.md", + "language_code": "th" + }, + "SUPPORT.md": { + "original_hash": "b8ef73cc49dec68e2c885ee9df545129", + "translation_date": "2025-07-21T19:09:17+00:00", + "source_file": "SUPPORT.md", + "language_code": "th" + } +} \ No newline at end of file diff --git a/translations/th/01-IntroToGenAI/README.md b/translations/th/01-IntroToGenAI/README.md index 5a69b265..26b53e62 100644 --- a/translations/th/01-IntroToGenAI/README.md +++ b/translations/th/01-IntroToGenAI/README.md @@ -1,12 +1,3 @@ - # บทนำสู่ Generative AI - ฉบับภาษา Java ## สิ่งที่คุณจะได้เรียนรู้ diff --git a/translations/th/02-SetupDevEnvironment/README.md b/translations/th/02-SetupDevEnvironment/README.md index 935e401f..d89640df 100644 --- a/translations/th/02-SetupDevEnvironment/README.md +++ b/translations/th/02-SetupDevEnvironment/README.md @@ -1,13 +1,253 @@ - +# การตั้งค่าสภาพแวดล้อมการพัฒนาสำหรับ Generative AI สำหรับ Java +> **เริ่มต้นอย่างรวดเร็ว**: โค้ดในคลาวด์ใน 2 นาที - ข้ามไปที่ [การตั้งค่า GitHub Codespaces](../../../02-SetupDevEnvironment) - ไม่ต้องติดตั้งในเครื่องและใช้โมเดลของ github! + +> **สนใจ Azure OpenAI?**, ดู [คู่มือการตั้งค่า Azure OpenAI](getting-started-azure-openai.md) ของเราพร้อมขั้นตอนการสร้างทรัพยากร Azure OpenAI ใหม่ + +## สิ่งที่คุณจะได้เรียนรู้ + +- ตั้งค่าสภาพแวดล้อมการพัฒนา Java สำหรับแอปพลิเคชัน AI +- เลือกและกำหนดค่าสภาพแวดล้อมการพัฒนาที่คุณต้องการ (เน้นคลาวด์ด้วย Codespaces, dev container ในเครื่อง, หรือการตั้งค่าเต็มรูปแบบในเครื่อง) +- ทดสอบการตั้งค่าของคุณโดยการเชื่อมต่อกับ GitHub Models + +## สารบัญ + +- [สิ่งที่คุณจะได้เรียนรู้](../../../02-SetupDevEnvironment) +- [บทนำ](../../../02-SetupDevEnvironment) +- [ขั้นตอนที่ 1: ตั้งค่าสภาพแวดล้อมการพัฒนา](../../../02-SetupDevEnvironment) + - [ตัวเลือก A: GitHub Codespaces (แนะนำ)](../../../02-SetupDevEnvironment) + - [ตัวเลือก B: Local Dev Container](../../../02-SetupDevEnvironment) + - [ตัวเลือก C: ใช้การติดตั้งในเครื่องที่มีอยู่แล้ว](../../../02-SetupDevEnvironment) +- [ขั้นตอนที่ 2: สร้าง GitHub Personal Access Token](../../../02-SetupDevEnvironment) +- [ขั้นตอนที่ 3: ทดสอบการตั้งค่าของคุณ](../../../02-SetupDevEnvironment) +- [การแก้ไขปัญหา](../../../02-SetupDevEnvironment) +- [สรุป](../../../02-SetupDevEnvironment) +- [ขั้นตอนถัดไป](../../../02-SetupDevEnvironment) + +## บทนำ + +บทนี้จะแนะนำคุณผ่านการตั้งค่าสภาพแวดล้อมการพัฒนา เราจะใช้ **GitHub Models** เป็นตัวอย่างหลักของเราเพราะมันฟรี, ง่ายต่อการตั้งค่าด้วยแค่บัญชี GitHub, ไม่ต้องใช้บัตรเครดิต, และให้การเข้าถึงโมเดลหลายตัวสำหรับการทดลอง + +**ไม่ต้องติดตั้งในเครื่อง!** คุณสามารถเริ่มเขียนโค้ดได้ทันทีโดยใช้ GitHub Codespaces ซึ่งให้สภาพแวดล้อมการพัฒนาเต็มรูปแบบในเว็บเบราว์เซอร์ของคุณ + +Screenshot: GitHub Models + +เราแนะนำให้ใช้ [**GitHub Models**](https://github.com/marketplace?type=models) สำหรับคอร์สนี้เพราะว่า: +- **ฟรี** เริ่มต้นได้ทันที +- **ง่าย** ที่จะตั้งค่าด้วยเพียงบัญชี GitHub +- **ไม่ต้องใช้บัตรเครดิต** +- มี **โมเดลหลายตัว** สำหรับการทดลอง + +> **หมายเหตุ**: GitHub Models ที่ใช้ในการอบรมนี้มีข้อจำกัดฟรีดังนี้: +> - 15 คำขอต่อหนึ่งนาที (150 ต่อวัน) +> - ประมาณ 8,000 คำเข้า, 4,000 คำออกต่อคำขอ +> - 5 คำขอทำงานพร้อมกัน +> +> สำหรับการใช้งานจริง, อัปเกรดเป็น Azure AI Foundry Models ด้วยบัญชี Azure ของคุณ โค้ดของคุณไม่จำเป็นต้องเปลี่ยน ดูข้อมูลจาก [เอกสาร Azure AI Foundry](https://learn.microsoft.com/azure/ai-foundry/foundry-models/how-to/quickstart-github-models). + +## ขั้นตอนที่ 1: ตั้งค่าสภาพแวดล้อมการพัฒนา + + + +เราได้สร้าง dev container ที่กำหนดค่าไว้ล่วงหน้าเพื่อลดเวลาการตั้งค่าและให้แน่ใจว่าคุณมีเครื่องมือที่จำเป็นทั้งหมดสำหรับคอร์ส Generative AI สำหรับ Java นี้ เลือกวิธีการพัฒนาที่คุณต้องการ: + +### ตัวเลือกการตั้งค่าสภาพแวดล้อม: + +#### ตัวเลือก A: GitHub Codespaces (แนะนำ) + +**เริ่มเขียนโค้ดใน 2 นาที - ไม่ต้องติดตั้งในเครื่อง!** + +1. Fork รีโพซิทอรีนี้ไปยังบัญชี GitHub ของคุณ + > **หมายเหตุ**: หากคุณต้องการแก้ไขการตั้งค่าพื้นฐาน กรุณาดูที่ [Dev Container Configuration](../../../.devcontainer/devcontainer.json) +2. คลิก **Code** → แท็บ **Codespaces** → **...** → **New with options...** +3. ใช้ค่าดีฟอลต์ – ซึ่งจะเลือก **การกำหนดค่า Dev container**: **Generative AI Java Development Environment** devcontainer ที่สร้างขึ้นสำหรับคอร์สนี้โดยเฉพาะ +4. คลิก **Create codespace** +5. รอประมาณ 2 นาทีให้สภาพแวดล้อมพร้อมใช้งาน +6. ดำเนินการต่อไปที่ [ขั้นตอนที่ 2: สร้าง GitHub Token](../../../02-SetupDevEnvironment) + +Screenshot: Codespaces submenu + +Screenshot: New with options + +Screenshot: Create codespace options + + +> **ข้อดีของ Codespaces**: +> - ไม่ต้องติดตั้งในเครื่อง +> - ใช้งานได้กับอุปกรณ์ใดก็ได้ที่มีเว็บเบราว์เซอร์ +> - ตั้งค่าล่วงหน้าพร้อมเครื่องมือและการพึ่งพาทั้งหมด +> - ฟรี 60 ชั่วโมงต่อเดือนสำหรับบัญชีส่วนตัว +> - สภาพแวดล้อมที่สม่ำเสมอสำหรับผู้เรียนทุกคน + +#### ตัวเลือก B: Local Dev Container + +**สำหรับนักพัฒนาที่ต้องการพัฒนาในเครื่องด้วย Docker** + +1. Fork และโคลนรีโพซิทอรีนี้ไปยังเครื่องของคุณ + > **หมายเหตุ**: หากคุณต้องการแก้ไขการตั้งค่าพื้นฐาน กรุณาดูที่ [Dev Container Configuration](../../../.devcontainer/devcontainer.json) +2. ติดตั้ง [Docker Desktop](https://www.docker.com/products/docker-desktop/) และ [VS Code](https://code.visualstudio.com/) +3. ติดตั้งส่วนขยาย [Dev Containers extension](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers) ใน VS Code +4. เปิดโฟลเดอร์รีโพซิทอรีใน VS Code +5. เมื่อมีคำถาม ให้คลิก **Reopen in Container** (หรือใช้ `Ctrl+Shift+P` → "Dev Containers: Reopen in Container") +6. รอให้ container สร้างและเริ่มทำงาน +7. ดำเนินการต่อไปที่ [ขั้นตอนที่ 2: สร้าง GitHub Token](../../../02-SetupDevEnvironment) + +Screenshot: Dev container setup + +Screenshot: Dev container build complete + +#### ตัวเลือก C: ใช้การติดตั้งในเครื่องที่มีอยู่แล้ว + +**สำหรับนักพัฒนาที่มีสภาพแวดล้อม Java อยู่แล้ว** + +สิ่งที่ต้องมี: +- [Java 21+](https://www.oracle.com/java/technologies/javase/jdk21-archive-downloads.html) +- [Maven 3.9+](https://maven.apache.org/download.cgi) +- [VS Code](https://code.visualstudio.com) หรือ IDE ที่คุณชอบ + +ขั้นตอน: +1. โคลนรีโพซิทอรีนี้ไปยังเครื่องของคุณ +2. เปิดโปรเจคใน IDE ของคุณ +3. ดำเนินการต่อไปที่ [ขั้นตอนที่ 2: สร้าง GitHub Token](../../../02-SetupDevEnvironment) + +> **เคล็ดลับมือโปร**: หากเครื่องคุณสเปคต่ำแต่ต้องการใช้ VS Code ในเครื่อง ให้ใช้ GitHub Codespaces! คุณสามารถเชื่อมต่อ VS Code ในเครื่องกับ Codespace ที่โฮสต์ในคลาวด์เพื่อรวมข้อดีทั้งสองด้าน + +Screenshot: created local devcontainer instance + + +## ขั้นตอนที่ 2: สร้าง GitHub Personal Access Token + +1. ไปที่ [GitHub Settings](https://github.com/settings/profile) และเลือก **Settings** จากเมนูโปรไฟล์ของคุณ +2. ในแถบด้านซ้าย คลิก **Developer settings** (มักอยู่ด้านล่าง) +3. ภายใต้ **Personal access tokens** คลิก **Fine-grained tokens** (หรือใช้ลิงก์ตรงนี้ [link](https://github.com/settings/personal-access-tokens)) +4. คลิก **Generate new token** +5. ใต้ "Token name" ใส่ชื่อที่อธิบายได้ (เช่น `GenAI-Java-Course-Token`) +6. ตั้งวันหมดอายุ (แนะนำ: 7 วันเพื่อความปลอดภัย) +7. ใต้ "Resource owner" เลือกบัญชีผู้ใช้ของคุณ +8. ใต้ "Repository access" เลือกรีโพซิทอรีที่คุณต้องการใช้กับ GitHub Models (หรือเลือก "All repositories" หากจำเป็น) +9. ใต้ "Account permissions" หาหัวข้อ **Models** และตั้งเป็น **Read-only** +10. คลิก **Generate token** +11. **คัดลอกและบันทึกโทเค็นของคุณตอนนี้** – คุณจะไม่เห็นมันอีก! + +> **คำแนะนำด้านความปลอดภัย**: ใช้ขอบเขตน้อยที่สุดที่จำเป็นและตั้งเวลาหมดอายุสั้นที่สุดที่เหมาะสมสำหรับโทเค็นของคุณ + +## ขั้นตอนที่ 3: ทดสอบการตั้งค่าของคุณด้วยตัวอย่าง GitHub Models + +เมื่อสภาพแวดล้อมการพัฒนาของคุณพร้อมแล้ว มาลองทดสอบการเชื่อมต่อ GitHub Models ด้วยแอปพลิเคชันตัวอย่างใน [`02-SetupDevEnvironment/examples/github-models`](../../../02-SetupDevEnvironment/examples/github-models). + +1. เปิดเทอร์มินัลในสภาพแวดล้อมพัฒนาของคุณ +2. ไปยังตัวอย่าง GitHub Models: + ```bash + cd 02-SetupDevEnvironment/examples/github-models + ``` +3. ตั้งค่า GitHub token ของคุณเป็นตัวแปรสภาพแวดล้อม: + ```bash + # macOS/Linux + export GITHUB_TOKEN=your_token_here + + # Windows (พรอมต์คำสั่ง) + set GITHUB_TOKEN=your_token_here + + # Windows (PowerShell) + $env:GITHUB_TOKEN="your_token_here" + ``` + +4. รันแอปพลิเคชัน: + ```bash + mvn compile exec:java -Dexec.mainClass="com.example.githubmodels.App" + ``` + +คุณควรเห็นผลลัพธ์คล้ายกับ: +```text +Using model: gpt-4.1-nano +Sending request to GitHub Models... +Response: Hello World! +``` + +### ทำความเข้าใจโค้ดตัวอย่าง + +ก่อนอื่น ให้เข้าใจสิ่งที่เราเพิ่งรัน ตัวอย่างในโฟลเดอร์ `examples/github-models` ใช้ OpenAI Java SDK เพื่อเชื่อมต่อกับ GitHub Models: + +**สิ่งที่โค้ดนี้ทำ:** +- **เชื่อมต่อ** กับ GitHub Models โดยใช้ personal access token ของคุณ +- **ส่ง** ข้อความง่ายๆ "Say Hello World!" ไปยังโมเดล AI +- **รับ** และแสดงการตอบกลับจาก AI +- **ตรวจสอบ** ว่าการตั้งค่าของคุณทำงานถูกต้อง + +**ไลบรารีหลัก** (ใน `pom.xml`): +```xml + + com.openai + openai-java + 2.12.0 + +``` + +**โค้ดหลัก** (`App.java`): +```java +// เชื่อมต่อกับโมเดล GitHub โดยใช้ OpenAI Java SDK +OpenAIClient client = OpenAIOkHttpClient.builder() + .apiKey(pat) + .baseUrl("https://models.inference.ai.azure.com") + .build(); + +// สร้างคำขอการสนทนาเสร็จสิ้น +ChatCompletionCreateParams params = ChatCompletionCreateParams.builder() + .model(modelId) + .addSystemMessage("You are a concise assistant.") + .addUserMessage("Say Hello World!") + .build(); + +// รับการตอบกลับจาก AI +ChatCompletion response = client.chat().completions().create(params); +System.out.println("Response: " + response.choices().get(0).message().content().orElse("No response content")); +``` + +## สรุป + +เยี่ยม! ตอนนี้คุณได้ตั้งค่าทุกอย่างเรียบร้อยแล้ว: + +- สร้าง GitHub Personal Access Token ที่มีสิทธิ์เหมาะสมสำหรับการเข้าถึงโมเดล AI +- เปิดใช้งานสภาพแวดล้อมการพัฒนา Java (ไม่ว่าจะเป็น Codespaces, dev container หรือแบบติดตั้งในเครื่อง) +- เชื่อมต่อกับ GitHub Models โดยใช้ OpenAI Java SDK สำหรับการพัฒนา AI ฟรี +- ทดสอบทุกอย่างทำงานได้ด้วยตัวอย่างง่ายๆ ที่สื่อสารกับโมเดล AI + +## ขั้นตอนถัดไป + +[บทที่ 3: เทคนิคหลักของ Generative AI](../03-CoreGenerativeAITechniques/README.md) + +## การแก้ไขปัญหา + +พบปัญหาหรือไม่? นี่คือปัญหาทั่วไปและวิธีแก้: + +- **โทเค็นไม่ทำงาน?** + - ตรวจสอบว่าคุณคัดลอกโทเค็นทั้งหมด ไม่มีช่องว่างเกิน + - ตรวจสอบว่าโทเค็นถูกตั้งเป็นตัวแปรสภาพแวดล้อมอย่างถูกต้อง + - ตรวจสอบว่าโทเค็นของคุณมีสิทธิ์ถูกต้อง (Models: Read-only) + +- **หา Maven ไม่เจอ?** + - หากใช้ dev containers/Codespaces, Maven ควรติดตั้งมาแล้ว + - สำหรับการตั้งค่าในเครื่อง, ให้แน่ใจว่าติดตั้ง Java 21+ และ Maven 3.9+ แล้ว + - ลองใช้คำสั่ง `mvn --version` เพื่อตรวจสอบการติดตั้ง + +- **ปัญหาการเชื่อมต่อ?** + - ตรวจสอบการเชื่อมต่ออินเทอร์เน็ตของคุณ + - ยืนยันว่า GitHub เข้าถึงได้จากเครือข่ายของคุณ + - ให้แน่ใจว่าคุณไม่ได้อยู่หลังไฟร์วอลล์ที่บล็อก endpoint ของ GitHub Models + +- **Dev container ไม่เริ่ม?** + - ตรวจสอบว่า Docker Desktop ทำงานอยู่ (สำหรับการพัฒนาในเครื่อง) + - ลองสร้าง container ใหม่: `Ctrl+Shift+P` → "Dev Containers: Rebuild Container" + +- **ข้อผิดพลาดในการคอมไพล์แอปฯ?** + - ตรวจสอบว่าคุณอยู่ในไดเรกทอรีถูกต้อง: `02-SetupDevEnvironment/examples/github-models` + - ลองทำความสะอาดและคอมไพล์ใหม่: `mvn clean compile` + +> **ต้องการความช่วยเหลือ?**: หากยังมีปัญหา แสดงปัญหาในรีโพซิทอรีและเราจะช่วยคุณเอง. --- + +**ข้อจำกัดความรับผิดชอบ**: +เอกสารฉบับนี้ถูกแปลโดยใช้บริการแปลภาษาอัตโนมัติ [Co-op Translator](https://github.com/Azure/co-op-translator) แม้เราจะพยายามให้ความถูกต้องสูงสุด โปรดทราบว่าการแปลอัตโนมัติอาจมีข้อผิดพลาดหรือความไม่ถูกต้อง เอกสารต้นฉบับในภาษาต้นทางควรถูกพิจารณาเป็นแหล่งข้อมูลที่เชื่อถือได้ สำหรับข้อมูลที่สำคัญ ขอแนะนำให้ใช้บริการแปลโดยมืออาชีพที่เป็นมนุษย์ เราจะไม่รับผิดชอบต่อความเข้าใจผิดหรือการตีความที่ผิดพลาดใดๆ ที่เกิดจากการใช้การแปลนี้ + \ No newline at end of file diff --git a/translations/th/02-SetupDevEnvironment/examples/basic-chat-azure/README.md b/translations/th/02-SetupDevEnvironment/examples/basic-chat-azure/README.md index fa33e8a6..95fc3fe7 100644 --- a/translations/th/02-SetupDevEnvironment/examples/basic-chat-azure/README.md +++ b/translations/th/02-SetupDevEnvironment/examples/basic-chat-azure/README.md @@ -1,12 +1,3 @@ - # ตัวอย่างการแชทพื้นฐานกับ Azure OpenAI - ตั้งแต่ต้นจนจบ ตัวอย่างนี้แสดงวิธีสร้างแอปพลิเคชัน Spring Boot แบบง่ายที่เชื่อมต่อกับ Azure OpenAI และทดสอบการตั้งค่าของคุณ diff --git a/translations/th/02-SetupDevEnvironment/getting-started-azure-openai.md b/translations/th/02-SetupDevEnvironment/getting-started-azure-openai.md index a0e3c803..dc39a700 100644 --- a/translations/th/02-SetupDevEnvironment/getting-started-azure-openai.md +++ b/translations/th/02-SetupDevEnvironment/getting-started-azure-openai.md @@ -1,12 +1,3 @@ - # การตั้งค่าสภาพแวดล้อมการพัฒนาสำหรับ Azure OpenAI > **เริ่มต้นอย่างรวดเร็ว**: คู่มือนี้สำหรับการตั้งค่า Azure OpenAI หากต้องการเริ่มต้นใช้งานโมเดลฟรีทันที ให้ใช้ [GitHub Models with Codespaces](./README.md#quick-start-cloud) diff --git a/translations/th/03-CoreGenerativeAITechniques/README.md b/translations/th/03-CoreGenerativeAITechniques/README.md index 35fe248f..ac08d6a7 100644 --- a/translations/th/03-CoreGenerativeAITechniques/README.md +++ b/translations/th/03-CoreGenerativeAITechniques/README.md @@ -1,12 +1,3 @@ - # บทเรียนเทคนิคพื้นฐานของ Generative AI ## สารบัญ diff --git a/translations/th/04-PracticalSamples/README.md b/translations/th/04-PracticalSamples/README.md index 8f4b1b30..1cc31ef5 100644 --- a/translations/th/04-PracticalSamples/README.md +++ b/translations/th/04-PracticalSamples/README.md @@ -1,12 +1,3 @@ - # การประยุกต์ใช้งานและโปรเจกต์จริง ## สิ่งที่คุณจะได้เรียนรู้ diff --git a/translations/th/04-PracticalSamples/calculator/README.md b/translations/th/04-PracticalSamples/calculator/README.md index 1a1ffe80..67dbe899 100644 --- a/translations/th/04-PracticalSamples/calculator/README.md +++ b/translations/th/04-PracticalSamples/calculator/README.md @@ -1,12 +1,3 @@ - # บทแนะนำ MCP Calculator สำหรับผู้เริ่มต้น ## สารบัญ diff --git a/translations/th/04-PracticalSamples/foundrylocal/README.md b/translations/th/04-PracticalSamples/foundrylocal/README.md index 2eecb62a..8b4f0c20 100644 --- a/translations/th/04-PracticalSamples/foundrylocal/README.md +++ b/translations/th/04-PracticalSamples/foundrylocal/README.md @@ -1,12 +1,3 @@ - # คู่มือการใช้งาน Foundry Local Spring Boot ## สารบัญ diff --git a/translations/th/04-PracticalSamples/petstory/README.md b/translations/th/04-PracticalSamples/petstory/README.md index 7dfff6b9..4ff46cf1 100644 --- a/translations/th/04-PracticalSamples/petstory/README.md +++ b/translations/th/04-PracticalSamples/petstory/README.md @@ -1,12 +1,3 @@ - # คู่มือการใช้งาน Pet Story Generator สำหรับผู้เริ่มต้น ## สารบัญ diff --git a/translations/th/05-ResponsibleGenAI/README.md b/translations/th/05-ResponsibleGenAI/README.md index 573802af..7100ef95 100644 --- a/translations/th/05-ResponsibleGenAI/README.md +++ b/translations/th/05-ResponsibleGenAI/README.md @@ -1,12 +1,3 @@ - # การพัฒนา Generative AI อย่างมีความรับผิดชอบ ## สิ่งที่คุณจะได้เรียนรู้ diff --git a/translations/th/AGENTS.md b/translations/th/AGENTS.md index 55a25db2..d5980ef1 100644 --- a/translations/th/AGENTS.md +++ b/translations/th/AGENTS.md @@ -1,12 +1,3 @@ - # AGENTS.md ## ภาพรวมของโปรเจกต์ diff --git a/translations/th/CODE_OF_CONDUCT.md b/translations/th/CODE_OF_CONDUCT.md index a96e713c..7333050e 100644 --- a/translations/th/CODE_OF_CONDUCT.md +++ b/translations/th/CODE_OF_CONDUCT.md @@ -1,12 +1,3 @@ - # หลักจรรยาบรรณของโค้ดโอเพ่นซอร์สของ Microsoft โครงการนี้ได้นำ [หลักจรรยาบรรณของโค้ดโอเพ่นซอร์สของ Microsoft](https://opensource.microsoft.com/codeofconduct/) มาใช้ diff --git a/translations/th/README.md b/translations/th/README.md index 45ab35ed..d68bb608 100644 --- a/translations/th/README.md +++ b/translations/th/README.md @@ -1,129 +1,120 @@ - -# Generative AI สำหรับผู้เริ่มต้น - ฉบับ Java +# ปัญญาประดิษฐ์สร้างสรรค์สำหรับผู้เริ่มต้น - รุ่น Java [![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) -![Generative AI สำหรับผู้เริ่มต้น - ฉบับ Java](../../translated_images/th/beg-genai-series.8b48be9951cc574c.webp) +![Generative AI for Beginners - Java Edition](../../translated_images/th/beg-genai-series.8b48be9951cc574c.webp) -**เวลาที่ใช้**: เวิร์กช็อปทั้งหมดสามารถทำได้ออนไลน์โดยไม่ต้องตั้งค่าท้องถิ่น การตั้งค่าสภาพแวดล้อมใช้เวลา 2 นาที โดยการสำรวจตัวอย่างใช้เวลาประมาณ 1-3 ชั่วโมงขึ้นอยู่กับความลึกของการสำรวจ +**เวลาที่ใช้**: เวิร์กช็อปทั้งหมดสามารถทำออนไลน์ได้โดยไม่ต้องติดตั้งท้องถิ่น การตั้งค่าสภาพแวดล้อมใช้เวลา 2 นาที และการสำรวจตัวอย่างต้องใช้เวลา 1-3 ชั่วโมงขึ้นอยู่กับความลึกในการสำรวจ > **เริ่มต้นอย่างรวดเร็ว** -1. Fork รีโพสitory นี้ไปยังบัญชี GitHub ของคุณ -2. คลิก **Code** → แถบ **Codespaces** → **...** → **New with options...** -3. ใช้ค่าเริ่มต้น – ระบบจะเลือกคอนเทนเนอร์สำหรับการพัฒนาที่สร้างไว้สำหรับคอร์สนี้ -4. คลิก **Create codespace** -5. รอประมาณ 2 นาทีจนกว่าสภาพแวดล้อมจะพร้อมใช้งาน -6. ไปที่ [ตัวอย่างแรก](./02-SetupDevEnvironment/README.md#step-2-create-a-github-personal-access-token) ได้เลย +1. สร้าง Fork ของที่เก็บนี้ในบัญชี GitHub ของคุณ +2. คลิก **Code** → แท็บ **Codespaces** → **...** → **New with options...** +3. ใช้ค่าเริ่มต้น – ซึ่งจะเลือก Development container ที่สร้างขึ้นสำหรับหลักสูตรนี้ +4. คลิก **Create codespace** +5. รอประมาณ 2 นาทีเพื่อให้สภาพแวดล้อมพร้อมใช้งาน +6. ข้ามไปที่ [ตัวอย่างแรก](./02-SetupDevEnvironment/README.md#step-2-create-a-github-personal-access-token) -> **ต้องการโคลนแบบโลคัลไหม?** -> -> รีโพสitory นี้มีการแปลภาษา 50+ ภาษา ซึ่งทำให้ขนาดดาวน์โหลดใหญ่ขึ้นมาก หากต้องการโคลนโดยไม่รวมการแปลภาษา ใช้ sparse checkout: +> **ต้องการโคลนไปที่เครื่องของคุณแทน?** +> +> ที่เก็บนี้มีการแปลภาษากว่า 50 ภาษา ซึ่งเพิ่มขนาดการดาวน์โหลดอย่างมาก หากต้องการโคลนโดยไม่รวมแปลภาษานั้น ให้ใช้ sparse checkout: > ```bash > git clone --filter=blob:none --sparse https://github.com/microsoft/Generative-AI-for-beginners-java.git > cd Generative-AI-for-beginners-java > git sparse-checkout set --no-cone '/*' '!translations' '!translated_images' > ``` -> วิธีนี้จะให้ทุกอย่างที่คุณต้องใช้เพื่อทำคอร์สให้เสร็จอย่างรวดเร็วมากขึ้น +> วิธีนี้จะให้ทุกอย่างที่คุณต้องการเพื่อจบหลักสูตรด้วยการดาวน์โหลดที่เร็วขึ้นมาก - -## รองรับหลายภาษา +## การรองรับหลายภาษา ### รองรับผ่าน GitHub Action (อัตโนมัติ & อัปเดตตลอดเวลา) -[อาหรับ](../ar/README.md) | [เบงกาลี](../bn/README.md) | [บัลแกเรีย](../bg/README.md) | [พม่า (เมียนมา)](../my/README.md) | [จีน (ตัวย่อ)](../zh/README.md) | [จีน (ตัวเต็ม, ฮ่องกง)](../hk/README.md) | [จีน (ตัวเต็ม, มาเก๊า)](../mo/README.md) | [จีน (ตัวเต็ม, ไต้หวัน)](../tw/README.md) | [โครเอเชีย](../hr/README.md) | [เช็ก](../cs/README.md) | [เดนมาร์ก](../da/README.md) | [ดัตช์](../nl/README.md) | [เอสโตเนีย](../et/README.md) | [ฟินแลนด์](../fi/README.md) | [ฝรั่งเศส](../fr/README.md) | [เยอรมัน](../de/README.md) | [กรีก](../el/README.md) | [ฮิบรู](../he/README.md) | [ฮินดี](../hi/README.md) | [ฮังการี](../hu/README.md) | [อินโดนีเซีย](../id/README.md) | [อิตาลี](../it/README.md) | [ญี่ปุ่น](../ja/README.md) | [กันนาดา](../kn/README.md) | [เกาหลี](../ko/README.md) | [ลิทัวเนีย](../lt/README.md) | [มาเลย์](../ms/README.md) | [มาลายาลัม](../ml/README.md) | [มราษฏร์](../mr/README.md) | [เนปาล](../ne/README.md) | [ไนจีเรีย พิดจิน](../pcm/README.md) | [นอร์เวย์](../no/README.md) | [เปอร์เซีย (ฟาร์ซี)](../fa/README.md) | [โปแลนด์](../pl/README.md) | [โปรตุเกส (บราซิล)](../br/README.md) | [โปรตุเกส (โปรตุเกส)](../pt/README.md) | [ปัญจาบี (กูรมุขี)](../pa/README.md) | [โรมาเนีย](../ro/README.md) | [รัสเซีย](../ru/README.md) | [เซอร์เบีย (ซีริลลิก)](../sr/README.md) | [สโลวัก](../sk/README.md) | [สโลวีเนีย](../sl/README.md) | [สเปน](../es/README.md) | [สวาฮีลี](../sw/README.md) | [สวีเดน](../sv/README.md) | [ตากาล็อก (ฟิลิปปินส์)](../tl/README.md) | [ทมิฬ](../ta/README.md) | [เทลูกู](../te/README.md) | [ไทย](./README.md) | [ตุรกี](../tr/README.md) | [ยูเครน](../uk/README.md) | [อูรดู](../ur/README.md) | [เวียดนาม](../vi/README.md) +[ภาษาอาหรับ](../ar/README.md) | [ภาษาเบงกาลี](../bn/README.md) | [ภาษาบัลแกเรีย](../bg/README.md) | [ภาษาพม่า (เมียนมาร์)](../my/README.md) | [ภาษาจีน (ตัวย่อ)](../zh-CN/README.md) | [ภาษาจีน (ตัวเต็ม, ฮ่องกง)](../zh-HK/README.md) | [ภาษาจีน (ตัวเต็ม, มาเก๊า)](../zh-MO/README.md) | [ภาษาจีน (ตัวเต็ม, ไต้หวัน)](../zh-TW/README.md) | [ภาษาโครเอเชีย](../hr/README.md) | [ภาษาเช็ก](../cs/README.md) | [ภาษาเดนมาร์ก](../da/README.md) | [ภาษาดัตช์](../nl/README.md) | [ภาษาเอสโตเนีย](../et/README.md) | [ภาษาฟินแลนด์](../fi/README.md) | [ภาษาฝรั่งเศส](../fr/README.md) | [ภาษาเยอรมัน](../de/README.md) | [ภาษากรีก](../el/README.md) | [ภาษาฮีบรู](../he/README.md) | [ภาษาฮินดี](../hi/README.md) | [ภาษาฮังกาเรียน](../hu/README.md) | [ภาษาอินโดนีเซีย](../id/README.md) | [ภาษาอิตาลี](../it/README.md) | [ภาษาญี่ปุ่น](../ja/README.md) | [ภาษากันนาดา](../kn/README.md) | [ภาษาเกาหลี](../ko/README.md) | [ภาษาลิทัวเนีย](../lt/README.md) | [ภาษามาเลย์](../ms/README.md) | [ภาษามาลายาลัม](../ml/README.md) | [ภาษามราฐี](../mr/README.md) | [ภาษาเนปาล](../ne/README.md) | [ภาษาไนจีเรียพิดจิน](../pcm/README.md) | [ภาษานอร์เวย์](../no/README.md) | [ภาษาเปอร์เซีย (ฟาร์ซี)](../fa/README.md) | [ภาษาโพแลนด์](../pl/README.md) | [ภาษาโปรตุเกส (บราซิล)](../pt-BR/README.md) | [ภาษาโปรตุเกส (โปรตุเกส)](../pt-PT/README.md) | [ภาษาปัญจาบี (กูรมุกขิ)](../pa/README.md) | [ภาษาโรมาเนีย](../ro/README.md) | [ภาษารัสเซีย](../ru/README.md) | [ภาษาเซอร์เบียน (อักษรซีริลลิก)](../sr/README.md) | [ภาษา สโลวัก](../sk/README.md) | [ภาษา สโลเวเนีย](../sl/README.md) | [ภาษาสเปน](../es/README.md) | [ภาษาสวาฮิลี](../sw/README.md) | [ภาษาสวีเดน](../sv/README.md) | [ภาษา ตากาล็อก (ฟิลิปปินส์)](../tl/README.md) | [ภาษาทมิฬ](../ta/README.md) | [ภาษาเทลูกู](../te/README.md) | [ภาษาไทย](./README.md) | [ภาษาตุรกี](../tr/README.md) | [ภาษา ยูเครน](../uk/README.md) | [ภาษาอูรดู](../ur/README.md) | [ภาษาเวียดนาม](../vi/README.md) -> **ต้องการโคลนแบบโลคัลไหม?** +> **ต้องการโคลนไปที่เครื่องของคุณแทน?** -> รีโพสitory นี้มีการแปลภาษา 50+ ภาษา ซึ่งทำให้ขนาดดาวน์โหลดใหญ่ขึ้นมาก หากต้องการโคลนโดยไม่รวมการแปลภาษา ใช้ sparse checkout: +> ที่เก็บนี้มีการแปลภาษากว่า 50 ภาษา ซึ่งเพิ่มขนาดการดาวน์โหลดอย่างมาก หากต้องการโคลนโดยไม่รวมแปลภาษานั้น ให้ใช้ sparse checkout: > ```bash > git clone --filter=blob:none --sparse https://github.com/microsoft/Generative-AI-for-beginners-java.git > cd Generative-AI-for-beginners-java > git sparse-checkout set --no-cone '/*' '!translations' '!translated_images' > ``` -> วิธีนี้จะให้ทุกอย่างที่คุณต้องใช้เพื่อทำคอร์สให้เสร็จอย่างรวดเร็วมากขึ้น +> วิธีนี้จะให้ทุกอย่างที่คุณต้องการเพื่อจบหลักสูตรด้วยการดาวน์โหลดที่เร็วขึ้นมาก -## โครงสร้างคอร์ส & เส้นทางการเรียนรู้ +## โครงสร้างหลักสูตร & เส้นทางการเรียนรู้ -### **บทที่ 1: บทนำสู่ Generative AI** -- **แนวคิดหลัก**: ทำความเข้าใจโมเดลภาษาใหญ่ tokens, embeddings และความสามารถของ AI -- **ระบบนิเวศ AI ของ Java**: ภาพรวม Spring AI และ OpenAI SDKs -- **โปรโตคอลบริบทของโมเดล**: แนะนำ MCP และบทบาทในการสื่อสารของตัวแทน AI -- **การใช้งานที่เป็นประโยชน์**: สถานการณ์จริงรวมถึงแชทบอทและการสร้างเนื้อหา +### **บทที่ 1: แนะนำปัญญาประดิษฐ์สร้างสรรค์** +- **แนวคิดหลัก**: เข้าใจโมเดลภาษาขนาดใหญ่, โทเค็น, embedding และความสามารถของ AI +- **ระบบนิเวศ AI ของ Java**: ภาพรวม Spring AI และ OpenAI SDK +- **โปรโตคอล Model Context**: แนะนำ MCP และบทบาทในการสื่อสารของตัวแทน AI +- **การประยุกต์ใช้งานจริง**: สถานการณ์จริง เช่น แชทบ็อตและการสร้างเนื้อหา - **[→ เริ่มบทที่ 1](./01-IntroToGenAI/README.md)** -### **บทที่ 2: การตั้งค่าสภาพแวดล้อมการพัฒนา** -- **การตั้งค่าหลายผู้ให้บริการ**: ตั้งค่า GitHub Models, Azure OpenAI และ OpenAI Java SDK integrations -- **Spring Boot + Spring AI**: แนวทางปฏิบัติที่ดีที่สุดสำหรับการพัฒนาแอป AI สำหรับองค์กร -- **GitHub Models**: โมเดล AI ฟรีสำหรับการสร้างต้นแบบและการเรียนรู้ (ไม่ต้องใช้บัตรเครดิต) -- **เครื่องมือพัฒนา**: คอนเทนเนอร์ Docker, VS Code, และการตั้งค่า GitHub Codespaces +### **บทที่ 2: การตั้งค่าสภาพแวดล้อมพัฒนา** +- **การกำหนดค่าผู้ให้บริการหลายราย**: ตั้งค่า GitHub Models, Azure OpenAI, และ OpenAI Java SDK +- **Spring Boot + Spring AI**: แนวปฏิบัติที่ดีที่สุดสำหรับการพัฒนา AI ในองค์กร +- **GitHub Models**: เข้าถึงโมเดล AI ฟรีสำหรับต้นแบบและการเรียนรู้ (ไม่ต้องใช้บัตรเครดิต) +- **เครื่องมือพัฒนา**: Docker containers, VS Code, และ GitHub Codespaces - **[→ เริ่มบทที่ 2](./02-SetupDevEnvironment/README.md)** -### **บทที่ 3: เทคนิค Generative AI หลัก** -- **Prompt Engineering**: เทคนิคสำหรับคำตอบโมเดล AI ที่ดีที่สุด -- **Embeddings & การดำเนินการเวกเตอร์**: นำไปใช้การค้นหาเชิงความหมายและการจับคู่ความคล้ายคลึง -- **Retrieval-Augmented Generation (RAG)**: รวม AI กับแหล่งข้อมูลของคุณเอง -- **Function Calling**: ขยายความสามารถ AI ด้วยเครื่องมือและปลั๊กอินที่กำหนดเอง +### **บทที่ 3: เทคนิคหลักของปัญญาประดิษฐ์สร้างสรรค์** +- **วิศวกรรมพรอมต์**: เทคนิคสำหรับตอบสนองที่ดีที่สุดจากโมเดล AI +- **Embeddings & การดำเนินการเวกเตอร์**: นำไปใช้ในการค้นหาเชิงความหมายและการจับคู่ความคล้ายคลึง +- **การสร้างโดยเสริมการดึงข้อมูล (RAG)**: ผสมผสาน AI กับแหล่งข้อมูลของคุณเอง +- **การเรียกฟังก์ชัน**: ขยายความสามารถของ AI ด้วยเครื่องมือและปลั๊กอินที่กำหนดเอง - **[→ เริ่มบทที่ 3](./03-CoreGenerativeAITechniques/README.md)** -### **บทที่ 4: การประยุกต์ใช้งานและโปรเจกต์** -- **Pet Story Generator** (`petstory/`): สร้างเนื้อหาเชิงสร้างสรรค์ด้วย GitHub Models -- **Foundry Local Demo** (`foundrylocal/`): การรวมโมเดล AI แบบโลคัลด้วย OpenAI Java SDK -- **MCP Calculator Service** (`calculator/`): การใช้งาน Model Context Protocol เบื้องต้นด้วย Spring AI +### **บทที่ 4: การประยุกต์ใช้งานและโปรเจกต์** +- **ผู้สร้างเรื่องราวสัตว์เลี้ยง** (`petstory/`): สร้างเนื้อหาอย่างสร้างสรรค์ด้วย GitHub Models +- **เดโม Foundry Local** (`foundrylocal/`): การเชื่อมต่อโมเดล AI ท้องถิ่นด้วย OpenAI Java SDK +- **บริการเครื่องคิดเลข MCP** (`calculator/`): การใช้งาน Model Context Protocol พื้นฐานด้วย Spring AI - **[→ เริ่มบทที่ 4](./04-PracticalSamples/README.md)** -### **บทที่ 5: การพัฒนา AI อย่างรับผิดชอบ** -- **ความปลอดภัย GitHub Models**: ทดสอบฟิลเตอร์เนื้อหาและกลไกความปลอดภัยในตัว (บล็อกเข้มงวดและการปฏิเสธนุ่มนวล) -- **เดโม AI อย่างรับผิดชอบ**: ตัวอย่างใช้งานจริงแสดงให้เห็นว่าระบบความปลอดภัยของ AI สมัยใหม่ทำงานอย่างไร -- **แนวทางปฏิบัติที่ดีที่สุด**: แนวทางสำคัญสำหรับการพัฒนาและเผยแพร่ AI อย่างมีจริยธรรม +### **บทที่ 5: การพัฒนา AI ที่รับผิดชอบ** +- **ความปลอดภัย GitHub Models**: ทดสอบฟิลเตอร์เนื้อหาและกลไกความปลอดภัยในตัว (บล็อกแน่นและปฏิเสธนุ่มนวล) +- **เดโม AI ที่รับผิดชอบ**: ตัวอย่างการใช้งานระบบความปลอดภัย AI สมัยใหม่ในทางปฏิบัติ +- **แนวปฏิบัติที่ดีที่สุด**: แนวทางสำคัญสำหรับการพัฒนาและใช้งาน AI อย่างมีจริยธรรม - **[→ เริ่มบทที่ 5](./05-ResponsibleGenAI/README.md)** -## แหล่งข้อมูลเพิ่มเติม +## ทรัพยากรเพิ่มเติม -### LangChain -[![LangChain4j สำหรับผู้เริ่มต้น](https://img.shields.io/badge/LangChain4j%20for%20Beginners-22C55E?style=for-the-badge&&labelColor=E5E7EB&color=0553D6)](https://aka.ms/langchain4j-for-beginners) -[![LangChain.js สำหรับผู้เริ่มต้น](https://img.shields.io/badge/LangChain.js%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=0553D6)](https://aka.ms/langchainjs-for-beginners?WT.mc_id=m365-94501-dwahlin) +### LangChain +[![LangChain4j สำหรับผู้เริ่มต้น](https://img.shields.io/badge/LangChain4j%20for%20Beginners-22C55E?style=for-the-badge&&labelColor=E5E7EB&color=0553D6)](https://aka.ms/langchain4j-for-beginners) +[![LangChain.js สำหรับผู้เริ่มต้น](https://img.shields.io/badge/LangChain.js%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=0553D6)](https://aka.ms/langchainjs-for-beginners?WT.mc_id=m365-94501-dwahlin) --- -### Azure / Edge / MCP / Agents -[![AZD สำหรับผู้เริ่มต้น](https://img.shields.io/badge/AZD%20for%20Beginners-0078D4?style=for-the-badge&labelColor=E5E7EB&color=0078D4)](https://github.com/microsoft/AZD-for-beginners?WT.mc_id=academic-105485-koreyst) -[![Edge AI สำหรับผู้เริ่มต้น](https://img.shields.io/badge/Edge%20AI%20for%20Beginners-00B8E4?style=for-the-badge&labelColor=E5E7EB&color=00B8E4)](https://github.com/microsoft/edgeai-for-beginners?WT.mc_id=academic-105485-koreyst) -[![MCP สำหรับผู้เริ่มต้น](https://img.shields.io/badge/MCP%20for%20Beginners-009688?style=for-the-badge&labelColor=E5E7EB&color=009688)](https://github.com/microsoft/mcp-for-beginners?WT.mc_id=academic-105485-koreyst) -[![AI Agents สำหรับผู้เริ่มต้น](https://img.shields.io/badge/AI%20Agents%20for%20Beginners-00C49A?style=for-the-badge&labelColor=E5E7EB&color=00C49A)](https://github.com/microsoft/ai-agents-for-beginners?WT.mc_id=academic-105485-koreyst) +### Azure / Edge / MCP / Agents +[![AZD สำหรับผู้เริ่มต้น](https://img.shields.io/badge/AZD%20for%20Beginners-0078D4?style=for-the-badge&labelColor=E5E7EB&color=0078D4)](https://github.com/microsoft/AZD-for-beginners?WT.mc_id=academic-105485-koreyst) +[![Edge AI สำหรับผู้เริ่มต้น](https://img.shields.io/badge/Edge%20AI%20for%20Beginners-00B8E4?style=for-the-badge&labelColor=E5E7EB&color=00B8E4)](https://github.com/microsoft/edgeai-for-beginners?WT.mc_id=academic-105485-koreyst) +[![MCP สำหรับผู้เริ่มต้น](https://img.shields.io/badge/MCP%20for%20Beginners-009688?style=for-the-badge&labelColor=E5E7EB&color=009688)](https://github.com/microsoft/mcp-for-beginners?WT.mc_id=academic-105485-koreyst) +[![AI Agents สำหรับผู้เริ่มต้น](https://img.shields.io/badge/AI%20Agents%20for%20Beginners-00C49A?style=for-the-badge&labelColor=E5E7EB&color=00C49A)](https://github.com/microsoft/ai-agents-for-beginners?WT.mc_id=academic-105485-koreyst) --- -### ชุด Generative AI -[![Generative AI สำหรับผู้เริ่มต้น](https://img.shields.io/badge/Generative%20AI%20for%20Beginners-8B5CF6?style=for-the-badge&labelColor=E5E7EB&color=8B5CF6)](https://github.com/microsoft/generative-ai-for-beginners?WT.mc_id=academic-105485-koreyst) -[![Generative AI (.NET)](https://img.shields.io/badge/Generative%20AI%20(.NET)-9333EA?style=for-the-badge&labelColor=E5E7EB&color=9333EA)](https://github.com/microsoft/Generative-AI-for-beginners-dotnet?WT.mc_id=academic-105485-koreyst) -[![Generative AI (Java)](https://img.shields.io/badge/Generative%20AI%20(Java)-C084FC?style=for-the-badge&labelColor=E5E7EB&color=C084FC)](https://github.com/microsoft/generative-ai-for-beginners-java?WT.mc_id=academic-105485-koreyst) -[![Generative AI (JavaScript)](https://img.shields.io/badge/Generative%20AI%20(JavaScript)-E879F9?style=for-the-badge&labelColor=E5E7EB&color=E879F9)](https://github.com/microsoft/generative-ai-with-javascript?WT.mc_id=academic-105485-koreyst) +### ชุด Generative AI +[![Generative AI สำหรับผู้เริ่มต้น](https://img.shields.io/badge/Generative%20AI%20for%20Beginners-8B5CF6?style=for-the-badge&labelColor=E5E7EB&color=8B5CF6)](https://github.com/microsoft/generative-ai-for-beginners?WT.mc_id=academic-105485-koreyst) +[![Generative AI (.NET)](https://img.shields.io/badge/Generative%20AI%20(.NET)-9333EA?style=for-the-badge&labelColor=E5E7EB&color=9333EA)](https://github.com/microsoft/Generative-AI-for-beginners-dotnet?WT.mc_id=academic-105485-koreyst) +[![Generative AI (Java)](https://img.shields.io/badge/Generative%20AI%20(Java)-C084FC?style=for-the-badge&labelColor=E5E7EB&color=C084FC)](https://github.com/microsoft/generative-ai-for-beginners-java?WT.mc_id=academic-105485-koreyst) +[![Generative AI (JavaScript)](https://img.shields.io/badge/Generative%20AI%20(JavaScript)-E879F9?style=for-the-badge&labelColor=E5E7EB&color=E879F9)](https://github.com/microsoft/generative-ai-with-javascript?WT.mc_id=academic-105485-koreyst) --- -### การเรียนรู้หลัก -[![ML สำหรับผู้เริ่มต้น](https://img.shields.io/badge/ML%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=22C55E)](https://aka.ms/ml-beginners?WT.mc_id=academic-105485-koreyst) -[![Data Science สำหรับผู้เริ่มต้น](https://img.shields.io/badge/Data%20Science%20for%20Beginners-84CC16?style=for-the-badge&labelColor=E5E7EB&color=84CC16)](https://aka.ms/datascience-beginners?WT.mc_id=academic-105485-koreyst) -[![AI สำหรับผู้เริ่มต้น](https://img.shields.io/badge/AI%20for%20Beginners-A3E635?style=for-the-badge&labelColor=E5E7EB&color=A3E635)](https://aka.ms/ai-beginners?WT.mc_id=academic-105485-koreyst) -[![Cybersecurity สำหรับผู้เริ่มต้น](https://img.shields.io/badge/Cybersecurity%20for%20Beginners-F97316?style=for-the-badge&labelColor=E5E7EB&color=F97316)](https://github.com/microsoft/Security-101?WT.mc_id=academic-96948-sayoung) -[![Web Dev สำหรับผู้เริ่มต้น](https://img.shields.io/badge/Web%20Dev%20for%20Beginners-EC4899?style=for-the-badge&labelColor=E5E7EB&color=EC4899)](https://aka.ms/webdev-beginners?WT.mc_id=academic-105485-koreyst) +### การเรียนรู้พื้นฐาน +[![ML สำหรับผู้เริ่มต้น](https://img.shields.io/badge/ML%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=22C55E)](https://aka.ms/ml-beginners?WT.mc_id=academic-105485-koreyst) +[![Data Science สำหรับผู้เริ่มต้น](https://img.shields.io/badge/Data%20Science%20for%20Beginners-84CC16?style=for-the-badge&labelColor=E5E7EB&color=84CC16)](https://aka.ms/datascience-beginners?WT.mc_id=academic-105485-koreyst) +[![AI สำหรับผู้เริ่มต้น](https://img.shields.io/badge/AI%20for%20Beginners-A3E635?style=for-the-badge&labelColor=E5E7EB&color=A3E635)](https://aka.ms/ai-beginners?WT.mc_id=academic-105485-koreyst) +[![Cybersecurity สำหรับผู้เริ่มต้น](https://img.shields.io/badge/Cybersecurity%20for%20Beginners-F97316?style=for-the-badge&labelColor=E5E7EB&color=F97316)](https://github.com/microsoft/Security-101?WT.mc_id=academic-96948-sayoung) + +[![Web Dev for Beginners](https://img.shields.io/badge/Web%20Dev%20for%20Beginners-EC4899?style=for-the-badge&labelColor=E5E7EB&color=EC4899)](https://aka.ms/webdev-beginners?WT.mc_id=academic-105485-koreyst) [![IoT for Beginners](https://img.shields.io/badge/IoT%20for%20Beginners-14B8A6?style=for-the-badge&labelColor=E5E7EB&color=14B8A6)](https://aka.ms/iot-beginners?WT.mc_id=academic-105485-koreyst) [![XR Development for Beginners](https://img.shields.io/badge/XR%20Development%20for%20Beginners-38BDF8?style=for-the-badge&labelColor=E5E7EB&color=38BDF8)](https://github.com/microsoft/xr-development-for-beginners?WT.mc_id=academic-105485-koreyst) --- -### Copilot Series +### ชุด Copilot [![Copilot for AI Paired Programming](https://img.shields.io/badge/Copilot%20for%20AI%20Paired%20Programming-FACC15?style=for-the-badge&labelColor=E5E7EB&color=FACC15)](https://aka.ms/GitHubCopilotAI?WT.mc_id=academic-105485-koreyst) [![Copilot for C#/.NET](https://img.shields.io/badge/Copilot%20for%20C%23/.NET-FBBF24?style=for-the-badge&labelColor=E5E7EB&color=FBBF24)](https://github.com/microsoft/mastering-github-copilot-for-dotnet-csharp-developers?WT.mc_id=academic-105485-koreyst) [![Copilot Adventure](https://img.shields.io/badge/Copilot%20Adventure-FDE68A?style=for-the-badge&labelColor=E5E7EB&color=FDE68A)](https://github.com/microsoft/CopilotAdventures?WT.mc_id=academic-105485-koreyst) @@ -131,11 +122,11 @@ CO_OP_TRANSLATOR_METADATA: ## การขอความช่วยเหลือ -หากคุณติดขัดหรือต้องการสอบถามเกี่ยวกับการสร้างแอป AI ร่วมกับนักเรียนและนักพัฒนาที่มีประสบการณ์ในการอภิปรายเกี่ยวกับ MCP นี่คือชุมชนที่สนับสนุนซึ่งเปิดรับคำถามและแบ่งปันความรู้กันอย่างอิสระ +หากคุณติดขัดหรือมีคำถามเกี่ยวกับการสร้างแอป AI เข้าร่วมกับผู้เรียนและนักพัฒนาที่มีประสบการณ์ในการสนทนาเกี่ยวกับ MCP นี่คือชุมชนที่ให้การสนับสนุนซึ่งคำถามได้รับการต้อนรับและความรู้มีการแบ่งปันอย่างเสรี [![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) -หากคุณมีคำติชมเกี่ยวกับผลิตภัณฑ์หรือพบข้อผิดพลาดระหว่างการสร้างโปรดเยี่ยมชม: +หากคุณมีข้อเสนอแนะเกี่ยวกับผลิตภัณฑ์หรือพบข้อผิดพลาดขณะสร้างโปรดไปที่: [![Microsoft Foundry Developer Forum](https://img.shields.io/badge/GitHub-Microsoft_Foundry_Developer_Forum-blue?style=for-the-badge&logo=github&color=000000&logoColor=fff)](https://aka.ms/foundry/forum) @@ -143,5 +134,5 @@ CO_OP_TRANSLATOR_METADATA: **ข้อจำกัดความรับผิดชอบ**: -เอกสารฉบับนี้ได้รับการแปลโดยใช้บริการแปลภาษาด้วย AI [Co-op Translator](https://github.com/Azure/co-op-translator) แม้เราจะพยายามให้ความถูกต้องสูงสุด แต่กรุณาทราบว่าการแปลโดยอัตโนมัติอาจมีข้อผิดพลาดหรือความคลาดเคลื่อนได้ เอกสารต้นฉบับในภาษาต้นทางถือเป็นแหล่งข้อมูลที่เชื่อถือได้สำหรับข้อมูลที่ถูกต้องที่สุด สำหรับข้อมูลที่มีความสำคัญ ขอแนะนำให้ใช้บริการแปลโดยมืออาชีพที่เป็นมนุษย์ เราไม่รับผิดชอบต่อความเข้าใจผิดหรือการตีความผิดที่เกิดขึ้นจากการใช้การแปลฉบับนี้ +เอกสารนี้ได้รับการแปลโดยใช้บริการแปลภาษา AI [Co-op Translator](https://github.com/Azure/co-op-translator) แม้ว่าเราจะพยายามให้ความถูกต้อง แต่โปรดทราบว่าการแปลโดยอัตโนมัติอาจมีข้อผิดพลาดหรือความคลาดเคลื่อนได้ เอกสารต้นฉบับในภาษาต้นฉบับถือเป็นแหล่งข้อมูลที่น่าเชื่อถือที่สุด สำหรับข้อมูลที่สำคัญ ขอแนะนำให้ใช้การแปลโดยผู้เชี่ยวชาญมนุษย์ เราไม่รับผิดชอบต่อความเข้าใจผิดหรือการตีความผิดที่เกิดจากการใช้การแปลนี้ \ No newline at end of file diff --git a/translations/th/SECURITY.md b/translations/th/SECURITY.md index 31e3c417..348832e9 100644 --- a/translations/th/SECURITY.md +++ b/translations/th/SECURITY.md @@ -1,12 +1,3 @@ - ## ความปลอดภัย Microsoft ให้ความสำคัญกับความปลอดภัยของผลิตภัณฑ์และบริการซอฟต์แวร์ของเราอย่างจริงจัง ซึ่งรวมถึงที่เก็บซอร์สโค้ดทั้งหมดที่จัดการผ่านองค์กร GitHub ของเรา เช่น [Microsoft](https://github.com/Microsoft), [Azure](https://github.com/Azure), [DotNet](https://github.com/dotnet), [AspNet](https://github.com/aspnet) และ [Xamarin](https://github.com/xamarin) diff --git a/translations/th/SUPPORT.md b/translations/th/SUPPORT.md index a08cb5fe..cd2338c3 100644 --- a/translations/th/SUPPORT.md +++ b/translations/th/SUPPORT.md @@ -1,12 +1,3 @@ - # การสนับสนุน ## วิธีรายงานปัญหาและขอความช่วยเหลือ diff --git a/translations/tl/.co-op-translator.json b/translations/tl/.co-op-translator.json new file mode 100644 index 00000000..542ca365 --- /dev/null +++ b/translations/tl/.co-op-translator.json @@ -0,0 +1,92 @@ +{ + "01-IntroToGenAI/README.md": { + "original_hash": "75bfb080ca725e8a9aa9c80cae25fba1", + "translation_date": "2025-07-29T09:52:19+00:00", + "source_file": "01-IntroToGenAI/README.md", + "language_code": "tl" + }, + "02-SetupDevEnvironment/README.md": { + "original_hash": "96a30d42b9751a3d4e4b20e28d29d459", + "translation_date": "2026-01-28T05:13:54+00:00", + "source_file": "02-SetupDevEnvironment/README.md", + "language_code": "tl" + }, + "02-SetupDevEnvironment/examples/basic-chat-azure/README.md": { + "original_hash": "efd82efe50711d7e257eb943151d682c", + "translation_date": "2025-07-27T13:45:03+00:00", + "source_file": "02-SetupDevEnvironment/examples/basic-chat-azure/README.md", + "language_code": "tl" + }, + "02-SetupDevEnvironment/getting-started-azure-openai.md": { + "original_hash": "bfdb4b4eadbee3a59ef742439f58326a", + "translation_date": "2025-07-27T13:20:59+00:00", + "source_file": "02-SetupDevEnvironment/getting-started-azure-openai.md", + "language_code": "tl" + }, + "03-CoreGenerativeAITechniques/README.md": { + "original_hash": "685f55cb07de19b52a30ce6e8b6d889e", + "translation_date": "2025-08-28T22:12:55+00:00", + "source_file": "03-CoreGenerativeAITechniques/README.md", + "language_code": "tl" + }, + "04-PracticalSamples/README.md": { + "original_hash": "14c0a61ecc1cd2012a9c129236dfdf71", + "translation_date": "2025-07-29T09:52:05+00:00", + "source_file": "04-PracticalSamples/README.md", + "language_code": "tl" + }, + "04-PracticalSamples/calculator/README.md": { + "original_hash": "b6c16b5514d524e415a94f6097ee7d4c", + "translation_date": "2025-09-18T15:37:33+00:00", + "source_file": "04-PracticalSamples/calculator/README.md", + "language_code": "tl" + }, + "04-PracticalSamples/foundrylocal/README.md": { + "original_hash": "f787307400de59adc25a1404466a35f3", + "translation_date": "2025-11-04T07:31:08+00:00", + "source_file": "04-PracticalSamples/foundrylocal/README.md", + "language_code": "tl" + }, + "04-PracticalSamples/petstory/README.md": { + "original_hash": "0cbf68d605615a1e602c832a24616859", + "translation_date": "2025-07-25T11:46:48+00:00", + "source_file": "04-PracticalSamples/petstory/README.md", + "language_code": "tl" + }, + "05-ResponsibleGenAI/README.md": { + "original_hash": "301c05c2f57e60a6950b8c665b8bdbba", + "translation_date": "2025-07-29T15:56:21+00:00", + "source_file": "05-ResponsibleGenAI/README.md", + "language_code": "tl" + }, + "AGENTS.md": { + "original_hash": "afc90918d008cf77fd1982691f681306", + "translation_date": "2025-10-03T08:40:53+00:00", + "source_file": "AGENTS.md", + "language_code": "tl" + }, + "CODE_OF_CONDUCT.md": { + "original_hash": "442b123d034f92f7c384d2bbd28f99f1", + "translation_date": "2025-07-21T19:09:05+00:00", + "source_file": "CODE_OF_CONDUCT.md", + "language_code": "tl" + }, + "README.md": { + "original_hash": "125a08948d881c95628094f4dd1fbd43", + "translation_date": "2026-01-29T16:02:54+00:00", + "source_file": "README.md", + "language_code": "tl" + }, + "SECURITY.md": { + "original_hash": "57f14126c1c6add76b3aef3844dfe4e3", + "translation_date": "2025-07-21T19:07:51+00:00", + "source_file": "SECURITY.md", + "language_code": "tl" + }, + "SUPPORT.md": { + "original_hash": "b8ef73cc49dec68e2c885ee9df545129", + "translation_date": "2025-07-21T19:10:17+00:00", + "source_file": "SUPPORT.md", + "language_code": "tl" + } +} \ No newline at end of file diff --git a/translations/tl/01-IntroToGenAI/README.md b/translations/tl/01-IntroToGenAI/README.md index cd167a2b..a296fbd4 100644 --- a/translations/tl/01-IntroToGenAI/README.md +++ b/translations/tl/01-IntroToGenAI/README.md @@ -1,12 +1,3 @@ - # Panimula sa Generative AI - Java Edition ## Ano ang Iyong Matututunan diff --git a/translations/tl/02-SetupDevEnvironment/README.md b/translations/tl/02-SetupDevEnvironment/README.md index 364b0a48..281513bd 100644 --- a/translations/tl/02-SetupDevEnvironment/README.md +++ b/translations/tl/02-SetupDevEnvironment/README.md @@ -1,13 +1,253 @@ - +# Pag-set Up ng Development Environment para sa Generative AI para sa Java +> **Mabilisang Simula**: Mag-code sa Cloud sa loob ng 2 minuto - Tumalon sa [GitHub Codespaces Setup](../../../02-SetupDevEnvironment) - walang kinakailangang lokal na pag-install at gumagamit ng github models! + +> **Interesado sa Azure OpenAI?**, tingnan ang aming [Azure OpenAI Setup Guide](getting-started-azure-openai.md) na may mga hakbang para gumawa ng bagong Azure OpenAI resource. + +## Ano ang Matututuhan Mo + +- Mag-set up ng Java development environment para sa AI applications +- Pumili at i-configure ang iyong nais na development environment (cloud-first gamit ang Codespaces, local dev container, o kumpletong lokal na setup) +- Subukan ang iyong setup sa pamamagitan ng pagkonekta sa GitHub Models + +## Talaan ng Nilalaman + +- [Ano ang Matututuhan Mo](../../../02-SetupDevEnvironment) +- [Panimula](../../../02-SetupDevEnvironment) +- [Hakbang 1: I-set Up ang Iyong Development Environment](../../../02-SetupDevEnvironment) + - [Opsyon A: GitHub Codespaces (Inirerekomenda)](../../../02-SetupDevEnvironment) + - [Opsyon B: Local Dev Container](../../../02-SetupDevEnvironment) + - [Opsyon C: Gamitin ang Kasalukuyan Mong Lokal na Instalasyon](../../../02-SetupDevEnvironment) +- [Hakbang 2: Gumawa ng GitHub Personal Access Token](../../../02-SetupDevEnvironment) +- [Hakbang 3: Subukan ang Iyong Setup](../../../02-SetupDevEnvironment) +- [Pagsasaayos ng Problema](../../../02-SetupDevEnvironment) +- [Buod](../../../02-SetupDevEnvironment) +- [Mga Susunod na Hakbang](../../../02-SetupDevEnvironment) + +## Panimula + +Ang kabanatang ito ay gagabay sa iyo sa pag-set up ng development environment. Gagamit tayo ng **GitHub Models** bilang pangunahing halimbawa dahil ito ay libre, madaling i-setup gamit lamang ang GitHub account, hindi nangangailangan ng credit card, at nagbibigay ng access sa maraming modelo para sa eksperimento. + +**Walang kinakailangang lokal na setup!** Maaari kang magsimula agad mag-code gamit ang GitHub Codespaces, na nagbibigay ng kumpletong development environment sa iyong browser. + +Screenshot: GitHub Models + +Inirerekomenda naming gamitin ang [**GitHub Models**](https://github.com/marketplace?type=models) para sa kursong ito dahil ito ay: +- **Libre** para makapagsimula +- **Madaling** i-set up gamit lamang ang GitHub account +- **Walang credit card** na kailangan +- **Maraming modelo** na magagamit para sa eksperimento + +> **Tandaan**: Ang GitHub Models na ginamit sa pagsasanay na ito ay may sumusunod na libreng limitasyon: +> - 15 kahilingan kada minuto (150 kada araw) +> - ~8,000 salita input, ~4,000 salita output kada kahilingan +> - 5 sabay-sabay na kahilingan +> +> Para sa production, i-upgrade sa Azure AI Foundry Models gamit ang iyong Azure account. Hindi mo kailangang baguhin ang iyong code. Tingnan ang [Azure AI Foundry documentation](https://learn.microsoft.com/azure/ai-foundry/foundry-models/how-to/quickstart-github-models). + +## Hakbang 1: I-set Up ang Iyong Development Environment + + + +Nagawa namin ang isang preconfigured development container upang mabawasan ang oras ng setup at matiyak na mayroon kang lahat ng kinakailangang tools para sa kursong Generative AI para sa Java. Piliin ang iyong nais na paraan ng pag-develop: + +### Mga Opsyon sa Pag-setup ng Environment: + +#### Opsyon A: GitHub Codespaces (Inirerekomenda) + +**Magsimulang mag-code sa loob ng 2 minuto - walang kinakailangang lokal na setup!** + +1. I-fork ang repository na ito sa iyong GitHub account + > **Tandaan**: Kung nais mong i-edit ang basic config, tingnan ang [Dev Container Configuration](../../../.devcontainer/devcontainer.json) +2. I-click ang **Code** → tab na **Codespaces** → **...** → **New with options...** +3. Gamitin ang defaults – pipiliin nito ang **Dev container configuration**: **Generative AI Java Development Environment**, ang custom devcontainer na ginawa para sa kursong ito +4. I-click ang **Create codespace** +5. Maghintay ng mga ~2 minuto para maging handa ang environment +6. Magpatuloy sa [Hakbang 2: Gumawa ng GitHub Token](../../../02-SetupDevEnvironment) + +Screenshot: Codespaces submenu + +Screenshot: New with options + +Screenshot: Create codespace options + +> **Mga Benepisyo ng Codespaces**: +> - Walang kinakailangang lokal na pag-install +> - Gumagana sa anumang device na may browser +> - Pre-configured na may lahat ng tools at dependencies +> - Libreng 60 oras kada buwan para sa personal accounts +> - Konsistent na environment para sa lahat ng nag-aaral + +#### Opsyon B: Local Dev Container + +**Para sa mga developer na mas gustong lokal na pag-develop gamit ang Docker** + +1. I-fork at i-clone ang repository na ito sa iyong lokal na makina + > **Tandaan**: Kung nais mong i-edit ang basic config, tingnan ang [Dev Container Configuration](../../../.devcontainer/devcontainer.json) +2. Mag-install ng [Docker Desktop](https://www.docker.com/products/docker-desktop/) at [VS Code](https://code.visualstudio.com/) +3. I-install ang [Dev Containers extension](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers) sa VS Code +4. Buksan ang folder ng repository sa VS Code +5. Kapag pinilit, i-click ang **Reopen in Container** (o gamitin ang `Ctrl+Shift+P` → "Dev Containers: Reopen in Container") +6. Maghintay para mabuo at magsimula ang container +7. Magpatuloy sa [Hakbang 2: Gumawa ng GitHub Token](../../../02-SetupDevEnvironment) + +Screenshot: Dev container setup + +Screenshot: Dev container build complete + +#### Opsyon C: Gamitin ang Kasalukuyan Mong Lokal na Instalasyon + +**Para sa mga developer na may kasalukuyang Java environment** + +Mga kinakailangan: +- [Java 21+](https://www.oracle.com/java/technologies/javase/jdk21-archive-downloads.html) +- [Maven 3.9+](https://maven.apache.org/download.cgi) +- [VS Code](https://code.visualstudio.com) o ang iyong paboritong IDE + +Mga hakbang: +1. I-clone ang repository na ito sa iyong lokal na makina +2. Buksan ang proyekto sa iyong IDE +3. Magpatuloy sa [Hakbang 2: Gumawa ng GitHub Token](../../../02-SetupDevEnvironment) + +> **Pro Tip**: Kung may mababang spec na makina ka pero gusto mo ang VS Code lokal, gamitin ang GitHub Codespaces! Maaari mong i-connect ang lokal mong VS Code sa cloud-hosted Codespace para sa pinakamahusay sa dalawang mundo. + +Screenshot: created local devcontainer instance + +## Hakbang 2: Gumawa ng GitHub Personal Access Token + +1. Pumunta sa [GitHub Settings](https://github.com/settings/profile) at piliin ang **Settings** mula sa iyong profile menu. +2. Sa kaliwang sidebar, i-click ang **Developer settings** (karaniwan nasa ibaba). +3. Sa ilalim ng **Personal access tokens**, i-click ang **Fine-grained tokens** (o sundin ang direktang [link na ito](https://github.com/settings/personal-access-tokens)). +4. I-click ang **Generate new token**. +5. Sa ilalim ng "Token name", maglagay ng isang malinaw na pangalan (hal., `GenAI-Java-Course-Token`). +6. Magtakda ng expiration date (inirerekomenda: 7 araw para sa pinakamahusay na mga praktis sa seguridad). +7. Sa ilalim ng "Resource owner", piliin ang iyong user account. +8. Sa ilalim ng "Repository access", piliin ang mga repository na nais mong gamitin kasama ang GitHub Models (o "All repositories" kung kinakailangan). +9. Sa ilalim ng "Account permissions", hanapin ang **Models** at itakda ito sa **Read-only**. +10. I-click ang **Generate token**. +11. **Kopyahin at i-save ang iyong token ngayon** – hindi mo na ito muling makikita! + +> **Tip sa Seguridad**: Gumamit ng pinakamababang sakop na kinakailangan at pinakamaikling praktikal na oras ng pag-expire para sa iyong access tokens. + +## Hakbang 3: Subukan ang Iyong Setup sa GitHub Models Example + +Kapag handa na ang iyong development environment, subukan natin ang integrasyon ng GitHub Models gamit ang aming halimbawa sa [`02-SetupDevEnvironment/examples/github-models`](../../../02-SetupDevEnvironment/examples/github-models). + +1. Buksan ang terminal sa iyong development environment. +2. Pumunta sa halimbawa ng GitHub Models: + ```bash + cd 02-SetupDevEnvironment/examples/github-models + ``` +3. Itakda ang iyong GitHub token bilang environment variable: + ```bash + # macOS/Linux + export GITHUB_TOKEN=your_token_here + + # Windows (Command Prompt) + set GITHUB_TOKEN=your_token_here + + # Windows (PowerShell) + $env:GITHUB_TOKEN="your_token_here" + ``` + +4. Patakbuhin ang application: + ```bash + mvn compile exec:java -Dexec.mainClass="com.example.githubmodels.App" + ``` + +Makikita mo ang output na katulad nito: +```text +Using model: gpt-4.1-nano +Sending request to GitHub Models... +Response: Hello World! +``` + + +### Pag-unawa sa Halimbawa ng Code + +Una, unawain natin ang pinatakbo natin. Ang halimbawa sa ilalim ng `examples/github-models` ay gumagamit ng OpenAI Java SDK para kumonekta sa GitHub Models: + +**Ano ang ginagawa ng code na ito:** +- **Kumokonekta** sa GitHub Models gamit ang iyong personal access token +- **Nagsusumite** ng simpleng mensaheng "Say Hello World!" sa AI model +- **Tumatanggap** at ipinapakita ang tugon ng AI +- **Tinitiyak** na gumagana nang tama ang iyong setup + +**Pangunahing Dependency** (sa `pom.xml`): +```xml + + com.openai + openai-java + 2.12.0 + +``` + +**Pangunahing Code** (`App.java`): +```java +// Kumonekta sa mga Modelo ng GitHub gamit ang OpenAI Java SDK +OpenAIClient client = OpenAIOkHttpClient.builder() + .apiKey(pat) + .baseUrl("https://models.inference.ai.azure.com") + .build(); + +// Gumawa ng kahilingan para sa chat completion +ChatCompletionCreateParams params = ChatCompletionCreateParams.builder() + .model(modelId) + .addSystemMessage("You are a concise assistant.") + .addUserMessage("Say Hello World!") + .build(); + +// Kumuha ng sagot mula sa AI +ChatCompletion response = client.chat().completions().create(params); +System.out.println("Response: " + response.choices().get(0).message().content().orElse("No response content")); +``` + + +## Buod + +Mahusay! Naitsura mo na lahat ng kailangan: + +- Nakagawa ng GitHub Personal Access Token na may tamang permiso para sa AI model access +- Napatakbo ang iyong Java development environment (Codespaces, dev containers, o lokal man) +- Nakakonekta sa GitHub Models gamit ang OpenAI Java SDK para sa libreng AI development +- Nasubukan lahat gamit ang isang simpleng halimbawa na nakikipag-usap sa AI models + +## Mga Susunod na Hakbang + +[Chapter 3: Core Generative AI Techniques](../03-CoreGenerativeAITechniques/README.md) + +## Pagsasaayos ng Problema + +May problema? Narito ang mga karaniwang isyu at mga solusyon: + +- **Hindi gumagana ang token?** + - Siguraduhing nakopya mo nang buo ang token nang walang dagdag na espasyo + - Tiyaking naka-set nang tama ang token bilang environment variable + - Suriin na ang token ay may tamang permiso (Models: Read-only) + +- **Hindi makita ang Maven?** + - Kung gumagamit ng dev containers/Codespaces, naka-pre-install ang Maven + - Para sa lokal na setup, tiyakin na naka-install ang Java 21+ at Maven 3.9+ + - Subukang patakbuhin ang `mvn --version` para tiyakin ang instalasyon + +- **Mga isyu sa koneksyon?** + - Suriin ang iyong internet connection + - Tiyaking ma-access ang GitHub mula sa iyong network + - Siguraduhing wala kang firewall na humaharang sa GitHub Models endpoint + +- **Hindi nagsisimula ang dev container?** + - Siguraduhing tumatakbo ang Docker Desktop (para sa lokal na pag-develop) + - Subukang i-rebuild ang container: `Ctrl+Shift+P` → "Dev Containers: Rebuild Container" + +- **May error sa pag-compile ng aplikasyon?** + - Siguraduhing nasa tamang directory ka: `02-SetupDevEnvironment/examples/github-models` + - Subukang linisin at i-rebuild: `mvn clean compile` + +> **Kailangang tulong?**: May problema pa rin? Magbukas ng isyu sa repository at tutulungan ka namin. --- + +**Paunawa**: +Ang dokumentong ito ay isinalin gamit ang AI translation service na [Co-op Translator](https://github.com/Azure/co-op-translator). Bagama't aming pinagsisikapang maging tumpak ang pagsasalin, mangyaring tandaan na ang mga awtomatikong pagsasalin ay maaaring maglaman ng mga pagkakamali o di-tumpak na impormasyon. Ang orihinal na dokumento sa orihinal nitong wika ang dapat ituring na opisyal na sanggunian. Para sa mahahalagang impormasyon, inirerekomenda ang propesyonal na pagsasalin ng tao. Hindi kami mananagot sa anumang hindi pagkakaunawaan o maling interpretasyon na maaaring magmula sa paggamit ng pagsasaling ito. + \ No newline at end of file diff --git a/translations/tl/02-SetupDevEnvironment/examples/basic-chat-azure/README.md b/translations/tl/02-SetupDevEnvironment/examples/basic-chat-azure/README.md index f54a5d59..2ec9520c 100644 --- a/translations/tl/02-SetupDevEnvironment/examples/basic-chat-azure/README.md +++ b/translations/tl/02-SetupDevEnvironment/examples/basic-chat-azure/README.md @@ -1,12 +1,3 @@ - # Basic Chat with Azure OpenAI - Halimbawa ng End-to-End Ang halimbawang ito ay nagpapakita kung paano gumawa ng simpleng Spring Boot application na kumokonekta sa Azure OpenAI at sinusubukan ang iyong setup. diff --git a/translations/tl/02-SetupDevEnvironment/getting-started-azure-openai.md b/translations/tl/02-SetupDevEnvironment/getting-started-azure-openai.md index e5738935..2a00fd3d 100644 --- a/translations/tl/02-SetupDevEnvironment/getting-started-azure-openai.md +++ b/translations/tl/02-SetupDevEnvironment/getting-started-azure-openai.md @@ -1,12 +1,3 @@ - # Pagtatakda ng Development Environment para sa Azure OpenAI > **Quick Start**: Ang gabay na ito ay para sa Azure OpenAI setup. Para sa mabilisang pagsisimula gamit ang mga libreng modelo, gamitin ang [GitHub Models with Codespaces](./README.md#quick-start-cloud). diff --git a/translations/tl/03-CoreGenerativeAITechniques/README.md b/translations/tl/03-CoreGenerativeAITechniques/README.md index 04ee26c6..880836db 100644 --- a/translations/tl/03-CoreGenerativeAITechniques/README.md +++ b/translations/tl/03-CoreGenerativeAITechniques/README.md @@ -1,12 +1,3 @@ - # Core Generative AI Techniques Tutorial ## Nilalaman ng Talakayan diff --git a/translations/tl/04-PracticalSamples/README.md b/translations/tl/04-PracticalSamples/README.md index 17c1dea7..5ef7be83 100644 --- a/translations/tl/04-PracticalSamples/README.md +++ b/translations/tl/04-PracticalSamples/README.md @@ -1,12 +1,3 @@ - # Praktikal na Aplikasyon at mga Proyekto ## Ano ang Iyong Matututunan diff --git a/translations/tl/04-PracticalSamples/calculator/README.md b/translations/tl/04-PracticalSamples/calculator/README.md index 40541219..bb3a8be9 100644 --- a/translations/tl/04-PracticalSamples/calculator/README.md +++ b/translations/tl/04-PracticalSamples/calculator/README.md @@ -1,12 +1,3 @@ - # MCP Calculator Tutorial para sa mga Baguhan ## Nilalaman diff --git a/translations/tl/04-PracticalSamples/foundrylocal/README.md b/translations/tl/04-PracticalSamples/foundrylocal/README.md index f65ffcf2..992e7402 100644 --- a/translations/tl/04-PracticalSamples/foundrylocal/README.md +++ b/translations/tl/04-PracticalSamples/foundrylocal/README.md @@ -1,12 +1,3 @@ - # Foundry Local Spring Boot Tutorial ## Nilalaman ng Talakayan diff --git a/translations/tl/04-PracticalSamples/petstory/README.md b/translations/tl/04-PracticalSamples/petstory/README.md index 77b7e07d..453bc32b 100644 --- a/translations/tl/04-PracticalSamples/petstory/README.md +++ b/translations/tl/04-PracticalSamples/petstory/README.md @@ -1,12 +1,3 @@ - # Tutorial sa Pet Story Generator para sa mga Baguhan ## Nilalaman diff --git a/translations/tl/05-ResponsibleGenAI/README.md b/translations/tl/05-ResponsibleGenAI/README.md index 8b812bc8..454e284a 100644 --- a/translations/tl/05-ResponsibleGenAI/README.md +++ b/translations/tl/05-ResponsibleGenAI/README.md @@ -1,12 +1,3 @@ - # Responsableng Generative AI ## Ano ang Iyong Matututunan diff --git a/translations/tl/AGENTS.md b/translations/tl/AGENTS.md index b2dc3b59..d5d08247 100644 --- a/translations/tl/AGENTS.md +++ b/translations/tl/AGENTS.md @@ -1,12 +1,3 @@ - # AGENTS.md ## Pangkalahatang-ideya ng Proyekto diff --git a/translations/tl/CODE_OF_CONDUCT.md b/translations/tl/CODE_OF_CONDUCT.md index 5ae95537..3b62c233 100644 --- a/translations/tl/CODE_OF_CONDUCT.md +++ b/translations/tl/CODE_OF_CONDUCT.md @@ -1,12 +1,3 @@ - # Microsoft Open Source Code of Conduct Ang proyektong ito ay sumunod sa [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/). diff --git a/translations/tl/README.md b/translations/tl/README.md index a605f34d..9ac2f40c 100644 --- a/translations/tl/README.md +++ b/translations/tl/README.md @@ -1,90 +1,81 @@ - # Generative AI para sa mga Baguhan - Java Edition [![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) ![Generative AI para sa mga Baguhan - Java Edition](../../translated_images/tl/beg-genai-series.8b48be9951cc574c.webp) -**Oras na Kailanganin**: Ang buong workshop ay maaaring matapos nang online nang walang lokal na setup. Ang pagsasaayos ng kapaligiran ay tumatagal ng 2 minuto, na may pag-explore sa mga halimbawa na nangangailangan ng 1-3 oras depende sa lalim ng pag-aaral. +**Oras na Kinakailangan**: Ang buong workshop ay maaaring matapos nang online nang walang lokal na setup. Ang pag-setup ng kapaligiran ay tumatagal ng 2 minuto, at ang pag-explore ng mga sample ay nangangailangan ng 1-3 oras depende sa lalim ng pag-explore. > **Mabilis na Simula** -1. I-fork ang repository na ito sa iyong GitHub account +1. I-fork ang repositoryong ito sa iyong GitHub account 2. I-click ang **Code** → tab na **Codespaces** → **...** → **New with options...** -3. Gamitin ang mga default – pipiliin nito ang Development container na ginawa para sa kursong ito +3. Gamitin ang mga default – pipiliin nito ang Development container na nilikha para sa kursong ito 4. I-click ang **Create codespace** 5. Maghintay ng ~2 minuto para maging handa ang kapaligiran 6. Direktang pumunta sa [Ang unang halimbawa](./02-SetupDevEnvironment/README.md#step-2-create-a-github-personal-access-token) -> **Mas gusto mo bang I-clone Lokal?** +> **Mas Gusto Mo Bang I-clone Lokal?** > -> Kasama sa repository na ito ang mahigit 50+ na pagsasalin ng wika na malaki ang dagdag sa laki ng pag-download. Para mag-clone nang walang mga pagsasalin, gamitin ang sparse checkout: +> Kasama sa repositoryong ito ang higit sa 50 wika ng pagsasalin na malaki ang dagdag sa laki ng pag-download. Para mag-clone nang walang pagsasalin, gamitin ang sparse checkout: > ```bash > git clone --filter=blob:none --sparse https://github.com/microsoft/Generative-AI-for-beginners-java.git > cd Generative-AI-for-beginners-java > git sparse-checkout set --no-cone '/*' '!translations' '!translated_images' > ``` -> Bibigyan ka nito ng lahat ng kailangan mo para matapos ang kurso nang mas mabilis ang pag-download. +> Bibigyan ka nito ng lahat ng kailangan mo upang matapos ang kurso na mas mabilis ang pag-download. -## Suporta sa Maramihang Wika +## Suporta sa Iba't ibang Wika -### Sinusuportahan sa pamamagitan ng GitHub Action (Awtomatik at Palaging Napapanahon) +### Sinusuportahan sa pamamagitan ng GitHub Action (Awtomatiko at Palaging Napapanahon) -[Arabic](../ar/README.md) | [Bengali](../bn/README.md) | [Bulgarian](../bg/README.md) | [Burmese (Myanmar)](../my/README.md) | [Chinese (Simplified)](../zh/README.md) | [Chinese (Traditional, Hong Kong)](../hk/README.md) | [Chinese (Traditional, Macau)](../mo/README.md) | [Chinese (Traditional, Taiwan)](../tw/README.md) | [Croatian](../hr/README.md) | [Czech](../cs/README.md) | [Danish](../da/README.md) | [Dutch](../nl/README.md) | [Estonian](../et/README.md) | [Finnish](../fi/README.md) | [French](../fr/README.md) | [German](../de/README.md) | [Greek](../el/README.md) | [Hebrew](../he/README.md) | [Hindi](../hi/README.md) | [Hungarian](../hu/README.md) | [Indonesian](../id/README.md) | [Italian](../it/README.md) | [Japanese](../ja/README.md) | [Kannada](../kn/README.md) | [Korean](../ko/README.md) | [Lithuanian](../lt/README.md) | [Malay](../ms/README.md) | [Malayalam](../ml/README.md) | [Marathi](../mr/README.md) | [Nepali](../ne/README.md) | [Nigerian Pidgin](../pcm/README.md) | [Norwegian](../no/README.md) | [Persian (Farsi)](../fa/README.md) | [Polish](../pl/README.md) | [Portuguese (Brazil)](../br/README.md) | [Portuguese (Portugal)](../pt/README.md) | [Punjabi (Gurmukhi)](../pa/README.md) | [Romanian](../ro/README.md) | [Russian](../ru/README.md) | [Serbian (Cyrillic)](../sr/README.md) | [Slovak](../sk/README.md) | [Slovenian](../sl/README.md) | [Spanish](../es/README.md) | [Swahili](../sw/README.md) | [Swedish](../sv/README.md) | [Tagalog (Filipino)](./README.md) | [Tamil](../ta/README.md) | [Telugu](../te/README.md) | [Thai](../th/README.md) | [Turkish](../tr/README.md) | [Ukrainian](../uk/README.md) | [Urdu](../ur/README.md) | [Vietnamese](../vi/README.md) +[Arabic](../ar/README.md) | [Bengali](../bn/README.md) | [Bulgarian](../bg/README.md) | [Burmese (Myanmar)](../my/README.md) | [Chinese (Simplified)](../zh-CN/README.md) | [Chinese (Traditional, Hong Kong)](../zh-HK/README.md) | [Chinese (Traditional, Macau)](../zh-MO/README.md) | [Chinese (Traditional, Taiwan)](../zh-TW/README.md) | [Croatian](../hr/README.md) | [Czech](../cs/README.md) | [Danish](../da/README.md) | [Dutch](../nl/README.md) | [Estonian](../et/README.md) | [Finnish](../fi/README.md) | [French](../fr/README.md) | [German](../de/README.md) | [Greek](../el/README.md) | [Hebrew](../he/README.md) | [Hindi](../hi/README.md) | [Hungarian](../hu/README.md) | [Indonesian](../id/README.md) | [Italian](../it/README.md) | [Japanese](../ja/README.md) | [Kannada](../kn/README.md) | [Korean](../ko/README.md) | [Lithuanian](../lt/README.md) | [Malay](../ms/README.md) | [Malayalam](../ml/README.md) | [Marathi](../mr/README.md) | [Nepali](../ne/README.md) | [Nigerian Pidgin](../pcm/README.md) | [Norwegian](../no/README.md) | [Persian (Farsi)](../fa/README.md) | [Polish](../pl/README.md) | [Portuguese (Brazil)](../pt-BR/README.md) | [Portuguese (Portugal)](../pt-PT/README.md) | [Punjabi (Gurmukhi)](../pa/README.md) | [Romanian](../ro/README.md) | [Russian](../ru/README.md) | [Serbian (Cyrillic)](../sr/README.md) | [Slovak](../sk/README.md) | [Slovenian](../sl/README.md) | [Spanish](../es/README.md) | [Swahili](../sw/README.md) | [Swedish](../sv/README.md) | [Tagalog (Filipino)](./README.md) | [Tamil](../ta/README.md) | [Telugu](../te/README.md) | [Thai](../th/README.md) | [Turkish](../tr/README.md) | [Ukrainian](../uk/README.md) | [Urdu](../ur/README.md) | [Vietnamese](../vi/README.md) -> **Mas gusto mo bang I-clone Lokal?** +> **Mas Gusto Mo Bang I-clone Lokal?** -> Kasama sa repository na ito ang mahigit 50+ na pagsasalin ng wika na malaki ang dagdag sa laki ng pag-download. Para mag-clone nang walang mga pagsasalin, gamitin ang sparse checkout: +> Kasama sa repositoryong ito ang higit sa 50 wika ng pagsasalin na malaki ang dagdag sa laki ng pag-download. Para mag-clone nang walang pagsasalin, gamitin ang sparse checkout: > ```bash > git clone --filter=blob:none --sparse https://github.com/microsoft/Generative-AI-for-beginners-java.git > cd Generative-AI-for-beginners-java > git sparse-checkout set --no-cone '/*' '!translations' '!translated_images' > ``` -> Bibigyan ka nito ng lahat ng kailangan mo para matapos ang kurso nang mas mabilis ang pag-download. +> Bibigyan ka nito ng lahat ng kailangan mo upang matapos ang kurso na mas mabilis ang pag-download. -## Estruktura ng Kurso at Landas ng Pagkatuto +## Istruktura ng Kurso at Landas ng Pagkatuto ### **Kabanata 1: Panimula sa Generative AI** -- **Pangunahing Konsepto**: Pag-unawa sa Large Language Models, tokens, embeddings, at mga kakayahan ng AI +- **Pangunahing Konsepto**: Pag-unawa sa Malalaking Modelo ng Wika, mga token, embeddings, at kakayahan ng AI - **Java AI Ecosystem**: Pangkalahatang-ideya ng Spring AI at OpenAI SDKs -- **Model Context Protocol**: Panimula sa MCP at ang papel nito sa komunikasyon ng AI agent -- **Mga Praktikal na Aplikasyon**: Mga totoong senaryo kabilang ang mga chatbot at paggawa ng nilalaman +- **Protocol ng Model Context**: Panimula sa MCP at ang papel nito sa komunikasyon ng AI agent +- **Mga Praktikal na Aplikasyon**: Mga totoong senaryo kabilang ang mga chatbot at pagbuo ng nilalaman - **[→ Simulan ang Kabanata 1](./01-IntroToGenAI/README.md)** -### **Kabanata 2: Pagsasaayos ng Development Environment** -- **Multi-Provider Configuration**: Ayusin ang GitHub Models, Azure OpenAI, at OpenAI Java SDK integrations -- **Spring Boot + Spring AI**: Pinakamahuhusay na kasanayan para sa enterprise AI application development -- **GitHub Models**: Libreng access sa AI model para sa prototyping at pag-aaral (hindi kailangan ng credit card) -- **Mga Tools sa Development**: Docker containers, VS Code, at kaayusan ng GitHub Codespaces +### **Kabanata 2: Pag-setup ng Development Environment** +- **Konfigurasyon ng Maramihang Provider**: I-set up ang GitHub Models, Azure OpenAI, at OpenAI Java SDK integrations +- **Spring Boot + Spring AI**: Mga pinakamahuhusay na gawi para sa pag-develop ng enterprise AI application +- **GitHub Models**: Libre na pag-access sa AI model para sa prototyping at pagkatuto (hindi kailangan ng credit card) +- **Mga Development Tools**: Docker containers, VS Code, at GitHub Codespaces konfigurasyon - **[→ Simulan ang Kabanata 2](./02-SetupDevEnvironment/README.md)** -### **Kabanata 3: Pangunahing Teknik sa Generative AI** -- **Prompt Engineering**: Mga teknik para sa pinakamainam na tugon ng AI model -- **Embeddings at Vector Operations**: Ipatupad ang semantic search at similarity matching -- **Retrieval-Augmented Generation (RAG)**: Pagsamahin ang AI sa sarili mong mga pinagkukunan ng datos +### **Kabanata 3: Pangunahing Teknik ng Generative AI** +- **Prompt Engineering**: Mga teknik para sa optimal na tugon ng AI model +- **Embeddings at Vector Operations**: Magpatupad ng semantic search at similarity matching +- **Retrieval-Augmented Generation (RAG)**: Pagsamahin ang AI sa iyong sariling mga pinagkukunan ng data - **Function Calling**: Palawakin ang kakayahan ng AI gamit ang custom na mga tool at plugin - **[→ Simulan ang Kabanata 3](./03-CoreGenerativeAITechniques/README.md)** ### **Kabanata 4: Mga Praktikal na Aplikasyon at Proyekto** -- **Pet Story Generator** (`petstory/`): Malikhaing paggawa ng nilalaman gamit ang GitHub Models +- **Pet Story Generator** (`petstory/`): Malikhaing pagbuo ng nilalaman gamit ang GitHub Models - **Foundry Local Demo** (`foundrylocal/`): Lokal na integrasyon ng AI model gamit ang OpenAI Java SDK - **MCP Calculator Service** (`calculator/`): Pangunahing implementasyon ng Model Context Protocol gamit ang Spring AI - **[→ Simulan ang Kabanata 4](./04-PracticalSamples/README.md)** -### **Kabanata 5: Responsableng Pag-unlad ng AI** -- **Kaligtasan ng GitHub Models**: Subukan ang built-in na content filtering at mga mekanismo ng kaligtasan (hard blocks at soft refusals) -- **Responsableng AI Demo**: Hands-on na halimbawa na nagpapakita kung paano gumagana ang modernong AI safety systems sa praktika -- **Pinakamahuhusay na Kasanayan**: Mahahalagang gabay para sa etikal na pag-develop at deployment ng AI +### **Kabanata 5: Responsableng Pag-develop ng AI** +- **Kaligtasan ng GitHub Models**: Subukan ang naka-built-in na content filtering at mga safety mechanism (mahigpit na paghihigpit at malumanay na pagtanggi) +- **Responsableng AI Demo**: Hands-on na halimbawa ng kung paano gumagana ang mga modernong sistema ng kaligtasan ng AI sa praktika +- **Pinakamahuhusay na Gawi**: Mahahalagang patnubay para sa etikal na pag-develop at deployment ng AI - **[→ Simulan ang Kabanata 5](./05-ResponsibleGenAI/README.md)** ## Karagdagang Mga Mapagkukunan @@ -96,7 +87,7 @@ CO_OP_TRANSLATOR_METADATA: --- -### Azure / Edge / MCP / Mga Agent +### Azure / Edge / MCP / Agents [![AZD para sa mga Baguhan](https://img.shields.io/badge/AZD%20for%20Beginners-0078D4?style=for-the-badge&labelColor=E5E7EB&color=0078D4)](https://github.com/microsoft/AZD-for-beginners?WT.mc_id=academic-105485-koreyst) [![Edge AI para sa mga Baguhan](https://img.shields.io/badge/Edge%20AI%20for%20Beginners-00B8E4?style=for-the-badge&labelColor=E5E7EB&color=00B8E4)](https://github.com/microsoft/edgeai-for-beginners?WT.mc_id=academic-105485-koreyst) [![MCP para sa mga Baguhan](https://img.shields.io/badge/MCP%20for%20Beginners-009688?style=for-the-badge&labelColor=E5E7EB&color=009688)](https://github.com/microsoft/mcp-for-beginners?WT.mc_id=academic-105485-koreyst) @@ -117,31 +108,31 @@ CO_OP_TRANSLATOR_METADATA: [![Data Science para sa mga Baguhan](https://img.shields.io/badge/Data%20Science%20for%20Beginners-84CC16?style=for-the-badge&labelColor=E5E7EB&color=84CC16)](https://aka.ms/datascience-beginners?WT.mc_id=academic-105485-koreyst) [![AI para sa mga Baguhan](https://img.shields.io/badge/AI%20for%20Beginners-A3E635?style=for-the-badge&labelColor=E5E7EB&color=A3E635)](https://aka.ms/ai-beginners?WT.mc_id=academic-105485-koreyst) [![Cybersecurity para sa mga Baguhan](https://img.shields.io/badge/Cybersecurity%20for%20Beginners-F97316?style=for-the-badge&labelColor=E5E7EB&color=F97316)](https://github.com/microsoft/Security-101?WT.mc_id=academic-96948-sayoung) -[![Web Dev para sa mga Baguhan](https://img.shields.io/badge/Web%20Dev%20for%20Beginners-EC4899?style=for-the-badge&labelColor=E5E7EB&color=EC4899)](https://aka.ms/webdev-beginners?WT.mc_id=academic-105485-koreyst) -[![IoT para sa mga Nagsisimula](https://img.shields.io/badge/IoT%20for%20Beginners-14B8A6?style=for-the-badge&labelColor=E5E7EB&color=14B8A6)](https://aka.ms/iot-beginners?WT.mc_id=academic-105485-koreyst) -[![XR Development para sa mga Nagsisimula](https://img.shields.io/badge/XR%20Development%20for%20Beginners-38BDF8?style=for-the-badge&labelColor=E5E7EB&color=38BDF8)](https://github.com/microsoft/xr-development-for-beginners?WT.mc_id=academic-105485-koreyst) +[![Web Dev for Beginners](https://img.shields.io/badge/Web%20Dev%20for%20Beginners-EC4899?style=for-the-badge&labelColor=E5E7EB&color=EC4899)](https://aka.ms/webdev-beginners?WT.mc_id=academic-105485-koreyst) +[![IoT for Beginners](https://img.shields.io/badge/IoT%20for%20Beginners-14B8A6?style=for-the-badge&labelColor=E5E7EB&color=14B8A6)](https://aka.ms/iot-beginners?WT.mc_id=academic-105485-koreyst) +[![XR Development for Beginners](https://img.shields.io/badge/XR%20Development%20for%20Beginners-38BDF8?style=for-the-badge&labelColor=E5E7EB&color=38BDF8)](https://github.com/microsoft/xr-development-for-beginners?WT.mc_id=academic-105485-koreyst) --- ### Copilot Series -[![Copilot para sa AI Paired Programming](https://img.shields.io/badge/Copilot%20for%20AI%20Paired%20Programming-FACC15?style=for-the-badge&labelColor=E5E7EB&color=FACC15)](https://aka.ms/GitHubCopilotAI?WT.mc_id=academic-105485-koreyst) -[![Copilot para sa C#/.NET](https://img.shields.io/badge/Copilot%20for%20C%23/.NET-FBBF24?style=for-the-badge&labelColor=E5E7EB&color=FBBF24)](https://github.com/microsoft/mastering-github-copilot-for-dotnet-csharp-developers?WT.mc_id=academic-105485-koreyst) +[![Copilot for AI Paired Programming](https://img.shields.io/badge/Copilot%20for%20AI%20Paired%20Programming-FACC15?style=for-the-badge&labelColor=E5E7EB&color=FACC15)](https://aka.ms/GitHubCopilotAI?WT.mc_id=academic-105485-koreyst) +[![Copilot for C#/.NET](https://img.shields.io/badge/Copilot%20for%20C%23/.NET-FBBF24?style=for-the-badge&labelColor=E5E7EB&color=FBBF24)](https://github.com/microsoft/mastering-github-copilot-for-dotnet-csharp-developers?WT.mc_id=academic-105485-koreyst) [![Copilot Adventure](https://img.shields.io/badge/Copilot%20Adventure-FDE68A?style=for-the-badge&labelColor=E5E7EB&color=FDE68A)](https://github.com/microsoft/CopilotAdventures?WT.mc_id=academic-105485-koreyst) ## Pagkuha ng Tulong -Kung na-stuck ka o may mga tanong tungkol sa paggawa ng AI apps. Sumali sa mga kapwa nag-aaral at mga bihasang developer sa mga talakayan tungkol sa MCP. Isa itong suportadong komunidad kung saan malugod ang mga tanong at malayang ibinabahagi ang kaalaman. +Kung ikaw ay natigil o may mga tanong tungkol sa paggawa ng mga AI na app. Sumali sa mga kapwa nag-aaral at mga bihasang developer sa mga talakayan tungkol sa MCP. Ito ay isang suportadong komunidad kung saan malugod ang mga tanong at malaya ang pagbabahagi ng kaalaman. [![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) -Kung mayroon kang puna tungkol sa produkto o mga error habang gumagawa, bisitahin: +Kung mayroon kang puna tungkol sa produkto o nakaranas ng mga error habang gumagawa, bisitahin ang: [![Microsoft Foundry Developer Forum](https://img.shields.io/badge/GitHub-Microsoft_Foundry_Developer_Forum-blue?style=for-the-badge&logo=github&color=000000&logoColor=fff)](https://aka.ms/foundry/forum) --- -**Paalala**: -Ang dokumentong ito ay isinalin gamit ang AI translation service na [Co-op Translator](https://github.com/Azure/co-op-translator). Bagamat sinisikap naming maging tumpak, pakatandaan na maaaring may mga kamalian o di-tumpak na bahagi ang awtomatikong salin. Ang orihinal na dokumento sa orihinal nitong wika ang dapat ituring na pangunahing sanggunian. Para sa mahahalagang impormasyon, inirerekomenda ang propesyonal na pagsasalin ng tao. Hindi kami mananagot sa anumang hindi pagkakaintindihan o maling interpretasyon na maaaring magmula sa paggamit ng salin na ito. +**Paunawa**: +Ang dokumentong ito ay isinalin gamit ang AI translation service na [Co-op Translator](https://github.com/Azure/co-op-translator). Bagaman aming pinagsisikapang maging tumpak ang pagsasalin, mangyaring tandaan na ang awtomatikong pagsasalin ay maaaring maglaman ng mga pagkakamali o di-tumpak na impormasyon. Ang orihinal na dokumento sa sariling wika nito ang dapat ituring na pangunahing sanggunian. Para sa mahahalagang impormasyon, inirerekomenda ang propesyonal na pagsasalin ng tao. Hindi kami mananagot sa anumang hindi pagkakaunawaan o maling interpretasyon na maaaring magmula sa paggamit ng pagsasaling ito. \ No newline at end of file diff --git a/translations/tl/SECURITY.md b/translations/tl/SECURITY.md index 58d83d90..ed543f2c 100644 --- a/translations/tl/SECURITY.md +++ b/translations/tl/SECURITY.md @@ -1,12 +1,3 @@ - ## Seguridad Seryoso ang Microsoft pagdating sa seguridad ng aming mga software na produkto at serbisyo, kabilang na ang lahat ng source code repositories na pinamamahalaan sa pamamagitan ng aming mga organisasyon sa GitHub, tulad ng [Microsoft](https://github.com/Microsoft), [Azure](https://github.com/Azure), [DotNet](https://github.com/dotnet), [AspNet](https://github.com/aspnet), at [Xamarin](https://github.com/xamarin). diff --git a/translations/tl/SUPPORT.md b/translations/tl/SUPPORT.md index e8711357..e73e66e6 100644 --- a/translations/tl/SUPPORT.md +++ b/translations/tl/SUPPORT.md @@ -1,12 +1,3 @@ - # Suporta ## Paano maghain ng mga isyu at humingi ng tulong diff --git a/translations/tr/.co-op-translator.json b/translations/tr/.co-op-translator.json new file mode 100644 index 00000000..d1924181 --- /dev/null +++ b/translations/tr/.co-op-translator.json @@ -0,0 +1,92 @@ +{ + "01-IntroToGenAI/README.md": { + "original_hash": "75bfb080ca725e8a9aa9c80cae25fba1", + "translation_date": "2025-07-29T09:12:53+00:00", + "source_file": "01-IntroToGenAI/README.md", + "language_code": "tr" + }, + "02-SetupDevEnvironment/README.md": { + "original_hash": "96a30d42b9751a3d4e4b20e28d29d459", + "translation_date": "2026-01-28T04:59:15+00:00", + "source_file": "02-SetupDevEnvironment/README.md", + "language_code": "tr" + }, + "02-SetupDevEnvironment/examples/basic-chat-azure/README.md": { + "original_hash": "efd82efe50711d7e257eb943151d682c", + "translation_date": "2025-07-27T13:40:46+00:00", + "source_file": "02-SetupDevEnvironment/examples/basic-chat-azure/README.md", + "language_code": "tr" + }, + "02-SetupDevEnvironment/getting-started-azure-openai.md": { + "original_hash": "bfdb4b4eadbee3a59ef742439f58326a", + "translation_date": "2025-07-27T13:09:15+00:00", + "source_file": "02-SetupDevEnvironment/getting-started-azure-openai.md", + "language_code": "tr" + }, + "03-CoreGenerativeAITechniques/README.md": { + "original_hash": "685f55cb07de19b52a30ce6e8b6d889e", + "translation_date": "2025-08-28T22:05:45+00:00", + "source_file": "03-CoreGenerativeAITechniques/README.md", + "language_code": "tr" + }, + "04-PracticalSamples/README.md": { + "original_hash": "14c0a61ecc1cd2012a9c129236dfdf71", + "translation_date": "2025-07-29T09:12:37+00:00", + "source_file": "04-PracticalSamples/README.md", + "language_code": "tr" + }, + "04-PracticalSamples/calculator/README.md": { + "original_hash": "b6c16b5514d524e415a94f6097ee7d4c", + "translation_date": "2025-09-18T15:32:13+00:00", + "source_file": "04-PracticalSamples/calculator/README.md", + "language_code": "tr" + }, + "04-PracticalSamples/foundrylocal/README.md": { + "original_hash": "f787307400de59adc25a1404466a35f3", + "translation_date": "2025-11-04T07:24:21+00:00", + "source_file": "04-PracticalSamples/foundrylocal/README.md", + "language_code": "tr" + }, + "04-PracticalSamples/petstory/README.md": { + "original_hash": "0cbf68d605615a1e602c832a24616859", + "translation_date": "2025-07-25T11:23:15+00:00", + "source_file": "04-PracticalSamples/petstory/README.md", + "language_code": "tr" + }, + "05-ResponsibleGenAI/README.md": { + "original_hash": "301c05c2f57e60a6950b8c665b8bdbba", + "translation_date": "2025-07-29T15:50:19+00:00", + "source_file": "05-ResponsibleGenAI/README.md", + "language_code": "tr" + }, + "AGENTS.md": { + "original_hash": "afc90918d008cf77fd1982691f681306", + "translation_date": "2025-10-03T08:35:50+00:00", + "source_file": "AGENTS.md", + "language_code": "tr" + }, + "CODE_OF_CONDUCT.md": { + "original_hash": "442b123d034f92f7c384d2bbd28f99f1", + "translation_date": "2025-07-21T17:37:17+00:00", + "source_file": "CODE_OF_CONDUCT.md", + "language_code": "tr" + }, + "README.md": { + "original_hash": "125a08948d881c95628094f4dd1fbd43", + "translation_date": "2026-01-29T15:45:43+00:00", + "source_file": "README.md", + "language_code": "tr" + }, + "SECURITY.md": { + "original_hash": "57f14126c1c6add76b3aef3844dfe4e3", + "translation_date": "2025-07-21T17:36:06+00:00", + "source_file": "SECURITY.md", + "language_code": "tr" + }, + "SUPPORT.md": { + "original_hash": "b8ef73cc49dec68e2c885ee9df545129", + "translation_date": "2025-07-21T17:38:22+00:00", + "source_file": "SUPPORT.md", + "language_code": "tr" + } +} \ No newline at end of file diff --git a/translations/tr/01-IntroToGenAI/README.md b/translations/tr/01-IntroToGenAI/README.md index 691f37f5..5502db9d 100644 --- a/translations/tr/01-IntroToGenAI/README.md +++ b/translations/tr/01-IntroToGenAI/README.md @@ -1,12 +1,3 @@ - # Java Sürümü - Üretken Yapay Zekaya Giriş ## Öğrenecekleriniz diff --git a/translations/tr/02-SetupDevEnvironment/README.md b/translations/tr/02-SetupDevEnvironment/README.md index 9742af1e..e771d2e4 100644 --- a/translations/tr/02-SetupDevEnvironment/README.md +++ b/translations/tr/02-SetupDevEnvironment/README.md @@ -1,13 +1,254 @@ - +# Java için Üretken AI Geliştirme Ortamını Kurma +> **Hızlı Başlangıç**: Bulutta 2 dakikada kodlamaya başlayın - Atla [GitHub Codespaces Kurulumu](../../../02-SetupDevEnvironment) - yerel kurulum gerekmez ve github modellerini kullanır! + +> **Azure OpenAI ile ilgileniyor musunuz?**, yeni bir Azure OpenAI kaynağı oluşturma adımlarını içeren [Azure OpenAI Kurulum Kılavuzumuza](getting-started-azure-openai.md) bakın. + +## Öğrenecekleriniz + +- AI uygulamaları için Java geliştirme ortamı kurma +- Tercih ettiğiniz geliştirme ortamını seçme ve yapılandırma (öncelikli olarak Codespaces ile bulut, yerel geliştirme kapsayıcısı veya tam yerel kurulum) +- GitHub Modellerine bağlanarak kurulumunuzu test etme + +## İçindekiler + +- [Öğrenecekleriniz](../../../02-SetupDevEnvironment) +- [Giriş](../../../02-SetupDevEnvironment) +- [Adım 1: Geliştirme Ortamınızı Kurun](../../../02-SetupDevEnvironment) + - [Seçenek A: GitHub Codespaces (Önerilen)](../../../02-SetupDevEnvironment) + - [Seçenek B: Yerel Geliştirme Kapsayıcısı](../../../02-SetupDevEnvironment) + - [Seçenek C: Var Olan Yerel Kurulumunuzu Kullanın](../../../02-SetupDevEnvironment) +- [Adım 2: GitHub Kişisel Erişim Tokenı Oluşturun](../../../02-SetupDevEnvironment) +- [Adım 3: Kurulumunuzu Test Edin](../../../02-SetupDevEnvironment) +- [Sorun Giderme](../../../02-SetupDevEnvironment) +- [Özet](../../../02-SetupDevEnvironment) +- [Sonraki Adımlar](../../../02-SetupDevEnvironment) + +## Giriş + +Bu bölüm, geliştirme ortamınızın kurulmasına rehberlik edecektir. Birincil örnek olarak **GitHub Modellerini** kullanacağız çünkü ücretsizdir, sadece bir GitHub hesabıyla kolayca kurulabilir, kredi kartı gerektirmez ve deneyler için birden çok modele erişim sağlar. + +**Yerel kurulum gerekmez!** Tam bir geliştirme ortamı sağlayan GitHub Codespaces ile tarayıcınızdan hemen kodlamaya başlayabilirsiniz. + +Ekran Görüntüsü: GitHub Modelleri + +Bu kurs için [**GitHub Modelleri**](https://github.com/marketplace?type=models) kullanmanızı öneriyoruz çünkü: +- Başlamak için **ücretsiz** +- Sadece bir GitHub hesabı ile **kolay** kurulum +- **Kredi kartı gerektirmez** +- Deney için **birden fazla model** mevcut + +> **Not**: Bu eğitimde kullanılan GitHub Modellerinin ücretsiz sınırları şunlardır: +> - Dakikada 15 istek (günde 150) +> - İstek başına yaklaşık 8.000 kelime giriş, 4.000 kelime çıkış +> - 5 eşzamanlı istek +> +> Üretim ortamı için Azure AI Foundry Modellerine Azure hesabınızla yükseltin. Kodunuzun değişmesi gerekmez. [Azure AI Foundry belgelerine](https://learn.microsoft.com/azure/ai-foundry/foundry-models/how-to/quickstart-github-models) bakın. + + +## Adım 1: Geliştirme Ortamınızı Kurun + + + +Kurulum süresini en aza indirmek ve bu Java için Üretken AI kursu için gerekli tüm araçları sağlamak amacıyla önceden yapılandırılmış bir geliştirme kapsayıcısı oluşturduk. Tercih ettiğiniz geliştirme yaklaşımını seçin: + +### Ortam Kurulum Seçenekleri: + +#### Seçenek A: GitHub Codespaces (Önerilen) + +**Yerel kurulum gerektirmeden 2 dakikada kodlamaya başlayın!** + +1. Bu depoyu GitHub hesabınıza fork edin + > **Not**: Temel konfigürasyonu değiştirmek isterseniz, lütfen [Dev Container Yapılandırmasına](../../../.devcontainer/devcontainer.json) bakın +2. **Code** → **Codespaces** sekmesine tıklayın → **...** → **Yeni seçeneklerle...** seçeneği +3. Varsayılanları kullanın – bu, bu kurs için oluşturulmuş özel geliştirme kapsayıcısı **Generative AI Java Development Environment** yapılandırmasını seçecektir +4. **Codespace oluştur** butonuna tıklayın +5. Ortamın hazır olması için yaklaşık 2 dakika bekleyin +6. [Adım 2: GitHub Tokenı Oluştur](../../../02-SetupDevEnvironment) bölümüne geçin + +Ekran Görüntüsü: Codespaces alt menüsü + +Ekran Görüntüsü: Yeni seçeneklerle + +Ekran Görüntüsü: Codespace oluşturma seçenekleri + + +> **Codespaces Avantajları**: +> - Yerel kurulum gerekmez +> - Tarayıcısı olan her cihazda çalışır +> - Tüm araçlar ve bağımlılıklar önceden yapılandırılmıştır +> - Kişisel hesaplar için ayda 60 saat ücretsiz +> - Tüm öğrenciler için tutarlı geliştirme ortamı + +#### Seçenek B: Yerel Geliştirme Kapsayıcısı + +**Docker ile yerel geliştirmeyi tercih eden geliştiriciler için** + +1. Bu depoyu fork edip yerel makinenize klonlayın + > **Not**: Temel konfigürasyonu değiştirmek isterseniz, lütfen [Dev Container Yapılandırmasına](../../../.devcontainer/devcontainer.json) bakın +2. [Docker Desktop](https://www.docker.com/products/docker-desktop/) ve [VS Code](https://code.visualstudio.com/) yükleyin +3. VS Code’a [Dev Containers uzantısını](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers) kurun +4. Depo klasörünü VS Code’da açın +5. İstendiğinde, **Kapsayıcıda Yeniden Aç** seçeneğine tıklayın (veya `Ctrl+Shift+P` → "Dev Containers: Reopen in Container" komutunu kullanın) +6. Kapsayıcının oluşturulmasını ve başlamasını bekleyin +7. [Adım 2: GitHub Tokenı Oluştur](../../../02-SetupDevEnvironment) bölümüne geçin + +Ekran Görüntüsü: Geliştirme kapsayıcısı kurulumu + +Ekran Görüntüsü: Geliştirme kapsayıcısı derlemesi tamamlandı + +#### Seçenek C: Var Olan Yerel Kurulumunuzu Kullanın + +**Mevcut Java ortamı olan geliştiriciler için** + +Önkoşullar: +- [Java 21+](https://www.oracle.com/java/technologies/javase/jdk21-archive-downloads.html) +- [Maven 3.9+](https://maven.apache.org/download.cgi) +- [VS Code](https://code.visualstudio.com) veya tercih ettiğiniz IDE + +Adımlar: +1. Bu depoyu yerel makinenize klonlayın +2. Projeyi IDE'nizde açın +3. [Adım 2: GitHub Tokenı Oluştur](../../../02-SetupDevEnvironment) bölümüne geçin + +> **Profesyonel İpucu**: Düşük özellikli bir makineniz varsa ama yerelde VS Code kullanmak istiyorsanız, GitHub Codespaces’i kullunun! Yerel VS Code'unuzu bulut barındırılan Codespace’e bağlayarak en iyisini elde edebilirsiniz. + +Ekran Görüntüsü: oluşturulmuş yerel geliştirme kapsayıcısı örneği + + +## Adım 2: GitHub Kişisel Erişim Tokenı Oluşturun + +1. [GitHub Ayarları](https://github.com/settings/profile) sayfasına gidin ve profil menünüzden **Ayarlar** seçeneğini seçin. +2. Sol kenar çubuğunda **Geliştirici ayarları** (genellikle en altta) tıklayın. +3. **Kişisel erişim tokenları** altında **Ayrıntılı yetkilendirme tokenları**na tıklayın (veya bu doğrudan [bağlantıyı](https://github.com/settings/personal-access-tokens) kullanın). +4. **Yeni token oluştur** butonuna tıklayın. +5. "Token adı"na açıklayıcı bir isim girin (örn. `GenAI-Java-Course-Token`). +6. Bir son kullanma tarihi belirleyin (güvenlik için önerilen: 7 gün). +7. "Kaynak sahibi" olarak kullanıcı hesabınızı seçin. +8. "Depo erişimi" altında, GitHub Modelleriyle kullanmak istediğiniz depoları seçin (veya gerekirse "Tüm depolar"). +9. "Hesap izinleri" altında **Modeller**i bulun ve **Salt okunur** olarak ayarlayın. +10. **Token oluştur** butonuna tıklayın. +11. **Tokenı hemen kopyalayın ve kaydedin** – tekrar gösterilmeyecektir! + +> **Güvenlik İpucu**: Erişim tokenlarınızda minimum gerekli kapsamı ve en kısa pratik geçerlilik süresini kullanın. + +## Adım 3: Kurulumunuzu GitHub Modelleri Örneğiyle Test Edin + +Geliştirme ortamınız hazır olduğunda, GitHub Modelleri entegrasyonunu [`02-SetupDevEnvironment/examples/github-models`](../../../02-SetupDevEnvironment/examples/github-models) altındaki örnek uygulamamızla test edelim. + +1. Geliştirme ortamınızda terminali açın. +2. GitHub Modelleri örnek dizinine gidin: + ```bash + cd 02-SetupDevEnvironment/examples/github-models + ``` +3. GitHub tokenınızı çevresel değişken olarak ayarlayın: + ```bash + # macOS/Linux + export GITHUB_TOKEN=your_token_here + + # Windows (Komut İstemi) + set GITHUB_TOKEN=your_token_here + + # Windows (PowerShell) + $env:GITHUB_TOKEN="your_token_here" + ``` + +4. Uygulamayı çalıştırın: + ```bash + mvn compile exec:java -Dexec.mainClass="com.example.githubmodels.App" + ``` + +Şu şekilde bir çıktı görmelisiniz: +```text +Using model: gpt-4.1-nano +Sending request to GitHub Models... +Response: Hello World! +``` + +### Örnek Kodu Anlamak + +İlk olarak, az önce çalıştırdığımız şeyi anlayalım. `examples/github-models` altındaki örnek, GitHub Modellerine bağlanmak için OpenAI Java SDK’sını kullanır: + +**Bu kod ne yapar:** +- Kişisel erişim tokenınızla GitHub Modellerine **bağlanır** +- AI modele basit bir "Merhaba Dünya!" mesajı **gönderir** +- AI yanıtını **alır** ve gösterir +- Kurulumunuzun doğru çalıştığını **doğrular** + +**Ana Bağımlılık** (`pom.xml` içinde): +```xml + + com.openai + openai-java + 2.12.0 + +``` + +**Ana Kod** (`App.java`): +```java +// OpenAI Java SDK kullanarak GitHub Modellerine bağlan +OpenAIClient client = OpenAIOkHttpClient.builder() + .apiKey(pat) + .baseUrl("https://models.inference.ai.azure.com") + .build(); + +// Sohbet tamamlama isteği oluştur +ChatCompletionCreateParams params = ChatCompletionCreateParams.builder() + .model(modelId) + .addSystemMessage("You are a concise assistant.") + .addUserMessage("Say Hello World!") + .build(); + +// Yapay zeka yanıtını al +ChatCompletion response = client.chat().completions().create(params); +System.out.println("Response: " + response.choices().get(0).message().content().orElse("No response content")); +``` + +## Özet + +Harika! Artık her şey hazır: + +- AI model erişimi için uygun izinlerle bir GitHub Kişisel Erişim Tokenı oluşturdunuz +- Java geliştirme ortamınızı çalıştırdınız (Codespaces, geliştirme kapsayıcıları veya yerel fark etmez) +- OpenAI Java SDK ile ücretsiz olarak GitHub Modellerine bağlandınız +- AI modelleri ile iletişim kuran basit bir örnekle her şeyin çalıştığını test ettiniz + +## Sonraki Adımlar + +[Bölüm 3: Temel Üretken AI Teknikleri](../03-CoreGenerativeAITechniques/README.md) + +## Sorun Giderme + +Sorun mu yaşıyorsunuz? İşte yaygın problemler ve çözümleri: + +- **Token çalışmıyor mu?** + - Tokenı eksiksiz ve boşluksuz kopyaladığınızdan emin olun + - Tokenın doğru şekilde çevresel değişken olarak ayarlandığını doğrulayın + - Tokenınızın izinlerinin doğru olduğunu kontrol edin (Modeller: Salt okunur) + +- **Maven bulunamadı mı?** + - Eğer dev container/Codespaces kullanıyorsanız, Maven önceden kurulmuş olmalı + - Yerel kurulumda Java 21+ ve Maven 3.9+ yüklü olduğundan emin olun + - Kurulumu doğrulamak için `mvn --version` komutunu deneyin + +- **Bağlantı sorunları mı?** + - İnternet bağlantınızı kontrol edin + - GitHub'ın ağınızdan erişilebilir olduğundan emin olun + - GitHub Modelleri uç noktasını engelleyen bir güvenlik duvarı olmadığından emin olun + +- **Geliştirme kapsayıcısı başlamıyor mu?** + - Docker Desktop'ın çalıştığını doğrulayın (yerel geliştirme için) + - Kapsayıcıyı yeniden oluşturmayı deneyin: `Ctrl+Shift+P` → "Dev Containers: Rebuild Container" + +- **Uygulama derleme hataları mı var?** + - Doğru dizinde olduğunuzdan emin olun: `02-SetupDevEnvironment/examples/github-models` + - Temizleyip yeniden derlemeyi deneyin: `mvn clean compile` + +> **Yardıma mı ihtiyacınız var?**: Hala sorun mu yaşıyorsunuz? Depoya bir issue açın, size yardımcı olalım. --- + +**Feragatname**: +Bu belge, AI çeviri hizmeti [Co-op Translator](https://github.com/Azure/co-op-translator) kullanılarak çevrilmiştir. Doğruluk için çaba göstersek de, otomatik çevirilerin hatalar veya yanlışlıklar içerebileceğini lütfen unutmayın. Orijinal belge, ana dilinde yetkili kaynak olarak kabul edilmelidir. Kritik bilgiler için profesyonel insan çevirisi önerilir. Bu çevirinin kullanılması sonucunda oluşabilecek yanlış anlamalar veya yorum hatalarından sorumlu değiliz. + \ No newline at end of file diff --git a/translations/tr/02-SetupDevEnvironment/examples/basic-chat-azure/README.md b/translations/tr/02-SetupDevEnvironment/examples/basic-chat-azure/README.md index c722ad42..6b3b895d 100644 --- a/translations/tr/02-SetupDevEnvironment/examples/basic-chat-azure/README.md +++ b/translations/tr/02-SetupDevEnvironment/examples/basic-chat-azure/README.md @@ -1,12 +1,3 @@ - # Azure OpenAI ile Temel Sohbet - Uçtan Uca Örnek Bu örnek, Azure OpenAI'ye bağlanan ve kurulumunuzu test eden basit bir Spring Boot uygulamasının nasıl oluşturulacağını gösterir. diff --git a/translations/tr/02-SetupDevEnvironment/getting-started-azure-openai.md b/translations/tr/02-SetupDevEnvironment/getting-started-azure-openai.md index 2e2c57ab..cd4500a9 100644 --- a/translations/tr/02-SetupDevEnvironment/getting-started-azure-openai.md +++ b/translations/tr/02-SetupDevEnvironment/getting-started-azure-openai.md @@ -1,12 +1,3 @@ - # Azure OpenAI için Geliştirme Ortamını Kurma > **Hızlı Başlangıç**: Bu kılavuz Azure OpenAI kurulumu içindir. Ücretsiz modellerle hemen başlamak için [GitHub Modelleri ve Codespaces](./README.md#quick-start-cloud) kullanabilirsiniz. diff --git a/translations/tr/03-CoreGenerativeAITechniques/README.md b/translations/tr/03-CoreGenerativeAITechniques/README.md index 629bda14..20fe0e89 100644 --- a/translations/tr/03-CoreGenerativeAITechniques/README.md +++ b/translations/tr/03-CoreGenerativeAITechniques/README.md @@ -1,12 +1,3 @@ - # Çekirdek Üretken Yapay Zeka Teknikleri Eğitimi ## İçindekiler diff --git a/translations/tr/04-PracticalSamples/README.md b/translations/tr/04-PracticalSamples/README.md index d65ae649..57bb6ef5 100644 --- a/translations/tr/04-PracticalSamples/README.md +++ b/translations/tr/04-PracticalSamples/README.md @@ -1,12 +1,3 @@ - # Pratik Uygulamalar ve Projeler ## Öğrenecekleriniz diff --git a/translations/tr/04-PracticalSamples/calculator/README.md b/translations/tr/04-PracticalSamples/calculator/README.md index 44f49a82..483c0a0e 100644 --- a/translations/tr/04-PracticalSamples/calculator/README.md +++ b/translations/tr/04-PracticalSamples/calculator/README.md @@ -1,12 +1,3 @@ - # MCP Hesap Makinesi Eğitimi Yeni Başlayanlar İçin ## İçindekiler diff --git a/translations/tr/04-PracticalSamples/foundrylocal/README.md b/translations/tr/04-PracticalSamples/foundrylocal/README.md index 6840dcd5..fed2fec9 100644 --- a/translations/tr/04-PracticalSamples/foundrylocal/README.md +++ b/translations/tr/04-PracticalSamples/foundrylocal/README.md @@ -1,12 +1,3 @@ - # Foundry Local Spring Boot Eğitimi ## İçindekiler diff --git a/translations/tr/04-PracticalSamples/petstory/README.md b/translations/tr/04-PracticalSamples/petstory/README.md index 85d93892..1c38ad0c 100644 --- a/translations/tr/04-PracticalSamples/petstory/README.md +++ b/translations/tr/04-PracticalSamples/petstory/README.md @@ -1,12 +1,3 @@ - # Evcil Hayvan Hikaye Üretici Başlangıç Eğitimi ## İçindekiler diff --git a/translations/tr/05-ResponsibleGenAI/README.md b/translations/tr/05-ResponsibleGenAI/README.md index 1634f6d4..c4f48fc9 100644 --- a/translations/tr/05-ResponsibleGenAI/README.md +++ b/translations/tr/05-ResponsibleGenAI/README.md @@ -1,12 +1,3 @@ - # Sorumlu Üretken Yapay Zeka ## Öğrenecekleriniz diff --git a/translations/tr/AGENTS.md b/translations/tr/AGENTS.md index d36fd92f..f0ba226d 100644 --- a/translations/tr/AGENTS.md +++ b/translations/tr/AGENTS.md @@ -1,12 +1,3 @@ - # AGENTS.md ## Proje Genel Bakış diff --git a/translations/tr/CODE_OF_CONDUCT.md b/translations/tr/CODE_OF_CONDUCT.md index 450cf0a1..f9c09fef 100644 --- a/translations/tr/CODE_OF_CONDUCT.md +++ b/translations/tr/CODE_OF_CONDUCT.md @@ -1,12 +1,3 @@ - # Microsoft Açık Kaynak Davranış Kuralları Bu proje, [Microsoft Açık Kaynak Davranış Kuralları](https://opensource.microsoft.com/codeofconduct/) benimsemiştir. diff --git a/translations/tr/README.md b/translations/tr/README.md index 1765ca3e..1e513591 100644 --- a/translations/tr/README.md +++ b/translations/tr/README.md @@ -1,91 +1,82 @@ - # Yeni Başlayanlar için Üretken Yapay Zeka - Java Sürümü [![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) ![Yeni Başlayanlar için Üretken Yapay Zeka - Java Sürümü](../../translated_images/tr/beg-genai-series.8b48be9951cc574c.webp) -**Zaman Taahhüdü**: Tüm atölye online olarak yerel kuruluma gerek olmadan tamamlanabilir. Ortam kurulumu 2 dakika sürer, örnekleri keşfetmek ise keşif derinliğine bağlı olarak 1-3 saat arası zaman alır. +**Zaman Taahhüdü**: Tüm atölye çevrimiçi tamamlanabilir, yerel kurulum gerekmez. Ortam kurulumu 2 dakika alır, örnekleri keşfetmek ise keşfetme derinliğine bağlı olarak 1-3 saat sürer. > **Hızlı Başlangıç** -1. Bu depo yerel GitHub hesabınıza fork edin -2. **Code** → **Codespaces** sekmesi → **...** → **New with options...** tıklayın -3. Varsayılanları kullanın – bu kursta oluşturulan Geliştirme konteynerini seçecektir -4. **Create codespace** tıklayın +1. Bu depoyu GitHub hesabınıza çatallayın +2. **Code** → **Codespaces** sekmesine tıklayın → **...** → **New with options...** seçeneğine tıklayın +3. Varsayılanları kullanın – bu, bu kurs için oluşturulmuş Geliştirme konteynerini seçer +4. **Create codespace** butonuna tıklayın 5. Ortamın hazır olması için yaklaşık 2 dakika bekleyin 6. Doğrudan [İlk örneğe](./02-SetupDevEnvironment/README.md#step-2-create-a-github-personal-access-token) atlayın -> **Yerelde Klonlamayı mı Tercih Ediyorsunuz?** +> **Yerelde Kopyalamayı mı Tercih Ediyorsunuz?** > -> Bu depo, indirme boyutunu önemli ölçüde artıran 50'den fazla dil çevirisi içerir. Çeviriler olmadan klonlamak için sparse checkout kullanın: +> Bu depo 50'den fazla dil çevirisi içerir, bu da indirme boyutunu önemli ölçüde artırır. Çeviriler olmadan klonlamak için sparse checkout kullanın: > ```bash > git clone --filter=blob:none --sparse https://github.com/microsoft/Generative-AI-for-beginners-java.git > cd Generative-AI-for-beginners-java > git sparse-checkout set --no-cone '/*' '!translations' '!translated_images' > ``` -> Bu, kursu tamamlamak için ihtiyacınız olan her şeyi çok daha hızlı bir indirme ile sunar. +> Bu, kursu tamamlamak için ihtiyacınız olan her şeyi çok daha hızlı bir indirme ile sağlar. ## Çok Dilli Destek -### GitHub Action ile Desteklenir (Otomatik ve Her Zaman Güncel) +### GitHub Action ile Desteklenmektedir (Otomatik ve Her Zaman Güncel) -[Arapça](../ar/README.md) | [Bengalce](../bn/README.md) | [Bulgarca](../bg/README.md) | [Burmaca (Myanmar)](../my/README.md) | [Çince (Basitleştirilmiş)](../zh/README.md) | [Çince (Geleneksel, Hong Kong)](../hk/README.md) | [Çince (Geleneksel, Macau)](../mo/README.md) | [Çince (Geleneksel, Tayvan)](../tw/README.md) | [Hırvatça](../hr/README.md) | [Çekçe](../cs/README.md) | [Danca](../da/README.md) | [Flemenkçe](../nl/README.md) | [Estonca](../et/README.md) | [Fince](../fi/README.md) | [Fransızca](../fr/README.md) | [Almanca](../de/README.md) | [Yunanca](../el/README.md) | [İbranice](../he/README.md) | [Hintçe](../hi/README.md) | [Macarca](../hu/README.md) | [Endonezce](../id/README.md) | [İtalyanca](../it/README.md) | [Japonca](../ja/README.md) | [Kannada](../kn/README.md) | [Korece](../ko/README.md) | [Litvanca](../lt/README.md) | [Malayca](../ms/README.md) | [Malayalamca](../ml/README.md) | [Marathi](../mr/README.md) | [Nepalce](../ne/README.md) | [Nijerya Pidgin](../pcm/README.md) | [Norveççe](../no/README.md) | [Farsça (Persian)](../fa/README.md) | [Lehçe](../pl/README.md) | [Portekizce (Brezilya)](../br/README.md) | [Portekizce (Portekiz)](../pt/README.md) | [Pencapça (Gurmukhi)](../pa/README.md) | [Romence](../ro/README.md) | [Rusça](../ru/README.md) | [Sırpça (Kiril)](../sr/README.md) | [Slovakça](../sk/README.md) | [Slovence](../sl/README.md) | [İspanyolca](../es/README.md) | [Svahili](../sw/README.md) | [İsveççe](../sv/README.md) | [Tagalogca (Filipinler)](../tl/README.md) | [Tamilce](../ta/README.md) | [Telugu](../te/README.md) | [Tayca](../th/README.md) | [Türkçe](./README.md) | [Ukraynaca](../uk/README.md) | [Urduca](../ur/README.md) | [Vietnamca](../vi/README.md) +[Arapça](../ar/README.md) | [Bengalce](../bn/README.md) | [Bulgarca](../bg/README.md) | [Birmanca (Myanmar)](../my/README.md) | [Çince (Basitleştirilmiş)](../zh-CN/README.md) | [Çince (Geleneksel, Hong Kong)](../zh-HK/README.md) | [Çince (Geleneksel, Macau)](../zh-MO/README.md) | [Çince (Geleneksel, Tayvan)](../zh-TW/README.md) | [Hırvatça](../hr/README.md) | [Çekçe](../cs/README.md) | [Danca](../da/README.md) | [Flemenkçe](../nl/README.md) | [Estonca](../et/README.md) | [Fince](../fi/README.md) | [Fransızca](../fr/README.md) | [Almanca](../de/README.md) | [Yunanca](../el/README.md) | [İbranice](../he/README.md) | [Hintçe](../hi/README.md) | [Macarca](../hu/README.md) | [Endonezce](../id/README.md) | [İtalyanca](../it/README.md) | [Japonca](../ja/README.md) | [Kannada](../kn/README.md) | [Korece](../ko/README.md) | [Litvanca](../lt/README.md) | [Malayca](../ms/README.md) | [Malayalamca](../ml/README.md) | [Marathi](../mr/README.md) | [Nepalce](../ne/README.md) | [Nijerya Pidgin](../pcm/README.md) | [Norveççe](../no/README.md) | [Farsça](../fa/README.md) | [Lehçe](../pl/README.md) | [Portekizce (Brezilya)](../pt-BR/README.md) | [Portekizce (Portekiz)](../pt-PT/README.md) | [Punjabca (Gurmukhi)](../pa/README.md) | [Rumence](../ro/README.md) | [Rusça](../ru/README.md) | [Sırpça (Kiril)](../sr/README.md) | [Slovakça](../sk/README.md) | [Slovence](../sl/README.md) | [İspanyolca](../es/README.md) | [Svahili](../sw/README.md) | [İsveççe](../sv/README.md) | [Tagalogca (Filipince)](../tl/README.md) | [Tamilce](../ta/README.md) | [Telugu](../te/README.md) | [Tayca](../th/README.md) | [Türkçe](./README.md) | [Ukraynaca](../uk/README.md) | [Urduca](../ur/README.md) | [Vietnamca](../vi/README.md) -> **Yerelde Klonlamayı mı Tercih Ediyorsunuz?** +> **Yerelde Kopyalamayı mı Tercih Ediyorsunuz?** -> Bu depo, indirme boyutunu önemli ölçüde artıran 50'den fazla dil çevirisi içerir. Çeviriler olmadan klonlamak için sparse checkout kullanın: +> Bu depo 50'den fazla dil çevirisi içerir, bu da indirme boyutunu önemli ölçüde artırır. Çeviriler olmadan klonlamak için sparse checkout kullanın: > ```bash > git clone --filter=blob:none --sparse https://github.com/microsoft/Generative-AI-for-beginners-java.git > cd Generative-AI-for-beginners-java > git sparse-checkout set --no-cone '/*' '!translations' '!translated_images' > ``` -> Bu, kursu tamamlamak için ihtiyacınız olan her şeyi çok daha hızlı bir indirme ile sunar. +> Bu, kursu tamamlamak için ihtiyacınız olan her şeyi çok daha hızlı bir indirme ile sağlar. -## Kurs Yapısı & Öğrenme Yolu +## Kurs Yapısı ve Öğrenme Yolu ### **Bölüm 1: Üretken Yapay Zekaya Giriş** -- **Temel Kavramlar**: Büyük Dil Modelleri, tokenlar, gömme (embedding) yapıları ve yapay zeka yeteneklerinin anlaşılması +- **Temel Kavramlar**: Büyük Dil Modelleri, tokenlar, gömme işlemleri ve yapay zeka yeteneklerinin anlaşılması - **Java AI Ekosistemi**: Spring AI ve OpenAI SDK'larının genel bakışı -- **Model Context Protocol**: MCP'ye giriş ve AI ajan iletişimindeki rolü -- **Pratik Uygulamalar**: Sohbet botları ve içerik oluşturma gibi gerçek dünya senaryoları -- **[→ Bölüm 1'i Başlat](./01-IntroToGenAI/README.md)** - -### **Bölüm 2: Geliştirme Ortamının Kurulması** -- **Çoklu Sağlayıcı Yapılandırması**: GitHub Modelleri, Azure OpenAI ve OpenAI Java SDK entegrasyonlarının kurulması -- **Spring Boot + Spring AI**: Kurumsal AI uygulama geliştirme için en iyi uygulamalar -- **GitHub Modelleri**: Prototip oluşturma ve öğrenme için ücretsiz AI model erişimi (kredi kartı gerektirmez) -- **Geliştirme Araçları**: Docker konteynerleri, VS Code ve GitHub Codespaces yapılandırması -- **[→ Bölüm 2'yi Başlat](./02-SetupDevEnvironment/README.md)** - -### **Bölüm 3: Temel Üretken AI Teknikleri** -- **Prompt Mühendisliği**: AI modelinden en iyi yanıtları almak için teknikler -- **Embedding ve Vektör Operasyonları**: Anlamsal arama ve benzerlik eşleştirme uygulamaları -- **Retrieval-Augmented Generation (RAG)**: AI'yı kendi veri kaynaklarınızla birleştirme -- **Fonksiyon Çağrısı**: AI yeteneklerini özel araçlar ve eklentilerle genişletme -- **[→ Bölüm 3'ü Başlat](./03-CoreGenerativeAITechniques/README.md)** - -### **Bölüm 4: Pratik Uygulamalar & Projeler** -- **Pet Story Generator** (`petstory/`): GitHub Modelleri ile yaratıcı içerik oluşturma -- **Foundry Local Demo** (`foundrylocal/`): OpenAI Java SDK ile yerel AI model entegrasyonu -- **MCP Calculator Service** (`calculator/`): Spring AI ile temel Model Context Protocol uygulaması -- **[→ Bölüm 4'ü Başlat](./04-PracticalSamples/README.md)** - -### **Bölüm 5: Sorumlu AI Geliştirme** -- **GitHub Modelleri Güvenliği**: Yerleşik içerik filtreleme ve güvenlik mekanizmalarının (sert engeller ve yumuşak reddetmeler) testi -- **Sorumlu AI Demosu**: Modern AI güvenlik sistemlerinin pratik örneği -- **En İyi Uygulamalar**: Etik AI geliştirme ve dağıtımı için temel rehber İlkeleri -- **[→ Bölüm 5'i Başlat](./05-ResponsibleGenAI/README.md)** +- **Model Bağlam Protokolü**: MCP'ye giriş ve yapay zeka ajanları arasındaki iletişimdeki rolü +- **Pratik Uygulamalar**: Sohbet botları ve içerik üretimi dahil gerçek dünya senaryoları +- **[→ Bölüm 1’e Başla](./01-IntroToGenAI/README.md)** + +### **Bölüm 2: Geliştirme Ortamı Kurulumu** +- **Çoklu Sağlayıcı Konfigürasyonu**: GitHub Modelleri, Azure OpenAI ve OpenAI Java SDK entegrasyonlarının kurulumu +- **Spring Boot + Spring AI**: Kurumsal yapay zeka uygulama geliştirme için en iyi uygulamalar +- **GitHub Modelleri**: Prototipleme ve öğrenme için ücretsiz yapay zeka modeli erişimi (kredi kartı gerektirmez) +- **Geliştirme Araçları**: Docker konteynerleri, VS Code ve GitHub Codespaces ayarları +- **[→ Bölüm 2’ye Başla](./02-SetupDevEnvironment/README.md)** + +### **Bölüm 3: Temel Üretken Yapay Zeka Teknikleri** +- **Prompt Mühendisliği**: Yapay zeka modelinden optimal cevaplar almak için teknikler +- **Gömme İşlemleri & Vektör Operasyonları**: Anlamsal arama ve benzerlik eşleştirme uygulaması +- **Retrieval-Augmented Generation (RAG)**: Yapay zekayı kendi veri kaynaklarınızla birleştirme +- **Fonksiyon Çağrıları**: Yapay zeka yeteneklerini özel araçlar ve eklentiler ile genişletme +- **[→ Bölüm 3’e Başla](./03-CoreGenerativeAITechniques/README.md)** + +### **Bölüm 4: Pratik Uygulamalar ve Projeler** +- **Evcil Hayvan Hikaye Üreticisi** (`petstory/`): GitHub Modelleri ile yaratıcı içerik üretimi +- **Foundry Yerel Demo** (`foundrylocal/`): OpenAI Java SDK ile yerel yapay zeka modeli entegrasyonu +- **MCP Hesaplayıcı Servisi** (`calculator/`): Spring AI ile temel Model Bağlam Protokolü uygulaması +- **[→ Bölüm 4’e Başla](./04-PracticalSamples/README.md)** + +### **Bölüm 5: Sorumlu Yapay Zeka Geliştirme** +- **GitHub Modelleri Güvenliği**: Yerleşik içerik filtresi ve güvenlik mekanizmalarının testi (katı engellemeler ve nazik reddetmeler) +- **Sorumlu Yapay Zeka Demo**: Modern yapay zeka güvenlik sistemlerinin pratikte nasıl çalıştığını gösteren uygulamalı örnek +- **En İyi Uygulamalar**: Etik yapay zeka geliştirme ve dağıtım için temel yönergeler +- **[→ Bölüm 5’e Başla](./05-ResponsibleGenAI/README.md)** ## Ek Kaynaklar @@ -100,15 +91,15 @@ CO_OP_TRANSLATOR_METADATA: [![Yeni Başlayanlar için AZD](https://img.shields.io/badge/AZD%20for%20Beginners-0078D4?style=for-the-badge&labelColor=E5E7EB&color=0078D4)](https://github.com/microsoft/AZD-for-beginners?WT.mc_id=academic-105485-koreyst) [![Yeni Başlayanlar için Edge AI](https://img.shields.io/badge/Edge%20AI%20for%20Beginners-00B8E4?style=for-the-badge&labelColor=E5E7EB&color=00B8E4)](https://github.com/microsoft/edgeai-for-beginners?WT.mc_id=academic-105485-koreyst) [![Yeni Başlayanlar için MCP](https://img.shields.io/badge/MCP%20for%20Beginners-009688?style=for-the-badge&labelColor=E5E7EB&color=009688)](https://github.com/microsoft/mcp-for-beginners?WT.mc_id=academic-105485-koreyst) -[![Yeni Başlayanlar için AI Ajanlar](https://img.shields.io/badge/AI%20Agents%20for%20Beginners-00C49A?style=for-the-badge&labelColor=E5E7EB&color=00C49A)](https://github.com/microsoft/ai-agents-for-beginners?WT.mc_id=academic-105485-koreyst) +[![Yeni Başlayanlar için Yapay Zeka Ajanları](https://img.shields.io/badge/AI%20Agents%20for%20Beginners-00C49A?style=for-the-badge&labelColor=E5E7EB&color=00C49A)](https://github.com/microsoft/ai-agents-for-beginners?WT.mc_id=academic-105485-koreyst) --- -### Üretken AI Serisi -[![Yeni Başlayanlar için Üretken AI](https://img.shields.io/badge/Generative%20AI%20for%20Beginners-8B5CF6?style=for-the-badge&labelColor=E5E7EB&color=8B5CF6)](https://github.com/microsoft/generative-ai-for-beginners?WT.mc_id=academic-105485-koreyst) -[![Üretken AI (.NET)](https://img.shields.io/badge/Generative%20AI%20(.NET)-9333EA?style=for-the-badge&labelColor=E5E7EB&color=9333EA)](https://github.com/microsoft/Generative-AI-for-beginners-dotnet?WT.mc_id=academic-105485-koreyst) -[![Üretken AI (Java)](https://img.shields.io/badge/Generative%20AI%20(Java)-C084FC?style=for-the-badge&labelColor=E5E7EB&color=C084FC)](https://github.com/microsoft/generative-ai-for-beginners-java?WT.mc_id=academic-105485-koreyst) -[![Üretken AI (JavaScript)](https://img.shields.io/badge/Generative%20AI%20(JavaScript)-E879F9?style=for-the-badge&labelColor=E5E7EB&color=E879F9)](https://github.com/microsoft/generative-ai-with-javascript?WT.mc_id=academic-105485-koreyst) +### Üretken Yapay Zeka Serisi +[![Yeni Başlayanlar için Üretken Yapay Zeka](https://img.shields.io/badge/Generative%20AI%20for%20Beginners-8B5CF6?style=for-the-badge&labelColor=E5E7EB&color=8B5CF6)](https://github.com/microsoft/generative-ai-for-beginners?WT.mc_id=academic-105485-koreyst) +[![Üretken Yapay Zeka (.NET)](https://img.shields.io/badge/Generative%20AI%20(.NET)-9333EA?style=for-the-badge&labelColor=E5E7EB&color=9333EA)](https://github.com/microsoft/Generative-AI-for-beginners-dotnet?WT.mc_id=academic-105485-koreyst) +[![Üretken Yapay Zeka (Java)](https://img.shields.io/badge/Generative%20AI%20(Java)-C084FC?style=for-the-badge&labelColor=E5E7EB&color=C084FC)](https://github.com/microsoft/generative-ai-for-beginners-java?WT.mc_id=academic-105485-koreyst) +[![Üretken Yapay Zeka (JavaScript)](https://img.shields.io/badge/Generative%20AI%20(JavaScript)-E879F9?style=for-the-badge&labelColor=E5E7EB&color=E879F9)](https://github.com/microsoft/generative-ai-with-javascript?WT.mc_id=academic-105485-koreyst) --- @@ -117,31 +108,32 @@ CO_OP_TRANSLATOR_METADATA: [![Yeni Başlayanlar için Veri Bilimi](https://img.shields.io/badge/Data%20Science%20for%20Beginners-84CC16?style=for-the-badge&labelColor=E5E7EB&color=84CC16)](https://aka.ms/datascience-beginners?WT.mc_id=academic-105485-koreyst) [![Yeni Başlayanlar için Yapay Zeka](https://img.shields.io/badge/AI%20for%20Beginners-A3E635?style=for-the-badge&labelColor=E5E7EB&color=A3E635)](https://aka.ms/ai-beginners?WT.mc_id=academic-105485-koreyst) [![Yeni Başlayanlar için Siber Güvenlik](https://img.shields.io/badge/Cybersecurity%20for%20Beginners-F97316?style=for-the-badge&labelColor=E5E7EB&color=F97316)](https://github.com/microsoft/Security-101?WT.mc_id=academic-96948-sayoung) + [![Yeni Başlayanlar için Web Geliştirme](https://img.shields.io/badge/Web%20Dev%20for%20Beginners-EC4899?style=for-the-badge&labelColor=E5E7EB&color=EC4899)](https://aka.ms/webdev-beginners?WT.mc_id=academic-105485-koreyst) -[![Başlangıç Seviyesi için Nesnelerin İnterneti](https://img.shields.io/badge/IoT%20for%20Beginners-14B8A6?style=for-the-badge&labelColor=E5E7EB&color=14B8A6)](https://aka.ms/iot-beginners?WT.mc_id=academic-105485-koreyst) -[![Başlangıç Seviyesi için XR Geliştirme](https://img.shields.io/badge/XR%20Development%20for%20Beginners-38BDF8?style=for-the-badge&labelColor=E5E7EB&color=38BDF8)](https://github.com/microsoft/xr-development-for-beginners?WT.mc_id=academic-105485-koreyst) +[![Yeni Başlayanlar için IoT](https://img.shields.io/badge/IoT%20for%20Beginners-14B8A6?style=for-the-badge&labelColor=E5E7EB&color=14B8A6)](https://aka.ms/iot-beginners?WT.mc_id=academic-105485-koreyst) +[![Yeni Başlayanlar için XR Geliştirme](https://img.shields.io/badge/XR%20Development%20for%20Beginners-38BDF8?style=for-the-badge&labelColor=E5E7EB&color=38BDF8)](https://github.com/microsoft/xr-development-for-beginners?WT.mc_id=academic-105485-koreyst) --- ### Copilot Serisi -[![AI Eşliğinde Programlama için Copilot](https://img.shields.io/badge/Copilot%20for%20AI%20Paired%20Programming-FACC15?style=for-the-badge&labelColor=E5E7EB&color=FACC15)](https://aka.ms/GitHubCopilotAI?WT.mc_id=academic-105485-koreyst) +[![Yapay Zeka Eşliğinde Programlama için Copilot](https://img.shields.io/badge/Copilot%20for%20AI%20Paired%20Programming-FACC15?style=for-the-badge&labelColor=E5E7EB&color=FACC15)](https://aka.ms/GitHubCopilotAI?WT.mc_id=academic-105485-koreyst) [![C#/.NET için Copilot](https://img.shields.io/badge/Copilot%20for%20C%23/.NET-FBBF24?style=for-the-badge&labelColor=E5E7EB&color=FBBF24)](https://github.com/microsoft/mastering-github-copilot-for-dotnet-csharp-developers?WT.mc_id=academic-105485-koreyst) [![Copilot Macerası](https://img.shields.io/badge/Copilot%20Adventure-FDE68A?style=for-the-badge&labelColor=E5E7EB&color=FDE68A)](https://github.com/microsoft/CopilotAdventures?WT.mc_id=academic-105485-koreyst) ## Yardım Alma -Yapay zeka uygulamaları geliştirme konusunda takılırsanız veya sorularınız olursa, MCP hakkında tartışmalara katılın. Bu, soruların memnuniyetle karşılandığı ve bilginin özgürce paylaşıldığı destekleyici bir topluluktur. +Eğer takılırsanız veya AI uygulamaları geliştirme hakkında herhangi bir sorunuz olursa, diğer öğrenenler ve deneyimli geliştiricilerle MCP üzerine tartışmalara katılın. Burada sorular hoş karşılanır ve bilgi özgürce paylaşılır, destekleyici bir topluluktur. [![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) -Ürün geri bildiriminiz veya geliştirme sırasında karşılaştığınız hatalar için şurayı ziyaret edin: +Eğer ürünle ilgili geri bildirimde bulunmak veya geliştirme sırasında hatalarla karşılaşırsanız, ziyaret edin: -[![Microsoft Foundry Geliştirici Forumu](https://img.shields.io/badge/GitHub-Microsoft_Foundry_Developer_Forum-blue?style=for-the-badge&logo=github&color=000000&logoColor=fff)](https://aka.ms/foundry/forum) +[![Microsoft Foundry Developer Forum](https://img.shields.io/badge/GitHub-Microsoft_Foundry_Developer_Forum-blue?style=for-the-badge&logo=github&color=000000&logoColor=fff)](https://aka.ms/foundry/forum) --- -**Feragatname**: -Bu belge, AI çeviri servisi [Co-op Translator](https://github.com/Azure/co-op-translator) kullanılarak çevrilmiştir. Doğruluk için çaba gösterilse de, otomatik çevirilerin hatalar veya yanlışlıklar içerebileceğini lütfen unutmayınız. Orijinal belge, kendi dilinde yetkili kaynak olarak kabul edilmelidir. Kritik bilgiler için profesyonel insan çevirisi önerilir. Bu çevirinin kullanımı sonucu ortaya çıkabilecek herhangi bir yanlış anlama veya yanlış yorumdan sorumlu değiliz. +**Feragatname**: +Bu belge, AI çeviri hizmeti [Co-op Translator](https://github.com/Azure/co-op-translator) kullanılarak çevrilmiştir. Doğruluk için çaba göstersek de, otomatik çevirilerin hatalar veya yanlışlıklar içerebileceğini lütfen unutmayın. Orijinal belge, kendi dilinde yetkili kaynak olarak kabul edilmelidir. Kritik bilgiler için profesyonel insan çevirisi önerilir. Bu çevirinin kullanımı sonucunda oluşabilecek herhangi bir yanlış anlama veya yanlış yorumdan sorumlu tutulamayız. \ No newline at end of file diff --git a/translations/tr/SECURITY.md b/translations/tr/SECURITY.md index a03df666..9848fcbb 100644 --- a/translations/tr/SECURITY.md +++ b/translations/tr/SECURITY.md @@ -1,12 +1,3 @@ - ## Güvenlik Microsoft, yazılım ürünlerimizin ve hizmetlerimizin güvenliğini ciddiye alır. Bu, [Microsoft](https://github.com/Microsoft), [Azure](https://github.com/Azure), [DotNet](https://github.com/dotnet), [AspNet](https://github.com/aspnet) ve [Xamarin](https://github.com/xamarin) gibi GitHub organizasyonlarımız aracılığıyla yönetilen tüm kaynak kodu depolarını da kapsar. diff --git a/translations/tr/SUPPORT.md b/translations/tr/SUPPORT.md index 3fbca8ef..e6bfc90c 100644 --- a/translations/tr/SUPPORT.md +++ b/translations/tr/SUPPORT.md @@ -1,12 +1,3 @@ - # Destek ## Sorunları nasıl bildirebilir ve yardım alabilirsiniz diff --git a/translations/tw/02-SetupDevEnvironment/README.md b/translations/tw/02-SetupDevEnvironment/README.md deleted file mode 100644 index b5373cd0..00000000 --- a/translations/tw/02-SetupDevEnvironment/README.md +++ /dev/null @@ -1,13 +0,0 @@ - - - ---- - diff --git a/translations/tw/README.md b/translations/tw/README.md deleted file mode 100644 index 6f067356..00000000 --- a/translations/tw/README.md +++ /dev/null @@ -1,147 +0,0 @@ - -# 生成式 AI 初學者指南 - Java 版 -[![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) - -![生成式 AI 初學者指南 - Java 版](../../translated_images/tw/beg-genai-series.8b48be9951cc574c.webp) - -**時間投入**：整個工作坊可在線完成，無需本機設定。環境設定需 2 分鐘，探索範例需 1-3 小時，視探索深度而定。 - -> **快速開始** - -1. 將此程式庫分叉到您的 GitHub 帳戶 -2. 點選 **Code** → **Codespaces** 標籤 → **...** → **New with options...** -3. 使用預設值 – 這將選擇為本課程建立的開發容器 -4. 點選 **Create codespace** -5. 等待約 2 分鐘，環境即準備就緒 -6. 直接跳至 [第一個範例](./02-SetupDevEnvironment/README.md#step-2-create-a-github-personal-access-token) - -> **偏好本機複製？** -> -> 本程式庫包含超過 50 種語言翻譯，會大幅增加下載大小。若要不含翻譯的複製，請使用稀疏結帳： -> ```bash -> git clone --filter=blob:none --sparse https://github.com/microsoft/Generative-AI-for-beginners-java.git -> cd Generative-AI-for-beginners-java -> git sparse-checkout set --no-cone '/*' '!translations' '!translated_images' -> ``` -> 這樣可以更快速下載，且包含完成課程所需的一切。 - - -## 多語言支援 - -### 透過 GitHub Action 支援（自動且持續更新） - - -[阿拉伯語](../ar/README.md) | [孟加拉語](../bn/README.md) | [保加利亞語](../bg/README.md) | [緬甸語](../my/README.md) | [中文（簡體）](../zh/README.md) | [中文（繁體，香港）](../hk/README.md) | [中文（繁體，澳門）](../mo/README.md) | [中文（繁體，台灣）](./README.md) | [克羅埃西亞語](../hr/README.md) | [捷克語](../cs/README.md) | [丹麥語](../da/README.md) | [荷蘭語](../nl/README.md) | [愛沙尼亞語](../et/README.md) | [芬蘭語](../fi/README.md) | [法語](../fr/README.md) | [德語](../de/README.md) | [希臘語](../el/README.md) | [希伯來語](../he/README.md) | [印地語](../hi/README.md) | [匈牙利語](../hu/README.md) | [印尼語](../id/README.md) | [義大利語](../it/README.md) | [日語](../ja/README.md) | [坎那達語](../kn/README.md) | [韓語](../ko/README.md) | [立陶宛語](../lt/README.md) | [馬來語](../ms/README.md) | [馬拉雅拉姆語](../ml/README.md) | [馬拉地語](../mr/README.md) | [尼泊爾語](../ne/README.md) | [奈及利亞皮欽語](../pcm/README.md) | [挪威語](../no/README.md) | [波斯語（法爾西語）](../fa/README.md) | [波蘭語](../pl/README.md) | [葡萄牙語（巴西）](../br/README.md) | [葡萄牙語（葡萄牙）](../pt/README.md) | [旁遮普語（古魯穆奇）](../pa/README.md) | [羅馬尼亞語](../ro/README.md) | [俄語](../ru/README.md) | [塞爾維亞語（西里爾字母）](../sr/README.md) | [斯洛伐克語](../sk/README.md) | [斯洛維尼亞語](../sl/README.md) | [西班牙語](../es/README.md) | [斯瓦希里語](../sw/README.md) | [瑞典語](../sv/README.md) | [他加祿語（菲律賓語）](../tl/README.md) | [泰米爾語](../ta/README.md) | [泰盧固語](../te/README.md) | [泰語](../th/README.md) | [土耳其語](../tr/README.md) | [烏克蘭語](../uk/README.md) | [烏爾都語](../ur/README.md) | [越南語](../vi/README.md) - -> **偏好本機複製？** - -> 本程式庫包含超過 50 種語言翻譯，會大幅增加下載大小。若要不含翻譯的複製，請使用稀疏結帳： -> ```bash -> git clone --filter=blob:none --sparse https://github.com/microsoft/Generative-AI-for-beginners-java.git -> cd Generative-AI-for-beginners-java -> git sparse-checkout set --no-cone '/*' '!translations' '!translated_images' -> ``` -> 這樣可以更快速下載，且包含完成課程所需的一切。 - - -## 課程結構與學習路徑 - -### **第一章：生成式 AI 簡介** -- **核心概念**：認識大型語言模型、詞元、嵌入向量與 AI 能力 -- **Java AI 生態系統**：Spring AI 與 OpenAI SDK 簡介 -- **模型上下文協議**：介紹 MCP 及其在 AI 代理間通訊的角色 -- **實務應用**：包含聊天機器人與內容生成的真實案例 -- **[→ 開始第一章](./01-IntroToGenAI/README.md)** - -### **第二章：開發環境建置** -- **多平台配置**：設定 GitHub Models、Azure OpenAI 及 OpenAI Java SDK 整合 -- **Spring Boot + Spring AI**：企業 AI 應用程式開發最佳實務 -- **GitHub Models**：免費 AI 模型供原型與學習（無需信用卡） -- **開發工具**：Docker 容器、VS Code 與 GitHub Codespaces 設定 -- **[→ 開始第二章](./02-SetupDevEnvironment/README.md)** - -### **第三章：生成式 AI 核心技術** -- **提示工程**：最佳化 AI 模型回應的技巧 -- **嵌入向量與向量運算**：實作語意搜尋與相似度匹配 -- **檢索增強生成（RAG）**：將 AI 與您的資料來源結合 -- **函式呼叫**：透過自訂工具與外掛擴充 AI 功能 -- **[→ 開始第三章](./03-CoreGenerativeAITechniques/README.md)** - -### **第四章：實務應用與專案** -- **寵物故事產生器**（`petstory/`）：利用 GitHub Models 產生創意內容 -- **Foundry 本地示範**（`foundrylocal/`）：本地 AI 模型整合 OpenAI Java SDK -- **MCP 計算服務**（`calculator/`）：使用 Spring AI 實作基本模型上下文協議 -- **[→ 開始第四章](./04-PracticalSamples/README.md)** - -### **第五章：負責任的 AI 開發** -- **GitHub Models 安全性**：測試內建內容過濾與安全機制（硬阻擋與軟拒絕） -- **負責任 AI 示範**：動手範例展示現代 AI 安全系統如何運作 -- **最佳實務**：道德 AI 開發與部署之基本指南 -- **[→ 開始第五章](./05-ResponsibleGenAI/README.md)** - -## 額外資源 - - -### LangChain -[![LangChain4j 入門](https://img.shields.io/badge/LangChain4j%20for%20Beginners-22C55E?style=for-the-badge&&labelColor=E5E7EB&color=0553D6)](https://aka.ms/langchain4j-for-beginners) -[![LangChain.js 入門](https://img.shields.io/badge/LangChain.js%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=0553D6)](https://aka.ms/langchainjs-for-beginners?WT.mc_id=m365-94501-dwahlin) - ---- - -### Azure / Edge / MCP / Agents -[![AZD 入門](https://img.shields.io/badge/AZD%20for%20Beginners-0078D4?style=for-the-badge&labelColor=E5E7EB&color=0078D4)](https://github.com/microsoft/AZD-for-beginners?WT.mc_id=academic-105485-koreyst) -[![Edge AI 入門](https://img.shields.io/badge/Edge%20AI%20for%20Beginners-00B8E4?style=for-the-badge&labelColor=E5E7EB&color=00B8E4)](https://github.com/microsoft/edgeai-for-beginners?WT.mc_id=academic-105485-koreyst) -[![MCP 入門](https://img.shields.io/badge/MCP%20for%20Beginners-009688?style=for-the-badge&labelColor=E5E7EB&color=009688)](https://github.com/microsoft/mcp-for-beginners?WT.mc_id=academic-105485-koreyst) -[![AI Agents 入門](https://img.shields.io/badge/AI%20Agents%20for%20Beginners-00C49A?style=for-the-badge&labelColor=E5E7EB&color=00C49A)](https://github.com/microsoft/ai-agents-for-beginners?WT.mc_id=academic-105485-koreyst) - ---- - -### 生成式 AI 系列 -[![生成式 AI 初學者](https://img.shields.io/badge/Generative%20AI%20for%20Beginners-8B5CF6?style=for-the-badge&labelColor=E5E7EB&color=8B5CF6)](https://github.com/microsoft/generative-ai-for-beginners?WT.mc_id=academic-105485-koreyst) -[![生成式 AI (.NET)](https://img.shields.io/badge/Generative%20AI%20(.NET)-9333EA?style=for-the-badge&labelColor=E5E7EB&color=9333EA)](https://github.com/microsoft/Generative-AI-for-beginners-dotnet?WT.mc_id=academic-105485-koreyst) -[![生成式 AI (Java)](https://img.shields.io/badge/Generative%20AI%20(Java)-C084FC?style=for-the-badge&labelColor=E5E7EB&color=C084FC)](https://github.com/microsoft/generative-ai-for-beginners-java?WT.mc_id=academic-105485-koreyst) -[![生成式 AI (JavaScript)](https://img.shields.io/badge/Generative%20AI%20(JavaScript)-E879F9?style=for-the-badge&labelColor=E5E7EB&color=E879F9)](https://github.com/microsoft/generative-ai-with-javascript?WT.mc_id=academic-105485-koreyst) - ---- - -### 核心學習資源 -[![機器學習初學者](https://img.shields.io/badge/ML%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=22C55E)](https://aka.ms/ml-beginners?WT.mc_id=academic-105485-koreyst) -[![資料科學初學者](https://img.shields.io/badge/Data%20Science%20for%20Beginners-84CC16?style=for-the-badge&labelColor=E5E7EB&color=84CC16)](https://aka.ms/datascience-beginners?WT.mc_id=academic-105485-koreyst) -[![AI 初學者](https://img.shields.io/badge/AI%20for%20Beginners-A3E635?style=for-the-badge&labelColor=E5E7EB&color=A3E635)](https://aka.ms/ai-beginners?WT.mc_id=academic-105485-koreyst) -[![資安初學者](https://img.shields.io/badge/Cybersecurity%20for%20Beginners-F97316?style=for-the-badge&labelColor=E5E7EB&color=F97316)](https://github.com/microsoft/Security-101?WT.mc_id=academic-96948-sayoung) -[![網頁開發初學者](https://img.shields.io/badge/Web%20Dev%20for%20Beginners-EC4899?style=for-the-badge&labelColor=E5E7EB&color=EC4899)](https://aka.ms/webdev-beginners?WT.mc_id=academic-105485-koreyst) -[![IoT for Beginners](https://img.shields.io/badge/IoT%20for%20Beginners-14B8A6?style=for-the-badge&labelColor=E5E7EB&color=14B8A6)](https://aka.ms/iot-beginners?WT.mc_id=academic-105485-koreyst) -[![XR Development for Beginners](https://img.shields.io/badge/XR%20Development%20for%20Beginners-38BDF8?style=for-the-badge&labelColor=E5E7EB&color=38BDF8)](https://github.com/microsoft/xr-development-for-beginners?WT.mc_id=academic-105485-koreyst) - ---- - -### Copilot 系列 -[![Copilot for AI Paired Programming](https://img.shields.io/badge/Copilot%20for%20AI%20Paired%20Programming-FACC15?style=for-the-badge&labelColor=E5E7EB&color=FACC15)](https://aka.ms/GitHubCopilotAI?WT.mc_id=academic-105485-koreyst) -[![Copilot for C#/.NET](https://img.shields.io/badge/Copilot%20for%20C%23/.NET-FBBF24?style=for-the-badge&labelColor=E5E7EB&color=FBBF24)](https://github.com/microsoft/mastering-github-copilot-for-dotnet-csharp-developers?WT.mc_id=academic-105485-koreyst) -[![Copilot Adventure](https://img.shields.io/badge/Copilot%20Adventure-FDE68A?style=for-the-badge&labelColor=E5E7EB&color=FDE68A)](https://github.com/microsoft/CopilotAdventures?WT.mc_id=academic-105485-koreyst) - - -## 尋求協助 - -如果您遇到困難或對建立 AI 應用程式有任何問題，歡迎加入其他學習者與經驗豐富的開發人員，一同討論 MCP。這是一個支持性的社群，問題歡迎提出，知識自由分享。 - -[![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) - -如果您在建構過程中有產品反饋或錯誤，請造訪： - -[![Microsoft Foundry Developer Forum](https://img.shields.io/badge/GitHub-Microsoft_Foundry_Developer_Forum-blue?style=for-the-badge&logo=github&color=000000&logoColor=fff)](https://aka.ms/foundry/forum) - ---- - - -**免責聲明**： -本文件係使用 AI 翻譯服務 [Co-op Translator](https://github.com/Azure/co-op-translator) 進行翻譯。雖然我們致力於確保翻譯的準確性，但請注意自動翻譯結果可能包含錯誤或不準確之處。原始文件的母語版本應視為權威來源。對於關鍵資訊，建議採用專業人工翻譯。我們不對因使用本翻譯內容而產生的任何誤解或錯誤詮釋負責。 - \ No newline at end of file diff --git a/translations/uk/.co-op-translator.json b/translations/uk/.co-op-translator.json new file mode 100644 index 00000000..fa7ac96b --- /dev/null +++ b/translations/uk/.co-op-translator.json @@ -0,0 +1,92 @@ +{ + "01-IntroToGenAI/README.md": { + "original_hash": "75bfb080ca725e8a9aa9c80cae25fba1", + "translation_date": "2025-07-29T10:32:15+00:00", + "source_file": "01-IntroToGenAI/README.md", + "language_code": "uk" + }, + "02-SetupDevEnvironment/README.md": { + "original_hash": "96a30d42b9751a3d4e4b20e28d29d459", + "translation_date": "2026-01-28T05:29:22+00:00", + "source_file": "02-SetupDevEnvironment/README.md", + "language_code": "uk" + }, + "02-SetupDevEnvironment/examples/basic-chat-azure/README.md": { + "original_hash": "efd82efe50711d7e257eb943151d682c", + "translation_date": "2025-07-27T13:49:29+00:00", + "source_file": "02-SetupDevEnvironment/examples/basic-chat-azure/README.md", + "language_code": "uk" + }, + "02-SetupDevEnvironment/getting-started-azure-openai.md": { + "original_hash": "bfdb4b4eadbee3a59ef742439f58326a", + "translation_date": "2025-07-27T13:31:56+00:00", + "source_file": "02-SetupDevEnvironment/getting-started-azure-openai.md", + "language_code": "uk" + }, + "03-CoreGenerativeAITechniques/README.md": { + "original_hash": "685f55cb07de19b52a30ce6e8b6d889e", + "translation_date": "2025-08-28T22:20:18+00:00", + "source_file": "03-CoreGenerativeAITechniques/README.md", + "language_code": "uk" + }, + "04-PracticalSamples/README.md": { + "original_hash": "14c0a61ecc1cd2012a9c129236dfdf71", + "translation_date": "2025-07-29T10:31:59+00:00", + "source_file": "04-PracticalSamples/README.md", + "language_code": "uk" + }, + "04-PracticalSamples/calculator/README.md": { + "original_hash": "b6c16b5514d524e415a94f6097ee7d4c", + "translation_date": "2025-09-18T15:44:52+00:00", + "source_file": "04-PracticalSamples/calculator/README.md", + "language_code": "uk" + }, + "04-PracticalSamples/foundrylocal/README.md": { + "original_hash": "f787307400de59adc25a1404466a35f3", + "translation_date": "2025-11-04T07:37:40+00:00", + "source_file": "04-PracticalSamples/foundrylocal/README.md", + "language_code": "uk" + }, + "04-PracticalSamples/petstory/README.md": { + "original_hash": "0cbf68d605615a1e602c832a24616859", + "translation_date": "2025-07-25T12:11:06+00:00", + "source_file": "04-PracticalSamples/petstory/README.md", + "language_code": "uk" + }, + "05-ResponsibleGenAI/README.md": { + "original_hash": "301c05c2f57e60a6950b8c665b8bdbba", + "translation_date": "2025-07-29T16:02:15+00:00", + "source_file": "05-ResponsibleGenAI/README.md", + "language_code": "uk" + }, + "AGENTS.md": { + "original_hash": "afc90918d008cf77fd1982691f681306", + "translation_date": "2025-10-03T08:46:30+00:00", + "source_file": "AGENTS.md", + "language_code": "uk" + }, + "CODE_OF_CONDUCT.md": { + "original_hash": "442b123d034f92f7c384d2bbd28f99f1", + "translation_date": "2025-07-21T20:38:21+00:00", + "source_file": "CODE_OF_CONDUCT.md", + "language_code": "uk" + }, + "README.md": { + "original_hash": "125a08948d881c95628094f4dd1fbd43", + "translation_date": "2026-01-29T16:21:04+00:00", + "source_file": "README.md", + "language_code": "uk" + }, + "SECURITY.md": { + "original_hash": "57f14126c1c6add76b3aef3844dfe4e3", + "translation_date": "2025-07-21T20:36:57+00:00", + "source_file": "SECURITY.md", + "language_code": "uk" + }, + "SUPPORT.md": { + "original_hash": "b8ef73cc49dec68e2c885ee9df545129", + "translation_date": "2025-07-21T20:39:31+00:00", + "source_file": "SUPPORT.md", + "language_code": "uk" + } +} \ No newline at end of file diff --git a/translations/uk/01-IntroToGenAI/README.md b/translations/uk/01-IntroToGenAI/README.md index 8e7d4846..f0c8db9b 100644 --- a/translations/uk/01-IntroToGenAI/README.md +++ b/translations/uk/01-IntroToGenAI/README.md @@ -1,12 +1,3 @@ - # Вступ до Генеративного AI - Java Edition ## Що ви дізнаєтесь diff --git a/translations/uk/02-SetupDevEnvironment/README.md b/translations/uk/02-SetupDevEnvironment/README.md index ab3f86bd..e91a041a 100644 --- a/translations/uk/02-SetupDevEnvironment/README.md +++ b/translations/uk/02-SetupDevEnvironment/README.md @@ -1,13 +1,251 @@ - +# Налаштування середовища розробки для генеративного ШІ для Java +> **Швидкий старт**: Програмуйте у хмарі за 2 хвилини – Перейдіть до [GitHub Codespaces Setup](../../../02-SetupDevEnvironment) – локальна інсталяція не потрібна та використовує моделі GitHub! + +> **Зацікавлені в Azure OpenAI?**, перегляньте наш [Посібник з налаштування Azure OpenAI](getting-started-azure-openai.md) з кроками створення нового ресурсу Azure OpenAI. + +## Чого ви навчитеся + +- Налаштувати середовище розробки Java для AI-додатків +- Вибрати та налаштувати потрібне середовище розробки (перш за все хмарне з Codespaces, локальний контейнер розробника або повне локальне налаштування) +- Перевірити налаштування, підключившись до GitHub Models + +## Зміст + +- [Чого ви навчитеся](../../../02-SetupDevEnvironment) +- [Вступ](../../../02-SetupDevEnvironment) +- [Крок 1: Налаштуйте середовище розробки](../../../02-SetupDevEnvironment) + - [Варіант A: GitHub Codespaces (Рекомендовано)](../../../02-SetupDevEnvironment) + - [Варіант B: Локальний контейнер розробника](../../../02-SetupDevEnvironment) + - [Варіант C: Використання існуючої локальної інсталяції](../../../02-SetupDevEnvironment) +- [Крок 2: Створення особистого токена доступу GitHub](../../../02-SetupDevEnvironment) +- [Крок 3: Перевірте налаштування](../../../02-SetupDevEnvironment) +- [Усунення несправностей](../../../02-SetupDevEnvironment) +- [Підсумок](../../../02-SetupDevEnvironment) +- [Наступні кроки](../../../02-SetupDevEnvironment) + +## Вступ + +Цей розділ проведе вас через налаштування середовища розробки. Ми використаємо **GitHub Models** як основний приклад, оскільки це безкоштовно, легко налаштовується лише з обліковим записом GitHub, без необхідності кредитної картки та забезпечує доступ до кількох моделей для експериментів. + +**Локальна інсталяція не потрібна!** Ви можете почати програмувати відразу, використовуючи GitHub Codespaces, яке надає повне середовище розробки у вашому браузері. + +Скріншот: GitHub Models + +Ми рекомендуємо використовувати [**GitHub Models**](https://github.com/marketplace?type=models) для цього курсу, тому що це: +- **Безкоштовно** для початку +- **Просто** налаштувати лише з обліковим записом GitHub +- **Без кредитної картки** +- **Кілька моделей** доступні для експериментів + +> **Примітка**: GitHub Models, які використовуються у цьому навчанні, мають такі безкоштовні обмеження: +> - 15 запитів на хвилину (150 на день) +> - ~8000 слів на вхід, ~4000 слів на вихід за запит +> - 5 одночасних запитів +> +> Для використання у виробництві оновіться до Azure AI Foundry Models з вашим обліковим записом Azure. Ваш код змінювати не потрібно. Див. [документацію Azure AI Foundry](https://learn.microsoft.com/azure/ai-foundry/foundry-models/how-to/quickstart-github-models). + +## Крок 1: Налаштуйте середовище розробки + + + +Ми створили попередньо налаштований контейнер розробника, щоб мінімізувати час налаштування та забезпечити наявність усіх необхідних інструментів для цього курсу Generative AI for Java. Виберіть зручний для вас спосіб розробки: + +### Варіанти налаштування оточення: + +#### Варіант A: GitHub Codespaces (Рекомендовано) + +**Почніть програмувати за 2 хвилини – локальна інсталяція не потрібна!** + +1. Форкніть цей репозиторій у свій обліковий запис GitHub + > **Примітка**: Якщо хочете редагувати базову конфігурацію, будь ласка, перегляньте [Dev Container Configuration](../../../.devcontainer/devcontainer.json) +2. Натисніть **Code** → вкладка **Codespaces** → **...** → **New with options...** +3. Використайте налаштування за замовчуванням – це вибере **Dev container configuration**: **Generative AI Java Development Environment**, створений спеціально для цього курсу +4. Натисніть **Create codespace** +5. Зачекайте ~2 хвилини, поки середовище стане готовим +6. Перейдіть до [Крок 2: Створення токена GitHub](../../../02-SetupDevEnvironment) + +Скріншот: Codespaces вкладка меню + +Скріншот: New with options + +Скріншот: Options створення codespace + +> **Переваги Codespaces**: +> - Локальна інсталяція не потрібна +> - Працює на будь-якому пристрої з браузером +> - Попередньо налаштоване з усіма інструментами та залежностями +> - Безкоштовно 60 годин на місяць для персональних акаунтів +> - Однорідне середовище для всіх учасників + +#### Варіант B: Локальний контейнер розробника + +**Для розробників, які віддають перевагу локальній розробці з Docker** + +1. Форкніть і клонують цей репозиторій на свій локальний комп’ютер + > **Примітка**: Якщо хочете редагувати базову конфігурацію, будь ласка, перегляньте [Dev Container Configuration](../../../.devcontainer/devcontainer.json) +2. Встановіть [Docker Desktop](https://www.docker.com/products/docker-desktop/) та [VS Code](https://code.visualstudio.com/) +3. Встановіть розширення [Dev Containers](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers) у VS Code +4. Відкрийте папку репозиторію у VS Code +5. Коли буде запит, натисніть **Reopen in Container** (або використайте `Ctrl+Shift+P` → "Dev Containers: Reopen in Container") +6. Зачекайте, поки контейнер збудується і запуститься +7. Перейдіть до [Крок 2: Створення токена GitHub](../../../02-SetupDevEnvironment) + +Скріншот: Налаштування контейнера розробника + +Скріншот: Завершення збірки контейнера розробника + +#### Варіант C: Використання існуючої локальної інсталяції + +**Для розробників з уже існуючим Java середовищем** + +Вимоги: +- [Java 21+](https://www.oracle.com/java/technologies/javase/jdk21-archive-downloads.html) +- [Maven 3.9+](https://maven.apache.org/download.cgi) +- [VS Code](https://code.visualstudio.com) або улюблений IDE + +Кроки: +1. Клонуйте цей репозиторій на свій локальний комп’ютер +2. Відкрийте проект у вашому IDE +3. Перейдіть до [Крок 2: Створення токена GitHub](../../../02-SetupDevEnvironment) + +> **Професійна порада**: Якщо у вас слабкий комп’ютер, але ви хочете VS Code локально, використовуйте GitHub Codespaces! Ви можете підключити локальний VS Code до Codespace у хмарі й отримати найкраще поєднання. + +Скріншот: створений локальний контейнер розробника + +## Крок 2: Створення особистого токена доступу GitHub + +1. Перейдіть до [Налаштувань GitHub](https://github.com/settings/profile) і виберіть **Settings** у вашому меню профілю. +2. У лівій панелі натисніть **Developer settings** (зазвичай внизу). +3. У розділі **Personal access tokens** натисніть **Fine-grained tokens** (або перейдіть за цим прямим [посиланням](https://github.com/settings/personal-access-tokens)). +4. Натисніть **Generate new token**. +5. В полі "Token name" вкажіть описову назву (наприклад, `GenAI-Java-Course-Token`). +6. Встановіть дату закінчення строку дії (рекомендовано: 7 днів для кращої безпеки). +7. В розділі "Resource owner" виберіть свій користувацький акаунт. +8. В розділі "Repository access" оберіть репозиторії, з якими ви хочете працювати через GitHub Models (або "All repositories", якщо потрібно). +9. В розділі "Account permissions" знайдіть **Models** і встановіть доступ **Read-only**. +10. Натисніть **Generate token**. +11. **Скопіюйте та збережіть токен зараз** — ви не зможете побачити його знову! + +> **Порада з безпеки**: Використовуйте мінімально необхідні права доступу і найкоротший практичний термін дії токена. + +## Крок 3: Перевірте налаштування з прикладом GitHub Models + +Коли середовище розробки готове, давайте перевіримо інтеграцію GitHub Models з нашим прикладом у [`02-SetupDevEnvironment/examples/github-models`](../../../02-SetupDevEnvironment/examples/github-models). + +1. Відкрийте термінал у вашому середовищі розробки. +2. Перейдіть до прикладу GitHub Models: + ```bash + cd 02-SetupDevEnvironment/examples/github-models + ``` +3. Встановіть ваш GitHub токен як змінну середовища: + ```bash + # macOS/Linux + export GITHUB_TOKEN=your_token_here + + # Windows (Командний рядок) + set GITHUB_TOKEN=your_token_here + + # Windows (PowerShell) + $env:GITHUB_TOKEN="your_token_here" + ``` + +4. Запустіть додаток: + ```bash + mvn compile exec:java -Dexec.mainClass="com.example.githubmodels.App" + ``` + +Ви повинні побачити вивід, схожий на: +```text +Using model: gpt-4.1-nano +Sending request to GitHub Models... +Response: Hello World! +``` + +### Розуміння прикладного коду + +Спершу зрозуміємо, що ми лише що запустили. Приклад у папці `examples/github-models` використовує OpenAI Java SDK для підключення до GitHub Models: + +**Що виконує цей код:** +- **Підключається** до GitHub Models, використовуючи ваш персональний токен доступу +- **Відправляє** просте повідомлення "Say Hello World!" AI-моделі +- **Отримує** й відображає відповідь ШІ +- **Перевіряє**, що ваше налаштування працює коректно + +**Ключова залежність** (з `pom.xml`): +```xml + + com.openai + openai-java + 2.12.0 + +``` + +**Основний код** (`App.java`): +```java +// Підключитися до моделей GitHub за допомогою OpenAI Java SDK +OpenAIClient client = OpenAIOkHttpClient.builder() + .apiKey(pat) + .baseUrl("https://models.inference.ai.azure.com") + .build(); + +// Створити запит на завершення чату +ChatCompletionCreateParams params = ChatCompletionCreateParams.builder() + .model(modelId) + .addSystemMessage("You are a concise assistant.") + .addUserMessage("Say Hello World!") + .build(); + +// Отримати відповідь ШІ +ChatCompletion response = client.chat().completions().create(params); +System.out.println("Response: " + response.choices().get(0).message().content().orElse("No response content")); +``` + +## Підсумок + +Чудово! Тепер у вас є все необхідне: + +- Створено особистий токен доступу GitHub з потрібними правами для доступу до AI моделей +- Налаштоване середовище розробки Java (Codespaces, контейнер розробника або локальне) +- Підключено до GitHub Models за допомогою OpenAI Java SDK для безкоштовної розробки AI +- Перевірено роботу за допомогою простого прикладу, який спілкується з AI моделями + +## Наступні кроки + +[Розділ 3: Основні техніки генеративного ШІ](../03-CoreGenerativeAITechniques/README.md) + +## Усунення несправностей + +Маєте проблеми? Ось розповсюджені проблеми і їх рішення: + +- **Токен не працює?** + - Переконайтеся, що ви скопіювали увесь токен без додаткових пробілів + - Перевірте, що токен встановлено правильно як змінну середовища + - Переконайтеся, що токен має правильні дозволи (Models: Read-only) + +- **Maven не знайдено?** + - Якщо використовуєте контейнери розробника чи Codespaces, Maven має бути встановлено заздалегідь + - Для локального налаштування переконайтеся, що встановлені Java 21+ та Maven 3.9+ + - Спробуйте `mvn --version` для перевірки інсталяції + +- **Проблеми з підключенням?** + - Перевірте інтернет-з'єднання + - Переконайтеся, що GitHub доступний з вашої мережі + - Переконайтеся, що ви не за файрволом, який блокує точку доступу GitHub Models + +- **Контейнер розробника не запускається?** + - Переконайтеся, що Docker Desktop запущено (для локальної розробки) + - Спробуйте перебудувати контейнер: `Ctrl+Shift+P` → "Dev Containers: Rebuild Container" + +- **Помилки компіляції додатку?** + - Переконайтеся, що ви у правильній папці: `02-SetupDevEnvironment/examples/github-models` + - Спробуйте почистити і перебудувати: `mvn clean compile` + +> **Потрібна допомога?**: Якщо проблеми залишаються, відкрийте issue у репозиторії, і ми вам допоможемо. --- + +**Застереження**: +Цей документ було перекладено за допомогою сервісу автоматичного перекладу [Co-op Translator](https://github.com/Azure/co-op-translator). Хоча ми прагнемо до точності, будь ласка, майте на увазі, що автоматичні переклади можуть містити помилки або неточності. Оригінальний документ рідною мовою слід розглядати як авторитетне джерело. Для критичної інформації рекомендується звертатися до професійного людського перекладу. Ми не несемо відповідальності за будь-які непорозуміння чи неправильні тлумачення, що виникли внаслідок використання цього перекладу. + \ No newline at end of file diff --git a/translations/uk/02-SetupDevEnvironment/examples/basic-chat-azure/README.md b/translations/uk/02-SetupDevEnvironment/examples/basic-chat-azure/README.md index 3df3ff22..1a1a1a3b 100644 --- a/translations/uk/02-SetupDevEnvironment/examples/basic-chat-azure/README.md +++ b/translations/uk/02-SetupDevEnvironment/examples/basic-chat-azure/README.md @@ -1,12 +1,3 @@ - # Основний чат з Azure OpenAI - приклад від початку до кінця Цей приклад демонструє, як створити простий додаток Spring Boot, який підключається до Azure OpenAI і тестує вашу конфігурацію. diff --git a/translations/uk/02-SetupDevEnvironment/getting-started-azure-openai.md b/translations/uk/02-SetupDevEnvironment/getting-started-azure-openai.md index f1c9d1f7..dd3e3b22 100644 --- a/translations/uk/02-SetupDevEnvironment/getting-started-azure-openai.md +++ b/translations/uk/02-SetupDevEnvironment/getting-started-azure-openai.md @@ -1,12 +1,3 @@ - # Налаштування середовища розробки для Azure OpenAI > **Швидкий старт**: Цей посібник призначений для налаштування Azure OpenAI. Для швидкого старту з безкоштовними моделями скористайтеся [GitHub Models with Codespaces](./README.md#quick-start-cloud). diff --git a/translations/uk/03-CoreGenerativeAITechniques/README.md b/translations/uk/03-CoreGenerativeAITechniques/README.md index cdeab0b5..ea99699b 100644 --- a/translations/uk/03-CoreGenerativeAITechniques/README.md +++ b/translations/uk/03-CoreGenerativeAITechniques/README.md @@ -1,12 +1,3 @@ - # Основні техніки генеративного штучного інтелекту: Посібник ## Зміст diff --git a/translations/uk/04-PracticalSamples/README.md b/translations/uk/04-PracticalSamples/README.md index 5e9dd877..35a01895 100644 --- a/translations/uk/04-PracticalSamples/README.md +++ b/translations/uk/04-PracticalSamples/README.md @@ -1,12 +1,3 @@ - # Практичні застосування та проєкти ## Що ви навчитеся diff --git a/translations/uk/04-PracticalSamples/calculator/README.md b/translations/uk/04-PracticalSamples/calculator/README.md index 368e8878..646420f6 100644 --- a/translations/uk/04-PracticalSamples/calculator/README.md +++ b/translations/uk/04-PracticalSamples/calculator/README.md @@ -1,12 +1,3 @@ - # Підручник MCP Calculator для початківців ## Зміст diff --git a/translations/uk/04-PracticalSamples/foundrylocal/README.md b/translations/uk/04-PracticalSamples/foundrylocal/README.md index 18a94f8a..6517ed4f 100644 --- a/translations/uk/04-PracticalSamples/foundrylocal/README.md +++ b/translations/uk/04-PracticalSamples/foundrylocal/README.md @@ -1,12 +1,3 @@ - # Локальний підручник Foundry Spring Boot ## Зміст diff --git a/translations/uk/04-PracticalSamples/petstory/README.md b/translations/uk/04-PracticalSamples/petstory/README.md index 07127db5..840223f1 100644 --- a/translations/uk/04-PracticalSamples/petstory/README.md +++ b/translations/uk/04-PracticalSamples/petstory/README.md @@ -1,12 +1,3 @@ - # Посібник для початківців зі створення генератора історій про домашніх улюбленців ## Зміст diff --git a/translations/uk/05-ResponsibleGenAI/README.md b/translations/uk/05-ResponsibleGenAI/README.md index f0b128bf..41279ff5 100644 --- a/translations/uk/05-ResponsibleGenAI/README.md +++ b/translations/uk/05-ResponsibleGenAI/README.md @@ -1,12 +1,3 @@ - # Відповідальний Генеративний AI ## Що Ви Дізнаєтесь diff --git a/translations/uk/AGENTS.md b/translations/uk/AGENTS.md index 4a52ed72..cb2b00a7 100644 --- a/translations/uk/AGENTS.md +++ b/translations/uk/AGENTS.md @@ -1,12 +1,3 @@ - # AGENTS.md ## Огляд проєкту diff --git a/translations/uk/CODE_OF_CONDUCT.md b/translations/uk/CODE_OF_CONDUCT.md index 8635cba2..befeb5c2 100644 --- a/translations/uk/CODE_OF_CONDUCT.md +++ b/translations/uk/CODE_OF_CONDUCT.md @@ -1,12 +1,3 @@ - # Кодекс поведінки для відкритого коду Microsoft Цей проєкт прийняв [Кодекс поведінки для відкритого коду Microsoft](https://opensource.microsoft.com/codeofconduct/). diff --git a/translations/uk/README.md b/translations/uk/README.md index fd5cf843..56e2a43f 100644 --- a/translations/uk/README.md +++ b/translations/uk/README.md @@ -1,123 +1,114 @@ - -# Генеративний ШІ для Початківців - Java Edition +# Генеративний ШІ для Початківців - Java Випуск [![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) -![Генеративний ШІ для Початківців - Java Edition](../../translated_images/uk/beg-genai-series.8b48be9951cc574c.webp) +![Генеративний ШІ для Початківців - Java Випуск](../../translated_images/uk/beg-genai-series.8b48be9951cc574c.webp) -**Час, який потрібно витратити**: Весь воркшоп можна пройти онлайн без локальної установки. Налаштування середовища займає 2 хвилини, дослідження прикладів потребує 1-3 години, залежно від глибини вивчення. +**Час, потрібний для проходження**: Весь воркшоп можна пройти онлайн без локальної установки. Налаштування середовища займає 2 хвилини, а ознайомлення з прикладами - від 1 до 3 годин залежно від глибини вивчення. -> **Швидкий старт** +> **Швидкий початок** -1. Форкніть цей репозиторій до свого облікового запису GitHub -2. Натисніть **Code** → вкладку **Codespaces** → **...** → **New with options...** -3. Використовуйте налаштування за замовчуванням – це вибере Development container, створений для цього курсу -4. Натисніть **Create codespace** -5. Почекайте приблизно 2 хвилини, поки середовище стане готовим -6. Перейдіть безпосередньо до [Першого прикладу](./02-SetupDevEnvironment/README.md#step-2-create-a-github-personal-access-token) +1. Форкніть цей репозиторій у свій акаунт GitHub +2. Натисніть **Code** → вкладку **Codespaces** → **...** → **New with options...** +3. Використайте налаштування за замовчуванням – це вибере контейнер розробки, створений для цього курсу +4. Натисніть **Create codespace** +5. Почекайте приблизно 2 хвилини, доки середовище буде готове +6. Перейдіть прямо до [Першого прикладу](./02-SetupDevEnvironment/README.md#step-2-create-a-github-personal-access-token) -> **Віддаєте перевагу клонуванню локально?** -> -> Цей репозиторій містить понад 50 перекладів мовами, що значно збільшує розмір завантаження. Щоб клонувати без перекладів, використовуйте sparse checkout: +> **Віддаєте перевагу клонувати локально?** +> +> Цей репозиторій містить понад 50 перекладів мовами, що значно збільшує розмір завантаження. Щоб клонувати без перекладів, використовуйте sparse checkout: > ```bash > git clone --filter=blob:none --sparse https://github.com/microsoft/Generative-AI-for-beginners-java.git > cd Generative-AI-for-beginners-java > git sparse-checkout set --no-cone '/*' '!translations' '!translated_images' > ``` -> Це дасть вам усе необхідне для проходження курсу з набагато швидшим завантаженням. +> Це дає все, що вам потрібно для проходження курсу з набагато швидшим завантаженням. -## Підтримка кількох мов +## Підтримка Багатьох Мов -### Підтримується за допомогою GitHub Action (автоматично та завжди актуально) +### Підтримується через GitHub Action (Автоматично та Завжди Оновлено) -[Арабська](../ar/README.md) | [Бенгальська](../bn/README.md) | [Болгарська](../bg/README.md) | [Бірманська (М’янма)](../my/README.md) | [Китайська (спрощена)](../zh/README.md) | [Китайська (традиційна, Гонконг)](../hk/README.md) | [Китайська (традиційна, Макао)](../mo/README.md) | [Китайська (традиційна, Тайвань)](../tw/README.md) | [Хорватська](../hr/README.md) | [Чеська](../cs/README.md) | [Данська](../da/README.md) | [Голландська](../nl/README.md) | [Естонська](../et/README.md) | [Фінська](../fi/README.md) | [Французька](../fr/README.md) | [Німецька](../de/README.md) | [Грецька](../el/README.md) | [Іврит](../he/README.md) | [Гінді](../hi/README.md) | [Угорська](../hu/README.md) | [Індонезійська](../id/README.md) | [Італійська](../it/README.md) | [Японська](../ja/README.md) | [Каннада](../kn/README.md) | [Корейська](../ko/README.md) | [Литовська](../lt/README.md) | [Малайська](../ms/README.md) | [Малаялам](../ml/README.md) | [Маратхі](../mr/README.md) | [Непалі](../ne/README.md) | [Нігерійський Піджин](../pcm/README.md) | [Норвезька](../no/README.md) | [Перська (Фарсі)](../fa/README.md) | [Польська](../pl/README.md) | [Португальська (Бразилія)](../br/README.md) | [Португальська (Португалія)](../pt/README.md) | [Пенджабі (Гурмухі)](../pa/README.md) | [Румунська](../ro/README.md) | [Російська](../ru/README.md) | [Сербська (кирилиця)](../sr/README.md) | [Словацька](../sk/README.md) | [Словенська](../sl/README.md) | [Іспанська](../es/README.md) | [Суаїлі](../sw/README.md) | [Шведська](../sv/README.md) | [Тагальська (філіппінська)](../tl/README.md) | [Тамільська](../ta/README.md) | [Телугу](../te/README.md) | [Тайська](../th/README.md) | [Турецька](../tr/README.md) | [Українська](./README.md) | [Урду](../ur/README.md) | [В’єтнамська](../vi/README.md) +[Арабська](../ar/README.md) | [Бенгальська](../bn/README.md) | [Болгарська](../bg/README.md) | [Бирманська (М’янма)](../my/README.md) | [Китайська (спрощена)](../zh-CN/README.md) | [Китайська (традиційна, Гонконг)](../zh-HK/README.md) | [Китайська (традиційна, Макао)](../zh-MO/README.md) | [Китайська (традиційна, Тайвань)](../zh-TW/README.md) | [Хорватська](../hr/README.md) | [Чеська](../cs/README.md) | [Данська](../da/README.md) | [Голландська](../nl/README.md) | [Естонська](../et/README.md) | [Фінська](../fi/README.md) | [Французька](../fr/README.md) | [Німецька](../de/README.md) | [Грецька](../el/README.md) | [Іврит](../he/README.md) | [Хінді](../hi/README.md) | [Угорська](../hu/README.md) | [Індонезійська](../id/README.md) | [Італійська](../it/README.md) | [Японська](../ja/README.md) | [Каннада](../kn/README.md) | [Корейська](../ko/README.md) | [Литовська](../lt/README.md) | [Малайська](../ms/README.md) | [Малаялам](../ml/README.md) | [Маратхі](../mr/README.md) | [Непальська](../ne/README.md) | [Нігерійський підійзьн](../pcm/README.md) | [Норвезька](../no/README.md) | [Перська (Фарсі)](../fa/README.md) | [Польська](../pl/README.md) | [Португальська (Бразилія)](../pt-BR/README.md) | [Португальська (Португалія)](../pt-PT/README.md) | [Пенджабі (Гурмукхі)](../pa/README.md) | [Румунська](../ro/README.md) | [Російська](../ru/README.md) | [Сербська (кирилиця)](../sr/README.md) | [Словацька](../sk/README.md) | [Словенська](../sl/README.md) | [Іспанська](../es/README.md) | [Суахілі](../sw/README.md) | [Шведська](../sv/README.md) | [Тагалог (філіппінська)](../tl/README.md) | [Тамільська](../ta/README.md) | [Телугу](../te/README.md) | [Тайська](../th/README.md) | [Турецька](../tr/README.md) | [Українська](./README.md) | [Урду](../ur/README.md) | [В’єтнамська](../vi/README.md) -> **Віддаєте перевагу клонуванню локально?** - -> Цей репозиторій містить понад 50 перекладів мовами, що значно збільшує розмір завантаження. Щоб клонувати без перекладів, використовуйте sparse checkout: +> **Віддаєте перевагу клонувати локально?** +> +> Цей репозиторій містить понад 50 перекладів мовами, що значно збільшує розмір завантаження. Щоб клонувати без перекладів, використовуйте sparse checkout: > ```bash > git clone --filter=blob:none --sparse https://github.com/microsoft/Generative-AI-for-beginners-java.git > cd Generative-AI-for-beginners-java > git sparse-checkout set --no-cone '/*' '!translations' '!translated_images' > ``` -> Це дасть вам усе необхідне для проходження курсу з набагато швидшим завантаженням. +> Це дає все, що вам потрібно для проходження курсу з набагато швидшим завантаженням. -## Структура курсу та навчальний шлях +## Структура Курсу та Шлях Навчання -### **Розділ 1: Вступ до генеративного ШІ** -- **Основні поняття**: Розуміння великих мовних моделей, токенів, вбудованих представлень (embeddings) та можливостей ШІ -- **Екосистема Java AI**: Огляд Spring AI та OpenAI SDK -- **Протокол контексту моделі**: Вступ до MCP та його ролі в комунікації агентів ШІ -- **Практичні застосування**: Реальні сценарії, включно з чатботами та генерацією контенту +### **Розділ 1: Вступ до Генеративного ШІ** +- **Основні поняття**: Розуміння великих мовних моделей, токенів, вбудувань та можливостей ШІ +- **Екосистема Java AI**: Огляд Spring AI і OpenAI SDK +- **Протокол Контексту Моделі**: Введення в MCP і його роль у комунікації агентів ШІ +- **Практичні застосування**: Реальні сценарії, включно з чатботами та генерацією контенту - **[→ Почати Розділ 1](./01-IntroToGenAI/README.md)** -### **Розділ 2: Налаштування середовища розробки** -- **Конфігурація для кількох провайдерів**: Налаштування GitHub Models, Azure OpenAI та інтеграцій OpenAI Java SDK -- **Spring Boot + Spring AI**: Кращі практики для розробки корпоративних AI-додатків -- **GitHub Models**: Безкоштовний доступ до AI-моделей для прототипування та навчання (без необхідності кредитної картки) -- **Інструменти розробника**: Контейнери Docker, VS Code та налаштування GitHub Codespaces +### **Розділ 2: Налаштування Середовища Розробки** +- **Конфігурація для кількох провайдерів**: Налаштування GitHub Models, Azure OpenAI та інтеграції OpenAI Java SDK +- **Spring Boot + Spring AI**: Кращі практики для розробки корпоративних AI-додатків +- **GitHub Models**: Безкоштовний доступ до AI-моделей для прототипування та навчання (без кредитної картки) +- **Інструменти розробки**: Docker контейнери, VS Code та налаштування GitHub Codespaces - **[→ Почати Розділ 2](./02-SetupDevEnvironment/README.md)** -### **Розділ 3: Основні методи генеративного ШІ** -- **Інженерія підказок**: Методи оптимізації відповідей моделі ШІ -- **Embeddings та векторні операції**: Реалізація семантичного пошуку та пошуку за схожістю -- **Retrieval-Augmented Generation (RAG)**: Поєднання ШІ з власними джерелами даних -- **Виклики функцій**: Розширення можливостей ШІ за допомогою власних інструментів і плагінів +### **Розділ 3: Основні Техніки Генеративного ШІ** +- **Інженерія підказок**: Техніки для оптимальних відповідей моделей ШІ +- **Вбудування та операції з векторами**: Реалізація семантичного пошуку та порівняння схожості +- **Ретривальна доповнена генерація (RAG)**: Комбінування ШІ з вашими власними джерелами даних +- **Виклик функцій**: Розширення можливостей ШІ за допомогою власних інструментів і плагінів - **[→ Почати Розділ 3](./03-CoreGenerativeAITechniques/README.md)** -### **Розділ 4: Практичні застосування та проєкти** -- **Генератор історій про домашніх улюбленців** (`petstory/`): Творча генерація контенту з GitHub Models -- **Локальна демонстрація Foundry** (`foundrylocal/`): Локальна інтеграція AI-моделі з OpenAI Java SDK -- **Сервіс калькулятора MCP** (`calculator/`): Базова реалізація Model Context Protocol із Spring AI +### **Розділ 4: Практичні Застосування та Проєкти** +- **Генератор історій про домашніх улюбленців** (`petstory/`): Креативне генерування контенту з GitHub Models +- **Демо Foundry Local** (`foundrylocal/`): Локальна інтеграція AI моделей з OpenAI Java SDK +- **Сервіс калькулятора MCP** (`calculator/`): Базова реалізація Протоколу Контексту Моделі з Spring AI - **[→ Почати Розділ 4](./04-PracticalSamples/README.md)** -### **Розділ 5: Відповідальна розробка ШІ** -- **Безпека GitHub Models**: Тестування вбудованих механізмів фільтрації контенту та безпеки (жорсткі блокування та м’які відмови) -- **Демонстрація відповідального ШІ**: Практичний приклад роботи сучасних систем безпеки ШІ -- **Кращі практики**: Важливі настанови для етичної розробки та впровадження ШІ +### **Розділ 5: Відповідальна Розробка ШІ** +- **Безпека GitHub Models**: Тестування вбудованих фільтрів контенту та механізмів безпеки (жорсткі блоки та м'які відмови) +- **Демо Відповідального ШІ**: Практичний приклад роботи сучасних систем безпеки ШІ +- **Кращі практики**: Важливі настанови для етичної розробки та впровадження ШІ - **[→ Почати Розділ 5](./05-ResponsibleGenAI/README.md)** -## Додаткові ресурси +## Додаткові Ресурси -### LangChain -[![LangChain4j для початківців](https://img.shields.io/badge/LangChain4j%20for%20Beginners-22C55E?style=for-the-badge&&labelColor=E5E7EB&color=0553D6)](https://aka.ms/langchain4j-for-beginners) -[![LangChain.js для початківців](https://img.shields.io/badge/LangChain.js%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=0553D6)](https://aka.ms/langchainjs-for-beginners?WT.mc_id=m365-94501-dwahlin) +### LangChain +[![LangChain4j для Початківців](https://img.shields.io/badge/LangChain4j%20for%20Beginners-22C55E?style=for-the-badge&&labelColor=E5E7EB&color=0553D6)](https://aka.ms/langchain4j-for-beginners) +[![LangChain.js для Початківців](https://img.shields.io/badge/LangChain.js%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=0553D6)](https://aka.ms/langchainjs-for-beginners?WT.mc_id=m365-94501-dwahlin) --- -### Azure / Edge / MCP / Агенти -[![AZD для початківців](https://img.shields.io/badge/AZD%20for%20Beginners-0078D4?style=for-the-badge&labelColor=E5E7EB&color=0078D4)](https://github.com/microsoft/AZD-for-beginners?WT.mc_id=academic-105485-koreyst) -[![Edge AI для початківців](https://img.shields.io/badge/Edge%20AI%20for%20Beginners-00B8E4?style=for-the-badge&labelColor=E5E7EB&color=00B8E4)](https://github.com/microsoft/edgeai-for-beginners?WT.mc_id=academic-105485-koreyst) -[![MCP для початківців](https://img.shields.io/badge/MCP%20for%20Beginners-009688?style=for-the-badge&labelColor=E5E7EB&color=009688)](https://github.com/microsoft/mcp-for-beginners?WT.mc_id=academic-105485-koreyst) -[![AI Агенти для початківців](https://img.shields.io/badge/AI%20Agents%20for%20Beginners-00C49A?style=for-the-badge&labelColor=E5E7EB&color=00C49A)](https://github.com/microsoft/ai-agents-for-beginners?WT.mc_id=academic-105485-koreyst) +### Azure / Edge / MCP / Агенти +[![AZD для Початківців](https://img.shields.io/badge/AZD%20for%20Beginners-0078D4?style=for-the-badge&labelColor=E5E7EB&color=0078D4)](https://github.com/microsoft/AZD-for-beginners?WT.mc_id=academic-105485-koreyst) +[![Edge AI для Початківців](https://img.shields.io/badge/Edge%20AI%20for%20Beginners-00B8E4?style=for-the-badge&labelColor=E5E7EB&color=00B8E4)](https://github.com/microsoft/edgeai-for-beginners?WT.mc_id=academic-105485-koreyst) +[![MCP для Початківців](https://img.shields.io/badge/MCP%20for%20Beginners-009688?style=for-the-badge&labelColor=E5E7EB&color=009688)](https://github.com/microsoft/mcp-for-beginners?WT.mc_id=academic-105485-koreyst) +[![AI Агенти для Початківців](https://img.shields.io/badge/AI%20Agents%20for%20Beginners-00C49A?style=for-the-badge&labelColor=E5E7EB&color=00C49A)](https://github.com/microsoft/ai-agents-for-beginners?WT.mc_id=academic-105485-koreyst) --- - -### Серія Генеративного ШІ -[![Генеративний ШІ для початківців](https://img.shields.io/badge/Generative%20AI%20for%20Beginners-8B5CF6?style=for-the-badge&labelColor=E5E7EB&color=8B5CF6)](https://github.com/microsoft/generative-ai-for-beginners?WT.mc_id=academic-105485-koreyst) -[![Генеративний ШІ (.NET)](https://img.shields.io/badge/Generative%20AI%20(.NET)-9333EA?style=for-the-badge&labelColor=E5E7EB&color=9333EA)](https://github.com/microsoft/Generative-AI-for-beginners-dotnet?WT.mc_id=academic-105485-koreyst) -[![Генеративний ШІ (Java)](https://img.shields.io/badge/Generative%20AI%20(Java)-C084FC?style=for-the-badge&labelColor=E5E7EB&color=C084FC)](https://github.com/microsoft/generative-ai-for-beginners-java?WT.mc_id=academic-105485-koreyst) + +### Серія Генеративного ШІ +[![Генеративний ШІ для Початківців](https://img.shields.io/badge/Generative%20AI%20for%20Beginners-8B5CF6?style=for-the-badge&labelColor=E5E7EB&color=8B5CF6)](https://github.com/microsoft/generative-ai-for-beginners?WT.mc_id=academic-105485-koreyst) +[![Генеративний ШІ (.NET)](https://img.shields.io/badge/Generative%20AI%20(.NET)-9333EA?style=for-the-badge&labelColor=E5E7EB&color=9333EA)](https://github.com/microsoft/Generative-AI-for-beginners-dotnet?WT.mc_id=academic-105485-koreyst) +[![Генеративний ШІ (Java)](https://img.shields.io/badge/Generative%20AI%20(Java)-C084FC?style=for-the-badge&labelColor=E5E7EB&color=C084FC)](https://github.com/microsoft/generative-ai-for-beginners-java?WT.mc_id=academic-105485-koreyst) [![Генеративний ШІ (JavaScript)](https://img.shields.io/badge/Generative%20AI%20(JavaScript)-E879F9?style=for-the-badge&labelColor=E5E7EB&color=E879F9)](https://github.com/microsoft/generative-ai-with-javascript?WT.mc_id=academic-105485-koreyst) --- - -### Основне навчання -[![Машинне навчання для початківців](https://img.shields.io/badge/ML%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=22C55E)](https://aka.ms/ml-beginners?WT.mc_id=academic-105485-koreyst) -[![Дата-сайєнс для початківців](https://img.shields.io/badge/Data%20Science%20for%20Beginners-84CC16?style=for-the-badge&labelColor=E5E7EB&color=84CC16)](https://aka.ms/datascience-beginners?WT.mc_id=academic-105485-koreyst) -[![ШІ для початківців](https://img.shields.io/badge/AI%20for%20Beginners-A3E635?style=for-the-badge&labelColor=E5E7EB&color=A3E635)](https://aka.ms/ai-beginners?WT.mc_id=academic-105485-koreyst) -[![Кібербезпека для початківців](https://img.shields.io/badge/Cybersecurity%20for%20Beginners-F97316?style=for-the-badge&labelColor=E5E7EB&color=F97316)](https://github.com/microsoft/Security-101?WT.mc_id=academic-96948-sayoung) -[![Веб-розробка для початківців](https://img.shields.io/badge/Web%20Dev%20for%20Beginners-EC4899?style=for-the-badge&labelColor=E5E7EB&color=EC4899)](https://aka.ms/webdev-beginners?WT.mc_id=academic-105485-koreyst) + +### Основне навчання +[![Машинне навчання для Початківців](https://img.shields.io/badge/ML%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=22C55E)](https://aka.ms/ml-beginners?WT.mc_id=academic-105485-koreyst) +[![Data Science для Початківців](https://img.shields.io/badge/Data%20Science%20for%20Beginners-84CC16?style=for-the-badge&labelColor=E5E7EB&color=84CC16)](https://aka.ms/datascience-beginners?WT.mc_id=academic-105485-koreyst) +[![ШІ для Початківців](https://img.shields.io/badge/AI%20for%20Beginners-A3E635?style=for-the-badge&labelColor=E5E7EB&color=A3E635)](https://aka.ms/ai-beginners?WT.mc_id=academic-105485-koreyst) +[![Кібербезпека для Початківців](https://img.shields.io/badge/Cybersecurity%20for%20Beginners-F97316?style=for-the-badge&labelColor=E5E7EB&color=F97316)](https://github.com/microsoft/Security-101?WT.mc_id=academic-96948-sayoung) +[![Web Dev for Beginners](https://img.shields.io/badge/Web%20Dev%20for%20Beginners-EC4899?style=for-the-badge&labelColor=E5E7EB&color=EC4899)](https://aka.ms/webdev-beginners?WT.mc_id=academic-105485-koreyst) [![IoT for Beginners](https://img.shields.io/badge/IoT%20for%20Beginners-14B8A6?style=for-the-badge&labelColor=E5E7EB&color=14B8A6)](https://aka.ms/iot-beginners?WT.mc_id=academic-105485-koreyst) [![XR Development for Beginners](https://img.shields.io/badge/XR%20Development%20for%20Beginners-38BDF8?style=for-the-badge&labelColor=E5E7EB&color=38BDF8)](https://github.com/microsoft/xr-development-for-beginners?WT.mc_id=academic-105485-koreyst) @@ -131,17 +122,17 @@ CO_OP_TRANSLATOR_METADATA: ## Отримання допомоги -Якщо ви застрягли або маєте питання щодо створення AI-додатків, приєднуйтесь до інших учнів та досвідчених розробників у дискусіях про MCP. Це підтримуюча спільнота, де питання вітаються, а знання вільно поширюються. +Якщо ви застрягли або у вас є питання щодо створення AI-додатків. Приєднуйтесь до інших учнів і досвідчених розробників у дискусіях про MCP. Це підтримуюча спільнота, де питання вітаються, а знання вільно обмінюються. [![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) -Якщо у вас є відгуки про продукт або помилки під час розробки, відвідайте: +Якщо у вас є відгуки про продукт або помилки під час створення, відвідайте: [![Microsoft Foundry Developer Forum](https://img.shields.io/badge/GitHub-Microsoft_Foundry_Developer_Forum-blue?style=for-the-badge&logo=github&color=000000&logoColor=fff)](https://aka.ms/foundry/forum) --- -**Відмова від відповідальності**: -Цей документ було перекладено за допомогою сервісу автоматичного перекладу [Co-op Translator](https://github.com/Azure/co-op-translator). Хоча ми прагнемо до точності, зверніть увагу, що автоматичні переклади можуть містити помилки або неточності. Оригінальний документ рідною мовою слід вважати авторитетним джерелом. Для критично важливої інформації рекомендується професійний переклад людиною. Ми не несемо відповідальності за будь-які непорозуміння або неправильні тлумачення, що виникли через використання цього перекладу. +**Відмова від відповідальності**: +Цей документ було перекладено за допомогою сервісу автоматичного перекладу [Co-op Translator](https://github.com/Azure/co-op-translator). Хоча ми прагнемо до точності, будь ласка, майте на увазі, що автоматичні переклади можуть містити помилки або неточності. Оригінальний документ мовою оригіналу слід вважати авторитетним джерелом. Для важливої інформації рекомендується звертатися до професійного людського перекладу. Ми не несемо відповідальності за будь-які непорозуміння або неправильні тлумачення, що виникли внаслідок використання цього перекладу. \ No newline at end of file diff --git a/translations/uk/SECURITY.md b/translations/uk/SECURITY.md index c2f7f768..890cd595 100644 --- a/translations/uk/SECURITY.md +++ b/translations/uk/SECURITY.md @@ -1,12 +1,3 @@ - ## Безпека Microsoft серйозно ставиться до безпеки наших програмних продуктів і послуг, включаючи всі репозиторії вихідного коду, які керуються через наші організації на GitHub, такі як [Microsoft](https://github.com/Microsoft), [Azure](https://github.com/Azure), [DotNet](https://github.com/dotnet), [AspNet](https://github.com/aspnet) і [Xamarin](https://github.com/xamarin). diff --git a/translations/uk/SUPPORT.md b/translations/uk/SUPPORT.md index 82b1029a..034a5c30 100644 --- a/translations/uk/SUPPORT.md +++ b/translations/uk/SUPPORT.md @@ -1,12 +1,3 @@ - # Підтримка ## Як повідомити про проблеми та отримати допомогу diff --git a/translations/ur/.co-op-translator.json b/translations/ur/.co-op-translator.json new file mode 100644 index 00000000..b2727c0a --- /dev/null +++ b/translations/ur/.co-op-translator.json @@ -0,0 +1,92 @@ +{ + "01-IntroToGenAI/README.md": { + "original_hash": "75bfb080ca725e8a9aa9c80cae25fba1", + "translation_date": "2025-07-29T08:16:19+00:00", + "source_file": "01-IntroToGenAI/README.md", + "language_code": "ur" + }, + "02-SetupDevEnvironment/README.md": { + "original_hash": "96a30d42b9751a3d4e4b20e28d29d459", + "translation_date": "2026-01-28T04:41:32+00:00", + "source_file": "02-SetupDevEnvironment/README.md", + "language_code": "ur" + }, + "02-SetupDevEnvironment/examples/basic-chat-azure/README.md": { + "original_hash": "efd82efe50711d7e257eb943151d682c", + "translation_date": "2025-07-27T13:34:46+00:00", + "source_file": "02-SetupDevEnvironment/examples/basic-chat-azure/README.md", + "language_code": "ur" + }, + "02-SetupDevEnvironment/getting-started-azure-openai.md": { + "original_hash": "bfdb4b4eadbee3a59ef742439f58326a", + "translation_date": "2025-07-27T12:53:48+00:00", + "source_file": "02-SetupDevEnvironment/getting-started-azure-openai.md", + "language_code": "ur" + }, + "03-CoreGenerativeAITechniques/README.md": { + "original_hash": "685f55cb07de19b52a30ce6e8b6d889e", + "translation_date": "2025-08-28T21:55:33+00:00", + "source_file": "03-CoreGenerativeAITechniques/README.md", + "language_code": "ur" + }, + "04-PracticalSamples/README.md": { + "original_hash": "14c0a61ecc1cd2012a9c129236dfdf71", + "translation_date": "2025-07-29T08:16:00+00:00", + "source_file": "04-PracticalSamples/README.md", + "language_code": "ur" + }, + "04-PracticalSamples/calculator/README.md": { + "original_hash": "b6c16b5514d524e415a94f6097ee7d4c", + "translation_date": "2025-09-18T15:25:01+00:00", + "source_file": "04-PracticalSamples/calculator/README.md", + "language_code": "ur" + }, + "04-PracticalSamples/foundrylocal/README.md": { + "original_hash": "f787307400de59adc25a1404466a35f3", + "translation_date": "2025-11-04T07:15:05+00:00", + "source_file": "04-PracticalSamples/foundrylocal/README.md", + "language_code": "ur" + }, + "04-PracticalSamples/petstory/README.md": { + "original_hash": "0cbf68d605615a1e602c832a24616859", + "translation_date": "2025-07-25T10:50:06+00:00", + "source_file": "04-PracticalSamples/petstory/README.md", + "language_code": "ur" + }, + "05-ResponsibleGenAI/README.md": { + "original_hash": "301c05c2f57e60a6950b8c665b8bdbba", + "translation_date": "2025-07-29T15:42:24+00:00", + "source_file": "05-ResponsibleGenAI/README.md", + "language_code": "ur" + }, + "AGENTS.md": { + "original_hash": "afc90918d008cf77fd1982691f681306", + "translation_date": "2025-10-03T08:27:17+00:00", + "source_file": "AGENTS.md", + "language_code": "ur" + }, + "CODE_OF_CONDUCT.md": { + "original_hash": "442b123d034f92f7c384d2bbd28f99f1", + "translation_date": "2025-07-21T17:36:29+00:00", + "source_file": "CODE_OF_CONDUCT.md", + "language_code": "ur" + }, + "README.md": { + "original_hash": "125a08948d881c95628094f4dd1fbd43", + "translation_date": "2026-01-29T15:22:50+00:00", + "source_file": "README.md", + "language_code": "ur" + }, + "SECURITY.md": { + "original_hash": "57f14126c1c6add76b3aef3844dfe4e3", + "translation_date": "2025-07-21T17:34:20+00:00", + "source_file": "SECURITY.md", + "language_code": "ur" + }, + "SUPPORT.md": { + "original_hash": "b8ef73cc49dec68e2c885ee9df545129", + "translation_date": "2025-07-21T17:37:33+00:00", + "source_file": "SUPPORT.md", + "language_code": "ur" + } +} \ No newline at end of file diff --git a/translations/ur/01-IntroToGenAI/README.md b/translations/ur/01-IntroToGenAI/README.md index eba6aec5..f46c59da 100644 --- a/translations/ur/01-IntroToGenAI/README.md +++ b/translations/ur/01-IntroToGenAI/README.md @@ -1,12 +1,3 @@ - # جنریٹو اے آئی کا تعارف - جاوا ایڈیشن ## آپ کیا سیکھیں گے diff --git a/translations/ur/02-SetupDevEnvironment/README.md b/translations/ur/02-SetupDevEnvironment/README.md index 7a16b54b..7322c784 100644 --- a/translations/ur/02-SetupDevEnvironment/README.md +++ b/translations/ur/02-SetupDevEnvironment/README.md @@ -1,13 +1,251 @@ - +# جاوا کے لئے جنریٹیو اے آئی کے لیے ڈیولپمنٹ ماحول کی ترتیب +> **فوری آغاز**: کلاؤڈ میں 2 منٹ میں کوڈ لکھیں - پر جائیں [GitHub Codespaces Setup](../../../02-SetupDevEnvironment) - کوئی مقامی تنصیب ضروری نہیں اور گٹ ہب ماڈلز استعمال کرتا ہے! + +> **Azure OpenAI میں دلچسپی رکھتے ہیں؟**، ہمارے [Azure OpenAI Setup Guide](getting-started-azure-openai.md) کو دیکھیں جس میں نیا Azure OpenAI ریسورس بنانے کے اقدامات ہیں۔ + +## آپ کیا سیکھیں گے + +- AI ایپلیکیشنز کے لیے جاوا ڈیولپمنٹ ماحول قائم کرنا +- اپنی پسندیدہ ڈیولپمنٹ ماحول کا انتخاب اور ترتیب دینا (کلاؤڈ اولین Codespaces کے ساتھ، مقامی ڈیو کنٹینر، یا مکمل مقامی سیٹ اپ) +- GitHub Models سے جڑ کر اپنی ترتیب کی جانچ کرنا + +## فہرست مضامین + +- [آپ کیا سیکھیں گے](../../../02-SetupDevEnvironment) +- [تعارف](../../../02-SetupDevEnvironment) +- [مرحلہ 1: اپنا ڈیولپمنٹ ماحول قائم کریں](../../../02-SetupDevEnvironment) + - [اختیار A: GitHub Codespaces (تجویز کردہ)](../../../02-SetupDevEnvironment) + - [اختیار B: مقامی ڈیو کنٹینر](../../../02-SetupDevEnvironment) + - [اختیار C: اپنی موجودہ مقامی تنصیب استعمال کریں](../../../02-SetupDevEnvironment) +- [مرحلہ 2: GitHub پرسنل ایکسیس ٹوکن بنائیں](../../../02-SetupDevEnvironment) +- [مرحلہ 3: اپنی ترتیب کو جانچیں](../../../02-SetupDevEnvironment) +- [مسائل کا حل](../../../02-SetupDevEnvironment) +- [خلاصہ](../../../02-SetupDevEnvironment) +- [اگلے اقدامات](../../../02-SetupDevEnvironment) + +## تعارف + +یہ باب آپ کو ڈیولپمنٹ ماحول قائم کرنے میں رہنمائی کرے گا۔ ہم **GitHub Models** کو اپنے بنیادی مثال کے طور پر استعمال کریں گے کیونکہ یہ مفت ہے، صرف GitHub اکاؤنٹ سے آسانی سے سیٹ اپ ہوتا ہے، کسی کریڈٹ کارڈ کی ضرورت نہیں، اور تجربے کے لیے متعدد ماڈلز تک رسائی فراہم کرتا ہے۔ + +**کوئی مقامی سیٹ اپ ضروری نہیں!** آپ فوری طور پر GitHub Codespaces کا استعمال کرتے ہوئے کوڈنگ شروع کر سکتے ہیں، جو آپ کے براؤزر میں مکمل ڈیولپمنٹ ماحول فراہم کرتا ہے۔ + +اسکرین شاٹ: GitHub Models + +ہم اس کورس کے لیے [**GitHub Models**](https://github.com/marketplace?type=models) کے استعمال کی سفارش کرتے ہیں کیونکہ یہ: +- شروع کرنے کے لیے **مفت** ہے +- صرف GitHub اکاؤنٹ کے ساتھ **آسان** سیٹ اپ +- **کوئی کریڈٹ کارڈ** درکار نہیں +- تجربے کے لیے **متعدد ماڈلز** دستیاب ہیں + +> **نوٹ**: اس تربیت میں استعمال ہونے والے GitHub Models کی یہ مفت حدود ہیں: +> - فی منٹ 15 درخواستیں (روزانہ 150) +> - فی درخواست تقریباً 8,000 الفاظ داخل، تقریباً 4,000 الفاظ باہر +> - 5 متوازی درخواستیں +> +> پیداواری استعمال کے لیے، Azure AI Foundry Models میں اپنے Azure اکاؤنٹ کے ساتھ اپ گریڈ کریں۔ آپ کے کوڈ کو تبدیل کرنے کی ضرورت نہیں۔ دیکھیں [Azure AI Foundry دستاویزات](https://learn.microsoft.com/azure/ai-foundry/foundry-models/how-to/quickstart-github-models)۔ + +## مرحلہ 1: اپنا ڈیولپمنٹ ماحول قائم کریں + + + +ہم نے اس جنریٹیو AI جاوا کورس کے لیے آپ کے وقت کی بچت اور تمام ضروری ٹولز کی دستیابی کو یقینی بنانے کے لیے پہلے سے ترتیب دی گئی ڈیو کنٹینر تیار کیا ہے۔ اپنی پسندیدہ ڈیولپمنٹ اپروچ منتخب کریں: + +### ماحول قائم کرنے کے اختیارات: + +#### اختیار A: GitHub Codespaces (تجویز کردہ) + +**2 منٹ میں کوڈنگ شروع کریں - کوئی مقامی سیٹ اپ ضروری نہیں!** + +1. اس ریپوزٹری کو اپنے GitHub اکاؤنٹ پر فورک کریں + > **نوٹ**: اگر آپ بنیادی کنفیگریشن میں ترمیم کرنا چاہتے ہیں تو براہ کرم [Dev Container Configuration](../../../.devcontainer/devcontainer.json) دیکھیں +2. **Code** → **Codespaces** ٹیب → **...** → **New with options...** پر کلک کریں +3. ڈیفالٹس استعمال کریں – یہ **Dev container configuration** منتخب کرے گا: اس کورس کے لیے بنائی گئی **Generative AI Java Development Environment** کلائنٹ ڈیو کنٹینر +4. **Create codespace** پر کلک کریں +5. ماحول تیار ہونے کے لیے تقریباً 2 منٹ انتظار کریں +6. [مرحلہ 2: GitHub ٹوکن بنائیں](../../../02-SetupDevEnvironment) پر جائیں + +اسکرین شاٹ: Codespaces سب مینو + +اسکرین شاٹ: New with options + +اسکرین شاٹ: Create codespace کے اختیارات + +> **Codespaces کے فوائد**: +> - کوئی مقامی تنصیب ضروری نہیں +> - کسی بھی ڈیوائس پر براؤزر کے ساتھ کام کرتا ہے +> - تمام ٹولز اور dependencies کے ساتھ پہلے سے ترتیب دیا گیا +> - ذاتی اکاؤنٹس کے لیے ہر مہینے 60 گھنٹے مفت +> - تمام سیکھنے والوں کے لیے یکساں ماحول + +#### اختیار B: مقامی ڈیو کنٹینر + +**ان ڈیولپرز کے لیے جو Docker کے ساتھ مقامی ترقی پسند کرتے ہیں** + +1. اس ریپوزٹری کو اپنی مقامی مشین پر فورک کریں اور کلون کریں + > **نوٹ**: اگر آپ بنیادی کنفیگریشن میں ترمیم کرنا چاہتے ہیں تو براہ کرم [Dev Container Configuration](../../../.devcontainer/devcontainer.json) دیکھیں +2. [Docker Desktop](https://www.docker.com/products/docker-desktop/) اور [VS Code](https://code.visualstudio.com/) انسٹال کریں +3. VS Code میں [Dev Containers extension](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers) انسٹال کریں +4. VS Code میں اس ریپوزٹری فولڈر کو کھولیں +5. جب پوچها جائے، تو **Reopen in Container** پر کلک کریں (یا `Ctrl+Shift+P` → "Dev Containers: Reopen in Container" استعمال کریں) +6. کنٹینر کے بنانے اور شروع ہونے کا انتظار کریں +7. [مرحلہ 2: GitHub ٹوکن بنائیں](../../../02-SetupDevEnvironment) پر جائیں + +اسکرین شاٹ: ڈیو کنٹینر سیٹ اپ + +اسکرین شاٹ: ڈیو کنٹینر کا تعمیر مکمل + +#### اختیار C: اپنی موجودہ مقامی تنصیب استعمال کریں + +**ان ڈیولپرز کے لیے جن کے پاس پہلے سے جاوا ماحول موجود ہے** + +ضروریات: +- [Java 21+](https://www.oracle.com/java/technologies/javase/jdk21-archive-downloads.html) +- [Maven 3.9+](https://maven.apache.org/download.cgi) +- [VS Code](https://code.visualstudio.com) یا آپ کی پسندیدہ IDE + +اقدامات: +1. اس ریپوزٹری کو اپنی مقامی مشین پر کلون کریں +2. پروجیکٹ کو اپنی IDE میں کھولیں +3. [مرحلہ 2: GitHub ٹوکن بنائیں](../../../02-SetupDevEnvironment) پر جائیں + +> **پرو ٹپ**: اگر آپ کے پاس کم صلاحیت والی مشین ہے لیکن آپ VS Code مقامی استعمال کرنا چاہتے ہیں، تو GitHub Codespaces استعمال کریں! آپ اپنے مقامی VS Code کو کلاؤڈ پر ہوسٹڈ Codespace سے جڑ سکتے ہیں تاکہ بہترین تجربہ حاصل ہو۔ + +اسکرین شاٹ: مقامی ڈیو کنٹینر انسٹنس ایجاد کی گئی + +## مرحلہ 2: GitHub پرسنل ایکسیس ٹوکن بنائیں + +1. [GitHub Settings](https://github.com/settings/profile) پر جائیں اور اپنے پروفائل مینو سے **Settings** منتخب کریں۔ +2. بائیں سائڈبار میں، **Developer settings** پر کلک کریں (عام طور پر نیچے کی جانب)۔ +3. **Personal access tokens** کے تحت، **Fine-grained tokens** پر کلک کریں (یا اس براہ راست [لنک](https://github.com/settings/personal-access-tokens) پر جائیں)۔ +4. **Generate new token** پر کلک کریں۔ +5. "Token name" کے تحت ایک وضاحتی نام دیں (مثلاً `GenAI-Java-Course-Token`)۔ +6. ایک وقت ختم ہونے کی تاریخ مقرر کریں (تجویز کردہ: 7 دن احتیاطی تدابیر کے لئے)۔ +7. "Resource owner" کے تحت اپنا صارف اکاؤنٹ منتخب کریں۔ +8. "Repository access" کے تحت وہ ریپوزٹریز منتخب کریں جنہیں آپ GitHub Models کے ساتھ استعمال کرنا چاہتے ہیں (یا "All repositories" اگر ضرورت ہو)۔ +9. "Account permissions" کے تحت **Models** کو **Read-only** پر سیٹ کریں۔ +10. **Generate token** پر کلک کریں۔ +11. **اب اپنے ٹوکن کو کاپی اور محفوظ کریں** – آپ اسے دوبارہ نہیں دیکھ پائیں گے! + +> **سیکیورٹی ٹپ**: اپنی ایکسیس ٹوکنز کے لیے کم از کم مطلوبہ حدود اور سب سے چھوٹا قابلِ عمل معیاد استعمال کریں۔ + +## مرحلہ 3: GitHub Models کی مثال کے ساتھ اپنی ترتیب کی جانچ کریں + +جب آپ کا ڈیولپمنٹ ماحول تیار ہو جائے، تو آئیے GitHub Models انٹیگریشن کو ہمارے مثال اپلیکیشن میں [`02-SetupDevEnvironment/examples/github-models`](../../../02-SetupDevEnvironment/examples/github-models) میں آزمائیں۔ + +1. اپنے ڈیولپمنٹ ماحول میں ٹرمینل کھولیں۔ +2. GitHub Models کی مثال کے فولڈر میں جائیں: + ```bash + cd 02-SetupDevEnvironment/examples/github-models + ``` +3. اپنا GitHub ٹوکن بطور انوائرنمنٹ ویریبل سیٹ کریں: + ```bash + # میک او ایس/لینکس + export GITHUB_TOKEN=your_token_here + + # ونڈوز (کمانڈ پرامپٹ) + set GITHUB_TOKEN=your_token_here + + # ونڈوز (پاور شیل) + $env:GITHUB_TOKEN="your_token_here" + ``` + +4. ایپلیکیشن چلائیں: + ```bash + mvn compile exec:java -Dexec.mainClass="com.example.githubmodels.App" + ``` + +آپ کو اس طرح کا آؤٹ پٹ دکھائی دینا چاہیے: +```text +Using model: gpt-4.1-nano +Sending request to GitHub Models... +Response: Hello World! +``` + +### مثال کوڈ کو سمجھنا + +سب سے پہلے، آئیے سمجھتے ہیں جو ہم نے ابھی چلایا۔ `examples/github-models` کے تحت موجود مثال OpenAI Java SDK استعمال کرتی ہے تاکہ GitHub Models سے جُڑے: + +**یہ کوڈ کیا کرتا ہے:** +- آپ کے پرسنل ایکسیس ٹوکن کے ذریعے GitHub Models سے **کنیکٹ** ہوتا ہے +- AI ماڈل کو ایک سادہ "Say Hello World!" پیغام **بھیجتا** ہے +- AI کے جواب کو **حاصل کرتا** ہے اور دکھاتا ہے +- آپ کی ترتیب کو درست کام کرنے کی تصدیق **کرتا** ہے + +**اہم انحصار** (`pom.xml` میں): +```xml + + com.openai + openai-java + 2.12.0 + +``` + +**مین کوڈ** (`App.java`): +```java +// اوپن اے آئی جاوا ایس ڈی کے کا استعمال کرتے ہوئے گٹ ہب ماڈلز سے منسلک ہوں +OpenAIClient client = OpenAIOkHttpClient.builder() + .apiKey(pat) + .baseUrl("https://models.inference.ai.azure.com") + .build(); + +// چیٹ تکمیل کی درخواست بنائیں +ChatCompletionCreateParams params = ChatCompletionCreateParams.builder() + .model(modelId) + .addSystemMessage("You are a concise assistant.") + .addUserMessage("Say Hello World!") + .build(); + +// اے آئی کا جواب حاصل کریں +ChatCompletion response = client.chat().completions().create(params); +System.out.println("Response: " + response.choices().get(0).message().content().orElse("No response content")); +``` + +## خلاصہ + +شاندار! اب آپ کے پاس سب کچھ ترتیب دیا گیا ہے: + +- AI ماڈلز تک رسائی کے لیے درست اجازتوں کے ساتھ GitHub پرسنل ایکسیس ٹوکن بنایا +- اپنا جاوا ڈیولپمنٹ ماحول چلایا (چاہے وہ Codespaces ہو، ڈیو کنٹینرز، یا مقامی) +- مفت AI ترقی کے لیے OpenAI Java SDK کے ذریعے GitHub Models سے جُڑے +- ایک سادہ مثال کے ساتھ جانچا کہ سب کچھ صحیح کام کر رہا ہے جو AI ماڈلز سے بات کرتا ہے + +## اگلے اقدامات + +[باب 3: کور جنریٹیو AI تکنیکس](../03-CoreGenerativeAITechniques/README.md) + +## مسائل کا حل + +مسائل درپیش ہیں؟ یہاں عام مسائل اور ان کے حل ہیں: + +- **ٹوکن کام نہیں کر رہا؟** + - یقینی بنائیں کہ آپ نے پورا ٹوکن بغیر کسی اضافی خالی جگہ کے کاپی کیا ہے + - تصدیق کریں کہ ٹوکن انوائرنمنٹ ویریبل کے طور پر صحیح سیٹ ہے + - چیک کریں کہ آپ کے ٹوکن کی اجازتیں درست ہیں (Models: Read-only) + +- **Maven نہیں مل رہا؟** + - اگر dev containers/Codespaces استعمال کر رہے ہیں تو Maven پیشگی انسٹال ہوتا ہے + - مقامی سیٹ اپ کے لیے، Java 21+ اور Maven 3.9+ انسٹال ہونا چاہیے + - `mvn --version` کمانڈ سے تصدیق کریں + +- **کنیکشن کے مسائل؟** + - اپنے انٹرنیٹ کنیکشن کو چیک کریں + - تصدیق کریں کہ GitHub آپ کے نیٹ ورک سے قابل رسائی ہے + - یقینی بنائیں کہ آپ فائر وال کے پیچھے نہیں ہیں جو GitHub Models کے اینڈپوائنٹ کو بلاک کر رہا ہو + +- **ڈیو کنٹینر شروع نہیں ہو رہا؟** + - یقینی بنائیں کہ Docker Desktop چل رہا ہے (مقامی ترقی کے لیے) + - کنٹینر دوبارہ بنانے کی کوشش کریں: `Ctrl+Shift+P` → "Dev Containers: Rebuild Container" + +- **ایپلیکیشن کمپائل کے ایررز؟** + - یقینی بنائیں کہ آپ صحیح ڈائریکٹری میں ہیں: `02-SetupDevEnvironment/examples/github-models` + - کلین اور دوبارہ تعمیر کی کوشش کریں: `mvn clean compile` + +> **مدد چاہیے؟**: اب بھی مسئلہ ہے؟ ریپوزٹری میں ایک مسئلہ کھولیں اور ہم آپ کی مدد کریں گے۔ --- + +**دستخطی دستبرداری**: +یہ دستاویز [Co-op Translator](https://github.com/Azure/co-op-translator) نامی AI ترجمہ سروس کے ذریعے ترجمہ کی گئی ہے۔ اگرچہ ہم درستگی کے لیے کوشاں ہیں، براہ کرم یاد رکھیں کہ خودکار تراجم میں غلطیاں یا عدم صحت ہو سکتی ہے۔ اصل دستاویز اپنی مادری زبان میں ہی معتبر ماخذ سمجھا جائے گا۔ اہم معلومات کے لیے پیشہ ورانہ انسانی ترجمہ تجویز کیا جاتا ہے۔ اس ترجمہ کے استعمال سے پیدا ہونے والی کسی بھی غلط فہمی یا غلط تشریح کی صورت میں ہم ذمہ دار نہیں ہوں گے۔ + \ No newline at end of file diff --git a/translations/ur/02-SetupDevEnvironment/examples/basic-chat-azure/README.md b/translations/ur/02-SetupDevEnvironment/examples/basic-chat-azure/README.md index 218761c9..3c3d833e 100644 --- a/translations/ur/02-SetupDevEnvironment/examples/basic-chat-azure/README.md +++ b/translations/ur/02-SetupDevEnvironment/examples/basic-chat-azure/README.md @@ -1,12 +1,3 @@ - # Azure OpenAI کے ساتھ بنیادی چیٹ - مکمل مثال یہ مثال دکھاتی ہے کہ کس طرح ایک سادہ اسپرنگ بوٹ ایپلیکیشن بنائی جائے جو Azure OpenAI سے جڑتی ہے اور آپ کی سیٹ اپ کو ٹیسٹ کرتی ہے۔ diff --git a/translations/ur/02-SetupDevEnvironment/getting-started-azure-openai.md b/translations/ur/02-SetupDevEnvironment/getting-started-azure-openai.md index d1e90f4c..de6e67fa 100644 --- a/translations/ur/02-SetupDevEnvironment/getting-started-azure-openai.md +++ b/translations/ur/02-SetupDevEnvironment/getting-started-azure-openai.md @@ -1,12 +1,3 @@ - # ایزور اوپن اے آئی کے لیے ڈیولپمنٹ ماحول ترتیب دینا > **جلدی شروع کریں**: یہ گائیڈ ایزور اوپن اے آئی سیٹ اپ کے لیے ہے۔ مفت ماڈلز کے ساتھ فوری آغاز کے لیے [GitHub Models with Codespaces](./README.md#quick-start-cloud) استعمال کریں۔ diff --git a/translations/ur/03-CoreGenerativeAITechniques/README.md b/translations/ur/03-CoreGenerativeAITechniques/README.md index edaf73d8..5d13ddb7 100644 --- a/translations/ur/03-CoreGenerativeAITechniques/README.md +++ b/translations/ur/03-CoreGenerativeAITechniques/README.md @@ -1,12 +1,3 @@ - # کور جنریٹو اے آئی تکنیکس ٹیوٹوریل ## فہرستِ مضامین diff --git a/translations/ur/04-PracticalSamples/README.md b/translations/ur/04-PracticalSamples/README.md index e2569fa0..0162f3b4 100644 --- a/translations/ur/04-PracticalSamples/README.md +++ b/translations/ur/04-PracticalSamples/README.md @@ -1,12 +1,3 @@ - # عملی اطلاقات اور منصوبے ## آپ کیا سیکھیں گے diff --git a/translations/ur/04-PracticalSamples/calculator/README.md b/translations/ur/04-PracticalSamples/calculator/README.md index 7a67699a..838eef53 100644 --- a/translations/ur/04-PracticalSamples/calculator/README.md +++ b/translations/ur/04-PracticalSamples/calculator/README.md @@ -1,12 +1,3 @@ - # ایم سی پی کیلکولیٹر ٹیوٹوریل برائے ابتدائی افراد ## مواد کی فہرست diff --git a/translations/ur/04-PracticalSamples/foundrylocal/README.md b/translations/ur/04-PracticalSamples/foundrylocal/README.md index a194eafb..536d1c76 100644 --- a/translations/ur/04-PracticalSamples/foundrylocal/README.md +++ b/translations/ur/04-PracticalSamples/foundrylocal/README.md @@ -1,12 +1,3 @@ - # فاؤنڈری لوکل اسپرنگ بوٹ ٹیوٹوریل ## مواد کی فہرست diff --git a/translations/ur/04-PracticalSamples/petstory/README.md b/translations/ur/04-PracticalSamples/petstory/README.md index d1dd02c5..0799f00b 100644 --- a/translations/ur/04-PracticalSamples/petstory/README.md +++ b/translations/ur/04-PracticalSamples/petstory/README.md @@ -1,12 +1,3 @@ - # پالتو جانوروں کی کہانی بنانے کا ابتدائی ٹیوٹوریل ## مواد کی فہرست diff --git a/translations/ur/05-ResponsibleGenAI/README.md b/translations/ur/05-ResponsibleGenAI/README.md index 8523e352..1e832311 100644 --- a/translations/ur/05-ResponsibleGenAI/README.md +++ b/translations/ur/05-ResponsibleGenAI/README.md @@ -1,12 +1,3 @@ - # ذمہ دار جنریٹو اے آئی ## آپ کیا سیکھیں گے؟ diff --git a/translations/ur/AGENTS.md b/translations/ur/AGENTS.md index 1578aba3..f994a138 100644 --- a/translations/ur/AGENTS.md +++ b/translations/ur/AGENTS.md @@ -1,12 +1,3 @@ - # AGENTS.md ## پروجیکٹ کا جائزہ diff --git a/translations/ur/CODE_OF_CONDUCT.md b/translations/ur/CODE_OF_CONDUCT.md index 4f67e37d..6b5d4993 100644 --- a/translations/ur/CODE_OF_CONDUCT.md +++ b/translations/ur/CODE_OF_CONDUCT.md @@ -1,12 +1,3 @@ - # مائیکروسافٹ اوپن سورس ضابطہ اخلاق اس پروجیکٹ نے [مائیکروسافٹ اوپن سورس ضابطہ اخلاق](https://opensource.microsoft.com/codeofconduct/) کو اپنایا ہے۔ diff --git a/translations/ur/README.md b/translations/ur/README.md index ac80daba..0516add3 100644 --- a/translations/ur/README.md +++ b/translations/ur/README.md @@ -1,146 +1,138 @@ - -# ابتدائیوں کے لیے جنریٹو AI - جاوا ایڈیشن +# ابتدائیوں کے لیے جنریٹو اے آئی - جاوا ایڈیشن [![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) -![ابتدائیوں کے لیے جنریٹو AI - جاوا ایڈیشن](../../translated_images/ur/beg-genai-series.8b48be9951cc574c.webp) +![ابتدائیوں کے لیے جنریٹو اے آئی - جاوا ایڈیشن](../../translated_images/ur/beg-genai-series.8b48be9951cc574c.webp) -**وقت کی وابستگی**: پورا ورکشاپ آن لائن مکمل کیا جا سکتا ہے بغیر لوکل سیٹ اپ کے۔ ماحول کی ترتیب میں 2 منٹ لگتے ہیں، نمونوں کو دریافت کرنے میں 1-3 گھنٹے لگ سکتے ہیں، دریافت کی گہرائی پر منحصر ہے۔ +**وقت کی وابستگی**: پورا ورکشاپ آن لائن بغیر لوکل سیٹ اپ کے مکمل کیا جا سکتا ہے۔ ماحول کی تیاری میں 2 منٹ لگتے ہیں، اور نمونوں کی تحقیق میں 1-3 گھنٹے لگ سکتے ہیں جو تحقیق کی گہرائی پر منحصر ہے۔ -> **جلدی آغاز** +> **فوری آغاز** -1. اس ریپوزٹری کو اپنے GitHub اکاؤنٹ میں فورک کریں -2. **Code** → **Codespaces** ٹیب → **...** → **New with options...** پر کلک کریں -3. ڈیفالٹس استعمال کریں – اس سے اس کورس کے لیے تیار کردہ Development container منتخب ہو جائے گا +1. اس ذخیرہ کو اپنے GitHub اکاؤنٹ میں فورک کریں +2. **Code** پر کلک کریں → **Codespaces** ٹیب → **...** → **New with options...** +3. ڈیفالٹس کا استعمال کریں – یہ اس کورس کے لیے بنائی گئی ڈیولپمنٹ کنٹینر کا انتخاب کرے گا 4. **Create codespace** پر کلک کریں -5. ماحول کے تیار ہونے کے لیے تقریباً 2 منٹ انتظار کریں -6. سیدھا [پہلے مثال](./02-SetupDevEnvironment/README.md#step-2-create-a-github-personal-access-token) پر جائیں +5. تقریباً 2 منٹ انتظار کریں تاکہ ماحول تیار ہو جائے +6. سیدھے [پہلے مثال](./02-SetupDevEnvironment/README.md#step-2-create-a-github-personal-access-token) پر پہنچیں -> **لوکل کلوننگ کو ترجیح دیتے ہیں؟** +> **کیا آپ لوکل کلون کرنا پسند کریں گے؟** > -> اس ریپوزٹری میں 50+ زبانوں کے تراجم شامل ہیں جو ڈاؤن لوڈ سائز کو خاصا بڑھاتے ہیں۔ بغیر تراجم کے کلون کرنے کے لیے sparse checkout استعمال کریں: +> اس ذخیرہ میں 50+ زبانوں کے تراجم شامل ہیں جو ڈاؤن لوڈ کے سائز کو نمایاں طور پر بڑھاتے ہیں۔ بغیر تراجم کے کلون کرنے کے لیے sparse checkout استعمال کریں: > ```bash > git clone --filter=blob:none --sparse https://github.com/microsoft/Generative-AI-for-beginners-java.git > cd Generative-AI-for-beginners-java > git sparse-checkout set --no-cone '/*' '!translations' '!translated_images' > ``` -> یہ آپ کو کورس مکمل کرنے کے لیے تمام ضروری چیزیں فراہم کرتا ہے اور ڈاؤن لوڈ بہت تیز ہوتا ہے۔ +> یہ آپ کو کورس مکمل کرنے کے لیے ہر چیز فراہم کرتا ہے، اور ڈاؤن لوڈ بہت تیز ہوتا ہے۔ -## کثیر لسانی حمایت +## کثیر زبانی سپورٹ -### GitHub Action کے ذریعے سپورٹ (خودکار اور ہمیشہ تازہ ترین) +### GitHub Action کے ذریعے حمایت یافتہ (خودکار اور ہمیشہ تازہ ترین) -[عربی](../ar/README.md) | [بنگالی](../bn/README.md) | [بلغاریائی](../bg/README.md) | [برمی (میانمار)](../my/README.md) | [چینی (سادہ)](../zh/README.md) | [چینی (روایتی، ہانگ کانگ)](../hk/README.md) | [چینی (روایتی، ماؤ)](../mo/README.md) | [چینی (روایتی، تائیوان)](../tw/README.md) | [کروشیائی](../hr/README.md) | [چیک](../cs/README.md) | [ڈینش](../da/README.md) | [ڈچ](../nl/README.md) | [ایسٹونین](../et/README.md) | [فنلش](../fi/README.md) | [فرانسیسی](../fr/README.md) | [جرمن](../de/README.md) | [یونانی](../el/README.md) | [عبرانی](../he/README.md) | [ہندی](../hi/README.md) | [ہنگیرین](../hu/README.md) | [انڈونیشین](../id/README.md) | [اطالوی](../it/README.md) | [جاپانی](../ja/README.md) | [کنڑا](../kn/README.md) | [کوریائی](../ko/README.md) | [لتھوانین](../lt/README.md) | [ملائی](../ms/README.md) | [مالایالم](../ml/README.md) | [مراٹھی](../mr/README.md) | [نیپالی](../ne/README.md) | [نائجیریائی پیدگن](../pcm/README.md) | [ناروے](../no/README.md) | [فارسی (فارس)](../fa/README.md) | [پولش](../pl/README.md) | [پرتگالی (برازیل)](../br/README.md) | [پرتگالی (پورٹوگال)](../pt/README.md) | [پنجابی (گرمکھی)](../pa/README.md) | [رومنین](../ro/README.md) | [روسی](../ru/README.md) | [سربیائی (سریلی)]](../sr/README.md) | [سلوواک](../sk/README.md) | [سلووینین](../sl/README.md) | [ہسپانوی](../es/README.md) | [سواحلی](../sw/README.md) | [سویڈش](../sv/README.md) | [ٹگالگ (فلپائنی)](../tl/README.md) | [تمل](../ta/README.md) | [تیلگو](../te/README.md) | [تھائی](../th/README.md) | [ترکی](../tr/README.md) | [یوکرینیائی](../uk/README.md) | [اردو](./README.md) | [ویتنامی](../vi/README.md) +[عربی](../ar/README.md) | [بنگالی](../bn/README.md) | [بلغاریائی](../bg/README.md) | [برمی (میانمار)](../my/README.md) | [چینی (سادہ)](../zh-CN/README.md) | [چینی (روایتی، ہانگ کانگ)](../zh-HK/README.md) | [چینی (روایتی، مکاو)](../zh-MO/README.md) | [چینی (روایتی، تائیوان)](../zh-TW/README.md) | [کروشیائی](../hr/README.md) | [چےک](../cs/README.md) | [ڈینش](../da/README.md) | [ڈچ](../nl/README.md) | [ایسٹونین](../et/README.md) | [فنش](../fi/README.md) | [فرانسیسی](../fr/README.md) | [جرمن](../de/README.md) | [یونانی](../el/README.md) | [عبرانی](../he/README.md) | [ہندی](../hi/README.md) | [ہنگیری](../hu/README.md) | [انڈونیشیائی](../id/README.md) | [اطالوی](../it/README.md) | [جاپانی](../ja/README.md) | [کنڑ](../kn/README.md) | [کوریائی](../ko/README.md) | [لتھوانین](../lt/README.md) | [مالے](../ms/README.md) | [مالیالم](../ml/README.md) | [مراٹھی](../mr/README.md) | [نیپالی](../ne/README.md) | [نیجیریائی پڈگن](../pcm/README.md) | [ناروے](../no/README.md) | [فارسی (فارس)](../fa/README.md) | [پولش](../pl/README.md) | [پرتگالی (برازیل)](../pt-BR/README.md) | [پرتگالی (پرتگال)](../pt-PT/README.md) | [پنجابی (گورمکھی)](../pa/README.md) | [رومانیائی](../ro/README.md) | [روسی](../ru/README.md) | [سربیائی (سریلیک)](../sr/README.md) | [سلوواک](../sk/README.md) | [سلووینین](../sl/README.md) | [ہسپانوی](../es/README.md) | [سواحلی](../sw/README.md) | [سویڈش](../sv/README.md) | [ٹگالوگ (فلپائنی)](../tl/README.md) | [تامِل](../ta/README.md) | [تیلوگو](../te/README.md) | [تھائی](../th/README.md) | [ترکی](../tr/README.md) | [یوکرینی](../uk/README.md) | [اردو](./README.md) | [ویت نامی](../vi/README.md) -> **لوکل کلوننگ کو ترجیح دیتے ہیں؟** +> **کیا آپ لوکل کلون کرنا پسند کریں گے؟** -> اس ریپوزٹری میں 50+ زبانوں کے تراجم شامل ہیں جو ڈاؤن لوڈ سائز کو خاصا بڑھاتے ہیں۔ بغیر تراجم کے کلون کرنے کے لیے sparse checkout استعمال کریں: +> اس ذخیرہ میں 50+ زبانوں کے تراجم شامل ہیں جو ڈاؤن لوڈ کے سائز کو نمایاں طور پر بڑھاتے ہیں۔ بغیر تراجم کے کلون کرنے کے لیے sparse checkout استعمال کریں: > ```bash > git clone --filter=blob:none --sparse https://github.com/microsoft/Generative-AI-for-beginners-java.git > cd Generative-AI-for-beginners-java > git sparse-checkout set --no-cone '/*' '!translations' '!translated_images' > ``` -> یہ آپ کو کورس مکمل کرنے کے لیے تمام ضروری چیزیں فراہم کرتا ہے اور ڈاؤن لوڈ بہت تیز ہوتا ہے۔ +> یہ آپ کو کورس مکمل کرنے کے لیے ہر چیز فراہم کرتا ہے، اور ڈاؤن لوڈ بہت تیز ہوتا ہے۔ ## کورس کی ساخت اور سیکھنے کا راستہ -### **باب 1: جنریٹو AI کا تعارف** -- **بنیادی تصورات**: بڑی زبان کے ماڈلز، ٹوکنز، ایمبیڈنگز، اور AI کی صلاحیتوں کو سمجھنا -- **جاوا AI ماحولیاتی نظام**: Spring AI اور OpenAI SDKs کا جائزہ -- **ماڈل کانٹیکسٹ پروٹوکول**: MCP کا تعارف اور AI ایجنٹ کمیونیکیشن میں اس کا کردار -- **عملی اطلاقات**: حقیقی دنیا کے منظرنامے، بشمول چیٹ بوٹس اور مواد کی تخلیق +### **باب 1: جنریٹو اے آئی کا تعارف** +- **اہم تصورات**: بڑے زبان کے ماڈلز، ٹوکنز، ایمبیڈنگز، اور اے آئی کی صلاحیتوں کی سمجھ +- **جاوا اے آئی کا ماحولی نظام**: اسپرنگ اے آئی اور OpenAI SDKs کا جائزہ +- **ماڈل کانٹیکسٹ پروٹوکول**: MCP کا تعارف اور اے آئی ایجنٹ مواصلات میں اس کا کردار +- **عملی اطلاقات**: حقیقی دنیا کے منظرنامے جن میں چیٹ بوٹس اور مواد کی تخلیق شامل ہیں - **[→ باب 1 شروع کریں](./01-IntroToGenAI/README.md)** -### **باب 2: ترقیاتی ماحول کی ترتیب** -- **کثیر فراہم کنندہ کنفیگریشن**: GitHub ماڈلز، Azure OpenAI، اور OpenAI Java SDK انضمام کی سیٹ اپ -- **Spring Boot + Spring AI**: انٹرپرائز AI ایپلیکیشن ڈویلپمنٹ کے بہترین طریقے -- **GitHub ماڈلز**: پروٹو ٹائپنگ اور سیکھنے کے لیے مفت AI ماڈل تک رسائی (کریڈٹ کارڈ کی ضرورت نہیں) -- **ترقیاتی ٹولز**: Docker کنٹینرز، VS Code، اور GitHub Codespaces کی ترتیب +### **باب 2: ترقیاتی ماحول کی تیاری** +- **کثیر فراہم کنندہ ترتیب**: GitHub Models، Azure OpenAI، اور OpenAI Java SDK انضمامات کی تیاری +- **اسپرنگ بوٹ + اسپرنگ اے آئی**: انٹرپرائز اے آئی ایپلیکیشن کی ترقی کے لیے بہترین طریقے +- **GitHub Models**: نمونہ سازی اور سیکھنے کے لیے مفت اے آئی ماڈل تک رسائی (کریڈٹ کارڈ کی ضرورت نہیں) +- **ترقیاتی اوزار**: ڈاکر کنٹینرز، VS Code، اور GitHub Codespaces کی ترتیب - **[→ باب 2 شروع کریں](./02-SetupDevEnvironment/README.md)** -### **باب 3: بنیادی جنریٹو AI تکنیکیں** -- **پرامپٹ انجینئرنگ**: AI ماڈل کے جوابات کے لیے بہترین تکنیکیں -- **ایمبیڈنگز اور ویکٹر آپریشنز**: سیمنٹک سرچ اور مماثلت کا نفاذ -- **ریٹریول آگمینٹڈ جنریشن (RAG)**: AI کو اپنی ڈیٹا سورسز کے ساتھ ملائیں -- **فنکشن کالنگ**: کسٹم ٹولز اور پلگ انز کے ساتھ AI صلاحیتوں کو بڑھائیں +### **باب 3: بنیادی جنریٹو اے آئی تکنیکیں** +- **پرومپٹ انجینئرنگ**: بہترین اے آئی ماڈل ردعمل کے طریقے +- **ایمبیڈنگز اور ویکٹر آپریشنز**: معنوی تلاش اور مماثلت میچنگ کا نفاذ +- **ریٹریول-آگمینٹڈ جنریشن (RAG)**: اے آئی کو اپنے ڈیٹا ذرائع کے ساتھ ملائیں +- **فنکشن کالنگ**: حسب ضرورت اوزار اور پلگ انز کے ساتھ اے آئی صلاحیتوں میں اضافہ کریں - **[→ باب 3 شروع کریں](./03-CoreGenerativeAITechniques/README.md)** -### **باب 4: عملی اطلاقات اور منصوبے** -- **پالتو جانوروں کی کہانی بنانے والا** (`petstory/`): GitHub ماڈلز کے ساتھ تخلیقی مواد کی تخلیق -- **Foundry لوکل ڈیمو** (`foundrylocal/`): OpenAI Java SDK کے ساتھ مقامی AI ماڈل انضمام -- **MCP کیلکولیٹر سروس** (`calculator/`): Spring AI کے ساتھ بنیادی ماڈل کانٹیکسٹ پروٹوکول کا نفاذ +### **باب 4: عملی اطلاقات اور پروجیکٹس** +- **پیٹ سٹوری جنریٹر** (`petstory/`): GitHub Models کے ساتھ تخلیقی مواد کی تخلیق +- **فاؤنڈری لوکل ڈیمو** (`foundrylocal/`): OpenAI Java SDK کے ساتھ لوکل اے آئی ماڈل انضمام +- **MCP کیلکولیٹر سروس** (`calculator/`): اسپرنگ اے آئی کے ساتھ بنیادی ماڈل کانٹیکسٹ پروٹوکول کا نفاذ - **[→ باب 4 شروع کریں](./04-PracticalSamples/README.md)** -### **باب 5: ذمہ دار AI کی ترقی** -- **GitHub ماڈلز کی حفاظت**: بلٹ ان مواد کی فلٹرنگ اور سیفٹی مکینزم (ہارڈ بلاکس اور سوفٹ انکار) کی جانچ -- **ذمہ دار AI ڈیمو**: ایک عملی مثال دکھاتی ہے کہ جدید AI سیفٹی سسٹمز کس طرح کام کرتے ہیں -- **بہترین طریقے**: اخلاقی AI ترقی اور تعیناتی کے لیے ضروری رہنما اصول +### **باب 5: ذمہ دار اے آئی ترقی** +- **GitHub Models کی حفاظت**: بلٹ ان مواد کی فلٹریشن اور حفاظتی میکانزمز کا ٹیسٹ کریں (سخت پابندیاں اور نرم انکار) +- **ذمہ دار اے آئی ڈیمو**: جدید اے آئی حفاظتی نظاموں کے عملی کام کا مظاہرہ +- **بہترین طریقے**: اخلاقی اے آئی ترقی اور تعیناتی کے بنیادی اصول - **[→ باب 5 شروع کریں](./05-ResponsibleGenAI/README.md)** ## اضافی وسائل -### LangChain -[![LangChain4j ابتدائیوں کے لیے](https://img.shields.io/badge/LangChain4j%20for%20Beginners-22C55E?style=for-the-badge&&labelColor=E5E7EB&color=0553D6)](https://aka.ms/langchain4j-for-beginners) -[![LangChain.js ابتدائیوں کے لیے](https://img.shields.io/badge/LangChain.js%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=0553D6)](https://aka.ms/langchainjs-for-beginners?WT.mc_id=m365-94501-dwahlin) +### لینگ چین +[![ابتدائیوں کے لیے LangChain4j](https://img.shields.io/badge/LangChain4j%20for%20Beginners-22C55E?style=for-the-badge&&labelColor=E5E7EB&color=0553D6)](https://aka.ms/langchain4j-for-beginners) +[![ابتدائیوں کے لیے LangChain.js](https://img.shields.io/badge/LangChain.js%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=0553D6)](https://aka.ms/langchainjs-for-beginners?WT.mc_id=m365-94501-dwahlin) --- -### Azure / Edge / MCP / ایجنٹس -[![AZD ابتدائیوں کے لیے](https://img.shields.io/badge/AZD%20for%20Beginners-0078D4?style=for-the-badge&labelColor=E5E7EB&color=0078D4)](https://github.com/microsoft/AZD-for-beginners?WT.mc_id=academic-105485-koreyst) -[![Edge AI ابتدائیوں کے لیے](https://img.shields.io/badge/Edge%20AI%20for%20Beginners-00B8E4?style=for-the-badge&labelColor=E5E7EB&color=00B8E4)](https://github.com/microsoft/edgeai-for-beginners?WT.mc_id=academic-105485-koreyst) -[![MCP ابتدائیوں کے لیے](https://img.shields.io/badge/MCP%20for%20Beginners-009688?style=for-the-badge&labelColor=E5E7EB&color=009688)](https://github.com/microsoft/mcp-for-beginners?WT.mc_id=academic-105485-koreyst) -[![AI ایجنٹس ابتدائیوں کے لیے](https://img.shields.io/badge/AI%20Agents%20for%20Beginners-00C49A?style=for-the-badge&labelColor=E5E7EB&color=00C49A)](https://github.com/microsoft/ai-agents-for-beginners?WT.mc_id=academic-105485-koreyst) +### ایزور / ایج / MCP / ایجنٹس +[![ابتدائیوں کے لیے AZD](https://img.shields.io/badge/AZD%20for%20Beginners-0078D4?style=for-the-badge&labelColor=E5E7EB&color=0078D4)](https://github.com/microsoft/AZD-for-beginners?WT.mc_id=academic-105485-koreyst) +[![ابتدائیوں کے لیے ایج اے آئی](https://img.shields.io/badge/Edge%20AI%20for%20Beginners-00B8E4?style=for-the-badge&labelColor=E5E7EB&color=00B8E4)](https://github.com/microsoft/edgeai-for-beginners?WT.mc_id=academic-105485-koreyst) +[![ابتدائیوں کے لیے MCP](https://img.shields.io/badge/MCP%20for%20Beginners-009688?style=for-the-badge&labelColor=E5E7EB&color=009688)](https://github.com/microsoft/mcp-for-beginners?WT.mc_id=academic-105485-koreyst) +[![ابتدائیوں کے لیے اے آئی ایجنٹس](https://img.shields.io/badge/AI%20Agents%20for%20Beginners-00C49A?style=for-the-badge&labelColor=E5E7EB&color=00C49A)](https://github.com/microsoft/ai-agents-for-beginners?WT.mc_id=academic-105485-koreyst) --- - -### جنریٹو AI سیریز -[![ابتدائیوں کے لیے جنریٹو AI](https://img.shields.io/badge/Generative%20AI%20for%20Beginners-8B5CF6?style=for-the-badge&labelColor=E5E7EB&color=8B5CF6)](https://github.com/microsoft/generative-ai-for-beginners?WT.mc_id=academic-105485-koreyst) -[![جنریٹو AI (.NET)](https://img.shields.io/badge/Generative%20AI%20(.NET)-9333EA?style=for-the-badge&labelColor=E5E7EB&color=9333EA)](https://github.com/microsoft/Generative-AI-for-beginners-dotnet?WT.mc_id=academic-105485-koreyst) -[![جنریٹو AI (جاوا)](https://img.shields.io/badge/Generative%20AI%20(Java)-C084FC?style=for-the-badge&labelColor=E5E7EB&color=C084FC)](https://github.com/microsoft/generative-ai-for-beginners-java?WT.mc_id=academic-105485-koreyst) -[![جنریٹو AI (جاوااسکرپٹ)](https://img.shields.io/badge/Generative%20AI%20(JavaScript)-E879F9?style=for-the-badge&labelColor=E5E7EB&color=E879F9)](https://github.com/microsoft/generative-ai-with-javascript?WT.mc_id=academic-105485-koreyst) + +### جنریٹو اے آئی سیریز +[![ابتدائیوں کے لیے جنریٹو اے آئی](https://img.shields.io/badge/Generative%20AI%20for%20Beginners-8B5CF6?style=for-the-badge&labelColor=E5E7EB&color=8B5CF6)](https://github.com/microsoft/generative-ai-for-beginners?WT.mc_id=academic-105485-koreyst) +[![جنریٹو اے آئی (.NET)](https://img.shields.io/badge/Generative%20AI%20(.NET)-9333EA?style=for-the-badge&labelColor=E5E7EB&color=9333EA)](https://github.com/microsoft/Generative-AI-for-beginners-dotnet?WT.mc_id=academic-105485-koreyst) +[![جنریٹو اے آئی (جاوا)](https://img.shields.io/badge/Generative%20AI%20(Java)-C084FC?style=for-the-badge&labelColor=E5E7EB&color=C084FC)](https://github.com/microsoft/generative-ai-for-beginners-java?WT.mc_id=academic-105485-koreyst) +[![جنریٹو اے آئی (جاوا اسکرپٹ)](https://img.shields.io/badge/Generative%20AI%20(JavaScript)-E879F9?style=for-the-badge&labelColor=E5E7EB&color=E879F9)](https://github.com/microsoft/generative-ai-with-javascript?WT.mc_id=academic-105485-koreyst) --- - + ### بنیادی تعلیم -[![ابتدائیوں کے لیے ML](https://img.shields.io/badge/ML%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=22C55E)](https://aka.ms/ml-beginners?WT.mc_id=academic-105485-koreyst) +[![ابتدائیوں کے لیے مشین لرننگ](https://img.shields.io/badge/ML%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=22C55E)](https://aka.ms/ml-beginners?WT.mc_id=academic-105485-koreyst) [![ابتدائیوں کے لیے ڈیٹا سائنس](https://img.shields.io/badge/Data%20Science%20for%20Beginners-84CC16?style=for-the-badge&labelColor=E5E7EB&color=84CC16)](https://aka.ms/datascience-beginners?WT.mc_id=academic-105485-koreyst) -[![ابتدائیوں کے لیے AI](https://img.shields.io/badge/AI%20for%20Beginners-A3E635?style=for-the-badge&labelColor=E5E7EB&color=A3E635)](https://aka.ms/ai-beginners?WT.mc_id=academic-105485-koreyst) -[![ابتدائیوں کے لیے سائبرسیکیورٹی](https://img.shields.io/badge/Cybersecurity%20for%20Beginners-F97316?style=for-the-badge&labelColor=E5E7EB&color=F97316)](https://github.com/microsoft/Security-101?WT.mc_id=academic-96948-sayoung) +[![ابتدائیوں کے لیے اے آئی](https://img.shields.io/badge/AI%20for%20Beginners-A3E635?style=for-the-badge&labelColor=E5E7EB&color=A3E635)](https://aka.ms/ai-beginners?WT.mc_id=academic-105485-koreyst) +[![ابتدائیوں کے لیے سائبر سیکیورٹی](https://img.shields.io/badge/Cybersecurity%20for%20Beginners-F97316?style=for-the-badge&labelColor=E5E7EB&color=F97316)](https://github.com/microsoft/Security-101?WT.mc_id=academic-96948-sayoung) + [![ابتدائیوں کے لیے ویب ڈویلپمنٹ](https://img.shields.io/badge/Web%20Dev%20for%20Beginners-EC4899?style=for-the-badge&labelColor=E5E7EB&color=EC4899)](https://aka.ms/webdev-beginners?WT.mc_id=academic-105485-koreyst) -[![IoT for Beginners](https://img.shields.io/badge/IoT%20for%20Beginners-14B8A6?style=for-the-badge&labelColor=E5E7EB&color=14B8A6)](https://aka.ms/iot-beginners?WT.mc_id=academic-105485-koreyst) -[![XR Development for Beginners](https://img.shields.io/badge/XR%20Development%20for%20Beginners-38BDF8?style=for-the-badge&labelColor=E5E7EB&color=38BDF8)](https://github.com/microsoft/xr-development-for-beginners?WT.mc_id=academic-105485-koreyst) +[![ابتدائیوں کے لیے IoT](https://img.shields.io/badge/IoT%20for%20Beginners-14B8A6?style=for-the-badge&labelColor=E5E7EB&color=14B8A6)](https://aka.ms/iot-beginners?WT.mc_id=academic-105485-koreyst) +[![ابتدائیوں کے لیے XR ڈویلپمنٹ](https://img.shields.io/badge/XR%20Development%20for%20Beginners-38BDF8?style=for-the-badge&labelColor=E5E7EB&color=38BDF8)](https://github.com/microsoft/xr-development-for-beginners?WT.mc_id=academic-105485-koreyst) --- -### کاپائلٹ سیریز -[![Copilot for AI Paired Programming](https://img.shields.io/badge/Copilot%20for%20AI%20Paired%20Programming-FACC15?style=for-the-badge&labelColor=E5E7EB&color=FACC15)](https://aka.ms/GitHubCopilotAI?WT.mc_id=academic-105485-koreyst) -[![Copilot for C#/.NET](https://img.shields.io/badge/Copilot%20for%20C%23/.NET-FBBF24?style=for-the-badge&labelColor=E5E7EB&color=FBBF24)](https://github.com/microsoft/mastering-github-copilot-for-dotnet-csharp-developers?WT.mc_id=academic-105485-koreyst) -[![Copilot Adventure](https://img.shields.io/badge/Copilot%20Adventure-FDE68A?style=for-the-badge&labelColor=E5E7EB&color=FDE68A)](https://github.com/microsoft/CopilotAdventures?WT.mc_id=academic-105485-koreyst) +### کوپائلٹ سیریز +[![AI جوڑی پروگرامنگ کے لیے کوپائلٹ](https://img.shields.io/badge/Copilot%20for%20AI%20Paired%20Programming-FACC15?style=for-the-badge&labelColor=E5E7EB&color=FACC15)](https://aka.ms/GitHubCopilotAI?WT.mc_id=academic-105485-koreyst) +[![C#/.NET کے لیے کوپائلٹ](https://img.shields.io/badge/Copilot%20for%20C%23/.NET-FBBF24?style=for-the-badge&labelColor=E5E7EB&color=FBBF24)](https://github.com/microsoft/mastering-github-copilot-for-dotnet-csharp-developers?WT.mc_id=academic-105485-koreyst) +[![کوپائلٹ ایڈونچر](https://img.shields.io/badge/Copilot%20Adventure-FDE68A?style=for-the-badge&labelColor=E5E7EB&color=FDE68A)](https://github.com/microsoft/CopilotAdventures?WT.mc_id=academic-105485-koreyst) ## مدد حاصل کرنا -اگر آپ پھنس جاتے ہیں یا AI ایپس بنانے کے بارے میں کوئی سوال ہے۔ دوسرے سیکھنے والوں اور تجربہ کار ڈویلپرز کے ساتھ MCP پر مباحثہ میں شامل ہوں۔ یہ ایک معاون کمیونٹی ہے جہاں سوالات کا خیرمقدم کیا جاتا ہے اور علم آزادانہ طور پر شیئر کیا جاتا ہے۔ +اگر آپ پھنس جائیں یا AI ایپس بنانے کے بارے میں کوئی سوال ہو تو MCP پر ساتھی سیکھنے والوں اور تجربہ کار ڈویلپرز کے ساتھ بات چیت میں شامل ہوں۔ یہ ایک مددگار کمیونٹی ہے جہاں سوالات کا خیرمقدم کیا جاتا ہے اور علم آزادانہ طور پر شیئر کیا جاتا ہے۔ [![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) -اگر آپ کے پاس مصنوعات کے بارے میں تاثرات یا تعمیر کے دوران خامیاں ہیں تو یہاں جائیں: +اگر آپ کے پاس پراڈکٹ پر تاثرات یا تعمیر کے دوران غلطیاں ہوں تو یہاں جائیں: [![Microsoft Foundry Developer Forum](https://img.shields.io/badge/GitHub-Microsoft_Foundry_Developer_Forum-blue?style=for-the-badge&logo=github&color=000000&logoColor=fff)](https://aka.ms/foundry/forum) --- -**ڈسکلیمر**: -یہ دستاویز AI ترجمہ سروس [Co-op Translator](https://github.com/Azure/co-op-translator) کے ذریعے ترجمہ کی گئی ہے۔ اگرچہ ہم درستگی کے لئے کوشش کرتے ہیں، براہ کرم نوٹ کریں کہ خودکار ترجمے میں غلطیاں یا عدم مطابقت ہو سکتی ہے۔ اصل دستاویز اپنی مادری زبان میں مجاز ماخذ سمجھا جائے گا۔ اہم معلومات کے لیے پیشہ ور انسانی ترجمہ کی سفارش کی جاتی ہے۔ اس ترجمے کے استعمال سے ہونے والی کسی بھی غلط فہمی یا غلط تشریحات کی ذمہ داری ہم پر عائد نہیں ہوتی۔ +**دستخطی اعلامیہ**: +یہ دستاویز AI ترجمہ سروس [Co-op Translator](https://github.com/Azure/co-op-translator) کے ذریعے ترجمہ کی گئی ہے۔ اگرچہ ہم درستگی کے لیے کوشاں ہیں، براہ کرم آگاہ رہیں کہ خودکار ترجمے میں غلطیاں یا عدم درستیاں ہو سکتی ہیں۔ اصل دستاویز اپنی مادری زبان میں معتبر ماخذ سمجھی جانی چاہیے۔ اہم معلومات کے لیے پیشہ ور انسانی ترجمہ کی سفارش کی جاتی ہے۔ اس ترجمے کے استعمال سے پیدا ہونے والی کسی بھی غلط فہمی یا غلط تعبیر کی ذمہ داری ہم پر عائد نہیں ہوتی۔ \ No newline at end of file diff --git a/translations/ur/SECURITY.md b/translations/ur/SECURITY.md index 01556cac..1b718dd0 100644 --- a/translations/ur/SECURITY.md +++ b/translations/ur/SECURITY.md @@ -1,12 +1,3 @@ - ## سیکیورٹی مائیکروسافٹ اپنی سافٹ ویئر پروڈکٹس اور سروسز کی سیکیورٹی کو سنجیدگی سے لیتا ہے، جس میں وہ تمام سورس کوڈ ریپوزیٹریز شامل ہیں جو ہماری GitHub تنظیموں کے ذریعے منظم کیے جاتے ہیں، جن میں [Microsoft](https://github.com/Microsoft)، [Azure](https://github.com/Azure)، [DotNet](https://github.com/dotnet)، [AspNet](https://github.com/aspnet) اور [Xamarin](https://github.com/xamarin) شامل ہیں۔ diff --git a/translations/ur/SUPPORT.md b/translations/ur/SUPPORT.md index 6edd75b6..547dc1fe 100644 --- a/translations/ur/SUPPORT.md +++ b/translations/ur/SUPPORT.md @@ -1,12 +1,3 @@ - # سپورٹ ## مسائل درج کرنے اور مدد حاصل کرنے کا طریقہ diff --git a/translations/vi/.co-op-translator.json b/translations/vi/.co-op-translator.json new file mode 100644 index 00000000..0877962d --- /dev/null +++ b/translations/vi/.co-op-translator.json @@ -0,0 +1,92 @@ +{ + "01-IntroToGenAI/README.md": { + "original_hash": "75bfb080ca725e8a9aa9c80cae25fba1", + "translation_date": "2025-07-29T09:43:00+00:00", + "source_file": "01-IntroToGenAI/README.md", + "language_code": "vi" + }, + "02-SetupDevEnvironment/README.md": { + "original_hash": "96a30d42b9751a3d4e4b20e28d29d459", + "translation_date": "2026-01-28T05:10:14+00:00", + "source_file": "02-SetupDevEnvironment/README.md", + "language_code": "vi" + }, + "02-SetupDevEnvironment/examples/basic-chat-azure/README.md": { + "original_hash": "efd82efe50711d7e257eb943151d682c", + "translation_date": "2025-07-27T13:44:07+00:00", + "source_file": "02-SetupDevEnvironment/examples/basic-chat-azure/README.md", + "language_code": "vi" + }, + "02-SetupDevEnvironment/getting-started-azure-openai.md": { + "original_hash": "bfdb4b4eadbee3a59ef742439f58326a", + "translation_date": "2025-07-27T13:18:18+00:00", + "source_file": "02-SetupDevEnvironment/getting-started-azure-openai.md", + "language_code": "vi" + }, + "03-CoreGenerativeAITechniques/README.md": { + "original_hash": "685f55cb07de19b52a30ce6e8b6d889e", + "translation_date": "2025-08-28T22:11:05+00:00", + "source_file": "03-CoreGenerativeAITechniques/README.md", + "language_code": "vi" + }, + "04-PracticalSamples/README.md": { + "original_hash": "14c0a61ecc1cd2012a9c129236dfdf71", + "translation_date": "2025-07-29T09:42:39+00:00", + "source_file": "04-PracticalSamples/README.md", + "language_code": "vi" + }, + "04-PracticalSamples/calculator/README.md": { + "original_hash": "b6c16b5514d524e415a94f6097ee7d4c", + "translation_date": "2025-09-18T15:36:26+00:00", + "source_file": "04-PracticalSamples/calculator/README.md", + "language_code": "vi" + }, + "04-PracticalSamples/foundrylocal/README.md": { + "original_hash": "f787307400de59adc25a1404466a35f3", + "translation_date": "2025-11-04T07:29:19+00:00", + "source_file": "04-PracticalSamples/foundrylocal/README.md", + "language_code": "vi" + }, + "04-PracticalSamples/petstory/README.md": { + "original_hash": "0cbf68d605615a1e602c832a24616859", + "translation_date": "2025-07-25T11:41:11+00:00", + "source_file": "04-PracticalSamples/petstory/README.md", + "language_code": "vi" + }, + "05-ResponsibleGenAI/README.md": { + "original_hash": "301c05c2f57e60a6950b8c665b8bdbba", + "translation_date": "2025-07-29T15:55:03+00:00", + "source_file": "05-ResponsibleGenAI/README.md", + "language_code": "vi" + }, + "AGENTS.md": { + "original_hash": "afc90918d008cf77fd1982691f681306", + "translation_date": "2025-10-03T08:39:35+00:00", + "source_file": "AGENTS.md", + "language_code": "vi" + }, + "CODE_OF_CONDUCT.md": { + "original_hash": "442b123d034f92f7c384d2bbd28f99f1", + "translation_date": "2025-07-21T19:08:49+00:00", + "source_file": "CODE_OF_CONDUCT.md", + "language_code": "vi" + }, + "README.md": { + "original_hash": "125a08948d881c95628094f4dd1fbd43", + "translation_date": "2026-01-29T15:58:30+00:00", + "source_file": "README.md", + "language_code": "vi" + }, + "SECURITY.md": { + "original_hash": "57f14126c1c6add76b3aef3844dfe4e3", + "translation_date": "2025-07-21T19:07:12+00:00", + "source_file": "SECURITY.md", + "language_code": "vi" + }, + "SUPPORT.md": { + "original_hash": "b8ef73cc49dec68e2c885ee9df545129", + "translation_date": "2025-07-21T19:10:00+00:00", + "source_file": "SUPPORT.md", + "language_code": "vi" + } +} \ No newline at end of file diff --git a/translations/vi/01-IntroToGenAI/README.md b/translations/vi/01-IntroToGenAI/README.md index b18de2ba..15645a6c 100644 --- a/translations/vi/01-IntroToGenAI/README.md +++ b/translations/vi/01-IntroToGenAI/README.md @@ -1,12 +1,3 @@ - # Giới thiệu về Generative AI - Phiên bản Java ## Những điều bạn sẽ học diff --git a/translations/vi/02-SetupDevEnvironment/README.md b/translations/vi/02-SetupDevEnvironment/README.md index d6bf4626..3e6b58c1 100644 --- a/translations/vi/02-SetupDevEnvironment/README.md +++ b/translations/vi/02-SetupDevEnvironment/README.md @@ -1,13 +1,254 @@ - +# Thiết Lập Môi Trường Phát Triển cho Generative AI bằng Java +> **Bắt Đầu Nhanh**: Lập trình trên đám mây trong 2 phút - Nhảy tới [Thiết Lập GitHub Codespaces](../../../02-SetupDevEnvironment) - không cần cài đặt cục bộ và sử dụng các mô hình github! + +> **Quan tâm đến Azure OpenAI?**, xem [Hướng Dẫn Thiết Lập Azure OpenAI](getting-started-azure-openai.md) với các bước tạo tài nguyên Azure OpenAI mới. + +## Bạn Sẽ Học Gì + +- Thiết lập môi trường phát triển Java cho các ứng dụng AI +- Chọn và cấu hình môi trường phát triển ưa thích của bạn (ưu tiên đám mây với Codespaces, container dev cục bộ, hoặc thiết lập hoàn toàn cục bộ) +- Kiểm tra thiết lập của bạn bằng cách kết nối với GitHub Models + +## Mục Lục + +- [Bạn Sẽ Học Gì](../../../02-SetupDevEnvironment) +- [Giới Thiệu](../../../02-SetupDevEnvironment) +- [Bước 1: Thiết Lập Môi Trường Phát Triển](../../../02-SetupDevEnvironment) + - [Tùy Chọn A: GitHub Codespaces (Khuyến nghị)](../../../02-SetupDevEnvironment) + - [Tùy Chọn B: Local Dev Container](../../../02-SetupDevEnvironment) + - [Tùy Chọn C: Sử Dụng Cài Đặt Cục Bộ Hiện Có](../../../02-SetupDevEnvironment) +- [Bước 2: Tạo GitHub Personal Access Token](../../../02-SetupDevEnvironment) +- [Bước 3: Kiểm Tra Thiết Lập](../../../02-SetupDevEnvironment) +- [Khắc Phục Sự Cố](../../../02-SetupDevEnvironment) +- [Tóm Tắt](../../../02-SetupDevEnvironment) +- [Các Bước Tiếp Theo](../../../02-SetupDevEnvironment) + +## Giới Thiệu + +Chương này sẽ hướng dẫn bạn thiết lập môi trường phát triển. Chúng ta sẽ sử dụng **GitHub Models** làm ví dụ chính vì nó miễn phí, dễ thiết lập chỉ với tài khoản GitHub, không yêu cầu thẻ tín dụng, và cung cấp truy cập tới nhiều mô hình để thử nghiệm. + +**Không cần thiết lập cục bộ!** Bạn có thể bắt đầu lập trình ngay bằng GitHub Codespaces, cung cấp môi trường phát triển đầy đủ trên trình duyệt của bạn. + +Ảnh chụp màn hình: GitHub Models + +Chúng tôi khuyên bạn dùng [**GitHub Models**](https://github.com/marketplace?type=models) cho khóa học này vì nó: +- **Miễn phí** để bắt đầu +- **Dễ dàng** thiết lập chỉ với tài khoản GitHub +- **Không cần thẻ tín dụng** +- **Nhiều mô hình** để thử nghiệm + +> **Lưu ý**: Các GitHub Models sử dụng trong đào tạo này có các giới hạn miễn phí sau: +> - 15 yêu cầu mỗi phút (150 mỗi ngày) +> - ~8,000 từ đầu vào, ~4,000 từ đầu ra mỗi yêu cầu +> - 5 yêu cầu đồng thời +> +> Để sử dụng sản xuất, nâng cấp lên Azure AI Foundry Models với tài khoản Azure của bạn. Mã của bạn không cần phải thay đổi. Xem [tài liệu Azure AI Foundry](https://learn.microsoft.com/azure/ai-foundry/foundry-models/how-to/quickstart-github-models). + + +## Bước 1: Thiết Lập Môi Trường Phát Triển + + + +Chúng tôi đã tạo sẵn một container phát triển được cấu hình để giảm thiểu thời gian thiết lập và đảm bảo bạn có tất cả công cụ cần thiết cho khóa học Generative AI cho Java này. Chọn phương pháp phát triển bạn ưa thích: + +### Các Tùy Chọn Thiết Lập Môi Trường: + +#### Tùy Chọn A: GitHub Codespaces (Khuyến nghị) + +**Bắt đầu lập trình trong 2 phút - không cần cài đặt cục bộ!** + +1. Fork kho lưu trữ này vào tài khoản GitHub của bạn + > **Lưu ý**: Nếu bạn muốn sửa đổi cấu hình cơ bản, vui lòng xem [Cấu hình Dev Container](../../../.devcontainer/devcontainer.json) +2. Nhấn **Code** → tab **Codespaces** → **...** → **New with options...** +3. Sử dụng mặc định – điều này sẽ chọn **Cấu hình Dev container**: **Generative AI Java Development Environment** devcontainer tùy chỉnh cho khóa học này +4. Nhấn **Create codespace** +5. Chờ khoảng ~2 phút để môi trường sẵn sàng +6. Tiếp tục đến [Bước 2: Tạo GitHub Token](../../../02-SetupDevEnvironment) + +Ảnh chụp màn hình: menu phụ Codespaces + +Ảnh chụp màn hình: New with options + +Ảnh chụp màn hình: Tùy chọn tạo codespace + + +> **Lợi Ích của Codespaces**: +> - Không cần cài đặt cục bộ +> - Hoạt động trên mọi thiết bị có trình duyệt +> - Được cấu hình sẵn với tất cả công cụ và phụ thuộc +> - Miễn phí 60 giờ mỗi tháng cho tài khoản cá nhân +> - Môi trường nhất quán cho tất cả học viên + +#### Tùy Chọn B: Local Dev Container + +**Dành cho lập trình viên thích phát triển cục bộ với Docker** + +1. Fork và clone kho lưu trữ này vào máy tính của bạn + > **Lưu ý**: Nếu bạn muốn sửa đổi cấu hình cơ bản, vui lòng xem [Cấu hình Dev Container](../../../.devcontainer/devcontainer.json) +2. Cài đặt [Docker Desktop](https://www.docker.com/products/docker-desktop/) và [VS Code](https://code.visualstudio.com/) +3. Cài đặt [Tiện ích Dev Containers extension](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers) trong VS Code +4. Mở thư mục kho lưu trữ trong VS Code +5. Khi có thông báo, nhấp **Reopen in Container** (hoặc dùng `Ctrl+Shift+P` → "Dev Containers: Reopen in Container") +6. Chờ container được xây dựng và khởi động +7. Tiếp tục đến [Bước 2: Tạo GitHub Token](../../../02-SetupDevEnvironment) + +Ảnh chụp màn hình: Thiết lập dev container + +Ảnh chụp màn hình: Hoàn thành xây dựng dev container + +#### Tùy Chọn C: Sử Dụng Cài Đặt Cục Bộ Hiện Có + +**Dành cho lập trình viên có môi trường Java hiện có** + +Yêu cầu trước: +- [Java 21+](https://www.oracle.com/java/technologies/javase/jdk21-archive-downloads.html) +- [Maven 3.9+](https://maven.apache.org/download.cgi) +- [VS Code](https://code.visualstudio.com) hoặc IDE bạn thích + +Các bước: +1. Clone kho lưu trữ này vào máy của bạn +2. Mở dự án trong IDE của bạn +3. Tiếp tục đến [Bước 2: Tạo GitHub Token](../../../02-SetupDevEnvironment) + +> **Mẹo Chuyên Nghiệp**: Nếu máy bạn cấu hình thấp nhưng muốn sử dụng VS Code cục bộ, hãy sử dụng GitHub Codespaces! Bạn có thể kết nối VS Code cục bộ với Codespace trên đám mây để tận hưởng cả hai thế giới. + +Ảnh chụp màn hình: tạo instance devcontainer cục bộ + + +## Bước 2: Tạo GitHub Personal Access Token + +1. Truy cập [GitHub Settings](https://github.com/settings/profile) và chọn **Settings** trong menu profile. +2. Ở thanh bên trái, nhấn **Developer settings** (thường ở dưới cùng). +3. Dưới **Personal access tokens**, nhấn **Fine-grained tokens** (hoặc theo đường dẫn trực tiếp này [link](https://github.com/settings/personal-access-tokens)). +4. Nhấn **Generate new token**. +5. Ở phần "Token name", nhập tên mô tả (ví dụ, `GenAI-Java-Course-Token`). +6. Đặt ngày hết hạn (khuyến nghị: 7 ngày để đảm bảo bảo mật tốt). +7. Ở phần "Resource owner", chọn tài khoản người dùng của bạn. +8. Ở phần "Repository access", chọn kho lưu trữ bạn muốn dùng với GitHub Models (hoặc "All repositories" nếu cần). +9. Ở phần "Account permissions", tìm **Models** và đặt quyền thành **Read-only**. +10. Nhấn **Generate token**. +11. **Sao chép và lưu token ngay bây giờ** – bạn sẽ không thấy lại nó nữa! + +> **Mẹo bảo mật**: Sử dụng phạm vi quyền tối thiểu cần thiết và thời gian hết hạn ngắn nhất phù hợp cho các token truy cập của bạn. + +## Bước 3: Kiểm Tra Thiết Lập Với Ví Dụ GitHub Models + +Khi môi trường phát triển của bạn đã sẵn sàng, hãy kiểm tra tích hợp GitHub Models với ứng dụng ví dụ của chúng ta trong [`02-SetupDevEnvironment/examples/github-models`](../../../02-SetupDevEnvironment/examples/github-models). + +1. Mở terminal trong môi trường phát triển của bạn. +2. Điều hướng tới ví dụ GitHub Models: + ```bash + cd 02-SetupDevEnvironment/examples/github-models + ``` +3. Thiết lập token GitHub của bạn làm biến môi trường: + ```bash + # macOS/Linux + export GITHUB_TOKEN=your_token_here + + # Windows (Dấu nhắc lệnh) + set GITHUB_TOKEN=your_token_here + + # Windows (PowerShell) + $env:GITHUB_TOKEN="your_token_here" + ``` + +4. Chạy ứng dụng: + ```bash + mvn compile exec:java -Dexec.mainClass="com.example.githubmodels.App" + ``` + +Bạn sẽ thấy kết quả tương tự: +```text +Using model: gpt-4.1-nano +Sending request to GitHub Models... +Response: Hello World! +``` + +### Hiểu Về Mã Ví Dụ + +Trước tiên, hãy hiểu những gì chúng ta vừa chạy. Ví dụ trong `examples/github-models` sử dụng SDK OpenAI Java để kết nối với GitHub Models: + +**Mã này làm gì:** +- **Kết nối** tới GitHub Models sử dụng personal access token của bạn +- **Gửi** thông điệp đơn giản "Say Hello World!" tới mô hình AI +- **Nhận** và hiển thị phản hồi của AI +- **Xác nhận** thiết lập của bạn hoạt động đúng + +**Phụ thuộc chính** (trong `pom.xml`): +```xml + + com.openai + openai-java + 2.12.0 + +``` + +**Mã chính** (`App.java`): +```java +// Kết nối với GitHub Models sử dụng OpenAI Java SDK +OpenAIClient client = OpenAIOkHttpClient.builder() + .apiKey(pat) + .baseUrl("https://models.inference.ai.azure.com") + .build(); + +// Tạo yêu cầu hoàn thành trò chuyện +ChatCompletionCreateParams params = ChatCompletionCreateParams.builder() + .model(modelId) + .addSystemMessage("You are a concise assistant.") + .addUserMessage("Say Hello World!") + .build(); + +// Nhận phản hồi AI +ChatCompletion response = client.chat().completions().create(params); +System.out.println("Response: " + response.choices().get(0).message().content().orElse("No response content")); +``` + +## Tóm Tắt + +Tuyệt vời! Bạn đã có mọi thứ được thiết lập: + +- Đã tạo GitHub Personal Access Token với quyền phù hợp truy cập mô hình AI +- Môi trường phát triển Java của bạn đang chạy (dù là Codespaces, dev container, hay cục bộ) +- Kết nối thành công với GitHub Models dùng OpenAI Java SDK để phát triển AI miễn phí +- Kiểm tra mọi thứ hoạt động với ví dụ đơn giản trao đổi với mô hình AI + +## Các Bước Tiếp Theo + +[Chương 3: Các Kỹ Thuật Generative AI Cốt Lõi](../03-CoreGenerativeAITechniques/README.md) + +## Khắc Phục Sự Cố + +Gặp sự cố? Dưới đây là các vấn đề phổ biến và cách giải quyết: + +- **Token không hoạt động?** + - Đảm bảo bạn đã sao chép toàn bộ token không có khoảng trắng thừa + - Kiểm tra token đã được thiết lập đúng làm biến môi trường + - Xác nhận token có quyền đúng (Models: Read-only) + +- **Không tìm thấy Maven?** + - Nếu dùng dev container/Codespaces, Maven đã được cài sẵn + - Với thiết lập cục bộ, đảm bảo đã cài Java 21+ và Maven 3.9+ + - Thử chạy `mvn --version` để kiểm tra cài đặt + +- **Lỗi kết nối?** + - Kiểm tra kết nối internet của bạn + - Xác nhận GitHub có thể truy cập được từ mạng của bạn + - Đảm bảo không có firewall chặn endpoint GitHub Models + +- **Dev container không khởi động?** + - Đảm bảo Docker Desktop đang chạy (với phát triển cục bộ) + - Thử xây lại container: `Ctrl+Shift+P` → "Dev Containers: Rebuild Container" + +- **Lỗi biên dịch ứng dụng?** + - Đảm bảo bạn ở đúng thư mục: `02-SetupDevEnvironment/examples/github-models` + - Thử dọn dẹp và build lại: `mvn clean compile` + +> **Cần giúp đỡ?**: Vẫn gặp sự cố? Hãy mở một issue trong kho lưu trữ và chúng tôi sẽ giúp bạn. --- + +**Tuyên bố miễn trách nhiệm**: +Tài liệu này đã được dịch bằng dịch vụ dịch thuật AI [Co-op Translator](https://github.com/Azure/co-op-translator). Mặc dù chúng tôi cố gắng đảm bảo độ chính xác, xin lưu ý rằng các bản dịch tự động có thể chứa lỗi hoặc không chính xác. Văn bản gốc bằng ngôn ngữ gốc của tài liệu mới là nguồn tham khảo chính xác nhất. Đối với thông tin quan trọng, nên sử dụng dịch vụ dịch thuật chuyên nghiệp do con người thực hiện. Chúng tôi không chịu trách nhiệm về bất kỳ sự hiểu lầm hoặc diễn giải sai nào phát sinh từ việc sử dụng bản dịch này. + \ No newline at end of file diff --git a/translations/vi/02-SetupDevEnvironment/examples/basic-chat-azure/README.md b/translations/vi/02-SetupDevEnvironment/examples/basic-chat-azure/README.md index 660c667c..a1f43ece 100644 --- a/translations/vi/02-SetupDevEnvironment/examples/basic-chat-azure/README.md +++ b/translations/vi/02-SetupDevEnvironment/examples/basic-chat-azure/README.md @@ -1,12 +1,3 @@ - # Chat cơ bản với Azure OpenAI - Ví dụ từ đầu đến cuối Ví dụ này minh họa cách tạo một ứng dụng Spring Boot đơn giản kết nối với Azure OpenAI và kiểm tra thiết lập của bạn. diff --git a/translations/vi/02-SetupDevEnvironment/getting-started-azure-openai.md b/translations/vi/02-SetupDevEnvironment/getting-started-azure-openai.md index 8c070639..a5017750 100644 --- a/translations/vi/02-SetupDevEnvironment/getting-started-azure-openai.md +++ b/translations/vi/02-SetupDevEnvironment/getting-started-azure-openai.md @@ -1,12 +1,3 @@ - # Thiết Lập Môi Trường Phát Triển cho Azure OpenAI > **Bắt Đầu Nhanh**: Hướng dẫn này dành cho thiết lập Azure OpenAI. Để bắt đầu ngay với các mô hình miễn phí, hãy sử dụng [GitHub Models với Codespaces](./README.md#quick-start-cloud). diff --git a/translations/vi/03-CoreGenerativeAITechniques/README.md b/translations/vi/03-CoreGenerativeAITechniques/README.md index fe644770..dedae627 100644 --- a/translations/vi/03-CoreGenerativeAITechniques/README.md +++ b/translations/vi/03-CoreGenerativeAITechniques/README.md @@ -1,12 +1,3 @@ - # Hướng Dẫn Kỹ Thuật AI Tạo Sinh Cốt Lõi ## Mục Lục diff --git a/translations/vi/04-PracticalSamples/README.md b/translations/vi/04-PracticalSamples/README.md index 3d6b24e6..9d5e2329 100644 --- a/translations/vi/04-PracticalSamples/README.md +++ b/translations/vi/04-PracticalSamples/README.md @@ -1,12 +1,3 @@ - # Ứng Dụng Thực Tiễn & Dự Án ## Bạn Sẽ Học Được Gì diff --git a/translations/vi/04-PracticalSamples/calculator/README.md b/translations/vi/04-PracticalSamples/calculator/README.md index 4404773f..0492bee8 100644 --- a/translations/vi/04-PracticalSamples/calculator/README.md +++ b/translations/vi/04-PracticalSamples/calculator/README.md @@ -1,12 +1,3 @@ - # Hướng dẫn sử dụng MCP Calculator dành cho người mới bắt đầu ## Mục lục diff --git a/translations/vi/04-PracticalSamples/foundrylocal/README.md b/translations/vi/04-PracticalSamples/foundrylocal/README.md index a71393ad..a1ddb065 100644 --- a/translations/vi/04-PracticalSamples/foundrylocal/README.md +++ b/translations/vi/04-PracticalSamples/foundrylocal/README.md @@ -1,12 +1,3 @@ - # Hướng dẫn Spring Boot Foundry Local ## Mục lục diff --git a/translations/vi/04-PracticalSamples/petstory/README.md b/translations/vi/04-PracticalSamples/petstory/README.md index bca12f0d..a38e73c2 100644 --- a/translations/vi/04-PracticalSamples/petstory/README.md +++ b/translations/vi/04-PracticalSamples/petstory/README.md @@ -1,12 +1,3 @@ - # Hướng Dẫn Sử Dụng Pet Story Generator Dành Cho Người Mới Bắt Đầu ## Mục Lục diff --git a/translations/vi/05-ResponsibleGenAI/README.md b/translations/vi/05-ResponsibleGenAI/README.md index 09777527..61335f86 100644 --- a/translations/vi/05-ResponsibleGenAI/README.md +++ b/translations/vi/05-ResponsibleGenAI/README.md @@ -1,12 +1,3 @@ - # AI Tạo Sinh Có Trách Nhiệm ## Những Gì Bạn Sẽ Học diff --git a/translations/vi/AGENTS.md b/translations/vi/AGENTS.md index 9a06ae52..9a85ef60 100644 --- a/translations/vi/AGENTS.md +++ b/translations/vi/AGENTS.md @@ -1,12 +1,3 @@ - # AGENTS.md ## Tổng quan dự án diff --git a/translations/vi/CODE_OF_CONDUCT.md b/translations/vi/CODE_OF_CONDUCT.md index de25c30a..c7295f61 100644 --- a/translations/vi/CODE_OF_CONDUCT.md +++ b/translations/vi/CODE_OF_CONDUCT.md @@ -1,12 +1,3 @@ - # Quy tắc ứng xử mã nguồn mở của Microsoft Dự án này đã áp dụng [Quy tắc ứng xử mã nguồn mở của Microsoft](https://opensource.microsoft.com/codeofconduct/). diff --git a/translations/vi/README.md b/translations/vi/README.md index 0f217126..f9fe36ac 100644 --- a/translations/vi/README.md +++ b/translations/vi/README.md @@ -1,129 +1,120 @@ - -# Generative AI cho Người mới bắt đầu - Phiên bản Java +# Trí Tuệ Nhân Tạo Tạo Sinh cho Người Mới Bắt Đầu - Phiên Bản Java [![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) -![Generative AI cho Người mới bắt đầu - Phiên bản Java](../../translated_images/vi/beg-genai-series.8b48be9951cc574c.webp) +![Trí Tuệ Nhân Tạo Tạo Sinh cho Người Mới Bắt Đầu - Phiên Bản Java](../../translated_images/vi/beg-genai-series.8b48be9951cc574c.webp) -**Thời gian cam kết**: Toàn bộ hội thảo có thể hoàn thành trực tuyến mà không cần cài đặt cục bộ. Việc thiết lập môi trường mất 2 phút, khám phá các ví dụ mẫu cần từ 1-3 giờ tùy thuộc vào độ sâu khám phá. +**Thời gian cam kết**: Toàn bộ hội thảo có thể hoàn thành trực tuyến mà không cần thiết lập cục bộ. Việc thiết lập môi trường mất 2 phút, khám phá các mẫu mất từ 1-3 giờ tùy theo độ sâu khám phá. -> **Bắt đầu nhanh** +> **Bắt đầu nhanh** -1. Fork kho lưu trữ này vào tài khoản GitHub của bạn -2. Nhấp **Code** → tab **Codespaces** → **...** → **New with options...** -3. Sử dụng mặc định – việc này sẽ chọn container Phát triển được tạo cho khoá học này -4. Nhấp **Create codespace** -5. Chờ khoảng 2 phút để môi trường sẵn sàng -6. Tiếp tục ngay đến [Ví dụ đầu tiên](./02-SetupDevEnvironment/README.md#step-2-create-a-github-personal-access-token) +1. Fork kho lưu trữ này vào tài khoản GitHub của bạn +2. Nhấn **Code** → tab **Codespaces** → **...** → **Mới với tùy chọn...** +3. Sử dụng các thiết lập mặc định – điều này sẽ chọn container Phát Triển được tạo cho khóa học này +4. Nhấn **Tạo codespace** +5. Chờ khoảng ~2 phút để môi trường sẵn sàng +6. Bắt đầu ngay tại [Ví dụ đầu tiên](./02-SetupDevEnvironment/README.md#step-2-create-a-github-personal-access-token) -> **Ưu tiên Clone Cục bộ?** -> -> Kho lưu trữ này bao gồm hơn 50 bản dịch ngôn ngữ, điều này làm tăng kích thước tải xuống đáng kể. Để clone mà không có bản dịch, sử dụng sparse checkout: +> **Thích Clone Cục Bộ hơn?** +> +> Kho lưu trữ này bao gồm hơn 50 bản dịch ngôn ngữ làm tăng đáng kể kích thước tải xuống. Để clone mà không cần bản dịch, sử dụng sparse checkout: > ```bash > git clone --filter=blob:none --sparse https://github.com/microsoft/Generative-AI-for-beginners-java.git > cd Generative-AI-for-beginners-java > git sparse-checkout set --no-cone '/*' '!translations' '!translated_images' > ``` -> Điều này cung cấp cho bạn mọi thứ cần thiết để hoàn thành khoá học với tốc độ tải xuống nhanh hơn nhiều. +> Điều này cung cấp cho bạn mọi thứ cần thiết để hoàn thành khóa học với tốc độ tải xuống nhanh hơn nhiều. -## Hỗ trợ Đa Ngôn ngữ +## Hỗ Trợ Đa Ngôn Ngữ ### Hỗ trợ qua GitHub Action (Tự động & Luôn cập nhật) -[Tiếng Ả Rập](../ar/README.md) | [Tiếng Bengal](../bn/README.md) | [Tiếng Bungari](../bg/README.md) | [Tiếng Miến Điện (Myanmar)](../my/README.md) | [Tiếng Trung (Giản thể)](../zh/README.md) | [Tiếng Trung (Phồn thể, Hồng Kông)](../hk/README.md) | [Tiếng Trung (Phồn thể, Macao)](../mo/README.md) | [Tiếng Trung (Phồn thể, Đài Loan)](../tw/README.md) | [Tiếng Croatia](../hr/README.md) | [Tiếng Séc](../cs/README.md) | [Tiếng Đan Mạch](../da/README.md) | [Tiếng Hà Lan](../nl/README.md) | [Tiếng Estonia](../et/README.md) | [Tiếng Phần Lan](../fi/README.md) | [Tiếng Pháp](../fr/README.md) | [Tiếng Đức](../de/README.md) | [Tiếng Hy Lạp](../el/README.md) | [Tiếng Hebrew](../he/README.md) | [Tiếng Hindi](../hi/README.md) | [Tiếng Hungary](../hu/README.md) | [Tiếng Indonesia](../id/README.md) | [Tiếng Ý](../it/README.md) | [Tiếng Nhật](../ja/README.md) | [Tiếng Kannada](../kn/README.md) | [Tiếng Hàn](../ko/README.md) | [Tiếng Litva](../lt/README.md) | [Tiếng Mã Lai](../ms/README.md) | [Tiếng Malayalam](../ml/README.md) | [Tiếng Marathi](../mr/README.md) | [Tiếng Nepal](../ne/README.md) | [Tiếng Pidgin Nigeria](../pcm/README.md) | [Tiếng Na Uy](../no/README.md) | [Tiếng Ba Tư (Farsi)](../fa/README.md) | [Tiếng Ba Lan](../pl/README.md) | [Tiếng Bồ Đào Nha (Brazil)](../br/README.md) | [Tiếng Bồ Đào Nha (Bồ Đào Nha)](../pt/README.md) | [Tiếng Punjabi (Gurmukhi)](../pa/README.md) | [Tiếng Romania](../ro/README.md) | [Tiếng Nga](../ru/README.md) | [Tiếng Serbia (Chữ Kirin)](../sr/README.md) | [Tiếng Slovakia](../sk/README.md) | [Tiếng Slovenia](../sl/README.md) | [Tiếng Tây Ban Nha](../es/README.md) | [Tiếng Swahili](../sw/README.md) | [Tiếng Thụy Điển](../sv/README.md) | [Tiếng Tagalog (Philippines)](../tl/README.md) | [Tiếng Tamil](../ta/README.md) | [Tiếng Telugu](../te/README.md) | [Tiếng Thái](../th/README.md) | [Tiếng Thổ Nhĩ Kỳ](../tr/README.md) | [Tiếng Ukraina](../uk/README.md) | [Tiếng Urdu](../ur/README.md) | [Tiếng Việt](./README.md) +[Tiếng Ả Rập](../ar/README.md) | [Tiếng Bengal](../bn/README.md) | [Tiếng Bulgari](../bg/README.md) | [Tiếng Miến Điện (Myanmar)](../my/README.md) | [Tiếng Trung (Giản Thể)](../zh-CN/README.md) | [Tiếng Trung (Phồn Thể, Hồng Kông)](../zh-HK/README.md) | [Tiếng Trung (Phồn Thể, Macau)](../zh-MO/README.md) | [Tiếng Trung (Phồn Thể, Đài Loan)](../zh-TW/README.md) | [Tiếng Croatia](../hr/README.md) | [Tiếng Séc](../cs/README.md) | [Tiếng Đan Mạch](../da/README.md) | [Tiếng Hà Lan](../nl/README.md) | [Tiếng Estonia](../et/README.md) | [Tiếng Phần Lan](../fi/README.md) | [Tiếng Pháp](../fr/README.md) | [Tiếng Đức](../de/README.md) | [Tiếng Hy Lạp](../el/README.md) | [Tiếng Do Thái](../he/README.md) | [Tiếng Hindi](../hi/README.md) | [Tiếng Hungary](../hu/README.md) | [Tiếng Indonesia](../id/README.md) | [Tiếng Ý](../it/README.md) | [Tiếng Nhật](../ja/README.md) | [Tiếng Kannada](../kn/README.md) | [Tiếng Hàn](../ko/README.md) | [Tiếng Litva](../lt/README.md) | [Tiếng Mã Lai](../ms/README.md) | [Tiếng Malayalam](../ml/README.md) | [Tiếng Marathi](../mr/README.md) | [Tiếng Nepal](../ne/README.md) | [Tiếng Pidgin Nigeria](../pcm/README.md) | [Tiếng Na Uy](../no/README.md) | [Tiếng Ba Tư (Farsi)](../fa/README.md) | [Tiếng Ba Lan](../pl/README.md) | [Tiếng Bồ Đào Nha (Brazil)](../pt-BR/README.md) | [Tiếng Bồ Đào Nha (Bồ Đào Nha)](../pt-PT/README.md) | [Tiếng Punjabi (Gurmukhi)](../pa/README.md) | [Tiếng Rumani](../ro/README.md) | [Tiếng Nga](../ru/README.md) | [Tiếng Serbia (Chữ Cyrillic)](../sr/README.md) | [Tiếng Slovak](../sk/README.md) | [Tiếng Slovenia](../sl/README.md) | [Tiếng Tây Ban Nha](../es/README.md) | [Tiếng Swahili](../sw/README.md) | [Tiếng Thụy Điển](../sv/README.md) | [Tiếng Tagalog (Filipino)](../tl/README.md) | [Tiếng Tamil](../ta/README.md) | [Tiếng Telugu](../te/README.md) | [Tiếng Thái](../th/README.md) | [Tiếng Thổ Nhĩ Kỳ](../tr/README.md) | [Tiếng Ukraina](../uk/README.md) | [Tiếng Urdu](../ur/README.md) | [Tiếng Việt](./README.md) -> **Ưu tiên Clone Cục bộ?** +> **Thích Clone Cục Bộ hơn?** -> Kho lưu trữ này bao gồm hơn 50 bản dịch ngôn ngữ, điều này làm tăng kích thước tải xuống đáng kể. Để clone mà không có bản dịch, sử dụng sparse checkout: +> Kho lưu trữ này bao gồm hơn 50 bản dịch ngôn ngữ làm tăng đáng kể kích thước tải xuống. Để clone mà không cần bản dịch, sử dụng sparse checkout: > ```bash > git clone --filter=blob:none --sparse https://github.com/microsoft/Generative-AI-for-beginners-java.git > cd Generative-AI-for-beginners-java > git sparse-checkout set --no-cone '/*' '!translations' '!translated_images' > ``` -> Điều này cung cấp cho bạn mọi thứ cần thiết để hoàn thành khoá học với tốc độ tải xuống nhanh hơn nhiều. +> Điều này cung cấp cho bạn mọi thứ cần thiết để hoàn thành khóa học với tốc độ tải xuống nhanh hơn nhiều. -## Cấu trúc khoá học & Lộ trình học +## Cấu Trúc Khóa Học & Lộ Trình Học -### **Chương 1: Giới thiệu về Generative AI** -- **Khái niệm cốt lõi**: Hiểu về Mô hình Ngôn ngữ lớn, token, embeddings và khả năng AI -- **Hệ sinh thái AI Java**: Tổng quan về Spring AI và OpenAI SDKs -- **Giao thức Ngữ cảnh Mô hình**: Giới thiệu MCP và vai trò của nó trong giao tiếp tác nhân AI -- **Ứng dụng thực tế**: Các kịch bản thực tế bao gồm chatbot và tạo nội dung +### **Chương 1: Giới thiệu về Trí Tuệ Nhân Tạo Tạo Sinh** +- **Khái Niệm Cốt Lõi**: Hiểu về Mô hình Ngôn ngữ Lớn, token, embeddings, và khả năng AI +- **Hệ Sinh Thái AI Java**: Tổng quan về Spring AI và các SDK OpenAI +- **Giao Thức Ngữ Cảnh Mô Hình**: Giới thiệu MCP và vai trò trong giao tiếp đại lý AI +- **Ứng Dụng Thực Tiễn**: Các kịch bản thực tiễn bao gồm chatbot và tạo nội dung - **[→ Bắt đầu Chương 1](./01-IntroToGenAI/README.md)** -### **Chương 2: Thiết lập Môi trường Phát triển** -- **Cấu hình đa nhà cung cấp**: Thiết lập GitHub Models, Azure OpenAI, và tích hợp OpenAI Java SDK -- **Spring Boot + Spring AI**: Thực hành tốt nhất để phát triển ứng dụng AI doanh nghiệp -- **GitHub Models**: Truy cập mô hình AI miễn phí để tạo mẫu và học tập (không cần thẻ tín dụng) -- **Công cụ phát triển**: Cấu hình docker container, VS Code, và GitHub Codespaces +### **Chương 2: Thiết Lập Môi Trường Phát Triển** +- **Cấu Hình Đa Nhà Cung Cấp**: Thiết lập GitHub Models, Azure OpenAI, và tích hợp OpenAI Java SDK +- **Spring Boot + Spring AI**: Thực hành tốt nhất để phát triển ứng dụng AI doanh nghiệp +- **GitHub Models**: Truy cập mô hình AI miễn phí để tạo mẫu và học tập (không cần thẻ tín dụng) +- **Công Cụ Phát Triển**: Docker container, VS Code, và thiết lập GitHub Codespaces - **[→ Bắt đầu Chương 2](./02-SetupDevEnvironment/README.md)** -### **Chương 3: Kỹ thuật Generative AI cốt lõi** -- **Kỹ thuật Prompt Engineering**: Kỹ thuật để có câu trả lời tối ưu từ mô hình AI -- **Embeddings & các phép toán Vector**: Thực hiện tìm kiếm ngữ nghĩa và đối chiếu tương đồng -- **Tạo sinh bằng truy xuất tăng cường (RAG)**: Kết hợp AI với nguồn dữ liệu riêng của bạn -- **Gọi hàm (Function Calling)**: Mở rộng khả năng AI với công cụ và plugin tùy chỉnh +### **Chương 3: Kỹ Thuật Cốt Lõi của Trí Tuệ Nhân Tạo Tạo Sinh** +- **Kỹ thuật Prompt Engineering**: Kỹ thuật để có phản hồi tối ưu từ mô hình AI +- **Embeddings & Các phép toán Vector**: Triển khai tìm kiếm ngữ nghĩa và so khớp tương tự +- **Retrieval-Augmented Generation (RAG)**: Kết hợp AI với nguồn dữ liệu của riêng bạn +- **Function Calling**: Mở rộng khả năng AI với công cụ và plugin tùy chỉnh - **[→ Bắt đầu Chương 3](./03-CoreGenerativeAITechniques/README.md)** -### **Chương 4: Ứng dụng Thực tế & Dự án** -- **Pet Story Generator** (`petstory/`): Tạo nội dung sáng tạo với GitHub Models -- **Foundry Local Demo** (`foundrylocal/`): Tích hợp mô hình AI cục bộ với OpenAI Java SDK -- **MCP Calculator Service** (`calculator/`): Triển khai đơn giản Giao thức Ngữ cảnh Mô hình với Spring AI +### **Chương 4: Ứng Dụng Thực Tiễn & Dự Án** +- **Trình tạo câu chuyện thú cưng** (`petstory/`): Tạo nội dung sáng tạo với GitHub Models +- **Demo Foundry Local** (`foundrylocal/`): Tích hợp mô hình AI cục bộ với OpenAI Java SDK +- **Dịch vụ Máy tính MCP** (`calculator/`): Triển khai cơ bản Giao thức Ngữ Cảnh Mô Hình với Spring AI - **[→ Bắt đầu Chương 4](./04-PracticalSamples/README.md)** -### **Chương 5: Phát triển AI có trách nhiệm** -- **An toàn GitHub Models**: Thử nghiệm lọc nội dung và các cơ chế an toàn tích hợp sẵn (chặn cứng và từ chối mềm) -- **Demo AI có trách nhiệm**: Ví dụ thực hành cho thấy cách các hệ thống an toàn AI hiện đại hoạt động thực tế -- **Thực hành tốt nhất**: Các hướng dẫn thiết yếu cho phát triển và triển khai AI đạo đức +### **Chương 5: Phát Triển AI Có Trách Nhiệm** +- **An toàn GitHub Models**: Thử nghiệm lọc nội dung tích hợp và cơ chế an toàn (chặn cứng và từ chối nhẹ) +- **Demo AI Có Trách Nhiệm**: Ví dụ thực hành cho thấy cách các hệ thống an toàn AI hiện đại hoạt động +- **Thực hành tốt nhất**: Các hướng dẫn thiết yếu cho phát triển và triển khai AI có đạo đức - **[→ Bắt đầu Chương 5](./05-ResponsibleGenAI/README.md)** -## Tài nguyên Bổ sung +## Tài Nguyên Bổ Sung -### LangChain -[![LangChain4j cho Người mới bắt đầu](https://img.shields.io/badge/LangChain4j%20for%20Beginners-22C55E?style=for-the-badge&&labelColor=E5E7EB&color=0553D6)](https://aka.ms/langchain4j-for-beginners) -[![LangChain.js cho Người mới bắt đầu](https://img.shields.io/badge/LangChain.js%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=0553D6)](https://aka.ms/langchainjs-for-beginners?WT.mc_id=m365-94501-dwahlin) +### LangChain +[![LangChain4j cho Người Mới Bắt Đầu](https://img.shields.io/badge/LangChain4j%20for%20Beginners-22C55E?style=for-the-badge&&labelColor=E5E7EB&color=0553D6)](https://aka.ms/langchain4j-for-beginners) +[![LangChain.js cho Người Mới Bắt Đầu](https://img.shields.io/badge/LangChain.js%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=0553D6)](https://aka.ms/langchainjs-for-beginners?WT.mc_id=m365-94501-dwahlin) --- -### Azure / Edge / MCP / Agents -[![AZD cho Người mới bắt đầu](https://img.shields.io/badge/AZD%20for%20Beginners-0078D4?style=for-the-badge&labelColor=E5E7EB&color=0078D4)](https://github.com/microsoft/AZD-for-beginners?WT.mc_id=academic-105485-koreyst) -[![Edge AI cho Người mới bắt đầu](https://img.shields.io/badge/Edge%20AI%20for%20Beginners-00B8E4?style=for-the-badge&labelColor=E5E7EB&color=00B8E4)](https://github.com/microsoft/edgeai-for-beginners?WT.mc_id=academic-105485-koreyst) -[![MCP cho Người mới bắt đầu](https://img.shields.io/badge/MCP%20for%20Beginners-009688?style=for-the-badge&labelColor=E5E7EB&color=009688)](https://github.com/microsoft/mcp-for-beginners?WT.mc_id=academic-105485-koreyst) -[![Công cụ AI Agents cho Người mới bắt đầu](https://img.shields.io/badge/AI%20Agents%20for%20Beginners-00C49A?style=for-the-badge&labelColor=E5E7EB&color=00C49A)](https://github.com/microsoft/ai-agents-for-beginners?WT.mc_id=academic-105485-koreyst) +### Azure / Edge / MCP / Đại lý +[![AZD cho Người Mới Bắt Đầu](https://img.shields.io/badge/AZD%20for%20Beginners-0078D4?style=for-the-badge&labelColor=E5E7EB&color=0078D4)](https://github.com/microsoft/AZD-for-beginners?WT.mc_id=academic-105485-koreyst) +[![Edge AI cho Người Mới Bắt Đầu](https://img.shields.io/badge/Edge%20AI%20for%20Beginners-00B8E4?style=for-the-badge&labelColor=E5E7EB&color=00B8E4)](https://github.com/microsoft/edgeai-for-beginners?WT.mc_id=academic-105485-koreyst) +[![MCP cho Người Mới Bắt Đầu](https://img.shields.io/badge/MCP%20for%20Beginners-009688?style=for-the-badge&labelColor=E5E7EB&color=009688)](https://github.com/microsoft/mcp-for-beginners?WT.mc_id=academic-105485-koreyst) +[![Đại lý AI cho Người Mới Bắt Đầu](https://img.shields.io/badge/AI%20Agents%20for%20Beginners-00C49A?style=for-the-badge&labelColor=E5E7EB&color=00C49A)](https://github.com/microsoft/ai-agents-for-beginners?WT.mc_id=academic-105485-koreyst) --- -### Series Generative AI -[![Generative AI cho Người mới bắt đầu](https://img.shields.io/badge/Generative%20AI%20for%20Beginners-8B5CF6?style=for-the-badge&labelColor=E5E7EB&color=8B5CF6)](https://github.com/microsoft/generative-ai-for-beginners?WT.mc_id=academic-105485-koreyst) -[![Generative AI (.NET)](https://img.shields.io/badge/Generative%20AI%20(.NET)-9333EA?style=for-the-badge&labelColor=E5E7EB&color=9333EA)](https://github.com/microsoft/Generative-AI-for-beginners-dotnet?WT.mc_id=academic-105485-koreyst) -[![Generative AI (Java)](https://img.shields.io/badge/Generative%20AI%20(Java)-C084FC?style=for-the-badge&labelColor=E5E7EB&color=C084FC)](https://github.com/microsoft/generative-ai-for-beginners-java?WT.mc_id=academic-105485-koreyst) -[![Generative AI (JavaScript)](https://img.shields.io/badge/Generative%20AI%20(JavaScript)-E879F9?style=for-the-badge&labelColor=E5E7EB&color=E879F9)](https://github.com/microsoft/generative-ai-with-javascript?WT.mc_id=academic-105485-koreyst) +### Chuỗi Trí Tuệ Nhân Tạo Tạo Sinh +[![Trí Tuệ Nhân Tạo Tạo Sinh cho Người Mới Bắt Đầu](https://img.shields.io/badge/Generative%20AI%20for%20Beginners-8B5CF6?style=for-the-badge&labelColor=E5E7EB&color=8B5CF6)](https://github.com/microsoft/generative-ai-for-beginners?WT.mc_id=academic-105485-koreyst) +[![Trí Tuệ Nhân Tạo Tạo Sinh (.NET)](https://img.shields.io/badge/Generative%20AI%20(.NET)-9333EA?style=for-the-badge&labelColor=E5E7EB&color=9333EA)](https://github.com/microsoft/Generative-AI-for-beginners-dotnet?WT.mc_id=academic-105485-koreyst) +[![Trí Tuệ Nhân Tạo Tạo Sinh (Java)](https://img.shields.io/badge/Generative%20AI%20(Java)-C084FC?style=for-the-badge&labelColor=E5E7EB&color=C084FC)](https://github.com/microsoft/generative-ai-for-beginners-java?WT.mc_id=academic-105485-koreyst) +[![Trí Tuệ Nhân Tạo Tạo Sinh (JavaScript)](https://img.shields.io/badge/Generative%20AI%20(JavaScript)-E879F9?style=for-the-badge&labelColor=E5E7EB&color=E879F9)](https://github.com/microsoft/generative-ai-with-javascript?WT.mc_id=academic-105485-koreyst) --- -### Học tập Cốt lõi -[![ML cho Người mới bắt đầu](https://img.shields.io/badge/ML%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=22C55E)](https://aka.ms/ml-beginners?WT.mc_id=academic-105485-koreyst) -[![Khoa học Dữ liệu cho Người mới bắt đầu](https://img.shields.io/badge/Data%20Science%20for%20Beginners-84CC16?style=for-the-badge&labelColor=E5E7EB&color=84CC16)](https://aka.ms/datascience-beginners?WT.mc_id=academic-105485-koreyst) -[![AI cho Người mới bắt đầu](https://img.shields.io/badge/AI%20for%20Beginners-A3E635?style=for-the-badge&labelColor=E5E7EB&color=A3E635)](https://aka.ms/ai-beginners?WT.mc_id=academic-105485-koreyst) -[![An ninh mạng cho Người mới bắt đầu](https://img.shields.io/badge/Cybersecurity%20for%20Beginners-F97316?style=for-the-badge&labelColor=E5E7EB&color=F97316)](https://github.com/microsoft/Security-101?WT.mc_id=academic-96948-sayoung) -[![Phát triển Web cho Người mới bắt đầu](https://img.shields.io/badge/Web%20Dev%20for%20Beginners-EC4899?style=for-the-badge&labelColor=E5E7EB&color=EC4899)](https://aka.ms/webdev-beginners?WT.mc_id=academic-105485-koreyst) +### Học Tập Cơ Bản +[![Máy Học cho Người Mới Bắt Đầu](https://img.shields.io/badge/ML%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=22C55E)](https://aka.ms/ml-beginners?WT.mc_id=academic-105485-koreyst) +[![Khoa Học Dữ Liệu cho Người Mới Bắt Đầu](https://img.shields.io/badge/Data%20Science%20for%20Beginners-84CC16?style=for-the-badge&labelColor=E5E7EB&color=84CC16)](https://aka.ms/datascience-beginners?WT.mc_id=academic-105485-koreyst) +[![AI cho Người Mới Bắt Đầu](https://img.shields.io/badge/AI%20for%20Beginners-A3E635?style=for-the-badge&labelColor=E5E7EB&color=A3E635)](https://aka.ms/ai-beginners?WT.mc_id=academic-105485-koreyst) +[![An Ninh Mạng cho Người Mới Bắt Đầu](https://img.shields.io/badge/Cybersecurity%20for%20Beginners-F97316?style=for-the-badge&labelColor=E5E7EB&color=F97316)](https://github.com/microsoft/Security-101?WT.mc_id=academic-96948-sayoung) +[![Web Dev for Beginners](https://img.shields.io/badge/Web%20Dev%20for%20Beginners-EC4899?style=for-the-badge&labelColor=E5E7EB&color=EC4899)](https://aka.ms/webdev-beginners?WT.mc_id=academic-105485-koreyst) [![IoT for Beginners](https://img.shields.io/badge/IoT%20for%20Beginners-14B8A6?style=for-the-badge&labelColor=E5E7EB&color=14B8A6)](https://aka.ms/iot-beginners?WT.mc_id=academic-105485-koreyst) [![XR Development for Beginners](https://img.shields.io/badge/XR%20Development%20for%20Beginners-38BDF8?style=for-the-badge&labelColor=E5E7EB&color=38BDF8)](https://github.com/microsoft/xr-development-for-beginners?WT.mc_id=academic-105485-koreyst) --- -### Chuỗi Copilot +### Dòng Copilot [![Copilot for AI Paired Programming](https://img.shields.io/badge/Copilot%20for%20AI%20Paired%20Programming-FACC15?style=for-the-badge&labelColor=E5E7EB&color=FACC15)](https://aka.ms/GitHubCopilotAI?WT.mc_id=academic-105485-koreyst) [![Copilot for C#/.NET](https://img.shields.io/badge/Copilot%20for%20C%23/.NET-FBBF24?style=for-the-badge&labelColor=E5E7EB&color=FBBF24)](https://github.com/microsoft/mastering-github-copilot-for-dotnet-csharp-developers?WT.mc_id=academic-105485-koreyst) [![Copilot Adventure](https://img.shields.io/badge/Copilot%20Adventure-FDE68A?style=for-the-badge&labelColor=E5E7EB&color=FDE68A)](https://github.com/microsoft/CopilotAdventures?WT.mc_id=academic-105485-koreyst) @@ -131,11 +122,11 @@ CO_OP_TRANSLATOR_METADATA: ## Nhận Trợ Giúp -Nếu bạn bị kẹt hoặc có bất kỳ câu hỏi nào về việc xây dựng ứng dụng AI. Hãy tham gia cùng các học viên và nhà phát triển có kinh nghiệm trong các cuộc thảo luận về MCP. Đây là một cộng đồng hỗ trợ, nơi các câu hỏi được chào đón và kiến thức được chia sẻ tự do. +Nếu bạn gặp khó khăn hoặc có bất kỳ câu hỏi nào về việc xây dựng ứng dụng AI, hãy tham gia cùng những người học khác và các nhà phát triển có kinh nghiệm trong các cuộc thảo luận về MCP. Đây là một cộng đồng hỗ trợ, nơi các câu hỏi được chào đón và kiến thức được chia sẻ một cách tự do. [![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) -Nếu bạn có phản hồi về sản phẩm hoặc lỗi trong quá trình xây dựng, hãy truy cập: +Nếu bạn có phản hồi về sản phẩm hoặc gặp lỗi trong quá trình xây dựng, hãy truy cập: [![Microsoft Foundry Developer Forum](https://img.shields.io/badge/GitHub-Microsoft_Foundry_Developer_Forum-blue?style=for-the-badge&logo=github&color=000000&logoColor=fff)](https://aka.ms/foundry/forum) @@ -143,5 +134,5 @@ Nếu bạn có phản hồi về sản phẩm hoặc lỗi trong quá trình x **Tuyên bố miễn trừ trách nhiệm**: -Tài liệu này đã được dịch bằng dịch vụ dịch thuật AI [Co-op Translator](https://github.com/Azure/co-op-translator). Mặc dù chúng tôi cố gắng đảm bảo độ chính xác, xin lưu ý rằng bản dịch tự động có thể chứa lỗi hoặc sự không chính xác. Tài liệu gốc bằng ngôn ngữ bản địa nên được coi là nguồn chính thức. Đối với thông tin quan trọng, nên sử dụng dịch vụ dịch thuật chuyên nghiệp bởi con người. Chúng tôi không chịu trách nhiệm về bất kỳ sự hiểu lầm hoặc diễn giải sai nào phát sinh từ việc sử dụng bản dịch này. +Tài liệu này đã được dịch bằng dịch vụ dịch thuật AI [Co-op Translator](https://github.com/Azure/co-op-translator). Mặc dù chúng tôi cố gắng đảm bảo độ chính xác, xin lưu ý rằng bản dịch tự động có thể chứa lỗi hoặc không chính xác. Tài liệu gốc bằng ngôn ngữ gốc của nó được coi là nguồn thông tin chính xác và có thẩm quyền. Đối với các thông tin quan trọng, khuyến nghị sử dụng dịch vụ dịch thuật chuyên nghiệp do con người thực hiện. Chúng tôi không chịu trách nhiệm đối với bất kỳ sự hiểu lầm hoặc diễn giải sai nào phát sinh từ việc sử dụng bản dịch này. \ No newline at end of file diff --git a/translations/vi/SECURITY.md b/translations/vi/SECURITY.md index 43fde652..2aaf3a87 100644 --- a/translations/vi/SECURITY.md +++ b/translations/vi/SECURITY.md @@ -1,12 +1,3 @@ - ## Bảo mật Microsoft coi trọng vấn đề bảo mật của các sản phẩm và dịch vụ phần mềm của mình, bao gồm tất cả các kho mã nguồn được quản lý thông qua các tổ chức GitHub của chúng tôi, bao gồm [Microsoft](https://github.com/Microsoft), [Azure](https://github.com/Azure), [DotNet](https://github.com/dotnet), [AspNet](https://github.com/aspnet) và [Xamarin](https://github.com/xamarin). diff --git a/translations/vi/SUPPORT.md b/translations/vi/SUPPORT.md index 9b4610f5..b5fe264e 100644 --- a/translations/vi/SUPPORT.md +++ b/translations/vi/SUPPORT.md @@ -1,12 +1,3 @@ - # Hỗ trợ ## Cách gửi vấn đề và nhận trợ giúp diff --git a/translations/zh-CN/.co-op-translator.json b/translations/zh-CN/.co-op-translator.json new file mode 100644 index 00000000..c9d14692 --- /dev/null +++ b/translations/zh-CN/.co-op-translator.json @@ -0,0 +1,92 @@ +{ + "01-IntroToGenAI/README.md": { + "original_hash": "75bfb080ca725e8a9aa9c80cae25fba1", + "translation_date": "2025-07-29T08:19:31+00:00", + "source_file": "01-IntroToGenAI/README.md", + "language_code": "zh-CN" + }, + "02-SetupDevEnvironment/README.md": { + "original_hash": "96a30d42b9751a3d4e4b20e28d29d459", + "translation_date": "2026-01-28T04:42:17+00:00", + "source_file": "02-SetupDevEnvironment/README.md", + "language_code": "zh-CN" + }, + "02-SetupDevEnvironment/examples/basic-chat-azure/README.md": { + "original_hash": "efd82efe50711d7e257eb943151d682c", + "translation_date": "2025-07-27T13:35:05+00:00", + "source_file": "02-SetupDevEnvironment/examples/basic-chat-azure/README.md", + "language_code": "zh-CN" + }, + "02-SetupDevEnvironment/getting-started-azure-openai.md": { + "original_hash": "bfdb4b4eadbee3a59ef742439f58326a", + "translation_date": "2025-07-27T12:54:41+00:00", + "source_file": "02-SetupDevEnvironment/getting-started-azure-openai.md", + "language_code": "zh-CN" + }, + "03-CoreGenerativeAITechniques/README.md": { + "original_hash": "685f55cb07de19b52a30ce6e8b6d889e", + "translation_date": "2025-08-28T21:56:44+00:00", + "source_file": "03-CoreGenerativeAITechniques/README.md", + "language_code": "zh-CN" + }, + "04-PracticalSamples/README.md": { + "original_hash": "14c0a61ecc1cd2012a9c129236dfdf71", + "translation_date": "2025-07-29T08:19:18+00:00", + "source_file": "04-PracticalSamples/README.md", + "language_code": "zh-CN" + }, + "04-PracticalSamples/calculator/README.md": { + "original_hash": "b6c16b5514d524e415a94f6097ee7d4c", + "translation_date": "2025-09-18T15:25:30+00:00", + "source_file": "04-PracticalSamples/calculator/README.md", + "language_code": "zh-CN" + }, + "04-PracticalSamples/foundrylocal/README.md": { + "original_hash": "f787307400de59adc25a1404466a35f3", + "translation_date": "2025-11-04T07:15:41+00:00", + "source_file": "04-PracticalSamples/foundrylocal/README.md", + "language_code": "zh-CN" + }, + "04-PracticalSamples/petstory/README.md": { + "original_hash": "0cbf68d605615a1e602c832a24616859", + "translation_date": "2025-07-25T10:52:03+00:00", + "source_file": "04-PracticalSamples/petstory/README.md", + "language_code": "zh-CN" + }, + "05-ResponsibleGenAI/README.md": { + "original_hash": "301c05c2f57e60a6950b8c665b8bdbba", + "translation_date": "2025-07-29T15:43:01+00:00", + "source_file": "05-ResponsibleGenAI/README.md", + "language_code": "zh-CN" + }, + "AGENTS.md": { + "original_hash": "afc90918d008cf77fd1982691f681306", + "translation_date": "2025-10-03T08:28:06+00:00", + "source_file": "AGENTS.md", + "language_code": "zh-CN" + }, + "CODE_OF_CONDUCT.md": { + "original_hash": "442b123d034f92f7c384d2bbd28f99f1", + "translation_date": "2025-07-21T15:58:15+00:00", + "source_file": "CODE_OF_CONDUCT.md", + "language_code": "zh-CN" + }, + "README.md": { + "original_hash": "125a08948d881c95628094f4dd1fbd43", + "translation_date": "2026-01-29T15:23:43+00:00", + "source_file": "README.md", + "language_code": "zh-CN" + }, + "SECURITY.md": { + "original_hash": "57f14126c1c6add76b3aef3844dfe4e3", + "translation_date": "2025-07-21T15:55:50+00:00", + "source_file": "SECURITY.md", + "language_code": "zh-CN" + }, + "SUPPORT.md": { + "original_hash": "b8ef73cc49dec68e2c885ee9df545129", + "translation_date": "2025-07-21T15:59:25+00:00", + "source_file": "SUPPORT.md", + "language_code": "zh-CN" + } +} \ No newline at end of file diff --git a/translations/zh/01-IntroToGenAI/README.md b/translations/zh-CN/01-IntroToGenAI/README.md similarity index 95% rename from translations/zh/01-IntroToGenAI/README.md rename to translations/zh-CN/01-IntroToGenAI/README.md index 5bc5b14a..243781ae 100644 --- a/translations/zh/01-IntroToGenAI/README.md +++ b/translations/zh-CN/01-IntroToGenAI/README.md @@ -1,12 +1,3 @@ - # 生成式人工智能简介 - Java 版 ## 你将学到什么 @@ -44,7 +35,7 @@ CO_OP_TRANSLATOR_METADATA: 不同类型的模型针对不同任务进行了优化。例如，**小型语言模型（SLMs）**和**大型语言模型（LLMs）**都可以处理文本生成，但 LLMs 通常在处理复杂任务时表现更佳。而对于图像相关任务，你可能会使用专门的视觉模型或多模态模型。 -![图示：生成式 AI 模型类型及其应用场景。](../../../translated_images/zh/llms.225ca2b8a0d34473.webp) +![图示：生成式 AI 模型类型及其应用场景。](../../../translated_images/zh-CN/llms.225ca2b8a0d34473.webp) 当然，这些模型的响应并非总是完美的。你可能听说过模型会“幻觉”（hallucinate），即以权威的方式生成错误信息。但通过为模型提供清晰的指令和上下文，你可以帮助它生成更好的响应。这就是**提示工程**的用武之地。 @@ -79,13 +70,13 @@ CO_OP_TRANSLATOR_METADATA: - **嵌入**：嵌入是捕捉语义意义的 tokens 的向量表示。它们是数值表示（通常是浮点数数组），使模型能够理解单词之间的关系并生成语境相关的响应。相似的单词具有相似的嵌入，这使得模型能够理解同义词和语义关系。 -![图示：嵌入](../../../translated_images/zh/embedding.398e50802c0037f9.webp) +![图示：嵌入](../../../translated_images/zh-CN/embedding.398e50802c0037f9.webp) 在 Java 中，你可以使用 OpenAI SDK 或其他支持嵌入生成的库来生成嵌入。这些嵌入对于语义搜索等任务至关重要，在语义搜索中，你希望根据含义而非精确文本匹配找到相似内容。 - **向量数据库**：向量数据库是针对嵌入优化的专用存储系统。它们支持高效的相似性搜索，对于需要基于语义相似性而非精确匹配从大型数据集中查找相关信息的检索增强生成（RAG）模式至关重要。 -![图示：向量数据库架构，展示嵌入如何存储和检索以进行相似性搜索。](../../../translated_images/zh/vector.f12f114934e223df.webp) +![图示：向量数据库架构，展示嵌入如何存储和检索以进行相似性搜索。](../../../translated_images/zh-CN/vector.f12f114934e223df.webp) > **注意**：本课程不会涵盖向量数据库，但它们在实际应用中非常常见，因此值得一提。 @@ -93,7 +84,7 @@ CO_OP_TRANSLATOR_METADATA: 在 Java AI 应用程序中，你将使用 tokens 进行文本处理，使用嵌入进行语义搜索和 RAG，使用向量数据库进行数据检索，并结合 MCP 使用代理构建智能工具系统。 -![图示：从提示到回复的流程——包括 tokens、向量、可选的 RAG 查找、LLM 思考以及 MCP 代理的快速流程。](../../../translated_images/zh/flow.f4ef62c3052d12a8.webp) +![图示：从提示到回复的流程——包括 tokens、向量、可选的 RAG 查找、LLM 思考以及 MCP 代理的快速流程。](../../../translated_images/zh-CN/flow.f4ef62c3052d12a8.webp) ### Java 的 AI 开发工具和库 diff --git a/translations/zh-CN/02-SetupDevEnvironment/README.md b/translations/zh-CN/02-SetupDevEnvironment/README.md new file mode 100644 index 00000000..60b6726e --- /dev/null +++ b/translations/zh-CN/02-SetupDevEnvironment/README.md @@ -0,0 +1,253 @@ +# 为 Java 生成式 AI 设置开发环境 + +> **快速开始**：2 分钟内在云端编码 - 跳到 [GitHub Codespaces 设置](../../../02-SetupDevEnvironment) - 无需本地安装，且使用 GitHub 模型！ + +> **对 Azure OpenAI 感兴趣？**，请参见我们的 [Azure OpenAI 设置指南](getting-started-azure-openai.md) ，包含创建新的 Azure OpenAI 资源的步骤。 + +## 您将学到什么 + +- 为 AI 应用设置 Java 开发环境 +- 选择并配置您喜欢的开发环境（优先云端 Codespaces、本地开发容器或完全本地设置） +- 通过连接 GitHub 模型测试您的设置 + +## 目录 + +- [您将学到什么](../../../02-SetupDevEnvironment) +- [介绍](../../../02-SetupDevEnvironment) +- [步骤 1：设置开发环境](../../../02-SetupDevEnvironment) + - [选项 A：GitHub Codespaces（推荐）](../../../02-SetupDevEnvironment) + - [选项 B：本地开发容器](../../../02-SetupDevEnvironment) + - [选项 C：使用您现有的本地安装](../../../02-SetupDevEnvironment) +- [步骤 2：创建 GitHub 个人访问令牌](../../../02-SetupDevEnvironment) +- [步骤 3：测试您的设置](../../../02-SetupDevEnvironment) +- [故障排除](../../../02-SetupDevEnvironment) +- [总结](../../../02-SetupDevEnvironment) +- [下一步](../../../02-SetupDevEnvironment) + +## 介绍 + +本章将指导您完成开发环境的设置。我们将使用 **GitHub 模型** 作为主要示例，因为它免费、仅需 GitHub 账户即可轻松设置、无需信用卡，并可访问多个模型进行实验。 + +**无需本地设置！**您可以立即使用 GitHub Codespaces 直接在浏览器中开始编写代码，提供完整的开发环境。 + +截图：GitHub 模型 + +我们推荐课程使用[**GitHub 模型**](https://github.com/marketplace?type=models)，因为它： +- **免费**开始使用 +- **仅需 GitHub 账户**即可轻松设置 +- **无需信用卡** +- 提供多种模型供实验 + +> **注意**：本培训中使用的 GitHub 模型有以下免费限制： +> - 每分钟 15 次请求（每天 150 次） +> - 每次请求约 8000 字输入，4000 字输出 +> - 5 个并发请求 +> +> 若用于生产，请使用您的 Azure 账户升级到 Azure AI Foundry 模型。代码无需更改。请参见 [Azure AI Foundry 文档](https://learn.microsoft.com/azure/ai-foundry/foundry-models/how-to/quickstart-github-models)。 + +## 步骤 1：设置开发环境 + + + +我们创建了预配置的开发容器，最大限度减少设置时间，并确保您拥有本课程所需的所有工具。请选择您喜欢的开发方式： + +### 环境设置选项： + +#### 选项 A：GitHub Codespaces（推荐） + +**2 分钟内开始编码 - 无需本地设置！** + +1. 将此仓库 Fork 到您的 GitHub 账户 + > **注意**：如果您想编辑基本配置，请查看 [开发容器配置](../../../.devcontainer/devcontainer.json) +2. 点击 **Code** → **Codespaces** 标签 → **...** → **New with options...** +3. 使用默认设置 – 这会选择为本课程创建的自定义开发容器配置：**Generative AI Java Development Environment** +4. 点击 **Create codespace** +5. 等待大约 2 分钟环境准备完成 +6. 继续到 [步骤 2：创建 GitHub 令牌](../../../02-SetupDevEnvironment) + +截图：Codespaces 子菜单 + +截图：New with options + +截图：创建 codespace 选项 + + +> **Codespaces 的优势**： +> - 无需本地安装 +> - 任何带浏览器的设备都可使用 +> - 预配置所有工具和依赖 +> - 个人账户每月免费 60 小时 +> - 为所有学习者提供一致的环境 + +#### 选项 B：本地开发容器 + +**适合喜欢使用 Docker 本地开发的开发者** + +1. 将此仓库 Fork 并克隆到您的本地机器 + > **注意**：如果您想编辑基本配置，请查看 [开发容器配置](../../../.devcontainer/devcontainer.json) +2. 安装 [Docker Desktop](https://www.docker.com/products/docker-desktop/) 和 [VS Code](https://code.visualstudio.com/) +3. 在 VS Code 中安装 [开发容器扩展](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers) +4. 在 VS Code 中打开仓库文件夹 +5. 出现提示时，点击 **Reopen in Container**（或使用 `Ctrl+Shift+P` → “Dev Containers: Reopen in Container”） +6. 等待容器构建并启动 +7. 继续到 [步骤 2：创建 GitHub 令牌](../../../02-SetupDevEnvironment) + +截图：开发容器设置 + +截图：开发容器构建完成 + +#### 选项 C：使用您现有的本地安装 + +**适合已有 Java 环境的开发者** + +先决条件： +- [Java 21+](https://www.oracle.com/java/technologies/javase/jdk21-archive-downloads.html) +- [Maven 3.9+](https://maven.apache.org/download.cgi) +- [VS Code](https://code.visualstudio.com) 或您喜欢的 IDE + +步骤： +1. 克隆此仓库到本地机器 +2. 在您的 IDE 中打开项目 +3. 继续到 [步骤 2：创建 GitHub 令牌](../../../02-SetupDevEnvironment) + +> **专业提示**：如果您的设备配置较低但想在本地用 VS Code，可以使用 GitHub Codespaces！您可以将本地 VS Code 连接到云端 Codespace，兼得两者优势。 + +截图：创建的本地开发容器实例 + + +## 步骤 2：创建 GitHub 个人访问令牌 + +1. 访问 [GitHub 设置](https://github.com/settings/profile)，从您的个人资料菜单选择 **Settings**。 +2. 在左侧边栏点击 **Developer settings**（通常在底部）。 +3. 在 **Personal access tokens** 下，点击 **Fine-grained tokens**（或直接访问此 [链接](https://github.com/settings/personal-access-tokens)）。 +4. 点击 **Generate new token**。 +5. 在“Token name”中填写描述性名称（例如 `GenAI-Java-Course-Token`）。 +6. 设置过期时间（推荐：7 天以符合安全最佳实践）。 +7. 在“Resource owner”选择您的用户账户。 +8. 在“Repository access”选择您想用 GitHub 模型访问的仓库（或“所有仓库”，如有需要）。 +9. 在“Account permissions”中找到 **Models** 并设置为 **只读**。 +10. 点击 **Generate token**。 +11. **现在复制并保存您的令牌** – 以后不会再次显示！ + +> **安全提示**：令牌权限应最小化，过期时间应尽可能短。 + +## 步骤 3：使用 GitHub 模型示例测试您的设置 + +当您的开发环境准备好后，让我们用位于 [`02-SetupDevEnvironment/examples/github-models`](../../../02-SetupDevEnvironment/examples/github-models) 的示例应用测试 GitHub 模型集成。 + +1. 打开开发环境的终端。 +2. 切换到 GitHub 模型示例目录： + ```bash + cd 02-SetupDevEnvironment/examples/github-models + ``` +3. 将您的 GitHub 令牌设置为环境变量： + ```bash + # macOS/Linux + export GITHUB_TOKEN=your_token_here + + # Windows（命令提示符） + set GITHUB_TOKEN=your_token_here + + # Windows（PowerShell） + $env:GITHUB_TOKEN="your_token_here" + ``` + +4. 运行应用： + ```bash + mvn compile exec:java -Dexec.mainClass="com.example.githubmodels.App" + ``` + +您应该看到类似输出： +```text +Using model: gpt-4.1-nano +Sending request to GitHub Models... +Response: Hello World! +``` + +### 了解示例代码 + +首先，让我们理解刚刚运行的内容。`examples/github-models` 中的示例使用了 OpenAI Java SDK 连接到 GitHub 模型： + +**这段代码做了什么：** +- 使用您的个人访问令牌 **连接** GitHub 模型 +- **发送** 一条简单的 “Say Hello World!” 消息到 AI 模型 +- **接收** 并显示 AI 的响应 +- **验证** 您的设置是否正确 + +**关键依赖**（在 `pom.xml`）： +```xml + + com.openai + openai-java + 2.12.0 + +``` + +**主要代码** (`App.java`)： +```java +// 使用 OpenAI Java SDK 连接到 GitHub 模型 +OpenAIClient client = OpenAIOkHttpClient.builder() + .apiKey(pat) + .baseUrl("https://models.inference.ai.azure.com") + .build(); + +// 创建聊天补全请求 +ChatCompletionCreateParams params = ChatCompletionCreateParams.builder() + .model(modelId) + .addSystemMessage("You are a concise assistant.") + .addUserMessage("Say Hello World!") + .build(); + +// 获取 AI 响应 +ChatCompletion response = client.chat().completions().create(params); +System.out.println("Response: " + response.choices().get(0).message().content().orElse("No response content")); +``` + +## 总结 + +太好了！您现在已完成所有设置： + +- 创建了具有访问 AI 模型权限的 GitHub 个人访问令牌 +- 启动并运行了 Java 开发环境（无论是 Codespaces、开发容器还是本地） +- 使用 OpenAI Java SDK 连接到 GitHub 模型，免费进行 AI 开发 +- 通过简单示例测试了与 AI 模型的连接 + +## 下一步 + +[第 3 章：核心生成式 AI 技术](../03-CoreGenerativeAITechniques/README.md) + +## 故障排除 + +遇到问题？这里是常见问题及解决方案： + +- **令牌无效？** + - 确认您完全复制了令牌且无多余空格 + - 确保令牌作为环境变量设置正确 + - 检查令牌权限是否正确（Models：只读） + +- **找不到 Maven？** + - 使用开发容器/Codespaces 时，Maven 应已预装 + - 本地设置需确保安装 Java 21+ 和 Maven 3.9+ + - 运行 `mvn --version` 验证安装 + +- **连接问题？** + - 检查网络连接 + - 确认所在网络允许访问 GitHub + - 确保没有防火墙阻止 GitHub 模型端点 + +- **开发容器无法启动？** + - 确保 Docker Desktop 正在运行（本地开发时） + - 尝试重建容器：`Ctrl+Shift+P` → “Dev Containers: Rebuild Container” + +- **应用编译错误？** + - 确保位置正确：`02-SetupDevEnvironment/examples/github-models` + - 尝试清理并重建：`mvn clean compile` + +> **需要帮助？**：依然有问题？请在仓库中提出 issue，我们会协助您解决。 + +--- + + +**免责声明**： +本文档由 AI 翻译服务 [Co-op Translator](https://github.com/Azure/co-op-translator) 翻译而成。虽然我们力求准确，但请注意自动翻译可能包含错误或不准确之处。原始文档的原语言版本应被视为权威来源。对于重要信息，建议采用专业人工翻译。我们不对因使用此翻译而产生的任何误解或曲解承担责任。 + \ No newline at end of file diff --git a/translations/zh/02-SetupDevEnvironment/examples/basic-chat-azure/README.md b/translations/zh-CN/02-SetupDevEnvironment/examples/basic-chat-azure/README.md similarity index 96% rename from translations/zh/02-SetupDevEnvironment/examples/basic-chat-azure/README.md rename to translations/zh-CN/02-SetupDevEnvironment/examples/basic-chat-azure/README.md index e238cd2b..33721620 100644 --- a/translations/zh/02-SetupDevEnvironment/examples/basic-chat-azure/README.md +++ b/translations/zh-CN/02-SetupDevEnvironment/examples/basic-chat-azure/README.md @@ -1,12 +1,3 @@ - # 使用 Azure OpenAI 的基础聊天 - 端到端示例 此示例展示了如何创建一个简单的 Spring Boot 应用程序，连接到 Azure OpenAI 并测试您的设置。 diff --git a/translations/zh/02-SetupDevEnvironment/getting-started-azure-openai.md b/translations/zh-CN/02-SetupDevEnvironment/getting-started-azure-openai.md similarity index 94% rename from translations/zh/02-SetupDevEnvironment/getting-started-azure-openai.md rename to translations/zh-CN/02-SetupDevEnvironment/getting-started-azure-openai.md index f2770ce3..cbe70143 100644 --- a/translations/zh/02-SetupDevEnvironment/getting-started-azure-openai.md +++ b/translations/zh-CN/02-SetupDevEnvironment/getting-started-azure-openai.md @@ -1,12 +1,3 @@ - # 为 Azure OpenAI 设置开发环境 > **快速开始**：本指南适用于 Azure OpenAI 的设置。如果您想快速使用免费模型，请参考 [GitHub Models with Codespaces](./README.md#quick-start-cloud)。 @@ -75,7 +66,7 @@ CO_OP_TRANSLATOR_METADATA: > **注意**：如果您想编辑基本配置，请查看 [Dev Container Configuration](../../../.devcontainer/devcontainer.json) 2. 在您的 Fork 仓库中，点击 **Code** → **Codespaces** 标签 3. 点击 **...** → **New with options...** -![创建带选项的 Codespace](../../../translated_images/zh/codespaces.9945ded8ceb431a5.webp) +![创建带选项的 Codespace](../../../translated_images/zh-CN/codespaces.9945ded8ceb431a5.webp) 4. 选择 **Dev container configuration**： - **Generative AI Java Development Environment** 5. 点击 **Create codespace** diff --git a/translations/zh/03-CoreGenerativeAITechniques/README.md b/translations/zh-CN/03-CoreGenerativeAITechniques/README.md similarity index 98% rename from translations/zh/03-CoreGenerativeAITechniques/README.md rename to translations/zh-CN/03-CoreGenerativeAITechniques/README.md index f8110e6f..dcaa55fb 100644 --- a/translations/zh/03-CoreGenerativeAITechniques/README.md +++ b/translations/zh-CN/03-CoreGenerativeAITechniques/README.md @@ -1,12 +1,3 @@ - # 核心生成式 AI 技术教程 ## 目录 diff --git a/translations/zh/04-PracticalSamples/README.md b/translations/zh-CN/04-PracticalSamples/README.md similarity index 93% rename from translations/zh/04-PracticalSamples/README.md rename to translations/zh-CN/04-PracticalSamples/README.md index 6ed9f7db..30524e26 100644 --- a/translations/zh/04-PracticalSamples/README.md +++ b/translations/zh-CN/04-PracticalSamples/README.md @@ -1,12 +1,3 @@ - # 实用应用与项目 ## 你将学到什么 diff --git a/translations/zh/04-PracticalSamples/calculator/README.md b/translations/zh-CN/04-PracticalSamples/calculator/README.md similarity index 97% rename from translations/zh/04-PracticalSamples/calculator/README.md rename to translations/zh-CN/04-PracticalSamples/calculator/README.md index fd86cb75..3b1b9e12 100644 --- a/translations/zh/04-PracticalSamples/calculator/README.md +++ b/translations/zh-CN/04-PracticalSamples/calculator/README.md @@ -1,12 +1,3 @@ - # MCP计算器初学者教程 ## 目录 diff --git a/translations/zh/04-PracticalSamples/foundrylocal/README.md b/translations/zh-CN/04-PracticalSamples/foundrylocal/README.md similarity index 98% rename from translations/zh/04-PracticalSamples/foundrylocal/README.md rename to translations/zh-CN/04-PracticalSamples/foundrylocal/README.md index a23fd507..3fcf13b7 100644 --- a/translations/zh/04-PracticalSamples/foundrylocal/README.md +++ b/translations/zh-CN/04-PracticalSamples/foundrylocal/README.md @@ -1,12 +1,3 @@ - # Foundry Local Spring Boot 教程 ## 目录 diff --git a/translations/zh/04-PracticalSamples/petstory/README.md b/translations/zh-CN/04-PracticalSamples/petstory/README.md similarity index 98% rename from translations/zh/04-PracticalSamples/petstory/README.md rename to translations/zh-CN/04-PracticalSamples/petstory/README.md index ec9839e1..87e36e4c 100644 --- a/translations/zh/04-PracticalSamples/petstory/README.md +++ b/translations/zh-CN/04-PracticalSamples/petstory/README.md @@ -1,12 +1,3 @@ - # 宠物故事生成器初学者教程 ## 目录 diff --git a/translations/zh/05-ResponsibleGenAI/README.md b/translations/zh-CN/05-ResponsibleGenAI/README.md similarity index 95% rename from translations/zh/05-ResponsibleGenAI/README.md rename to translations/zh-CN/05-ResponsibleGenAI/README.md index 5bed8aea..91b5c21d 100644 --- a/translations/zh/05-ResponsibleGenAI/README.md +++ b/translations/zh-CN/05-ResponsibleGenAI/README.md @@ -1,12 +1,3 @@ - # 负责任的生成式 AI ## 学习内容 @@ -58,7 +49,7 @@ GitHub Models 自带基础内容过滤功能。它就像您 AI 俱乐部的友 5. 显示结果，展示哪些内容被屏蔽、拒绝或允许 6. 测试安全内容以作对比 -![负责任的 AI 安全演示](../../../translated_images/zh/responsible.e4f51a917bafa4bf.webp) +![负责任的 AI 安全演示](../../../translated_images/zh-CN/responsible.e4f51a917bafa4bf.webp) ### 设置说明 @@ -164,7 +155,7 @@ Status: Response generated successfully 恭喜您完成了《生成式 AI 初学者》课程！ -![课程完成](../../../translated_images/zh/image.73c7e2ff4a652e77.webp) +![课程完成](../../../translated_images/zh-CN/image.73c7e2ff4a652e77.webp) **您已完成的内容：** - 设置开发环境 diff --git a/translations/zh/AGENTS.md b/translations/zh-CN/AGENTS.md similarity index 97% rename from translations/zh/AGENTS.md rename to translations/zh-CN/AGENTS.md index 25d5ea5b..3bc65277 100644 --- a/translations/zh/AGENTS.md +++ b/translations/zh-CN/AGENTS.md @@ -1,12 +1,3 @@ - # AGENTS.md ## 项目概述 diff --git a/translations/zh/CODE_OF_CONDUCT.md b/translations/zh-CN/CODE_OF_CONDUCT.md similarity index 80% rename from translations/zh/CODE_OF_CONDUCT.md rename to translations/zh-CN/CODE_OF_CONDUCT.md index 3313c119..532ea997 100644 --- a/translations/zh/CODE_OF_CONDUCT.md +++ b/translations/zh-CN/CODE_OF_CONDUCT.md @@ -1,12 +1,3 @@ - # Microsoft 开源行为准则 本项目已采用 [Microsoft 开源行为准则](https://opensource.microsoft.com/codeofconduct/)。 diff --git a/translations/zh-CN/README.md b/translations/zh-CN/README.md new file mode 100644 index 00000000..451c07ef --- /dev/null +++ b/translations/zh-CN/README.md @@ -0,0 +1,139 @@ +# 面向初学者的生成式AI - Java版 +[![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) + +![面向初学者的生成式AI - Java版](../../translated_images/zh-CN/beg-genai-series.8b48be9951cc574c.webp) + +**时间投入**：整个工作坊可以在网上完成，无需本地设置。环境设置花费约2分钟，浏览示例根据深入程度需要1-3小时。 + +> **快速开始** + +1. 将此仓库分叉到您的GitHub账户 +2. 点击 **Code** → **Codespaces** 标签 → **...** → **New with options...** +3. 使用默认设置 – 这将选择为本课程创建的开发容器 +4. 点击 **Create codespace** +5. 等待约2分钟，环境准备完成 +6. 直接跳转到 [第一个示例](./02-SetupDevEnvironment/README.md#step-2-create-a-github-personal-access-token) + +> **更喜欢本地克隆？** +> +> 此仓库包含50多个语言翻译，大幅增加了下载大小。若想不含翻译克隆，请使用稀疏检出： +> ```bash +> git clone --filter=blob:none --sparse https://github.com/microsoft/Generative-AI-for-beginners-java.git +> cd Generative-AI-for-beginners-java +> git sparse-checkout set --no-cone '/*' '!translations' '!translated_images' +> ``` +> 这样您将获得完成课程所需的一切，且下载速度更快。 + + +## 多语言支持 + +### 通过GitHub Action支持（自动且始终最新） + + +[阿拉伯语](../ar/README.md) | [孟加拉语](../bn/README.md) | [保加利亚语](../bg/README.md) | [缅甸语](../my/README.md) | [中文（简体）](./README.md) | [中文（繁体，香港）](../zh-HK/README.md) | [中文（繁体，澳门）](../zh-MO/README.md) | [中文（繁体，台湾）](../zh-TW/README.md) | [克罗地亚语](../hr/README.md) | [捷克语](../cs/README.md) | [丹麦语](../da/README.md) | [荷兰语](../nl/README.md) | [爱沙尼亚语](../et/README.md) | [芬兰语](../fi/README.md) | [法语](../fr/README.md) | [德语](../de/README.md) | [希腊语](../el/README.md) | [希伯来语](../he/README.md) | [印地语](../hi/README.md) | [匈牙利语](../hu/README.md) | [印度尼西亚语](../id/README.md) | [意大利语](../it/README.md) | [日语](../ja/README.md) | [卡纳达语](../kn/README.md) | [韩语](../ko/README.md) | [立陶宛语](../lt/README.md) | [马来语](../ms/README.md) | [马拉雅拉姆语](../ml/README.md) | [马拉提语](../mr/README.md) | [尼泊尔语](../ne/README.md) | [尼日利亚匹钦语](../pcm/README.md) | [挪威语](../no/README.md) | [波斯语（法尔西语）](../fa/README.md) | [波兰语](../pl/README.md) | [葡萄牙语（巴西）](../pt-BR/README.md) | [葡萄牙语（葡萄牙）](../pt-PT/README.md) | [旁遮普语（古鲁姆克希文字）](../pa/README.md) | [罗马尼亚语](../ro/README.md) | [俄语](../ru/README.md) | [塞尔维亚语（西里尔字母）](../sr/README.md) | [斯洛伐克语](../sk/README.md) | [斯洛文尼亚语](../sl/README.md) | [西班牙语](../es/README.md) | [斯瓦希里语](../sw/README.md) | [瑞典语](../sv/README.md) | [塔加洛语（菲律宾语）](../tl/README.md) | [泰米尔语](../ta/README.md) | [泰卢固语](../te/README.md) | [泰语](../th/README.md) | [土耳其语](../tr/README.md) | [乌克兰语](../uk/README.md) | [乌尔都语](../ur/README.md) | [越南语](../vi/README.md) + +> **更喜欢本地克隆？** + +> 此仓库包含50多个语言翻译，大幅增加了下载大小。若想不含翻译克隆，请使用稀疏检出： +> ```bash +> git clone --filter=blob:none --sparse https://github.com/microsoft/Generative-AI-for-beginners-java.git +> cd Generative-AI-for-beginners-java +> git sparse-checkout set --no-cone '/*' '!translations' '!translated_images' +> ``` +> 这样您将获得完成课程所需的一切，且下载速度更快。 + + +## 课程结构与学习路径 + +### **第1章：生成式AI简介** +- **核心概念**：了解大型语言模型、token、嵌入以及AI能力 +- **Java AI生态系统**：Spring AI和OpenAI SDK概览 +- **模型上下文协议**：MCP简介及其在AI代理通信中的角色 +- **实际应用**：聊天机器人和内容生成等实际场景 +- **[→ 开始第1章](./01-IntroToGenAI/README.md)** + +### **第2章：开发环境设置** +- **多供应商配置**：设置GitHub模型、Azure OpenAI和OpenAI Java SDK集成 +- **Spring Boot + Spring AI**：企业级AI应用最佳实践 +- **GitHub模型**：免费AI模型访问，用于原型设计和学习（无需信用卡） +- **开发工具**：Docker容器、VS Code及GitHub Codespaces配置 +- **[→ 开始第2章](./02-SetupDevEnvironment/README.md)** + +### **第3章：核心生成式AI技术** +- **提示工程**：优化AI模型响应的技术 +- **嵌入与向量操作**：实现语义搜索和相似度匹配 +- **检索增强生成（RAG）**：将AI与您的数据源结合 +- **函数调用**：通过自定义工具和插件扩展AI能力 +- **[→ 开始第3章](./03-CoreGenerativeAITechniques/README.md)** + +### **第4章：实用应用与项目** +- **宠物故事生成器** (`petstory/`)：使用GitHub模型进行创意内容生成 +- **Foundry本地示范** (`foundrylocal/`)：使用OpenAI Java SDK进行本地AI模型整合 +- **MCP计算服务** (`calculator/`)：使用Spring AI实现基础的模型上下文协议 +- **[→ 开始第4章](./04-PracticalSamples/README.md)** + +### **第5章：负责任的AI开发** +- **GitHub模型安全**：测试内置内容过滤和安全机制（硬性屏蔽及软拒绝） +- **负责任AI示范**：实际展示现代AI安全系统如何工作 +- **最佳实践**：伦理AI开发与部署的关键指南 +- **[→ 开始第5章](./05-ResponsibleGenAI/README.md)** + +## 附加资源 + + +### LangChain +[![初学者的LangChain4j](https://img.shields.io/badge/LangChain4j%20for%20Beginners-22C55E?style=for-the-badge&&labelColor=E5E7EB&color=0553D6)](https://aka.ms/langchain4j-for-beginners) +[![初学者的LangChain.js](https://img.shields.io/badge/LangChain.js%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=0553D6)](https://aka.ms/langchainjs-for-beginners?WT.mc_id=m365-94501-dwahlin) + +--- + +### Azure / Edge / MCP / 代理 +[![初学者的AZD](https://img.shields.io/badge/AZD%20for%20Beginners-0078D4?style=for-the-badge&labelColor=E5E7EB&color=0078D4)](https://github.com/microsoft/AZD-for-beginners?WT.mc_id=academic-105485-koreyst) +[![初学者的Edge AI](https://img.shields.io/badge/Edge%20AI%20for%20Beginners-00B8E4?style=for-the-badge&labelColor=E5E7EB&color=00B8E4)](https://github.com/microsoft/edgeai-for-beginners?WT.mc_id=academic-105485-koreyst) +[![初学者的MCP](https://img.shields.io/badge/MCP%20for%20Beginners-009688?style=for-the-badge&labelColor=E5E7EB&color=009688)](https://github.com/microsoft/mcp-for-beginners?WT.mc_id=academic-105485-koreyst) +[![初学者的AI代理](https://img.shields.io/badge/AI%20Agents%20for%20Beginners-00C49A?style=for-the-badge&labelColor=E5E7EB&color=00C49A)](https://github.com/microsoft/ai-agents-for-beginners?WT.mc_id=academic-105485-koreyst) + +--- + +### 生成式AI系列 +[![面向初学者的生成式AI](https://img.shields.io/badge/Generative%20AI%20for%20Beginners-8B5CF6?style=for-the-badge&labelColor=E5E7EB&color=8B5CF6)](https://github.com/microsoft/generative-ai-for-beginners?WT.mc_id=academic-105485-koreyst) +[![生成式AI (.NET)](https://img.shields.io/badge/Generative%20AI%20(.NET)-9333EA?style=for-the-badge&labelColor=E5E7EB&color=9333EA)](https://github.com/microsoft/Generative-AI-for-beginners-dotnet?WT.mc_id=academic-105485-koreyst) +[![生成式AI (Java)](https://img.shields.io/badge/Generative%20AI%20(Java)-C084FC?style=for-the-badge&labelColor=E5E7EB&color=C084FC)](https://github.com/microsoft/generative-ai-for-beginners-java?WT.mc_id=academic-105485-koreyst) +[![生成式AI (JavaScript)](https://img.shields.io/badge/Generative%20AI%20(JavaScript)-E879F9?style=for-the-badge&labelColor=E5E7EB&color=E879F9)](https://github.com/microsoft/generative-ai-with-javascript?WT.mc_id=academic-105485-koreyst) + +--- + +### 核心学习 +[![初学者的机器学习](https://img.shields.io/badge/ML%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=22C55E)](https://aka.ms/ml-beginners?WT.mc_id=academic-105485-koreyst) +[![初学者的数据科学](https://img.shields.io/badge/Data%20Science%20for%20Beginners-84CC16?style=for-the-badge&labelColor=E5E7EB&color=84CC16)](https://aka.ms/datascience-beginners?WT.mc_id=academic-105485-koreyst) +[![初学者的人工智能](https://img.shields.io/badge/AI%20for%20Beginners-A3E635?style=for-the-badge&labelColor=E5E7EB&color=A3E635)](https://aka.ms/ai-beginners?WT.mc_id=academic-105485-koreyst) +[![初学者的网络安全](https://img.shields.io/badge/Cybersecurity%20for%20Beginners-F97316?style=for-the-badge&labelColor=E5E7EB&color=F97316)](https://github.com/microsoft/Security-101?WT.mc_id=academic-96948-sayoung) + +[![Web Dev for Beginners](https://img.shields.io/badge/Web%20Dev%20for%20Beginners-EC4899?style=for-the-badge&labelColor=E5E7EB&color=EC4899)](https://aka.ms/webdev-beginners?WT.mc_id=academic-105485-koreyst) +[![IoT for Beginners](https://img.shields.io/badge/IoT%20for%20Beginners-14B8A6?style=for-the-badge&labelColor=E5E7EB&color=14B8A6)](https://aka.ms/iot-beginners?WT.mc_id=academic-105485-koreyst) +[![XR Development for Beginners](https://img.shields.io/badge/XR%20Development%20for%20Beginners-38BDF8?style=for-the-badge&labelColor=E5E7EB&color=38BDF8)](https://github.com/microsoft/xr-development-for-beginners?WT.mc_id=academic-105485-koreyst) + +--- + +### Copilot 系列 +[![Copilot for AI Paired Programming](https://img.shields.io/badge/Copilot%20for%20AI%20Paired%20Programming-FACC15?style=for-the-badge&labelColor=E5E7EB&color=FACC15)](https://aka.ms/GitHubCopilotAI?WT.mc_id=academic-105485-koreyst) +[![Copilot for C#/.NET](https://img.shields.io/badge/Copilot%20for%20C%23/.NET-FBBF24?style=for-the-badge&labelColor=E5E7EB&color=FBBF24)](https://github.com/microsoft/mastering-github-copilot-for-dotnet-csharp-developers?WT.mc_id=academic-105485-koreyst) +[![Copilot Adventure](https://img.shields.io/badge/Copilot%20Adventure-FDE68A?style=for-the-badge&labelColor=E5E7EB&color=FDE68A)](https://github.com/microsoft/CopilotAdventures?WT.mc_id=academic-105485-koreyst) + + +## 获取帮助 + +如果您遇到困难或对构建 AI 应用有任何疑问，请加入学习者和经验丰富的开发者讨论 MCP 的社区。这是一个支持性的社区，欢迎提问并自由共享知识。 + +[![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) + +如果您在构建过程中有产品反馈或发现错误，请访问： + +[![Microsoft Foundry Developer Forum](https://img.shields.io/badge/GitHub-Microsoft_Foundry_Developer_Forum-blue?style=for-the-badge&logo=github&color=000000&logoColor=fff)](https://aka.ms/foundry/forum) + +--- + + +**免责声明**： +本文件使用人工智能翻译服务[Co-op Translator](https://github.com/Azure/co-op-translator)进行翻译。尽管我们努力确保准确性，但请注意，自动翻译可能包含错误或不准确之处。应以原始语言的原文为权威来源。对于重要信息，建议采用专业人工翻译。对于因使用本翻译而产生的任何误解或误释，我们不承担任何责任。 + \ No newline at end of file diff --git a/translations/zh/SECURITY.md b/translations/zh-CN/SECURITY.md similarity index 93% rename from translations/zh/SECURITY.md rename to translations/zh-CN/SECURITY.md index dd4979b9..73485c59 100644 --- a/translations/zh/SECURITY.md +++ b/translations/zh-CN/SECURITY.md @@ -1,12 +1,3 @@ - ## 安全性 微软非常重视我们软件产品和服务的安全性，这包括通过我们的 GitHub 组织管理的所有源代码库，这些组织包括 [Microsoft](https://github.com/Microsoft)、[Azure](https://github.com/Azure)、[DotNet](https://github.com/dotnet)、[AspNet](https://github.com/aspnet) 和 [Xamarin](https://github.com/xamarin)。 diff --git a/translations/zh/SUPPORT.md b/translations/zh-CN/SUPPORT.md similarity index 79% rename from translations/zh/SUPPORT.md rename to translations/zh-CN/SUPPORT.md index 761659d6..02246d75 100644 --- a/translations/zh/SUPPORT.md +++ b/translations/zh-CN/SUPPORT.md @@ -1,12 +1,3 @@ - # 支持 ## 如何提交问题并获取帮助 diff --git a/translations/zh-HK/.co-op-translator.json b/translations/zh-HK/.co-op-translator.json new file mode 100644 index 00000000..88a4026a --- /dev/null +++ b/translations/zh-HK/.co-op-translator.json @@ -0,0 +1,92 @@ +{ + "01-IntroToGenAI/README.md": { + "original_hash": "75bfb080ca725e8a9aa9c80cae25fba1", + "translation_date": "2025-07-29T08:25:46+00:00", + "source_file": "01-IntroToGenAI/README.md", + "language_code": "zh-HK" + }, + "02-SetupDevEnvironment/README.md": { + "original_hash": "96a30d42b9751a3d4e4b20e28d29d459", + "translation_date": "2026-01-28T04:44:01+00:00", + "source_file": "02-SetupDevEnvironment/README.md", + "language_code": "zh-HK" + }, + "02-SetupDevEnvironment/examples/basic-chat-azure/README.md": { + "original_hash": "efd82efe50711d7e257eb943151d682c", + "translation_date": "2025-07-27T13:35:49+00:00", + "source_file": "02-SetupDevEnvironment/examples/basic-chat-azure/README.md", + "language_code": "zh-HK" + }, + "02-SetupDevEnvironment/getting-started-azure-openai.md": { + "original_hash": "bfdb4b4eadbee3a59ef742439f58326a", + "translation_date": "2025-07-27T12:56:26+00:00", + "source_file": "02-SetupDevEnvironment/getting-started-azure-openai.md", + "language_code": "zh-HK" + }, + "03-CoreGenerativeAITechniques/README.md": { + "original_hash": "685f55cb07de19b52a30ce6e8b6d889e", + "translation_date": "2025-08-28T21:57:49+00:00", + "source_file": "03-CoreGenerativeAITechniques/README.md", + "language_code": "zh-HK" + }, + "04-PracticalSamples/README.md": { + "original_hash": "14c0a61ecc1cd2012a9c129236dfdf71", + "translation_date": "2025-07-29T08:25:30+00:00", + "source_file": "04-PracticalSamples/README.md", + "language_code": "zh-HK" + }, + "04-PracticalSamples/calculator/README.md": { + "original_hash": "b6c16b5514d524e415a94f6097ee7d4c", + "translation_date": "2025-09-18T15:26:16+00:00", + "source_file": "04-PracticalSamples/calculator/README.md", + "language_code": "zh-HK" + }, + "04-PracticalSamples/foundrylocal/README.md": { + "original_hash": "f787307400de59adc25a1404466a35f3", + "translation_date": "2025-11-04T07:16:46+00:00", + "source_file": "04-PracticalSamples/foundrylocal/README.md", + "language_code": "zh-HK" + }, + "04-PracticalSamples/petstory/README.md": { + "original_hash": "0cbf68d605615a1e602c832a24616859", + "translation_date": "2025-07-25T10:55:34+00:00", + "source_file": "04-PracticalSamples/petstory/README.md", + "language_code": "zh-HK" + }, + "05-ResponsibleGenAI/README.md": { + "original_hash": "301c05c2f57e60a6950b8c665b8bdbba", + "translation_date": "2025-07-29T15:43:48+00:00", + "source_file": "05-ResponsibleGenAI/README.md", + "language_code": "zh-HK" + }, + "AGENTS.md": { + "original_hash": "afc90918d008cf77fd1982691f681306", + "translation_date": "2025-10-03T08:29:42+00:00", + "source_file": "AGENTS.md", + "language_code": "zh-HK" + }, + "CODE_OF_CONDUCT.md": { + "original_hash": "442b123d034f92f7c384d2bbd28f99f1", + "translation_date": "2025-07-21T15:58:27+00:00", + "source_file": "CODE_OF_CONDUCT.md", + "language_code": "zh-HK" + }, + "README.md": { + "original_hash": "125a08948d881c95628094f4dd1fbd43", + "translation_date": "2026-01-29T15:26:56+00:00", + "source_file": "README.md", + "language_code": "zh-HK" + }, + "SECURITY.md": { + "original_hash": "57f14126c1c6add76b3aef3844dfe4e3", + "translation_date": "2025-07-21T15:56:13+00:00", + "source_file": "SECURITY.md", + "language_code": "zh-HK" + }, + "SUPPORT.md": { + "original_hash": "b8ef73cc49dec68e2c885ee9df545129", + "translation_date": "2025-07-21T15:59:35+00:00", + "source_file": "SUPPORT.md", + "language_code": "zh-HK" + } +} \ No newline at end of file diff --git a/translations/hk/01-IntroToGenAI/README.md b/translations/zh-HK/01-IntroToGenAI/README.md similarity index 95% rename from translations/hk/01-IntroToGenAI/README.md rename to translations/zh-HK/01-IntroToGenAI/README.md index d38b0ae0..fab836f0 100644 --- a/translations/hk/01-IntroToGenAI/README.md +++ b/translations/zh-HK/01-IntroToGenAI/README.md @@ -1,12 +1,3 @@ - # 生成式人工智能入門 - Java 版 ## 你將學到的內容 @@ -44,7 +35,7 @@ CO_OP_TRANSLATOR_METADATA: 針對不同的任務，有特定類型的模型進行優化。例如，**小型語言模型（SLMs）**和**大型語言模型（LLMs）**都可以處理文本生成，但 LLMs 通常在處理複雜任務時表現更佳。針對圖像相關任務，你可以使用專門的視覺模型或多模態模型。 -![圖示：生成式人工智能模型類型及其使用案例。](../../../translated_images/hk/llms.225ca2b8a0d34473.webp) +![圖示：生成式人工智能模型類型及其使用案例。](../../../translated_images/zh-HK/llms.225ca2b8a0d34473.webp) 當然，這些模型的回應並非總是完美的。你可能聽說過模型會“幻覺”或以權威的方式生成錯誤信息。但你可以通過提供清晰的指令和上下文來幫助模型生成更好的回應，而這正是**提示工程**的作用。 @@ -79,13 +70,13 @@ CO_OP_TRANSLATOR_METADATA: - **嵌入**：嵌入是捕捉語義意義的 tokens 的向量表示。它們是數字表示（通常是浮點數數組），使模型能理解單詞之間的關係並生成具有上下文相關性的回應。相似的單詞具有相似的嵌入，這使模型能理解同義詞和語義關係。 -![圖示：嵌入](../../../translated_images/hk/embedding.398e50802c0037f9.webp) +![圖示：嵌入](../../../translated_images/zh-HK/embedding.398e50802c0037f9.webp) 在 Java 中，你可以使用 OpenAI SDK 或其他支持嵌入生成的庫來生成嵌入。這些嵌入對於語義搜索等任務至關重要，因為你希望基於意義而非精確文本匹配找到相似內容。 - **向量數據庫**：向量數據庫是針對嵌入進行優化的專門存儲系統。它們支持高效的相似性搜索，對於需要基於語義相似性而非精確匹配從大型數據集中查找相關信息的檢索增強生成（RAG）模式至關重要。 -![圖示：向量數據庫架構，展示嵌入如何存儲和檢索以進行相似性搜索。](../../../translated_images/hk/vector.f12f114934e223df.webp) +![圖示：向量數據庫架構，展示嵌入如何存儲和檢索以進行相似性搜索。](../../../translated_images/zh-HK/vector.f12f114934e223df.webp) > **注意**：本課程不會涵蓋向量數據庫，但它們在實際應用中非常常見，因此值得一提。 @@ -93,7 +84,7 @@ CO_OP_TRANSLATOR_METADATA: 在 Java AI 應用中，你將使用 tokens 進行文本處理，嵌入進行語義搜索和 RAG，向量數據庫進行數據檢索，以及代理與 MCP 建立智能工具使用系統。 -![圖示：提示如何轉化為回應——tokens、向量、可選的 RAG 查詢、LLM 思考以及 MCP 代理在一個快速流程中的作用。](../../../translated_images/hk/flow.f4ef62c3052d12a8.webp) +![圖示：提示如何轉化為回應——tokens、向量、可選的 RAG 查詢、LLM 思考以及 MCP 代理在一個快速流程中的作用。](../../../translated_images/zh-HK/flow.f4ef62c3052d12a8.webp) ### Java 的 AI 開發工具和庫 diff --git a/translations/zh-HK/02-SetupDevEnvironment/README.md b/translations/zh-HK/02-SetupDevEnvironment/README.md new file mode 100644 index 00000000..b33f6f6d --- /dev/null +++ b/translations/zh-HK/02-SetupDevEnvironment/README.md @@ -0,0 +1,253 @@ +# 針對 Java 的生成式 AI 設置開發環境 + +> **快速開始**：在雲端 2 分鐘即可編碼 - 跳至 [GitHub Codespaces 設置](../../../02-SetupDevEnvironment) - 無需本地安裝，並使用 github 模型！ + +> **有興趣使用 Azure OpenAI？**，請參見我們的 [Azure OpenAI 設置指南](getting-started-azure-openai.md) ，內含建立新的 Azure OpenAI 資源的步驟。 + +## 你將學到什麼 + +- 設置 AI 應用的 Java 開發環境 +- 選擇及配置你偏好的開發環境（優先使用 Codespaces 雲端、當地開發容器或完整本地設置） +- 透過連接 GitHub 模型來測試你的設置 + +## 目錄 + +- [你將學到什麼](../../../02-SetupDevEnvironment) +- [介紹](../../../02-SetupDevEnvironment) +- [步驟 1：設置你的開發環境](../../../02-SetupDevEnvironment) + - [選項 A：GitHub Codespaces（推薦）](../../../02-SetupDevEnvironment) + - [選項 B：本地開發容器](../../../02-SetupDevEnvironment) + - [選項 C：使用你現有的本地安裝](../../../02-SetupDevEnvironment) +- [步驟 2：建立 GitHub 個人存取權杖](../../../02-SetupDevEnvironment) +- [步驟 3：用 GitHub 模型範例測試你的設定](../../../02-SetupDevEnvironment) +- [疑難排解](../../../02-SetupDevEnvironment) +- [總結](../../../02-SetupDevEnvironment) +- [下一步](../../../02-SetupDevEnvironment) + +## 介紹 + +本章將引導你設置開發環境。我們將以 **GitHub 模型** 作為主要範例，因為它免費，只需一個 GitHub 帳戶即可輕鬆設置，無需信用卡，並提供多種模型供您實驗。 + +**無需本地安裝！** 你可以立即使用 GitHub Codespaces 在瀏覽器中開始編碼，該服務提供完整的開發環境。 + +Screenshot: GitHub Models + +本課程推薦使用 [**GitHub 模型**](https://github.com/marketplace?type=models) ，因為它： +- **免費** 起步 +- 只需 GitHub 帳戶即可 **輕鬆** 設置 +- **無需信用卡** +- 提供多個模型供實驗 + +> **注意**：本課程所使用的 GitHub 模型有以下免費限制： +> - 每分鐘 15 次請求（每天 150 次） +> - 每次請求約輸入 8,000 字，輸出約 4,000 字 +> - 5 個併發請求 +> +> 若用於生產環境，請使用你的 Azure 帳戶升級到 Azure AI Foundry 模型。你的程式碼不需更改。詳見 [Azure AI Foundry 文件](https://learn.microsoft.com/azure/ai-foundry/foundry-models/how-to/quickstart-github-models)。 + + +## 步驟 1：設置你的開發環境 + + + +我們已建立一個預配置的開發容器，以將設定時間降至最低，並確保你擁有此生成式 AI for Java 課程所需的所有工具。請選擇你偏好的開發方式： + +### 環境設置選項： + +#### 選項 A：GitHub Codespaces（推薦） + +**2 分鐘開始編碼 - 無需本地安裝！** + +1. 將此儲存庫分叉到你的 GitHub 帳戶 + > **注意**：如果你想修改基本配置，請查看 [Dev Container 配置](../../../.devcontainer/devcontainer.json) +2. 點擊 **Code** → **Codespaces** 分頁 → **...** → **New with options...** +3. 使用預設設定 — 這會選擇為本課程建立的 **Dev container 配置**：**生成式 AI Java 開發環境** 客製 devcontainer +4. 點擊 **Create codespace** +5. 等待約 2 分鐘，環境即準備完成 +6. 繼續進行 [步驟 2：建立 GitHub 權杖](../../../02-SetupDevEnvironment) + +Screenshot: Codespaces submenu + +Screenshot: New with options + +Screenshot: Create codespace options + +> **Codespaces 的優點**： +> - 無需本地安裝 +> - 支援任何有瀏覽器的裝置 +> - 預先配置所有工具與依賴 +> - 個人帳戶每月免費 60 小時 +> - 為所有學習者提供一致的環境 + +#### 選項 B：本地開發容器 + +**適合偏好使用 Docker 本地開發的開發者** + +1. 將此儲存庫分叉並克隆到本地機器 + > **注意**：如果你想修改基本配置，請查看 [Dev Container 配置](../../../.devcontainer/devcontainer.json) +2. 安裝 [Docker Desktop](https://www.docker.com/products/docker-desktop/) 與 [VS Code](https://code.visualstudio.com/) +3. 在 VS Code 裝置 [Dev Containers 擴充](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers) +4. 在 VS Code 開啟儲存庫資料夾 +5. 當被提示時，點選 **Reopen in Container**（或使用 `Ctrl+Shift+P` → "Dev Containers: Reopen in Container"） +6. 等待容器完成建置並啟動 +7. 繼續進行 [步驟 2：建立 GitHub 權杖](../../../02-SetupDevEnvironment) + +Screenshot: Dev container setup + +Screenshot: Dev container build complete + +#### 選項 C：使用你現有的本地安裝 + +**適合已有 Java 環境的開發者** + +先決條件： +- [Java 21+](https://www.oracle.com/java/technologies/javase/jdk21-archive-downloads.html) +- [Maven 3.9+](https://maven.apache.org/download.cgi) +- [VS Code](https://code.visualstudio.com) 或你喜歡的 IDE + +步驟： +1. 克隆此儲存庫到本地機器 +2. 在 IDE 中開啟專案 +3. 繼續進行 [步驟 2：建立 GitHub 權杖](../../../02-SetupDevEnvironment) + +> **專家提示**：如果你的機器規格偏低但想使用 VS Code 本地版本，請使用 GitHub Codespaces！你可以將本地的 VS Code 連接到雲端託管的 Codespace，兩者兼得。 + +Screenshot: created local devcontainer instance + + +## 步驟 2：建立 GitHub 個人存取權杖 + +1. 前往 [GitHub 設定](https://github.com/settings/profile)，並從你的個人選單選擇 **Settings**。 +2. 在左側邊欄點擊 **Developer settings**（通常在靠下的位置）。 +3. 在 **Personal access tokens** 下，點選 **Fine-grained tokens**（或使用此直接 [連結](https://github.com/settings/personal-access-tokens)）。 +4. 點擊 **Generate new token**。 +5. 在「Token name」欄輸入描述性名稱（例如 `GenAI-Java-Course-Token`）。 +6. 設定過期時間（建議：7 天以符合安全最佳實踐）。 +7. 在「Resource owner」選擇你的使用者帳戶。 +8. 在「Repository access」選擇想用於 GitHub 模型的儲存庫（或全部儲存庫）。 +9. 在「Account permissions」找到 **Models**，設為 **Read-only**。 +10. 點擊 **Generate token**。 +11. **立即複製並保存你的權杖** — 之後無法再見到！ + +> **安全提示**：為你的存取權杖使用最低所需範圍，以及最短實用期限。 + +## 步驟 3：用 GitHub 模型範例測試你的設定 + +當你的開發環境就緒後，讓我們用位於 [`02-SetupDevEnvironment/examples/github-models`](../../../02-SetupDevEnvironment/examples/github-models) 的範例應用來測試 GitHub 模型整合。 + +1. 在你的開發環境中打開終端機。 +2. 切換到 GitHub 模型範例目錄： + ```bash + cd 02-SetupDevEnvironment/examples/github-models + ``` +3. 設定你的 GitHub 權杖為環境變數： + ```bash + # macOS/Linux + export GITHUB_TOKEN=your_token_here + + # Windows（命令提示字元） + set GITHUB_TOKEN=your_token_here + + # Windows（PowerShell） + $env:GITHUB_TOKEN="your_token_here" + ``` + +4. 執行應用： + ```bash + mvn compile exec:java -Dexec.mainClass="com.example.githubmodels.App" + ``` + +你應該會看到類似以下的輸出： +```text +Using model: gpt-4.1-nano +Sending request to GitHub Models... +Response: Hello World! +``` + +### 理解範例程式碼 + +首先，我們了解剛執行的程式碼。`examples/github-models` 中的範例使用 OpenAI Java SDK 連接 GitHub 模型： + +**此程式碼的功能：** +- **連接** 使用你的個人存取權杖的 GitHub 模型 +- **傳送** 簡單的 “Say Hello World!” 訊息給 AI 模型 +- **接收** 並顯示 AI 的回應 +- **驗證** 你的設定是否正常運作 + +**主要依賴**（在 `pom.xml` 中）： +```xml + + com.openai + openai-java + 2.12.0 + +``` + +**主要程式碼** (`App.java`)： +```java +// 使用 OpenAI Java SDK 連接到 GitHub 模型 +OpenAIClient client = OpenAIOkHttpClient.builder() + .apiKey(pat) + .baseUrl("https://models.inference.ai.azure.com") + .build(); + +// 創建聊天完成請求 +ChatCompletionCreateParams params = ChatCompletionCreateParams.builder() + .model(modelId) + .addSystemMessage("You are a concise assistant.") + .addUserMessage("Say Hello World!") + .build(); + +// 獲取 AI 回應 +ChatCompletion response = client.chat().completions().create(params); +System.out.println("Response: " + response.choices().get(0).message().content().orElse("No response content")); +``` + +## 總結 + +太好了！你現在已完成設定： + +- 建立具備 AI 模型存取權限的 GitHub 個人存取權杖 +- 讓你的 Java 開發環境運行（無論是 Codespaces、開發容器還是本地） +- 使用 OpenAI Java SDK 連接 GitHub 模型，實現免費 AI 開發 +- 用簡單範例測試一切運作正常，與 AI 模型對話 + +## 下一步 + +[第 3 章：核心生成式 AI 技術](../03-CoreGenerativeAITechniques/README.md) + +## 疑難排解 + +遇到問題？這裡是常見問題與解決方案： + +- **權杖無效？** + - 確認你已完整複製權杖，無多餘空格 + - 驗證權杖已正確設為環境變數 + - 檢查權杖權限是否正確（Models：唯讀） + +- **找不到 Maven？** + - 使用開發容器或 Codespaces，Maven 應預裝 + - 本地設置確保安裝 Java 21+ 和 Maven 3.9+ + - 執行 `mvn --version` 檢查是否安裝正確 + +- **連線問題？** + - 檢查網際網路連線 + - 驗證能否從網路連至 GitHub + - 確認沒有防火牆阻擋 GitHub 模型端點 + +- **開發容器無法啟動？** + - 確保 Docker Desktop 正在運行（本地開發） + - 嘗試重建容器：`Ctrl+Shift+P` → "Dev Containers: Rebuild Container" + +- **應用編譯錯誤？** + - 確保你在正確目錄：`02-SetupDevEnvironment/examples/github-models` + - 嘗試清理並重建：`mvn clean compile` + +> **需要幫助？**：仍有問題？請在儲存庫開啟 Issues，我們會協助你解決。 + +--- + + +**免責聲明**： +本文件是使用 AI 翻譯服務 [Co-op Translator](https://github.com/Azure/co-op-translator) 進行翻譯。儘管我們致力於確保準確性，但請注意，自動翻譯可能包含錯誤或不準確之處。原始語言文件應被視為權威來源。對於重要資訊，建議採用專業人工翻譯。我們不對因使用本翻譯而引起的任何誤解或誤譯承擔責任。 + \ No newline at end of file diff --git a/translations/hk/02-SetupDevEnvironment/examples/basic-chat-azure/README.md b/translations/zh-HK/02-SetupDevEnvironment/examples/basic-chat-azure/README.md similarity index 96% rename from translations/hk/02-SetupDevEnvironment/examples/basic-chat-azure/README.md rename to translations/zh-HK/02-SetupDevEnvironment/examples/basic-chat-azure/README.md index a77539a4..2d3ab64e 100644 --- a/translations/hk/02-SetupDevEnvironment/examples/basic-chat-azure/README.md +++ b/translations/zh-HK/02-SetupDevEnvironment/examples/basic-chat-azure/README.md @@ -1,12 +1,3 @@ - # 使用 Azure OpenAI 的基本聊天範例 - 端到端示例 此範例展示如何建立一個簡單的 Spring Boot 應用程式，連接到 Azure OpenAI 並測試您的設置。 diff --git a/translations/hk/02-SetupDevEnvironment/getting-started-azure-openai.md b/translations/zh-HK/02-SetupDevEnvironment/getting-started-azure-openai.md similarity index 94% rename from translations/hk/02-SetupDevEnvironment/getting-started-azure-openai.md rename to translations/zh-HK/02-SetupDevEnvironment/getting-started-azure-openai.md index bcbbba3a..3a84ff1d 100644 --- a/translations/hk/02-SetupDevEnvironment/getting-started-azure-openai.md +++ b/translations/zh-HK/02-SetupDevEnvironment/getting-started-azure-openai.md @@ -1,12 +1,3 @@ - # 設置 Azure OpenAI 的開發環境 > **快速開始**：本指南適用於 Azure OpenAI 的設置。如果想快速使用免費模型，請參考 [GitHub Models with Codespaces](./README.md#quick-start-cloud)。 @@ -75,7 +66,7 @@ CO_OP_TRANSLATOR_METADATA: > **注意**：如果你想編輯基本配置，請查看 [Dev Container Configuration](../../../.devcontainer/devcontainer.json) 2. 在你的 Fork 倉庫中，點擊 **Code** → **Codespaces** 標籤 3. 點擊 **...** → **New with options...** -![創建帶選項的 Codespace](../../../translated_images/hk/codespaces.9945ded8ceb431a5.webp) +![創建帶選項的 Codespace](../../../translated_images/zh-HK/codespaces.9945ded8ceb431a5.webp) 4. 選擇 **Dev container configuration**： - **Generative AI Java Development Environment** 5. 點擊 **Create codespace** diff --git a/translations/hk/03-CoreGenerativeAITechniques/README.md b/translations/zh-HK/03-CoreGenerativeAITechniques/README.md similarity index 98% rename from translations/hk/03-CoreGenerativeAITechniques/README.md rename to translations/zh-HK/03-CoreGenerativeAITechniques/README.md index c38ac7d3..52d036e0 100644 --- a/translations/hk/03-CoreGenerativeAITechniques/README.md +++ b/translations/zh-HK/03-CoreGenerativeAITechniques/README.md @@ -1,12 +1,3 @@ - # 核心生成式 AI 技術教學 ## 目錄 diff --git a/translations/hk/04-PracticalSamples/README.md b/translations/zh-HK/04-PracticalSamples/README.md similarity index 93% rename from translations/hk/04-PracticalSamples/README.md rename to translations/zh-HK/04-PracticalSamples/README.md index 687ddd18..d3ad8d90 100644 --- a/translations/hk/04-PracticalSamples/README.md +++ b/translations/zh-HK/04-PracticalSamples/README.md @@ -1,12 +1,3 @@ - # 實用應用與項目 ## 你將學到什麼 diff --git a/translations/hk/04-PracticalSamples/calculator/README.md b/translations/zh-HK/04-PracticalSamples/calculator/README.md similarity index 97% rename from translations/hk/04-PracticalSamples/calculator/README.md rename to translations/zh-HK/04-PracticalSamples/calculator/README.md index a0294a31..41462902 100644 --- a/translations/hk/04-PracticalSamples/calculator/README.md +++ b/translations/zh-HK/04-PracticalSamples/calculator/README.md @@ -1,12 +1,3 @@ - # MCP 計算器初學者教程 ## 目錄 diff --git a/translations/hk/04-PracticalSamples/foundrylocal/README.md b/translations/zh-HK/04-PracticalSamples/foundrylocal/README.md similarity index 98% rename from translations/hk/04-PracticalSamples/foundrylocal/README.md rename to translations/zh-HK/04-PracticalSamples/foundrylocal/README.md index 6cfc451d..cf1c02be 100644 --- a/translations/hk/04-PracticalSamples/foundrylocal/README.md +++ b/translations/zh-HK/04-PracticalSamples/foundrylocal/README.md @@ -1,12 +1,3 @@ - # Foundry Local Spring Boot 教學 ## 目錄 diff --git a/translations/hk/04-PracticalSamples/petstory/README.md b/translations/zh-HK/04-PracticalSamples/petstory/README.md similarity index 98% rename from translations/hk/04-PracticalSamples/petstory/README.md rename to translations/zh-HK/04-PracticalSamples/petstory/README.md index e7715890..4bd99df6 100644 --- a/translations/hk/04-PracticalSamples/petstory/README.md +++ b/translations/zh-HK/04-PracticalSamples/petstory/README.md @@ -1,12 +1,3 @@ - # 寵物故事生成器初學者教程 ## 目錄 diff --git a/translations/hk/05-ResponsibleGenAI/README.md b/translations/zh-HK/05-ResponsibleGenAI/README.md similarity index 96% rename from translations/hk/05-ResponsibleGenAI/README.md rename to translations/zh-HK/05-ResponsibleGenAI/README.md index ff44cd91..408e8964 100644 --- a/translations/hk/05-ResponsibleGenAI/README.md +++ b/translations/zh-HK/05-ResponsibleGenAI/README.md @@ -1,12 +1,3 @@ - # 負責任的生成式人工智能 ## 學習內容 @@ -58,7 +49,7 @@ GitHub Models 提供基本的內容過濾功能，就像人工智能俱樂部裡 5. 顯示結果，展示哪些內容被阻擋、拒絕或允許 6. 測試安全內容以作比較 -![負責任的人工智能安全示範](../../../translated_images/hk/responsible.e4f51a917bafa4bf.webp) +![負責任的人工智能安全示範](../../../translated_images/zh-HK/responsible.e4f51a917bafa4bf.webp) ### 設置指引 @@ -164,7 +155,7 @@ Status: Response generated successfully 恭喜您完成生成式人工智能初學者課程！ -![課程完成](../../../translated_images/hk/image.73c7e2ff4a652e77.webp) +![課程完成](../../../translated_images/zh-HK/image.73c7e2ff4a652e77.webp) **您已完成的內容：** - 設置您的開發環境 diff --git a/translations/hk/AGENTS.md b/translations/zh-HK/AGENTS.md similarity index 97% rename from translations/hk/AGENTS.md rename to translations/zh-HK/AGENTS.md index 5dfebe90..c53a9e05 100644 --- a/translations/hk/AGENTS.md +++ b/translations/zh-HK/AGENTS.md @@ -1,12 +1,3 @@ - # AGENTS.md ## 專案概述 diff --git a/translations/hk/CODE_OF_CONDUCT.md b/translations/zh-HK/CODE_OF_CONDUCT.md similarity index 80% rename from translations/hk/CODE_OF_CONDUCT.md rename to translations/zh-HK/CODE_OF_CONDUCT.md index 038cf020..48735d88 100644 --- a/translations/hk/CODE_OF_CONDUCT.md +++ b/translations/zh-HK/CODE_OF_CONDUCT.md @@ -1,12 +1,3 @@ - # Microsoft 開源行為準則 此項目已採用 [Microsoft 開源行為準則](https://opensource.microsoft.com/codeofconduct/)。 diff --git a/translations/zh-HK/README.md b/translations/zh-HK/README.md new file mode 100644 index 00000000..04a0155a --- /dev/null +++ b/translations/zh-HK/README.md @@ -0,0 +1,138 @@ +# Generative AI for Beginners - Java 版本 +[![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) + +![Generative AI for Beginners - Java 版本](../../translated_images/zh-HK/beg-genai-series.8b48be9951cc574c.webp) + +**時間投入**：整個工作坊可在線上完成，無需本地設置。環境設置約需 2 分鐘，探索示例視探索深度需時 1-3 小時。 + +> **快速開始** + +1. 將本倉庫派生至你的 GitHub 帳戶 +2. 點擊 **Code** → **Codespaces** 標籤 → **...** → **New with options...** +3. 使用預設選項 – 這將選擇為本課程建立的開發容器 +4. 點擊 **Create codespace** +5. 等待約 2 分鐘直到環境準備就緒 +6. 直接前往 [第一個示例](./02-SetupDevEnvironment/README.md#step-2-create-a-github-personal-access-token) + +> **偏好本地複製？** +> +> 本倉庫包含 50 多種語言翻譯，會顯著增加下載大小。如需複製而不包含翻譯，請使用稀疏結帳： +> ```bash +> git clone --filter=blob:none --sparse https://github.com/microsoft/Generative-AI-for-beginners-java.git +> cd Generative-AI-for-beginners-java +> git sparse-checkout set --no-cone '/*' '!translations' '!translated_images' +> ``` +> 這會讓你獲得完成課程所需的所有內容，且下載速度更快。 + +## 多語言支援 + +### 透過 GitHub Action 支援（自動且隨時更新） + + +[阿拉伯文](../ar/README.md) | [孟加拉文](../bn/README.md) | [保加利亞文](../bg/README.md) | [緬甸文](../my/README.md) | [中文（簡體）](../zh-CN/README.md) | [中文（繁體，香港）](./README.md) | [中文（繁體，澳門）](../zh-MO/README.md) | [中文（繁體，臺灣）](../zh-TW/README.md) | [克羅地亞文](../hr/README.md) | [捷克文](../cs/README.md) | [丹麥文](../da/README.md) | [荷蘭文](../nl/README.md) | [愛沙尼亞文](../et/README.md) | [芬蘭文](../fi/README.md) | [法文](../fr/README.md) | [德文](../de/README.md) | [希臘文](../el/README.md) | [希伯來文](../he/README.md) | [印地文](../hi/README.md) | [匈牙利文](../hu/README.md) | [印尼文](../id/README.md) | [義大利文](../it/README.md) | [日文](../ja/README.md) | [坎納達文](../kn/README.md) | [韓文](../ko/README.md) | [立陶宛文](../lt/README.md) | [馬來文](../ms/README.md) | [馬拉雅拉姆文](../ml/README.md) | [馬拉地文](../mr/README.md) | [尼泊爾文](../ne/README.md) | [奈及利亞皮欽語](../pcm/README.md) | [挪威文](../no/README.md) | [波斯文（法爾西文）](../fa/README.md) | [波蘭文](../pl/README.md) | [葡萄牙文（巴西）](../pt-BR/README.md) | [葡萄牙文（葡萄牙）](../pt-PT/README.md) | [旁遮普文（古魯穆奇字）](../pa/README.md) | [羅馬尼亞文](../ro/README.md) | [俄文](../ru/README.md) | [塞爾維亞文（西里爾字母）](../sr/README.md) | [斯洛伐克文](../sk/README.md) | [斯洛文尼亞文](../sl/README.md) | [西班牙文](../es/README.md) | [斯瓦希里文](../sw/README.md) | [瑞典文](../sv/README.md) | [他加祿文（菲律賓語）](../tl/README.md) | [泰米爾文](../ta/README.md) | [泰盧固文](../te/README.md) | [泰文](../th/README.md) | [土耳其文](../tr/README.md) | [烏克蘭文](../uk/README.md) | [烏爾都文](../ur/README.md) | [越南文](../vi/README.md) + +> **偏好本地複製？** + +> 本倉庫包含 50 多種語言翻譯，會顯著增加下載大小。如需複製而不包含翻譯，請使用稀疏結帳： +> ```bash +> git clone --filter=blob:none --sparse https://github.com/microsoft/Generative-AI-for-beginners-java.git +> cd Generative-AI-for-beginners-java +> git sparse-checkout set --no-cone '/*' '!translations' '!translated_images' +> ``` +> 這會讓你獲得完成課程所需的所有內容，且下載速度更快。 + + +## 課程結構與學習路徑 + +### **第一章：生成式 AI 簡介** +- **核心概念**：了解大型語言模型、代幣、嵌入及 AI 能力 +- **Java AI 生態系統**：Spring AI 和 OpenAI SDK 概覽 +- **模型上下文協議**：MCP 介紹及其在 AI 代理通訊中的作用 +- **實用應用**：實務場景，包括聊天機器人與內容生成 +- **[→ 開始第一章](./01-IntroToGenAI/README.md)** + +### **第二章：開發環境設置** +- **多服務供應商配置**：設置 GitHub Models、Azure OpenAI 及 OpenAI Java SDK 整合 +- **Spring Boot + Spring AI**：企業級 AI 應用開發最佳實踐 +- **GitHub Models**：免費 AI 模型存取，適用於原型製作與學習（無需信用卡） +- **開發工具**：Docker 容器、VS Code 及 GitHub Codespaces 配置 +- **[→ 開始第二章](./02-SetupDevEnvironment/README.md)** + +### **第三章：核心生成式 AI 技巧** +- **Prompt Engineering**：最佳 AI 模型回應的方法 +- **嵌入與向量運算**：實現語意搜尋與相似匹配 +- **檢索增強生成 (RAG)**：結合 AI 與你自己的資料來源 +- **函數呼叫**：利用自訂工具和插件擴展 AI 能力 +- **[→ 開始第三章](./03-CoreGenerativeAITechniques/README.md)** + +### **第四章：實務應用與專案** +- **寵物故事生成器** (`petstory/`)：使用 GitHub Models 進行創意內容生成 +- **Foundry 本地示範** (`foundrylocal/`)：OpenAI Java SDK 的本地 AI 模型整合 +- **MCP 計算器服務** (`calculator/`)：使用 Spring AI 實現基本模型上下文協議 +- **[→ 開始第四章](./04-PracticalSamples/README.md)** + +### **第五章：負責任的 AI 開發** +- **GitHub Models 安全性**：測試內建內容過濾與安全機制（硬阻擋與軟拒絕） +- **負責任 AI 示範**：實作範例展示現代 AI 安全系統如何運作 +- **最佳實踐**：倫理 AI 開發與部署的重要指引 +- **[→ 開始第五章](./05-ResponsibleGenAI/README.md)** + +## 額外資源 + + +### LangChain +[![LangChain4j 初學者](https://img.shields.io/badge/LangChain4j%20for%20Beginners-22C55E?style=for-the-badge&&labelColor=E5E7EB&color=0553D6)](https://aka.ms/langchain4j-for-beginners) +[![LangChain.js 初學者](https://img.shields.io/badge/LangChain.js%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=0553D6)](https://aka.ms/langchainjs-for-beginners?WT.mc_id=m365-94501-dwahlin) + +--- + +### Azure / Edge / MCP / Agents +[![AZD 初學者](https://img.shields.io/badge/AZD%20for%20Beginners-0078D4?style=for-the-badge&labelColor=E5E7EB&color=0078D4)](https://github.com/microsoft/AZD-for-beginners?WT.mc_id=academic-105485-koreyst) +[![Edge AI 初學者](https://img.shields.io/badge/Edge%20AI%20for%20Beginners-00B8E4?style=for-the-badge&labelColor=E5E7EB&color=00B8E4)](https://github.com/microsoft/edgeai-for-beginners?WT.mc_id=academic-105485-koreyst) +[![MCP 初學者](https://img.shields.io/badge/MCP%20for%20Beginners-009688?style=for-the-badge&labelColor=E5E7EB&color=009688)](https://github.com/microsoft/mcp-for-beginners?WT.mc_id=academic-105485-koreyst) +[![AI Agents 初學者](https://img.shields.io/badge/AI%20Agents%20for%20Beginners-00C49A?style=for-the-badge&labelColor=E5E7EB&color=00C49A)](https://github.com/microsoft/ai-agents-for-beginners?WT.mc_id=academic-105485-koreyst) + +--- + +### 生成式 AI 系列 +[![生成式 AI 初學者](https://img.shields.io/badge/Generative%20AI%20for%20Beginners-8B5CF6?style=for-the-badge&labelColor=E5E7EB&color=8B5CF6)](https://github.com/microsoft/generative-ai-for-beginners?WT.mc_id=academic-105485-koreyst) +[![生成式 AI (.NET)](https://img.shields.io/badge/Generative%20AI%20(.NET)-9333EA?style=for-the-badge&labelColor=E5E7EB&color=9333EA)](https://github.com/microsoft/Generative-AI-for-beginners-dotnet?WT.mc_id=academic-105485-koreyst) +[![生成式 AI (Java)](https://img.shields.io/badge/Generative%20AI%20(Java)-C084FC?style=for-the-badge&labelColor=E5E7EB&color=C084FC)](https://github.com/microsoft/generative-ai-for-beginners-java?WT.mc_id=academic-105485-koreyst) +[![生成式 AI (JavaScript)](https://img.shields.io/badge/Generative%20AI%20(JavaScript)-E879F9?style=for-the-badge&labelColor=E5E7EB&color=E879F9)](https://github.com/microsoft/generative-ai-with-javascript?WT.mc_id=academic-105485-koreyst) + +--- + +### 核心學習 +[![ML 初學者](https://img.shields.io/badge/ML%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=22C55E)](https://aka.ms/ml-beginners?WT.mc_id=academic-105485-koreyst) +[![數據科學初學者](https://img.shields.io/badge/Data%20Science%20for%20Beginners-84CC16?style=for-the-badge&labelColor=E5E7EB&color=84CC16)](https://aka.ms/datascience-beginners?WT.mc_id=academic-105485-koreyst) +[![AI 初學者](https://img.shields.io/badge/AI%20for%20Beginners-A3E635?style=for-the-badge&labelColor=E5E7EB&color=A3E635)](https://aka.ms/ai-beginners?WT.mc_id=academic-105485-koreyst) +[![網絡安全初學者](https://img.shields.io/badge/Cybersecurity%20for%20Beginners-F97316?style=for-the-badge&labelColor=E5E7EB&color=F97316)](https://github.com/microsoft/Security-101?WT.mc_id=academic-96948-sayoung) + +[![Web Dev for Beginners](https://img.shields.io/badge/Web%20Dev%20for%20Beginners-EC4899?style=for-the-badge&labelColor=E5E7EB&color=EC4899)](https://aka.ms/webdev-beginners?WT.mc_id=academic-105485-koreyst) +[![IoT for Beginners](https://img.shields.io/badge/IoT%20for%20Beginners-14B8A6?style=for-the-badge&labelColor=E5E7EB&color=14B8A6)](https://aka.ms/iot-beginners?WT.mc_id=academic-105485-koreyst) +[![XR Development for Beginners](https://img.shields.io/badge/XR%20Development%20for%20Beginners-38BDF8?style=for-the-badge&labelColor=E5E7EB&color=38BDF8)](https://github.com/microsoft/xr-development-for-beginners?WT.mc_id=academic-105485-koreyst) + +--- + +### Copilot Series +[![Copilot for AI Paired Programming](https://img.shields.io/badge/Copilot%20for%20AI%20Paired%20Programming-FACC15?style=for-the-badge&labelColor=E5E7EB&color=FACC15)](https://aka.ms/GitHubCopilotAI?WT.mc_id=academic-105485-koreyst) +[![Copilot for C#/.NET](https://img.shields.io/badge/Copilot%20for%20C%23/.NET-FBBF24?style=for-the-badge&labelColor=E5E7EB&color=FBBF24)](https://github.com/microsoft/mastering-github-copilot-for-dotnet-csharp-developers?WT.mc_id=academic-105485-koreyst) +[![Copilot Adventure](https://img.shields.io/badge/Copilot%20Adventure-FDE68A?style=for-the-badge&labelColor=E5E7EB&color=FDE68A)](https://github.com/microsoft/CopilotAdventures?WT.mc_id=academic-105485-koreyst) + + +## 獲取幫助 + +如果你在建立 AI 應用時遇到困難或有任何問題，歡迎加入其他學習者及有經驗的開發者，一起參與 MCP 討論。這是一個支持性的社群，歡迎提問並自由分享知識。 + +[![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) + +如果您在開發過程中有產品反饋或錯誤，請造訪： + +[![Microsoft Foundry Developer Forum](https://img.shields.io/badge/GitHub-Microsoft_Foundry_Developer_Forum-blue?style=for-the-badge&logo=github&color=000000&logoColor=fff)](https://aka.ms/foundry/forum) + +--- + + +**免責聲明**： +本文件乃使用 AI 翻譯服務 [Co-op Translator](https://github.com/Azure/co-op-translator) 翻譯而成。雖然我們致力於提供準確的翻譯，但請注意自動翻譯可能包含錯誤或不準確之處。原始語言文件應視為權威來源。對於重要資訊，建議採用專業人工翻譯。我們不對因使用此翻譯而引起的任何誤解或誤釋負責。 + \ No newline at end of file diff --git a/translations/hk/SECURITY.md b/translations/zh-HK/SECURITY.md similarity index 93% rename from translations/hk/SECURITY.md rename to translations/zh-HK/SECURITY.md index 6d2e0153..ab06ee2f 100644 --- a/translations/hk/SECURITY.md +++ b/translations/zh-HK/SECURITY.md @@ -1,12 +1,3 @@ - ## 安全性 Microsoft 非常重視我們軟件產品和服務的安全性，包括所有透過我們 GitHub 組織管理的原始碼庫，這些組織包括 [Microsoft](https://github.com/Microsoft)、[Azure](https://github.com/Azure)、[DotNet](https://github.com/dotnet)、[AspNet](https://github.com/aspnet) 和 [Xamarin](https://github.com/xamarin)。 diff --git a/translations/hk/SUPPORT.md b/translations/zh-HK/SUPPORT.md similarity index 80% rename from translations/hk/SUPPORT.md rename to translations/zh-HK/SUPPORT.md index 94ce782f..ddbaf823 100644 --- a/translations/hk/SUPPORT.md +++ b/translations/zh-HK/SUPPORT.md @@ -1,12 +1,3 @@ - # 支援 ## 如何提交問題及獲取幫助 diff --git a/translations/zh-MO/.co-op-translator.json b/translations/zh-MO/.co-op-translator.json new file mode 100644 index 00000000..1c4287ff --- /dev/null +++ b/translations/zh-MO/.co-op-translator.json @@ -0,0 +1,92 @@ +{ + "01-IntroToGenAI/README.md": { + "original_hash": "75bfb080ca725e8a9aa9c80cae25fba1", + "translation_date": "2025-07-29T08:22:31+00:00", + "source_file": "01-IntroToGenAI/README.md", + "language_code": "zh-MO" + }, + "02-SetupDevEnvironment/README.md": { + "original_hash": "96a30d42b9751a3d4e4b20e28d29d459", + "translation_date": "2026-01-28T04:43:25+00:00", + "source_file": "02-SetupDevEnvironment/README.md", + "language_code": "zh-MO" + }, + "02-SetupDevEnvironment/examples/basic-chat-azure/README.md": { + "original_hash": "efd82efe50711d7e257eb943151d682c", + "translation_date": "2025-07-27T13:35:25+00:00", + "source_file": "02-SetupDevEnvironment/examples/basic-chat-azure/README.md", + "language_code": "zh-MO" + }, + "02-SetupDevEnvironment/getting-started-azure-openai.md": { + "original_hash": "bfdb4b4eadbee3a59ef742439f58326a", + "translation_date": "2025-07-27T12:55:36+00:00", + "source_file": "02-SetupDevEnvironment/getting-started-azure-openai.md", + "language_code": "zh-MO" + }, + "03-CoreGenerativeAITechniques/README.md": { + "original_hash": "685f55cb07de19b52a30ce6e8b6d889e", + "translation_date": "2025-08-28T21:57:15+00:00", + "source_file": "03-CoreGenerativeAITechniques/README.md", + "language_code": "zh-MO" + }, + "04-PracticalSamples/README.md": { + "original_hash": "14c0a61ecc1cd2012a9c129236dfdf71", + "translation_date": "2025-07-29T08:22:16+00:00", + "source_file": "04-PracticalSamples/README.md", + "language_code": "zh-MO" + }, + "04-PracticalSamples/calculator/README.md": { + "original_hash": "b6c16b5514d524e415a94f6097ee7d4c", + "translation_date": "2025-09-18T15:25:51+00:00", + "source_file": "04-PracticalSamples/calculator/README.md", + "language_code": "zh-MO" + }, + "04-PracticalSamples/foundrylocal/README.md": { + "original_hash": "f787307400de59adc25a1404466a35f3", + "translation_date": "2025-11-04T07:16:12+00:00", + "source_file": "04-PracticalSamples/foundrylocal/README.md", + "language_code": "zh-MO" + }, + "04-PracticalSamples/petstory/README.md": { + "original_hash": "0cbf68d605615a1e602c832a24616859", + "translation_date": "2025-07-25T10:53:52+00:00", + "source_file": "04-PracticalSamples/petstory/README.md", + "language_code": "zh-MO" + }, + "05-ResponsibleGenAI/README.md": { + "original_hash": "301c05c2f57e60a6950b8c665b8bdbba", + "translation_date": "2025-07-29T15:43:21+00:00", + "source_file": "05-ResponsibleGenAI/README.md", + "language_code": "zh-MO" + }, + "AGENTS.md": { + "original_hash": "afc90918d008cf77fd1982691f681306", + "translation_date": "2025-10-03T08:28:53+00:00", + "source_file": "AGENTS.md", + "language_code": "zh-MO" + }, + "CODE_OF_CONDUCT.md": { + "original_hash": "442b123d034f92f7c384d2bbd28f99f1", + "translation_date": "2025-07-21T17:36:35+00:00", + "source_file": "CODE_OF_CONDUCT.md", + "language_code": "zh-MO" + }, + "README.md": { + "original_hash": "125a08948d881c95628094f4dd1fbd43", + "translation_date": "2026-01-29T15:26:00+00:00", + "source_file": "README.md", + "language_code": "zh-MO" + }, + "SECURITY.md": { + "original_hash": "57f14126c1c6add76b3aef3844dfe4e3", + "translation_date": "2025-07-21T17:34:35+00:00", + "source_file": "SECURITY.md", + "language_code": "zh-MO" + }, + "SUPPORT.md": { + "original_hash": "b8ef73cc49dec68e2c885ee9df545129", + "translation_date": "2025-07-21T17:37:38+00:00", + "source_file": "SUPPORT.md", + "language_code": "zh-MO" + } +} \ No newline at end of file diff --git a/translations/mo/01-IntroToGenAI/README.md b/translations/zh-MO/01-IntroToGenAI/README.md similarity index 95% rename from translations/mo/01-IntroToGenAI/README.md rename to translations/zh-MO/01-IntroToGenAI/README.md index b227d34c..a45dd262 100644 --- a/translations/mo/01-IntroToGenAI/README.md +++ b/translations/zh-MO/01-IntroToGenAI/README.md @@ -1,12 +1,3 @@ - # 生成式人工智慧入門 - Java 版 ## 你將學到什麼 @@ -44,7 +35,7 @@ CO_OP_TRANSLATOR_METADATA: 不同的模型針對不同的任務進行了優化。例如，**小型語言模型（SLMs）**和**大型語言模型（LLMs）**都可以處理文字生成，但 LLMs 通常在處理複雜任務時表現更佳。對於圖像相關的任務，你可能會使用專門的視覺模型或多模態模型。 -![圖示：生成式人工智慧模型類型及其應用場景。](../../../translated_images/mo/llms.225ca2b8a0d34473.webp) +![圖示：生成式人工智慧模型類型及其應用場景。](../../../translated_images/zh-MO/llms.225ca2b8a0d34473.webp) 當然，這些模型的回應並非總是完美的。你可能聽說過模型會「幻覺」（hallucinate），即以權威的方式生成錯誤資訊。不過，你可以透過提供清晰的指示和上下文來幫助模型生成更好的回應，這就是**提示工程**的作用。 @@ -79,13 +70,13 @@ CO_OP_TRANSLATOR_METADATA: - **嵌入**：嵌入是捕捉語義意義的 tokens 向量表示。它們是數值表示（通常是浮點數陣列），使模型能夠理解單詞之間的關係並生成語義相關的回應。相似的單詞具有相似的嵌入，這使得模型能夠理解同義詞和語義關係。 -![圖示：嵌入](../../../translated_images/mo/embedding.398e50802c0037f9.webp) +![圖示：嵌入](../../../translated_images/zh-MO/embedding.398e50802c0037f9.webp) 在 Java 中，你可以使用 OpenAI SDK 或其他支援嵌入生成的函式庫來生成嵌入。這些嵌入對於語義搜尋等任務至關重要，因為你希望根據意義而非精確文字匹配來找到相似內容。 - **向量資料庫**：向量資料庫是針對嵌入進行優化的專門儲存系統。它們支持高效的相似性搜尋，對於檢索增強生成（RAG）模式至關重要，該模式需要基於語義相似性而非精確匹配從大型資料集中找到相關資訊。 -![圖示：向量資料庫架構，展示如何儲存和檢索嵌入以進行相似性搜尋。](../../../translated_images/mo/vector.f12f114934e223df.webp) +![圖示：向量資料庫架構，展示如何儲存和檢索嵌入以進行相似性搜尋。](../../../translated_images/zh-MO/vector.f12f114934e223df.webp) > **注意**：本課程不會涵蓋向量資料庫，但認為它們值得一提，因為它們在實際應用中非常常見。 @@ -93,7 +84,7 @@ CO_OP_TRANSLATOR_METADATA: 在 Java 的 AI 應用程式中，你將使用 tokens 進行文字處理，使用嵌入進行語義搜尋和 RAG，使用向量資料庫進行資料檢索，並使用 MCP 的代理來構建智能工具使用系統。 -![圖示：從提示到回應的流程——tokens、向量、可選的 RAG 查詢、LLM 思考以及 MCP 代理的快速流程。](../../../translated_images/mo/flow.f4ef62c3052d12a8.webp) +![圖示：從提示到回應的流程——tokens、向量、可選的 RAG 查詢、LLM 思考以及 MCP 代理的快速流程。](../../../translated_images/zh-MO/flow.f4ef62c3052d12a8.webp) ### Java 的 AI 開發工具與函式庫 diff --git a/translations/zh-MO/02-SetupDevEnvironment/README.md b/translations/zh-MO/02-SetupDevEnvironment/README.md new file mode 100644 index 00000000..05463d0e --- /dev/null +++ b/translations/zh-MO/02-SetupDevEnvironment/README.md @@ -0,0 +1,252 @@ +# 為 Java 生成式 AI 設定開發環境 + +> **快速入門**：2 分鐘於雲端編寫程式碼 - 跳至 [GitHub Codespaces 設定](../../../02-SetupDevEnvironment) - 不需本地安裝並使用 github 模型！ + +> **對 Azure OpenAI 感興趣？**，請參閱我們的 [Azure OpenAI 設定指南](getting-started-azure-openai.md)，其中包含建立新的 Azure OpenAI 資源的步驟。 + +## 您將學習到什麼 + +- 建立用於 AI 應用程式的 Java 開發環境 +- 選擇並設定您偏好的開發環境（以 Codespaces 為主的雲端環境、本地開發容器或完整本地安裝） +- 透過連接 GitHub 模型來測試您的設定 + +## 目錄 + +- [您將學習到什麼](../../../02-SetupDevEnvironment) +- [簡介](../../../02-SetupDevEnvironment) +- [步驟 1：建立您的開發環境](../../../02-SetupDevEnvironment) + - [選項 A：GitHub Codespaces（推薦）](../../../02-SetupDevEnvironment) + - [選項 B：本地開發容器](../../../02-SetupDevEnvironment) + - [選項 C：使用您現有的本地安裝](../../../02-SetupDevEnvironment) +- [步驟 2：建立 GitHub 個人存取權杖](../../../02-SetupDevEnvironment) +- [步驟 3：使用 GitHub 模型範例測試您的設定](../../../02-SetupDevEnvironment) +- [疑難排解](../../../02-SetupDevEnvironment) +- [摘要](../../../02-SetupDevEnvironment) +- [下一步](../../../02-SetupDevEnvironment) + +## 簡介 + +本章將指導您完成開發環境的設定。我們將使用 **GitHub 模型** 作為主要範例，因為它是免費的，只需有一個 GitHub 帳戶即可輕易設定，不需信用卡，且可存取多種模型供試驗。 + +**不需本地安裝！** 您可以使用 GitHub Codespaces 立即開始編寫程式碼，該服務提供瀏覽器中的完整開發環境。 + +螢幕截圖：GitHub 模型 + +我們推薦在本課程使用 [**GitHub 模型**](https://github.com/marketplace?type=models)，因為它： +- **免費**起步 +- 只需一個 GitHub 帳戶即可 **輕鬆**設定 +- 不需要 **信用卡** +- 提供多種模型供試驗 + +> **注意**：此訓練中所用的 GitHub 模型有以下免費限制： +> - 每分鐘 15 次請求（每日 150 次） +> - 每次請求約輸入 8,000 字，輸出約 4,000 字 +> - 允許 5 個並行請求 +> +> 要用於生產環境，請使用您的 Azure 帳戶升級至 Azure AI Foundry 模型。您的程式碼不需更改。請參閱 [Azure AI Foundry 文件](https://learn.microsoft.com/azure/ai-foundry/foundry-models/how-to/quickstart-github-models)。 + +## 步驟 1：建立您的開發環境 + + + +我們已建立預配置的開發容器，能減少設定時間並確保您擁有本 Java 生成式 AI 課程需要的所有工具。請選擇您偏好的開發方式： + +### 環境設定選項： + +#### 選項 A：GitHub Codespaces（推薦） + +**2 分鐘即可開始編碼 - 不需本地安裝！** + +1. 將此存放庫分支（fork）到您的 GitHub 帳戶 + > **注意**：若需修改基本配置，請參閱 [開發容器設定](../../../.devcontainer/devcontainer.json) +2. 點選 **Code** → **Codespaces** 頁籤 → **...** → **New with options...** +3. 使用預設值，這將選擇本課程專用的 **Dev container 配置**：**Generative AI Java Development Environment** +4. 點選 **Create codespace** +5. 等候約 2 分鐘以完成環境準備 +6. 繼續至 [步驟 2：建立 GitHub 權杖](../../../02-SetupDevEnvironment) + +螢幕截圖：Codespaces 子選單 + +螢幕截圖：New with options + +螢幕截圖：建立 codespace 選項 + +> **Codespaces 的優點**： +> - 不需本地安裝 +> - 適用於任何有瀏覽器的裝置 +> - 預配置所有工具與相依性 +> - 個人帳戶每月免費 60 小時 +> - 所有學員皆享有一致的開發環境 + +#### 選項 B：本地開發容器 + +**適合喜歡使用 Docker 進行本地開發的開發者** + +1. 將此存放庫分支（fork）並克隆至本地機器 + > **注意**：若需修改基本配置，請參閱 [開發容器設定](../../../.devcontainer/devcontainer.json) +2. 安裝 [Docker Desktop](https://www.docker.com/products/docker-desktop/) 與 [VS Code](https://code.visualstudio.com/) +3. 在 VS Code 裝置上安裝 [Dev Containers 擴充](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers) +4. 在 VS Code 開啟存放庫目錄 +5. 出現提示時，點選 **Reopen in Container**（或使用 `Ctrl+Shift+P` → "Dev Containers: Reopen in Container"） +6. 等待容器建置與啟動完成 +7. 繼續至 [步驟 2：建立 GitHub 權杖](../../../02-SetupDevEnvironment) + +螢幕截圖：開發容器設定 + +螢幕截圖：開發容器建置完成 + +#### 選項 C：使用您現有的本地安裝 + +**適合已有現有 Java 環境的開發者** + +前置條件： +- [Java 21+](https://www.oracle.com/java/technologies/javase/jdk21-archive-downloads.html) +- [Maven 3.9+](https://maven.apache.org/download.cgi) +- [VS Code](https://code.visualstudio.com) 或您偏好的 IDE + +步驟： +1. 將此存放庫克隆至本地機器 +2. 使用 IDE 開啟專案 +3. 繼續至 [步驟 2：建立 GitHub 權杖](../../../02-SetupDevEnvironment) + +> **專家提示**：如果您的電腦規格較低，但仍想本地使用 VS Code，請使用 GitHub Codespaces！您可以讓本地 VS Code 連接至雲端託管的 Codespace，享有兩者優勢。 + +螢幕截圖：已建立本地開發容器實例 + + +## 步驟 2：建立 GitHub 個人存取權杖 + +1. 前往 [GitHub 設定頁面](https://github.com/settings/profile)，從您的個人資料選單中選取 **Settings**。 +2. 在左側側欄按 **Developer settings**（通常位於底部）。 +3. 在 **Personal access tokens** 下，點選 **Fine-grained tokens**（或使用此直接 [連結](https://github.com/settings/personal-access-tokens)）。 +4. 點選 **Generate new token**。 +5. 在「Token name」欄輸入描述名稱（例如 `GenAI-Java-Course-Token`）。 +6. 設定過期日期（建議：為安全起見設為 7 天）。 +7. 「Resource owner」選擇您的用戶帳戶。 +8. 「Repository access」選擇您要與 GitHub 模型搭配使用的儲存庫（或選「所有儲存庫」）。 +9. 「Account permissions」找到 **Models** 權限並設定為 **Read-only**。 +10. 點按 **Generate token**。 +11. **立即複製並保存您的權杖** — 您之後將無法再次查看！ + +> **安全提示**：盡量使用最低權限範圍及最短實用的過期時間。 + +## 步驟 3：使用 GitHub 模型範例測試您的設定 + +一旦您的開發環境準備就緒，讓我們使用 [`02-SetupDevEnvironment/examples/github-models`](../../../02-SetupDevEnvironment/examples/github-models) 中的範例應用程式來測試 GitHub 模型整合。 + +1. 在您的開發環境中開啟終端機。 +2. 前往 GitHub 模型範例目錄： + ```bash + cd 02-SetupDevEnvironment/examples/github-models + ``` +3. 將您的 GitHub 權杖設定為環境變數： + ```bash + # macOS/Linux + export GITHUB_TOKEN=your_token_here + + # Windows（命令提示字元） + set GITHUB_TOKEN=your_token_here + + # Windows（PowerShell） + $env:GITHUB_TOKEN="your_token_here" + ``` + +4. 執行應用程式： + ```bash + mvn compile exec:java -Dexec.mainClass="com.example.githubmodels.App" + ``` + +您應會看到如下類似輸出： +```text +Using model: gpt-4.1-nano +Sending request to GitHub Models... +Response: Hello World! +``` + +### 了解範例程式碼 + +首先，讓我們了解剛才執行的內容。`examples/github-models` 下的範例使用 OpenAI Java SDK 來連接 GitHub 模型： + +**此程式碼功能：** +- 使用您的個人存取權杖 **連接** GitHub 模型 +- **傳送** 一句簡單的 "Say Hello World!" 訊息給 AI 模型 +- **接收** 並顯示 AI 回應 +- **驗證** 您的設定是否正常運作 + +**主要相依元件**（在 `pom.xml` 中）： +```xml + + com.openai + openai-java + 2.12.0 + +``` + +**主要程式碼**（`App.java`）： +```java +// 使用 OpenAI Java SDK 連接到 GitHub 模型 +OpenAIClient client = OpenAIOkHttpClient.builder() + .apiKey(pat) + .baseUrl("https://models.inference.ai.azure.com") + .build(); + +// 建立聊天完成請求 +ChatCompletionCreateParams params = ChatCompletionCreateParams.builder() + .model(modelId) + .addSystemMessage("You are a concise assistant.") + .addUserMessage("Say Hello World!") + .build(); + +// 獲取 AI 回應 +ChatCompletion response = client.chat().completions().create(params); +System.out.println("Response: " + response.choices().get(0).message().content().orElse("No response content")); +``` + +## 摘要 + +太好了！您現在已完成所有設定： + +- 建立具有 AI 模型存取權限的 GitHub 個人存取權杖 +- 啟動您的 Java 開發環境（不論是 Codespaces、開發容器，或本地安裝） +- 使用 OpenAI Java SDK 連接 GitHub 模型，免費開發 AI +- 使用簡單範例確認所有功能運作正常 + +## 下一步 + +[第 3 章：核心生成式 AI 技術](../03-CoreGenerativeAITechniques/README.md) + +## 疑難排解 + +遇到問題？以下是常見問題及解決方案： + +- **權杖無法使用？** + - 確保完整複製權杖且無多餘空白 + - 驗證環境變數是否正確設定 + - 確認權杖擁有正確權限（Models：唯讀） + +- **找不到 Maven？** + - 若使用開發容器/Codespaces，Maven 應已預裝 + - 本地環境須安裝 Java 21+ 與 Maven 3.9+ + - 使用 `mvn --version` 驗證安裝 + +- **連線問題？** + - 檢查網路連線 + - 確認可連接 GitHub + - 確定未受防火牆阻擋 GitHub 模型終端點 + +- **開發容器無法啟動？** + - 確認 Docker Desktop 正常執行（本地開發用） + - 嘗試重建容器：`Ctrl+Shift+P` → "Dev Containers: Rebuild Container" + +- **應用程式編譯錯誤？** + - 確認目前目錄為：`02-SetupDevEnvironment/examples/github-models` + - 嘗試清理並重新編譯：`mvn clean compile` + +> **需要幫助嗎？**：仍有問題？歡迎於本存放庫開啟 issue，我們會協助您。 + +--- + + +**免責聲明**： +本文件使用 AI 翻譯服務 [Co-op Translator](https://github.com/Azure/co-op-translator) 進行翻譯。雖然我們力求準確，但請注意，自動翻譯可能包含錯誤或不準確之處。原文件的母語版本應視為權威來源。對於重要資訊，建議採用專業人工翻譯。我們不對因使用本翻譯而引起的任何誤解或曲解承擔責任。 + \ No newline at end of file diff --git a/translations/mo/02-SetupDevEnvironment/examples/basic-chat-azure/README.md b/translations/zh-MO/02-SetupDevEnvironment/examples/basic-chat-azure/README.md similarity index 96% rename from translations/mo/02-SetupDevEnvironment/examples/basic-chat-azure/README.md rename to translations/zh-MO/02-SetupDevEnvironment/examples/basic-chat-azure/README.md index df59581c..fa4dbf7e 100644 --- a/translations/mo/02-SetupDevEnvironment/examples/basic-chat-azure/README.md +++ b/translations/zh-MO/02-SetupDevEnvironment/examples/basic-chat-azure/README.md @@ -1,12 +1,3 @@ - # 使用 Azure OpenAI 的基礎聊天範例 - 端到端示例 此範例展示如何建立一個簡單的 Spring Boot 應用程式，連接到 Azure OpenAI 並測試您的設定。 diff --git a/translations/mo/02-SetupDevEnvironment/getting-started-azure-openai.md b/translations/zh-MO/02-SetupDevEnvironment/getting-started-azure-openai.md similarity index 94% rename from translations/mo/02-SetupDevEnvironment/getting-started-azure-openai.md rename to translations/zh-MO/02-SetupDevEnvironment/getting-started-azure-openai.md index 9071e854..2fc31cbc 100644 --- a/translations/mo/02-SetupDevEnvironment/getting-started-azure-openai.md +++ b/translations/zh-MO/02-SetupDevEnvironment/getting-started-azure-openai.md @@ -1,12 +1,3 @@ - # 設置 Azure OpenAI 開發環境 > **快速開始**：本指南適用於 Azure OpenAI 的設置。如果想立即使用免費模型，請參考 [GitHub Models with Codespaces](./README.md#quick-start-cloud)。 @@ -75,7 +66,7 @@ CO_OP_TRANSLATOR_METADATA: > **注意**：如果您想編輯基本配置，請查看 [Dev Container Configuration](../../../.devcontainer/devcontainer.json) 2. 在您的 Fork 存儲庫中，點擊 **Code** → **Codespaces** 標籤 3. 點擊 **...** → **New with options...** -![使用選項創建 Codespace](../../../translated_images/mo/codespaces.9945ded8ceb431a5.webp) +![使用選項創建 Codespace](../../../translated_images/zh-MO/codespaces.9945ded8ceb431a5.webp) 4. 選擇 **Dev container configuration**： - **Generative AI Java Development Environment** 5. 點擊 **Create codespace** diff --git a/translations/mo/03-CoreGenerativeAITechniques/README.md b/translations/zh-MO/03-CoreGenerativeAITechniques/README.md similarity index 98% rename from translations/mo/03-CoreGenerativeAITechniques/README.md rename to translations/zh-MO/03-CoreGenerativeAITechniques/README.md index 6f988877..a7af3a44 100644 --- a/translations/mo/03-CoreGenerativeAITechniques/README.md +++ b/translations/zh-MO/03-CoreGenerativeAITechniques/README.md @@ -1,12 +1,3 @@ - # 核心生成式 AI 技術教學 ## 目錄 diff --git a/translations/mo/04-PracticalSamples/README.md b/translations/zh-MO/04-PracticalSamples/README.md similarity index 93% rename from translations/mo/04-PracticalSamples/README.md rename to translations/zh-MO/04-PracticalSamples/README.md index 71294cda..5ca76f6f 100644 --- a/translations/mo/04-PracticalSamples/README.md +++ b/translations/zh-MO/04-PracticalSamples/README.md @@ -1,12 +1,3 @@ - # 實用應用與專案 ## 你將學到什麼 diff --git a/translations/mo/04-PracticalSamples/calculator/README.md b/translations/zh-MO/04-PracticalSamples/calculator/README.md similarity index 97% rename from translations/mo/04-PracticalSamples/calculator/README.md rename to translations/zh-MO/04-PracticalSamples/calculator/README.md index 8e222613..ef43b4d7 100644 --- a/translations/mo/04-PracticalSamples/calculator/README.md +++ b/translations/zh-MO/04-PracticalSamples/calculator/README.md @@ -1,12 +1,3 @@ - # MCP 計算器初學者教學 ## 目錄 diff --git a/translations/mo/04-PracticalSamples/foundrylocal/README.md b/translations/zh-MO/04-PracticalSamples/foundrylocal/README.md similarity index 98% rename from translations/mo/04-PracticalSamples/foundrylocal/README.md rename to translations/zh-MO/04-PracticalSamples/foundrylocal/README.md index 6bfa3939..c8c639db 100644 --- a/translations/mo/04-PracticalSamples/foundrylocal/README.md +++ b/translations/zh-MO/04-PracticalSamples/foundrylocal/README.md @@ -1,12 +1,3 @@ - # Foundry Local Spring Boot 教學 ## 目錄 diff --git a/translations/mo/04-PracticalSamples/petstory/README.md b/translations/zh-MO/04-PracticalSamples/petstory/README.md similarity index 98% rename from translations/mo/04-PracticalSamples/petstory/README.md rename to translations/zh-MO/04-PracticalSamples/petstory/README.md index a6baac54..ab575d8a 100644 --- a/translations/mo/04-PracticalSamples/petstory/README.md +++ b/translations/zh-MO/04-PracticalSamples/petstory/README.md @@ -1,12 +1,3 @@ - # 寵物故事生成器初學者教程 ## 目錄 diff --git a/translations/mo/05-ResponsibleGenAI/README.md b/translations/zh-MO/05-ResponsibleGenAI/README.md similarity index 95% rename from translations/mo/05-ResponsibleGenAI/README.md rename to translations/zh-MO/05-ResponsibleGenAI/README.md index 3696936b..dec00650 100644 --- a/translations/mo/05-ResponsibleGenAI/README.md +++ b/translations/zh-MO/05-ResponsibleGenAI/README.md @@ -1,12 +1,3 @@ - # 負責任的生成式 AI ## 你將學到什麼 @@ -58,7 +49,7 @@ GitHub Models 提供了基本的內容過濾功能，就像 AI 俱樂部裡的 5. 顯示結果，說明哪些內容被阻擋、拒絕或允許 6. 測試安全內容以進行比較 -![負責任的 AI 安全示範](../../../translated_images/mo/responsible.e4f51a917bafa4bf.webp) +![負責任的 AI 安全示範](../../../translated_images/zh-MO/responsible.e4f51a917bafa4bf.webp) ### 設定說明 @@ -164,7 +155,7 @@ Status: Response generated successfully 恭喜你完成了生成式 AI 初學者課程！ -![課程完成](../../../translated_images/mo/image.73c7e2ff4a652e77.webp) +![課程完成](../../../translated_images/zh-MO/image.73c7e2ff4a652e77.webp) **你已完成的內容：** - 設置開發環境 diff --git a/translations/mo/AGENTS.md b/translations/zh-MO/AGENTS.md similarity index 97% rename from translations/mo/AGENTS.md rename to translations/zh-MO/AGENTS.md index 1ccad421..192cf28c 100644 --- a/translations/mo/AGENTS.md +++ b/translations/zh-MO/AGENTS.md @@ -1,12 +1,3 @@ - # AGENTS.md ## 專案概述 diff --git a/translations/mo/CODE_OF_CONDUCT.md b/translations/zh-MO/CODE_OF_CONDUCT.md similarity index 80% rename from translations/mo/CODE_OF_CONDUCT.md rename to translations/zh-MO/CODE_OF_CONDUCT.md index 6ff94a6f..1d16e580 100644 --- a/translations/mo/CODE_OF_CONDUCT.md +++ b/translations/zh-MO/CODE_OF_CONDUCT.md @@ -1,12 +1,3 @@ - # Microsoft 開源行為準則 此專案已採用 [Microsoft 開源行為準則](https://opensource.microsoft.com/codeofconduct/)。 diff --git a/translations/zh-MO/README.md b/translations/zh-MO/README.md new file mode 100644 index 00000000..143c3550 --- /dev/null +++ b/translations/zh-MO/README.md @@ -0,0 +1,139 @@ +# Generative AI for Beginners - Java 版 +[![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) + +![Generative AI for Beginners - Java 版](../../translated_images/zh-MO/beg-genai-series.8b48be9951cc574c.webp) + +**所需時間**：整個工作坊可在線完成，無需本地設置。環境設定約需 2 分鐘，根據探索深度，瀏覽範本需 1-3 小時。 + +> **快速開始** + +1. 將此儲存庫分叉到您的 GitHub 帳號 +2. 點擊 **Code** → **Codespaces** 標籤 → **...** → **New with options...** +3. 使用預設值—這將選擇為本課程建立的開發容器 +4. 點擊 **Create codespace** +5. 等待約 2 分鐘以準備環境 +6. 直接跳至 [第一個範例](./02-SetupDevEnvironment/README.md#step-2-create-a-github-personal-access-token) + +> **偏好本地複製？** + +> 此儲存庫含有超過 50 種語言翻譯，顯著增加下載大小。若不含翻譯檔案複製，請使用稀疏結帳： +> ```bash +> git clone --filter=blob:none --sparse https://github.com/microsoft/Generative-AI-for-beginners-java.git +> cd Generative-AI-for-beginners-java +> git sparse-checkout set --no-cone '/*' '!translations' '!translated_images' +> ``` +> 這可讓您用更快速度下載完整課程所需內容。 + + +## 多語言支援 + +### 透過 GitHub Action 支援 （自動化且隨時最新） + + +[阿拉伯語](../ar/README.md) | [孟加拉語](../bn/README.md) | [保加利亞語](../bg/README.md) | [緬甸語](../my/README.md) | [中文（簡體）](../zh-CN/README.md) | [中文（繁體，香港）](../zh-HK/README.md) | [中文（繁體，澳門）](./README.md) | [中文（繁體，台灣）](../zh-TW/README.md) | [克羅埃西亞語](../hr/README.md) | [捷克語](../cs/README.md) | [丹麥語](../da/README.md) | [荷蘭語](../nl/README.md) | [愛沙尼亞語](../et/README.md) | [芬蘭語](../fi/README.md) | [法語](../fr/README.md) | [德語](../de/README.md) | [希臘語](../el/README.md) | [希伯來語](../he/README.md) | [印地語](../hi/README.md) | [匈牙利語](../hu/README.md) | [印尼語](../id/README.md) | [義大利語](../it/README.md) | [日語](../ja/README.md) | [坎納達語](../kn/README.md) | [韓語](../ko/README.md) | [立陶宛語](../lt/README.md) | [馬來語](../ms/README.md) | [馬拉雅拉姆語](../ml/README.md) | [馬拉地語](../mr/README.md) | [尼泊爾語](../ne/README.md) | [奈及利亞洋普丁語](../pcm/README.md) | [挪威語](../no/README.md) | [波斯語（法爾西語）](../fa/README.md) | [波蘭語](../pl/README.md) | [葡萄牙語（巴西）](../pt-BR/README.md) | [葡萄牙語（葡萄牙）](../pt-PT/README.md) | [旁遮普語（古魯穆奇字母）](../pa/README.md) | [羅馬尼亞語](../ro/README.md) | [俄語](../ru/README.md) | [塞爾維亞語（西里爾字母）](../sr/README.md) | [斯洛伐克語](../sk/README.md) | [斯洛文尼亞語](../sl/README.md) | [西班牙語](../es/README.md) | [斯瓦希里語](../sw/README.md) | [瑞典語](../sv/README.md) | [他加祿語（菲律賓語）](../tl/README.md) | [泰米爾語](../ta/README.md) | [泰盧固語](../te/README.md) | [泰語](../th/README.md) | [土耳其語](../tr/README.md) | [烏克蘭語](../uk/README.md) | [烏爾都語](../ur/README.md) | [越南語](../vi/README.md) + +> **偏好本地複製？** + +> 本儲存庫包含 50 多種語言的翻譯，顯著增加下載大小。若不含翻譯檔案複製，請使用稀疏結帳： +> ```bash +> git clone --filter=blob:none --sparse https://github.com/microsoft/Generative-AI-for-beginners-java.git +> cd Generative-AI-for-beginners-java +> git sparse-checkout set --no-cone '/*' '!translations' '!translated_images' +> ``` +> 這可讓您用更快速度下載完整課程所需內容。 + + +## 課程結構與學習路徑 + +### **第一章：生成式 AI 簡介** +- **核心概念**：瞭解大型語言模型、詞元、嵌入向量及 AI 能力 +- **Java AI 生態系統**：Spring AI 與 OpenAI SDK 概述 +- **模型上下文協議**：MCP 介紹及其在 AI 代理通訊的角色 +- **實際應用**：真實場景案例，包括聊天機器人與內容生成 +- **[→ 開始第一章](./01-IntroToGenAI/README.md)** + +### **第二章：開發環境設置** +- **多提供者配置**：設置 GitHub 模型、Azure OpenAI 及 OpenAI Java SDK 整合 +- **Spring Boot + Spring AI**：企業級 AI 應用程式開發最佳實踐 +- **GitHub 模型**：免費 AI 模型供原型設計及學習使用（無需信用卡） +- **開發工具**：Docker 容器、VS Code 及 GitHub Codespaces 配置 +- **[→ 開始第二章](./02-SetupDevEnvironment/README.md)** + +### **第三章：生成式 AI 核心技術** +- **提示工程**：取得最佳 AI 模型回應的技巧 +- **嵌入向量與向量運算**：實作語意搜尋與相似度匹配 +- **檢索增強生成（RAG）**：結合 AI 與您自有資料庫 +- **函式呼叫**：以自訂工具與外掛延伸 AI 能力 +- **[→ 開始第三章](./03-CoreGenerativeAITechniques/README.md)** + +### **第四章：實務應用與專案** +- **寵物故事生成器** (`petstory/`)：利用 GitHub 模型進行創意內容生成 +- **Foundry 本地示範** (`foundrylocal/`)：OpenAI Java SDK 的本地 AI 模型整合 +- **MCP 計算器服務** (`calculator/`)：使用 Spring AI 實作基本模型上下文協議 +- **[→ 開始第四章](./04-PracticalSamples/README.md)** + +### **第五章：負責任的 AI 開發** +- **GitHub 模型安全性**：測試內建內容過濾與安全機制（硬封鎖與軟拒絕） +- **負責任 AI 示範**：實際操作展示現代 AI 安全系統運作 +- **最佳實務指南**：倫理 AI 開發與部署的重要指導方針 +- **[→ 開始第五章](./05-ResponsibleGenAI/README.md)** + +## 額外資源 + + +### LangChain +[![LangChain4j for Beginners](https://img.shields.io/badge/LangChain4j%20for%20Beginners-22C55E?style=for-the-badge&&labelColor=E5E7EB&color=0553D6)](https://aka.ms/langchain4j-for-beginners) +[![LangChain.js for Beginners](https://img.shields.io/badge/LangChain.js%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=0553D6)](https://aka.ms/langchainjs-for-beginners?WT.mc_id=m365-94501-dwahlin) + +--- + +### Azure / Edge / MCP / Agents +[![AZD for Beginners](https://img.shields.io/badge/AZD%20for%20Beginners-0078D4?style=for-the-badge&labelColor=E5E7EB&color=0078D4)](https://github.com/microsoft/AZD-for-beginners?WT.mc_id=academic-105485-koreyst) +[![Edge AI for Beginners](https://img.shields.io/badge/Edge%20AI%20for%20Beginners-00B8E4?style=for-the-badge&labelColor=E5E7EB&color=00B8E4)](https://github.com/microsoft/edgeai-for-beginners?WT.mc_id=academic-105485-koreyst) +[![MCP for Beginners](https://img.shields.io/badge/MCP%20for%20Beginners-009688?style=for-the-badge&labelColor=E5E7EB&color=009688)](https://github.com/microsoft/mcp-for-beginners?WT.mc_id=academic-105485-koreyst) +[![AI Agents for Beginners](https://img.shields.io/badge/AI%20Agents%20for%20Beginners-00C49A?style=for-the-badge&labelColor=E5E7EB&color=00C49A)](https://github.com/microsoft/ai-agents-for-beginners?WT.mc_id=academic-105485-koreyst) + +--- + +### 生成式 AI 系列 +[![Generative AI for Beginners](https://img.shields.io/badge/Generative%20AI%20for%20Beginners-8B5CF6?style=for-the-badge&labelColor=E5E7EB&color=8B5CF6)](https://github.com/microsoft/generative-ai-for-beginners?WT.mc_id=academic-105485-koreyst) +[![Generative AI (.NET)](https://img.shields.io/badge/Generative%20AI%20(.NET)-9333EA?style=for-the-badge&labelColor=E5E7EB&color=9333EA)](https://github.com/microsoft/Generative-AI-for-beginners-dotnet?WT.mc_id=academic-105485-koreyst) +[![Generative AI (Java)](https://img.shields.io/badge/Generative%20AI%20(Java)-C084FC?style=for-the-badge&labelColor=E5E7EB&color=C084FC)](https://github.com/microsoft/generative-ai-for-beginners-java?WT.mc_id=academic-105485-koreyst) +[![Generative AI (JavaScript)](https://img.shields.io/badge/Generative%20AI%20(JavaScript)-E879F9?style=for-the-badge&labelColor=E5E7EB&color=E879F9)](https://github.com/microsoft/generative-ai-with-javascript?WT.mc_id=academic-105485-koreyst) + +--- + +### 核心學習 +[![ML for Beginners](https://img.shields.io/badge/ML%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=22C55E)](https://aka.ms/ml-beginners?WT.mc_id=academic-105485-koreyst) +[![Data Science for Beginners](https://img.shields.io/badge/Data%20Science%20for%20Beginners-84CC16?style=for-the-badge&labelColor=E5E7EB&color=84CC16)](https://aka.ms/datascience-beginners?WT.mc_id=academic-105485-koreyst) +[![AI for Beginners](https://img.shields.io/badge/AI%20for%20Beginners-A3E635?style=for-the-badge&labelColor=E5E7EB&color=A3E635)](https://aka.ms/ai-beginners?WT.mc_id=academic-105485-koreyst) +[![Cybersecurity for Beginners](https://img.shields.io/badge/Cybersecurity%20for%20Beginners-F97316?style=for-the-badge&labelColor=E5E7EB&color=F97316)](https://github.com/microsoft/Security-101?WT.mc_id=academic-96948-sayoung) + +[![Web Dev for Beginners](https://img.shields.io/badge/Web%20Dev%20for%20Beginners-EC4899?style=for-the-badge&labelColor=E5E7EB&color=EC4899)](https://aka.ms/webdev-beginners?WT.mc_id=academic-105485-koreyst) +[![IoT for Beginners](https://img.shields.io/badge/IoT%20for%20Beginners-14B8A6?style=for-the-badge&labelColor=E5E7EB&color=14B8A6)](https://aka.ms/iot-beginners?WT.mc_id=academic-105485-koreyst) +[![XR Development for Beginners](https://img.shields.io/badge/XR%20Development%20for%20Beginners-38BDF8?style=for-the-badge&labelColor=E5E7EB&color=38BDF8)](https://github.com/microsoft/xr-development-for-beginners?WT.mc_id=academic-105485-koreyst) + +--- + +### Copilot 系列 +[![Copilot for AI Paired Programming](https://img.shields.io/badge/Copilot%20for%20AI%20Paired%20Programming-FACC15?style=for-the-badge&labelColor=E5E7EB&color=FACC15)](https://aka.ms/GitHubCopilotAI?WT.mc_id=academic-105485-koreyst) +[![Copilot for C#/.NET](https://img.shields.io/badge/Copilot%20for%20C%23/.NET-FBBF24?style=for-the-badge&labelColor=E5E7EB&color=FBBF24)](https://github.com/microsoft/mastering-github-copilot-for-dotnet-csharp-developers?WT.mc_id=academic-105485-koreyst) +[![Copilot Adventure](https://img.shields.io/badge/Copilot%20Adventure-FDE68A?style=for-the-badge&labelColor=E5E7EB&color=FDE68A)](https://github.com/microsoft/CopilotAdventures?WT.mc_id=academic-105485-koreyst) + + +## 尋求協助 + +如果你遇到困難或對建立 AI 應用有任何疑問，歡迎加入其他學習者及經驗豐富的開發者一同討論 MCP。這是個支持性的社群，問題受到歡迎，知識自由共享。 + +[![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) + +如果你在開發過程中有產品反饋或錯誤，請造訪： + +[![Microsoft Foundry Developer Forum](https://img.shields.io/badge/GitHub-Microsoft_Foundry_Developer_Forum-blue?style=for-the-badge&logo=github&color=000000&logoColor=fff)](https://aka.ms/foundry/forum) + +--- + + +**免責聲明**： +本文件經由人工智能翻譯服務 [Co-op Translator](https://github.com/Azure/co-op-translator) 翻譯。雖然我們致力於保持準確性，但請注意自動翻譯可能包含錯誤或不準確之處。原始文件的原文版本應視為權威依據。對於重要資訊，建議採用專業人工翻譯。我們不對因使用本翻譯而產生的任何誤解或曲解承擔責任。 + \ No newline at end of file diff --git a/translations/mo/SECURITY.md b/translations/zh-MO/SECURITY.md similarity index 93% rename from translations/mo/SECURITY.md rename to translations/zh-MO/SECURITY.md index e2a6b250..7343394e 100644 --- a/translations/mo/SECURITY.md +++ b/translations/zh-MO/SECURITY.md @@ -1,12 +1,3 @@ - ## 安全性 Microsoft 非常重視我們軟體產品與服務的安全性，這包括透過我們的 GitHub 組織管理的所有原始碼庫，例如 [Microsoft](https://github.com/Microsoft)、[Azure](https://github.com/Azure)、[DotNet](https://github.com/dotnet)、[AspNet](https://github.com/aspnet) 和 [Xamarin](https://github.com/xamarin)。 diff --git a/translations/mo/SUPPORT.md b/translations/zh-MO/SUPPORT.md similarity index 79% rename from translations/mo/SUPPORT.md rename to translations/zh-MO/SUPPORT.md index a0b49ee2..628e22d4 100644 --- a/translations/mo/SUPPORT.md +++ b/translations/zh-MO/SUPPORT.md @@ -1,12 +1,3 @@ - # 支援 ## 如何提交問題和獲取幫助 diff --git a/translations/zh-TW/.co-op-translator.json b/translations/zh-TW/.co-op-translator.json new file mode 100644 index 00000000..37ab056e --- /dev/null +++ b/translations/zh-TW/.co-op-translator.json @@ -0,0 +1,92 @@ +{ + "01-IntroToGenAI/README.md": { + "original_hash": "75bfb080ca725e8a9aa9c80cae25fba1", + "translation_date": "2025-07-29T08:28:57+00:00", + "source_file": "01-IntroToGenAI/README.md", + "language_code": "zh-TW" + }, + "02-SetupDevEnvironment/README.md": { + "original_hash": "96a30d42b9751a3d4e4b20e28d29d459", + "translation_date": "2026-01-28T04:45:30+00:00", + "source_file": "02-SetupDevEnvironment/README.md", + "language_code": "zh-TW" + }, + "02-SetupDevEnvironment/examples/basic-chat-azure/README.md": { + "original_hash": "efd82efe50711d7e257eb943151d682c", + "translation_date": "2025-07-27T13:36:13+00:00", + "source_file": "02-SetupDevEnvironment/examples/basic-chat-azure/README.md", + "language_code": "zh-TW" + }, + "02-SetupDevEnvironment/getting-started-azure-openai.md": { + "original_hash": "bfdb4b4eadbee3a59ef742439f58326a", + "translation_date": "2025-07-27T12:57:32+00:00", + "source_file": "02-SetupDevEnvironment/getting-started-azure-openai.md", + "language_code": "zh-TW" + }, + "03-CoreGenerativeAITechniques/README.md": { + "original_hash": "685f55cb07de19b52a30ce6e8b6d889e", + "translation_date": "2025-08-28T21:58:21+00:00", + "source_file": "03-CoreGenerativeAITechniques/README.md", + "language_code": "zh-TW" + }, + "04-PracticalSamples/README.md": { + "original_hash": "14c0a61ecc1cd2012a9c129236dfdf71", + "translation_date": "2025-07-29T08:28:42+00:00", + "source_file": "04-PracticalSamples/README.md", + "language_code": "zh-TW" + }, + "04-PracticalSamples/calculator/README.md": { + "original_hash": "b6c16b5514d524e415a94f6097ee7d4c", + "translation_date": "2025-09-18T15:26:43+00:00", + "source_file": "04-PracticalSamples/calculator/README.md", + "language_code": "zh-TW" + }, + "04-PracticalSamples/foundrylocal/README.md": { + "original_hash": "f787307400de59adc25a1404466a35f3", + "translation_date": "2025-11-04T07:17:20+00:00", + "source_file": "04-PracticalSamples/foundrylocal/README.md", + "language_code": "zh-TW" + }, + "04-PracticalSamples/petstory/README.md": { + "original_hash": "0cbf68d605615a1e602c832a24616859", + "translation_date": "2025-07-25T10:57:28+00:00", + "source_file": "04-PracticalSamples/petstory/README.md", + "language_code": "zh-TW" + }, + "05-ResponsibleGenAI/README.md": { + "original_hash": "301c05c2f57e60a6950b8c665b8bdbba", + "translation_date": "2025-07-29T15:44:15+00:00", + "source_file": "05-ResponsibleGenAI/README.md", + "language_code": "zh-TW" + }, + "AGENTS.md": { + "original_hash": "afc90918d008cf77fd1982691f681306", + "translation_date": "2025-10-03T08:30:34+00:00", + "source_file": "AGENTS.md", + "language_code": "zh-TW" + }, + "CODE_OF_CONDUCT.md": { + "original_hash": "442b123d034f92f7c384d2bbd28f99f1", + "translation_date": "2025-07-21T15:58:21+00:00", + "source_file": "CODE_OF_CONDUCT.md", + "language_code": "zh-TW" + }, + "README.md": { + "original_hash": "125a08948d881c95628094f4dd1fbd43", + "translation_date": "2026-01-29T15:27:58+00:00", + "source_file": "README.md", + "language_code": "zh-TW" + }, + "SECURITY.md": { + "original_hash": "57f14126c1c6add76b3aef3844dfe4e3", + "translation_date": "2025-07-21T15:56:00+00:00", + "source_file": "SECURITY.md", + "language_code": "zh-TW" + }, + "SUPPORT.md": { + "original_hash": "b8ef73cc49dec68e2c885ee9df545129", + "translation_date": "2025-07-21T15:59:30+00:00", + "source_file": "SUPPORT.md", + "language_code": "zh-TW" + } +} \ No newline at end of file diff --git a/translations/tw/01-IntroToGenAI/README.md b/translations/zh-TW/01-IntroToGenAI/README.md similarity index 95% rename from translations/tw/01-IntroToGenAI/README.md rename to translations/zh-TW/01-IntroToGenAI/README.md index 7dd0bbfa..bcab3b22 100644 --- a/translations/tw/01-IntroToGenAI/README.md +++ b/translations/zh-TW/01-IntroToGenAI/README.md @@ -1,12 +1,3 @@ - # 生成式人工智慧入門 - Java 版 ## 你將學到什麼 @@ -44,7 +35,7 @@ CO_OP_TRANSLATOR_METADATA: 不同的模型針對不同的任務進行了優化。例如，**小型語言模型（SLMs）**和**大型語言模型（LLMs）**都可以處理文字生成，但 LLMs 通常在處理複雜任務時表現更佳。對於圖像相關的任務，你可能會使用專門的視覺模型或多模態模型。 -![圖示：生成式人工智慧模型類型及其應用場景。](../../../translated_images/tw/llms.225ca2b8a0d34473.webp) +![圖示：生成式人工智慧模型類型及其應用場景。](../../../translated_images/zh-TW/llms.225ca2b8a0d34473.webp) 當然，這些模型的回應並非總是完美的。你可能聽說過模型會「幻覺」（hallucinate），即以權威的方式生成錯誤資訊。不過，你可以透過提供清晰的指示和上下文來幫助模型生成更好的回應，而這正是**提示工程**的作用。 @@ -79,13 +70,13 @@ CO_OP_TRANSLATOR_METADATA: - **嵌入**：嵌入是捕捉語義意義的 tokens 向量表示。它們是數值表示（通常是浮點數陣列），使模型能夠理解單詞之間的關係並生成語義相關的回應。相似的單詞具有相似的嵌入，這使得模型能夠理解同義詞和語義關係。 -![圖示：嵌入](../../../translated_images/tw/embedding.398e50802c0037f9.webp) +![圖示：嵌入](../../../translated_images/zh-TW/embedding.398e50802c0037f9.webp) 在 Java 中，你可以使用 OpenAI SDK 或其他支援嵌入生成的函式庫來生成嵌入。這些嵌入對於語義搜索等任務至關重要，因為你希望根據意義而非精確文字匹配來找到相似內容。 - **向量資料庫**：向量資料庫是針對嵌入進行優化的專門存儲系統。它們支持高效的相似性搜索，對於檢索增強生成（RAG）模式至關重要，該模式需要根據語義相似性而非精確匹配從大型資料集中查找相關資訊。 -![圖示：向量資料庫架構，展示嵌入如何存儲和檢索以進行相似性搜索。](../../../translated_images/tw/vector.f12f114934e223df.webp) +![圖示：向量資料庫架構，展示嵌入如何存儲和檢索以進行相似性搜索。](../../../translated_images/zh-TW/vector.f12f114934e223df.webp) > **注意**：本課程不涵蓋向量資料庫，但認為它們值得一提，因為它們在實際應用中非常常見。 @@ -93,7 +84,7 @@ CO_OP_TRANSLATOR_METADATA: 在 Java 的人工智慧應用程式中，你將使用 tokens 進行文字處理，使用嵌入進行語義搜索和 RAG，使用向量資料庫進行資料檢索，並使用 MCP 的代理來構建智能工具使用系統。 -![圖示：從提示到回應的流程——tokens、向量、可選的 RAG 查詢、LLM 思考以及 MCP 代理在一個快速流程中的作用。](../../../translated_images/tw/flow.f4ef62c3052d12a8.webp) +![圖示：從提示到回應的流程——tokens、向量、可選的 RAG 查詢、LLM 思考以及 MCP 代理在一個快速流程中的作用。](../../../translated_images/zh-TW/flow.f4ef62c3052d12a8.webp) ### Java 的人工智慧開發工具與函式庫 diff --git a/translations/zh-TW/02-SetupDevEnvironment/README.md b/translations/zh-TW/02-SetupDevEnvironment/README.md new file mode 100644 index 00000000..c34df1e8 --- /dev/null +++ b/translations/zh-TW/02-SetupDevEnvironment/README.md @@ -0,0 +1,252 @@ +# 為 Java 設定生成式 AI 的開發環境 + +> **快速開始**：2 分鐘內在雲端編寫程式碼 - 跳至 [GitHub Codespaces 設定](../../../02-SetupDevEnvironment) - 不需本機安裝且使用 GitHub 模型！ + +> **對 Azure OpenAI 有興趣嗎？**，請參閱我們的 [Azure OpenAI 設定指南](getting-started-azure-openai.md)，內含建立新的 Azure OpenAI 資源步驟。 + +## 你將學到什麼 + +- 為 AI 應用設定 Java 開發環境 +- 選擇並設定你偏好的開發環境（雲端優先的 Codespaces、本地開發容器或完整本地安裝） +- 透過連接 GitHub 模型來測試你的設定 + +## 目錄 + +- [你將學到什麼](../../../02-SetupDevEnvironment) +- [介紹](../../../02-SetupDevEnvironment) +- [步驟 1：設定你的開發環境](../../../02-SetupDevEnvironment) + - [選項 A：GitHub Codespaces（推薦）](../../../02-SetupDevEnvironment) + - [選項 B：本地開發容器](../../../02-SetupDevEnvironment) + - [選項 C：使用你現有的本地安裝](../../../02-SetupDevEnvironment) +- [步驟 2：建立 GitHub 個人存取權杖](../../../02-SetupDevEnvironment) +- [步驟 3：使用 GitHub 模型範例測試你的設定](../../../02-SetupDevEnvironment) +- [疑難排解](../../../02-SetupDevEnvironment) +- [摘要](../../../02-SetupDevEnvironment) +- [下一步](../../../02-SetupDevEnvironment) + +## 介紹 + +本章將指導你完成開發環境的設定。我們將以 **GitHub 模型** 作為主要範例，因為它免費、只需一個 GitHub 帳戶即可輕鬆設置，不需信用卡，且提供多種模型可用來實驗。 + +**不需本地安裝！** 你可以立即使用 GitHub Codespaces 在瀏覽器中啟動完整開發環境開始編程。 + +Screenshot: GitHub Models + +我們建議本課程使用 [**GitHub Models**](https://github.com/marketplace?type=models)，因為它： +- **免費** 開始使用 +- 只需一個 GitHub 帳戶即可 **輕鬆設置** +- 不需 **信用卡** +- 有多種模型可供試驗 + +> **注意**：本訓練中使用的 GitHub 模型有以下免費限制： +> - 每分鐘 15 次請求（每日 150 次） +> - 每次請求約 8,000 字輸入，約 4,000 字輸出 +> - 同時可發送 5 個請求 +> +> 若要用於生產環境，請使用你的 Azure 帳戶升級至 Azure AI Foundry 模型。程式碼無需更動。詳見 [Azure AI Foundry 文件](https://learn.microsoft.com/azure/ai-foundry/foundry-models/how-to/quickstart-github-models)。 + +## 步驟 1：設定你的開發環境 + + + +我們已建立預先設定好的開發容器，減少設定時間並確保你擁有本課程所需的所有工具。請選擇你偏好的開發方式： + +### 環境設定選項： + +#### 選項 A：GitHub Codespaces（推薦） + +**2 分鐘內開始編碼 - 不需本地安裝！** + +1. 將本儲存庫 fork 到你的 GitHub 帳號 + > **注意**：若要編輯基本配置，請參閱 [開發容器配置](../../../.devcontainer/devcontainer.json) +2. 點選 **Code** → **Codespaces** 標籤 → **...** → **New with options...** +3. 使用預設值—這將選擇本課程自訂開發容器配置：**Generative AI Java Development Environment** +4. 點選 **Create codespace** +5. 等待約 2 分鐘，環境就緒 +6. 執行至 [步驟 2：建立 GitHub 存取權杖](../../../02-SetupDevEnvironment) + +Screenshot: Codespaces submenu + +Screenshot: New with options + +Screenshot: Create codespace options + + +> **Codespaces 的優點**： +> - 不需本地安裝 +> - 任何有瀏覽器的裝置皆可使用 +> - 預先配置所有工具與相依套件 +> - 個人帳號每月免費 60 小時 +> - 為所有學員提供一致的環境 + +#### 選項 B：本地開發容器 + +**適合偏好以 Docker 本地開發者** + +1. 將本儲存庫 fork 並 clone 至你的本機 + > **注意**：若要編輯基本配置，請參閱 [開發容器配置](../../../.devcontainer/devcontainer.json) +2. 安裝 [Docker Desktop](https://www.docker.com/products/docker-desktop/) 和 [VS Code](https://code.visualstudio.com/) +3. 在 VS Code 安裝 [Dev Containers 擴充功能](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers) +4. 在 VS Code 打開儲存庫資料夾 +5. 出現提示時，點選 **Reopen in Container**（或使用 `Ctrl+Shift+P` → "Dev Containers: Reopen in Container"） +6. 等待容器建置並啟動完成 +7. 執行至 [步驟 2：建立 GitHub 存取權杖](../../../02-SetupDevEnvironment) + +Screenshot: Dev container setup + +Screenshot: Dev container build complete + +#### 選項 C：使用你現有的本地安裝 + +**適合已有 Java 環境的開發者** + +先決條件： +- [Java 21+](https://www.oracle.com/java/technologies/javase/jdk21-archive-downloads.html) +- [Maven 3.9+](https://maven.apache.org/download.cgi) +- [VS Code](https://code.visualstudio.com) 或你偏好的 IDE + +步驟： +1. 將本儲存庫 clone 至本機 +2. 在 IDE 中開啟專案 +3. 執行至 [步驟 2：建立 GitHub 存取權杖](../../../02-SetupDevEnvironment) + +> **小提示**：若你的裝置規格較低但想使用本地 VS Code，建議採用 GitHub Codespaces！你可以將本地 VS Code 連接到雲端 Codespace，享受兩者優點。 + +Screenshot: created local devcontainer instance + +## 步驟 2：建立 GitHub 個人存取權杖 + +1. 前往 [GitHub 設定頁](https://github.com/settings/profile)，在個人資料選單中選擇 **Settings**。 +2. 在左側邊欄點選 **Developer settings**（通常在最下方）。 +3. 在 **Personal access tokens** 區塊點選 **Fine-grained tokens**（或使用此直接 [連結](https://github.com/settings/personal-access-tokens)）。 +4. 點選 **Generate new token**。 +5. 在「Token name」欄位填寫描述名稱（例如 `GenAI-Java-Course-Token`）。 +6. 設定過期時間（建議設定 7 天，以符合安全最佳實踐）。 +7. 在「Resource owner」選擇你的使用者帳號。 +8. 在「Repository access」選擇你想用於 GitHub 模型的儲存庫（或選「All repositories」）。 +9. 在「Account permissions」中找到 **Models** 權限，設定為 **Read-only**。 +10. 點選 **Generate token**。 +11. **請立即複製並保存你的權杖** — 之後將無法再次查看！ + +> **安全提示**：為存取權杖使用最低必要的範圍及最短可行的過期時間。 + +## 步驟 3：使用 GitHub 模型範例測試你的設定 + +當開發環境準備好後，讓我們用 [`02-SetupDevEnvironment/examples/github-models`](../../../02-SetupDevEnvironment/examples/github-models) 的範例應用程式測試 GitHub 模型整合。 + +1. 在你的開發環境中開啟終端機。 +2. 切換到 GitHub 模型範例資料夾： + ```bash + cd 02-SetupDevEnvironment/examples/github-models + ``` +3. 將你的 GitHub 權杖設為環境變數： + ```bash + # macOS/Linux + export GITHUB_TOKEN=your_token_here + + # Windows（命令提示字元） + set GITHUB_TOKEN=your_token_here + + # Windows（PowerShell） + $env:GITHUB_TOKEN="your_token_here" + ``` + +4. 執行應用程式： + ```bash + mvn compile exec:java -Dexec.mainClass="com.example.githubmodels.App" + ``` + +你將看到類似以下的輸出： +```text +Using model: gpt-4.1-nano +Sending request to GitHub Models... +Response: Hello World! +``` + +### 理解範例程式碼 + +首先，來了解我們執行了什麼。`examples/github-models` 下的範例使用 OpenAI Java SDK 連接到 GitHub 模型： + +**此程式碼的功能：** +- **使用你的個人存取權杖**連接到 GitHub 模型 +- **傳送**簡單的「Say Hello World!」訊息給 AI 模型 +- **接收**並顯示 AI 回應 +- **驗證**你的設定是否正確 + +**關鍵相依套件**（在 `pom.xml` 中）： +```xml + + com.openai + openai-java + 2.12.0 + +``` + +**主要程式碼**（`App.java`）： +```java +// 使用 OpenAI Java SDK 連接到 GitHub 模型 +OpenAIClient client = OpenAIOkHttpClient.builder() + .apiKey(pat) + .baseUrl("https://models.inference.ai.azure.com") + .build(); + +// 建立聊天回應請求 +ChatCompletionCreateParams params = ChatCompletionCreateParams.builder() + .model(modelId) + .addSystemMessage("You are a concise assistant.") + .addUserMessage("Say Hello World!") + .build(); + +// 取得 AI 回應 +ChatCompletion response = client.chat().completions().create(params); +System.out.println("Response: " + response.choices().get(0).message().content().orElse("No response content")); +``` + +## 摘要 + +太好了！你現在已完成所有設定： + +- 建立了具備 AI 模型存取權限的 GitHub 個人存取權杖 +- 啟動你的 Java 開發環境（無論是 Codespaces、開發容器或本地環境） +- 使用 OpenAI Java SDK 免費連接 GitHub 模型進行 AI 開發 +- 透過簡單範例測試一切功能正常，成功與 AI 模型互動 + +## 下一步 + +[第 3 章：核心生成式 AI 技術](../03-CoreGenerativeAITechniques/README.md) + +## 疑難排解 + +遇到問題嗎？以下列出常見問題與解決方案： + +- **權杖無法使用？** + - 確認完整複製權杖，無多餘空白 + - 確認權杖正確設定為環境變數 + - 檢查權杖權限是否設定為 Models: Read-only + +- **找不到 Maven？** + - 使用開發容器或 Codespaces 時，Maven 應已預裝 + - 本地安裝請確保已安裝 Java 21+ 與 Maven 3.9+ + - 用 `mvn --version` 確認安裝狀態 + +- **連線問題？** + - 檢查網路連線狀態 + - 確認網路可連接 GitHub + - 確保防火牆未阻擋 GitHub 模型端點 + +- **開發容器無法啟動？** + - 確認 Docker Desktop 正在執行（本地開發） + - 嘗試重建容器：`Ctrl+Shift+P` → "Dev Containers: Rebuild Container" + +- **應用程式編譯錯誤？** + - 確認目錄是否為：`02-SetupDevEnvironment/examples/github-models` + - 嘗試清理並重新編譯：`mvn clean compile` + +> **需要幫助嗎？**：若問題持續，請在儲存庫開啟 Issue，我們將協助你。 + +--- + + +**免責聲明**： +本文件由 AI 翻譯服務 [Co-op Translator](https://github.com/Azure/co-op-translator) 進行翻譯。雖然我們力求準確，但請注意，自動翻譯可能包含錯誤或不準確之處。原始文件的母語版本應被視為權威來源。對於重要資訊，建議使用專業人工翻譯。我們不對因使用本翻譯而導致的任何誤解或誤釋負責。 + \ No newline at end of file diff --git a/translations/tw/02-SetupDevEnvironment/examples/basic-chat-azure/README.md b/translations/zh-TW/02-SetupDevEnvironment/examples/basic-chat-azure/README.md similarity index 96% rename from translations/tw/02-SetupDevEnvironment/examples/basic-chat-azure/README.md rename to translations/zh-TW/02-SetupDevEnvironment/examples/basic-chat-azure/README.md index 0f74acda..f6ac5af7 100644 --- a/translations/tw/02-SetupDevEnvironment/examples/basic-chat-azure/README.md +++ b/translations/zh-TW/02-SetupDevEnvironment/examples/basic-chat-azure/README.md @@ -1,12 +1,3 @@ - # 使用 Azure OpenAI 的基礎聊天範例 - 端到端示例 此範例展示如何建立一個簡單的 Spring Boot 應用程式，連接到 Azure OpenAI 並測試您的設置。 diff --git a/translations/tw/02-SetupDevEnvironment/getting-started-azure-openai.md b/translations/zh-TW/02-SetupDevEnvironment/getting-started-azure-openai.md similarity index 94% rename from translations/tw/02-SetupDevEnvironment/getting-started-azure-openai.md rename to translations/zh-TW/02-SetupDevEnvironment/getting-started-azure-openai.md index ba96950c..09b22b7f 100644 --- a/translations/tw/02-SetupDevEnvironment/getting-started-azure-openai.md +++ b/translations/zh-TW/02-SetupDevEnvironment/getting-started-azure-openai.md @@ -1,12 +1,3 @@ - # 設置 Azure OpenAI 開發環境 > **快速開始**：本指南適用於 Azure OpenAI 的設置。如果想立即使用免費模型，請參考 [GitHub Models with Codespaces](./README.md#quick-start-cloud)。 @@ -75,7 +66,7 @@ CO_OP_TRANSLATOR_METADATA: > **注意**：如果您想編輯基本配置，請查看 [Dev Container Configuration](../../../.devcontainer/devcontainer.json) 2. 在您的 Fork 存儲庫中，點擊 **Code** → **Codespaces** 標籤 3. 點擊 **...** → **New with options...** -![使用選項創建 Codespace](../../../translated_images/tw/codespaces.9945ded8ceb431a5.webp) +![使用選項創建 Codespace](../../../translated_images/zh-TW/codespaces.9945ded8ceb431a5.webp) 4. 選擇 **Dev container configuration**： - **Generative AI Java Development Environment** 5. 點擊 **Create codespace** diff --git a/translations/tw/03-CoreGenerativeAITechniques/README.md b/translations/zh-TW/03-CoreGenerativeAITechniques/README.md similarity index 98% rename from translations/tw/03-CoreGenerativeAITechniques/README.md rename to translations/zh-TW/03-CoreGenerativeAITechniques/README.md index 3829be79..9f785910 100644 --- a/translations/tw/03-CoreGenerativeAITechniques/README.md +++ b/translations/zh-TW/03-CoreGenerativeAITechniques/README.md @@ -1,12 +1,3 @@ - # 核心生成式 AI 技術教學 ## 目錄 diff --git a/translations/tw/04-PracticalSamples/README.md b/translations/zh-TW/04-PracticalSamples/README.md similarity index 93% rename from translations/tw/04-PracticalSamples/README.md rename to translations/zh-TW/04-PracticalSamples/README.md index a2242714..fc7b0ba1 100644 --- a/translations/tw/04-PracticalSamples/README.md +++ b/translations/zh-TW/04-PracticalSamples/README.md @@ -1,12 +1,3 @@ - # 實用應用與專案 ## 你將學到什麼 diff --git a/translations/tw/04-PracticalSamples/calculator/README.md b/translations/zh-TW/04-PracticalSamples/calculator/README.md similarity index 97% rename from translations/tw/04-PracticalSamples/calculator/README.md rename to translations/zh-TW/04-PracticalSamples/calculator/README.md index bc68b142..443ca088 100644 --- a/translations/tw/04-PracticalSamples/calculator/README.md +++ b/translations/zh-TW/04-PracticalSamples/calculator/README.md @@ -1,12 +1,3 @@ - # MCP 計算器初學者教程 ## 目錄 diff --git a/translations/tw/04-PracticalSamples/foundrylocal/README.md b/translations/zh-TW/04-PracticalSamples/foundrylocal/README.md similarity index 98% rename from translations/tw/04-PracticalSamples/foundrylocal/README.md rename to translations/zh-TW/04-PracticalSamples/foundrylocal/README.md index c58539ce..b983f331 100644 --- a/translations/tw/04-PracticalSamples/foundrylocal/README.md +++ b/translations/zh-TW/04-PracticalSamples/foundrylocal/README.md @@ -1,12 +1,3 @@ - # Foundry Local Spring Boot 教學 ## 目錄 diff --git a/translations/tw/04-PracticalSamples/petstory/README.md b/translations/zh-TW/04-PracticalSamples/petstory/README.md similarity index 98% rename from translations/tw/04-PracticalSamples/petstory/README.md rename to translations/zh-TW/04-PracticalSamples/petstory/README.md index 801f4658..bfafdbfd 100644 --- a/translations/tw/04-PracticalSamples/petstory/README.md +++ b/translations/zh-TW/04-PracticalSamples/petstory/README.md @@ -1,12 +1,3 @@ - # 寵物故事生成器初學者教程 ## 目錄 diff --git a/translations/tw/05-ResponsibleGenAI/README.md b/translations/zh-TW/05-ResponsibleGenAI/README.md similarity index 95% rename from translations/tw/05-ResponsibleGenAI/README.md rename to translations/zh-TW/05-ResponsibleGenAI/README.md index 5cfe2d23..6b313246 100644 --- a/translations/tw/05-ResponsibleGenAI/README.md +++ b/translations/zh-TW/05-ResponsibleGenAI/README.md @@ -1,12 +1,3 @@ - # 負責任的生成式 AI ## 你將學到什麼 @@ -58,7 +49,7 @@ GitHub Models 提供基本的內容過濾功能，就像在 AI 俱樂部裡有 5. 顯示結果，展示哪些內容被阻擋、拒絕或允許 6. 測試安全內容以進行比較 -![負責任的 AI 安全示範](../../../translated_images/tw/responsible.e4f51a917bafa4bf.webp) +![負責任的 AI 安全示範](../../../translated_images/zh-TW/responsible.e4f51a917bafa4bf.webp) ### 設定指引 @@ -164,7 +155,7 @@ Status: Response generated successfully 恭喜完成生成式 AI 初學者課程！ -![課程完成](../../../translated_images/tw/image.73c7e2ff4a652e77.webp) +![課程完成](../../../translated_images/zh-TW/image.73c7e2ff4a652e77.webp) **你已完成的內容：** - 設置你的開發環境 diff --git a/translations/tw/AGENTS.md b/translations/zh-TW/AGENTS.md similarity index 97% rename from translations/tw/AGENTS.md rename to translations/zh-TW/AGENTS.md index c7db5c09..93a1fd0a 100644 --- a/translations/tw/AGENTS.md +++ b/translations/zh-TW/AGENTS.md @@ -1,12 +1,3 @@ - # AGENTS.md ## 專案概述 diff --git a/translations/tw/CODE_OF_CONDUCT.md b/translations/zh-TW/CODE_OF_CONDUCT.md similarity index 79% rename from translations/tw/CODE_OF_CONDUCT.md rename to translations/zh-TW/CODE_OF_CONDUCT.md index f9810ddb..3243707b 100644 --- a/translations/tw/CODE_OF_CONDUCT.md +++ b/translations/zh-TW/CODE_OF_CONDUCT.md @@ -1,12 +1,3 @@ - # 微軟開源行為準則 此專案已採用[微軟開源行為準則](https://opensource.microsoft.com/codeofconduct/)。 diff --git a/translations/zh-TW/README.md b/translations/zh-TW/README.md new file mode 100644 index 00000000..1661c4b1 --- /dev/null +++ b/translations/zh-TW/README.md @@ -0,0 +1,138 @@ +# Generative AI 初學者指南 - Java 版 +[![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) + +![Generative AI 初學者指南 - Java 版](../../translated_images/zh-TW/beg-genai-series.8b48be9951cc574c.webp) + +**所需時間**：整個工作坊可在線上完成，無需本地端設定。環境設定約需 2 分鐘，探索範例約需 1-3 小時，視探索深度而定。 + +> **快速開始** + +1. 將此資源庫分支到您的 GitHub 帳戶 +2. 點選 **Code** → **Codespaces** 標籤 → **...** → **New with options...** +3. 使用預設值 — 這會選擇為本課程建立的開發容器 +4. 點選 **Create codespace** +5. 等待約 2 分鐘讓環境準備完成 +6. 直接跳到 [第一個範例](./02-SetupDevEnvironment/README.md#step-2-create-a-github-personal-access-token) + +> **偏好本地端克隆？** +> +> 此資源庫包含 50 多種語言翻譯，會顯著增加下載大小。如欲不下載翻譯檔，請使用 sparse checkout： +> ```bash +> git clone --filter=blob:none --sparse https://github.com/microsoft/Generative-AI-for-beginners-java.git +> cd Generative-AI-for-beginners-java +> git sparse-checkout set --no-cone '/*' '!translations' '!translated_images' +> ``` +> 這能讓您以更快的速度下載所需完成課程的所有內容。 + +## 多語言支援 + +### 透過 GitHub Action 支援（自動化且始終保持最新） + + +[阿拉伯語](../ar/README.md) | [孟加拉語](../bn/README.md) | [保加利亞語](../bg/README.md) | [緬甸語 (緬甸)](../my/README.md) | [中文 (簡體)](../zh-CN/README.md) | [中文 (繁體，香港)](../zh-HK/README.md) | [中文 (繁體，澳門)](../zh-MO/README.md) | [中文 (繁體，台灣)](./README.md) | [克羅地亞語](../hr/README.md) | [捷克語](../cs/README.md) | [丹麥語](../da/README.md) | [荷蘭語](../nl/README.md) | [愛沙尼亞語](../et/README.md) | [芬蘭語](../fi/README.md) | [法語](../fr/README.md) | [德語](../de/README.md) | [希臘語](../el/README.md) | [希伯來語](../he/README.md) | [印地語](../hi/README.md) | [匈牙利語](../hu/README.md) | [印尼語](../id/README.md) | [義大利語](../it/README.md) | [日語](../ja/README.md) | [坎納達語](../kn/README.md) | [韓語](../ko/README.md) | [立陶宛語](../lt/README.md) | [馬來語](../ms/README.md) | [馬拉雅拉姆語](../ml/README.md) | [馬拉地語](../mr/README.md) | [尼泊爾語](../ne/README.md) | [尼日利亞皮欽語](../pcm/README.md) | [挪威語](../no/README.md) | [波斯語 (法爾西)](../fa/README.md) | [波蘭語](../pl/README.md) | [葡萄牙語 (巴西)](../pt-BR/README.md) | [葡萄牙語 (葡萄牙)](../pt-PT/README.md) | [旁遮普語 (古魯穆奇)](../pa/README.md) | [羅馬尼亞語](../ro/README.md) | [俄語](../ru/README.md) | [塞爾維亞語 (西里爾字母)](../sr/README.md) | [斯洛伐克語](../sk/README.md) | [斯洛維尼亞語](../sl/README.md) | [西班牙語](../es/README.md) | [斯瓦希里語](../sw/README.md) | [瑞典語](../sv/README.md) | [塔加洛語 (菲律賓語)](../tl/README.md) | [泰米爾語](../ta/README.md) | [泰盧固語](../te/README.md) | [泰語](../th/README.md) | [土耳其語](../tr/README.md) | [烏克蘭語](../uk/README.md) | [烏爾都語](../ur/README.md) | [越南語](../vi/README.md) + +> **偏好本地端克隆？** + +> 此資源庫包含 50 多種語言翻譯，會顯著增加下載大小。如欲不下載翻譯檔，請使用 sparse checkout： +> ```bash +> git clone --filter=blob:none --sparse https://github.com/microsoft/Generative-AI-for-beginners-java.git +> cd Generative-AI-for-beginners-java +> git sparse-checkout set --no-cone '/*' '!translations' '!translated_images' +> ``` +> 這能讓您以更快的速度下載所需完成課程的所有內容。 + + +## 課程結構與學習路徑 + +### **第一章：生成式 AI 簡介** +- **核心概念**：認識大型語言模型、詞元、嵌入向量與 AI 能力 +- **Java AI 生態系統**：Spring AI 與 OpenAI SDK 概覽 +- **模型上下文協定**：介紹 MCP 及其在 AI 代理通訊中的角色 +- **實務應用**：實際案例包含聊天機器人與內容生成 +- **[→ 開始第一章](./01-IntroToGenAI/README.md)** + +### **第二章：開發環境設定** +- **多供應商設定**：GitHub Models、Azure OpenAI 及 OpenAI Java SDK 整合 +- **Spring Boot + Spring AI**：企業級 AI 應用開發最佳實務 +- **GitHub Models**：免費 AI 模型存取來快速原型開發與學習 (無需信用卡) +- **開發工具**：Docker 容器、VS Code 與 GitHub Codespaces 配置 +- **[→ 開始第二章](./02-SetupDevEnvironment/README.md)** + +### **第三章：生成式 AI 核心技術** +- **提示工程**：取得最佳 AI 模型回應的技巧 +- **嵌入向量與向量操作**：實作語義搜尋與相似度比對 +- **檢索增強生成 (RAG)**：將 AI 與您的資料源結合 +- **函數呼叫**：使用自訂工具及外掛延伸 AI 能力 +- **[→ 開始第三章](./03-CoreGenerativeAITechniques/README.md)** + +### **第四章：實務應用與專案** +- **寵物故事產生器** (`petstory/`)：利用 GitHub Models 創造內容生成 +- **Foundry 本地端示範** (`foundrylocal/`)：OpenAI Java SDK 本地端模型整合 +- **MCP 計算器服務** (`calculator/`)：基礎模型上下文協定與 Spring AI 實作 +- **[→ 開始第四章](./04-PracticalSamples/README.md)** + +### **第五章：負責任的 AI 開發** +- **GitHub Models 安全機制**：測試內建內容過濾與安全機制（硬阻擋與軟拒絕） +- **負責任 AI 示範**：實務範例展示現代 AI 安全機制運作 +- **最佳實務**：倫理 AI 開發與部署的核心指引 +- **[→ 開始第五章](./05-ResponsibleGenAI/README.md)** + +## 額外資源 + + +### LangChain +[![LangChain4j 初學者指南](https://img.shields.io/badge/LangChain4j%20for%20Beginners-22C55E?style=for-the-badge&&labelColor=E5E7EB&color=0553D6)](https://aka.ms/langchain4j-for-beginners) +[![LangChain.js 初學者指南](https://img.shields.io/badge/LangChain.js%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=0553D6)](https://aka.ms/langchainjs-for-beginners?WT.mc_id=m365-94501-dwahlin) + +--- + +### Azure / Edge / MCP / Agents +[![AZD 初學者指南](https://img.shields.io/badge/AZD%20for%20Beginners-0078D4?style=for-the-badge&labelColor=E5E7EB&color=0078D4)](https://github.com/microsoft/AZD-for-beginners?WT.mc_id=academic-105485-koreyst) +[![Edge AI 初學者指南](https://img.shields.io/badge/Edge%20AI%20for%20Beginners-00B8E4?style=for-the-badge&labelColor=E5E7EB&color=00B8E4)](https://github.com/microsoft/edgeai-for-beginners?WT.mc_id=academic-105485-koreyst) +[![MCP 初學者指南](https://img.shields.io/badge/MCP%20for%20Beginners-009688?style=for-the-badge&labelColor=E5E7EB&color=009688)](https://github.com/microsoft/mcp-for-beginners?WT.mc_id=academic-105485-koreyst) +[![AI 代理初學者指南](https://img.shields.io/badge/AI%20Agents%20for%20Beginners-00C49A?style=for-the-badge&labelColor=E5E7EB&color=00C49A)](https://github.com/microsoft/ai-agents-for-beginners?WT.mc_id=academic-105485-koreyst) + +--- + +### 生成式 AI 系列 +[![Generative AI 初學者指南](https://img.shields.io/badge/Generative%20AI%20for%20Beginners-8B5CF6?style=for-the-badge&labelColor=E5E7EB&color=8B5CF6)](https://github.com/microsoft/generative-ai-for-beginners?WT.mc_id=academic-105485-koreyst) +[![Generative AI (.NET)](https://img.shields.io/badge/Generative%20AI%20(.NET)-9333EA?style=for-the-badge&labelColor=E5E7EB&color=9333EA)](https://github.com/microsoft/Generative-AI-for-beginners-dotnet?WT.mc_id=academic-105485-koreyst) +[![Generative AI (Java)](https://img.shields.io/badge/Generative%20AI%20(Java)-C084FC?style=for-the-badge&labelColor=E5E7EB&color=C084FC)](https://github.com/microsoft/generative-ai-for-beginners-java?WT.mc_id=academic-105485-koreyst) +[![Generative AI (JavaScript)](https://img.shields.io/badge/Generative%20AI%20(JavaScript)-E879F9?style=for-the-badge&labelColor=E5E7EB&color=E879F9)](https://github.com/microsoft/generative-ai-with-javascript?WT.mc_id=academic-105485-koreyst) + +--- + +### 核心學習 +[![機器學習 初學者](https://img.shields.io/badge/ML%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=22C55E)](https://aka.ms/ml-beginners?WT.mc_id=academic-105485-koreyst) +[![資料科學 初學者](https://img.shields.io/badge/Data%20Science%20for%20Beginners-84CC16?style=for-the-badge&labelColor=E5E7EB&color=84CC16)](https://aka.ms/datascience-beginners?WT.mc_id=academic-105485-koreyst) +[![人工智慧 初學者](https://img.shields.io/badge/AI%20for%20Beginners-A3E635?style=for-the-badge&labelColor=E5E7EB&color=A3E635)](https://aka.ms/ai-beginners?WT.mc_id=academic-105485-koreyst) +[![資安 初學者](https://img.shields.io/badge/Cybersecurity%20for%20Beginners-F97316?style=for-the-badge&labelColor=E5E7EB&color=F97316)](https://github.com/microsoft/Security-101?WT.mc_id=academic-96948-sayoung) + +[![Web Dev for Beginners](https://img.shields.io/badge/Web%20Dev%20for%20Beginners-EC4899?style=for-the-badge&labelColor=E5E7EB&color=EC4899)](https://aka.ms/webdev-beginners?WT.mc_id=academic-105485-koreyst) +[![IoT for Beginners](https://img.shields.io/badge/IoT%20for%20Beginners-14B8A6?style=for-the-badge&labelColor=E5E7EB&color=14B8A6)](https://aka.ms/iot-beginners?WT.mc_id=academic-105485-koreyst) +[![XR Development for Beginners](https://img.shields.io/badge/XR%20Development%20for%20Beginners-38BDF8?style=for-the-badge&labelColor=E5E7EB&color=38BDF8)](https://github.com/microsoft/xr-development-for-beginners?WT.mc_id=academic-105485-koreyst) + +--- + +### Copilot 系列 +[![Copilot for AI Paired Programming](https://img.shields.io/badge/Copilot%20for%20AI%20Paired%20Programming-FACC15?style=for-the-badge&labelColor=E5E7EB&color=FACC15)](https://aka.ms/GitHubCopilotAI?WT.mc_id=academic-105485-koreyst) +[![Copilot for C#/.NET](https://img.shields.io/badge/Copilot%20for%20C%23/.NET-FBBF24?style=for-the-badge&labelColor=E5E7EB&color=FBBF24)](https://github.com/microsoft/mastering-github-copilot-for-dotnet-csharp-developers?WT.mc_id=academic-105485-koreyst) +[![Copilot Adventure](https://img.shields.io/badge/Copilot%20Adventure-FDE68A?style=for-the-badge&labelColor=E5E7EB&color=FDE68A)](https://github.com/microsoft/CopilotAdventures?WT.mc_id=academic-105485-koreyst) + + +## 尋求協助 + +如果您在建立 AI 應用程式時遇到困難或有任何問題，歡迎加入與其他學習者及經驗豐富的開發者一同討論 MCP。這是一個支持性的社群，鼓勵提問並自由分享知識。 + +[![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) + +如果您在開發過程中有產品反饋或發現錯誤，請造訪： + +[![Microsoft Foundry Developer Forum](https://img.shields.io/badge/GitHub-Microsoft_Foundry_Developer_Forum-blue?style=for-the-badge&logo=github&color=000000&logoColor=fff)](https://aka.ms/foundry/forum) + +--- + + +**免責聲明**： +本文件是使用 AI 翻譯服務 [Co-op Translator](https://github.com/Azure/co-op-translator) 進行翻譯。雖然我們力求準確，但請注意，自動翻譯可能包含錯誤或不準確之處。原始文件的母語版本應視為權威來源。對於重要資訊，建議採用專業人工翻譯。我們不對因使用此翻譯而產生的任何誤解或誤譯負責。 + \ No newline at end of file diff --git a/translations/tw/SECURITY.md b/translations/zh-TW/SECURITY.md similarity index 93% rename from translations/tw/SECURITY.md rename to translations/zh-TW/SECURITY.md index ea9647bb..344d7089 100644 --- a/translations/tw/SECURITY.md +++ b/translations/zh-TW/SECURITY.md @@ -1,12 +1,3 @@ - ## 安全性 Microsoft 非常重視我們軟體產品和服務的安全性，這包括透過我們的 GitHub 組織管理的所有原始碼庫，這些組織包括 [Microsoft](https://github.com/Microsoft)、[Azure](https://github.com/Azure)、[DotNet](https://github.com/dotnet)、[AspNet](https://github.com/aspnet) 和 [Xamarin](https://github.com/xamarin)。 diff --git a/translations/tw/SUPPORT.md b/translations/zh-TW/SUPPORT.md similarity index 80% rename from translations/tw/SUPPORT.md rename to translations/zh-TW/SUPPORT.md index 2774463c..02cea340 100644 --- a/translations/tw/SUPPORT.md +++ b/translations/zh-TW/SUPPORT.md @@ -1,12 +1,3 @@ - # 支援 ## 如何提交問題和獲取幫助 diff --git a/translations/zh/02-SetupDevEnvironment/README.md b/translations/zh/02-SetupDevEnvironment/README.md deleted file mode 100644 index 1ad14266..00000000 --- a/translations/zh/02-SetupDevEnvironment/README.md +++ /dev/null @@ -1,13 +0,0 @@ - - - ---- - diff --git a/translations/zh/README.md b/translations/zh/README.md deleted file mode 100644 index 96c78b8f..00000000 --- a/translations/zh/README.md +++ /dev/null @@ -1,146 +0,0 @@ - -# 生成式人工智能初学者指南 - Java 版 -[![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) - -![生成式人工智能初学者指南 - Java 版](../../translated_images/zh/beg-genai-series.8b48be9951cc574c.webp) - -**时间投入**：整个工作坊可以在线完成，无需本地设置。环境设置需要2分钟，浏览示例根据探索深度需要1-3小时。 - -> **快速开始** - -1. 将此仓库分叉到您的 GitHub 账户 -2. 点击 **Code** → **Codespaces** 标签 → **...** → **New with options...** -3. 使用默认设置 – 这将选择为本课程创建的开发容器 -4. 点击 **Create codespace** -5. 等待约2分钟，环境即准备就绪 -6. 直接跳转到 [第一个示例](./02-SetupDevEnvironment/README.md#step-2-create-a-github-personal-access-token) - -> **想要本地克隆？** -> -> 本仓库包括50多种语言的翻译，极大增加了下载大小。若想在不下载翻译的情况下克隆，请使用稀疏检出： -> ```bash -> git clone --filter=blob:none --sparse https://github.com/microsoft/Generative-AI-for-beginners-java.git -> cd Generative-AI-for-beginners-java -> git sparse-checkout set --no-cone '/*' '!translations' '!translated_images' -> ``` -> 这样您可以用更快的下载速度完整获得完成课程所需要的一切。 - -## 多语言支持 - -### 通过 GitHub Action 提供支持（自动且始终保持最新） - - -[阿拉伯语](../ar/README.md) | [孟加拉语](../bn/README.md) | [保加利亚语](../bg/README.md) | [缅甸语 (Myanmar)](../my/README.md) | [中文（简体）](./README.md) | [中文（繁体，香港）](../hk/README.md) | [中文（繁体，澳门）](../mo/README.md) | [中文（繁体，台湾）](../tw/README.md) | [克罗地亚语](../hr/README.md) | [捷克语](../cs/README.md) | [丹麦语](../da/README.md) | [荷兰语](../nl/README.md) | [爱沙尼亚语](../et/README.md) | [芬兰语](../fi/README.md) | [法语](../fr/README.md) | [德语](../de/README.md) | [希腊语](../el/README.md) | [希伯来语](../he/README.md) | [印地语](../hi/README.md) | [匈牙利语](../hu/README.md) | [印尼语](../id/README.md) | [意大利语](../it/README.md) | [日语](../ja/README.md) | [卡纳达语](../kn/README.md) | [韩语](../ko/README.md) | [立陶宛语](../lt/README.md) | [马来语](../ms/README.md) | [马拉雅拉姆语](../ml/README.md) | [马拉地语](../mr/README.md) | [尼泊尔语](../ne/README.md) | [尼日利亚皮钦语](../pcm/README.md) | [挪威语](../no/README.md) | [波斯语 (法尔西)](../fa/README.md) | [波兰语](../pl/README.md) | [葡萄牙语（巴西）](../br/README.md) | [葡萄牙语（葡萄牙）](../pt/README.md) | [旁遮普语 (古鲁穆奇)](../pa/README.md) | [罗马尼亚语](../ro/README.md) | [俄语](../ru/README.md) | [塞尔维亚语（西里尔文）](../sr/README.md) | [斯洛伐克语](../sk/README.md) | [斯洛文尼亚语](../sl/README.md) | [西班牙语](../es/README.md) | [斯瓦希里语](../sw/README.md) | [瑞典语](../sv/README.md) | [他加禄语（菲律宾语）](../tl/README.md) | [泰米尔语](../ta/README.md) | [泰卢固语](../te/README.md) | [泰语](../th/README.md) | [土耳其语](../tr/README.md) | [乌克兰语](../uk/README.md) | [乌尔都语](../ur/README.md) | [越南语](../vi/README.md) - -> **想要本地克隆？** - -> 本仓库包括50多种语言的翻译，极大增加了下载大小。若想在不下载翻译的情况下克隆，请使用稀疏检出： -> ```bash -> git clone --filter=blob:none --sparse https://github.com/microsoft/Generative-AI-for-beginners-java.git -> cd Generative-AI-for-beginners-java -> git sparse-checkout set --no-cone '/*' '!translations' '!translated_images' -> ``` -> 这样您可以用更快的下载速度完整获得完成课程所需要的一切。 - - -## 课程结构与学习路径 - -### **第一章：生成式人工智能简介** -- **核心概念**：理解大型语言模型、标记、嵌入向量及 AI 能力 -- **Java AI 生态系统**：Spring AI 和 OpenAI SDK 概述 -- **模型上下文协议**：介绍 MCP 及其在 AI 代理通信中的作用 -- **实际应用**：包括聊天机器人和内容生成的真实场景 -- **[→ 开始第一章](./01-IntroToGenAI/README.md)** - -### **第二章：开发环境设置** -- **多服务商配置**：设置 GitHub 模型、Azure OpenAI 和 OpenAI Java SDK 集成 -- **Spring Boot + Spring AI**：企业级 AI 应用开发最佳实践 -- **GitHub 模型**：免费 AI 模型访问，用于原型开发和学习（无信用卡要求） -- **开发工具**：Docker 容器、VS Code 和 GitHub Codespaces 配置 -- **[→ 开始第二章](./02-SetupDevEnvironment/README.md)** - -### **第三章：核心生成式 AI 技术** -- **提示工程**：优化 AI 模型响应的技巧 -- **嵌入向量与向量操作**：实现语义搜索和相似度匹配 -- **检索增强生成 (RAG)**：将 AI 与您的数据源结合 -- **函数调用**：使用自定义工具和插件扩展 AI 能力 -- **[→ 开始第三章](./03-CoreGenerativeAITechniques/README.md)** - -### **第四章：实际应用与项目** -- **宠物故事生成器** (`petstory/`)：使用 GitHub 模型进行创意内容生成 -- **Foundry 本地演示** (`foundrylocal/`)：使用 OpenAI Java SDK 的本地 AI 模型集成 -- **MCP 计算服务** (`calculator/`)：用 Spring AI 实现基础模型上下文协议 -- **[→ 开始第四章](./04-PracticalSamples/README.md)** - -### **第五章：负责任的 AI 开发** -- **GitHub 模型安全**：测试内置内容过滤和安全机制（硬阻止和软拒绝） -- **负责任 AI 演示**：实操示例展示现代 AI 安全系统的工作方式 -- **最佳实践**：道德 AI 开发与部署的基本指导 -- **[→ 开始第五章](./05-ResponsibleGenAI/README.md)** - -## 额外资源 - - -### LangChain -[![LangChain4j for Beginners](https://img.shields.io/badge/LangChain4j%20for%20Beginners-22C55E?style=for-the-badge&&labelColor=E5E7EB&color=0553D6)](https://aka.ms/langchain4j-for-beginners) -[![LangChain.js for Beginners](https://img.shields.io/badge/LangChain.js%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=0553D6)](https://aka.ms/langchainjs-for-beginners?WT.mc_id=m365-94501-dwahlin) - ---- - -### Azure / Edge / MCP / Agents -[![AZD for Beginners](https://img.shields.io/badge/AZD%20for%20Beginners-0078D4?style=for-the-badge&labelColor=E5E7EB&color=0078D4)](https://github.com/microsoft/AZD-for-beginners?WT.mc_id=academic-105485-koreyst) -[![Edge AI for Beginners](https://img.shields.io/badge/Edge%20AI%20for%20Beginners-00B8E4?style=for-the-badge&labelColor=E5E7EB&color=00B8E4)](https://github.com/microsoft/edgeai-for-beginners?WT.mc_id=academic-105485-koreyst) -[![MCP for Beginners](https://img.shields.io/badge/MCP%20for%20Beginners-009688?style=for-the-badge&labelColor=E5E7EB&color=009688)](https://github.com/microsoft/mcp-for-beginners?WT.mc_id=academic-105485-koreyst) -[![AI Agents for Beginners](https://img.shields.io/badge/AI%20Agents%20for%20Beginners-00C49A?style=for-the-badge&labelColor=E5E7EB&color=00C49A)](https://github.com/microsoft/ai-agents-for-beginners?WT.mc_id=academic-105485-koreyst) - ---- - -### 生成式 AI 系列 -[![生成式人工智能初学者指南](https://img.shields.io/badge/Generative%20AI%20for%20Beginners-8B5CF6?style=for-the-badge&labelColor=E5E7EB&color=8B5CF6)](https://github.com/microsoft/generative-ai-for-beginners?WT.mc_id=academic-105485-koreyst) -[![生成式人工智能 (.NET)](https://img.shields.io/badge/Generative%20AI%20(.NET)-9333EA?style=for-the-badge&labelColor=E5E7EB&color=9333EA)](https://github.com/microsoft/Generative-AI-for-beginners-dotnet?WT.mc_id=academic-105485-koreyst) -[![生成式人工智能 (Java)](https://img.shields.io/badge/Generative%20AI%20(Java)-C084FC?style=for-the-badge&labelColor=E5E7EB&color=C084FC)](https://github.com/microsoft/generative-ai-for-beginners-java?WT.mc_id=academic-105485-koreyst) -[![生成式人工智能 (JavaScript)](https://img.shields.io/badge/Generative%20AI%20(JavaScript)-E879F9?style=for-the-badge&labelColor=E5E7EB&color=E879F9)](https://github.com/microsoft/generative-ai-with-javascript?WT.mc_id=academic-105485-koreyst) - ---- - -### 核心学习 -[![机器学习初学者](https://img.shields.io/badge/ML%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=22C55E)](https://aka.ms/ml-beginners?WT.mc_id=academic-105485-koreyst) -[![数据科学初学者](https://img.shields.io/badge/Data%20Science%20for%20Beginners-84CC16?style=for-the-badge&labelColor=E5E7EB&color=84CC16)](https://aka.ms/datascience-beginners?WT.mc_id=academic-105485-koreyst) -[![人工智能初学者](https://img.shields.io/badge/AI%20for%20Beginners-A3E635?style=for-the-badge&labelColor=E5E7EB&color=A3E635)](https://aka.ms/ai-beginners?WT.mc_id=academic-105485-koreyst) -[![网络安全初学者](https://img.shields.io/badge/Cybersecurity%20for%20Beginners-F97316?style=for-the-badge&labelColor=E5E7EB&color=F97316)](https://github.com/microsoft/Security-101?WT.mc_id=academic-96948-sayoung) -[![网页开发初学者](https://img.shields.io/badge/Web%20Dev%20for%20Beginners-EC4899?style=for-the-badge&labelColor=E5E7EB&color=EC4899)](https://aka.ms/webdev-beginners?WT.mc_id=academic-105485-koreyst) -[![IoT for Beginners](https://img.shields.io/badge/IoT%20for%20Beginners-14B8A6?style=for-the-badge&labelColor=E5E7EB&color=14B8A6)](https://aka.ms/iot-beginners?WT.mc_id=academic-105485-koreyst) -[![XR Development for Beginners](https://img.shields.io/badge/XR%20Development%20for%20Beginners-38BDF8?style=for-the-badge&labelColor=E5E7EB&color=38BDF8)](https://github.com/microsoft/xr-development-for-beginners?WT.mc_id=academic-105485-koreyst) - ---- - -### Copilot 系列 -[![Copilot for AI Paired Programming](https://img.shields.io/badge/Copilot%20for%20AI%20Paired%20Programming-FACC15?style=for-the-badge&labelColor=E5E7EB&color=FACC15)](https://aka.ms/GitHubCopilotAI?WT.mc_id=academic-105485-koreyst) -[![Copilot for C#/.NET](https://img.shields.io/badge/Copilot%20for%20C%23/.NET-FBBF24?style=for-the-badge&labelColor=E5E7EB&color=FBBF24)](https://github.com/microsoft/mastering-github-copilot-for-dotnet-csharp-developers?WT.mc_id=academic-105485-koreyst) -[![Copilot Adventure](https://img.shields.io/badge/Copilot%20Adventure-FDE68A?style=for-the-badge&labelColor=E5E7EB&color=FDE68A)](https://github.com/microsoft/CopilotAdventures?WT.mc_id=academic-105485-koreyst) - - -## 获取帮助 - -如果您遇到困难或对构建 AI 应用有任何疑问。加入其他学习者和经验丰富的开发者的讨论，了解 MCP 相关内容。这里是一个支持性的社区，欢迎提问并自由分享知识。 - -[![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) - -如果您在构建过程中有产品反馈或遇到错误，请访问： - -[![Microsoft Foundry Developer Forum](https://img.shields.io/badge/GitHub-Microsoft_Foundry_Developer_Forum-blue?style=for-the-badge&logo=github&color=000000&logoColor=fff)](https://aka.ms/foundry/forum) - ---- - - -**免责声明**： -本文件由 AI 翻译服务 [Co-op Translator](https://github.com/Azure/co-op-translator) 翻译而成。虽然我们力求准确，但请注意，自动翻译可能包含错误或不准确之处。请以原始语言的原始文档为权威来源。对于重要信息，建议使用专业人工翻译。因使用本翻译而产生的任何误解或误译，我们概不负责。 - \ No newline at end of file