Cleaning up beginners' guide for Agents docs

Author: Oxyjun

src/content/docs/agents/getting-started/get-started.mdx

@@ -0,0 +1,71 @@
+---
+title: Get started
+pcx_content_type: get-started
+sidebar:
+  order: 2
+---
+
+import { Render, PackageManagers, WranglerConfig, TypeScriptExample, Steps } from "~/components";
+
+## Use the starter template
+
+To use the Agent starter template and create your first Agent with the Agents SDK:
+
+<Steps>
+1. Create a new project using the `agents-starter` template.
+   ```sh
+   # install it
+   npm create cloudflare@latest agents-starter -- --template=cloudflare/agents-starter
+   ```
+2. Deploy the project.
+
+   ```sh
+   #deploy it
+   npx wrangler@latest deploy
+   ```
+</Steps>
+
+## Manually create an Agent
+
+1. Install the `agents` package directly into an existing project:
+
+```sh
+npm i agents
+```
+
+2. Define your first Agent by creating a class that extends the `Agent` class:
+
+<TypeScriptExample>
+
+```ts
+import { Agent, AgentNamespace } from "agents";
+
+export class MyAgent extends Agent {
+	// Define methods on the Agent:
+	// https://developers.cloudflare.com/agents/api-reference/agents-api/
+	//
+	// Every Agent has built in state via this.setState and this.sql
+	// Built-in scheduling via this.schedule
+	// Agents support WebSockets, HTTP requests, state synchronization and
+	// can run for seconds, minutes or hours: as long as the tasks need.
+}
+```
+
+</TypeScriptExample>
+
+3. Add the [Durable Objects](/durable-objects/) binding to your wrangler file:
+
+<WranglerConfig>
+```toml
+[[durable_objects.bindings]]
+name = "MyAgent"
+class_name = "MyAgent"
+
+[[migrations]]
+tag = "v1"
+new_sqlite_classes = ["MyAgent"]
+
+```
+</WranglerConfig>
+
+Dive into the [Agent SDK reference](/agents/api-reference/agents-api/) to learn more about how to use the Agents SDK package and defining an `Agent`.

src/content/docs/agents/getting-started/testing-your-agent.mdx

@@ -11,7 +11,7 @@ Because Agents run on Cloudflare Workers and Durable Objects, they can be tested
 
 ## Writing and running tests
 
-### Setup
+### 1. Setup your environment
 
 :::note
 
@@ -42,7 +42,7 @@ export default defineWorkersConfig({
 });
 ```
 
-### Add the Agent configuration
+### 2. Add the Agent configuration
 
 Add a `durableObjects` configuration to `vitest.config.js` with the name of your Agent class:
 
@@ -65,7 +65,7 @@ export default defineWorkersConfig({
 });
 ```
 
-### Write a test
+### 3. Write a test
 
 :::note
 
@@ -110,7 +110,7 @@ describe("make a request to my Agent", () => {
 });
 ```
 
-### Run tests
+### 4. Run tests
 
 Running tests is done using the `vitest` CLI:
 

src/content/docs/agents/index.mdx

@@ -1,5 +1,5 @@
 ---
-title: Build Agents on Cloudflare
+title: Cloudflare Agents
 
 pcx_content_type: overview
 tags:
@@ -11,81 +11,13 @@ head:
     content: Agents
 ---
 
-import {
-	CardGrid,
-	Description,
-	Feature,
-	LinkButton,
-	LinkTitleCard,
-	PackageManagers,
-	Plan,
-	RelatedProduct,
-	Render,
-	TabItem,
-	Tabs,
-	TypeScriptExample,
-	WranglerConfig,
-} from "~/components";
+import { CardGrid, Description, Feature, LinkButton, LinkTitleCard, PackageManagers, Plan, RelatedProduct, Render, TabItem, Tabs, TypeScriptExample, WranglerConfig } from "~/components";
 
 The Agents SDK enables you to build and deploy AI-powered agents that can autonomously perform tasks, communicate with clients in real time, call AI models, persist state, schedule tasks, run asynchronous workflows, browse the web, query data from your database, support human-in-the-loop interactions, and [a lot more](/agents/api-reference/).
 
-### Ship your first Agent
+Try [building a chat agent](https://github.com/cloudflare/agents-starter).
 
-To use the Agent starter template and create your first Agent with the Agents SDK:
-
-```sh
-# install it
-npm create cloudflare@latest agents-starter -- --template=cloudflare/agents-starter
-# and deploy it
-npx wrangler@latest deploy
-```
-
-Head to the guide on [building a chat agent](/agents/getting-started/build-a-chat-agent) to learn how the starter project is built and how to use it as a foundation for your own agents.
-
-If you're already building on [Workers](/workers/), you can install the `agents` package directly into an existing project:
-
-```sh
-npm i agents
-```
-
-And then define your first Agent by creating a class that extends the `Agent` class:
-
-<TypeScriptExample>
-
-```ts
-import { Agent, AgentNamespace } from "agents";
-
-export class MyAgent extends Agent {
-	// Define methods on the Agent:
-	// https://developers.cloudflare.com/agents/api-reference/agents-api/
-	//
-	// Every Agent has built in state via this.setState and this.sql
-	// Built-in scheduling via this.schedule
-	// Agents support WebSockets, HTTP requests, state synchronization and
-	// can run for seconds, minutes or hours: as long as the tasks need.
-}
-```
-
-</TypeScriptExample>
-
-Lastly, add the [Durable Objects](/durable-objects/) binding to your wrangler file:
-
-<WranglerConfig>
-```toml
-[[durable_objects.bindings]]
-name = "MyAgent"
-class_name = "MyAgent"
-
-[[migrations]]
-tag = "v1"
-new_sqlite_classes = ["MyAgent"]
-
-```
-</WranglerConfig>
-
-Dive into the [Agent SDK reference](/agents/api-reference/agents-api/) to learn more about how to use the Agents SDK package and defining an `Agent`.
-
-### Why build agents on Cloudflare?
+## Why build agents on Cloudflare?
 
 We built the Agents SDK with a few things in mind:
 
@@ -97,7 +29,7 @@ Agents built with Agents SDK can be deployed directly to Cloudflare and run on t
 
 ---
 
-### Build on the Cloudflare Platform
+## Build on the Cloudflare Platform
 
 <RelatedProduct header="Workers" href="/workers/" product="workers">