Skip to content
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

[TRANSLATION] translated to fr communication, unit0 unit1 #145

Open
wants to merge 1 commit into
base: main
Choose a base branch
from
Open
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
50 changes: 50 additions & 0 deletions units/fr/_toctree.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,50 @@
- title: Unité 0. Bienvenue dans le cours
sections:
- local: unit0/introduction
title: Bienvenue dans le cours 🤗
- local: unit0/onboarding
title: Intégration
- local: unit0/discord101
title: (Optionnel) Discord 101
- title: Live 1. Comment fonctionne le cours et Q&R
sections:
- local: communication/live1
title: Live 1. Comment fonctionne le cours et Q&R
- title: Unité 1. Introduction aux Agents
sections:
- local: unit1/introduction
title: Introduction
- local: unit1/what-are-agents
title: Qu'est-ce qu'un Agent ?
- local: unit1/quiz1
title: Quiz rapide 1
- local: unit1/what-are-llms
title: Que sont les LLMs ?
- local: unit1/messages-and-special-tokens
title: Messages et Tokens Spéciaux
- local: unit1/tools
title: Que sont les Outils ?
- local: unit1/quiz2
title: Quiz rapide 2
- local: unit1/agent-steps-and-structure
title: Comprendre les Agents IA à travers le cycle Pensée-Action-Observation
- local: unit1/thoughts
title: Pensée, Raisonnement Interne et l'Approche Re-Act
- local: unit1/actions
title: Actions, permettant à l'Agent d'interagir avec son environnement
- local: unit1/observations
title: Observer, intégrer les retours pour réfléchir et s'adapter
- local: unit1/dummy-agent-library
title: Bibliothèque d'Agents Factices
- local: unit1/tutorial
title: Créons notre premier Agent avec Smolagents
- local: unit1/final-quiz
title: Quiz Final de l'Unité 1
- local: unit1/get-your-certificate
title: Obtenez votre certificat
- local: unit1/conclusion
title: Conclusion
- title: Quand les prochaines unités seront-elles publiées ?
sections:
- local: communication/next-units
title: Prochaines unités
7 changes: 7 additions & 0 deletions units/fr/communication/live1.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
# Live 1 : Comment fonctionne le cours et première session de questions-réponses

Dans ce premier live stream du cours Agents, nous avons expliqué comment le cours **fonctionne** (contenu, unités, défis, et plus encore) et avons répondu à vos questions.

<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>

Pour savoir quand la prochaine session en direct est prévue, consultez notre **serveur Discord**. Nous vous enverrons également un email. Si vous ne pouvez pas participer, ne vous inquiétez pas, nous **enregistrons toutes les sessions en direct**.
7 changes: 7 additions & 0 deletions units/fr/communication/next-units.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
Quand les prochaines unités seront-elles publiées ?
Voici le calendrier de publication :

<img src="https://huggingface.co/datasets/agents-course/course-images/resolve/main/en/communication/next-units.jpg" alt="Next Units" width="100%"/>
N'oubliez pas de <a href="https://bit.ly/hf-learn-agents">vous inscrire au cours</a> ! En vous inscrivant, nous pourrons vous envoyer les liens dès que chaque unité est publiée, ainsi que des mises à jour et des détails sur les défis à venir.

Continuez à apprendre, restez génial 🤗
42 changes: 42 additions & 0 deletions units/fr/unit0/discord101.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,42 @@
(Optionnel) Discord 101 [[discord-101]]
<img src="https://huggingface.co/datasets/agents-course/course-images/resolve/main/en/unit0/discord-etiquette.jpg" alt="L'étiquette sur Discord" width="100%"/>
Ce guide est conçu pour vous aider à débuter sur Discord, une plateforme de chat gratuite très prisée dans les communautés de gaming et de machine learning.

Rejoignez le serveur Discord de la communauté Hugging Face, qui compte plus de 100 000 membres, en cliquant <a href="https://discord.gg/UrrTSsSyjb" target="_blank">ici</a>. C'est un excellent endroit pour se connecter avec d'autres passionnés !

Le cours Agents sur la communauté Discord de Hugging Face
Commencer sur Discord peut sembler un peu intimidant, alors voici un guide rapide pour vous orienter.

<!-- Ce n'est plus le cas, vous serez invité à choisir vos centres d'intérêt. Assurez-vous de sélectionner **« AI Agents »** pour accéder à la catégorie AI Agents, qui comprend tous les canaux relatifs au cours. N'hésitez pas à explorer et rejoindre d'autres canaux si vous le souhaitez ! 🚀-->

Le serveur communautaire HF réunit une communauté dynamique aux intérêts variés, offrant des opportunités d'apprentissage à travers des discussions sur des articles, des événements et bien plus encore.

Après vous être inscrit, présentez-vous dans le canal #introduce-yourself.

Nous avons créé 4 canaux pour le cours sur les Agents :

agents-course-announcements : pour les dernières informations sur le cours.
🎓-agents-course-general : pour les discussions générales et bavardages.
agents-course-questions : pour poser des questions et aider vos camarades.
agents-course-showcase : pour présenter vos meilleurs agents.
De plus, vous pouvez consulter :

smolagents : pour les discussions et l'assistance concernant la bibliothèque.
Conseils pour utiliser Discord efficacement
Comment rejoindre un serveur
Si vous n'êtes pas très familier avec Discord, vous pouvez consulter ce <a href="https://support.discord.com/hc/en-us/articles/360034842871-How-do-I-join-a-Server#h_01FSJF9GT2QJMS2PRAW36WNBS8" target="_blank">guide</a> expliquant comment rejoindre un serveur.

Voici un résumé rapide des étapes :

Cliquez sur le <a href="https://discord.gg/UrrTSsSyjb" target="_blank">lien d'invitation</a>.
Connectez-vous avec votre compte Discord ou créez-en un si vous n'en avez pas.
Vérifiez que vous n'êtes pas un agent IA !
Configurez votre pseudo et votre avatar.
Cliquez sur « Rejoindre le serveur ».
Comment utiliser Discord efficacement
Voici quelques conseils pour tirer le meilleur parti de Discord :

Les canaux vocaux sont disponibles, bien que le chat textuel soit plus utilisé.
Vous pouvez formater votre texte en utilisant le style markdown, ce qui est particulièrement utile pour écrire du code. Notez toutefois que le markdown n'est pas aussi efficace pour les liens.
Pensez à ouvrir des fils de discussion pour les conversations longues afin de garder vos échanges bien organisés.
Nous espérons que ce guide vous sera utile ! Si vous avez des questions, n'hésitez pas à nous les poser sur Discord 🤗.
172 changes: 172 additions & 0 deletions units/fr/unit0/introduction.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,172 @@
# Bienvenue au cours 🤗 AI Agents [[introduction]]

<figure>
<img src="https://huggingface.co/datasets/agents-course/course-images/resolve/main/en/unit0/thumbnail.jpg" alt="Vignette du cours AI Agents" width="100%"/>
<figcaption>L'arrière-plan de l'image a été généré à l'aide de <a href="https://scenario.com/">Scenario.com</a>
</figcaption>
</figure>


Bienvenue dans le sujet le plus passionnant de l'IA aujourd'hui : **Les Agents** !

Ce cours gratuit vous emmènera dans un voyage, **du débutant à l'expert**, pour comprendre, utiliser et construire des agents IA.

Cette première unité va vous aider à démarrer :

- Découvrez le **programme du cours**.
- **Choisissez le parcours** que vous souhaitez suivre (soit en autoformation, soit en suivant le processus de certification).
- **Obtenez plus d'informations sur le processus de certification et les dates limites**.
- Faites connaissance avec l'équipe derrière le cours.
- Créez votre **compte Hugging Face**.
- **Inscrivez-vous à notre serveur Discord** et rencontrez vos camarades ainsi que nous.

C'est parti !

## Que pouvez-vous attendre de ce cours ? [[expect]]

Dans ce cours, vous allez :

- 📖 Étudier les agents IA en **théorie, en conception et en pratique**.
- 🧑‍💻 Apprendre à **utiliser des bibliothèques d'agents IA établies** telles que [smolagents](https://huggingface.co/docs/smolagents/en/index), [LangChain](https://www.langchain.com/), et [LlamaIndex](https://www.llamaindex.ai/).
- 💾 **Partager vos agents** sur le Hugging Face Hub et explorer les agents créés par la communauté.
- 🏆 Participer à des challenges où vous **évaluerez vos agents par rapport à ceux des autres étudiants**.
- 🎓 **Obtenir un certificat de réussite** en complétant les exercices.

Et bien plus encore !

À la fin de ce cours, vous comprendrez **comment fonctionnent les Agents et comment construire vos propres Agents en utilisant les dernières bibliothèques et outils**.

N'oubliez pas de **<a href="https://bit.ly/hf-learn-agents">vous inscrire au cours !</a>**

(Nous respectons votre vie privée. Nous collectons votre adresse email afin de pouvoir **vous envoyer les liens dès que chaque unité est publiée et vous fournir des informations sur les challenges et les mises à jour**.)

## À quoi ressemble le cours ? [[course-look-like]]

Le cours se compose de :

- *Unités fondamentales* : où vous apprenez les **concepts des Agents en théorie**.
- *Pratique* : où vous apprendrez **à utiliser des bibliothèques d'agents IA existantes** pour entraîner vos agents dans des environnements uniques. Ces sessions pratiques se feront dans des **Hugging Face Spaces** avec un environnement préconfiguré.
- *Exercices basés sur des cas d'utilisation* : où vous appliquerez les concepts appris pour résoudre un problème réel de votre choix.
- *Le Challenge* : vous mettrez votre agent en compétition contre d'autres agents dans un challenge. Il y aura également [un classement](https://huggingface.co/spaces/huggingface-projects/AI-Agents-Leaderboard) (pas encore disponible) pour comparer les performances des agents.

Ce **cours est un projet vivant, évoluant avec vos retours et contributions !** N'hésitez pas à [ouvrir des issues et des PR sur GitHub](https://github.com/huggingface/agents-course) et à participer aux discussions sur notre serveur Discord.

Après avoir suivi le cours, vous pouvez également nous envoyer vos retours [👉 via ce formulaire](https://docs.google.com/forms/d/e/1FAIpQLSe9VaONn0eglax0uTwi29rIn4tM7H2sYmmybmG5jJNlE5v0xA/viewform?usp=dialog)

## Quel est le programme ? [[syllabus]]

Voici le **programme général du cours**. Une liste plus détaillée des sujets sera publiée avec chaque unité.

| Chapter | Topic | Description |
| :---- | :---- | :---- |
| 0 | Intégration | Vous préparer avec les outils et plateformes que vous utiliserez. |
| 1 | Fondamentaux des Agents | Expliquer les outils, les pensées, les actions, les observations et leurs formats. Expliquer les LLM, les messages, les tokens spéciaux et les modèles de chat. Présenter un cas d'usage simple en utilisant des fonctions Python comme outils. |
| 2 | Frameworks | Comprendre comment les fondamentaux sont implémentés dans des bibliothèques populaires : smolagents, LangGraph, LlamaIndex |
| 3 | Cas d'utilisation | Construisons quelques cas d'utilisation réels (les PRs 🤗 des constructeurs d'agents expérimentés sont les bienvenus) |
| 4 | Projet final | Construisez un agent pour un benchmark sélectionné et démontrez votre compréhension des Agents sur le classement étudiant 🚀 |

*Nous prévoyons également de publier quelques unités bonus, restez à l'écoute !*

## Quels sont les prérequis ?

Pour pouvoir suivre ce cours, vous devez avoir :

- Une connaissance de base de Python
- Une connaissance de base des LLM (nous avons une section dans l'Unité 1 pour rappeler ce qu'ils sont)


## De quels outils ai-je besoin ? [[tools]]

Vous n'avez besoin que de 2 choses :

- *Un ordinateur* avec une connexion internet.
- Un *compte Hugging Face* : pour pousser et charger des modèles, des agents, et créer des Spaces. Si vous n'avez pas encore de compte, vous pouvez en créer un **[ici](https://hf.co/join)** (c'est gratuit).

<img src="https://huggingface.co/datasets/agents-course/course-images/resolve/main/en/unit0/tools.jpg" alt="Outils nécessaires pour le cours" width="100%"/>

## Le processus de certification [[certification-process]]

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

Vous pouvez choisir de suivre ce cours en *mode auditeur libre*, ou de réaliser les activités et *obtenir l'un des deux certificats que nous délivrerons*.

Si vous suivez le cours en auditeur libre, vous pouvez participer à tous les challenges et faire les exercices si vous le souhaitez, et **vous n'avez pas besoin de nous en informer**.

Le processus de certification est **entièrement gratuit** :

- *Pour obtenir une certification des fondamentaux* : vous devez compléter l'Unité 1 du cours. Ceci est destiné aux étudiants qui souhaitent se tenir à jour avec les dernières tendances en matière d'Agents.
- *Pour obtenir un certificat de réussite* : vous devez compléter l'Unité 1, l'un des exercices de cas d'utilisation que nous proposerons pendant le cours, ainsi que le challenge final.

Il y a une date limite pour le processus de certification : tous les exercices doivent être terminés avant le **1er mai 2025**.

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

## Quel est le rythme recommandé ? [[recommended-pace]]

Chaque chapitre de ce cours est conçu **pour être complété en 1 semaine, avec environ 3 à 4 heures de travail par semaine**.

Comme il y a une date limite, nous vous proposons un rythme recommandé :

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

## Comment tirer le meilleur parti du cours ? [[advice]]

Pour tirer le meilleur parti du cours, nous vous donnons quelques conseils :

1. <a href="https://discord.gg/UrrTSsSyjb">Rejoignez des groupes d'étude sur Discord</a> : étudier en groupe est toujours plus facile. Pour cela, vous devez rejoindre notre serveur Discord et vérifier votre compte Hugging Face.
2. **Faites les quiz et les exercices** : la meilleure façon d'apprendre est par la pratique et l'auto-évaluation.
3. **Définissez un planning pour rester en phase** : vous pouvez utiliser notre planning de rythme recommandé ci-dessous ou créer le vôtre.

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

## Qui sommes-nous ? [[who-are-we]]

À propos des auteurs :

### Joffrey Thomas

Joffrey est ingénieur en machine learning chez Hugging Face et a construit et déployé des agents IA en production. Joffrey sera votre principal instructeur pour ce cours.

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

### Ben Burtenshaw

Ben est ingénieur en machine learning chez Hugging Face et a donné plusieurs cours sur diverses plateformes. L'objectif de Ben est de rendre le cours accessible à tous.

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

### Thomas Simonini

Thomas est ingénieur en machine learning chez Hugging Face et a animé avec succès les cours <a href="https://huggingface.co/learn/deep-rl-course/unit0/introduction">Deep RL</a> et <a href="https://huggingface.co/learn/ml-games-course/en/unit0/introduction">ML for games</a>. Thomas est un grand fan des Agents et est impatient de voir ce que la communauté va construire.

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

## Remerciements

Nous tenons à exprimer notre gratitude aux personnes suivantes pour leurs contributions inestimables à ce cours :

- **[Pedro Cuenca](https://huggingface.co/pcuenq)** – Pour ses conseils et son expertise dans la révision des supports
- **[Aymeric Roucher](https://huggingface.co/m-ric)** – Pour ses incroyables espaces de démonstration (décodage et agent final)
- **[Joshua Lochner](https://huggingface.co/Xenova)** – Pour son espace de démonstration incroyable sur la tokenisation

## J'ai trouvé un bug, ou je souhaite améliorer le cours [[contribute]]

Les contributions sont **les bienvenues** 🤗

- Si vous *avez trouvé un bug 🐛 dans un notebook*, veuillez <a href="https://github.com/huggingface/agents-course/issues">ouvrir une issue</a> et **décrire le problème**.
- Si vous *souhaitez améliorer le cours*, vous pouvez <a href="https://github.com/huggingface/agents-course/pulls">ouvrir une Pull Request</a>.
- Si vous *voulez ajouter une section complète ou une nouvelle unité*, le mieux est d'ouvrir <a href="https://github.com/huggingface/agents-course/issues">une issue</a> et **décrire le contenu que vous souhaitez ajouter avant de commencer à l'écrire afin que nous puissions vous guider**.

## J'ai encore des questions [[questions]]

Veuillez poser vos questions sur notre <a href="https://discord.gg/UrrTSsSyjb">serveur Discord #ai-agents-discussions</a>.

Maintenant que vous avez toutes les informations, embarquons ⛵

<img src="https://huggingface.co/datasets/agents-course/course-images/resolve/main/en/unit0/time-to-onboard.jpg" alt="Il est temps de démarrer" width="100%"/>
Loading