🐫 CAMEL: The first and the best multi-agent framework. Finding the Scaling Law of Agents. https://www.camel-ai.org
Python agentai-societiesartificial-intelligencecommunicative-aicooperative-aideep-learninglarge-language-modelsmulti-agent-systemsnatural-language-processing
Implement `babyagi_agent` and integrate it into multimodel role playing (#210)
Hongyi Chenaa1c912ad156
diff --git a/camel/agents/__init__.py b/camel/agents/__init__.pyindex bb30ced33..a857c7fae 100644--- a/camel/agents/__init__.py+++ b/camel/agents/__init__.py@@ -13,7 +13,12 @@# =========== Copyright 2023 @ CAMEL-AI.org. All Rights Reserved. ===========from .base import BaseAgentfrom .chat_agent import ChatAgent, ChatAgentResponse-from .task_agent import TaskPlannerAgent, TaskSpecifyAgent+from .task_agent import (+ TaskSpecifyAgent,+ TaskPlannerAgent,+ TaskCreationAgent,+ TaskPrioritizationAgent,+)from .critic_agent import CriticAgentfrom .tool_agents.base import BaseToolAgentfrom .tool_agents.hugging_face_tool_agent import HuggingFaceToolAgent@@ -25,6 +30,8 @@ __all__ = ['ChatAgentResponse','TaskSpecifyAgent','TaskPlannerAgent',+ 'TaskCreationAgent',+ 'TaskPrioritizationAgent','CriticAgent','BaseToolAgent','HuggingFaceToolAgent',diff --git a/camel/agents/task_agent.py b/camel/agents/task_agent.pyindex 804b43478..2e01fcff2 100644--- a/camel/agents/task_agent.py+++ b/camel/agents/task_agent.py@@ -11,13 +11,14 @@# See the License for the specific language governing permissions and# limitations under the License.# =========== Copyright 2023 @ CAMEL-AI.org. All Rights Reserved. ===========-from typing import Any, Dict, Optional, Union+from typing import Any, Dict, List, Optional, Unionfrom camel.agents import ChatAgentfrom camel.configs import ChatGPTConfigfrom camel.messages import BaseMessagefrom camel.prompts import PromptTemplateGenerator, TextPromptfrom camel.typing import ModelType, RoleType, TaskType+from camel.utils import get_task_listclass TaskSpecifyAgent(ChatAgent):@@ -29,15 +30,15 @@ class TaskSpecifyAgent(ChatAgent):task_specify_prompt (TextPrompt): The prompt for specifying the task.Args:- model (ModelType): The type of model to use for the agent.+ model (ModelType, optional): The type of model to use for the agent.(default: :obj:`ModelType.GPT_3_5_TURBO`)- task_type (TaskType): The type of task for which to generate a prompt.- (default: :obj:`TaskType.AI_SOCIETY`)- model_config (Any): The configuration for the model.+ task_type (TaskType, optional): The type of task for which to generate+ a prompt. (default: :obj:`TaskType.AI_SOCIETY`)+ model_config (Any, optional): The configuration for the model.(default: :obj:`None`)- task_specify_prompt (Optional[TextPrompt]): The prompt for specifying- the task. (default: :obj:`None`)- word_limit (int): The word limit for the task prompt.+ task_specify_prompt (Union[str, TextPrompt], optional): The prompt for+ specifying the task. (default: :obj:`None`)+ word_limit (int, optional): The word limit for the task prompt.(default: :obj:`50`)output_language (str, optional): The language to be output by theagent. (default: :obj:`None`)@@ -86,7 +87,7 @@ class TaskSpecifyAgent(ChatAgent):Args:task_prompt (Union[str, TextPrompt]): The original taskprompt.- meta_dict (Optional[Dict[str, Any]]): A dictionary containing+ meta_dict (Dict[str, Any], optional): A dictionary containingadditional information to include in the prompt.(default: :obj:`None`)@@ -94,19 +95,16 @@ class TaskSpecifyAgent(ChatAgent):TextPrompt: The specified task prompt."""self.reset()- self.task_specify_prompt = self.task_specify_prompt.format(- task=task_prompt)+ task_specify_prompt = self.task_specify_prompt.format(task=task_prompt)if meta_dict is not None:- self.task_specify_prompt = (self.task_specify_prompt.format(- **meta_dict))+ task_specify_prompt = task_specify_prompt.format(**meta_dict)- task_msg = BaseMessage.make_user_message(- role_name="Task Specifier", content=self.task_specify_prompt)+ task_msg = BaseMessage.make_user_message(role_name="Task Specifier",+ content=task_specify_prompt)specifier_response = self.step(task_msg)- if (specifier_response.msgs is None- or len(specifier_response.msgs) == 0):- raise RuntimeError("Task specification failed.")+ if len(specifier_response.msgs) == 0:+ raise RuntimeError("Got no specification message.")specified_task_msg = specifier_response.msgs[0]if specifier_response.terminated:@@ -124,9 +122,9 @@ class TaskPlannerAgent(ChatAgent):the task into subtasks.Args:- model (ModelType): The type of model to use for the agent.+ model (ModelType, optional: The type of model to use for the agent.(default: :obj:`ModelType.GPT_3_5_TURBO`)- model_config (Any): The configuration for the model.+ model_config (Any, optional): The configuration for the model.(default: :obj:`None`)output_language (str, optional): The language to be output by theagent. (default: :obj:`None`)@@ -135,13 +133,12 @@ class TaskPlannerAgent(ChatAgent):def __init__(self,model: Optional[ModelType] = None,- model_config: Any = None,+ model_config: Optional[Any] = None,output_language: Optional[str] = None,) -> None:self.task_planner_prompt = TextPrompt("Divide this task into subtasks: {task}. Be concise.")-system_message = BaseMessage(role_name="Task Planner",role_type=RoleType.ASSISTANT,@@ -167,17 +164,214 @@ class TaskPlannerAgent(ChatAgent):"""# TODO: Maybe include roles information.self.reset()- self.task_planner_prompt = self.task_planner_prompt.format(- task=task_prompt)+ task_planner_prompt = self.task_planner_prompt.format(task=task_prompt)++ task_msg = BaseMessage.make_user_message(role_name="Task Planner",+ content=task_planner_prompt)- task_msg = BaseMessage.make_user_message(- role_name="Task Planner", content=self.task_planner_prompt)task_response = self.step(task_msg)- if task_response.msgs is None:- raise RuntimeError("Got None Subtasks messages.")+ if len(task_response.msgs) == 0:+ raise RuntimeError("Got no task planning message.")if task_response.terminated:raise RuntimeError("Task planning failed.")sub_tasks_msg = task_response.msgs[0]return TextPrompt(sub_tasks_msg.content)+++class TaskCreationAgent(ChatAgent):+ r"""An agent that helps create new tasks based on the objective+ and last completed task. Compared to :obj:`TaskPlannerAgent`,+ it's still a task planner, but it has more context information+ like last task and incomplete task list. Modified from+ `BabyAGI <https://github.com/yoheinakajima/babyagi>`_.++ Attributes:+ task_creation_prompt (TextPrompt): A prompt for the agent to create+ new tasks.++ Args:+ objective (Union[str, TextPrompt]): The objective of the Agent to+ perform the task.+ model (ModelType, optional): The type of model to use for the agent.+ (default: :obj:`ModelType.GPT_3_5_TURBO`)+ model_config (Any, optional): The configuration for the model.+ (default: :obj:`None`)+ output_language (str, optional): The language to be output by the+ agent. (default: :obj:`None`)+ """++ def __init__(+ self,+ objective: Union[str, TextPrompt],+ model: Optional[ModelType] = None,+ model_config: Optional[Any] = None,+ output_language: Optional[str] = None,+ ) -> None:++ task_creation_prompt = TextPrompt(+ """Create new tasks with the following objective: {objective}.+The last completed task has the result:+{task_result}.+This result was based on this task: {task}.+Based on the result, return a list of tasks to be completed in order to meet \+the objective.++{unsolved_tasks}++Return one task per line in your response.+The result must be a numbered list in the format:++1. First task+2. Second task++The number of each entry must be followed by a period. Be concise.""")++ self.task_creation_prompt = task_creation_prompt.format(+ objective=objective)+ self.objective = objective++ system_message = BaseMessage(+ role_name="Task Creator",+ role_type=RoleType.ASSISTANT,+ meta_dict=None,+ content="You are a helpful task creator.",+ )++ super().__init__(system_message, model, model_config,+ output_language=output_language)++ def run(+ self,+ previous_task: Union[str, TextPrompt],+ task_result: Union[str, TextPrompt],+ task_list: Optional[List[str]] = None,+ ) -> List[str]:+ r"""Generate subtasks based on the previous task results and+ incomplete task list.++ Args:+ previous_task (Union[str, TextPrompt]): The last completed task to+ be used to create future plans.+ task_result (Union[str, TextPrompt]): The result of last completed+ task to be used to create future plans.+ task_list (List[str], optional): The incomplete task list+ which should not overlap with new created tasks.+ (default: :obj:`None`)+ Returns:+ List[str]: The new task list generated by the Agent.+ """+ self.reset()+ task_creation_prompt = self.task_creation_prompt.format(+ task=previous_task, task_result=task_result)+ if task_list is not None:+ unsolved = (+ f"These are unsolved tasks: {task_list}.\n"+ "These new tasks must not overlap with incomplete tasks.")++ task_creation_prompt = task_creation_prompt.format(+ unsolved_tasks=unsolved)+ else:+ task_creation_prompt = task_creation_prompt.format(+ unsolved_tasks="")++ task_msg = BaseMessage.make_user_message(role_name="Task Creator",+ content=task_creation_prompt)++ task_response = self.step(task_msg)++ if len(task_response.msgs) == 0:+ raise RuntimeError("Got no task creation message.")+ if task_response.terminated:+ raise RuntimeError("Task creation failed.")++ sub_tasks_msg = task_response.msgs[0]+ return get_task_list(sub_tasks_msg.content)+++class TaskPrioritizationAgent(ChatAgent):+ r"""An agent that helps re-prioritize the task list and+ returns numbered prioritized list. Modified from+ `BabyAGI <https://github.com/yoheinakajima/babyagi>`_.++ Attributes:+ task_prioritization_prompt (TextPrompt): A prompt for the agent to+ prioritize tasks.++ Args:+ objective (Union[str, TextPrompt]): The objective of the Agent to+ perform the task.+ model (ModelType, optional): The type of model to use for the agent.+ (default: :obj:`ModelType.GPT_3_5_TURBO`)+ model_config (Any, optional): The configuration for the model.+ (default: :obj:`None`)+ output_language (str, optional): The language to be output by the+ agent. (default: :obj:`None`)+ """++ def __init__(+ self,+ objective: Union[str, TextPrompt],+ model: Optional[ModelType] = None,+ model_config: Optional[Any] = None,+ output_language: Optional[str] = None,+ ) -> None:++ task_prioritization_prompt = TextPrompt(+ """Prioritize the following tasks : {task_list}.+Consider the ultimate objective of you: {objective}.+Tasks should be sorted from highest to lowest priority,+where higher-priority tasks are those that act as pre-requisites \+or are more essential for meeting the objective.+Return one task per line in your response. Do not remove any tasks.+The result must be a numbered list in the format:++1. First task+2. Second task++The entries must be consecutively numbered, starting with 1.+The number of each entry must be followed by a period.+Be concise.""")++ self.task_prioritization_prompt = task_prioritization_prompt.format(+ objective=objective)+ self.objective = objective++ system_message = BaseMessage(+ role_name="Task Prioritizer",+ role_type=RoleType.ASSISTANT,+ meta_dict=None,+ content="You are a helpful task prioritizer.",+ )++ super().__init__(system_message, model, model_config,+ output_language=output_language)++ def run(+ self,+ task_list: List[str],+ ) -> List[str]:+ r"""Prioritize the task list given the agent objective.++ Args:+ task_list (List[str]): The un-prioritized task list of agent.+ Returns:+ List[str]: The new prioritized task list generated by the Agent.+ """+ self.reset()+ task_prioritization_prompt = self.task_prioritization_prompt.format(+ task_list=task_list)++ task_msg = BaseMessage.make_user_message(+ role_name="Task Prioritizer", content=task_prioritization_prompt)++ task_response = self.step(task_msg)++ if len(task_response.msgs) == 0:+ raise RuntimeError("Got no task prioritization message.")+ if task_response.terminated:+ raise RuntimeError("Task prioritization failed.")++ sub_tasks_msg = task_response.msgs[0]+ return get_task_list(sub_tasks_msg.content)diff --git a/camel/utils/__init__.py b/camel/utils/__init__.pyindex 3a8ce79e8..693b7a818 100644--- a/camel/utils/__init__.py+++ b/camel/utils/__init__.py@@ -22,6 +22,7 @@ from .functions import (get_first_int,download_tasks,parse_doc,+ get_task_list,)__all__ = [@@ -35,4 +36,5 @@ __all__ = ['download_tasks','PythonInterpreter','parse_doc',+ 'get_task_list',]diff --git a/camel/utils/functions.py b/camel/utils/functions.pyindex f74dfeefc..3f211310d 100644--- a/camel/utils/functions.py+++ b/camel/utils/functions.py@@ -314,3 +314,26 @@ def parse_doc(func: Callable) -> Dict[str, Any]:}return function_dict+++def get_task_list(task_response: str) -> List[str]:+ r"""Parse the response of the Agent and return task list.++ Args:+ task_response (str): The string response of the Agent.++ Returns:+ List[str]: A list of the string tasks.+ """++ new_tasks_list = []+ task_string_list = task_response.strip().split('\n')+ # each task starts with #.+ for task_string in task_string_list:+ task_parts = task_string.strip().split(".", 1)+ if len(task_parts) == 2:+ task_id = ''.join(s for s in task_parts[0] if s.isnumeric())+ task_name = re.sub(r'[^\w\s_]+', '', task_parts[1]).strip()+ if task_name.strip() and task_id.isnumeric():+ new_tasks_list.append(task_name)+ return new_tasks_listdiff --git a/test/agents/test_task_agent.py b/test/agents/test_task_agent.pyindex 454430388..5c689bc87 100644--- a/test/agents/test_task_agent.py+++ b/test/agents/test_task_agent.py@@ -15,7 +15,12 @@ from typing import Optionalimport pytest-from camel.agents import TaskPlannerAgent, TaskSpecifyAgent+from camel.agents import (+ TaskCreationAgent,+ TaskPlannerAgent,+ TaskPrioritizationAgent,+ TaskSpecifyAgent,+)from camel.configs import ChatGPTConfigfrom camel.typing import ModelType, TaskType@@ -34,7 +39,7 @@ def test_task_specify_ai_society_agent(model: Optional[ModelType]):specified_task_prompt = task_specify_agent.run(original_task_prompt, meta_dict=dict(assistant_role="Musician",user_role="Student"))- assert ("{" and "}" not in task_specify_agent.task_specify_prompt)+ assert ("{" and "}" not in specified_task_prompt)print(f"Specified task prompt:\n{specified_task_prompt}\n")@@ -50,7 +55,7 @@ def test_task_specify_code_agent(model: Optional[ModelType]):specified_task_prompt = task_specify_agent.run(original_task_prompt, meta_dict=dict(domain="Chemistry",language="Python"))- assert ("{" and "}" not in task_specify_agent.task_specify_prompt)+ assert ("{" and "}" not in specified_task_prompt)print(f"Specified task prompt:\n{specified_task_prompt}\n")@@ -71,3 +76,66 @@ def test_task_planner_agent(model: Optional[ModelType]):model_config=ChatGPTConfig(temperature=1.0), model=model)planned_task_prompt = task_planner_agent.run(specified_task_prompt)print(f"Planned task prompt:\n{planned_task_prompt}\n")+++@parametrize+def test_task_creation_agent(model: Optional[ModelType]):+ original_task_prompt = "Modeling molecular dynamics"+ task_creation_agent = TaskCreationAgent(+ model_config=ChatGPTConfig(temperature=1.0), model=model,+ objective=original_task_prompt)+ task = "Search math tools for dynamics modeling"+ task_result = "Molecular dynamics trajectories are the result of \+ molecular dynamics simulations. Trajectories are sequential \+ snapshots of simulated molecular system which represents atomic \+ coordinates at specific time periods. Based on the definition, \+ in a text format trajectory files are characterized by their \+ simplicity and uselessness. To obtain information from such files, \+ special programs and information processing techniques are applied: \+ from molecular dynamics animation to finding characteristics \+ along the trajectory (versus time). In this review, we describe \+ different programs for processing molecular dynamics trajectories. \+ The performance of these programs, usefulness for analyses of \+ molecular dynamics trajectories, strongs and weaks are discussed."++ planned_task = task_creation_agent.run(+ previous_task=task,+ task_result=task_result,+ )+ print(f"Planned task list:\n{planned_task}\n")++ assert isinstance(planned_task, list)+ task_list = ["Study the computational technology for dynamics modeling"]+ planned_task = task_creation_agent.run(+ previous_task=task,+ task_result=task_result,+ task_list=task_list,+ )+ print(f"Planned task list:\n{planned_task}\n")+ assert isinstance(planned_task, list)+++@parametrize+def test_task_prioritization_agent(model: Optional[ModelType]):+ original_task_prompt = ("A high school student wants to "+ "prove the Riemann hypothesis")++ task_list = [+ "Drop out of high school",+ "Start a tech company",+ "Become a billionaire",+ "Buy a yacht",+ "Obtain a bachelor degree in mathematics",+ "Obtain a PhD degree in mathematics",+ "Become a professor of mathematics",+ ]++ task_prioritization_agent = TaskPrioritizationAgent(+ model_config=ChatGPTConfig(temperature=1.0),+ model=model,+ objective=original_task_prompt,+ )++ prioritized_task = task_prioritization_agent.run(task_list=task_list)+ print(f"Prioritized task list:\n{prioritized_task}\n")+ assert isinstance(prioritized_task, list)diff --git a/test/utils/test_functions.py b/test/utils/test_functions.pynew file mode 100644index 000000000..5c1a569bd--- /dev/null+++ b/test/utils/test_functions.py@@ -0,0 +1,39 @@+# =========== Copyright 2023 @ CAMEL-AI.org. All Rights Reserved. ===========+# Licensed under the Apache License, Version 2.0 (the “License”);+# you may not use this file except in compliance with the License.+# You may obtain a copy of the License at+#+# http://www.apache.org/licenses/LICENSE-2.0+#+# Unless required by applicable law or agreed to in writing, software+# distributed under the License is distributed on an “AS IS” BASIS,+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.+# See the License for the specific language governing permissions and+# limitations under the License.+# =========== Copyright 2023 @ CAMEL-AI.org. All Rights Reserved. ===========+from camel.utils import get_task_list+++def test_get_task_list():+ task_response = ""+ task_list = get_task_list(task_response)+ assert isinstance(task_list, list)+ assert len(task_list) == 0++ task_response = "1.Task1\n2.Task2\n3.Task3"+ task_list = get_task_list(task_response)+ assert isinstance(task_list, list)+ assert isinstance(task_list[0], str)+ assert len(task_list) == 3++ task_response = "1.Task12.Task2\n3.Task3"+ task_list = get_task_list(task_response)+ assert isinstance(task_list, list)+ assert isinstance(task_list[0], str)+ assert len(task_list) == 2++ task_response = "#.Task12.Task2\n3.Task3"+ task_list = get_task_list(task_response)+ assert isinstance(task_list, list)+ assert isinstance(task_list[0], str)+ assert len(task_list) == 1