Skip to content

docs(sdk): Add guide for parallel tool execution#409

Merged
VascoSch92 merged 8 commits intomainfrom
parallel-tool-execution
Mar 20, 2026
Merged

docs(sdk): Add guide for parallel tool execution#409
VascoSch92 merged 8 commits intomainfrom
parallel-tool-execution

Conversation

@VascoSch92
Copy link
Contributor

@VascoSch92 VascoSch92 commented Mar 20, 2026

Summary

Adds documentation for the experimental tool_concurrency_limit feature in the OpenHands Agent SDK that allows agents to execute multiple tools concurrently within a single LLM response.

Changes

New Documentation

  • Created sdk/guides/parallel-tool-execution.mdx with:
    • Overview of parallel tool execution and when to use it
    • Configuration guidance for tool_concurrency_limit parameter
    • Use cases (parallel file operations, sub-agent delegation)
    • Best practices and thread safety considerations
    • Clear experimental warning about the feature status
    • Ready-to-run example code from the parallel-tool-execution branch

Navigation

  • Updated docs.json to add the new guide after agent-delegation (related concept)

Notes

  • This feature is marked as experimental in the docs since tool_concurrency_limit defaults to 1 (sequential)
  • The documentation emphasizes using this feature cautiously due to potential race conditions
  • Once the feature is merged to main in the SDK, the example code link can be updated

Adds documentation for the experimental tool_concurrency_limit feature
that allows agents to execute multiple tools concurrently within a
single LLM response.

- Created sdk/guides/parallel-tool-execution.mdx with:
  - Overview of parallel tool execution
  - Configuration guidance
  - Use cases and best practices
  - Experimental warning and safety considerations
  - Ready-to-run example code

- Updated docs.json navigation

Co-authored-by: openhands <openhands@all-hands.dev>
Copy link
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.

🟡 Acceptable - Documentation is technically accurate against the feature branch, but has usability issues that should be fixed.

@VascoSch92 VascoSch92 changed the title Add guide for parallel tool execution docs(sdk): Add guide for parallel tool execution Mar 20, 2026
all-hands-bot

This comment was marked as outdated.

all-hands-bot

This comment was marked as outdated.

Copy link
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 - Documentation is accurate, pragmatic, and doesn't over-engineer. Verified against feature branch source code.

…rallel-tool-execution

# Conflicts:
#	sdk/guides/parallel-tool-execution.mdx
Copy link
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.

🟡 Acceptable - Documentation is technically accurate against the feature branch, but the focus highlight still doesn't match the comment intent.

VascoSch92 and others added 2 commits March 20, 2026 11:36
Co-authored-by: OpenHands Bot <contact@all-hands.dev>
Co-authored-by: Engel Nyst <engel.nyst@gmail.com>
Copy link
Collaborator

@enyst enyst left a comment

Choose a reason for hiding this comment

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

If you prefer you can negotiate with the agent, but since I'm here I'll approve it anyway 😅

Thank you for the PTE work!

Copy link
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.

🟡 Acceptable - Documentation accurately reflects the SDK source (verified against main branch), but has a broken link and minor focus issue.

Co-authored-by: OpenHands Bot <contact@all-hands.dev>
@VascoSch92
Copy link
Contributor Author

If you prefer you can negotiate with the agent, but since I'm here I'll approve it anyway 😅

Thank you for the PTE work!

@enyst Thanks :-)

I just wanted to be sure I was not adding broken links....

@VascoSch92 VascoSch92 merged commit 9f7f4e5 into main Mar 20, 2026
5 checks passed
@VascoSch92 VascoSch92 deleted the parallel-tool-execution branch March 20, 2026 13:56
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.

4 participants