Skip to content

docs: Add LLM profiles documentation#491

Open
VascoSch92 wants to merge 3 commits intomainfrom
docs/llm-profiles-documentation
Open

docs: Add LLM profiles documentation#491
VascoSch92 wants to merge 3 commits intomainfrom
docs/llm-profiles-documentation

Conversation

@VascoSch92
Copy link
Copy Markdown
Contributor

Summary

This PR adds documentation for the LLM profiles feature to the Language Model (LLM) Settings page.

Changes

Added a new "LLM Profiles" section that documents:

  • Creating LLM Profiles: How profiles are automatically created when saving LLM configurations, and how to manually add profiles
  • Managing LLM Profiles: How to edit, rename, delete, and set profiles as active from the settings page
  • Switching Profiles During a Conversation: How to switch between different LLM models mid-conversation using the profile selector button in the chat input area
  • How Profile Switching Works: Technical explanation of what happens when switching profiles (context preservation, metadata updates)
  • Best Practices: Tips for naming profiles, creating task-specific configurations, and testing after switching

Why This Change

The LLM profiles feature allows users to:

  • Save up to 10 different LLM configurations
  • Switch between models during active conversations without losing context
  • Use different models for different types of tasks (e.g., faster models for exploration, more powerful models for complex reasoning)

This powerful feature was not previously documented, making it difficult for users to discover and use effectively.

References

  • Frontend implementation: frontend/src/components/features/settings/llm-profiles-manager.tsx
  • Backend implementation: openhands/app_server/settings/llm_profiles.py
  • Conversation profile switching: openhands/app_server/app_conversation/app_conversation_router.py

This PR was created by an AI agent (OpenHands) on behalf of the user.

@VascoSch92 can click here to continue refining the PR

Document the LLM profiles feature that allows users to:
- Save multiple LLM configurations as named profiles
- Switch between profiles during active conversations
- Manage profiles (edit, rename, delete, set as active)

This feature enables users to leverage different models for different
tasks without losing conversation context.

Co-authored-by: openhands <openhands@all-hands.dev>
@mintlify
Copy link
Copy Markdown

mintlify Bot commented May 6, 2026

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
all-hands-ai 🟢 Ready View Preview May 6, 2026, 2:08 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.

@VascoSch92 VascoSch92 requested a review from all-hands-bot May 8, 2026 08:47
all-hands-bot

This comment was marked as outdated.

@VascoSch92 VascoSch92 marked this pull request as ready for review May 8, 2026 09:03
@VascoSch92 VascoSch92 requested a review from mamoodi as a code owner May 8, 2026 09:03
@VascoSch92 VascoSch92 requested a review from all-hands-bot May 8, 2026 09:04
Copy link
Copy Markdown
Contributor

@all-hands-bot all-hands-bot left a comment

Choose a reason for hiding this comment

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

🟢 Good taste - Well-structured documentation that solves a real problem.

This PR documents the previously undocumented LLM profiles feature with clear, actionable information. The documentation:

  • Follows existing Mintlify patterns and uses appropriate components (, )
  • Provides complete coverage: creation, management, switching, slash commands, and best practices
  • Has been verified against source code by previous reviews
  • Maintains logical flow and appropriate detail level

[RISK ASSESSMENT]

  • [Overall PR] ⚠️ Risk Assessment: 🟢 LOW

Documentation-only change with no code modifications, breaking changes, or security implications.

VERDICT:
Worth merging - Addresses real user need with quality documentation.

KEY INSIGHT:
Documents a powerful feature (mid-conversation model switching) that enables users to optimize cost and performance by leveraging different models for different tasks.

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

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants