Conversation

ConversationSample holds a chat transcript: a list of messages, each a role and its content, in the shape every chat API and SFT corpus already uses.

Shape

from sdvm import ConversationSample, Message

sample = ConversationSample(
    messages=[
        Message("system", "You are a concise assistant."),
        Message("user", "how do i reverse a list in python"),
        Message("assistant", "Use slicing: `xs[::-1]` returns a reversed copy, or `xs.reverse()` in place."),
    ],
)

Plain dicts work too: messages=[{"role": "user", "content": "..."}, ...] is normalised to Message objects. On the wire:

{
  "task_type": "conversation",
  "messages": [
    { "role": "system", "content": "You are a concise assistant." },
    { "role": "user", "content": "how do i reverse a list in python" },
    { "role": "assistant", "content": "Use slicing: `xs[::-1]` returns a reversed copy, or `xs.reverse()` in place." }
  ]
}

Roles are system, user and assistant. A system message may appear once, and only first. The transcript needs at least one user and one assistant turn. Tool and function turns are not accepted. The type deliberately lets some defects through: an empty turn, a transcript that ends on the user, two user turns in a row. Those are what sdvm-audit-1 reports and sdvm-fix-1 repairs, so refusing them at construction would put them out of reach.

Extra columns

Anything beyond messages goes in extra and comes back untouched, exactly as on every other sample type:

ConversationSample(messages=[...], extra={"prompt_id": "a1b2", "source": "ultrachat"})

Turns

turns says how much of the transcript the models read. "last", the default, is the final exchange: the last user turn, the last assistant reply, and whether that reply belongs to the transcript. "all" is every assistant turn, each against the transcript before it, reported per turn under turns in the audit. Each turn read this way adds to the cost of the sample.

ConversationSample(messages=[...], turns="all")

On the wire it is "turns": "all" on the sample.

What the models return

sdvm-audit-1

What it returns for this sample.

sdvm-fix-1

What it changes, and what it never does.

Refine

Audit, fix and re-audit in one call.

Get started

Sample types

Models

Guides

SDK

HTTP API

Pricing and limits

Conversation

Shape

Extra columns

Turns

What the models return

sdvm-audit-1

sdvm-fix-1

Refine

​Shape

​Extra columns

​Turns

​What the models return

sdvm-audit-1

sdvm-fix-1

Refine

Shape

Extra columns

Turns

What the models return