This documentation supports the 26.1 version of BMC Helix Digital Workplace Basic and BMC Helix Digital Workplace Advanced. Icons distinguish capabilities available only for the Advanced and External license levels. For more information, see the License types and features topic. To view an earlier version, select the version from the Product version menu.

 

Creating surveys with Catalog Curator


Surveys are essential tools for organizations to gather feedback and assess user satisfaction after a service is completed. As a catalog administrator, you can use the AI capabilities of Catalog Curator to create surveys efficiently in BMC Helix Digital Workplace Catalog. Creating surveys manually can be a time-consuming process. Catalog Curator interprets your prompts and generates a summary of survey parameters based on your requirements. You can review the summary, make real-time edits, and finalize the survey by entering an assertive response. This approach reduces manual effort and ensures consistency across feedback forms.

Information
Scenario

Hannah, a catalog administrator at Apex Global, manages IT asset requests for laptops and monitors through the BMC Helix Digital Workplace Catalog. She wants to create a survey to collect feedback on delivery speed and overall satisfaction. Instead of building the survey manually, Hannah uses Survey Assistant in Catalog Curator:

  • She enters a prompt in the chat field: Create a survey to measure satisfaction for IT asset requests with a 5-point star rating. Ask if delivery was timely and include a comment field. Support English, French, and Spanish. No specific delivery restrictions.
  • Catalog Curator generates a survey and displays a tabular summary with attributes such as name, locales, rating scale, and questions.
  • Hannah reviews the summary and decides to make a few changes. She adds an extra question about the packaging of the delivered asset and removes one question that feels redundant.
    She also adds a conditional question that asks for improvement suggestions only if the satisfaction rating is below 3 stars.
  • After reviewing the real-time edits to the summary, she confirms with an assertive reply: "Looks good." The survey has been generated and is ready to be mapped to the relevant catalog services.

Considerations for survey creation by using Catalog Curator

Review the following supported and unsupported scenarios before using the Survey Assistant:

  • For the supported LLM models, see Models in BMC HelixGPT.
  • The supported out-of-the-box agentic skill for creating surveys is Catalog Survey Curator, and the out-of-the-box agent is Catalog Survey Curator. For more information, see Out-of-the-box skills in BMC Helix Digital Workplace.
  • You can translate surveys to all the locales supported by BMC Helix Digital Workplace Catalog. For more information, see Localizing catalog items and  Supported languages and locales.
  • Mapping surveys to specific services is not supported through Catalog Curator.
    You can assign surveys to services only from the Catalog console after they have been created.
  • Accessing the Catalog Curator via the Microsoft Teams interface is not supported.
  • Editing existing surveys through the Catalog Curator chat is not supported.
  • You can set the delivery frequency for the survey through the Catalog Curator chat. For more information, see Survey delivery settings.
  • You can design surveys with the following types of questions:
    Click here to see the supported question types and their configurable details:
    Question TypeConfigurable Details
    CheckboxLabel, Description, Display Value, Stored Value, Required
    Date and TimeLabel, Description, Date Restrictions, Default Value, Required (Operations not supported)
    Dropdown (Single Select)Label, Description, Question Values (Display Value, Stored Value), Required
    Radio ButtonLabel, Description, Question Values, Required
    Text AreaLabel, Description, Default Value, Regular Expression, Required (Operations not supported)
    TextLabel, Description, Default Value, Regular Expression, Required (Operations not supported)

Before you begin

  • Make sure you have set the preferred language model for the out-of-the-box skill. For more information, see  Enabling and configuring Catalog Curator.
  • Make sure that the Catalog Curator is enabled. To configure this setting in the Catalog console, select Application settings > Catalog curator.
  • (Optional) Enable localization if you want to create surveys in multiple locales. In the Catalog console, select Application settings > Service Catalog > Multi-language.
  • (Optional) Select the preferred Rating scale before creating the survey. In the Catalog console, select Application settings > Post-request survey > Rating scale. This scale type is used in the generated surveys with Catalog Curator; otherwise, CSAT is used as the default. When you change the scale type, a confirmation prompt appears, and all available survey templates are automatically updated to align with the new scale type.

To create a survey with Catalog Curator

  1. Log in to the Catalog console as a catalog administrator.
  2. From the navigation panel, select Services > Surveys.
    survey assistant Catalog
  3. Click Survey Assistant.
    The Catalog Curator chat window is launched.
  4. (Optional) Click Guide me to refer to the sample prompt.
  5. Enter a prompt that describes the purpose and requirements of the survey.
    For example,

    Create a survey to assess the onboarding experience for new employees to measure overall satisfaction.
    Ask if the process was clear and if resources were provided on time. Support English and German.


    Survey curator

  6. Review the summary of survey attributes.

    Click here to see interface:

     Survey summary

    The summary contains the following details:

    DetailsAttributes
    Base informationSurvey Name, Languages, Scale Type, Delivery Restrictions
    QuestionnaireLabel, Description, Type, Additional Details
  7. (Optional) Modify survey attributes listed in the summary from the following actions:

    ActionsModification prompt examples
    Add or remove questions
    Add a question: What was the most helpful part, and what could be improved?
    Edit the delivery frequency settings
    Set the delivery frequency to one survey per requester every 30 days.
    Add conditional questions
    Show an additional question asking for improvement suggestions only if the satisfaction rating is below neutral.

    Change the visual for the rating scale (CSAT only)

    Change the rating scale visual from emojis to stars.
    Change the custom label for the rating scales
    Update the NPS label from  “Not likely”  to “Not at all likely.” 
    Change the sequence of the questionsMove Q11 and Q12 below Q7.
    Click here to see interface:

    Survey mod

  8. Confirm by entering an assertive and clear reply, such as 'Create survey' or 'Looks good.'
    After your confirmation, the survey is created. It is active and available for mapping to catalog services.
    Click here to see interface:

    Survey confirm

Click here to view a newly created survey, which is ready to be mapped with services:

 

New survey

You can verify the details, edit if necessary, and then map to the relevant services:

Survey designer view

Information
Best practice
  • We recommend reviewing the generated survey in the Survey Designer interface of the Catalog console before assigning it to services.
    Verify the survey details, including questions, rating scale, delivery settings, and conditional logic, and then map the survey to the relevant catalog services.

  • We recommend starting a new chat topic for each survey when creating multiple surveys in a single Catalog Curator chat session.

Example prompts to create surveys

  • HR services
Create a survey to gather feedback on HR requests.
Include questions about whether the process felt intuitive and quick, and if the issue was resolved as expected.
Add an optional comment field for remarks. The survey should support English, Spanish, and French. No delivery restrictions apply.
  • IT asset requests 
Design a survey to capture feedback on IT asset requests. Ask if the delivery was timely and whether the asset met expectations.
Include an optional comment field for suggestions. Support English and French. Limit delivery to one survey per requester per month.
  • Facilities requests 
Create a survey to evaluate facilities maintenance requests. Ask if the issue was resolved promptly and whether the technician was professional.
Include an optional comment field for additional feedback.
The survey should be available in both English and Spanish. No delivery restrictions apply.
  • Procurement requests 
Create a survey to measure satisfaction with procurement requests.
Ask if the ordering process was straightforward, if delivery met expectations, and provide a comment field for feedback.
Support English, French, and Spanish.

Troubleshooting

IssueDescription

Survey creation fails due to the maximum output tokens showing the following error:

I cannot find any information. Please define your request.

This error indicates that the configured maximum output token limit is insufficient for the request. This behavior relates to the model configuration.
Workaround

Increase the maximum output token value in the model configuration settings.

The red warning indicator is displayed after reordering questions.

The red warning indicator is displayed when a conditional (dependent) question is placed above its parent question. The condition remains, but the question order makes the logic invalid and may affect survey behavior. Catalog Curator does not automatically reorder questions based for conditional logic. 

Workaround:

  • Reorder the questions so the parent question is displayed above the dependent question. If the warning persists, remove the condition and add it again after reordering.
  • Review the questionnaire by using the Survey Designer interface in the Catalog console to confirm that all questions and conditions are configured correctly.
The red warning indicator is displayed after deleting a question or condition.

The red warning indicator is displayed when a parent question or its condition is deleted. Associated conditions are removed automatically, and the dependent question remains flagged for review.

Best practice: Review the flagged question and either remove it or recreate the expected logic. Review the questionnaire by using the Survey Designer interface in the Catalog console to confirm that all questions and conditions are configured correctly.

Where to go from here

After creating a survey using the Survey Assistant, you can assign it to relevant catalog services to collect feedback for specific service requests.
To configure custom surveys and map them to the specific catalog services, see Configuring custom surveys for catalog services.
 

Related topics

Out-of-the-box skills in BMC Helix Digital Workplace

Setting up satisfaction surveys for catalog services

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*

BMC Helix Digital Workplace 26.1