Skip to content

add Companion catalog tutorial, CMEM-8423 - #315

Merged
rpietzsch merged 4 commits into
mainfrom
feature/docu-tutorial-for-new-companion-module-CMEM-8423
Nov 19, 2026
Merged

rpietzsch merged 4 commits into
mainfrom
feature/docu-tutorial-for-new-companion-module-CMEM-8423

Conversation

@annamakor

@annamakor annamakor commented Nov 17, 2026 •

Copy link
Copy Markdown
Contributor

New tutorial that builds a catalog with a minimal agent network on the product data: the task agent supplier_lookup, the interactive agent procurement_advisor and the skill /cheapest_supplier.

Depends on #314 — this branch contains the new Companion section structure. Merge #314 first; the diff of this PR shrinks to the tutorial afterwards.

  • link the tutorial from the Companion foundations and management pages
  • add the tutorial to the Companion navigation

Verified against CMEM v26.2.3-354 (release_26.3.0).

New tutorial that builds a catalog with a minimal agent network on the
product data: the task agent supplier_lookup, the interactive agent
procurement_advisor and the skill /cheapest_supplier.

- link the tutorial from the Companion AI chat page
- add the tutorial to the navigation

Verified against CMEM v26.2.3-354 (release_26.3.0).
@github-actions

github-actions Bot commented Nov 17, 2026 •

Copy link
Copy Markdown

Markdown lint

0 tests   0 ✅  0s ⏱️
0 suites  0 💤
1 files    0 ❌

Results for commit 63d87d6.

♻️ This comment has been updated with latest results.

…odule-CMEM-8421' into feature/docu-tutorial-for-new-companion-module-CMEM-8423

Move the tutorial into the new Companion section structure: add it to
the section navigation, link it from the foundations and management
pages, and align its prerequisites with the Access section.
@annamakor
annamakor requested a review from rpietzsch November 17, 2026 13:30

@annamakor annamakor left a comment

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Catalog wording is outdated against the current 26.3 build

Checked on Explore v26.2.3-354 (release_26.3.0). The catalog was reworked into
defaults + overlay, so several statements no longer match the UI:

management/index.md

  • L87, warning: the button is now Reset to the defaults, not Reset to the shipped catalog.
    What it removes exactly (overlay only, or also the owl:imports) still needs checking before the warning is rewritten.
  • L169–170, Save changes: the catalog is no longer "not stored → shipped catalog is served → first save writes it".
    The status now reads: "No overlay is stored in the main catalog. The defaults of this version apply as they are,
    until the first save changes one of them."
    A save stores only the changes to the defaults (the overlay).
  • Catalogs, action list: Disable is missing. It sits between Export and Import.
  • companion-management-catalog.png: shows the old UI. The main catalog was labeled Companion Catalog,
    and the screenshot still has Reset to the shipped catalog and the "not stored yet" message.
    Today the main catalog is labeled Default Companion Catalog Overlay, and the catalog selector on Agents and
    Skills shows Default Companion Catalog Overlay (main).

index.md (foundations), Catalog

  • L86: "Until the catalog is saved for the first time, the Companion uses the catalog shipped with
    Corporate Memory" is outdated in the same way.
  • L83–84: the merge rule could follow the UI's own explanation: "The companion starts from the defaults
    of this version. The main companion catalog holds what this installation changed on them, its overlay,
    and imports the additional catalogs. What runs is everything merged into one effective catalog: the
    defaults with the overlay win every collision, and an additional catalog adds only what is still free."

Also fixed in this build: Add a new catalog no longer fails on a fresh installation (201, "created and
imported into the main catalog").

The tutorial in #315 already uses the new labels.

annamakor and others added 2 commits November 19, 2026 09:44
…-8423

- add the add icon and "in the header" to the Add a new catalog/agent/skill steps
- name the header as location of Save changes
- name the Catalogs, Agents and Skills tabs as tabs

@rpietzsch rpietzsch left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks good to me. checked in serve and preview.

@rpietzsch
rpietzsch merged commit e75dcfc into main Nov 19, 2026
2 checks passed
@rpietzsch
rpietzsch deleted the feature/docu-tutorial-for-new-companion-module-CMEM-8423 branch November 19, 2026 09:51
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Development

Successfully merging this pull request may close these issues.

2 participants