Pular para o conteúdo principal
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 está no @niadra/sdk no npm.

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.

Registros de turno

Com a funcionalidade turns ligada no espaço (ela vem ligada), os RunHooks de Python com turns=True e os ganchos de JavaScript com turns: true gravam cada execução como um registro de turno, com cada chamada de ferramenta pelo id do provedor e cada chamada de modelo com os tokens; um handoff abre um subturno. Os ganchos do OpenAI Agents JS não param uma ferramenta, então envolva as ferramentas com Niadra.tool() para um replay respondê-las do registro; em Python, as FunctionTools respondem do registro. Um turno nunca espera pela Niadra e nunca repete o texto da conversa.

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.