copilot openai todo

? kopilot-openai-todo

Proyek ini adalah contoh implementasi aplikasi Todo, yang bertujuan untuk menunjukkan cara menggunakan GitHub Copilot untuk membangun aplikasi todo yang didukung AI menggunakan Azure OpenAI dan Azure Cosmos DB.

Aplikasi yang sudah lengkap terletak di cabang yang sudah selesai.

Prasyarat

• Node.js v18+
• buruh pelabuhan v20+
• akun Azure . Jika Anda baru menggunakan Azure, dapatkan akun Azure secara gratis untuk mendapatkan kredit Azure gratis untuk memulai.
• Langganan Azure dengan akses diaktifkan untuk layanan Azure OpenAI . Anda dapat meminta akses dengan formulir ini.
  • Alternatifnya, Anda dapat menggunakan kunci API OpenAI alih-alih layanan Azure OpenAI.

Anda dapat menggunakan GitHub Codespaces untuk mengerjakan proyek ini langsung dari browser Anda: pilih tombol Code , lalu tab Codespaces dan klik Create Codespaces on main .

Anda juga dapat menggunakan ekstensi Dev Containers agar VS Code dapat bekerja secara lokal menggunakan lingkungan dev yang siap digunakan.

Setelah Anda mengkloning atau membuka proyek di lingkungan dev Anda, jalankan perintah berikut untuk menginstal dependensi:

npm install

Detail proyek

Proyek ini disusun sebagai monorepo dan menggunakan NPM Workspaces. Ini diatur sebagai berikut:

.devcontainer/    # Dev container configuration
.github/          # GitHub Actions CI/CD pipeline
packages/         # The different parts of our app
| - server/        # The Express server, hosting the API and the website
+- client/        # The website client
package.json      # NPM workspace configuration 

Bagaimana cara membangun proyek tersebut

npm run build

Perintah ini akan membangun paket klien dan server.

Cara menyiapkan penerapan

Untuk menyediakan sumber daya di Azure dan menyebarkan layanan, kami menggunakan Azure Dev CLI.

 # Only needed once
azd auth login --use-device-code

# Provision and deploy infrastructure
azd up

Anda juga dapat menyediakan dan menyebarkan infrastruktur secara terpisah:

 # Provision infrastructure
azd provision

# Deploy infrastructure
azd deploy

Cara menjalankannya secara lokal

Untuk menjalankan aplikasi secara lokal, Anda perlu menyiapkan variabel lingkungan berikut dalam file .env di root proyek dengan konten berikut:

AZURE_OPENAI_ENDPOINT= < your Azure OpenAI endpoint >
AZURE_COSMOS_DB_ENDPOINT= < your Azure Cosmos DB endpoint >

Karena aplikasi mengandalkan layanan Azure untuk penyelesaian OpenAI dan penyimpanan Cosmos DB, Anda harus menyediakan sumber daya ini di Azure terlebih dahulu (lihat Cara menyiapkan penerapan).

Kemudian, jalankan perintah berikut untuk menghasilkan file .env Anda:

azd env get-values > .env

Setelah file .env Anda siap, Anda dapat memulai aplikasi dengan menjalankan perintah berikut di root proyek:

npm run start

Ini akan menjalankan klien dan server:

• Klien akan tersedia di http://localhost:4200.
• Server akan tersedia di http://localhost:3000.

Berkontribusi

Proyek ini menyambut baik kontribusi dan saran. Sebagian besar kontribusi mengharuskan Anda menyetujui Perjanjian Lisensi Kontributor (CLA) yang menyatakan bahwa Anda berhak, dan memang benar, memberi kami hak untuk menggunakan kontribusi Anda. Untuk detailnya, kunjungi https://cla.opensource.microsoft.com.

Saat Anda mengirimkan permintaan tarik, bot CLA akan secara otomatis menentukan apakah Anda perlu memberikan CLA dan menghiasi PR dengan tepat (misalnya, pemeriksaan status, komentar). Cukup ikuti instruksi yang diberikan oleh bot. Anda hanya perlu melakukan ini sekali di seluruh repo menggunakan CLA kami.

Proyek ini telah mengadopsi Kode Etik Sumber Terbuka Microsoft. Untuk informasi lebih lanjut lihat FAQ Pedoman Perilaku atau hubungi [email protected] jika ada pertanyaan atau komentar tambahan.

Merek Dagang

Proyek ini mungkin berisi merek dagang atau logo untuk proyek, produk, atau layanan. Penggunaan resmi atas merek dagang atau logo Microsoft tunduk dan harus mengikuti Pedoman Merek Dagang & Merek Microsoft. Penggunaan merek dagang atau logo Microsoft dalam versi modifikasi proyek ini tidak boleh menimbulkan kebingungan atau menyiratkan sponsor Microsoft. Segala penggunaan merek dagang atau logo pihak ketiga tunduk pada kebijakan pihak ketiga tersebut.