# building-ai-agent-on-cloudflare

Генерирует код AI-агентов на Cloudflare Agents SDK с WebSockets и Durable Objects. Помогает настроить персистентное состояние, вызовы моделей и отложенные задачи в Workers.

- скилл · `type=skill` · Codex, ChatGPT · 2 установки · ★ 7604
- Автор: Cloudflare · официальный репозиторий OpenAI
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/openai/plugins/tree/HEAD/plugins/cloudflare/skills/building-ai-agent-on-cloudflare/SKILL.md
- Обновлён: 2026-10-08
- HTML: https://affpapa.org/nevibecode/skills/building-ai-agent-on-cloudflare

## Что делает

Скилл инструктирует модель генерировать сервисы на Cloudflare Agents SDK вместо устаревших подходов. Архитектура опирается на Durable Objects. Каждый агент держит состояние в памяти, синхронизирует его с клиентами через метод `setState` или сохраняет документы во встроенную базу SQLite с помощью тега `this.sql`.

Клиенты подключаются по протоколу WebSocket. Логика распределяется по хукам `onConnect`, `onMessage` и `onClose`. Для генерации ответов код связывается с привязкой Workers AI, запуская модели уровня `@cf/meta/llama-3-8b-instruct`. Кроме потокового чата поддерживается планировщик `this.schedule`, который запускает отложенные вызовы методов через заданное количество секунд или по конкретной дате.

Для запуска сгенерированного проекта требуются аккаунт Cloudflare с доступом к Workers, Node.js 18+ и утилита Wrangler CLI. В инструкциях скилл принудительно требует искать свежую документацию Cloudflare вместо использования базовых весов нейросети.

## Установка

### Codex (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add openai/plugins --skill building-ai-agent-on-cloudflare -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/building-ai-agent-on-cloudflare/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Claude Code

1. **Через Skills CLI (Vercel)**
```bash
npx skills add openai/plugins --skill building-ai-agent-on-cloudflare -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/building-ai-agent-on-cloudflare/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/building-ai-agent-on-cloudflare/

### Cursor

**Вручную: положить файлы**
- Файл: `.cursor/skills/building-ai-agent-on-cloudflare/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install openai/plugins building-ai-agent-on-cloudflare
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/building-ai-agent-on-cloudflare/SKILL.md`

### Gemini CLI

**Командой платформы**
```bash
gemini skills install https://github.com/openai/plugins --path plugins/cloudflare/skills/building-ai-agent-on-cloudflare
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/building-ai-agent-on-cloudflare/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/openai/plugins/tree/HEAD/plugins/cloudflare/skills/building-ai-agent-on-cloudflare/SKILL.md

## Когда брать
- Развернуть стейтфул-агента на Cloudflare Workers и Durable Objects
- Настроить WebSocket-соединение с синхронизацией состояния между клиентами
- Подключить привязку Workers AI для генерации ответов внутри агента
- Запланировать фоновые задачи через встроенный метод schedule

## Примеры запросов агенту
- Создай чат-агента на Cloudflare Agents SDK с сохранением истории диалога
- Напиши класс агента на Durable Objects с обработкой WebSocket и SQLite-таблицей
- Сделай фоновую задачу через this.schedule для отправки напоминания через час

## Похожие
- [setup-matt-pocock-skills](https://affpapa.org/nevibecode/skills/setup-matt-pocock-skills.md) — скилл · 1052851 установка
- [ask-matt](https://affpapa.org/nevibecode/skills/ask-matt.md) — скилл · 766587 установок
- [to-tickets](https://affpapa.org/nevibecode/skills/to-tickets.md) — скилл · 711230 установок
- [writing-plans](https://affpapa.org/nevibecode/skills/writing-plans.md) — скилл · 282859 установок
- [caveman-review](https://affpapa.org/nevibecode/skills/caveman-review.md) — скилл · 411800 установок
- [caveman-compress](https://affpapa.org/nevibecode/skills/caveman-compress.md) — скилл · 411500 установок

Из того же набора: [openai/plugins](https://affpapa.org/nevibecode/by/openai/plugins.md) — 528 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md