使用 Oracle 代理程式記憶體搭配 Codex

編碼代理程式通常會開始一項工作，而不會出現先前階段作業中發現的決策、儲存區域慣例、架構注意事項和疑難排解課程。從來源檔案和交談歷史記錄重新建構該相關資訊環境會花費時間、金錢，並可能導致變更不一致。

Codex (現為 ChatGPT Work) 的 Oracle AI Agent Memory 外掛程式提供 Codex 持續性專案記憶體。Codex 可在實際工作之前先搜尋相關知識、為後續階段作業新增簡潔的持久性事實，並在明確啟用時，擷取目前記憶體執行緒中的使用者提示和最終輔助程式回覆。

本指南將現有的 Codex 外掛程式封裝為可下載的本機市集，並逐步說明使用該外掛程式所需的兩個角色：

警告：內含的 MCP 伺服器是學習和參照部署。它使用共用機密 JWT，其預設組態在本機電腦上提供純 HTTP。在信任的環境之外使用驗證、傳輸安全、證明資料儲存、記號生命週期、授權以及可觀察性之前，請先加以複查及調整。

下載外掛程式

下載 Codex Plugin 專案 codex_plugin.zip 。此歸檔是從儲存庫的 examples/codex_plugin 目錄建立的，包含外掛程式清單、記憶體技巧、MCP 配置、鉤點和參考伺服器。

將它解壓縮到您要執行 Codex 的電腦上。請先閱讀外掛程式清單 .mcp.json 和 hooks/hooks.json，再進行安裝。如需一般的外掛程式概念和安裝行為，請參閱 ChatGPT 外掛程式文件。

unzip codex_plugin.zip
cd codex_plugin

瞭解元件

下載的專案有三個 Plugin 元件和一個管理員執行服務：

Plugin 預設為 http://127.0.0.1:8000/mcp。當管理員和 Codex 在同一部電腦上執行時，便可使用此功能。如果是管理員管理的服務，請先將 .mcp.json 中的 url 變更為核准的 MCP 端點，再分配或安裝 Plugin。

安裝 Python 需求

鉤點和 MCP 伺服器會在不同的 Python 環境中執行。在執行需求的位置安裝需求。

環境 必要的程式庫
用來啟動 Codex 的 Python requests. Plugin 掛載會呼叫該環境的 python 執行檔。
用來執行參照 MCP 伺服器的 Python oracleagentmemory、fastmcp、PyJWT 和 python-dotenv，加上 Oracle AI Database 連線，以及已設定的內嵌和 LLM 提供者。

例如，在啟動 Codex 的環境中安裝 hook 相依性：

python -m pip install requests

在將啟動伺服器的環境中安裝參照伺服器相依性：

python -m pip install oracleagentmemory fastmcp PyJWT python-dotenv

如需 SDK 和資料庫設定，請參閱設定指南和在本機執行 Oracle AI Database 。

管理員：設定記憶體 MCP 伺服器

伺服器會從 misc/.env 讀取其連線、模型及簽署組態。複製提供的樣板，並使用您環境的值填入樣板：

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

只要產生一次簽署加密密碼，即可安全地儲存加密密碼，並將值放在 misc/.env。發出使用者權杖時，必須提供相同的加密密碼。

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

從解壓縮的外掛程式目錄啟動伺服器：

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

注意：如果伺服器為遠端伺服器，請使用適合該部署的主機和連接埠，然後讓其端點符合 Plugin 的 .mcp.json 組態。

管理員：發出使用者權杖

參照伺服器會從 Bearer 權杖衍生 user_id 和 agent_id 範圍，而不是接受來自 Codex 的值。為應共用記憶體的使用者和代理程式相關資訊環境建立權杖。匯出伺服器使用的相同簽署加密密碼，然後執行：

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

透過核准的加密密碼傳遞機制，將列印的權杖提供給預期的 Codex 使用者。將它視為其中編碼之記憶體範圍的證明資料。參照記號存留時間和簽署方法為範例行為，而非生產權杖管理原則。

使用者：在 Codex 安裝外掛程式

從擷取的外掛程式目錄中，新增本機市集並安裝外掛程式：

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

使用管理員提供的記號啟動 Codex：

OAM_MCP_TOKEN="<user-token>" codex

執行 /mcp，並確認 memory 伺服器可以使用 search 和 add 工具。這些工具不需自動擷取即可運作。

使用者：選擇性啟用自動階段作業擷取

Plugin 的掛載會將每個送出的使用者提示和最終輔助程式回覆傳送給記憶體 MCP 伺服器。安裝並重新啟動 Codex 之後，請執行 /hooks、檢查 Oracle AI Agent Memory UserPromptSubmit 與 Stop 鉤點，並明確信任只有在您想要執行該操作時才行。如需鉤點行為和組態詳細資訊，請參閱 ChatGPT 鉤點文件。

讓鉤點保持不受信任會停用自動擷取，但不會讓 Codex 透過 MCP 工具搜尋或新增記憶體。

結論

在本指南中，我們學會如何下載並安裝 Oracle AI Agent Memory Codex 外掛程式、設定其參照 MCP 伺服器、發出作用領域的使用者記號，以及選擇性地擷取階段作業訊息。Codex 現在可以搜尋持久的專案環境，並儲存可重複使用的知識，供日後編寫程式碼。

→ 瞭解如何搭配 Codex 使用 Oracle 代理程式記憶體之後，您可能也對使用代理程式記憶體搭配 MCP 伺服器感興趣。