Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Sign up
Appearance settings

[TRANSLATION] add japanese version for unit0/1 & communication #567

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Draft
ktro2828 wants to merge 3 commits into huggingface:main
base: main
Choose a base branch
Loading
from ktro2828:translation/ja/unit0
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .github/workflows/build_documentation.yml
View file Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -14,6 +14,6 @@ jobs:
package_name: agents-course
path_to_docs: agents-course/units/
additional_args: --not_python_module
languages: en zh-CN ru-RU vi es ko
languages: en zh-CN ru-RU vi es ko ja
secrets:
hf_token: ${{ secrets.HF_DOC_BUILD_PUSH }}
2 changes: 1 addition & 1 deletion .github/workflows/build_pr_documentation.yml
View file Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -17,4 +17,4 @@ jobs:
package_name: agents-course
path_to_docs: agents-course/units/
additional_args: --not_python_module
languages: en zh-CN ru-RU vi es ko
languages: en zh-CN ru-RU vi es ko ja
44 changes: 44 additions & 0 deletions units/ja/_toctree.yml
View file Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,44 @@
- title: Unit 0. Welcome to the course
sections:
- local: unit0/introduction
title: Welcome to the course 🤗
- local: unit0/onboarding
title: Onboarding
- local: unit0/discord101
title: (Optional) Discord 101
- title: Live 1. How the course works and Q&A
sections:
- local: communication/live1
title: Live 1. How the course works and Q&A
- title: Unit 1. Introduction to Agents
sections:
- local: unit1/introduction
title: Introduction
- local: unit1/what-are-agents
title: What is an Agent?
- local: unit1/quiz1
title: Quick Quiz 1
- local: unit1/what-are-llms
title: What are LLMs?
- local: unit1/messages-and-special-tokens
title: Messages and Special Tokens
- local: unit1/tools
title: What are Tools?
- local: unit1/quiz2
title: Quick Quiz 2
- local: unit1/agent-steps-and-structure
title: Understanding AI Agents through the Thought-Action-Observation Cycle
- local: unit1/thoughts
title: Thought, Internal Reasoning and the Re-Act Approach
- local: unit1/actions
title: Actions, Enabling the Agent to Engage with Its Environment
- local: unit1/observations
title: Observe, Integrating Feedback to Reflect and Adapt
- local: unit1/dummy-agent-library
title: Dummy Agent Library
- local: unit1/tutorial
title: Let’s Create Our First Agent Using smolagents
- local: unit1/final-quiz
title: Unit 1 Final Quiz
- local: unit1/conclusion
title: Conclusion
7 changes: 7 additions & 0 deletions units/ja/communication/live1.mdx
View file Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
# Live 1: コースの仕組みと最初のQ&A

Agentsコースの最初のライブストリームでは、コースの**仕組み**(範囲、ユニット、チャレンジなど)について説明し、あなたの質問に答えました。

<iframe width="560" height="315" src="https://www.youtube.com/embed/iLVyYDbdSmM?si=TCX5Ai3uZuKLXq45" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen></iframe>

次のライブセッションのスケジュールを知りたい場合は、**Discordサーバー**をチェックしてください。また、メールでもお知らせします。参加できない場合でも心配しないでください。すべてのライブセッションを**録画**しています。
52 changes: 52 additions & 0 deletions units/ja/unit0/discord101.mdx
View file Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,52 @@
# (Optional) Discord 101 [[discord-101]]

<img src="https://huggingface.co/datasets/agents-course/course-images/resolve/main/en/unit0/discord-etiquette.jpg" alt="The Discord Etiquette" width="100%"/>

このガイドは、ゲームや機械学習コミュニティで人気のある無料チャットプラットフォーム、Discordを始めるためのものです。

Hugging FaceコミュニティのDiscordサーバーには、**10万人以上のメンバー**がいます。以下の<a href="https://discord.gg/UrrTSsSyjb" target="_blank">リンク</a>をクリックして参加してください!他の人とつながる素晴らしい場所です!

## AgentsコースをHugging FaceのDiscordコミュニティで

Discordを始めるのは少し圧倒されるかもしれませんが、ナビゲートを手助けするための簡単なガイドを用意しました。

<!-- Not the case anymore, you'll be prompted to choose your interests. Be sure to select **"AI Agents"** to gain access to the AI Agents Category, which includes all the course-related channels. Feel free to explore and join additional channels if you wish! 🚀-->

HFコミュニティサーバーは、さまざまな分野に興味を持つ活気あるコミュニティをホストしており、論文の議論、イベントなどを通じて学ぶ機会を提供しています。

[サインアップ](http://hf.co/join/discord)したら、`#introduce-yourself`チャンネルで自己紹介をしてください。

私たちは、Agentsコースのために4つのチャンネルを作成しました:

- `agents-course-announcements`: **最新のコース情報**を確認するためのチャンネル
- `🎓-agents-course-general`: **一般的な議論や雑談**のためのチャンネル
- `agents-course-questions`: **質問をしたり、メンバーを助けたり**するためのチャンネル
- `agents-course-showcase`: **自分のエージェントを公開する**ためのチャンネル

さらに、以下のチャンネルもチェックできます:

- `smolagents`: **ライブラリに関する議論やサポート**を受けるためのチャンネル。

## Discordを効果的に使うためのヒント

### サーバーに参加する方法

Discordにあまり慣れていない場合は、サーバーに参加する方法についての<a href="https://support.discord.com/hc/en-us/articles/360034842871-How-do-I-join-a-Server#h_01FSJF9GT2QJMS2PRAW36WNBS8" target="_blank">ガイド</a>を確認することをお勧めします。

以下は手順の簡単な概要です:

1. <a href="https://discord.gg/UrrTSsSyjb" target="_blank">招待リンク</a>をクリックします。
2. Discordアカウントでサインインするか、アカウントを作成します。
3. AIエージェントではないことを確認します。
4. ニックネームとアバターを設定します。
5. "サーバーに参加"をクリックします。

### Discordを効果的に使うためのヒント

Discordを効果的に使うためのいくつかのヒントを紹介します:

- **ボイスチャンネル**も利用可能ですが、テキストチャットがより一般的に使用されます。
- **マークダウンスタイル**を使用してテキストをフォーマットできます。これは特にコードを書く際に便利です。ただし、マークダウンはリンクにはあまり適していません。
- **長い会話**を整理するためにスレッドを開くことを検討してください。

このガイドが役に立つことを願っています!質問がある場合は、Discordでお気軽にお尋ねください🤗。
187 changes: 187 additions & 0 deletions units/ja/unit0/introduction.mdx
View file Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,187 @@
# 🤗 AI Agents Courseへようこそ [[introduction]]

<figure>
<img src="https://huggingface.co/datasets/agents-course/course-images/resolve/main/en/unit0/thumbnail.jpg" alt="AI Agents Course thumbnail" width="100%"/>
<figcaption>背景画像は<a href="https://scenario.com/">Scenario.com</a>によって作成されました</figcaption>
</figure>


昨今のAIで最もエキサイティングなトピック、**エージェント**へようこそ!

この無料コースでは、AIエージェントを理解し、使用し、構築するための旅に、**初心者から専門家まで**お連れします。

この最初のユニットでは、オンボーディングを手助けします:

- **コースのシラバス**を確認する。
- 自己監査または認定プロセスのいずれか、**進むべき道を選択する**。
- **認定プロセスについての詳細情報を取得する**。
- コースの背後にいるチームを知る。
- **Hugging Faceアカウント**を作成する。
- **Discordサーバーにサインアップ**し、クラスメートや私たちと出会いましょう。

さあ、始めましょう!

## このコースで学べること [[expect]]

このコースでは、以下のことを学びます:

- 📖 AIエージェントの**理論、設計、実践**を学ぶ。
- 🧑‍💻 [smolagents](https://huggingface.co/docs/smolagents/en/index)、[LlamaIndex](https://www.llamaindex.ai/)、[LangGraph](https://langchain-ai.github.io/langgraph/)などの**確立されたAIエージェントライブラリを使用する**方法を学ぶ。
- 💾 **自分のエージェントを共有する**ためにHugging Face Hubを利用し、コミュニティが作成したエージェントを探索する。
- 🏆 他の学生のエージェントと**自分のエージェントを評価する**チャレンジに参加する。
- 🎓 課題を完了することで**修了証明書を取得する**。

さらには!

このコースの終わりには、**エージェントの仕組みと最新のライブラリやツールを使用して自分のエージェントを構築する方法**を理解できるようになります。

**<a href="https://bit.ly/hf-learn-agents">こちらにサインアップすることもお忘れなく!</a>**


(私たちはあなたのプライバシーを尊重します。**各ユニットが公開されるときにリンクを送信し、課題や更新に関する情報を提供できるように、あなたのメールアドレスを収集します**)。

## コースの内容について [[course-look-like]]

コースは以下で構成されています:

- *基礎ユニット*: エージェントの**理論**を学ぶ場所です。
- *Hands-on*: エージェントをユニークな環境でトレーニングするための**確立されたAIエージェントライブラリを使用する**方法を学ぶ場所です。これらのハンズオンセクションは、**Hugging Face Spaces**で事前に構成された環境を使用します。
- *ユースケース課題*: 学んだ概念を適用して、自分が選んだ実世界の問題を解決する場所です。
- *チャレンジ*: 自分のエージェントを他のエージェントと競わせることができる場所です。また、エージェントのパフォーマンスを比較するための[リーダーボード](https://huggingface.co/spaces/agents-course/Students_leaderboard)も用意されています。

この**コースはあなたのフィードバックや貢献に応じて進化する生きたプロジェクトです!** [GitHubで問題やPRをオープンする](https://github.com/huggingface/agents-course)ことや、Discordサーバーでの議論に参加することを自由に行ってください。

コースを修了した後は、[👉 このフォームを使用して](https://docs.google.com/forms/d/e/1FAIpQLSe9VaONn0eglax0uTwi29rIn4tM7H2sYmmybmG5jJNlE5v0xA/viewform?usp=dialog)フィードバックを送信することもできます。

## コースのシラバスについて [[syllabus]]

こちらが**コースの一般的なシラバス**です。各ユニットとともに、より詳細なトピックリストが公開されます。

| チャプター | トピック | 説明 |
| :---- | :---- | :---- |
| 0 | オンボーディング | 使用するツールやプラットフォームのセットアップを行います。 |
| 1 | エージェント基礎 | ツール、思考、行動、観察、およびその形式について説明します。LLM、メッセージ、特殊トークン、チャットテンプレートについて説明します。ツールとしてPython関数を使用した簡単なユースケースを示します。 |
| 2 | フレームワーク | 基礎がどのように人気のあるライブラリ(smolagents、LangGraph、LLamaIndex)に実装されているかを理解します。 |
| 3 | ユースケース | 実際のユースケースを構築します(経験豊富なエージェントビルダーからのPRを歓迎します🤗)。 |
| 4 | 最終課題 | 選択したベンチマーク用のエージェントを構築し、学生リーダーボードでエージェントの理解を証明します🚀。 |

メインのシラバスに加えて、3つのボーナスユニットがあります:
- *ボーナスユニット1*: 関数呼び出しのためにLLMを微調整する
- *ボーナスユニット2*: エージェントの可観測性と評価
- *ボーナスユニット3*: ポケモンを使用したゲーム内エージェント

例えば、ボーナスユニット3では、ポケモンバトルをプレイするためのエージェントを構築する方法を学びます🥊。

## 必要な事前知識について

このコースを受講するには、以下の知識が必要です。

- Pythonの基本的な知識
- LLMの基本的な知識(ユニット1に要約セクションがあります)

## 必要なツールについて [[tools]]

必要なものは2つだけです。

- *インターネット接続のあるコンピュータ*
- *Hugging Faceアカウント*: モデル、エージェントをプッシュおよびロードし、Spacesを作成するために必要です。まだアカウントをお持ちでない場合は、**[こちら](https://hf.co/join)**から作成できます(無料です)。
<img src="https://huggingface.co/datasets/agents-course/course-images/resolve/main/en/unit0/tools.jpg" alt="Course tools needed" width="100%"/>

## 認定プロセス [[certification-process]]

<img src="https://huggingface.co/datasets/agents-course/course-images/resolve/main/en/unit0/three-paths.jpg" alt="Two paths" width="100%"/>

このコースを*監査モード*で受講するか、アクティビティを実施して*発行される2つの証明書のいずれかを取得する*ことができます。

コースを監査する場合は、すべての課題に参加し、必要に応じて課題を実施できます。また、**通知する必要はありません**。

認定プロセスは**完全に無料**です。

- *基礎の認定を取得するには*: コースのユニット1を完了する必要があります。これは、エージェントの最新のトレンドを把握したい学生を対象としています。
- *修了証明書を取得するには*: ユニット1、コース中に提案されるユースケース課題の1つ、および最終チャレンジを完了する必要があります。

認定プロセスに**締切はありません**。

## コースの推奨学習ペース [[recommended-pace]]

このコースの各章は、**1週間で完了することを想定しており、週に約3〜4時間の作業が必要です**。

推奨ペースを以下に示します:

<img src="https://huggingface.co/datasets/agents-course/course-images/resolve/main/en/unit0/recommended-pace.jpg" alt="Recommended Pace" width="100%"/>

## コースを最大限に活用するには? [[advice]]

このコースを最大限に活用するためのアドバイスがあります。

1. <a href="https://discord.gg/UrrTSsSyjb">Discordで勉強グループに参加する</a>: グループで学ぶことは常に簡単です。そのためには、私たちのDiscordサーバーに参加し、Hugging Faceアカウントを確認する必要があります。
2. **クイズや課題を実施する**: 学ぶ最良の方法は、実践と自己評価を通じてです。
3. **スケジュールを定義して同期を保つ**: 推奨ペースのスケジュールを使用するか、自分自身のスケジュールを作成できます。

<img src="https://huggingface.co/datasets/agents-course/course-images/resolve/main/en/unit0/advice.jpg" alt="Course advice" width="100%"/>

## 私たちについて [[who-are-we]]

私たちについて:

### Joffrey Thomas

JoffreyはHugging Faceの機械学習エンジニアで、AIエージェントをプロダクション環境で構築および展開しています。Joffreyはこのコースの主なインストラクターです。

- [Follow Joffrey on Hugging Face](https://huggingface.co/Jofthomas)
- [Follow Joffrey on X](https://x.com/Jthmas404)
- [Follow Joffrey on Linkedin](https://www.linkedin.com/in/joffrey-thomas/)

### Ben Burtenshaw

BenはHugging Faceの機械学習エンジニアで、さまざまなプラットフォームで複数のコースを提供しています。Benの目標は、すべての人がコースにアクセスできるようにすることです。

- [Follow Ben on Hugging Face](https://huggingface.co/burtenshaw)
- [Follow Ben on X](https://x.com/ben_burtenshaw)
- [Follow Ben on Linkedin](https://www.linkedin.com/in/ben-burtenshaw/)

### Thomas Simonini

ThomasはHugging Faceの機械学習エンジニアで、AIエージェントの分野に情熱を注いでいます。彼は<a href="https://huggingface.co/learn/deep-rl-course/unit0/introduction">Deep RL</a>および<a href="https://huggingface.co/learn/ml-games-course/en/unit0/introduction">ML for games</a>コースを提供しました。Thomasはエージェントの大ファンであり、コミュニティが何を構築するのかを見るのを楽しみにしています。

- [Follow Thomas on Hugging Face](https://huggingface.co/ThomasSimonini)
- [Follow Thomas on X](https://x.com/ThomasSimonini)
- [Follow Thomas on Linkedin](https://www.linkedin.com/in/simoninithomas/)


### Sergio Paniego

SergioはHugging Faceの機械学習エンジニアです。彼はユニット2、3、4、およびボーナスユニットのいくつかのセクションに貢献しました。

- [Follow Sergio on Hugging Face](https://huggingface.co/sergiopaniego)
- [Follow Sergio on X](https://x.com/sergiopaniego)
- [Follow Sergio on Linkedin](https://www.linkedin.com/in/sergio-paniego-blanco/)

## 謝辞

私たちは、このコースへの貴重な貢献に対して以下の個人に感謝の意を表したいと思います。

- **[Pedro Cuenca](https://huggingface.co/pcuenq)** - 材料のレビューにおける彼の指導と専門知識に感謝します。
- **[Aymeric Roucher](https://huggingface.co/m-ric)** - 彼の素晴らしいデモスペース(デコーディングと最終エージェント)や、smolagentsパーツへの彼の助けに感謝します。
- **[Joshua Lochner](https://huggingface.co/Xenova)** - トークン化に関する彼の素晴らしいデモスペースに感謝します。
- **[Quentin Gallouédec](https://huggingface.co/qgallouedec)** - コースコンテンツに関する彼の助けに感謝します。
- **[David Berenstein](https://huggingface.co/davidberenstein1957)** - コースコンテンツとモデレーションに関する彼の助けに感謝します。
- **[XiaXiao (ShawnSiao)](https://huggingface.co/SSSSSSSiao)** - コースの中国語翻訳者。
- **[Jiaming Huang](https://huggingface.co/nordicsushi)** - コースの中国語翻訳者。

## バグを見つけた、またはコースを改善したい場合 [[contribute]]

コントリビューションは**大歓迎**です 🤗

- *ノートブック内でバグ🐛を見つけた場合*は、<a href="https://github.com/huggingface/agents-course/issues">issueを開いて問題を説明してください</a>。
- *コースを改善したい場合*は、<a href="https://github.com/huggingface/agents-course/pulls">Pull Requestを開いてください</a>。
- *新しいセクションやユニットを追加したい場合*は、<a href="https://github.com/huggingface/agents-course/issues">issueを開いて、書き始める前に追加したいコンテンツを説明してください</a>。そうすれば、私たちがガイドできます。

## 他に質問がある場合 [[questions]]

もしまだ質問がある場合は、私たちの<a href="https://discord.gg/UrrTSsSyjb">Discordサーバーの#agents-course-questions</a>チャンネルで質問してください。私たちのコミュニティメンバーやコースチームが喜んでお手伝いします。

以上がコースの概要です。それでは、オンボードに進みましょう!⛵:

<img src="https://huggingface.co/datasets/agents-course/course-images/resolve/main/en/unit0/time-to-onboard.jpg" alt="Time to Onboard" width="100%"/>

Loading

AltStyle によって変換されたページ (->オリジナル) /