ag2 0.9.9__py3-none-any.whl → 0.9.10__py3-none-any.whl

{ag2-0.9.9.dist-info → ag2-0.9.10.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ag2
-Version: 0.9.9
+Version: 0.9.10
 Summary: A programming framework for agentic AI
 Project-URL: Homepage, https://ag2.ai/
 Project-URL: Documentation, https://docs.ag2.ai
@@ -30,7 +30,6 @@ Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Requires-Python: <3.14,>=3.10
 Requires-Dist: anyio<5.0.0,>=3.0.0
-Requires-Dist: asyncer==0.0.8
 Requires-Dist: diskcache
 Requires-Dist: docker
 Requires-Dist: httpx<1,>=0.28.1
@@ -61,7 +60,7 @@ Requires-Dist: cerebras-cloud-sdk>=1.0.0; extra == 'cerebras'
 Provides-Extra: cohere
 Requires-Dist: cohere>=5.13.5; extra == 'cohere'
 Provides-Extra: commsagent-discord
-Requires-Dist: discord-py<2.6,>=2.4.0; extra == 'commsagent-discord'
+Requires-Dist: discord-py<2.7,>=2.4.0; extra == 'commsagent-discord'
 Provides-Extra: commsagent-slack
 Requires-Dist: slack-sdk<3.40,>=3.33.0; extra == 'commsagent-slack'
 Provides-Extra: commsagent-telegram
@@ -84,10 +83,10 @@ Requires-Dist: mcp>=1.11.0; extra == 'dev'
 Requires-Dist: mdx-include==1.4.2; extra == 'dev'
 Requires-Dist: mike==2.1.3; extra == 'dev'
 Requires-Dist: mkdocs-git-revision-date-localized-plugin==1.4.7; extra == 'dev'
-Requires-Dist: mkdocs-glightbox==0.4.0; extra == 'dev'
+Requires-Dist: mkdocs-glightbox==0.5.1; extra == 'dev'
 Requires-Dist: mkdocs-literate-nav==0.6.2; extra == 'dev'
-Requires-Dist: mkdocs-macros-plugin==1.3.7; extra == 'dev'
-Requires-Dist: mkdocs-material==9.6.16; extra == 'dev'
+Requires-Dist: mkdocs-macros-plugin==1.3.9; extra == 'dev'
+Requires-Dist: mkdocs-material==9.6.19; extra == 'dev'
 Requires-Dist: mkdocs-minify-plugin==0.8.0; extra == 'dev'
 Requires-Dist: mkdocs-redirects==1.2.2; extra == 'dev'
 Requires-Dist: mkdocstrings[python]==0.30.0; extra == 'dev'
@@ -97,26 +96,26 @@ Requires-Dist: nbclient==0.10.2; extra == 'dev'
 Requires-Dist: nbconvert==7.16.6; extra == 'dev'
 Requires-Dist: nbformat==5.10.4; extra == 'dev'
 Requires-Dist: openai>=1.99.3; extra == 'dev'
-Requires-Dist: pandas==2.3.1; extra == 'dev'
+Requires-Dist: pandas==2.3.2; extra == 'dev'
 Requires-Dist: pdoc3==0.11.6; extra == 'dev'
 Requires-Dist: pillow; extra == 'dev'
 Requires-Dist: pre-commit==4.3.0; extra == 'dev'
 Requires-Dist: pytest-asyncio==1.1.0; extra == 'dev'
-Requires-Dist: pytest-cov==6.2.1; extra == 'dev'
-Requires-Dist: pytest==8.4.1; extra == 'dev'
+Requires-Dist: pytest-cov==6.3.0; extra == 'dev'
+Requires-Dist: pytest==8.4.2; extra == 'dev'
 Requires-Dist: pyupgrade-directories==0.3.0; extra == 'dev'
 Requires-Dist: pyyaml==6.0.2; extra == 'dev'
-Requires-Dist: ruff==0.12.8; extra == 'dev'
+Requires-Dist: ruff==0.12.12; extra == 'dev'
 Requires-Dist: termcolor==3.1.0; extra == 'dev'
 Requires-Dist: toml==0.10.2; extra == 'dev'
-Requires-Dist: typer==0.16.0; extra == 'dev'
+Requires-Dist: typer==0.17.4; extra == 'dev'
 Requires-Dist: types-decorator; extra == 'dev'
 Requires-Dist: types-pycurl; extra == 'dev'
 Requires-Dist: types-python-dateutil; extra == 'dev'
 Requires-Dist: types-pyyaml; extra == 'dev'
 Requires-Dist: types-requests; extra == 'dev'
 Requires-Dist: types-ujson; extra == 'dev'
-Requires-Dist: uv==0.8.8; extra == 'dev'
+Requires-Dist: uv==0.8.15; extra == 'dev'
 Provides-Extra: docs
 Requires-Dist: cairosvg; extra == 'docs'
 Requires-Dist: jinja2==3.1.6; extra == 'docs'
@@ -124,10 +123,10 @@ Requires-Dist: mcp>=1.11.0; extra == 'docs'
 Requires-Dist: mdx-include==1.4.2; extra == 'docs'
 Requires-Dist: mike==2.1.3; extra == 'docs'
 Requires-Dist: mkdocs-git-revision-date-localized-plugin==1.4.7; extra == 'docs'
-Requires-Dist: mkdocs-glightbox==0.4.0; extra == 'docs'
+Requires-Dist: mkdocs-glightbox==0.5.1; extra == 'docs'
 Requires-Dist: mkdocs-literate-nav==0.6.2; extra == 'docs'
-Requires-Dist: mkdocs-macros-plugin==1.3.7; extra == 'docs'
-Requires-Dist: mkdocs-material==9.6.16; extra == 'docs'
+Requires-Dist: mkdocs-macros-plugin==1.3.9; extra == 'docs'
+Requires-Dist: mkdocs-material==9.6.19; extra == 'docs'
 Requires-Dist: mkdocs-minify-plugin==0.8.0; extra == 'docs'
 Requires-Dist: mkdocs-redirects==1.2.2; extra == 'docs'
 Requires-Dist: mkdocstrings[python]==0.30.0; extra == 'docs'
@@ -136,7 +135,7 @@ Requires-Dist: pdoc3==0.11.6; extra == 'docs'
 Requires-Dist: pillow; extra == 'docs'
 Requires-Dist: pyyaml==6.0.2; extra == 'docs'
 Requires-Dist: termcolor==3.1.0; extra == 'docs'
-Requires-Dist: typer==0.16.0; extra == 'docs'
+Requires-Dist: typer==0.17.4; extra == 'docs'
 Provides-Extra: duckduckgo
 Requires-Dist: duckduckgo-search>=8.0.2; extra == 'duckduckgo'
 Provides-Extra: flaml
@@ -171,23 +170,23 @@ Requires-Dist: matplotlib; extra == 'graph'
 Requires-Dist: networkx; extra == 'graph'
 Provides-Extra: graph-rag-falkor-db
 Requires-Dist: falkordb>=1.0.10; extra == 'graph-rag-falkor-db'
-Requires-Dist: graphrag-sdk==0.7.1; extra == 'graph-rag-falkor-db'
+Requires-Dist: graphrag-sdk==0.8.0; extra == 'graph-rag-falkor-db'
 Provides-Extra: groq
 Requires-Dist: groq>=0.9.0; extra == 'groq'
 Provides-Extra: interop
 Requires-Dist: crewai[tools]<1,>=0.76; (python_version >= '3.10' and python_version < '3.13') and extra == 'interop'
 Requires-Dist: langchain-community<1,>=0.3.12; extra == 'interop'
-Requires-Dist: litellm<=1.75.5.post1; extra == 'interop'
-Requires-Dist: pydantic-ai==0.6.2; extra == 'interop'
+Requires-Dist: litellm<=1.76.3; extra == 'interop'
+Requires-Dist: pydantic-ai==1.0.1; extra == 'interop'
 Requires-Dist: weaviate-client<5,>=4; (python_version >= '3.10' and python_version < '3.13') and extra == 'interop'
 Provides-Extra: interop-crewai
 Requires-Dist: crewai[tools]<1,>=0.76; (python_version >= '3.10' and python_version < '3.13') and extra == 'interop-crewai'
-Requires-Dist: litellm<=1.75.5.post1; extra == 'interop-crewai'
+Requires-Dist: litellm<=1.76.3; extra == 'interop-crewai'
 Requires-Dist: weaviate-client<5,>=4; (python_version >= '3.10' and python_version < '3.13') and extra == 'interop-crewai'
 Provides-Extra: interop-langchain
 Requires-Dist: langchain-community<1,>=0.3.12; extra == 'interop-langchain'
 Provides-Extra: interop-pydantic-ai
-Requires-Dist: pydantic-ai==0.6.2; extra == 'interop-pydantic-ai'
+Requires-Dist: pydantic-ai==1.0.1; extra == 'interop-pydantic-ai'
 Provides-Extra: jupyter-executor
 Requires-Dist: ipykernel>=6.29.0; extra == 'jupyter-executor'
 Requires-Dist: jupyter-client>=8.6.0; extra == 'jupyter-executor'
@@ -197,7 +196,7 @@ Requires-Dist: websocket-client; extra == 'jupyter-executor'
 Provides-Extra: lint
 Requires-Dist: codespell==2.4.1; extra == 'lint'
 Requires-Dist: pyupgrade-directories==0.3.0; extra == 'lint'
-Requires-Dist: ruff==0.12.8; extra == 'lint'
+Requires-Dist: ruff==0.12.12; extra == 'lint'
 Provides-Extra: lmm
 Requires-Dist: pillow; extra == 'lmm'
 Requires-Dist: replicate; extra == 'lmm'
@@ -218,9 +217,10 @@ Provides-Extra: mistral
 Requires-Dist: mistralai>=1.0.1; extra == 'mistral'
 Provides-Extra: neo4j
 Requires-Dist: docx2txt==0.9; extra == 'neo4j'
-Requires-Dist: llama-index-graph-stores-neo4j==0.5.0; extra == 'neo4j'
-Requires-Dist: llama-index-readers-web==0.5.0; extra == 'neo4j'
-Requires-Dist: llama-index<1,>=0.12; extra == 'neo4j'
+Requires-Dist: llama-index-core<0.14,>=0.12; extra == 'neo4j'
+Requires-Dist: llama-index-graph-stores-neo4j<0.6,>=0.4; extra == 'neo4j'
+Requires-Dist: llama-index-readers-web<0.6,>=0.4; extra == 'neo4j'
+Requires-Dist: llama-index<0.14,>=0.12; extra == 'neo4j'
 Provides-Extra: ollama
 Requires-Dist: fix-busted-json>=0.0.18; extra == 'ollama'
 Requires-Dist: ollama>=0.4.7; extra == 'ollama'
@@ -232,11 +232,14 @@ Requires-Dist: openai[realtime]; extra == 'openai-realtime'
 Provides-Extra: rag
 Requires-Dist: chromadb<2,>=0.5; extra == 'rag'
 Requires-Dist: docling<3,>=2.15.1; extra == 'rag'
-Requires-Dist: llama-index-embeddings-huggingface==0.6.0; extra == 'rag'
-Requires-Dist: llama-index-llms-langchain==0.7.0; extra == 'rag'
-Requires-Dist: llama-index-vector-stores-chroma==0.4.1; extra == 'rag'
-Requires-Dist: llama-index-vector-stores-mongodb==0.8.0; extra == 'rag'
-Requires-Dist: llama-index<1,>=0.12; extra == 'rag'
+Requires-Dist: llama-index-core<0.14,>=0.12; extra == 'rag'
+Requires-Dist: llama-index-embeddings-huggingface<0.7,>=0.5; extra == 'rag'
+Requires-Dist: llama-index-embeddings-openai<0.6,>=0.3; extra == 'rag'
+Requires-Dist: llama-index-llms-langchain<0.8,>=0.6; extra == 'rag'
+Requires-Dist: llama-index-llms-openai<0.6,>=0.4; extra == 'rag'
+Requires-Dist: llama-index-vector-stores-chroma<0.6,>=0.4; extra == 'rag'
+Requires-Dist: llama-index-vector-stores-mongodb<0.9,>=0.6; extra == 'rag'
+Requires-Dist: llama-index<0.14,>=0.12; extra == 'rag'
 Requires-Dist: requests<3,>=2.32.3; extra == 'rag'
 Requires-Dist: selenium<5,>=4.28.1; extra == 'rag'
 Requires-Dist: webdriver-manager==4.0.2; extra == 'rag'
@@ -244,50 +247,50 @@ Provides-Extra: redis
 Requires-Dist: redis; extra == 'redis'
 Provides-Extra: retrievechat
 Requires-Dist: beautifulsoup4; extra == 'retrievechat'
-Requires-Dist: chromadb==1.0.16; extra == 'retrievechat'
+Requires-Dist: chromadb==1.0.20; extra == 'retrievechat'
 Requires-Dist: ipython; extra == 'retrievechat'
 Requires-Dist: markdownify; extra == 'retrievechat'
-Requires-Dist: protobuf==6.31.1; extra == 'retrievechat'
+Requires-Dist: protobuf==6.32.0; extra == 'retrievechat'
 Requires-Dist: pypdf; extra == 'retrievechat'
 Requires-Dist: sentence-transformers<=5.1.0; extra == 'retrievechat'
 Provides-Extra: retrievechat-couchbase
 Requires-Dist: beautifulsoup4; extra == 'retrievechat-couchbase'
-Requires-Dist: chromadb==1.0.16; extra == 'retrievechat-couchbase'
+Requires-Dist: chromadb==1.0.20; extra == 'retrievechat-couchbase'
 Requires-Dist: couchbase>=4.3.0; extra == 'retrievechat-couchbase'
 Requires-Dist: ipython; extra == 'retrievechat-couchbase'
 Requires-Dist: markdownify; extra == 'retrievechat-couchbase'
 Requires-Dist: numpy; extra == 'retrievechat-couchbase'
-Requires-Dist: protobuf==6.31.1; extra == 'retrievechat-couchbase'
+Requires-Dist: protobuf==6.32.0; extra == 'retrievechat-couchbase'
 Requires-Dist: pypdf; extra == 'retrievechat-couchbase'
 Requires-Dist: sentence-transformers<=5.1.0; extra == 'retrievechat-couchbase'
 Provides-Extra: retrievechat-mongodb
 Requires-Dist: beautifulsoup4; extra == 'retrievechat-mongodb'
-Requires-Dist: chromadb==1.0.16; extra == 'retrievechat-mongodb'
+Requires-Dist: chromadb==1.0.20; extra == 'retrievechat-mongodb'
 Requires-Dist: ipython; extra == 'retrievechat-mongodb'
 Requires-Dist: markdownify; extra == 'retrievechat-mongodb'
 Requires-Dist: numpy; extra == 'retrievechat-mongodb'
-Requires-Dist: protobuf==6.31.1; extra == 'retrievechat-mongodb'
+Requires-Dist: protobuf==6.32.0; extra == 'retrievechat-mongodb'
 Requires-Dist: pymongo>=4.0.0; extra == 'retrievechat-mongodb'
 Requires-Dist: pypdf; extra == 'retrievechat-mongodb'
 Requires-Dist: sentence-transformers<=5.1.0; extra == 'retrievechat-mongodb'
 Provides-Extra: retrievechat-pgvector
 Requires-Dist: beautifulsoup4; extra == 'retrievechat-pgvector'
-Requires-Dist: chromadb==1.0.16; extra == 'retrievechat-pgvector'
+Requires-Dist: chromadb==1.0.20; extra == 'retrievechat-pgvector'
 Requires-Dist: ipython; extra == 'retrievechat-pgvector'
 Requires-Dist: markdownify; extra == 'retrievechat-pgvector'
 Requires-Dist: pgvector>=0.2.5; extra == 'retrievechat-pgvector'
-Requires-Dist: protobuf==6.31.1; extra == 'retrievechat-pgvector'
+Requires-Dist: protobuf==6.32.0; extra == 'retrievechat-pgvector'
 Requires-Dist: psycopg>=3.1.18; (platform_system == 'Linux') and extra == 'retrievechat-pgvector'
 Requires-Dist: psycopg[binary]>=3.1.18; (platform_system == 'Windows' or platform_system == 'Darwin') and extra == 'retrievechat-pgvector'
 Requires-Dist: pypdf; extra == 'retrievechat-pgvector'
 Requires-Dist: sentence-transformers<=5.1.0; extra == 'retrievechat-pgvector'
 Provides-Extra: retrievechat-qdrant
 Requires-Dist: beautifulsoup4; extra == 'retrievechat-qdrant'
-Requires-Dist: chromadb==1.0.16; extra == 'retrievechat-qdrant'
+Requires-Dist: chromadb==1.0.20; extra == 'retrievechat-qdrant'
 Requires-Dist: fastembed>=0.3.1; extra == 'retrievechat-qdrant'
 Requires-Dist: ipython; extra == 'retrievechat-qdrant'
 Requires-Dist: markdownify; extra == 'retrievechat-qdrant'
-Requires-Dist: protobuf==6.31.1; extra == 'retrievechat-qdrant'
+Requires-Dist: protobuf==6.32.0; extra == 'retrievechat-qdrant'
 Requires-Dist: pypdf; extra == 'retrievechat-qdrant'
 Requires-Dist: qdrant-client; extra == 'retrievechat-qdrant'
 Requires-Dist: sentence-transformers<=5.1.0; extra == 'retrievechat-qdrant'
@@ -303,10 +306,10 @@ Requires-Dist: mcp>=1.11.0; extra == 'test'
 Requires-Dist: mock==5.2.0; extra == 'test'
 Requires-Dist: nbconvert==7.16.6; extra == 'test'
 Requires-Dist: nbformat==5.10.4; extra == 'test'
-Requires-Dist: pandas==2.3.1; extra == 'test'
+Requires-Dist: pandas==2.3.2; extra == 'test'
 Requires-Dist: pytest-asyncio==1.1.0; extra == 'test'
-Requires-Dist: pytest-cov==6.2.1; extra == 'test'
-Requires-Dist: pytest==8.4.1; extra == 'test'
+Requires-Dist: pytest-cov==6.3.0; extra == 'test'
+Requires-Dist: pytest==8.4.2; extra == 'test'
 Provides-Extra: together
 Requires-Dist: together>=1.2; extra == 'together'
 Provides-Extra: twilio
@@ -323,10 +326,10 @@ Requires-Dist: mypy==1.17.1; extra == 'types'
 Requires-Dist: nbconvert==7.16.6; extra == 'types'
 Requires-Dist: nbformat==5.10.4; extra == 'types'
 Requires-Dist: openai>=1.99.3; extra == 'types'
-Requires-Dist: pandas==2.3.1; extra == 'types'
+Requires-Dist: pandas==2.3.2; extra == 'types'
 Requires-Dist: pytest-asyncio==1.1.0; extra == 'types'
-Requires-Dist: pytest-cov==6.2.1; extra == 'types'
-Requires-Dist: pytest==8.4.1; extra == 'types'
+Requires-Dist: pytest-cov==6.3.0; extra == 'types'
+Requires-Dist: pytest==8.4.2; extra == 'types'
 Requires-Dist: types-decorator; extra == 'types'
 Requires-Dist: types-pycurl; extra == 'types'
 Requires-Dist: types-python-dateutil; extra == 'types'
@@ -342,6 +345,9 @@ Requires-Dist: pathvalidate; extra == 'websurfer'
 Requires-Dist: pdfminer-six; extra == 'websurfer'
 Provides-Extra: wikipedia
 Requires-Dist: wikipedia-api<1.0,>=0.8.1; extra == 'wikipedia'
+Provides-Extra: yepcode
+Requires-Dist: python-dotenv; extra == 'yepcode'
+Requires-Dist: yepcode-run>=1.6.1; extra == 'yepcode'
 Description-Content-Type: text/markdown
 
 <a name="readme-top"></a>
@@ -411,9 +417,9 @@ The project is currently maintained by a [dynamic group of volunteers](MAINTAINE
     - [Tools](#tools)
     - [Advanced agentic design patterns](#advanced-agentic-design-patterns)
   - [Announcements](#announcements)
-  - [Contributors Wall](#contributors-wall)
   - [Code style and linting](#code-style-and-linting)
   - [Related papers](#related-papers)
+  - [Contributors Wall](#contributors-wall)
   - [Cite the project](#cite-the-project)
   - [License](#license)
 
@@ -425,22 +431,30 @@ For a step-by-step walk through of AG2 concepts and code, see [Basic Concepts](h
 
 AG2 requires **Python version >= 3.10, < 3.14**. AG2 is available via `ag2` (or its alias `autogen`) on PyPI.
 
+**Windows/Linux:**
 ```bash
 pip install ag2[openai]
 ```
 
+**Mac:**
+```bash
+pip install 'ag2[openai]'
+```
+
 Minimal dependencies are installed by default. You can install extra options based on the features you need.
 
 ### Setup your API keys
 
-To keep your LLM dependencies neat we recommend using the `OAI_CONFIG_LIST` file to store your API keys.
+To keep your LLM dependencies neat and avoid accidentally checking in code with your API key, we recommend storing your keys in a configuration file.
 
-You can use the sample file `OAI_CONFIG_LIST_sample` as a template.
+In our examples, we use a file named **`OAI_CONFIG_LIST`** to store API keys. You can choose any filename, but make sure to add it to `.gitignore` so it will not be committed to source control.
+
+You can use the following content as a template:
 
 ```json
 [
   {
-    "model": "gpt-4o",
+    "model": "gpt-5",
     "api_key": "<your OpenAI API key here>"
   }
 ]
@@ -455,12 +469,11 @@ from autogen import AssistantAgent, UserProxyAgent, LLMConfig
 
 llm_config = LLMConfig.from_json(path="OAI_CONFIG_LIST")
 
+assistant = AssistantAgent("assistant", llm_config=llm_config)
 
-with llm_config:
-    assistant = AssistantAgent("assistant")
 user_proxy = UserProxyAgent("user_proxy", code_execution_config={"work_dir": "coding", "use_docker": False})
-user_proxy.initiate_chat(assistant, message="Plot a chart of NVDA and TESLA stock price change YTD.")
-# This initiates an automated chat between the two agents to solve the task
+
+user_proxy.run(assistant, message="Summarize the main differences between Python lists and tuples.").process()
 ```
 
 ## Example applications
@@ -484,208 +497,216 @@ We have several agent concepts in AG2 to help you build your AI agents. We intro
 
 The [ConversableAgent](https://docs.ag2.ai/latest/docs/api-reference/autogen/ConversableAgent) is the fundamental building block of AG2, designed to enable seamless communication between AI entities. This core agent type handles message exchange and response generation, serving as the base class for all agents in the framework.
 
-In the example below, we'll create a simple information validation workflow with two specialized agents that communicate with each other:
-
-Note: Before running this code, make sure to set your `OPENAI_API_KEY` as an environment variable. This example uses `gpt-4o-mini`, but you can replace it with any other [model](https://docs.ag2.ai/latest/docs/user-guide/models/amazon-bedrock) supported by AG2.
+Let's begin with a simple example where two agents collaborate:
+- A **coder agent** that writes Python code.
+- A **reviewer agent** that critiques the code without rewriting it.
 
 ```python
-# 1. Import ConversableAgent class
+import logging
 from autogen import ConversableAgent, LLMConfig
 
-# 2. Define our LLM configuration for OpenAI's GPT-4o mini
-#    uses the OPENAI_API_KEY environment variable
-llm_config = LLMConfig(api_type="openai", model="gpt-4o-mini")
-
-
-# 3. Create our LLM agent
-with llm_config:
-  # Create an AI agent
-  assistant = ConversableAgent(
-      name="assistant",
-      system_message="You are an assistant that responds concisely.",
-  )
-
-  # Create another AI agent
-  fact_checker = ConversableAgent(
-      name="fact_checker",
-      system_message="You are a fact-checking assistant.",
-  )
-
-# 4. Start the conversation
-assistant.initiate_chat(
-    recipient=fact_checker,
-    message="What is AG2?",
-    max_turns=2
+# Configure logging
+logging.basicConfig(level=logging.INFO)
+logger = logging.getLogger(__name__)
+
+# Load LLM configuration
+llm_config = LLMConfig.from_json(path="OAI_CONFIG_LIST")
+
+# Define agents
+coder = ConversableAgent(
+    name="coder",
+    system_message="You are a Python developer. Write short Python scripts.",
+    llm_config=llm_config,
 )
-```
 
-### Human in the loop
+reviewer = ConversableAgent(
+    name="reviewer",
+    system_message="You are a code reviewer. Analyze provided code and suggest improvements. "
+                   "Do not generate code, only suggest improvements.",
+    llm_config=llm_config,
+)
 
-Human oversight is crucial for many AI workflows, especially when dealing with critical decisions, creative tasks, or situations requiring expert judgment. AG2 makes integrating human feedback seamless through its human-in-the-loop functionality.
-You can configure how and when human input is solicited using the `human_input_mode` parameter:
+# Start a conversation
+response = reviewer.run(
+            recipient=coder,
+            message="Write a Python function that computes Fibonacci numbers.",
+            max_turns=10
+        )
 
-- `ALWAYS`: Requires human input for every response
-- `NEVER`: Operates autonomously without human involvement
-- `TERMINATE`: Only requests human input to end conversations
+response.process()
 
-For convenience, AG2 provides the specialized `UserProxyAgent` class that automatically sets `human_input_mode` to `ALWAYS` and supports code execution:
+logger.info("Final output:\n%s", response.summary)
+```
+
+---
+### Orchestrating Multiple Agents
+
+AG2 enables sophisticated multi-agent collaboration through flexible orchestration patterns, allowing you to create dynamic systems where specialized agents work together to solve complex problems.
 
-Note: Before running this code, make sure to set your `OPENAI_API_KEY` as an environment variable. This example uses `gpt-4o-mini`, but you can replace it with any other [model](https://docs.ag2.ai/latest/docs/user-guide/models/amazon-bedrock) supported by AG2.
+Here’s how to build a team of **teacher**, **lesson planner**, and **reviewer** agents working together to design a lesson plan:
 
 ```python
-# 1. Import ConversableAgent and UserProxyAgent classes
-from autogen import ConversableAgent, UserProxyAgent, LLMConfig
+import logging
+from autogen import ConversableAgent, LLMConfig
+from autogen.agentchat import run_group_chat
+from autogen.agentchat.group.patterns import AutoPattern
 
-# 2. Define our LLM configuration for OpenAI's GPT-4o mini
-#    uses the OPENAI_API_KEY environment variable
-llm_config = LLMConfig(api_type="openai", model="gpt-4o-mini")
+logging.basicConfig(level=logging.INFO)
+logger = logging.getLogger(__name__)
 
+llm_config = LLMConfig.from_json(path="OAI_CONFIG_LIST")
 
-# 3. Create our LLM agent
-with llm_config:
-  assistant = ConversableAgent(
-      name="assistant",
-      system_message="You are a helpful assistant.",
-  )
+# Define lesson planner and reviewer
+planner_message = "You are a classroom lesson planner. Given a topic, write a lesson plan for a fourth grade class."
+reviewer_message = "You are a classroom lesson reviewer. Compare the plan to the curriculum and suggest up to 3 improvements."
 
-# 4. Create a human agent with manual input mode
-human = ConversableAgent(
-    name="human",
-    human_input_mode="ALWAYS"
+lesson_planner = ConversableAgent(
+    name="planner_agent",
+    system_message=planner_message,
+    description="Creates or revises lesson plans.",
+    llm_config=llm_config,
 )
-# or
-human = UserProxyAgent(name="human", code_execution_config={"work_dir": "coding", "use_docker": False})
 
-# 5. Start the chat
-human.initiate_chat(
-    recipient=assistant,
-    message="Hello! What's 2 + 2?"
+lesson_reviewer = ConversableAgent(
+    name="reviewer_agent",
+    system_message=reviewer_message,
+    description="Provides one round of feedback to lesson plans.",
+    llm_config=llm_config,
 )
 
-```
+teacher_message = "You are a classroom teacher. You decide topics and collaborate with planner and reviewer to finalize lesson plans. When satisfied, output DONE!"
 
-### Orchestrating multiple agents
+teacher = ConversableAgent(
+    name="teacher_agent",
+    system_message=teacher_message,
+    is_termination_msg=lambda x: "DONE!" in (x.get("content", "") or "").upper(),
+    llm_config=llm_config,
+)
 
-AG2 enables sophisticated multi-agent collaboration through flexible orchestration patterns, allowing you to create dynamic systems where specialized agents work together to solve complex problems.
+auto_selection = AutoPattern(
+    agents=[teacher, lesson_planner, lesson_reviewer],
+    initial_agent=lesson_planner,
+    group_manager_args={"name": "group_manager", "llm_config": llm_config},
+)
+
+response = run_group_chat(
+    pattern=auto_selection,
+    messages="Let's introduce our kids to the solar system.",
+    max_rounds=20,
+)
 
-The framework offers both custom orchestration and several built-in collaboration patterns including `GroupChat` and `Swarm`.
+response.process()
+
+logger.info("Final output:\n%s", response.summary)
+```
 
-Here's how to implement a collaborative team for curriculum development using GroupChat:
+---
 
-Note: Before running this code, make sure to set your `OPENAI_API_KEY` as an environment variable. This example uses `gpt-4o-mini`, but you can replace it with any other [model](https://docs.ag2.ai/latest/docs/user-guide/models/amazon-bedrock) supported by AG2.
+### Human in the Loop
+
+Human oversight is often essential for validating or guiding AI outputs.
+AG2 provides the `UserProxyAgent` for seamless integration of human feedback.
+
+Here we extend the **teacher–planner–reviewer** example by introducing a **human agent** who validates the final lesson:
 
 ```python
-from autogen import ConversableAgent, GroupChat, GroupChatManager, LLMConfig
-
-# Put your key in the OPENAI_API_KEY environment variable
-llm_config = LLMConfig(api_type="openai", model="gpt-4o-mini")
-
-planner_message = """You are a classroom lesson agent.
-Given a topic, write a lesson plan for a fourth grade class.
-Use the following format:
-<title>Lesson plan title</title>
-<learning_objectives>Key learning objectives</learning_objectives>
-<script>How to introduce the topic to the kids</script>
-"""
-
-reviewer_message = """You are a classroom lesson reviewer.
-You compare the lesson plan to the fourth grade curriculum and provide a maximum of 3 recommended changes.
-Provide only one round of reviews to a lesson plan.
-"""
-
-# 1. Add a separate 'description' for our planner and reviewer agents
-planner_description = "Creates or revises lesson plans."
-
-reviewer_description = """Provides one round of reviews to a lesson plan
-for the lesson_planner to revise."""
-
-with llm_config:
-    lesson_planner = ConversableAgent(
-        name="planner_agent",
-        system_message=planner_message,
-        description=planner_description,
-    )
-
-    lesson_reviewer = ConversableAgent(
-        name="reviewer_agent",
-        system_message=reviewer_message,
-        description=reviewer_description,
-    )
-
-# 2. The teacher's system message can also be used as a description, so we don't define it
-teacher_message = """You are a classroom teacher.
-You decide topics for lessons and work with a lesson planner.
-and reviewer to create and finalise lesson plans.
-When you are happy with a lesson plan, output "DONE!".
-"""
-
-with llm_config:
-    teacher = ConversableAgent(
-        name="teacher_agent",
-        system_message=teacher_message,
-        # 3. Our teacher can end the conversation by saying DONE!
-        is_termination_msg=lambda x: "DONE!" in (x.get("content", "") or "").upper(),
-    )
-
-# 4. Create the GroupChat with agents and selection method
-groupchat = GroupChat(
-    agents=[teacher, lesson_planner, lesson_reviewer],
-    speaker_selection_method="auto",
-    messages=[],
+import logging
+from autogen import ConversableAgent, LLMConfig, UserProxyAgent
+from autogen.agentchat import run_group_chat
+from autogen.agentchat.group.patterns import AutoPattern
+
+logging.basicConfig(level=logging.INFO)
+logger = logging.getLogger(__name__)
+
+llm_config = LLMConfig.from_json(path="OAI_CONFIG_LIST")
+
+# Same agents as before, but now the human validator will pass to the planner who will check for "APPROVED" and terminate
+planner_message = "You are a classroom lesson planner. Given a topic, write a lesson plan for a fourth grade class."
+reviewer_message = "You are a classroom lesson reviewer. Compare the plan to the curriculum and suggest up to 3 improvements."
+teacher_message = "You are an experienced classroom teacher. You don't prepare plans, you provide simple guidance to the planner to prepare a lesson plan on the key topic."
+
+lesson_planner = ConversableAgent(
+    name="planner_agent",
+    system_message=planner_message,
+    description="Creates or revises lesson plans before having them reviewed.",
+    is_termination_msg=lambda x: "APPROVED" in (x.get("content", "") or "").upper(),
+    human_input_mode="NEVER",
+    llm_config=llm_config,
 )
 
-# 5. Our GroupChatManager will manage the conversation and uses an LLM to select the next agent
-manager = GroupChatManager(
-    name="group_manager",
-    groupchat=groupchat,
+lesson_reviewer = ConversableAgent(
+    name="reviewer_agent",
+    system_message=reviewer_message,
+    description="Provides one round of feedback to lesson plans back to the lesson planner before requiring the human validator.",
     llm_config=llm_config,
 )
 
-# 6. Initiate the chat with the GroupChatManager as the recipient
-teacher.initiate_chat(
-    recipient=manager,
-    message="Today, let's introduce our kids to the solar system."
+teacher = ConversableAgent(
+    name="teacher_agent",
+    system_message=teacher_message,
+    description="Provides guidance on the topic and content, if required.",
+    llm_config=llm_config,
+)
+
+human_validator = UserProxyAgent(
+    name="human_validator",
+    system_message="You are a human educator who provides final approval for lesson plans.",
+    description="Evaluates the proposed lesson plan and either approves it or requests revisions, before returning to the planner.",
 )
-```
 
-When executed, this code creates a collaborative system where the teacher initiates the conversation, and the lesson planner and reviewer agents work together to create and refine a lesson plan. The GroupChatManager orchestrates the conversation, selecting the next agent to respond based on the context of the discussion.
+auto_selection = AutoPattern(
+    agents=[teacher, lesson_planner, lesson_reviewer],
+    initial_agent=teacher,
+    user_agent=human_validator,
+    group_manager_args={"name": "group_manager", "llm_config": llm_config},
+)
 
-For workflows requiring more structured processes, explore the Group Chat pattern in the detailed [documentation](https://docs.ag2.ai/latest/docs/user-guide/advanced-concepts/orchestration/group-chat/introduction).
+response = run_group_chat(
+    pattern=auto_selection,
+    messages="Let's introduce our kids to the solar system.",
+    max_rounds=20,
+)
 
-### Tools
+response.process()
 
-Agents gain significant utility through tools as they provide access to external data, APIs, and functionality.
+logger.info("Final output:\n%s", response.summary)
+```
+
+---
+
+### Tools
 
-Note: Before running this code, make sure to set your `OPENAI_API_KEY` as an environment variable. This example uses `gpt-4o-mini`, but you can replace it with any other [model](https://docs.ag2.ai/latest/docs/user-guide/models/amazon-bedrock) supported by AG2.
+Agents gain significant utility through **tools**, which extend their capabilities with external data, APIs, or functions.
 
 ```python
+import logging
 from datetime import datetime
 from typing import Annotated
-
 from autogen import ConversableAgent, register_function, LLMConfig
 
-# Put your key in the OPENAI_API_KEY environment variable
-llm_config = LLMConfig(api_type="openai", model="gpt-4o-mini")
+logging.basicConfig(level=logging.INFO)
+logger = logging.getLogger(__name__)
+
+llm_config = LLMConfig.from_json(path="OAI_CONFIG_LIST")
 
-# 1. Our tool, returns the day of the week for a given date
+# Tool: returns weekday for a given date
 def get_weekday(date_string: Annotated[str, "Format: YYYY-MM-DD"]) -> str:
     date = datetime.strptime(date_string, "%Y-%m-%d")
     return date.strftime("%A")
 
-# 2. Agent for determining whether to run the tool
-with llm_config:
-    date_agent = ConversableAgent(
-        name="date_agent",
-        system_message="You get the day of the week for a given date.",
-    )
+date_agent = ConversableAgent(
+    name="date_agent",
+    system_message="You find the day of the week for a given date.",
+    llm_config=llm_config,
+)
 
-# 3. And an agent for executing the tool
 executor_agent = ConversableAgent(
     name="executor_agent",
     human_input_mode="NEVER",
+    llm_config=llm_config,
 )
 
-# 4. Registers the tool with the agents, the description will be used by the LLM
+# Register tool
 register_function(
     get_weekday,
     caller=date_agent,
@@ -693,14 +714,14 @@ register_function(
     description="Get the day of the week for a given date",
 )
 
-# 5. Two-way chat ensures the executor agent follows the suggesting agent
+# Use tool in chat
 chat_result = executor_agent.initiate_chat(
     recipient=date_agent,
-    message="I was born on the 25th of March 1995, what day was it?",
+    message="I was born on 1995-03-25, what day was it?",
     max_turns=2,
 )
 
-print(chat_result.chat_history[-1]["content"])
+logger.info("Final output:\n%s", chat_result.chat_history[-1]["content"])
 ```
 
 ### Advanced agentic design patterns
@@ -712,6 +733,7 @@ AG2 supports more advanced concepts to help you build your AI agent workflows. Y
 - [Retrieval Augmented Generation (RAG)](https://docs.ag2.ai/latest/docs/user-guide/advanced-concepts/rag/)
 - [Code Execution](https://docs.ag2.ai/latest/docs/user-guide/advanced-concepts/code-execution)
 - [Tools with Secrets](https://docs.ag2.ai/latest/docs/user-guide/advanced-concepts/tools/tools-with-secrets/)
+- [Pattern Cookbook (9 group orchestrations)](https://docs.ag2.ai/latest/docs/user-guide/advanced-concepts/pattern-cookbook/overview/)
 
 ## Announcements
 
@@ -729,12 +751,6 @@ We adopt the Apache 2.0 license from v0.3. This enhances our commitment to open-
 
 [More Announcements](announcements.md)
 
-## Contributors Wall
-
-<a href="https://github.com/ag2ai/ag2/graphs/contributors">
-  <img src="https://contrib.rocks/image?repo=ag2ai/ag2&max=204" />
-</a>
-
 ## Code style and linting
 
 This project uses pre-commit hooks to maintain code quality. Before contributing:
@@ -764,6 +780,12 @@ pre-commit run --all-files
 
 - [StateFlow: Enhancing LLM Task-Solving through State-Driven Workflows](https://arxiv.org/abs/2403.11322)
 
+## Contributors Wall
+
+<a href="https://github.com/ag2ai/ag2/graphs/contributors">
+  <img src="https://contrib.rocks/image?repo=ag2ai/ag2&max=204" />
+</a>
+
 ## Cite the project
 
 ```