Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
The objects Hue records and evaluates, where to find them in the app, and their names in the SDKs and MCP.
| Term | What it is | In Hue |
|---|---|---|
| Trace | One recorded execution of your application: a tree of OpenTelemetry spans with one root. | Traces |
| Span | One timed step in a trace, such as a model call, tool call or agent step. | Trace detail |
| Session | Traces grouped by the session id your application records, such as turns in one conversation. | Traces filter |
| Finding | A problem Hue detects in an ended trace, such as an unrecovered tool error or a reply that claims an action no tool performed. A trace with a finding needs attention. | Traces |
| Trace check | A project-defined, versioned check of production behavior, such as whether a handoff expanded the request. Advisory, not a score. | Traces |
| Intent | The task type a trace belongs to, classified against your project’s published taxonomy. | User Intent |
| Term | What it is | In Hue |
|---|---|---|
| Eval set | A versioned collection of cases. A run pins one eval set version. | Evals |
| Case | One example: the task, its inputs, optional expected values and reviewed success criteria. You can create one from a trace. | Evals |
| Evaluator | How quality is measured: a deterministic verifier or a hosted LLM judge with a pinned model and rubric. | Evaluators |
| Run | Your agent executed over an eval set version, with each case’s output, trace and scores. Compare runs to catch regressions. | Runs |
| Scoring run | Evaluators applied to outputs a run already stored, without running the agent again. | Runs |
| Environment | A simulated app (for example Linear or Gmail): its starting data and the actions an agent can take. | Environments |
| World | A fresh instance of an environment version for one execution. Its journal of actions is scoring evidence. | Environments |
| Term | What it is |
|---|---|
| Project | The workspace that holds traces, eval sets, runs and keys. |
| Project key | A server-side key with one preset: Read, Read and write or Tracing only. Created in Settings → Integrations & API keys. See Project keys. |
| Hue MCP | The project-data MCP server at https://mcp.hue.run/mcp. Agents connect by signing in with Hue or with a key. See Hue MCP. |
createEvalSet, createEvaluator and createRun in TypeScript, create_eval_set, create_evaluator and create_run in Python, and fields such as eval_set_id, evaluator_version_id, run_id and scoring_run_id. Older methods, REST paths and response fields still say dataset, scorer and experiment; the TypeScript and Python references mark which ones are deprecated.