Known issues and limitations
Get a quick overview of the known issues and limitations for IBM watsonx Orchestrate.
Known issues are identified bugs or unexpected behaviors currently under investigation or scheduled for resolution in future updates. These issues are actively tracked by the development team and will be addressed in upcoming releases.
Limitations refer to constraints or currently unsupported capabilities due to design, security, or technical reasons. They are not bugs but rather boundaries of what the platform can currently support.
Being aware of known issues and limitations helps you:
Plan effective workarounds for your implementation
Avoid spending time troubleshooting known problems
Make informed decisions about feature usage
Understand the current capabilities and boundaries of the platform
Staying updated
When known issues are resolved, the fixes are documented in the release notes for that specific release. Check the release notes regularly to stay informed about bug fixes, enhancements, and newly identified issues.
Known issues by category
Building and configuration
Category | What's covered |
|---|---|
Agent creation, model selection, evaluation, multi-agent collaboration | |
Agentic workflows, tool execution, document processing | |
Connection management, authentication types, credentials |
Deployment and usage
Category | What's covered |
|---|---|
Deployment process, channel integrations | |
End-user chat experience, document upload, file handling | |
Agent analytics dashboard, monitoring data, observability traces |
Administration
Category | What's covered |
|---|---|
Tenant management, user management, language support, IBM SaaS Console |
Development tools
For issues related to development toolkit and APIs:
Reporting issues
If you encounter an issue not listed here, contact IBM Support with:
Detailed description of the issue
Steps to reproduce
Environment details (browser, OS, instance type)
Error messages or screenshots