Comparações
Copilotz vs AI SDK da Vercel
O AI SDK é um kit para chamar modelos e montar interfaces de chat. O Copilotz é um runtime para o app inteiro. Eles trabalham em camadas diferentes; veja o que isso muda na prática, com uma fonte para cada afirmação.
Verificado em 12 de novembro de 2026.
Em resumo
O AI SDK da Vercel é um kit em TypeScript para apps e agentes de IA: o AI SDK Core chama modelos, com ferramentas, saída estruturada e agentes, e o AI SDK UI traz hooks de chat com streaming para React, Vue, Svelte e Angular. É a biblioteca mais usada do tipo, hoje na versão 7, com versões novas quase todo dia.
O Copilotz trabalha uma camada acima. É um runtime para o app inteiro: os dados, as Actions que mudam esses dados, quem pode chamá-las, como o app aparece numa página ou no prompt de um modelo, e um registro de cada escrita. O AI SDK deixa isso com você, de propósito: armazenamento, usuários, permissões e servir MCP são código seu.
Então a pergunta é quanto você quer construir por conta própria. Escolha o AI SDK para colocar chamadas de modelo e um chat num app que você já tem. Escolha o Copilotz quando quiser que o app, as regras e os agentes venham de um lugar só.
Escolha o AI SDK se…
- Você quer colocar chamadas de modelo, ferramentas ou um chat num app que já existe, mantendo o seu banco de dados, a sua autenticação e a sua hospedagem.
- Você quer a maior escolha de modelos atrás de uma API só, com o AI Gateway da Vercel como caminho padrão.
- Você quer hooks oficiais de chat com steaming para React, Vue, Svelte e Angular.
- Você quer a biblioteca mais adotada do tipo: cerca de 44,8 milhões de downloads semanais no npm, e uma versão 7.x estável.
- Você precisa de um cliente MCP, para usar as ferramentas de servidores MCP de fora.
Escolha o Copilotz se…
- Você prefere não construir o que o SDK deixa com você: armazenamento, usuários e permissões, um registro de quem fez o quê, e um servidor MCP.
- Os seus agentes e os assistentes de fora devem agir pelas mesmas Actions da sua página web, sob as mesmas regras.
- Você quer o seu app servido por MCP, com widgets no ChatGPT e no Claude, e no WhatsApp, a partir dos mesmos plugins.
- Você quer testar o app inteiro offline, incluindo as respostas do agente, com um modelo roteirizado, e um release candidate serve para você.
Lado a lado
Cada afirmação aponta para a sua fonte. Os números mudam: estes foram lidos em 12 de novembro de 2026.
| Aspecto | Copilotz | AI SDK |
|---|---|---|
| O que é | Copilotz:Um runtime para apps que pessoas e IA usam do mesmo jeito. Você escreve o app uma vez, em plugins: os dados, as Actions, quem pode chamá-las e como ele aparece.[1] | AI SDK:Um kit em TypeScript para apps e agentes de IA: o AI SDK Core chama modelos, com ferramentas e agentes; o AI SDK UI monta interfaces de chat.[2] |
| Onde roda | Copilotz:Node 24 ou mais novo, Deno e Bun. Feito sobre padrões da web, também para Cloudflare Workers e o navegador.[1][3] | AI SDK:Qualquer ambiente JavaScript, como Node.js, Deno e o navegador. A versão 7 exige Node 22 ou mais novo e é só ESM.[4][5] |
| Agentes, ferramentas e fluxos | Copilotz:Agentes são configuração: instruções, um modelo e ferramentas. Uma ferramenta só chama uma Action, a mesma que a página web e o MCP chamam. Processors reagem a eventos; agendamentos e rotinas rodam trabalho no horário.[1][3] | AI SDK:generateText e streamText com ferramentas, vários passos com stopWhen, e a classe ToolLoopAgent. Fluxos duráveis vêm de um pacote separado, o Workflow DevKit.[6][7][8] |
| Memória | Copilotz:O plugin history resume conversas longas; o plugin memory lembra entre elas, por significado com um modelo de embeddings, ou por palavras sem ele.[3][9] | AI SDK:O SDK não guarda: você salva as mensagens, como mostra o guia de persistência dele. Memória de longo prazo vem de provedores como Mem0 ou Letta, ou de uma ferramenta sua.[10][11] |
| MCP (cliente e servidor) | Copilotz:Servidor: o plugin mcp oferece as ferramentas do app ao ChatGPT, ao Claude e a qualquer cliente MCP, e desenha as Views web dentro deles como widgets. Ainda sem login no MCP: cada conversa entra como um contato. Cliente: não oferece; a documentação não usa servidores MCP de fora como ferramentas.[3][12][13] | AI SDK:Cliente: createMCPClient (@ai-sdk/mcp), por HTTP, SSE ou stdio. Servidor: não está no SDK; o pacote separado mcp-handler, da Vercel, hospeda um.[14][15] |
| Autenticação e regras de acesso | Copilotz:Embutido, sob MIT. Toda chamada diz quem age, para quem e onde. Cada Action diz quem pode chamá-la (allow), e isso vale para o agente e para quem ele trabalha. Regras no dado filtram toda leitura e checam toda escrita, seja qual for a porta.[1][3] | AI SDK:Sem usuários, papéis ou regras de dados embutidos: isso é código seu. Ferramentas podem pedir aprovação antes de rodar, e um pacote opcional leva as regras de aprovação para o Open Policy Agent.[6][10][16] |
| Persistência | Copilotz:Um só armazenamento para tudo: em memória, SQLite ou PostgreSQL, os três sob a mesma suíte de conformidade. Trocar de um para outro muda uma linha.[17] | AI SDK:Nenhuma embutida: o banco de dados é seu.[10] |
| Observabilidade | Copilotz:Toda escrita e toda chamada de Action é um evento que diz quem agiu, para quem e onde. As métricas seguem o modelo do OpenTelemetry, exportadas por OTLP ou em texto do Prometheus.[3][18] | AI SDK:OpenTelemetry, pelo pacote @ai-sdk/otel.[19] |
| Testes | Copilotz:O app inteiro testado offline, com um modelo roteirizado e um relógio manual, sem chave de API. copilotz/testing é uma só API de testes para Node, Deno e Bun.[1][3] | AI SDK:Modelos falsos e utilitários em ai/test (como o MockLanguageModelV4) e simulateReadableStream, para testar sem chamar um provedor.[20] |
| Deploy | Copilotz:Você hospeda: um servidor web em Node e o armazenamento que o ambiente define, SQLite ou PostgreSQL, com um lease para que cada deploy passe a vez sem dois processos escrevendo.[21] | AI SDK:Uma biblioteca: roda dentro do seu app, na Vercel ou em qualquer outra hospedagem.[5] |
| Canais | Copilotz:Página web, terminal, API REST e cliente, MCP com widgets, WhatsApp (Cloud API da Meta), ligações de voz (Twilio) e um chat no seu site.[3] | AI SDK:Nenhum no SDK. O Chat SDK, separado, da Vercel, cria bots para Slack, Teams, Google Chat, Discord, Telegram e outros.[22] |
| Licença | Copilotz:MIT.[3] | AI SDK:Apache 2.0.[5] |
| Maturidade | Copilotz:Release candidate: 1.0.0-rc.45, de 12 de novembro de 2026. O 1.0 ainda não saiu. Um projeto jovem, com uma comunidade pequena.[23] | AI SDK:Estável: versão 7 desde 25 de junho de 2026; ai 7.0.171 em 12 de novembro de 2026. Cerca de 27.900 estrelas no GitHub e 44,8 milhões de downloads por semana no npm.[24][25][26][27] |
| Ecossistema | Copilotz:Provedores de modelo por quatro protocolos (OpenAI, compatível com OpenAI, Anthropic e Gemini). Plugins próprios para login, espaços, memória, skills, rotinas, quadros, documentos e cobrança. Poucas integrações de terceiros por enquanto.[3][28] | AI SDK:Dezenas de provedores de modelo, oficiais e da comunidade, o AI Gateway como caminho padrão, e hooks de chat para React, Vue, Svelte e Angular.[26][29][30] |
Uma ferramenta, em cada um
O AI SDK passa as ferramentas para uma chamada de modelo e roda o loop. O Copilotz declara a ferramenta num plugin, e ela chama uma Action que a página web e o MCP também chamam, sob as mesmas regras.
import { z } from 'zod';import { generateText, tool, isStepCount } from 'ai'; const result = await generateText({ model: "anthropic/claude-sonnet-5.5", tools: { weather: tool({ description: 'Get the weather in a location', inputSchema: z.object({ location: z.string().describe('The location to get the weather for'), }), execute: async ({ location }) => ({ location, temperature: 72 + Math.floor(Math.random() * 21) - 10, }), }), }, stopWhen: isStepCount(5), prompt: 'What is the weather in San Francisco?',});
Fonte: ai-sdk.dev: Tool calling
// From the README's salon.ts: one Action, three callers (excerpt).actions: { "booking.make": defineAction({ input: booking, // Asked of every caller, tools included: people, agents working for them, and contacts. allow: peopleOrContacts, run: (ctx, input) => ctx.db.collection("booking").insertOne(input), }),},views: { // What a model reads after it books, the app's own or one over MCP. "tool:book": (_, ctx) => ctx.show("bookings", {}),},resources: { // The rules: a booking lives in a space, and belongs to the chat it was made in. shared: { booking: { part: "thread" } }, tools: { book: tool({ description: "Books a slot, like 'Wed 15:00'.", input: { type: "object", properties: { slot: { type: "string" } }, required: ["slot"] }, run: ({ slot }, ctx) => ctx.call("booking.make", { slot, in: ctx.in, thread: ctx.thread }), }), }, agents: { concierge: { instructions: "Book slots.", model: "openai/gpt-5.4-mini", tools: ["book"] }, }, // An MCP server at /mcp/salon. No sign-in: each conversation is a contact, in its own chat. mcp: { salon: { in: "desk", tools: { book: {} } } },},
Fontes
O que dizemos sobre AI SDK vem da documentação, do repositório, do npm e dos anúncios do próprio projeto; o que dizemos sobre o Copilotz, da documentação e do repositório dele. Achou algo errado ou desatualizado? Escreva para hello@copilotz.com e a gente corrige.
- [1]copilotz.com: AGENTS.md
- [2]ai-sdk.dev: Introduction
- [3]GitHub: copilotzhq/copilotz (README)
- [4]ai-sdk.dev: Navigating the library
- [5]vercel.com: AI SDK
- [6]ai-sdk.dev: Tool calling
- [7]ai-sdk.dev: Loop control
- [8]ai-sdk.dev: WorkflowAgent
- [9]copilotz.com: the memory plugin
- [10]ai-sdk.dev: Message persistence
- [11]ai-sdk.dev: Memory
- [12]copilotz.com: the mcp plugin
- [13]copilotz.com: Getting Started
- [14]ai-sdk.dev: MCP tools
- [15]GitHub: vercel-labs/mcp-handler
- [16]ai-sdk.dev: Policy tool approvals
- [17]copilotz.com: Stores
- [18]copilotz.com: Metrics
- [19]ai-sdk.dev: Telemetry
- [20]ai-sdk.dev: Testing
- [21]copilotz.com: Shipping the salon
- [22]ai-sdk.dev: Chat platforms
- [23]GitHub: Copilotz releases
- [24]vercel.com: AI SDK 7
- [25]npm: ai
- [26]GitHub: vercel/ai
- [27]npm: ai downloads, 5–11 Nov 2026
- [28]copilotz.com: the models plugin
- [29]ai-sdk.dev: Providers
- [30]ai-sdk.dev: AI SDK UI
Veja por conta própria.
O guia constrói um app, para pessoas e para IA, em dez capítulos, e os testes rodam offline.
Ler o guia