Skip to main content

Optimizing content for Fin

How to produce support content that's optimized for AI answers.

Written by Beth-Ann Sher

Fin AI Agent and Copilot can consume all your support content to immediately offer your customers and teammates accurate and trustworthy answers.

Use this article to optimize your help center content for Fin AI Agent and Copilot. You'll learn how to identify content gaps, update existing articles, and apply the 14-factor content readiness framework — so Fin can retrieve accurate answers and customers can find what they need. This article is for workspace admins managing a knowledge base.


Create new content to fill gaps

  • Spot trends - Look at patterns among your customer conversations that an article might address. What questions are customers always asking? Do teammates have the resources they need to help customers troubleshoot specific issues? After you've deployed Fin, you can do this from the Topics Explorer.

  • Analyze performance - Visit the Fin Optimize dashboard after you've deployed Fin to get real-time, actionable insights on which topics Fin needs more content to support, and AI-generated suggestions to automatically create and update your content to fill these gaps.

  • Reuse team macros - Go through your Support team’s macros/saved replies and decide if there are some that would make sense as a public article or snippet. Even if the content doesn’t seem substantial enough for its own article, Fin can still use a snippet for short pieces of information that have no other obvious home.


Optimize and update existing content

The more simple, straightforward, and comprehensive your articles are, the easier it will be for AI (and humans!) to consume them. If it’s confusing for a human to read, it’ll be confusing for an AI agent or copilot as well. Focus on:

  • Simplifying language: Think about how your users frame questions and ensure that the answer is phrased in a relevant and accessible way. Avoid basic “yes” or “no” answers; instead, use full sentences to disambiguate the answer for AI.

  • Creating a scannable structure: Structuring your content in a more streamlined way not only helps humans, but AI too. Use rich formatting such as headings, tables, and bullet points to make it easier for AI to scan and retrieve the answer your customer or teammate is looking for.

  • Identifying who the content is aimed at: If you have a variety of user types, and your support content differs for each one, ensure that each piece of content includes a clear reference to the type of user the content is geared towards. Tip: Use audience rules to target content at specific customer segments.

  • Auditing for accuracy: From sales and engineering, to legal and security - knowledge can be created by multiple teams and subject matter experts (SMEs). So divide your content by owner and ask each team or SME to review their knowledge area.

  • Explaining key terms: Explain the meaning of special terms or spell out acronyms the first time you use them, even if you think your audience already knows what they mean.

Pro tip: See how you can use AI to help restructure and optimize your existing content for Fin.

Prioritize the most important updates

Here are some tips to help you prioritize which content to optimize for Fin first:

  • Sort your content by ‘Last updated’ to find the content most likely to contain outdated information.

  • Identify the high-traffic articles in your Help Center (based on metrics like views and conversations started from articles), and make them as straightforward and informative as you can.

  • Once you've deployed Fin, use the Optimize dashboard to discover topics which are driving a high volume of conversations with low CX Scores (customer experience scores) and review the suggestions to improve Fin’s performance.

  • Not all inaccuracies in your support content are created equal. Updating content to reflect minor aesthetic edits to your product or internal workflows is less urgent than updating with more major functional or usability changes to your product or service offering.


Examples of Best Practice

The following best practices use public articles as an example, but apply to all content enabled for AI — including internal articles, snippets, and synced or external sources. They're organized around a 14-factor content readiness framework: the set of criteria that determines whether a piece of content is ready to be used by Fin and Copilot to answer real customer questions.

Avoid ambiguity (Disambiguation)

If it’s confusing or ambiguous for a human to read, it’s also going to be ambiguous for AI! (And that’s when there’s a chance it’ll give the wrong answer, or make an incorrect inference, or just not answer something that otherwise should be answerable).

The table below shows how restating the subject removes ambiguity for both customers and Fin:

Good practice

Collaborating on projects is easier when you invite teammates to join your team.

Poor practice

It’s easier when you invite teammates.

Restate questions (Query-answer symmetry)

You don’t need to do a question-answer pair, but write as if you’re doing a radio interview and you don’t want to be quoted out of context.

The table below shows how restating the question in the answer keeps it self-contained when retrieved out of context:

Good practice

You can use your own packaging when sending an item back for a return or exchange, no need to save the original shipping box.

Poor practice

Do I need to use the original outer shipping box to ship back a return item?

No.

Use headers (Semantic chunk boundaries)

Use headers (H1, H2, H3) to divide your content into focused, single-topic sections. Each section should cover one thing — if a section mixes multiple subjects, break it up. This directly controls what Fin retrieves and presents to a customer: a section covering three different things will generate unfocused answers. Also include some of the header text in the paragraph below it, in case Fin or Copilot fails to capture all headings in the HTML.

The table below shows how using separate headers with context under each one keeps sections self-contained for Fin retrieval:

Good practice

Check out as a guest

To check out as a guest, click ‘Checkout as guest’ and enter your email address. We’ll need this to confirm your order and update you on shipping.

Check out as a logged in user

To check out as a logged in user, sign in or create a new account by clicking ‘Sign in’ at checkout. This lets you collect points and keep all your orders in one place.

Poor practice

Checking out can be done as a guest or logged in user. Click ‘Checkout as guest’ and enter your email address. We’ll need this to confirm your order and update you on shipping. You can also sign in or create a new account by clicking ‘Sign in’ at checkout.

Use bulleted lists (Structured enumeration)

Multi-step processes must use numbered lists. Lists of options or items must use bullet points. If a sentence says 'the following:' it must be followed by an actual list, not a paragraph. AI performs better when long, detailed paragraphs are formatted using clear structure instead.

The table below shows how converting a dense paragraph into a structured list helps Fin extract specific points:

Good practice

Use Projects to:

  • Create and manage tasks in one place.

  • Get a clear overview of timelines and stay on track.

  • Collaborate efficiently with your whole team.

Poor practice

You can do lots of things with Projects, like creating and managing tasks, getting an overview of timelines to stay on track, and collaborating efficiently with your whole team.

Don’t ask Fin to do math

All numbers, thresholds, limits, durations, and quantities must be stated precisely. 'A few minutes,' 'some requests,' 'shortly' — none of these pass. Use exact values where known. If you want Fin to handle questions that may involve calculation, include worked examples that show clearly how the sum is calculated.

The table below shows how stating exact timeframes and breaking them down eliminates the need for a customer or Fin to calculate durations:

Good practice

Returns can take up to 12 business days to post to your account. This is because the shipment may take up to 7 days to arrive at our warehouse, and 5 additional days to be processed.

If you don’t see the return status updated in your account and it’s been more than 12 business days, please ask to speak to a human.

If your return has been posted to your account but you’re waiting for your refund to appear on your payment method, please know it could take up to 5 additional business days for it to appear.

Poor practice

Refunds for returns can take 7 days for the shipment to arrive, and then 5 days to process the refund, and 5 more days for the refund to be credited to your account.

Include contact details (Audience specification)

Every piece of content should state who it's for and what access or permissions are required. Don't assume the reader knows their own role or plan. 'Available on all plans' or 'requires Workspace Owner permissions' gives readers the context to know whether this applies to them before they follow five steps to discover it doesn't. The same principle applies to contact details — if certain numbers or addresses are specific to a particular situation, clearly delineate them.

The table below shows how labeling contact details by audience makes each entry self-descriptive and unambiguous:

Good practice

Contact Sales team: 018 4366891

Contact Support team: 018 4366892

Advertise with us: 018 4366893

Poor practice

Contact us

Sales: 018 4366891

Support: 018 4366892

Advertising: 018 4366893

Use FAQ articles or snippets (Self-contained sections)

An AI agent drives the most value when it resolves high volume, repetitive questions. So if you have small pieces of information that don’t require a full article or have no other obvious home, you should include them as a list of FAQs (frequently asked questions) in one public / internal article or create snippets. Fin will still be able to find them and serve them to customers.

The table below shows a well-structured FAQ entry that's complete enough for Fin to retrieve and use in isolation:

Good practice

Can I have a free trial?

Yes, all new customers get a 1 month free trial after signing up.

Do I need to upload a profile picture for my pet?

No, you don’t need to upload a profile picture for your pets, but we’d love to see them!

Poor practice

Excluding this information from your support content and missing out on some easy resolutions.

When setting up FAQ articles it is strongly recommended to use headers (H1, H2, H3) when structuring your FAQs.

Give context to multimedia (Visual content and alt text)

Fin can send relevant images/GIFs from your support content in it's AI answers (up to 3).

However, if you've included multimedia in your support content, it's still important to also include step-by-step text instructions above or below any image or video which guides the user through the process.

Bonus: Including step-by-step text instructions makes your content more accessible to users with low vision, while also catering for multi-mode learners:

The table below shows how pairing an image with step-by-step text ensures Fin can answer process questions even if it doesn't surface the image:

Good practice

Screenshot of a project creation dashboard showing a list of existing projects, demonstrating good practice: a screenshot paired with numbered step-by-step written instructions below it.

To create new projects, just follow these steps:

  1. From your dashboard, navigate to your projects page and click the plus icon (+) in the top left of your toolbar.

  2. Add a project name. Make sure it's clear and explains what the project is about at a glance.

  3. Success! Your project will now be visible on your "My Projects" page.

Poor practice

Screenshot of a project creation dashboard showing only a screenshot with no written step-by-step instructions below or above it.

Note: Fin will include a maximum of 3 images in any single AI answer, even if your article contains more. Always pair images with written text instructions so Fin can answer accurately even if it doesn't surface an image. Also note that Fin may not always capture headings from HTML — this is why each section should restate its topic in the opening sentence, not rely on the heading alone.

Write a strong opening paragraph (Jobs to be done)

The opening paragraph of every article must state what the reader will accomplish, not just what the article is about. Fin uses the opening to understand what an article is for — a weak opening degrades how well it surfaces for relevant queries.

The table below shows the difference between a topic-description opening and a jobs-to-be-done opening:

Good practice

Use this article to invite teammates to your workspace, manage their permissions, and troubleshoot common access issues.

Poor practice

This article covers teammate invitations and permissions.

Complete every set of instructions (Instruction completeness)

Step-by-step instructions must be complete end-to-end. That means including what happens after the final step: confirmation dialogs, what the customer should expect to see, and what to do if they don't see it. An incomplete instruction leaves the customer stranded — and gives Fin nothing to draw on when a customer asks 'did it work?'

The table below shows how completing an instruction — including the confirmation step — removes ambiguity about whether an action succeeded:

Good practice

Click Remove. A confirmation dialog will appear — select Confirm to complete the action. The item will be removed from your list immediately.

Poor practice

Click Remove.

Document limitations and workarounds (Limitations and workarounds)

If a feature has known limitations, gaps, or edge cases, document them specifically — not vaguely. Which configurations are affected, what the limitation is, and what the customer should do instead. This is the factor that most directly prevents Fin from giving a misleading answer. If a limitation isn't documented, Fin doesn't know to flag it.

The table below shows how documenting a specific limitation with a workaround prevents Fin from giving a misleadingly incomplete answer:

Good practice

Bulk export is not available for custom report types. To export a custom report, open it individually and use the Export button in the top right. CSV and PDF formats are supported.

Poor practice

Some configurations may not support bulk export.

Define all terms and acronyms (Defined terms)

Abbreviations and product-specific terms must be defined on first use. Don't assume the reader knows what CSV, GDPR, or 2FA mean. The first time an acronym appears, spell it out in full — then use the short form for the rest of the article.

The table below shows how defining an acronym on first use makes content accessible to all readers:

Good practice

You can export your data as a CSV (comma-separated values) file from the Reports page. Once you've downloaded the CSV, open it in any spreadsheet application.

Poor practice

Export your data as a CSV from the Reports page.

Repeat key terms throughout (Entity distribution)

Key product and feature names should appear throughout an article — not just in the opening paragraph. When Fin retrieves a section mid-article, it needs enough context to know what's being discussed. A section that only says 'click the button in the top right' with no mention of the product or feature it refers to is effectively invisible to retrieval.

The table below shows how repeating the feature name in each section gives Fin the context it needs to retrieve and use that section accurately:

Good practice

To remove a teammate from your Intercom workspace, go to Settings > Teammates. Find the teammate you want to remove, click the options menu, and select Remove from workspace. The teammate will immediately lose access to your Intercom workspace.

Poor practice

Go to Settings > Teammates. Find the person you want to remove, click the options menu, and select Remove. They'll lose access immediately.

Introduce every table and standalone block (Context in tables)

Tables and standalone blocks must include an introductory sentence that explains what they cover and where they apply. Fin can retrieve a table without the heading above it, so the table itself needs to make sense in isolation. A table that jumps straight into rows with no context fails this — Fin has no way to know what the table is about.

The table below shows how adding a single introductory sentence makes a standalone table self-explanatory for both customers and Fin:

Good practice

The table below shows which file formats are supported for import on each Intercom plan:

Starter: CSV

Pro: CSV, XLS

Premium: CSV, XLS, JSON

Poor practice

Starter: CSV

Pro: CSV, XLS

Premium: CSV, XLS, JSON


Content readiness checklist

Before publishing any piece of content, check it against these 14 factors. Content that passes all of them will be easy for customers to follow and easy for Fin to retrieve, parse, and use to give accurate, complete answers.

  1. Jobs to be done: Opens with a clear statement of what the reader will accomplish.

  2. Disambiguation: Every reference is self-descriptive.

  3. Self-contained sections: Every section makes sense if retrieved in isolation.

  4. Semantic chunk boundaries: Long sections are broken up with meaningful subheadings.

  5. Query-answer symmetry: Headings mirror how a customer would phrase a question.

  6. Structured enumeration: Multi-step processes use numbered lists. Lists of items use bullet points.

  7. Instruction completeness: Completes every set of instructions, including what happens at the end.

  8. Numerical clarity: All numbers, thresholds, limits, durations, and quantities are stated precisely.

  9. Defined terms: Defines every abbreviation and product-specific term on first use.

  10. Audience specification: States who the content is for and what access is required.

  11. Limitations and workarounds: Documents known limitations explicitly, with workarounds.

  12. Entity distribution: Key product and feature names appear throughout (not just in the intro).

  13. Context in tables: Tables and standalone blocks include an introductory sentence.

  14. Visual content and alt text: Every image has descriptive alt text explaining what the screenshot or diagram shows.


💡Tip

Need more help? Get support from our Community Forum
Find answers and get help from Intercom Support and Community Experts


Did this answer your question?