What's new

​

⬆️ Upgrade now

pip install --upgrade ibm-watsonx-orchestrate==1.13.0

​

🚀 New features

​

Automatic agent refinement

​

Custom watsonx Orchestrate Developer Edition image registry

​

Export knowledge bases

​

watsonx Orchestrate MCP Server

​

Agentic workflows changes

• Retry option: Use the error_handler_config parameter in Tool and Generative prompt nodes to configure retry behavior. For more information, see Tool node and Generative prompt node.
• User in the loop: Use the enable_review parameter in Document classifier and Document field extractor nodes to enable or disable user review. For more information, see Document classifier node and Document field extractor node.

​

🔧 Enhancements

• Agent list display name: The orchestrate agents list command now shows the agent display name in the Name column.

​

🐛 Bug fixes

• OpenAPI server error in SaaS: Fixed issue where the orchestrate tools list command failed in SaaS environments with the error “[ERROR] - OpenAPI definition must include exactly one server”.
• Complex types in MCP tools: Fixed issue where tools from MCP servers with complex types did not work correctly.
• Scheduler tool import failure: Fixed issue where a scheduler tool was not imported into SaaS environments if the flow being imported was schedulable.
• Assistant agent export failure: Fixed issue where users were unable to export assistant agents that were configured as collaborators to native agents.

​

⬆️ Upgrade now

pip install --upgrade ibm-watsonx-orchestrate==1.12.0

​

🚀 New features

​

Langflow tools

​

Remote MCP

​

Package partner

​

External agents with connections

​

Evaluation framework for on-opremises

​

AstraDB connections for knowledge base

​

Parallel foreach

​

Validate native agents and components

​

🔧 Enhancements

• Improved execution performance: Agent knowledge executions are optimized to reduce the time it takes to resolve user queries, resulting in faster and more responsive interactions.
• Export agentic workflows: You can now use orchestrate agent export and orchestrate tools export to export agentic workflows tools for local instances of watsonx Orchestrate Developer Edition.
• @flow decorator parameters: Two new parameters — llm_model and agent_conversation_memory_turns_limit — are now available in the @flow decorator to enhance flow configurations.
• OpenAPI tool display names: When imported through the ADK CLI, OpenAPI tools now use the summary value as their display name. If summary is not configured, the display name defaults to the operationId.
• Agentic workflow terminology: The tools previously referred to as “flows” are now called “agentic workflows”.

​

🐛 Bug fixes

• Agent-to-agent import via CLI: Fixed issue where agents could not be imported via CLI unless hidden: false and enable_cot: false flags were explicitly set.

​

Security updates for the watsonx Orchestrate Developer Edition

​

⬆️ Upgrade now

pip install --upgrade ibm-watsonx-orchestrate==1.11.0

​

🚀 New features

​

Custom fields for OAuth authentication

​

Document processing

• Added document_structure parameter to the document text extractor node. For more information, see Document text extractor node (Public preview).
• Updated method name in the Document classifier node from docclassfier() to docclassifier(). For more information, see Document classifier node (Public preview).
• Added a new example in the official ADK repository that includes all document processing nodes in a single flow. For more information, see document_processing.

​

Flows

• Manual mapping of inputs and outputs for flow nodes. For more information, see Mapping inputs and outputs.
• Procode configuration support for User activity nodes. For more information, see User activity node.
• Enable or disable prompt examples for GenAI nodes. For more information, see GenAI node.
• New flow configuration examples added to the official ADK repository. For more information, see Examples.

​

Evaluation framework

• Quick evaluations
• Analyzing agents and tools
• Agent vulnerability testing

​

Dynamic knowledge bases (Public preview)

​

🔧 Enhancements

• Agents list performance: Optimized the orchestrate agents list command for faster response times.
• Copilot refinement: Improved error handling during agent refinement. An error is now returned if the agent spec file is invalid.

​

🐛 Bug fixes

• On-premises environment activation: Fixed error preventing activation of multiple on-premises environments via ADK.

​

⬆️ Upgrade now

pip install --upgrade ibm-watsonx-orchestrate==1.10.0

​

🚀 New features

​

Voice

​

Deploy and undeploy agents

​

OAuth2 Password Flow

​

Flows and document processing

• Document classifier node
• Branch node
• Timer node

• Document text extractor and Document field extractor nodes now include renamed parameters and a new enable_hw parameter.

​

Knowledge base

• Custom certificate support for Milvus connections using the server_cert parameter.
• Maximum document limit for LLM input using the max_docs_passed_to_llm parameter.
• Option to disable confidence thresholds by setting retrieval_confidence_threshold to Off.
• URL support for each document in built-in Milvus knowledge bases using path and url in the documents parameter.
• Support for app-id when updating a knowledge base.

​

Orchestrate copilot extension

​

Context variables in embedded webchat

​

🐛 Bug fixes

• Planner agent planning failure: Fixed issue where planner agents failed to plan after the first utterance.
• Tool input/output types: Fixed issue where tools using | or Optional[] in their input/output definitions were stored without a type.
• macOS M4 compatibility: Fixed issue preventing macOS M4 users from starting watsonx Orchestrate Developer Edition with Elasticsearch.

​

⬆️ Upgrade now

pip install --upgrade ibm-watsonx-orchestrate==1.9.0

​

🚀 New features

​

Azure AI as a custom LLM

​

Document processing

​

Context variables for external agents as collaborator agents

​

Custom Docker setup

​

Events reference

​

Orchestrate copilot extension

​

🔧 Enhancements

• Default agent provisioning: A default agent called AskOrchestrate is now created during tenant provisioning. You can edit or delete this agent using the ADK. If deleted, it cannot be re-imported. If no other agents are available, the system falls back to a basic LLM agent.
• Async OpenAPI tools: Restored support for asynchronous OpenAPI tools in flows, enabling non-blocking API interactions.
• Document processing logs: Improved logging messages for document processing.
• Evaluation structure: Refined the folder structure used by the orchestrate evaluations validate-external command for better organization and clarity.
• Orchestrate copilot: Added support for creating and refining agents using knowledge bases and agent collaborators directly through Orchestrate copilot.
• Tools list verbose: The id parameter is now included in the output of the orchestrate tools list -v command.

​

🐛 Bug fixes

• Connections with =: Fixed an issue where the ADK failed to accept connection configurations when the API key contained an equals sign (=).
• MCP import: Fixed an issue where MCP toolkits couldn’t be imported without --package or --package-root when using the --command flag.
• Orchestrate copilot crashes: Fixed an issue where Orchestrate copilot crashed due to invalid input, causing the response to end prematurely.
• Tools list verbose: Fixed an issue where the orchestrate tools list -v command returned output in an invalid JSON format. The output is now properly structured and ready for parsing.
• Python tool schema registration: Fixed an issue where importing Python tools through the ADK resulted in inaccurate values for input and output schemas.

​

⬆️ Upgrade now

pip install --upgrade ibm-watsonx-orchestrate==1.8.1

​

🐛 Bug fixes

• Python tool import: Fixed an issue where Python tools couldn’t be imported due to an upstream dependency change.

​

⬆️ Upgrade now

pip install --upgrade ibm-watsonx-orchestrate==1.8.0

​

🚀 New features

​

Orchestrate copilot

​

Flow updates

​

🔧 Enhancements

• Smarter knowledge base updates: You can now keep your knowledge base fully in sync with your specification. When you update the knowledge base, all defined files are uploaded again, even if they already exist. Files that are no longer listed in the specification are automatically removed from the server.

​

🐛 Bug fixes

• Flow runtime callback rejection: Fixed an issue where the Flow runtime rejected callbacks to resume node execution when the payload size exceeded 100 KB in the watsonx Orchestrate Developer Edition.
• OAuth credential configuration failure: Fixed an issue where you couldn’t configure the grant-type and send-via values for the oauth_auth_client_credentials_flow connection type. You can now use the new --grant-type and --send-via flags with the orchestrate connections set-credentials command to set these values.
• Server startup failure: Fixed an issue where you were unable to start the watsonx Orchestrate Developer Edition server due to cache-related errors.

​

⬆️ Upgrade now

pip install --upgrade ibm-watsonx-orchestrate==1.7.0

​

🚀 New features

​

MCSP v2 support

​

IBM document processing in flows (Public preview)

orchestrate server start -e <.env file path> -d

​

--debug parameter

​

Knowledge base updated

​

🔧 Enhancements

• CLI messages and descriptions: Improved CLI output messages and command descriptions for better clarity.
• Tool spec optimization: Refactored tool specification generation to occur on access instead of during initialization.
• Flows endpoint path: Updated the flows endpoint from /flows to /v1/flows to reflect the correct API path.

​

🐛 Bug fixes

• Environment variable handling: Fixed an issue where environment variables caused inconsistent server startup behavior for Orchestrate instances.

​

⬆️ Upgrade now

pip install --upgrade ibm-watsonx-orchestrate==1.6.2

​

🔧 Enhancements

• Langchain version locking: Locked the versions of langchain-core, langchain-community, and langsmith to prevent errors introduced in the latest langsmith release.

​

⬆️ Upgrade now

pip install --upgrade ibm-watsonx-orchestrate==1.6.1

​

🔧 Enhancements

• New connection options for Python tools: You can now use connections.oauth2_client_creds(<app_id>) and connections.oauth2_auth_code(<app_id>) when building Python-based tools.

​

🐛 Bug fixes

• Spelling correction in error message: Fixed a typo in the connection error message, changing “diffrent” to “different”.
• Duplicate error messages: Fixed an issue where the CLI displayed the same error message twice when importing a tool with a connection configured only for the draft environment.
• Crashloop in AWS Mumbai: Fixed an issue where ai-gateway failed and entered a crashloop state in the AWS Mumbai region.
• Incorrect default model in AWS Mumbai: Fixed a bug where the default agent was associated with the wrong model in the AWS Mumbai region.
• Agent version not found: Fixed an issue where the error Agent version <agent UUID> not found appeared in agent chat, even though the agent was correctly configured.
• LLM inference failures not captured: Fixed an issue where LLM inference failures were incorrectly marked as successful in observability logs.
• Trace not found error: Fixed an issue where users saw a “Trace not found” error when clicking on traces that does not have a Model ID.
• Connection warning update: Changed the error shown when a live connection is missing during tool import to a warning instead.
• Record command improvements: Updated log messages and file format for the record command.

​

⬆️ Upgrade now

pip install --upgrade ibm-watsonx-orchestrate==1.6.0

​

🚀 New features

​

Flow tools

​

New environment variable

​

Async OpenAPI tools

​

InstructLab fine tuned custom model

​

Context variables

• Providing access to context variables
• Chat With Orchestrate Assistant

​

Custom search

​

Webchat customization

​

Fullscreen webchat

​

Support for on-premises

​

Agent evaluation framework

​

Chat with documents

​

Welcome message and starter prompt

• Welcome message
• Starter prompts

​

Agent guidelines

​

External agents as collaborator agents

​

🔧 Enhancements

• Manage hidden agents: You can now manage hidden agents directly from the ADK CLI.
• Preferred model indicator: You can now identify validated third-party models by a star (⭐) icon. These models are tested and approved for use with watsonx Orchestrate agents.

​

🐛 Bug fixes

• Agent export with MCP and flows: Fixed an error that prevented agents that used MCP and flow tools from being exported. The agent now exports correctly. MCP and flows are still not included in the export.
• Toolkit deletion: Fixed an issue that blocked users from deleting toolkits in the SaaS environment.
• Mistral model failures: Fixed an error where some utterances and tools failed when using Mistral models.
• Missing deployment platform: Fixed an issue where the deployment platform was not included in the watsonx Orchestrate Developer Edition.
• Invalid API key acceptance: Fixed an error where invalid API keys were incorrectly accepted during environment activation.
• Model policy import: Fixed an error where the CLI forced you to provide values for on_status_code.
• Model Policy fallback:: Fixed an error where weights of 1.0 were incorrectly assigned to each model.

​

⬆️ Upgrade now

pip install --upgrade ibm-watsonx-orchestrate==1.5.1

​

🚀 New features

​

Model policies

​

🔧 Enhancements

• AI Gateway: You can now use model policies in the AI Gateway to enable load balancing, fallback, and retry logic.

​

🐛 Bug fixes

• Re-enabled flow editor UI that was unavailable in the previous version.

​

⬆️ Upgrade now

pip install --upgrade ibm-watsonx-orchestrate==1.5.0

​

🚀 New features

​

Custom LLM provider

​

Agent styles

​

Flows UI

​

🔧 Enhancements

• Credentials configuration: You can now configure credentials using connections, just like in other parts of watsonx Orchestrate—no more .env files.
• LLM providers: You can now integrate with more LLM providers for greater flexibility.
• Flow examples: You can now explore three new flow tool examples to jumpstart your development:
  • collaborator_agents
  • extract_support_request
  • get_tuition_reimbursed
• Chat feedback: You can now give thumbs up/down feedback in the chat interface of the watsonx Orchestrate Developer Edition UI to improve agent responses.

​

🐛 Bug fixes

• Toolkit endpoint alignment: Fixed inconsistent toolkit endpoints across SaaS and Developer Edition environments.

​

🚀 New features

​

Export agents and tools

• Exporting tools
• Exporting agents

​

Flow tools (Public Preview)

​

Custom LLM provider (Public Preview)

​

watsonx/* LLMs

​

🔧 Enhancements

• Agent identity in chat: You can now see the agent’s name and avatar in the chat screen during conversations.
• Display names: You can now assign display names to tools and agents.
• Granite 3.2 & 3.3 support: You can now use the Granite 3.2 and 3.3 LLMs.
• Simplified command: You no longer need the --project-id flag when using the orchestrate settings observability langfuse command.
• SaaS proxy access: You can now source watsonx Orchestrate Developer Edition images from the SaaS proxy without needing an entitlement.
• LLM Without API Key: You can now use a SaaS instance of watsonx Orchestrate as your LLM provider without supplying a wx.ai key.
• MCP toolkit management: You can now list your MCP toolkits and import them directly from public NPM repositories.

​

🐛 Bug fixes

• Tool import hang: Fixed issue where importing multiple tools caused the ADK to hang.
• Truncated tool names: Fixed an issue in multi-file tools where the import process dropped the first letter of each tool name due to incorrect package name handling.

​

New features

• You can now use the --version flag in the CLI to display the currently installed version of the ADK.
• The ADK now supports creating knowledge bases using Python files. Documentation has been updated with examples and configuration details for Python-based setups. For more information, see Creating Knowledge Bases.

​

Bugfixes

• Fixed an issue that prevented the use of numbers in the names of OpenAPI-based tools.

​

Enhancements

• Environment variable persistence: Environment variables passed during the orchestrate server start command are now cached. You no longer need to re-specify them when starting the watsonx Orchestrate Developer Edition chat. By default, only non-sensitive variables are persisted. To persist all variables, including secrets, use the hidden -p flag.
• Toos importing error messages: Importing error messages for tools have been enhanced to provide clearer and more descriptive feedback when issues occur.
• Support for non-ZIP tool formats: The importing process now supports tools that are not packaged in ZIP format.
• Startup feedback for observability Languse platform: A new feedback message is displayed when starting the observability Languse platform. This message includes instructions on how to access the platform.

​

Bug fixes

• Crash during repeated tool import: Fixed an issue that caused the application to crash when importing tools multiple times in succession.
• watsonx Orchestrate Developer Edition name on CLI: Fixed the watsonx Orchestrate Developer Edition name on CLI.

​

Enhancements

• Private network communication for containers: watsonx Orchestrate Developer Edition containers now communicate exclusively on the private network (excluding TRM).
• Open Source Containers from DockerHub: Open source containers are now pulled directly from DockerHub.
• Memory consumption: Enhanced memory usage to reduce memory consumption.
• Path mapping for knowledge base commands: Fixed path mappings for the knowledge commands on SaaS.
• PI publication: PyPI publication has been enabled and is now the default setting.

​

New features

• New feature for observability
• New feature for managing knowledge bases
• Ability to upload multiple files to build tools
• Updated connection commands structure

• Bug fixes

​

Enhancements

• A new chat completion API for watsonx Orchestrate agents exists that can be called from Agentforce
• Salesforce Agentforce agents can now be used as external agents to Orchestrator Agent
• External instances of watson assistant can be registered as collaborators to a native agent

​

Bugfixes

• |python_tag| no longer appears in the response of React Style agents
• Optional fields are no longer required by the tool runtime
• Server start timeout has been increased to 7 minutes and it is more clear when a timeout happens and the server fails to start

• Bug fixes

• Adds the ability to connect to a wx.ai agent as a collaborator.