Filtering with the AI Filter Assistant

AAI leverages GenAI (generative artificial intelligence) technology to make filtering lists on AAI pages and views easier and more natural for you by allowing you to enter natural language descriptions of what you want to filter for rather than going through prescribed steps. This topic explains where you can use the AI Filter Assistant and how to use it.

For AAI administrators, see Preparations and Considerations for the AI Filter Assistant.

Using the AI Filter Assistant

This section gives you some tips with general understanding about the AI Filter Assistant that can be helpful to understand how it works and its capabilities and limitations. Then it provides steps for how you use the AI Filter Assistant to build your own filter statements in easily with prompts in your own natural language.

Tips about the AI Filter Assistant

When using the AI Filter Assistant it can be helpful to know the following characteristics about it:

• Optional system-wide feature: The AI Filter Assistant is an optional feature that needs to be enabled by your AAI administrator.  

• Wherever you have standard filters: When the AI Filter Assistant is enabled, it is available wherever you see the standard, blue filter button .  

• What you can filter on: You can use the AI Filter Assistant to filter for anything that you can filter in the standard way of selecting filter parameters and defining criteria. If you cannot filter on a specific field in the standard method, the AI Filter Assistant cannot filter on that field either.

• Builds filter criteria additively: You can use the AI Filter Assistant in combination with defining filter criteria in the standard way (by selecting attributes and specifying values from the filter drop-down). For each query that you enter in the AI Filter Assistant, the filter criteria are added to any other filters that are already applied. In this way, you can build complex filters incrementally.

Filtering with the AI Filter Assistant

For any page where you see the blue, standard filter button , use the following steps on the page to filter the list using the AI Filter Assistant.

1. Click the filter button in the far left of the toolbar to open the filter drop-down.

2. Select AI Filter Assistant at the top of the list.

   Note:

   If you do not see the AI Filter Assistant option, then this feature has not been enabled in your AAI system. Contact your AAI administrator for help.

3. Enter a filter request in natural language. For example:

   • Show me jobstreams for the Finance business area

   • Please filter for jobstreams that had failed runs in the last 48 hours

   • I want to see jobstreams that begin with 'fin' and ran in the last two days or is forecasted to run in the next two days.

   You can also enter requests in telegraph style prompts, that is, with just the essential words and without a question form, or articles, punctuation, or other connecting words. For example:

   • jobstreams in finance business area

   • failed runs last 48 hrs

   • name starts with fin and runs for last 2 days or next 2 days

4. Click Add.

   Result: The filter criteria that you described are added to the existing filter criteria in the toolbar in the standard format, and the list is filtered accordingly.

   For example, if the list was already filtered for the Finance business area, and your request was "show me failed runs," the filter would now contain Business Area = Finance, SLAStatus = [failed], Date = [past 2 days]

   Tip:

   Check that the AI Filter Assistant had correctly interpreted your request. As a young AI tool, it is still learning our human language in AAI.

5. Continue to enhance and modify the filter as follows:

   • Add more criteria with the AI Filter Assistant in the same way to narrow the resulting list further.

   • Remove a filter parameter as you do with any filter parameter on the toolbar, click the x in the right of the bubble.

   • Change the parameter values by clicking the down arrow in the left of the bubble and then changing the selection or options.

   As with all filters, remove all filter changes and return to the saved version of the current view of the Jobstream Runs Grid page, select Reset Filter. You cold also click Save a Copy to create a new saved view.

Examples of Using the AI Filter Assistant

The following are examples of how you can build filter statements with the AI Filter Assistant:

EXAMPLE 1

Starting at the Jobstream Runs Grid page, enter the following series of prompts in the AI Filter Assistant:

1. Prompt: show me runs where name contains dev

   Result: Jobstream Name : [ = *dev*]

   Notice that you don't have to say "jobstream name" and the AI Filter Assistant knows the context is jobstreams.

2. Prompt: I want to see runs with alerts

   Result: Jobstream Name : [ = *dev*] Number of Alerts : [ > 0 ]

   Notice that the AI Filter Assistant added the new criteria to the existing one, thus building the filter statement to further narrow down the list of jobstream runs.

3. Prompt: with 100 or more jobs

   Result: Jobstream Name : [ = *dev* ] Number of Alerts : [ > 0 ] Total Jobs : [ > 100 ]

   The AI Filter Assistant interprets your prompt and builds a criterion based on the appropriate field.

EXAMPLE 2

Again, starting at the Jobstream Runs Grid page, enter the following series of prompts in the AI Filter Assistant:

1. Prompt: Show me all runs in last 3 days and next 2 days in NPTF

   Result: Date Range: [= Last 3 Days to Next 2 Days], SLA Status: [= NPTF]

2. Prompt: On Automic schedulers

   Result: Date Range: [= Last 3 Days to Next 2 Days], SLA Status: [= NPTF] Scheduler = [ *Automic*]

   Remember, that you can only filter on attributes that you can filter on in the standard way. When you open the filter options on the Jobstream Runs Grid page, you see Scheduler as an attribute and its values are scheduler names, not scheduler types. So the AI Filter Assistant has filtered on all schedulers with Automic in their names, not on schedulers of the Automic type. If you had an Automic scheduler named "NewYork AA", the AI Filter Assistant would not pick it up.

   That's why it is important that you check the generated filter to be sure they are filtering as you intend.