Configure Group Action Framework

Set up Group Action Framework (GAF) to improve the response quality, recall speed, and consistency of AI agents.

Before you begin

There must be a ml_platform read ACL for GAF to be configured. If there is no read ACL present, you must create it and grant the appropriate role access, such as admin, ml_admin, or sn_aia.admin. This is required for GAF to access Machine Learning tables and services. If your ACL is not configured correctly, you may see the error "Failed to initialize pipeline: Failed to load message_content dataset. No columns to parse from file."

To access GAF's optimized prediction feature, you can enable Now Assist in AI Search. For more information, see Setup AI Search for Group Action Framework.

Role required: sn_aia.admin

About this task

You can activate GAF to have AI agents use indexed clusters that perform LLM executions on representative records rather than all records. GAF is used by some AI agents and agentic workflows to work optimally. For more information about GAF and how it works, see Group Action Framework.

You can have different GAF configurations for different agentic workflows and Now Assist applications. You must configure each agentic workflow or application separately.

Important:

Setting up GAF can take some time, between 10 minutes up to an hour, depending on the number of records in the grouping. The script runs in the background.

Procedure

1. Navigate to All > System Definition > Scripts - Background.
2. Paste the following code into the text area.

   Do not run the script until the groupSkillID and the actionSkillID variables have values. The values are acquired in the following steps.

   var groupSkillId = ""; 
                           var actionSkillId = ""; 
                           var topicSkillId = "43bce9e477e012103f075cea5b5a998f"; 
                           new sn_gaf.GAFUtils().activate(groupSkillId, topicSkillId, actionSkillId, "run_once");

   The topicSkillId is the same for all GAF setups.

3. In a new browser tab, navigate to the Now Assist Skill Config [sn_nowassist_skill_config] table by entering sn_nowassist_skill_config.list in the filter navigator.
4. In the Name field, enter *grouping and search to see the grouping records that are associated with your agentic workflows and Now Assist applications.

   

5. Open the grouping record for the agentic workflow or application that you want to configure.
6. In the Now Assist Config Var Set related list, open the Grouping inputs record.
7. Confirm that the filters for the grouping include all the records you want to index.
   If you want to add filters to change what records are included in the GAF setup, do so here. The more records that you include means that you have a longer setup time, but they can help increase the quality of your results. You should have at least 2000 records for successful clustering.

   Note:

   Your current scope should be Group-Action Framework to make changes.

   

8. Return to the Now Assist Skill Config Grouping record and copy the sys_id.
   You use this sys_id and two other sys_ids in the background script function call.
9. In the browser tab with the background script, paste the sys_id in the script between the quotation marks for the groupSkillId variable.

   Your groupSkillId variable should be in the same format as the topicSkillId variable.

10. In the tab with the Now Assist Skill Config record, return to the Now Assist Skill Config table and search for *action strategy to find the action strategy skill config for the application.
    Make sure that the record is for the same application. If you pasted the sys_id of the GAF ITSM grouping, you must open the GAF ITSM action strategy.
11. Open the action strategy record for the application that you’re configuring.
12. Copy the sys_id of the action strategy record.
13. In the browser tab with the background script, paste the sys_id in the script between the quotation marks for the actionSkillId variable.

    Your actionSkillId variable should be in the same format as the groupSkillId and topickillId variables.

    

14. Run the background script by selecting Run script.

    Running this background script creates a scheduled job called GAF - Run Offline Flow. You can view the scheduled job on the Scheduled Script Executions [sysauto_script] table. If you want to run the script immediately, open the Scheduled Script Execution record and select Execute Now.

    The script runs in the background.

Result

GAF is configured on your instance for that Now Assist application and can be used by AI agents to find related records.

What to do next

To verify that grouping and action outputs have been generated, go to the ML Solution [ml_solution] table to check if the clustering solution is running or completed. If it is complete, check the following tables to see records for groups, clustered records, and down-sampled records per group are present.

• GAF record group [sn_gaf_record_group]
• GAF record group detail [sn_gaf_record_group_detail]
• GAF action strategy result [sn_gaf_action_strategy_result]

You can repeat this procedure for additional agentic workflows and Now Assist applications.

You may see the error "Failed to initialize pipeline: Failed to load message_content dataset. No columns to parse from file." when trying to configure GAF. This could be because your instance lacks data on the table or filters you configured excluded records from the table. You can reach out to Now Support for additional assistance if you cannot resolve this error.