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

# profiles • AI Agent SDK

> Harness profiles and the model-family resolver.

# profiles

<Badge color="blue">AI Agent</Badge>

Harness profiles and the model-family resolver.

A :class:`HarnessProfile` bundles two family-tuned knobs:

* `base_prompt` — an optional system-prompt fragment prepended to the
  assembled prompt with family-specific tool-use guidance.
* `preferred_edit_format` — the file-edit primitive the family handles
  best (`"apply_patch"` or `"edit_file"`); `None` keeps the current
  both-exposed behaviour.

The registry maps case-insensitive substring matchers (evaluated against the
model id) to profiles. Unknown models fall back to :data:`DEFAULT_PROFILE`,
which is behaviour-preserving (no prompt fragment, no edit-format preference).

## Import

```python theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
from praisonaiagents.model_harness import profiles
```

## Classes

<CardGroup cols={2}>
  <Card title="HarnessProfile" icon="brackets-curly" href="../classes/HarnessProfile">
    A model-family harness profile.
  </Card>

  <Card title="HarnessResolverProtocol" icon="brackets-curly" href="../classes/HarnessResolverProtocol">
    Protocol for objects that resolve a model id to a harness profile.
  </Card>
</CardGroup>

## Functions

<CardGroup cols={2}>
  <Card title="register_profile()" icon="function" href="../functions/register_profile">
    Register (or prepend) a family matcher → profile mapping.
  </Card>

  <Card title="resolve_harness()" icon="function" href="../functions/resolve_harness">
    Resolve a model id to a :class:`HarnessProfile`.
  </Card>
</CardGroup>

### Constants

| Name              | Value                            |
| ----------------- | -------------------------------- |
| `DEFAULT_PROFILE` | `HarnessProfile(name='default')` |

***

## Related Documentation

<CardGroup cols={2}>
  <Card title="Agent Profiles" icon="id-card" href="/docs/docs/features/agent-profiles" />

  <Card title="Profiling" icon="chart-line" href="/docs/docs/features/profiling" />
</CardGroup>