docs: agentic commerce guide (#13657)

www/apps/resources/generated/edit-dates.mjs

@@ -6609,5 +6609,6 @@ export const generatedEditDates = {
   "references/core_flows/Locking/Steps_Locking/variables/core_flows.Locking.Steps_Locking.releaseLockStepId/page.mdx": "2025-09-15T09:52:14.219Z",
   "references/core_flows/Locking/core_flows.Locking.Steps_Locking/page.mdx": "2025-09-15T09:52:14.217Z",
   "app/nextjs-starter/guides/storefront-returns/page.mdx": "2025-09-22T06:02:00.580Z",
-  "references/js_sdk/admin/Admin/properties/js_sdk.admin.Admin.views/page.mdx": "2025-09-18T17:04:59.240Z"
+  "references/js_sdk/admin/Admin/properties/js_sdk.admin.Admin.views/page.mdx": "2025-09-18T17:04:59.240Z",
+  "app/how-to-tutorials/tutorials/agentic-commerce/page.mdx": "2025-10-02T07:14:50.956Z"
 }

www/apps/resources/generated/files-map.mjs

@@ -755,6 +755,10 @@ export const filesMap = [
     "filePath": "/www/apps/resources/app/how-to-tutorials/tutorials/abandoned-cart/page.mdx",
     "pathname": "/how-to-tutorials/tutorials/abandoned-cart"
   },
+  {
+    "filePath": "/www/apps/resources/app/how-to-tutorials/tutorials/agentic-commerce/page.mdx",
+    "pathname": "/how-to-tutorials/tutorials/agentic-commerce"
+  },
   {
     "filePath": "/www/apps/resources/app/how-to-tutorials/tutorials/first-purchase-discounts/page.mdx",
     "pathname": "/how-to-tutorials/tutorials/first-purchase-discounts"

www/apps/resources/generated/generated-commerce-modules-sidebar.mjs

@@ -1087,6 +1087,14 @@ const generatedgeneratedCommerceModulesSidebarSidebar = {
               "path": "https://docs.medusajs.com/resources/how-to-tutorials/tutorials/gift-message",
               "children": []
             },
+            {
+              "loaded": true,
+              "isPathHref": true,
+              "type": "ref",
+              "title": "Agentic Commerce",
+              "path": "https://docs.medusajs.com/resources/how-to-tutorials/tutorials/agentic-commerce",
+              "children": []
+            },
             {
               "loaded": true,
               "isPathHref": true,
@@ -6219,6 +6227,14 @@ const generatedgeneratedCommerceModulesSidebarSidebar = {
               "path": "https://docs.medusajs.com/resources/how-to-tutorials/tutorials/gift-message",
               "children": []
             },
+            {
+              "loaded": true,
+              "isPathHref": true,
+              "type": "ref",
+              "title": "Agentic Commerce",
+              "path": "https://docs.medusajs.com/resources/how-to-tutorials/tutorials/agentic-commerce",
+              "children": []
+            },
             {
               "loaded": true,
               "isPathHref": true,

www/apps/resources/generated/generated-how-to-tutorials-sidebar.mjs

@@ -399,6 +399,15 @@ const generatedgeneratedHowToTutorialsSidebarSidebar = {
           "description": "Learn how to add a gift option and message to items in the cart.",
           "children": []
         },
+        {
+          "loaded": true,
+          "isPathHref": true,
+          "type": "link",
+          "title": "Agentic Commerce",
+          "path": "/how-to-tutorials/tutorials/agentic-commerce",
+          "description": "Learn how to build Agentic Commerce with Medusa to support purchase with AI agents like ChatGPT.",
+          "children": []
+        },
         {
           "loaded": true,
           "isPathHref": true,
@@ -649,18 +658,10 @@ const generatedgeneratedHowToTutorialsSidebarSidebar = {
         {
           "loaded": true,
           "isPathHref": true,
-          "type": "sub-category",
+          "type": "link",
           "title": "Self-Hosting",
-          "children": [
-            {
-              "loaded": true,
-              "isPathHref": true,
-              "type": "link",
-              "path": "https://docs.medusajs.com/learn/deployment/general",
-              "title": "General",
-              "children": []
-            }
-          ]
+          "path": "https://docs.medusajs.com/learn/deployment/general",
+          "children": []
         },
         {
           "loaded": true,

www/apps/resources/sidebars/how-to-tutorials.mjs

@@ -79,6 +79,13 @@ While tutorials show you a specific use case, they also help you understand how
         description:
           "Learn how to add a gift option and message to items in the cart.",
       },
+      {
+        type: "link",
+        title: "Agentic Commerce",
+        path: "/how-to-tutorials/tutorials/agentic-commerce",
+        description:
+          "Learn how to build Agentic Commerce with Medusa to support purchase with AI agents like ChatGPT.",
+      },
       {
         type: "ref",
         title: "Analytics with Segment",
@@ -249,15 +256,9 @@ While tutorials show you a specific use case, they also help you understand how
         path: "https://docs.medusajs.com/cloud",
       },
       {
-        type: "sub-category",
+        type: "link",
         title: "Self-Hosting",
-        children: [
-          {
-            type: "link",
-            path: "https://docs.medusajs.com/learn/deployment/general",
-            title: "General",
-          },
-        ],
+        path: "https://docs.medusajs.com/learn/deployment/general",
       },
       {
         type: "sub-category",

www/packages/tags/src/tags/cart.ts

@@ -19,6 +19,10 @@ export const cart = [
     "title": "Send Abandoned Cart Notification",
     "path": "https://docs.medusajs.com/resources/how-to-tutorials/tutorials/abandoned-cart"
   },
+  {
+    "title": "Agentic Commerce",
+    "path": "https://docs.medusajs.com/resources/how-to-tutorials/tutorials/agentic-commerce"
+  },
   {
     "title": "Implement First-Purchase Discount",
     "path": "https://docs.medusajs.com/resources/how-to-tutorials/tutorials/first-purchase-discounts"

www/packages/tags/src/tags/order.ts

@@ -55,6 +55,10 @@ export const order = [
     "title": "Implement Quote Management",
     "path": "https://docs.medusajs.com/resources/examples/guides/quote-management"
   },
+  {
+    "title": "Agentic Commerce",
+    "path": "https://docs.medusajs.com/resources/how-to-tutorials/tutorials/agentic-commerce"
+  },
   {
     "title": "Add Gift Message",
     "path": "https://docs.medusajs.com/resources/how-to-tutorials/tutorials/gift-message"

www/packages/tags/src/tags/server.ts

@@ -59,6 +59,10 @@ export const server = [
     "title": "Abandoned Cart Notification",
     "path": "https://docs.medusajs.com/resources/how-to-tutorials/tutorials/abandoned-cart"
   },
+  {
+    "title": "Agentic Commerce",
+    "path": "https://docs.medusajs.com/resources/how-to-tutorials/tutorials/agentic-commerce"
+  },
   {
     "title": "First-Purchase Discount",
     "path": "https://docs.medusajs.com/resources/how-to-tutorials/tutorials/first-purchase-discounts"

www/packages/tags/src/tags/tutorial.ts

@@ -27,6 +27,10 @@ export const tutorial = [
     "title": "Abandoned Cart Notification",
     "path": "https://docs.medusajs.com/resources/how-to-tutorials/tutorials/abandoned-cart"
   },
+  {
+    "title": "Agentic Commerce",
+    "path": "https://docs.medusajs.com/resources/how-to-tutorials/tutorials/agentic-commerce"
+  },
   {
     "title": "First-Purchase Discount",
     "path": "https://docs.medusajs.com/resources/how-to-tutorials/tutorials/first-purchase-discounts"