Skip to content

[CognitiveServices] LUIS Programmatic API Spec#2083

Merged
alvadb merged 134 commits intoAzure:currentfrom
southworks:cognitiveservices-luis-programmatic-spec
Dec 13, 2017
Merged

[CognitiveServices] LUIS Programmatic API Spec#2083
alvadb merged 134 commits intoAzure:currentfrom
southworks:cognitiveservices-luis-programmatic-spec

Conversation

@pcostantini
Copy link
Copy Markdown
Contributor

@pcostantini pcostantini commented Dec 2, 2017

This PR includes the API Spec for the LUIS Runtime endpoint (Predictions):
https://westus.dev.cognitive.microsoft.com/docs/services/5890b47c39e2bb17b84a55ff/operations/5890b47c39e2bb052c5b9c2f

The whole the spec has been reviewed and updated.


This checklist is used to make sure that common issues in a pull request are addressed. This will expedite the process of getting your pull request merged and avoid extra work on your part to fix issues discovered during the review process.

PR information

  • The title of the PR is clear and informative.
  • There are a small number of commits, each of which have an informative message. This means that previously merged commits do not appear in the history of the PR. For information on cleaning up the commits in your pull request, see this page.
  • Except for special cases involving multiple contributors, the PR is started from a fork of the main repository, not a branch.
  • If applicable, the PR references the bug/issue that it fixes.
  • Swagger files are correctly named (e.g. the api-version in the path should match the api-version in the spec).

Quality of Swagger

pcostantini and others added 30 commits November 27, 2017 16:19
- Swagger Spec + Samples
- Readme with C# generation configuration
…:southworkscom/azure-rest-api-specs into cognitiveservices-luis-programmatic-spec
@pcostantini pcostantini force-pushed the cognitiveservices-luis-programmatic-spec branch from 1f60e35 to d0cb2bb Compare December 5, 2017 13:39
@pcostantini pcostantini force-pushed the cognitiveservices-luis-programmatic-spec branch from d0cb2bb to 04b7234 Compare December 5, 2017 13:44
@pcostantini pcostantini force-pushed the cognitiveservices-luis-programmatic-spec branch from eb066f5 to 66579df Compare December 7, 2017 23:09
"200": {
"description": "If there's no trained model, nothing is returned in the response. If there's a trained model and the active learning algorithm finds any relevant queries, they are returned with the model predictions. If there's a trained model but the active learning algorithm didn't find any relevant queries, an empty list is returned in the response.",
"schema": {

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Please add description to properties.

"200": {
"description": "If there's no trained model, nothing is returned in the response. If there's a trained model and the active learning algorithm finds any relevant queries, they are returned with the model predictions. If there's a trained model but the active learning algorithm didn't find any relevant queries, an empty list is returned in the response.",
"schema": {

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Please add description for properties.

"200": {
"description": "If there's no trained model, nothing is returned in the response. If there's a trained model and the active learning algorithm finds any relevant queries, they are returned with the model predictions. If there's a trained model but the active learning algorithm didn't find any relevant queries, an empty list is returned in the response.",
"schema": {

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Please add description to properties.

"200": {
"description": "If there's no trained model, nothing is returned in the response. If there's a trained model and the active learning algorithm finds any relevant queries, they are returned with the model predictions. If there's a trained model but the active learning algorithm didn't find any relevant queries, an empty list is returned in the response.",
"schema": {

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Please add description to properties.

@alvadb
Copy link
Copy Markdown

alvadb commented Dec 9, 2017

@enzocano
Copy link
Copy Markdown

Hi @alvadb

We reviewed the lint errors and fixed almost all of them.
The followings autorest-lint errors are related to the current implementation of LUIS API and cannot be addressed without introducing breaking changes to the current live API:

  • Delete operations with request body (DeleteMustNotHaveRequestBody error)
    Both operations use the request body to specify the entity to delete

  • Properties not using camelCase style (DefinitionsPropertiesNamesCamelCase error)
    All these properties are defined as-is from the LUIS API and cannot be changed in the Swagger without updating the API implementation

Regards,
-EnzoC.

@azuresdkciprbot
Copy link
Copy Markdown

Hi There,

I am the AutoRest Linter Azure bot. I am here to help. My task is to analyze the situation from the AutoRest linter perspective. Please review the below analysis result:

File: specification/cognitiveservices/data-plane/LUIS/Programmatic/readme.md
Before the PR: Warning(s): 0 Error(s): 0
After the PR: Warning(s): 0 Error(s): 0

AutoRest Linter Guidelines | AutoRest Linter Issues | Send feedback

Thanks for your co-operation.

@enzocano enzocano force-pushed the cognitiveservices-luis-programmatic-spec branch from 372d803 to 898921e Compare December 12, 2017 13:54
@azuresdkciprbot
Copy link
Copy Markdown

Hi There,

I am the AutoRest Linter Azure bot. I am here to help. My task is to analyze the situation from the AutoRest linter perspective. Please review the below analysis result:

File: specification/cognitiveservices/data-plane/LUIS/Programmatic/readme.md
Before the PR: Warning(s): 0 Error(s): 0
After the PR: Warning(s): 0 Error(s): 0

AutoRest Linter Guidelines | AutoRest Linter Issues | Send feedback

Thanks for your co-operation.

@alvadb alvadb merged commit 2e03dc2 into Azure:current Dec 13, 2017
@AutorestCI
Copy link
Copy Markdown

No modification for AutorestCI/azure-sdk-for-python

@AutorestCI
Copy link
Copy Markdown

No modification for AutorestCI/azure-sdk-for-ruby

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

6 participants