Saltar a contenido

Las páginas sin traducir se abren en inglés y se indican como inglés.

Esta página es una traducción automática de la página en inglés, que prevalece. Machine-translated from the English page, which is authoritative.

Sesiones de conversación de OpenAI Agents

LoomSession implementa las interfaces de sesión nativas de Python y TypeScript sobre las memorias episódicas de Loom. Las herramientas existentes pueden conservar por separado hechos más allá de una conversación. Los paquetes de los frameworks siguen siendo dependencias opcionales.

Cada elemento es una llamada a memory.set con su JSON nativo, una clave formada por marca de tiempo y valor aleatorio, el usuario final y una sesión derivada del usuario y del id de sesión nativo. Las escrituras puntuales omiten la coalescencia del SDK, de modo que los elementos repetidos y concurrentes permanecen separados. Las filas episódicas conservan los elementos repetidos sin extracción semántica ni fusión de duplicados. Python y TypeScript usan prefijos de sesión derivada distintos porque sus formatos de elemento nativos son diferentes.

Las lecturas paginan mediante memory.list, eliminan duplicados de claves solapadas y completan los valores ausentes o truncados con memory.get. Los elementos se devuelven en orden de clave, y un límite solicitado conserva los elementos más recientes. Las lecturas con límite positivo también recorren el historial, porque los tiempos de llegada al servidor no pueden acotar las claves generadas por el escritor. El adaptador de TypeScript captura el usuario validado en el momento de la construcción. Sus cargas de bytes nativas de imagen y archivo usan arreglos JSON en el almacenamiento y se devuelven como Uint8Array; el JSON ordinario y la información de medios no cambian. La eliminación incluye el usuario y la sesión derivada: pop_item elimina el último elemento y clear_session elimina el historial listado. Las adiciones o limpiezas concurrentes son operaciones individuales del servidor, no una transacción sobre la conversación. Si un elemento desaparece antes de completarse, la lectura falla en lugar de devolver un elemento nativo incompleto. Las claves usan los relojes de los escritores; los escritores concurrentes no comparten una secuencia del servidor.

Puntos de entrada del código fuente

  • sdk/python/loom/integrations/openai_agents.py: LoomSession.
  • sdk/typescript/src/integrations/openai-agents.ts: LoomSession.

Invariantes

La organización, el espacio de nombres y el nombre del agente delimitan cada historial. Si se omite el usuario, se escriben filas compartidas del espacio de nombres; un usuario explícito selecciona el historial de ese usuario. El servidor aporta la procedencia del actor y de la fuente. Se aplican las reglas habituales de eliminación de memoria, borrado y actualización progresiva. No se añade ninguna base de datos de historial local ni esquema.