# Näytös 1: Tapaa tekoälytutkimusassistenttisi 🤖 ![lab1](../../../../translated_images/fi/lab1.1dd5210a7d114e2e.webp) ## Haaste Olet käynnistämässä "Future Bytes" -nimistä uutta teknologiapodcastia. Jakso 1 käsittelee uusimpia tekoälyläpimurtoja, mutta sinulla on 24 tuntia aikaa: 1. Tutkia aihetta 2. Etsiä luotettavia lähteitä 3. Kirjoittaa mukaansatempaava käsikirjoitus 4. Saada se kuulostamaan luonnolliselta **Juonenkäänne**: Sinun ei tarvitse tehdä sitä yksin. Olet rakentamassa ensimmäistä tekoälyassistenttiasi, joka voi auttaa kaikessa tässä. Kutsutaan häntä Alexiksi — väsymättömäksi tutkimuskumppaniksesi, joka ei koskaan tarvitse unta. ## Miksi pienet kielimallit? (Vinkki: Ne ovat mahtavia) Ajattele pieniä kielimalleja (SLM) henkilökohtaisena tekoälynä, joka asuu *sinun* tietokoneellasi. Ei pilveä, ei kuukausimaksuja, ei epäilyttävää datan jakamista. **Miksi SLM:t ovat 🔥:** - **🏠 Toimii omalla koneellasi**: kannettava, pöytäkone, jopa tehokas Raspberry Pi - **💸 Ei jatkuvia kustannuksia**: Ei API-maksuja, jotka syövät lounasrahojasi - **🔒 Yksityisyys ensin**: Datasi ei koskaan poistu laitteeltasi - **⚡ Salamannopea**: Ei internet-viivettä, välittömät vastaukset - **🪦 Kevyt**: 1B-10B parametria vs 100B+ suurilla malleilla **Suositut SLM:t**: Qwen 3, Phi-4, Gemma 3 (käytämme Qwenia tässä työpajassa) ## Työkalupakkisi ### Ollama: Tekoälymallien hallinta [Ollama](https://ollama.com/) on kuin Steam tekoälymalleille. Lataa, suorita ja hallitse malleja yksinkertaisilla komennoilla. **Mikä tekee siitä siistin:** - Yksi komento mallin lataamiseen ja suorittamiseen - Toimii Macissa, Windowsissa, Linuxissa - Käyttää automaattisesti GPU:tasi, jos sinulla on sellainen - Erittäin muistitehokas ### Microsoft Agent Framework: Taikapaikka [Microsoft Agent Framework](https://github.com/microsoft/agent-framework) on leikkikenttäsi tekoälyagenttien rakentamiseen, jotka voivat: - 💬 Keskustella ja muistaa, mistä puhuitte - 🛠️ Käyttää mukautettuja työkaluja (kuten web-haku tai säätiedot) - 🧠 Pohtia monimutkaisia ongelmia askel askeleelta - 🤝 Työskennellä muiden agenttien kanssa tiimissä - 🔌 Yhdistää eri tekoälypalveluihin (OpenAI, Ollama, Azure) **Rakennuspalikat:** - **Agentit**: Omanlaisia tekoälyassistentteja tiettyihin tehtäviin - **Työkalut**: Erikoisominaisuuksia, joita annat heille - **Muisti**: Jotta he eivät unohda keskustelua - **Päättely**: Opetetaan heille ajattelemaan, ei pelkästään vastaamaan ## Koulutustesi sarja: 4 tehtävää ### Tehtävä 1: Luo ensimmäinen agenttisi 📓 [Avaa muistio](../code/01.BasicAgent/00.BasicAgent-agent.ipynb) **Tehtävä**: Rakenna Alex, podcast-käsikirjoittaja tekoälysi. Alexin tulee luoda dialogi kahden juontajan välillä, jotka keskustelevat teknologia-aiheista. **Mitä opit**: - Kuinka herättää tekoälyagentti henkiin (helppoa kuin maanantaina herääminen) - Annetaan sille persoonallisuus ja ohjeet - Saadaan se luomaan oikeita podcast-käsikirjoituksia - Ymmärtämään mitä se sinulle vastaa **Voiton ehto**: Alex kirjoittaa käsikirjoituksen "Future Bytes" pilottijaksolle, joka käsittelee tekoälyä! 🎯 ### Tehtävä 2: Anna Alexille supervoimat (työkalut!) 📓 [Avaa muistio](../code/01.BasicAgent/01.BasicAgent-tools.ipynb) **Tehtävä**: Alex on fiksu, mutta ei tiedä tämän päivän säätä tai kellonaikaa. Korjataan tämä antamalla sille työkaluja! **Mitä opit**: - Luoda räätälöityjä Python-funktioita "työkaluina" - Anna Alexin päättää *milloin* käyttää mitäkin työkalua - Katso, kuinka se itsenäisesti ratkaisee ongelmia - Yhdistää useita työkaluja monimutkaisiin tehtäviin **Voiton ehto**: Kysy "Mikä on sää Tokiossa?" ja Alex selvittää sen itse! ☁️ ### Tehtävä 3: Opeta Alex ajattelemaan 📓 [Avaa muistio](../code/01.BasicAgent/02.BasicAgent-reasoning.ipynb) **Tehtävä**: Tee Alexista sellainen, että se näyttää ratkaisuprosessinsa. Kun ratkaiset ongelmia, haluat nähdä *miten* se ajattelee, et vain vastauksen. **Mitä opit**: - Aktivoi "päättelytila" (se on kuin matikan tehtävien ratkaisun näyttäminen) - Näe Alexin askel askeleelta ajatusprosessi - Ymmärrä ketjuttamiseen perustuva kysely (chain-of-thought prompting) - Vianmääritys, kun Alex menee sekaisin **Voiton ehto**: Kysy vaikea matemaattinen ongelma ja katso, kuinka Alex ajattelee sen läpi! 🧠 ### Tehtävä 4: Yhdistä Alex internetiin 📓 [Avaa muistio](../code/01.BasicAgent/03.BasicAgent-websearch.ipynb) **Tehtävä**: Alexin tieto päättyy johonkin päivämäärään. Yhdistetään se nettiin reaaliaikaista tietoa varten! **Mitä opit**: - Rakenna oma verkkohakutyökalu - Integroi ulkoiset API:t - Käsittele verkkovirheitä sujuvasti - Hanki tietoa, jota Alexin koulutusaineistossa ei ole **Voiton ehto**: Kysy tämän päivän teknouutisia ja saa tuoreita tuloksia! 📰 ## Ennen kuin aloitat 🚀 **Vaaditut varusteet:** - Python 3.10+ asennettuna - Ollama käynnissä (tarkista `ollama --version` komennolla) - VS Code Python-laajennuksella - Vähintään 8GB RAMia (16GB, jos haluat sujuvaa käyttöä) ## Tehtävien järjestys Seuraa muistioita tässä järjestyksessä saadaksesi kokonaiskuvan: 1. [00.BasicAgent-agent.ipynb](../code/01.BasicAgent/00.BasicAgent-agent.ipynb) — Tapaa Alex (ensimmäinen agenttisi) 2. [01.BasicAgent-tools.ipynb](../code/01.BasicAgent/01.BasicAgent-tools.ipynb) — Voimaantuminen! 3. [02.BasicAgent-reasoning.ipynb](../code/01.BasicAgent/02.BasicAgent-reasoning.ipynb) — Opeta Alex ajattelemaan 4. [03.BasicAgent-websearch.ipynb](../code/01.BasicAgent/03.BasicAgent-websearch.ipynb) — Internetyhteys avattu! ## Mitä hallitset Näytös 1:n jälkeen osaat: - ✅ Juosta tekoälymalleja omalla laitteistollasi (ilman pilveä!) - ✅ Rakentaa agentteja muokatuilla persoonallisuuksilla ja taidoilla - ✅ Antaa agenteille työkaluja ratkaista oikeita ongelmia - ✅ Saada agentit näyttämään päättelyprosessinsa - ✅ Yhdistää agentit ulkoisiin tietolähteisiin - ✅ Korjata ongelmat, kun kaikki ei mene kuin Strömsössä ## Kun asiat menevät pieleen (ja miten ne korjataan) 🔧 ### "Alex ei käynnisty! Muisti loppu!" **Korjaus**: Tietokoneesi kamppailee. Yritä sulkea muita sovelluksia tai vaihda pienempään malliin. 8GB RAM on minimivaatimus. ### "Alex on niin hidas" **Korjaus**: Ota GPU-kiihdytys käyttöön Ollaman asetuksista. Tai vähennä kontekstin kokoa. Nopeuseläin-tila päällä! 🏎️ ### "Työkalut eivät toimi!" **Korjaus**: Tarkista funktioiden syntaksit. Alex tarvitsee selkeät tyyppivihjeet ymmärtääkseen, mitä työkalu tekee. Ajattele sitä selkeinä ohjeina. ## Hyödyllisiä linkkejä 🔗 - [Agent Framework Docs](https://github.com/microsoft/agent-framework) — Viralliset oppaat ja esimerkit - [Ollama Model Library](https://ollama.com/library) — Selaa kaikkia saatavilla olevia malleja - [Qwen Model](https://ollama.com/library/qwen3) — Tapaa tekoälysi aivot - [Koodi-esimerkit](https://github.com/microsoft/agent-framework/tree/main/python/samples) — Varasta ideoita täältä ## Seuraavana: Näytös 2 🎬 Sinulla on yksi agentti. Mutta entä jos sinulla olisi *tiimi* agenteista, jotka työskentelevät yhdessä? Näytös 2:ssa rakennat koko podcastin tuotantoryhmän: - **Tutkija-agentti**: Löytää parhaat lähteet - **Kirjoittaja-agentti**: Laatii täydellisen käsikirjoituksen - **Toimittaja (sinä!)**: Hyväksyy tai pyytää muutoksia Luodaan yhdessä taikavoimia tekoälyllä! → [Näytös 2: Kokoa tuotantoryhmäsi](02.AIAgentOrchestrationAndWorkflows.md) --- **Jumiuduitko?** Kysy työpajan aikana. Opimme kaikki yhdessä! 🙌 --- **Vastuuvapauslauseke**: Tämä asiakirja on käännetty käyttämällä tekoälypohjaista käännöspalvelua [Co-op Translator](https://github.com/Azure/co-op-translator). Pyrimme täsmällisyyteen, mutta huomioithan, että automaattikäännöksissä saattaa esiintyä virheitä tai epätarkkuuksia. Alkuperäistä asiakirjaa sen alkuperäiskielellä tulisi pitää virallisena lähteenä. Tärkeissä tiedoissa suositellaan ammattilaisen tekemiä ihmiskäännöksiä. Emme ole vastuussa mahdollisista väärinymmärryksistä tai tulkinnoista, jotka johtuvat tämän käännöksen käytöstä.