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

Para usar o Genkit no seu projeto, instale as seguintes dependências:

  • genkit oferece os recursos principais do Genkit.
  • @genkit-ai/googleai dá acesso aos modelos do Gemini da IA do Google.
npm install genkit @genkit-ai/googleai

Configure 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 exige um cartão de crédito para começar. Para usar a API Gemini, você precisa de uma chave de API. Se ainda não tiver, crie uma chave no Google AI Studio.

Gerar uma chave de API do Google AI Studio

Depois de criar uma chave de API, defina a variável de ambiente GOOGLE_GENAI_API_KEY para 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á pronto para fazer solicitações de modelo com o Genkit, aprenda a usar mais recursos do Genkit para criar seus apps e fluxos de trabalho com tecnologia de IA. Para começar a usar outros recursos do Genkit, consulte estes guias:

  • Ferramentas para desenvolvedores: saiba como configurar e usar a CLI e a interface de desenvolvedor do Genkit para testar e depurar seu app localmente.
  • Geração de 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 flows, que fornecem observabilidade de ponta a ponta para fluxos de trabalho e depuração rica com as ferramentas do Genkit.
  • Gerenciamento de comandos: saiba como o Genkit ajuda a gerenciar comandos e a configuração em conjunto como código.