{
"cells": [
{
"cell_type": "markdown",
"metadata": {
"id": "Pi9CF0391ARI"
},
"source": [
"# Integrating Agents With Tools\n",
"\n",
"This notebook is part of the [Hugging Face Agents Course](https://www.hf.co/learn/agents-course), a free Course from beginner to expert, where you learn to build Agents.\n",
"\n",
""
]
},
{
"cell_type": "markdown",
"metadata": {
"id": "9gsYky7F1GzT"
},
"source": [
"## Let's install the dependencies and login to our HF account to access the Inference API\n",
"\n",
"If you haven't installed `smolagents` yet, you can do so by running the following command:"
]
},
{
"cell_type": "code",
"execution_count": null,
"metadata": {
"id": "MoFopncp0pnJ"
},
"outputs": [],
"source": [
"!pip install smolagents -U"
]
},
{
"cell_type": "markdown",
"source": [
"Let's also login to the Hugging Face Hub to have access to the Inference API."
],
"metadata": {
"id": "cH-4W1GhYL4T"
}
},
{
"cell_type": "code",
"execution_count": null,
"metadata": {
"id": "TFTc-ry70y1f"
},
"outputs": [],
"source": [
"from huggingface_hub import notebook_login\n",
"\n",
"notebook_login()"
]
},
{
"cell_type": "markdown",
"metadata": {
"id": "ekKxaZrd1HlB"
},
"source": [
"## Selecting a Playlist for the Party Using `smolagents` and a `ToolCallingAgent`\n",
"\n",
"Let's revisit the previous example where Alfred started party preparations, but this time we'll use a `ToolCallingAgent` to highlight the difference. We'll build an agent that can search the web using DuckDuckGo, just like in our Code Agent example. The only difference is the agent type - the framework handles everything else:"
]
},
{
"cell_type": "code",
"execution_count": null,
"metadata": {
"colab": {
"base_uri": "https://localhost:8080/",
"height": 1000
},
"id": "6IInDOUN01sP",
"outputId": "e49f2360-d377-4ed8-b7ae-8da4a3e3757b"
},
"outputs": [
{
"data": {
"text/html": [
"╭──────────────────────────────────────────────────── New run ────────────────────────────────────────────────────╮\n",
"│ │\n",
"│ Search for the best music recommendations for a party at the Wayne's mansion. │\n",
"│ │\n",
"╰─ HfApiModel - Qwen/Qwen2.5-Coder-32B-Instruct ──────────────────────────────────────────────────────────────────╯\n",
"\n"
],
"text/plain": [
"\u001b[38;2;212;183;2m╭─\u001b[0m\u001b[38;2;212;183;2m───────────────────────────────────────────────────\u001b[0m\u001b[38;2;212;183;2m \u001b[0m\u001b[1;38;2;212;183;2mNew run\u001b[0m\u001b[38;2;212;183;2m \u001b[0m\u001b[38;2;212;183;2m───────────────────────────────────────────────────\u001b[0m\u001b[38;2;212;183;2m─╮\u001b[0m\n",
"\u001b[38;2;212;183;2m│\u001b[0m \u001b[38;2;212;183;2m│\u001b[0m\n",
"\u001b[38;2;212;183;2m│\u001b[0m \u001b[1mSearch for the best music recommendations for a party at the Wayne's mansion.\u001b[0m \u001b[38;2;212;183;2m│\u001b[0m\n",
"\u001b[38;2;212;183;2m│\u001b[0m \u001b[38;2;212;183;2m│\u001b[0m\n",
"\u001b[38;2;212;183;2m╰─\u001b[0m\u001b[38;2;212;183;2m HfApiModel - Qwen/Qwen2.5-Coder-32B-Instruct \u001b[0m\u001b[38;2;212;183;2m─────────────────────────────────────────────────────────────────\u001b[0m\u001b[38;2;212;183;2m─╯\u001b[0m\n"
]
},
"metadata": {},
"output_type": "display_data"
},
{
"data": {
"text/html": [
"━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ Step 1 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n",
"\n"
],
"text/plain": [
"\u001b[38;2;212;183;2m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ \u001b[0m\u001b[1mStep \u001b[0m\u001b[1;36m1\u001b[0m\u001b[38;2;212;183;2m ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m\n"
]
},
"metadata": {},
"output_type": "display_data"
},
{
"name": "stderr",
"output_type": "stream",
"text": [
"/usr/local/lib/python3.11/dist-packages/huggingface_hub/utils/_auth.py:94: UserWarning: \n",
"The secret `HF_TOKEN` does not exist in your Colab secrets.\n",
"To authenticate with the Hugging Face Hub, create a token in your settings tab (https://huggingface.co./settings/tokens), set it as secret in your Google Colab and restart your session.\n",
"You will be able to reuse this secret in all of your notebooks.\n",
"Please note that authentication is recommended but still optional to access public models or datasets.\n",
" warnings.warn(\n"
]
},
{
"data": {
"text/html": [
"╭─────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮\n",
"│ Calling tool: 'web_search' with arguments: {'query': \"best music recommendations for a party at Wayne's │\n",
"│ mansion\"} │\n",
"╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯\n",
"\n"
],
"text/plain": [
"╭─────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮\n",
"│ Calling tool: 'web_search' with arguments: {'query': \"best music recommendations for a party at Wayne's │\n",
"│ mansion\"} │\n",
"╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯\n"
]
},
"metadata": {},
"output_type": "display_data"
},
{
"data": {
"text/html": [
"Observations: ## Search Results\n",
"\n",
"|The 75 Best Party Songs That Will Get Everyone Dancing - \n",
"Gear4music](https://www.gear4music.com/blog/best-party-songs/)\n",
"The best party songs 1. \"September\" - Earth, Wind & Fire (1978) Quite possibly the best party song. An infectious \n",
"mix of funk and soul, \"September\" is celebrated for its upbeat melody and \"ba-dee-ya\" chorus, making it a timeless \n",
"dance favorite.\n",
"\n",
"|Wedding Party Entrance Songs to Get the Party Started - The Mansion \n",
"...](https://mansiononmainstreet.com/wedding-party-entrance-songs-to-get-the-party-started/)\n",
"Best Wedding Party Entrance Songs. No matter what vibe you're going for, there are some wedding party entrance \n",
"songs that are guaranteed to be a hit with people. From the latest music from Justin Timberlake to oldies but \n",
"goodies, most of your guests will be familiar with the popular wedding party entrance songs listed below.\n",
"\n",
"|50 Songs on Every Event Planner's Playlist - \n",
"Eventbrite](https://www.eventbrite.com/blog/event-planning-playlist-ds00/)\n",
"Music sets the mood and provides the soundtrack (literally) for a memorable and exciting time. While the right \n",
"songs can enhance the experience, the wrong event music can throw off the vibe. For example, fast-paced songs \n",
"probably aren't the best fit for a formal gala. And smooth jazz is likely to lull your guests at a motivational \n",
"conference.\n",
"\n",
"|200 Classic House Party Songs Everyone Knows | The Best ... - \n",
"iSpyTunes](https://www.ispytunes.com/post/house-party-songs)\n",
"\" Branded merchandise adds flair to any occasion, just like the perfect playlist. 200 classic house party songs \n",
"everyone knows set the mood, bringing energy to every celebration. The best popular party hits keep guests dancing,\n",
"creating unforgettable moments. From throwback anthems to modern beats, a great selection ensures nonstop fun.\n",
"\n",
"|The Best Songs For Parties - The Ambient Mixer \n",
"Blog](https://blog.ambient-mixer.com/usage/parties-2/the-best-songs-for-parties/)\n",
"The 100 best party songs ever made. Top 100 Best Party Songs Of All Time. Of course, these are just 2 of the many \n",
"available playlists to choose from. However, these two contain some of the most popular ones most people usually \n",
"end up using. If these are not the type of songs you or your guests might enjoy then simply follow the steps in the\n",
"...\n",
"\n",
"|Passaic County Parks & Recreation: Music at the \n",
"Mansion](https://passaiccountynj.myrec.com/info/activities/program_details.aspx?ProgramID=29909)\n",
"Thursdays from 7 to 9 PM the finest local bands will be playing music while In the Drink restaurant sells food and \n",
"drinks on site. September 3rd: Norton Smull Band; Parking is limited at the Dey Mansion 209 Totowa Rd. Wayne, NJ. \n",
"Overflow parking will be at the Preakness Valley Golf Course. You may drop off your guests at the Mansion first.\n",
"\n",
"|Grand Entrance Songs | SOUNDfonix](https://soundfonixent.com/resources/reception-song-ideas/grand-entrance-songs/)\n",
"The entrance song sets the tone for the rest of the dance and the evening. Choose your entrance song wisely.\n",
"\n",
"|Party Music Guide: Ultimate Tips for the Perfect \n",
"Playlist](https://thebackstage-deezer.com/music/perfect-party-music-playlist/)\n",
"Check out the best party playlists and top party songs to ensure your next party is packed! The most popular party \n",
"songs are here, just hit play. ... to decor. But, most of all, you need to have fantastic music. We recommend you \n",
"get at least three hours' worth of party music queued and ready — that's about 75 songs. Lucky for you, we've ...\n",
"\n",
"|The Top 100 Best Party Songs of All Time - \n",
"LiveAbout](https://www.liveabout.com/top-best-party-songs-of-all-time-3248355)\n",
"\"Macarena\" then spent 14 weeks at No. 1 on the U.S. pop singles chart. For more than a year this was one of the \n",
"most popular special event songs in the United States. It still works well as a charming party song encouraging \n",
"everyone to join in on the simple dance.\n",
"\n",
"|70 Best Piano Bar Songs You Should Request](https://www.pianoarea.com/best-piano-bar-songs/)\n",
"Best Piano Bar Songs You Should Request 1. \"Piano Man\" by Billy Joel. One of the top recommendations for piano bar \n",
"songs is \"Piano Man\" by Billy Joel.. This iconic track was released by Columbia Records in 1973.. As part of the \n",
"album titled 'Piano Man,' it's one of Billy Joel's most recognizable works.. The song spins a captivating narrative\n",
"and showcases Joe's compelling ...\n",
"\n"
],
"text/plain": [
"Observations: ## Search Results\n",
"\n",
"|The \u001b[1;36m75\u001b[0m Best Party Songs That Will Get Everyone Dancing - \n",
"Gear4music\u001b[1m]\u001b[0m\u001b[1m(\u001b[0m\u001b[4;94mhttps://www.gear4music.com/blog/best-party-songs/\u001b[0m\u001b[4;94m)\u001b[0m\n",
"The best party songs \u001b[1;36m1\u001b[0m. \u001b[32m\"September\"\u001b[0m - Earth, Wind & Fire \u001b[1m(\u001b[0m\u001b[1;36m1978\u001b[0m\u001b[1m)\u001b[0m Quite possibly the best party song. An infectious \n",
"mix of funk and soul, \u001b[32m\"September\"\u001b[0m is celebrated for its upbeat melody and \u001b[32m\"ba-dee-ya\"\u001b[0m chorus, making it a timeless \n",
"dance favorite.\n",
"\n",
"|Wedding Party Entrance Songs to Get the Party Started - The Mansion \n",
"\u001b[33m...\u001b[0m\u001b[1m]\u001b[0m\u001b[1m(\u001b[0m\u001b[4;94mhttps://mansiononmainstreet.com/wedding-party-entrance-songs-to-get-the-party-started/\u001b[0m\u001b[4;94m)\u001b[0m\n",
"Best Wedding Party Entrance Songs. No matter what vibe you're going for, there are some wedding party entrance \n",
"songs that are guaranteed to be a hit with people. From the latest music from Justin Timberlake to oldies but \n",
"goodies, most of your guests will be familiar with the popular wedding party entrance songs listed below.\n",
"\n",
"|\u001b[1;36m50\u001b[0m Songs on Every Event Planner's Playlist - \n",
"Eventbrite\u001b[1m]\u001b[0m\u001b[1m(\u001b[0m\u001b[4;94mhttps://www.eventbrite.com/blog/event-planning-playlist-ds00/\u001b[0m\u001b[4;94m)\u001b[0m\n",
"Music sets the mood and provides the soundtrack \u001b[1m(\u001b[0mliterally\u001b[1m)\u001b[0m for a memorable and exciting time. While the right \n",
"songs can enhance the experience, the wrong event music can throw off the vibe. For example, fast-paced songs \n",
"probably aren't the best fit for a formal gala. And smooth jazz is likely to lull your guests at a motivational \n",
"conference.\n",
"\n",
"|\u001b[1;36m200\u001b[0m Classic House Party Songs Everyone Knows | The Best \u001b[33m...\u001b[0m - \n",
"iSpyTunes\u001b[1m]\u001b[0m\u001b[1m(\u001b[0m\u001b[4;94mhttps://www.ispytunes.com/post/house-party-songs\u001b[0m\u001b[4;94m)\u001b[0m\n",
"\" Branded merchandise adds flair to any occasion, just like the perfect playlist. \u001b[1;36m200\u001b[0m classic house party songs \n",
"everyone knows set the mood, bringing energy to every celebration. The best popular party hits keep guests dancing,\n",
"creating unforgettable moments. From throwback anthems to modern beats, a great selection ensures nonstop fun.\n",
"\n",
"|The Best Songs For Parties - The Ambient Mixer \n",
"Blog\u001b[1m]\u001b[0m\u001b[1m(\u001b[0m\u001b[4;94mhttps://blog.ambient-mixer.com/usage/parties-2/the-best-songs-for-parties/\u001b[0m\u001b[4;94m)\u001b[0m\n",
"The \u001b[1;36m100\u001b[0m best party songs ever made. Top \u001b[1;36m100\u001b[0m Best Party Songs Of All Time. Of course, these are just \u001b[1;36m2\u001b[0m of the many \n",
"available playlists to choose from. However, these two contain some of the most popular ones most people usually \n",
"end up using. If these are not the type of songs you or your guests might enjoy then simply follow the steps in the\n",
"\u001b[33m...\u001b[0m\n",
"\n",
"|Passaic County Parks & Recreation: Music at the \n",
"Mansion\u001b[1m]\u001b[0m\u001b[1m(\u001b[0m\u001b[4;94mhttps://passaiccountynj.myrec.com/info/activities/program_details.aspx?\u001b[0m\u001b[4;94mProgramID\u001b[0m\u001b[4;94m=\u001b[0m\u001b[4;94m29909\u001b[0m\u001b[4;94m)\u001b[0m\n",
"Thursdays from \u001b[1;36m7\u001b[0m to \u001b[1;36m9\u001b[0m PM the finest local bands will be playing music while In the Drink restaurant sells food and \n",
"drinks on site. September 3rd: Norton Smull Band; Parking is limited at the Dey Mansion \u001b[1;36m209\u001b[0m Totowa Rd. Wayne, NJ. \n",
"Overflow parking will be at the Preakness Valley Golf Course. You may drop off your guests at the Mansion first.\n",
"\n",
"|Grand Entrance Songs | SOUNDfonix\u001b[1m]\u001b[0m\u001b[1m(\u001b[0m\u001b[4;94mhttps://soundfonixent.com/resources/reception-song-ideas/grand-entrance-songs/\u001b[0m\u001b[4;94m)\u001b[0m\n",
"The entrance song sets the tone for the rest of the dance and the evening. Choose your entrance song wisely.\n",
"\n",
"|Party Music Guide: Ultimate Tips for the Perfect \n",
"Playlist\u001b[1m]\u001b[0m\u001b[1m(\u001b[0m\u001b[4;94mhttps://thebackstage-deezer.com/music/perfect-party-music-playlist/\u001b[0m\u001b[4;94m)\u001b[0m\n",
"Check out the best party playlists and top party songs to ensure your next party is packed! The most popular party \n",
"songs are here, just hit play. \u001b[33m...\u001b[0m to decor. But, most of all, you need to have fantastic music. We recommend you \n",
"get at least three hours' worth of party music queued and ready — that's about \u001b[1;36m75\u001b[0m songs. Lucky for you, we've \u001b[33m...\u001b[0m\n",
"\n",
"|The Top \u001b[1;36m100\u001b[0m Best Party Songs of All Time - \n",
"LiveAbout\u001b[1m]\u001b[0m\u001b[1m(\u001b[0m\u001b[4;94mhttps://www.liveabout.com/top-best-party-songs-of-all-time-3248355\u001b[0m\u001b[4;94m)\u001b[0m\n",
"\u001b[32m\"Macarena\"\u001b[0m then spent \u001b[1;36m14\u001b[0m weeks at No. \u001b[1;36m1\u001b[0m on the U.S. pop singles chart. For more than a year this was one of the \n",
"most popular special event songs in the United States. It still works well as a charming party song encouraging \n",
"everyone to join in on the simple dance.\n",
"\n",
"|\u001b[1;36m70\u001b[0m Best Piano Bar Songs You Should Request\u001b[1m]\u001b[0m\u001b[1m(\u001b[0m\u001b[4;94mhttps://www.pianoarea.com/best-piano-bar-songs/\u001b[0m\u001b[4;94m)\u001b[0m\n",
"Best Piano Bar Songs You Should Request \u001b[1;36m1\u001b[0m. \u001b[32m\"Piano Man\"\u001b[0m by Billy Joel. One of the top recommendations for piano bar \n",
"songs is \u001b[32m\"Piano Man\"\u001b[0m by Billy Joel.. This iconic track was released by Columbia Records in \u001b[1;36m1973\u001b[0m.. As part of the \n",
"album titled \u001b[32m'Piano Man,'\u001b[0m it's one of Billy Joel's most recognizable works.. The song spins a captivating narrative\n",
"and showcases Joe's compelling \u001b[33m...\u001b[0m\n"
]
},
"metadata": {},
"output_type": "display_data"
},
{
"data": {
"text/html": [
"[Step 0: Duration 4.70 seconds| Input tokens: 1,174 | Output tokens: 26]\n",
"\n"
],
"text/plain": [
"\u001b[2m[Step 0: Duration 4.70 seconds| Input tokens: 1,174 | Output tokens: 26]\u001b[0m\n"
]
},
"metadata": {},
"output_type": "display_data"
},
{
"data": {
"text/html": [
"━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ Step 2 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n",
"\n"
],
"text/plain": [
"\u001b[38;2;212;183;2m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ \u001b[0m\u001b[1mStep \u001b[0m\u001b[1;36m2\u001b[0m\u001b[38;2;212;183;2m ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m\n"
]
},
"metadata": {},
"output_type": "display_data"
},
{
"data": {
"text/html": [
"╭─────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮\n",
"│ Calling tool: 'web_search' with arguments: {'query': 'best party songs for a mansion late-night event'} │\n",
"╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯\n",
"\n"
],
"text/plain": [
"╭─────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮\n",
"│ Calling tool: 'web_search' with arguments: {'query': 'best party songs for a mansion late-night event'} │\n",
"╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯\n"
]
},
"metadata": {},
"output_type": "display_data"
},
{
"data": {
"text/html": [
"Observations: ## Search Results\n",
"\n",
"|The 75 Best Party Songs That Will Get Everyone Dancing - \n",
"Gear4music](https://www.gear4music.com/blog/best-party-songs/)\n",
"The best party songs 1. \"September\" - Earth, Wind & Fire (1978) Quite possibly the best party song. An infectious \n",
"mix of funk and soul, \"September\" is celebrated for its upbeat melody and \"ba-dee-ya\" chorus, making it a timeless \n",
"dance favorite.\n",
"\n",
"|45 Songs That Get Your Event Guests on the Dance Floor Every \n",
"Time](https://hub.theeventplannerexpo.com/entertainment/35-songs-that-get-your-event-guests-on-the-dance-floor-ever\n",
"y-time)\n",
"You'll know your client's event best, including music genre preferences and styles. But these songs are wildly \n",
"popular among many generations and are always great to have on standby should your dance guests need a boost. Party\n",
"Songs \"Flowers\" by Miley Cyrus (2023) \"TQG\" by KAROL G & Shakira (2023) \"TRUSTFALL\" by P!nk (2023)\n",
"\n",
"|Top 200 Most Requested Songs - DJ Event Planner](https://djeventplanner.com/mostrequested.htm)\n",
"Based on over 2 million requests using the DJ Event Planner song request system, this is a list of the most \n",
"requested songs of the past year. ... December 1963 (Oh, What A Night) 24: Commodores: Brick House: 25: Earth, Wind\n",
"and Fire: Boogie Wonderland: 26: Elton John: Your Song: 27: Stevie Wonder: Isn't She Lovely: 28: ... Grove St. \n",
"Party: 30 ...\n",
"\n",
"|50 Songs on Every Event Planner's Playlist - \n",
"Eventbrite](https://www.eventbrite.com/blog/event-planning-playlist-ds00/)\n",
"For example, fast-paced songs probably aren't the best fit for a formal gala. And smooth jazz is likely to lull \n",
"your guests at a motivational conference. That's why it's crucial to think about the tone you want to set and \n",
"choose a playlist that embodies it. We've compiled a list of possible tunes to help you pick the best event songs.\n",
"\n",
"|The Best Party Songs of All Time (Our Playlists)](https://www.ispytunes.com/post/best-party-songs)\n",
"Discover the best party songs to make your event unforgettable! Our playlists feature the top party songs, from \n",
"timeless classics to the latest hits. ... Last Friday Night by Katy Perry. Sweet Child O' Mine by Guns N' Roses. I \n",
"Gotta Feeling by the Black Eyed Peas. ... 200 Classic House Party Songs Everyone Knows | The Best Popular Party \n",
"Songs ...\n",
"\n",
"|15 Best Party Songs of All Time - Singersroom.com](https://singersroom.com/w75/best-party-songs-of-all-time/)\n",
"Whether it's a wild club night, a backyard BBQ, or a house party with friends, the best party songs bring people \n",
"together, get them moving, and keep the good vibes flowing all night long.\n",
"\n",
"|Best Songs To Party: DJ's Ultimate Party Songs Playlist - \n",
"Top40Weekly.com](https://top40weekly.com/best-songs-to-party/)\n",
"\"Jump Around\" by House of Pain is a classic party anthem that has stood the test of time, remaining a staple at \n",
"parties and sporting events for over two decades. The song's energetic rap verses, pulsating rhythm, and catchy \n",
"chorus create an atmosphere of pure excitement and exhilaration that never fails to ignite the dance floor.\n",
"\n",
"|50+ Best Songs For Your Next Party in 2025 - Aleka's \n",
"Get-Together](https://alekasgettogether.com/top-songs-for-any-party/)\n",
"A perfect, high-energy track to keep the party vibe strong all night. Last Friday Night (T.G.I.F.) - Katy Perry \n",
"This upbeat pop anthem is a must-play to keep the energy light and fun. Bleeding Love - Leona Lewis A heartfelt \n",
"ballad that balances out the upbeat tracks with an emotional sing-along. Crank That (Soulja Boy) - Soulja Boy Tell \n",
"'Em\n",
"\n",
"|27 Most Influential Songs About Parties & Celebrations (Must Hear)](https://www.pdmusic.org/songs-about-parties/)\n",
"Contents. 1 27 Most Famous Songs About Parties, Partying & Drinking With Friend (Ultimate Playlist); 2 #1 \"Party in\n",
"the U.S.A.\" by Miley Cyrus; 3 #2 \"I Gotta Feeling\" by The Black Eyed Peas; 4 #3 \"Party Rock Anthem\" by LMFAO; 5 #4 \n",
"\"Last Friday Night (T.G.I.F.)\" by Katy Perry; 6 #5 \"Dancing Queen\" by ABBA; 7 #6 \"Turn Down for What\" by DJ Snake &\n",
"Lil Jon\n",
"\n",
"|40 Best Party Songs | Songs To Dance To, Ranked By Our Editors - Time \n",
"Out](https://www.timeout.com/music/best-party-songs)\n",
"The best is when you go for the extended version, and find yourself in the midst of the intro for about 11 minutes.\n",
"But whichever version you go for, this is the party song, in every way. She ...\n",
"\n"
],
"text/plain": [
"Observations: ## Search Results\n",
"\n",
"|The \u001b[1;36m75\u001b[0m Best Party Songs That Will Get Everyone Dancing - \n",
"Gear4music\u001b[1m]\u001b[0m\u001b[1m(\u001b[0m\u001b[4;94mhttps://www.gear4music.com/blog/best-party-songs/\u001b[0m\u001b[4;94m)\u001b[0m\n",
"The best party songs \u001b[1;36m1\u001b[0m. \u001b[32m\"September\"\u001b[0m - Earth, Wind & Fire \u001b[1m(\u001b[0m\u001b[1;36m1978\u001b[0m\u001b[1m)\u001b[0m Quite possibly the best party song. An infectious \n",
"mix of funk and soul, \u001b[32m\"September\"\u001b[0m is celebrated for its upbeat melody and \u001b[32m\"ba-dee-ya\"\u001b[0m chorus, making it a timeless \n",
"dance favorite.\n",
"\n",
"|\u001b[1;36m45\u001b[0m Songs That Get Your Event Guests on the Dance Floor Every \n",
"Time\u001b[1m]\u001b[0m\u001b[1m(\u001b[0m\u001b[4;94mhttps://hub.theeventplannerexpo.com/entertainment/35-songs-that-get-your-event-guests-on-the-dance-floor-ever\u001b[0m\n",
"\u001b[4;94my-time\u001b[0m\u001b[4;94m)\u001b[0m\n",
"You'll know your client's event best, including music genre preferences and styles. But these songs are wildly \n",
"popular among many generations and are always great to have on standby should your dance guests need a boost. Party\n",
"Songs \u001b[32m\"Flowers\"\u001b[0m by Miley Cyrus \u001b[1m(\u001b[0m\u001b[1;36m2023\u001b[0m\u001b[1m)\u001b[0m \u001b[32m\"TQG\"\u001b[0m by KAROL G & Shakira \u001b[1m(\u001b[0m\u001b[1;36m2023\u001b[0m\u001b[1m)\u001b[0m \u001b[32m\"TRUSTFALL\"\u001b[0m by P!nk \u001b[1m(\u001b[0m\u001b[1;36m2023\u001b[0m\u001b[1m)\u001b[0m\n",
"\n",
"|Top \u001b[1;36m200\u001b[0m Most Requested Songs - DJ Event Planner\u001b[1m]\u001b[0m\u001b[1m(\u001b[0m\u001b[4;94mhttps://djeventplanner.com/mostrequested.htm\u001b[0m\u001b[4;94m)\u001b[0m\n",
"Based on over \u001b[1;36m2\u001b[0m million requests using the DJ Event Planner song request system, this is a list of the most \n",
"requested songs of the past year. \u001b[33m...\u001b[0m December \u001b[1;36m1963\u001b[0m \u001b[1m(\u001b[0mOh, What A Night\u001b[1m)\u001b[0m \u001b[1;36m24\u001b[0m: Commodores: Brick House: \u001b[1;36m25\u001b[0m: Earth, Wind\n",
"and Fire: Boogie Wonderland: \u001b[1;36m26\u001b[0m: Elton John: Your Song: \u001b[1;36m27\u001b[0m: Stevie Wonder: Isn't She Lovely: \u001b[1;36m28\u001b[0m: \u001b[33m...\u001b[0m Grove St. \n",
"Party: \u001b[1;36m30\u001b[0m \u001b[33m...\u001b[0m\n",
"\n",
"|\u001b[1;36m50\u001b[0m Songs on Every Event Planner's Playlist - \n",
"Eventbrite\u001b[1m]\u001b[0m\u001b[1m(\u001b[0m\u001b[4;94mhttps://www.eventbrite.com/blog/event-planning-playlist-ds00/\u001b[0m\u001b[4;94m)\u001b[0m\n",
"For example, fast-paced songs probably aren't the best fit for a formal gala. And smooth jazz is likely to lull \n",
"your guests at a motivational conference. That's why it's crucial to think about the tone you want to set and \n",
"choose a playlist that embodies it. We've compiled a list of possible tunes to help you pick the best event songs.\n",
"\n",
"|The Best Party Songs of All Time \u001b[1m(\u001b[0mOur Playlists\u001b[1m)\u001b[0m\u001b[1m]\u001b[0m\u001b[1m(\u001b[0m\u001b[4;94mhttps://www.ispytunes.com/post/best-party-songs\u001b[0m\u001b[4;94m)\u001b[0m\n",
"Discover the best party songs to make your event unforgettable! Our playlists feature the top party songs, from \n",
"timeless classics to the latest hits. \u001b[33m...\u001b[0m Last Friday Night by Katy Perry. Sweet Child O' Mine by Guns N' Roses. I \n",
"Gotta Feeling by the Black Eyed Peas. \u001b[33m...\u001b[0m \u001b[1;36m200\u001b[0m Classic House Party Songs Everyone Knows | The Best Popular Party \n",
"Songs \u001b[33m...\u001b[0m\n",
"\n",
"|\u001b[1;36m15\u001b[0m Best Party Songs of All Time - Singersroom.com\u001b[1m]\u001b[0m\u001b[1m(\u001b[0m\u001b[4;94mhttps://singersroom.com/w75/best-party-songs-of-all-time/\u001b[0m\u001b[4;94m)\u001b[0m\n",
"Whether it's a wild club night, a backyard BBQ, or a house party with friends, the best party songs bring people \n",
"together, get them moving, and keep the good vibes flowing all night long.\n",
"\n",
"|Best Songs To Party: DJ's Ultimate Party Songs Playlist - \n",
"Top40Weekly.com\u001b[1m]\u001b[0m\u001b[1m(\u001b[0m\u001b[4;94mhttps://top40weekly.com/best-songs-to-party/\u001b[0m\u001b[4;94m)\u001b[0m\n",
"\u001b[32m\"Jump Around\"\u001b[0m by House of Pain is a classic party anthem that has stood the test of time, remaining a staple at \n",
"parties and sporting events for over two decades. The song's energetic rap verses, pulsating rhythm, and catchy \n",
"chorus create an atmosphere of pure excitement and exhilaration that never fails to ignite the dance floor.\n",
"\n",
"|\u001b[1;36m50\u001b[0m+ Best Songs For Your Next Party in \u001b[1;36m2025\u001b[0m - Aleka's \n",
"Get-Together\u001b[1m]\u001b[0m\u001b[1m(\u001b[0m\u001b[4;94mhttps://alekasgettogether.com/top-songs-for-any-party/\u001b[0m\u001b[4;94m)\u001b[0m\n",
"A perfect, high-energy track to keep the party vibe strong all night. Last Friday Night \u001b[1m(\u001b[0mT.G.I.F.\u001b[1m)\u001b[0m - Katy Perry \n",
"This upbeat pop anthem is a must-play to keep the energy light and fun. Bleeding Love - Leona Lewis A heartfelt \n",
"ballad that balances out the upbeat tracks with an emotional sing-along. Crank That \u001b[1m(\u001b[0mSoulja Boy\u001b[1m)\u001b[0m - Soulja Boy Tell \n",
"'Em\n",
"\n",
"|\u001b[1;36m27\u001b[0m Most Influential Songs About Parties & Celebrations \u001b[1m(\u001b[0mMust Hear\u001b[1m)\u001b[0m\u001b[1m]\u001b[0m\u001b[1m(\u001b[0m\u001b[4;94mhttps://www.pdmusic.org/songs-about-parties/\u001b[0m\u001b[4;94m)\u001b[0m\n",
"Contents. \u001b[1;36m1\u001b[0m \u001b[1;36m27\u001b[0m Most Famous Songs About Parties, Partying & Drinking With Friend \u001b[1m(\u001b[0mUltimate Playlist\u001b[1m)\u001b[0m; \u001b[1;36m2\u001b[0m #\u001b[1;36m1\u001b[0m \u001b[32m\"Party in\u001b[0m\n",
"\u001b[32mthe U.S.A.\"\u001b[0m by Miley Cyrus; \u001b[1;36m3\u001b[0m #\u001b[1;36m2\u001b[0m \u001b[32m\"I Gotta Feeling\"\u001b[0m by The Black Eyed Peas; \u001b[1;36m4\u001b[0m #\u001b[1;36m3\u001b[0m \u001b[32m\"Party Rock Anthem\"\u001b[0m by LMFAO; \u001b[1;36m5\u001b[0m #\u001b[1;36m4\u001b[0m \n",
"\u001b[32m\"Last Friday Night \u001b[0m\u001b[32m(\u001b[0m\u001b[32mT.G.I.F.\u001b[0m\u001b[32m)\u001b[0m\u001b[32m\"\u001b[0m by Katy Perry; \u001b[1;36m6\u001b[0m #\u001b[1;36m5\u001b[0m \u001b[32m\"Dancing Queen\"\u001b[0m by ABBA; \u001b[1;36m7\u001b[0m #\u001b[1;36m6\u001b[0m \u001b[32m\"Turn Down for What\"\u001b[0m by DJ Snake &\n",
"Lil Jon\n",
"\n",
"|\u001b[1;36m40\u001b[0m Best Party Songs | Songs To Dance To, Ranked By Our Editors - Time \n",
"Out\u001b[1m]\u001b[0m\u001b[1m(\u001b[0m\u001b[4;94mhttps://www.timeout.com/music/best-party-songs\u001b[0m\u001b[4;94m)\u001b[0m\n",
"The best is when you go for the extended version, and find yourself in the midst of the intro for about \u001b[1;36m11\u001b[0m minutes.\n",
"But whichever version you go for, this is the party song, in every way. She \u001b[33m...\u001b[0m\n"
]
},
"metadata": {},
"output_type": "display_data"
},
{
"data": {
"text/html": [
"[Step 1: Duration 6.66 seconds| Input tokens: 3,435 | Output tokens: 55]\n",
"\n"
],
"text/plain": [
"\u001b[2m[Step 1: Duration 6.66 seconds| Input tokens: 3,435 | Output tokens: 55]\u001b[0m\n"
]
},
"metadata": {},
"output_type": "display_data"
},
{
"data": {
"text/html": [
"━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ Step 3 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n",
"\n"
],
"text/plain": [
"\u001b[38;2;212;183;2m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ \u001b[0m\u001b[1mStep \u001b[0m\u001b[1;36m3\u001b[0m\u001b[38;2;212;183;2m ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m\n"
]
},
"metadata": {},
"output_type": "display_data"
},
{
"data": {
"text/html": [
"╭─────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮\n",
"│ Calling tool: 'final_answer' with arguments: {'answer': \"For a party at Wayne's mansion, consider playing a mix │\n",
"│ of classic party hits and modern anthems to cater to various age groups. A recommended playlist might include │\n",
"│ songs like 'September' by Earth, Wind & Fire, 'I Gotta Feeling' by The Black Eyed Peas, 'Last Friday Night │\n",
"│ (T.G.I.F.)' by Katy Perry, 'Dancing Queen' by ABBA, 'Turn Down for What' by DJ Snake & Lil Jon, and 'Crank That │\n",
"│ (Soulja Boy)' by Soulja Boy Tell 'Em. These songs are known to get everyone dancing and celebrating!\"} │\n",
"╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯\n",
"\n"
],
"text/plain": [
"╭─────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮\n",
"│ Calling tool: 'final_answer' with arguments: {'answer': \"For a party at Wayne's mansion, consider playing a mix │\n",
"│ of classic party hits and modern anthems to cater to various age groups. A recommended playlist might include │\n",
"│ songs like 'September' by Earth, Wind & Fire, 'I Gotta Feeling' by The Black Eyed Peas, 'Last Friday Night │\n",
"│ (T.G.I.F.)' by Katy Perry, 'Dancing Queen' by ABBA, 'Turn Down for What' by DJ Snake & Lil Jon, and 'Crank That │\n",
"│ (Soulja Boy)' by Soulja Boy Tell 'Em. These songs are known to get everyone dancing and celebrating!\"} │\n",
"╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯\n"
]
},
"metadata": {},
"output_type": "display_data"
},
{
"data": {
"text/html": [
"Final answer: For a party at Wayne's mansion, consider playing a mix of classic party hits and modern anthems to \n",
"cater to various age groups. A recommended playlist might include songs like 'September' by Earth, Wind & Fire, 'I \n",
"Gotta Feeling' by The Black Eyed Peas, 'Last Friday Night (T.G.I.F.)' by Katy Perry, 'Dancing Queen' by ABBA, 'Turn\n",
"Down for What' by DJ Snake & Lil Jon, and 'Crank That (Soulja Boy)' by Soulja Boy Tell 'Em. These songs are known \n",
"to get everyone dancing and celebrating!\n",
"\n"
],
"text/plain": [
"\u001b[1;38;2;212;183;2mFinal answer: For a party at Wayne's mansion, consider playing a mix of classic party hits and modern anthems to \u001b[0m\n",
"\u001b[1;38;2;212;183;2mcater to various age groups. A recommended playlist might include songs like 'September' by Earth, Wind & Fire, 'I \u001b[0m\n",
"\u001b[1;38;2;212;183;2mGotta Feeling' by The Black Eyed Peas, 'Last Friday Night (T.G.I.F.)' by Katy Perry, 'Dancing Queen' by ABBA, 'Turn\u001b[0m\n",
"\u001b[1;38;2;212;183;2mDown for What' by DJ Snake & Lil Jon, and 'Crank That (Soulja Boy)' by Soulja Boy Tell 'Em. These songs are known \u001b[0m\n",
"\u001b[1;38;2;212;183;2mto get everyone dancing and celebrating!\u001b[0m\n"
]
},
"metadata": {},
"output_type": "display_data"
},
{
"data": {
"text/html": [
"[Step 2: Duration 10.69 seconds| Input tokens: 6,869 | Output tokens: 199]\n",
"\n"
],
"text/plain": [
"\u001b[2m[Step 2: Duration 10.69 seconds| Input tokens: 6,869 | Output tokens: 199]\u001b[0m\n"
]
},
"metadata": {},
"output_type": "display_data"
},
{
"data": {
"application/vnd.google.colaboratory.intrinsic+json": {
"type": "string"
},
"text/plain": [
"\"For a party at Wayne's mansion, consider playing a mix of classic party hits and modern anthems to cater to various age groups. A recommended playlist might include songs like 'September' by Earth, Wind & Fire, 'I Gotta Feeling' by The Black Eyed Peas, 'Last Friday Night (T.G.I.F.)' by Katy Perry, 'Dancing Queen' by ABBA, 'Turn Down for What' by DJ Snake & Lil Jon, and 'Crank That (Soulja Boy)' by Soulja Boy Tell 'Em. These songs are known to get everyone dancing and celebrating!\""
]
},
"execution_count": 3,
"metadata": {},
"output_type": "execute_result"
}
],
"source": [
"from smolagents import ToolCallingAgent, DuckDuckGoSearchTool, HfApiModel\n",
"\n",
"agent = ToolCallingAgent(tools=[DuckDuckGoSearchTool()], model=HfApiModel())\n",
"\n",
"agent.run(\"Search for the best music recommendations for a party at the Wayne's mansion.\")"
]
},
{
"cell_type": "markdown",
"source": [
"\n",
"When you examine the agent's trace, instead of seeing `Executing parsed code:`, you'll see something like:\n",
"\n",
"```text\n",
"╭─────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮\n",
"│ Calling tool: 'web_search' with arguments: {'query': \"best music recommendations for a party at Wayne's │\n",
"│ mansion\"} │\n",
"╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯\n",
"``` \n",
"\n",
"The agent generates a structured tool call that the system processes to produce the output, rather than directly executing code like a `CodeAgent`.\n",
"\n",
"Now that we understand both agent types, we can choose the right one for our needs. Let's continue exploring `smolagents` to make Alfred's party a success! 🎉"
],
"metadata": {
"id": "Cl19VWGRYXrr"
}
}
],
"metadata": {
"colab": {
"provenance": []
},
"kernelspec": {
"display_name": "Python 3",
"name": "python3"
},
"language_info": {
"name": "python"
}
},
"nbformat": 4,
"nbformat_minor": 0
}