As páginas sem tradução abrem em inglês e são identificadas como inglês.
Esta página é uma tradução automática da página em inglês, que prevalece. Machine-translated from the English page, which is authoritative.
Sessões de conversa do OpenAI Agents
LoomSession implementa as interfaces de sessão nativas de Python e TypeScript sobre
memórias episódicas do Loom. Ferramentas existentes podem reter fatos além de uma
conversa de forma separada. Os pacotes de framework continuam sendo dependências opcionais.
Cada item corresponde a uma chamada memory.set com seu JSON nativo, uma chave composta por
timestamp e valor aleatório, o usuário final e uma sessão derivada do usuário e do id de sessão
nativo. As gravações pontuais ignoram a coalescência do SDK, de modo que itens repetidos e
concorrentes permanecem separados. As linhas episódicas preservam itens repetidos sem extração
semântica nem mesclagem de duplicatas. Python e TypeScript usam prefixos de sessão derivada
distintos, porque seus formatos de item nativos são diferentes.
As leituras paginam por memory.list, eliminam chaves sobrepostas duplicadas e recuperam valores
ausentes ou truncados com memory.get. Os itens são retornados na ordem das chaves, e um limite
solicitado mantém os itens mais recentes. Leituras com limite positivo também varrem o histórico,
porque os horários de chegada no servidor não conseguem delimitar chaves geradas pelo escritor. O
adaptador TypeScript captura o usuário validado no momento da construção. Seus payloads nativos de
bytes de imagem e arquivo usam arrays JSON no armazenamento e retornam como Uint8Array; o JSON
comum e as informações de mídia permanecem inalterados. A exclusão carrega o usuário e a sessão
derivada: pop_item exclui o item mais recente e clear_session exclui o histórico listado.
Acréscimos ou limpezas concorrentes são operações individuais no servidor, e não uma transação
sobre a conversa.
Se um item desaparecer antes da recuperação, a leitura falha em vez de retornar um item nativo
incompleto. As chaves usam os relógios dos escritores; escritores concorrentes não compartilham uma
sequência do servidor.
Pontos de entrada no código-fonte
sdk/python/loom/integrations/openai_agents.py:LoomSession.sdk/typescript/src/integrations/openai-agents.ts:LoomSession.
Invariantes
A organização, o namespace e o nome do agente delimitam cada histórico. Um usuário omitido grava linhas compartilhadas do namespace; um usuário explícito seleciona o histórico desse usuário. O servidor fornece a proveniência de ator e de origem. Aplicam-se as regras comuns de exclusão de memória, apagamento e atualização gradual (rolling upgrade). Nenhum banco de dados local de histórico nem esquema é adicionado.