شروع کنید

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

پیش نیازها

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

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

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

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

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

  • @genkit-ai/ai و @genkit-ai/core قابلیت های هسته Genkit را ارائه می دهند.
  • @genkit-ai/googleai امکان دسترسی به مدل‌های Google AI Gemini را فراهم می‌کند.
  • genkit Genkit CLI و ابزاری را برای کمک به شما در آزمایش و اشکال‌زدایی راه‌حل خود در آینده فراهم می‌کند.
npm install @genkit-ai/ai @genkit-ai/core @genkit-ai/googleai
npm install -g genkit

کلید 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 و افزونه برای APIهای Google AI Gemini را وارد کنید.

import { generate } from '@genkit-ai/ai';
import { configureGenkit } from '@genkit-ai/core';
import { googleAI, gemini15Flash } from '@genkit-ai/googleai';

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

از روش generate برای ایجاد پاسخ متنی استفاده کنید.

configureGenkit({ plugins: [googleAI()] });

const result = await generate({
    model: gemini15Flash,
    prompt: 'Tell me a heroic story about a software developer.',
});

console.log(result.text())

مراحل بعدی

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

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