Setting up the IBM Software Hub AI assistant

The IBM Software Hub AI assistant is a specialized assistant that can help you use the platform more efficiently and effectively.

Important: You must purchase IBM Software Hub Premium to use the IBM Software Hub AI assistant.
Who needs to complete this task?
Most of the tasks require one of the following permissions:
  • Administer platform
  • Manage configurations
However, some tasks must be completed by an instance administrator because they require access to the OpenShift® command-line interface.
When do you need to complete this task?
Complete this task if you want to use the IBM Software Hub AI assistant.

Before you begin

Open a support ticket to obtain the credentials for the gen AI agent on IBM Cloud.
Entitled access

If you purchased IBM Software Hub Premium, open a support ticket to register and receive your credentials:

  1. Visit IBM Support Portal and sign in with your IBM ID.
  2. Open a case with the following title:
    IBM Software Hub AI Assistant - Registration
  3. In the Product field, select Cloud Pak for Data.
  4. In the Version field enter the version of IBM Software Hub that is installed on your cluster.
  5. Set the Severity to 3.
  6. In the Support Case field, enter the following text:
    Description: 
Dear IBM Customer Experience Team,

We are using IBM Software Hub and would like to integrate with the AI Assistant.
Please provide an API Key to enable access to the AI Assistant's functionality.

Our product entitlement is active and we are currently licensed users.

Thank you,
[Your Name]
Trial access (60 days)

If you do not have IBM Software Hub Premium, you can request a 60 day trial.

To request trial access:

  1. Visit IBM Support Portal and sign in with your IBM ID.
  2. Open a case with the following title:
    IBM Software Hub AI Assistant - Trial Request
  3. In the Product field, select Cloud Pak for Data.
  4. In the Version field enter the version of IBM Software Hub that is installed on your cluster.
  5. Set the Severity to 3.
  6. In the Support Case field, enter the following text:
    Description: 
Dear IBM Customer Experience Team,

We are evaluating IBM Software Hub AI Assistant for internal use and would like 
to request a 60-day trial API key to explore its features and capabilities.  

Please grant us trial access for the AI Assistant.  

We understand this is for evaluation purposes only.

Thank you,
[Your Name]

The IBM Support team will provide your API key through the support ticket. You will also receive an email from SWHub.GenAI@ibm.com with details on accessing the API key.

About this task

The IBM Software Hub AI assistant service runs on your cluster and connects to a gen AI agent on IBM Cloud.

Tip: If your IBM Software Hub installation is in a restricted network, you can use a proxy server to connect to agent.
After you set up the assistant, the assistant can query your environment to answer questions such as:
  • What version of IBM Software Hub is installed?
  • What services are installed?
  • What is the current vCPU quota for the instance?
  • Which pods are using the most memory?
In addition, the assistant is trained on the product documentation and can help you learn how to configure your environment. For example, you can ask the assistant how to:
  • Set quotas in IBM Software Hub
  • Get notified when a service exceeds its quota
  • Make your environment more secure
  • Troubleshoot problems that occur when installing or upgrading IBM Software Hub
Important: The responses that are returned by the IBM Software Hub AI assistant are created using generative AI, which might produce inaccurate advice.

All recommendations should be reviewed by a knowledgeable user before they are implemented.

Procedure

To set up the IBM Software Hub AI assistant: