DocumentationConversations & Threads

Conversations & Threads

Understand how Cevvo manages multi-turn conversations and conversation history.

Overview

Every chat interaction in Cevvo happens within a thread. Threads maintain context across multiple messages, allowing the AI to reference previous questions and answers in the conversation. Each thread has a unique ID that you can use to continue conversations via the API or widget.

Key Concepts

Threads

A thread groups related messages into a single conversation. Pass a thread_id to continue an existing conversation.

Context Window

Cevvo automatically includes relevant previous messages as context, so the AI understands follow-up questions.

Source Citations

Each AI response includes references to the knowledge base sources it used, with relevance scores.

Streaming

Use the /chat/stream endpoint to receive responses in real-time as they are generated.

Conversation Lifecycle

1

User sends a message

A new thread is created automatically if no thread_id is provided, or the message is added to an existing thread.

2

Retrieval

Cevvo searches your knowledge base for the most relevant content chunks using semantic search.

3

Generation

The AI model generates a response using the retrieved context and conversation history.

4

Response delivered

The answer is returned with source citations. The conversation is stored for future reference and analytics.

Viewing Conversations

All conversations are accessible from the Conversations page in your dashboard. You can view full message history, see which sources were cited, and filter by date or status. Conversations can also be exported or deleted via the API.