What content formats are acceptable for use in the knowledge base?
- .doc
- .docx
- .pptx
- .txt
- .md
- URLs (must not be password-protected)
What does Realtime retrieval mean?
The agent actively searches your domain each chat — no retraining required. The website search has been updated (July 2026) for more accurate answers and more relevant content retrieval. During longer lookups the agent briefly acknowledges it is working, so visitors can see it is actively processing rather than frozen.
Omniagent API — knowledge files are uploaded by URL
If you are using the Omniagent API directly, knowledge files are not uploaded as direct file attachments. Instead, you provide a publicly reachable HTTPS URL pointing to the document, and the platform fetches and indexes it:
curl -X POST https://companion-api.napster.com/public/knowledge-bases/kb_abc123/files \
-H "X-Api-Key: $NAPSTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "url": "https://example.com/docs/product-guide.pdf" }'The file must be at a URL accessible without authentication. Password-protected, geo-restricted, or Cloudflare-protected URLs will fail to index. This is different from the Napster Spaces editor, which accepts direct file uploads from your device.
Best practices for uploads (Spaces editor)
- Split large PDFs (over 50 pages) for faster indexing.
- Wait for the file status to read Processed before closing the window or navigating away.
- Do not close or refresh the editor while files are uploading — session expiry can cause a false "unsupported format" error. If this happens, refresh and re-upload.
- Non-Latin filenames (Arabic, Chinese, etc.) are fully supported. PDFs with non-Latin character filenames upload successfully without any renaming required.
Are .txt and .md files supported?
Yes. If you see an "unsupported format" error for these types, your editing session has expired. Refresh and try again. Note: .md files work best when they contain factual reference content. Instruction-style or persona content is better placed in the Persona Prompt editor.
Why is my agent giving incomplete or wrong answers from uploaded documents?
The most common cause is the structure of the source file. Tabular data (Excel exports, structured schedules, pricing tables) carries little semantic meaning for the AI embedding model. Convert tabular data into narrative, sentence-form text. Add dedicated FAQs for the most critical questions that must always be answered correctly — FAQ entries take priority over knowledge base retrieval.
My Spaces dashboard showed all my Spaces as gone after an upload error
This is a session display issue, not data loss. Refresh the page and your Spaces will reappear.