VoltAgent

niadraHooks() devolve onPrepareModelMessages, onEnd e onHandoff para new Agent({ hooks }), e niadraTools(session) devolve o kit como ferramentas do VoltAgent. A memória do próprio VoltAgent (conversas, working memory) continua dele; a Niadra é a memória do cliente compartilhada com os outros agentes da empresa. Só em TypeScript.

Instalar

npm install @niadra/sdk @voltagent/core   # @voltagent/core 2.10 ou mais novo, abaixo da 3, sobre o AI SDK 6

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	`onPrepareModelMessages` põe o contexto (depois das notas do agente, com `agentMemory`) como mensagem de sistema depois das suas instruções e o `turn_block` no fim da última mensagem do usuário, só no que vai ao modelo: nada disso entra na memória do VoltAgent
Turnos	`onPrepareModelMessages` registra a mensagem mais nova do usuário; `onEnd` registra a resposta com o uso da operação inteira (leituras e escritas do cache de prompt incluídas)
Ferramentas	`niadraTools(session)`: ferramentas do VoltAgent com os esquemas JSON do kit, amarradas ao cliente
Verificação	`verify` na opção dos hooks, registrado uma vez antes do primeiro contexto
Transbordo	`onHandoff` registra a delegação a um subagente como transbordo entre agentes, quando os hooks são criados para uma conversa fixa

A conversa vem do contexto da operação (context: { niadra: convo } em generateText ou streamText), ou é fixa quando você passa session ao criar os hooks.

Exemplo mínimo

import { Agent } from "@voltagent/core";
import { openai } from "@ai-sdk/openai";
import { Niadra, handles } from "@niadra/sdk";
import { niadraHooks, niadraTools } from "@niadra/sdk/voltagent";

const niadra = new Niadra();
const support = new Agent({
  name: "support",
  instructions: "You are Acme's support agent.",
  model: openai("gpt-4.1"),
  hooks: niadraHooks(),
});

const convo = niadra.conversation({ subject: handles.appUserId(user.id), channel: "web_chat", conversation_id: chatId });
const { text } = await support.generateText("Where is my replacement?", {
  context: { niadra: convo },
  tools: niadraTools(convo),
});

Memória do agente

niadraHooks({ 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 VoltAgent 2.x roda sobre o AI SDK 6; o adaptador o acompanha.
Quando o nome do modelo não diz o provedor, passe provider na opção dos hooks para o uso do turno do agente.
Nada aqui para o agente: com a Niadra lenta ou fora, as mensagens vão ao modelo como vieram.
Testado contra @voltagent/core 2.10.0 com um Agent real sobre um modelo de teste 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

Vercel AI SDK

Navegação do histórico

​Instalar

​As cinco primitivas

​Exemplo mínimo

​Memória do agente

​Limites

​Próximos passos

Vercel AI SDK

Navegação do histórico

Instalar

As cinco primitivas

Exemplo mínimo

Memória do agente

Limites

Próximos passos