# Score Text/Pronunciation {% hint style="info" %} **Run in Postman**: [Score a word or sentence](https://docs.speechace.com/#23421587-4c6c-4a67-8575-295d50d6a55b) {% endhint %} ### Request Format The endpoint that is to be used will depend on the [region](/getting-started/pre-requisites/api-regions-and-endpoints.md) of your subscription. For example, for US West, the endpoint is . `POST` [`https://api.speechace.co/api/scoring/text/v9/json`](https://api.speechace.co/api/scoring/text/v9/json?key={{speechacekey}}\&dialect=en-us\&user_id=XYZ-ABC-99001) {% tabs %} {% tab title="Score a word" %} {% code overflow="wrap" lineNumbers="true" %} ```curl curl --location -g 'https://api.speechace.co/api/scoring/text/v9/json?key={{speechacekey}}&dialect=en-us \ --form 'text="apple"' \ --form 'user_audio_file=@"apple.wav"' ``` {% endcode %} {% endtab %} {% tab title="Score a sentence" %} {% code overflow="wrap" lineNumbers="true" %} ``` curl --location -g 'https://api.speechace.co/api/scoring/text/v9/json?key={{speechacekey}}&dialect=en-us \ --form 'text="Some parents admire famous athletes as strong role models, so they name their children after them."' \ --form 'user_audio_file=@"someparents.wav"' ``` {% endcode %} {% endtab %} {% endtabs %} ### Query Parameters
ParameterTypeDescription
keyStringAPI key issued by Speechace.
dialectString

This is the dialect in which the speaker will be assessed.

Note: Not all features of the score/text API support every dialect. Applicable dialects will be explicitly mentioned.

user_idStringOptional: A unique anonymized identifier (generated by your application) for the end-user who spoke the audio.
### Request Body
ParameterTypeDescription
textStringA word, phrase, or sentence to score. This should be in the dialect chosen. For example, if fr-fr is the chosen dialect, then the word can be Salut.
user_audio_fileFilefile with user audio (wav, mp3, m4a, webm, ogg, aiff)
question_infoStringOptional: A unique identifier (generated by your application) for the activity or question this user audio is answering.
no_mcStringOptional: no_mc = 1 to indicate the text field contains multiple lines.
include_fluencyStringOptional: include_fluency= 1 to include fluency scoring in the response.
See this guide for how to use this field.
include_intonationStringOptional: include_intonation= 1 to include intonation and stress-level scores.
See this guide for how to use this field.
markup_languageString

Optional: markup_language = arpa_mark
This key signifies that the text parameter may contain markup annotations.

See this guide for how to use this field.

include_unknown_wordsString

Optional: include_unknown_words = 1

This key instructs Speechace to automatically infer the expected pronunciation for unknown terms, such as names, places, and other specific terminology. This ensures accurate feedback even for unfamiliar words.

detect_dialectString

Optional field: Possible values - 0 | 1

1: will apply language detection and warn if the majority of the response language is different from the intended scoring dialect.

enforce_dialectString

Optional field: Possible values - 0 | 1

1: will apply language detection and error if the majority of the response language is different from the intended scoring dialect.

Setting enforce_dialect=1 automatically sets detect_dialect=1.

include_interference_metricsString

Optional: include_interference_metrics = 1 to include interference metrics in the response. When set, the interference_ratio field is returned inside text_score.

See the Detecting Speech Interference guide for how to interpret and use this field.

### Response Example {% tabs %} {% tab title="200: OK Scoring a word" %} 
{
  "status": "success",
  "quota_remaining": -1,
  "text_score": {
    "text": "apple",
    "word_score_list": [
      {
        "word": "apple",
        "quality_score": 100,
        "phone_score_list": [
          {
            "phone": "ae",
            "stress_level": 1,
            "extent": [
              12,
              27
            ],
            "quality_score": 100,
            "stress_score": 100,
            "predicted_stress_level": 2,
            "word_extent": [
              0,
              1
            ],
            "sound_most_like": "ae"
          },
          {
            "phone": "p",
            "stress_level": null,
            "extent": [
              27,
              39
            ],
            "quality_score": 100,
            "word_extent": [
              2,
              3
            ],
            "sound_most_like": "p"
          },
          {
            "phone": "ah",
            "stress_level": 0,
            "extent": [
              39,
              42
            ],
            "quality_score": 100,
            "stress_score": 100,
            "predicted_stress_level": 0,
            "word_extent": [
              3,
              4
            ],
            "sound_most_like": "ah"
          },
          {
            "phone": "l",
            "stress_level": null,
            "extent": [
              42,
              54
            ],
            "quality_score": 98.5,
            "word_extent": [
              3,
              4
            ],
            "sound_most_like": "l"
          }
        ],
        "syllable_score_list": [
          {
            "phone_count": 1,
            "stress_level": 1,
            "letters": "ap",
            "quality_score": 100,
            "stress_score": 100,
            "predicted_stress_level": 2,
            "extent": [
              12,
              27
            ]
          },
          {
            "phone_count": 3,
            "stress_level": 0,
            "letters": "ple",
            "quality_score": 100,
            "stress_score": 100,
            "predicted_stress_level": 0,
            "extent": [
              27,
              54
            ]
          }
        ]
      }
    ],
    "ielts_score": {
      "pronunciation": 9
    },
    "pte_score": {
      "pronunciation": 90
    },
    "speechace_score": {
      "pronunciation": 100
    },
    "toeic_score": {
      "pronunciation": 200
    },
    "cefr_score": {
      "pronunciation": "C2"
    }
  },
  "version": "9.3"
}
{% endtab %} {% tab title="200: OK Success: Scoring a sentence" %} {% code lineNumbers="true" %} ```json { "status": "success", "quota_remaining": -1, "text_score": { "text": "Some parents admire famous athletes as strong role models, so they name their children after them.", "word_score_list": [ { "word": "Some", "quality_score": 99, "phone_score_list": [ { "phone": "s", "stress_level": null, "extent": [ 9, 27 ], "quality_score": 98.66666666666667, "word_extent": [ 0, 1 ], "sound_most_like": "s" }, { "phone": "ah", "stress_level": 1, "extent": [ 27, 36 ], "quality_score": 100, "stress_score": 100, "predicted_stress_level": 1, "word_extent": [ 1, 2 ], "sound_most_like": "ah" }, { "phone": "m", "stress_level": null, "extent": [ 36, 42 ], "quality_score": 99.5, "word_extent": [ 2, 3 ], "sound_most_like": "m" } ], "syllable_score_list": [ { "phone_count": 3, "stress_level": 1, "letters": "some", "quality_score": 99, "stress_score": 100, "predicted_stress_level": 1, "extent": [ 9, 42 ] } ] }, { "word": "parents", "quality_score": 99, "phone_score_list": [ { "phone": "p", "stress_level": null, "extent": [ 42, 51 ], "quality_score": 100, "word_extent": [ 0, 1 ], "sound_most_like": "p" }, { "phone": "eh", "stress_level": 1, "extent": [ 51, 57 ], "quality_score": 100, "stress_score": 100, "predicted_stress_level": 1, "word_extent": [ 1, 2 ], "sound_most_like": "eh" }, { "phone": "r", "stress_level": null, "extent": [ 57, 66 ], "quality_score": 100, "word_extent": [ 2, 3 ], "sound_most_like": "r" }, { "phone": "ah", "stress_level": 0, "extent": [ 66, 69 ], "quality_score": 100, "stress_score": 100, "predicted_stress_level": 0, "word_extent": [ 3, 4 ], "sound_most_like": "ah" }, { "phone": "n", "stress_level": null, "extent": [ 69, 75 ], "quality_score": 100, "word_extent": [ 4, 5 ], "sound_most_like": "n" }, { "phone": "t", "stress_level": null, "extent": [ 75, 76 ], "quality_score": 94, "word_extent": [ 5, 6 ], "sound_most_like": "t" }, { "phone": "s", "stress_level": null, "extent": [ 76, 84 ], "quality_score": 99.25, "word_extent": [ 6, 7 ], "sound_most_like": "s" } ], "syllable_score_list": [ { "phone_count": 2, "stress_level": 1, "letters": "pa", "quality_score": 100, "stress_score": 100, "predicted_stress_level": 1, "extent": [ 42, 57 ] }, { "phone_count": 5, "stress_level": 0, "letters": "rents", "quality_score": 99, "stress_score": 100, "predicted_stress_level": 0, "extent": [ 57, 84 ] } ] }, { "word": "admire", "quality_score": 99, "phone_score_list": [ { "phone": "ah", "stress_level": 0, "extent": [ 84, 90 ], "quality_score": 97, "stress_score": 100, "predicted_stress_level": 0, "word_extent": [ 0, 1 ], "sound_most_like": "ah" }, { "phone": "d", "stress_level": null, "extent": [ 90, 93 ], "quality_score": 100, "word_extent": [ 1, 2 ], "sound_most_like": "d" }, { "phone": "m", "stress_level": null, "extent": [ 93, 102 ], "quality_score": 100, "word_extent": [ 2, 3 ], "sound_most_like": "m" }, { "phone": "ay", "stress_level": 1, "extent": [ 102, 117 ], "quality_score": 99.8, "stress_score": 100, "predicted_stress_level": 1, "word_extent": [ 3, 4 ], "sound_most_like": "ay" }, { "phone": "er", "stress_level": 0, "extent": [ 117, 129 ], "quality_score": 99, "stress_score": 100, "predicted_stress_level": 0, "word_extent": [ 4, 5 ], "sound_most_like": "er" } ], "syllable_score_list": [ { "phone_count": 2, "stress_level": 0, "letters": "ad", "quality_score": 98, "stress_score": 100, "predicted_stress_level": 0, "extent": [ 84, 93 ] }, { "phone_count": 2, "stress_level": 1, "letters": "mi", "quality_score": 100, "stress_score": 100, "predicted_stress_level": 1, "extent": [ 93, 117 ] }, { "phone_count": 1, "stress_level": 0, "letters": "re", "quality_score": 99, "stress_score": 100, "predicted_stress_level": 0, "extent": [ 117, 129 ] } ] }, { "word": "famous", "quality_score": 98, "phone_score_list": [ { "phone": "f", "stress_level": null, "extent": [ 129, 141 ], "quality_score": 98.75, "word_extent": [ 0, 1 ], "sound_most_like": "f" }, { "phone": "ey", "stress_level": 1, "extent": [ 141, 150 ], "quality_score": 100, "stress_score": 100, "predicted_stress_level": 1, "word_extent": [ 1, 2 ], "sound_most_like": "ey" }, { "phone": "m", "stress_level": null, "extent": [ 150, 156 ], "quality_score": 100, "word_extent": [ 2, 3 ], "sound_most_like": "m" }, { "phone": "ah", "stress_level": 0, "extent": [ 156, 162 ], "quality_score": 95.5, "stress_score": 100, "predicted_stress_level": 0, "word_extent": [ 3, 5 ], "sound_most_like": "ah" }, { "phone": "s", "stress_level": null, "extent": [ 162, 174 ], "quality_score": 95.5, "word_extent": [ 5, 6 ], "sound_most_like": "s" } ], "syllable_score_list": [ { "phone_count": 2, "stress_level": 1, "letters": "fa", "quality_score": 99, "stress_score": 100, "predicted_stress_level": 1, "extent": [ 129, 150 ] }, { "phone_count": 3, "stress_level": 0, "letters": "mous", "quality_score": 97, "stress_score": 100, "predicted_stress_level": 0, "extent": [ 150, 174 ] } ] }, { "word": "athletes", "quality_score": 98, "phone_score_list": [ { "phone": "ae", "stress_level": 1, "extent": [ 174, 186 ], "quality_score": 100, "stress_score": 100, "predicted_stress_level": 1, "word_extent": [ 0, 1 ], "sound_most_like": "ae" }, { "phone": "th", "stress_level": null, "extent": [ 186, 195 ], "quality_score": 96.66666666666667, "word_extent": [ 1, 3 ], "sound_most_like": "th" }, { "phone": "l", "stress_level": null, "extent": [ 195, 204 ], "quality_score": 99.66666666666667, "word_extent": [ 3, 4 ], "sound_most_like": "l" }, { "phone": "iy", "stress_level": 2, "extent": [ 204, 213 ], "quality_score": 99.66666666666667, "stress_score": 50, "predicted_stress_level": 0, "word_extent": [ 4, 5 ], "sound_most_like": "iy" }, { "phone": "t", "stress_level": null, "extent": [ 213, 219 ], "quality_score": 97.5, "word_extent": [ 5, 6 ], "sound_most_like": "t" }, { "phone": "s", "stress_level": null, "extent": [ 219, 225 ], "quality_score": 93, "word_extent": [ 7, 8 ], "sound_most_like": "s" } ], "syllable_score_list": [ { "phone_count": 2, "stress_level": 1, "letters": "ath", "quality_score": 98, "stress_score": 100, "predicted_stress_level": 1, "extent": [ 174, 195 ] }, { "phone_count": 4, "stress_level": 2, "letters": "letes", "quality_score": 97, "stress_score": 50, "predicted_stress_level": 0, "extent": [ 195, 225 ] } ] }, { "word": "as", "quality_score": 100, "phone_score_list": [ { "phone": "eh", "stress_level": 1, "extent": [ 225, 234 ], "quality_score": 99.66666666666667, "stress_score": 100, "predicted_stress_level": 1, "word_extent": [ 0, 1 ], "sound_most_like": "eh" }, { "phone": "z", "stress_level": null, "extent": [ 234, 240 ], "quality_score": 100, "word_extent": [ 1, 2 ], "sound_most_like": "z" } ], "syllable_score_list": [ { "phone_count": 2, "stress_level": 1, "letters": "as", "quality_score": 100, "stress_score": 100, "predicted_stress_level": 1, "extent": [ 225, 240 ] } ] }, { "word": "strong", "quality_score": 100, "phone_score_list": [ { "phone": "s", "stress_level": null, "extent": [ 240, 246 ], "quality_score": 100, "word_extent": [ 0, 1 ], "sound_most_like": "s" }, { "phone": "t", "stress_level": null, "extent": [ 246, 252 ], "quality_score": 100, "word_extent": [ 1, 2 ], "sound_most_like": "t" }, { "phone": "r", "stress_level": null, "extent": [ 252, 258 ], "quality_score": 100, "word_extent": [ 2, 3 ], "sound_most_like": "r" }, { "phone": "ao", "stress_level": 1, "extent": [ 258, 267 ], "quality_score": 99.33333333333333, "stress_score": 100, "predicted_stress_level": 0, "word_extent": [ 3, 4 ], "sound_most_like": "ao" }, { "phone": "ng", "stress_level": null, "extent": [ 267, 273 ], "quality_score": 100, "word_extent": [ 4, 6 ], "sound_most_like": "ng" } ], "syllable_score_list": [ { "phone_count": 5, "stress_level": 1, "letters": "strong", "quality_score": 100, "stress_score": 100, "predicted_stress_level": 0, "extent": [ 240, 273 ] } ] }, { "word": "role", "quality_score": 100, "phone_score_list": [ { "phone": "r", "stress_level": null, "extent": [ 273, 282 ], "quality_score": 99.66666666666667, "word_extent": [ 0, 1 ], "sound_most_like": "r" }, { "phone": "ow", "stress_level": 1, "extent": [ 282, 291 ], "quality_score": 100, "stress_score": 100, "predicted_stress_level": 1, "word_extent": [ 1, 2 ], "sound_most_like": "ow" }, { "phone": "l", "stress_level": null, "extent": [ 291, 300 ], "quality_score": 100, "word_extent": [ 2, 3 ], "sound_most_like": "l" } ], "syllable_score_list": [ { "phone_count": 3, "stress_level": 1, "letters": "role", "quality_score": 100, "stress_score": 100, "predicted_stress_level": 1, "extent": [ 273, 300 ] } ] }, { "word": "models", "quality_score": 99, "phone_score_list": [ { "phone": "m", "stress_level": null, "extent": [ 300, 312 ], "quality_score": 98.25, "word_extent": [ 0, 1 ], "sound_most_like": "m" }, { "phone": "aa", "stress_level": 1, "extent": [ 312, 321 ], "quality_score": 100, "stress_score": 100, "predicted_stress_level": 1, "word_extent": [ 1, 2 ], "sound_most_like": "aa" }, { "phone": "d", "stress_level": null, "extent": [ 321, 327 ], "quality_score": 100, "word_extent": [ 2, 3 ], "sound_most_like": "d" }, { "phone": "ah", "stress_level": 0, "extent": [ 327, 333 ], "quality_score": 96, "stress_score": 100, "predicted_stress_level": 0, "word_extent": [ 3, 4 ], "sound_most_like": "ah" }, { "phone": "l", "stress_level": null, "extent": [ 333, 339 ], "quality_score": 100, "word_extent": [ 4, 5 ], "sound_most_like": "l" }, { "phone": "z", "stress_level": null, "extent": [ 339, 354 ], "quality_score": 100, "word_extent": [ 5, 6 ], "sound_most_like": "z" } ], "ending_punctuation": ",", "syllable_score_list": [ { "phone_count": 2, "stress_level": 1, "letters": "mo", "quality_score": 99, "stress_score": 100, "predicted_stress_level": 1, "extent": [ 300, 321 ] }, { "phone_count": 4, "stress_level": 0, "letters": "dels", "quality_score": 99, "stress_score": 100, "predicted_stress_level": 0, "extent": [ 321, 354 ] } ] }, { "word": "so", "quality_score": 99, "phone_score_list": [ { "phone": "s", "stress_level": null, "extent": [ 390, 408 ], "quality_score": 99.33333333333333, "word_extent": [ 0, 1 ], "sound_most_like": "s" }, { "phone": "ow", "stress_level": 1, "extent": [ 408, 414 ], "quality_score": 99.5, "stress_score": 100, "predicted_stress_level": 1, "word_extent": [ 1, 2 ], "sound_most_like": "ow" } ], "syllable_score_list": [ { "phone_count": 2, "stress_level": 1, "letters": "so", "quality_score": 99, "stress_score": 100, "predicted_stress_level": 1, "extent": [ 390, 414 ] } ] }, { "word": "they", "quality_score": 99, "phone_score_list": [ { "phone": "dh", "stress_level": null, "extent": [ 414, 420 ], "quality_score": 100, "word_extent": [ 0, 2 ], "sound_most_like": "dh" }, { "phone": "ey", "stress_level": 1, "extent": [ 420, 429 ], "quality_score": 98.33333333333333, "stress_score": 100, "predicted_stress_level": 0, "word_extent": [ 2, 4 ], "sound_most_like": "ey" } ], "syllable_score_list": [ { "phone_count": 2, "stress_level": 1, "letters": "they", "quality_score": 99, "stress_score": 100, "predicted_stress_level": 0, "extent": [ 414, 429 ] } ] }, { "word": "name", "quality_score": 99, "phone_score_list": [ { "phone": "n", "stress_level": null, "extent": [ 429, 435 ], "quality_score": 100, "word_extent": [ 0, 1 ], "sound_most_like": "n" }, { "phone": "ey", "stress_level": 1, "extent": [ 435, 444 ], "quality_score": 99.66666666666667, "stress_score": 100, "predicted_stress_level": 1, "word_extent": [ 1, 2 ], "sound_most_like": "ey" }, { "phone": "m", "stress_level": null, "extent": [ 444, 453 ], "quality_score": 98, "word_extent": [ 2, 3 ], "sound_most_like": "m" } ], "syllable_score_list": [ { "phone_count": 3, "stress_level": 1, "letters": "name", "quality_score": 99, "stress_score": 100, "predicted_stress_level": 1, "extent": [ 429, 453 ] } ] }, { "word": "their", "quality_score": 99, "phone_score_list": [ { "phone": "dh", "stress_level": null, "extent": [ 453, 459 ], "quality_score": 100, "word_extent": [ 0, 2 ], "sound_most_like": "dh" }, { "phone": "eh", "stress_level": 1, "extent": [ 459, 465 ], "quality_score": 100, "stress_score": 100, "predicted_stress_level": 1, "word_extent": [ 2, 3 ], "sound_most_like": "eh" }, { "phone": "r", "stress_level": null, "extent": [ 465, 468 ], "quality_score": 96, "word_extent": [ 4, 5 ], "sound_most_like": "r" } ], "syllable_score_list": [ { "phone_count": 3, "stress_level": 1, "letters": "their", "quality_score": 99, "stress_score": 100, "predicted_stress_level": 1, "extent": [ 453, 468 ] } ] }, { "word": "children", "quality_score": 98, "phone_score_list": [ { "phone": "ch", "stress_level": null, "extent": [ 468, 483 ], "quality_score": 97.6, "word_extent": [ 0, 2 ], "sound_most_like": "ch" }, { "phone": "ih", "stress_level": 1, "extent": [ 483, 489 ], "quality_score": 99, "stress_score": 100, "predicted_stress_level": 1, "word_extent": [ 2, 3 ], "sound_most_like": "ih" }, { "phone": "l", "stress_level": null, "extent": [ 489, 495 ], "quality_score": 100, "word_extent": [ 3, 4 ], "sound_most_like": "l" }, { "phone": "d", "stress_level": null, "extent": [ 495, 498 ], "quality_score": 100, "word_extent": [ 4, 5 ], "sound_most_like": "d" }, { "phone": "r", "stress_level": null, "extent": [ 498, 507 ], "quality_score": 95.66666666666667, "word_extent": [ 5, 6 ], "sound_most_like": "r" }, { "phone": "ah", "stress_level": 0, "extent": [ 507, 510 ], "quality_score": 100, "stress_score": 100, "predicted_stress_level": 0, "word_extent": [ 6, 7 ], "sound_most_like": "ah" }, { "phone": "n", "stress_level": null, "extent": [ 510, 519 ], "quality_score": 96.66666666666667, "word_extent": [ 7, 8 ], "sound_most_like": "n" } ], "syllable_score_list": [ { "phone_count": 3, "stress_level": 1, "letters": "chil", "quality_score": 99, "stress_score": 100, "predicted_stress_level": 1, "extent": [ 468, 495 ] }, { "phone_count": 4, "stress_level": 0, "letters": "dren", "quality_score": 98, "stress_score": 100, "predicted_stress_level": 0, "extent": [ 495, 519 ] } ] }, { "word": "after", "quality_score": 100, "phone_score_list": [ { "phone": "ae", "stress_level": 1, "extent": [ 519, 531 ], "quality_score": 99.75, "stress_score": 100, "predicted_stress_level": 2, "word_extent": [ 0, 1 ], "sound_most_like": "ae" }, { "phone": "f", "stress_level": null, "extent": [ 531, 540 ], "quality_score": 100, "word_extent": [ 1, 2 ], "sound_most_like": "f" }, { "phone": "t", "stress_level": null, "extent": [ 540, 546 ], "quality_score": 100, "word_extent": [ 2, 3 ], "sound_most_like": "t" }, { "phone": "er", "stress_level": 0, "extent": [ 546, 549 ], "quality_score": 100, "stress_score": 100, "predicted_stress_level": 0, "word_extent": [ 3, 5 ], "sound_most_like": "er" } ], "syllable_score_list": [ { "phone_count": 2, "stress_level": 1, "letters": "af", "quality_score": 100, "stress_score": 100, "predicted_stress_level": 2, "extent": [ 519, 540 ] }, { "phone_count": 2, "stress_level": 0, "letters": "ter", "quality_score": 100, "stress_score": 100, "predicted_stress_level": 0, "extent": [ 540, 549 ] } ] }, { "word": "them", "quality_score": 100, "phone_score_list": [ { "phone": "dh", "stress_level": null, "extent": [ 549, 555 ], "quality_score": 100, "word_extent": [ 0, 2 ], "sound_most_like": "dh" }, { "phone": "eh", "stress_level": 1, "extent": [ 555, 564 ], "quality_score": 100, "stress_score": 100, "predicted_stress_level": 1, "word_extent": [ 2, 3 ], "sound_most_like": "eh" }, { "phone": "m", "stress_level": null, "extent": [ 564, 582 ], "quality_score": 100, "word_extent": [ 3, 4 ], "sound_most_like": "m" } ], "ending_punctuation": ".", "syllable_score_list": [ { "phone_count": 3, "stress_level": 1, "letters": "them", "quality_score": 100, "stress_score": 100, "predicted_stress_level": 1, "extent": [ 549, 582 ] } ] } ], "ielts_score": { "pronunciation": 9 }, "pte_score": { "pronunciation": 90 }, "speechace_score": { "pronunciation": 99 }, "toeic_score": { "pronunciation": 200 }, "cefr_score": { "pronunciation": "C2" } }, "version": "9.3" } ``` {% endcode %} {% endtab %} {% endtabs %} --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://api-docs.speechace.com/api-reference/score-text-pronunciation.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.