Interface UpdateHarnessRequest.Builder

All Superinterfaces:

AwsRequest.Builder, BedrockAgentCoreControlRequest.Builder, Buildable, CopyableBuilder<UpdateHarnessRequest.Builder,UpdateHarnessRequest>, SdkBuilder<UpdateHarnessRequest.Builder,UpdateHarnessRequest>, SdkPojo, SdkRequest.Builder

Enclosing class:

UpdateHarnessRequest

@Mutable
@NotThreadSafe
public static interface UpdateHarnessRequest.Builder
extends BedrockAgentCoreControlRequest.Builder, SdkPojo, CopyableBuilder<UpdateHarnessRequest.Builder,UpdateHarnessRequest>

Method Summary

Modifier and Type	Method	Description
UpdateHarnessRequest.Builder	allowedTools(String... allowedTools)	The tools that the agent is allowed to use.
UpdateHarnessRequest.Builder	allowedTools(Collection<String> allowedTools)	The tools that the agent is allowed to use.
default UpdateHarnessRequest.Builder	authorizerConfiguration(Consumer<UpdatedAuthorizerConfiguration.Builder> authorizerConfiguration)	Sets the value of the AuthorizerConfiguration property for this object.
UpdateHarnessRequest.Builder	authorizerConfiguration(UpdatedAuthorizerConfiguration authorizerConfiguration)	Sets the value of the AuthorizerConfiguration property for this object.
UpdateHarnessRequest.Builder	clientToken(String clientToken)	A unique, case-sensitive identifier to ensure idempotency of the request.
default UpdateHarnessRequest.Builder	environment(Consumer<HarnessEnvironmentProviderRequest.Builder> environment)	The compute environment configuration for the harness.
UpdateHarnessRequest.Builder	environment(HarnessEnvironmentProviderRequest environment)	The compute environment configuration for the harness.
default UpdateHarnessRequest.Builder	environmentArtifact(Consumer<UpdatedHarnessEnvironmentArtifact.Builder> environmentArtifact)	The environment artifact for the harness.
UpdateHarnessRequest.Builder	environmentArtifact(UpdatedHarnessEnvironmentArtifact environmentArtifact)	The environment artifact for the harness.
UpdateHarnessRequest.Builder	environmentVariables(Map<String,String> environmentVariables)	Environment variables to set in the harness runtime environment.
UpdateHarnessRequest.Builder	executionRoleArn(String executionRoleArn)	The ARN of the IAM role that the harness assumes when running.
UpdateHarnessRequest.Builder	harnessId(String harnessId)	The ID of the harness to update.
UpdateHarnessRequest.Builder	maxIterations(Integer maxIterations)	The maximum number of iterations the agent loop can execute per invocation.
UpdateHarnessRequest.Builder	maxTokens(Integer maxTokens)	The maximum number of tokens the agent can generate per iteration.
default UpdateHarnessRequest.Builder	memory(Consumer<UpdatedHarnessMemoryConfiguration.Builder> memory)	The AgentCore Memory configuration.
UpdateHarnessRequest.Builder	memory(UpdatedHarnessMemoryConfiguration memory)	The AgentCore Memory configuration.
default UpdateHarnessRequest.Builder	model(Consumer<HarnessModelConfiguration.Builder> model)	The model configuration for the harness.
UpdateHarnessRequest.Builder	model(HarnessModelConfiguration model)	The model configuration for the harness.
UpdateHarnessRequest.Builder	overrideConfiguration(Consumer<AwsRequestOverrideConfiguration.Builder> builderConsumer)	Add an optional request override configuration.
UpdateHarnessRequest.Builder	overrideConfiguration(AwsRequestOverrideConfiguration overrideConfiguration)	Add an optional request override configuration.
UpdateHarnessRequest.Builder	skills(Collection<HarnessSkill> skills)	The skills available to the agent.
UpdateHarnessRequest.Builder	skills(Consumer<HarnessSkill.Builder>... skills)	The skills available to the agent.
UpdateHarnessRequest.Builder	skills(HarnessSkill... skills)	The skills available to the agent.
UpdateHarnessRequest.Builder	systemPrompt(Collection<HarnessSystemContentBlock> systemPrompt)	The system prompt that defines the agent's behavior.
UpdateHarnessRequest.Builder	systemPrompt(Consumer<HarnessSystemContentBlock.Builder>... systemPrompt)	The system prompt that defines the agent's behavior.
UpdateHarnessRequest.Builder	systemPrompt(HarnessSystemContentBlock... systemPrompt)	The system prompt that defines the agent's behavior.
UpdateHarnessRequest.Builder	timeoutSeconds(Integer timeoutSeconds)	The maximum duration in seconds for the agent loop execution per invocation.
UpdateHarnessRequest.Builder	tools(Collection<HarnessTool> tools)	The tools available to the agent.
UpdateHarnessRequest.Builder	tools(Consumer<HarnessTool.Builder>... tools)	The tools available to the agent.
UpdateHarnessRequest.Builder	tools(HarnessTool... tools)	The tools available to the agent.
default UpdateHarnessRequest.Builder	truncation(Consumer<HarnessTruncationConfiguration.Builder> truncation)	The truncation configuration for managing conversation context.
UpdateHarnessRequest.Builder	truncation(HarnessTruncationConfiguration truncation)	The truncation configuration for managing conversation context.

Methods inherited from interface software.amazon.awssdk.awscore.AwsRequest.Builder

overrideConfiguration

Methods inherited from interface software.amazon.awssdk.services.bedrockagentcorecontrol.model.BedrockAgentCoreControlRequest.Builder

build

Methods inherited from interface software.amazon.awssdk.utils.builder.CopyableBuilder

copy

Methods inherited from interface software.amazon.awssdk.utils.builder.SdkBuilder

applyMutation, build

Methods inherited from interface software.amazon.awssdk.core.SdkPojo

equalsBySdkFields, sdkFieldNameToField, sdkFields

Method Details

harnessId

UpdateHarnessRequest.Builder harnessId(String harnessId)

The ID of the harness to update.

Parameters:

harnessId - The ID of the harness to update.

Returns:

Returns a reference to this object so that method calls can be chained together.

clientToken

UpdateHarnessRequest.Builder clientToken(String clientToken)

A unique, case-sensitive identifier to ensure idempotency of the request.

Parameters:

clientToken - A unique, case-sensitive identifier to ensure idempotency of the request.

Returns:

Returns a reference to this object so that method calls can be chained together.

executionRoleArn

UpdateHarnessRequest.Builder executionRoleArn(String executionRoleArn)

The ARN of the IAM role that the harness assumes when running. If not specified, the existing value is retained.

Parameters:

executionRoleArn - The ARN of the IAM role that the harness assumes when running. If not specified, the existing value is retained.

Returns:

Returns a reference to this object so that method calls can be chained together.

environment

UpdateHarnessRequest.Builder environment(HarnessEnvironmentProviderRequest environment)

The compute environment configuration for the harness. If not specified, the existing value is retained.

Parameters:

environment - The compute environment configuration for the harness. If not specified, the existing value is retained.

Returns:

Returns a reference to this object so that method calls can be chained together.

environment

default UpdateHarnessRequest.Builder environment(Consumer<HarnessEnvironmentProviderRequest.Builder> environment)

The compute environment configuration for the harness. If not specified, the existing value is retained.

This is a convenience method that creates an instance of the HarnessEnvironmentProviderRequest.Builder avoiding the need to create one manually via HarnessEnvironmentProviderRequest.builder().

When the Consumer completes, SdkBuilder.build() is called immediately and its result is passed to environment(HarnessEnvironmentProviderRequest).

Parameters:

environment - a consumer that will call methods on HarnessEnvironmentProviderRequest.Builder

Returns:

Returns a reference to this object so that method calls can be chained together.

See Also:

• environment(HarnessEnvironmentProviderRequest)

environmentArtifact

UpdateHarnessRequest.Builder environmentArtifact(UpdatedHarnessEnvironmentArtifact environmentArtifact)

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.

Parameters:

environmentArtifact - 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.

Returns:

Returns a reference to this object so that method calls can be chained together.

environmentArtifact

default UpdateHarnessRequest.Builder environmentArtifact(Consumer<UpdatedHarnessEnvironmentArtifact.Builder> environmentArtifact)

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.

This is a convenience method that creates an instance of the UpdatedHarnessEnvironmentArtifact.Builder avoiding the need to create one manually via UpdatedHarnessEnvironmentArtifact.builder().

When the Consumer completes, SdkBuilder.build() is called immediately and its result is passed to environmentArtifact(UpdatedHarnessEnvironmentArtifact).

Parameters:

environmentArtifact - a consumer that will call methods on UpdatedHarnessEnvironmentArtifact.Builder

Returns:

Returns a reference to this object so that method calls can be chained together.

See Also:

• environmentArtifact(UpdatedHarnessEnvironmentArtifact)

environmentVariables

UpdateHarnessRequest.Builder environmentVariables(Map<String,String> environmentVariables)

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.

Parameters:

environmentVariables - 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.

Returns:

Returns a reference to this object so that method calls can be chained together.

authorizerConfiguration

UpdateHarnessRequest.Builder authorizerConfiguration(UpdatedAuthorizerConfiguration authorizerConfiguration)

Sets the value of the AuthorizerConfiguration property for this object.

Parameters:

authorizerConfiguration - The new value for the AuthorizerConfiguration property for this object.

Returns:

Returns a reference to this object so that method calls can be chained together.

authorizerConfiguration

default UpdateHarnessRequest.Builder authorizerConfiguration(Consumer<UpdatedAuthorizerConfiguration.Builder> authorizerConfiguration)

Sets the value of the AuthorizerConfiguration property for this object. This is a convenience method that creates an instance of the UpdatedAuthorizerConfiguration.Builder avoiding the need to create one manually via UpdatedAuthorizerConfiguration.builder().

When the Consumer completes, SdkBuilder.build() is called immediately and its result is passed to authorizerConfiguration(UpdatedAuthorizerConfiguration).

Parameters:

authorizerConfiguration - a consumer that will call methods on UpdatedAuthorizerConfiguration.Builder

Returns:

Returns a reference to this object so that method calls can be chained together.

See Also:

• authorizerConfiguration(UpdatedAuthorizerConfiguration)

model

UpdateHarnessRequest.Builder model(HarnessModelConfiguration model)

The model configuration for the harness. If not specified, the existing value is retained.

Parameters:

model - The model configuration for the harness. If not specified, the existing value is retained.

Returns:

Returns a reference to this object so that method calls can be chained together.

model

default UpdateHarnessRequest.Builder model(Consumer<HarnessModelConfiguration.Builder> model)

The model configuration for the harness. If not specified, the existing value is retained.

This is a convenience method that creates an instance of the HarnessModelConfiguration.Builder avoiding the need to create one manually via HarnessModelConfiguration.builder().

When the Consumer completes, SdkBuilder.build() is called immediately and its result is passed to model(HarnessModelConfiguration).

Parameters:

model - a consumer that will call methods on HarnessModelConfiguration.Builder

Returns:

Returns a reference to this object so that method calls can be chained together.

See Also:

• model(HarnessModelConfiguration)

systemPrompt

UpdateHarnessRequest.Builder systemPrompt(Collection<HarnessSystemContentBlock> systemPrompt)

The system prompt that defines the agent's behavior. If not specified, the existing value is retained.

Parameters:

systemPrompt - The system prompt that defines the agent's behavior. If not specified, the existing value is retained.

Returns:

Returns a reference to this object so that method calls can be chained together.

systemPrompt

UpdateHarnessRequest.Builder systemPrompt(HarnessSystemContentBlock... systemPrompt)

The system prompt that defines the agent's behavior. If not specified, the existing value is retained.

Parameters:

systemPrompt - The system prompt that defines the agent's behavior. If not specified, the existing value is retained.

Returns:

Returns a reference to this object so that method calls can be chained together.

systemPrompt

UpdateHarnessRequest.Builder systemPrompt(Consumer<HarnessSystemContentBlock.Builder>... systemPrompt)

The system prompt that defines the agent's behavior. If not specified, the existing value is retained.

This is a convenience method that creates an instance of the HarnessSystemContentBlock.Builder avoiding the need to create one manually via HarnessSystemContentBlock.builder().

When the Consumer completes, SdkBuilder.build() is called immediately and its result is passed to systemPrompt(List<HarnessSystemContentBlock>).

Parameters:

systemPrompt - a consumer that will call methods on HarnessSystemContentBlock.Builder

Returns:

Returns a reference to this object so that method calls can be chained together.

See Also:

• systemPrompt(java.util.Collection<HarnessSystemContentBlock>)

tools

UpdateHarnessRequest.Builder tools(Collection<HarnessTool> tools)

The tools available to the agent. If specified, this replaces all existing tools. If not specified, the existing value is retained.

Parameters:

tools - The tools available to the agent. If specified, this replaces all existing tools. If not specified, the existing value is retained.

Returns:

Returns a reference to this object so that method calls can be chained together.

tools

UpdateHarnessRequest.Builder tools(HarnessTool... tools)

The tools available to the agent. If specified, this replaces all existing tools. If not specified, the existing value is retained.

Parameters:

tools - The tools available to the agent. If specified, this replaces all existing tools. If not specified, the existing value is retained.

Returns:

Returns a reference to this object so that method calls can be chained together.

tools

UpdateHarnessRequest.Builder tools(Consumer<HarnessTool.Builder>... tools)

The tools available to the agent. If specified, this replaces all existing tools. If not specified, the existing value is retained.

This is a convenience method that creates an instance of the HarnessTool.Builder avoiding the need to create one manually via HarnessTool.builder().

When the Consumer completes, SdkBuilder.build() is called immediately and its result is passed to tools(List<HarnessTool>).

Parameters:

tools - a consumer that will call methods on HarnessTool.Builder

Returns:

Returns a reference to this object so that method calls can be chained together.

See Also:

• tools(java.util.Collection<HarnessTool>)

skills

UpdateHarnessRequest.Builder skills(Collection<HarnessSkill> skills)

The skills available to the agent. If specified, this replaces all existing skills. If not specified, the existing value is retained.

Parameters:

skills - The skills available to the agent. If specified, this replaces all existing skills. If not specified, the existing value is retained.

Returns:

Returns a reference to this object so that method calls can be chained together.

skills

UpdateHarnessRequest.Builder skills(HarnessSkill... skills)

The skills available to the agent. If specified, this replaces all existing skills. If not specified, the existing value is retained.

Parameters:

skills - The skills available to the agent. If specified, this replaces all existing skills. If not specified, the existing value is retained.

Returns:

Returns a reference to this object so that method calls can be chained together.

skills

UpdateHarnessRequest.Builder skills(Consumer<HarnessSkill.Builder>... skills)

The skills available to the agent. If specified, this replaces all existing skills. If not specified, the existing value is retained.

This is a convenience method that creates an instance of the HarnessSkill.Builder avoiding the need to create one manually via HarnessSkill.builder().

When the Consumer completes, SdkBuilder.build() is called immediately and its result is passed to skills(List<HarnessSkill>).

Parameters:

skills - a consumer that will call methods on HarnessSkill.Builder

Returns:

Returns a reference to this object so that method calls can be chained together.

See Also:

• skills(java.util.Collection<HarnessSkill>)

allowedTools

UpdateHarnessRequest.Builder allowedTools(Collection<String> allowedTools)

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.

Parameters:

allowedTools - 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.

Returns:

Returns a reference to this object so that method calls can be chained together.

allowedTools

UpdateHarnessRequest.Builder allowedTools(String... allowedTools)

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.

Parameters:

allowedTools - 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.

Returns:

Returns a reference to this object so that method calls can be chained together.

memory

UpdateHarnessRequest.Builder memory(UpdatedHarnessMemoryConfiguration memory)

The AgentCore Memory configuration. Use the optionalValue wrapper to set a new value, or set it to null to clear the existing configuration.

Parameters:

memory - The AgentCore Memory configuration. Use the optionalValue wrapper to set a new value, or set it to null to clear the existing configuration.

Returns:

Returns a reference to this object so that method calls can be chained together.

memory

default UpdateHarnessRequest.Builder memory(Consumer<UpdatedHarnessMemoryConfiguration.Builder> memory)

The AgentCore Memory configuration. Use the optionalValue wrapper to set a new value, or set it to null to clear the existing configuration.

This is a convenience method that creates an instance of the UpdatedHarnessMemoryConfiguration.Builder avoiding the need to create one manually via UpdatedHarnessMemoryConfiguration.builder().

When the Consumer completes, SdkBuilder.build() is called immediately and its result is passed to memory(UpdatedHarnessMemoryConfiguration).

Parameters:

memory - a consumer that will call methods on UpdatedHarnessMemoryConfiguration.Builder

Returns:

Returns a reference to this object so that method calls can be chained together.

See Also:

• memory(UpdatedHarnessMemoryConfiguration)

truncation

UpdateHarnessRequest.Builder truncation(HarnessTruncationConfiguration truncation)

The truncation configuration for managing conversation context. If not specified, the existing value is retained.

Parameters:

truncation - The truncation configuration for managing conversation context. If not specified, the existing value is retained.

Returns:

Returns a reference to this object so that method calls can be chained together.

truncation

default UpdateHarnessRequest.Builder truncation(Consumer<HarnessTruncationConfiguration.Builder> truncation)

The truncation configuration for managing conversation context. If not specified, the existing value is retained.

This is a convenience method that creates an instance of the HarnessTruncationConfiguration.Builder avoiding the need to create one manually via HarnessTruncationConfiguration.builder().

When the Consumer completes, SdkBuilder.build() is called immediately and its result is passed to truncation(HarnessTruncationConfiguration).

Parameters:

truncation - a consumer that will call methods on HarnessTruncationConfiguration.Builder

Returns:

Returns a reference to this object so that method calls can be chained together.

See Also:

• truncation(HarnessTruncationConfiguration)

maxIterations

UpdateHarnessRequest.Builder maxIterations(Integer maxIterations)

The maximum number of iterations the agent loop can execute per invocation. If not specified, the existing value is retained.

Parameters:

maxIterations - The maximum number of iterations the agent loop can execute per invocation. If not specified, the existing value is retained.

Returns:

Returns a reference to this object so that method calls can be chained together.

maxTokens

UpdateHarnessRequest.Builder maxTokens(Integer maxTokens)

The maximum number of tokens the agent can generate per iteration. If not specified, the existing value is retained.

Parameters:

maxTokens - The maximum number of tokens the agent can generate per iteration. If not specified, the existing value is retained.

Returns:

Returns a reference to this object so that method calls can be chained together.

timeoutSeconds

UpdateHarnessRequest.Builder timeoutSeconds(Integer timeoutSeconds)

The maximum duration in seconds for the agent loop execution per invocation. If not specified, the existing value is retained.

Parameters:

timeoutSeconds - The maximum duration in seconds for the agent loop execution per invocation. If not specified, the existing value is retained.

Returns:

Returns a reference to this object so that method calls can be chained together.

overrideConfiguration

UpdateHarnessRequest.Builder overrideConfiguration(AwsRequestOverrideConfiguration overrideConfiguration)

Description copied from interface: AwsRequest.Builder

Add an optional request override configuration.

Specified by:

overrideConfiguration in interface AwsRequest.Builder

Parameters:

overrideConfiguration - The override configuration.

Returns:

This object for method chaining.

overrideConfiguration

UpdateHarnessRequest.Builder overrideConfiguration(Consumer<AwsRequestOverrideConfiguration.Builder> builderConsumer)

Description copied from interface: AwsRequest.Builder

Add an optional request override configuration.

Specified by:

overrideConfiguration in interface AwsRequest.Builder

Parameters:

builderConsumer - A Consumer to which an empty AwsRequestOverrideConfiguration.Builder will be given.

Returns:

This object for method chaining.