> For the complete documentation index, see [llms.txt](https://speaking-test-docs.speechace.com/speechace-speaking-test/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://speaking-test-docs.speechace.com/speechace-speaking-test/speechace-workspaces-create-manage-and-share-speaking-assessments/creating-assessments/scoring-logic/scoring-with-maximum-scores-weights-and-randomization.md).
# Scoring with Maximum Scores, Weights and Randomization
Let us consider an assessment that uses a combination of [weights and maximum scores](/speechace-speaking-test/speechace-workspaces-create-manage-and-share-speaking-assessments/creating-assessments/custom-assessments/speaking-and-writing-assessments/assessment-configurations/weights-max-scores-timers.md). The test creator has created two groups: **Pronunciation** (with a maximum score of 8.0 and a weight of 70%) and **Fluency** (with a maximum score of 3.0 and a weight of 30%).
The above configuration not only specifies the maximum possible score for a question but also caps the maximum possible score for the assessment. In the below paragraphs, we explain the logic behind each of these calculations.
**Maximum possible score for the assessment**\
\
The maximum possible score for the assessment is determined by a weighted average of the maximum scores of each question group as illustrated in the formula below:
Aggregate Maximum Score Calculation = Sum of (`Max score of group` x `weight of group`) / (100)
For this example, the **Pronunciation** group has a a max score of 8.0 and a weight of 70% and the **Fluency** group has a max score of 3.0 and a weight of 30%. Therefore the max possible score for the assessment will be 6.5 out of 9.0, as shown in the calculation below:
$$
\[(8.0*70)+(3.0*30)]/100=6.5
$$
No attempt for this assessment will have a score > 6.5
#### Scoring an attempt
When an attempt is made on the assessment, the score for each question is capped by its group's maximum score. The overall attempt score is then calculated by taking a weighted average of the average question score of all groups as illustrated below:
Score = Sum of (`average question score for group` x `weight of section`)/100
As an example, if the Speechace scores for the two **Pronunciation** questions are 8.0 and 7.6, and the one **Fluency** question is 3.0 (all out of 9.0), the final assessment score will be 6.4 out of 9.0 as per the calculation below:
$$
\[(((8.0+7.6)/2)*70)+(3.0*30)]/100=6.4
$$
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## 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, and the optional `goal` query parameter:
```
GET https://speaking-test-docs.speechace.com/speechace-speaking-test/speechace-workspaces-create-manage-and-share-speaking-assessments/creating-assessments/scoring-logic/scoring-with-maximum-scores-weights-and-randomization.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
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.