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

# Service Settings

> Configure Aiko's optional service modules: mentions, ticket assistant, and FAQ

Service Settings groups three optional modules behind one screen. Each is independent — turning one on or off has no effect on the others.

## Open Service Settings

`/settings` → **Manage** next to **Service Settings**

Each module below has its own **Manage** button on this screen.

You need Discord's **Manage Server** permission to change this.

<Tabs>
  <Tab title="Mention">
    Mention settings control where Aiko answers @mentions and replies. They don't affect the `/aiko` slash command, which always works where it's available.

    ### Open mention settings

    Service Settings → **Manage** next to **Mention → Modal Form**

    | Field                            | Meaning                                                                                                                                                                                |
    | -------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
    | **Enabled**                      | Turns @mention/reply responses on or off for the whole server. Members can still use `/aiko` when off.                                                                                 |
    | **Scope**                        | **All channels** — respond anywhere Aiko can read. **Whitelist only** — respond only in the listed channels. **All except blacklist** — respond everywhere except the listed channels. |
    | **Whitelist/blacklist channels** | Used by the Scope modes above; ignored in All channels mode.                                                                                                                           |

    <Tip>
      Common setups: a dedicated help channel → **Whitelist only** + `#help`.

      Keep Aiko out of staff areas → **All except blacklist** + staff channels.

      Slash-command only → turn **Enabled** off.
    </Tip>
  </Tab>

  <Tab title="Ticket Assistant">
    The ticket assistant automatically answers questions from non-staff members inside designated support-ticket categories, using the server's [reference material](/reference) — no @mention needed.

    ### Open ticket settings

    Service Settings → **Manage** next to **Ticket Assistant → Modal Form**

    | Field                  | Meaning                                                                                                                 |
    | ---------------------- | ----------------------------------------------------------------------------------------------------------------------- |
    | **Enabled**            | Turns the assistant on or off for the whole server.                                                                     |
    | **Ticket categories**  | Every channel inside these Discord **categories** counts as a ticket channel. Pick categories, not individual channels. |
    | **Staff roles**        | Members with any of these roles are never auto-answered; while one is active in a channel, auto-answers pause there.    |
    | **Cooldown (seconds)** | Minimum time between auto-answers in the same channel. Whole number, **0–3600**.                                        |

    <Note>
      Because nobody @mentioned Aiko, the assistant stays **silent** instead of apologizing whenever it can't help — a staff member is active, the channel's on cooldown, the reference material has nothing grounded to answer with, or the server/member is over its [usage quota](/quota).
    </Note>

    <Warning>
      Requires [reference material](/reference) to be bound to the server — with none configured, it stays silent for every question.
    </Warning>
  </Tab>

  <Tab title="FAQ Settings">
    FAQ fast-path answers common questions instantly and for free, skipping the AI cascade entirely — as long as the incoming question is a close paraphrase of something already saved. Exact wording never has to match.

    ### Open FAQ settings

    Service Settings → **Manage** next to **FAQ**

    Every FAQ control lives on this one screen.

    **Enable / Disable** — turns FAQ matching on or off. Existing entries are never deleted by disabling; turning it back on brings them all back immediately.

    **Entry → Add** — opens a modal with **Question** (matched by meaning, not exact wording) and **Answer** (shown to users exactly as written, no other context added). Goes live immediately on submit.

    **All Entries → View** — lists every live entry in full, each with its own **Remove** button. The only place entries are removed, whether typed manually or generated by AI.

    **Generate from reference** — drafts FAQ pairs from whatever [reference material](/reference) is already bound, using AI. Pick how many to generate (pre-filled with however many entries are left before the cap). Auto-writes each returned pair live.

    <Warning>
      Generating costs real credits, billed the same as a normal AI answer, and is subject to the server's [usage quota](/quota). A reference document must already be bound — Aiko can't generate from nothing.
    </Warning>

    <Info>
      A server can hold at most **10** live FAQ entries in total — manual and AI-generated combined, on every plan.
    </Info>

    #### What a FAQ match looks like

    | Part   | Content                                                              |
    | ------ | -------------------------------------------------------------------- |
    | Header | **FAQ found**                                                        |
    | Body   | The matched **Q:** and **A:**, verbatim                              |
    | Footer | **Confidence: N%** — how closely your question matched the saved one |

    No **sources** or **usage** buttons on a FAQ-matched reply — there's no AI cascade run to show for it, and it cost nothing. If nothing matches closely enough, or FAQ is disabled, Aiko falls through to the normal AI cascade instead.

    <Note>
      FAQ matching runs before every real question — @mention, `/aiko`, and the ticket assistant alike. It doesn't apply to Aiko's internal utility calls (e.g. extracting a memory fact).
    </Note>
  </Tab>
</Tabs>