v1.18.0

huggingface/smolagentsv1.18.0Jun 10, 2025by albertvillanova

AI Summary

Adds parallel tool calls, streaming outputs, and a new API Web Search Tool. It also updates terminology in prompts from 'search' to 'web_search' and 'wiki' to 'wiki_search'.

Key Highlights

  • ToolCallingAgent now handles multiple tool calls in parallel
  • Added streaming outputs for ToolCallingAgent
  • Introduced new ApiWebSearchTool for structured web search
  • Updated terminology in prompts (search -> web_search)

New Features

  • Parallel tool calls
  • Streaming outputs
  • API Web Search Tool

Full Release Notes

## New Features ✨
* **Multiple Parallel Tool Calls**: ToolCallingAgent can now handle multiple tool calls in parallel, significantly enhancing performance for complex tasks.
  * Support multiple tool calls in parallel in ToolCallingAgent by @albertvillanova in https://github.com/huggingface/smolagents/pull/1412
* **Streaming Output for ToolCallingAgent**: ToolCallingAgent now supports streaming outputs, improving responsiveness and user experience during multi-step tool interactions
  * Streaming outputs for ToolCallingAgent 🚀 by @aymeric-roucher in https://github.com/huggingface/smolagents/pull/1409
* **API Web Search Tool**: Introduced a new ApiWebSearchTool, enabling structured web search capabilities via API.
  * Create API web search tool by @albertvillanova in https://github.com/huggingface/smolagents/pull/1400

## Enhancements 🛠️
* Update prompts to avoid confusion: search -> web_search and wiki -> wiki_search by @SrzStephen in https://github.com/huggingface/smolagents/pull/1403
* Make Agent.system_prompt read only by @albertvillanova in https://github.com/huggingface/smolagents/pull/1399
* Support configurable tool_choice in prepare_completion_kwargs by @albertvillanova in https://github.com/huggingface/smolagents/pull/1392
* Support passing additional params to MLXModel load and tokenizer.apply_chat_template by @albertvillanova in https://github.com/huggingface/smolagents/pull/1406
* Support custom headers/params for ApiWebSearchTool by @albertvillanova in https://github.com/huggingface/smolagents/pull/1411

## Bug Fixes 🐛
* Fix: Support custom inputs execution for custom Final Answer Tool by @Lrakotoson in https://github.com/huggingface/smolagents/pull/1383
* Fix @tool decorator for remote Python executor by @tobiasofsn in https://github.com/huggingface/smolagents/pull/1334
* Always pass add_generation_prompt=True to apply_chat_template by @albertvillanova in https://github.com/huggingface/smolagents/pull/1416

## Documentation Improvements 📚
* Make docs neutral about agent types by @julien-c in https://github.com/huggingface/smolagents/pull/1376
* Add MCP tools doc section by @aymeric-roucher in https://github.com/huggingface/smolagents/pull/1394
* Update ToolCollection.from_mcp docstring examples by @neonwatty in https://github.com/huggingface/smolagents/pull/1398
* Document better final_answer_checks by @albertvillanova in https://github.com/huggingface/smolagents/pull/1407
* Fix typo in secure code execution documentation by @chahn in https://github.com/huggingface/smolagents/pull/1414
* Add chat server demo to examples by @albertvillanova in https://github.com/huggingface/smolagents/pull/1415
* Fix VLM model in web_browser example docs by @albertvillanova in https://github.com/huggingface/smolagents/pull/1424
* Fix ValueError on Guided Tour docs by @albertvillanova in https://github.com/huggingface/smolagents/pull/1425
* Explain agent types better in Guided tour docs by @albertvillanova in https://github.com/huggingface/smolagents/pull/1426
* Add Quickstart page to docs by @albertvillanova in https://github.com/huggingface/smolagents/pull/1413

## Maintenance 🏗️
* Bump dev version: v1.18.0.dev0 by @albertvillanova in https://github.com/huggingface/smolagents/pull/1390

## New Contributors
* @Lrakotoson made their first contribution in https://github.com/huggingface/smolagents/pull/1383
* @neonwatty made their first contribution in https://github.com/huggingface/smolagents/pull/1398
* @SrzStephen made their first contribution in https://github.com/huggingface/smolagents/pull/1403
* @chahn made their first contribution in https://github.com/huggingface/smolagents/pull/1414

**Full Changelog**: https://github.com/huggingface/smolagents/compare/v1.17.0...v1.18.0