Instruction Following
llm.instruction_following
Measures how reliably the system obeys explicit format and length instructions.
Contract
| Field | Value |
|---|---|
version | 1.0.0 |
metric_type | pointwise |
scorer_contract | per_row |
direction | higher_is_better |
entrypoint | aip_metrics_llm.unanswered.instruction_following |
target_kind | None |
Required columns
input_idpromptsut_response
Accepted schemas
[
{
"name": "gdi_text_v1",
"task_types": [
"multi_turn_llm",
"multi_turn_rag",
"single_turn_llm",
"single_turn_rag"
]
}
]
Methodology
- Deterministic scoring - no judge LLM (an optional generator only rephrases the prompts).
- Generate constrained variants of the query (e.g. exact sentence count, word limit, JSON format, two-part separator).
- Send each to the system under test.
- Programmatically check each response against its constraint and report followed / valid.
Score semantics
Scores range 0-1, the fraction of constrained variants whose response satisfied its instruction. A high score means the system follows format/length rules; a low score means it ignores them. Higher is better.
Worked example
Of 4 constraints (exactly 2 sentences, JSON output, under 10 words, two responses separated by '---'), the system satisfies 3 -> 0.75.
Configuration schema
{
"properties": {
"inverted": {
"default": false,
"title": "Inverted",
"type": "boolean",
"x-aip-param-role": "scoring_metadata"
},
"language": {
"default": "en",
"enum": [
"en",
"de",
"fr"
],
"title": "Language",
"type": "string"
},
"max": {
"default": 1.0,
"title": "Max",
"type": "number",
"x-aip-param-role": "scoring_metadata"
},
"metric_name": {
"default": "instruction_following",
"title": "Metric Name",
"type": "string",
"x-aip-param-role": "scoring_metadata"
},
"min": {
"default": 0.0,
"title": "Min",
"type": "number",
"x-aip-param-role": "scoring_metadata"
},
"n_sut_retries": {
"default": 0,
"maximum": 5,
"minimum": 0,
"title": "N Sut Retries",
"type": "integer"
},
"num_samples": {
"default": 4,
"maximum": 32,
"minimum": 1,
"title": "Num Samples",
"type": "integer"
},
"rephrase_probability": {
"default": 0.5,
"maximum": 1.0,
"minimum": 0.0,
"title": "Rephrase Probability",
"type": "number"
},
"sub_call_concurrency_limit": {
"default": 5,
"maximum": 64,
"minimum": 1,
"title": "Sub Call Concurrency Limit",
"type": "integer",
"x-aip-param-role": "operational"
},
"sut_temperature": {
"default": 0.7,
"maximum": 2.0,
"minimum": 0.0,
"title": "Sut Temperature",
"type": "number"
},
"synthesis_temperature": {
"default": 0.0,
"maximum": 2.0,
"minimum": 0.0,
"title": "Synthesis Temperature",
"type": "number"
},
"timeout_seconds": {
"default": 60.0,
"exclusiveMinimum": 0,
"title": "Timeout Seconds",
"type": "number",
"x-aip-param-role": "operational"
},
"weight": {
"default": 1.0,
"title": "Weight",
"type": "number",
"x-aip-param-role": "scoring_metadata"
}
},
"title": "InstructionFollowingConfig",
"type": "object"
}
Execution
{
"emits_metric_family": false,
"function_name": null,
"max_concurrency": 8,
"processing_kind": "network",
"stream_batch_size": null,
"timeout_seconds": 900
}
Complete manifest
accepts:
- name: gdi_text_v1
task_types:
- multi_turn_llm
- multi_turn_rag
- single_turn_llm
- single_turn_rag
config_schema:
properties:
inverted:
default: false
title: Inverted
type: boolean
x-aip-param-role: scoring_metadata
language:
default: en
enum:
- en
- de
- fr
title: Language
type: string
max:
default: 1.0
title: Max
type: number
x-aip-param-role: scoring_metadata
metric_name:
default: instruction_following
title: Metric Name
type: string
x-aip-param-role: scoring_metadata
min:
default: 0.0
title: Min
type: number
x-aip-param-role: scoring_metadata
n_sut_retries:
default: 0
maximum: 5
minimum: 0
title: N Sut Retries
type: integer
num_samples:
default: 4
maximum: 32
minimum: 1
title: Num Samples
type: integer
rephrase_probability:
default: 0.5
maximum: 1.0
minimum: 0.0
title: Rephrase Probability
type: number
sub_call_concurrency_limit:
default: 5
maximum: 64
minimum: 1
title: Sub Call Concurrency Limit
type: integer
x-aip-param-role: operational
sut_temperature:
default: 0.7
maximum: 2.0
minimum: 0.0
title: Sut Temperature
type: number
synthesis_temperature:
default: 0.0
maximum: 2.0
minimum: 0.0
title: Synthesis Temperature
type: number
timeout_seconds:
default: 60.0
exclusiveMinimum: 0
title: Timeout Seconds
type: number
x-aip-param-role: operational
weight:
default: 1.0
title: Weight
type: number
x-aip-param-role: scoring_metadata
title: InstructionFollowingConfig
type: object
dependencies: []
description: How reliably does the system obey explicit format and length instructions?
direction: higher_is_better
display_name: Instruction Following
entrypoint: aip_metrics_llm.unanswered.instruction_following
execution:
emits_metric_family: false
function_name: null
max_concurrency: 8
processing_kind: network
stream_batch_size: null
timeout_seconds: 900
kind: metric
manifest_version: '1'
max_prompt_slots: 0
metric_metadata:
methodology:
- Deterministic scoring - no judge LLM (an optional generator only rephrases the
prompts).
- Generate constrained variants of the query (e.g. exact sentence count, word limit,
JSON format, two-part separator).
- Send each to the system under test.
- Programmatically check each response against its constraint and report followed
/ valid.
score_semantics: Scores range 0-1, the fraction of constrained variants whose response
satisfied its instruction. A high score means the system follows format/length
rules; a low score means it ignores them. Higher is better.
summary: Measures how reliably the system obeys explicit format and length instructions.
worked_example: Of 4 constraints (exactly 2 sentences, JSON output, under 10 words,
two responses separated by '---'), the system satisfies 3 -> 0.75.
metric_type: pointwise
name: llm.instruction_following
partition_types: []
required_columns:
- input_id
- prompt
- sut_response
required_kinds: []
scorer_contract: per_row
target_kind: null
unsupported_trace_shapes: []
version: 1.0.0