Term
AgentProfile
A declarative description of an eligible kind of agent. It names capabilities, constraints, and intended roles without identifying a running process.
Purpose
Select and constrain which kinds of agents may be assigned to AgentRuns without confusing the kind with a live instance or an assignment.
Relationships
| Name | Target | Kind | Cardinality | Inverse |
|---|---|---|---|---|
instances | AgentInstance | observes | 0..* | profile 0..1 |
assigned_runs | AgentRun | observes | 0..* | agent_profile 0..1 |
Invariants
- MUST NOT
not-an-instance: An AgentProfile MUST NOT be treated as a running AgentInstance. - MUST NOT
not-an-assignment: An AgentProfile MUST NOT be treated as an AgentRun.
Aliases
agent-kind
Deprecated aliases
None.
Not synonyms
- AgentInstance: The instance is a running process or endpoint, not the declared kind.
- AgentRun: The run is a bounded assignment, not a reusable kind.
- Principal: A principal is an authenticated identity, which a profile is not.
Examples
- A "repository reviewer" profile reused across many AgentRuns.
Anti-examples
- A PID of a currently running agent process.
Fields
The identity field is the index of the handle. fields is the exchange shape.
| Name | Kind | Type | Portable | Notes |
|---|---|---|---|---|
agent_profile_id | identity | name | True | |
display_name | descriptive | string | True | |
capabilities | descriptive | list | True | |
constraints | policy | object | True |
Native mapping hooks
| System | Native term | Fidelity | Notes |
|---|---|---|---|
project-interop | _none_ | tbd |