Tervetuloa Lehmus AI -alustalle. Tämä opas auttaa sinua saamaan projektisi nopeasti käyntiin. Jos kohtaat haasteita, tukitiimimme on apunasi sekä kampuksella että verkossa. Seurataksesi tätä ohjetta, sinulla tulee olla käyttöoikeudet Lehmus AI -alustalle, joiden hankkimiseen ohjeet löydät sivulta Lehmus AI: Tietoturvallinen Generatiivisen tekoälyn alusta.

Perusteet: Mikä on Lehmus AI?

Lehmus AI on taustajärjestelmä, joka tarjoaa pääsyn paikallisiin Large Language Model -malleihin (LLM), AI-agentteihin sekä RAG-järjestelmiin (Retrieval-Augmented Generation). Käytännössä tämä tarkoittaa, että voit keskustella tekoälyn kanssa turvallisesti, hyödyntää eri kielimalleja ja antaa tekoälyn lukea omia tiedostojasi. Lehmus AI sisältää myös chat-käyttöliittymän.

Tiimin hallinta (käyttöoikeudet)

Käyttöoikeuksia hallitaan Oulun yliopiston IDM-ryhmien kautta. Jokaiselle projektille luodaan kaksi ryhmää:

1. Jäsenet: lehmusai-projectid-staff|idm

2. Ylläpitäjät: lehmusai-projectid-admins-staff

Näin lisäät uusia käyttäjiä:

• Missä: Mene osoitteeseen u.oulu.fi/modgroup.
• Vaatimukset: Sinun täytyy olla yliopiston VPN-verkossa ja kirjautuneena yliopiston tunnuksella.
• Tuloksena: Ryhmään lisätyt käyttäjät voivat kirjautua Lehmus AI -portaaliin.

Projektin valinta (Tenantit)

Järjestelmä käyttää Tenantteja (tenants) projektien tietojen eristämiseen ja suojaamiseen. Tämä varmistaa, että eri projektien datat ja asetukset pysyvät erillään ja suojattuina.

Yleensä kuulut vain yhteen projektiin, jolloin päädyt suoraan oikeaan työtilaan kirjautuessasi. Jos kuitenkin kuulut useampaan projektiin, voit liikkua niiden välillä:

• Tenantin vaihtaminen työkalussa: Klikkaa sähköpostiosoitettasi portaalissa ja valitse Switch Tenant.
• Huomioi: Data, RAG-asetukset ja endpointit ovat tenant-kohtaisia, eikä niitä voi jakaa eri projektien välillä.

Chatin käyttö ja omat dokumentit (RAG)

Suurin osa käyttäjistä käyttää alustaa chat-käyttöliittymän kautta, minkä löydät palvelun etusivulla ollessasi (Dashboard) klikkaamalla Private Chat UI > Open Chat. Voit käyttää chatissa tekoälyä yleisesti tai syöttää sille esimerkiksi omia dokumenttejasi.

Haku omista dokumenteista – RAG-järjestelmän käyttöönotto

RAG-järjestelmän avulla voit liittää alustaan omia dokumentteja (esim. PDF-tiedostoja), joiden perusteella tekoäly pyrkii ensisijaisesti vastaamaan kysymyksiisi.

1. Luo RAG-endpoint: Klikkaa palvelun vasemmasta sivupalkista RAG-endpoints ja valitse avautuvalta sivulta oikeasta yläkulmasta Deploy RAG endpoint. Kirjoita Name -kenttään kuvaava nimi RAG-endpointillesi, jonka jälkeen voit klikata Deploy-nappia.
2. Lisää RAG-endpointtiin dokumentteja: Kun olet luonut RAG-endpointin, avaa se RAG endpoints –sivulta auki. Avautuvalla General-välilehdellä klikkaa Data sources alta löytyvää File Management –nappia, jonka kautta voit joko ladata tähän RAG-endpointtiin tiedostoja Upload Files –kohdasta tai tarvittaessa poistaa tiedostoja Manage Files –kohdasta. Kun olet ladannut RAG-endpointtiin haluamasi tiedostot, muista klikata Upload-napista, jotta valitsemasi tiedostot latautuvat tähän RAG-endpointtiin
3. Käytä RAG-endpointtia: Kun olet chat-käyttöliittymässä, voit aktivoida luomasi RAG-endpointin chatissa klikkaamalla tekstikentän oikeasta alareunasta löytyvää Knowledge bases –nappia, josta voit klikata luomasi RAG-endpointin käyttöön chatissa ruksia painamalla. Sinulla voi olla useampi RAG-endpoint luotuna, esimerkiksi eri aineistojen tutkimiseen tai tiettyjen ohjeiden läpikäymiseen, joten varmista, että aktivoit chatissa oikean haluamasi RAG-endpointin käyttöön. Sinulla voi olla myös useampi RAG-endpoint samanaikaisesti chatissa käytössä. Kun olet aktivoinut RAG:in, tekoäly hakee vastaukset ensisijaisesti kyseiseen RAG:iin lataamistasi tiedostoista.

Endpointtien ja API-avainten käyttöönotto

Tämä osio on tarkoitettu käyttäjille, jotka haluavat yhdistää ulkoisia sovelluksia, kuten Open WebUI:ta, Lehmus AI –malleihin. Jos käytät vain portaalin chat-ominaisuutta, voit hypätä tämän kohdan yli.

Jotta voit yhdistää sovelluksesi (kuten Open WebUI:n) Lehmus AI-malleihin, sinun tulee luoda API-avain. API-avain voidaan luoda henkilökohtaisena (”personal”) tai palvelutunnukselle (”service account”). Henkilökohtaisessa käytössä käytä henkilökohtaista API-avainta ja palvelutunnusta, kun luot palvelun jota käyttää useampi kuin yksi henkilö.

1. Luo API avain

Tämän ohjeen avulla luot itsellesi API-avaimen, jonka avulla pääset käsiksi kielimalleihin, jotka olet kyseiseen API-avaimeen liittänyt.  

1. Klikkaa palvelun etusivuilla olevasta vasemmasta sivupalkista API keys.  
2. API keys -sivun oikeassa yläreunassa on nappi Create API key, klikkaa sitä.  
3. Täytä API avaimellesi nimi ja valitse, aiotko luoda Personal vai Service Account API avaimen. Hyvä käytäntö olisi luoda erillinen API-avain jokaiselle käyttäjälle tai sovellukselle, sillä tämä mahdollistaa tarkan käytön seurannan.  
4. Valitse Resource type -kohdasta, minkä tyyppisen API-avaimen haluat luoda (Model deployment, External Model, RAG Deployment, Group). Resource, Select resource -kohdasta voit valita kielimallin tarjolla olevista vaihtoehdoista. Huomioithan, että jos haluat käyttää samaa API-avainta mallien käyttöön sekä RAG-endpointtien käyttöön, RAG endpointin täytyy olla luotuna ennen API avaimen luontia ja sinun täytyy asettaa API-avaimelle sekä Model Deployment, että RAG Deployment kullekin haluamallesi kielimallille! Eli voit joutua lisäämään API-avaimelle esim. Gemma4 31B:n kahteen kertaan (Model Deployment + RAG Deployment). Suosituksemme tällä hetkellä on Gemma4 31B, joka tarjoaa hyvän tasapainon suorituskyvyn ja nopeuden välillä. Add grant -napista voit lisätä useamman kielimallin tämän API-avaimen taakse.
5. Kun kaikki on valmista, voit painaa Create–nappia.  

Muista kopioida API-avaimesi talteen! Et näe sitä enää tämän vaiheen jälkeen. 

2. Kielimallien yksilöivien identiteettien löytäminen API kutsuja varten

1. Klikkaa palvelun etusivulla ollessasi vasemmasta sivupalkista Models, jossa näet listauksen tarjolla olevista malleista.  
2. Klikkaa haluamaasi tarjolla olevaa kielimallia, jonka jälkeen avautuu kielimallin sivu, josta näet mm. kyseisen kielimallin ID:n sekä API URL:in.  

3. Kutsujen luominen API-avaimen kanssa

Tälle sivulle on koottu esimerkkikutsuja Lehmus AI-alustan kielimallien käyttämistä varten. Jotta voit kutsua kielimalleja, tarvitset API-avaimen sekä kielimallin julkisen ID:n. API:n oletusosoite on https://api.lehmus-ai.oulu.fi/v1

Chat Completions API-rajapinta

curl --request post \
--url https://api.lehmus-ai.oulu.fi/v1/chat/completions \
--header 'authorization: Bearer api_key_here' \
--header 'content-type: application/json' \
--data '{
"model": "model_id_here",
"messages": [
{
"role": "user",
"content": "What does this platform do?"
}
],
"temperature": 0.7,
"max_tokens": 150
}'

Reponses API-rajapinta

curl --request post \
--url https://api.lehmus-ai.oulu.fi/v1/responses \
--header 'authorization: Bearer api_key_here' \
--header 'content-type: application/json' \
--data '{
"model": "model_id_here",
"input": [
{
"role": "user",
"content": "What is the capital of France?"
}
]
}'


Lisätietoa

Lehmus AI perustuu Confidential Minds -teknologiaan. Edistyneempiä asetuksia ja syvällisempää teknistä tietoa löydät Confidential Minds – dokumentaatiosta .

 

« Takaisin