Skip to main content
NiadraADK entrega before_model (injeta o contexto), after_model (registra a resposta) e tools (o kit do histórico como BaseTools do ADK). Em TypeScript, niadraAdk({ session }) devolve os dois callbacks e as ferramentas para o ADK para TypeScript.

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/google_adk_agent.py.

Em TypeScript

niadraAdk({ session }) serve a uma definição de agente para todas as sessões do ADK: session é uma conversa fixa ou uma função do contexto (userId, sessionId, state), chamada uma vez por id de sessão do ADK. beforeModelCallback registra a mensagem do usuário de cada invocação uma vez e acrescenta o contexto depois da sua instrução em systemInstruction e o turn_block como parte de texto do último conteúdo do usuário; o ADK remonta o pedido a partir dos eventos da sessão a cada chamada, então nada disso entra na sessão. afterModelCallback registra a resposta final com o usageMetadata e uma chamada transfer_to_agent como transbordo entre agentes; respostas parciais (em stream) e chamadas de ferramenta não registram nada. tools declara os esquemas JSON do kit (parametersJsonSchema) e encontra o cliente no contexto da ferramenta, nunca nos argumentos do modelo. Dê o mesmo ...memory aos subagentes.

Memória do agente

NiadraADK(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

  • Se o agente já tem callbacks, passe listas: o ADK roda todos em ordem.
  • Nada aqui derruba a invocação: sem contexto, o pedido segue com a instrução do agente.
  • Testado contra google-adk 2.9 com o modelo substituído por um fake e a Niadra no emulador; em TypeScript, contra @google/adk 2.1.0, com um InMemoryRunner real e subagentes sobre um modelo roteirizado.

Próximos passos

Google GenAI

o wrap() do cliente, para quem não usa o ADK.

Navegação do histórico

as três ferramentas que o agente recebe.