chore: docs sync from main — needs review (2026-04-24)

Author: copilotkit-devops-bot[bot]

showcase/shell-docs/src/content/docs/integrations/agent-spec/quickstart.mdx

@@ -108,7 +108,6 @@ hideTOC: true
           Clone the starter template
 
           ```bash
-          # If you are in the path integrations/agent-spec/python, then run the following command to go to root
           git clone https://github.com/CopilotKit/with-agent-spec.git
           cd with-agent-spec
           ```

showcase/shell-docs/src/content/docs/integrations/built-in-agent/server-tools.mdx

@@ -21,19 +21,20 @@ import { z } from "zod";
 
 const getWeather = defineTool({
   name: "getWeather",
-  description: "Get the current weather for a city",
+  description: "Get the current weather for a location",
   parameters: z.object({
-    city: z.string().describe("The city name"),
+    location: z.string().describe("The location's name"),
   }),
-  execute: async ({ city }) => {
+  execute: async ({ location }) => {
     // Your implementation here
-    return { temperature: 72, condition: "sunny", city };
+    return { temperature: 72, condition: "sunny", location };
   },
 });
 
 const builtInAgent = new BuiltInAgent({
   model: "openai:gpt-5.4-mini",
   tools: [getWeather],
+  maxSteps: 2                   //Important for tool calls
 });
 ```
 
@@ -75,6 +76,7 @@ const createTicket = defineTool({
 const builtInAgent = new BuiltInAgent({
   model: "openai:gpt-5.4-mini",
   tools: [searchDocs, createTicket], // [!code highlight]
+  maxSteps: 2                        
 });
 ```
 

showcase/shell-docs/src/content/docs/integrations/langgraph/deep-agents.mdx

@@ -3,7 +3,6 @@ title: Deep Agents
 description: Leverage LangGraph Deep Agents to build sophisticated agentic applications.
 icon: "lucide/BrainCircuit"
 ---
-
 ## Prerequisites
 
 Before you begin, you'll need the following:
@@ -14,7 +13,6 @@ Before you begin, you'll need the following:
 - A LangSmith API key - only required if deploying to LangSmith Platform
 
 ## Getting started
-
 <Steps>
     <Step>
         ### Initialize your agent project
@@ -53,12 +51,13 @@ Before you begin, you'll need the following:
                     return f"The weather in {location} is sunny."
 
                 agent = create_deep_agent(
-                    model="openai:gpt-5.2",
+                    model="openai:gpt-5.4",
                     tools=[get_weather],
                     middleware=[CopilotKitMiddleware()], # for frontend tools and context
                     system_prompt="You are a helpful research assistant.",
-                    checkpointer=MemorySaver()
                 )
+
+                graph = agent
                 ```
 
                 Then to test and deploy with LangSmith, we'll also need a `langgraph.json`
@@ -90,6 +89,9 @@ Before you begin, you'll need the following:
                 Then create a simple LangGraph agent, add a FastAPI app, and build attach our agent as an AG-UI endpoint.
 
                 ```python title="main.py"
+                import os
+                from fastapi import FastAPI 
+                import uvicorn
 
                 # [!code highlight:2]
                 from ag_ui_langgraph import add_langgraph_fastapi_endpoint
@@ -102,13 +104,15 @@ Before you begin, you'll need the following:
                     return f"The weather in {location} is sunny."
 
                 agent = create_deep_agent(
-                    model="openai:gpt-5.2",
+                    model="openai:gpt-5.4",
                     tools=[get_weather],
                     middleware=[CopilotKitMiddleware()], # for frontend tools and context
                     system_prompt="You are a helpful research assistant.",
                     checkpointer=MemorySaver()
                 )
 
+                app = FastAPI()
+
                 # [!code highlight:9]
                 add_langgraph_fastapi_endpoint(
                     app=app,
@@ -125,7 +129,7 @@ Before you begin, you'll need the following:
                     uvicorn.run(
                         "main:app",
                         host="0.0.0.0",
-                        port="8123",
+                        port=8123,
                         reload=True,
                     )
 
@@ -181,11 +185,14 @@ Before you begin, you'll need the following:
         <Tabs groupId="deployment_method" items={['LangSmith', 'FastAPI']}>
             <Tab value="LangSmith">
                 ```tsx title="app/api/copilotkit/route.ts"
+                import {
                     CopilotRuntime,
                     ExperimentalEmptyAdapter,
                     copilotRuntimeNextJSAppRouterEndpoint,
                 } from "@copilotkit/runtime";
                 // [!code highlight]
+                import { LangGraphAgent } from "@copilotkit/runtime/langgraph";
+                import { NextRequest } from "next/server";
 
                 const serviceAdapter = new ExperimentalEmptyAdapter();
 
@@ -213,11 +220,14 @@ Before you begin, you'll need the following:
             </Tab>
             <Tab value="FastAPI">
                 ```tsx title="app/api/copilotkit/route.ts"
+                import {
                     CopilotRuntime,
                     ExperimentalEmptyAdapter,
                     copilotRuntimeNextJSAppRouterEndpoint,
                 } from "@copilotkit/runtime";
                 // [!code highlight]
+                import { LangGraphHttpAgent } from "@copilotkit/runtime/langgraph";
+                import { NextRequest } from "next/server";
 
                 const serviceAdapter = new ExperimentalEmptyAdapter();
 
@@ -250,6 +260,8 @@ Before you begin, you'll need the following:
 
         ```tsx title="app/layout.tsx"
         // [!code highlight:2]
+        import { CopilotKit } from "@copilotkit/react-core";
+        import "@copilotkit/react-ui/v2/styles.css";
 
         // ...
 
@@ -275,6 +287,8 @@ Before you begin, you'll need the following:
     ```tsx title="app/page.tsx"
     "use client";
 
+    import { CopilotSidebar } from "@copilotkit/react-core/v2";
+    import { useDefaultRenderTool } from "@copilotkit/react-core/v2";
 
     export default function Page() {
         useDefaultRenderTool({
@@ -352,5 +366,4 @@ Before you begin, you'll need the following:
             </Tab>
         </Tabs>
     </Step>
-
-</Steps>
+</Steps>

showcase/shell-docs/src/content/docs/integrations/microsoft-agent-framework/quickstart.mdx

@@ -233,6 +233,7 @@ Before you begin, you'll need the following:
 
                         ```bash
                         uv init my-agent
+                        cd my-agent
                         uv add agent-framework-ag-ui python-dotenv uvicorn agent-framework-openai
                         ```
                         Create a minimal FastAPI server that exposes a Microsoft Agent Framework agent over AG-UI:
@@ -293,8 +294,7 @@ Before you begin, you'll need the following:
                         # (optional) AZURE_OPENAI_API_KEY=...
 
                         # Run the agent
-                        cd agent
-                        uv run src/byo_agent.py
+                        uv run main.py
                         ```
                     </Tab>
                 </Tabs>