Managing access for remote environments
To change your environments in the ADK, you must provide the ADK with your service instance URL and your watsonx Orchestrate API key. Currently, watsonx Orchestrate as a service (SaaS) is deployed in both IBM Cloud and AWS. Depending on which environment you have a valid account, the process to retrieve this information can vary.
The ADK is unable to connect to on-premises environments. Support for IBM Software Hub and IBM Cloud Pak for Data will come in later releases.
IBM Cloud
To connect to IBM Cloud, you need both the service instance URL and an API key of your watsonx Orchestrate instance.
Don’t use the credentials that you get from the IBM Cloud resources page. Use the following procedure to get the appropriate API key and service instance URL.
Log in to your watsonx Orchestrate instance.
Click your user icon on the top right and click Settings.
Go to the API details tab.
Copy the service instance URL.
Click the Generate API key button.
Generate an API Key
The page redirects you to the IBM Cloud Identity Access Management center. Click Create to create a new API Key.
Enter a name and a description for your API Key.
Copy the API key and store it in a safe vault.
Add and activate your environment with the ADK CLI:
For more information, see Configuring your environments.
AWS
To connect to an instance hosted on AWS, follow these steps:
Log in to your watsonx Orchestrate instance.
Click your user icon on the top right and click Settings.
Go to the API details tab.
Copy the service instance URL.
Generate API key
Click the Generate API key button and copy the key.
- API keys are not retrievable and can’t be edited or deleted. Make sure to store your API keys in a safe location after you generate a new API key.
- You are limited to 10 API keys in this environment. If you have no more available keys, contact IBM Support for further assistance.
Add and activate your environment with the ADK CLI:
For more information, see Configuring your environments.