Initiate Natural Language Processing Action

Create a record for the AI natural language processing result and initiate text processing by using the service specified in the related record.

This object is available in API version 60.0 and later.

Special Access Rules

To access the Initiate Natural Language Processing action, enable either IndustriesNLPInsightsAddOn or both IndustriesContractsAIAddOn and ContractsAIAddOn.

Supported REST HTTP Methods

URI: /services/data/v60.0/actions/standard/initiateNaturalLangProcessing
Formats: JSON, XML
HTTP Methods: GET, HEAD, POST
Authentication: Authorization: Bearer token

Inputs

Input	Details
referenceRecordId	Type string Description Required. The record ID with the text field that's processed by an AI natural language process request.
referenceRecordTextField	Type string Description Required. The text field that's processed by an AI natural language process request.
serviceDetailsList	Type string Description Required. A comma-delimited list containing the details of services that are used to process AI natural language process requests. The possible values are: `Amazon_Comprehend_Keyphrase_Extraction` `Amazon_Comprehend_Entity_Extraction` `OpenAIClauseExtraction` `OpenAIEntityExtraction` `GenAI_Assessment_Questions_Extraction`

Outputs

Input	Details
aiNaturalLangProcRsltIdsList	Type string Description A comma-delimited list containing the IDs of AI Natural Language Process Result records that store the result of the natural language process requests.

Example

Sample Request

JSON Request Body

1{
2  "inputs": [
3    {
4      "referenceRecordId": "a00SB000003Z2LPYA0",
5      "referenceRecordTextField": "Vehicle__c.Comments__c",
6      "serviceDetailsList": {
7        "serviceDetails": [
8          {
9            "serviceName": "Amazon_Comprehend_Keyphrase_Extraction",
10            "configurationApiName": "AWS_Keyphrase_Extraction"
11          }
12        ]
13      }
14    }
15  ]
16}

Sample Response

JSON Response Body

1[
2  {
3    "actionName": "initiateNaturalLangProcessing",
4    "errors": null,
5    "isSuccess": true,
6    "outputValues": {
7      "aiNaturalLangProcRsltIds": {
8        "aiNaturalLangProcessResultIds": [
9          "7NPSB0000000g8v4AA"
10        ]
11      }
12    },
13    "version": 1
14  }
15]

Sample Error message when referenceRecordId is not provided

JSON Error Body

1[ {
2  "errorCode" : "METHOD_NOT_ALLOWED",
3  "message" : "HTTP Method 'POST' not allowed. Allowed are HEAD,GET"
4} ]

Industries Common Resources Developer Guide