Creating Answer Filters
Learn how to create Answer Filters that guide your agent’s responses for specific queries. This guide will walk you through the entire process, from planning to implementation and testing.Prerequisites
Before creating Answer Filters, ensure you have:Agent Created: You need an existing agent to add filters to
Admin Access: Only project Admins and Owners can create filters
Clear Objectives: Know what topics need filtered responses
Answer Filters are configured per agent in the Answer Filters tab of the agent dashboard.
Planning Your Filter
Before creating a filter, take time to plan its structure. A well-planned filter is more effective and easier to maintain.Step 1: Identify the Topic
What specific topic or question type needs consistent responses?- Examples
- Checklist
Good Topics for Answer Filters:
- Return policy questions
- Pricing inquiries
- Contact information requests
- Specific product features
- Account troubleshooting steps
- “Customer questions” (too vague)
- “Product information” (too general)
- “Help requests” (too open-ended)
Step 2: Collect Query Examples
Gather 3-5 different ways users might ask about this topic.Pro Tip: Include variations in phrasing, formality, and wording. The more diverse your examples, the better the filter will match real user queries.
Step 3: Define Good Responses
Write 2-4 approved responses that you want the agent to use or incorporate. Characteristics of Good Responses:- ✅ Accurate and up-to-date
- ✅ Clear and specific
- ✅ Helpful and actionable
- ✅ Brand-aligned
- ✅ Complete (answers the full question)
- Example 1
- Example 2
- Example 3
Topic: Refund PolicyGood Responses:
Step 4: Identify Bad Responses
List 2-3 responses that should be avoided. Types of Bad Responses:- ❌ Incorrect information
- ❌ Vague or unhelpful answers
- ❌ Off-brand language
- ❌ Deflecting or dismissive responses
- ❌ Outdated information
- Example 1
- Example 2
- Example 3
Topic: Refund PolicyBad Responses:
Creating the Filter
Now that you’ve planned your filter, let’s create it in the platform.Step-by-Step Process
Navigate to Answer Filters Tab
- Go to your Project Dashboard
- Select your Agent
- Click on the Answer Filters tab
You should see a table listing any existing Answer Filters for this agent.
Open Create Filter Dialog
Click the ”+ Create Filter” or “Add Filter” button.A dialog or sheet will open with the Answer Filter creation form.
Add Queries
In the Queries section:
- Enter your first query example
- Click ”+ Add” or press Enter to add more
- Add 3-5 query variations
- Include different phrasings
- Vary the formality level
- Consider typos or common misspellings
- Think about how real users actually ask
Add Good Responses
In the Good Responses section:
- Enter your first approved response
- Click ”+ Add” to add more
- Add 2-4 good responses
- Be specific and actionable
- Include all necessary details
- Use your brand voice
- Ensure accuracy
Add Bad Responses
In the Bad Responses section:
- Enter responses to avoid
- Click ”+ Add” to add more
- Add 2-3 bad responses
- Include common mistakes
- List any outdated information
- Note off-brand phrasings
- Add deflecting responses
Complete Examples
Example 1: E-commerce Returns
Example 2: SaaS Pricing
Example 3: Technical Support
Testing Your Filter
After creating a filter, thorough testing is crucial.Testing Checklist
1. Test Exact Matches
1. Test Exact Matches
Try the exact queries you defined:
2. Test Variations
2. Test Variations
Try similar but different phrasings:
3. Test Edge Cases
3. Test Edge Cases
Try queries that are somewhat related but different:
4. Test Negative Cases
4. Test Negative Cases
Verify bad responses are avoided:
Testing in Chat
Best Practices
Quality over Quantity
Start with 5-10 critical filtersFocus on topics that:
- Are asked frequently
- Need consistent answers
- Have compliance requirements
- Protect brand reputation
Be Specific
Detailed is better than vagueInstead of:
❌ “Our return policy is flexible”Use:
✅ “We accept returns within 30 days with original packaging for a full refund”
Include Context
Provide complete informationGood responses should:
- Answer the full question
- Include next steps
- Provide relevant details
- Link to more info if needed
Plan for Maintenance
Keep filters current
- Review monthly
- Update when policies change
- Remove outdated filters
- Add new ones based on user questions
Common Mistakes to Avoid
❌ Too Few Query Examples
❌ Too Few Query Examples
Problem: Only 1-2 query examplesImpact: Filter won’t trigger for many similar questionsSolution: Add 3-5 diverse query variations
❌ Vague Good Responses
❌ Vague Good Responses
Problem: “We have a good return policy”Impact: Agent can’t provide specific, helpful informationSolution: Include specific details, numbers, timeframes
❌ No Bad Responses
❌ No Bad Responses
Problem: Only defining what to say, not what to avoidImpact: Agent might still make known mistakesSolution: List 2-3 common mistakes or outdated info
❌ Overlapping Answer Filters
❌ Overlapping Answer Filters
Problem: Multiple filters cover similar topicsImpact: Inconsistent responses, confusionSolution: Keep filters distinct or combine related ones
❌ Outdated Information
❌ Outdated Information
Problem: Filter contains old policy or pricingImpact: Agent gives wrong informationSolution: Set calendar reminders to review filters
Trigger Threshold (Advanced)
Default Setting: 0.5 (50% similarity)Most users should stick with the default. Adjust only if you’re experiencing issues with filter triggering.
When to Adjust
- Lower Threshold (0.3-0.4)
- Higher Threshold (0.6-0.7)
- Default (0.5)
Use when:
- Filter isn’t triggering often enough
- Topic is commonly asked in many different ways
- You want broad matching
Next Steps
Managing Answer Filters
Learn to edit, update, and delete filters
Overview
Learn more about Answer Filters concepts
Analytics
Monitor filter effectiveness
Agent Settings
Configure other agent features
Troubleshooting
Filter isn't triggering
Filter isn't triggering
Possible causes:
- Query examples are too different from user queries
- Threshold is too high
- Not enough query examples
- Add more diverse query examples
- Lower the threshold slightly (0.4)
- Test with actual user phrasings
Filter triggers too often
Filter triggers too often
Possible causes:
- Query examples are too generic
- Threshold is too low
- Filter topic overlaps with others
- Make query examples more specific
- Raise the threshold (0.6-0.7)
- Review and consolidate overlapping filters
Agent ignores good responses
Agent ignores good responses
Possible causes:
- Good responses are too vague
- Agent’s system prompt overrides filter
- Model doesn’t support filters well
- Make good responses more specific and directive
- Review system prompt for conflicts
- Ensure filter is actually triggering (test with exact queries)
Can't create filter (permission error)
Can't create filter (permission error)
Possible causes:
- Insufficient permissions
- Not an Admin or Owner
- Contact project Admin or Owner
- Request elevated permissions
- Check project membership role