Repository navigation
Memory and Oracle Database 26ai concept pages; Model providers page corrected; pill and nav colour fixes - #368
Merged
Merged
Conversation
…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>
Signed-off-by: Federico Kamelhar <federico.kamelhar@oracle.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Memory, exposed properly. New
docs/concepts/memory.mdexplains 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. Newdocs/concepts/oracle-26ai.mdis 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.mdandmemory-manager.mdnow lead with the Oracle option.Model providers page, fact-checked against the code. Cohere is never served by OCI's
/openai/v1(everycohere.*id is routed to the SDK transport), Mistral is not in the OCI catalog, prompt caching applies onstream()too (shared request builder), the notebook sentence names OCI, and the source link no longer pins a line number.providers/anthropic.mdfollows. 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
pong; thread resume viathread_id→Alice; cross-thread recall throughLLMMemoryManager→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.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.