Skip to main content
NiadraHooks é um HookProvider do Strands Agents: antes de cada chamada ao modelo ele põe o contexto no prompt de sistema e depois a restaura; tools traz o kit do histórico. Em TypeScript, NiadraPlugin é um plugin do Strands Agents para TypeScript. Serve a quem já está na AWS.

Instalar

A integração em TypeScript 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

Exemplo mínimo

O mesmo código está em examples/strands_agent.py.

Em TypeScript

new NiadraPlugin(convo) entra em plugins do Agent: um middleware de entrada do InvokeModelStage registra a mensagem mais nova do cliente uma vez, acrescenta o contexto depois do seu prompt de sistema e dobra o turn_block na última mensagem do usuário (mantendo o ponto de cache antes dele, como o injetor de contexto do próprio Strands faz), sem tocar em agent.messages; um middleware de saída registra a resposta final com o uso do modelo (Bedrock e Anthropic contam os tokens em cache à parte; os outros, dentro); getTools() dá o kit quando a sessão é fixa. O plugin recebe a conversa ou uma função do agente que a encontra a cada chamada.

Memória do agente

NiadraHooks(conversation, agent_memory=True) põe as notas do próprio agente antes do contexto do cliente e acrescenta as duas ferramentas. Veja Memória do agente.

Limites

  • O MemoryStore do Strands guarda a sessão do próprio agente; a Niadra não é esse armazenamento, então entra por hooks, ao lado de qualquer gerenciador de sessão que você use.
  • Nada aqui derruba a invocação: sem contexto, o prompt de sistema segue como você o escreveu.
  • O Strands para TypeScript exige Node 22 ou mais novo.
  • Testado contra strands-agents 1.57 com o modelo substituído por um fake e a Niadra no emulador; em TypeScript, contra @strands-agents/sdk 1.19.0, com um Agent real pelo adaptador de modelo do AI SDK.

Próximos passos

Amazon Bedrock

o wrap() da API Converse, para quem chama o Bedrock direto.

Agentes internos

tarefas, objetos e ações que fecham pendências.