Add uttrances in CLU Cognitive Services

Adarsh Pandey 21

Hi Team,

I do see we can add Phrases in LUIS via this API endpoint: https://learn.microsoft.com/en-us/rest/api/cognitiveservices-luis/authoringv2.0/features/add-phrase-list?tabs=HTTP

As I am planning to migrate LUIS to CLU we've to rewrite the APIs to send the Phrases details in CLU (As phrases is not in CLU, I understand they'll go as utterances).

Is there any way in CLU to add utterances via API endpoint? I do see we've a screen in CLU to upload the utterances file in one go but is this possible to do programmatic way via CLU APIs ?

Any response would be much appreciated.

Thanks,
Adarsh

romungi-MSFT 42,311 Reputation points Microsoft Employee

2022-12-13T05:11:58.15+00:00

@Adarsh Pandey You can add utterances using the Import API with the REST API. A sample request from the examples in the document is here.
romungi-MSFT 42,311 Reputation points Microsoft Employee

2022-12-14T09:04:36.323+00:00

@Adarsh Pandey Did the below API work to add utterances programmatically?
Adarsh Pandey 21 Reputation points

2022-12-16T08:12:40.567+00:00

@romungi-MSFT hey sorry for the delayed response, I was away for couple of days. Let me give a try today on this and update back. Thanks for your reply :-)
Adarsh Pandey 21 Reputation points

2022-12-16T09:01:20.843+00:00

@romungi-MSFT I've given a try but this is not something I was looking for.
This seems the project import and not something I was looking for.

As we know we can add list of utterances and can also upload the utterances file via Azure portal(Screenshot attached) but what if I want to upload list of utterance in existing project via API Endpoint in place of using Azure Portal.
Adarsh Pandey 21 Reputation points

2022-12-19T09:29:22.25+00:00

Hi @romungi-MSFT , Any response please?
romungi-MSFT 42,311 Reputation points Microsoft Employee

2022-12-22T06:22:24.153+00:00

@Adarsh Pandey The product team confirmed that they are actually using the import API for the above functionality to update the project with the list of utterances in the file.
Adarsh Pandey 21 Reputation points

2022-12-22T06:35:18.587+00:00

Hi @romungi-MSFT Thanks for the reply.

So If I do use this import API on existing project which already has Intent, Utterances, Entities and Trained Model available, it won't delete or drop the existing things and it'll just add the utterances inside defined intent? Because As per the documentation https://learn.microsoft.com/en-us/rest/api/language/2022-10-01-preview/conversational-analysis-authoring/import?tabs=HTTP#examples it is clearly mentioned that "Triggers a job to import a project. If a project with the same name already exists, the data of that project is replaced."

Can you please confirm on that because the documentation on Microsoft website and what you proposing above is kind of contradicting to me or may be you need to help me understand it a bit better by some examples.

Thanks,
Adarsh

Accepted answer

romungi-MSFT 42,311 Reputation points Microsoft Employee

2022-12-22T10:36:56.02+00:00
@AdarshPandey-2727 The upload functionality from the UI is actually using the file and the import API but it is also internally using the export API to export the project and appending the file selected in the import API request. This effectively is editing the data although the project is just being overwritten.

So, for example, if we have a project with 20 intents and 100 utterances, to programmatically add 200 more utterances:

Export JSON

Edit JSON to append 200 more utterances

Import JSON again, then same project will now have 20 intents and 300 utterances.

I hope this helps!!

If an answer is helpful, please click on or upvote which might help other community members reading this thread.
Please sign in to rate this answer.

1 person found this answer helpful.
Adarsh Pandey 21 Reputation points

2022-12-28T05:52:08.033+00:00

Make lot of sense @romungi-MSFT . Thank you so much for the help let me give a try then and will reach out in case of any questions.

YutongTie-MSFT 46,991 Reputation points

2022-12-29T16:07:40.977+00:00

Hello @Adarsh Pandey

I have converted Rohit's comment to answer since you think it's helpful. Please let us know if you have any further questions, we are happy to help.

Regards,
Yutong
Sign in to comment

Add uttrances in CLU Cognitive Services

0 additional answers