Threads allow you to easily create a conversation inside a Workflow. A thread is a collection of messages between a user and the AI. You can create as many threads as you want inside a Workflow:

​
Create a thread

First of all, you need to create a thread (think of it as a chat session).

​
SDK

const thread = await itzam.threads.create({
  workflowSlug: "customer-support",
  name: "Chat for user 123", // optional
  lookupKeys: ["user-123", "platform-web-app"], // optional
  contextSlugs: ["financial-docs", "admin-docs"], // optional
});

console.log(thread.id); // "thread_424242" (save this ID in your database)

​
API

curl -X POST https://itz.am/api/v1/threads \
  -H "Authorization: Bearer $ITZAM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"workflowSlug": "customer-support", "name": "Chat for user 123", "lookupKeys": ["user-123", "platform-web-app"], "contextSlugs": ["financial-docs", "admin-docs"]}'

​
Send messages

After creating a thread, you can use its ID when sending new messages. This will make the AI continue the conversation and remember all previous messages. 
const message = await itzam.generateText({
  threadId: "thread_424242",
  input: "Hello, I'm Gustavo, how are you?",
});

console.log(message.content); // "I'm doing well, thank you!"

// If you use the same thread ID, the AI will continue the conversation
const message = await itzam.generateText({
  threadId: "thread_424242",
  input: "What's my name?",
});

console.log(message.content); // "Your name is Gustavo"

​
Check threads

You can check how a thread is going by clicking in the threads option inside any run. Threads You can also use our API or SDKs to get the thread by its ID or by Workflow.

​
Check runs

You can check the runs using our API or SDKs.