Cara Saya Membina Apl Pencari Lirik Muzik dengan CopilotKit dan Next.js: Panduan Langkah demi Langkah

Helo, rakan pejuang sumber terbuka saya! Memandangkan musim Hacktoberfest semakin hampir, saya harap anda membuat kemajuan yang baik dengan sumbangan anda. Hari ini saya ingin berkongsi dengan anda bagaimana kami boleh menggunakan keupayaan AI Copilotkit untuk membangunkan apl web yang membolehkan pengguna mencari lirik lagu. Di bawah ialah teknologi utama yang akan kami gunakan untuk membina projek ini:

• Next.js: Rangka kerja React yang membolehkan pemaparan sebelah pelayan dan penjanaan tapak statik untuk membina aplikasi web yang pantas dan berskala.
• Tailwind CSS: Rangka kerja CSS yang mengutamakan utiliti untuk membina antara muka pengguna tersuai dengan pantas.
• UI Shadcn: Pustaka komponen UI sumber terbuka yang direka untuk aplikasi web moden.
• CopilotKit: Alat sumber terbuka yang memudahkan untuk menyepadukan Copilot sedia pengeluaran ke dalam sebarang aplikasi. Dengan CopilotKit, anda boleh melaksanakan chatbot AI tersuai dan ejen AI dengan lancar untuk meningkatkan kefungsian aplikasi anda.

Persediaan Projek

Pertama, kami akan mencipta apl Next.js baharu. (Pada masa menulis artikel ini, saya menggunakan Next.js 14)

npx create-next-app@latest

Pilih pilihan pilihan anda dan kemudian cd ke dalam projek anda dan pasang kebergantungan berikut:

npm install @copilotkit/react-core @copilotkit/react-ui @copilotkit/runtime 

Pergi ke Groq Console, daftar untuk akaun baharu jika anda tidak mempunyai akaun dan kemudian dalam papan pemuka anda, jana kunci API

Sekarang dalam akar projek anda, buat fail .env.local dan tampal dalam kunci API anda dan parameter berikut seperti:

GROQ_API_KEY="groq api key"
GROQ_MODEL="llama3-8b-8192"

Sejuk!, sebelum kita mula mengerjakan projek, pasang pustaka ShadcnUI dengan cepat:

npm install npx shadcn@latest init

Pilih konfigurasi pilihan anda dan kemudian gunakan arahan di bawah untuk mendapatkan komponen Kad

npx shadcn@latest add card

Secara pilihan, anda juga boleh memasang pustaka ikon reaksi

npm install react-icons --save

Sekarang kita tidak mempunyai masalah itu, mari kita terjun ke dalam pembinaan projek

Membina Projek

Kami mula-mula akan bermula dengan bahagian hujung belakang apl kami. Di dalam folder aplikasi buat folder api. Di dalam folder api, cipta dua folder iaitu: tindakan dan copilotkit. Struktur folder anda sepatutnya kelihatan seperti ini:

├── apl
│ ├── api
│ │ ├── tindakan
│ │ └── copilotkit

Buat fail yang dipanggil lyric.ts di dalam folder tindakan. Salin kod di bawah:

"use server";

export async function fetchLyrics({ song, artist }: { song: string; artist: string }) {

    const URL = `https://api.lyrics.ovh/v1/${artist}/${song}`; // url to access the lyrics api

    try {
        const response = await fetch(URL);

        if (!response.ok) {
            throw new Error("Lyrics not found");
        }

        const data = await response.json();

        return data.lyrics || "Lyrics not found.";
    } catch (error) {
        console.error("Error fetching lyrics:", error);
        return "An error occurred while fetching lyrics.";
    }
}

Buka folder copilotkit dan buat fail route.ts. Salin kod di bawah:

npx create-next-app@latest

Sekarang kami telah selesai dengan bahagian belakang apl kami. Untuk bahagian hadapan, buka folder komponen yang dibuat untuk kami dan buat fail yang dipanggil LyricFinder.tsx. Struktur folder anda sepatutnya kelihatan seperti ini:

├── komponen
│ ├── ui
│ ├── LyricFinder.tsx

Sekarang salin kod di bawah:

npm install @copilotkit/react-core @copilotkit/react-ui @copilotkit/runtime 

Buka fail halaman dalam akar folder apl anda dan tampal kod di bawah:

GROQ_API_KEY="groq api key"
GROQ_MODEL="llama3-8b-8192"

Sweet! Kami telah selesai membina apl. Buka terminal anda dan mulakan pelayan pembangunan

npm install npx shadcn@latest init

Buka http://localhost:3000 dalam penyemak imbas anda untuk melihat apl.

Kesimpulan

Itu pembalut! Dalam tutorial ini, kami berjaya menggunakan CopilotKit untuk membina apl Music Lyric Finder, menunjukkan betapa mudahnya untuk menyepadukan AI ke dalam aplikasi kami.

Anda boleh melihat kod sumber lengkap dalam repo Github ini

Berikut ialah demo langsung projek di sini

Ada sebarang soalan? Tanya dalam komen

Selamat Menggoda!

Atas ialah kandungan terperinci Cara Saya Membina Apl Pencari Lirik Muzik dengan CopilotKit dan Next.js: Panduan Langkah demi Langkah. Untuk maklumat lanjut, sila ikut artikel berkaitan lain di laman web China PHP!