Framework TypeScript para criar agentes de IA com memória, ferramentas, MCP, RAG, voz e workflows, além do console VoltOps para observabilidade.
10,8 mil1,4 milTypeScriptMITAtualizado há 5 dias
cloudflare/agents
SDK em TypeScript para criar agentes de IA persistentes e com estado na Cloudflare Durable Objects, com sincronização em tempo real, agendamento e suporte a MCP.
- Estrelas
- 5,854
- Forks
- 787
- Issues abertas
- 171
- Último commit
- há 7 horas
O que é?
Cloudflare Agents é um SDK para executar agentes de IA como unidades persistentes e com estado na Durable Objects da Cloudflare. Cada agente mantém seu próprio estado e armazenamento, entra em hibernação quando fica ocioso e desperta quando necessário. Assim, é possível criar um agente para cada usuário, sessão ou sala de jogo.
O pacote principal, `agents`, oferece uma classe base `Agent`, com estado sincronizado em tempo real com os clientes conectados, métodos invocáveis expostos pelo decorator `@callable()` e suporte integrado a agendamento, WebSockets, consultas SQL e chamadas a modelos de IA. A integração com o frontend está disponível por meio de hooks do React, como `useAgent` e `useAgentChat`, além de um cliente vanilla JS.
O repositório é um monorepo pnpm que também inclui pacotes para chat com IA, uma abordagem Code Mode em que LLMs escrevem TypeScript executável, um bundler de runtime para Workers e middleware para Hono, além de mais de 30 apps de exemplo.
Recursos principais
- 01Estado persistente dos agentes, sincronizado em tempo real com todos os clientes conectados
- 02Métodos invocáveis com segurança de tipos por meio do decorator @callable()
- 03Agendamento de tarefas pontuais, recorrentes e baseadas em cron
- 04Suporte a servidores e clientes MCP
- 05Workflows duráveis de várias etapas, com aprovação humana no processo
- 06Hooks do React e cliente vanilla JS para integração com o frontend
Casos de uso
- Criar um assistente de IA por usuário, com memória persistente e histórico de conversas
- Criar salas de jogos multiplayer em tempo real, cada uma representada por um agente
- Disponibilizar ferramentas para LLMs por meio de servidores MCP hospedados no Cloudflare Workers
- Executar tarefas em segundo plano agendadas que chamam modelos de IA
Início rápido
- 1
Crie um novo projeto a partir do template inicial
npm create cloudflare@latest -- --template cloudflare/agents-starter - 2
Ou adicione o SDK a um projeto existente
npm install agents - 3
Execute um exemplo localmente a partir do repositório (por exemplo, o playground)
cd examples/playground npm start
Antes de usar
- É baseado no Cloudflare Durable Objects, por isso foi projetado para rodar na plataforma Cloudflare.
- No momento, não estamos aceitando pull requests externos.
Tópicos
Perguntas frequentes
- O que é agents?
- SDK em TypeScript para criar agentes de IA persistentes e com estado na Cloudflare Durable Objects, com sincronização em tempo real, agendamento e suporte a MCP. Cloudflare Agents é um SDK para executar agentes de IA como unidades persistentes e com estado na Durable Objects da Cloudflare. Cada agente mantém seu próprio estado e armazenamento, entra em hibernação quando fica ocioso e desperta quando necessário. Assim, é possível criar um agente para cada usuário, sessão ou sala de jogo.
- agents é gratuito? Qual é a licença?
- agents é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
- agents ainda é mantido?
- Manutenção ativa. O último commit de agents foi em 20 de out. de 2026.
- Para que posso usar agents?
- Criar um assistente de IA por usuário, com memória persistente e histórico de conversas Criar salas de jogos multiplayer em tempo real, cada uma representada por um agente Disponibilizar ferramentas para LLMs por meio de servidores MCP hospedados no Cloudflare Workers Executar tarefas em segundo plano agendadas que chamam modelos de IA
- Como instalar agents?
- Crie um novo projeto a partir do template inicial: npm create cloudflare@latest -- --template cloudflare/agents-starter Ou adicione o SDK a um projeto existente: npm install agents Execute um exemplo localmente a partir do repositório (por exemplo, o playground): cd examples/playground npm start
- Onde consigo agents?
- O código-fonte e as instruções de instalação estão no GitHub: https://github.com/cloudflare/agents
Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.
Projetos relacionados
SDK open source para criar e executar agentes de IA em Python e TypeScript, com ferramentas, MCP, memória e portabilidade entre modelos.
8,9 mil1,4 milTypeScriptApache-2.0Atualizado há 20 horas
SDKs para TypeScript e Python que dão a agentes de IA acesso a mais de 1.000 toolkits de apps pré-autenticados, sessões por usuário e um sandbox para executar ações.
30,6 mil4,9 milTypeScriptMITAtualizado há 10 horas
Uma biblioteca JavaScript que incorpora um agente de interface gráfica a qualquer página web, permitindo que usuários controlem a interface usando linguagem natural.
29,5 mil2,9 milTypeScriptMITAtualizado há 22 horas
Framework em TypeScript para criar agentes de IA e aplicações com LLMs, com workflows, tools, memória, servidores MCP e evals.
28,9 mil3 milTypeScriptOtherAtualizado há 7 horas
Um servidor MCP open source que conecta agentes de IA, IDEs e aplicativos a bancos de dados por meio de ferramentas prontas ou definições personalizadas.
16,7 mil1,8 milGoApache-2.0Atualizado há 4 dias