Handle system-level data using Creatio AI in the business process

Level: intermediate

To implement the example:

1. Develop AI Skill. Read more >>>
2. Implement a business process that runs the AI Skill. Read more >>>
3. Set up the page UI. Read more >>>

Example

Display summarized information of a specific contact on a "Retrieve the summarized contact information" page. The "Summarize contact information" business process generates the "Retrieve the summarized contact information" page and handles the retrieved data using Creatio AI. The page has the following parameters:

• Outcome of the Creatio AI work that contains the Full name, Birth date, Full job title, Business phone of the contact. The data is handled by Creatio AI.
• Status of the Creatio AI execution
• Error message

1. Develop AI Skill

1. Open the Customer 360 app in the No-Code Designer.

2. Open the Advanced settings tab in the No-Code Designer. To do this, click in the top right → Application management → Application Hub → Customer 360 app → Advanced settings.

3. Create a user-made package to develop AI Skill. To do this, click → Create new package → fill out the package properties → Save.

   For this example, create the sdkCreatioAIInBusinessProcess user-made package.

4. Change the current package. Instructions: Change the current package.

   For this example, change the current package to sdkCreatioAIInBusinessProcess user-made package.

5. Open the Creatio AI setup section. To do this, click in the top right → System setup → Creatio AI setup.

6. Add an AI Skill. To do this, click New.

7. Fill out the properties of the AI Skill.

   Property	Property value
   Title*	Contact summary
   Description*	AI Skill that summarizes contact information
   Status*	Active
   Usage mode*	API

8. Specify the user's goal when using the AI Skill.

   Property	Property value
   Prompt	Your task is to summarize the following contact information: Full name, Birth date, Full job title, Business phone.

9. Specify input parameters of AI Skill.

   1. Go to the Input parameters block.

   2. Click New.

   3. Fill out the parameter properties.

      Code	Name	Description	Data type
      ContactName	Contact name	Parameter that contains contact name	Text (500 characters)
      ContactInfo	Contact info	Parameter that contains detailed contact information	Unlimited length text

10. Specify output parameters of AI Skill.

    1. Go to the Output parameters block.

    2. Click New.

    3. Fill out the parameter properties.

       Code	Name	Description	Data type
       CreatioAIResult	Outcome of the Creatio AI work	Parameter that contains the outcome of the Creatio AI work	Text (500 characters)
       ExecutionStatus	Status of the Creatio AI execution	Parameter that contains the status of the Creatio AI execution	Text (500 characters)

11. Save the changes.

As a result, Creatio will add the "Contact summary" AI Skill to the Creatio AI setup section.

2. Implement a business process that runs the AI Skill

1. Create a business process

1. Open the Customer 360 app in the No-Code Designer.

2. Open the Advanced settings tab in the No-Code Designer. To do this, click in the top right → Application management → Application Hub → Customer 360 app → Advanced settings.

3. Select a user-made package to create a business process.

   For this example, select the sdkCreatioAIInBusinessProcess user-made package.

4. Create the business process schema. To do this, click Add → Business process.

5. Open the Settings tab.

6. Fill out the schema properties.

   For this example, use the following schema properties.

   Property	Property value
   Title	Summarize contact information
   Code	UsrSummarizeContactInformation

7. Save the changes.

As a result:

• The "Summarize contact information" business process will be created.
• Creatio will add the "Summarize contact information" business process to the Process library section.

2. Set up the business process parameters

1. Open the properties of the business process schema. To do this, click an arbitrary place in the working area of the Process Designer.

2. Open the Parameters tab.

3. Add the business process parameters.

   For this example, add the parameter that contains the list of contacts. To do this:

   1. Click Add parameter and select a parameter of the needed type.

   2. Fill out the parameter properties.

      Element	Element type	Property	Property value
      Parameter that contains the list of contacts	Lookup	Title	Contact
      		Code	ContactList
      		Data type	Lookup
      		Lookup	Contact
      		Direction	Input

As a result, the Parameters tab of the "Summarize contact information" business process will be as follows.

3. Implement reading contact information

1. Add a Read data element. To do this, click → place the Read data element between the Simple and Terminate page elements in the working area of the Process Designer.

2. Fill out the element properties.

   Property	Property value
   Title	Read contact information
   Which object to read data from?	Contact
   How to filter records?	Click Add condition. This opens the Select column window. Select "Id" in the Column property. Click Select. Select Compare with Parameter. This opens the Select parameter window. Select the parameter. To do this, open the Process parameters tab → click Contact → Select.

   Leave default values for other element properties.

3. Save the changes.

As a result:

• The setup area of the "Read contact information" element will be as follows.

  

• The diagram of the "Summarize contact information" business process will be as follows.

  

4. Implement running the AI Skill

1. Add a Call Creatio AI element. To do this, click → place the Call Creatio AI element between the Read data system action and Terminate page element in the working area of the Process Designer.

2. Fill out the element properties.

   Property	Property value
   Title	Run the AI Skill
   Which skill to call?	Contact summary
   Contact info	Click → Formula. This opens the Formula window. Add the formula: "Birth date: " + [#Read contact information.First item of resulting collection.Birth date#] + " Full job title: " + [#Read contact information.First item of resulting collection.Full job title#] + " Business phone: " + [#Read contact information.First item of resulting collection.Business phone#] Save the changes.
   Contact name	Click → Formula. This opens the Formula window. Add the formula: "Full name: " + [#Read contact information.First item of resulting collection.Full name#] Save the changes.

3. Save the changes.

As a result, the diagram of the "Summarize contact information" business process will be as follows.

5. Implement a separate page to display the outcome of the Creatio AI work

1. Add an auto-generated page.

   1. Click → place the Auto-generated page element between the Call Creatio AI system action and Terminate page element in the working area of the Process Designer.

   2. Fill out the element properties.

      Property	Property value
      Title	Retrieve the summarized contact information
      Page title	Retrieve the summarized contact information

      Creatio populates the Contact property using the "[#System variable.Current user contact#]" value.

2. Add the parameters of the AI Skill.

   For this example, add the following parameters:

   • parameter that contains the outcome of the Creatio AI work
   • parameter that contains the status of the Creatio AI execution
   • parameter that contains the error message if error occurs during the AI Skill execution

   To do this:

   1. Go to the Page Items block.

   2. Click and select a parameter of the needed type.

   3. Fill out the parameter properties.

      Element	Element type	Property	Property value
      Parameter that contains the outcome of the Creatio AI work	Text field	Title	Outcome of the Creatio AI work
      		Code	CreatioAIResult
      		Is multiline	Select the checkbox
      		Value	Click → Process parameter → Process elements tab → Run the AI Skill → Outcome of the Creatio AI work → Select. This populates the property using the "[#Run the AI Skill.Outcome of the Creatio AI work#]" value.
      Parameter that contains the status of the Creatio AI execution	Text field	Title	Status of the Creatio AI execution
      		Code	ExecutionStatus
      		Value	Click → Process parameter → Process elements tab → Run the AI Skill → Status of the Creatio AI execution → Select. This populates the property using the "[#Run the AI Skill.Status of the Creatio AI execution#]" value.
      Parameter that contains the error message if error occurs during the AI Skill execution	Text field	Title	Error message
      		Code	ErrorMessage
      		Is multiline	Select the checkbox
      		Value	Click → Process parameter → Process elements tab → Run the AI Skill → Error message → Select. This populates the property using the "[#Run the AI Skill.Error message#]" value.

   As a result, the Page Items property block of the "Retrieve the summarized contact information" auto-generated page will be as follows.

   

As a result, the diagram of the "Summarize contact information" business process will be as follows.

3. Set up the page UI

1. Open the Customer 360 app in the No-Code Designer.

2. Open the Contacts form page.

3. Add a button.

   For this example, add the button that calls the "Summarize contact information" business process.

   To do this:

   1. Add a Button type component to the toolbar of the Freedom UI Designer.

   2. Click and fill out the button properties.

      Element	Property	Property value
      Button that calls the "Summarize contact information" business process	Title	Create summary
      	Style	Outline
      	Action	Run process
      	Which process to run?	Summarize contact information
      	How to run the process?	For the selected page

4. Save the changes.

View the result

1. Open the Contacts section.
2. Open a contact that has an arbitrary name. For example, "Alice Phillips."
3. Click Create summary.

As a result, Creatio will display the "Retrieve the summarized contact information" page that include the summarized information of a specific contact. View the result >>>

---

Resources

Package with example implementation