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>

Observação: embora este tutorial use a API Gemini do AI Studio, o Genkit oferece suporte a uma grande variedade de provedores de modelos, incluindo Gemini da Vertex AI, modelos Claude 3 da Anthropic e Llama 3.1 no Vertex AI Model Garden, modelos de código aberto no Ollama e vários outros provedores com suporte da comunidade, como OpenAI e Cohere.

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.
• Modelos de solicitação: saiba como o Genkit permite tratar modelos de solicitação como funções, encapsulando configurações de modelos e esquemas de entrada/saída.