Servicenow_create_change_request_from_problem

plugins/servicenow-change-request-from-problem/.codeblocks/block_0.sh

@@ -0,0 +1,4 @@
+curl --location 'https://<YOUR_DOMAIN>/api/now/table/problem?sysparm_query=descriptionLIKE{{description}}' \
+--header 'Accept: application/json' \
+--header 'Authorization: Bearer <ACCESS_TOKEN>' \
+--header 'Content-Type: application/json'

plugins/servicenow-change-request-from-problem/.codeblocks/block_1.sh

@@ -0,0 +1,11 @@
+curl --location 'https://<YOUR_DOMAIN>/api/now/table/change_request' \
+--header 'Accept: application/json' \
+--header 'Content-Type: application/json' \
+--header 'Authorization: Bearer <ACCESS_TOKEN>' \
+--data '{
+  "short_description": "{{short_description}}",
+  "reason": "{{reason}}",
+  "implementation_plan": "{{implementation_plan}}",
+  "u_problem": "{{u_problem_sys_id}}"
+}'
+

plugins/servicenow-change-request-from-problem/README.md

@@ -1,11 +1,75 @@
 ---
 description: A plugin that allows for the creation a change request from a problem.
-fidelity: IDEA
+fidelity: GUIDE
 name: Create a Change Request from a Problem
+difficulty_level: BEGINNER
+time_in_minutes: 20
 purple_chat_link: https://developer.moveworks.com/creator-studio/developer-tools/purple-chat?conversation=%7B%22startTimestamp%22%3A%2211%3A43+AM%22%2C%22messages%22%3A%5B%7B%22parts%22%3A%5B%7B%22richText%22%3A%22%3Cp%3EI+need+to+create+a+change+request+from+a+problem%3C%2Fp%3E%22%7D%5D%2C%22role%22%3A%22user%22%7D%2C%7B%22parts%22%3A%5B%7B%22richText%22%3A%22I+can+help+with+that.+Do+you+have+an+incident+number+or+a+description+of+the+problem%3F%22%7D%5D%2C%22role%22%3A%22assistant%22%7D%2C%7B%22parts%22%3A%5B%7B%22richText%22%3A%22The+problem+we%27re+having+with+email+server+outages.%22%7D%5D%2C%22role%22%3A%22user%22%7D%2C%7B%22parts%22%3A%5B%7B%22reasoningSteps%22%3A%5B%7B%22richText%22%3A%22Searching+ServiceNow+for+problems+matching+%27email+server+outages%27%22%2C%22status%22%3A%22success%22%7D%5D%7D%2C%7B%22richText%22%3A%22I+found+a+few+problems+in+%3Cb%3EServiceNow%3C%2Fb%3E+related+to+%27email+server+outages%27.+Please+select+the+correct+one%3A%22%7D%2C%7B%22buttons%22%3A%5B%7B%22buttonText%22%3A%22PRB0040192%3A+Intermittent+email+delivery+delays%22%7D%2C%7B%22buttonText%22%3A%22PRB0040188%3A+Users+unable+to+access+shared+mailboxes%22%7D%2C%7B%22buttonText%22%3A%22None+of+these%22%7D%5D%7D%5D%2C%22role%22%3A%22assistant%22%7D%2C%7B%22parts%22%3A%5B%7B%22richText%22%3A%22PRB0040192%3A+Intermittent+email+delivery+delays%22%7D%5D%2C%22role%22%3A%22user%22%7D%2C%7B%22parts%22%3A%5B%7B%22richText%22%3A%22Got+it.+I%27ll+link+this+change+request+to+problem+%3Cb%3EPRB0040192%3C%2Fb%3E.+What+is+the+reason+for+the+change+and+what+is+the+implementation+plan%3F%22%7D%5D%2C%22role%22%3A%22assistant%22%7D%2C%7B%22parts%22%3A%5B%7B%22richText%22%3A%22The+reason+is+to+increase+server+memory+to+handle+peak+load.+The+plan+is+to+schedule+a+maintenance+window+for+Saturday+at+10+PM%2C+apply+the+memory+upgrade%2C+and+monitor+performance+for+2+hours+post-change.%22%7D%5D%2C%22role%22%3A%22user%22%7D%2C%7B%22parts%22%3A%5B%7B%22richText%22%3A%22%3Cp%3EOkay%2C+I%27m+ready+to+submit+the+change+request+in+%3Cb%3EServiceNow%3C%2Fb%3E.%3C%2Fp%3E%3Cul%3E%3Cli%3E%3Cb%3EAssociated+Problem%3A%3C%2Fb%3E+PRB0040192%3C%2Fli%3E%3Cli%3E%3Cb%3EReason+for+change%3A%3C%2Fb%3E+Increase+server+memory+to+handle+peak+load.%3C%2Fli%3E%3Cli%3E%3Cb%3EImplementation+plan%3A%3C%2Fb%3E+Schedule+a+maintenance+window+for+Saturday+at+10+PM%2C+apply+the+memory+upgrade%2C+and+monitor+performance+for+2+hours+post-change.%3C%2Fli%3E%3C%2Ful%3E%3Cp%3E%3Cb%3EShall+I+proceed%3F%3C%2Fb%3E%3C%2Fp%3E%22%7D%2C%7B%22buttons%22%3A%5B%7B%22buttonText%22%3A%22Submit+Change+Request%22%2C%22style%22%3A%22filled%22%7D%2C%7B%22buttonText%22%3A%22Cancel%22%2C%22style%22%3A%22outlined%22%7D%5D%7D%5D%2C%22role%22%3A%22assistant%22%7D%2C%7B%22parts%22%3A%5B%7B%22richText%22%3A%22Submit+Change+Request%22%7D%5D%2C%22role%22%3A%22user%22%7D%2C%7B%22parts%22%3A%5B%7B%22reasoningSteps%22%3A%5B%7B%22richText%22%3A%22Creating+change+request+from+problem+PRB0040192+in+ServiceNow%22%2C%22status%22%3A%22success%22%7D%5D%7D%2C%7B%22richText%22%3A%22Done%21+I%27ve+submitted+change+request+%3Cb%3ECHG0070221%3C%2Fb%3E%2C+which+is+now+linked+to+problem+%3Cb%3EPRB0040192%3C%2Fb%3E.%22%7D%2C%7B%22citations%22%3A%5B%7B%22citationTitle%22%3A%22CHG0070221%22%2C%22connectorName%22%3A%22servicenow%22%7D%5D%7D%5D%2C%22role%22%3A%22assistant%22%2C%22showFeedbackTray%22%3Atrue%7D%5D%7D
 solution_tags:
 - IT
 systems:
 - servicenow
 
 ---
+## Introduction
+
+The **“Create Change Request from Problem”** plugin empowers IT teams to quickly generate a **Change Request** in **ServiceNow** directly from an existing **Problem record** using the Moveworks AI Assistant. This streamlines the change management process by eliminating manual steps, ensuring better tracking, and enabling faster resolution of issues that require infrastructure or process changes.
+
+This guide will walk you through installing and configuring the plugin in **Agent Studio** in just a few minutes. Let’s get started!
+
+## **Prerequisites**
+
+- Access to Agent Studio
+
+### Agent Design
+
+This [purple chat](https://developer.moveworks.com/creator-studio/developer-tools/purple-chat?conversation=%7B%22startTimestamp%22%3A%2211%3A43+AM%22%2C%22messages%22%3A%5B%7B%22parts%22%3A%5B%7B%22richText%22%3A%22%3Cp%3EI+need+to+create+a+change+request+from+a+problem%3C%2Fp%3E%22%7D%5D%2C%22role%22%3A%22user%22%7D%2C%7B%22parts%22%3A%5B%7B%22richText%22%3A%22I+can+help+with+that.+Do+you+have+an+incident+number+or+a+description+of+the+problem%3F%22%7D%5D%2C%22role%22%3A%22assistant%22%7D%2C%7B%22parts%22%3A%5B%7B%22richText%22%3A%22The+problem+we%27re+having+with+email+server+outages.%22%7D%5D%2C%22role%22%3A%22user%22%7D%2C%7B%22parts%22%3A%5B%7B%22reasoningSteps%22%3A%5B%7B%22richText%22%3A%22Searching+ServiceNow+for+problems+matching+%27email+server+outages%27%22%2C%22status%22%3A%22success%22%7D%5D%7D%2C%7B%22richText%22%3A%22I+found+a+few+problems+in+%3Cb%3EServiceNow%3C%2Fb%3E+related+to+%27email+server+outages%27.+Please+select+the+correct+one%3A%22%7D%2C%7B%22buttons%22%3A%5B%7B%22buttonText%22%3A%22PRB0040192%3A+Intermittent+email+delivery+delays%22%7D%2C%7B%22buttonText%22%3A%22PRB0040188%3A+Users+unable+to+access+shared+mailboxes%22%7D%2C%7B%22buttonText%22%3A%22None+of+these%22%7D%5D%7D%5D%2C%22role%22%3A%22assistant%22%7D%2C%7B%22parts%22%3A%5B%7B%22richText%22%3A%22PRB0040192%3A+Intermittent+email+delivery+delays%22%7D%5D%2C%22role%22%3A%22user%22%7D%2C%7B%22parts%22%3A%5B%7B%22richText%22%3A%22Got+it.+I%27ll+link+this+change+request+to+problem+%3Cb%3EPRB0040192%3C%2Fb%3E.+What+is+the+reason+for+the+change+and+what+is+the+implementation+plan%3F%22%7D%5D%2C%22role%22%3A%22assistant%22%7D%2C%7B%22parts%22%3A%5B%7B%22richText%22%3A%22The+reason+is+to+increase+server+memory+to+handle+peak+load.+The+plan+is+to+schedule+a+maintenance+window+for+Saturday+at+10+PM%2C+apply+the+memory+upgrade%2C+and+monitor+performance+for+2+hours+post-change.%22%7D%5D%2C%22role%22%3A%22user%22%7D%2C%7B%22parts%22%3A%5B%7B%22richText%22%3A%22%3Cp%3EOkay%2C+I%27m+ready+to+submit+the+change+request+in+%3Cb%3EServiceNow%3C%2Fb%3E.%3C%2Fp%3E%3Cul%3E%3Cli%3E%3Cb%3EAssociated+Problem%3A%3C%2Fb%3E+PRB0040192%3C%2Fli%3E%3Cli%3E%3Cb%3EReason+for+change%3A%3C%2Fb%3E+Increase+server+memory+to+handle+peak+load.%3C%2Fli%3E%3Cli%3E%3Cb%3EImplementation+plan%3A%3C%2Fb%3E+Schedule+a+maintenance+window+for+Saturday+at+10+PM%2C+apply+the+memory+upgrade%2C+and+monitor+performance+for+2+hours+post-change.%3C%2Fli%3E%3C%2Ful%3E%3Cp%3E%3Cb%3EShall+I+proceed%3F%3C%2Fb%3E%3C%2Fp%3E%22%7D%2C%7B%22buttons%22%3A%5B%7B%22buttonText%22%3A%22Submit+Change+Request%22%2C%22style%22%3A%22filled%22%7D%2C%7B%22buttonText%22%3A%22Cancel%22%2C%22style%22%3A%22outlined%22%7D%5D%7D%5D%2C%22role%22%3A%22assistant%22%7D%2C%7B%22parts%22%3A%5B%7B%22richText%22%3A%22Submit+Change+Request%22%7D%5D%2C%22role%22%3A%22user%22%7D%2C%7B%22parts%22%3A%5B%7B%22reasoningSteps%22%3A%5B%7B%22richText%22%3A%22Creating+change+request+from+problem+PRB0040192+in+ServiceNow%22%2C%22status%22%3A%22success%22%7D%5D%7D%2C%7B%22richText%22%3A%22Done%21+I%27ve+submitted+change+request+%3Cb%3ECHG0070221%3C%2Fb%3E%2C+which+is+now+linked+to+problem+%3Cb%3EPRB0040192%3C%2Fb%3E.%22%7D%2C%7B%22citations%22%3A%5B%7B%22citationTitle%22%3A%22CHG0070221%22%2C%22connectorName%22%3A%22servicenow%22%7D%5D%7D%5D%2C%22role%22%3A%22assistant%22%2C%22showFeedbackTray%22%3Atrue%7D%5D%7D) shows the experience we are going to build.
+
+## **Installation Steps**
+
+We recommend setting up **ServiceNow** before installing this plugin. Please follow the [ServiceNow Connector](https://developer.moveworks.com/marketplace/package/?id=servicenow&hist=home%2Cbrws#how-to-implement) guide to configure the connection.
+
+Ensure the following permissions are granted:
+
+- **Table Access**: `Read` access to the `problem` table and `Create` access to the `change_request` table
+- **Field Access**: `Read` access to the necessary problem fields and `Write` access to fields required for creating a change request
+
+Once the connector is successfully configured, follow our [plugin installation documentation](https://help.moveworks.com/docs/ai-agent-marketplace-installation) for detailed steps on how to install and activate the plugin in **Agent Studio**.
+
+## **Appendix**
+
+### API #1: Get Problem Records by Description
+
+```bash
+curl --location 'https://<YOUR_DOMAIN>/api/now/table/problem?sysparm_query=descriptionLIKE{{description}}' \
+--header 'Accept: application/json' \
+--header 'Authorization: Bearer <ACCESS_TOKEN>' \
+--header 'Content-Type: application/json'
+```
+
+**Query Parameters:**
+
+- `description` (string) – A keyword or phrase to match against the problem's description field
+
+### API #2: Create a Change Request from a Problem
+
+```bash
+curl --location 'https://<YOUR_DOMAIN>/api/now/table/change_request' \
+--header 'Accept: application/json' \
+--header 'Content-Type: application/json' \
+--header 'Authorization: Bearer <ACCESS_TOKEN>' \
+--data '{
+  "short_description": "{{short_description}}",
+  "reason": "{{reason}}",
+  "implementation_plan": "{{implementation_plan}}",
+  "u_problem": "{{u_problem_sys_id}}"
+}'
+
+```
+
+**Request Body Fields:**
+
+- `short_description` (string) – A brief summary of the change request
+- `reason` (string) – The reason for initiating the change
+- `implementation_plan` (string) – The plan detailing how the change will be implemented
+- `u_problem` (string) – The `sys_id` of the related problem record