Início rápido
Você precisa do Node 20+ e de uma conta na Cloudflare (o plano gratuito basta). Os agentes rodam no Workers AI por padrão, então nenhuma chave de modelo é necessária para começar.
1. Baixe o template
git clone https://github.com/rubrion/rubry my-agents
cd my-agents
npm install
Você recebe dois Workers:
my-agents/
agents/ seus agentes (src/agents/) e ferramentas (src/tools/)
middleware/ chaves de API, provedor, página de configurações (client/)
docs/ os mesmos guias, no repositório
2. Defina os segredos locais
cp middleware/.dev.vars.example middleware/.dev.vars
Preencha os dois valores em middleware/.dev.vars (quaisquer textos aleatórios longos, por exemplo de openssl rand -hex 32):
| Segredo | Para que serve |
|---|---|
ADMIN_TOKEN | Faz login na página de configurações |
SECRET_KEY | Criptografa a chave do provedor de modelo no banco. Não perca nem mude depois de definir um provedor. |
3. Rode os dois Workers
npm run dev
Isso aplica a migração do banco e inicia os dois Workers juntos, o middleware em http://localhost:8787 ligado ao Worker de agentes. (Se o seu login da Cloudflare tem várias contas, defina CLOUDFLARE_ACCOUNT_ID antes: o Workers AI roda na sua conta mesmo em desenvolvimento local.)
4. Crie uma chave e chame a API
Abra http://localhost:8787, entre com seu ADMIN_TOKEN e crie uma chave de API. Depois:
curl -N http://localhost:8787/v1/chat/completions \
-H "Authorization: Bearer rk_…" \
-H "Content-Type: application/json" \
-d '{"model":"auto","stream":true,"messages":[{"role":"user","content":"Escreva um slogan de 6 palavras para uma loja de bicicletas"}]}'
A resposta chega em streaming, em chunks no formato da OpenAI. model pode ser auto (o planejador escolhe) ou o id de um agente (writer, researcher); GET /v1/models lista todos.