Skip to content

Conversation

@jpshackelford
Copy link
Contributor

@jpshackelford jpshackelford commented Jan 18, 2026

Summary

Update documentation to reflect the actual plugin loading implementation in software-agent-sdk#1651.

Changes

  • Update "Recommended" section to use plugins parameter on Conversation (not AgentContext.plugin_source)
  • Use PluginSource model for specifying plugins
  • Update example path from 03_plugin_via_agent_context to 03_plugin_via_conversation
  • Update Quick Reference section
  • Fix anchor link in Manual Plugin Loading note

The Recommended Pattern

from openhands.sdk.plugin import PluginSource

conversation = Conversation(
    agent=agent,
    workspace="./workspace",
    plugins=[
        PluginSource(source="github:org/security-plugin", ref="v2.0.0"),
        PluginSource(source="github:org/monorepo", repo_path="plugins/audit"),
        PluginSource(source="/local/custom-plugin"),
    ],
)

Related

Add documentation for the recommended pattern of loading plugins via
AgentContext.plugin_source. This pattern:
- Is consistent with the agent-server API
- Automatically handles all plugin components (skills, MCP config, hooks)
- Reduces boilerplate code

The existing Plugin.load() pattern is now documented as 'Manual Plugin Loading'
for advanced use cases requiring fine-grained control.

Related to: OpenHands/software-agent-sdk#1651

Co-authored-by: openhands <openhands@all-hands.dev>
Updates documentation to reflect the actual implementation:
- Plugin loading via `plugins` parameter on Conversation
- Using PluginSource model instead of AgentContext fields
- Updated example path to 03_plugin_via_conversation

Related: OpenHands/software-agent-sdk#1651

Co-authored-by: openhands <openhands@all-hands.dev>
@jpshackelford jpshackelford changed the title docs: Add plugin loading via AgentContext example docs: Update plugin loading documentation for Conversation-based approach Jan 20, 2026
@openhands-ai
Copy link

openhands-ai bot commented Jan 20, 2026

Looks like there are a few issues preventing this PR from being merged!

  • GitHub Actions are failing:
    • .github/workflows/sync-agent-sdk-openapi.yml
    • .github/workflows/sync-docs-code-blocks.yml

If you'd like me to help, just leave a comment, like

@OpenHands please fix the failing actions on PR #265 at branch `feat/plugin-via-agent-context-example`

Feel free to include any additional details that might help me get this PR into a better state.

You can manage your notification settings

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