The watsonx Orchestrate ADK version 2.7.0 is now available!Upgrade to version 2.7.0 to manage Workspaces through the CLI, develop agents using Skill specifications, use updated OpenSearch schemas, connect to Genesys platforms, enhance agentic workflows, view custom code tool logs, and import agents from ZIP files.
⬆️ Upgrade now
To upgrade to version 2.7.0, run:BASH
🚀 New features
Workspaces
Use the new Workspaces commands to manage Workspaces with the watsonx Orchestrate ADK CLI. For more information, see Workspaces.Agent development with Skills specifications (Public Preview)
Use the MCP servers and agent‑agnostic Skill specifications provided by IBM watsonx Orchestrate to help coding agents build solutions more reliably while reducing large context overhead. For more information, see Agent development with Skills specifications.Updated schema for OpenSearch
Use the updated schemas for OpenSearch. For more information, see OpenSearch.Genesys Cloud platform connections
Use theorchestrate customer‑care commands to configure connections for your Genesys Cloud platforms. For more information, see Managing connections to Customer Care platformsAgentic workflow updates
Use the updated user activity node for agentic workflows. Configure dynamic forms and use date and time fields in your user activity node. For more information, see:Logs for custom code tools
View logs generated by your custom code tools in watsonx Orchestrate Developer Edition. For more information, see Logging behavior for Python tools in watsonx Orchestrate.Import agents from ZIP files
Import agents from ZIP files exported by the watsonx Orchestrate ADK CLI. For more information, see Bulk import from ZIP.🐛 Bug fixes
- Voice-configs import failure: Fixed an issue where importing voice configurations failed in on‑premises environments.
- Display name mapping: Fixed an issue where display names were not mapped correctly into the flow model for some node types.
The watsonx Orchestrate ADK version 2.6.0 is now available!Upgrade to version 2.6.0 to use the new unified connection model, pass metadata to MCP tools, configure external service credentials, upload multiple files through Python tools, and search traces using relative time windows.Updates to the
Use the expanded capabilities of the
⬆️ Upgrade now
To upgrade to version 2.6.0, run:BASH
🚀 New features
Credential configuration for services on watsonx Orchestrate Developer Edition
Configure custom service credentials for watsonx Orchestrate Developer Edition. For more information, see Configure services credentials for watsonx Orchestrate Developer Edition in the .env file and Initializing watsonx Orchestrate Developer Edition server.Updates to the orchestrate chat ask command
Use the expanded capabilities of the orchestrate chat ask command for richer interaction. For more information, see Chatting with an agent in interactive mode through the CLI.Multiple file upload for Python tools
Create Python tools that upload multiple files. For more information, see Creating tools that accept files.Relative time window for trace search
Use the--last flag with the orchestrate observability traces search command to search traces from the last minutes, hours, or days. For more information, see Searching traces.Contextual metadata for MCP toolkits
Pass contextual metadata to tools that come from MCP toolkits. For more information, see Tracing, tenant and agent context.Unified connection experience for knowledge bases
Use the updated connection experience for knowledge bases. Connections now support optional categorization, allowing you to define the connection type and the application that uses it. For more information, see Adding and configuring connections.User activity node updates
Use the updated field types in theform() object for the user activity node. For more information, see Forms.🐛 Bug fixes
- Corrected instructions text wrapping: Fixed the wrapping issue for the
orchestrate agents ai-builder prompt-tunecommand. - Updated CPD instance validation: CPD instances no longer need to start with
https://cpd.
The watsonx Orchestrate ADK version 2.5.0 is now available!Upgrade to version 2.5.0 to search traces, manage Langfuse configuration, create citation‑enabled Python tools, and benefit from improved tool listing behavior.
⬆️ Upgrade now
To upgrade to version 2.5.0, run:BASH
🚀 New features
Traces with ADK
Search and export traces through the ADK CLI or Python scripts. For more information, see Traces.Remove configuration settings for Langfuse
Use the new command to delete Langfuse configuration settings from your environment. For more information, see Removing configuration settings.Citations for Python tools
Create Python tools that trigger citations. For more information, see Creating tools that can trigger citations.Connection types for local MCP servers
Use different connection types to authenticate with your local MCP servers. For more information, see Supported connection types for local MCP servers.🔧 Enhancements
- Improved tool listing: The
orchestrate tools listcommand now shows both thenameanddisplay_namewhen they differ, making it easier to identify tools in the output.
The watsonx Orchestrate ADK version 2.4.0 is now available!Upgrade to version 2.4.0 to import custom agents, define your own certificate bundles, and use new public preview Customer Care style that expand how you build and run agents.
⬆️ Upgrade now
To upgrade to version 2.4.0, run:BASH
🚀 New features
Custom agents
Use the--experimental-package-root and --experimental-config-file flags to import your custom LangGraph agents into watsonx Orchestrate through the ADK. For more information, see:- LangGraph agent
- Importing agents using an agent file
- Creating agents directly from the CLI
- Associating connections to Custom agents
Custom certificate bundle path
Use the new--cert-bundle-path flag with the orchestrate server start command to inject a custom certificate bundle through Docker volumes into the required microservices. For more information, see Initializing watsonx Orchestrate Developer Edition server.(Public preview) Customer Care style support
Use the newexperimental_customer_care style. For more information, see:- (Public preview) Customer Care style
- Getting Started with Customer Care
Note:
This public preview has oficially ended. The experimental Customer Care style is no longer supported.
This public preview has oficially ended. The experimental Customer Care style is no longer supported.
🔧 Enhancements
- Localized welcome experience: The welcome message and quick‑start prompts automatically translate to the language you choose. Translation quality depends on the LLM.
- Improved KB import and update messages: Knowledge base import and update operations now show progress messages until completion.
- Bedrock gpt‑oss model availability: The
bedrock/openai.gpt-oss-120b-1:0model is now available as one of the models for your agents.
🐛 Bug fixes
- Resolved agent response failure: Fixed an issue where an agent did not respond when running a flow tool through
orchestrate chat ask.
📘 Guides
Migration guidance from Llama to GPT-OSS-120b
A migration guide is now available to help you switch from Llama to the GPT-OSS-120b model. For more information, see Migrating to GPT-OSS-120B.The watsonx Orchestrate ADK version 2.3.0 is now available!You can now upgrade to version 2.3.0 to access new ways of interacting with your agents, export your models, and control context variables with Python tools.
⬆️ Upgrade now
To upgrade to version 2.3.0, run:BASH
🚀 New features
Chatting with agents through CLI
Chat with agents in your active environment directly from the ADK CLI by using theorchestrate chat ask command. For more information, see Chatting with an agent in interactive mode through the CLI.Export models and model polices
Use the ADK CLI to export models and model policies from watsonx Orchestrate. For more information, see Exporting custom LLM and Exporting model policy.Modifing context variables with Python tools
Modify context variables inside Python tools, including values such as the user identity. For more information, see Using Context Variables.🔧 Enhancements
- Improved invalid docstring warnings: You now receive clearer and more accurate messages when a Python tool import fails because of incorrect docstrings.
🐛 Bug fixes
- OpenAPI import problem: Fixed an issue where OpenAPI specs containing circular jsonref objects could not be imported into the ADK.
- Inaccurate error reporting: Fixed an issue where certain failures incorrectly displayed
str object has no attribute .decodeinstead of the actual error message.
The watsonx Orchestrate ADK version 2.2.0 is now available!This release expands agent deployment options, enhances extensibility, and simplifies tool and connection configuration. You can now deploy agents across new digital channels, create custom agents, work with dynamic schemas, and take advantage of major MCP and tooling improvements.
⬆️ Upgrade now
To upgrade to version 2.2.0, run:BASH
🚀 New features
Deploy agents on digital channels
Deploy your agents directly to Microsoft Teams and Facebook Messenger channels. This allows you to reach users across multiple communication platforms. For more information, see Establishing Channels.Dynamic input and output schemas in Python tools
Configure custom schemas for Python tools using the newenable_dynamic_schema field. For more information, see Dynamic input and output schemas.Auto-discover for Python tools
Use the new--auto-discover flag with orchestrate tools import to automatically discover and import all Python functions in the module specified by the -f flag. For more information, see Auto-discover.Enhanced Langflow commands
Use the Langflow flow name to import Langflow flows directly into watsonx Orchestrate. When you provide the Langflow flow name, the ADK retrieves the latest JSON with credentials, so you do not need to export the flow before adding it to watsonx Orchestrate. For more information, see Importing langflow flow using langflow flow name.🔧 Enhancements
- LangChain core upgrade: Updated langchain-core to version ~1.2.4.
- Langflow Builder UI: Updated to version 1.7.1.
- Python tool parameter parsing: The ADK now parses input parameter descriptions for Python tools directly from docstrings.
- Genesys audio connector credentials: Automatic generation of API key and secret is now supported, matching UI behavior. You can still provide credentials manually or leave them blank to auto-generate.
🐛 Bug fixes
- Webchat embed deployment: Fixed an issue where the
webchat embedcommand failed for deployed agents.
The watsonx Orchestrate ADK version 2.1.0 is now available!
⬆️ Upgrade now
To upgrade to version 2.1.0, run:BASH
🚀 New features
Support for new phone and chat channels
ADK now supports more channels to connect to:- Twilio WhatsApp
- Slack
- Twilio SMS
- Genesys Bot Connector
- Deepgram Speech-To-Text and Text-To-Speech
- ElevenLabs Text-To-Speech
Support for plug-ins
Plug-ins inspect and modify the input or output of an agent run. A plug-in is a tool that is automatically started either before the agent begins generating a response (pre-invoke) or after the agent completes its response (post-invoke).To learn more about plug-ins, see Plug-ins.watsonx Orchestrate copilot is now watsonx Orchestrate AI Builder
watsonx Orchestrate copilot has been renamed to watsonx Orchestrate AI Builder. The new VS Code extension can now be found as watsonx Orchestrate ADK Extension in the VS Code Extensions store.The extension now also includes access to an embedded web chat. You can learn more about it on watsonx Orchestrate AI Agent Builder and Orchestrate ADK Extension.Evaluation framework: Langfuse support
The evaluation framework now supports evaluation with Langfuse. You can learn more about it in Agentops evaluation.Document processing custom output format
The “docproc” (text extraction) node now includes anoutput_format parameter that gives you explicit control over how document processing results are returned. When set to docref, docproc returns a URL reference to the stored extraction results. This is the current and default behaviour. When set to object, docproc returns the actual JSON object.For more information, see Document processing with output format.🐛 Bug fixes
- Channels: Fixed an issue where channel names were not saved after adding them.
- Lima VM: Fixed issues related to the installation of the Lima VM when installing the watsonx Orchestrate Developer Edition.
- Stop server: The command
orchestrate server stopnow correctly stops the virtual machine that runs the watsonx Orchestrate Developer Edition server. You can opt to keep the VM running with the--keep-vmflag. - Flows: Uploaded files now support non-ASCII characters in the file name.
The watsonx Orchestrate ADK version 2.0.0 is now available!
If you previously used this feature, you must update your model name to include the provider prefix. For example:
⬆️ Upgrade now
To upgrade to version 2.0.0, run:BASH
🚀 New features
Installing watsonx Orchestrate Developer Edition
The installation process for watsonx Orchestrate Developer Edition is updated. You no longer need Docker installed; the installation configures everything automatically. You still need the .env file. New commands are available to manage your watsonx Orchestrate Developer Edition. For more information, see watsonx Orchestrate Developer Edition.Channels
Channels allow watsonx Orchestrate agents to connect with users across multiple platforms and communication tools. A new set of channels commands has been added to the ADK. For more information, see Channels.Forms support for user activity node
Previously released in public preview, forms support for user activity nodes is now generally available. You can configure forms in a user activity node. For more information, see Forms.Data mapping
Large data in flows is automatically summarized to improve auto-mapping reliability. You can customize the summarization by providing instructions specific to your use case. For more information, see Data mappingBreaking change: Import MCP toolkits
The formerorchestrate toolkits import command has been renamed to orchestrate toolkits add. Additionally, a new orchestrate toolkits import command has been added, which works on files in a way that is the inverse of the orchestrate toolkits export command. You can learn more in Importing local MCP toolkits and Importing remote MCP toolkits.Export MCP toolkits
You can now use the ADK CLI to export MCP toolkits. For more information, see Exporting remote MCP toolkits using ADK CLI.AI gateway models in Document Processing
You can now use AI gateway models for KVP extraction in Document Processing nodes. For more information, see Document text extractor node.Important update for existing usersIf you previously used this feature, you must update your model name to include the provider prefix. For example:
- Before:
mistralai/mistral-small-3-1-24b-instruct-2503(deployed on watsonx.ai) - Now:
watsonx/mistralai/mistral-small-3-1-24b-instruct-2503
Groq GPT-OSS Models
watsonx Orchestrate now supports Groq GPT-OSS models. For more information, see Large Language Models.Note:
This model is a non-IBM product governed by a third-party license that may impose use restrictions and other obligations. By using this model you agree to the terms. Read the terms
This model is a non-IBM product governed by a third-party license that may impose use restrictions and other obligations. By using this model you agree to the terms. Read the terms
🐛 Bug fixes
- Deleting agents: Fixed an issue where deleting an agent also deleted the modular knowledge attached to it.
- Importing complex agentic workflows: Fixed an issue where agentic workflows with complex schemas could be imported by ADK but not executed by watsonx Orchestrate.