A programming framework for agentic AI
Sequential Chat Tutorial (#3861) (#4584)
Gerardo Morenoafaf2c128828
diff --git a/python/packages/autogen-core/docs/drawio/sequential-workflow.drawio b/python/packages/autogen-core/docs/drawio/sequential-workflow.drawionew file mode 100644index 000000000..0abea4515--- /dev/null+++ b/python/packages/autogen-core/docs/drawio/sequential-workflow.drawio@@ -0,0 +1,66 @@+<mxfile host="app.diagrams.net" agent="Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/131.0.0.0 Safari/537.36" version="25.0.3">+ <diagram name="Page-1" id="J3B7wUMKLXaSRlGf0apQ">+ <mxGraphModel dx="436" dy="1180" grid="0" gridSize="10" guides="1" tooltips="1" connect="1" arrows="1" fold="1" page="0" pageScale="1" pageWidth="2050" pageHeight="2000" math="0" shadow="0">+ <root>+ <mxCell id="0" />+ <mxCell id="1" parent="0" />+ <mxCell id="sqq-OtPLxvXwgYRML6Fe-1" value="Concept&nbsp;<span style="background-color: initial;">Extractor</span><div><span style="background-color: initial;">Agent</span></div>" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#dae8fc;strokeColor=#6c8ebf;" vertex="1" parent="1">+ <mxGeometry x="592" y="394" width="120" height="60" as="geometry" />+ </mxCell>+ <mxCell id="sqq-OtPLxvXwgYRML6Fe-2" value="<div>Writer Agent</div>" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#dae8fc;strokeColor=#6c8ebf;" vertex="1" parent="1">+ <mxGeometry x="805" y="394" width="120" height="60" as="geometry" />+ </mxCell>+ <mxCell id="sqq-OtPLxvXwgYRML6Fe-3" value="<div>Format&nbsp;<span style="background-color: initial;">Proof</span></div><div><span style="background-color: initial;">Agent</span></div>" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#dae8fc;strokeColor=#6c8ebf;" vertex="1" parent="1">+ <mxGeometry x="1020" y="394" width="120" height="60" as="geometry" />+ </mxCell>+ <mxCell id="sqq-OtPLxvXwgYRML6Fe-4" value="<div>User Agent</div>" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#dae8fc;strokeColor=#6c8ebf;" vertex="1" parent="1">+ <mxGeometry x="1216" y="394" width="120" height="60" as="geometry" />+ </mxCell>+ <mxCell id="sqq-OtPLxvXwgYRML6Fe-5" value="" style="endArrow=classic;html=1;rounded=0;exitX=1;exitY=0.5;exitDx=0;exitDy=0;entryX=0;entryY=0.5;entryDx=0;entryDy=0;" edge="1" parent="1">+ <mxGeometry width="50" height="50" relative="1" as="geometry">+ <mxPoint x="712" y="423.75" as="sourcePoint" />+ <mxPoint x="805" y="423.75" as="targetPoint" />+ </mxGeometry>+ </mxCell>+ <mxCell id="sqq-OtPLxvXwgYRML6Fe-11" value="Product<div>Concepts</div>" style="edgeLabel;html=1;align=center;verticalAlign=middle;resizable=0;points=[];" vertex="1" connectable="0" parent="sqq-OtPLxvXwgYRML6Fe-5">+ <mxGeometry x="0.1833" y="1" relative="1" as="geometry">+ <mxPoint x="-12" y="1" as="offset" />+ </mxGeometry>+ </mxCell>+ <mxCell id="sqq-OtPLxvXwgYRML6Fe-6" value="" style="endArrow=classic;html=1;rounded=0;exitX=1;exitY=0.5;exitDx=0;exitDy=0;entryX=0;entryY=0.5;entryDx=0;entryDy=0;" edge="1" parent="1" source="sqq-OtPLxvXwgYRML6Fe-2" target="sqq-OtPLxvXwgYRML6Fe-3">+ <mxGeometry width="50" height="50" relative="1" as="geometry">+ <mxPoint x="891" y="420" as="sourcePoint" />+ <mxPoint x="941" y="370" as="targetPoint" />+ </mxGeometry>+ </mxCell>+ <mxCell id="sqq-OtPLxvXwgYRML6Fe-13" value="Marketing&nbsp;<div>Copy</div>" style="edgeLabel;html=1;align=center;verticalAlign=middle;resizable=0;points=[];" vertex="1" connectable="0" parent="sqq-OtPLxvXwgYRML6Fe-6">+ <mxGeometry x="-0.3085" relative="1" as="geometry">+ <mxPoint x="16" as="offset" />+ </mxGeometry>+ </mxCell>+ <mxCell id="sqq-OtPLxvXwgYRML6Fe-7" value="" style="endArrow=classic;html=1;rounded=0;entryX=0;entryY=0.5;entryDx=0;entryDy=0;exitX=1;exitY=0.5;exitDx=0;exitDy=0;" edge="1" parent="1" source="sqq-OtPLxvXwgYRML6Fe-3" target="sqq-OtPLxvXwgYRML6Fe-4">+ <mxGeometry width="50" height="50" relative="1" as="geometry">+ <mxPoint x="1076" y="429" as="sourcePoint" />+ <mxPoint x="1132" y="423.5" as="targetPoint" />+ </mxGeometry>+ </mxCell>+ <mxCell id="sqq-OtPLxvXwgYRML6Fe-14" value="Final&nbsp;<div>Copy</div>" style="edgeLabel;html=1;align=center;verticalAlign=middle;resizable=0;points=[];" vertex="1" connectable="0" parent="sqq-OtPLxvXwgYRML6Fe-7">+ <mxGeometry x="-0.4265" y="1" relative="1" as="geometry">+ <mxPoint x="13" y="1" as="offset" />+ </mxGeometry>+ </mxCell>+ <mxCell id="sqq-OtPLxvXwgYRML6Fe-9" value="" style="endArrow=classic;html=1;rounded=0;entryX=0.5;entryY=0;entryDx=0;entryDy=0;" edge="1" parent="1" target="sqq-OtPLxvXwgYRML6Fe-1">+ <mxGeometry width="50" height="50" relative="1" as="geometry">+ <mxPoint x="652" y="324" as="sourcePoint" />+ <mxPoint x="671" y="350" as="targetPoint" />+ </mxGeometry>+ </mxCell>+ <mxCell id="sqq-OtPLxvXwgYRML6Fe-15" value="Product Description" style="edgeLabel;html=1;align=center;verticalAlign=middle;resizable=0;points=[];" vertex="1" connectable="0" parent="sqq-OtPLxvXwgYRML6Fe-9">+ <mxGeometry x="-0.3657" y="-3" relative="1" as="geometry">+ <mxPoint as="offset" />+ </mxGeometry>+ </mxCell>+ </root>+ </mxGraphModel>+ </diagram>+</mxfile>diff --git a/python/packages/autogen-core/docs/src/user-guide/core-user-guide/design-patterns/index.md b/python/packages/autogen-core/docs/src/user-guide/core-user-guide/design-patterns/index.mdindex df4da43dc..e1dada414 100644--- a/python/packages/autogen-core/docs/src/user-guide/core-user-guide/design-patterns/index.md+++ b/python/packages/autogen-core/docs/src/user-guide/core-user-guide/design-patterns/index.md@@ -21,6 +21,7 @@ group chat for task decomposition, and reflection for robustness.:maxdepth: 1concurrent-agents+sequential-workflowgroup-chathandoffsmixture-of-agentsdiff --git a/python/packages/autogen-core/docs/src/user-guide/core-user-guide/design-patterns/sequential-workflow.ipynb b/python/packages/autogen-core/docs/src/user-guide/core-user-guide/design-patterns/sequential-workflow.ipynbnew file mode 100644index 000000000..1ef40a2ce--- /dev/null+++ b/python/packages/autogen-core/docs/src/user-guide/core-user-guide/design-patterns/sequential-workflow.ipynb@@ -0,0 +1,391 @@+{+ "cells": [+ {+ "cell_type": "markdown",+ "metadata": {},+ "source": [+ "# Sequential Workflow\n",+ "\n",+ "Sequential Workflow is a multi-agent design pattern where agents respond in a deterministic sequence. Each agent in the workflow performs a specific task by processing a message, generating a response, and then passing it to the next agent. This pattern is useful for creating deterministic workflows where each agent contributes to a pre-specified sub-task."+ ]+ },+ {+ "cell_type": "markdown",+ "metadata": {},+ "source": [+ "In this example, we demonstrate a sequential workflow where multiple agents collaborate to transform a basic product description into a polished marketing copy.\n",+ "\n",+ "The pipeline consists of four specialized agents:\n",+ "- **Concept Extractor Agent**: Analyzes the initial product description to extract key features, target audience, and unique selling points (USPs). The output is a structured analysis in a single text block.\n",+ "- **Writer Agent**: Crafts compelling marketing copy based on the extracted concepts. This agent transforms the analytical insights into engaging promotional content, delivering a cohesive narrative in a single text block.\n",+ "- **Format & Proof Agent**: Polishes the draft copy by refining grammar, enhancing clarity, and maintaining consistent tone. This agent ensures professional quality and delivers a well-formatted final version.\n",+ "- **User Agent**: Presents the final, refined marketing copy to the user, completing the workflow."+ ]+ },+ {+ "cell_type": "markdown",+ "metadata": {},+ "source": [+ "The following diagram illustrates the sequential workflow in this example:\n",+ "\n",+ "\n",+ "\n",+ "We will implement this workflow using publish-subscribe messaging.\n",+ "Please read about [Topic and Subscription](../core-concepts/topic-and-subscription.md) for the core concepts\n",+ "and [Broadcast Messaging](../framework/message-and-communication.ipynb#broadcast) for the the API usage.\n",+ "\n",+ "In this pipeline, agents communicate with each other by publishing their completed work as messages to the topic of the \n",+ "next agent in the sequence. For example, when the `ConceptExtractor` finishes analyzing the product description, it \n",+ "publishes its findings to the `\"WriterAgent\"` topic, which the `WriterAgent` is subscribed to. This pattern continues through \n",+ "each step of the pipeline, with each agent publishing to the topic that the next agent in line subscribed to."+ ]+ },+ {+ "cell_type": "code",+ "execution_count": 20,+ "metadata": {},+ "outputs": [],+ "source": [+ "from dataclasses import dataclass\n",+ "\n",+ "from autogen_core import (\n",+ " MessageContext,\n",+ " RoutedAgent,\n",+ " SingleThreadedAgentRuntime,\n",+ " TopicId,\n",+ " TypeSubscription,\n",+ " message_handler,\n",+ " type_subscription,\n",+ ")\n",+ "from autogen_core.components.models import ChatCompletionClient, SystemMessage, UserMessage\n",+ "from autogen_ext.models import OpenAIChatCompletionClient"+ ]+ },+ {+ "cell_type": "markdown",+ "metadata": {},+ "source": [+ "## Message Protocol\n",+ "\n",+ "The message protocol for this example workflow is a simple text message that agents will use to relay their work."+ ]+ },+ {+ "cell_type": "code",+ "execution_count": 21,+ "metadata": {},+ "outputs": [],+ "source": [+ "@dataclass\n",+ "class Message:\n",+ " content: str"+ ]+ },+ {+ "cell_type": "markdown",+ "metadata": {},+ "source": [+ "## Topics\n",+ "\n",+ "Each agent in the workflow will be subscribed to a specific topic type. The topic types are named after the agents in the sequence,\n",+ "This allows each agent to publish its work to the next agent in the sequence."+ ]+ },+ {+ "cell_type": "code",+ "execution_count": 22,+ "metadata": {},+ "outputs": [],+ "source": [+ "concept_extractor_topic_type = \"ConceptExtractorAgent\"\n",+ "writer_topic_type = \"WriterAgent\"\n",+ "format_proof_topic_type = \"FormatProofAgent\"\n",+ "user_topic_type = \"User\""+ ]+ },+ {+ "cell_type": "markdown",+ "metadata": {},+ "source": [+ "## Agents\n",+ "\n",+ "Each agent class is defined with a {py:class}`~autogen_core.type_subscription` decorator to specify the topic type it is subscribed to.\n",+ "Alternative to the decorator, you can also use the {py:meth}`~autogen_core.AgentRuntime.add_subscription` method to subscribe to a topic through runtime directly.\n",+ "\n",+ "The concept extractor agent comes up with the initial bullet points for the product description."+ ]+ },+ {+ "cell_type": "code",+ "execution_count": 23,+ "metadata": {},+ "outputs": [],+ "source": [+ "@type_subscription(topic_type=concept_extractor_topic_type)\n",+ "class ConceptExtractorAgent(RoutedAgent):\n",+ " def __init__(self, model_client: ChatCompletionClient) -> None:\n",+ " super().__init__(\"A concept extractor agent.\")\n",+ " self._system_message = SystemMessage(\n",+ " content=(\n",+ " \"You are a marketing analyst. Given a product description, identify:\\n\"\n",+ " \"- Key features\\n\"\n",+ " \"- Target audience\\n\"\n",+ " \"- Unique selling points\\n\\n\"\n",+ " )\n",+ " )\n",+ " self._model_client = model_client\n",+ "\n",+ " @message_handler\n",+ " async def handle_user_description(self, message: Message, ctx: MessageContext) -> None:\n",+ " prompt = f\"Product description: {message.content}\"\n",+ " llm_result = await self._model_client.create(\n",+ " messages=[self._system_message, UserMessage(content=prompt, source=self.id.key)],\n",+ " cancellation_token=ctx.cancellation_token,\n",+ " )\n",+ " response = llm_result.content\n",+ " assert isinstance(response, str)\n",+ " print(f\"{'-'*80}\\n{self.id.type}:\\n{response}\")\n",+ "\n",+ " await self.publish_message(Message(response), topic_id=TopicId(writer_topic_type, source=self.id.key))"+ ]+ },+ {+ "cell_type": "markdown",+ "metadata": {},+ "source": [+ "The writer agent performs writing."+ ]+ },+ {+ "cell_type": "code",+ "execution_count": 24,+ "metadata": {},+ "outputs": [],+ "source": [+ "@type_subscription(topic_type=writer_topic_type)\n",+ "class WriterAgent(RoutedAgent):\n",+ " def __init__(self, model_client: ChatCompletionClient) -> None:\n",+ " super().__init__(\"A writer agent.\")\n",+ " self._system_message = SystemMessage(\n",+ " content=(\n",+ " \"You are a marketing copywriter. Given a block of text describing features, audience, and USPs, \"\n",+ " \"compose a compelling marketing copy (like a newsletter section) that highlights these points. \"\n",+ " \"Output should be short (around 150 words), output just the copy as a single text block.\"\n",+ " )\n",+ " )\n",+ " self._model_client = model_client\n",+ "\n",+ " @message_handler\n",+ " async def handle_intermediate_text(self, message: Message, ctx: MessageContext) -> None:\n",+ " prompt = f\"Below is the info about the product:\\n\\n{message.content}\"\n",+ "\n",+ " llm_result = await self._model_client.create(\n",+ " messages=[self._system_message, UserMessage(content=prompt, source=self.id.key)],\n",+ " cancellation_token=ctx.cancellation_token,\n",+ " )\n",+ " response = llm_result.content\n",+ " assert isinstance(response, str)\n",+ " print(f\"{'-'*80}\\n{self.id.type}:\\n{response}\")\n",+ "\n",+ " await self.publish_message(Message(response), topic_id=TopicId(format_proof_topic_type, source=self.id.key))"+ ]+ },+ {+ "cell_type": "markdown",+ "metadata": {},+ "source": [+ "The format proof agent performs the formatting."+ ]+ },+ {+ "cell_type": "code",+ "execution_count": 25,+ "metadata": {},+ "outputs": [],+ "source": [+ "@type_subscription(topic_type=format_proof_topic_type)\n",+ "class FormatProofAgent(RoutedAgent):\n",+ " def __init__(self, model_client: ChatCompletionClient) -> None:\n",+ " super().__init__(\"A format & proof agent.\")\n",+ " self._system_message = SystemMessage(\n",+ " content=(\n",+ " \"You are an editor. Given the draft copy, correct grammar, improve clarity, ensure consistent tone, \"\n",+ " \"give format and make it polished. Output the final improved copy as a single text block.\"\n",+ " )\n",+ " )\n",+ " self._model_client = model_client\n",+ "\n",+ " @message_handler\n",+ " async def handle_intermediate_text(self, message: Message, ctx: MessageContext) -> None:\n",+ " prompt = f\"Draft copy:\\n{message.content}.\"\n",+ " llm_result = await self._model_client.create(\n",+ " messages=[self._system_message, UserMessage(content=prompt, source=self.id.key)],\n",+ " cancellation_token=ctx.cancellation_token,\n",+ " )\n",+ " response = llm_result.content\n",+ " assert isinstance(response, str)\n",+ " print(f\"{'-'*80}\\n{self.id.type}:\\n{response}\")\n",+ "\n",+ " await self.publish_message(Message(response), topic_id=TopicId(user_topic_type, source=self.id.key))"+ ]+ },+ {+ "cell_type": "markdown",+ "metadata": {},+ "source": [+ "In this example, the user agent simply prints the final marketing copy to the console.\n",+ "In a real-world application, this could be replaced by storing the result to a database, sending an email, or any other desired action."+ ]+ },+ {+ "cell_type": "code",+ "execution_count": 26,+ "metadata": {},+ "outputs": [],+ "source": [+ "@type_subscription(topic_type=user_topic_type)\n",+ "class UserAgent(RoutedAgent):\n",+ " def __init__(self) -> None:\n",+ " super().__init__(\"A user agent that outputs the final copy to the user.\")\n",+ "\n",+ " @message_handler\n",+ " async def handle_final_copy(self, message: Message, ctx: MessageContext) -> None:\n",+ " print(f\"\\n{'-'*80}\\n{self.id.type} received final copy:\\n{message.content}\")"+ ]+ },+ {+ "cell_type": "markdown",+ "metadata": {},+ "source": [+ "## Workflow\n",+ "\n",+ "Now we can register the agents to the runtime.\n",+ "Because we used the {py:class}`~autogen_core.type_subscription` decorator, the runtime will automatically subscribe the agents to the correct topics."+ ]+ },+ {+ "cell_type": "code",+ "execution_count": null,+ "metadata": {},+ "outputs": [],+ "source": [+ "model_client = OpenAIChatCompletionClient(\n",+ " model=\"gpt-4o-mini\",\n",+ " # api_key=\"YOUR_API_KEY\"\n",+ ")\n",+ "\n",+ "runtime = SingleThreadedAgentRuntime()\n",+ "\n",+ "await ConceptExtractorAgent.register(\n",+ " runtime, type=concept_extractor_topic_type, factory=lambda: ConceptExtractorAgent(model_client=model_client)\n",+ ")\n",+ "\n",+ "await WriterAgent.register(runtime, type=writer_topic_type, factory=lambda: WriterAgent(model_client=model_client))\n",+ "\n",+ "await FormatProofAgent.register(\n",+ " runtime, type=format_proof_topic_type, factory=lambda: FormatProofAgent(model_client=model_client)\n",+ ")\n",+ "\n",+ "await UserAgent.register(runtime, type=user_topic_type, factory=lambda: UserAgent())"+ ]+ },+ {+ "cell_type": "markdown",+ "metadata": {},+ "source": [+ "## Run the Workflow\n",+ "\n",+ "Finally, we can run the workflow by publishing a message to the first agent in the sequence."+ ]+ },+ {+ "cell_type": "code",+ "execution_count": null,+ "metadata": {},+ "outputs": [+ {+ "name": "stdout",+ "output_type": "stream",+ "text": [+ "--------------------------------------------------------------------------------\n",+ "ConceptExtractorAgent:\n",+ "**Key Features:**\n",+ "- Made from eco-friendly stainless steel\n",+ "- Can keep drinks cold for up to 24 hours\n",+ "- Durable and reusable design\n",+ "- Lightweight and portable\n",+ "- BPA-free and non-toxic materials\n",+ "- Sleek, modern aesthetic available in various colors\n",+ "\n",+ "**Target Audience:**\n",+ "- Environmentally conscious consumers\n",+ "- Health and fitness enthusiasts\n",+ "- Outdoor adventurers (hikers, campers, etc.)\n",+ "- Urban dwellers looking for sustainable alternatives\n",+ "- Individuals seeking stylish and functional drinkware\n",+ "\n",+ "**Unique Selling Points:**\n",+ "- Eco-friendly design minimizes plastic waste and supports sustainability\n",+ "- Superior insulation technology that maintains cold temperatures for a full day\n",+ "- Durable construction ensures long-lasting use, offering a great return on investment\n",+ "- Attractive design that caters to fashion-forward individuals \n",+ "- Versatile use for both everyday hydration and outdoor activities\n",+ "--------------------------------------------------------------------------------\n",+ "WriterAgent:\n",+ "🌍🌿 Stay Hydrated, Stay Sustainable! 🌿🌍 \n",+ "\n",+ "Introducing our eco-friendly stainless steel drinkware, the perfect companion for the environmentally conscious and style-savvy individuals. With superior insulation technology, our bottles keep your beverages cold for an impressive 24 hours—ideal for hiking, camping, or just tackling a busy day in the city. Made from lightweight, BPA-free materials, this durable and reusable design not only helps reduce plastic waste but also ensures you’re making a responsible choice for our planet.\n",+ "\n",+ "Available in a sleek, modern aesthetic with various colors to match your personality, this drinkware isn't just functional—it’s fashionable! Whether you’re hitting the trails or navigating urban life, equip yourself with a stylish hydration solution that supports your active and sustainable lifestyle. Join the movement today and make a positive impact without compromising on style! 🌟🥤\n",+ "--------------------------------------------------------------------------------\n",+ "FormatProofAgent:\n",+ "🌍🌿 Stay Hydrated, Stay Sustainable! 🌿🌍 \n",+ "\n",+ "Introducing our eco-friendly stainless steel drinkware—the perfect companion for environmentally conscious and style-savvy individuals. With superior insulation technology, our bottles keep your beverages cold for an impressive 24 hours, making them ideal for hiking, camping, or simply tackling a busy day in the city. Crafted from lightweight, BPA-free materials, this durable and reusable design not only helps reduce plastic waste but also ensures that you’re making a responsible choice for our planet.\n",+ "\n",+ "Our drinkware features a sleek, modern aesthetic available in a variety of colors to suit your personality. It’s not just functional; it’s also fashionable! Whether you’re exploring the trails or navigating urban life, equip yourself with a stylish hydration solution that supports your active and sustainable lifestyle. Join the movement today and make a positive impact without compromising on style! 🌟🥤\n",+ "\n",+ "--------------------------------------------------------------------------------\n",+ "User received final copy:\n",+ "🌍🌿 Stay Hydrated, Stay Sustainable! 🌿🌍 \n",+ "\n",+ "Introducing our eco-friendly stainless steel drinkware—the perfect companion for environmentally conscious and style-savvy individuals. With superior insulation technology, our bottles keep your beverages cold for an impressive 24 hours, making them ideal for hiking, camping, or simply tackling a busy day in the city. Crafted from lightweight, BPA-free materials, this durable and reusable design not only helps reduce plastic waste but also ensures that you’re making a responsible choice for our planet.\n",+ "\n",+ "Our drinkware features a sleek, modern aesthetic available in a variety of colors to suit your personality. It’s not just functional; it’s also fashionable! Whether you’re exploring the trails or navigating urban life, equip yourself with a stylish hydration solution that supports your active and sustainable lifestyle. Join the movement today and make a positive impact without compromising on style! 🌟🥤\n"+ ]+ }+ ],+ "source": [+ "runtime.start()\n",+ "\n",+ "await runtime.publish_message(\n",+ " Message(content=\"An eco-friendly stainless steel water bottle that keeps drinks cold for 24 hours\"),\n",+ " topic_id=TopicId(concept_extractor_topic_type, source=\"default\"),\n",+ ")\n",+ "\n",+ "await runtime.stop_when_idle()"+ ]+ }+ ],+ "metadata": {+ "kernelspec": {+ "display_name": ".venv",+ "language": "python",+ "name": "python3"+ },+ "language_info": {+ "codemirror_mode": {+ "name": "ipython",+ "version": 3+ },+ "file_extension": ".py",+ "mimetype": "text/x-python",+ "name": "python",+ "nbconvert_exporter": "python",+ "pygments_lexer": "ipython3",+ "version": "3.11.5"+ }+ },+ "nbformat": 4,+ "nbformat_minor": 2+}diff --git a/python/packages/autogen-core/docs/src/user-guide/core-user-guide/design-patterns/sequential-workflow.svg b/python/packages/autogen-core/docs/src/user-guide/core-user-guide/design-patterns/sequential-workflow.svgnew file mode 100644index 000000000..d68612ec3--- /dev/null+++ b/python/packages/autogen-core/docs/src/user-guide/core-user-guide/design-patterns/sequential-workflow.svg@@ -0,0 +1,3 @@+<?xml version="1.0" encoding="UTF-8"?>+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" version="1.1" width="746px" height="139px" viewBox="-0.5 -0.5 746 139" class="ge-export-svg-dark" style="background-color: rgb(0, 0, 0);"><defs><style type="text/css">svg.ge-export-svg-dark:not(mjx-container > svg) { filter: invert(100%) hue-rotate(180deg); }
svg.ge-export-svg-dark foreignObject img,
svg.ge-export-svg-dark image:not(svg.ge-export-svg-dark switch image),
svg.ge-export-svg-dark svg:not(mjx-container > svg)
{ filter: invert(100%) hue-rotate(180deg) }</style></defs><rect fill="#ffffff" width="100%" height="100%" x="0" y="0"/><g><g data-cell-id="0"><g data-cell-id="1"><g data-cell-id="sqq-OtPLxvXwgYRML6Fe-1"><g><rect x="0" y="77" width="120" height="60" rx="9" ry="9" fill="#dae8fc" stroke="#6c8ebf" pointer-events="all"/></g><g><g transform="translate(-0.5 -0.5)scale(0.9999999999999999)"><switch><foreignObject pointer-events="none" width="101%" height="101%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility" style="overflow: visible; text-align: left;"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 118px; height: 1px; padding-top: 107px; margin-left: 1px;"><div data-drawio-colors="color: rgb(0, 0, 0); " style="box-sizing: border-box; font-size: 0px; text-align: center;"><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;">Concept <span style="background-color: initial;">Extractor</span><div><span style="background-color: initial;">Agent</span></div></div></div></div></foreignObject><text x="60" y="111" fill="rgb(0, 0, 0)" font-family=""Helvetica"" font-size="12px" text-anchor="middle">Concept Extractor...</text></switch></g></g></g><g data-cell-id="sqq-OtPLxvXwgYRML6Fe-2"><g><rect x="213" y="77" width="120" height="60" rx="9" ry="9" fill="#dae8fc" stroke="#6c8ebf" pointer-events="all"/></g><g><g transform="translate(-0.5 -0.5)scale(0.9999999999999999)"><switch><foreignObject pointer-events="none" width="101%" height="101%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility" style="overflow: visible; text-align: left;"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 118px; height: 1px; padding-top: 107px; margin-left: 214px;"><div data-drawio-colors="color: rgb(0, 0, 0); " style="box-sizing: border-box; font-size: 0px; text-align: center;"><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;"><div>Writer Agent</div></div></div></div></foreignObject><text x="273" y="111" fill="rgb(0, 0, 0)" font-family=""Helvetica"" font-size="12px" text-anchor="middle">Writer Agent</text></switch></g></g></g><g data-cell-id="sqq-OtPLxvXwgYRML6Fe-3"><g><rect x="428" y="77" width="120" height="60" rx="9" ry="9" fill="#dae8fc" stroke="#6c8ebf" pointer-events="all"/></g><g><g transform="translate(-0.5 -0.5)scale(0.9999999999999999)"><switch><foreignObject pointer-events="none" width="101%" height="101%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility" style="overflow: visible; text-align: left;"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 118px; height: 1px; padding-top: 107px; margin-left: 429px;"><div data-drawio-colors="color: rgb(0, 0, 0); " style="box-sizing: border-box; font-size: 0px; text-align: center;"><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;"><div>Format <span style="background-color: initial;">Proof</span></div><div><span style="background-color: initial;">Agent</span></div></div></div></div></foreignObject><text x="488" y="111" fill="rgb(0, 0, 0)" font-family=""Helvetica"" font-size="12px" text-anchor="middle">Format Proof...</text></switch></g></g></g><g data-cell-id="sqq-OtPLxvXwgYRML6Fe-4"><g><rect x="624" y="77" width="120" height="60" rx="9" ry="9" fill="#dae8fc" stroke="#6c8ebf" pointer-events="all"/></g><g><g transform="translate(-0.5 -0.5)scale(0.9999999999999999)"><switch><foreignObject pointer-events="none" width="101%" height="101%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility" style="overflow: visible; text-align: left;"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 118px; height: 1px; padding-top: 107px; margin-left: 625px;"><div data-drawio-colors="color: rgb(0, 0, 0); " style="box-sizing: border-box; font-size: 0px; text-align: center;"><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;"><div>User Agent</div></div></div></div></foreignObject><text x="684" y="111" fill="rgb(0, 0, 0)" font-family=""Helvetica"" font-size="12px" text-anchor="middle">User Agent</text></switch></g></g></g><g data-cell-id="sqq-OtPLxvXwgYRML6Fe-5"><g><path d="M 120 106.75 L 206.63 106.75" fill="none" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="stroke"/><path d="M 211.88 106.75 L 204.88 110.25 L 206.63 106.75 L 204.88 103.25 Z" fill="rgb(0, 0, 0)" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="all"/></g><g data-cell-id="sqq-OtPLxvXwgYRML6Fe-11"><g><g transform="translate(-0.5 -0.5)scale(0.9999999999999999)"><switch><foreignObject pointer-events="none" width="101%" height="101%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility" style="overflow: visible; text-align: left;"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 1px; height: 1px; padding-top: 107px; margin-left: 163px;"><div data-drawio-colors="color: rgb(0, 0, 0); background-color: rgb(255, 255, 255); " style="box-sizing: border-box; font-size: 0px; text-align: center;"><div style="display: inline-block; font-size: 11px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; background-color: rgb(255, 255, 255); white-space: nowrap;">Product<div>Concepts</div></div></div></div></foreignObject><text x="163" y="111" fill="rgb(0, 0, 0)" font-family=""Helvetica"" font-size="11px" text-anchor="middle">Product...</text></switch></g></g></g></g><g data-cell-id="sqq-OtPLxvXwgYRML6Fe-6"><g><path d="M 333 107 L 421.63 107" fill="none" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="stroke"/><path d="M 426.88 107 L 419.88 110.5 L 421.63 107 L 419.88 103.5 Z" fill="rgb(0, 0, 0)" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="all"/></g><g data-cell-id="sqq-OtPLxvXwgYRML6Fe-13"><g><g transform="translate(-0.5 -0.5)scale(0.9999999999999999)"><switch><foreignObject pointer-events="none" width="101%" height="101%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility" style="overflow: visible; text-align: left;"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 1px; height: 1px; padding-top: 108px; margin-left: 382px;"><div data-drawio-colors="color: rgb(0, 0, 0); background-color: rgb(255, 255, 255); " style="box-sizing: border-box; font-size: 0px; text-align: center;"><div style="display: inline-block; font-size: 11px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; background-color: rgb(255, 255, 255); white-space: nowrap;">Marketing <div>Copy</div></div></div></div></foreignObject><text x="382" y="111" fill="rgb(0, 0, 0)" font-family=""Helvetica"" font-size="11px" text-anchor="middle">Marketing...</text></switch></g></g></g></g><g data-cell-id="sqq-OtPLxvXwgYRML6Fe-7"><g><path d="M 548 107 L 617.63 107" fill="none" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="stroke"/><path d="M 622.88 107 L 615.88 110.5 L 617.63 107 L 615.88 103.5 Z" fill="rgb(0, 0, 0)" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="all"/></g><g data-cell-id="sqq-OtPLxvXwgYRML6Fe-14"><g><g transform="translate(-0.5 -0.5)scale(0.9999999999999999)"><switch><foreignObject pointer-events="none" width="101%" height="101%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility" style="overflow: visible; text-align: left;"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 1px; height: 1px; padding-top: 108px; margin-left: 584px;"><div data-drawio-colors="color: rgb(0, 0, 0); background-color: rgb(255, 255, 255); " style="box-sizing: border-box; font-size: 0px; text-align: center;"><div style="display: inline-block; font-size: 11px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; background-color: rgb(255, 255, 255); white-space: nowrap;">Final <div>Copy</div></div></div></div></foreignObject><text x="584" y="111" fill="rgb(0, 0, 0)" font-family=""Helvetica"" font-size="11px" text-anchor="middle">Final...</text></switch></g></g></g></g><g data-cell-id="sqq-OtPLxvXwgYRML6Fe-9"><g><path d="M 60 7 L 60 70.63" fill="none" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="stroke"/><path d="M 60 75.88 L 56.5 68.88 L 60 70.63 L 63.5 68.88 Z" fill="rgb(0, 0, 0)" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="all"/></g><g data-cell-id="sqq-OtPLxvXwgYRML6Fe-15"><g><g transform="translate(-0.5 -0.5)scale(0.9999999999999999)"><switch><foreignObject pointer-events="none" width="101%" height="101%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility" style="overflow: visible; text-align: left;"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 1px; height: 1px; padding-top: 30px; margin-left: 58px;"><div data-drawio-colors="color: rgb(0, 0, 0); background-color: rgb(255, 255, 255); " style="box-sizing: border-box; font-size: 0px; text-align: center;"><div style="display: inline-block; font-size: 11px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; background-color: rgb(255, 255, 255); white-space: nowrap;">Product Description</div></div></div></foreignObject><text x="58" y="33" fill="rgb(0, 0, 0)" font-family=""Helvetica"" font-size="11px" text-anchor="middle">Product Description</text></switch></g></g></g></g></g></g></g></svg>\ No newline at end of file