Help Center / Knowledge Packs
Writing Knowledge Packs that work
Format content so agents find the right answer fast.
How you structure a Knowledge Pack matters as much as what's in it. Clear, specific content gives faster and more accurate answers.
Formatting
- Use Markdown (.md) rather than plain text when you can.
- Use clear headings, short sections and short paragraphs or bullet lists.
- Be specific: include names, dates, units and amounts.
- Avoid vague words like "it", "this" or "they". Repeat the noun instead.
- Keep related facts together under one heading.
- Leave out images and complex tables. The agent can't read images, and tables confuse it.
- Only include information relevant to the pack's purpose.
Spreadsheets
Raw tables are harder for the agent to search. Keep related rows together, add a sentence explaining what the columns mean, and summarise the key facts in Markdown where you can.
Websites
- Point at focused sections such as
/faq/or/services/rather than an entire site. - Exclude pages you don't need. You can exclude up to 200 URLs per crawl path and 500 per pack.
Example
## Emergency plumbing call-out
- Available 24 hours a day, 7 days a week
- Call-out fee: $95, waived if the repair goes ahead
- Response time: within 90 minutes in the metro area