Skip to content

notebooks/agent_memory: default support assistant to OpenAI embeddings #216

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
WSPluta merged 1 commit into from
Jul 7, 2026
+153 −79
Merged

notebooks/agent_memory: default support assistant to OpenAI embeddings #216

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 8 additions & 8 deletions notebooks/agent_memory/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -38,14 +38,14 @@ The notebooks in this folder use the [`oracleagentmemory`](https://www.oracle.co

## Notebooks

| # | Name | Description | Framework | Open Notebook | Open in Colab |
| --- | -------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 01 | Deep Research Agent | Build a deep research agent for human genome exploration that uses Tavily for live web search and stores running conversation + durable findings in Oracle AI Database. Demonstrates the OpenAI Agents SDK `Session` protocol implemented against an Oracle-backed memory store. | OpenAI Agents SDK · Tavily · OAMP | [![Open Notebook](https://img.shields.io/badge/Open%20Notebook-orange?style=flat-square)](./01_deep_research_openai_agents.ipynb) | [![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/oracle-devrel/oracle-ai-developer-hub/blob/main/notebooks/agent_memory/01_deep_research_openai_agents.ipynb) |
| 02 | Supply Chain Assistant | A supply chain assistant that tracks and updates shipment cargo through in-process tools and an MCP server. Uses Oracle AI Agent Memory to persist shipment records, operational notes, and conversation history across restarts. | Claude Agent SDK · MCP · OAMP | [![Open Notebook](https://img.shields.io/badge/Open%20Notebook-orange?style=flat-square)](./02_supply_chain_claude_agent_sdk.ipynb) | [![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/oracle-devrel/oracle-ai-developer-hub/blob/main/notebooks/agent_memory/02_supply_chain_claude_agent_sdk.ipynb) |
| 03 | Mortgage Approval Workflow | A deterministic mortgage approval workflow modeled as a `StateGraph` with prebuilt `create_agent` nodes. Uses Oracle AI Agent Memory so a workflow that fails mid-stage can resume from the last persisted state instead of restarting. | LangGraph · OAMP | [![Open Notebook](https://img.shields.io/badge/Open%20Notebook-orange?style=flat-square)](./03_mortgage_workflow_langgraph.ipynb) | [![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/oracle-devrel/oracle-ai-developer-hub/blob/main/notebooks/agent_memory/03_mortgage_workflow_langgraph.ipynb) |
| 04 | OAMP Benchmarks | Quantifies the practical benefits of Oracle AI Agent Memory over naive flat-history memory along three axes: token consumption per turn, wall-clock latency, and response quality (LLM-as-a-judge). Runs the same 80-turn scripted conversation through three agents. | OAMP · LiteLLM · OpenAI | [![Open Notebook](https://img.shields.io/badge/Open%20Notebook-orange?style=flat-square)](./oracle_agent_memory_benchmarks.ipynb) | [![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/oracle-devrel/oracle-ai-developer-hub/blob/main/notebooks/agent_memory/oracle_agent_memory_benchmarks.ipynb) |
| 05 | OAMP Developer Guide | A hands-on, step-by-step guide to the `oracleagentmemory` package. Builds an agent memory system from scratch — connection, the three primitives (users/agents, memories, threads), manual vs. automatic LLM-powered extraction, vector search, context cards, and scoping. | OAMP · LiteLLM | [![Open Notebook](https://img.shields.io/badge/Open%20Notebook-orange?style=flat-square)](./oracle_agent_memory_developer_guide.ipynb) | [![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/oracle-devrel/oracle-ai-developer-hub/blob/main/notebooks/agent_memory/oracle_agent_memory_developer_guide.ipynb) |
| 06 | Support Assistant Copilot | An end-to-end customer-support copilot that follows one damaged-delivery case from setup through knowledge ingestion, agent tool use, context-card compaction, preference correction, cross-user isolation, TTL/retention, and teardown. Demonstrates background extraction, hybrid search, metadata inheritance and filtering, in-database embeddings, and chunked semantic indexing. | OpenAI Agents SDK · OAMP | [![Open Notebook](https://img.shields.io/badge/Open%20Notebook-orange?style=flat-square)](./oamp_support_assistant_example.ipynb) | [![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/oracle-devrel/oracle-ai-developer-hub/blob/main/notebooks/agent_memory/oamp_support_assistant_example.ipynb) |
| # | Name | Description | Framework | Open Notebook | Open in Colab |
| --- | -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 01 | Deep Research Agent | Build a deep research agent for human genome exploration that uses Tavily for live web search and stores running conversation + durable findings in Oracle AI Database. Demonstrates the OpenAI Agents SDK `Session` protocol implemented against an Oracle-backed memory store. | OpenAI Agents SDK · Tavily · OAMP | [![Open Notebook](https://img.shields.io/badge/Open%20Notebook-orange?style=flat-square)](./01_deep_research_openai_agents.ipynb) | [![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/oracle-devrel/oracle-ai-developer-hub/blob/main/notebooks/agent_memory/01_deep_research_openai_agents.ipynb) |
| 02 | Supply Chain Assistant | A supply chain assistant that tracks and updates shipment cargo through in-process tools and an MCP server. Uses Oracle AI Agent Memory to persist shipment records, operational notes, and conversation history across restarts. | Claude Agent SDK · MCP · OAMP | [![Open Notebook](https://img.shields.io/badge/Open%20Notebook-orange?style=flat-square)](./02_supply_chain_claude_agent_sdk.ipynb) | [![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/oracle-devrel/oracle-ai-developer-hub/blob/main/notebooks/agent_memory/02_supply_chain_claude_agent_sdk.ipynb) |
| 03 | Mortgage Approval Workflow | A deterministic mortgage approval workflow modeled as a `StateGraph` with prebuilt `create_agent` nodes. Uses Oracle AI Agent Memory so a workflow that fails mid-stage can resume from the last persisted state instead of restarting. | LangGraph · OAMP | [![Open Notebook](https://img.shields.io/badge/Open%20Notebook-orange?style=flat-square)](./03_mortgage_workflow_langgraph.ipynb) | [![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/oracle-devrel/oracle-ai-developer-hub/blob/main/notebooks/agent_memory/03_mortgage_workflow_langgraph.ipynb) |
| 04 | OAMP Benchmarks | Quantifies the practical benefits of Oracle AI Agent Memory over naive flat-history memory along three axes: token consumption per turn, wall-clock latency, and response quality (LLM-as-a-judge). Runs the same 80-turn scripted conversation through three agents. | OAMP · LiteLLM · OpenAI | [![Open Notebook](https://img.shields.io/badge/Open%20Notebook-orange?style=flat-square)](./oracle_agent_memory_benchmarks.ipynb) | [![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/oracle-devrel/oracle-ai-developer-hub/blob/main/notebooks/agent_memory/oracle_agent_memory_benchmarks.ipynb) |
| 05 | OAMP Developer Guide | A hands-on, step-by-step guide to the `oracleagentmemory` package. Builds an agent memory system from scratch — connection, the three primitives (users/agents, memories, threads), manual vs. automatic LLM-powered extraction, vector search, context cards, and scoping. | OAMP · LiteLLM | [![Open Notebook](https://img.shields.io/badge/Open%20Notebook-orange?style=flat-square)](./oracle_agent_memory_developer_guide.ipynb) | [![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/oracle-devrel/oracle-ai-developer-hub/blob/main/notebooks/agent_memory/oracle_agent_memory_developer_guide.ipynb) |
| 06 | Support Assistant Copilot | An end-to-end customer-support copilot that follows one damaged-delivery case from setup through knowledge ingestion, agent tool use, context-card compaction, preference correction, cross-user isolation, TTL/retention, and teardown. Demonstrates background extraction, pluggable embeddings (OpenAI by default or an in-database ONNX model), vector search, metadata inheritance and filtering, and chunked semantic indexing. | OpenAI Agents SDK · OAMP | [![Open Notebook](https://img.shields.io/badge/Open%20Notebook-orange?style=flat-square)](./oamp_support_assistant_example.ipynb) | [![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/oracle-devrel/oracle-ai-developer-hub/blob/main/notebooks/agent_memory/oamp_support_assistant_example.ipynb) |

## Getting Started

Expand Down
Loading