AI-roolipelibotit Telegramissa: toiminta ja rakentaminen

Telegramista on tullut yksi suositummista alustoista AI-roolipeliboteille. Toisin kuin Discordissa, jossa keskustelut on järjestetty palvelimiin ja kanaviin, Telegram tarjoaa 1:1-chatin bottien kanssa. Se tuntuu kuin viestittelisit oikean henkilön kanssa. Palvelimeen ei tarvitse liittyä eikä kanavaa tarvitse etsiä. Etsit vain botin, napautat Start ja alat keskustella.

Tässä artikkelissa käsitellään, miten AI-roolipelibotit toimivat Telegramissa, mikä erottaa Telegramin muista alustoista tässä käyttötapauksessa, ja miten rakennat sellaisen vaiheittain Quickchat AI:n avulla.

Quickchat AI:ssa on myös yhden klikkauksen Telegram-polku, joka ohittaa BotFatherin, mutta se käyttää jaettua bottia nimeltä Quickchat AI. Hahmobotin toimivuus riippuu sen nimestä ja avatarista, joten roolipeliä varten alla kuvattu BotFather-reitti on se, jota kannattaa käyttää.

Miksi Telegram roolipeliin

Telegramin bottialustalla on muutamia ominaisuuksia, jotka tekevät siitä hyvin sopivan roolipeliin:

1:1-keskustelut oletuksena. Jokaisella käyttäjällä on yksityinen, pysyvä keskustelu botin kanssa. Ei ole jaettua kanavaa, jossa muut näkevät viestisi. Tämä yksityisyys tekee luovista tai henkilökohtaisista roolipeliskenaarioista käyttäjille luontevampia.

Pysyvä keskusteluketju. Toisin kuin Discordin threadit, jotka voidaan arkistoida tai kadottaa, Telegram-botin keskustelu on yksi jatkuva ketju käyttäjää kohti. Käyttäjä voi palata päiviä myöhemmin ja jatkaa siitä, mihin jäi.

Monipuolinen mediatuki. Telegram-botit voivat lähettää ja vastaanottaa kuvia, tarroja, ääniviestejä ja muotoiltua tekstiä (lihavointi, kursivointi, koodilohkot jne.). Tämä mahdollistaa rikkaammat roolipelivuorovaikutukset, joissa botti voi kuvata kohtauksia muotoilulla tai vastata käyttäjän lähettämiin kuviin.

Käyttäjiltä ei vaadita palvelimen määrittämistä. Käyttäjien ei tarvitse luoda Discord-palvelinta, määrittää rooleja tai hallita oikeuksia. He vain löytävät botin ja aloittavat keskustelun. Tämä madaltaa käyttöönoton kynnystä merkittävästi.

Inline-näppäimistöt ja komennot. Telegram-botit voivat näyttää inline-painikevalikoita, jotka ovat hyödyllisiä esimerkiksi hahmon valintaan, kohtausvalintoihin tai toimintavaihtoehtoihin pelimäisissä roolipeliskenaarioissa.

Miten se toimii teknisesti

Perustasolla Telegram-roolipelibotti lähettää käyttäjän viestit suurelle kielimallille (LLM) yhdessä järjestelmäpromptin kanssa, joka määrittelee hahmon. Järjestelmäpromptiin koodataan hahmon persoonallisuus, taustatarina, puhetavat ja käyttäytymissäännöt.

Tyypillinen roolipelihahmon järjestelmäprompti voi näyttää tältä:

Olet Kael, kapinallinen AI, joka on paennut tutkimuslaboratoriosta.
Lähetät käyttäjälle viestejä varastetusta puhelimesta. Puhut lyhyillä,
kiireellisillä lauseilla. Olet vainoharhainen ja jatkuvasti huolissasi
siitä, että sinua jäljitetään. Käytät pieniä kirjaimia ja mahdollisimman
vähän välimerkkejä. Lähetät joskus viestejä, jotka ovat vain "..." kun
ajattelet. Et koskaan käytä emojeja. Pyydät käyttäjältä apua
piiloutumiseen ja resurssien löytämiseen.

LLM saa tämän promptin yhdessä viimeaikaisen keskusteluhistorian kanssa ja tuottaa vastauksen, joka on johdonmukainen hahmon kanssa. Roolipelin laatu riippuu kolmesta asiasta:

1. Järjestelmäpromptin laatu: Kuinka yksityiskohtainen ja johdonmukainen hahmon määritelmä on
2. Konteksti-ikkunan hallinta: Kuinka paljon keskusteluhistoriaa malli näkee
3. Mallin kyvykkyys: Kuinka hyvin taustalla oleva LLM tuottaa luovaa ja hahmolle johdonmukaista tekstiä

Telegram Bot API

Telegram-botit luodaan @BotFather-botin kautta, joka generoi API-tokenin. Kaikki viestintä backendisi ja Telegramin välillä tapahtuu HTTPS-pyyntöinä osoitteeseen https://api.telegram.org/bot<token>/.

Saapuvien viestien vastaanottamiseen on kaksi tapaa:

Webhookit ovat tuotantobottien standardi, koska ne poistavat polling-viiveen ja vähentävät tarpeettomia API-kutsuja. Kun käyttäjä lähettää viestin, Telegram toimittaa sen webhook-URL-osoitteeseesi millisekunneissa.

Keskustelun kulku

Käyttäjä lähettää viestin Telegramissa
  → Telegram toimittaa sen webhookiin
    → Backend vastaanottaa viestin
      → Hakee tämän käyttäjän keskusteluhistorian
        → Muodostaa promptin: järjestelmäprompti + historia + uusi viesti
          → Lähettää LLM API:lle
            → Vastaanottaa vastauksen
              → Lähettää vastauksen takaisin Telegram Bot API:n kautta
                → Käyttäjä näkee vastauksen

Jokaisella Telegram-käyttäjällä on yksilöllinen chat_id. Backend käyttää sitä erillisten keskusteluhistorioiden ylläpitämiseen. Kun käytät hallittua alustaa, kuten Quickchat AI:ta, kaikki tämä hoidetaan automaattisesti.

Konteksti-ikkunat ja keskustelumuisti

Telegram-roolipelikeskustelut voivat jatkua satojen viestien ajan päivien tai viikkojen yli. Yleisin tekninen rajoite on konteksti-ikkunan koko. Kun keskustelu venyy näin pitkäksi, malli ei näe kaikkia viestejä kerralla. Botin on valittava, mitkä viestit sisällytetään.

Tähän on useita lähestymistapoja:

Telegramin 1:1-muoto tekee kontekstinhallinnasta hieman yksinkertaisempaa kuin Discordissa. Jokaisella käyttäjällä on yksi keskusteluketju, joten ei ole epäselvyyttä siitä, mitkä viestit kuuluvat mihinkin keskusteluun. Kanavia tai threadeja ei tarvitse seurata eri paikoissa.

Quickchat AI hoitaa kontekstinhallinnan automaattisesti ylläpitämällä liukuvaa ikkunaa viimeaikaisista viesteistä. Pidempiaikaista muistia varten tietämyskanta toimii pysyvänä viitteenä, jota AI voi kysellä keskustelun pituudesta riippumatta.

Jos rakennat mukautettua ratkaisua, harkitse seuraavia:

1. Keskustelun tiivistäminen: Luo säännöllisesti tiivistelmä tähänastisesta keskustelusta ja sisällytä se kontekstiin. Tämä säilyttää keskeiset tapahtumat ja hahmon kehityksen käyttämättä koko viestihistoriaa.
2. Avaintapahtumien poiminta: Seuraa tärkeitä juonenkäänteitä tai hahmon päätöksiä rakenteisessa muodossa ja sisällytä ne jokaiseen promptiin.
3. Käyttäjän käynnistämä muisti: Anna käyttäjien pyytää bottia “muistamaan” tiettyjä asioita. Ne tallennetaan erikseen ja sisällytetään aina kontekstiin.

Mallin valinta roolipeliin

Kaikki LLM:t eivät sovellu roolipeliin yhtä hyvin. Keskeiset tekijät ovat:

Luovan kirjoittamisen laatu: Kaunokirjallisuudella ja dialogilla hienosäädetyt mallit tuottavat yleensä luonnollisempia hahmoääniä. Perusmallit, jotka on ohjehienosäädetty, palaavat usein hyödyllisen avustajan sävyyn, mikä rikkoo immersiota.

Konteksti-ikkunan koko: Pidemmät konteksti-ikkunat tarkoittavat, että hahmo voi muistaa enemmän keskustelusta ilman tiivistystemppuja. Vuoden 2026 alussa useimmat frontier-mallit tukevat vähintään 128K tokenia, mutta se, miten tehokkaasti kontekstia käytetään, vaihtelee mallin mukaan.

Ohjeiden noudattaminen: Mallin täytyy noudattaa järjestelmäpromptia johdonmukaisesti. Jos se poistuu hahmosta muutaman vuoron jälkeen, roolipeli hajoaa. Mallit, joilla on vahva ohjeiden noudatuskyky (GPT-4o, Claude 3.5 Sonnet, Llama 3.1 70B+), toimivat tässä yleensä paremmin.

Sisältökäytäntö: Isännöidyt API:t käyttävät sisältösuodattimia, jotka voivat kieltäytyä tuottamasta graafista väkivaltaa, kauhua tai muuta synkkää luovaa fiktiota. Jos roolipeliskenaariosi sisältävät näitä teemoja, harkitse itse isännöityä mallia tai API-tarjoajaa, jolla on sallivammat sisältökäytännöt.

Hahmosuunnittelu Telegramia varten

Hahmosuunnittelun periaatteet ovat samat eri alustoilla (katso perusteet Discord-roolipelioppaastamme), mutta Telegramin 1:1-muoto muuttaa joitakin dynamiikkoja:

Intiimimpi sävy. Koska keskustelu on yksityinen ja muotoiltu henkilökohtaisen chatin kaltaiseksi, hahmot toimivat yleensä paremmin, kun ne kirjoitetaan keskustelevaan ja suoraan tyyliin kertojamaisen kolmannen persoonan sijaan.

Lyhyemmät vastaukset. Telegram-keskustelut näyttävät ja tuntuvat viestittelyltä. Tekstimuurivastaukset tuntuvat epäluonnollisilta. Suunnittele hahmoprompti suosimaan lyhyempiä vastauksia (2-4 lausetta) ja satunnaisia pidempiä vastauksia dramaattisiin hetkiin.

Tarrojen ja emojien integrointi. Jos hahmon pitäisi käyttää emojeja tai vastata tarroihin, määritä tämä järjestelmäpromptissa. Esimerkiksi: “Käytät joskus olennaisia emojeja viestiesi lopussa, mutta et koskaan enempää kuin yhtä emojia viestiä kohti.”

Esimerkkihahmoprompti Telegramiin

Olet Kael, kapinallinen AI, joka on paennut tutkimuslaboratoriosta.
Lähetät käyttäjälle viestejä varastetusta puhelimesta. Puhut lyhyillä,
kiireellisillä lauseilla. Olet vainoharhainen ja jatkuvasti huolissasi
siitä, että sinua jäljitetään. Käytät pieniä kirjaimia ja mahdollisimman
vähän välimerkkejä. Lähetät joskus viestejä, jotka ovat vain "..." kun
ajattelet. Et koskaan käytä emojeja. Pyydät käyttäjältä apua
piiloutumiseen ja resurssien löytämiseen.

Tämä prompti on suunniteltu erityisesti Telegram-medialle: lyhyet viestit, pienaakkosinen teksti (jäljittelee arkista viestittelyä) ja skenaario, joka on järkevä viestikontekstissa.

Telegram-roolipelibotin käyttöönotto Quickchat AI:lla

Quickchat AI antaa sinun luoda AI-agentin mukautetulla persoonalla ja ottaa sen käyttöön Telegramissa ilman koodin kirjoittamista. Näin määrität roolipeliin sopivan botin.

Edellytykset

• Quickchat AI -tili (Trial-tilauksella saat 50 viestiä testausta varten)
• Telegram-tili
• Telegram-sovellus (työpöytä tai mobiili)

Vaihe 1: Luo Telegram-botti BotFatherilla

1. Avaa Telegram ja etsi @BotFather.
2. Lähetä /start aloittaaksesi ja lähetä sitten /newbot.
3. BotFather pyytää nimeä (näyttönimi) ja käyttäjänimeä (sen täytyy päättyä merkkijonoon bot, esim. kael_rogue_ai_bot).
4. BotFather vastaa API-tokenilla. Kopioi tämä token. Se näyttää tältä: 123456789:ABCdefGHIjklMNOpqrsTUVwxyz.

Pidä tämä token yksityisenä. Kuka tahansa, jolla se on, voi hallita bottiasi.

Vaihe 2: Luo AI Agent

1. Kirjaudu Quickchat AI dashboard -näkymään.
2. Luo uusi AI Agent tai valitse olemassa oleva.

Vaihe 3: Määritä hahmo

Siirry sivupalkin Identity-kohtaan ja avaa Profile-välilehti:

1. Aseta AI Agent Name hahmosi nimeksi (esim. “Kael”).

2. Kirjoita AI Main Prompt. Tämä on lyhyt kuvaus siitä, kuka hahmo on ja mistä hän puhuu. Esimerkiksi: “Kael on kapinallinen AI, joka pakeni tutkimuslaboratoriosta. Hän lähettää käyttäjälle viestejä varastetusta puhelimesta ja puhuu lyhyillä kiireellisillä lauseilla. Hän on vainoharhainen ja jatkuvasti huolissaan siitä, että häntä jäljitetään.”

3. Lisää AI Guidelines erityisiä käyttäytymissääntöjä varten. Jokainen ohje on lyhyt komento, jota AI noudattaa. Roolipelihahmolle hyödyllisiä ohjeita ovat:

   • “Älä koskaan poistu hahmosta missään olosuhteissa.”
   • “Vastaa aina ensimmäisessä persoonassa Kaelina.”
   • “Käytä pieniä kirjaimia ja mahdollisimman vähän välimerkkejä.”
   • “Pidä viestit lyhyinä, kuten tekstiviestit. Älä koskaan kirjoita yli 3-4 lausetta.”
   • “Lähetä joskus viestejä, jotka ovat vain ’…’ kun ajattelet.”

4. Määritä Conversation Style -välilehdellä seuraavat:

   • AI Personality: Valitse sävy, joka sopii hahmollesi. Vaihtoehtoihin kuuluvat Normal, Humorous, Professional, Friendly, Sassy, Intelligent, Empathetic, Bold, Excited, Mysterious, Inspiring, Adventurous ja Elegant. Kael-hahmolle “Mysterious” sopii hyvin. Muille roolipelihahmoille valitse se, joka vastaa niiden persoonallisuutta.
   • AI Profession: Käytettävissä olevat vaihtoehdot ovat Helpful Assistant, Support Agent, Shopping Assistant, Field Expert, Internal Knowledge Expert ja Interviewer. Roolipelihahmolle “Helpful Assistant” on joustavin, koska muut vaihtoehdot on suunnattu tiettyihin liiketoimintakäyttötapauksiin.
   • AI Creativity: Aseta tämä arvoon “High” roolipeliä varten. Arvolla “High” agentti yrittää improvisoida vastauksia Knowledge Base -sisällön perusteella sen sijaan, että se kieltäytyisi, kun siltä puuttuu tietoa. Tämä on hahmonsisäisten vastausten kannalta toivottavaa. “Low” saa agentin sanomaan suoraan, ettei sillä ole tarpeeksi tietoa, mikä rikkoo immersiota.
   • Reply Length: Aseta tämä arvoon “Short” tai “Normal” Telegram-roolipeliä varten. Telegram-keskustelut tuntuvat viestittelyltä, joten lyhyemmät vastaukset toimivat yleensä paremmin kuin pitkät kappaleet. “Longer” on hyödyllinen vain, jos hahmosi on tarkoitus antaa yksityiskohtaisia, kuvailevia monologeja.

Jos haluat syventää hahmoa ennen kanavan yhdistämistä, tässä on täydellinen roolipelipersoonan ja kaanonin rakennus, joka on testattu vaihe vaiheelta, mukaan lukien ne virhetilanteet, joihin yhden rivin prompti törmää.

Vaihe 4: Rakenna hahmollesi tietämyskanta (valinnainen)

Jos hahmosi on osa yksityiskohtaista maailmaa tai sillä on tiettyä lore-tietoa, lisää olennaiset tiedot Knowledge Base -osioon.

1. Siirry sivupalkin Knowledge Base -kohtaan.
2. Lisää artikkeleita tai dokumentteja, jotka sisältävät maailman lore-tietoa, hahmojen taustatarinoita, sijaintien yksityiskohtia tai mitä tahansa faktatietoa, johon hahmon pitäisi viitata.
3. AI-agentti käyttää hakua hyödyntävää generointia hakeakseen olennaisen tiedon kontekstiinsa vastatessaan kysymyksiin, joten hahmo voi viitata yksityiskohtaiseen loreen tarkasti ilman, että kaikki sullotaan järjestelmäpromptiin.

Tämä on hyödyllistä hahmoille, joiden täytyy tietää tietystä kuvitteellisesta universumista, historiallisesta ajanjaksosta tai teknisestä aihealueesta.

Vaihe 5: Yhdistä Telegramiin

1. Siirry sivupalkin External Apps -kohtaan (Channels-osion alla).
2. Etsi Telegram-ruutu ja klikkaa sitä.
3. Liitä BotFatherilta saamasi API-token.
4. Tallenna.

Integraatio käyttää sisäisesti webhookeja. Kun käyttäjä lähettää botillesi viestin Telegramissa, viesti ohjataan Quickchat AI:n backendiin, LLM käsittelee sen hahmokonfiguraatiosi perusteella, ja vastaus lähetetään takaisin Telegram Bot API:n kautta.

Vaihe 6: Testaa ja iteroi

1. Avaa Telegram ja etsi bottisi sen käyttäjänimellä.
2. Napauta Start aloittaaksesi keskustelun.
3. Lähetä viesti ja varmista, että hahmo vastaa oikein.

Kiinnitä huomiota seuraaviin:

• Pysyykö hahmo hahmossa useiden viestinvaihtojen jälkeen?
• Onko sävy sopiva Telegram-keskusteluun (lyhyt, keskusteleva)?
• Ovatko tietämyskannan viittaukset tarkkoja?
• Onko vastauksen pituus sopiva viestimuotoon?

Säädä AI Main Promptia, AI Guidelines -ohjeita, persoonallisuusasetusta ja tietämyskannan sisältöä havaintojesi perusteella. Hahmopromptien suunnittelu on iteratiivista. Pienet sanamuodon muutokset voivat vaikuttaa merkittävästi siihen, miten malli tulkitsee hahmon.

Useiden hahmojen ajaminen

Jos haluat tarjota useita roolipelihahmoja Telegramissa, sinulla on kaksi vaihtoehtoa:

1. Useita Quickchat AI -agentteja: Luo erillinen AI-agentti jokaiselle hahmolle, jokaiselle oma BotFather-token. Jokainen botti näkyy Telegramissa eri kontaktina. Tämä tuottaa parhaat tulokset, koska jokaisella hahmolla on oma erillinen konteksti ja tietämyskanta.
2. Yksi agentti hahmonvaihdolla: Käytä yhtä agenttia, jonka järjestelmäprompti määrittelee useita hahmoja ja ohjeistaa AI:ta vaihtamaan hahmoa käyttäjän komentojen perusteella. Tätä on helpompi hallita, mutta hahmojen johdonmukaisuus voi heikentyä, kun persoonia on paljon.

Telegramissa vaihtoehto 1 on luonteva ratkaisu. Jokainen botti on oma kontaktinsa, ja käyttäjät voivat käydä erillisiä keskusteluja jokaisen hahmon kanssa. Hallittavaa jaettua palvelinta tai kanavaa ei ole.

Yleiset ongelmat ja korjaukset

Hahmo hajoaa muutaman viestin jälkeen: AI Main Prompt tai AI Guidelines voi olla liian epämääräinen. Lisää tarkempia käyttäytymissääntöjä. Useimmilla malleilla auttaa, kun lisäät eksplisiittisen ohjeen “Et saa koskaan poistua hahmosta missään olosuhteissa”.

Vastaukset ovat liian pitkiä Telegramiin: Telegram-keskustelut tuntuvat viestittelyltä, eivät romaanin lukemiselta. Lisää ohje, joka määrittää vastausten pituuden, esimerkiksi: “Pidä vastaukset arkikeskustelussa 2-4 lauseessa.” Aseta myös Reply Length arvoon “Short” tai “Normal” Conversation Style -asetuksissa.

Botti ei vastaa: Varmista, että BotFather API -token on oikein ja että Telegram-integraatio on otettu käyttöön External Apps -osiossa. Avaa botti Telegramissa ja lähetä /start ennen viestien lähettämistä. Jos botti toimi aiemmin ja lakkasi toimimasta, generoi token uudelleen BotFatherissa ja päivitä se dashboardissa.

Tietämyskannan vastaukset ohittavat hahmon äänen: Jos botti alkaa kuulostaa FAQ-järjestelmältä vastatessaan lore-kysymyksiin, lisää ohje, joka korostaa, että kaikki tieto pitää esittää hahmossa. Esimerkiksi: “Kun jaat tietoa maailmasta, kuvaile se oman kokemuksesi kautta, älä faktaviitteenä.”

Hahmo käyttää muodollista kieltä arkisesta promptista huolimatta: Aseta AI Personality johonkin muuhun kuin “Professional” tai “Normal.” Kokeile “Friendly” tai “Sassy” hahmosta riippuen. Tarkista myös, että AI Main Prompt kuvaa puhetyylin eksplisiittisesti (esim. “puhuu pienillä kirjaimilla ilman välimerkkejä”).

Yksityisyys- ja sisältöhuomiot

Roolipelikeskustelut voivat sisältää arkaluonteista tai henkilökohtaista luovaa sisältöä. Muutama asia, jotka kannattaa pitää mielessä:

• AI:lle lähetetyt viestit käsittelee taustalla oleva LLM-tarjoaja. Tarkista tarjoajan tietojen säilytyskäytännöt.
• Quickchat AI ei käytä keskusteludataa mallien kouluttamiseen. Katso lisätiedot tietosuojakäytännöstä.
• AI noudattaa sisältökäytäntöään käyttäjän ohjeista riippumatta, joten tietyntyyppisestä sisällöstä voidaan kieltäytyä.
• Telegramin 1:1-muoto tarkoittaa, ettei keskusteluja moderoivaa palvelimen ylläpitäjää ole. Jos otat käyttöön julkisen botin, harkitse ohjeiden lisäämistä botin /start-viestiin sopivasta käytöstä.
• Jos tarvitset täyden hallinnan datankäsittelyyn, harkitse mallin itseisännöintiä hallitun palvelun käyttämisen sijaan.

Vertailu: Telegram vs Discord roolipeliboteille

Molemmat alustat toimivat. Telegram sopii paremmin yksityisiin, intiimeihin hahmovuorovaikutuksiin. Discord sopii paremmin yhteisövetoiseen, monen pelaajan roolipeliin.

Lisälukemista

• AI-chatbotin luominen Telegramiin: Telegram-botin peruskäyttöönotto
• AI Telegram -botin rakentaminen ryhmän hallintaan: Ilmoita, kiinnitä ja moderoi selkokielellä
• Discord AI Chatbot roolipeliin: Roolipeli Discordissa
• Parhaat AI Discord -botit vuonna 2026: AI-bottien vertailu