Siirry pääsisältöön
Asennus kestää noin 15 minuuttia. Tarvitset neljä asiaa:
  • EchoAuth AI Agent -lisenssiavain. Osta se kaupasta, jos sinulla ei vielä ole sellaista.
  • Discord-palvelin, jolle voit lisätä botteja ja hallita rooleja.
  • OpenRouter-API-avain. Yksi OpenRouter-avain kattaa kaiken, mitä agentti tarvitsee: vastaukset, kuvakaappaukset ja haun.
  • Valinnaisesti dokumentaatiosivusto tai kirjallista dokumentaatiota, josta agentti voi vastata.
Me ylläpidämme agenttiasi ja pidämme sen käynnissä. Määrität sen hallintapaneelissa osoitteessa agent.echoauth.dev.
Suositeltu asetus. Pitkäaikaiset testit tehtiin vain OpenRouterilla käyttäen näitä kolmea mallia:Hallintapaneelissa on saatavilla myös muita tarjoajia (NVIDIA, OpenAI, Anthropic), mutta tämä on yhdistelmä, jota olemme testanneet pitkään.

1. Luo tili

1

Avaa rekisteröintisivu

Siirry osoitteeseen agent.echoauth.dev/register.
2

Syötä lisenssiavain

Liitä avain ostosvahvistuksen sähköpostista. Se näyttää tältä: ECHO-XXXX-XXXX-XXXX-XXXX.
3

Valitse käyttäjätunnus ja salasana

Salasanan on oltava vähintään 8 merkkiä. Napsauta Create account.
Rekisteröintilomake, jossa kentät lisenssiavaimelle, käyttäjätunnukselle ja salasanalle

Rekisteröintisivu

Kun lisenssisi on aktiivinen, agenttisi luodaan puolestasi. Päädyt hallintapaneeliin, jossa näet agentin, lisenssisi ja käyttötilastot.
Hallintapaneeli, jossa yksi agentti, lisenssin tila ja käyttö

Hallintapaneeli kirjautumisen jälkeen

Jos näkyvissä on No agents yet, avaa sivupalkista License ja tarkista, että lisenssisi on aktiivinen.
Napsauta agenttiasi avataksesi sen sivun. Kaikki tämän oppaan muu alkaa tästä: Configure avaa asetukset, Live logs näyttää, mitä agentti tekee, ja Update Agent ottaa käyttöön asetukset, jotka vaativat uudelleenkäyttöönoton.
Agentin sivu, jossa Configure, Live logs, Restart ja Update Agent

Agentin sivu

2. Luo Discord-bottisi

Agenttisi vastaa omistamasi Discord-botin kautta. Luo se Discord Developer Portalissa.
1

Luo sovellus

Avaa Discord Developer Portal ja napsauta New Application. Nimeä se tukiagenttisi mukaan, esimerkiksi “Acme Support”.
2

Ota Message Content -intent käyttöön

Siirry kohtaan Bot. Ota kohdassa Privileged Gateway Intents käyttöön Message Content Intent ja tallenna.
Ilman tätä intenttiä botti saa tyhjiä viestejä eikä koskaan vastaa.
3

Kopioi botin tunnus

Napsauta edelleen kohdassa Bot Reset Token ja kopioi tunnus. Liität sen hallintapaneeliin seuraavassa osiossa. Pidä se yksityisenä: kuka tahansa, jolla on tunnus, voi ohjata bottiasi.
4

Kutsu botti palvelimellesi

Siirry kohtaan OAuth2 → URL Generator. Valitse scopet bot ja applications.commands sekä nämä botin oikeudet:
  • View Channels
  • Send Messages
  • Read Message History
  • Embed Links
  • Attach Files
Avaa luotu osoite ja lisää botti palvelimellesi.
5

Anna botille pääsy tikettikategoriaasi

Varmista, että botin rooli näkee kategorian, johon tikettikanavasi luodaan. Jos se ei näe kanavaa, se ei voi vastata.

3. Lisää avaimesi

Luo API-avain osoitteessa openrouter.ai/keys ja lisää OpenRouter-tilillesi saldoa. Vision-malli on ilmainen, mutta chat- ja embedding-mallit maksavat käytön mukaan. Napsauta sitten agenttisi sivulla Configure ja avaa API Keys -välilehti.
API Keys -välilehti, jossa OpenRouter-API-avain ja Discord-botin tunnus on merkitty configured

API Keys -välilehti, jossa OpenRouter-avain ja Discord-botin tunnus on määritetty

  1. Liitä avaimesi kohtaan OpenRouter API Key.
  2. Liitä Discord Bot Token.
  3. Napsauta Save.
Voit jättää OpenAI-, Anthropic- ja NVIDIA-kentät tyhjiksi. Avaimet tallennetaan salattuina, eikä niitä näytetä enää tallennuksen jälkeen. configured-merkki vahvistaa, että avain on asetettu.

4. Valitse tekoälymallisi

Avaa AI Settings -välilehti. Agentti käyttää kolmea mallia. Aseta kaikki kolme tarjoajaksi OpenRouter ja valitse suositellut mallit:
AI Settings -välilehti, jossa OpenRouter valittuna chat-, vision- ja embedding-malleille

AI Settings -välilehti suositelluilla OpenRouter-malleilla

Embedding-mallin alla hallintapaneeli varoittaa, että se ylittää 2000 ulottuvuutta. Tämä on odotettua mallille qwen/qwen3-embedding-8b. Haku toimii silti: se tarkistaa jokaisen kappaleen indeksin käyttämisen sijaan, mikä pysyy nopeana muutaman tuhannen kappaleen tietopankissa.
Kirjoita sitten Base Prompt. Se on agentin pysyvät ohjeet: kenelle se työskentelee, mitä sävyä käyttää ja mitä sen ei koskaan pitäisi tehdä. Esimerkiksi:
Valitse embedding-mallisi ennen kuin indeksoit mitään. Sen vaihtaminen myöhemmin tekee nykyisestä indeksistä käyttökelvottoman, kunnes rakennat sen uudelleen.

5. Yhdistä se tiketteihisi

Avaa Discord-välilehti. Nämä asetukset kertovat agentille, mihin vastata ja ketä pidetään henkilökuntana.
Discord-välilehti, jossa owner-roolit, staff-roolit, tikettikategorioiden ID:t, tikettibottien ID:t ja kuvamallit

Discord-välilehti

Kopioidaksesi ID:t ota Discordissa kohdassa User Settings → Advanced käyttöön Developer Mode. Napsauta sitten roolia, kategoriaa tai käyttäjää hiiren kakkospainikkeella ja valitse Copy ID.
Roolit, jotka saavat käyttää kaikkia kauttaviivakomentoja, mukaan lukien /pause_bot ja /edit_base. Erota useat ID:t pilkuilla.
Tukitiimisi roolit. Kun henkilökunnan jäsen kirjoittaa tikettiin, agentti astuu sivuun ja pysyy hiljaa kyseisessä tiketissä. Saadaksesi sen takaisin mainitse botti tiketissä tai käytä siellä komentoa /restart.
Kategoriat, joihin tikettikanavasi luodaan. Agentti vastaa vain näiden kategorioiden sisällä.
Tikettibottisi käyttäjätunnus, kuten Ticket Tool tai SellAuth Tickets. Agentti ohittaa muut botit, joten lisää omasi tähän, jotta agentti voi lukea tiketin avausviestin.
Varavision-mallit, yksi per rivi, joita kokeillaan järjestyksessä, jos AI Settings -asetusten vision-malli epäonnistuu. Lisää nämä varavaihtoehdot:
nvidia/nemotron-3-nano-omni-30b-a3b-reasoning:free
google/gemma-4-31b-it:free
google/gemma-4-26b-a4b-it:free
thinkingmachines/inkling-small:free
dots-studio/dots-3-note-preview:free
Napsauta Save.

6. Anna agentille dokumentaatiosi

Avaa Knowledge Base -välilehti. Agentti vastaa kahdesta lähteestä, ja voit käyttää kumpaa tahansa tai molempia.
Knowledge Base -välilehti, jossa Index documentation -painike, Docs URL ja sisäinen tietopankki

Knowledge Base -välilehti

Käytä tätä, jos dokumentaatiosi on julkaistu Mintlifyssa.
  1. Syötä Docs URL, esimerkiksi https://docs.acme-store.com, ilman loppukauttaviivaa. Sivuston täytyy tarjota /llms.txt, minka Mintlify tekee automaattisesti.
  2. Napsauta Save, siirry sitten agenttisi sivulle ja napsauta Update Agent.
  3. Napsauta takaisin tällä välilehdellä Index documentation. Muutaman sadan sivun indeksointi kestää pari minuuttia, ja voit poistua sivulta sen aikana.
Kun Sync Mode on Poll llms.txt hourly, agentti tarkistaa dokumentaatiosi tunnin välein ja indeksoi uudelleen vain muuttuneet sivut.
Pidä Documentation Retrieval ja Agentic Retrieval päällä. Kun haku on käytössä, agentti hakee vain kuhunkin kysymykseen liittyvät kappaleet sen sijaan, että lukisi kaiken joka kerta.

7. Määritä vastausajat ja eskalointi

Avaa Behavior-välilehti.
Behavior-välilehti, jossa vastausajat ja ihmisavun avainsanat

Behavior-välilehti

Agentti odottaa, kunnes asiakas on lopettanut kirjoittamisen, ja vastaa sitten kaikkeen yhdellä vastauksella. Jokainen uusi viesti käynnistää ajastimen uudelleen. Luettele kohdassa Human Help Keywords sanat, joiden pitäisi siirtää tiketti tiimillesi, yksi per rivi. Esimerkiksi refund, chargeback tai real person.

8. Ota hälytykset käyttöön (valinnainen)

Avaa Notifications-välilehti ja liitä yksityisen henkilökuntakanavan ID. Agentti julkaisee siellä, kun lisenssisi on päättymässä ja kun tekoälytarjoaja hylkää avaimesi tai kiintiö loppuu.
Notifications-välilehti, jossa ilmoituskanavan ID

Notifications-välilehti

9. Käynnistä agentti

Palaa agenttisi sivulle ja napsauta Update Agent. Tämä ottaa agentin uudelleen käyttöön botin tunnuksellasi, dokumentaatio-osoitteellasi ja embedding-mallillasi. Tulostus näkyy painikkeen alla sen ajon aikana.
Useimmat asetukset tavoittavat käynnissä olevan agentin noin minuutissa ilman uudelleenkäyttöönottoa. Tarvitset Update Agent -toimintoa vain muutettuasi Discord Bot Tokenin, Docs URL -osoitteen, Embedding Modelin tai Sync Moden.
Tarkistaaksesi, että kaikki toimii:
  1. Avaa palvelimellasi testitiketti ja kysy kysymys, johon dokumentaatiosi vastaa.
  2. Avaa agenttisi sivulla Live logs ja seuraa, kuinka agentti vastaanottaa viestin, hakee dokumentaatiostasi ja vastaa.
Live logs, jossa agentti käynnistyy, synkronoi, hakee dokumentaatiosta ja vastaa tiketissä

Live logs

Agenttisi tilamerkki näyttää Online, kun se on käynnissä.

Kauttaviivakomennot

Kun agentti on palvelimellasi, omistajat ja henkilökunta voivat ohjata sitä Discordista. Voit myös keskeyttää agentin hallintapaneelista Global Bot Pause -asetuksella Discord-välilehdellä.

Pidä lisenssisi aktiivisena

Agenttisi pysyy verkossa niin kauan kuin lisenssisi on aktiivinen. License-sivu näyttää jäljellä olevat päivät ja päättymispäiväsi.
License-sivu, jossa tila, jäljellä olevat päivät ja saatavilla olevat paketit

License-sivu

Uusiaksesi osta uusi avain kaupasta, napsauta Renew license ja liitä avain. Aika lisätään nykyisen lisenssisi päälle.

Vianetsintä

  • Tarkista, että Message Content Intent on päällä Discord Developer Portalissa.
  • Tarkista, että tiketin kategorian ID on kohdassa Ticket Category IDs.
  • Tarkista, että botti näkee kyseisen kategorian ja voi lähettää siellä viestejä.
  • Tarkista, ettei henkilökunnan jäsen ole jo kirjoittanut tikettiin. Mainitse botti tai käytä komentoa /restart saadaksesi sen takaisin.
  • Tarkista, että Global Bot Pause on pois päältä.
Lisää tikettibottisi käyttäjätunnus kohtaan Ticket Bot IDs Discord-välilehdellä.
Avaa Knowledge Base -välilehti. Jos siinä lukee Documentation is not indexed yet, napsauta Index documentation. Jos siinä lukee The index does not match the embedding model, napsauta Clear and rebuild the index tai aseta embedding-malli takaisin näytetyksi ja tallenna.
Tarkista, että OpenRouter-tililtäsi löytyy saldoa ja että API Keys -välilehden avain on yhä voimassa. Ilmaisilla malleilla, kuten vision-mallilla, voi olla käyttörajoituksia ruuhka-aikoina; agentti siirtyy silloin seuraavaan malliin kohdassa Image Models.
Avaa Live logs ja etsi virheitä, esimerkiksi virheellinen avain tai loppunut saldo. Napsauta sitten agentin sivulla Restart. Jos se ei auta, napsauta Update Agent.