AG2 Files

Highlights

BREAKING - Docker Moved to Extra

• The docker package, used for code execution with Docker, is now an optional dependency. please install with ag2[docker].

🛣️ Continuing the Path to v1.0

v0.12.1 builds on the v0.12.0 foundation with new tools, Google Vertex AI support, bug fixes, and community feedback on the roadmap.

👥 Community Feedback in Action

• ✅ PerplexitySearchTool removed from deprecations – Based on community feedback, this tool will continue to be supported. Thanks for speaking up! Keep the feedback coming.

🔬 Beta: Major New Capabilities

• 📁 Files API Client – New Files API client and related functionality for file handling in Beta.
• 🔧 Multi-part ToolResult – Tools can now return Input types and multi-part ToolResult.
• 🔧 Toolkit Merging API – New API for merging toolkits, with updated common tools documentation.
• ☁️ Google Vertex AI Support – Use models on Google Vertex AI.

🧰 New Search Tools

• 🔍 TavilySearchTool – New Tavily-powered web search tool.
• 🔍 ExaToolkit – New toolkit for Exa search.
• 🦆 DDGS Tool (Beta) – New DuckDuckGo search tool in Beta.

🎉 New Features

• 🎯 Advanced Orchestration with Step Events – Step event support for advanced orchestration patterns.
• 🔗 LangChain ChatVertexAI Factory – New interop factory for Gemini on Vertex AI via LangChain.

Bug Fixes

• 🔧 HTTP Request Timeouts – Added timeouts to HTTP requests across multiple modules.
• 🔧 AG-UI Flow – Fixed AG-UI flow and new ToolResult.parts shape handling in the adapter.
• 🔧 Logger Redaction – Applied redact() to remaining unredacted logger paths.
• 🔧 Beta: Anthropic Token Usage – Added total_tokens to Usage calculation for Anthropic.
• 🔧 Beta: RedisStream – Dispatch events locally before publishing.
• 🔧 Beta: Input Type Mappers – Fixed beta input type mappers.
• 🔧 OpenTelemetry – Fixed ModuleNotFoundError for opentelemetry.exporter.otlp.proto.grpc.

Documentation

• 🔗 Fixed numerous broken internal and external links across docs, blog posts, and notebooks.
• 🖼️ Fixed missing ecosystem-composio.png image.

Maintenance

• 🔧 CI: Skip Claude Code Review for Dependabot PRs.

What's Changed

• Missing image file ecosystem-composio.png by @VasiliyRad in https://github.com/ag2ai/ag2/pull/2667
• Broken external link: stackoverflow.com/help/mcve (404) by @VasiliyRad in https://github.com/ag2ai/ag2/pull/2669
• Broken external link: huggingface.co/datasets/openai_humaneval (404) by @VasiliyRad in https://github.com/ag2ai/ag2/pull/2670
• Broken GitHub link: simple_workflow.py returns 404 by @VasiliyRad in https://github.com/ag2ai/ag2/pull/2673
• Broken localhost link in WebSockets blog post by @VasiliyRad in https://github.com/ag2ai/ag2/pull/2674
• Broken link to agenteval_cq_math.ipynb by @VasiliyRad in https://github.com/ag2ai/ag2/pull/2677
• Broken link to docs.together.ai/docs/examples by @VasiliyRad in https://github.com/ag2ai/ag2/pull/2678
• Broken link to autobuild_basic.ipynb by @VasiliyRad in https://github.com/ag2ai/ag2/pull/2679
• Broken internal link on Realtime API category page by @VasiliyRad in https://github.com/ag2ai/ag2/pull/2680
• Broken internal link on AG2 logging events blog page by @VasiliyRad in https://github.com/ag2ai/ag2/pull/2681
• Broken internal link on GPT-Researcher blog page by @VasiliyRad in https://github.com/ag2ai/ag2/pull/2682
• Broken internal link on Gemini Thinking Config blog page by @VasiliyRad in https://github.com/ag2ai/ag2/pull/2683
• Broken internal link on Gemini Thinking Config blog page by @VasiliyRad in https://github.com/ag2ai/ag2/pull/2684
• ModuleNotFoundError: opentelemetry.exporter.otlp.proto.grpc not... by @VasiliyRad in https://github.com/ag2ai/ag2/pull/2640
• Broken external link: google.github.io/A2A/ returns 404 by @VasiliyRad in https://github.com/ag2ai/ag2/pull/2641
• Broken links with double slash in GitHub URLs by @VasiliyRad in https://github.com/ag2ai/ag2/pull/2642
• roadmap: Remove PerplexitySearchTool from deprecations by @marklysze in https://github.com/ag2ai/ag2/pull/2703
• Update advanced orchestration with step events by @priyansh4320 in https://github.com/ag2ai/ag2/pull/2328
• feat: Move docker to extra by @marklysze in https://github.com/ag2ai/ag2/pull/2705
• feat(beta): Ddgs tool by @vvlrff in https://github.com/ag2ai/ag2/pull/2690
• feat: add TavilySearchTool and related functionality for web search by @vvlrff in https://github.com/ag2ai/ag2/pull/2701
• feat: add toolkit merging API and update common tools docs by @Lancetnik in https://github.com/ag2ai/ag2/pull/2711
• feat: allow tools to return Input types and multi-part ToolResult by @Lancetnik in https://github.com/ag2ai/ag2/pull/2713
• feat(beta): Google Vertex AI support by @marklysze in https://github.com/ag2ai/ag2/pull/2715
• fix: Tool call thought signature preservation with VertexAI by @marklysze in https://github.com/ag2ai/ag2/pull/2720
• fix(beta): Streaming usage metadata with VertexAI by @marklysze in https://github.com/ag2ai/ag2/pull/2719
• feat: add ExaToolkit and related functionality for Exa search by @vvlrff in https://github.com/ag2ai/ag2/pull/2714
• fix: add timeout to HTTP requests across multiple modules by @Ricardo-M-L in https://github.com/ag2ai/ag2/pull/2722
• fix: correct AG-UI flow by @Lancetnik in https://github.com/ag2ai/ag2/pull/2723
• fix(beta): handle new ToolResult.parts shape in AG-UI adapter by @vidhuUC in https://github.com/ag2ai/ag2/pull/2721
• fix: apply redact() to remaining unredacted logger paths by @amabito in https://github.com/ag2ai/ag2/pull/2500
• fix(beta): Add total_tokens to Usage calculation for Anthropic by @marklysze in https://github.com/ag2ai/ag2/pull/2724
• feat(beta): implement Files API client and related functionality by @vvlrff in https://github.com/ag2ai/ag2/pull/2688
• fix(beta): Dispatch RedisStream events locally before publishing by @marklysze in https://github.com/ag2ai/ag2/pull/2726
• fix(beta): Beta input types mappers by @vvlrff in https://github.com/ag2ai/ag2/pull/2718
• ci: skip Claude Code Review for Dependabot PRs by @elCaptnCode in https://github.com/ag2ai/ag2/pull/2729
• feat(interop-langchain): add ChatVertexAI factory for Gemini on Vertex AI by @VasiliyRad in https://github.com/ag2ai/ag2/pull/2727
• fix(tests): Remove JSON mode structured output tests for Anthropic by @marklysze in https://github.com/ag2ai/ag2/pull/2733
• Version bump to 0.12.1 by @marklysze in https://github.com/ag2ai/ag2/pull/2734

New Contributors

• @vidhuUC made their first contribution in https://github.com/ag2ai/ag2/pull/2721

Full Changelog: https://github.com/ag2ai/ag2/compare/v0.12.0...v0.12.1