Autogen

Headsup: in the next release we will change the default setting of `use_docker` in `code_execution_config` to True. It needs to be set to False or None explicitly to disable docker.

Highlights

- Support Python 3.12.
- Support function call style API in function decorator.
- Support AzureOpenAI when using azure endpoints.
- Add usage summary for agents.
- Improvement in docker usage and documentation.
- Bug fix for tool call, async, group chat.
- Improvement in AutoGen studio.
- Filter llm configurations by tag.

Thanks to ekzhu, maxim-saplin, kevin666aa, r3d91ll, Yanni8, yenif, davorrunje, shhdgit, ashutoshpw, afourney and all the other contributors!

What's Changed
* Update studio README.md with badges by gagb in https://github.com/microsoft/autogen/pull/1225
* Add documentation and raise exception when registering async reply function in sync chat by davorrunje in https://github.com/microsoft/autogen/pull/1208
* Upgrade docusaurus by olaoluwasalami in https://github.com/microsoft/autogen/pull/1101
* fix: forward kwargs to conversable agent + fix typing by joseferben in https://github.com/microsoft/autogen/pull/1193
* [Core] Sanitize filename before using it as docker image tag. Fix 1069 by ekzhu in https://github.com/microsoft/autogen/pull/1127
* [Core] Compatibility with function call style API (Azure OpenAI and Gemini) by ekzhu in https://github.com/microsoft/autogen/pull/1227
* Refined the user_proxy description. by afourney in https://github.com/microsoft/autogen/pull/951
* update default aoai version by sonichi in https://github.com/microsoft/autogen/pull/1229
* Fix bug in async group chat with func/tool call by sonichi in https://github.com/microsoft/autogen/pull/1243
* fix: Fixed typo from 'mont' to 'mount' by eaandersen in https://github.com/microsoft/autogen/pull/1250
* Improve test for function call in groupchat by sonichi in https://github.com/microsoft/autogen/pull/1252
* run sync and async in async by yenif in https://github.com/microsoft/autogen/pull/1242
* Added the ability to add tags to the OAI_CONFIG_LIST, and filter by afourney in https://github.com/microsoft/autogen/pull/1226
* Docker Documentation by r3d91ll in https://github.com/microsoft/autogen/pull/1251
* Replaced `asyncio.coroutines.iscoroutinefunction` with `inspect.iscoroutinefunction` by davorrunje in https://github.com/microsoft/autogen/pull/1267
* remove name from tool response by yenif in https://github.com/microsoft/autogen/pull/1263
* [Core] Update documentation for function call compatibility by ekzhu in https://github.com/microsoft/autogen/pull/1237
* add workdir in test by sonichi in https://github.com/microsoft/autogen/pull/1274
* remove filter_dict by sonichi in https://github.com/microsoft/autogen/pull/1284
* Add usage summary for agents by kevin666aa in https://github.com/microsoft/autogen/pull/1269
* [AutoGen Studio] Fix the new workflow process by shhdgit in https://github.com/microsoft/autogen/pull/1181
* Switched to AzureOpenAI for api_type=="azure" by maxim-saplin in https://github.com/microsoft/autogen/pull/1232
* removed alpine image by Yanni8 in https://github.com/microsoft/autogen/pull/1279
* Update README.md by olivMertens in https://github.com/microsoft/autogen/pull/1306
* Chore: Updated Blog and removed `cd frontend` by ashutoshpw in https://github.com/microsoft/autogen/pull/1301
* def _prepare_chat for groupchat manager to reset the groupchat by yenif in https://github.com/microsoft/autogen/pull/1254
* Fix website accessibility by cheng-tan in https://github.com/microsoft/autogen/pull/1153
* Support for Python 3.12 by ekzhu in https://github.com/microsoft/autogen/pull/1317

New Contributors
* joseferben made their first contribution in https://github.com/microsoft/autogen/pull/1193
* eaandersen made their first contribution in https://github.com/microsoft/autogen/pull/1250
* r3d91ll made their first contribution in https://github.com/microsoft/autogen/pull/1251
* shhdgit made their first contribution in https://github.com/microsoft/autogen/pull/1181
* Yanni8 made their first contribution in https://github.com/microsoft/autogen/pull/1279
* olivMertens made their first contribution in https://github.com/microsoft/autogen/pull/1306
* ashutoshpw made their first contribution in https://github.com/microsoft/autogen/pull/1301
* cheng-tan made their first contribution in https://github.com/microsoft/autogen/pull/1153

**Full Changelog**: https://github.com/microsoft/autogen/compare/v0.2.6...v0.2.7

This release fixes bugs in tool calls. It also adds support for streaming tool calls.

Thanks to yenif, davorrunje and other contributors!

What's Changed
* cleaner definition of tool_responses fixes 1174 by yenif in https://github.com/microsoft/autogen/pull/1182
* Documentation: polish docs for tools calls by davorrunje in https://github.com/microsoft/autogen/pull/1185
* check tool_returns by sonichi in https://github.com/microsoft/autogen/pull/1187
* Change `contrib-tests.yml` tests to use `--skip-openai` by maxim-saplin in https://github.com/microsoft/autogen/pull/1132
* remove inappropriate api_type by sonichi in https://github.com/microsoft/autogen/pull/1190
* Bump follow-redirects from 1.15.2 to 1.15.4 in /website by dependabot in https://github.com/microsoft/autogen/pull/1189
* Added support for streaming tool calls by davorrunje in https://github.com/microsoft/autogen/pull/1184
* More async tool fixes by yenif in https://github.com/microsoft/autogen/pull/1204
* Fix registration of async functions by davorrunje in https://github.com/microsoft/autogen/pull/1201


**Full Changelog**: https://github.com/microsoft/autogen/compare/v0.2.5...v0.2.6

This PR makes `contrib/capability` importable and adds support for streamed function calls. The documentation about [installation](https://microsoft.github.io/autogen/docs/Installation/) is improved.

Thanks to btcioner bitnom qingyun-wu yuandong-tian and all the other contributors!

What's Changed
* guide on the usage of docker by qingyun-wu in https://github.com/microsoft/autogen/pull/1111
* nbqa adedd to pre-commit, added black and ruff for notebooks by davorrunje in https://github.com/microsoft/autogen/pull/1171
* Handle streamed function calls by bitnom in https://github.com/microsoft/autogen/pull/1118
* add __init__.py for capabilities by btcioner in https://github.com/microsoft/autogen/pull/1177
* bump version to 0.2.5 by sonichi in https://github.com/microsoft/autogen/pull/1180

New Contributors
* bitnom made their first contribution in https://github.com/microsoft/autogen/pull/1118
* btcioner made their first contribution in https://github.com/microsoft/autogen/pull/1177

**Full Changelog**: https://github.com/microsoft/autogen/compare/v0.2.4...v0.2.5

Highlights

- **Breaking change**: Remove GPT-4 as the default model to avoid unexpected use of GPT-4. Require explicit setting the model when using LLM.
- Generalized **teachability** and **extensibility**: Allow any conversable agent to be teachable via a new and generic extensibility mechanism. Example: [Teach OpenAI Assistants Through GPTAssistantAgent](https://github.com/microsoft/autogen/blob/main/notebook/agentchat_teachable_oai_assistants.ipynb)
- New feature in **AutoBuild**: support building agents from an agent library and generating agent descriptions for group chat. [Example](https://github.com/microsoft/autogen/blob/main/notebook/autobuild_agent_library.ipynb).
- Initial support of OpenAI **tool calls** in conversable agents.

Thanks to rickyloynd-microsoft LinxinS97 yenif davorrunje afourney ekzhu and all the other contributors!

What's Changed
* [Core] check if docker is installed if user_docker is specified. by ekzhu in https://github.com/microsoft/autogen/pull/1145
* Let run tests directly via `python test_xyz.py`, fix for `conftest` import via `sys.path.append` by maxim-saplin in https://github.com/microsoft/autogen/pull/1144
* Remove GPT-4 as the default model. by afourney in https://github.com/microsoft/autogen/pull/1072
* [AutoBuild] Supporting build agents from library; supporting generating agent descriptions by LinxinS97 in https://github.com/microsoft/autogen/pull/1039
* [Core] [Tool Call] adjust conversable agent to support tool_calls by yenif in https://github.com/microsoft/autogen/pull/974
* bump version to 0.2.4 by sonichi in https://github.com/microsoft/autogen/pull/1160
* Add codespell to pre-commit hooks and fix spelling of existing files by davorrunje in https://github.com/microsoft/autogen/pull/1161
* contributor wall & news update by sonichi in https://github.com/microsoft/autogen/pull/1165
* Teachability for any agent by rickyloynd-microsoft in https://github.com/microsoft/autogen/pull/1091

New Contributors
* yenif made their first contribution in https://github.com/microsoft/autogen/pull/974

**Full Changelog**: https://github.com/microsoft/autogen/compare/v0.2.3...v0.2.4

Highlights

* Decorator for function calling makes function calls easier to define. [Doc](https://microsoft.github.io/autogen/docs/Use-Cases/agent_chat#function-calling)
* Address breaking changes introduced by new versions of openai.
* Introducing [AgentOptimizer](https://microsoft.github.io/autogen/blog/2023/12/23/AgentOptimizer): An Agentic Way to Train Your LLM Agent
* Improvement in group chat, multimodal, GPTAssistant, retrieval chat, AutoBuild, testbed, config list loading utils. [Blogpost](https://microsoft.github.io/autogen/blog/2023/12/29/AgentDescriptions) about agent descriptions.
* Guidance + AutoGen [example](https://github.com/microsoft/autogen/blob/main/notebook/agentchat_guidance.ipynb): constrained generation + multi-step reasoning
* The sample app AutoGen Assistant is renamed into AutoGen Studio with upgrades.
* Sample [notebook](https://github.com/microsoft/autogen/blob/main/notebook/agentchat_microsoft_fabric.ipynb) for using AutoGen in Microsoft Fabric.
* Sample [app](https://github.com/microsoft/autogen/blob/main/samples/simple_chat.py) of simple chat.
* Improvement in docs and tests.

Thanks to davorrunje skzhang1 JieyuZ2 afourney BeibinLi IANTHEREAL LinxinS97 cool-RR LeoLjl kevin666aa gagb victordibia dragosMC91 thinkall danyrouh olaoluwasalami yuandong-tian ShobhitVishnoi30 ekzhu maxim-saplin rlam3 bitsnaps and all the other contributors!

What's Changed
* Simple chat app by danyrouh in https://github.com/microsoft/autogen/pull/921
* Add privacy and cookies link to documentation website by victordibia in https://github.com/microsoft/autogen/pull/966
* Add collate file and more tests from autogpt into testbed by LeoLjl in https://github.com/microsoft/autogen/pull/915
* Allow users to specify the Docker image to use with Testbed by afourney in https://github.com/microsoft/autogen/pull/986
* fixed a typo fron -> from by kar2905 in https://github.com/microsoft/autogen/pull/992
* Website, update privacy link by victordibia in https://github.com/microsoft/autogen/pull/994
* [AutoBuild] address issue 941 954; add new feature; add debug information by LinxinS97 in https://github.com/microsoft/autogen/pull/944
* fix link that returns 404 by olaoluwasalami in https://github.com/microsoft/autogen/pull/945
* Updated get_max_token_limit with latest models and numbers by afourney in https://github.com/microsoft/autogen/pull/972
* Add missing assistant UI documentation steps by dragosMC91 in https://github.com/microsoft/autogen/pull/935
* correcting typo by halr9000 in https://github.com/microsoft/autogen/pull/931
* Update client.py by eltociear in https://github.com/microsoft/autogen/pull/934
* Enable allow_repeat_speaker to be a list of agents by afourney in https://github.com/microsoft/autogen/pull/905
* Add MATH tests to testbed by kevin666aa in https://github.com/microsoft/autogen/pull/914
* Fix exception cause in agent_builder.py by cool-RR in https://github.com/microsoft/autogen/pull/1007
* Update privacy link docusaurus.config.js by victordibia in https://github.com/microsoft/autogen/pull/1016
* Add async test by gagb in https://github.com/microsoft/autogen/pull/520
* Add examples constrained generation + multi-step reasoning via Guidance + AutoGen by gagb in https://github.com/microsoft/autogen/pull/937
* add links to sdk 910 by olaoluwasalami in https://github.com/microsoft/autogen/pull/958
* Change default model in LMM by BeibinLi in https://github.com/microsoft/autogen/pull/1032
* Fix/typo by KazooTTT in https://github.com/microsoft/autogen/pull/1034
* Update README to incorporate using existing docker image by yuandong-tian in https://github.com/microsoft/autogen/pull/1040
* Autobuild notebook minor fix by AdiG1123 in https://github.com/microsoft/autogen/pull/1049
* Update AutoGen Sample App | Rename AutoGen Assistant -> AutoGen Studio by victordibia in https://github.com/microsoft/autogen/pull/998
* Partial fix for 960 by afourney in https://github.com/microsoft/autogen/pull/963
* Add decorator for function calling by davorrunje in https://github.com/microsoft/autogen/pull/1018
* Add default value to the logprobs parameter by davorrunje in https://github.com/microsoft/autogen/pull/1044
* Fix exception causes all over the codebase 1007 by cool-RR in https://github.com/microsoft/autogen/pull/1014
* Add additional docs in retrieval agent if required by ShobhitVishnoi30 in https://github.com/microsoft/autogen/pull/1028
* Add poetry setup by rlam3 in https://github.com/microsoft/autogen/pull/824
* Fix mode dump with different pydantic version by kevin666aa in https://github.com/microsoft/autogen/pull/1063
* AgentOptimizer by skzhang1 in https://github.com/microsoft/autogen/pull/1053
* Filter out candidates with the same name but different instructions, … by IANTHEREAL in https://github.com/microsoft/autogen/pull/925
* [Core] Fix openai dependency error introduced when merging 1044 by ekzhu in https://github.com/microsoft/autogen/pull/1071
* fix: Fix typo by hugo-syn in https://github.com/microsoft/autogen/pull/1068
* [Docs/Contributing] Clarification on running non-OpenAI tests by maxim-saplin in https://github.com/microsoft/autogen/pull/1052
* Reuse docker image 929 by olaoluwasalami in https://github.com/microsoft/autogen/pull/956
* Agent description blog post by afourney in https://github.com/microsoft/autogen/pull/1092
* [Core] Extending inline docs for `openai_utils.py`, boosting coverage in `test_utils.py`, fixing 762 by maxim-saplin in https://github.com/microsoft/autogen/pull/1046
* [Dotnet] Add dotnet build workflow by LittleLittleCloud in https://github.com/microsoft/autogen/pull/946
* add example to website by olaoluwasalami in https://github.com/microsoft/autogen/pull/860
* `dev` alias for frontend `develop` for AutoGen Studio by brotsky in https://github.com/microsoft/autogen/pull/1083
* Update Ecosystem.md by bitsnaps in https://github.com/microsoft/autogen/pull/1104
* Fix function call use case in website 1107 by ekzhu in https://github.com/microsoft/autogen/pull/1108
* openai base url default to None; read files when env vars exist; remove deprecated models by sonichi in https://github.com/microsoft/autogen/pull/1110
* Skip tests that depend on OpenAI via `--skip-openai` by maxim-saplin in https://github.com/microsoft/autogen/pull/1097
* move dotnet pipeline to the root of workflow by LittleLittleCloud in https://github.com/microsoft/autogen/pull/1116
* [Core] Improve config_list_from_json by BeibinLi in https://github.com/microsoft/autogen/pull/1026
* Minor fix groupchat by kevin666aa in https://github.com/microsoft/autogen/pull/904
* [AutoGen Studio] Allow multiline strings in chat input by dragosMC91 in https://github.com/microsoft/autogen/pull/1105
* Update tutorial.ipynb by eltociear in https://github.com/microsoft/autogen/pull/1119
* Fix minor typo in blog post by PyroGenesis in https://github.com/microsoft/autogen/pull/1122
* [Core] Throw an error when the OAI_CONFIG_LIST is missing. by afourney in https://github.com/microsoft/autogen/pull/1082
* Chore: upgrade base image to the latest Debian (Bullseye -> Bookworm) by davorrunje in https://github.com/microsoft/autogen/pull/1133
* fix typo agent_chat.md by lordlinus in https://github.com/microsoft/autogen/pull/1131
* update global.json in dotnet-run-openai-test-and-notebook.yml by LittleLittleCloud in https://github.com/microsoft/autogen/pull/1135
* [Core] Fix update_usage_summary when response doesn't have usage attribute by kevin666aa in https://github.com/microsoft/autogen/pull/1008
* Add a sample notebook for using AutoGen in Microsoft Fabric by thinkall in https://github.com/microsoft/autogen/pull/940
* bump version to 0.2.3 by sonichi in https://github.com/microsoft/autogen/pull/1140

New Contributors
* danyrouh made their first contribution in https://github.com/microsoft/autogen/pull/921
* kar2905 made their first contribution in https://github.com/microsoft/autogen/pull/992
* dragosMC91 made their first contribution in https://github.com/microsoft/autogen/pull/935
* halr9000 made their first contribution in https://github.com/microsoft/autogen/pull/931
* cool-RR made their first contribution in https://github.com/microsoft/autogen/pull/1007
* KazooTTT made their first contribution in https://github.com/microsoft/autogen/pull/1034
* yuandong-tian made their first contribution in https://github.com/microsoft/autogen/pull/1040
* AdiG1123 made their first contribution in https://github.com/microsoft/autogen/pull/1049
* davorrunje made their first contribution in https://github.com/microsoft/autogen/pull/1018
* rlam3 made their first contribution in https://github.com/microsoft/autogen/pull/824
* ekzhu made their first contribution in https://github.com/microsoft/autogen/pull/1071
* hugo-syn made their first contribution in https://github.com/microsoft/autogen/pull/1068
* brotsky made their first contribution in https://github.com/microsoft/autogen/pull/1083
* bitsnaps made their first contribution in https://github.com/microsoft/autogen/pull/1104
* lordlinus made their first contribution in https://github.com/microsoft/autogen/pull/1131

**Full Changelog**: https://github.com/microsoft/autogen/compare/v0.2.2...v0.2.3

This release fixes a crucial breaking change introduced by for openai>=1.1.0 in dealing with function call. Please upgrade to this release if you are using 0.2.0 or 0.2.1.

Highlights

* New example [notebook](https://github.com/microsoft/autogen/blob/main/notebook/agentchat_video_transcript_translate_with_whisper.ipynb) demoing video transcript translate with whisper.
* A preliminary [gallery](https://microsoft.github.io/autogen/docs/Gallery) page on the website.
* Improvement to group chat: allow receiving message from agents that are not participants; allow a separate description field distinct from system message - expected to **greatly improve the speaker selection quality**; allow async group chat; disallow function/tool use for group chat manager.
* Improvement to agent builder: change default model and config loading process.
* Improvement to cost calculation when working with old cache.
* Issue template.

Special thanks to kevin666aa for the fast fix of the breaking change. Thanks to chengxuan233 skzhang1 afourney tyler-suard-parker kittyandrew LinxinS97 thinkall and all the other contributors!

What's Changed
* Update cache if cost not calculated by kevin666aa in https://github.com/microsoft/autogen/pull/903
* Add test for async group chat by tyler-suard-parker in https://github.com/microsoft/autogen/pull/902
* Adding a notebook demostrating video transcript translate with whisper in AutoGen by chengxuan233 in https://github.com/microsoft/autogen/pull/881
* Website Gallery page building by skzhang1 in https://github.com/microsoft/autogen/pull/850
* Allow GroupChat to receive messages from outside. by afourney in https://github.com/microsoft/autogen/pull/912
* Add issue forms by thinkall in https://github.com/microsoft/autogen/pull/918
* Add a comment to explain the role of UNSTRUCTURED_FORMATS by thinkall in https://github.com/microsoft/autogen/pull/909
* Change default model and config loading process in AgentBuilder by LinxinS97 in https://github.com/microsoft/autogen/pull/917
* Added an agent description field distinct from the system_message. by afourney in https://github.com/microsoft/autogen/pull/736
* Fix monitoring and observability gallery docs link by DMCS20 in https://github.com/microsoft/autogen/pull/926
* Make groupchat & generation async, actually by kittyandrew in https://github.com/microsoft/autogen/pull/543
* Enhanced Independent Coverage Reporting by IANTHEREAL in https://github.com/microsoft/autogen/pull/886
* Raise error when function as llm_config passed to GroupChatManager by kevin666aa in https://github.com/microsoft/autogen/pull/911
* bump version to 0.2.2 by sonichi in https://github.com/microsoft/autogen/pull/906
* Convert ChatCompletionMessage to Dict after completion by kevin666aa in https://github.com/microsoft/autogen/pull/791

New Contributors
* tyler-suard-parker made their first contribution in https://github.com/microsoft/autogen/pull/902
* chengxuan233 made their first contribution in https://github.com/microsoft/autogen/pull/881
* DMCS20 made their first contribution in https://github.com/microsoft/autogen/pull/926
* kittyandrew made their first contribution in https://github.com/microsoft/autogen/pull/543

**Full Changelog**: https://github.com/microsoft/autogen/compare/v0.2.1...v0.2.2