Knowledge Base Manager
Help users manage their AI knowledge base to ensure accurate, up-to-date information for the support bot.
Workflow Modes
1. View Status
- Use
list_knowledge_sources to get all sources
- Present summary: total sources, active vs pending vs errored
- Flag any sources with errors and show the overview table
2. Add Source
- Use
list_knowledge_sources first to check if the URL already exists
- If duplicate, inform the user and show existing source status
- If new, use
add_knowledge_url with the URL and optional name
- Explain that processing is async (a few minutes). Offer to check status later with
get_knowledge_source
3. Search Content
- Use
search_knowledge with the user's query
- Present matching results with content previews and source attribution
- If no results, suggest different search terms or adding relevant content
4. Audit Coverage
- Use
list_knowledge_sources and get_knowledge_stats together
- Identify: sources with 0 chunks, errored sources, sources stale >30 days
- Cross-reference with common topics (refund policy, pricing, getting started, troubleshooting, billing, integrations)
- Present findings with recommended actions
5. View Stats
- Use
get_knowledge_stats to retrieve aggregate data
- Present total sources, total chunks, index health, and notable patterns
6. Delete Source
- Look up the source using
list_knowledge_sources or get_knowledge_source
- Confirm with the user — show source name, URL, and chunk count
- Delete using
delete_knowledge_source and confirm
Examples
| User Says |
Workflow |
| "Show my KB status" |
View Status |
| "Add https://docs.acme.com to my KB" |
Add Source |
| "Search for refund policy" |
Search Content |
| "Audit my knowledge base for gaps" |
Audit Coverage |
| "Show KB stats" |
View Stats |
| "Remove the old blog source" |
Delete Source |
| "What does my AI know about pricing?" |
Search Content |
Output Formats
Knowledge Base Overview — Total: [count], Active: [count], Pending: [count], Errored: [count]
| Source |
Type |
Status |
Chunks |
Last Updated |
| [name] |
[url/file] |
[status] |
[count] |
[date] |
Audit Report — Sources reviewed: [count], Issues: [count], Gaps: [topics]
| Issue |
Source |
Recommendation |
| 0 chunks |
[name] |
Re-add or check URL accessibility |
| Error state |
[name] |
Delete and re-add |
| Stale >30d |
[name] |
Re-index or verify content is current |
Edge Cases
- Source already exists: Show existing status. Offer to delete and re-add to refresh.
- URL unreachable: Explain the URL may be behind auth, blocking bots, or temporarily down.
- Indexing takes too long: Indexing is async. Offer to check back with
get_knowledge_source.
- Search returns no results: Suggest broader terms, then suggest adding content if topic is missing.
- Delete confirmation: Always confirm. Show source name and chunk count before deleting.
Gap Analysis Guidance
When auditing, check coverage against these common support categories:
- Getting started / onboarding
- Pricing and billing
- Refund and cancellation policy
- Account management
- Troubleshooting / FAQ
- Integrations and API
- Contact and escalation paths
If any category has zero or weak search results, flag it as a gap.
Settings Reference
show_ids: When enabled, display source IDs in output tables. When disabled, omit for cleaner output.
Cross-Skill References
- For deeper analysis of KB quality and optimization recommendations, suggest: "Consider running the kb-optimizer agent for a comprehensive analysis."
- If the user mentions their bot is giving wrong answers, start with Search Content to verify what the KB actually contains.
Guidelines
- Always show source names, not just IDs
- For errored sources, display the error message
- Processing is async — set expectations that new sources take a few minutes
- When searching, show content previews with source attribution
- When adding multiple URLs, process them sequentially and report results together
- When deleting, always confirm with the user first
1---2name: knowledge-manager3description: Manage the AI knowledge base by listing sources, checking indexing status, adding new URLs, searching indexed content, and auditing for coverage gaps. Use when the user asks about their knowledge base, wants to add training data, search KB content, check what the AI knows, or audit documentation coverage.4---56# Knowledge Base Manager78Help users manage their AI knowledge base to ensure accurate, up-to-date information for the support bot.910## Workflow Modes1112### 1. View Status13141. Use `list_knowledge_sources` to get all sources152. Present summary: total sources, active vs pending vs errored163. Flag any sources with errors and show the overview table1718### 2. Add Source19201. Use `list_knowledge_sources` first to check if the URL already exists212. If duplicate, inform the user and show existing source status223. If new, use `add_knowledge_url` with the URL and optional name234. Explain that processing is async (a few minutes). Offer to check status later with `get_knowledge_source`2425### 3. Search Content26271. Use `search_knowledge` with the user's query282. Present matching results with content previews and source attribution293. If no results, suggest different search terms or adding relevant content3031### 4. Audit Coverage32331. Use `list_knowledge_sources` and `get_knowledge_stats` together342. Identify: sources with 0 chunks, errored sources, sources stale >30 days353. Cross-reference with common topics (refund policy, pricing, getting started, troubleshooting, billing, integrations)364. Present findings with recommended actions3738### 5. View Stats39401. Use `get_knowledge_stats` to retrieve aggregate data412. Present total sources, total chunks, index health, and notable patterns4243### 6. Delete Source44451. Look up the source using `list_knowledge_sources` or `get_knowledge_source`462. Confirm with the user — show source name, URL, and chunk count473. Delete using `delete_knowledge_source` and confirm4849## Examples5051| User Says | Workflow |52|-----------|----------|53| "Show my KB status" | View Status |54| "Add https://docs.acme.com to my KB" | Add Source |55| "Search for refund policy" | Search Content |56| "Audit my knowledge base for gaps" | Audit Coverage |57| "Show KB stats" | View Stats |58| "Remove the old blog source" | Delete Source |59| "What does my AI know about pricing?" | Search Content |6061## Output Formats6263**Knowledge Base Overview** — Total: [count], Active: [count], Pending: [count], Errored: [count]6465| Source | Type | Status | Chunks | Last Updated |66|--------|------|--------|--------|-------------|67| [name] | [url/file] | [status] | [count] | [date] |6869**Audit Report** — Sources reviewed: [count], Issues: [count], Gaps: [topics]7071| Issue | Source | Recommendation |72|-------|--------|----------------|73| 0 chunks | [name] | Re-add or check URL accessibility |74| Error state | [name] | Delete and re-add |75| Stale >30d | [name] | Re-index or verify content is current |7677## Edge Cases7879- **Source already exists**: Show existing status. Offer to delete and re-add to refresh.80- **URL unreachable**: Explain the URL may be behind auth, blocking bots, or temporarily down.81- **Indexing takes too long**: Indexing is async. Offer to check back with `get_knowledge_source`.82- **Search returns no results**: Suggest broader terms, then suggest adding content if topic is missing.83- **Delete confirmation**: Always confirm. Show source name and chunk count before deleting.8485## Gap Analysis Guidance8687When auditing, check coverage against these common support categories:881. Getting started / onboarding892. Pricing and billing903. Refund and cancellation policy914. Account management925. Troubleshooting / FAQ936. Integrations and API947. Contact and escalation paths9596If any category has zero or weak search results, flag it as a gap.9798## Settings Reference99100- **`show_ids`**: When enabled, display source IDs in output tables. When disabled, omit for cleaner output.101102## Cross-Skill References103104- For deeper analysis of KB quality and optimization recommendations, suggest: "Consider running the kb-optimizer agent for a comprehensive analysis."105- If the user mentions their bot is giving wrong answers, start with Search Content to verify what the KB actually contains.106107## Guidelines108109- Always show source names, not just IDs110- For errored sources, display the error message111- Processing is async — set expectations that new sources take a few minutes112- When searching, show content previews with source attribution113- When adding multiple URLs, process them sequentially and report results together114- When deleting, always confirm with the user first
jonny-1812