update_harness¶
Operation¶
async
¶
update_harness(input: UpdateHarnessInput, plugins: list[Plugin] | None = None) -> UpdateHarnessOutput
Operation to update a harness.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
input
|
UpdateHarnessInput
|
An instance of |
required |
plugins
|
list[Plugin] | None
|
A list of callables that modify the configuration dynamically. Changes made by these plugins only apply for the duration of the operation execution and will not affect any other operation invocations. |
None
|
Returns:
| Type | Description |
|---|---|
UpdateHarnessOutput
|
An instance of |
Input¶
dataclass
¶
Dataclass for UpdateHarnessInput structure.
Attributes¶
class-attribute
instance-attribute
¶
allowed_tools: list[str] | None = None
The tools that the agent is allowed to use. If specified, this replaces all existing allowed tools. If not specified, the existing value is retained.
class-attribute
instance-attribute
¶
authorizer_configuration: UpdatedAuthorizerConfiguration | None = None
Wrapper for updating an optional AuthorizerConfiguration field with PATCH semantics. When present in an update request, the authorizer configuration is replaced with optionalValue. When absent, the authorizer configuration is left unchanged. To unset, include the wrapper with optionalValue not specified.
class-attribute
instance-attribute
¶
client_token: str | None = None
A unique, case-sensitive identifier to ensure idempotency of the request.
class-attribute
instance-attribute
¶
environment: HarnessEnvironmentProviderRequest | None = None
The compute environment configuration for the harness. If not specified, the existing value is retained.
class-attribute
instance-attribute
¶
environment_artifact: UpdatedHarnessEnvironmentArtifact | None = None
The environment artifact for the harness. Use the optionalValue wrapper to set a new value, or set it to null to clear the existing configuration.
class-attribute
instance-attribute
¶
environment_variables: dict[str, str] | None = field(repr=False, default=None)
Environment variables to set in the harness runtime environment. If specified, this replaces all existing environment variables. If not specified, the existing value is retained.
class-attribute
instance-attribute
¶
execution_role_arn: str | None = None
The ARN of the IAM role that the harness assumes when running. If not specified, the existing value is retained.
class-attribute
instance-attribute
¶
harness_id: str | None = None
The ID of the harness to update.
class-attribute
instance-attribute
¶
max_iterations: int | None = None
The maximum number of iterations the agent loop can execute per invocation. If not specified, the existing value is retained.
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. If not specified, the existing value is retained.
class-attribute
instance-attribute
¶
memory: UpdatedHarnessMemoryConfiguration | None = None
The AgentCore Memory configuration. Use the optionalValue wrapper to set a new value, or set it to null to clear the existing configuration.
class-attribute
instance-attribute
¶
model: HarnessModelConfiguration | None = None
The model configuration for the harness. If not specified, the existing value is retained.
class-attribute
instance-attribute
¶
skills: list[HarnessSkill] | None = None
The skills available to the agent. If specified, this replaces all existing skills. If not specified, the existing value is retained.
class-attribute
instance-attribute
¶
system_prompt: list[HarnessSystemContentBlock] | None = None
The system prompt that defines the agent's behavior. If not specified, the existing value is retained.
class-attribute
instance-attribute
¶
timeout_seconds: int | None = None
The maximum duration in seconds for the agent loop execution per invocation. If not specified, the existing value is retained.
class-attribute
instance-attribute
¶
tools: list[HarnessTool] | None = None
The tools available to the agent. If specified, this replaces all existing tools. If not specified, the existing value is retained.
class-attribute
instance-attribute
¶
truncation: HarnessTruncationConfiguration | None = None
The truncation configuration for managing conversation context. If not specified, the existing value is retained.