Skip to main content
Em Python, NiadraAgentsMemory entrega run_config() (o filtro que injeta o contexto antes de cada chamada ao modelo), hooks (que registram os turnos) e tools. Em JavaScript, @niadra/sdk/openai-agents traz NiadraSession, niadraInstructions(), niadraTools() e niadraRunHooks().

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/openai_agents_run.py e examples/openai-agents.ts.

Memória do agente

Em Python, agent_memory=True (ou {"write": True, "max_tokens": 300, "tags": [...]}) põe as notas do próprio agente depois das instruções e antes do contexto do cliente, e search_agent_memory (e remember, com write) entram em tools. Em JavaScript, agentMemory nas opções. Veja Memória do agente.

Limites

  • O adaptador em Python não implementa a Session do SDK: uma Session guarda os itens do próprio agente, e a Niadra guarda memória derivada, não uma cópia de cada item. Use qualquer Session ao lado dele. Em JavaScript, NiadraSession embrulha a sessão que você escolher.
  • Nada aqui derruba um run: a Niadra lenta ou fora deixa as instruções só suas.
  • Em Python, o extra openai-agents fixa versões incompatíveis com livekit, crewai e litellm; instale um por ambiente.
  • Testado contra openai-agents 0.22.3 e @openai/agents 0.18.0 com o modelo substituído por um fake e a Niadra no emulador.

Próximos passos

Navegação do histórico

as três ferramentas que o agente recebe.

OpenAI e Azure OpenAI

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