Skip to main content
Candidates are the prompts or agents you want to compare in an experiment. When you add a candidate, Fetch Hive captures the source configuration at that moment. Later edits to the source prompt or agent do not change the candidate already added to the experiment.

​
Candidate types

Candidate typeWhat it usesWhen to use it
Dashboard PromptThe current prompt from the dashboard editorUse this when you are iterating on a prompt before publishing it.
Deployed PromptA prompt deployment, variant, and versionUse this when you want to test the exact version your app or API callers use.
AgentThe current agent configurationUse this when you want to test agent behavior over many rows.

​
How do I add a dashboard prompt?

Open the experiment. Click Add candidate. Choose Dashboard Prompt as the type. Select the prompt. Click Add candidate. Use this when you want to compare the current prompt editor state.

​
How do I add a deployed prompt?

Open the experiment. Click Add candidate. Choose Deployed Prompt as the type. Select the prompt. Select the deployed prompt. Select the variant. Select the version. Click Add candidate. Use this when you want repeatable testing against a specific production or staging deployment version.

​
How do I add an agent?

Open the experiment. Click Add candidate. Choose Agent as the type. Select the agent. Click Add candidate. Use this when you want to test an agent against a structured dataset.

​
Candidate settings

Candidate settings are read-only in experiments right now. Edit model, temperature, tools, instructions, and other settings in the prompt or agent editor before adding the candidate. Experiment-local overrides are planned for a future version.

​
Refreshing a candidate snapshot

Use Refresh snapshot when the source prompt, deployed prompt, or agent has changed and you want future runs to use the latest source configuration. Refreshing updates the existing candidate’s captured snapshot. It does not change historical run results. Use this when you want to keep the same candidate row in an experiment instead of archiving and re-adding it. For deployed prompts, refresh uses the same selected deployment, variant, and version reference. If you want to test a different deployed version, add a new candidate for that version.

​
Archived candidates

If you archive a candidate, it is removed from future experiment setup and run selections. Existing run results remain available so previous comparisons still make sense. Archiving requires confirmation. See also: Prompts, Publishing and versioning, and Agents