agents-course/pr_693/en/unit3/agentic-rag/introduction.html

<meta charset="utf-8" /><meta name="hf:doc:metadata" content="{&quot;title&quot;:&quot;Introduction to Use Case for Agentic RAG&quot;,&quot;local&quot;:&quot;introduction-to-use-case-for-agentic-rag&quot;,&quot;sections&quot;:[{&quot;title&quot;:&quot;A Gala to Remember&quot;,&quot;local&quot;:&quot;a-gala-to-remember&quot;,&quot;sections&quot;:[],&quot;depth&quot;:2},{&quot;title&quot;:&quot;The Gala Requirements&quot;,&quot;local&quot;:&quot;the-gala-requirements&quot;,&quot;sections&quot;:[],&quot;depth&quot;:2}],&quot;depth&quot;:1}">
		<link href="/docs/agents-course/pr_693/en/_app/immutable/assets/0.e3b0c442.css" rel="modulepreload">
		<link rel="modulepreload" href="/docs/agents-course/pr_693/en/_app/immutable/entry/start.e12ac9b3.js">
		<link rel="modulepreload" href="/docs/agents-course/pr_693/en/_app/immutable/chunks/scheduler.505acc25.js">
		<link rel="modulepreload" href="/docs/agents-course/pr_693/en/_app/immutable/chunks/singletons.09161e8f.js">
		<link rel="modulepreload" href="/docs/agents-course/pr_693/en/_app/immutable/chunks/index.001f95d5.js">
		<link rel="modulepreload" href="/docs/agents-course/pr_693/en/_app/immutable/chunks/paths.11a73501.js">
		<link rel="modulepreload" href="/docs/agents-course/pr_693/en/_app/immutable/entry/app.fc405f77.js">
		<link rel="modulepreload" href="/docs/agents-course/pr_693/en/_app/immutable/chunks/preload-helper.7112d566.js">
		<link rel="modulepreload" href="/docs/agents-course/pr_693/en/_app/immutable/chunks/index.fbb49fb4.js">
		<link rel="modulepreload" href="/docs/agents-course/pr_693/en/_app/immutable/nodes/0.b8cee527.js">
		<link rel="modulepreload" href="/docs/agents-course/pr_693/en/_app/immutable/chunks/each.e59479a4.js">
		<link rel="modulepreload" href="/docs/agents-course/pr_693/en/_app/immutable/nodes/70.5759351f.js">
		<link rel="modulepreload" href="/docs/agents-course/pr_693/en/_app/immutable/chunks/CopyLLMTxtMenu.2fa0472a.js">
		<link rel="modulepreload" href="/docs/agents-course/pr_693/en/_app/immutable/chunks/MermaidChart.svelte_svelte_type_style_lang.3a1211b0.js">
		<link rel="modulepreload" href="/docs/agents-course/pr_693/en/_app/immutable/chunks/Heading.511e0027.js"><!-- HEAD_svelte-u9bgzb_START --><meta name="hf:doc:metadata" content="{&quot;title&quot;:&quot;Introduction to Use Case for Agentic RAG&quot;,&quot;local&quot;:&quot;introduction-to-use-case-for-agentic-rag&quot;,&quot;sections&quot;:[{&quot;title&quot;:&quot;A Gala to Remember&quot;,&quot;local&quot;:&quot;a-gala-to-remember&quot;,&quot;sections&quot;:[],&quot;depth&quot;:2},{&quot;title&quot;:&quot;The Gala Requirements&quot;,&quot;local&quot;:&quot;the-gala-requirements&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="introduction-to-use-case-for-agentic-rag" 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="#introduction-to-use-case-for-agentic-rag"><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>Introduction to Use Case for Agentic RAG</span></h1> <p data-svelte-h="svelte-10xg9bk"><img src="https://huggingface.co/datasets/agents-course/course-images/resolve/main/en/unit3/agentic-rag/thumbnail.jpg" alt="Agentic RAG banner"></p> <p data-svelte-h="svelte-dln0jb">In this unit, we will help Alfred, our friendly agent who is hosting the gala, by using Agentic RAG to create a tool that can be used to answer questions about the guests at the gala.</p> <blockquote class="tip" data-svelte-h="svelte-1smsp4r"><p>This is a ‘real-world’ use case for Agentic RAG, that you could use in your own projects or workplaces. If you want to get more out of this project, why not try it out on your own use case and share in Discord?</p></blockquote> <p data-svelte-h="svelte-chbkr8">You can choose any of the frameworks discussed in the course for this use case. We provide code samples for each in separate tabs.</p>  <h2 class="relative group"><a id="a-gala-to-remember" 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="#a-gala-to-remember"><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>A Gala to Remember</span></h2> <p data-svelte-h="svelte-lwee7a">Now, it’s time to get our hands dirty with an actual use case. Let’s set the stage!</p> <p data-svelte-h="svelte-ywrlwx"><strong>You decided to host the most extravagant and opulent party of the century.</strong> This means lavish feasts, enchanting dancers, renowned DJs, exquisite drinks, a breathtaking fireworks display, and much more.</p> <p data-svelte-h="svelte-1yu8jhn">Alfred, your friendly neighbourhood agent, is getting ready to watch over all of your needs for this party, and <strong>Alfred is going to manage everything himself</strong>. To do so, he needs to have access to all of the information about the party, including the menu, the guests, the schedule, weather forecasts, and much more!</p> <p data-svelte-h="svelte-1b2ats5">Not only that, but he also needs to make sure that the party is going to be a success, so <strong>he needs to be able to answer any questions about the party during the party</strong>, whilst handling unexpected situations that may arise.</p> <p data-svelte-h="svelte-8od5zx">He can’t do this alone, so we need to make sure that Alfred has access to all of the information and tools he needs.</p> <p data-svelte-h="svelte-1qicvrg">First, let’s give him a list of hard requirements for the gala.</p>  <h2 class="relative group"><a id="the-gala-requirements" 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="#the-gala-requirements"><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>The Gala Requirements</span></h2> <p data-svelte-h="svelte-90d9lk">A properly educated person in the age of the <strong>Renaissance</strong> needs to have three main traits.
He or she needed to be profound in the <strong>knowledge of sports, culture, and science</strong>. So, we need to make sure we can impress our guests with our knowledge and provide them with a truly unforgettable gala.
However, to avoid any conflicts, there are some <strong>topics, like politics and religion, that are to be avoided at a gala.</strong> It needs to be a fun party without conflicts related to beliefs and ideals.</p> <p data-svelte-h="svelte-md96cy">According to etiquette, <strong>a good host should be aware of guests’ backgrounds</strong>, including their interests and endeavours. A good host also gossips and shares stories about the guests with one another.</p> <p data-svelte-h="svelte-50f9pa">Lastly, we need to make sure that we’ve got <strong>some general knowledge about the weather</strong> to ensure we can continuously find a real-time update to ensure perfect timing to launch the fireworks and end the gala with a bang! 🎆</p> <p data-svelte-h="svelte-xqu6bj">As you can see, Alfred needs a lot of information to host the gala.
Luckily, we can help and prepare Alfred by giving him some <strong>Retrieval Augmented Generation (RAG) training!</strong></p> <p data-svelte-h="svelte-16zvcod">Let’s start by creating the tools that Alfred needs to be able to host the gala!</p> <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/en/unit3/agentic-rag/introduction.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_l7uhis = {
						assets: "/docs/agents-course/pr_693/en",
						base: "/docs/agents-course/pr_693/en",
						env: {}
					};

					const element = document.currentScript.parentElement;

					const data = [null,null];

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