​
Version - 1.8.0
2025-07-24
The watsonx Orchestrate ADK version 1.8.0 is now available!This release introduces powerful new features like Orchestrate Copilot, voice resource support, and major updates to Flow tools. It also includes enhancements to knowledge base management and several important bug fixes to improve stability and usability.

​
⬆️ Upgrade now

To upgrade to version 1.8.0, run:
BASH
pip install --upgrade ibm-watsonx-orchestrate==1.8.0

​
🚀 New features

​
Orchestrate copilot

You can now create and refine agents by chatting directly with copilot in the watsonx Orchestrate CLI. Copilot helps you build smarter, faster — just start a conversation and let it guide you through the process. For more information, see Copilot.

​
Flow updates

Flow introduces several enhancements, including a new Scheduler feature, and the addition of Prompt and Decisions nodes. For more information, see Flow tools.

​
🔧 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.
​
Version - 1.7.0
2025-07-11
The watsonx Orchestrate ADK version 1.7.0 is now available!This release introduces new features, enhancements, and fixes to improve your development experience. You can now use MCSP v2 environments, add document processing to flows, and debug CLI commands more easily.

​
⬆️ Upgrade now

To upgrade to version 1.7.0, run:
BASH
pip install --upgrade ibm-watsonx-orchestrate==1.7.0

​
🚀 New features

​
MCSP v2 support

You can now add environments using Multi-Cloud SaaS Platform (MCSP) v2. This is now the default when you select the mcsp type. For more information, see Creating an environment.

​
IBM document processing in flows (Public preview)

You can now process documents directly inside a flow. For more information, see Processing documents in flows.This feature is disabled by default in watsonx Orchestrate Developer Edition because it requires additional hardware resources. To enable it, start the server with the -d parameter:
BASH
orchestrate server start -e <.env file path> -d
This feature is also in public preview. Functionality and behavior may change in future updates.

​
--debug parameter

You can now enable debug mode for any CLI command using the new --debug parameter. Add it after the orchestrate command to get detailed output. For more information see Running commands in debug mode.

​
Knowledge base updated

The --path parameter is no longer supported in knowledge base commands. To update an existing knowledge base, run the import command again using the same knowledge base name. For more information, see Updating knowledge base.

​
🔧 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.
​
Version - 1.6.2
2025-07-04
The watsonx Orchestrate ADK version 1.6.2 is now available!

​
⬆️ Upgrade now

To upgrade to version 1.6.2, run:
BASH
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.
​
Version - 1.6.1
2025-07-03
The watsonx Orchestrate ADK version 1.6.1 is now available!This release brings a series of important bug fixes to improve the stability and reliability of the ADK.

​
⬆️ Upgrade now

To upgrade to version 1.6.1, run:
BASH
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.
​
Version - 1.6.0
2025-06-30
The watsonx Orchestrate ADK version 1.6.0 is now available!This release brings powerful new features and enhancements to help you build, evaluate, and customize your agents more efficiently. You can now skip login for watsonx Orchestrate Developer Edition images, import async OpenAPI tools, and much more.
ImportantA change in the connection manager introduced in version 1.6.0 causes a regression for earlier ADK versions. If you’re using any version prior to 1.6.0 to connect to a SaaS environment, you must now configure credentials in both the draft and live environments before they can be used.

​
⬆️ Upgrade now

To upgrade to version 1.6.0, run:
BASH
pip install --upgrade ibm-watsonx-orchestrate==1.6.0

​
🚀 New features

​
Flow tools

You can now fully use Flow Tools to build dynamic, workflow-based tools. This feature was previously in public preview. You can create flow tools using either the ADK or the user interface. For more information, see Flow tools.

​
New environment variable

You can now skip the login step when retrieving watsonx Orchestrate Developer Edition images by setting the new environment variable called WO_DEVELOPER_EDITION_SKIP_LOGIN. For more information, see Setup the environment.

​
Async OpenAPI tools

You can now import asynchronous OpenAPI tools. For more information, see Creating OpenAPI-based tools.

​
InstructLab fine tuned custom model

You can now use the orchestrate models add command to import fine-tuned custom models from InstructLab in watsonx.ai. These models must be deployed using the Bring Your Own Model (BYOM) option. For more information, see Adding custom LLM.

​
Context variables

You can now use context variables with agents. You can enable these variables in agent instructions and set their values through the API. For more information, see:You can now configure your own knowledge base server and connect it to watsonx Orchestrate using custom search. For more information, see Custom search.

​
Webchat customization

You can now customize the embedded webchat colors to better match your website’s branding. For more information, see Customizing webchat.

​
Fullscreen webchat

You can now configure your embedded webchat to run in fullscreen mode. For more information, see Configuring webchat layout.

​
Support for on-premises

You can now connect your on-premises environment in the ADK. The environment setup works just like any other environment. To authenticate, use either an API key or your username and password. For more information, see On-premises.
Note: ADK version 1.6.0 is long-term supported by the on-premises version 5.2 for the entire duration of this on-premises version support lifecycle

​
Agent evaluation framework

You can now evaluate the performance and effectiveness of your agents using the new agent evaluation framework. For more information, see Evaluation Framework.

​
Chat with documents

You can now upload documents to your native agents and get responses based on the document content during the same thread. Enable this feature by configuring the chat_with_docs section in your agent file. For more information, see Chat with documents.

​
Welcome message and starter prompt

You can configure the welcome message and starter prompts individually for each agent in your environment. For more information, see:

​
Agent guidelines

You can now configure guidelines for your agents. For more information, see Guidelines.

​
External agents as collaborator agents

You can now use external agents as collaborators for native agents. For more information, see 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.
​
Version - 1.5.1
2025-06-13
The watsonx Orchestrate ADK version 1.5.1 is now available!This release brings bug fixes and improvements such as the model policies.

​
⬆️ Upgrade now

To upgrade to version 1.5.1, run:
BASH
pip install --upgrade ibm-watsonx-orchestrate==1.5.1

​
🚀 New features

​
Model policies

You can now define model policies to coordinate multiple models for tasks like load balancing and fallback. This helps you improve reliability and performance across your workflows. For more information, see Configuring 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.
​
Version - 1.5.0
2025-06-12
The watsonx Orchestrate ADK version 1.5.0 is now available!This release brings powerful new capabilities to help you build and manage agents with greater flexibility and control. You can now define model policies, and fully integrate custom LLMs.The watsonx Orchestrate Developer Edition UI also gets major upgrades, including flow editing and in-chat feedback.

​
⬆️ Upgrade now

To upgrade to version 1.5.0, run:
BASH
pip install --upgrade ibm-watsonx-orchestrate==1.5.0

​
🚀 New features

​
Custom LLM provider

The custom LLM provider feature, earlier in public preview, is now fully released. You can now fully integrate custom models using a supported set of providers. For more information, see Managing custom LLMs using AI gateway.

​
Agent styles

You can now build native agents using the tool planner style. These agents support structured output and custom join tools, giving you more flexibility in how your agents reason and respond. For more information, see Planner style.

​
Flows UI

You can now edit your flows directly in the watsonx Orchestrate Developer Edition UI for a more streamlined development experience.

​
🔧 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:
  • 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.
​
Version - 1.4.2
2025-05-29
The watsonx Orchestrate ADK version 1.4.2 is now available! This release brings powerful new features and enhancements to streamline your development workflow. You can now export tools and agents, use flows as tools, and configure custom LLM providers — all designed to give you more flexibility and control.

​
🚀 New features

​
Export agents and tools

You can now export agents and tools directly from your active environment. Use the new export argument with the orchestrate agents and orchestrate tools commands to get started. For more information, see:

​
Flow tools (Public Preview)

You can now create flow tools. Flow tools let you sequence nodes to build dynamic, workflow-based tools. A new tool type available in public preview for the watsonx Orchestrate Developer Edition. For more information, see Flow tools (Public Preview).

​
Custom LLM provider (Public Preview)

You can now add and remove custom LLM providers for your agents. This feature is available in public preview for the watsonx Orchestrate Developer Edition. For more information, see Managing custom LLMs using AI gateway (Public Preview).

​
watsonx/* LLMs

You can now use watsonx/* LLMs by simply configuring a few .env variables. For more information, see Enabling watsonx/* LLMs.

​
Hate, Abuse, and Profanity filtering

You can now control how your knowledge bases handle inappropriate content by using the new Hate, Abuse, and Profanity (HAP) filter settings. For more information, see Configuring Hate Abuse and Profanity (HAP) filtering.

​
🔧 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 argument 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.
​
Version - 1.3.0
2025-05-15
The watsonx Orchestrate ADK version 1.3.0 is now available. This release introduces new functionality, including support for Python-based knowledge bases and a ADK version display command. It also includes key bug fixes to improve usability.

​
New features

  • You can now use the --version argument 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.
​
Version - 1.2.0
2025-05-05
In version 1.2.0, the watsonx Orchestrate ADK introduces support for building and managing toolkits within your watsonx Orchestrate environment.This is the first iteration of toolkit functionality in the ADK. Therefore, this feature is only available for watsonx Orchestrate Developer Edition and currently supports only the MCP server.For more information, see Managing Toolkits.
​
Version - 1.1.0
2025-05-03
The 1.1.0 version brings numerous enhancements and bug fixes to IBM watsonx Orchestrate ADK.

​
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 argument.
  • 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.
​
Version - 1.0.1
2025-05-01
The 1.0.1 version brings numerous enhancements to IBM watsonx Orchestrate ADK.

​
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.
​
Version - 1.0.0
2025-04-30

​
New features

  • New feature for observability
  • New feature for managing knowledge bases
  • Ability to upload multiple files to build tools
  • Updated connection commands structure
​
Version - 0.9.1
2025-04-16
  • Bug fixes
​
Version - 0.9.0
2025-04-16

​
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
​
Version - 0.8.1
2025-04-16
  • Bug fixes
​
Version - 0.8.0
2025-03-31
  • Adds the ability to connect to a wx.ai agent as a collaborator.