Interface CreateHarnessRequest.Builder

All Superinterfaces:

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

Enclosing class:

CreateHarnessRequest

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

Method Summary

Modifier and Type	Method	Description
CreateHarnessRequest.Builder	allowedTools(String... allowedTools)	The tools that the agent is allowed to use.
CreateHarnessRequest.Builder	allowedTools(Collection<String> allowedTools)	The tools that the agent is allowed to use.
default CreateHarnessRequest.Builder	authorizerConfiguration(Consumer<AuthorizerConfiguration.Builder> authorizerConfiguration)	Sets the value of the AuthorizerConfiguration property for this object.
CreateHarnessRequest.Builder	authorizerConfiguration(AuthorizerConfiguration authorizerConfiguration)	Sets the value of the AuthorizerConfiguration property for this object.
CreateHarnessRequest.Builder	clientToken(String clientToken)	A unique, case-sensitive identifier to ensure idempotency of the request.
default CreateHarnessRequest.Builder	environment(Consumer<HarnessEnvironmentProviderRequest.Builder> environment)	The compute environment configuration for the harness, including network and lifecycle settings.
CreateHarnessRequest.Builder	environment(HarnessEnvironmentProviderRequest environment)	The compute environment configuration for the harness, including network and lifecycle settings.
default CreateHarnessRequest.Builder	environmentArtifact(Consumer<HarnessEnvironmentArtifact.Builder> environmentArtifact)	The environment artifact for the harness, such as a custom container image containing additional dependencies.
CreateHarnessRequest.Builder	environmentArtifact(HarnessEnvironmentArtifact environmentArtifact)	The environment artifact for the harness, such as a custom container image containing additional dependencies.
CreateHarnessRequest.Builder	environmentVariables(Map<String,String> environmentVariables)	Environment variables to set in the harness runtime environment.
CreateHarnessRequest.Builder	executionRoleArn(String executionRoleArn)	The ARN of the IAM role that the harness assumes when running.
CreateHarnessRequest.Builder	harnessName(String harnessName)	The name of the harness.
CreateHarnessRequest.Builder	maxIterations(Integer maxIterations)	The maximum number of iterations the agent loop can execute per invocation.
CreateHarnessRequest.Builder	maxTokens(Integer maxTokens)	The maximum total number of output tokens the agent can generate across all model calls within a single invocation.
default CreateHarnessRequest.Builder	memory(Consumer<HarnessMemoryConfiguration.Builder> memory)	The AgentCore Memory configuration for persisting conversation context across sessions.
CreateHarnessRequest.Builder	memory(HarnessMemoryConfiguration memory)	The AgentCore Memory configuration for persisting conversation context across sessions.
default CreateHarnessRequest.Builder	model(Consumer<HarnessModelConfiguration.Builder> model)	The model configuration for the harness.
CreateHarnessRequest.Builder	model(HarnessModelConfiguration model)	The model configuration for the harness.
CreateHarnessRequest.Builder	overrideConfiguration(Consumer<AwsRequestOverrideConfiguration.Builder> builderConsumer)	Add an optional request override configuration.
CreateHarnessRequest.Builder	overrideConfiguration(AwsRequestOverrideConfiguration overrideConfiguration)	Add an optional request override configuration.
CreateHarnessRequest.Builder	skills(Collection<HarnessSkill> skills)	The skills available to the agent.
CreateHarnessRequest.Builder	skills(Consumer<HarnessSkill.Builder>... skills)	The skills available to the agent.
CreateHarnessRequest.Builder	skills(HarnessSkill... skills)	The skills available to the agent.
CreateHarnessRequest.Builder	systemPrompt(Collection<HarnessSystemContentBlock> systemPrompt)	The system prompt that defines the agent's behavior and instructions.
CreateHarnessRequest.Builder	systemPrompt(Consumer<HarnessSystemContentBlock.Builder>... systemPrompt)	The system prompt that defines the agent's behavior and instructions.
CreateHarnessRequest.Builder	systemPrompt(HarnessSystemContentBlock... systemPrompt)	The system prompt that defines the agent's behavior and instructions.
CreateHarnessRequest.Builder	tags(Map<String,String> tags)	Tags to apply to the harness resource.
CreateHarnessRequest.Builder	timeoutSeconds(Integer timeoutSeconds)	The maximum duration in seconds for the agent loop execution per invocation.
CreateHarnessRequest.Builder	tools(Collection<HarnessTool> tools)	The tools available to the agent, such as remote MCP servers, AgentCore Gateway, AgentCore Browser, Code Interpreter, or inline functions.
CreateHarnessRequest.Builder	tools(Consumer<HarnessTool.Builder>... tools)	The tools available to the agent, such as remote MCP servers, AgentCore Gateway, AgentCore Browser, Code Interpreter, or inline functions.
CreateHarnessRequest.Builder	tools(HarnessTool... tools)	The tools available to the agent, such as remote MCP servers, AgentCore Gateway, AgentCore Browser, Code Interpreter, or inline functions.
default CreateHarnessRequest.Builder	truncation(Consumer<HarnessTruncationConfiguration.Builder> truncation)	The truncation configuration for managing conversation context when it exceeds model limits.
CreateHarnessRequest.Builder	truncation(HarnessTruncationConfiguration truncation)	The truncation configuration for managing conversation context when it exceeds model limits.

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

harnessName

CreateHarnessRequest.Builder harnessName(String harnessName)

The name of the harness. Must start with a letter and contain only alphanumeric characters and underscores.

Parameters:

harnessName - The name of the harness. Must start with a letter and contain only alphanumeric characters and underscores.

Returns:

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

clientToken

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

CreateHarnessRequest.Builder executionRoleArn(String executionRoleArn)

The ARN of the IAM role that the harness assumes when running. This role must have permissions for the services the agent needs to access, such as Amazon Bedrock for model invocation.

Parameters:

executionRoleArn - The ARN of the IAM role that the harness assumes when running. This role must have permissions for the services the agent needs to access, such as Amazon Bedrock for model invocation.

Returns:

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

environment

CreateHarnessRequest.Builder environment(HarnessEnvironmentProviderRequest environment)

The compute environment configuration for the harness, including network and lifecycle settings.

Parameters:

environment - The compute environment configuration for the harness, including network and lifecycle settings.

Returns:

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

environment

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

The compute environment configuration for the harness, including network and lifecycle settings.

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

CreateHarnessRequest.Builder environmentArtifact(HarnessEnvironmentArtifact environmentArtifact)

The environment artifact for the harness, such as a custom container image containing additional dependencies.

Parameters:

environmentArtifact - The environment artifact for the harness, such as a custom container image containing additional dependencies.

Returns:

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

environmentArtifact

default CreateHarnessRequest.Builder environmentArtifact(Consumer<HarnessEnvironmentArtifact.Builder> environmentArtifact)

The environment artifact for the harness, such as a custom container image containing additional dependencies.

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

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

Parameters:

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

Returns:

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

See Also:

• environmentArtifact(HarnessEnvironmentArtifact)

environmentVariables

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

Environment variables to set in the harness runtime environment.

Parameters:

environmentVariables - Environment variables to set in the harness runtime environment.

Returns:

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

authorizerConfiguration

CreateHarnessRequest.Builder authorizerConfiguration(AuthorizerConfiguration 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 CreateHarnessRequest.Builder authorizerConfiguration(Consumer<AuthorizerConfiguration.Builder> authorizerConfiguration)

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

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

Parameters:

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

Returns:

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

See Also:

• authorizerConfiguration(AuthorizerConfiguration)

model

CreateHarnessRequest.Builder model(HarnessModelConfiguration model)

The model configuration for the harness. Supports Amazon Bedrock, OpenAI, and Google Gemini model providers.

Parameters:

model - The model configuration for the harness. Supports Amazon Bedrock, OpenAI, and Google Gemini model providers.

Returns:

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

model

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

The model configuration for the harness. Supports Amazon Bedrock, OpenAI, and Google Gemini model providers.

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

CreateHarnessRequest.Builder systemPrompt(Collection<HarnessSystemContentBlock> systemPrompt)

The system prompt that defines the agent's behavior and instructions.

Parameters:

systemPrompt - The system prompt that defines the agent's behavior and instructions.

Returns:

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

systemPrompt

CreateHarnessRequest.Builder systemPrompt(HarnessSystemContentBlock... systemPrompt)

The system prompt that defines the agent's behavior and instructions.

Parameters:

systemPrompt - The system prompt that defines the agent's behavior and instructions.

Returns:

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

systemPrompt

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

The system prompt that defines the agent's behavior and instructions.

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

CreateHarnessRequest.Builder tools(Collection<HarnessTool> tools)

The tools available to the agent, such as remote MCP servers, AgentCore Gateway, AgentCore Browser, Code Interpreter, or inline functions.

Parameters:

tools - The tools available to the agent, such as remote MCP servers, AgentCore Gateway, AgentCore Browser, Code Interpreter, or inline functions.

Returns:

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

tools

CreateHarnessRequest.Builder tools(HarnessTool... tools)

The tools available to the agent, such as remote MCP servers, AgentCore Gateway, AgentCore Browser, Code Interpreter, or inline functions.

Parameters:

tools - The tools available to the agent, such as remote MCP servers, AgentCore Gateway, AgentCore Browser, Code Interpreter, or inline functions.

Returns:

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

tools

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

The tools available to the agent, such as remote MCP servers, AgentCore Gateway, AgentCore Browser, Code Interpreter, or inline functions.

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

CreateHarnessRequest.Builder skills(Collection<HarnessSkill> skills)

The skills available to the agent. Skills are bundles of files that the agent can pull into its context on demand.

Parameters:

skills - The skills available to the agent. Skills are bundles of files that the agent can pull into its context on demand.

Returns:

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

skills

CreateHarnessRequest.Builder skills(HarnessSkill... skills)

The skills available to the agent. Skills are bundles of files that the agent can pull into its context on demand.

Parameters:

skills - The skills available to the agent. Skills are bundles of files that the agent can pull into its context on demand.

Returns:

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

skills

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

The skills available to the agent. Skills are bundles of files that the agent can pull into its context on demand.

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

CreateHarnessRequest.Builder allowedTools(Collection<String> allowedTools)

The tools that the agent is allowed to use. Supports glob patterns such as * for all tools, @builtin for all built-in tools, or @serverName/toolName for specific MCP server tools.

Parameters:

allowedTools - The tools that the agent is allowed to use. Supports glob patterns such as * for all tools, @builtin for all built-in tools, or @serverName/toolName for specific MCP server tools.

Returns:

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

allowedTools

CreateHarnessRequest.Builder allowedTools(String... allowedTools)

The tools that the agent is allowed to use. Supports glob patterns such as * for all tools, @builtin for all built-in tools, or @serverName/toolName for specific MCP server tools.

Parameters:

allowedTools - The tools that the agent is allowed to use. Supports glob patterns such as * for all tools, @builtin for all built-in tools, or @serverName/toolName for specific MCP server tools.

Returns:

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

memory

CreateHarnessRequest.Builder memory(HarnessMemoryConfiguration memory)

The AgentCore Memory configuration for persisting conversation context across sessions.

Parameters:

memory - The AgentCore Memory configuration for persisting conversation context across sessions.

Returns:

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

memory

default CreateHarnessRequest.Builder memory(Consumer<HarnessMemoryConfiguration.Builder> memory)

The AgentCore Memory configuration for persisting conversation context across sessions.

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

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

Parameters:

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

Returns:

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

See Also:

• memory(HarnessMemoryConfiguration)

truncation

CreateHarnessRequest.Builder truncation(HarnessTruncationConfiguration truncation)

The truncation configuration for managing conversation context when it exceeds model limits.

Parameters:

truncation - The truncation configuration for managing conversation context when it exceeds model limits.

Returns:

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

truncation

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

The truncation configuration for managing conversation context when it exceeds model limits.

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

CreateHarnessRequest.Builder maxIterations(Integer maxIterations)

The maximum number of iterations the agent loop can execute per invocation.

Parameters:

maxIterations - The maximum number of iterations the agent loop can execute per invocation.

Returns:

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

maxTokens

CreateHarnessRequest.Builder maxTokens(Integer maxTokens)

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

Parameters:

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

Returns:

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

timeoutSeconds

CreateHarnessRequest.Builder timeoutSeconds(Integer timeoutSeconds)

The maximum duration in seconds for the agent loop execution per invocation.

Parameters:

timeoutSeconds - The maximum duration in seconds for the agent loop execution per invocation.

Returns:

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

tags

CreateHarnessRequest.Builder tags(Map<String,String> tags)

Tags to apply to the harness resource.

Parameters:

tags - Tags to apply to the harness resource.

Returns:

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

overrideConfiguration

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

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