Pelajaran ini akan membahas cara menjalankan contoh kode dari kursus ini.
Sebelum Anda mulai mengkloning repositori, bergabunglah dengan saluran Discord AI Agents For Beginners untuk mendapatkan bantuan terkait pengaturan, pertanyaan tentang kursus, atau untuk terhubung dengan peserta lainnya.
Untuk memulai, silakan kloning atau fork repositori GitHub. Ini akan membuat versi Anda sendiri dari materi kursus sehingga Anda dapat menjalankan, menguji, dan mengubah kode!
Hal ini dapat dilakukan dengan mengklik tautan untuk fork repositori
Sekarang Anda seharusnya memiliki versi fork dari kursus ini di tautan berikut:

Repositori penuh bisa cukup besar (~3 GB) saat Anda mengunduh seluruh riwayat dan semua file. Jika Anda hanya mengikuti workshop atau hanya membutuhkan beberapa folder pelajaran, kloning shallow (atau kloning sparse) menghindari sebagian besar unduhan tersebut dengan memotong riwayat dan/atau melewatkan blob.
Ganti <your-username> dalam perintah di bawah ini dengan URL fork Anda (atau URL upstream jika Anda lebih suka).
Untuk mengkloning hanya riwayat commit terbaru (unduhan kecil):
git clone --depth 1 https://github.com/<your-username>/ai-agents-for-beginners.git
Untuk mengkloning cabang tertentu:
git clone --depth 1 --branch <branch-name> https://github.com/<your-username>/ai-agents-for-beginners.git
Ini menggunakan kloning parsial dan sparse-checkout (memerlukan Git 2.25+ dan Git modern yang mendukung kloning parsial):
git clone --depth 1 --filter=blob:none --sparse https://github.com/<your-username>/ai-agents-for-beginners.git
Masuk ke folder repositori:
Untuk bash:
cd ai-agents-for-beginners
Untuk Powershell:
Set-Location ai-agents-for-beginners
Kemudian tentukan folder mana yang Anda inginkan (contoh di bawah menunjukkan dua folder):
git sparse-checkout set 00-course-setup 01-intro-to-ai-agents
Setelah mengkloning dan memverifikasi file, jika Anda hanya membutuhkan file dan ingin menghemat ruang (tanpa riwayat git), silakan hapus metadata repositori (💀tidak dapat dibalik — Anda akan kehilangan semua fungsi Git: tidak ada commit, pull, push, atau akses riwayat).
Untuk Linux/macOS:
rm -rf .git
Untuk Windows:
Remove-Item -Recurse -Force .git
Buat Codespace baru untuk repositori ini melalui UI GitHub.
Kursus ini menawarkan serangkaian Jupyter Notebooks yang dapat Anda jalankan untuk mendapatkan pengalaman langsung dalam membangun AI Agents.
Contoh kode menggunakan:
Memerlukan Akun GitHub - Gratis:
1) Semantic Kernel Agent Framework + GitHub Models Marketplace. Ditandai sebagai (semantic-kernel.ipynb) 2) AutoGen Framework + GitHub Models Marketplace. Ditandai sebagai (autogen.ipynb)
Memerlukan Langganan Azure: 3) Azure AI Foundry + Azure AI Agent Service. Ditandai sebagai (azureaiagent.ipynb)
Kami mendorong Anda untuk mencoba semua tiga jenis contoh untuk melihat mana yang paling cocok untuk Anda.
Pilihan mana pun yang Anda pilih akan menentukan langkah pengaturan yang perlu Anda ikuti di bawah ini:
NOTE: Jika Anda belum menginstal Python3.12, pastikan Anda menginstalnya. Kemudian buat venv Anda menggunakan python3.12 untuk memastikan versi yang benar diinstal dari file requirements.txt.
Contoh
Buat direktori Python venv:
python3 -m venv venv
Kemudian aktifkan lingkungan venv untuk:
macOS dan Linux
source venv/bin/activate
Windows
venv\Scripts\activate
Kami telah menyertakan file requirements.txt di root repositori ini yang berisi semua paket Python yang diperlukan untuk menjalankan contoh kode.
Anda dapat menginstalnya dengan menjalankan perintah berikut di terminal Anda di root repositori:
pip install -r requirements.txt
Kami merekomendasikan membuat lingkungan virtual Python untuk menghindari konflik dan masalah.
Pastikan Anda menggunakan versi Python yang benar di VSCode.
Kursus ini memanfaatkan GitHub Models Marketplace, memberikan akses gratis ke Large Language Models (LLMs) yang akan Anda gunakan untuk membangun AI Agents.
Untuk menggunakan GitHub Models, Anda perlu membuat Token Akses Pribadi GitHub.
Ini dapat dilakukan dengan pergi ke Pengaturan Token Akses Pribadi di Akun GitHub Anda.
Silakan ikuti Prinsip Privilege Minimum saat membuat token Anda. Ini berarti Anda hanya harus memberikan token izin yang diperlukan untuk menjalankan contoh kode dalam kursus ini.
Pilih opsi Fine-grained tokens di sisi kiri layar Anda dengan menuju ke Pengaturan Pengembang

Kemudian pilih Generate new token.

Masukkan nama deskriptif untuk token Anda yang mencerminkan tujuannya, sehingga mudah diidentifikasi nanti.
🔐 Rekomendasi Durasi Token
Durasi yang direkomendasikan: 30 hari Untuk postur keamanan yang lebih baik, Anda dapat memilih periode yang lebih pendek—seperti 7 hari 🛡️ Ini adalah cara yang bagus untuk menetapkan target pribadi dan menyelesaikan kursus sambil momentum belajar Anda tinggi 🚀.

Batasi cakupan token ke fork repositori ini.

Batasi izin token: Di bawah Permissions, klik tab Account, dan klik tombol “+ Add permissions”. Dropdown akan muncul. Silakan cari Models dan centang kotaknya.

Verifikasi izin yang diperlukan sebelum membuat token. 
Sebelum membuat token, pastikan Anda siap menyimpan token di tempat yang aman seperti brankas pengelola kata sandi, karena token tidak akan ditampilkan lagi setelah Anda membuatnya. 
Salin token baru Anda yang baru saja dibuat. Anda sekarang akan menambahkannya ke file .env yang disertakan dalam kursus ini.
.env AndaUntuk membuat file .env Anda, jalankan perintah berikut di terminal Anda.
cp .env.example .env
Ini akan menyalin file contoh dan membuat .env di direktori Anda di mana Anda mengisi nilai untuk variabel lingkungan.
Dengan token Anda yang telah disalin, buka file .env di editor teks favorit Anda dan tempelkan token Anda ke kolom GITHUB_TOKEN.

Sekarang Anda seharusnya dapat menjalankan contoh kode dari kursus ini.
Ikuti langkah-langkah untuk membuat hub dan proyek di Azure AI Foundry yang dapat ditemukan di sini: Ikhtisar sumber daya Hub
Setelah Anda membuat proyek Anda, Anda perlu mengambil string koneksi untuk proyek Anda.
Ini dapat dilakukan dengan pergi ke halaman Overview dari proyek Anda di portal Azure AI Foundry.

.env AndaUntuk membuat file .env Anda, jalankan perintah berikut di terminal Anda.
cp .env.example .env
Ini akan menyalin file contoh dan membuat .env di direktori Anda di mana Anda mengisi nilai untuk variabel lingkungan.
Dengan token Anda yang telah disalin, buka file .env di editor teks favorit Anda dan tempelkan token Anda ke kolom PROJECT_ENDPOINT.
Sebagai praktik keamanan terbaik, kita akan menggunakan autentikasi tanpa kunci untuk autentikasi ke Azure OpenAI dengan Microsoft Entra ID.
Selanjutnya, buka terminal dan jalankan az login --use-device-code untuk masuk ke akun Azure Anda.
Setelah Anda masuk, pilih langganan Anda di terminal.
Untuk Pelajaran Agentic RAG - Pelajaran 5 - terdapat contoh yang menggunakan Azure Search dan Azure OpenAI.
Jika Anda ingin menjalankan contoh ini, Anda perlu menambahkan variabel lingkungan berikut ke file .env Anda:
AZURE_SUBSCRIPTION_ID - Periksa Detail Proyek di halaman Overview proyek Anda.
AZURE_AI_PROJECT_NAME - Lihat bagian atas halaman Overview untuk proyek Anda.
AZURE_OPENAI_SERVICE - Temukan ini di tab Included capabilities untuk Azure OpenAI Service di halaman Overview.
AZURE_OPENAI_RESOURCE_GROUP - Pergi ke Properti Proyek di halaman Overview dari Pusat Manajemen.
GLOBAL_LLM_SERVICE - Di bawah Connected resources, temukan nama koneksi Azure AI Services. Jika tidak terdaftar, periksa portal Azure di bawah grup sumber daya Anda untuk nama sumber daya AI Services.
AZURE_OPENAI_EMBEDDING_DEPLOYMENT_NAME - Pilih model embedding Anda (misalnya, text-embedding-ada-002) dan catat Deployment name dari detail model.
AZURE_OPENAI_CHAT_DEPLOYMENT_NAME - Pilih model chat Anda (misalnya, gpt-4o-mini) dan catat Deployment name dari detail model.
AZURE_OPENAI_ENDPOINT - Cari Azure AI services, klik, lalu pergi ke Resource Management, Keys and Endpoint, gulir ke bawah ke “Azure OpenAI endpoints”, dan salin yang bertuliskan “Language APIs”.
AZURE_OPENAI_API_KEY - Dari layar yang sama, salin KEY 1 atau KEY 2.
AZURE_SEARCH_SERVICE_ENDPOINT - Temukan sumber daya Azure AI Search Anda, klik, dan lihat Overview.
AZURE_SEARCH_API_KEY - Kemudian pergi ke Settings dan kemudian Keys untuk menyalin kunci admin utama atau sekunder.
AZURE_OPENAI_API_VERSION - Kunjungi halaman siklus hidup versi API di bawah Rilis API GA terbaru.Daripada menyematkan kredensial Anda, kita akan menggunakan koneksi tanpa kunci dengan Azure OpenAI. Untuk melakukannya, kita akan mengimpor DefaultAzureCredential dan kemudian memanggil fungsi DefaultAzureCredential untuk mendapatkan kredensial.
from azure.identity import DefaultAzureCredential, InteractiveBrowserCredential
Jika Anda mengalami masalah saat menjalankan pengaturan ini, bergabunglah dengan Azure AI Community Discord kami atau buat sebuah isu.
Anda sekarang siap untuk menjalankan kode dalam kursus ini. Selamat belajar lebih banyak tentang dunia AI Agents!
Pengenalan AI Agents dan Kasus Penggunaannya
Penafian:
Dokumen ini telah diterjemahkan menggunakan layanan penerjemahan AI Co-op Translator. Meskipun kami berupaya untuk memberikan hasil yang akurat, harap diperhatikan bahwa terjemahan otomatis mungkin mengandung kesalahan atau ketidakakuratan. Dokumen asli dalam bahasa aslinya harus dianggap sebagai sumber yang otoritatif. Untuk informasi yang penting, disarankan menggunakan jasa penerjemahan manusia profesional. Kami tidak bertanggung jawab atas kesalahpahaman atau interpretasi yang keliru yang timbul dari penggunaan terjemahan ini.