Skip to content

Harness

Source code in docs_src/capo_bedrock_agentcore_control/types/harness.py
class Harness(TypedDict, closed=True):
    harness_id: "capo_bedrock_agentcore_control.types.harness_id.HarnessId"
    """<p>The ID of the harness.</p>"""
    harness_name: "capo_bedrock_agentcore_control.types.harness_name.HarnessName"
    """<p>The name of the harness.</p>"""
    arn: "capo_bedrock_agentcore_control.types.harness_arn.HarnessArn"
    """<p>The ARN of the harness.</p>"""
    status: "capo_bedrock_agentcore_control.types.harness_status.HarnessStatus"
    """<p>The status of the harness.</p>"""
    harness_version: NotRequired[
        "capo_bedrock_agentcore_control.types.harness_version.HarnessVersion"
    ]
    """<p>The version of the harness. Incremented on every successful UpdateHarness.</p>"""
    execution_role_arn: "capo_bedrock_agentcore_control.types.role_arn.RoleArn"
    """<p>IAM role the harness assumes when running.</p>"""
    created_at: "capo_bedrock_agentcore_control.types.date_timestamp.DateTimestamp"
    """<p>The createdAt time of the harness.</p>"""
    updated_at: "capo_bedrock_agentcore_control.types.date_timestamp.DateTimestamp"
    """<p>The updatedAt time of the harness.</p>"""
    model: "capo_bedrock_agentcore_control.types.harness_model_configuration.HarnessModelConfiguration"
    """<p>The configuration of the default model used by the Harness.</p>"""
    system_prompt: (
        "capo_bedrock_agentcore_control.types.harness_system_prompt.HarnessSystemPrompt"
    )
    """<p>The system prompt of the harness.</p>"""
    tools: "capo_bedrock_agentcore_control.types.harness_tools.HarnessTools"
    """<p>The tools of the harness.</p>"""
    skills: "capo_bedrock_agentcore_control.types.harness_skills.HarnessSkills"
    """<p>The skills of the harness.</p>"""
    allowed_tools: (
        "capo_bedrock_agentcore_control.types.harness_allowed_tools.HarnessAllowedTools"
    )
    """<p>The allowed tools of the harness. All tools are allowed by default.</p>"""
    truncation: "capo_bedrock_agentcore_control.types.harness_truncation_configuration.HarnessTruncationConfiguration"
    """<p>Configuration for truncating model context.</p>"""
    environment: "capo_bedrock_agentcore_control.types.harness_environment_provider.HarnessEnvironmentProvider"
    """<p>The compute environment on which the Harness runs.</p>"""
    environment_artifact: NotRequired[
        "capo_bedrock_agentcore_control.types.harness_environment_artifact.HarnessEnvironmentArtifact"
    ]
    """<p>The environment artifact (e.g., container) in which the Harness operates.</p>"""
    environment_variables: NotRequired[
        "capo_bedrock_agentcore_control.types.environment_variables_map.EnvironmentVariablesMap"
    ]
    """<p>Environment variables exposed in the environment in which the harness operates.</p>"""
    authorizer_configuration: NotRequired[
        "capo_bedrock_agentcore_control.types.authorizer_configuration.AuthorizerConfiguration"
    ]
    memory: NotRequired[
        "capo_bedrock_agentcore_control.types.harness_memory_configuration.HarnessMemoryConfiguration"
    ]
    """<p>AgentCore Memory instance configuration for short and long term memory.</p>"""
    hooks: NotRequired[
        "capo_bedrock_agentcore_control.types.harness_hooks.HarnessHooks"
    ]
    """<p>The lifecycle hooks configured for the harness.</p>"""
    max_iterations: NotRequired["int"]
    """<p>The maximum number of iterations in the agent loop allowed before exiting per invocation.</p>"""
    max_tokens: NotRequired["int"]
    """<p>The maximum total number of output tokens the agent can generate across all model calls within a single invocation.</p>"""
    timeout_seconds: NotRequired["int"]
    """<p>The maximum duration per invocation.</p>"""
    failure_reason: NotRequired["str"]
    """<p>Reason why create or update operations fail.</p>"""

allowed_tools instance-attribute

allowed_tools: HarnessAllowedTools

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

arn instance-attribute

The ARN of the harness.

authorizer_configuration instance-attribute

authorizer_configuration: NotRequired[AuthorizerConfiguration]

created_at instance-attribute

created_at: DateTimestamp

The createdAt time of the harness.

environment instance-attribute

The compute environment on which the Harness runs.

environment_artifact instance-attribute

environment_artifact: NotRequired[HarnessEnvironmentArtifact]

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

environment_variables instance-attribute

environment_variables: NotRequired[EnvironmentVariablesMap]

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

execution_role_arn instance-attribute

execution_role_arn: RoleArn

IAM role the harness assumes when running.

failure_reason instance-attribute

failure_reason: NotRequired[str]

Reason why create or update operations fail.

harness_id instance-attribute

harness_id: HarnessId

The ID of the harness.

harness_name instance-attribute

harness_name: HarnessName

The name of the harness.

harness_version instance-attribute

harness_version: NotRequired[HarnessVersion]

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

hooks instance-attribute

hooks: NotRequired[HarnessHooks]

The lifecycle hooks configured for the harness.

max_iterations instance-attribute

max_iterations: NotRequired[int]

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

max_tokens instance-attribute

max_tokens: NotRequired[int]

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

memory instance-attribute

memory: NotRequired[HarnessMemoryConfiguration]

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: HarnessSkills

The skills of the harness.

status instance-attribute

status: HarnessStatus

The status of the harness.

system_prompt instance-attribute

system_prompt: HarnessSystemPrompt

The system prompt of the harness.

timeout_seconds instance-attribute

timeout_seconds: NotRequired[int]

The maximum duration per invocation.

tools instance-attribute

tools: HarnessTools

The tools of the harness.

truncation instance-attribute

Configuration for truncating model context.

updated_at instance-attribute

updated_at: DateTimestamp

The updatedAt time of the harness.