Ag2

Highlights
- 🔮 Perplexity AI Search Tool! Add AI-based web search capabilities to your agents.
- [Documentation](https://docs.ag2.ai/docs/user-guide/reference-tools/perplexity-search), [Notebook](https://docs.ag2.ai/docs/use-cases/notebooks/notebooks/tools_perplexity_search)
- 🔴 YouTube Search Tool! Enable your agents to find videos on YouTube using natural language.
- [Documentation](https://docs.ag2.ai/docs/user-guide/reference-tools/google-api/youtube-search), [Notebook](https://docs.ag2.ai/docs/use-cases/notebooks/notebooks/tools_youtube_search)
- 🔍 ReasoningAgent interim execution and improved termination
- 🔧 Tool choice parameters added to force/disable tool use
- 🛠️📖 Fixes and documentation improvements

♥️ Thanks to all the contributors and collaborators that helped make the release happen!

New Contributors
* ronaldpereira made their first contribution in https://github.com/ag2ai/ag2/pull/1431

What's Changed
* ReasoningAgent interim execution by giorgossideris in https://github.com/ag2ai/ag2/pull/1419
* updated notebooks missing front matter metadata by marufaytekin in https://github.com/ag2ai/ag2/pull/1445
* Fix exception in CaptainAgent when using LLMConfig by kumaranvpl in https://github.com/ag2ai/ag2/pull/1447
* Reasoning Notebook fixes by marklysze in https://github.com/ag2ai/ag2/pull/1449
* Perplexity AI search tool implementation by marufaytekin in https://github.com/ag2ai/ag2/pull/1439
* ReasoningAgent Fix process termination by giorgossideris in https://github.com/ag2ai/ag2/pull/1438
* [Docs]: Pattern Cookbook - Redundant Pattern to use nested chat by marklysze in https://github.com/ag2ai/ag2/pull/1435
* Add youtube search tool, notebook, and doc. by CAROLZXYZXY in https://github.com/ag2ai/ag2/pull/1440
* Fix Bedrock Boto3 Client Timeout by ronaldpereira in https://github.com/ag2ai/ag2/pull/1431
* Add Tool Choice parameter to model provider configs for tool control by marklysze in https://github.com/ag2ai/ag2/pull/1450
* Tool Choice test updates for new parameters by marklysze in https://github.com/ag2ai/ag2/pull/1459
* YouTube tool notebook metadata and documentation page linking by marklysze in https://github.com/ag2ai/ag2/pull/1460
* Bump version to 0.8.4 by marklysze in https://github.com/ag2ai/ag2/pull/1458

**Full Changelog**: https://github.com/ag2ai/ag2/compare/v0.8.3...v0.8.4

Highlights
- *FIXED*: LLMConfig bug that associated an agent's tools with other agents using the same LLM Configuration when using the context manager
- 🌐 BrowserUseTool can now return the URLs used
- 🚀 Anthropic client class now supported by MultimodalConversableAgent for images (great for OCR)
- 🔍 ReasoningAgent improved alignment through prompting and code execution config fix
- 🛠️📖 Fixes and documentation improvements

♥️ Thanks to all the contributors and collaborators that helped make the release happen!

New Contributors
* jk10001 made their first contribution in https://github.com/ag2ai/ag2/pull/1273

What's Changed
* bug fix for max_consecutive_auto_reply by marufaytekin in https://github.com/ag2ai/ag2/pull/1374
* [Docs] Generate notebooks section by harishmohanraj in https://github.com/ag2ai/ag2/pull/1378
* Fix CI by harishmohanraj in https://github.com/ag2ai/ag2/pull/1398
* [Docs] Add broken link checker for mkdocs site by harishmohanraj in https://github.com/ag2ai/ag2/pull/1399
* Use LLMConfig in function signatures properly by kumaranvpl in https://github.com/ag2ai/ag2/pull/1400
* Align ReasoningAgent through prompting by giorgossideris in https://github.com/ag2ai/ag2/pull/1345
* ReasoningAgent fix code_execution_config by giorgossideris in https://github.com/ag2ai/ag2/pull/1362
* Use LLMConfig in notebooks by kumaranvpl in https://github.com/ag2ai/ag2/pull/1391
* Use LLMConfig instead of dict in blogs by kumaranvpl in https://github.com/ag2ai/ag2/pull/1393
* [Docs] Fix edit links by harishmohanraj in https://github.com/ag2ai/ag2/pull/1407
* Update BrowserUseResult by rjambrecic in https://github.com/ag2ai/ag2/pull/1414
* Fix bug in filter_config while using string instead of list as filter… by kumaranvpl in https://github.com/ag2ai/ag2/pull/1417
* BrowserUseTool quick fix for multiple tool calls by rjambrecic in https://github.com/ag2ai/ag2/pull/1421
* Anthropic image format fix by jk10001 in https://github.com/ag2ai/ag2/pull/1273
* Updated OllamaLLMConfigEntry defaults by marklysze in https://github.com/ag2ai/ag2/pull/1360
* Fix: AttributeError: 'HttpUrl' object has no attribute 'partition' in Ollama Client by marufaytekin in https://github.com/ag2ai/ag2/pull/1426
* Add voice as parameter and use SecretStr for relevant fields by kumaranvpl in https://github.com/ag2ai/ag2/pull/1425
* Copy llmconfig by kumaranvpl in https://github.com/ag2ai/ag2/pull/1428
* Fix usage of LLMConfig in docs guides by kumaranvpl in https://github.com/ag2ai/ag2/pull/1415
* minor update link Getting-Started.mdx by sky-coderay in https://github.com/ag2ai/ag2/pull/1387
* Updated model provider compatibility in Structured Output notebook by marklysze in https://github.com/ag2ai/ag2/pull/1433
* Bump 0.8.3 by marklysze in https://github.com/ag2ai/ag2/pull/1432

**Full Changelog**: https://github.com/ag2ai/ag2/compare/v0.8.2...v0.8.3

Highlights
- 🔍 Add **real-time web searches** to your agents using the new [Google Search Tool](https://docs.ag2.ai/docs/user-guide/reference-tools/google-api/google-search)!
- 📝 LLM configurations can now use a new type-safe [LLMConfig](https://docs.ag2.ai/docs/user-guide/basic-concepts/llm-configuration/llm-configuration) object
- 📔⚡ [`DocAgent`](https://docs.ag2.ai/docs/user-guide/reference-agents/docagent) can now add citations! [See how…](https://docs.ag2.ai/docs/use-cases/notebooks/notebooks/agents_docagent#%5Bwith-citations-support%5D-ingesting-local-documents-and-answering-questions)
- 🦙🔍 [`DocAgent`](https://docs.ag2.ai/docs/user-guide/reference-agents/docagent) can now use any LlamaIndex vector store for embedding and querying its ingested documents! [See how...](https://docs.ag2.ai/docs/use-cases/notebooks/notebooks/LlamaIndex_query_engine)
- 🐝 9 x Swarm patterns with [full code examples](https://docs.ag2.ai/docs/user-guide/advanced-concepts/pattern-cookbook/overview)
- Termination messages added to indicate why a workflow ended
- 📖 Many improvements to documentation
- 🛠️ Fixes, fixes and more fixes

♥️ Thanks to all the contributors and collaborators that helped make the release happen!

What's Changed
* Updated support for OpenAI package 1.66.2 by marklysze in https://github.com/ag2ai/ag2/pull/1320
* [Docs] Add blogs to mkdocs by harishmohanraj in https://github.com/ag2ai/ag2/pull/1312
* Remove pysqlite3-binary dependency by rjambrecic in https://github.com/ag2ai/ag2/pull/1301
* Fix failing tests on Windows by harishmohanraj in https://github.com/ag2ai/ag2/pull/1329
* Add row to MAINTAINERS.md by giorgossideris in https://github.com/ag2ai/ag2/pull/1317
* Integrate fast-depends into the repo by davorrunje in https://github.com/ag2ai/ag2/pull/1327
* Add guidance on using GOOGLE_GEMINI_API_KEY by marklysze in https://github.com/ag2ai/ag2/pull/1318
* Termination messages by marklysze in https://github.com/ag2ai/ag2/pull/1336
* Correct code execution document text by marklysze in https://github.com/ag2ai/ag2/pull/1335
* Suppress warnings by marklysze in https://github.com/ag2ai/ag2/pull/1334
* [Docs]: Swarm Patterns documentation by marklysze in https://github.com/ag2ai/ag2/pull/1255
* Add package version to import utils by davorrunje in https://github.com/ag2ai/ag2/pull/1331
* Implement GoogleSearchTool by rjambrecic in https://github.com/ag2ai/ag2/pull/1315

**Full Changelog**: https://github.com/ag2ai/ag2/compare/v0.8.1...v0.8.2rc0

Highlights
- 🧠 Google GenAI's latest package is now supported
- 📔 [`DocAgent`](https://docs.ag2.ai/docs/user-guide/reference-agents/docagent) now utilises [OnContextCondition](https://docs.ag2.ai/docs/user-guide/advanced-concepts/swarm/deep-dive#registering-context-variable-based-handoffs-to-agents) for a faster and even more reliable workflow
- 🐝 Swarm function registration fixes and [notebook](https://docs.ag2.ai/docs/use-cases/notebooks/notebooks/agentchat_swarm_enhanced) improvements
- 📖 Many improvements to documentation and the API reference
- 🛠️ Fixes, fixes and more fixes

♥️ Thanks to all the contributors and collaborators that helped make the release happen!

New Contributors
* annwag made their first contribution in https://github.com/ag2ai/ag2/pull/1261
* hexcow made their first contribution in https://github.com/ag2ai/ag2/pull/1270
* sky-coderay made their first contribution in https://github.com/ag2ai/ag2/pull/1272

What's Changed
* Communication Agent and Tools documentation by marklysze in https://github.com/ag2ai/ag2/pull/1249
* Configure ruff pre-commit rule to mandate the documentation for every function parameter. by harishmohanraj in https://github.com/ag2ai/ag2/pull/1244
* Remove obsolete completion by kumaranvpl in https://github.com/ag2ai/ag2/pull/1223
* [Docs] Fix docstring related mkdocs warnings by harishmohanraj in https://github.com/ag2ai/ag2/pull/1257
* Add user guide for GroupChat tool calling by rjambrecic in https://github.com/ag2ai/ag2/pull/1262
* fix: fix script execution check for direct run by annwag in https://github.com/ag2ai/ag2/pull/1261
* Mongodb query engine by AgentGenie in https://github.com/ag2ai/ag2/pull/1263
* fix function generate_api_references.py by futreall in https://github.com/ag2ai/ag2/pull/1239
* Fix formating issue by davorrunje in https://github.com/ag2ai/ag2/pull/1267
* Fix issubclass checking error in dependency_injection by davorrunje in https://github.com/ag2ai/ag2/pull/1266
* DocAgent: Internal task manager agent utilise OnContextConditions by marklysze in https://github.com/ag2ai/ag2/pull/1253
* chore: fix default value for `max_round` in `group_chat_config` section by hexcow in https://github.com/ag2ai/ag2/pull/1270
* fix issues by sky-coderay in https://github.com/ag2ai/ag2/pull/1272
* Fix failing type checks by kumaranvpl in https://github.com/ag2ai/ag2/pull/1279
* Docs Polishing by harishmohanraj in https://github.com/ag2ai/ag2/pull/1281
* [Docs] Add realtime tag in metadata by harishmohanraj in https://github.com/ag2ai/ag2/pull/1283
* Minor documentation updates by rjambrecic in https://github.com/ag2ai/ag2/pull/1294
* [Docs] Fix broken Mintlify CI workflow by harishmohanraj in https://github.com/ag2ai/ag2/pull/1297
* Upgrade google genai version by sternakt in https://github.com/ag2ai/ag2/pull/1298
* Documentation small fixes by sternakt in https://github.com/ag2ai/ag2/pull/1304
* Run captain agent tests with agent builder by kumaranvpl in https://github.com/ag2ai/ag2/pull/1303
* Update Swarm Enhanced Demo notebook by marklysze in https://github.com/ag2ai/ag2/pull/1309
* Fix swarm context variable function injection by marklysze in https://github.com/ag2ai/ag2/pull/1264
* Version bump to 0.8.1 by marklysze in https://github.com/ag2ai/ag2/pull/1308

**Full Changelog**: https://github.com/ag2ai/ag2/compare/v0.8.0...v0.8.1

:grey_exclamation: Breaking Change

The `openai` package is no longer installed by default.
- Install AG2 with the appropriate extra to use your preferred LLMs, e.g. `pip install ag2[openai]` for OpenAI or `pip install ag2[gemini]` for Google's Gemini.
- See our [Model Providers](https://docs.ag2.ai/docs/user-guide/models/openai) documentation for details on installing AG2 with different model providers.