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 oferece acesso aos modelos de IA Gemini 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 GEMINI_API_KEY para sua chave com o seguinte comando:

export GEMINI_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 { gemini20Flash, googleAI } from '@genkit-ai/googleai';
import { genkit } from 'genkit';

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

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

main();

Próximas etapas

Agora que está tudo pronto para fazer solicitações de modelo com o Genkit, saiba como 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.
  • 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: saiba como 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 os comandos e a configuração em conjunto como código.
  • Integração em um app: acompanhe um exemplo implantado de vários fluxos do Genkit que alimentam um app da Web.