Começar

Este guia mostra como começar a usar o Genkit em um app Node.js.

Pré-requisitos

Neste guia, pressupomos que você já sabe criar aplicativos com o Node.js.

Para concluir este guia de início rápido, verifique se o ambiente de desenvolvimento atende aos seguintes requisitos:

  • Node.js v20+
  • npm

Instalar dependências do Genkit

Instale as seguintes dependências do Genkit para usá-lo no seu projeto:

  • O genkit fornece os recursos principais do Genkit.
  • @genkit-ai/googleai oferece acesso aos modelos de IA Gemini do Google.
npm install genkit @genkit-ai/googleai

Configurar a chave de API do modelo

Neste guia, vamos mostrar como usar a API Gemini, que oferece um nível sem custo financeiro generoso e não requer um cartão de crédito para começar. Para usar a API Gemini, você precisa de uma chave de API. Se você ainda não tiver uma, crie uma chave no Google AI Studio.

Gerar uma chave de API no Google AI Studio

Depois de criar uma chave de API, defina a variável de ambiente GOOGLE_GENAI_API_KEY como sua chave com o seguinte comando:

export GOOGLE_GENAI_API_KEY=<your API key>

Faça sua primeira solicitação

Comece a usar o Genkit com apenas algumas linhas de código simples.

// 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);
})();

Próximas etapas

Agora que você está configurado para fazer solicitações de modelo com o Genkit, aprenda a usar mais recursos do Genkit para criar seus fluxos de trabalho e apps com tecnologia de IA. Para começar a usar outros recursos do Genkit, consulte estes guias:

  • Ferramentas para desenvolvedores: aprenda a configurar e usar a CLI e a interface do desenvolvedor do Genkit para ajudar a testar e depurar seu app localmente.
  • Como gerar conteúdo: aprenda a usar a API de geração unificada do Genkit para gerar texto e dados estruturados de qualquer modelo com suporte.
  • Criação de fluxos: aprenda a usar funções especiais do Genkit, chamadas de fluxos, que fornecem observabilidade de ponta a ponta para fluxos de trabalho e depuração avançada com as ferramentas do Genkit.
  • Como gerenciar comandos: saiba como o Genkit ajuda você a gerenciar
  • suas instruções e configurações como código.