Documentation Index
Fetch the complete documentation index at: https://trygradient.ai/docs/llms.txt
Use this file to discover all available pages before exploring further.
Candidates & Sessions
Candidates
A candidate is a person being evaluated. Candidates are identified by email and scoped to your organization. The same person can take multiple assessments, and each attempt creates a separate session. Candidates are not admin users - they don’t log into the admin portal. Instead, they receive a unique link that drops them directly into the assessment workspace.Sessions
A session represents one candidate’s attempt at one assessment. It tracks everything: when they started, what they configured, every message they exchanged with the AI, and the final deliverable they submitted.Session lifecycle
| Status | What’s happening |
|---|---|
invited | Candidate received the link but hasn’t opened it yet |
setup | Candidate is configuring their workspace (connecting data sources, creating skills, setting memory) |
in_progress | Candidate is working on the task with AI assistance |
submitted | Candidate submitted their deliverable (or time expired) |
scoring | The automated scoring engine is evaluating the submission |
scored | Scores are available for admin review |
reviewed | An admin has reviewed and optionally adjusted the scores |
What happens during a session
Setup phase
The candidate configures their AI workspace: connecting data sources, uploading or creating skills, writing memory entries, and editing their agents.md configuration. This phase has its own timer.
Task phase
The candidate works with the AI assistant to complete the task brief. They can chat, run tool calls (like creating slides), search connected data sources, and iterate on their deliverable. A countdown timer is visible.