Skip to content

Memory and Oracle Database 26ai concept pages; Model providers page corrected; pill and nav colour fixes - #368

Merged
fede-kamel merged 2 commits into
mainfrom
docs/memory-26ai-and-fixes
Oct 27, 2026
Merged

fede-kamel merged 2 commits into
mainfrom
docs/memory-26ai-and-fixes

Conversation

@fede-kamel

Copy link
Copy Markdown
Member

Summary

Memory, exposed properly. New docs/concepts/memory.md explains the four layers an agent remembers at — working memory (ConversationManager), the thread (checkpointer + thread_id), long-term memory (LLMMemoryManager / OracleAgentMemoryManager) and knowledge (RAG) — and shows each on Oracle Database 26ai. New docs/concepts/oracle-26ai.md is the hub for every 26ai primitive with the notebook that runs it. Both are in the nav (26ai right after Multi-agent shapes; Memory first in the Memory and RAG group) and linked from the home page and README. checkpointers.md and memory-manager.md now lead with the Oracle option.

Model providers page, fact-checked against the code. Cohere is never served by OCI's /openai/v1 (every cohere.* id is routed to the SDK transport), Mistral is not in the OCI catalog, prompt caching applies on stream() too (shared request builder), the notebook sentence names OCI, and the source link no longer pins a line number. providers/anthropic.md follows. Examples move to the current Anthropic id (claude-sonnet-5-5) across docs, examples and docstrings; the pricing table and the exact-match note are unchanged.

Site. Hero pill removed with its CSS; dark-mode nav section labels use the muted colour instead of the rose tint.

Verification

  • Examples on the memory page executed live against OCI Generative AI (gpt-5.5, eu-frankfurt-1): sliding window → pong; thread resume via thread_id → Alice; cross-thread recall through LLMMemoryManager → EUR. The original phrasing was not kept by the built-in heuristic extractor, which is why the sentence (and the memory-manager quick start) changed.
  • Notebooks 05 and 11 run green from the branch on OCI gpt-4.1.
  • Oracle Database 26ai examples are compile-checked and match the constructor signatures (inspect.signature) and notebooks 37–44; a live run needs an Autonomous Database (pending a compartment in the Frankfurt tenancy).
  • mkdocs build --strict, markdownlint, the doc-snippet checker, docs tests (100) and ruff clean; 711 unit tests covering every touched source module pass.

…s; provider page facts; nav, pill and colour fixes

New concept pages:
- docs/concepts/memory.md — working memory, the thread (checkpointers),
  long-term memory (memory managers) and knowledge (RAG) as four layers,
  each shown on Oracle Database 26ai. Examples executed against OCI
  Generative AI (gpt-5.5, Frankfurt): sliding window, thread resume via
  thread_id, cross-thread recall through LLMMemoryManager.
- docs/concepts/oracle-26ai.md — every 26ai primitive (OracleVectorStore,
  OracleADBLoader, OracleInDBChunker, OracleInDBEmbeddings,
  oracle_checkpointer, OracleCheckpointSaver, OracleStore,
  OracleAgentMemoryManager, the Sync twins), connection arguments and the
  notebook that runs each one. Linked from the home page, README, nav
  (after Multi-agent shapes) and the Memory and RAG group.
- checkpointers.md and memory-manager.md now lead with the Oracle
  Database 26ai option; the memory-manager quick-start sentence is one
  the built-in heuristic extractor actually keeps.

Model providers page, checked against the code:
- OCI tree: Cohere is never served by /openai/v1 (every cohere.* id goes
  through the SDK transport), Mistral is not in the OCI catalog, Google
  is; prompt caching applies to stream() as well as complete(); the
  notebook line names OCI; the registry source link no longer pins a
  line number. providers/anthropic.md follows (model table, caching).
- Examples use the current Anthropic id (claude-sonnet-5-5) across docs,
  examples and docstrings; AnthropicModel's docstring names the Claude 5
  family. Pricing table and the exact-match note are untouched.

Site:
- The hero's "Oracle Generative AI | Agentic Harness" pill and its CSS are
  removed (the header lockup already says it).
- Dark-mode nav section labels use the same muted colour as light mode
  instead of the rose tint.

Signed-off-by: Federico Kamelhar <federico.kamelhar@oracle.com>
@oracle-contributor-agreement oracle-contributor-agreement Bot added the OCA Verified All contributors have signed the Oracle Contributor Agreement. label Oct 27, 2026
Signed-off-by: Federico Kamelhar <federico.kamelhar@oracle.com>
@fede-kamel
fede-kamel merged commit cdc153e into main Oct 27, 2026
16 checks passed
@fede-kamel
fede-kamel deleted the docs/memory-26ai-and-fixes branch October 27, 2026 21:13
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

OCA Verified All contributors have signed the Oracle Contributor Agreement.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant