Onboarding¶
Agents / Onboarding is where the tests you already have arrive: from a document, a spreadsheet, a requirements tool or a folder full of Word files. Your assistant reads them and writes them here as procedures, test cases, sentences and data points — things that run.
An import is an event, not a state. Every import stays as its own record, and the page is where somebody looks in three months to answer the question that always comes back: where did this test case come from?
What the page shows¶
Per run: what was imported, with the procedure it landed in, how many steps and how many of them are checks, what happened to it — created, updated, left as it was, deleted — and the source it was read from, as a link where there is one.
Below that: what was adapted — a test case taken over, but not word for word: what differs, from what to what, why, and whether the meaning stayed the same. Where the meaning changed, the person who agreed is named; without that name the run is not accepted. The test case's name leads to it. Then what was not written, each with the reason. A line that could not become a step is worth more here than a test case that pretends to run.
Before an assistant hands the run in, it checks each procedure it imported into
with check_procedure and runs one test case of each as a dry run; if it has
not, the check before handing in says which are missing.
Every run names the source it read — with its name as a link and its scope, the set or folder it was taken from — and each test case carries its own Source line in its description. That line is never translated: the next import looks for it literally.
An import keeps the order and meaning of each test as the source has it. Where a source sets a condition after the event that should cause the reaction, or builds one condition out of two such events, the assistant brings the test in as it is and says so — a coverage run or you decide. It may propose the corrected order alongside; it does not rearrange anything on its own.
What you do here¶
- Schedule onboarding asks your assistant for an import: choose the source of the test cases — one that is recorded, or a new one with its link and the part of it that is meant. The request waits in the Agent queue; tell your assistant Work through the open requests in XPressRT. It is closed by the onboarding run that read from that source.
- Read what came in, and open a test case from the list.
- Check the refused ones — usually a sentence that has no step, or a value nobody could resolve.
- Export the run as HTML when somebody outside needs the record.
What to expect of an import¶
Test cases arrive tagged ai-generated: an assistant wrote them and nobody has read them back yet. Removing the tag is the review. What the import creates — sentences, data points, block files — is written in English, whatever language you speak with the assistant; only quotes from your source stay as they are.
An import never changes a result, and it never starts a real run.
A whole set at once¶
An assistant does not have to create a set one call at a time. It writes a
plan — a JSON file in your workspace, usually under local/data/ — that
holds what is to come in: data points, step sentences, procedures, test cases,
preparations. Then one call brings it in.
Two things about it are worth knowing, because they decide what you can rely on:
- It may do exactly what one call at a time may do. Every piece goes through the same door as its single counterpart and through the same checks: a sentence that does not exist, a data point in the wrong direction, a placeholder left in a test case — everything that is refused singly is refused here. New is the number, not the permission.
- All of it or none of it. At the first no, your workspace stands as it did before, and the answer says which piece it was and why. A half-imported set is the state nobody can say anything about afterwards — not you, and not the assistant that wrote it.
The plan also has a place for what the assistant could not place, with a reason. That part is not written; it is the honest half, and it comes back in the answer.
The plan file is not the record. What somebody opens in three months to find out
where a test case came from is this page — so an assistant that imports also
hands in an onboarding run. XPressRT says so by itself: a workspace with test
cases that carry a Source: line and no onboarding run recording them is named
in the assistant's answers, at three, ten, twenty-five of them.