Skip to content

docs: unify chat-interface page (single cBioPortalChat agent)#12200

Merged
inodb merged 6 commits into
masterfrom
unified-chat-interface-docs
Jun 8, 2026
Merged

docs: unify chat-interface page (single cBioPortalChat agent)#12200
inodb merged 6 commits into
masterfrom
unified-chat-interface-docs

Conversation

@inodb

@inodb inodb commented Jun 8, 2026

Copy link
Copy Markdown
Member

Summary

Through 2026-Q2 the chat interface exposed two separate agents (`cBioDBAgent` and `cBioNavigator`) that the user had to pick between. They've been merged into a single `cBioPortalChat` agent that has access to all of the original tools and routes work to them based on the question.

This PR updates docs/ai-integrations/chat-interface.md to reflect that:

  • Drop the "choose your agent" framing throughout.
  • Replace the cBioDBAgent / cBioNavigator example links with `?spec=cBioPortalChat` links, organized by the three categories the chat shows on the welcome screen (Explore Data / Navigate cBioPortal / Analyze Data).
  • Add a short note in the tips that statistical tests can't be run inside the chat — the agent returns summary data and points users at Group Comparison / R / Python instead. (Matches the new guardrail rolled out in Guard against silent query rewrites and fabricated statistics (#66, #68) cbioportal-mcp#71.)
  • Rewrite the Architecture section: one agent, multiple MCP tools (database + navigator), rather than two agents with separate stacks.
  • Add a short callout about the earlier two-agent prototype for users coming back after seeing the previous version.

Related

Test plan

  • Render the page locally (or in the deploy preview) and confirm:
    • All example links resolve to `?spec=cBioPortalChat` and click through to the live chat.
    • No remaining references to `cBioDBAgent` or `cBioNavigator` as separate user-facing choices.
    • The Architecture section reads sensibly without the per-agent breakdown.

🤖 Generated with Claude Code

Through 2026-Q2 the platform exposed two separate agents (cBioDBAgent
and cBioNavigator) that the user had to choose between. These have
been merged into a single cBioPortalChat agent with access to all of
the original tools.

- Drop the "choose your agent" framing throughout.
- Replace the cBioDBAgent / cBioNavigator example links with
  cBioPortalChat links, organized by the same three categories the
  chat interface shows on the welcome screen (Explore / Navigate /
  Analyze).
- Note in the tips that statistical tests cannot be run inside the
  chat — the agent returns summary data and points users to Group
  Comparison / R / Python.
- Rewrite the Architecture section: one agent, multiple MCP tools
  (database + navigator), rather than two agents with separate stacks.
- Add a short callout about the earlier two-agent prototype for users
  who saw the previous version.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Copilot AI review requested due to automatic review settings June 8, 2026 19:20

Copilot AI 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.

Pull request overview

Updates the Chat Interface documentation to reflect the move from a two-agent user-facing experience (cBioDBAgent / cBioNavigator) to a single unified cBioPortalChat agent that routes requests to the appropriate MCP tooling internally.

Changes:

  • Reframes the docs to remove “choose your agent” language and introduces the unified cBioPortalChat agent.
  • Replaces legacy example links with spec=cBioPortalChat, grouped by the chat welcome categories (Explore Data / Navigate cBioPortal / Analyze Data).
  • Rewrites the Architecture section to describe one agent using multiple MCP servers (database + navigator), and adds updated usage tips.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread docs/ai-integrations/chat-interface.md Outdated
Comment thread docs/ai-integrations/chat-interface.md Outdated
Comment thread docs/ai-integrations/chat-interface.md Outdated
Comment thread docs/ai-integrations/chat-interface.md Outdated
Comment thread docs/ai-integrations/chat-interface.md Outdated
inodb and others added 5 commits June 8, 2026 16:40
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
@inodb inodb merged commit c7614bf into master Jun 8, 2026
15 of 16 checks passed
@inodb inodb deleted the unified-chat-interface-docs branch June 8, 2026 20:42
@sonarqubecloud

sonarqubecloud Bot commented Jun 8, 2026

Copy link
Copy Markdown

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants