Repolode
Предложить
cloudflare

cloudflare/agents

TypeScript SDK для создания постоянных ИИ-агентов с сохранением состояния на Cloudflare Durable Objects, синхронизацией в реальном времени, планировщиком задач и поддержкой MCP.

Открыть на GitHubСайт
Звёзды
5,854
Форки
787
Открытые issues
171
Последний коммит
5 часов назад

Что это?

Cloudflare Agents — это SDK для запуска ИИ-агентов в виде постоянных сущностей с собственным состоянием на Cloudflare Durable Objects. У каждого агента есть своё состояние и хранилище; в периоды бездействия он переходит в спящий режим и пробуждается по запросу. Благодаря этому можно создавать отдельного агента для каждого пользователя, сеанса или игровой комнаты.

Основной пакет `agents` предоставляет базовый класс Agent, состояние которого синхронизируется с подключёнными клиентами в реальном времени, вызываемые методы с декоратором `@callable()`, а также встроенную поддержку планирования задач, WebSockets, SQL-запросов и вызовов ИИ-моделей. Для интеграции с фронтендом доступны React-хуки, например `useAgent` и `useAgentChat`, а также клиент на vanilla JS.

Репозиторий представляет собой pnpm-монорепозиторий: в него также входят пакеты для ИИ-чата, подход Code Mode, в котором LLM пишут исполняемый TypeScript, сборщик Workers для runtime и middleware для Hono, а также более 30 примеров приложений.

Ключевые возможности

  • 01Постоянное состояние агента синхронизируется со всеми подключёнными клиентами в реальном времени
  • 02Типобезопасные вызываемые методы с декоратором `@callable()`
  • 03Планирование разовых и повторяющихся задач, а также задач по cron-расписанию
  • 04Поддержка MCP-серверов и клиентов
  • 05Долговременные многоэтапные рабочие процессы с подтверждением участия человека
  • 06React-хуки и клиент на vanilla JS для интеграции с фронтендом

Сценарии использования

  • Создание ИИ-помощника для каждого пользователя с постоянной памятью и историей чата
  • Создание игровых комнат для многопользовательских игр в реальном времени, где каждая комната представлена агентом
  • Предоставление LLM доступа к инструментам через MCP-серверы, размещённые на Cloudflare Workers
  • Запуск фоновых задач по расписанию, вызывающих ИИ-модели

Быстрый старт

  1. 1

    Создайте новый проект на основе стартового шаблона

    npm create cloudflare@latest -- --template cloudflare/agents-starter
  2. 2

    Или добавьте SDK в существующий проект

    npm install agents
  3. 3

    Запустите пример локально из репозитория (например, playground)

    cd examples/playground npm start

Что важно знать

  • Проект построен на Cloudflare Durable Objects и предназначен для работы на платформе Cloudflare.
  • В настоящее время внешние pull request не принимаются.

Темы

#ai-agents#cloudflare-workers#durable-objects#typescript#mcp#llm#websockets#serverless#agents#ai

Частые вопросы

Что такое agents?
TypeScript SDK для создания постоянных ИИ-агентов с сохранением состояния на Cloudflare Durable Objects, синхронизацией в реальном времени, планировщиком задач и поддержкой MCP. Cloudflare Agents — это SDK для запуска ИИ-агентов в виде постоянных сущностей с собственным состоянием на Cloudflare Durable Objects. У каждого агента есть своё состояние и хранилище; в периоды бездействия он переходит в спящий режим и пробуждается по запросу. Благодаря этому можно создавать отдельного агента для каждого пользователя, сеанса или игровой комнаты.
agents можно использовать бесплатно? Какая у него лицензия?
agents распространяется с открытым исходным кодом под лицензией MIT. Перед использованием в коммерческих продуктах проверьте условия лицензии.
agents всё ещё поддерживается?
Активно поддерживается. Последний коммит в agents — 20 окт. 2026 г..
Для чего можно использовать agents?
Создание ИИ-помощника для каждого пользователя с постоянной памятью и историей чата Создание игровых комнат для многопользовательских игр в реальном времени, где каждая комната представлена агентом Предоставление LLM доступа к инструментам через MCP-серверы, размещённые на Cloudflare Workers Запуск фоновых задач по расписанию, вызывающих ИИ-модели
Как установить agents?
Создайте новый проект на основе стартового шаблона: npm create cloudflare@latest -- --template cloudflare/agents-starter Или добавьте SDK в существующий проект: npm install agents Запустите пример локально из репозитория (например, playground): cd examples/playground npm start
Где скачать agents?
Исходный код и инструкции по установке — на GitHub: https://github.com/cloudflare/agents

Описание создано ИИ на основе README проекта. Статистика GitHub обновляется ежедневно.

Похожие проекты