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