AG2 Files

Highlights

v0.12.3 brings A2A v1.0 compatibility, sandboxed code execution in Beta, and a refreshed search story.

📍 Release Roadmap · 📔 V1.0 Contribution Policy

🤝 A2A v1.0 Compatibility

• 🔗 A2A v1.0 Spec Compatibility – AG2 now aligns with the v1.0 Agent2Agent protocol specification, ensuring interoperability with the broader A2A ecosystem.

🔬 Beta: Sandboxed Code Execution

• 🏖️ SandboxCodeTool – New Beta tool for sandboxed code execution with Daytona and Docker environments. Run agent-generated code safely in isolated environments with your choice of backend.

🔍 Beta: Search Tools Refresh

• 🔍 PerplexitySearchToolkit – Renamed from PerplexitySearchTool to PerplexitySearchToolkit for consistency with the toolkit pattern. Documentation updated.
• ✨ Perplexity Search Integration – New top-level Perplexity Search integration.
• 🔧 ExaToolkit Updates – Updated for the current Exa API, with integration header now set via client.headers.
• ⚡ Async SDK Clients in Search Tools – Search tools now use async SDK clients for better performance.

Bug Fixes

• 🔧 Beta: OpenAI Image Handling – Fixed image handling on both Chat Completions and Responses APIs.
• 🔧 Beta: ModelMessage None Content – Now handled correctly.
• 🔧 Gemini Exception Handling – Replaced bare except with except Exception in gemini_types.
• 🔧 SQLite Logger – Use full path when opening migration scripts.

Documentation & Maintenance

• 📔 V1.0 Contribution Policy – New contribution guidelines for the path to v1.0
• 📔 Fixed Python version requirement in README.
• 📦 Added Python 3.11+ markers for dependencies that require it.

What's Changed

• feat: add Perplexity Search integration by @jliounis in https://github.com/ag2ai/ag2/pull/2752
• fix: replace bare except with except Exception in gemini_types by @Ricardo-M-L in https://github.com/ag2ai/ag2/pull/2717
• fix: use full path when opening migration scripts in sqlite_logger by @Ricardo-M-L in https://github.com/ag2ai/ag2/pull/2716
• fix(beta): correct OpenAI image handling on Chat Completions and Responses by @marklysze in https://github.com/ag2ai/ag2/pull/2759
• feat(beta): rename PerplexitySearchTool to PerplexitySearchToolkit and update related documentation by @vvlrff in https://github.com/ag2ai/ag2/pull/2760
• feat(beta): add SandboxCodeTool with Daytona and Docker environments by @marklysze in https://github.com/ag2ai/ag2/pull/2763
• docs: fix Python version requirement in README by @ohdearquant in https://github.com/ag2ai/ag2/pull/2768
• fix: add Python 3.11+ markers for deps that require it by @ohdearquant in https://github.com/ag2ai/ag2/pull/2769
• fix(beta): update ExaToolkit for current Exa API by @10ishq in https://github.com/ag2ai/ag2/pull/2778
• Handle None content in ModelMessage by @Lancetnik in https://github.com/ag2ai/ag2/pull/2780
• fix(beta): set Exa integration header via client.headers by @10ishq in https://github.com/ag2ai/ag2/pull/2779
• refactor(beta): use async SDK clients in search tools by @vvlrff in https://github.com/ag2ai/ag2/pull/2764
• docs: V1.0 Contribution Policy by @marklysze in https://github.com/ag2ai/ag2/pull/2749
• feat: Upgrade to a2a-sdk v1.0 and implement compatibility layer for v0.3 by @vvlrff in https://github.com/ag2ai/ag2/pull/2771
• Version bump to 0.12.3 by @marklysze in https://github.com/ag2ai/ag2/pull/2783

New Contributors

• @jliounis made their first contribution in https://github.com/ag2ai/ag2/pull/2752
• @10ishq made their first contribution in https://github.com/ag2ai/ag2/pull/2778

Full Changelog: https://github.com/ag2ai/ag2/compare/v0.12.2...v0.12.3