Chat API

{
  messages: UIMessage[]      // Vercel AI SDK UIMessage format
  conversationId?: string    // omit to create a new conversation
  agentId?: string           // bypass routing and force a specific agent
  modelId?: string           // override the agent's default model
}

import { useChat } from "@ai-sdk/react";
 
const { messages, input, handleSubmit } = useChat({
  api: "/api/assistant/router",
  body: {
    agentId: "receipt-scanner", // optional
    modelId: "gpt-4o",          // optional
  },
  onResponse: (response) => {
    const conversationId = response.headers.get("x-conversation-id");
    // save to state for subsequent requests
  },
});

{
  messages: UIMessage[],
  conversation: {
    id: string,
    title: string,
    niche: string,
    workflowRun: {
      id: number,
      status: string,
      totalSteps: number,
      currentStepDescription: string,
      workflow: { id: string, title: string }
    } | null
  }
}