> ## Documentation Index
> Fetch the complete documentation index at: https://medlogprotocol.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Record schema overview

> Each MedLog record corresponds to one model invocation and contains nine fields.

The MedLog protocol captures AI use at the level of an inference call. It applies to simple
"prompt to model to response" systems as well as multi-stage workflows that use retrieval, tools,
rubric-based evaluation, or agentic orchestration. MedLog treats each model invocation as an event and
allows events to be linked within the same run or episode.

Each MedLog record corresponds to **one model invocation** and contains the following nine fields.

## Fields available at invocation

<CardGroup cols={2}>
  <Card title="Header" icon="fingerprint" href="/specification/header">
    Provenance information, execution context, and system metadata available at inference time.
  </Card>

  <Card title="Model instance" icon="microchip" href="/specification/model-instance">
    Stable identifiers of the AI model and version, with references to its model card and data sheet.
  </Card>

  <Card title="User identity" icon="gears" href="/specification/user-identity">
    The technical process, service, or workflow that invokes the model call.
  </Card>

  <Card title="Target identity" icon="crosshairs" href="/specification/target-identity">
    A reference to the entity about which the model produces output.
  </Card>

  <Card title="Inputs" icon="keyboard" href="/specification/inputs">
    The input data provided to the model.
  </Card>
</CardGroup>

## Fields appended later

<CardGroup cols={2}>
  <Card title="Internal artifacts" icon="diagram-project" href="/specification/internal-artifacts">
    Artifacts generated during inference for technical researchers and MLOps engineers.
  </Card>

  <Card title="Patient- or clinician-facing outputs" icon="comment-dots" href="/specification/outputs">
    The outputs intended for human users.
  </Card>

  <Card title="Outcomes" icon="flag-checkered" href="/specification/outcomes">
    Records of clinical actions or patient outcomes linked to the model recommendation.
  </Card>

  <Card title="User feedback" icon="comment-check" href="/specification/user-feedback">
    Any feedback provided by users, whether structured ratings or free-text comments.
  </Card>
</CardGroup>

<Note>
  This documentation describes the conceptual nine-field model from the MedLog protocol. The
  [API reference](/api-reference/overview) defines the concrete event payloads a collector accepts. See
  the [annotated example record](/specification/example-record) for how the two relate.
</Note>
