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

# AI Assistant

> Answers questions about the FlowX.AI platform as well as your organization's business domain based on uploaded documentation.

## Overview

The AI Assistant provides intelligent documentation support for both the FlowX.AI platform and your organization's business domain. It functions as a knowledge hub that can quickly search, retrieve, and synthesize information from both built-in FlowX.AI documentation and custom uploaded documents. You can ask natural language questions and receive well-formatted, accurate answers drawn from up-to-date documentation sources.

<Frame>
  <video controls className="w-full aspect-video" src="https://s3.eu-west-1.amazonaws.com/docx.flowx.ai/470/ai-assistant.mp4" autoPlay muted loop />
</Frame>

***

## Key capabilities

The AI Assistant offers specialized content search functionality across different documentation sources:

<CardGroup cols={2}>
  <Card title="Platform documentation search" icon="magnifying-glass">
    Provides answers to questions about the FlowX.AI platform, its features, configuration options, and best practices. Accesses a comprehensive repository of approximately 1,000 documentation chunks (318,000 tokens).
  </Card>

  <Card title="Custom document support" icon="file-arrow-up">
    Upload your organization's business domain documentation so the assistant can answer domain-specific questions alongside platform queries.
  </Card>

  <Card title="Natural language queries" icon="comments">
    Handles direct questions, keyword searches, or general topic inquiries related to the platform and uploaded documentation.
  </Card>

  <Card title="Formatted responses" icon="file-lines">
    Delivers answers in well-formatted markdown for readability, with rapid response times for most queries. Documentation ingestion takes approximately 12 seconds.
  </Card>
</CardGroup>

***

## How it works

The AI Assistant architecture follows a retrieval-augmented generation approach:

```mermaid theme={"system"}
%%{
  init: {
    'theme': 'base',
    'themeVariables': {
      'primaryColor': '#f1774a',
      'primaryTextColor': '#000',
      'primaryBorderColor': '#000',
      'lineColor': '#6b6b6b',
      'secondaryColor': '#f3b861',
      'tertiaryColor': '#000'
    }
  }
}%%
graph TD;
    Start([Start]):::primary
    Check_Prompt[Check Prompt]:::secondary
    Rewrite_Query[Rewrite Query]:::secondary
    Retrieve_Documents[Retrieve Documents]:::secondary
    Grade_Documents[Grade Documents]:::secondary
    Generate_Answer[Generate Answer]:::secondary
    Generate_Greetings[Generate Greetings]:::secondary
    END([END]):::primary

    Start --> Check_Prompt;
    Check_Prompt --> Rewrite_Query;
    Check_Prompt --> Generate_Greetings;
    Rewrite_Query --> Retrieve_Documents;
    Retrieve_Documents --> Grade_Documents;
    Grade_Documents --> Generate_Answer;
    Generate_Answer --> END;
    Generate_Greetings --> END;

    %% Styling
    classDef primary fill:#f1774a,stroke:#000,stroke-width:1px,color:#000;
    classDef secondary fill:#f3b861,stroke:#000,stroke-width:1px,color:#000;
```

The workflow begins with query refinement, followed by document retrieval and relevance grading. Based on the quality of retrieved information, the system can generate an immediate response, process a more complex response asynchronously, or refuse to answer if no relevant documentation is found.

***

## How to use

The AI Assistant is accessible within the FlowX.AI Platform:

<Steps>
  <Step title="Open the AI Assistant">
    Find the AI Assistant in the help section of the platform interface.
  </Step>

  <Step title="Ask a question">
    Use the chat-based interface to type natural language questions. View responses in real-time with markdown formatting, and follow up with additional questions in a conversational manner.
  </Step>

  <Step title="Upload custom documentation">
    Upload your organization's documentation through the document upload interface in the assistant section. You can select files from your local system or provide URLs to documentation resources.
  </Step>

  <Step title="Reference past conversations">
    Access saved conversations to reference past interactions. The assistant maintains context between sessions.
  </Step>
</Steps>

***

## Best practices

### DO the following

<Card icon="square-check" color="green" horizontal="true">
  **Be specific with your questions:**
  Clearly articulate what information you need about the FlowX.AI platform or your organization's business domain. The more specific your question, the more precise the answer will be.
</Card>

<Card icon="square-check" color="green" horizontal="true">
  **Reference platform components:**
  Mention specific features, modules, or functions you're asking about to help the assistant retrieve the most relevant documentation.
</Card>

<Card icon="square-check" color="green" horizontal="true">
  **Provide context:**
  When asking follow-up questions, include relevant context or reference your previous inquiry to help the assistant understand the conversation flow.
</Card>

<Card icon="square-check" color="green" horizontal="true">
  **Ask about best practices:**
  The assistant can provide guidance on recommended approaches and implementation strategies based on official documentation.
</Card>

### DON'T do these

<Card icon="ban" color="red" horizontal="true">
  **Don't ask about undocumented features:**
  The assistant relies on available documentation and may not be able to provide information about unreleased or undocumented functionality.
</Card>

<Card icon="ban" color="red" horizontal="true">
  **Don't expect troubleshooting of specific implementations:**
  While the assistant can provide general guidance, it cannot debug custom code or analyze specific implementation issues without detailed context.
</Card>

<Card icon="ban" color="red" horizontal="true">
  **Don't assume complete knowledge:**
  If documentation doesn't cover a particular topic, the assistant may not be able to provide comprehensive information on that subject.
</Card>

<Card icon="ban" color="red" horizontal="true">
  **Don't ask unrelated questions:**
  The assistant is specialized in FlowX.AI platform and your organization's business domain documentation and may not provide accurate answers on unrelated topics.
</Card>

***

## Related resources

<CardGroup cols={2}>
  <Card title="Agent Builder overview" icon="hammer" href="../agent-builder/overview">
    Create and configure custom AI agents for your organization
  </Card>

  <Card title="AI Analyst" icon="chart-mixed" href="./ai-analyst">
    Assists with process analysis and optimization recommendations
  </Card>

  <Card title="AI Designer" icon="pen-ruler" href="./ai-designer">
    Helps design and build UI components and process flows
  </Card>
</CardGroup>
