Changelog

Automating Asset Management with Contentstack Automate

This use case covers a scenario where you can dynamically update the asset description based on a Voice Profile whenever a new asset is published in Contentstack.

In this use case, we configure the Contentstack Asset Trigger. With the Chat with Vision action, fetch the asset UID and provide a suitable prompt to generate the response. In the next step, configure the Get a Single Voice Profile action using the Brand Kit connector to fetch the Voice Profile. To use this action, you must create a Voice Profile that certainly defines the product’s Voice Profile.

Next, in the Chat action, fetch the asset title and description based on the Voice Profile and Chat with Vision response. Once done, configure the Update an Asset action to update the asset description.

Let's break this scenario to see what the trigger event and the consequent action must be required to execute the Automation:

Set up the “Contentstack Asset'' Trigger Event: This trigger event is activated whenever a user publishes an asset in Contentstack.
Set up the ChatGPT “Chat with Vision” action: Once the above event triggers the automation, Chat with Vision fetches the asset UID and generates a response based on the prompt.
Set up the Brand Kit “Get a Voice Profile” action: Once the response generates, Get a Single Voice Profile fetches the Voice Profile created in the Brand Kit.
Set up the ChatGPT “Chat” action: Provide a prompt to generate an output based on the Chat with Vision and Get a Voice Profile action output.
Set up the Contentstack “Update an Asset” action: Fetch the output of the Chat action in the Asset Description.

The steps to set up the Automation are as follows:

Configure Contentstack Trigger
Configure ChatGPT Connector
Configure Brand Kit Connector
Configure ChatGPT Connector
Configure Contentstack Connector

Let's look at the setup in detail.

Configure Contentstack Trigger
1. Log in to your Contentstack account and click the Automate icon.
2. Click + New Project to add a new project.
3. Click + New Automation.
4. Enter the Automation Name and Description.
5. Click Create.
6. Select Configure Trigger from the left navigation panel.
7. Within the Configure Trigger step, click the Contentstack trigger connector.
8. Under the Choose Trigger tab, select Asset Trigger.
9. On the Asset Trigger Configure Trigger page, enter the details given below:
  1. Click + Add New Account button to connect your Contentstack account.
    Additional Resource: Refer to the Contentstack Trigger documentation to learn about adding an account.
  2. Select the trigger event from the drop-down, i.e., Asset Published and select a Stack and Branch from the Lookup drop-down.
    For Asset Trigger, you will find the following events:
    - Asset Created: When you create a new asset in your stack.
    - Asset Updated: When you update an asset.
    - Asset Deleted: When you delete an asset.
    - Asset Published: When you publish your assets to a publishing environment.
    - Asset Publish Failed: When asset publishing fails due to an error.
    - Asset Unpublished: When you unpublish or remove your assets from a publishing environment.
    - Asset Unpublish Failed: When the asset unpublishing activity fails.
    - All: When you perform any of the above activities on an asset.
      Note: By default, the main branch is selected (even if the Branch field is empty).
  3. [Optional] Enable the Show Optional Fields toggle button to display the Environment field.
10. Click Proceed.
11. Click Test Trigger to execute and test the trigger that you configured.
12. If successful, you will see an output as follows. If it looks appropriate, click Save and Exit.
Configure ChatGPT Connector
1. Click Configure Action Step from the left navigation panel.
2. Click Action Step to configure third-party services.
3. Within the Configure Action Step, click the ChatGPT connector.
4. Under Choose an Action tab, select the Chat with Vision action.
5. On the Chat with Vision Configure Action page, enter the details given below:
  1. Click + Add New Account button to connect your ChatGPT account.
    Additional Resource: Refer to the ChatGPT Connector documentation to learn about adding an account.
  2. Select the API Model from the drop-down list for response predictions. You can select the gpt-4-vision-preview API model. This model will be available as gpt-4-vision after production support.
  3. Provide the Prompt Text to generate response(s). Click + Add Prompt Text to enter multiple prompts.
    Note: For the Role as system or assistant, you will see the Prompt Text box to enter the text to generate response. If you select the Role as user, you can select the type of prompt content, i.e. Text or Image.
    If you select the Role as user, then follow the below steps:
    1. Under the Prompt Input section, click + Add Prompt Input button.
    2. In the Select Prompt Type drop-down, select the type of content, i.e., Text or Image to generate a response. For our use case we will select Text.
    3. Enter the Prompt Value. Fetch the asset UID from the trigger step and provide a valid prompt related to the asset.
    4. Click the Show Optional Fields toggle button to use these optional fields.
      1. Enter the Number of Tokens to generate the content. This must be within the range of 1 to 2048.
      2. Enter a value for the Randomness of Responses of the generated content. 0 being the most precise and 2 being the most random content predictions. This must be within the range of 0 to 2.
      3. Enter the Number of Prompt Responses you want to be generated in the automation response. This must be within the range of 1 to 3.
      4. Provide the value to set the Frequency of Repeated Words. The most positive value is likely to avoid the use of repeated words. This must be within the range of -2 to 2.
      5. Provide the value to set the Presence of Repeated Responses. The most positive value is likely to generate a new response. This must be within the range of -2 to 2.
      6. You can mark the Sanitize text checkbox to remove special characters or spaces from the chat response. Enabling this checkbox, eliminates any special characters or spaces in the chat response, resulting in a clean and compatible text.
6. Click Proceed.
7. Click Test Trigger to execute and test the trigger that you configured.
8. If successful, you will see an output as follows. If it looks appropriate, click Save and Exit.
Configure Brand Kit Connector
1. Click Configure Action Step from the left navigation panel.
2. Click Action Step to configure third-party services.
3. Within the Configure Action Step, click the Brand Kit connector.
4. Under Choose an Action tab, select the Get a Single Voice Profile action.
5. On the Get a Single Voice Profile Configure Action page, enter the details given below:
  1. Click + Add New Account button to connect your Brand Kit account.
    Additional Resource: Refer to the Brand Kit Connector documentation to learn about adding an account.
  2. Select a Brand Kit and Voice Profile from the Lookup list.
6. Once done, click Proceed.
7. Click Test Action to test the configured action.
8. The output will be shown as below. Click the Save and Exit button.
Configure ChatGPT Connector
1. Click Configure Action Step from the left navigation panel.
2. Click Action Step to configure third-party services.
3. Within the Configure Action Step, click the ChatGPT connector.
4. Under Choose an Action tab, select the Chat action.
5. On the Chat Configure Action page, enter the details given below:
  1. Click + Add New Account button to connect your ChatGPT account.
    Additional Resource: Refer to the ChatGPT Connector documentation to learn about adding an account.
  2. Select the API Model from the drop-down list to generate content for the chat responses.
    Note: Different models are available to different users based on the account the user holds such as paid accounts. You must check the account access before selecting the model.
  3. Provide the Prompt Text to generate response(s). Click + Add Prompt Text to enter multiple prompts.
  4. Select the Role from the drop-down options to send to the API model request. By default, the role is set to the user.
    Additional Resource: There are three different types of roles provided by the OpenAI platform. The system role sets the response context, the assistant role provides the response content, and the user role asks the prompt.
  5. Enter the value in the Input Query field. Add a prompt to generate a response based on the output data from Chat with Vision and Get a Single Voice Profile actions. This will ensure that the generated content aligns with the Brand Kit Voice Profile.
  6. Click the Show Optional Fields toggle button to use these optional fields:
    1. Select the Response Type as either Text or JSON. This ensures that the output is produced in a valid JSON format. By default, the response in ChatGPT is fetched in text format.
      Note: Ensure you are using the gpt-3.5-turbo-1106 model and above to access and correctly use the Response Type field in the connector.
    2. Enter the Number of Tokens to generate the content. This must be within the range of 1 to 2048.
    3. Enter a value for the Randomness of Responses of the generated content. 0 being the most precise and 2 being the most random content predictions. This must be within the range of 0 to 2.
    4. Enter the Number of Chat Responses you want to be generated in the automation response. This must be within the range of 1 to 3.
    5. Provide the value to set the Frequency of Repeated Words. The most positive value is likely to avoid the use of repeated words. This must be within the range of -2 to 2.
    6. Provide the value to set the Presence of Repeated Responses. The most positive value is likely to generate a new response. This must be within the range of -2 to 2.
    7. You can mark the Sanitize text checkbox to remove special characters or spaces from the chat response. Enabling this checkbox, eliminates any special characters or spaces in the chat response, resulting in a clean and compatible text.
6. Once done, click Proceed.
7. Click Test Action to test the configured action.
8. The output will be shown as below. Click the Save and Exit button.
Configure Contentstack Connector
1. Click Configure Action Step from the left navigation panel.
2. Click Action Step to configure third-party services.
3. Within the Configure Action Step, click the Contentstack connector.
4. Select the Contentstack Management connector to perform CMS tasks.
5. Under Choose an Action tab, select the Update an Asset action.
6. On the Update an Asset Configure Action page, enter the details given below:
  1. Click + Add New Account button to connect your ChatGPT account.
    Additional Resource: Refer to the Contentstack Connector documentation to learn about adding an account.
  2. Select a Stack and an Asset from the Lookup list.
    If you have assets stored in nested folders within your Contentstack CMS, you can select such assets as well for updating their details.
  3. Enter a Title and a suitable Description for the asset to update. Here, fetch the asset title from the Asset Trigger step and description from the Chat action as shown below:
  4. Specify a File Name for the asset and the Input URL of the image you want to update.
  5. Optionally, enable the Show Optional Fields toggle button to display the Select Folder field. In the Select Folder drop-down, choose a destination folder to update an asset in it.
7. Once done, click Proceed.
8. Click Test Action to test the configured action.
9. The output will be shown as below. Click the Save and Exit button.