big docs refactor (#1978)

Co-authored-by: Ankush Gola <ankush.gola@gmail.com>

docs/modules/agents.rst

@@ -1,30 +1,52 @@
 Agents
 ==========================
 
+.. note::
+   `Conceptual Guide <https://docs.langchain.com/docs/components/agents>`_
+
+
 Some applications will require not just a predetermined chain of calls to LLMs/other tools,
 but potentially an unknown chain that depends on the user's input.
 In these types of chains, there is a “agent” which has access to a suite of tools.
 Depending on the user input, the agent can then decide which, if any, of these tools to call.
 
-The following sections of documentation are provided:
-
-- `Getting Started <./agents/getting_started.html>`_: A notebook to help you get started working with agents as quickly as possible.
-
-- `Key Concepts <./agents/key_concepts.html>`_: A conceptual guide going over the various concepts related to agents.
-
-- `How-To Guides <./agents/how_to_guides.html>`_: A collection of how-to guides. These highlight how to integrate various types of tools, how to work with different types of agents, and how to customize agents.
-
-- `Reference <../reference/modules/agents.html>`_: API reference documentation for all Agent classes.
-
-
+In this section of documentation, we first start with a Getting Started notebook to over over how to use all things related to agents in an end-to-end manner.
 
 .. toctree::
    :maxdepth: 1
-   :caption: Agents
-   :name: Agents
    :hidden:
 
    ./agents/getting_started.ipynb
-   ./agents/key_concepts.md
-   ./agents/how_to_guides.rst
-   Reference<../reference/modules/agents.rst>
+
+
+We then split the documentation into the following sections:
+
+**Tools**
+
+An overview of the various tools LangChain supports.
+
+
+**Agents**
+
+An overview of the different agent types.
+
+
+**Toolkits**
+
+An overview of toolkits, and examples of the different ones LangChain supports.
+
+
+**Agent Executor**
+
+An overview of the Agent Executor class and examples of how to use it.
+
+Go Deeper
+---------
+
+.. toctree::
+   :maxdepth: 1
+
+   ./agents/tools.rst
+   ./agents/agents.rst
+   ./agents/agent_toolkits.rst
+   ./agents/agent_executors.rst