شروع کنید

این راهنما به شما نشان می دهد که چگونه با Genkit در یک برنامه Node.js شروع کنید.

پیش نیازها

این راهنما فرض می کند که شما با ساختن برنامه ها با Node.js آشنا هستید.

برای تکمیل این شروع سریع، مطمئن شوید که محیط توسعه شما شرایط زیر را دارد:

  • Node.js نسخه 20+
  • npm

وابستگی های Genkit را نصب کنید

برای استفاده از Genkit در پروژه خود، وابستگی های Genkit زیر را نصب کنید:

  • genkit قابلیت های اصلی Genkit را فراهم می کند.
  • @genkit-ai/googleai دسترسی به مدل‌های Google AI Gemini را فراهم می‌کند.
npm install genkit @genkit-ai/googleai

کلید API مدل خود را پیکربندی کنید

برای این راهنما، نحوه استفاده از Gemini API را به شما نشان خواهیم داد که یک ردیف رایگان سخاوتمندانه ارائه می دهد و برای شروع به کارت اعتباری نیاز ندارد. برای استفاده از Gemini API، به یک کلید API نیاز دارید. اگر قبلاً یکی ندارید، یک کلید در Google AI Studio ایجاد کنید.

یک کلید API از Google AI Studio دریافت کنید

پس از ایجاد یک کلید API، متغیر محیطی GOOGLE_GENAI_API_KEY را با دستور زیر روی کلید خود تنظیم کنید:

export GOOGLE_GENAI_API_KEY=<your API key>

اولین درخواست خود را مطرح کنید

با Genkit فقط در چند خط کد ساده شروع کنید.

// import the Genkit and Google AI plugin libraries
import { gemini15Flash, googleAI } from '@genkit-ai/googleai';
import { genkit } from 'genkit';

// configure a Genkit instance
const ai = genkit({
  plugins: [googleAI()],
  model: gemini15Flash, // set default model
});

(async () => {
  // make a generation request
  const { text } = await ai.generate('Hello, Gemini!');
  console.log(text);
})();

مراحل بعدی

اکنون که برای ایجاد درخواست‌های مدل با Genkit آماده شده‌اید، یاد بگیرید که چگونه از قابلیت‌های Genkit بیشتر برای ایجاد برنامه‌ها و گردش‌های کاری مبتنی بر هوش مصنوعی خود استفاده کنید. برای شروع کار با قابلیت های اضافی Genkit، به راهنماهای زیر مراجعه کنید:

  • ابزارهای برنامه‌نویس : نحوه راه‌اندازی و استفاده از Genkit's CLI و UI توسعه‌دهنده را بیاموزید تا به شما کمک کند برنامه خود را به صورت محلی آزمایش و اشکال‌زدایی کنید.
  • تولید محتوا : یاد بگیرید که چگونه از API نسل یکپارچه Genkit برای تولید متن و داده های ساختاریافته از هر مدل پشتیبانی شده استفاده کنید.
  • ایجاد جریان : نحوه استفاده از توابع ویژه Genkit به نام جریان ها را بیاموزید که قابلیت مشاهده سرتاسر برای گردش کار و اشکال زدایی غنی از ابزار Genkit را فراهم می کند.
  • مدل‌های درخواستی : بیاموزید که چگونه Genkit به شما امکان می‌دهد با الگوهای سریع به‌عنوان توابع رفتار کنید، پیکربندی‌های مدل و طرح‌واره ورودی/خروجی را کپسوله کنید.