Harness

Representation of a Harness.

allowedTools

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

Type: Array of strings

Length Constraints: Minimum length of 1. Maximum length of 64.

Pattern: (\*|@?[^/]+(/[^/]+)?)

Required: Yes

arn

The ARN of the Harness.

Type: String

Pattern: arn:([^:]+)?:bedrock-agentcore:[a-z0-9-]+:[0-9]{12}:harness/[a-zA-Z][a-zA-Z0-9_]{0,39}-[a-zA-Z0-9]{10}

Required: Yes

createdAt

The createdAt time of the Harness.

Type: Timestamp

Required: Yes

environment

The compute environment on which the Harness runs.

Type: HarnessEnvironmentProvider object

Note: This object is a Union. Only one member of this object can be specified or returned.

Required: Yes

executionRoleArn

IAM role the Harness assumes when running.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 2048.

Pattern: arn:aws(-[^:]+)?:iam::([0-9]{12})?:role/.+

Required: Yes

harnessId

The ID of the Harness.

Type: String

Pattern: [a-zA-Z][a-zA-Z0-9_]{0,39}-[a-zA-Z0-9]{10}

Required: Yes

harnessName

The name of the Harness.

Type: String

Pattern: [a-zA-Z][a-zA-Z0-9_]{0,39}

Required: Yes

model

The configuration of the default model used by the Harness.

Type: HarnessModelConfiguration object

Note: This object is a Union. Only one member of this object can be specified or returned.

Required: Yes

skills

The skills of the Harness.

Type: Array of HarnessSkill objects

Required: Yes

status

The status of the Harness.

Type: String

Required: Yes

systemPrompt

The system prompt of the Harness.

Type: Array of HarnessSystemContentBlock objects

Required: Yes

tools

The tools of the Harness.

Type: Array of HarnessTool objects

Required: Yes

truncation

Configuration for truncating model context.

Type: HarnessTruncationConfiguration object

Required: Yes

updatedAt

The updatedAt time of the Harness.

Type: Timestamp

Required: Yes

authorizerConfiguration

Represents inbound authorization configuration options used to authenticate incoming requests.

Type: AuthorizerConfiguration object

Note: This object is a Union. Only one member of this object can be specified or returned.

Required: No

environmentArtifact

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

Type: HarnessEnvironmentArtifact object

Note: This object is a Union. Only one member of this object can be specified or returned.

Required: No

environmentVariables

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

Type: String to string map

Map Entries: Minimum number of 0 items. Maximum number of 50 items.

Key Length Constraints: Minimum length of 1. Maximum length of 100.

Value Length Constraints: Minimum length of 0. Maximum length of 5000.

Required: No

failureReason

Reason why create or update operations fail.

Type: String

Required: No

maxIterations

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

Type: Integer

Required: No

maxTokens

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

Type: Integer

Required: No

memory

AgentCore Memory instance configuration for short and long term memory.

Type: HarnessMemoryConfiguration object

Note: This object is a Union. Only one member of this object can be specified or returned.

Required: No

timeoutSeconds

The maximum duration per invocation.

Type: Integer

Required: No

Harness

Contents

See Also