Generating prompts automatically from catalog services
As an administrator, to reuse the data from catalog services in BMC HelixGPT, you must publish it into HelixGPT. The published data is automatically converted to prompts in the format required for HelixGPT. The prompts are then available in the specified skill in HelixGPT for use. The router prompt is automatically updated with the newly imported data.
By reusing the data, you can reduce the task of manually creating prompts for catalog services.
Types of service fulfillment questions that are supported in chat
The following table lists the question types that BMC HelixGPT supports:
Question type | Supported? |
---|---|
Text area | ✅️ |
Text field | ✅️ |
Radio button | ✅️ |
Counter | ✅️ |
Toggle | ✅️ |
Date/Time | ✅️ |
Date | ✅️ |
Attachment | ✅️ |
Lookup (type-ahead or predicted text) Important: If real-time translation is enabled, lookups cannot provide options for partial words. End-users must enter the complete word to view the options. | |
Table | ❌️ |
Question with an option value whose length is greater than 64 | ❌️ |
Before you begin
Create a new skill in BMC HelixGPT into which you want to import the service catalog data as a prompt. Learn how to create a skill in creating and managing skills
You can't update out-of-the-box (OOTB) sample skills that are available for BMC Helix Digital Workplace. Instead, you must create a new skill to which you want to publish the service catalog data as a prompt. For more information about the available OOTB sample skills, see Out-of-the-box-skills-in-BMC-Helix-Digital-Workplace
To publish catalog services to BMC HelixGPT
- Log in to BMC Helix Innovation Studio.
- Select Workspace > HelixGPT Manager.
- Select Actions > Publish chat-enabled services.
- In the Publish Chat-enabled Service pane, on the Cognitive Service Provider tab, select BMC HelixGPT.
- Select the name of the application for which you want to generate prompts.
- Select the Skill Name to which you want to import the prompt, and click Next.
The services are displayed on the Service to Chat-enabled tab based on the catalog items you select. - Select the catalog services that you want to reuse in HelixGPT, and click Next.
- On the User Request tab, define the variations that users might ask in the chatbot, and click Next.
- On the Questions tab, define the natural language expression of the question, and click Next.
- On the Publication tab, review the details, and click Publish.
After publishing the catalog services to HelixGPT, the prompts are added to your selected skill. Verify that the prompts are generated correctly. If not, make the required changes and republish the catalog services.
Service modifications displayed when republishing a service
When you republish a service, the values changes in the Publish chat-enabled service wizard take precedence over changes made in BMC Helix Digital Workplace Catalog or BMC HelixGPT.
The following table lists the modifications to the service definitions that are displayed when republishing:
Modification to the service | Displayed when republishing? |
---|---|
Variations added to the user request | ✅️ |
A mandatory question is made optional (the Include question field value is changed) | ✅️ |
An optional question is made mandatory (the Include question field value is changed) | ❌️ Important: Because this change might result in broken data, this modification is not displayed. |
Modified the natural language expression of the question | ✅️ |
Changes made to the default answer | ✅️ |
Changes made to the prompt to confirm the default answer | ✅️ |
Changes made to the option to display the answers as buttons | ✅️ |
Label field in BMC Helix Digital Workplace Catalog | ✅️ |
Default value field in BMC Helix Digital Workplace Catalog | ✅️ |
Question Values (Toggle, drop-down, check box) field in BMC Helix Digital Workplace Catalog | ✅️ |
Required field in BMC Helix Digital Workplace Catalog | ✅️ |
While publishing a service from BMC Helix Digital Workplace Catalog to BMC HelixGPT, you can add input variations and change the natural language questions. These changes are preserved even after the service is published.
Best practices
Use the following best practices to use the automatically generated prompts in BMC HelixGPT:
- A generated prompt works best with the supported models.For more information about the supported models and the default model configuration values, see Models-in-BMC-HelixGPT.
- Create a new skill in HelixGPT to import the automatically generated prompts.
- Copy the instructions of an existing router prompt. Create a new router prompt for the new skill, and reuse the copied instructions for the new router prompt.
- A generated prompt works best if you use the model that supports JSON response.