导航|地址|刷新
Testing your Agents

Skip to contentDocumentation Index
Fetch the complete documentation index at: https://developers.cloudflare.com/agents/llms.txt
Use this file to discover all available pages before exploring further.

Docs Directory API SDKs Changelog

Search

Log in

Agents

/

Overview

Getting started

Quick start

Add to existing project

Testing your Agents

Concepts

What are agents?

Conversation state and memory

Tools

Calling LLMs

Using Agents with Workflows

Agentic patterns

Overview

Human-in-the-loop patterns

Long-running agents

Communication channels

Chat

Chat agents

Autonomous responses

Client SDK

Voice

Email

Slack

Webhooks

Overview

Push notifications

Tools

Sandbox

MCP

Browser

AI Search

Agentic Payments

Overview

Charge for HTTP content

x402

Overview

Charge for HTTP content

Charge for MCP tools

Pay from Agents SDK

Pay from coding tools

MPP (Machine Payments Protocol)

Code Mode

Overview

Create a durable Code Mode runtime

AI SDK integration

Use Code Mode with TanStack AI

Browser-owned tools

MCP

OpenAPI

How Code Mode works

Code Mode API reference

Harnesses

Overview

Think

Overview

Getting started

Configuration

Tools

Actions

Lifecycle hooks

Client tools

Messengers

Channels

Scheduled tasks

Workflows

Sub-agent RPC and programmatic turns

Programmatic submissions

Durable recovery

Runtime

Agents API

Lifecycle

Agent class internals

Callable methods

Store and sync state

Sessions

getCurrentAgent()

Communication

Routing

WebSockets

HTTP and Server-Sent Events

Chat SDK

Protocol messages

Readonly connections

Execution

Sub-agents

Schedule tasks

Durable execution with fibers

Queue tasks

Retries

Run Workflows

Agents as tools

Agent Skills

Operations

Configuration

Cross-domain authentication

Using AI Models

Observability

Examples

Chat agent

Slack agent

Voice agent

Browser agent

Email agent

Model Context Protocol (MCP)

Overview

APIs

MCP handler APIs

McpAgent

McpClient

Protocol

Tools

Authorization

Transport

MCP governance

Guides

Build MCP client

Build a Remote MCP server

Test a Remote MCP Server

Securing MCP servers

Connect to an MCP server

Handle OAuth with MCP servers

Migrate to MCP SDK v2

Build a single-tool Code Mode MCP server

Build a search and execute MCP server

Cloudflare

MCP server portals ↗

Cloudflare's own MCP servers

Overview

Cloudflare Community MCP Server

Code Mode MCP server patterns

Platform

Limits

Agent resources

Agent setup ↗

Cloudflare Skills ↗

Code Mode MCP Server ↗

Domain-specific MCP Servers ↗MCP

Agents llms.txt ↗

Agents llms-full.txt ↗

Cloudflare Docs llms.txt ↗

Cloudflare Docs llms-full.txt ↗

Home

/Agents

/Getting started

/Testing your Agents

Testing your Agents

Last updated Apr 30, 2026|Copy as Markdown|View as Markdown|Agent setup

OverviewWriting and running tests Setup Write a test Run testsRunning Agents locally

Because Agents run on Cloudflare Workers and Durable Objects, they can be tested using the same tools and techniques as Workers and Durable Objects.

Writing and running tests

Setup

Note

The agents-starter template and new Cloudflare Workers projects already include the relevant vitest and @cloudflare/vitest-pool-workers packages, as well as a valid vitest.config.js file.

Before you write your first test, install the necessary packages:
npm install vitest@^4.1.0 @cloudflare/vitest-pool-workers --save-dev
Ensure that your vitest.config.js has the cloudflareTest plugin configured:
import { cloudflareTest } from "@cloudflare/vitest-pool-workers";import { defineConfig } from "vitest/config";export default defineConfig({ plugins: [ cloudflareTest({ wrangler: { configPath: "./wrangler.jsonc" }, }), ],});

Write a test

Note

Review the Vitest documentation ↗ for more information on testing, including the test API reference and advanced testing techniques.

Tests use the vitest framework. A basic test suite for your Agent can validate how your Agent responds to requests, but can also unit test your Agent's methods and state.
import { env, exports } from "cloudflare:workers";import { createExecutionContext, waitOnExecutionContext,} from "cloudflare:test";import { describe, it, expect } from "vitest";import worker from "../src";import { Env } from "../src";interface ProvidedEnv extends Env {}describe("make a request to my Agent", () => { // Unit testing approach it("responds with state", async () => { // Provide a valid URL that your Worker can use to route to your Agent // If you are using routeAgentRequest, this will be /agents/:agent/:name const request = new Request<unknown, IncomingRequestCfProperties>( "http://example.com/agents/my-agent/agent-123", ); const ctx = createExecutionContext(); const response = await worker.fetch(request, env, ctx); await waitOnExecutionContext(ctx); expect(await response.json()).toEqual({ hello: "from your agent" }); }); it("also responds with state", async () => { const request = new Request("http://example.com/agents/my-agent/agent-123"); const response = await exports.default.fetch(request); expect(await response.json()).toEqual({ hello: "from your agent" }); });});

Run tests

Running tests is done using the vitest CLI:
npm run test# or run vitest directlynpx vitest MyAgent ✓ should return a greeting (1 ms)Test Files 1 passed (1)
Review the documentation on testing for additional examples and test configuration.

Running Agents locally

You can also run an Agent locally using the wrangler CLI:
npx wrangler devYour Worker and resources are simulated locally via Miniflare. For more information, see: https://developers.cloudflare.com/workers/testing/local-development.Your worker has access to the following bindings:- Durable Objects: - MyAgent: MyAgent Starting local server...[wrangler:inf] Ready on http://localhost:53645
This spins up a local development server that runs the same runtime as Cloudflare Workers, and allows you to iterate on your Agent's code and test it locally without deploying it.

Visit the wrangler dev ↗ docs to review the CLI flags and configuration options.

PreviousAdd to existing projectNextWhat are agents?

Was this helpful?

YesNo

Edit pageReport issue

On this page

Overview

Writing and running tests

Setup

Write a test

Run tests

Running Agents locally

Edit pageReport issue

Getting started
PlansContact salesPartnersFind a partnerStartupsUnder attack?Domain name search

Company
AboutCareersInvestorsPressPress kitGlobal network

Public interest
Project GalileoAthenian ProjectCloudflare for CampaignsProject FairshotImpact/ESG

Compliance
Compliance resourcesTrust HubData ProtectionResponsible AITransparency reportReport abuse

Resources
App innovation reportCloudflare RadarCase studiesStatusSupportEventsBlog

Developers
DocumentationLearning centerCommunity

Solutions
SSE and SASE platformCloudflare AI CloudAI SecurityFrontend Development PlatformMulti-Tenant Platform DevelopmentWeb Security Platform

Start BuildingLog In

© 2026 Cloudflare, Inc.

Privacy policy|Report security issues|Terms of use|Trademark
|
Your privacy choices

Docs

------
导航页打开网址