Lehmus AI: Käytön aloittaminen

Tämän ohjeen avulla pääset alkuun Lehmus AI:n käytössä. Opit kirjautumaan palveluun, valitsemaan oikean projektin ja aloittamaan kielimallien käytön chatissa. 

Mitä tarvitset ennen aloitusta 

Tarvitset: 

  • Lehmus AI -käyttöoikeuden 
  • Yhteyden Oulun yliopiston verkkoon tai VPN-yhteyden 
  • Organisaation käyttäjätunnuksen 

Jos sinulla ei ole vielä käyttöoikeutta, katso ohje Lehmus AI: Tietoturvallinen Generatiivisen tekoälyn alusta – ict.oulu.fi. 

Mikä on Lehmus AI? 

Lehmus AI on Oulun yliopiston generatiivisen tekoälyn alusta. Sen kautta voit käyttää kielimalleja chatissa, hyödyntää omiin aineistoihin perustuvia RAG-tietolähteitä, käyttää AI-agentteja ja työkaluja sekä yhdistää kielimalleja muihin sovelluksiin OpenAI-yhteensopivien rajapintojen kautta. 

Lehmus AI tarjoaa useita tapoja hyödyntää generatiivista tekoälyä: 

  • Chat: keskustele suoraan kielimallien kanssa 
  • RAG: anna kielimallin hakea tietoa omista aineistoistasi 
  • AI-agentit ja työkalut: käytä valmiiksi määritettyjä AI-agentteja ja niihin liitettyjä RAG- ja MCP-työkaluja. Projektin ylläpitäjät voivat myös luoda projektille omia agentteja. 
  • Ohjelmointirajapinnat: käytä Lehmus AI:n kielimalleja esimerkiksi omissa sovelluksissa tai kehitystyökaluissa 

Kirjaudu Lehmus AI:hin 

  1. Yhdistä laitteesi Oulun yliopiston verkkoon tai muodosta VPN-yhteys. 
  1. Avaa Lehmus AI –portaali osoitteessa  https://portal.lehmus-ai.oulu.fi/.  
  1. Kirjaudu organisaation käyttäjätunnuksellasi 

Jos kirjautuminen ei onnistu, tarkista ensin verkkoyhteys ja käyttöoikeutesi.  

Valitse oikea projekti 

Lehmus AI:ssa projektien työtiloja kutsutaan tenanteiksi. Tenant erottaa projektin keskustelut, aineistot, RAG-määritykset ja muut resurssit projektien sisällöistä. 

Jos sinulla on käyttöoikeus useampaan projektiin:  

  1. Tarkista portaalissa aktiivisena oleva projekti 
  1. Vaihda tarvittaessa oikeaan projektiin 
  1. Varmista valinta ennen työskentelyn aloittamista 

Tärkeää: tarkista aina aktiivinen projekti ennen kuin lisäät palveluun projektin aineistoa tai luot uusia resursseja, jos kuulut useampaan projektiin. 

Aloita Chatissa 

Lehmus AI:n Chatissa voit keskustella kielimallien ja valmiiksi määritettyjen AI-agenttien kanssa. 

  1. Avaa portaalin vasemmasta sivupalkista Chat 
  1. Avaa mallivalikko 
  1. Valitse tehtävään sopiva kielimalli tai AI-agentti (jos konfiguroitu) 
  1. Kirjoita pyyntösi viestikenttään 
  1. Lähetä viesti 
  1. Tarkista saamasi vastaus ennen sen hyödyntämistä 

Chatin mallivalikko näyttää ne chat-kielimallit ja agentit, joihin sinulla on käyttöoikeus. 

Vinkkejä hyvien kehotteiden laatimiseen löydät ohjesivulta Vinkkejä tekoälyn tehokkaaseen hyödyntämiseen – ict.oulu.fi. 

Huom: Tarkista aina kielimallin tuottama vastaus ennen sen hyödyntämistä. Kielimalli voi tuottaa virheellistä tai vanhentunutta tietoa. Tarkista tarvittaessa esimerkiksi lähteet, laskelmat, koodi ja tietoturvavaikutukset. 

Käytä omia aineistojasi RAGin avulla 

RAGin (Retrieval-Augmented Generation) avulla kielimallin vastauksia voidaan täydentää omista dokumenteista haetulla tiedolla. RAG-endpointissa voidaan hallita siihen liitettyjä dokumentteja ja käyttää niitä tiedonhaussa. 

Chatissa käytössäsi olevat RAGit näet Chatin alareunassa olevasta Knowledge bases –napista, josta voit aktivoida RAGit käytettäviksi Chatissa, jolloin kielimalli pyrkii muodostamaan vastauksen oman aineistosi perusteella. 

Lehmus AI:ssa voit luoda RAG-endpointin, lisätä siihen oman aineistosi ja käyttää RAGia kielimallin tietolähteenä esimerkiksi Chatin kautta. 

Vaiheittaiset ohjeet RAGin luontiin löydät ohjesivulta Lehmus AI: RAGin eli omien aineistojen käyttöönotto – ict.oulu.fi  

Käytä valmista agenttia 

Lehmus AI:ssa voidaan käyttää valmiiksi määritettyjä Preset Agents –agentteja. Agenttiin voidaan määrittää käytettävä kielimalli, toimintaohjeet ja mahdollisesti käytössä olevat työkalut.  

Agentti, johon sinulla on käyttöoikeus, näkyy Chatin mallivalikossa muodossa Preset agent: [AGENTIN NIMI]. Valitse agentti Chatin mallivalikosta ja kirjoita sille viesti tavallisen Chat-keskustelun tapaan. Agentin käyttö Chatissa ei edellytä API-avainta. 

Jos odottamasi agentti ei näy Chatissa, tarkista, että olet valinnut oikean projektin ja että sinulle on myönnetty agentin käyttöoikeus. Voit tarkistaa agentin käyttöoikeuden projektisi ylläpitäjältä. 

Projektien ylläpitäjille ohje Preset agenttien luontiin löytyy ohjesivulta Lehmus AI: Preset Agentin luominen ja hallinta  – ict.oulu.fi.  

Käytä työkaluja Chatissa 

Lehmus AI:n kielimalleihin ja agentteihin voidaan liittää myös työkaluja MCP:n (Model Context Protocol) avulla. Ulkoisen MCP-palvelimen työkalut voidaan tuoda Lehmus AI:n yhteiseen työkaluvalikoimaan. 

Käytössä olevat MCP-työkalut näet Chatin alareunassa olevasta Tools-valikosta, josta voit aktivoida käytössä olevia MCP-työkaluja Chattiisi, jolloin kielimalli pystyy vastaamaan kysymyksiin hyödyntäen MCP-työkaluja. 

Jos työkalu edellyttää henkilökohtaista kirjautumista, se näkyy Chatin Tools-valikossa Not Connected –tilassa. Valitse Connect, kirjaudu palveluun avautuvassa selainvälilehdessä ja myönnä tarvittava käyttöoikeus. Tämän jälkeen työkalun toiminnot tulevat näkyviin. 

Työkalun käyttö tapahtuu käyttäjän omilla oikeuksilla ulkoiseen palveluun. 

Lehmus AI:n käyttäminen muissa sovelluksissa 

Lehmus AI tarjoaa tuetun joukon OpenAI-yhteensopivia ohjelmointirajapintoja. Model Gateway tukee muun muassa Chat Completions-, Responses- ja Embeddings-rajapintoja sekä mallien listausta. 

Ulkoisissa sovelluksissa Lehmus AI:n kielimalleja hyödyntääksesi tarvitset: 

  • Lehmus AI -käyttöönoikeudet 
  • API-avaimen, jonka taakse olet liittänyt haluamasi kielimallit 
  • Lehmus AI:n API-osoitteen 
  • Käytettävän mallin tunnisteen, eli Public Model ID:n 

API-osoite näkyy Lehmus AI –portaalin sivupalkin alareunassa API URL –kohdassa. Mallien tunnisteet löydät Lehmus AI –portaalin Models -välilehdeltä. 

Tarkemmat ohjeet löydät ohjesivuilta: 

Löydät ohjeita Lehmus AI:n kielimallien yhdistämisestä muihin sovelluksiin: 

Projektin ylläpitäjille 

Projektin ylläpitäjille tarkoitetut käyttäjien ja käyttöoikeuksien hallintaohjeet löydät ohjeesta Lehmus AI: Projektin käyttäjien ja käyttöoikeuksien hallinta  – ict.oulu.fi.  

Ohjelmistokehittäjille 

Lehmus AI tukee OpenAI-yhteensopivia Chat Completions- ja Responses-rajapintoja. Responses API tukee lisäksi esimerkiksi keskusteluhistoriaa ja työkaluja.  

Lisää voit lukea ohjeesta Lehmus AI: Ohjelmointirajapintojen käyttö  – ict.oulu.fi 

Tuki ja lisätiedot 

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

Jos kohtaat ongelmia palvelun käytössä, tavoitat meidät esimerkiksi sähköpostitse ict@oulu.fi.

Takaisin ylös