Rename AI onboarding docs to Agent Toolkit

Author: Alek99

…ai_builder/integrations/ai_onboarding.md …ai_builder/integrations/agent_toolkit.mddocs/ai_builder/integrations/ai_onboarding.md renamed to docs/ai_builder/integrations/agent_toolkit.md docs/ai_builder/integrations/ai_onboarding.md renamed to docs/ai_builder/integrations/agent_toolkit.md

@@ -1,4 +1,4 @@
-# AI Onboarding
+# Agent Toolkit
 
 ```python exec
 import reflex as rx
@@ -20,7 +20,7 @@ def _resource_card(
     )
 
 
-def onboarding_resources() -> rx.Component:
+def agent_toolkit_resources() -> rx.Component:
     return rx.el.div(
         _resource_card(
             "Docs for Agents",
@@ -51,12 +51,10 @@ def onboarding_resources() -> rx.Component:
     )
 ```
 
-Everything you need to onboard your AI coding assistant to Reflex.
-
-If you are building Reflex apps with AI, combine current docs, structured MCP context, and local skills so the assistant can plan, code, run, and debug with the same assumptions as the Reflex docs.
+The Agent Toolkit gives AI coding assistants the Reflex context they need to plan, code, run, and debug with the same assumptions as the Reflex docs.
 
 ```python eval
-onboarding_resources()
+agent_toolkit_resources()
 ```
 
 ## Prerequisite: Choose Your Workflow
@@ -71,7 +69,7 @@ You do not need an API key to read Reflex documentation. Start by deciding how y
 
 ## Reflex Docs for Agents
 
-You can give your assistant current Reflex documentation in a few ways.
+You can give your assistant current Reflex documentation in a few ways. These Agent Toolkit resources are designed for assistants that need focused Markdown pages, a broad docs index, structured MCP lookup, or repeatable local skills.
 
 `````md tabs
 
@@ -80,7 +78,7 @@ You can give your assistant current Reflex documentation in a few ways.
 Every docs page has a Markdown version that agents can read directly. Add `.md` to the docs path:
 
 ```text
-https://reflex.dev/docs/ai/integrations/ai-onboarding.md
+https://reflex.dev/docs/ai/integrations/agent-toolkit.md
 ```
 
 Use this when an agent needs one focused page.

docs/ai_builder/integrations/agents_md.md

@@ -79,7 +79,7 @@ cp AGENTS.md /path/to/your/reflex-project/AGENTS.md
 
 ## Combining With Skills and MCP
 
-`AGENTS.md` and `CLAUDE.md` anchor the assistant in your project. Pair them with the other onboarding tools for deeper Reflex knowledge:
+`AGENTS.md` and `CLAUDE.md` anchor the assistant in your project. Pair them with the Agent Toolkit resources for deeper Reflex knowledge:
 
 - [Reflex Agent Skills](/docs/ai/integrations/skills/) provide reusable workflows that the file references by name.
 - [Reflex MCP](/docs/ai/integrations/mcp-overview/) provides structured documentation lookup at runtime.

docs/app/agent_files/_plugin.py

@@ -14,8 +14,11 @@
     "ai/integrations/mcp-installation.md",
     "ai/integrations/mcp-overview.md",
 }
-AI_ONBOARDING_DOC_PATHS = {
-    "ai/integrations/ai-onboarding.md",
+AGENT_TOOLKIT_DOC_PATHS = {
+    "ai/integrations/agent-toolkit.md",
+}
+LEGACY_MARKDOWN_ALIASES = {
+    Path("ai/integrations/ai-onboarding.md"): Path("ai/integrations/agent-toolkit.md"),
 }
 MCP_DOC_ORDER = {
     "ai/integrations/mcp-overview.md": 0,
@@ -190,7 +193,7 @@ def _include_index_entry_in_llms_txt(markdown_file: MarkdownIndexEntry) -> bool:
     path = markdown_file.url_path.as_posix()
     return (
         path in MCP_DOC_PATHS
-        or path in AI_ONBOARDING_DOC_PATHS
+        or path in AGENT_TOOLKIT_DOC_PATHS
         or path in SKILLS_DOC_PATHS
         or not path.startswith("ai/")
         or path.startswith("ai/overview/")
@@ -200,8 +203,8 @@ def _include_index_entry_in_llms_txt(markdown_file: MarkdownIndexEntry) -> bool:
 def _section_for_path(url_path: Path) -> str:
     """Return the llms.txt section for a generated markdown asset."""
     path = url_path.as_posix()
-    if path in AI_ONBOARDING_DOC_PATHS:
-        return "AI Onboarding"
+    if path in AGENT_TOOLKIT_DOC_PATHS:
+        return "Agent Toolkit"
     if path in MCP_DOC_PATHS:
         return "MCP"
     if path in SKILLS_DOC_PATHS:
@@ -219,10 +222,10 @@ def _ordered_sections(
     if "AI Builder" in sections and "MCP" in sections:
         ordered_sections.remove("MCP")
         ordered_sections.insert(ordered_sections.index("AI Builder") + 1, "MCP")
-    if "AI Builder" in sections and "AI Onboarding" in sections:
-        ordered_sections.remove("AI Onboarding")
+    if "AI Builder" in sections and "Agent Toolkit" in sections:
+        ordered_sections.remove("Agent Toolkit")
         ordered_sections.insert(
-            ordered_sections.index("AI Builder") + 1, "AI Onboarding"
+            ordered_sections.index("AI Builder") + 1, "Agent Toolkit"
         )
     if "MCP" in sections and "Skills" in sections:
         ordered_sections.remove("Skills")
@@ -847,9 +850,16 @@ def generate_agent_files() -> tuple[tuple[Path, str | bytes], ...]:
         (entry.url_path, generate_markdown_file_content(entry))
         for entry in markdown_file_entries
     )
+    markdown_files_by_path = dict(markdown_files)
+    legacy_markdown_files = tuple(
+        (legacy_path, markdown_files_by_path[target_path])
+        for legacy_path, target_path in LEGACY_MARKDOWN_ALIASES.items()
+        if target_path in markdown_files_by_path
+    )
 
     all_markdown_files = [
         *markdown_files,
+        *legacy_markdown_files,
         *dynamic_api_reference_files,
     ]
 

docs/app/reflex_docs/pages/docs/__init__.py

@@ -150,6 +150,8 @@ def get_previews_from_frontmatter(filepath: str) -> dict[str, str]:
     "docs/library/graphing/general/tooltip.md": "Graphing Tooltip",
     "docs/recipes/content/grid.md": "Grid Recipe",
     "docs/hosting/deploy-to-gcp.md": "Deploy to GCP",
+    "docs/ai_builder/integrations/agent_toolkit.md": "Agent Toolkit",
+    "docs/enterprise/event-handler-api.md": "Event Handler API Plugin",
 }
 
 

docs/app/reflex_docs/pages/docs_landing/views/enterprise.py

@@ -32,6 +32,12 @@ def enterprise_section() -> rx.Component:
                 enterprise_page.overview.path,
                 has_padding_left=True,
             ),
+            link_item(
+                "CodeIcon",
+                "Event Handler API Plugin",
+                "Expose Reflex event handlers as authenticated HTTP endpoints with an OpenAPI spec for agents, tests, and external integrations.",
+                enterprise_page.event_handler_api.path,
+            ),
             class_name="grid grid-cols-1 lg:grid-cols-2 border-t border-secondary-4 relative",
         ),
         class_name="flex flex-col gap-10 max-lg:text-center relative max-w-(--landing-layout-max-width) mx-auto w-full justify-start lg:mb-24 mb-10 max-xl:px-6 overflow-hidden",

docs/app/reflex_docs/reflex_docs.py

@@ -110,9 +110,13 @@ def _llms_txt_directive() -> rx.Component:
 
 # Add redirects.
 redirects = [
-    (route.path.replace("/ai/", "/ai-builder/", 1), route.path)
-    for route in routes
-    if route.path.startswith("/ai/")
+    ("/ai/integrations/ai-onboarding/", "/ai/integrations/agent-toolkit/"),
+    ("/ai-builder/integrations/ai-onboarding/", "/ai/integrations/agent-toolkit/"),
+    *[
+        (route.path.replace("/ai/", "/ai-builder/", 1), route.path)
+        for route in routes
+        if route.path.startswith("/ai/")
+    ],
 ]
 
 

docs/app/reflex_docs/templates/docpage/docpage.py

@@ -640,12 +640,15 @@ def breadcrumb(path: str, nav_sidebar: rx.Component, doc_content: str | None = N
         docs_sidebar_drawer,
     )
 
-    # Split the path into segments, removing 'docs' and capitalizing each segment
-    segments = [
-        segment.capitalize()
-        for segment in path.split("/")
-        if segment and segment != "docs"
-    ]
+    # Split the path into segments, removing 'docs'. Some legacy URLs keep
+    # their old slugs for compatibility while using newer public labels.
+    segments = [segment for segment in path.split("/") if segment and segment != "docs"]
+    segment_labels = {
+        "ai": "AI",
+        "ai-onboarding": "Agent Toolkit",
+        "agent-toolkit": "Agent Toolkit",
+        "event-handler-api": "Event Handler API Plugin",
+    }
 
     # Initialize an empty list to store the breadcrumbs and their separators
     breadcrumbs = []
@@ -658,7 +661,10 @@ def breadcrumb(path: str, nav_sidebar: rx.Component, doc_content: str | None = N
         # Add the breadcrumb item to the list
         breadcrumbs.append(
             rx.el.a(
-                to_title_case(to_snake_case(segment), sep=" "),
+                segment_labels.get(
+                    segment,
+                    to_title_case(to_snake_case(segment), sep=" "),
+                ),
                 class_name="min-h-8 flex items-center text-sm font-[525] text-m-slate-12 dark:text-m-slate-3 last:text-m-slate-7 dark:last:text-m-slate-6 hover:text-primary-10 dark:hover:text-primary-9"
                 + (" truncate" if i == len(segments) - 1 else ""),
                 underline="none",

docs/app/reflex_docs/templates/docpage/sidebar/sidebar.py

@@ -7,9 +7,9 @@
 from reflex_site_shared.styles.colors import c_color
 
 from .sidebar_items.ai import (
+    agent_toolkit_items,
     ai_builder_integrations,
     ai_builder_overview_items,
-    ai_onboarding_items,
     mcp_items,
     skills_items,
 )
@@ -305,7 +305,7 @@ def append_to_items(items, flat_items):
     + recipes
     + ai_builder_overview_items
     + ai_builder_integrations
-    + ai_onboarding_items
+    + agent_toolkit_items
     + mcp_items
     + skills_items
     + api_reference
@@ -440,7 +440,7 @@ def sidebar_comp(
     recipes_index: list[int],
     enterprise_usage_index: list[int],
     enterprise_component_index: list[int],
-    ai_onboarding_index: list[int],
+    agent_toolkit_index: list[int],
     mcp_index: list[int],
     skills_index: list[int],
     #
@@ -461,7 +461,7 @@ def sidebar_comp(
     is_docs_hosting = path.startswith("/hosting/")
     is_docs_ai_builder = path.startswith("/ai/")
     is_ai_mcp_or_skills = path.startswith((
-        "/ai/integrations/ai-onboarding/",
+        "/ai/integrations/agent-toolkit/",
         "/ai/integrations/skills/",
         "/ai/integrations/agents-md/",
         "/ai/integrations/mcp",
@@ -505,8 +505,8 @@ def sidebar_comp(
                 ai_category == 0,
             ),
             sidebar_category(
-                "MCP/Skills",
-                ai_builder_pages.integrations.ai_onboarding.path,
+                "Agent Toolkit",
+                ai_builder_pages.integrations.agent_toolkit.path,
                 "plug",
                 ai_category == 1,
             ),
@@ -516,9 +516,9 @@ def sidebar_comp(
             rx.el.ul(
                 create_sidebar_section(
                     "Overview",
-                    ai_builder_pages.integrations.ai_onboarding.path,
-                    ai_onboarding_items,
-                    ai_onboarding_index,
+                    ai_builder_pages.integrations.agent_toolkit.path,
+                    agent_toolkit_items,
+                    agent_toolkit_index,
                     url,
                 ),
                 create_sidebar_section(
@@ -732,7 +732,7 @@ def sidebar(url=None, width: str = "100%") -> rx.Component:
     ai_builder_integrations_index = calculate_index(
         ai_builder_integrations, normalized_url
     )
-    ai_onboarding_index = calculate_index(ai_onboarding_items, normalized_url)
+    agent_toolkit_index = calculate_index(agent_toolkit_items, normalized_url)
     mcp_index = calculate_index(mcp_items, normalized_url)
     skills_index = calculate_index(skills_items, normalized_url)
 
@@ -750,7 +750,7 @@ def sidebar(url=None, width: str = "100%") -> rx.Component:
             recipes_index=recipes_index,
             enterprise_usage_index=enterprise_usage_index,
             enterprise_component_index=enterprise_component_index,
-            ai_onboarding_index=ai_onboarding_index,
+            agent_toolkit_index=agent_toolkit_index,
             ai_builder_overview_index=ai_builder_overview_index,
             ai_builder_integrations_index=ai_builder_integrations_index,
             cli_ref_index=cli_ref_index,

docs/app/reflex_docs/templates/docpage/sidebar/sidebar_items/ai.py

@@ -146,13 +146,13 @@ def get_ai_builder_integrations():
     ]
 
 
-def get_sidebar_items_ai_onboarding():
+def get_sidebar_items_agent_toolkit():
     from reflex_docs.pages.docs import ai_builder
 
     return [
         SideBarItem(
-            names="AI Onboarding",
-            link=ai_builder.integrations.ai_onboarding.path,
+            names="Agent Toolkit",
+            link=ai_builder.integrations.agent_toolkit.path,
         ),
     ]
 
@@ -189,6 +189,6 @@ def get_sidebar_items_skills():
 
 ai_builder_overview_items = get_sidebar_items_ai_builder_overview()
 ai_builder_integrations = get_ai_builder_integrations()
-ai_onboarding_items = get_sidebar_items_ai_onboarding()
+agent_toolkit_items = get_sidebar_items_agent_toolkit()
 mcp_items = get_sidebar_items_mcp()
 skills_items = get_sidebar_items_skills()

docs/app/reflex_docs/templates/docpage/sidebar/sidebar_items/enterprise.py

@@ -28,8 +28,13 @@ def get_sidebar_items_enterprise_usage():
                     names="Single Port Proxy",
                     link=enterprise.single_port_proxy.path,
                 ),
+            ],
+        ),
+        SideBarItem(
+            names="Plugins",
+            children=[
                 SideBarItem(
-                    names="Event Handler API",
+                    names="Event Handler API Plugin",
                     link=enterprise.event_handler_api.path,
                 ),
             ],