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

# Conversations in Spaces

> Managing AI conversations within your workspace

## Overview

Conversations are the primary way to interact with AI models in Pulze. Each space can have multiple conversations, allowing you to organize different topics, projects, or workflows separately.

## Conversation Features

<CardGroup cols={2}>
  <Card title="Chat Interface" icon="comments" href="/docs/pulze/conversations/chat-interface">
    Real-time AI interactions with advanced features
  </Card>

  <Card title="Message History" icon="clock-rotate-left" href="/docs/pulze/conversations/message-history">
    Access and search through previous conversations
  </Card>

  <Card title="References & Sources" icon="link" href="/docs/pulze/conversations/references-sources">
    Track data sources and citations
  </Card>

  <Card title="Collaboration" icon="users" href="/docs/pulze/conversations/comments-collaboration">
    Comment and collaborate with team members
  </Card>
</CardGroup>

## Starting a Conversation

<Steps>
  <Step title="Navigate to Space">
    Open your space from the Spaces menu
  </Step>

  <Step title="Start New Conversation">
    Click the text input area or "Start a new conversation" section
  </Step>

  <Step title="Enter Your Prompt">
    Type your message or question for the AI
  </Step>

  <Step title="Submit">
    Press Enter or click Send to begin the conversation
  </Step>
</Steps>

## Conversation List

The space home displays all saved conversations with:

### Search and Filtering

* **Text Search**: Find conversations by keywords in titles or content
* **Owner Filter**: Show only your conversations or all team conversations
* **Type Filter**:
  * All conversations
  * Regular conversations
  * Task-based conversations
* **Task Filter**: Filter by specific scheduled tasks

### Conversation Preview

Each conversation shows:

* **Title**: Auto-generated or custom name
* **Preview**: Snippet of the latest response
* **Metadata**:
  * Last modified time
  * Creator information with profile picture
  * Unread message count (if applicable)
* **Participants**: Preview of member profile pictures
* **Task Indicator**: Clock icon for task-linked conversations

### Conversation Actions

* **Open**: Click anywhere to open the conversation
* **Rename**: Edit the conversation title
* **Delete**: Remove the conversation permanently
* **Share**: Add or remove members
* **Export**: Download conversation history

## Conversation Types

### Regular Conversations

* Manual interactions with AI models
* Can be saved for later reference
* Support all conversation features
* Persist until manually deleted

### Task Conversations

* Automatically created by scheduled tasks
* Linked to the originating task
* Marked with a special indicator
* Include task execution metadata

### Document Conversations

* Associated with collaborative documents
* Synchronized with document content
* Support inline AI assistance
* Track document-specific changes

## Conversation Settings

Each conversation can be configured with:

### Assistant Selection

* Choose a specific assistant for the conversation
* Use the space default assistant
* Switch assistants mid-conversation
* Access assistant-specific tools

### Model Configuration

* Select the AI model to use
* Switch models during the conversation
* Configure model parameters
* Set up failover options

### Data Context

* Attach specific documents
* Link to datasets
* Include custom data
* Configure RAG (Retrieval-Augmented Generation)

### Participant Management

* Invite specific team members
* Set conversation-level permissions
* Manage notifications
* Track participant activity

## Conversation Organization

### Naming Conventions

* Auto-generated titles based on first message
* Custom titles for better organization
* Support for emojis in titles
* Searchable names

### Categorization

* Group related conversations
* Use consistent naming patterns
* Tag conversations with metadata
* Create conversation collections

### Archiving

* Archive completed conversations
* Keep space clean and organized
* Maintain searchable history
* Restore when needed

## Unread Messages

The platform tracks unread messages in conversations:

* **Badge Indicators**: Show unread count
* **Visual Cues**: Highlight conversations with new activity
* **Notifications**: Alert when new messages arrive
* **Mark as Read**: Automatically or manually

## Conversation Lifecycle

<Steps>
  <Step title="Creation">
    Start a new conversation with a prompt
  </Step>

  <Step title="Active Use">
    Ongoing back-and-forth with AI and team members
  </Step>

  <Step title="Collaboration">
    Add comments, share with team, reference data
  </Step>

  <Step title="Completion">
    Mark as complete or let it go dormant
  </Step>

  <Step title="Archival">
    Archive for reference or delete if no longer needed
  </Step>
</Steps>

## Best Practices

<AccordionGroup>
  <Accordion title="Organization">
    * Use descriptive conversation titles
    * Create separate conversations for different topics
    * Regularly review and archive old conversations
    * Delete conversations that are no longer needed
  </Accordion>

  <Accordion title="Collaboration">
    * Share conversations with relevant team members only
    * Use comments for asynchronous feedback
    * Tag team members when input is needed
    * Keep conversation context clear for all participants
  </Accordion>

  <Accordion title="Efficiency">
    * Use filters to find conversations quickly
    * Save important conversations for easy access
    * Export conversations for external documentation
    * Leverage saved conversations as templates
  </Accordion>

  <Accordion title="Context Management">
    * Attach relevant documents at the start
    * Reference appropriate datasets
    * Use clear, specific prompts
    * Build on previous messages in the thread
  </Accordion>
</AccordionGroup>

## Pagination and Navigation

For spaces with many conversations:

* **Page Size Options**: 10, 25, 50, or 100 conversations per page
* **Page Navigation**: First, previous, next, last page controls
* **Jump to Page**: Direct page number input
* **Total Count**: Display of total conversations
* **Results Summary**: "Showing X-Y of Z conversations"

## Recent Conversations

The dashboard highlights:

* Your most recent conversations
* Conversations with new activity
* Conversations shared with you
* Task-generated conversations

## Conversation Analytics

Track conversation metrics:

* **Total Conversations**: Count in the space
* **Active Conversations**: Recently updated
* **Participation**: Member engagement levels
* **Token Usage**: Resource consumption per conversation

## Next Steps

<CardGroup cols={2}>
  <Card title="Chat Interface" icon="comments" href="/docs/pulze/conversations/chat-interface">
    Learn about the conversation UI
  </Card>

  <Card title="Message History" icon="clock-rotate-left" href="/docs/pulze/conversations/message-history">
    Explore message management
  </Card>

  <Card title="Comments" icon="comment-dots" href="/docs/pulze/conversations/comments-collaboration">
    Collaborate with your team
  </Card>

  <Card title="Back to Spaces" icon="rocket" href="/docs/pulze/spaces/overview">
    Return to Spaces overview
  </Card>
</CardGroup>
