Quickstart

Prerequisites

• Node.js 22+
• A Schift API key (get one here)

Create a project

npx create-schift@latest

Follow the prompts:

• Project name: my-agent
• Template: cs-chatbot
• API key: paste your sch_... key

Start the dev server

cd my-agent
npm run dev

Open http://localhost:3787 in your browser. You’ll see a chat interface.

Try it out

Type a question in the chat. The agent searches your documents and responds with answers and citations.

What just happened?

The template created an agent with:

import { Schift, Agent, RAG } from "@schift-io/sdk";

const schift = new Schift({ apiKey: process.env.SCHIFT_API_KEY });
const rag = new RAG({ bucket: "support-docs" }, schift.transport);

const agent = new Agent({
  name: "Support Bot",
  instructions: "Answer questions using the knowledge base.",
  rag,
  model: "gpt-4o-mini",
  transport: schift.transport,
});

• Schift connects to Schift Cloud
• RAG wraps a document bucket (OCR, chunking, embedding, search — all managed)
• Agent runs a ReAct loop: receive question -> search docs -> generate answer

Next steps

• Agent concepts — how the ReAct loop works
• Tools — add custom capabilities to your agent
• RAG — upload documents and configure search