Update documentation list[messages]

README.md

@@ -121,7 +121,7 @@ assistant = AssistantAgent("assistant", llm_config=llm_config)
 
 user_proxy = UserProxyAgent("user_proxy", code_execution_config={"work_dir": "coding", "use_docker": False})
 
-user_proxy.run(assistant, message="Summarize the main differences between Python lists and tuples.").process()
+user_proxy.run(assistant, message=[{"content":"Summarize the main differences between Python lists and tuples.","role":"user"}]).process()
 ```
 
 ## Example applications
@@ -177,7 +177,7 @@ reviewer = ConversableAgent(
 # Start a conversation
 response = reviewer.run(
             recipient=coder,
-            message="Write a Python function that computes Fibonacci numbers.",
+            message=[{"content":"Write a Python function that computes Fibonacci numbers.","role":"user"}],
             max_turns=10
         )
 
@@ -365,7 +365,7 @@ register_function(
 # Use tool in chat
 chat_result = executor_agent.initiate_chat(
     recipient=date_agent,
-    message="I was born on 1995-03-25, what day was it?",
+    message=[{"content":"I was born on 1995-03-25, what day was it?","role":"user"}],
     max_turns=2,
 )
 

autogen/agentchat/agent.py

@@ -40,14 +40,14 @@ def description(self) -> str:
 
     def send(
         self,
-        message: dict[str, Any] | str,
+        message: list[dict[str, Any]] | str,
         recipient: "Agent",
         request_reply: bool | None = None,
     ) -> None:
         """Send a message to another agent.
 
         Args:
-            message (dict or str): the message to send. If a dict, it should be
+            message (list[dict[str, Any]] or str): the message to send. If a list of messages, it should be
                 a JSON-serializable and follows the OpenAI's ChatCompletion schema.
             recipient (Agent): the recipient of the message.
             request_reply (bool): whether to request a reply from the recipient.
@@ -56,14 +56,14 @@ def send(
 
     async def a_send(
         self,
-        message: dict[str, Any] | str,
+        message: list[dict[str, Any]] | str,
         recipient: "Agent",
         request_reply: bool | None = None,
     ) -> None:
         """(Async) Send a message to another agent.
 
         Args:
-            message (dict or str): the message to send. If a dict, it should be
+            message (list[messages] or str): the message to send. If a list of messages, it should be
                 a JSON-serializable and follows the OpenAI's ChatCompletion schema.
             recipient (Agent): the recipient of the message.
             request_reply (bool): whether to request a reply from the recipient.
@@ -72,45 +72,49 @@ async def a_send(
 
     def receive(
         self,
-        message: dict[str, Any] | str,
+        message: list[dict[str, Any]],
         sender: "Agent",
         request_reply: bool | None = None,
+        silent: bool | None = False,
     ) -> None:
         """Receive a message from another agent.
 
         Args:
-            message (dict or str): the message received. If a dict, it should be
+            message (list[messages]): the list[messages] received. If a list of messages, it should be
                 a JSON-serializable and follows the OpenAI's ChatCompletion schema.
             sender (Agent): the sender of the message.
             request_reply (bool): whether the sender requests a reply.
+            silent (bool): whether to print the message received.
         """
 
     async def a_receive(
         self,
-        message: dict[str, Any] | str,
+        message: list[dict[str, Any]],
         sender: "Agent",
         request_reply: bool | None = None,
+        silent: bool | None = False,
     ) -> None:
         """(Async) Receive a message from another agent.
 
         Args:
-            message (dict or str): the message received. If a dict, it should be
+            message (list[messages]): the list[messages] received. If a list of messages, it should be
                 a JSON-serializable and follows the OpenAI's ChatCompletion schema.
             sender (Agent): the sender of the message.
             request_reply (bool): whether the sender requests a reply.
+            silent (bool): whether to print the message received.
         """
         ...
 
     def generate_reply(
         self,
-        messages: list[dict[str, Any]] | None = None,
+        messages: list[dict[str, Any]] | dict[str, Any] | None = None,
         sender: Optional["Agent"] = None,
         **kwargs: Any,
     ) -> str | dict[str, Any] | None:
         """Generate a reply based on the received messages.
 
         Args:
-            messages (list[dict[str, Any]]): a list of messages received from other agents.
+            messages (list[dict[str, Any]] or dict[str, Any]): a list of messages received from other agents. can be a single message.
                 The messages are dictionaries that are JSON-serializable and
                 follows the OpenAI's ChatCompletion schema.
             sender: sender of an Agent instance.
@@ -122,14 +126,14 @@ def generate_reply(
 
     async def a_generate_reply(
         self,
-        messages: list[dict[str, Any]] | None = None,
+        messages: list[dict[str, Any]] | dict[str, Any] | None = None,
         sender: Optional["Agent"] = None,
         **kwargs: Any,
     ) -> str | dict[str, Any] | None:
         """(Async) Generate a reply based on the received messages.
 
         Args:
-            messages (list[dict[str, Any]]): a list of messages received from other agents.
+            messages (list[dict[str, Any]] or dict[str, Any]): a list of messages received from other agents. can be a single message.
                 The messages are dictionaries that are JSON-serializable and
                 follows the OpenAI's ChatCompletion schema.
             sender: sender of an Agent instance.

autogen/agentchat/contrib/graph_rag/graph_rag_capability.py

@@ -38,7 +38,7 @@ class GraphRagCapability(AgentCapability):
         is_termination_msg=lambda msg: "TERMINATE" in msg["content"],
         human_input_mode="ALWAYS",
     )
-    user_proxy.initiate_chat(graph_rag_agent, message="Name a few actors who've played in 'The Matrix'")
+    user_proxy.initiate_chat(graph_rag_agent, message=[{"content":"Name a few actors who've played in 'The Matrix'","role":"user"}])
 
     # ChatResult(
         # chat_id=uuid.uuid4().int,