Skip to content

Bedrock Agentcore Control  >  Structures  >  Harness

Harness

Structure Class

Harness dataclass

Representation of a harness.

Attributes

allowed_tools instance-attribute
allowed_tools: list[str]

The allowed tools of the harness. All tools are allowed by default.

arn instance-attribute
arn: str

The ARN of the harness.

authorizer_configuration class-attribute instance-attribute
authorizer_configuration: AuthorizerConfiguration | None = None

Represents inbound authorization configuration options used to authenticate incoming requests.

created_at instance-attribute
created_at: datetime

The createdAt time of the harness.

environment instance-attribute

The compute environment on which the Harness runs.

environment_artifact class-attribute instance-attribute
environment_artifact: HarnessEnvironmentArtifact | None = None

The environment artifact (e.g., container) in which the Harness operates.

environment_variables class-attribute instance-attribute
environment_variables: dict[str, str] | None = field(repr=False, default=None)

Environment variables exposed in the environment in which the harness operates.

execution_role_arn instance-attribute
execution_role_arn: str

IAM role the harness assumes when running.

failure_reason class-attribute instance-attribute
failure_reason: str | None = None

Reason why create or update operations fail.

harness_id instance-attribute
harness_id: str

The ID of the harness.

harness_name instance-attribute
harness_name: str

The name of the harness.

harness_version class-attribute instance-attribute
harness_version: str | None = None

The version of the harness. Incremented on every successful UpdateHarness.

max_iterations class-attribute instance-attribute
max_iterations: int | None = None

The maximum number of iterations in the agent loop allowed before exiting per invocation.

max_tokens class-attribute instance-attribute
max_tokens: int | None = None

The maximum total number of output tokens the agent can generate across all model calls within a single invocation.

memory class-attribute instance-attribute
memory: HarnessMemoryConfiguration | None = None

AgentCore Memory instance configuration for short and long term memory.

model instance-attribute

The configuration of the default model used by the Harness.

skills instance-attribute
skills: list[HarnessSkill]

The skills of the harness.

status instance-attribute
status: HarnessStatus

The status of the harness.

system_prompt instance-attribute
system_prompt: list[HarnessSystemContentBlock]

The system prompt of the harness.

timeout_seconds class-attribute instance-attribute
timeout_seconds: int | None = None

The maximum duration per invocation.

tools instance-attribute
tools: list[HarnessTool]

The tools of the harness.

truncation instance-attribute

Configuration for truncating model context.

updated_at instance-attribute
updated_at: datetime

The updatedAt time of the harness.