From 35c18db510f962e38816e0b07508eb32d92f7cdb Mon Sep 17 00:00:00 2001
From: Matt Silverlock <matt@eatsleeprepeat.net>
Date: Tue, 25 Feb 2025 09:03:05 -0500
Subject: [PATCH] agents-sdk launch

---
 .../agents/2025-02-25-agents-sdk.mdx          | 40 +++++++++++++++++++
 1 file changed, 40 insertions(+)
 create mode 100644 src/content/changelog/agents/2025-02-25-agents-sdk.mdx

diff --git a/src/content/changelog/agents/2025-02-25-agents-sdk.mdx b/src/content/changelog/agents/2025-02-25-agents-sdk.mdx
new file mode 100644
index 000000000000000..b49a025a9280f50
--- /dev/null
+++ b/src/content/changelog/agents/2025-02-25-agents-sdk.mdx
@@ -0,0 +1,40 @@
+---
+title: Introducing the agents-sdk
+description: Build and ship AI Agents on Cloudflare using the agents-sdk
+products:
+  - agents
+  - workers
+date: 2025-02-25T14:00:00Z
+---
+
+We've released the [agents-sdk](http://blog.cloudflare.com/build-ai-agents-on-cloudflare/), a package and set of tools that help you build and ship AI Agents.
+
+You can get up and running with a [chat-based AI Agent](https://github.com/cloudflare/agents-starter) (and deploy it to Workers) that uses the `agents-sdk`, tool calling, and state syncing with a React-based front-end by running the following command:
+
+```sh
+npm create cloudflare@latest agents-starter -- --template="cloudflare/agents-starter"
+# open up README.md and follow the instructions
+```
+
+You can also add an Agent to any existing Workers application by installing the `agents-sdk` package directly
+
+```sh
+npm i agents-sdk
+```
+
+... and then define your first Agent:
+
+```ts
+import { Agent } from 'agents-sdk';
+
+export class YourAgent extends Agent<Env> {
+	// Build it out
+	// Access state on this.state or query the Agent's database via this.sql
+	// Handle WebSocket events with onConnect and onMessage
+	// Run tasks on a schedule with this.schedule
+	// Call AI models
+	// ... and/or call other Agents.
+}
+```
+
+Head over to the [Agents documentation](/agents/) to learn more about the `agents-sdk`, the SDK APIs, as well as how to test and deploying agents to production.