createAgent

createAgent is the high-level entrypoint for chat orchestration.

Minimal usage

import {
  createAgent,
  createInMemoryWorkflowRegistry,
  getProvider,
  initializeProviders,
} from "kortyx";
import { generalChatWorkflow } from "@/workflows/general-chat.workflow";

const registry = createInMemoryWorkflowRegistry([generalChatWorkflow], {
  fallbackId: "general-chat",
});

export const agent = createAgent({
  workflowRegistry: registry,
  loadRuntimeConfig: (options?: { sessionId?: string }) => ({
    session: { id: options?.sessionId ?? "anonymous-session" },
    ai: { googleApiKey: process.env.GOOGLE_API_KEY },
  }),
  getProvider,
  initializeProviders,
  fallbackWorkflowId: "general-chat",
});

Workflow source resolution

createAgent can resolve workflows from:

selectWorkflow function
workflowRegistry
workflowsDir
kortyx.config.mjs (loaded via loadKortyxConfig)
fallback default: ./src/workflows

Config knobs

Useful fields in CreateAgentArgs:

defaultWorkflowId
fallbackWorkflowId
config / configPath
frameworkAdapter
memoryAdapter
selectWorkflow or workflowRegistry

Result object:

const response = await agent.processChat(messages, options);