메모리, 도구, MCP, RAG, 음성, 워크플로를 지원하는 AI 에이전트 구축용 TypeScript 프레임워크와 관측성을 위한 VoltOps 콘솔입니다.
cloudflare/agents
Cloudflare Durable Objects에서 실시간 상태 동기화, 작업 예약, MCP를 지원하는 영속적이고 상태를 유지하는 AI 에이전트를 만들기 위한 TypeScript SDK입니다.
- 스타
- 5,854
- 포크
- 787
- 열린 이슈
- 171
- 마지막 커밋
- 2시간 전
어떤 프로젝트인가요?
Cloudflare Agents는 Cloudflare Durable Objects에서 영속적이고 상태를 유지하는 단위로 AI 에이전트를 실행하기 위한 SDK입니다. 각 에이전트는 자체 상태와 스토리지를 보유하고, 유휴 상태에서는 대기하다가 요청이 있으면 깨어나므로 사용자, 세션, 게임 룸마다 에이전트를 하나씩 만들 수 있습니다.
핵심 패키지인 `agents`는 연결된 클라이언트와 상태를 실시간으로 동기화하는 기본 Agent 클래스, `@callable()` 데코레이터로 노출하는 호출 가능한 메서드, 그리고 작업 예약, WebSockets, SQL 쿼리, AI 모델 호출을 위한 기본 지원을 제공합니다. 프론트엔드에서는 `useAgent`, `useAgentChat` 같은 React hooks와 vanilla JS 클라이언트를 사용할 수 있습니다.
이 저장소는 pnpm 모노레포로, AI 채팅, LLM이 실행 가능한 TypeScript를 작성하는 Code Mode 방식, 런타임 Workers 번들러, Hono 미들웨어용 패키지와 30개 이상의 예제 앱도 포함합니다.
핵심 기능
- 01연결된 모든 클라이언트에 실시간으로 동기화되는 영속적 에이전트 상태
- 02`@callable()` 데코레이터를 통한 타입 안전한 호출 가능 메서드
- 03일회성, 반복 및 cron 기반 작업 예약
- 04MCP 서버 및 클라이언트 지원
- 05사람의 승인을 포함하는 영속적인 다단계 워크플로
- 06프론트엔드 통합을 위한 React hooks 및 vanilla JS 클라이언트
활용 사례
- 영속적 메모리와 채팅 기록을 갖춘 사용자별 AI 어시스턴트 구축
- 각 룸이 하나의 에이전트로 동작하는 실시간 멀티플레이어 게임 룸 생성
- Cloudflare Workers에서 호스팅하는 MCP 서버를 통해 LLM에 도구 제공
- AI 모델을 호출하는 예약 백그라운드 작업 실행
빠른 시작
- 1
스타터 템플릿으로 새 프로젝트 만들기
npm create cloudflare@latest -- --template cloudflare/agents-starter - 2
또는 기존 프로젝트에 SDK 추가하기
npm install agents - 3
저장소에서 예제(예: playground)를 로컬로 실행하기
cd examples/playground npm start
사용 전 알아둘 점
- Cloudflare Durable Objects를 기반으로 하므로 Cloudflare 플랫폼에서 실행되도록 설계되었습니다.
- 현재 외부 풀 리퀘스트는 받지 않습니다.
토픽
자주 묻는 질문
- agents은(는) 무엇인가요?
- Cloudflare Durable Objects에서 실시간 상태 동기화, 작업 예약, MCP를 지원하는 영속적이고 상태를 유지하는 AI 에이전트를 만들기 위한 TypeScript SDK입니다. Cloudflare Agents는 Cloudflare Durable Objects에서 영속적이고 상태를 유지하는 단위로 AI 에이전트를 실행하기 위한 SDK입니다. 각 에이전트는 자체 상태와 스토리지를 보유하고, 유휴 상태에서는 대기하다가 요청이 있으면 깨어나므로 사용자, 세션, 게임 룸마다 에이전트를 하나씩 만들 수 있습니다.
- agents은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
- agents은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
- agents은(는) 아직 유지보수되고 있나요?
- 활발히 유지보수 중. agents의 마지막 커밋은 2026년 10월 20일입니다.
- agents은(는) 어디에 사용할 수 있나요?
- 영속적 메모리와 채팅 기록을 갖춘 사용자별 AI 어시스턴트 구축 각 룸이 하나의 에이전트로 동작하는 실시간 멀티플레이어 게임 룸 생성 Cloudflare Workers에서 호스팅하는 MCP 서버를 통해 LLM에 도구 제공 AI 모델을 호출하는 예약 백그라운드 작업 실행
- 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를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.
관련 프로젝트
Python과 TypeScript에서 도구, MCP, 메모리, 모델 간 이식성을 갖춘 AI 에이전트를 만들고 실행하는 오픈소스 SDK입니다.
AI 에이전트에 1,000개 이상의 사전 인증 앱 툴킷, 사용자별 세션, 작업 실행용 샌드박스를 제공하는 TypeScript 및 Python SDK입니다.
웹페이지에 GUI 에이전트를 삽입해 사용자가 자연어로 인터페이스를 제어할 수 있게 하는 JavaScript 라이브러리입니다.
워크플로, 도구, 메모리, MCP 서버, 평가 기능을 갖춘 AI 에이전트 및 LLM 기반 애플리케이션 개발용 TypeScript 프레임워크입니다.
사전 구축 도구나 사용자 정의 도구 정의로 AI 에이전트, IDE, 앱을 데이터베이스에 연결하는 오픈소스 MCP 서버입니다.