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

# Tekoälyagentin asennusopas

> Lisenssiavaimesta tekoälyagenttiin, joka vastaa Discord-tiketteihisi.

Asennus kestää noin 15 minuuttia. Tarvitset neljä asiaa:

* EchoAuth AI Agent -**lisenssiavain**. [Osta se kaupasta](https://shop.echoauth.dev/product/echos-ai-agent-hosted), jos sinulla ei vielä ole sellaista.
* **Discord-palvelin**, jolle voit lisätä botteja ja hallita rooleja.
* **[OpenRouter](https://openrouter.ai)-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](https://agent.echoauth.dev).

> [!NOTE]
>
> **Suositeltu asetus.** Pitkäaikaiset testit tehtiin vain OpenRouterilla käyttäen näitä kolmea mallia:
>
> | Rooli | Malli |
> | - | - |
> | Chat / Agent | `deepseek/deepseek-v4-flash-0731` |
> | Embedding | `qwen/qwen3-embedding-8b` |
> | Vision (kuvantunnistus) | `nvidia/nemotron-3-nano-omni-30b-a3b-reasoning:free` |
>
> 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](https://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](https://mintcdn.com/echoauth/cLGTi81QYaoRs3IW/images/ai-agent-setup/01-register.png?fit=max\&auto=format\&n=cLGTi81QYaoRs3IW\&q=85\&s=572419f600e4182cf06122e903cf3aa6)

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ö](https://mintcdn.com/echoauth/cLGTi81QYaoRs3IW/images/ai-agent-setup/02-dashboard.png?fit=max\&auto=format\&n=cLGTi81QYaoRs3IW\&q=85\&s=2397a77fc1428106e09dcbc3b2869dab)

Hallintapaneeli kirjautumisen jälkeen

> [!NOTE]
>
> 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](https://mintcdn.com/echoauth/cLGTi81QYaoRs3IW/images/ai-agent-setup/03-agent.png?fit=max\&auto=format\&n=cLGTi81QYaoRs3IW\&q=85\&s=6c4ca792bd16efd8e9e175519f337123)

Agentin sivu

## 2. Luo Discord-bottisi

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

**1. Luo sovellus**

Avaa [Discord Developer Portal](https://discord.com/developers/applications) 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.

> [!WARNING]
>
> 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](https://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](https://mintcdn.com/echoauth/cLGTi81QYaoRs3IW/images/ai-agent-setup/04-keys.png?fit=max\&auto=format\&n=cLGTi81QYaoRs3IW\&q=85\&s=635dd8eb112950e6f74cfdc24c4f5664)

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:

| Asetus | Mitä se tekee | Tarjoaja | Malli |
| - | - | - | - |
| **Chat / Agent Model** | Kirjoittaa vastaukset ja päättää, mitä dokumentaatiostasi haetaan. | OpenRouter | `deepseek/deepseek-v4-flash-0731` |
| **Vision Model** | Lukee kuvakaappaukset, joita asiakkaat liittävät tiketteihin. | OpenRouter | `nvidia/nemotron-3-nano-omni-30b-a3b-reasoning:free` |
| **Embedding Model** | Indeksoi dokumentaatiosi ja hakee siitä. | OpenRouter | `qwen/qwen3-embedding-8b` |

![AI Settings -välilehti, jossa OpenRouter valittuna chat-, vision- ja embedding-malleille](https://mintcdn.com/echoauth/cLGTi81QYaoRs3IW/images/ai-agent-setup/05-ai.png?fit=max\&auto=format\&n=cLGTi81QYaoRs3IW\&q=85\&s=9c43f2bab0d0ade4e7a897f04f0a21f0)

AI Settings -välilehti suositelluilla OpenRouter-malleilla

> [!NOTE]
>
> 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:

```text theme={null}
You are the support agent for Acme Store. Be friendly and concise.
Answer only from the documentation. If you are not sure, ask a staff member to step in.
```

> [!WARNING]
>
> 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](https://mintcdn.com/echoauth/cLGTi81QYaoRs3IW/images/ai-agent-setup/06-discord.png?fit=max\&auto=format\&n=cLGTi81QYaoRs3IW\&q=85\&s=43f9146b21aa094f8d7629f409930f57)

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**.

> [accordion] Owner Role IDs
>
> Roolit, jotka saavat käyttää kaikkia kauttaviivakomentoja, mukaan lukien `/pause_bot` ja `/edit_base`. Erota useat ID:t pilkuilla.

> [accordion] Staff Role IDs
>
> 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`.

> [accordion] Ticket Category IDs
>
> Kategoriat, joihin tikettikanavasi luodaan. Agentti vastaa vain näiden kategorioiden sisällä.

> [accordion] Ticket Bot IDs
>
> 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.

> [accordion] Image Models
>
> 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](https://mintcdn.com/echoauth/cLGTi81QYaoRs3IW/images/ai-agent-setup/07-knowledge.png?fit=max\&auto=format\&n=cLGTi81QYaoRs3IW\&q=85\&s=18150d070975d8635a2a87c251b04dfa)

Knowledge Base -välilehti

> [tab] Docs site
>
> 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.

> [tab] Internal knowledge base
>
> Käytä tätä kaikkeen, mikä ei ole dokumentaatiosivustolla: UKK, käytännöt, virhekoodit.
>
> 1. Vieritä kohtaan **Internal Knowledge Base**.
> 2. Liitä tekstisi tai napsauta **Load file** ja valitse `.txt`- tai `.md`-tiedosto.
> 3. Napsauta **Save**.
>
> Agentti indeksoi sen noin minuutissa. Pelkkä teksti riittää: ISOILLA KIRJAIMILLA kirjoitetut otsikot tai `=====`-rivien välissä olevat otsikot muuttuvat haettaviksi osioiksi.

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](https://mintcdn.com/echoauth/cLGTi81QYaoRs3IW/images/ai-agent-setup/08-behavior.png?fit=max\&auto=format\&n=cLGTi81QYaoRs3IW\&q=85\&s=14df915b4ac0f9860f6e3a6b3a61d318)

Behavior-välilehti

Agentti odottaa, kunnes asiakas on lopettanut kirjoittamisen, ja vastaa sitten kaikkeen yhdellä vastauksella. Jokainen uusi viesti käynnistää ajastimen uudelleen.

| Asetus | Oletus | Merkitys |
| - | - | - |
| After ticket opens | 45 s | Odotus ensimmäisen viestin jälkeen, koska asiakkaat lisäävät usein tietoja tai kuvakaappauksia. |
| After each message | 30 s | Hiljaisuusaika, jota tarvitaan myöhempien viestien jälkeen ennen vastaamista. |
| Maximum wait | 180 s | Vastaa tämän ajan jälkeen, vaikka asiakas jatkaisi kirjoittamista. |

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](https://mintcdn.com/echoauth/cLGTi81QYaoRs3IW/images/ai-agent-setup/09-notifications.png?fit=max\&auto=format\&n=cLGTi81QYaoRs3IW\&q=85\&s=5906f4bf0dbdf4fa308c4958553bded2)

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.

> [!NOTE]
>
> 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ä](https://mintcdn.com/echoauth/cLGTi81QYaoRs3IW/images/ai-agent-setup/11-logs.png?fit=max\&auto=format\&n=cLGTi81QYaoRs3IW\&q=85\&s=18d1bd77e85407858cd81751cd36388e)

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.

| Komento | Kuka | Mitä se tekee |
| - | - | - |
| `/stop` | Owner, staff | Estää agenttia vastaamasta tällä kanavalla. |
| `/restart` | Owner, staff | Sallii agentin vastata tällä kanavalla uudelleen. |
| `/mute_existing` | Owner, staff | Pysäyttää agentin kaikissa jo avoimissa tiketeissä. |
| `/pause_bot` | Owner | Keskeyttää agentin kaikkialla. |
| `/resume_bot` | Owner | Jatkaa agentin toimintaa kaikkialla. |
| `/edit_base` | Owner | Muokkaa base promptia. |
| `/chat_model` | Owner | Vaihtaa chat-mallin. |

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](https://mintcdn.com/echoauth/cLGTi81QYaoRs3IW/images/ai-agent-setup/10-license.png?fit=max\&auto=format\&n=cLGTi81QYaoRs3IW\&q=85\&s=62db270604520c9a0c2815db6201b908)

License-sivu

Uusiaksesi osta uusi avain [kaupasta](https://shop.echoauth.dev/product/echos-ai-agent-hosted), napsauta **Renew license** ja liitä avain. Aika lisätään nykyisen lisenssisi päälle.

## Vianetsintä

> [accordion] Botti on verkossa, mutta ei koskaan vastaa
>
> * 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ä.

> [accordion] Botti ohittaa tiketin avausviestin
>
> Lisää tikettibottisi käyttäjätunnus kohtaan **Ticket Bot IDs** **Discord**-välilehdellä.

> [accordion] Agentti ei käytä dokumentaatiotani
>
> 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.

> [accordion] Vastaukset tai indeksointi epäonnistuvat OpenRouter-virheeseen
>
> 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**.

> [accordion] Agentti lopetti vastaamisen
>
> Avaa **Live logs** ja etsi virheitä, esimerkiksi virheellinen avain tai loppunut saldo. Napsauta sitten agentin sivulla **Restart**. Jos se ei auta, napsauta **Update Agent**.


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