Início rápido
Do zero ao primeiro pedido
Em cerca de 10 minutos: instalar, conectar sua IA e seus dados, e fazer o primeiro pedido em português.
1
Instale o SDK
O Vardy está em acesso antecipado. O pacote é entregue sob solicitação (fale com a gente pela página inicial).
bash
npm install reliant-js # nome provisório do pacote; passará a ser "vardy"
npm install @modelcontextprotocol/sdk # opcional: só se for usar servidores MCP
2
Crie sua chave no painel
Em Compose → API keys, clique em Create key e copie a chave. Ela aparece uma única vez.
3
Conecte sua IA
O Vardy usa o modelo que você já usa, com a sua chave. Exemplo com OpenAI:
typescript
import { Compose } from 'reliant-js'
const llm = (model) => async (prompt) => {
const r = await fetch('https://api.openai.com/v1/chat/completions', {
method: 'POST',
headers: { Authorization: `Bearer ${process.env.OPENAI_API_KEY}`, 'Content-Type': 'application/json' },
body: JSON.stringify({ model, temperature: 0, messages: [{ role: 'user', content: prompt }] }),
})
return (await r.json()).choices[0].message.content
}
const vardy = new Compose({
generate: llm('gpt-4.1'), // escreve os programas
judge: llm('gpt-4.1-mini'), // opcional: classifica textos dentro do programa
apiKey: process.env.VARDY_API_KEY, // liga ao painel (regras, receitas, histórico)
})
4
Conecte seus dados
O jeito mais rápido é o banco, somente leitura. Use um usuário do banco que só tenha permissão de leitura.
typescript
import pg from 'pg'
const pool = new pg.Pool({ connectionString: process.env.DATABASE_URL_READONLY })
await vardy.connectDatabase({
name: 'erp', dialect: 'postgres',
query: async (sql, params) => (await pool.query(sql, params)).rows,
hiddenColumns: ['cpf', 'senha_hash'],
})
5
Faça o primeiro pedido
typescript
const r = await vardy.explore({
goal: 'Quais clientes têm mais valor vencido há mais de 30 dias?',
user: req.user,
})
console.log(r.answer)
await vardy.flush() // em funções serverless: envia o registro ao painel antes de encerrar
Para alterar dados (cancelar, enviar, atualizar), cadastre funções do seu sistema com
register. Elas passam por plano, regras e aprovação. Veja Conectar sistemas.