> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tied.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Help Center

> A public knowledge base for customers, and the knowledge source your AI agent answers from.

The Help Center does two jobs at once, and the second is the one people underestimate.

**Publicly**, it is a knowledge base your customers can search and read — articles, categories, FAQs, on your own domain if you want.

**Internally**, it is the highest-quality thing you can point an AI agent at. An agent with no knowledge source can only escalate. An agent with a well-maintained Help Center can resolve a `knowledge` question outright, which is the cheapest resolution class there is and the one most of your volume will fall into.

<Info>
  **Writing your Help Center is agent training.** Every article you publish is something your agent can
  answer from without touching an external system. This is the highest-leverage content work in the
  product — it serves customers who prefer self-service *and* deflects the questions your agent would
  otherwise escalate.
</Info>

## How it is structured

<ResponseField name="Portal" type="the site">
  One published knowledge base — name, slug, branding, and optionally a custom domain. Most accounts
  need one. Run several to serve genuinely separate brands or audiences.
</ResponseField>

<ResponseField name="Category" type="the shelf">
  Groups articles. Categories **nest** — a category can have sub-categories — and can be linked to
  related categories for cross-referencing.
</ResponseField>

<ResponseField name="Article" type="the content">
  Belongs to a portal, and optionally to a category. Has an author and a status: `draft`, `published`
  or `archived`.
</ResponseField>

A portal can also be attached to a **web chat widget**, which is what puts Help Center search inside the widget so customers can find an answer before starting a conversation.

## Translations work by linking, not duplicating

This is the part worth understanding before you start writing in more than one language.

A translated article is not a copy. Each article has a **root** and a set of **associated** articles — its translations. Categories work the same way. The relationship is explicit, which means a reader gets routed to their language rather than to a near-duplicate that search treats as competing content.

Plan the root language first and translate from it. Retrofitting a translation structure onto articles written independently in three languages is considerably more work than doing it in order.

## Article states

| State | Visible publicly | Agent can answer from it |
| - | - | - |
| `draft` | No | No |
| `published` | Yes | Yes |
| `archived` | No | No |

<Warning>
  **Archiving an article removes it from your agent's knowledge.** If customers still ask about
  something, archiving the article does not stop the questions — it just stops the agent being able to
  answer them. Update rather than archive unless the topic is genuinely dead.
</Warning>

## Where to start

<Steps>
  <Step title="Write the ten questions you actually get" icon="pencil">
    Not the ones you wish you got. Pull them from your existing inbox. Ten real articles beat fifty
    speculative ones, both for customers and for the agent.
  </Step>

  <Step title="Group them into categories" icon="folder-tree">
    Structure emerges from the content. Do not design a taxonomy before you have articles to put in it.
  </Step>

  <Step title="Publish and point your agent at it" icon="bot">
    A published article is immediately available as agent knowledge. See [AI agents](/agents).
  </Step>

  <Step title="Let the inbox tell you what is missing" icon="inbox">
    Every escalation your agent could not answer is a gap in your knowledge base. That feedback loop is
    the point.
  </Step>
</Steps>

## In this section

<CardGroup cols={2}>
  <Card title="Creating a portal" icon="layout-template" href="/help-center/portals">
    Setup, slug, branding, and running more than one.
  </Card>

  <Card title="Categories and structure" icon="folder-tree" href="/help-center/categories">
    Nesting, ordering and related categories.
  </Card>

  <Card title="Writing and publishing articles" icon="file-pen" href="/help-center/articles">
    The editor, draft state, authorship and SEO.
  </Card>

  <Card title="FAQs" icon="circle-question-mark" href="/help-center/faqs">
    Question-and-answer sets, and how they differ from articles.
  </Card>

  <Card title="Locales and translations" icon="languages" href="/help-center/locales">
    The root-and-associated model, in practice.
  </Card>

  <Card title="Portal settings and custom domain" icon="settings-2" href="/help-center/settings">
    Theming, domain, search behaviour and visibility.
  </Card>
</CardGroup>

## Next

<CardGroup cols={2}>
  <Card title="AI agents" icon="bot" href="/agents">
    Pointing an agent at the Help Center you just wrote.
  </Card>

  <Card title="Inserting articles into replies" icon="book-marked" href="/inbox/insert-article">
    Human agents using the same content in the inbox.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.