tervetuloa Lehmus AI -alustalle. Tämä opas auttaa sinua saamaan projektisi nopeasti käyntiin. Jos kohtaat haasteita, tukitiimimme on apunasi sekä kampuksella että verkossa.

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

• 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ä.

Endpointtien ja API-avainten käyttöönotto

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, 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