SDK
Conversations
Conversation-first agent and assistant interactions, including instructions, metadata, streaming, and final output.
Create, then send
const thread = await client.conversations.createForAgent("triage_agent", {
title: "Triage ticket ticket_123",
instructions: "Triage the ticket, propose the next owner, and explain confidence.",
metadata: { source: "support_queue", ticket_id: "ticket_123" },
type: "TASK",
});
await client.conversations.messages.send(thread.id, {
content: JSON.stringify({
ticket_id: "ticket_123",
prompt: "Triage this ticket.",
}),
metadata: { source: "support_queue", ticket_id: "ticket_123" },
});React hook
const conversation = useConversationMessages({
client,
agentName: "triage_agent",
autoResume: true,
});
await conversation.createConversation({
title: "Triage ticket ticket_123",
instructions: "Return owner, priority, and reasoning.",
metadata: { ticket_id: "ticket_123" },
type: "TASK",
setActive: true,
});
await conversation.sendMessage("Please triage ticket_123.", {
conversationId: conversation.conversationId,
metadata: { ticket_id: "ticket_123" },
});Use the right surface
| Need | Surface |
|---|---|
| List previous conversations | useConversations |
| Load one conversation | useConversation |
| Stream messages and final output | useConversationMessages |
| Build full assistant UI behavior | useAssistantController / useAssistantRuntime |
| Inspect agent input schema | useAgentInputSchema |