Mulai

Untuk mulai menggunakan Firebase Genkit, instal Genkit CLI dan jalankan genkit init pada project Node.js. Bagian selanjutnya dari halaman ini akan menunjukkan caranya.

Persyaratan

Node.js 20 atau yang lebih baru.

Prosedur

1. Instal Genkit CLI dengan menjalankan perintah berikut:

   npm i -g genkit
   

2. Buat project Node baru:

   mkdir genkit-intro && cd genkit-intro
   npm init -y
   

   Lihat package.json dan pastikan kolom main ditetapkan ke lib/index.js.

3. Lakukan inisialisasi project Genkit:

   genkit init
   

   1. Pilih Node.js sebagai opsi platform deployment (template untuk Firebase Cloud Functions dan Google Cloud Run juga tersedia).

   2. Pilih model Anda:

      Gemini (AI Google)

      Cara paling sederhana untuk memulai adalah dengan Google AI Gemini API. Pastikan software tersebut tersedia di wilayah Anda.

      Buat kunci API untuk Gemini API menggunakan Google AI Studio. Kemudian, tetapkan variabel lingkungan GOOGLE_GENAI_API_KEY ke kunci Anda:

      export GOOGLE_GENAI_API_KEY=<your API key>
      

      Gemini (Vertex AI)

      Jika Google AI Gemini API tidak tersedia di wilayah Anda, pertimbangkan untuk menggunakan Vertex AI API yang juga menawarkan Gemini dan model lainnya. Anda harus memiliki project Google Cloud yang mendukung penagihan, mengaktifkan AI Platform API, dan menetapkan beberapa variabel lingkungan tambahan:

      gcloud services enable aiplatform.googleapis.com
      export GCLOUD_PROJECT=<your project ID>
      export GCLOUD_LOCATION=us-central1
      

      Lihat https://cloud.google.com/vertex-ai/generative-ai/pricing untuk mengetahui harga Vertex AI.

   3. Pilih jawaban default untuk pertanyaan lainnya, yang akan menginisialisasi folder project Anda dengan beberapa kode contoh.

   Perintah genkit init membuat file sumber contoh, index.ts. Ini adalah titik entri project Anda, tempat Anda mengonfigurasi Genkit untuk project, mengonfigurasi plugin yang ingin dimuat, serta mengekspor alur AI dan resource lain yang telah Anda tentukan. File contoh berisi konfigurasi yang memuat plugin untuk mendukung penyedia model yang Anda pilih sebelumnya. File ini juga berisi satu alur, menuSuggestionFlow, yang meminta LLM menyarankan item untuk restoran dengan tema tertentu.

   configureGenkit({
     plugins: [googleAI()],
     logLevel: 'debug',
     enableTracingAndMetrics: true,
   });
   
   export const menuSuggestionFlow = defineFlow(
     {
       name: 'menuSuggestionFlow',
       inputSchema: z.string(),
       outputSchema: z.string(),
     },
     async (subject) => {
       const llmResponse = await generate({
         prompt: `Suggest an item for the menu of a {subject} themed restaurant`,
         model: geminiPro,
         config: {
           temperature: 1,
         },
       });
   
       return llmResponse.text();
     }
   );
   
   startFlowsServer();
   

   Saat membangun fitur AI aplikasi dengan Genkit, Anda mungkin akan membuat alur dengan beberapa langkah seperti pra-pemrosesan input, konstruksi perintah yang lebih canggih, mengintegrasikan sumber informasi eksternal untuk retrieval-augmented Generation (RAG), dan lainnya.

4. Kini Anda dapat menjalankan dan menjelajahi fitur Genkit serta project contoh secara lokal di komputer. Download dan mulai UI Developer Genkit:

   genkit start
   

   

   UI Developer Genkit sekarang berjalan di mesin Anda. Saat Anda menjalankan model atau flow pada langkah berikutnya, mesin Anda akan melakukan tugas orkestrasi yang diperlukan agar langkah-langkah flow Anda berfungsi bersama; panggilan ke layanan eksternal seperti Gemini API akan terus dilakukan terhadap server live.

   Selain itu, karena Anda berada di lingkungan pengembangan, Genkit akan menyimpan rekaman aktivitas dan status flow di file lokal.

5. UI Developer Genkit akan didownload dan terbuka secara otomatis saat Anda menjalankan perintah genkit start.

   UI Developer memungkinkan Anda melihat alur mana yang telah ditentukan dan model yang Anda konfigurasi, menjalankannya, serta memeriksa rekaman aktivitas operasi sebelumnya. Cobalah beberapa fitur ini:

   • Pada tab Run, Anda akan melihat daftar semua alur yang telah Anda tetapkan dan semua model yang telah dikonfigurasi oleh plugin.

     Klik menuSuggestionFlow dan coba jalankan dengan beberapa teks input (misalnya, "cat"). Jika semuanya berjalan lancar, Anda akan mendapatkan hadiah berupa saran menu untuk restoran bertema kucing.

   • Di tab Inspect, Anda akan melihat histori eksekusi flow. Untuk setiap alur, Anda dapat melihat parameter yang diteruskan ke alur dan rekaman aktivitas setiap langkah saat berjalan.

Langkah berikutnya

Pelajari cara membangun dan men-deploy aplikasi Genkit dengan Firebase, Cloud Run, atau platform Node.js apa pun.