Usa memoria agente Oracle con Codex

Gli agenti di codifica spesso iniziano un'attività senza le decisioni, le convenzioni del repository, le note sull'architettura e le lezioni di risoluzione dei problemi scoperte nelle sessioni precedenti. Ricostruire tale contesto dai file sorgente e dalla cronologia delle chat costa tempo, denaro e può portare a cambiamenti incoerenti.

Il plugin Oracle AI Agent Memory per Codex (ora ChatGPT Work) fornisce memoria di progetto persistente Codex. Codex può cercare le conoscenze precedenti prima di un lavoro sostanziale, aggiungere fatti duraturi concisi per una sessione successiva e, quando esplicitamente abilitato, acquisire i prompt utente e le risposte dell'assistente finale nel thread di memoria corrente.

Questa guida include il plugin Codex esistente come marketplace locale scaricabile e guida entrambi i ruoli necessari per utilizzarlo:

Avvertenza: il server MCP incluso è una distribuzione di apprendimento e riferimento. Utilizza un JWT condiviso-segreto e la sua configurazione predefinita serve HTTP semplice sul computer locale. Rivedere e adattare l'autenticazione, la sicurezza del trasporto, lo storage delle credenziali, il ciclo di vita del token, l'autorizzazione e l'osservabilità prima di utilizzarla oltre un ambiente sicuro.

Scarica il plugin

Scarica il progetto del plugin Codex, codex_plugin.zip. L'archivio viene creato dalla directory examples/codex_plugin del repository e contiene il file manifesto del plugin, la capacità di memoria, la configurazione MCP, gli hook e il server di riferimento.

Estrarlo sul computer in cui verrà eseguito Codex. Leggere il file manifesto del plugin, .mcp.json e hooks/hooks.json prima di installarlo. Per informazioni sui concetti generali relativi ai plugin e sul comportamento dell'installazione, vedere la documentazione relativa al plugin ChatGPT.

unzip codex_plugin.zip
cd codex_plugin

Comprendere i componenti

Il progetto scaricato include tre componenti plugin e un servizio gestito dall'amministratore:

Per impostazione predefinita, il plugin è http://127.0.0.1:8000/mcp. Funziona quando l'amministratore e il Codex vengono eseguiti sullo stesso computer. Per un servizio gestito dall'amministratore, modificare url in .mcp.json nell'endpoint MCP approvato prima di distribuire o installare il plugin.

Installare i requisiti Python

Gli hook e il server MCP vengono eseguiti in ambienti Python diversi. Installare i requisiti in cui vengono eseguiti.

Ambiente Librerie obbligatorie
Python utilizzato per avviare Codex requests. L'hook del plugin richiama l'eseguibile python dell'ambiente.
Python utilizzato per eseguire il server MCP di riferimento oracleagentmemory, fastmcp, PyJWT e python-dotenv, oltre alla connettività di Oracle AI Database e ai provider di incorporamento e LLM configurati.

Ad esempio, installare la dipendenza da hook nell'ambiente da cui si avvia Codex:

python -m pip install requests

Installare le dipendenze del server di riferimento nell'ambiente che avvierà il server:

python -m pip install oracleagentmemory fastmcp PyJWT python-dotenv

Per la configurazione di SDK e database, vedere Setup Guide e Run Oracle AI Database localmente.

Administrator: configurare il server MCP di memoria

Il server legge la configurazione di connessione, modello e firma da misc/.env. Copiare il modello fornito e inserirlo con i valori per l'ambiente in uso:

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>"

Generare il segreto di firma una sola volta, memorizzarlo in modo sicuro e inserire il valore in misc/.env. Lo stesso segreto è obbligatorio quando si emettono i token utente.

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

Avviare il server dalla directory del plugin estratto:

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

Nota: se il server è remoto, utilizzare l'host e la porta appropriati per la distribuzione, quindi impostare l'endpoint corrispondente alla configurazione .mcp.json del plugin.

Amministratore: emettere un token utente

Il server di riferimento deriva l'ambito user_id e agent_id dal token bearer invece di accettare tali valori da Codex. Creare un token per il contesto utente e agente che deve condividere la memoria. Esportare lo stesso segreto di firma utilizzato dal server, quindi eseguire:

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

Fornire il token stampato all'utente Codex previsto tramite un meccanismo di consegna del segreto approvato. Considera come credenziale per l'ambito di memoria codificato in esso. La durata del token di riferimento e l'approccio di firma sono un comportamento di esempio, non un criterio di gestione del token di produzione.

Utente: installa il plugin in Codex

Dalla directory del plugin estratto, aggiungere il marketplace locale e installare il plugin:

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

Avviare il Codex con il token fornito dall'amministratore:

OAM_MCP_TOKEN="<user-token>" codex

Eseguire /mcp e confermare che il server memory è disponibile con gli strumenti search e add. Questi strumenti funzionano senza cattura automatica.

Utente: facoltativamente, abilitare l'acquisizione automatica delle sessioni

Gli hook del plugin inviano ogni prompt utente inviato e la risposta dell'assistente finale al server MCP di memoria. Dopo aver installato e riavviato Codex, eseguire /hooks, ispezionare gli hook di Oracle AI Agent Memory UserPromptSubmit e Stop e fidarli esplicitamente solo se si desidera tale comportamento. Per informazioni sul comportamento degli hook e sui dettagli di configurazione, vedere la documentazione sugli hook di ChatGPT.

Lasciare i ganci non attendibili disabilita l'acquisizione automatica, ma non impedisce al Codex di cercare o aggiungere memoria tramite gli strumenti MCP.

Conclusione

In questa guida è stato illustrato come scaricare e installare il plugin Oracle AI Agent Memory Codex, configurare il server MCP di riferimento, emettere un token utente definito e, facoltativamente, acquisire i messaggi di sessione. Codex ora può cercare il contesto di progetto permanente e salvare le conoscenze riutilizzabili per le sessioni di codifica successive.

→ Dopo aver appreso come utilizzare la memoria dell'agente Oracle con Codex, potrebbe interessarti anche Utilizzare la memoria dell'agente con un server MCP.