Enabling watsonx/* LLMs

The watsonx Orchestrate Developer Edition now supports integration with the wxO SaaS tenant for LLM inferencing. Previously, developers were required to configure the Developer Edition using their own watsonx.ai API key and Space ID. This update simplifies the setup process by enabling proxy usage through Watsonx Orchestrate.

Prerequisites

To retrieve the necessary configuration details, you must have access to an instance of watsonx Orchestrate.

Environment Configuration

Additional environment variables are required to enable proxy usage. These variables differ based on the deployment type:

SaaS Deployment
On-premises Deployment

Common Parameters

Variable	Description
`AUTHORIZATION_URL`	IAM URL used to authorize watsonx Orchestrate to access the proxy service.
`USE_SAAS_ML_TOOLS_RUNTIME`	Enables the ADK to use the proxy.

SaaS Deployment Configuration

For SaaS deployments, use the following environment variables:

WO_API_KEY=<your API key for Watson Orchestrate on SaaS>
WO_INSTANCE=<your service instance URL>
# The below two fields are optional and automatically inferred by the Developer Edition
AUTHORIZATION_URL=<your IAM URL>
USE_SAAS_ML_TOOLS_RUNTIME=True

Note:
watsonx.ai API Key and Space ID are no longer required.

On-premises Deployment Configuration

For on-premises deployments, use the following environment variables:

authenticating with password
authenticating with API key

WO_USERNAME=<your username for onprem>
WO_PASSWORD=<your password for onprem>
WO_INSTANCE=<your service instance URL>
AUTHORIZATION_URL=<your IAM URL>

Variable	Description
`WO_USERNAME`	Username used to log in to IBM SoftwareHub.
`WO_PASSWORD`	Password associated with `WO_USERNAME`.
`WO_INSTANCE`	watsonx Orchestrate server instance URL
`AUTHORIZATION_URL`	Optional, an IAM URL used to authorize watsonx Orchestrate to access the proxy service.

WO_USERNAME=<your username for onprem>
WO_API_KEY=<your API key for onprem>
WO_INSTANCE=<your service instance URL>
AUTHORIZATION_URL=<your IAM URL>

Variable	Description
`WO_USERNAME`	Username used to log in to IBM SoftwareHub.
`WO_API_KEY`	API key associated with `WO_USERNAME`.
`WO_INSTANCE`	watsonx Orchestrate server instance URL
`AUTHORIZATION_URL`	Optional, an IAM URL used to authorize watsonx Orchestrate to access the proxy service.

Release Notes

Get Started

Build

Analyze

watsonx Orchestrate Developer Edition

watsonx Orchestrate ADK MCP Server

Reference

Legal notices

Prerequisites

Environment Configuration

Common Parameters

SaaS Deployment Configuration

On-premises Deployment Configuration

​Prerequisites

​Environment Configuration

​Common Parameters

​SaaS Deployment Configuration

​On-premises Deployment Configuration

Prerequisites

Environment Configuration

Common Parameters

SaaS Deployment Configuration

On-premises Deployment Configuration