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.

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 (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.