Conversations & follow-ups

Every turn belongs to a conversation. Finn keeps the context of a conversation server-side, so follow-up questions understand what came before — you just need to thread the conversationId (conversation_id in Python).

Start a conversation, then follow up

Node.js
Python

// First question — no conversationId, so Finn starts a new conversation.
const first = finn.sendMessage('How many active members do I have?');
for await (const c of first) process.stdout.write(c.text);
const { conversationId } = await first.completed;

// Follow-up — pass the id back, and Finn keeps the context.
const second = finn.sendMessage('How many joined in the last 90 days?', {
  conversationId,
});
for await (const c of second) process.stdout.write(c.text);
await second.completed;

# First question — no conversation_id, so Finn starts a new conversation.
first = await finn.send_message("How many active members do I have?")
async for c in first:
    print(c.text, end="", flush=True)
result = await first.completed
conversation_id = result.conversation_id

# Follow-up — pass the id back, and Finn keeps the context.
second = await finn.send_message(
    "How many joined in the last 90 days?",
    conversation_id=conversation_id,
)
async for c in second:
    print(c.text, end="", flush=True)
await second.completed

Because the second call carries the conversation id, “in the last 90 days” is understood against the same members the first question was about.

Send options

sendMessage / send_message accepts these options (send options — SendMessageOptions in Node.js, keyword arguments in Python):

Option (Node.js)	Python	Type	Description
`conversationId`	`conversation_id`	`str`	Continue an existing conversation. Omit to start a new one (or continue the client’s current one).
`systemPrompt`	`system_prompt`	`str`	Per-conversation system-prompt override — honored only when creating a new conversation. See System prompts.

Persisting conversations

The conversation id is just a string — store it wherever you keep user state (a session, a database row, a cache) and reuse it later, even across process restarts or reconnects:

Node.js
Python

const turn = finn.sendMessage(userQuestion, { conversationId: saved ?? undefined });
const { conversationId } = await turn.completed;
await db.users.update(userId, { finnConversationId: conversationId });

turn = await finn.send_message(user_question, conversation_id=saved)
result = await turn.completed
await db.users.update(user_id, finn_conversation_id=result.conversation_id)