How to Use MOAI
Your AI-powered document assistant. Follow this guide to get started.
Quick Start
Settings
Before using MOAI, you need to configure your API key(s).
OpenAI API Key
Required for document processing and chat functionality.
- Get your API key from OpenAI Platform
- Go to Settings
- Paste your key (starts with
sk-) and click Save
Anthropic API Key (Optional)
For using Claude models instead of GPT.
- Get your API key from Anthropic Console
- Go to Settings
- Paste your key (starts with
sk-ant-) and click Save
Note: Your API keys are stored securely and are only used to make requests on your behalf. Each user has their own API key configuration.
Documents
Manage your document library from the Documents page.
Uploading Files
- Click "Upload New Documents" to expand the upload section
- Drag and drop files or click to browse
- Supported formats: PDF, DOCX, DOC, TXT
- Check "Make files public" to share documents with other users
- Click "Upload Files" to process and index your documents
Filtering Documents
Use the filter field to search your documents:
- Type any part of a filename to filter
- Use
*as a wildcard (e.g.,report*2024) - Filtering is case-insensitive
- Patterns match anywhere in the filename
Examples:
invoice- matches "invoice.pdf", "my_invoice_2024.pdf"*.pdf- matches all PDF filesreport*q1- matches "report_q1.docx", "annual_report_q1_2024.pdf"
Deleting Documents
- Single delete: Click the trash icon next to any document
- Mass delete: Check multiple documents, then click "Delete Selected"
- Use "Select All" to select all visible documents at once
- A confirmation dialog will appear before deletion
Chat
Ask questions about your documents using the Chat page.
How It Works
MOAI uses Retrieval-Augmented Generation (RAG) to answer your questions:
- Your question is analyzed to find relevant document sections
- The most relevant passages are retrieved from your documents
- An AI generates an answer based on those passages
- Sources are cited so you can verify the information
Tips for Better Results
- Be specific in your questions
- Reference document types if relevant (e.g., "In the quarterly report...")
- Ask follow-up questions to dive deeper
- Check the cited sources to verify answers
Note: MOAI can only answer questions based on documents you've uploaded. It won't have information from external sources.
Admin Settings
Configure system-wide RAG parameters from the Admin page.
RAG Parameters
| Parameter | Description | Default |
|---|---|---|
| Chunk Size | Size of text chunks when processing documents. Larger chunks provide more context but may reduce precision. | 1000 |
| Chunk Overlap | How much chunks overlap. Higher overlap reduces information loss at chunk boundaries. | 200 |
| Top K | Number of document chunks to retrieve when answering questions. Higher values provide more context but may slow responses. | 5 |
Note: Changes to chunk size and overlap only affect newly uploaded documents. Existing documents retain their original chunking.
API Usage
Monitor your OpenAI API usage from the Usage page.
- View your current rate limits
- Check token consumption
- Monitor billing and spending
Troubleshooting
"API Key Required" error
You need to add your OpenAI API key in Settings before uploading documents or using chat.
Upload fails or times out
- Check that your file format is supported (PDF, DOCX, DOC, TXT)
- Large files may take longer to process
- Verify your API key is valid and has sufficient credits
Chat responses seem incomplete
- Try increasing the "Top K" value in Admin Settings
- Upload more relevant documents
- Rephrase your question to be more specific
Documents not showing in search
- Wait a few moments after upload for indexing to complete
- Check your filter criteria (clear the filter to see all documents)
- Refresh the page