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 ou mais recente
• npm

Instalar dependências do Genkit

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

• @genkit-ai/ai e @genkit-ai/core oferecem recursos principais do Genkit.
• @genkit-ai/googleai oferecem acesso aos modelos de IA Gemini do Google.
• O genkit fornece a CLI e as ferramentas do Genkit para ajudar você a testar e depurar sua solução posteriormente.

npm install @genkit-ai/ai @genkit-ai/core @genkit-ai/googleai
npm install -g genkit

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 exige 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.

Importar a biblioteca

Importe as bibliotecas principais do Genkit e o plug-in para as APIs Gemini de IA do Google.

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

Faça sua primeira solicitação

Use o método generate para gerar uma resposta de texto.

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

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

console.log(result.text())

Próximas etapas

Agora que você já 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 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 compatível.
• 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 nas 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.