Uso de la Memoria de Oracle Agent con Codex

Los agentes de codificación suelen comenzar una tarea sin las decisiones, convenciones del repositorio, notas de arquitectura y lecciones de solución de problemas detectadas en sesiones anteriores. La reconstrucción de ese contexto a partir de los archivos de origen y el historial de chat cuesta tiempo, dinero y puede provocar cambios incoherentes.

El plugin de Oracle AI Agent Memory para Codex (actualmente ChatGPT Work) proporciona a Codex memoria de proyecto persistente. Codex puede buscar conocimientos previos antes de un trabajo sustancial, agregar hechos duraderos concisos para una sesión posterior y, cuando se activa explícitamente, capturar peticiones de datos de usuario y respuestas finales del asistente en el subproceso de memoria actual.

Esta guía empaqueta el plugin existente del Codex como un mercado local descargable y recorre ambos roles necesarios para usarlo:

Advertencia: el servidor MCP incluido es un despliegue de referencia y aprendizaje. Utiliza un JWT secreto compartido y su configuración por defecto sirve HTTP sin formato en la computadora local. Revise y adapte la autenticación, la seguridad del transporte, el almacenamiento de credenciales, el ciclo de vida de los tokens, la autorización y la observabilidad antes de utilizarla más allá de un entorno de confianza.

Descargar el plugin

Descargue el proyecto del plugin del Codex, codex_plugin.zip. El archivo se crea desde el directorio examples/codex_plugin del repositorio y contiene el manifiesto de plugin, la aptitud de memoria, la configuración de MCP, los enlaces y el servidor de referencia.

Extraiga en el ordenador donde va a ejecutar Codex. Lea el manifiesto de plugin, .mcp.json y hooks/hooks.json antes de instalarlo. Para conocer los conceptos generales del plugin y el comportamiento de la instalación, consulte la documentación del plugin de ChatGPT.

unzip codex_plugin.zip
cd codex_plugin

Comprender los componentes

El proyecto descargado tiene tres componentes de plugin y un servicio de administración:

El plugin toma por defecto el valor http://127.0.0.1:8000/mcp. Esto funciona cuando el administrador y el Codex se ejecutan en la misma computadora. Para un servicio gestionado por el administrador, cambie url en .mcp.json al punto final de MCP aprobado antes de distribuir o instalar el plugin.

Instalar los requisitos de Python

Los enlaces y el servidor MCP se ejecutan en diferentes entornos Python. Instale sus requisitos donde se ejecuten.

Entorno Bibliotecas necesarias
Python utilizado para lanzar Codex requests. El enlace de plugin llama al ejecutable python de ese entorno.
Python utilizado para ejecutar el servidor MCP de referencia oracleagentmemory, fastmcp, PyJWT y python-dotenv, además de la conectividad de Oracle AI Database y los proveedores de LLM y embebido configurados.

Por ejemplo, instale la dependencia de enlace en el entorno desde el que inicie Codex:

python -m pip install requests

Instale las dependencias del servidor de referencia en el entorno que iniciará el servidor:

python -m pip install oracleagentmemory fastmcp PyJWT python-dotenv

Para la configuración del SDK y la base de datos, consulte la Guía de configuración y Ejecute Oracle AI Database localmente.

Administrador: configurar el servidor MCP de memoria

El servidor lee su configuración de conexión, modelo y firma desde misc/.env. Copie la plantilla proporcionada y rellénela con valores para su entorno:

cp misc/.env.sample misc/.env
DB_USER="<database-user>"
DB_PASSWORD="<database-password>"
DB_CONNECT_STRING="<database-connect-string>"
EMBEDDER_MODEL_ID="<embedding-model-id>"
EMBEDDER_API_BASE="<embedding-api-base>"
EMBEDDER_API_KEY="<embedding-api-key>"
LLM_MODEL_ID="<llm-model-id>"
LLM_API_BASE="<llm-api-base>"
LLM_API_KEY="<llm-api-key>"
JWT_SECRET="<signing-secret>"

Genere el secreto de firma una vez, almacénelo de forma segura y coloque el valor en misc/.env. Se necesita el mismo secreto al emitir tokens de usuario.

export JWT_SECRET="$(openssl rand -hex 32)"

Inicie el servidor desde el directorio del plugin extraído:

python misc/remote_mcp_server.py \
  --host 127.0.0.1 --port 8000

Nota: Si el servidor es remoto, utilice el host y el puerto adecuados para ese despliegue y, a continuación, haga que su punto final coincida con la configuración .mcp.json del plugin.

Administrador: emitir un token de usuario

El servidor de referencia deriva el ámbito user_id y agent_id del token portador en lugar de aceptar esos valores del Codex. Cree un token para el contexto de usuario y agente que debe compartir la memoria. Exporte el mismo secreto de firma utilizado por el servidor y, a continuación, ejecute:

export JWT_SECRET="<same-signing-secret>"
python misc/create_token.py \
  --user-id "<user-id>" \
  --agent-id "<agent-id>"

Dar el token impreso al usuario del Codex previsto a través de un mecanismo de entrega secreta aprobado. Tratarlo como una credencial para el ámbito de memoria codificado en él. La duración del token de referencia y el enfoque de firma son comportamientos de ejemplo, no una política de gestión de tokens de producción.

Usuario: instale el complemento en Codex

Desde el directorio del plugin extraído, agregue el marketplace local e instale el plugin:

codex plugin marketplace add .
codex plugin add oracle-ai-agent-memory@codex-oam

Inicie Codex con el token proporcionado por el administrador:

OAM_MCP_TOKEN="<user-token>" codex

Ejecute /mcp y confirme que el servidor memory está disponible con las herramientas search y add. Estas herramientas funcionan sin captura automática.

Usuario: si lo desea, active la captura automática de sesiones

Los enlaces del plugin envían cada petición de datos de usuario enviada y la respuesta final del asistente al servidor MCP de memoria. Después de instalar y reiniciar Codex, ejecute /hooks, inspeccione los enlaces UserPromptSubmit y Stop de Oracle AI Agent Memory y confíe explícitamente en ellos solo si desea ese comportamiento. Para obtener información detallada sobre el comportamiento y la configuración de los enlaces, consulte la documentación de enlaces de ChatGPT.

Dejar los ganchos sin confianza desactiva la captura automática, pero no impide que Codex busque o agregue memoria a través de las herramientas de MCP.

Conclusión

En esta guía hemos aprendido a descargar e instalar el plugin Oracle AI Agent Memory Codex, configurar su servidor MCP de referencia, emitir un token de usuario con ámbito y, opcionalmente, capturar mensajes de sesión. Codex ahora puede buscar un contexto de proyecto duradero y guardar conocimientos reutilizables para sesiones de codificación posteriores.

→ Después de haber aprendido a utilizar la memoria del agente de Oracle con Codex, puede que también le interese Usar memoria del agente con un servidor MCP.