Q&A
Frequently asked questions, best practices, and troubleshooting tips for building and managing your AI chatbot.
Best Practices
Write clear, specific instructions
Tell the agent exactly what it should do, what tone to use, and what topics to avoid. Vague instructions lead to inconsistent responses.
Upload high-quality, relevant sources
The agent's accuracy depends on its knowledge base. Upload well-structured documents and avoid including irrelevant or outdated content.
Test thoroughly before deploying
Use the Playground to simulate real conversations. Try edge cases, off-topic questions, and tricky phrasings to ensure the agent handles them well.
Keep your knowledge base up to date
Regularly review and update sources. Remove outdated documents and re-crawl websites when content changes.
Monitor conversations and iterate
Review chat history in the Usage section. Look for common questions the agent struggles with and update instructions or add sources to address gaps.
Troubleshooting
Agent gives inaccurate or irrelevant answers
Fix: Check your knowledge sources - the content may be outdated or missing. Add more relevant documents and refine the system instructions to be more specific.
Embedding progress seems stuck
Fix: Large files or many pages can take longer to process. Wait a few minutes and refresh the page. If it remains stuck, try removing and re-uploading the source.
Chat widget doesn't appear on my website
Fix: Verify the embed code is placed correctly (before the </body> tag). Check that your domain is listed in the allowed domains under the Connect tab.
Agent responds to topics it shouldn't
Fix: Update the system instructions with explicit boundaries, e.g. "Only answer questions related to [topic]. Politely decline any unrelated questions."