agents-course/pr_693/fr/unit4/hands-on.html

<meta charset="utf-8" /><meta name="hf:doc:metadata" content="{&quot;title&quot;:&quot;Le projet pratique final&quot;,&quot;local&quot;:&quot;le-projet-pratique-final&quot;,&quot;sections&quot;:[{&quot;title&quot;:&quot;Le jeu de données&quot;,&quot;local&quot;:&quot;le-jeu-de-données&quot;,&quot;sections&quot;:[],&quot;depth&quot;:2},{&quot;title&quot;:&quot;Le processus&quot;,&quot;local&quot;:&quot;le-processus&quot;,&quot;sections&quot;:[],&quot;depth&quot;:2}],&quot;depth&quot;:1}">
		<link href="/docs/agents-course/pr_693/fr/_app/immutable/assets/0.e3b0c442.css" rel="modulepreload">
		<link rel="modulepreload" href="/docs/agents-course/pr_693/fr/_app/immutable/entry/start.2c17f120.js">
		<link rel="modulepreload" href="/docs/agents-course/pr_693/fr/_app/immutable/chunks/scheduler.505acc25.js">
		<link rel="modulepreload" href="/docs/agents-course/pr_693/fr/_app/immutable/chunks/singletons.c42fe6bc.js">
		<link rel="modulepreload" href="/docs/agents-course/pr_693/fr/_app/immutable/chunks/index.001f95d5.js">
		<link rel="modulepreload" href="/docs/agents-course/pr_693/fr/_app/immutable/chunks/paths.d9eccb35.js">
		<link rel="modulepreload" href="/docs/agents-course/pr_693/fr/_app/immutable/entry/app.e6392e6e.js">
		<link rel="modulepreload" href="/docs/agents-course/pr_693/fr/_app/immutable/chunks/preload-helper.ed034652.js">
		<link rel="modulepreload" href="/docs/agents-course/pr_693/fr/_app/immutable/chunks/index.b1175496.js">
		<link rel="modulepreload" href="/docs/agents-course/pr_693/fr/_app/immutable/nodes/0.99eb6829.js">
		<link rel="modulepreload" href="/docs/agents-course/pr_693/fr/_app/immutable/chunks/each.e59479a4.js">
		<link rel="modulepreload" href="/docs/agents-course/pr_693/fr/_app/immutable/nodes/76.b8b28676.js">
		<link rel="modulepreload" href="/docs/agents-course/pr_693/fr/_app/immutable/chunks/Heading.60c0aaa1.js">
		<link rel="modulepreload" href="/docs/agents-course/pr_693/fr/_app/immutable/chunks/MermaidChart.svelte_svelte_type_style_lang.33a206b7.js"><!-- HEAD_svelte-u9bgzb_START --><meta name="hf:doc:metadata" content="{&quot;title&quot;:&quot;Le projet pratique final&quot;,&quot;local&quot;:&quot;le-projet-pratique-final&quot;,&quot;sections&quot;:[{&quot;title&quot;:&quot;Le jeu de données&quot;,&quot;local&quot;:&quot;le-jeu-de-données&quot;,&quot;sections&quot;:[],&quot;depth&quot;:2},{&quot;title&quot;:&quot;Le processus&quot;,&quot;local&quot;:&quot;le-processus&quot;,&quot;sections&quot;:[],&quot;depth&quot;:2}],&quot;depth&quot;:1}"><!-- HEAD_svelte-u9bgzb_END -->      <p></p>  <div class="items-center shrink-0 min-w-[100px] max-sm:min-w-[50px] justify-end ml-auto flex" style="float: right; margin-left: 10px; display: inline-flex; position: relative; z-index: 10;"><div class="inline-flex rounded-md max-sm:rounded-sm"><button class="inline-flex items-center gap-1 h-7 max-sm:h-7 px-2 max-sm:px-1.5 text-sm font-medium text-gray-800 border border-r-0 rounded-l-md max-sm:rounded-l-sm border-gray-200 bg-white hover:shadow-inner dark:border-gray-850 dark:bg-gray-950 dark:text-gray-200 dark:hover:bg-gray-800" aria-live="polite"><span class="inline-flex items-center justify-center rounded-md p-0.5 max-sm:p-0 hover:text-gray-800 dark:hover:text-gray-200"><svg class="sm:size-3.5 size-3" xmlns="http://www.w3.org/2000/svg" aria-hidden="true" fill="currentColor" focusable="false" role="img" width="1em" height="1em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 32 32"><path d="M28,10V28H10V10H28m0-2H10a2,2,0,0,0-2,2V28a2,2,0,0,0,2,2H28a2,2,0,0,0,2-2V10a2,2,0,0,0-2-2Z" transform="translate(0)"></path><path d="M4,18H2V4A2,2,0,0,1,4,2H18V4H4Z" transform="translate(0)"></path><rect fill="none" width="32" height="32"></rect></svg></span> <span>Copy page</span></button> <button class="inline-flex items-center justify-center w-6 max-sm:w-5 h-7 max-sm:h-7 disabled:pointer-events-none text-sm text-gray-500 hover:text-gray-700 dark:hover:text-white rounded-r-md max-sm:rounded-r-sm border border-l transition border-gray-200 bg-white hover:shadow-inner dark:border-gray-850 dark:bg-gray-950 dark:text-gray-200 dark:hover:bg-gray-800" aria-haspopup="menu" aria-expanded="false" aria-label="Open copy menu"><svg class="transition-transform text-gray-400 overflow-visible sm:size-3.5 size-3 rotate-0" width="1em" height="1em" viewBox="0 0 12 7" fill="none" xmlns="http://www.w3.org/2000/svg"><path d="M1 1L6 6L11 1" stroke="currentColor"></path></svg></button></div> </div>  <h1 class="relative group"><a id="le-projet-pratique-final" class="header-link block pr-1.5 text-lg no-hover:hidden with-hover:absolute with-hover:p-1.5 with-hover:opacity-0 with-hover:group-hover:opacity-100 with-hover:right-full" href="#le-projet-pratique-final"><span><svg class="" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" aria-hidden="true" role="img" width="1em" height="1em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 256 256"><path d="M167.594 88.393a8.001 8.001 0 0 1 0 11.314l-67.882 67.882a8 8 0 1 1-11.314-11.315l67.882-67.881a8.003 8.003 0 0 1 11.314 0zm-28.287 84.86l-28.284 28.284a40 40 0 0 1-56.567-56.567l28.284-28.284a8 8 0 0 0-11.315-11.315l-28.284 28.284a56 56 0 0 0 79.196 79.197l28.285-28.285a8 8 0 1 0-11.315-11.314zM212.852 43.14a56.002 56.002 0 0 0-79.196 0l-28.284 28.284a8 8 0 1 0 11.314 11.314l28.284-28.284a40 40 0 0 1 56.568 56.567l-28.285 28.285a8 8 0 0 0 11.315 11.314l28.284-28.284a56.065 56.065 0 0 0 0-79.196z" fill="currentColor"></path></svg></span></a> <span>Le projet pratique final</span></h1> <p data-svelte-h="svelte-1pjkb2a">Maintenant que vous êtes prêt à plonger plus profondément dans la création de votre agent, voyons comment vous pouvez le soumettre pour l’évaluer.</p>  <h2 class="relative group"><a id="le-jeu-de-données" class="header-link block pr-1.5 text-lg no-hover:hidden with-hover:absolute with-hover:p-1.5 with-hover:opacity-0 with-hover:group-hover:opacity-100 with-hover:right-full" href="#le-jeu-de-données"><span><svg class="" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" aria-hidden="true" role="img" width="1em" height="1em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 256 256"><path d="M167.594 88.393a8.001 8.001 0 0 1 0 11.314l-67.882 67.882a8 8 0 1 1-11.314-11.315l67.882-67.881a8.003 8.003 0 0 1 11.314 0zm-28.287 84.86l-28.284 28.284a40 40 0 0 1-56.567-56.567l28.284-28.284a8 8 0 0 0-11.315-11.315l-28.284 28.284a56 56 0 0 0 79.196 79.197l28.285-28.285a8 8 0 1 0-11.315-11.314zM212.852 43.14a56.002 56.002 0 0 0-79.196 0l-28.284 28.284a8 8 0 1 0 11.314 11.314l28.284-28.284a40 40 0 0 1 56.568 56.567l-28.285 28.285a8 8 0 0 0 11.315 11.314l28.284-28.284a56.065 56.065 0 0 0 0-79.196z" fill="currentColor"></path></svg></span></a> <span>Le jeu de données</span></h2> <p data-svelte-h="svelte-uawk1">Le jeu de données utilisé pour le classement se compose de 20 questions extraites des questions de niveau 1 de la partie <strong>validation</strong> de GAIA.</p> <p data-svelte-h="svelte-3urput">Les questions choisies ont été filtrées en fonction du nombre d’outils et d’étapes nécessaires pour répondre à une question.</p> <p data-svelte-h="svelte-1ibgal6">Sur la base de l’état actuel du <em>benchmark</em> GAIA, nous pensons que vous faire viser 30% sur les questions de niveau 1 est un test équitable.</p> <img src="https://huggingface.co/datasets/agents-course/course-images/resolve/main/en/unit4/leaderboard%20GAIA%2024%3A04%3A2025.png" alt="GAIA current status!">  <h2 class="relative group"><a id="le-processus" class="header-link block pr-1.5 text-lg no-hover:hidden with-hover:absolute with-hover:p-1.5 with-hover:opacity-0 with-hover:group-hover:opacity-100 with-hover:right-full" href="#le-processus"><span><svg class="" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" aria-hidden="true" role="img" width="1em" height="1em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 256 256"><path d="M167.594 88.393a8.001 8.001 0 0 1 0 11.314l-67.882 67.882a8 8 0 1 1-11.314-11.315l67.882-67.881a8.003 8.003 0 0 1 11.314 0zm-28.287 84.86l-28.284 28.284a40 40 0 0 1-56.567-56.567l28.284-28.284a8 8 0 0 0-11.315-11.315l-28.284 28.284a56 56 0 0 0 79.196 79.197l28.285-28.285a8 8 0 1 0-11.315-11.314zM212.852 43.14a56.002 56.002 0 0 0-79.196 0l-28.284 28.284a8 8 0 1 0 11.314 11.314l28.284-28.284a40 40 0 0 1 56.568 56.567l-28.285 28.285a8 8 0 0 0 11.315 11.314l28.284-28.284a56.065 56.065 0 0 0 0-79.196z" fill="currentColor"></path></svg></span></a> <span>Le processus</span></h2> <p data-svelte-h="svelte-x2x8sh">Maintenant, la grande question dans votre esprit est probablement : « Comment puis-je commencer à soumettre ? »</p> <p data-svelte-h="svelte-1jtaagm">Pour cette unité, nous avons créé une API qui vous permettra d’obtenir les questions et d’envoyer vos réponses pour évaluation.
Voici un résumé des routes (voir la <a href="https://agents-course-unit4-scoring.hf.space/docs" rel="nofollow">documentation en direct</a> pour les détails interactifs) :</p> <ul data-svelte-h="svelte-1jem6xi"><li><strong><code>GET /questions</code></strong> : Récupérer la liste complète des questions d’évaluation filtrées.</li> <li><strong><code>GET /random-question</code></strong> : Récupérer une seule question aléatoire de la liste.</li> <li><strong><code>GET /files/{task_id}</code></strong> : Télécharger un fichier spécifique associé à un ID de tâche donné.</li> <li><strong><code>POST /submit</code></strong> : Soumettre les réponses de l’agent, calculer le score et mettre à jour le classement.</li></ul> <p data-svelte-h="svelte-1a8yhux">La fonction de soumission comparera votre réponse à la vérité terrain via une <strong>CORRESPONDANCE EXACTE</strong>, donc formulez bien vos <em>prompts</em> ! L’équipe GAIA a partagé un exemple de formulation pour votre agent <a href="https://huggingface.co/spaces/gaia-benchmark/leaderboard" rel="nofollow">ici</a> (pour les besoins de ce cours, assurez-vous de ne pas inclure le texte “FINAL ANSWER” dans votre soumission, faites simplement que votre agent réponde avec la réponse et rien d’autre).</p> <p data-svelte-h="svelte-1y4s8s6">🎨 <strong>Personnalisez le gabarit !</strong></p> <p data-svelte-h="svelte-1wammoz">Pour démontrer le processus d’interaction avec l’API, nous avons inclus un <a href="https://huggingface.co/spaces/agents-course/Final_Assignment_Template" rel="nofollow">gabarit de base</a> comme point de départ.</p> <p data-svelte-h="svelte-dy0u92">N’hésitez pas à le changer, et <strong>nous vous encourageons activement à le faire</strong>, y ajouter ou le restructurer complètement ! Modifiez-le de la manière qui convient le mieux à votre approche et à votre créativité.</p> <p data-svelte-h="svelte-otyhad">Pour soumettre ces gabarits, calculez 3 éléments nécessaires à l’API :</p> <ul data-svelte-h="svelte-hogrfj"><li><strong>Nom d’utilisateur :</strong> Votre nom d’utilisateur Hugging Face (ici obtenu via la connexion Gradio), qui est utilisé pour identifier votre soumission.</li> <li><strong>Lien de code (<code>agent_code</code>) :</strong> l’URL pointant vers le code de votre <em>Space</em> Hugging Face (<code>.../tree/main</code>) à des fins de vérification, alors veuillez garder votre <em>Space</em> public.</li> <li><strong>Réponses (<code>answers</code>) :</strong> La liste des réponses (<code>{&quot;task_id&quot;: ..., &quot;submitted_answer&quot;: ...}</code>) générées par votre agent pour la notation.</li></ul> <p data-svelte-h="svelte-p205jl">Nous vous encourageons donc à commencer par dupliquer ce <a href="https://huggingface.co/spaces/agents-course/Final_Assignment_Template" rel="nofollow">gabarit</a> sur votre propre profil Hugging Face.</p> <p data-svelte-h="svelte-1uxx1x2">🏆 Consultez le classement <a href="https://huggingface.co/spaces/agents-course/Students_leaderboard" rel="nofollow">ici</a></p> <p data-svelte-h="svelte-bi35vm"><em>Une note amicale :<br>
Ce classement est destiné à s’amuser ! Nous savons qu’il est possible de soumettre des scores sans vérification complète. Si nous constatons qu’un trop grand nombre de scores élevés sont affichés sans lien public pour les étayer, il se peut que nous devions revoir, ajuster ou supprimer certaines entrées afin de préserver l’utilité du classement.</em> Le classement montrera le lien vers votre <em>Space</em> et le code qu’il contient. Puisque ce classement est réservé aux étudiants, veuillez le garder public si vous obtenez un score dont vous êtes fier.</p> <iframe src="https://agents-course-students-leaderboard.hf.space" frameborder="0" width="850" height="450"></iframe> <a class="!text-gray-400 !no-underline text-sm flex items-center not-prose mt-4" href="https://github.com/huggingface/agents-course/blob/main/units/fr/unit4/hands-on.mdx" target="_blank"><svg class="mr-1" xmlns="http://www.w3.org/2000/svg" aria-hidden="true" fill="currentColor" focusable="false" role="img" width="1em" height="1em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 32 32"><path d="M31,16l-7,7l-1.41-1.41L28.17,16l-5.58-5.59L24,9l7,7z"></path><path d="M1,16l7-7l1.41,1.41L3.83,16l5.58,5.59L8,23l-7-7z"></path><path d="M12.419,25.484L17.639,6.552l1.932,0.518L14.351,26.002z"></path></svg> <span data-svelte-h="svelte-zjs2n5"><span class="underline">Update</span> on GitHub</span></a>  <p></p> 
			
			<script>
				{
					__sveltekit_1jehap = {
						assets: "/docs/agents-course/pr_693/fr",
						base: "/docs/agents-course/pr_693/fr",
						env: {}
					};

					const element = document.currentScript.parentElement;

					const data = [null,null];

					Promise.all([
						import("/docs/agents-course/pr_693/fr/_app/immutable/entry/start.2c17f120.js"),
						import("/docs/agents-course/pr_693/fr/_app/immutable/entry/app.e6392e6e.js")
					]).then(([kit, app]) => {
						kit.start(app, element, {
							node_ids: [0, 76],
							data,
							form: null,
							error: null
						});
					});
				}
			</script>