Genkit

niadraMiddleware(session) é um model middleware para generate({ use }) do Genkit (Firebase Genkit para JavaScript), e niadraTools(session) devolve o kit como ferramentas do Genkit. Só em TypeScript.

Instalar

npm install @niadra/sdk genkit   # genkit 1.42 ou mais novo, abaixo da 2, como peer dependency opcional

A integração chega com o @niadra/sdk 0.3.0, pronto no ramo main e no npm quando for publicado; até lá, o pacote do npm é o 0.1.1.

As cinco primitivas

Primitiva	Como o adaptador liga
Contexto	O middleware roda em volta de cada chamada ao modelo da requisição, inclusive os passos do laço de ferramentas: o contexto (depois das notas do agente, com `agentMemory`) entra como uma parte de texto da sua mensagem de sistema (uma nova, se não há; vários provedores leem uma mensagem de sistema só) e o `turn_block` como parte de texto da última mensagem do usuário
Turnos	A mensagem mais nova do usuário é registrada uma vez; a resposta é o turno do agente, com o uso do Genkit (`inputTokens` e `cachedContentTokens`) quando você diz o `model` na opção, porque um model middleware não vê o nome do modelo. Passos que só pedem ferramentas não registram nada
Ferramentas	`niadraTools(session)`: ferramentas do Genkit não registradas (cada requisição leva as amarradas ao próprio cliente), com os esquemas JSON do kit
Verificação	`verify` na opção do middleware, registrado uma vez antes do primeiro contexto
Transbordo	`session.handoff()` onde o seu fluxo transfere

Exemplo mínimo

import { genkit } from "genkit";
import { googleAI } from "@genkit-ai/google-genai";
import { Niadra, handles } from "@niadra/sdk";
import { niadraMiddleware, niadraTools } from "@niadra/sdk/genkit";

const niadra = new Niadra();
const ai = genkit({ plugins: [googleAI()] });

const convo = niadra.conversation({ subject: handles.appUserId(user.id), channel: "web_chat", conversation_id: chatId });
const { text } = await ai.generate({
  model: googleAI.model("gemini-2.5-flash"),
  system: "You are Acme's support agent.",
  messages: history,
  prompt: "Where is my replacement?",
  tools: niadraTools(convo),
  use: [niadraMiddleware(convo, { model: "googleai/gemini-2.5-flash" })],
});

Memória do agente

niadraMiddleware(convo, { agentMemory: true }) e niadraTools(convo, { agentMemory: true }) põem as notas do próprio agente antes do contexto do cliente e acrescentam as duas ferramentas. Veja Memória do agente.

Limites

O middleware aceita uma conversa, uma tarefa ou uma função que encontra a de cada chamada; quando ela devolve null, a chamada passa sem mudança.
Sem model na opção, o turno do agente é registrado sem uso.
Nada aqui para a chamada: com a Niadra lenta ou fora, a requisição vai ao modelo como veio.
Testado contra genkit 1.42.0 com o modelo de teste do próprio Genkit, laço de ferramentas incluído, e a Niadra no emulador.

Começar

Voz

Canais

Frameworks de agente

SDKs de modelo

Plataformas de automação

Clientes MCP

Instalar

As cinco primitivas

Exemplo mínimo

Memória do agente

Limites

Próximos passos

Google GenAI

Navegação do histórico

​Instalar

​As cinco primitivas

​Exemplo mínimo

​Memória do agente

​Limites

​Próximos passos

Google GenAI

Navegação do histórico

Instalar

As cinco primitivas

Exemplo mínimo

Memória do agente

Limites

Próximos passos