---
title: "GET /apps/{appId}/versions/{versionId}/intents/{intentId}/suggest"
method: GET
path: "/apps/{appId}/versions/{versionId}/intents/{intentId}/suggest"
---

# GET /apps/{appId}/versions/{versionId}/intents/{intentId}/suggest

`GET /apps/{appId}/versions/{versionId}/intents/{intentId}/suggest`

Suggests example utterances that would improve the accuracy of the intent model in a version of the application.

## Path parameters

- `appId` string, uuid, required
- `versionId` string, required
- `intentId` string, uuid, required

## Query parameters

- `take` integer
- `enableNestedChildren` boolean

## Response `200`

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

- IntentsSuggestionExample[] — List of predicted/suggested intents.
  - `text` string — The utterance. For example, "What's the weather like in seattle?"
  - `tokenizedText` string[] — The tokenized utterance.
  - `intentPredictions` IntentPrediction[] — Predicted/suggested intents.
    - `name` string — The intent's name
    - `score` number — The intent's score, based on the prediction model.
  - `entityPredictions` EntityPrediction[] — Predicted/suggested entities.
    - `entityName` string, required — The entity's name
    - `startTokenIndex` integer, required — The index within the utterance where the extracted entity starts.
    - `endTokenIndex` integer, required — The index within the utterance where the extracted entity ends.
    - `phrase` string, required — The actual token(s) that comprise the entity.
    - `children` EntityPrediction[]

## Other responses

- `default` — Error Response.

---

[API](https://skmtc.net/azure/apis/luis-authoring-client.md) · [All operations](https://skmtc.net/azure/apis/luis-authoring-client/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/azure/luis-authoring-client/versions/a26a0f7e5a37/schema)