# Pomocník k packu: /ai

> Hráč se zeptá /ai jak vyrobím vrtuli a model, který vybereš, odpoví podle seznamu modů, questů a poznámek tvého serveru - jen tomu, kdo se ptal, s limitem na hráče. Novinka 0.4, výchozí vypnuto.

Source: https://stygion.eu/cs/docs/keystone/pack-helper
Updated: 2026-11-16

Modul `helper`, novinka Keystone 0.4. Je vypnutý, dokud v `config/keystone/helper.toml` (nebo v **Settings**) nenastavíš `enabled = true` a nerestartuješ server - `enabled` modulu se čte jednou, při startu serveru - a neodpoví nic, dokud ho nenasměruješ na model.

## Co vidí hráči

`/ai jak vyrobím vrtuli?` - za pár vteřin krátká odpověď **jen tomu, kdo se ptal**, začínající `AI:`. Pomocník odpovídá v jazyce otázky. Dokud přemýšlí, další otázka počká; přes svůj podíl (`per-player.most` otázek za `per-player.every`, 5 za 10 minut) se hráč dozví, kdy se smí zeptat znovu. `keystone.ai` má ve výchozím stavu každý.

## Co ví

Model ke každé otázce dostane:

- mody, které server načetl, i s verzemi (`include.mods`);
- názvy kapitol a questů FTB Quests z `config/ftbquests/quests/lang/en_us.snbt`, když je pack má (`include.quests`);
- tvoje `notes` - pravidla, jak fungují ranky, kde je obchod, co pack mění. Čím víc tu napíšeš, tím míň musí říkat „nevím“.

Má pokyn použít jen tohle a co o těchto konkrétních modech ví jistě, a raději říct, že neví - a poslat hráče do JEI/EMI nebo za týmem - než si vymyslet recept, číslo nebo příkaz. I tak se model může splést; řekni to hráčům.

## Nastavení

| Nastavení | Co |
|---|---|
| `address` | jakákoli služba, která mluví tvarem OpenAI chat-completions: `https://api.groq.com/openai/v1` (Groq má free tier), `https://api.openai.com/v1`, `https://openrouter.ai/api/v1`, vlastní Ollama s `allow-local` |
| `key` | API klíč k té adrese |
| `model` | model, výchozí `openai/gpt-oss-120b` |
| `reasoning-effort` | posílá se modelům, které před odpovědí přemýšlejí; prázdné = nic |
| `server-name` | jak pomocník tvůj server nazývá |
| `answer-length`, `question-length` | 600 a 300 znaků |
| `at-once` | otázek naráz (2); ostatní se dozví, ať to zkusí za chvilku |
| `patience` | jak dlouho smí odpověď trvat (30 s) |

Adresu, klíč a `allow-local` smí měnit jen vlastník.

## Co odchází ze serveru

> [!IMPORTANT]
> Otázka jde spolu se seznamem modů, názvy questů a tvými poznámkami **na adresu, kterou nastavíš** - bez jména hráče a bez jakéhokoli ID. Dokud je `address` prázdná, nic se neposílá.

Odpověď je obyčejný text do chatu: bez markdownu a barevných kódů, zkrácená na `answer-length` a se zapnutým filtrem sprostých slov i přes něj. Otázky a odpovědi se neukládají.

Není to modul `assistant`: ten je pro tebe a čte útroby serveru přes API; pomocník je pro hráče a zná jen pack.
