AgentProfile class

Declares one purpose-specific agent to the orchestrator: identity, persona (instructions), tools, context residency, and sampling.

This is plain configuration data. The orchestrator uses it to size and schedule the agent's KV-cache residency; building an agent abstraction on top is the host app's job — see AgentHandle.chatClient.

Constructors

AgentProfile({required String id, String? name, String? description, String? instructions, List<AITool>? tools, AgentPriority priority = AgentPriority.normal, int? preferredContextTokens, SamplingDefaults? sampling})

Creates a profile.

const

Properties

description → String?

Description of the agent's purpose.

final

hashCode → int

The hash code for this object.

no setter, inherited

id → String

Stable identifier; keys the agent's registry entry, KV snapshots on disk, and stash entries.

final

instructions → String?

System instructions (persona) to apply to every run of this agent.

final

name → String?

Human-readable name for this agent; defaults to id.

final

preferredContextTokens → int?

Context-size hint. Advisory in v1: the shared context is sized by the memory budget, not per agent.

final

priority → AgentPriority

Eviction priority under memory pressure.

final

runtimeType → Type

A representation of the runtime type of the object.

no setter, inherited

sampling → SamplingDefaults?

Sampling defaults overriding the model spec's, when set.

final

tools → List<AITool>?

Tools this agent may invoke.

final

Methods

noSuchMethod(Invocation invocation) → dynamic

Invoked when a nonexistent method or property is accessed.

inherited

toString() → String

A string representation of this object.

inherited

Operators

operator ==(Object other) → bool

The equality operator.

inherited