> ## Documentation Index
> Fetch the complete documentation index at: https://docs.buildbetter.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Chat Overview

> Understanding BuildBetter's AI-powered chat capabilities

## What is BuildBetter Chat?

BuildBetter's Chat is an AI-powered assistant that helps you:

* Ask questions about your calls, documents, and signals
* Extract insights and analyze patterns across your data
* Get contextual answers with direct citations to source material
* Research and explore your workspace content

## Key Features

<CardGroup cols={2}>
  <Card title="Context-Aware" icon="brain">
    Add calls, documents, and signals as context for targeted questions
  </Card>

  <Card title="Multi-Source Analysis" icon="layer-group">
    Analyze multiple recordings and documents simultaneously
  </Card>

  <Card title="Citation System" icon="link">
    Get answers with direct links to source timestamps and content
  </Card>

  <Card title="Thread Management" icon="messages">
    Organize conversations by topic with persistent chat threads
  </Card>
</CardGroup>

## How It Works

<Steps>
  <Step title="Create or Select Thread" stepNumber={1}>
    Start from **New Chat**, Home, or continue an existing conversation thread
  </Step>

  <Step title="Add Context (Optional)" stepNumber={2}>
    Drag calls, documents, or signals into the chat for focused analysis
  </Step>

  <Step title="Ask Questions" stepNumber={3}>
    Query your data using natural language questions
  </Step>

  <Step title="Follow Citations" stepNumber={4}>
    Click citations to jump directly to source material with timestamps
  </Step>
</Steps>

## New Chat

The `/new-chat` experience helps you start faster:

* Starter prompts for common workflows
* Quick actions
* Favorites
* An AI composer that creates a real chat thread as soon as you submit a prompt
* Working `@` mentions for adding relevant context

Recent chats are also available from the Home experience so you can resume prior work without searching through the full thread list.

## Primary Use Cases

### Data Analysis & Research

* Ask questions about specific calls or documents
* Find patterns across multiple recordings
* Research customer feedback and requests
* Analyze meeting outcomes and decisions

### Content Exploration

* Search for specific topics across your workspace
* Get summaries of calls or documents
* Understand context around signals and feedback
* Explore relationships between different data sources

## Context Management

<AccordionGroup>
  <Accordion title="Single Item Context">
    **When you add one call, document, or signal:**

    * Full transcript access for calls
    * Complete content analysis for documents
    * Detailed signal context and source material
    * Timestamp-specific citations in responses
  </Accordion>

  <Accordion title="Multiple Call Context">
    **When you add multiple calls, documents, or signals:**

    * Cross-item pattern analysis
    * Comparative insights across sources
    * Trend identification over time
    * Combined context for comprehensive answers
    * Citations show which specific sources were used
  </Accordion>
</AccordionGroup>

## Chat Interface Features

### Thread Management

* **Create new threads** for different topics or projects
* **Rename threads** to keep conversations organized
* **Delete threads** when no longer needed
* **Time-based organization** (Today, This Week, This Month)
* **Quick access** from the left sidebar

### Message Features

* **Real-time streaming** responses from AI
* **Rich citations** with links to source material and timestamps
* **Retry failed messages** if issues occur
* **Enter to send** (Shift+Enter for new lines)
* **Tool usage visibility** showing AI's research process

### Citation System

Citations in chat responses link directly to:

* **Call timestamps**: Jump to exact moments in recordings (`/call/123?t=45`)
* **Signal sources**: Navigate to specific feedback (`/signal/456?t=30`)
* **Document sections**: Open relevant documents (`/documents/789`)

<Warning>
  Chat responses are based on your workspace data. Ensure calls are processed and content is accessible for best results.
</Warning>

## Adding Context to Conversations

<Steps>
  <Step title="Drag Items">
    Drag calls, documents, or signals from anywhere in the app into the chat
  </Step>

  <Step title="Visual Confirmation">
    Context items appear as removable cards before sending your message
  </Step>

  <Step title="Send Message">
    Ask your question - context is automatically included in the AI's analysis
  </Step>

  <Step title="Review Citations">
    AI responses show which context sources were used with clickable citations
  </Step>
</Steps>

## What Chat Can and Cannot Do

<Warning>
  **Current Limitations:**

  * No real-time collaboration features (viewing/typing indicators)
  * No conversation export to PDF or markdown
  * No search within conversation list
  * No advanced filtering in context panel (only sorting by date)
  * Knowledge pages @mentions are in beta (not yet available to all users)
</Warning>

<Note>
  You CAN generate documents from chat responses using the Generate button, which appears when your conversation references calls or folders.
</Note>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Missing Context">
    * Verify call processing
    * Check permissions
    * Review data access
  </Accordion>

  <Accordion title="Unclear Responses">
    * Add more context
    * Rephrase questions
    * Use specific examples
  </Accordion>
</AccordionGroup>

<Info>
  Chat capabilities are continuously improved based on user feedback and new feature releases.
</Info>