Create a citation for a keyterm prompt test result
/api/boss/data/objects/ora/cxSalesCommon/keyterms/v1/keyterms/{keyterms_id}/prompts/{keyterms-prompts_id}/testResults/{keyterms-prompts-testResults_id}/citations
Request
-
keyterms-prompts-testResults_id(required): string
This path parameter maps to the following field defined in the Key Terms/prompts/testResults REST resource:
- id
-
keyterms-prompts_id(required): string
This path parameter maps to the following field defined in the Key Terms/prompts REST resource:
- id
-
keyterms_id(required): string
This path parameter maps to the following field defined in the Key Terms REST resource:
- code
- application/json
-
object
oraCxSalesCommonKeyterms.PromptTestCitation_item-fields
-
object
Citation
Title:
CitationCitation is the part of the source document that's referenced by the large language model to get a response.
object-
citation: string
-
createdBy: string
Title:
Created ByRead Only:true -
id: string
(big-integer)
Read Only:
true -
sequenceNumber: string
-
testResult:
testResult
-
timeCreated: string
(date-time)
Title:
Created OnRead Only:true -
timeUpdated: string
(date-time)
Title:
Last Updated DateRead Only:true -
updatedBy: string
Title:
Last Updated ByRead Only:true
objectCitationobject-
object
oraCxSalesCommonKeyterms.PromptTestResult_item-fields
-
object
Prompt Test Result
Title:
Prompt Test ResultPrompt test result includes information about the response provided by the large language model for a specific prompt.
object-
additionalInstructions: string
Title:
Additional Instruction -
createdBy: string
Title:
Created ByRead Only:true -
id: string
(big-integer)
Read Only:
true -
prompt:
prompt
-
promptText: string
Title:
Prompt -
resultDate: string
(date-time)
Title:
Date -
submitDate: string
(date-time)
Title:
Upload Date -
testOutput: string
Title:
Response -
timeCreated: string
(date-time)
Title:
Created OnRead Only:true -
timeUpdated: string
(date-time)
Title:
Last Updated DateRead Only:true -
updatedBy: string
Title:
Last Updated ByRead Only:true
objectPrompt Test Resultobject-
object
oraCxSalesCommonKeyterms.KeytermPrompt_item-fields
-
object
Key Term Prompt
Title:
Key Term PromptKey term prompt is the question that's used in a large language model to extract a certain key term from contract documents.
object-
createdBy: string
Title:
Created ByRead Only:true -
description: string
Title:
Description -
id: string
(big-integer)
Read Only:
true -
keyterm:
keyterm
-
latestAdditionalInstructions: string
-
name: string
Title:
Name -
status:
status
-
text: string
Title:
Prompt -
timeCreated: string
(date-time)
Title:
Created OnRead Only:true -
timeUpdated: string
(date-time)
Title:
Last Updated DateRead Only:true -
updatedBy: string
Title:
Last Updated ByRead Only:true
objectKey Term Promptobject-
object
oraCxSalesCommonKeyterms.Keyterm_item-fields
-
object
Key Term
Title:
Key TermKey term is the metadata present in the contract documents. The key terms to be extracted for each contract type is defined in the application with the corresponding prompts to be used for extraction.
object-
activeFlag: boolean
Title:
StatusDefault Value:true -
code: string
Title:
Code -
createdBy: string
Title:
Created ByRead Only:true -
group:
group
-
name: string
Title:
Name -
outputType:
outputType
-
timeCreated: string
(date-time)
Title:
Created OnRead Only:true -
timeUpdated: string
(date-time)
Title:
Last Updated DateRead Only:true -
updatedBy: string
Title:
Last Updated ByRead Only:true
objectKey Termobjectobject-
$sourceLang: string
Read Only:
true -
createdBy: string
Read Only:
true -
description: string
Read Only:
true -
displaySequence: string
(big-integer)
Read Only:
true -
enabledFlag: boolean
Read Only:
true -
endDateActive: string
(date)
Read Only:
true -
lookupCategoryId: string
(big-integer)
Read Only:
true -
lookupCode: string
Read Only:
true -
lookupType: string
Read Only:
true -
meaning: string
Read Only:
true -
startDateActive: string
(date)
Read Only:
true -
tag: string
Read Only:
true -
timeCreated: string
(date-time)
Read Only:
true -
timeUpdated: string
(date-time)
Read Only:
true -
updatedBy: string
Read Only:
true
object-
createdBy: string
Title:
Created ByThe user who created the record. -
description: string
Title:
Lookup Code DescriptionThe translated description of the Lookup Code. -
displaySequence: string
Title:
Display SequenceThe display sequence of the Lookup Code. -
enabledFlag: boolean
Title:
Lookup Code EnabledThe enabled flag of the Lookup Code. -
endDateActive: string
Title:
End Date ActiveThe active end date of the Lookup Code. -
lookupCategoryId: string
Title:
Lookup CategoryThe lookup category of the Lookup Code. -
lookupCode: string
Title:
Lookup Code IDThe unique identifier of the Lookup Code. -
lookupType: string
Title:
Lookup Type IDThe unique identifier of the Lookup Type. -
meaning: string
Title:
Lookup Code MeaningThe translated meaning of the Lookup Code. -
startDateActive: string
Title:
Start Date ActiveThe active start date of the Lookup Code. -
tag: string
Title:
Lookup TagThe tag value of the Lookup Code. -
timeCreated: string
Title:
Created OnThe date and time when the record was created. -
timeUpdated: string
Title:
Last Updated DateThe date and time when the record was last updated. -
updatedBy: string
Title:
Last Updated ByThe user who last updated the record.
objectGroupobject-
id: string
(big-integer)
Read Only:
true
Response
Default Response
Examples
The following example shows how to create a citation for a keyterm prompt test result by submitting a post request on the REST resource using cURL.
cURL Command
curl -X POST --location
'https://servername.fa.us2.oraclecloud.com/api/boss/data/objects/ora/cxSalesCommon/keyterms/v1/keyterms/{keyterms_id}/prompts/{keyterms-prompts_id}/testResults/{keyterms-prompts-testResults_id}/citations'
\ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer
<token>' -D @request.json
Example of Request Body
The following shows an example of the request body in JSON format.
{
"sequenceNumber":10,
"citation":"Placeholder Text where prompt is present"
}
Example of Response
The following shows an example of the response body in JSON format.
201 Created