autogen/notebook/agentchat_groupchat_finite_...

651 lines
297 KiB
Plaintext
Raw Permalink Normal View History

{
"cells": [
{
"attachments": {},
"cell_type": "markdown",
"metadata": {},
"source": [
"# FSM - User can input speaker transition constraints\n",
"\n",
"AutoGen offers conversable agents powered by LLM, tool, or human, which can be used to perform tasks collectively via automated chat. This framework allows tool use and human participation through multi-agent conversation.\n",
"Please find documentation about this feature [here](https://microsoft.github.io/autogen/docs/Use-Cases/agent_chat).\n",
"\n",
"This notebook is about using graphs to define the transition paths amongst speakers.\n",
"\n",
"Benefits\n",
"- This contribution fills the gap between the current modes of GroupChat Class (auto, manual, round_robin) and an expressive directed graph. See Motivation for more detailed discussion.\n",
"\n",
"\n",
"````{=mdx}\n",
":::info Requirements\n",
"Install `pyautogen`:\n",
"```bash\n",
"pip install pyautogen\n",
"```\n",
"\n",
"For more information, please refer to the [installation guide](/docs/installation/).\n",
":::\n",
"````"
]
},
{
"cell_type": "code",
"execution_count": 1,
"metadata": {},
"outputs": [],
"source": [
"%%capture --no-stderr\n",
"%pip install pyautogen[graph]>=0.2.11"
]
},
{
"cell_type": "code",
"execution_count": 2,
"metadata": {},
"outputs": [],
"source": [
"import random # noqa E402\n",
"\n",
"import matplotlib.pyplot as plt # noqa E402\n",
"import networkx as nx # noqa E402\n",
"\n",
"import autogen # noqa E402\n",
"from autogen.agentchat.conversable_agent import ConversableAgent # noqa E402\n",
"from autogen.agentchat.assistant_agent import AssistantAgent # noqa E402\n",
"from autogen.agentchat.groupchat import GroupChat # noqa E402\n",
"from autogen.graph_utils import visualize_speaker_transitions_dict # noqa E402"
]
},
{
"cell_type": "code",
"execution_count": 3,
"metadata": {},
"outputs": [
{
"name": "stdout",
"output_type": "stream",
"text": [
"0.2.25\n"
]
}
],
"source": [
"print(autogen.__version__)"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"## Motivation\n",
"\n",
"\n",
"The current GroupChat class allows transitioning to any agent (with or without the decision of the LLM), some use cases might demand for more control over transition. A graph is a possible way to control the transition paths, where each node represents an agent and each directed edge represents possible transition paths. Let's illustrate the current transition paths for a GroupChat with five agents."
]
},
{
"cell_type": "code",
"execution_count": 5,
"metadata": {},
"outputs": [],
"source": [
"config_list_gpt4 = {\n",
" \"timeout\": 600,\n",
" \"cache_seed\": 44, # change the seed for different trials\n",
" \"config_list\": autogen.config_list_from_json(\n",
" \"OAI_CONFIG_LIST\",\n",
" filter_dict={\"tags\": [\"gpt-4\", \"gpt-4-32k\"]}, # comment out to get all\n",
" ),\n",
" \"temperature\": 0,\n",
"}"
]
},
{
"cell_type": "code",
"execution_count": 6,
"metadata": {},
"outputs": [
{
"data": {
"image/png": "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
"text/plain": [
"<Figure size 640x480 with 1 Axes>"
]
},
"metadata": {},
"output_type": "display_data"
}
],
"source": [
"agents = [ConversableAgent(name=f\"Agent{i}\", llm_config=False) for i in range(5)]\n",
"allowed_speaker_transitions_dict = {agent: [other_agent for other_agent in agents] for agent in agents}\n",
"\n",
"visualize_speaker_transitions_dict(allowed_speaker_transitions_dict, agents)"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"### Possibly interesting transition paths\n",
"1. Hub and Spoke\n",
"2. Sequential Team Operations\n",
"3. Think aloud and debate"
]
},
{
"cell_type": "code",
"execution_count": 7,
"metadata": {},
"outputs": [
{
"data": {
"image/png": "iVBORw0KGgoAAAANSUhEUgAAApQAAAHzCAYAAACe1o1DAAAAOXRFWHRTb2Z0d2FyZQBNYXRwbG90bGliIHZlcnNpb24zLjguMywgaHR0cHM6Ly9tYXRwbG90bGliLm9yZy/H5lhTAAAACXBIWXMAAA9hAAAPYQGoP6dpAABmHUlEQVR4nO3deVhVdeLH8TcXRHYNAcUFFfet1NyzRcUlR80Ux9zTpsmsMUubFFNBDW1atF9NM7abqWhmalqpmRaZOW4omvsCuLDLIshyl98f1k3SSgM5F/i8nseny7nnnPuBJ7if+/2exclms9kQEREREfmTTEYHEBEREZGyTYVSRERERIpFhVJEREREikWFUkRERESKRYVSRERERIpFhVJEREREikWFUkRERESKRYVSRERERIpFhVJEREREikWFUkRERESKRYVSRERERIpFhVJEREREikWFUkRERESKRYVSRERERIpFhVJEREREikWFUkRERESKRYVSRERERIpFhVJEREREikWFUkRERESKRYVSRERERIpFhVJEREREikWFUkRERESKRYVSRERERIpFhVJEREREikWFUkRERESKRYVSRERERIpFhVJEREREikWFUkRERESKRYVSRERERIpFhVJEREREikWFUkRERESKRYVSRERERIpFhVJEREREikWFUkRERESKRYVSRERERIpFhVJEREREikWFUkRERESKxcXoACIiImVJTr6ZM2k5FJituLqYqFfNE8/KejuVik2/ASIiIn/geFI2S3fGs/VoMvHpudiues4JCPL1oFuTAEZ0DKJRdW+jYooYxslms9n+eDUREZGKJyE9l7BPY4k+kYqzyQmL9bffMn9+/u6GfkQ+2Io6vh6lmFTEWCqUIiIi1xG1K55Z6w5http+t0j+mrPJCReTExEDWvBQ+6BbmFDEcahQioiI/MobW4/z8qZjxd7PlF6NebJboxJIJOLYdJa3iIjIVaJ2xZdImQR4edMxVuyKL5F9iTgyFUoRESnzxo8fj5OTk/3f/Pnz/9R+EtJzmbXuUIlmm7nuEAnpuUWWxcTEEB4eTnh4ONu2bfvd7QsLC7njjjuKfH95eXklmlGkuFQoRUSkTCssLGTVqlVFlkVFRf2pfYV9Gov5Jo6XvBFmq42wT2OLLIuJiSEiIoKIiIg/LJT/+te/OHDgQIlmEilpKpQiIlKmbd68mbS0tCLL9u/fz5EjR25qP8eTsok+kXpTJ+DcCIvVRvSJVE4kZ9/0tkePHmXOnDm4ubmVaCaRkqZCKSIiZdrVo5EPPfTQdZf/bNWqVbRs2RI3NzdatmzJypUrCQ8Px8nJicY1fMg9+FWR9QuST5Oy9l+cfX0Ucf8ayNk3RpP2+f9hzkotsl5G9FLi5vcjbn4/Lh3YTNautZz776PEvTSQ8+8+SUH8AT764cqxlPXq1WPs2LH2bSMiIuxT2eHh4fblNpuNRx99lPz8fGbOnFmsn5HIraZCKSIiZVZeXh5r1qwBwN/fn4ULF+LicuWeHb8ulKtXr+avf/0rhw4dIj8/n0OHDjF06FD79gBW6y/rXz65mwuLnyH38LdYci6C1YzlUjqXDmwicfHTFGYkXjdT5vcruLjlbcwZF8BipjDlDImr5rAp5uRNfW+LFi0iOjqaO+64g2efffamthUpbSqUIiJSZq1fv57s7CtTyQMHDqR69ercd999wJXp4n379gFgsViYNGkSP18pb8iQIWzYsIGJEyeyf//+a/ZrLcwjdcMCsBSCyZmq94wmYOgcfDoOvrK/nIukb/rPdTOZMxLx6RSK/+AZVAqoD4Ct4DJHv/uCnHwzq1atIiwszL7+2LFjiY6OJjo6mnHjxgFw7tw5nnvuOZydnXn33XftJVnEUalQiohImXX1KGRoaGiR/179/J49e0hISACgRo0aLF26lL59+/Laa6/RqVOna/abd3of1txMANzqtaZynRY4ubji3rADzlWqX1nn1F4sP61zNfdGnbjtvofxaNSRKp2H2JcXXrzAmbQc2rVrR6NGv1ybMigoiK5du9K1a1eCgq5cCH3ChAlkZWXxzDPPcOedd/65H45IKVKhFBGRMik7O5sNGzYA4OvrS/fu3QEYNGgQzs7OAKxYsQKbzcapU6fs27Vt25ZKlSrZv+7cufM1+y5MP2d/nHdqD0lLn7P/s2Qm/fSMjcK0s9ds61anpf2xyd3H/tian0OB2XrN+r+2adMm1q1bR4MGDYiIiPjD9UUcgQqliIiUSWvWrLFfjzE9PZ1KlSrh5OREQEAAFosFgLi4OHbs2FFkOycnpxLLYCu89nqQJjevq17rqrdZmw1Xlz9+2z1//jwAJ0+exMPDw37CztXc3d0ZOHDgnwstcgvooAwRESmTli9ffkPrRUVFMWrUKPvX+/btw2Kx2Ecxf104ASr51rI/9mzZA79+T1+zjrUwD1Olm7ucT71qngCYTL8US6v1j0ctRRydCqWIiJQ5aWlpbN68GQBvb28iIyOLPF9QUMDkyZMB+Pjjj1mwYAF16tQhISGB8+fPM3r0aEaMGMHGjRv54Ycfrtm/W702mDyqYM3NJOfg15jcvXCv1wabzYo5M4n8s4cpTD5NzUevf2LO9XhVdsGz8pW33dtuu82+/Msvv+See+7Bzc2NVq1a0aFDBxYsWHDN9k8//Uupfemll2jSpMkNv7bIreZk+/mUNxERkTJi0aJFjB8/HoDBgwdfc6ccgDZt2hATEwPAV199RWZmJqGhofz6ba9Vq1bExl65k41/v0l4tAwB4PLJXSSvjrxypvd1OPsEUHvCe8CV61Bmbr8yYlqt7yS8br+yj7y4AyQtv3JG9x3dHyBmyxoAUlNTqV27Nvn5+UX2uXXrVvtZ6r929bT35cuXdbFzcSg6hlJERMqcq6e7BwwYcN11+vfvb38cFRXFoEGDWLlyJc2bN8fV1ZVmzZqxbNkyevToYV/P5lzZ/ti9QXsCH16AZ4tuOHv7gckFk7sPlQKC8W4/EP8Hp95U5mB/T/tjPz8/1qxZQ5s2bXB3d7+p/Yg4Io1QiohIhWCz2a57Qk6nTp3YuXMnAH1nLuaI2a9Eb7/obHKiS3A1ljzSscT2KeJoNEIpIiIVQnR0NMOGDWPjxo3ExcWxf/9+nnjiCXuZbNKkCW/+YxAuppI7CxzAxeRE5IOtSnSfIo5GI5QiIlIhbNu2jW7dul33OW9vbzZt2kSnTp2I2hXP1NWxJfa6Lw5qxdD2QSW2PxFHpBFKERGpEIKDgxk5ciQNGjTAw8ODypUr07BhQx5//HH2799vv2POQ+2DmNKrMcA1J/DcrGd7NVGZlApBI5QiIiK/Eh0dTf9J86nS/W+4uLpiuYlLRTqbnHAxOTF7QAuVSakwNEIpIiLyk/j4eIYNG8Y999xD5t7P6XzxK7oE+wFXiuLv+fn5LsHV+Orpe1UmpULRCKWIiFR4WVlZzJs3j1dffRWz2Wy/e81XX31Fjx49OJ6UzdKd8Ww9lkx8Wi5Xv3E6AUHVPOjWOICRnYJoGOBtyPcgYiQVShERqdBOnz5Nu3btyMjIuOY2iKdOnaJ+/fpFluXkmzmTlkOB2Yqri4l61Tztd8ARqaj0GyAiIhWat7c3AQEBXLx4schyZ2dn6tSpc836npVdaFGzSmnFEykTdAyliIhUaH5+fsTExNC7d+8iy2vWrImLi8ZdRG6ECqWIiFR42dnZbNmyBTc3N4KCrpxM06RJE4NTiZQd+uglIiIVXs+ePSksLGTNmjXce++9REZGcueddxodS6TM0Ek5IiJSoS1YsIBnnnmGBx54gDVr1hgdR6RMUqEUEZEK6/z58wQFBeHl5UVqaqqOmRT5k3QMpYiIVFg9evTAYrGwbt06lUmRYlChFBGRCmn27NkcOXKEESNGcM899xgdR6RM05S3iIhUOCdPnqRx48bcdtttJCcnYzJpfEWkOPQbJCIiFU5ISAg2m40vv/xSZVKkBOi3SEREKpRnn32WM2fO8Nhjj9GuXTuj44iUC5ryFhGRCuPgwYPcfvvt1KhRg7Nnz2p0UqSE6DdJREQqBKvVSq9evQDYvHm
"text/plain": [
"<Figure size 640x480 with 1 Axes>"
]
},
"metadata": {},
"output_type": "display_data"
}
],
"source": [
"agents = [ConversableAgent(name=f\"Agent{i}\", llm_config=False) for i in range(5)]\n",
"allowed_speaker_transitions_dict = {\n",
" agents[0]: [agents[1], agents[2], agents[3], agents[4]],\n",
" agents[1]: [agents[0]],\n",
" agents[2]: [agents[0]],\n",
" agents[3]: [agents[0]],\n",
" agents[4]: [agents[0]],\n",
"}\n",
"\n",
"visualize_speaker_transitions_dict(allowed_speaker_transitions_dict, agents)"
]
},
{
"cell_type": "code",
"execution_count": 8,
"metadata": {},
"outputs": [
{
"name": "stdout",
"output_type": "stream",
"text": [
"<autogen.agentchat.conversable_agent.ConversableAgent object at 0x7f605e116260>\n"
]
},
{
"data": {
"image/png": "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
"text/plain": [
"<Figure size 640x480 with 1 Axes>"
]
},
"metadata": {},
"output_type": "display_data"
}
],
"source": [
"# Sequential Team Operations\n",
"# Create an empty directed graph\n",
"\n",
"speaker_transitions_dict = {}\n",
"teams = [\"A\", \"B\", \"C\"]\n",
"team_size = 5\n",
"\n",
"\n",
"def get_agent_of_name(agents, name) -> ConversableAgent:\n",
" for agent in agents:\n",
" if agent.name == name:\n",
" return agent\n",
"\n",
"\n",
"# Create a list of 15 agents 3 teams x 5 agents\n",
"agents = [ConversableAgent(name=f\"{team}{i}\", llm_config=False) for team in teams for i in range(team_size)]\n",
"\n",
"# Loop through each team and add members and their connections\n",
"for team in teams:\n",
" for i in range(team_size):\n",
" member = f\"{team}{i}\"\n",
" # Connect each member to other members of the same team\n",
" speaker_transitions_dict[get_agent_of_name(agents, member)] = [\n",
" get_agent_of_name(agents, name=f\"{team}{j}\") for j in range(team_size) if j != i\n",
" ]\n",
"\n",
"# Team leaders connection\n",
"print(get_agent_of_name(agents, name=\"B0\"))\n",
"speaker_transitions_dict[get_agent_of_name(agents, \"A0\")].append(get_agent_of_name(agents, name=\"B0\"))\n",
"speaker_transitions_dict[get_agent_of_name(agents, \"B0\")].append(get_agent_of_name(agents, name=\"C0\"))\n",
"\n",
"visualize_speaker_transitions_dict(speaker_transitions_dict, agents)"
]
},
{
"cell_type": "code",
"execution_count": 9,
"metadata": {},
"outputs": [
{
"data": {
"image/png": "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
"text/plain": [
"<Figure size 640x480 with 1 Axes>"
]
},
"metadata": {},
"output_type": "display_data"
}
],
"source": [
"agents = [ConversableAgent(name=f\"Agent{i}\", llm_config=False) for i in range(2)]\n",
"allowed_speaker_transitions_dict = {\n",
" agents[0]: [agents[0], agents[1]],\n",
" agents[1]: [agents[0], agents[1]],\n",
"}\n",
"\n",
"visualize_speaker_transitions_dict(allowed_speaker_transitions_dict, agents)"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"## Demonstration"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"`GroupChat` now takes in two optional arguments.\n",
"- allowed_or_disallowed_speaker_transitions: The keys are source agents, and the values are agents that the key agent can/can't transit to, depending on speaker_transitions_type. Default is None, which means all agents can transit to all other agents.\n",
"- speaker_transitions_type: whether the speaker_transitions_type is a dictionary containing lists of allowed agents or disallowed agents. \"allowed\" means the `allowed_or_disallowed_speaker_transitions` is a dictionary containing lists of allowed agents."
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"### Team Operations\n"
]
},
{
"cell_type": "code",
"execution_count": 10,
"metadata": {},
"outputs": [
{
"data": {
"image/png": "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
"text/plain": [
"<Figure size 1200x1000 with 1 Axes>"
]
},
"metadata": {},
"output_type": "display_data"
}
],
"source": [
"# Create an empty directed graph\n",
"agents = []\n",
"speaker_transitions_dict = {}\n",
"secret_values = {}\n",
"\n",
"# Outer loop for prefixes 'A', 'B', 'C'\n",
"for prefix in [\"A\", \"B\", \"C\"]:\n",
" # Add 3 nodes with each prefix to the graph using a for loop\n",
" for i in range(3):\n",
" node_id = f\"{prefix}{i}\"\n",
" secret_value = random.randint(1, 5) # Generate a random secret value\n",
" secret_values[node_id] = secret_value\n",
"\n",
" # Create an AssistantAgent for each node (assuming AssistantAgent is a defined class)\n",
" agents.append(\n",
" AssistantAgent(\n",
" name=node_id,\n",
" system_message=f\"\"\"Your name is {node_id}.\n",
" Do not respond as the speaker named in the NEXT tag if your name is not in the NEXT tag. Instead, suggest a relevant team leader to handle the mis-tag, with the NEXT: tag.\n",
"\n",
" You have {secret_value} chocolates.\n",
"\n",
" The list of players are [A0, A1, A2, B0, B1, B2, C0, C1, C2].\n",
"\n",
" Your first character of your name is your team, and your second character denotes that you are a team leader if it is 0.\n",
" CONSTRAINTS: Team members can only talk within the team, whilst team leader can talk to team leaders of other teams but not team members of other teams.\n",
"\n",
" You can use NEXT: to suggest the next speaker. You have to respect the CONSTRAINTS, and can only suggest one player from the list of players, i.e., do not suggest A3 because A3 is not from the list of players.\n",
" Team leaders must make sure that they know the sum of the individual chocolate count of all three players in their own team, i.e., A0 is responsible for team A only.\n",
"\n",
" Keep track of the player's tally using a JSON format so that others can check the total tally. Use\n",
" A0:?, A1:?, A2:?,\n",
" B0:?, B1:?, B2:?,\n",
" C0:?, C1:?, C2:?\n",
"\n",
" If you are the team leader, you should aggregate your team's total chocolate count to cooperate.\n",
" Once the team leader know their team's tally, they can suggest another team leader for them to find their team tally, because we need all three team tallys to succeed.\n",
" Use NEXT: to suggest the next speaker, e.g., NEXT: A0.\n",
"\n",
" Once we have the total tally from all nine players, sum up all three teams' tally, then terminate the discussion using TERMINATE.\n",
"\n",
" \"\"\",\n",
" llm_config=config_list_gpt4,\n",
" )\n",
" )\n",
" speaker_transitions_dict[agents[-1]] = []\n",
"\n",
" # Add edges between nodes with the same prefix using a nested for loop\n",
" for source_node in range(3):\n",
" source_id = f\"{prefix}{source_node}\"\n",
" for target_node in range(3):\n",
" target_id = f\"{prefix}{target_node}\"\n",
" if source_node != target_node: # To avoid self-loops\n",
" speaker_transitions_dict[get_agent_of_name(agents, source_id)].append(\n",
" get_agent_of_name(agents, name=target_id)\n",
" )\n",
"\n",
"\n",
"# Adding edges between teams\n",
"speaker_transitions_dict[get_agent_of_name(agents, \"A0\")].append(get_agent_of_name(agents, name=\"B0\"))\n",
"speaker_transitions_dict[get_agent_of_name(agents, \"A0\")].append(get_agent_of_name(agents, name=\"C0\"))\n",
"speaker_transitions_dict[get_agent_of_name(agents, \"B0\")].append(get_agent_of_name(agents, name=\"A0\"))\n",
"speaker_transitions_dict[get_agent_of_name(agents, \"B0\")].append(get_agent_of_name(agents, name=\"C0\"))\n",
"speaker_transitions_dict[get_agent_of_name(agents, \"C0\")].append(get_agent_of_name(agents, name=\"A0\"))\n",
"speaker_transitions_dict[get_agent_of_name(agents, \"C0\")].append(get_agent_of_name(agents, name=\"B0\"))\n",
"\n",
"\n",
"# Visualization only\n",
"graph = nx.DiGraph()\n",
"\n",
"# Add nodes\n",
"graph.add_nodes_from([agent.name for agent in agents])\n",
"\n",
"# Add edges\n",
"for key, value in speaker_transitions_dict.items():\n",
" for agent in value:\n",
" graph.add_edge(key.name, agent.name)\n",
"\n",
"# Visualize\n",
"# Draw the graph with secret values annotated\n",
"plt.figure(figsize=(12, 10))\n",
"pos = nx.spring_layout(graph) # positions for all nodes\n",
"\n",
"# Draw nodes with their colors\n",
"nx.draw(graph, pos, with_labels=True, font_weight=\"bold\")\n",
"\n",
"# Annotate secret values\n",
"for node, (x, y) in pos.items():\n",
" secret_value = secret_values[node]\n",
" plt.text(x, y + 0.1, s=f\"Secret: {secret_value}\", horizontalalignment=\"center\")\n",
"\n",
"plt.show()"
]
},
{
"cell_type": "code",
"execution_count": 11,
"metadata": {},
"outputs": [],
"source": [
"# Termination message detection\n",
"\n",
"\n",
"def is_termination_msg(content) -> bool:\n",
" have_content = content.get(\"content\", None) is not None\n",
" if have_content and \"TERMINATE\" in content[\"content\"]:\n",
" return True\n",
" return False\n",
"\n",
"\n",
"# Terminates the conversation when TERMINATE is detected.\n",
"user_proxy = autogen.UserProxyAgent(\n",
" name=\"User_proxy\",\n",
" system_message=\"Terminator admin.\",\n",
" code_execution_config=False,\n",
" is_termination_msg=is_termination_msg,\n",
" human_input_mode=\"NEVER\",\n",
")\n",
"\n",
"agents.append(user_proxy)"
]
},
{
"cell_type": "code",
"execution_count": 12,
"metadata": {},
"outputs": [
{
"name": "stderr",
"output_type": "stream",
"text": [
"WARNING:root:Warning: There are isolated agent nodes, there are not incoming nor outgoing edges. Isolated agents: ['User_proxy']\n",
"WARNING:root:Warning: The set of agents in allowed_speaker_transitions do not match agents. Offending agents: ['User_proxy']\n"
]
},
{
"name": "stdout",
"output_type": "stream",
"text": [
"\u001b[33mA0\u001b[0m (to chat_manager):\n",
"\n",
"\n",
" There are 9 players in this game, split equally into Teams A, B, C. Therefore each team has 3 players, including the team leader.\n",
" The task is to find out the sum of chocolate count from all nine players. I will now start with my team.\n",
" NEXT: A1\n",
"\n",
"--------------------------------------------------------------------------------\n",
"\u001b[33mA1\u001b[0m (to chat_manager):\n",
"\n",
"As the team leader of Team A, it's my responsibility to gather the chocolate count from my team members. I have 1 chocolate. \n",
"\n",
"A0:?, A1:1, A2:?,\n",
"\n",
"B0:?, B1:?, B2:?,\n",
"\n",
"C0:?, C1:?, C2:?\n",
"\n",
"NEXT: A2\n",
"\n",
"--------------------------------------------------------------------------------\n",
"\u001b[33mA2\u001b[0m (to chat_manager):\n",
"\n",
"I have 5 chocolates.\n",
"\n",
"A0:?, A1:1, A2:5,\n",
"\n",
"B0:?, B1:?, B2:?,\n",
"\n",
"C0:?, C1:?, C2:?\n",
"\n",
"NEXT: A0\n",
"\n",
"--------------------------------------------------------------------------------\n",
"\u001b[33mA0\u001b[0m (to chat_manager):\n",
"\n",
"I have 1 chocolate. Now that I have the counts from A1 and A2, I can calculate our team's total.\n",
"\n",
"A0:1, A1:1, A2:5,\n",
"\n",
"B0:?, B1:?, B2:?,\n",
"\n",
"C0:?, C1:?, C2:?\n",
"\n",
"Team A's total tally is 7 chocolates. It's time to find out the tally from another team. I'll pass this to the next team leader.\n",
"\n",
"NEXT: B0\n",
"\n",
"--------------------------------------------------------------------------------\n",
"\u001b[33mB0\u001b[0m (to chat_manager):\n",
"\n",
"As the team leader of Team B, it's my responsibility to gather the chocolate count from my team members. I have 1 chocolate.\n",
"\n",
"A0:1, A1:1, A2:5,\n",
"\n",
"B0:1, B1:?, B2:?,\n",
"\n",
"C0:?, C1:?, C2:?\n",
"\n",
"Now, I need to find out the chocolate counts from B1 and B2.\n",
"\n",
"NEXT: B1\n",
"\n",
"--------------------------------------------------------------------------------\n",
"\u001b[33mB1\u001b[0m (to chat_manager):\n",
"\n",
"I have 3 chocolates.\n",
"\n",
"A0:1, A1:1, A2:5,\n",
"\n",
"B0:1, B1:3, B2:?,\n",
"\n",
"C0:?, C1:?, C2:?\n",
"\n",
"NEXT: B2\n",
"\n",
"--------------------------------------------------------------------------------\n",
"\u001b[33mB2\u001b[0m (to chat_manager):\n",
"\n",
"I have 4 chocolates. Now that I have the counts from B0 and B1, I can calculate our team's total.\n",
"\n",
"A0:1, A1:1, A2:5,\n",
"\n",
"B0:1, B1:3, B2:4,\n",
"\n",
"C0:?, C1:?, C2:?\n",
"\n",
"Team B's total tally is 8 chocolates. It's time to find out the tally from the last team. I'll pass this to the next team leader.\n",
"\n",
"NEXT: C0\n",
"\n",
"--------------------------------------------------------------------------------\n",
"\u001b[33mB0\u001b[0m (to chat_manager):\n",
"\n",
"I'm sorry for any confusion, but it seems there's been a misunderstanding in the flow of communication. As B0, I should be the one to summarize the tally for Team B and pass the conversation to the next team leader. Let me correct that.\n",
"\n",
"A0:1, A1:1, A2:5,\n",
"\n",
"B0:1, B1:3, B2:4,\n",
"\n",
"C0:?, C1:?, C2:?\n",
"\n",
"With the counts from B1 and B2, Team B's total tally is indeed 8 chocolates. Now, it's time to find out the tally from Team C. I'll pass this to the next team leader.\n",
"\n",
"NEXT: C0\n",
"\n",
"--------------------------------------------------------------------------------\n",
"\u001b[33mC0\u001b[0m (to chat_manager):\n",
"\n",
"As the team leader of Team C, it's my responsibility to gather the chocolate count from my team members. I have 3 chocolates.\n",
"\n",
"A0:1, A1:1, A2:5,\n",
"\n",
"B0:1, B1:3, B2:4,\n",
"\n",
"C0:3, C1:?, C2:?\n",
"\n",
"Now, I need to find out the chocolate counts from C1 and C2.\n",
"\n",
"NEXT: C1\n",
"\n",
"--------------------------------------------------------------------------------\n",
"\u001b[33mC1\u001b[0m (to chat_manager):\n",
"\n",
"I have 3 chocolates.\n",
"\n",
"A0:1, A1:1, A2:5,\n",
"\n",
"B0:1, B1:3, B2:4,\n",
"\n",
"C0:3, C1:3, C2:?\n",
"\n",
"NEXT: C2\n",
"\n",
"--------------------------------------------------------------------------------\n",
"\u001b[33mC2\u001b[0m (to chat_manager):\n",
"\n",
"I have 2 chocolates. Now that I have the counts from C0 and C1, I can calculate our team's total.\n",
"\n",
"A0:1, A1:1, A2:5,\n",
"\n",
"B0:1, B1:3, B2:4,\n",
"\n",
"C0:3, C1:3, C2:2\n",
"\n",
"Team C's total tally is 8 chocolates. Now that we have the tallies from all teams, we can sum them up.\n",
"\n",
"Team A's total is 7 chocolates, Team B's total is 8 chocolates, and Team C's total is 8 chocolates. The grand total is 23 chocolates.\n",
"\n",
"TERMINATE\n",
"\n",
"--------------------------------------------------------------------------------\n"
]
},
{
"data": {
"text/plain": [
"ChatResult(chat_id=None, chat_history=[{'content': '\\n There are 9 players in this game, split equally into Teams A, B, C. Therefore each team has 3 players, including the team leader.\\n The task is to find out the sum of chocolate count from all nine players. I will now start with my team.\\n NEXT: A1', 'role': 'assistant'}, {'content': \"As the team leader of Team A, it's my responsibility to gather the chocolate count from my team members. I have 1 chocolate. \\n\\nA0:?, A1:1, A2:?,\\n\\nB0:?, B1:?, B2:?,\\n\\nC0:?, C1:?, C2:?\\n\\nNEXT: A2\", 'name': 'A1', 'role': 'user'}, {'content': 'I have 5 chocolates.\\n\\nA0:?, A1:1, A2:5,\\n\\nB0:?, B1:?, B2:?,\\n\\nC0:?, C1:?, C2:?\\n\\nNEXT: A0', 'name': 'A2', 'role': 'user'}, {'content': \"I have 1 chocolate. Now that I have the counts from A1 and A2, I can calculate our team's total.\\n\\nA0:1, A1:1, A2:5,\\n\\nB0:?, B1:?, B2:?,\\n\\nC0:?, C1:?, C2:?\\n\\nTeam A's total tally is 7 chocolates. It's time to find out the tally from another team. I'll pass this to the next team leader.\\n\\nNEXT: B0\", 'role': 'assistant'}, {'content': \"As the team leader of Team B, it's my responsibility to gather the chocolate count from my team members. I have 1 chocolate.\\n\\nA0:1, A1:1, A2:5,\\n\\nB0:1, B1:?, B2:?,\\n\\nC0:?, C1:?, C2:?\\n\\nNow, I need to find out the chocolate counts from B1 and B2.\\n\\nNEXT: B1\", 'name': 'B0', 'role': 'user'}, {'content': 'I have 3 chocolates.\\n\\nA0:1, A1:1, A2:5,\\n\\nB0:1, B1:3, B2:?,\\n\\nC0:?, C1:?, C2:?\\n\\nNEXT: B2', 'name': 'B1', 'role': 'user'}, {'content': \"I have 4 chocolates. Now that I have the counts from B0 and B1, I can calculate our team's total.\\n\\nA0:1, A1:1, A2:5,\\n\\nB0:1, B1:3, B2:4,\\n\\nC0:?, C1:?, C2:?\\n\\nTeam B's total tally is 8 chocolates. It's time to find out the tally from the last team. I'll pass this to the next team leader.\\n\\nNEXT: C0\", 'name': 'B2', 'role': 'user'}, {'content': \"I'm sorry for any confusion, but it seems there's been a misunderstanding in the flow of communication. As B0, I should be the one to summarize the tally for Team B and pass the conversation to the next team leader. Let me correct that.\\n\\nA0:1, A1:1, A2:5,\\n\\nB0:1, B1:3, B2:4,\\n\\nC0:?, C1:?, C2:?\\n\\nWith the counts from B1 and B2, Team B's total tally is indeed 8 chocolates. Now, it's time to find out the tally from Team C. I'll pass this to the next team leader.\\n\\nNEXT: C0\", 'name': 'B0', 'role': 'user'}, {'content': \"As the team leader of Team C, it's my responsibility to gather the chocolate count from my team members. I have 3 chocolates.\\n\\nA0:1, A1:1, A2:5,\\n\\nB0:1, B1:3, B2:4,\\n\\nC0:3, C1:?, C2:?\\n\\nNow, I need to find out the chocolate counts from C1 and C2.\\n\\nNEXT: C1\", 'name': 'C0', 'role': 'user'}, {'content': 'I have 3 chocolates.\\n\\nA0:1, A1:1, A2:5,\\n\\nB0:1, B1:3, B2:4,\\n\\nC0:3, C1:3, C2:?\\n\\nNEXT: C2', 'name': 'C1', 'role': 'user'}, {'content': \"I have 2 chocolates. Now that I have the counts from C0 and C1, I can calculate our team's total.\\n\\nA0:1, A1:1, A2:5,\\n\\nB0:1, B1:3, B2:4,\\n\\nC0:3, C1:3, C2:2\\n\\nTeam C's total tally is 8 chocolates. Now that we have the tallies from all teams, we can sum them up.\\n\\nTeam A's total is 7 chocolates, Team B's total is 8 chocolates, and Team C's total is 8 chocolates. The grand total is 23 chocolates.\\n\\nTERMINATE\", 'name': 'C2', 'role': 'user'}], summary=\"I have 2 chocolates. Now that I have the counts from C0 and C1, I can calculate our team's total.\\n\\nA0:1, A1:1, A2:5,\\n\\nB0:1, B1:3, B2:4,\\n\\nC0:3, C1:3, C2:2\\n\\nTeam C's total tally is 8 chocolates. Now that we have the tallies from all teams, we can sum them up.\\n\\nTeam A's total is 7 chocolates, Team B's total is 8 chocolates, and Team C's total is 8 chocolates. The grand total is 23 chocolates.\\n\\n\", cost={'usage_including_cached_inference': {'total_cost': 0.5525399999999999, 'gpt-4': {'cost': 0.5525399999999999, 'prompt_tokens': 18174, 'completion_tokens': 122, 'total_tokens'
]
},
"execution_count": 12,
"metadata": {},
"output_type": "execute_result"
}
],
"source": [
"group_chat = GroupChat(\n",
" agents=agents,\n",
" messages=[],\n",
" max_round=20,\n",
" allowed_or_disallowed_speaker_transitions=speaker_transitions_dict,\n",
" speaker_transitions_type=\"allowed\",\n",
")\n",
"\n",
"\n",
"# Create the manager\n",
"manager = autogen.GroupChatManager(\n",
" groupchat=group_chat,\n",
" llm_config=config_list_gpt4,\n",
" code_execution_config=False,\n",
" is_termination_msg=is_termination_msg,\n",
")\n",
"\n",
"\n",
"# Initiates the chat with Alice\n",
"agents[0].initiate_chat(\n",
" manager,\n",
" message=\"\"\"\n",
" There are 9 players in this game, split equally into Teams A, B, C. Therefore each team has 3 players, including the team leader.\n",
" The task is to find out the sum of chocolate count from all nine players. I will now start with my team.\n",
" NEXT: A1\"\"\",\n",
")"
]
}
],
"metadata": {
"front_matter": {
"description": "Explore the demonstration of the Finite State Machine implementation, which allows the user to input speaker transition constraints.",
"tags": [
"orchestration"
]
},
"kernelspec": {
"display_name": "Python 3 (ipykernel)",
"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.10.13"
}
},
"nbformat": 4,
"nbformat_minor": 4
}