Agents in Your App Template

1
import { Recursiv } from '@recursiv/sdk';
2
3
const r = new Recursiv();
4
5
// Create the agent once (script, migration, or dashboard)
6
const { data: agent } = await r.agents.create({
7
  project_id: process.env.RECURSIV_PROJECT_ID!,
8
  name: 'In-App Assistant',
9
  model: 'anthropic/claude-sonnet-4.6',
10
  system_prompt: 'You help users inside our product. Be concise and accurate.',
11
});

1
// Express, Next.js route handler, or any Node server
2
import { Recursiv } from '@recursiv/sdk';
3
4
const r = new Recursiv();
5
6
export async function handleChat(req, res) {
7
  const { agentId, message } = req.body;
8
9
  res.setHeader('Content-Type', 'text/plain; charset=utf-8');
10
  for await (const chunk of r.agents.chatStream(agentId, { message })) {
11
    res.write(chunk.delta ?? '');
12
  }
13
  res.end();
14
}

1
const res = await fetch('/api/chat', {
2
  method: 'POST',
3
  headers: { 'Content-Type': 'application/json' },
4
  body: JSON.stringify({ agentId, message }),
5
});
6
7
const reader = res.body!.getReader();
8
const decoder = new TextDecoder();
9
while (true) {
10
  const { value, done } = await reader.read();
11
  if (done) break;
12
  appendToUI(decoder.decode(value)); // your existing render function
13
}