Planned deprecation for v0.14

[marklysze]

Why are these changes needed?

In v0.12 deprecations will be announced as per the roadmap.

This PR adds deprecation warnings in code, documentation, and notebooks.

Deprecations effective as of v0.14

Agents

Module	Class	Reason	Alternative
contrib/gpt_assistant_agent.py	GPTAssistantAgent	Tightly coupled to OpenAI Assistant API; defaults to gpt-4-0125-preview	ConversableAgent
contrib/llava_agent.py	LLaVAAgent	LLaVA model via Replicate is outdated; incomplete implementation with multiple TODOs	v1.0 will contain native multimodal support on Agent
contrib/web_surfer.py	WebSurferAgent	References gpt-3.5-turbo-1106; superseded by experimental version	autogen.agents.experimental.WebSurferAgent
contrib/text_analyzer_agent.py	TextAnalyzerAgent	Trivial wrapper around ConversableAgent with a system prompt	ConversableAgent with an appropriate system message
contrib/math_user_proxy_agent.py	MathUserProxyAgent	WolframAlpha-based math solving; modern LLMs handle math natively	ConversableAgent with tool calling
contrib/society_of_mind_agent.py	SocietyOfMindAgent	Inner monologue via GroupChat pattern	GroupChat patterns
contrib/agent_optimizer.py	AgentOptimizer	Fragile dynamic function generation via code execution	ConversableAgent with tool calling
contrib/swarm_agent.py	SwarmAgent	Incorporated into ConversableAgent	ConversableAgent
contrib/retrieve_assistant_agent.py	RetrieveAssistantAgent	Unnecessary subclass	AssistantAgent
contrib/qdrant_retrieve_user_proxy_agent.py	QdrantRetrieveUserProxyAgent	Unnecessary subclass	RetrieveUserProxyAgent with vector_db='qdrant'
realtime/experimental/	RealtimeAgent	Relies on deprecated realtime API endpoints	—

Swarm functions and aliases

Module	Feature	Alternative
contrib/swarm_agent.py	initiate_swarm_chat()	run_group_chat
contrib/swarm_agent.py	run_swarm()	run_group_chat
contrib/swarm_agent.py	AFTER_WORK	AfterWork
contrib/swarm_agent.py	ON_CONDITION	OnCondition

Capabilities

Module	Class	Reason	Alternative
contrib/capabilities/generate_images.py	ImageGeneration	Depends on deprecated TextAnalyzerAgent; uses old model patterns	—

Modules

Module	Functions/Classes	Reason
contrib/agent_eval/	generate_criteria(), quantify_criteria(), CriticAgent, QuantifierAgent, SubCriticAgent, Criterion, Task	Experimental evaluation framework

Documentation

Blog posts

File	Topic
_blogs/2023-11-13-OAI-assistants/	GPTAssistantAgent introduction
_blogs/2023-11-06-LMM-Agent/	LLaVA and multimodal agents
_blogs/2023-12-23-AgentOptimizer/	AgentOptimizer
_blogs/2023-11-20-AgentEval/	AgentEval framework
_blogs/2024-06-21-AgentEval/	AgentEval with verification
_blogs/2023-10-26-TeachableAgent/	Teachable agents (uses TextAnalyzerAgent, GPTAssistantAgent)
_blogs/2024-12-20-RealtimeAgent/	RealtimeAgent introduction
_blogs/2025-01-08-RealtimeAgent-over-websocket/	RealtimeAgent WebSocket
_blogs/2025-01-09-RealtimeAgent-over-WebRTC/	RealtimeAgent WebRTC
_blogs/2025-01-29-RealtimeAgent-with-gemini/	RealtimeAgent with Gemini

User guide pages

File	Topic
user-guide/advanced-concepts/realtime-agent/index.mdx	RealtimeAgent overview
user-guide/advanced-concepts/realtime-agent/websocket.mdx	RealtimeAgent WebSocket adapter
user-guide/advanced-concepts/realtime-agent/webrtc.mdx	RealtimeAgent WebRTC integration
user-guide/advanced-concepts/realtime-agent/twilio.mdx	RealtimeAgent Twilio adapter

Deprecated notebooks

Notebook	Title	Deprecated references	Models used
agentchat_MathChat.ipynb	Using MathChat to Solve Math Problems	MathUserProxyAgent	gpt-3.5-turbo, gpt-4
agentchat_RetrieveChat_qdrant.ipynb	Using RetrieveChat with Qdrant	QdrantRetrieveUserProxyAgent	gpt-5, gpt-5-mini
agentchat_agenteval_cq_math.ipynb	Demonstrating the AgentEval framework	agent_eval	—
agentchat_agentoptimizer.ipynb	AgentOptimizer	AgentOptimizer, MathUserProxyAgent	gpt-4-1106-preview
agentchat_dalle_and_gpt4v.ipynb	Multimodal Models: DALLE and GPT-4V	MultimodalConversableAgent	dall-e-3, gpt-4-vision-preview
agentchat_gpt_assistant_agent_function_call.ipynb	Function Calling with GPTAssistantAgent	GPTAssistantAgent	—
agentchat_image_generation_capability.ipynb	Generate Dalle Images With Conversable Agents	TextAnalyzerAgent, ImageGeneration	dall-e-3, gpt-4-turbo-preview, gpt-4-vision-preview
agentchat_lmm_llava.ipynb	Multimodal Models: LLaVA	LLaVAAgent	gpt-4, gpt-4-vision-preview, llava-v1.5-13b
agentchat_oai_assistant_function_call.ipynb	OpenAI Assistant function call: OSS Insights	GPTAssistantAgent	gpt-5, gpt-5-mini
agentchat_oai_assistant_groupchat.ipynb	Group Chat with GPTAssistantAgent	GPTAssistantAgent	gpt-5, gpt-5-mini
agentchat_oai_assistant_retrieval.ipynb	RAG OpenAI Assistants in AG2	GPTAssistantAgent	gpt-5, gpt-5-mini
agentchat_oai_assistant_twoagents_basic.ipynb	OpenAI Assistants in AG2	GPTAssistantAgent	gpt-5, gpt-5-mini
agentchat_oai_code_interpreter.ipynb	GPTAssistant with Code Interpreter	GPTAssistantAgent	gpt-5, gpt-5-mini
agentchat_realtime_gemini_swarm_websocket.ipynb	RealtimeAgent Swarm (Gemini)	RealtimeAgent	gemini-2.0-flash-exp, gemini-realtime
agentchat_realtime_gemini_websocket.ipynb	RealtimeAgent (Gemini)	RealtimeAgent	gemini-2.0-flash-exp, gemini-realtime
agentchat_realtime_swarm.ipynb	RealtimeAgent Swarm	RealtimeAgent	gpt-4o-realtime-preview
agentchat_realtime_swarm_webrtc.ipynb	RealtimeAgent Swarm (WebRTC)	RealtimeAgent	gpt-4o-realtime-preview
agentchat_realtime_swarm_websocket.ipynb	RealtimeAgent Swarm (WebSocket)	RealtimeAgent	gpt-4o-realtime-preview
agentchat_realtime_webrtc.ipynb	RealtimeAgent (WebRTC)	RealtimeAgent	gpt-4o-realtime-preview
agentchat_realtime_websocket.ipynb	RealtimeAgent (WebSocket)	RealtimeAgent	gpt-4o-realtime-preview
agentchat_society_of_mind.ipynb	SocietyOfMindAgent	SocietyOfMindAgent	gpt-5, gpt-5-mini
agentchat_teachability.ipynb	Chatting with a teachable agent	TextAnalyzerAgent	—
agentchat_teachable_oai_assistants.ipynb	Making OpenAI Assistants Teachable	GPTAssistantAgent, TextAnalyzerAgent	gpt-4, gpt-4-1106-preview
agentchat_video_transcript_translate_with_whisper.ipynb	Translating Video audio using Whisper	Outdated models	gpt-3.5-turbo, gpt-4
agentchat_JSON_mode_example.ipynb	Mitigating Prompt hacking with JSON Mode	Outdated models	gpt-4-0125-preview, gpt-4-turbo-preview
agentchat_RetrieveChat_mongodb.ipynb	RetrieveChat Powered by MongoDB Atlas	Outdated models	gpt-3.5-turbo-0125
agentchat_autobuild_agent_library.ipynb	Build Multi-agent System from Agent Library	Outdated models	gpt-4-1106-preview
agentchat_autobuild_basic.ipynb	AutoBuild	Outdated models	gpt-4-1106-preview
agentchat_autogen_uniformed_api_calling.ipynb	A Uniform interface to call different LLMs	Outdated models	gpt-35-turbo-1106, gpt-4-turbo-1106, claude-1.0
agentchat_captainagent.ipynb	CaptainAgent	Outdated models	gpt-3.5-turbo, gpt-3.5-turbo-16k
agentchat_config_loader_utility_functions.ipynb	Config loader utility functions	Outdated models	gpt-3.5-turbo
agentchat_function_call.ipynb	Task Solving with Provided Tools as Functions	Outdated models	gpt-3.5-turbo, gpt-3.5-turbo-16k
agentchat_function_call_code_writing.ipynb	Writing a software application using function calls	Outdated models	gpt-4-turbo-preview
agentchat_function_call_currency_calculator.ipynb	Currency Calculator	Outdated models	gpt-3.5-turbo, gpt-3.5-turbo-16k
agentchat_group_chat_with_llamaindex_agents.ipynb	Groupchat with Llamaindex agents	Outdated models	gpt-3.5-turbo
agentchat_groupchat_customized.ipynb	Group Chat with Customized Speaker Selection	Outdated models	gpt-4-1106-preview
agentchat_human_feedback.ipynb	Task Solving with Human Feedback	Outdated models	gpt-3.5-turbo, gpt-3.5-turbo-16k
agentchat_langchain.ipynb	Task Solving with Langchain Tools	Outdated models	gpt-3.5-turbo, gpt-3.5-turbo-16k
agentchat_lmm_gpt-4v.ipynb	Multimodal Models: GPT-4V in AG2	MultimodalConversableAgent, outdated models	gpt-4-vision-preview
agentchat_nested_chats_chess.ipynb	Nested Chats for Conversational Chess	Outdated models	gpt-4-turbo-preview
agentchat_oai_chatgpt_gpt4.ipynb	Use AG2 to Tune ChatGPT	Outdated models	gpt-3.5-turbo
agentchat_oai_completion.ipynb	Use AG2 to Tune OpenAI Models	Outdated models	gpt-3.5-turbo, gpt-35-turbo-v0301
agentchat_stream.ipynb	Interactive LLM Agent with Data Stream	Outdated models	gpt-3.5-turbo, gpt-3.5-turbo-16k
agentchat_web_info.ipynb	Solving Tasks Requiring Web Info	Outdated models	gpt4, gpt-4-32k

---

NOT being deprecated

Core agents (autogen/agentchat/)

Class	Description
ConversableAgent	Core agent class
AssistantAgent	LLM-powered assistant
UserProxyAgent	Human-in-the-loop proxy
GroupChat	Multi-agent group chat
GroupChatManager	Manages group chat flow

Contrib agents

Module	Class	Description
contrib/retrieve_user_proxy_agent.py	RetrieveUserProxyAgent	RAG agent with vector DB support
contrib/multimodal_conversable_agent.py	MultimodalConversableAgent	Multimodal agent (deferred to later deprecation cycle)
contrib/llamaindex_conversable_agent.py	LLamaIndexConversableAgent	LlamaIndex integration
contrib/captainagent/	CaptainAgent	Auto-builds expert agent groups (in preview)

Contrib capabilities

Module	Class	Description
capabilities/teachability.py	Teachability	Memory via vector DB
capabilities/vision_capability.py	VisionCapability	Adds vision to agents
capabilities/tools_capability.py	ToolsCapability	Composable tool support
capabilities/transforms.py	MessageTransform, MessageHistoryLimiter, MessageTokenLimiter, TextMessageCompressor	Message transformations
capabilities/transform_messages.py	TransformMessages	Message transformation capability
capabilities/agent_capability.py	AgentCapability	Base capability class

Contrib vector databases

Module	Class	Description
vectordb/base.py	VectorDB, VectorDBFactory, Document	Base protocol and factory
vectordb/chromadb.py	ChromaVectorDB	ChromaDB integration
vectordb/qdrant.py	QdrantVectorDB	Qdrant integration
vectordb/mongodb.py	MongoDBAtlasVectorDB	MongoDB Atlas integration
vectordb/couchbase.py	CouchbaseVectorDB	Couchbase integration
vectordb/pgvectordb.py	PGVectorDB	PostgreSQL pgvector integration

Contrib RAG

Module	Class	Description
rag/query_engine.py	RAGQueryEngine	Protocol for RAG engines
rag/chromadb_query_engine.py	ChromaDBQueryEngine	ChromaDB RAG
rag/llamaindex_query_engine.py	LlamaIndexQueryEngine	LlamaIndex RAG
rag/mongodb_query_engine.py	MongoDBQueryEngine	MongoDB RAG

Contrib graph RAG

Module	Class	Description
graph_rag/graph_query_engine.py	GraphQueryEngine	Protocol for graph engines
graph_rag/graph_rag_capability.py	GraphRagCapability	Graph RAG capability
graph_rag/neo4j_graph_query_engine.py	Neo4jGraphQueryEngine	Neo4j graph RAG
graph_rag/neo4j_native_graph_query_engine.py	Neo4jNativeGraphQueryEngine	Neo4j native graph RAG
graph_rag/falkor_graph_query_engine.py	FalkorGraphQueryEngine	Falkor graph RAG

Group chat and orchestration (active)

Module	Class/Function	Description
agentchat/	GroupChat, GroupChatManager	Core group chat
agentchat/	run_group_chat()	Group chat entry point (replacement for initiate_swarm_chat/run_swarm)
contrib/swarm_agent.py	AfterWork, AfterWorkOption	Post-agent-turn behaviour
contrib/swarm_agent.py	OnCondition, OnContextCondition	Transition conditions

Experimental agents (autogen/agents/experimental/)

Module	Class	Description
websurfer/	WebSurferAgent	Modern web browsing agent (replacement for contrib version)
deep_research/	DeepResearchAgent	Iterative web research
reasoning/	ReasoningAgent	Tree-of-thought reasoning
document_agent/	DocAgent	Document ingestion and querying
a2ui/	A2UIAgent	Rich UI generation
discord/	DiscordAgent	Discord integration
slack/	SlackAgent	Slack integration
telegram/	TelegramAgent	Telegram integration
wikipedia/	WikipediaAgent	Wikipedia retrieval

Contrib agents (autogen/agents/contrib/)

Module	Class	Description
time/	TimeReplyAgent, TimeToolAgent	Reference implementations

Utilities (not deprecated)

Module	Description
contrib/img_utils.py	Image handling utilities
contrib/retrieve_utils.py	File extraction and chunking
contrib/vectordb/utils.py	Vector DB utilities

Related issue number

N/A

Checks

• I've included any doc changes needed for https://docs.ag2.ai/. See https://docs.ag2.ai/latest/docs/contributor-guide/documentation/ to build and test documentation locally.
• I've added tests (if relevant) corresponding to the changes introduced in this PR.
• I've made sure all auto checks have passed.

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.

Files with missing lines	Coverage Δ
.../agentchat/realtime/experimental/realtime_agent.py	74.62% <100.00%> (+1.61%)	⬆️

... and 39 files with indirect coverage changes

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.