SDK: Document error handling & typed exceptions #91
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
- New guide: sdk/guides/error-handling.mdx - Navigation: add under SDK > Guides > LLM Features Refs OpenHands/software-agent-sdk#980 Co-authored-by: openhands <[email protected]>
xingyaoww
reviewed
Nov 7, 2025
- Show try/except around LLM.responses() Refs OpenHands/software-agent-sdk#980 Co-authored-by: openhands <[email protected]>
- Rename file to align with other LLM features - Update navigation to point at new path Refs OpenHands/software-agent-sdk#980 Co-authored-by: openhands <[email protected]>
malhotra5
reviewed
Nov 7, 2025
- Lead with Agent/Conversation examples and bubbling behavior - Move LLM examples (completion/responses) into secondary section Refs OpenHands/software-agent-sdk#980 Co-authored-by: openhands <[email protected]>
…uide - Content is redundant and covered elsewhere Refs OpenHands/software-agent-sdk#980 Co-authored-by: openhands <[email protected]>
Collaborator
Author
|
Restructured guide to be conversation-first, kept LLM examples as secondary, and removed the final 'Notes for advanced users' section as requested. Ready for re-review. |
enyst
commented
Nov 7, 2025
enyst
pushed a commit
that referenced
this pull request
Nov 8, 2025
…ass logic (#91) Co-authored-by: openhands <[email protected]>
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Summary
Add a dedicated guide for provider-agnostic SDK exceptions and client error-handling patterns. This documents the new typed exceptions introduced in OpenHands/software-agent-sdk PR #980 and shows practical examples for both direct LLM usage and higher-level agent/conversation flows.
What’s in this PR
Why
SDK PR #980 normalizes common provider errors (auth, rate limit, timeout, service unavailable, bad request, context-window exceeded) into stable types. Client developers need a clear reference and examples to handle these consistently across providers.
Related
Co-authored-by: openhands [email protected]
@enyst can click here to continue refining the PR