diff --git a/00-course-setup/translations/ja-jp/README.md b/00-course-setup/translations/ja-jp/README.md index efb5d5b3f..b3377ad84 100644 --- a/00-course-setup/translations/ja-jp/README.md +++ b/00-course-setup/translations/ja-jp/README.md @@ -1,6 +1,6 @@ # このコースを始めるために -私たちは、皆様がこのコースを開始し生成 AI で何を創り出すのかを見るのが、とても楽しみです！ +私たちは、皆様がこのコースを開始して、生成 AI を使って何を作り出してくださるのか、それを見るのがとても楽しみです！ 皆様がこのレッスンを成功できるよう、セットアップ手順と技術要件そして必要な時に情報を得る方法を、このページにまとめました。 @@ -10,40 +10,43 @@ ### 1. リポジトリのフォーク -コードを修正したりレッスンの課題を完了するため、このリポジトリ全てをご自身の GitHub アカウントで[フォーク](https://github.com/microsoft/generative-ai-for-beginners/fork?WT.mc_id=academic-105485-yoterada)してください。また、簡単にこのリポジトリを見つけれるよう、[スター（🌟）をつける](https://docs.github.com/en/get-started/exploring-projects-on-github/saving-repositories-with-stars?WT.mc_id=academic-105485-yoterada)こともできます。 +コードを修正したり、レッスン課題を終了するため、このリポジトリをご自身の GitHub アカウントに[フォーク](https://github.com/microsoft/generative-ai-for-beginners/fork?WT.mc_id=academic-105485-yoterada)してください。また後から、簡単にこのリポジトリを見つけられるように、[スター（🌟）をつける](https://docs.github.com/en/get-started/exploring-projects-on-github/saving-repositories-with-stars?WT.mc_id=academic-105485-yoterada)のもお勧めです。 ### 2. codespaces を作成 コードを実行する際、依存関係の問題を避けるため、GitHub codespaces で、このコースを実行することをお勧めします。 -codespaces は、上記でフォークしたリポジトリの `Code` を選択し、**Codespaces** オプションを選択することで作成できます。 +codespaces は、上記でフォークしたリポジトリの `Code` を選択し、**Codespaces** オプションを選択することで作成できます。 + +![codespaceを作成するボタンを示すダイアログ](../../images/who-will-pay.webp?WT.mc_id=academic-105485-yoterada) + +> **ご注意** (訳者追記)： +Fork したリポジトリで Codespace を利用する場合、Codespace の使用料はマイクロソフトが支払います。 ### 3. API　キーの保管 アプリケーションを構築する際、API キーを安全に管理することはとても重要です。公開リポジトリにこうした機密情報をコミットすると、不正利用による想定外のコストや問題が発生する可能性があります。そこで、作業中のコードに直接 API キーを保存しないようにしてください。 -![codespaceを作成するボタンを示すダイアログ](../../images/who-will-pay.webp?WT.mc_id=academic-105485-yoterada) - ## ローカルのコンピュータで実行する方法 ローカルのコンピュータ上で、コードを実行するためには、[Python のインストール](https://www.python.org/downloads/?WT.mc_id=academic-105485-yoterada)が必要です。 -そして、リポジトリを使用するためクローンする必要があります +そして、下記のようにリポジトリをクローンする必要があります ```shell git clone https://github.com/microsoft/generative-ai-for-beginners cd generative-ai-for-beginners ``` -これですべての準備が整いましたので、学習と作業を始めることができます。 +以上で準備が整ったので、学習と作業を始められます。 ### miniconda　のインストール　（オプションの手順） -**[miniconda](https://conda.io/en/latest/miniconda.html?WT.mc_id=academic-105485-yoterada)** のインストールをお勧めします - これは、異なる Python **仮想環境**で `conda` パッケージ・マネージャをサポートする、比較的軽量なインストーラーです。`conda` を利用すると、異なる Python のバージョンやパッケージを簡単にインストールでき、切り替えるもできます。さらに、`pip` 経由で入手できないパッケージのインストールもできます。 +下記は省略可能な手順ですが、可能であれば **[miniconda](https://conda.io/en/latest/miniconda.html?WT.mc_id=academic-105485-yoterada)** のインストールをお勧めします - これは、異なる Python **仮想環境**で `conda` パッケージ・マネージャをサポートする、比較的軽量なインストーラーです。`conda` を利用すると、異なる Python のバージョンやパッケージを簡単にインストールでき、切り替えもできます。さらに、`pip` を利用して公開されているパッケージのインストールもできます。 -miniconda をインストールした後、リポジトリをクローンしてください（まだ行っていない場合）。そして、このレッスン用の仮想環境を作成してください： +miniconda をインストールした後、リポジトリをクローンしてください（まだ行っていない場合）。そして、このレッスン用に下記の手順で新たな仮想環境を作成してください： -下記の手順を実行する前に、まず *environment.yml* ファイルが存在していることをご確認ください。*environment.yml* ファイルは、conda　環境の構築に必要な依存関係を定義した設定ファイルで、下記のような内容を記述します： +まず *environment.yml* ファイルが存在しているかご確認ください。*environment.yml* ファイルは、conda　環境の構築に必要な依存関係を定義した設定ファイルで、下記の内容を記述します： ```yml name: @@ -68,15 +71,15 @@ conda activate ai4beg ### Python の拡張機能をインストールした Visual Studio Code の使用 -本カリキュラムを進めていく上で最もお勧めの方法は、[Python の拡張機能を](https://marketplace.visualstudio.com/items?itemName=ms-python.python&WT.mc_id=academic-105485-yoterada)インストールした [Visual Studio Code](http://code.visualstudio.com/?WT.mc_id=academic-105485-yoterada) のご利用です。 +このカリキュラムを進める際には、[Python の拡張機能](https://marketplace.visualstudio.com/items?itemName=ms-python.python&WT.mc_id=academic-105485-yoterada)をインストールした [Visual Studio Code](http://code.visualstudio.com/?WT.mc_id=academic-105485-yoterada) の使用を特にお勧めします。 -> **ご注意**: クローンした後、VS Code でディレクトリを開くと、自動的に Python 拡張機能のインストールが提案されます。上記で説明したように miniconda もインストールする必要があります。 +> **ご注意**: クローンした後、VS Code でディレクトリを開くと、自動的に Python 拡張機能のインストールが提案されます。上記で説明したように miniconda もインストールしてください。 -> **ご注意**: ローカルにインストールした Python を利用したい場合、VS Code がコンテナでリポジトリを再度開くことを提案した際、コンテナでの起動を拒否してください。 +> **ご注意**: 仮に、ローカルにインストールした Python を利用したい場合、VS Code がコンテナでリポジトリを再度開くことを提案してきた時、その提案を拒否してください。 ### ブラウザで Jupyter の使用 -ご自身のコンピュータの Web ブラウザから直接、Jupyter 環境を使用することもできます。実際クラシックな Jupyter と Jupyter Hub は、自動補完、コード・ハイライトなどの機能を備えた非常に便利な開発環境を提供します。 +ご自分のコンピュータの Web ブラウザを利用して直接 Jupyter 環境を利用できます。実際クラシックな Jupyter と Jupyter Hub は、自動補完、コード・ハイライトなどの機能を備えた非常に便利な開発環境を提供します。 Jupyter をローカルで起動するには、レッスン・コースのディレクトリに移動し、下記のコマンドを実行します： @@ -90,25 +93,25 @@ jupyter notebook jupyterhub ``` -次に任意の `.ipynb` ファイルに移動し、ファイルを開いて作業を開始できます。 +次に任意の `.ipynb` ファイルに移動し、ファイルを開いて作業を開始します。 ### コンテナでの実行 -ローカル環境に Python をインストールする代わりに、コンテナ上で実行することもできます。このプロジェクトを fork するとレポジトリ内に、コンテナ環境を構築するために必要な設定を含む `.devcontainer` フォルダが存在します。そこで、VS Code は起動時にコンテナで実行することを提案します。コンテナで実行する為には、事前に Docker のインストールが必要で、少し複雑になるため経験豊富なユーザーにお勧めします。 +ローカル環境に Python をインストールする代わりに、コンテナ上でも実行できます。このプロジェクトを fork するとレポジトリ内に、コンテナ・イメージを構築するために必要な設定を含む `.devcontainer` フォルダが存在します。そして VS Code は設定ファイルに記載した内容を元に、コンテナ上での実行を提案します。コンテナで実行する為には、事前に Docker のインストールと起動が必要です。コンテナ環境のセットアップは少し複雑になるため経験豊富なユーザーにお勧めします。 -GitHub codespaces を使用して API キーを安全に管理するためには、Codespace Secrets の利用が最適です。[codespaces のシークレットを管理](https://docs.github.com/en/codespaces/managing-your-codespaces/managing-secrets-for-your-codespaces?WT.mc_id=academic-105485-yoterada)する方法については、このガイドをご参照ください。 +GitHub codespaces を使用して API キーを安全に管理するためには、Codespace Secrets の利用が最適です。[codespaces のシークレットを管理](https://docs.github.com/en/codespaces/managing-your-codespaces/managing-secrets-for-your-codespaces?WT.mc_id=academic-105485-yoterada)する方法については、リンク先のガイドをご参照ください。 ## レッスンと技術要件 このコースは、6 つの概念レッスンと 6 つのコーディング・レッスンがあります。 -コーディング・レッスンでは、Azure OpenAI サービスを使用します。コードを実行するには、Azure OpenAI サービスへのアクセスと API キーが必要です。[このアプリケーション・フォームを完了](https://go.microsoft.com/fwlink/?linkid=2222006&clcid=0x409?WT.mc_id=academic-105485-yoterada)することで Azure OpenAI へアクセス申請できます。 +コーディング・レッスンでは、Azure OpenAI サービスを使用します。コードを実行するには、Azure OpenAI サービスへのアクセス権限と API キーが必要です。[こちらのアプリケーション・フォームに記入](https://go.microsoft.com/fwlink/?linkid=2222006&clcid=0x409?WT.mc_id=academic-105485-yoterada)し Azure OpenAI へアクセス申請を行います。 -アプリケーション・フォーム申請処理の完了を待つ間、何もできないわけではなく、各レッスン中に、`README.md` ファイルとサンプル・コードが含まれていますので、申請処理の完了前でもレッスンの内容をご確認いただけます。 +アプリケーション・フォームの申請処理が完了するまで、何もできないわけではありません。各レッスン中に、`README.md` ファイルとサンプル・コードが含まれていますので、申請処理が完了する前でもレッスンの内容をご確認いただけます。 ## Azure OpenAI サービスをはじめて使用する場合 -仮に Azure OpenAI サービスをはじめて使用する場合は、[Azure OpenAI サービス・リソースを作成しデプロイする方法](https://learn.microsoft.com/azure/ai-services/openai/how-to/create-resource?pivots=web-portal&WT.mc_id=academic-105485-yoterada)はこちらのガイドをご参照ください。 +仮に Azure OpenAI サービスをはじめて使用する場合は、[Azure OpenAI サービスのリソースを作成しデプロイする](https://learn.microsoft.com/azure/ai-services/openai/how-to/create-resource?pivots=web-portal&WT.mc_id=academic-105485-yoterada)必要があります。リソースの作成方法はリンク先のガイドをご参照ください。 ## 他の学習者との交流 @@ -122,11 +125,12 @@ GitHub codespaces を使用して API キーを安全に管理するためには 本レッスンはオープンソース・プロジェクトとして公開しています。仮に改善すべき点や問題を発見したら、[プルリクエスト](https://github.com/microsoft/generative-ai-for-beginners/pulls?WT.mc_id=academic-105485-yoterada)をお送りいただくか、もしくは、[GitHub の Issue](https://github.com/microsoft/generative-ai-for-beginners/issues?WT.mc_id=academic-105485-yoterada) で報告していただければ幸いです。 -このプロジェクトの開発チームは全ての貢献を確認しています。オープンソースにご貢献いただくことは、生成 AI の分野で新しいキャリアを築くのに良い方法かもしれません。 +このプロジェクトの開発チームは全ての貢献を確認しています。そしてオープン・ソース・プロジェクトに貢献すると、生成 AI の分野で新しいキャリアを築ける可能性もあります。 多くの場合、貢献者はコントリビューター・ライセンス契約（CLA）に同意して頂く必要があります。これは貢献者が持っている権利を、私たちに、皆様の貢献を使用する権利を実際に与えて頂くことを宣言するための契約です。詳細については [CLA、コントリビューターライセンス契約のウェブサイト](https://cla.microsoft.com?WT.mc_id=academic-105485-yoterada)をご覧ください。 -重要なお知らせ：このリポジトリ内に含まれるテキストを翻訳する場合、機械翻訳の使用は避けてください。翻訳の内容はコミュニティで検証するため、ご自身が熟知している言語でのみ翻訳作業にご協力ください。 +重要なお知らせ： +このリポジトリ内に含まれるテキストを翻訳する場合、機械翻訳の使用は避けてください。翻訳内容はコミュニティで検証するため、ご自身が熟知している言語でのみ翻訳作業にご協力ください。 プル・リクエストを提出すると、CLA-bot が自動的に CLA（コントリビューター・ライセンス契約）の提出が必要かどうかを判断し、プル・リクエストに適切なマーク（例：ラベル、コメント）を付けます。bot の指示にお従いください。この処理は、CLA を使用するすべてのリポジトリで一度だけ行う必要があります。 diff --git a/translations/ja-jp/README.md b/translations/ja-jp/README.md index 7a0d1a446..473bd3c94 100644 --- a/translations/ja-jp/README.md +++ b/translations/ja-jp/README.md @@ -18,38 +18,38 @@ # 初心者のための生成 AI - コース -マイクロソフトのクラウド・アドボケイトが提供する、全12回のレッスンで生成 AI アプリケーション構築の基礎知識を身につけましょう。各レッスンで、生成 AI の基礎知識やアプリの実装に必要なキーポイントをしっかり押さえます。このコースを通じて、自分だけの生成 AI のスタートアップ企業を作りながらアイデアを形にする過程を実際に体験できます。 +マイクロソフトのクラウド・アドボケイトが提供する、全 12 回のレッスンを通して、生成 AI アプリケーション構築の基礎知識を身につけましょう。各レッスンで、生成 AI の基礎知識やアプリの実装に必要な重要ポイントをしっかりと理解できるようにします。このコースを通じて、自分だけの生成 AI のスタートアップ企業を作りながら、アイデアを形にする過程を実際に体験できます。 ## 🌱 はじめに -まず初めに、このリポジトリ全体をご自身の GitHub　アカウントで [fork](https://github.com/microsoft/generative-ai-for-beginners/fork?WT.mc_id=academic-105485-yoterada) してください。すると、コードの変更や各課題を修了することができるようになります。また、後から見つけやすくするために、このリポジトリに[スター 🌟 をつける](https://docs.github.com/en/get-started/exploring-projects-on-github/saving-repositories-with-stars?WT.mc_id=academic-105485-yoterada) のもおすすめです。 +まずはじめに、このリポジトリをご自分の GitHub アカウントに[フォーク](https://github.com/microsoft/generative-ai-for-beginners/fork?WT.mc_id=academic-105485-yoterada)してください。 すると、コードの変更や各課題を修了することができるようになります。また、後から探しやすくするために、このリポジトリに[スター 🌟 をつけて](https://docs.github.com/en/get-started/exploring-projects-on-github/saving-repositories-with-stars?WT.mc_id=academic-105485-yoterada) おくことをお勧めします。 -各レッスンのリンクは、下記に掲載しています。最も関心のあるレッスンからご自由に始めてください！ +各レッスンのリンクは、下記に記載しています。興味のあるレッスンからご自由に始めてください！ -ご自身に最適なセットアップ方法を見つけるために、[コース・セットアップ・ページ](../../00-course-setup/README.md?WT.mc_id=academic-105485-yoterada)にアクセスしてください。 +ご自身に最適なセットアップ方法を見つけるために、[コース・セットアップ・ページ](../../00-course-setup/translations/ja-jp/README.md?WT.mc_id=academic-105485-yoterada)にアクセスしてください。 ## 🗣️ 他の学習者と出会ったり、サポートを受ける -学習する上で最も効果的な方法は、他の方と一緒に学ぶことです！[公式 AI Discord サーバー](https://aka.ms/genai-discord?WT.mc_id=academic-105485-yoterada)に参加し、このコースを受講している他の学習者と出会って交流し助け合いましょう。もしかすると、そこで次のあなたの共同創業者が見つかるかもしれないですね！ +学びを深めるには、他の人と一緒に学ぶことが最も効果的です。！[公式の AI Discord サーバー](https://aka.ms/genai-discord?WT.mc_id=academic-105485-yoterada)に参加して、このコースを受講している他の学習者と出会い、交流し、助け合いましょう。そこで、新たなビジネス・パートナーが見つかる可能性もありますよ！ -## 🧠 さらに知識を深めたいですか？ +## 🧠 もっと知識を深めたいですか？ -このコースを終了後、さらに生成 AI に関する知識を深めたい場合は、[生成 AI 学習コレクション](https://aka.ms/genai-collection?WT.mc_id=academic-105485-yoterada)を、ぜひご覧ください！ +このコースを終了後、さらに生成 AI に関する知識を深めるために、[生成 AI 学習コレクション](https://aka.ms/genai-collection?WT.mc_id=academic-105485-yoterada)を、ぜひご覧ください！ ## 🚀 スタートアップですか、それとも実現したいアイデアはありますか？ -その場合、[Microsoft for Startups Founders Hub](https://aka.ms/genai-foundershub?WT.mc_id=academic-105485-yoterada) にご登録いただくと、**OpenAI クレジットを無料で**もらえるだけでなく、**最大で $150k の Azure クレジットを獲得し、Azure OpenAI サービスで OpenAI のモデルを利用**することができます。 +その場合、[Microsoft for Startups Founders Hub](https://aka.ms/genai-foundershub?WT.mc_id=academic-105485-yoterada) にご登録いただくと、**無料で OpenAI クレジットを**もらえるだけでなく、**最大で $150k の Azure クレジットを獲得し、Azure OpenAI のサービスを通じて OpenAI のモデルを利用**することができます。 ## 🙏 ご協力いただける方を募集しています 貢献して頂ける方法をいくつかご紹介します： -- 文章の誤字脱字やコードに間違いを発見したら、[問題(Issue)で指摘する](https://github.com/microsoft/generative-ai-for-beginners/issues?WT.mc_id=academic-105485-yoterada)か[プルリクエストを送ってください](https://github.com/microsoft/generative-ai-for-beginners/pulls?WT.mc_id=academic-105485-yoterada) -- 私たちに、新しいレッスンや演習アイデアなどの提案をお送りいただき、コースの改善点を教えてください +- 文章に誤字や脱字、コードの間違いを発見したら、GitHub の[問題 (Issue) として報告して頂く](https://github.com/microsoft/generative-ai-for-beginners/issues?WT.mc_id=academic-105485-yoterada)か[プル・リクエストを送ってください](https://github.com/microsoft/generative-ai-for-beginners/pulls?WT.mc_id=academic-105485-yoterada) +- 新しいレッスンや演習のアイデアをご提案していただき、コースをより良くするための改善点を教えてください。 ## 📂 各レッスンに含まれる内容 -- トピックの概要を説明する短い動画 +- トピックの概要を紹介する短い動画 - README に記載されているレッスン - サンプル・コードを含む Jupyter Notebook（プロジェクト形式のレッスンの場合） - 学習内容を活用した課題やチャレンジ @@ -71,11 +71,11 @@ | 10 | [ローコード AI アプリケーションの構築](../../10-building-low-code-ai-applications/translations/ja-jp/README.md?WT.mc_id=academic-105485-yoterada) | **Low Code:** Power Platform における生成 AI の概要 | 教育系スタートアップ企業がローコードで学生の課題追跡アプリを構築する | | 11 | [Function Calling との統合](../../11-integrating-with-function-calling/translations/ja-jp/README.md?WT.mc_id=academic-105485-yoterada) | **Code:** Function Calling とアプリケーションにおける用途 | 外部 API からデータを取得するため Function Calling を設定する | | 12 | [AI アプリケーション用の UX デザイン](../../12-designing-ux-for-ai-applications/translations/ja-jp/README.md?WT.mc_id=academic-105485-yoterada) | **概念:** 透明性と信頼性を備えたAIアプリケーションの設計 | 生成 AI アプリケーションの開発時に UX デザインの原則を適用する | -| xx | [学習の継続](../../13-continued-learning/translations/ja-jp/README.md?WT.mc_id=academic-105485-yoterada) | 各授業の内容をさらに進めるための参考リンク! | 生成 AI の技術をマスターするために | +| xx | [学習の継続](../../13-continued-learning/translations/ja-jp/README.md?WT.mc_id=academic-105485-yoterada) | 各授業の内容をさらに進めるための参考リンク! | 生成 AI の技術をマスターするために | ## 🎒 その他のコース -私たちは他のコースも提供しています！ぜひご覧ください： +他のコースも提供しています！ぜひご覧ください： - [初心者のための ML](https://aka.ms/ml-beginners?WT.mc_id=academic-105485-yoterada) - [初心者のための Data Science](https://aka.ms/datascience-beginners?WT.mc_id=academic-105485-yoterada)