Autogen

This release is the first update since v0.2.0.

Headsup: the sample app AutoGen Assistant will be renamed as AutoGen Studio in future.

Highlights
* An initial version of [AutoBuild](https://microsoft.github.io/autogen/blog/2023/11/26/Agent-AutoBuild) for automatically building multi-agent systems.
* v0.1 features that are added back to the new client-based inference: teachable agent, cost calculation and summary, raise content filter error.
* Function Inception: Enable AutoGen agents to update/remove functions during conversations. - [View Notebook](https://github.com/microsoft/autogen/blob/main/notebook/agentchat_inception_function.ipynb)
* Improvement to group chat: termination,
* Improvement to teachable agent: progress bar for learning.
* Improvement to retrieve chat: more informative warning.
* Improvement to gpt assistant agent: verbose flag for allowing more output to be printed.
* Improvement to testbed: utilize OPENAI_API_KEY; adding GAIA benchmark.
* Improvement to multimodal: generalize the data structure to incorporate gpt-4v message format.
* Improvement to the sample app (will be renamed as AutoGen Studio in future).
* Allow async human input.
* Temporary fix to the breaking change introduced by openai 1.3: limit openai dependency to <1.3.
* Improvement in test, documentation and website: Examples are moved to a standalone [tab](https://microsoft.github.io/autogen/docs/Examples) and a new tab [Ecosystem](https://microsoft.github.io/autogen/docs/Ecosystem) is added.

Thanks to LinxinS97 JieyuZ2 rickyloynd-microsoft kevin666aa elecnix afourney thinkall IANTHEREAL BeibinLi ShobhitVishnoi30 olaoluwasalami hodgesmr skzhang1 cpacker victordibia joshkyh PyroGenesis axa99 momuno and all the other contributors!

What's Changed
* Restore TeachableAgent tests by rickyloynd-microsoft in https://github.com/microsoft/autogen/pull/761
* Add links to newly added notebooks in the website 756 by olaoluwasalami in https://github.com/microsoft/autogen/pull/772
* how to register a rely function Issue-478 by olaoluwasalami in https://github.com/microsoft/autogen/pull/579
* Remove version condition to fix issue 775 by thinkall in https://github.com/microsoft/autogen/pull/777
* Update application figure by qingyun-wu in https://github.com/microsoft/autogen/pull/352
* add cost calculation to client by kevin666aa in https://github.com/microsoft/autogen/pull/769
* Progress bar for learn_from_user_feedback by rickyloynd-microsoft in https://github.com/microsoft/autogen/pull/776
* Quick fix for 765 by afourney in https://github.com/microsoft/autogen/pull/809
* Improve docstring of query_texts and search_string by thinkall in https://github.com/microsoft/autogen/pull/795
* GroupChat handle is_termination_msg by afourney in https://github.com/microsoft/autogen/pull/804
* Fix Langchain link in examples doc by hodgesmr in https://github.com/microsoft/autogen/pull/811
* Add a warning message if docs_path not explicitly set by thinkall in https://github.com/microsoft/autogen/pull/814
* Testbed folders by afourney in https://github.com/microsoft/autogen/pull/792
* Add ecosystem page for website by skzhang1 in https://github.com/microsoft/autogen/pull/803
* update about pyautogen 0.2 by sonichi in https://github.com/microsoft/autogen/pull/826
* Update Ecosystem.md (MemGPT + AutoGen integration) by cpacker in https://github.com/microsoft/autogen/pull/838
* Improvements to AutoGen Assistant by victordibia in https://github.com/microsoft/autogen/pull/828
* Enable defining new functions after agent creation by elecnix in https://github.com/microsoft/autogen/pull/285
* Add a Blog Post on the AutoGen Assistant by victordibia in https://github.com/microsoft/autogen/pull/834
* update the news for v0.2 release by sonichi in https://github.com/microsoft/autogen/pull/844
* fix citations by qingyun-wu in https://github.com/microsoft/autogen/pull/843
* improve ecosystem page by qingyun-wu in https://github.com/microsoft/autogen/pull/823
* Message "content" now supports both `str` and `List` in Agents by BeibinLi in https://github.com/microsoft/autogen/pull/713
* Register async human input handler by ShobhitVishnoi30 in https://github.com/microsoft/autogen/pull/794
* Add cost summary to client.py by kevin666aa in https://github.com/microsoft/autogen/pull/812
* Add examples by qingyun-wu in https://github.com/microsoft/autogen/pull/851
* Testing AutoBuild by LinxinS97 in https://github.com/microsoft/autogen/pull/846
* Fix blog title display error by LinxinS97 in https://github.com/microsoft/autogen/pull/855
* Minor grammar and wording issues by qingyun-wu in https://github.com/microsoft/autogen/pull/854
* AutoBuild blog refinement by LinxinS97 in https://github.com/microsoft/autogen/pull/856
* add a verbose flag to let gpt assistant print more log by IANTHEREAL in https://github.com/microsoft/autogen/pull/717
* Testbed can now read the OPENAI_API_KEY in addition to OAI_CONFIG_LIST by afourney in https://github.com/microsoft/autogen/pull/848
* fix 0.2 release tag link by PyroGenesis in https://github.com/microsoft/autogen/pull/872
* Clarifies the phrasing in notebook agent_hierarchy_flow_using_select_speaker by joshkyh in https://github.com/microsoft/autogen/pull/876
* Add details to AutoBuild's blog and fix test error. This PR is related to 846 by LinxinS97 in https://github.com/microsoft/autogen/pull/865
* corrected openai utils example by axa99 in https://github.com/microsoft/autogen/pull/869
* bump version to 0.2.1 by sonichi in https://github.com/microsoft/autogen/pull/867
* Adds the GAIA benchark to the Testbed. This PR depends on 792 by afourney in https://github.com/microsoft/autogen/pull/810
* Update position of registered custom generate_reply functions for contrib/ agents per PR 794 by momuno in https://github.com/microsoft/autogen/pull/871
* raise error for content_filter by sonichi in https://github.com/microsoft/autogen/pull/849

New Contributors
* hodgesmr made their first contribution in https://github.com/microsoft/autogen/pull/811
* cpacker made their first contribution in https://github.com/microsoft/autogen/pull/838
* elecnix made their first contribution in https://github.com/microsoft/autogen/pull/285
* ShobhitVishnoi30 made their first contribution in https://github.com/microsoft/autogen/pull/794
* LinxinS97 made their first contribution in https://github.com/microsoft/autogen/pull/846
* PyroGenesis made their first contribution in https://github.com/microsoft/autogen/pull/872
* axa99 made their first contribution in https://github.com/microsoft/autogen/pull/869
* momuno made their first contribution in https://github.com/microsoft/autogen/pull/871

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

This is a major release since v0.1.1, containing 13 minor releases (from v0.1.1 to v0.1.14) and 6 pre-releases (v0.2.0b1 to v0.2.0b6).

Highlights
* Support files in GPTAssistants. Notebook: https://github.com/microsoft/autogen/blob/main/notebook/agentchat_oai_assistant_retrieval.ipynb
* Richer choice of speaker selector and robustness improvement in GroupChat.
* Support custom text formats and recursive in RAG.
* Fix bugs in caching and filter checking.
* Robustness improvement in code block extraction.
* Sample web application: https://github.com/microsoft/autogen/tree/main/samples/apps/autogen-assistant.
* Adding first version of AgentEval -- a framework for assessing task utility for LLM-powered applications. Blogpost: https://microsoft.github.io/autogen/blog/2023/11/20/AgentEval.

Thanks to IANTHEREAL thinkall afourney gagb victordibia julianakiseleva Narabzad DearVa and all the other contributors!

What's Changed
* Fix typos in my affiliation by gagb in https://github.com/microsoft/autogen/pull/667
* Update index.mdx with version number by gagb in https://github.com/microsoft/autogen/pull/670
* Issue-560 by olaoluwasalami in https://github.com/microsoft/autogen/pull/578
* Sets the umask before executing the task in Docker. by afourney in https://github.com/microsoft/autogen/pull/593
* Allows users to specify a different requirements.txt file to install … by afourney in https://github.com/microsoft/autogen/pull/671
* Addresses issue 635, relating to newlines in Windows. by afourney in https://github.com/microsoft/autogen/pull/678
* Added an 'auto' mode to last_n_messages by afourney in https://github.com/microsoft/autogen/pull/693
* fix assistant creating without file by IANTHEREAL in https://github.com/microsoft/autogen/pull/689
* Fix typos in website blog by Hao-tian-Zheng in https://github.com/microsoft/autogen/pull/696
* Add RAG gptassistant example notebook by gagb in https://github.com/microsoft/autogen/pull/694
* Fix some type annotations and edge cases by s-cerevisiae in https://github.com/microsoft/autogen/pull/572
* Makes select_speaker more robust by checking for mentions anywhere. by afourney in https://github.com/microsoft/autogen/pull/669
* update side bar by skzhang1 in https://github.com/microsoft/autogen/pull/702
* Update speaker selector in GroupChat and update some notebooks by thinkall in https://github.com/microsoft/autogen/pull/688
* Update FAQ.md with api_base vs base_url question by gagb in https://github.com/microsoft/autogen/pull/672
* Re-added completion logging when using older versions of Autogen. by afourney in https://github.com/microsoft/autogen/pull/701
* add relevant dependency to the oai test workflow by qingyun-wu in https://github.com/microsoft/autogen/pull/712
* bump version to 0.2.0b6 by sonichi in https://github.com/microsoft/autogen/pull/710
* fix typos in function helper text by shresthasurav in https://github.com/microsoft/autogen/pull/503
* Sample Web Application Built with AutoGen by victordibia in https://github.com/microsoft/autogen/pull/695
* Fixes cache issue from 703 and 679 by afourney in https://github.com/microsoft/autogen/pull/707
* Support custom text formats and recursive by thinkall in https://github.com/microsoft/autogen/pull/496
* Adding first version of AgentEval -- a framework for assessing task utility for LLM-powered applications by julianakiseleva in https://github.com/microsoft/autogen/pull/681
* improve CODE_BLOCK_PATTERN for a more robust code match by DearVa in https://github.com/microsoft/autogen/pull/571

New Contributors
* Hao-tian-Zheng made their first contribution in https://github.com/microsoft/autogen/pull/696
* s-cerevisiae made their first contribution in https://github.com/microsoft/autogen/pull/572
* skzhang1 made their first contribution in https://github.com/microsoft/autogen/pull/702
* shresthasurav made their first contribution in https://github.com/microsoft/autogen/pull/503
* julianakiseleva made their first contribution in https://github.com/microsoft/autogen/pull/681
* DearVa made their first contribution in https://github.com/microsoft/autogen/pull/571

**Full Changelog**: https://github.com/microsoft/autogen/compare/0.2.0b5...v0.2.0b6

Highlights
:fire: Experimental [GPTAssistantAgent]( https://github.com/microsoft/autogen/blob/main/autogen/agentchat/contrib/gpt_assistant_agent.py), which leverages the OpenAI Assistant API for conversational capabilities in AutoGen. This agent is unique in its reliance on the OpenAI Assistant API for state management, differing from other agents using the Completion API.
- Blogpost: https://microsoft.github.io/autogen/blog/2023/11/13/OAI-assistants/
- Notebook 1: GPTAssistantAgent in a hello-world example: https://github.com/microsoft/autogen/blob/main/notebook/agentchat_oai_assistant_twoagents_basic.ipynb
- Notebook 2: GPTAssistantAgent using function call: https://github.com/microsoft/autogen/blob/main/notebook/agentchat_oai_assistant_function_call.ipynb
- Notebook 3: GPTAssistantAgent with code interpreter: https://github.com/microsoft/autogen/blob/main/notebook/agentchat_oai_code_interpreter.ipynb
- Notebook 4: GPTAssistantAgent in a group chat: https://github.com/microsoft/autogen/blob/main/notebook/agentchat_oai_assistant_groupchat.ipynb

:fire: Blogpost for [EcoAssistant](https://microsoft.github.io/autogen/blog/2023/11/09/EcoAssistant), which is designed to solve user queries more accurately and affordably using assistant hierarchy and solution demonstration.

Thanks to IANTHEREAL gagb LeoLjl kevin666aa qingyun-wu sonichi JieyuZ2 and all the other contributors!

What's Changed
* Fix docstring of get_or_create by thinkall in https://github.com/microsoft/autogen/pull/583
* Refactor GPTAssistantAgent by gagb in https://github.com/microsoft/autogen/pull/632
* uncomment test_hierarchy_flow_using_select_speaker by qingyun-wu in https://github.com/microsoft/autogen/pull/640
* Add basic notebook for gptassistant by gagb in https://github.com/microsoft/autogen/pull/636
* Openai assistant function usage notebook by IANTHEREAL in https://github.com/microsoft/autogen/pull/639
* bump version by sonichi in https://github.com/microsoft/autogen/pull/645
* add EcoAssistant blog by JieyuZ2 in https://github.com/microsoft/autogen/pull/647
* Add code interpreter for GptAssistant Notebook. by LeoLjl in https://github.com/microsoft/autogen/pull/644
* Add openai_client as property and update notebook. by LeoLjl in https://github.com/microsoft/autogen/pull/654
* fix tag in EcoAssistant blog by JieyuZ2 in https://github.com/microsoft/autogen/pull/657
* Add agentchat_oai_assistant_groupchat.ipynb by LeoLjl in https://github.com/microsoft/autogen/pull/656
* Add blog post for open ai assistants by gagb in https://github.com/microsoft/autogen/pull/638
* add doc about openai assistants by qingyun-wu in https://github.com/microsoft/autogen/pull/659

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

**Full Changelog**: https://github.com/microsoft/autogen/compare/v0.2.0b4...0.2.0b5

Highlights

* **CompressibleAgent** (experimental) can be used to handle long conversations. Notebook: https://github.com/microsoft/autogen/blob/main/notebook/agentchat_compression.ipynb
* Introducing Experimental **GPT Assistant Agent**: https://github.com/microsoft/autogen/blob/main/autogen/agentchat/contrib/gpt_assistant_agent.py. More improvements are under way.
* Experimental **streaming** support is added.
* `seed` is renamed to `cache_seed` to be compatible with openai's `seed` parameter in chat completion. Migration guide is updated: https://microsoft.github.io/autogen/docs/Installation/#migration-guide-to-v02
* Better warnings and error handling for group chat.

Thanks to IANTHEREAL kevin666aa Alvaromah and all the other contributors!

What's Changed
* seed -> cache_seed by sonichi in https://github.com/microsoft/autogen/pull/600
* Added link to the new notebook by joshkyh in https://github.com/microsoft/autogen/pull/594
* update return type of WolframAlphaAPIWrapper.run() by 1073710317 in https://github.com/microsoft/autogen/pull/523
* news update by sonichi in https://github.com/microsoft/autogen/pull/609
* Add EcoAssistant to the research page by JieyuZ2 in https://github.com/microsoft/autogen/pull/612
* Add CompressibleAgent by kevin666aa in https://github.com/microsoft/autogen/pull/443
* add AutoGen paper info at the beginning of readme by qingyun-wu in https://github.com/microsoft/autogen/pull/621
* Update oai_completion.ipynb by AndreasVolkmann in https://github.com/microsoft/autogen/pull/623
* Added warnings for some GroupChat misconfigurations and selection errors by afourney in https://github.com/microsoft/autogen/pull/603
* Introducing Experimental GPT Assistant Agent in AutoGen by IANTHEREAL in https://github.com/microsoft/autogen/pull/616
* added twitter(X) banner + link to readme by malikmmoaz in https://github.com/microsoft/autogen/pull/615
* Enable streaming support for openai v1 by Alvaromah in https://github.com/microsoft/autogen/pull/597
* improve readme by qingyun-wu in https://github.com/microsoft/autogen/pull/630
* Handled possible unclear IndexError in ConversableAgent.last_message method by jeezrick in https://github.com/microsoft/autogen/pull/622
* Fix test error of compressible agent by kevin666aa in https://github.com/microsoft/autogen/pull/631

New Contributors
* 1073710317 made their first contribution in https://github.com/microsoft/autogen/pull/523
* JieyuZ2 made their first contribution in https://github.com/microsoft/autogen/pull/612
* AndreasVolkmann made their first contribution in https://github.com/microsoft/autogen/pull/623
* IANTHEREAL made their first contribution in https://github.com/microsoft/autogen/pull/616
* malikmmoaz made their first contribution in https://github.com/microsoft/autogen/pull/615
* Alvaromah made their first contribution in https://github.com/microsoft/autogen/pull/597
* jeezrick made their first contribution in https://github.com/microsoft/autogen/pull/622

**Full Changelog**: https://github.com/microsoft/autogen/compare/v0.2.0b3...v0.2.0b4

A quick release to switch to openai-python v1.1.1.
Thanks to joshkyh for a new group chat notebook example with hierarchical flow: https://github.com/microsoft/autogen/blob/main/notebook/agentchat_hierarchy_flow_using_select_speaker.ipynb

What's Changed
* update version of openai dependency by sonichi in https://github.com/microsoft/autogen/pull/588
* Notebook/hierarchy flow by joshkyh in https://github.com/microsoft/autogen/pull/482

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

**Full Changelog**: https://github.com/microsoft/autogen/compare/v0.2.0b2...v0.2.0b3