oracle · nasseur · Dec 23, 2025 · Dec 22, 2025 · Dec 22, 2025
diff --git a/docs/pyagentspec/source/_templates/navbar-new.html b/docs/pyagentspec/source/_templates/navbar-new.html
@@ -13,8 +13,8 @@
     <li class="nav-item {% if pagename == 'changelog' %} current active{% endif %}">
         <a class="nav-link nav-internal" href="{{ pathto("changelog") }}">Release Notes</a>
     </li>
-    <li class="nav-item {% if pagename == 'adapters/langgraph' %} current active{% endif %}">
-        <a class="nav-link nav-internal" href="{{ pathto("adapters/langgraph") }}">Adapters</a>
+    <li class="nav-item {% if pagename == 'adapters/langgraph/index' %} current active{% endif %}">
+        <a class="nav-link nav-internal" href="{{ pathto("adapters/langgraph/index") }}">Adapters</a>
     </li>
     <li class="nav-item {% if pagename == 'ecosystem/integrations' %} current active{% endif %}">
         <a class="nav-link nav-internal" href="{{ pathto("ecosystem/integrations") }}">Ecosystem</a>

diff --git a/docs/pyagentspec/source/adapters/autogen.rst b/docs/pyagentspec/source/adapters/autogen.rst
diff --git a/docs/pyagentspec/source/adapters/autogen/autogen_to_spec.rst b/docs/pyagentspec/source/adapters/autogen/autogen_to_spec.rst
@@ -0,0 +1,12 @@
+
+.. _autogentospec:
+
+Convert AutoGen agents to Agent Spec
+====================================
+
+This usage example showcases how an AutoGen Agent can be converted into an Agent Spec configuration in JSON format.
+
+.. literalinclude:: ../../code_examples/adapter_autogen_quickstart.py
+    :language: python
+    :start-after: .. start-runtime_to_agentspec
+    :end-before: .. end-runtime_to_agentspec
diff --git a/docs/pyagentspec/source/adapters/autogen/index.rst b/docs/pyagentspec/source/adapters/autogen/index.rst
@@ -0,0 +1,43 @@
+.. _autogenadapter:
+
+=============================
+Agent Spec Adapters - AutoGen
+=============================
+
+
+.. figure:: ../../_static/icons/autogen-adapter.jpg
+    :align: center
+    :scale: 20%
+    :alt: Agent Spec adapter for AutoGen
+
+    ↑ With the **Agent Spec adapter for AutoGen**, you can easily import agents from external frameworks using Agent Spec and run them with AutoGen.
+
+
+*Microsoft AutoGen supports the development of multi-agent conversational systems,
+allowing agents to communicate and collaborate to solve tasks.*
+
+
+Get started
+===========
+
+To get started, set up your Python environment (Python 3.10 to 3.12 required),
+and then install the PyAgentSpec package with the AutoGen extension.
+
+
+.. code-block:: bash
+
+    python -m venv .venv
+    source .venv/bin/activate  # On Windows: .venv\Scripts\activate
+    pip install "pyagentspec[autogen]"
+
+
+Usage Examples
+==============
+
+You are now ready to use the adapter to:
+
+.. toctree::
+   :maxdepth: 1
+
+   Run Agent Spec configurations with AutoGen <spec_to_autogen>
+   Convert AutoGen agents to Agent Spec <autogen_to_spec>
diff --git a/docs/pyagentspec/source/adapters/autogen/spec_to_autogen.rst b/docs/pyagentspec/source/adapters/autogen/spec_to_autogen.rst
@@ -0,0 +1,12 @@
+.. _spectoautogen:
+
+Run Agent Spec configurations with AutoGen
+==========================================
+
+This usage example showcases the creation of a simple Agent Spec Agent, subsequently serialized into JSON and converted into an AutoGen
+assistant. Also includes mapping of a `ServerTool` and execution of the conversation.
+
+.. literalinclude:: ../../code_examples/adapter_autogen_quickstart.py
+    :language: python
+    :start-after: .. start-agentspec_to_runtime
+    :end-before: .. end-agentspec_to_runtime
diff --git a/docs/pyagentspec/source/adapters/langgraph.rst b/docs/pyagentspec/source/adapters/langgraph.rst
diff --git a/docs/pyagentspec/source/adapters/langgraph/index.rst b/docs/pyagentspec/source/adapters/langgraph/index.rst
@@ -0,0 +1,44 @@
+.. _langgraphadapter:
+
+===============================
+Agent Spec Adapters - LangGraph
+===============================
+
+
+.. figure:: ../../_static/icons/langgraph-adapter.jpg
+    :align: center
+    :scale: 18%
+    :alt: Agent Spec adapter for LangGraph
+
+    ↑ With the **Agent Spec adapter for LangGraph**, you can easily import agents from external frameworks using Agent Spec and run them with LangGraph.
+
+
+*LangGraph facilitates the creation and management of long-running, stateful agents
+with durable execution and human-in-the-loop capabilities.*
+
+
+Get started
+===========
+
+To get started, set up your Python environment (Python 3.10 or newer required),
+and then install the PyAgentSpec package with the LangGraph extension.
+
+
+.. code-block:: bash
+
+    python -m venv .venv
+    source .venv/bin/activate  # On Windows: .venv\Scripts\activate
+    pip install "pyagentspec[langgraph]"
+
+
+
+Usage Examples
+==============
+
+You are now ready to use the adapter to:
+
+.. toctree::
+   :maxdepth: 1
+
+   Run Agent Spec configurations with LangGraph <spec_to_langgraph>
+   Convert LangGraph agents to Agent Spec <langgraph_to_spec>
diff --git a/docs/pyagentspec/source/adapters/langgraph/langgraph_to_spec.rst b/docs/pyagentspec/source/adapters/langgraph/langgraph_to_spec.rst
@@ -0,0 +1,11 @@
+.. _langgraphtospec:
+
+Convert LangGraph agents to Agent Spec
+======================================
+
+This usage example showcases how a LangGraph Agent can be converted into an Agent Spec configuration in JSON format.
+
+.. literalinclude:: ../../code_examples/adapter_langgraph_quickstart.py
+    :language: python
+    :start-after: .. start-runtime_to_agentspec
+    :end-before: .. end-runtime_to_agentspec
diff --git a/docs/pyagentspec/source/adapters/langgraph/spec_to_langgraph.rst b/docs/pyagentspec/source/adapters/langgraph/spec_to_langgraph.rst
@@ -0,0 +1,12 @@
+.. _spectolanggraph:
+
+Run Agent Spec configurations with LangGraph
+============================================
+
+This usage example showcases the creation of a simple Agent Spec Agent, subsequently serialized into JSON and converted into a LangGraph
+assistant. Also includes mapping of a `ServerTool` and execution of the conversation.
+
+.. literalinclude:: ../../code_examples/adapter_langgraph_quickstart.py
+    :language: python
+    :start-after: .. start-agentspec_to_runtime
+    :end-before: .. end-agentspec_to_runtime
diff --git a/docs/pyagentspec/source/adapters/wayflow.rst → ...entspec/source/adapters/wayflow/index.rst b/docs/pyagentspec/source/adapters/wayflow.rst → ...entspec/source/adapters/wayflow/index.rst
@@ -5,7 +5,7 @@ Agent Spec Adapters - WayFlow
 =============================
 
 
-.. figure:: ../_static/icons/wayflow-adapter.jpg
+.. figure:: ../../_static/icons/wayflow-adapter.jpg
     :align: center
     :scale: 18%
     :alt: Agent Spec adapter for WayFlow
@@ -31,31 +31,13 @@ and then install the PyAgentSpec package as well as WayFlowCore.
     pip install pyagentspec wayflowcore
 
 
-You are now ready to use the adapter:
+Usage Examples
+==============
 
-- Run Agent Spec configurations with WayFlow (see more details :ref:`below <spectowayflow>`)
-- Convert WayFlow agents to Agent Spec (see more details :ref:`below <wayflowtospec>`)
+You are now ready to use the adapter to:
 
+.. toctree::
+   :maxdepth: 1
 
-
-.. _spectowayflow:
-
-Run Agent Spec configurations with WayFlow
-==========================================
-
-
-.. literalinclude:: ../code_examples/adapter_wayflow_quickstart.py
-    :language: python
-    :start-after: .. start-agentspec_to_runtime
-    :end-before: .. end-agentspec_to_runtime
-
-
-.. _wayflowtospec:
-
-Convert WayFlow agents to Agent Spec
-====================================
-
-.. literalinclude:: ../code_examples/adapter_wayflow_quickstart.py
-    :language: python
-    :start-after: .. start-runtime_to_agentspec
-    :end-before: .. end-runtime_to_agentspec
+   Run Agent Spec configurations with WayFlow <spec_to_wayflow>
+   Convert WayFlow agents to Agent Spec <wayflow_to_spec>
diff --git a/docs/pyagentspec/source/adapters/wayflow/spec_to_wayflow.rst b/docs/pyagentspec/source/adapters/wayflow/spec_to_wayflow.rst
@@ -0,0 +1,12 @@
+.. _spectowayflow:
+
+Run Agent Spec configurations with WayFlow
+==========================================
+
+This usage example showcases the creation of a simple Agent Spec Agent, subsequently serialized into JSON and converted into a WayFlow
+assistant. Also includes mapping of a `ServerTool` and execution of the conversation.
+
+.. literalinclude:: ../../code_examples/adapter_wayflow_quickstart.py
+    :language: python
+    :start-after: .. start-agentspec_to_runtime
+    :end-before: .. end-agentspec_to_runtime
diff --git a/docs/pyagentspec/source/adapters/wayflow/wayflow_to_spec.rst b/docs/pyagentspec/source/adapters/wayflow/wayflow_to_spec.rst
@@ -0,0 +1,11 @@
+.. _wayflowtospec:
+
+Convert WayFlow agents to Agent Spec
+====================================
+
+This usage example shows how a WayFlow Agent can be converted into an Agent Spec JSON format.
+
+.. literalinclude:: ../../code_examples/adapter_wayflow_quickstart.py
+    :language: python
+    :start-after: .. start-runtime_to_agentspec
+    :end-before: .. end-runtime_to_agentspec
diff --git a/docs/pyagentspec/source/docs_home.rst b/docs/pyagentspec/source/docs_home.rst
@@ -114,13 +114,13 @@ Agent Spec is developed jointly between Oracle Cloud Infrastructure and Oracle L
 
 
 .. toctree::
-   :maxdepth: 1
+   :maxdepth: 2
    :caption: Adapters
    :hidden:
 
-   LangGraph <adapters/langgraph>
-   WayFlow <adapters/wayflow>
-   AutoGen <adapters/autogen>
+   LangGraph <adapters/langgraph/index>
+   WayFlow <adapters/wayflow/index>
+   AutoGen <adapters/autogen/index>
 
 
 .. toctree::