Docs menu Glossary

DocsReference

Glossary

Every Spark Loops term in plain words. Terms are linked here from their first use on each page.

The agent

Agent
An AI assistant that does a job for you.
Specialist agent
One agent with one job, plus its instructions, examples and scoring guide.
Instructions
What your agent is told to do. This is what Spark improves.
Known mistakes
Ways the agent could go wrong, written down so each new version is tested against them.
Scoring guide
How good work is scored.
Quick offline check
A basic check that runs on your computer.
Draft-only
A new agent can draft, but nothing changes until you allow it.

A training round

Round
One training round: try new versions, test them, and check the result.
Training run
A series of rounds with a spending limit.
New version
A proposed new version of the agent's instructions.
Who writes new versions
Spark suggests new instructions and checks the work. Chat planning is coming soon.
Testing on your examples
Running a new version through your examples.
Quality check
A check that the work can be reviewed.
Spending limit
The most you allow a training run to spend. Training stops there.
What to work on
An optional note about the weakness you want to improve.

Reviewers

AI reviewers
Separate AI models that compare the work.
Checked blind
Reviewers do not know which version is which.
Reviewer
One AI reviewer.
Reviewer feedback
The AI reviewers' assessment of the work.

The hidden test

Hidden test
A separate check on fresh examples.
A test it cannot study for
A check that helps you look beyond the practice examples.
Test failure
A result that highlights a mistake in the work.

Your decision

Your best version
The best version so far. A new one replaces it only after you approve the upgrade.
Upgrade ready for you to approve
A proposed change for you to review and approve before use.
Keep what you had
You can keep the current instructions instead of approving a change.
Comparing results
Read scores alongside the examples and the conditions of each test.

Getting unstuck

Stuck
Several rounds in a row with no improvement.
Further experiments
More instruction variations to try when progress stalls.
Real outcome
A real result you record, for example how a lead actually turned out.

Grok Bot and helpers

Training brief
A short plan for what a training run should work on.
Decision record
The record of the decision: keep the change, keep it as a draft only, or change nothing.
Outside helper
Connecting outside helpers to suggest new versions is coming soon.
Direct connection
Connecting outside helpers is coming soon.