Loading AgentsKit ecosystem navigation…
AgentsKit Chat
How to

Connect a backend

Mount createChatHandler and optional Ask backends for production chat.

View canonical Markdown

Connect a backend

Overview

Loading diagram...

Chat HTTP handler

code
import { createChatHandler } from '@agentskit/chat/server'
import { supportChat } from './chat'

export default createChatHandler({
  authenticate: async request => { /* … */ },
  resolveDefinition: () => supportChat,
  sessionStorage: () => storage,
})

Details: Server · recipes: Deployment.

Ask / grounded Q&A

code
import { createAskServiceHandler } from '@agentskit/chat/server'

export const POST = createAskServiceHandler({
  authenticate: /* … */,
  resolveSite: /* … */,
  retrievers: { local: { retrieve: /* AgentsKit RAG */ } },
  generator: /* AgentsKit provider */,
})

Full contract: Backend.

Sessions

Persist application metadata with CAS storage; messages stay in AgentsKit memory — Sessions.

Checklist

  1. Shared defineChat definition
  2. createChatHandler (or local adapter) for turns
  3. Optional Ask handler for grounded misses
  4. Auth + rate limits on the host
  5. Native renderer per client