Update user guide (#4560)

* Update user guide

* Fix typos

* Move the file to correct dir

* update notebook, add runnable code to catch bugs, improve text on inner messages

* update icons in tutorial

* Reduce references to future concepts

---------

Co-authored-by: Victor Dibia <victor.dibia@gmail.com>

python/packages/autogen-core/docs/src/user-guide/agentchat-user-guide/tutorial/agents.ipynb

@@ -6,9 +6,6 @@
    "source": [
     "# Agents\n",
     "\n",
-    "```{include} ../warning.md\n",
-    "```\n",
-    "\n",
     "AutoGen AgentChat provides a set of preset Agents, each with variations in how an agent might respond to messages.\n",
     "All agents share the following attributes and methods:\n",
     "\n",

python/packages/autogen-core/docs/src/user-guide/agentchat-user-guide/tutorial/index.md

@@ -18,6 +18,12 @@ Get started with AgentChat through this comprehensive tutorial.
 Setting up model clients for agents and teams.
 :::
 
+:::{grid-item-card} {fas}`message;pst-color-primary` Messages
+:link: ./messages.html
+
+Understanding different types of messages.
+:::
+
 :::{grid-item-card} {fas}`users;pst-color-primary` Agents
 :link: ./agents.html
 
@@ -48,7 +54,7 @@ A dynamic team that uses handoffs to pass tasks between agents.
 How to build custom agents.
 :::
 
-:::{grid-item-card} {fas}`users;pst-color-primary` State Management
+:::{grid-item-card} {fas}`database;pst-color-primary` State Management
 :link: ./state.html
 
 How to manage state in agents and teams.
@@ -61,6 +67,7 @@ How to manage state in agents and teams.
 :hidden:
 
 models
+messages
 agents
 teams
 selector-group-chat