---
title: ModelSample
framework: evaluations
role: symbol
role_heading: Structure
path: evaluations/modelsample
---

# ModelSample

A general-purpose language model evaluation sample.

## Declaration

```swift
struct ModelSample<ExpectedValue> where ExpectedValue : Decodable, ExpectedValue : Encodable, ExpectedValue : Sendable
```

## Mentioned in

Generating synthetic datasets

## Overview

Overview Accepts string-based prompts and instructions. For multimodal prompts, create a custom ModelSampleProtocol conformance or use the init(input:expected:expectations:) initializer with a prebuilt ModelSampleInput. let sample = ModelSample(prompt: "The capital of France is...", expected: "Paris.")

## Topics

### Creating a sample

- [init(prompt:expected:instructions:generationSchema:expectations:)](evaluations/modelsample/init(prompt:expected:instructions:generationschema:expectations:)-7daed.md)
- [init(prompt:expected:instructions:generationSchema:expectations:)](evaluations/modelsample/init(prompt:expected:instructions:generationschema:expectations:)-8mni.md)
- [init(input:expected:expectations:)](evaluations/modelsample/init(input:expected:expectations:).md)

### Specifying the query

- [prompt](evaluations/modelsample/prompt.md)
- [promptDescription](evaluations/modelsample/promptdescription.md)
- [instructions](evaluations/modelsample/instructions.md)
- [instructionsDescription](evaluations/modelsample/instructionsdescription.md)
- [input](evaluations/modelsample/input.md)

### Specifying expected output

- [expected](evaluations/modelsample/expected.md)
- [output](evaluations/modelsample/output.md)

### Specifying tool expectations

- [expectations](evaluations/modelsample/expectations.md)

### Configuring generation

- [generationSchema](evaluations/modelsample/generationschema.md)

### Bundled input and output

- [ModelSampleInput](evaluations/modelsampleinput.md)
- [ModelSampleOutput](evaluations/modelsampleoutput.md)

### Protocols

- [ModelSampleProtocol](evaluations/modelsampleprotocol.md)
- [SampleProtocol](evaluations/sampleprotocol.md)

## Relationships

### Conforms To

- [Copyable](swift/copyable.md)
- [Decodable](swift/decodable.md)
- [Encodable](swift/encodable.md)
- [Escapable](swift/escapable.md)
- [ModelSampleProtocol](evaluations/modelsampleprotocol.md)
- [SampleProtocol](evaluations/sampleprotocol.md)
- [Sendable](swift/sendable.md)
- [SendableMetatype](swift/sendablemetatype.md)

## See Also

### Datasets

- [Generating synthetic datasets](evaluations/generating-synthetic-evaluation-datasets.md)
- [Designing datasets to test your feature](evaluations/designing-evaluation-datasets.md)
- [Loader](evaluations/loader.md)
- [SampleGenerator](evaluations/samplegenerator.md)