Skip to content

README.md

Latest commit

 

History

History
232 lines (143 loc) · 12.9 KB

README.md

File metadata and controls

232 lines (143 loc) · 12.9 KB

Selle kursuse alustamine

Oleme väga põnevil, et alustate seda kursust ja näete, mida Generative AI abil inspireeritud ehitada!

Et tagada teie edu, sisaldab see leht seadistusetappe, tehnilisi nõudeid ja teavet selle kohta, kust vajadusel abi saada.

Seadistusetapid

Kursusel osalemiseks peate läbima järgmised sammud.

1. Forkige see repo

Forkige kogu see repo oma GitHubi kontole, et saaksite koodi muuta ja väljakutseid lõpetada. Samuti võite jätta selle repo tärniga (🌟), et leida seda ja seotud reposi kergemini.

2. Looge codespace

Et vältida sõltuvusprobleeme koodi käivitamisel, soovitame selle kursuse käivitamiseks kasutada GitHub Codespaces.

Oma forkis: Code -> Codespaces -> New on main

Dialoog, mis näitab nuppe codespace loomiseks

2.1 Lisage saladus

  1. ⚙️ Hammasratta ikoon -> Command Palette-> Codespaces : Manage user secret -> Add a new secret.
  2. Nimetage OPENAI_API_KEY, kleepige oma võti, Salvestage.

3. Mis edasi?

Soovin… Minge…
Alustada õppetundi 1 01-introduction-to-genai
Töötada offline setup-local.md
Seadistada LLM pakkuja providers.md
Kohtuda teiste õppijatega Liituge meie Discordi serveriga

Probleemide lahendamine

Sümptom Lahendus
Containeri ehitus jääb kinni > 10 min Codespaces ➜ „Rebuild Container”
python: command not found Terminal ei olnud ühendatud; klõpsake + ➜ bash
401 Unauthorized OpenAI poolt Vale või aegunud OPENAI_API_KEY
VS Code kuvab “Dev container mounting…” Värskendage brauseri vahekaarti — Codespaces kaotab vahel ühenduse
Notebooki kernel puudub Notebooki menüüst ➜ Kernel ▸ Select Kernel ▸ Python 3

Unixipõhised süsteemid:

touch .env

Windows:

echo . > .env

  1. Muuda .env faili: Avage .env fail tekstiredaktoris (nt VS Code, Notepad++ või mõni muu redaktor). Lisage faili järgmine rida, asendades your_github_token_here oma tegeliku GitHubi tokeniga:

    GITHUB_TOKEN=your_github_token_here

  2. Salvestage fail: Salvestage muudatused ja sulgege tekstiredaktor.

  3. Installige python-dotenv: Kui te pole seda veel teinud, peate paigaldama python-dotenv paketi, et laadida keskkonnamuutujad .env failist oma Pythonirakendusse. Seda saab paigaldada pip abil:

    pip install python-dotenv

  4. Laadige keskkonnamuutujad oma Python skriptis: Kasutage oma Python skriptis python-dotenv paketti .env failist keskkonnamuutujate laadimiseks:

    from dotenv import load_dotenv
import os

# Laadi keskkonnamuutujad .env failist
load_dotenv()

# Juurdepääs GITHUB_TOKEN muutujale
github_token = os.getenv("GITHUB_TOKEN")

print(github_token)

See ongi kõik! Olete edukalt loonud .env faili, lisanud oma GitHubi tokeni ja laadinud selle oma Pythonirakendusse.

Kuidas käivitada kohapeal oma arvutis

Koodi kohalikuks käivitamiseks peab arvutis olema paigaldatud mõni Python versioon.

Seejärel on vaja repositori kloonida:

git clone https://github.com/microsoft/generative-ai-for-beginners
cd generative-ai-for-beginners

Kui olete kõik kontrollinud, saate alustadagi!

Valikulised sammud

Miniconda paigaldamine

Miniconda on kerge paigaldaja Conda, Pythoni ja mõne paketi installimiseks. Conda on pakettide haldur, mis lihtsustab erinevate Python virtuaalkeskkondade ja pakettide seadistamist ning vahetamist. See on kasulik ka selliste pakkide paigaldamiseks, mida pip kaudu ei leidu.

Miniconda seadistamise juhendiga saate tutvuda siin: MiniConda installation guide.

Miniconda paigaldamisel peate kloonima ka repo (kui te pole veel teinud).

Järgmisena peate looma virtuaalkeskkonna. Selleks looge Condaga uus keskkonna fail (environment.yml). Kui kasutate Codespaces, looge see .devcontainer kataloogi sisse, st .devcontainer/environment.yml.

Täiendage keskkonna faili alljärgneva fragmentiga:

name: <environment-name>
channels:
  - defaults
  - microsoft
dependencies:
  - python=<python-version>
  - openai
  - python-dotenv
  - pip
  - pip:
      - azure-ai-ml

Kui conda kasutamisel tekib vigu, võite käsitsi Microsoft AI teegid paigaldada, kasutades terminalis järgmist käsku.

conda install -c microsoft azure-ai-ml

Keskkonna faili määrab, milliseid sõltuvusi vaja on. <environment-name> on nimi, mida soovite Conda keskkonnale anda, ja <python-version> on Python'i versioon, mida soovite kasutada, näiteks 3 tähistab Python'i uusimat põhiversiooni.

Pärast seda looge Conda keskkond järgnevate terminalikäskude abil:

conda env create --name ai4beg --file .devcontainer/environment.yml # .devcontainer alamtee kehtib ainult Codespace'i seadete puhul
conda activate ai4beg

Kui ilmneb probleeme, vaadake Conda keskkondade juhendit.

Visual Studio Code kasutamine koos Pythoni laiendiga

Soovitame kasutada selle kursuse puhul Visual Studio Code'i (VS Code) koos Pythoni toe laiendiga. See on pigem soovitus, mitte kohustus.

Märkus: Avades kursuse reposi VS Codes, on teil võimalus seada projekt konteinerisse. Selle võimaldab eriline .devcontainer kataloog kursuse repos. Rohkem selle kohta hiljem.

Märkus: Kui kloonite ja avate kausta VS Codes, soovitab see automaatselt paigaldada Pythoni toe laiendi.

Märkus: Kui VS Code soovitab avada reposi uuesti konteineris, lükake see taotlus tagasi, et kasutada kohapeal paigaldatud Pythoni versiooni.

Jupyteri kasutamine brauseris

Projektiga saate töötada ka brauseris asuva Jupyteri keskkonna kaudu. Nii klassikaline Jupyter kui ka Jupyter Hub pakuvad mugavat arenduskeskkonda automaatse täitmise, süntaksikohanduse jne funktsioonidega.

Jupyteri käivitamiseks kohapeal minge terminali/konsooli, navigeerige kursuse kataloogi ja käivitage:

jupyter notebook

või

jupyterhub

See käivitab Jupyteri ning ligipääsu URL kuvatakse käsureal.

Kui URL-ile pääsete ligi, näete kursuse ülevaadet ja saate avada ükskõik millise *.ipynb faili, näiteks 08-building-search-applications/python/oai-solution.ipynb.

Käivitamine konteineris

Alternatiivina arvutisse või Codespacesisse paigaldamisele saate kasutada konteinerit. Kursuse reposis on eriline .devcontainer kaust, mis võimaldab VS Codel projekti konteinerisse seadistada. väljaspool Codespacesi tuleb seejärel paigaldada Docker ning see nõuab veidi rohkem tööd, seega soovitame seda kasutada ainult kontneritega juba tuttavatele.

Üks parimaid viise oma API võtmete turvaliseks hoidmiseks GitHub Codespacesis on kasutada Codespaces Secrets'i. Lisateabe saamiseks järgige juhendit Codespaces secrets management.

Õppetunnid ja tehnilised nõuded

Kursusel on 6 kontseptsioonitundi ja 6 programmeerimistundi.

Programmeerimistundides kasutame Azure OpenAI teenust. Koodi käitamiseks vajate ligipääsu Azure OpenAI teenusele ja API võtit. Ligipääsu saamiseks saate taotluse esitada, täites selle avalduse.

Kuni teie taotlust töödeldakse, sisaldab iga programmeerimistund ka README.md faili, kus saate vaadata koodi ja väljundeid.

Azure OpenAI teenuse esmakordne kasutamine

Kui kasutate Azure OpenAI teenust esimest korda, järgige palun juhendit, kuidas luua ja juurutada Azure OpenAI teenuse ressurss.

OpenAI API esmakordne kasutamine

Kui kasutate OpenAI API-d esimest korda, järgige juhendit, kuidas luua ja kasutada liidest.

Kohtuge teiste õppijatega

Oleme loonud ametlikus AI kogukonna Discord serveris kanaleid teiste õppijate kohtumiseks. See on suurepärane võimalus suhelda teiste ettevõtlike, ehitajate, üliõpilaste ja kõigiga, kes soovivad Generative AI alal areneda.

Liitu discord kanaliga

Projektimeeskond on samuti sellel Discord serveril valmis aitama kõiki õppijaid.

Panustamine

See kursus on avatud lähtekoodiga algatus. Kui märkate parandamist vajavaid kohti või probleeme, palun esitage Pull Request või logige GitHubi probleem.

Projektimeeskond jälgib kõiki panuseid. Avatud lähtekoodile panustamine on suurepärane võimalus oma karjääri ehitamiseks Generative AI valdkonnas.

Enamik panuseid nõuab, et nõustuksite Panustaja litsentsilepingu (CLA) tingimustega, mis kinnitavad, et teil on õigus ja tegelikult annate meile õigused kasutada teie panust. Lisateabe saamiseks külastage CLA, Contributor License Agreement veebilehte.

Oluline: selle repo teksti tõlkimisel palun ärge kasutage masintõlget. Tõlkeid kontrollitakse kogukonna poolt, seega palun pakkuda tõlkeid ainult keeltes, milles olete pädev.

Pull requesti esitamisel tuvastab CLA-bot automaatselt, kas peate esitama CLA ja märgistab PRi vastavalt (nt silt, kommentaar). Järgige lihtsalt boti juhiseid. Seda on vaja teha vaid korra kõigis repodes, mis kasutavad meie CLA-t.

See projekt on vastu võtnud Microsoft Open Source Code of Conduct. Lisateabe saamiseks lugege juhiseid või võtke ühendust aadressil Email opencode täiendavate küsimuste või kommentaaride korral.

Alustame!

Nüüd, kui olete lõpetanud selle kursuse vajalikud sammud, alustame Sissejuhatusega generatiivse tehisintellekti ja suurtõlkimismudelite juurde.

Vastutusest loobumine: See dokument on tõlgitud AI-tõlketeenuse Co-op Translator abil. Kuigi me püüdleme täpsuse poole, palun pidage meeles, et automatiseeritud tõlked võivad sisaldada vigu või ebatäpsusi. Originaaldokument selle emakeeles loetakse autoriteetseks allikaks. Kriitilise teabe puhul soovitatakse kasutada professionaalset inimtõlget. Me ei vastuta selle tõlke kasutamisest tulenevate arusaamatuste või valesti mõistmiste eest.