sandbox-agent/examples/cloudflare/README.md
2026-02-23 19:31:54 +00:00

56 lines
1.1 KiB
Markdown

# Cloudflare Sandbox Agent Example
Deploy sandbox-agent inside a Cloudflare Sandbox.
## Prerequisites
- Cloudflare account with Workers Paid plan
- Docker running locally for `wrangler dev`
- `ANTHROPIC_API_KEY` or `OPENAI_API_KEY` for the coding agents
## Setup
1. Install dependencies:
```bash
pnpm install
```
2. Create `.dev.vars` with your API keys:
```bash
echo "ANTHROPIC_API_KEY=your-api-key" > .dev.vars
```
## Development
Start the development server:
```bash
pnpm run dev
```
Test the endpoint:
```bash
curl http://localhost:8787
```
Test prompt routing through the SDK with a custom sandbox fetch handler:
```bash
curl -X POST "http://localhost:8787/sandbox/demo/prompt" \
-H "Content-Type: application/json" \
-d '{"agent":"codex","prompt":"Reply with one short sentence."}'
```
The response includes `events`, an array of all recorded session events for that prompt.
## Deploy
```bash
pnpm run deploy
```
Note: Production preview URLs require a custom domain with wildcard DNS routing.
See [Cloudflare Production Deployment](https://developers.cloudflare.com/sandbox/guides/production-deployment/) for details.