Teanga Bench Tonada suite

Methodology

Teanga Bench measures how well a large language model does the work of a language tutor. It has two suites.

This page says where the test items come from, how answers are marked, and what the scores can and cannot tell you.

What we publish and what we keep private

The code, the scoring rules, the build scripts and this page are public. For each test, 20 sample items are public. The full item sets are private. They stay on the machine that runs the benchmark and are never put in the repository. We do this so that the test items do not enter model training data.

Failure examples on the model pages come only from the public sample items.

Where the items come from

No answer in the benchmark was written by a language model for the benchmark. A build script copies each answer from a source file, or derives it from a source file by a rule that the script documents. Each item records its source, the licence of the source, and how strong the evidence for its answer is.

The sources are:

No human review

No person reviewed the items for this benchmark. Every item has human_checked: false. The app content is itself largely machine-authored and machine-reviewed. A score on an app-derived test therefore measures agreement with the app content. It is not a score against a standard that an expert signed off.

Each item carries an evidence label so that results can be split by it:

LabelMeaning
blas-app+bunamoThe answer is in the app content, and every word of it is a form that BÚNaMo lists.
blas-app+kaikkiThe answer is in the app content, and Kaikki lists it as a form.
blas-app-onlyThe answer is in the app content. We had no second source. All Welsh and Breton app items are in this group.
blas-app-unverifiedThe app content itself marks the sentence as not yet verified. All Cornish sentences in the translation tests are in this group.
corpus-referenceThe reference translation comes from a published parallel corpus.
distractor-derived-unverifiedThe error sentence was made by putting a wrong option from an app exercise into the sentence. See "Tutor tests".
planted-typoThe error is a doubled letter that a script planted in a clean sentence.
tonada-app-machine-reviewedThe exercise is in the Tonada app content, and the app's automated review marks it verified.
tonada-app-distractor-machine-reviewedThe error sentence was made by putting a wrong option from a Tonada exercise into the sentence.
tonada-app-answer-machine-reviewedA correct sentence from a Tonada exercise, used as a sentence with no error.
wikipedia-revision-silver-unreviewedA real edit from the English Wikipedia history. Some are changes of style and not clear errors.

A cross-check with BÚNaMo or Kaikki shows that a form exists. It does not show that the form is the right one for the question.

Licences

Each item records a licence. The app's own content is marked private-blas or private-tonada. Where the app took a sentence from another source, the item carries the licence of that source:

BÚNaMo, used for cross-checks, is under the Open Database Licence 1.0. Each public sample file has an attribution file beside it that lists its sources, licences and notices.

The tests

The table of tests on this page is generated from the build reports. It shows the number of items, the languages and the evidence counts for each test.

Grammar forms and lesson exercises

The model is asked for one form or one answer: a genitive, a verb form, a prepositional pronoun, a number, the right option in an exercise. The answer is compared with a list of accepted answers after light normalisation (case, apostrophe style and outer spaces do not matter). The list contains every alternative that the source records.

Limit: if a valid dialect or variant form is not in the source, the model is marked wrong for it. Few items have more than one accepted answer, because the sources rarely list alternatives.

Translation and round trip

In the translation test the model translates a sentence into English or from English. In the Breton corpus items the other language is French. The score is chrF++, a standard measure of character and word overlap with the reference translation.

In the round-trip test the model translates a sentence into English, and then, in a new conversation, translates its own English back. The score is chrF++ between the result and the original sentence.

Limits: an overlap measure gives a lower score to a correct translation that uses different words. Most translation items have one reference. Round-trip scores can be high when a model makes the same mistake in both directions.

Tutor tests

The model sees a learner's sentence. The sentence has one error or no error. The model must say if there is an error, give the wrong span, give the correction, give the corrected sentence and explain the error.

The headline score is marked by rule. An item is correct when the model finds the error, fixes it, and changes nothing else. For a sentence with no error, the model must say so and leave the sentence as it is. About one third of the items have no error.

The error sentences are not real learner errors. We found no corpus of real learner errors for these languages. The errors come from three places:

The Blas tutor test covers Irish, Welsh and Scottish Gaelic only. The app has too few suitable exercises for Manx, Breton and Cornish, and a test built on planted typos alone would mislead.

The explanation score

The explanation is the only part that a model marks. Two judge models from two different model families mark each explanation. The explanation passes only when both judges pass it. The same two judges mark every model, so the scores can be compared. A model from the same family as a judge gets no explanation score.

No person has checked the judges' marks. For this reason the explanation score is reported apart from the headline score, with the rate at which the two judges agreed. If a judge call fails three times, the explanation is left unscored. It is not counted as wrong.

Runs, intervals and cost

Contamination

A model may have seen some of the source text in training. Each translation item is labelled private or public-source.

Known limits

Test sets in the Tonada suite

Generated from the build reports in data/build-reports/. Items are sampled with a fixed seed. The full sets are private; 20 items per test are published in samples/tonada.

Items per test, with counts by group. Human-checked counts only items whose source records human review.

TestItemsPublicFirst languageCEFR levelHuman-checked
Lesson exercises
exercises
40020Japanese 100, Portuguese 100, Spanish 100, Vietnamese 100A1 70, A2 66, B1 128, B2 1360
Tutor accuracy
tutor_accuracy
36020Japanese 90, Portuguese 90, Spanish 90, Vietnamese 90A1 56, A2 56, B1 97, B2 107, Unspecified 440

Evidence says how strong the gold answer is: for example whether a course answer is confirmed by a dictionary, or comes from the course alone.

Lesson exercises

Closed English exercises from the Tonada course, with the instruction in the learner's first language, marked against the accepted answers.

Sources
grammar-lessons.json, grammar-lessons.review.json, lesson-screens.json, lesson-screens.review.json, tonada-grammar-lessons, tonada-lesson-screens
Licences
private-tonada 400
Evidence
tonada-app-machine-reviewed 400
Build report
tonada_exercises.json

Tutor accuracy

Find and fix the error in an English sentence, or leave a correct sentence alone; an item counts only when the error is found and fixed and nothing else is changed.

Sources
eng_sentences_detailed.tsv.bz2, english-clean.jsonl, english-error.jsonl, lesson-screens.json, lesson-screens.review.json, manifest.json, tonada-grammar-lessons, tonada-lesson-screens, wikiedits-multigec-en
Licences
CC BY-SA 4.0 (Wikipedia text); MIT (WikiEdits-MultiGEC dataset, https://huggingface.co/datasets/lang-uk/WikiEdits-MultiGEC) 44, private-tonada 316
Evidence
tonada-app-answer-machine-reviewed 106, tonada-app-distractor-machine-reviewed 210, wikipedia-revision-silver-unreviewed 44
Shortfalls
japanese, portuguese, spanish, vietnamese (see the build report)
Build report
tonada_tutor_accuracy.json