Como criar

O Início Rápido mostrou uma chamada. Leia esta linha devagar, porque ela é o futuro inteiro em uma frase: com uma única Application Key, cada usuário do seu produto ganha milhares de conexões de IA desde o primeiro dia, cada usuário isolado com conectores, credenciais e capacidades próprios, e nenhum deles jamais exposto à Vinkius. Nenhuma plataforma do mercado oferece essa frase. Os cinco projetos completos desta seção mostram como ela fica em produção: um chatbot de consumo, copilots por departamento, uma frota de agentes, automações sem intervenção humana e um SaaS multi-tenant, cada um escrito para que um desenvolvedor comece no topo e termine com uma IA funcional agindo no mundo real.

O primitivo por baixo dos cinco é o que o resto da indústria não oferece: qualquer entidade que precise agir se torna um usuário. Análises de custo da indústria estimam em seis dígitos, ao longo de três anos, uma versão construída em casa dessa arquitetura, e mesmo assim ela nunca termina de ser entregue. No AI Connect SDK ela é a linha de largada, não a linha de chegada.

A ideia que destrava tudo

Em todos os tutoriais aparece a mesma linha:

const user = vinkius.user(externalId);

Esse externalId é um valor que você define. Não é uma conta Vinkius, não é um e-mail, não é um ser humano. É uma string opaca e segura para URL que seu backend já controla, e o SDK a trata como a fronteira que isola conectores, credenciais e capacidades. Como é opaca, pode nomear qualquer coisa que precise agir:

Perceba o quão radical isso é. Toda plataforma de conectividade que a indústria entregou até hoje conecta uma aplicação a um serviço. Nenhuma delas entrega ao seu produto o próprio modelo de usuários por entidade, com credenciais que o seu código jamais consegue ler de volta. A linha acima entrega, e essa é a diferença entre alugar conectividade para o seu app e possuir uma plataforma de conectividade para os seus usuários.

Escolha o seu projeto

O fluxo que todo projeto compartilha

Seja qual for a entidade que você modelar, o loop de execução é idêntico. Aprenda uma vez e construa todos os cinco de memória:

1. Crie um cliente no servidor a partir de uma única Application Key.
2. Identifique o ator: entregue ao vinkius.user(externalId) o id que é dono da ação.
3. Conecte um conector: user.connector('github').connect(), armazene credenciais uma vez, nunca as leia de volta.
4. Descubra capacidades: user.capabilities() retorna apenas o que este ator tem pronto.
5. Entregue ao modelo: um adapter converte o conjunto para OpenAI, Anthropic, Gemini, Vercel AI SDK, LangChain ou JSON Schema puro.
6. Execute e devolva: rode a chamada de tool do modelo; o isError deixa o agente se recuperar em vez de quebrar.

A vantagem defensável, por dentro

Todos os projetos abaixo se apoiam na mesma arquitetura, e compreendê-la é o que torna crível a promessa de que "a infraestrutura de integração não é sua", em vez de simples marketing.

• Dois planos, um segredo. Um plano de controle (users, connectors, credentials, catalog) sobre REST, e um plano de execução (listar e executar capacidades) que conversa via JSON-RPC diretamente com o runtime de cada conexão. Tudo é acessado por uma única chave vk_app_sk_*; o runtime usa o protocolo MCP internamente, mas isso jamais aparece no seu vocabulário.
• Medição e revogação por conexão. Cada conexão possui o próprio token de dados vk_live_*. Custo e revogação imediata operam por conexão, e é isso que permite isolar um departamento, um agente ou uma conta de serviço de forma financeira e operacional, não apenas lógica.
• Credenciais somente de escrita. Seu servidor armazena os segredos de conector de um usuário e pode ver quais campos estão configurados, mas nada, nem seu código, nem o modelo, nem o painel, consegue ler os valores de volta.
• Redação por padrão. Os hooks de observabilidade recebem dados já higienizados: Authorization, campos que aparentam credenciais e segmentos de URL vk_live_* são mascarados antes do seu callback executar.
• Zero dependências de runtime. fetch nativo, ESM/CJS e tipagem, roda em Node 18+, Bun, Deno e edge, então o mesmo alvo de build cobre um contêiner de cron e um Worker.
• Repetição e idempotência bem definidas. Falhas transitórias são repetidas automaticamente com backoff de jitter completo, e declarar um idempotencyKey é o que torna seguro repetir até uma escrita não-idempotente.

Antes de começar

Todos os projetos assumem os mesmos três pré-requisitos, detalhados em Instalação e Autenticação e escopo:

• Node.js 18+ ou qualquer runtime de servidor com fetch (Bun, Deno, edge, Cloudflare Workers)
• @vinkius/connect instalado
• Um App ID (vk_app_…) e uma Application Key (vk_app_sk_…) do Vinkius em variáveis de ambiente do servidor

Pronto? Nenhuma outra plataforma do mercado consegue hospedar esta seção, porque nenhuma oferece a sua premissa: a de que um usuário é qualquer entidade que precisa agir. Escolha um projeto e termine, com uma IA que age para todo usuário que você definir.