agents-course/pr_545/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_545/en/_app/immutable/assets/0.e3b0c442.css" rel="modulepreload">
		<link rel="modulepreload" href="/docs/agents-course/pr_545/en/_app/immutable/entry/start.1596c81c.js">
		<link rel="modulepreload" href="/docs/agents-course/pr_545/en/_app/immutable/chunks/scheduler.37c15a92.js">
		<link rel="modulepreload" href="/docs/agents-course/pr_545/en/_app/immutable/chunks/singletons.8a3d92bd.js">
		<link rel="modulepreload" href="/docs/agents-course/pr_545/en/_app/immutable/chunks/index.18351ede.js">
		<link rel="modulepreload" href="/docs/agents-course/pr_545/en/_app/immutable/chunks/paths.5b2602e7.js">
		<link rel="modulepreload" href="/docs/agents-course/pr_545/en/_app/immutable/entry/app.856a784e.js">
		<link rel="modulepreload" href="/docs/agents-course/pr_545/en/_app/immutable/chunks/index.2bf4358c.js">
		<link rel="modulepreload" href="/docs/agents-course/pr_545/en/_app/immutable/nodes/0.1cd5790a.js">
		<link rel="modulepreload" href="/docs/agents-course/pr_545/en/_app/immutable/chunks/each.e59479a4.js">
		<link rel="modulepreload" href="/docs/agents-course/pr_545/en/_app/immutable/nodes/70.39f8a82e.js">
		<link rel="modulepreload" href="/docs/agents-course/pr_545/en/_app/immutable/chunks/Tip.363c041f.js">
		<link rel="modulepreload" href="/docs/agents-course/pr_545/en/_app/immutable/chunks/Heading.8ada512a.js">
		<link rel="modulepreload" href="/docs/agents-course/pr_545/en/_app/immutable/chunks/getInferenceSnippets.031140c2.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>  <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>  <div class="course-tip  bg-gradient-to-br dark:bg-gradient-to-r before:border-green-500 dark:before:border-green-800 from-green-50 dark:from-gray-900 to-white dark:to-gray-950 border border-green-50 text-green-700 dark:text-gray-400">This is a &#39;real-world&#39; 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?</div> <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"><span data-svelte-h="svelte-1kd6by1">&lt;</span> <span data-svelte-h="svelte-x0xyl0">&gt;</span> <span data-svelte-h="svelte-1dajgef"><span class="underline ml-1.5">Update</span> on GitHub</span></a>  <p></p> 
			
			<script>
				{
					__sveltekit_17hovx6 = {
						assets: "/docs/agents-course/pr_545/en",
						base: "/docs/agents-course/pr_545/en",
						env: {}
					};

					const element = document.currentScript.parentElement;

					const data = [null,null];

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