---
sourceDocument: Xanadu Enable AI
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/xanadu/intelligent-experiences

 Release :

    - xanadu

ft:locale :

    - en-US

ft:publication_title :

    - Xanadu Enable AI

ft:clusterId :

    - platai

bundleId :

    - platai

workflow :

    - Platform


---

# Use a script with Generative AI Controller

# Use a script with Generative AI Controller {#ariaid-title1}

* Release version: Xanadu
* 
* Updated August 1, 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 minute to read

Use background scripts and Generative AI Controller Generic Prompt to interact directly with the generative AI model API.

## Before you begin

You must be on Vancouver patch 2 or above to script with `sn_one_extend.OneExtendUtil` objects.

Role required: admin

## About this task

With scripting, you have greater flexibility in how you use Generative AI Controller capabilities across the platform. By accessing the capability programmatically, you can capture the LLM's response and use that to determine next actions.

For more information on tracking Generative AI Controller usage, see [Monitoring Now Assist usage](https://www.servicenow.com/docs/access?context=monitoring-now-assist-usage&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US).

## Procedure

1. Navigate to AllSystem DefinitionScripts - Background.
2. Create the text content for a Generic Prompt by creating a `request` array with a singular `executionRequests` object.
3. Inside the `executionRequests`, add the `payload` and `capabilityID` attributes.  
   The `capabilityID` is the sys_id of the capability on the OneExtend Capabilities (sys_one_extend_capability) table, such as Generic Prompt.
4. Add the required inputs as attributes in the `payload` object.  
   {#script-with-generative-ai__entry__2}

   | Capability | Required attributes |
   |-|-|
   | Generic Prompt | prompt: Prompt for the generative AI to respond to. |
   | Generate Content | topic: Subject for content generation. |
   | Sentiment Analysis | utterance: Text to analyze for user sentiment. |
   | Summarize | textToSummarize: Topic for the AI to generate a summary. |
   [ ]

   The following is an example `request` array for the Generic Prompt capability.

       var request = {
          "executionRequests": [
           {
              "payload": {
                 "prompt": "Can you act like my business partner and give me some advice on a pitch?"
               },
               "capabilityId": "0c90ca79533121106b38ddeeff7b12d7"
            }
         ]
       };

5. Call the `execute` method on sn_one_extend.OneExtendUtil.
6. **Optional:** To display the response after running the background script, print the response in readable JSON by using the following code:  

       gs.info(JSON.stringify(sn_one_extend.OneExtendUtil.execute(request)));

*[\>]: and then