Update Harness
| bedrockagentcorecontrol_update_harness | R Documentation |
Operation to update a Harness¶
Description¶
Operation to update a Harness.
Usage¶
bedrockagentcorecontrol_update_harness(harnessId, clientToken,
executionRoleArn, environment, environmentArtifact,
environmentVariables, authorizerConfiguration, model, systemPrompt,
tools, skills, allowedTools, memory, truncation, maxIterations,
maxTokens, timeoutSeconds)
Arguments¶
harnessId |
[required] The ID of the harness to update. |
clientToken |
A unique, case-sensitive identifier to ensure idempotency of the request. |
executionRoleArn |
The ARN of the IAM role that the harness assumes when running. If not specified, the existing value is retained. |
environment |
The compute environment configuration for the harness. If not specified, the existing value is retained. |
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. |
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. |
authorizerConfiguration |
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. |
model |
The model configuration for the harness. If not specified, the existing value is retained. |
systemPrompt |
The system prompt that defines the agent's behavior. If not specified, the existing value is retained. |
tools |
The tools available to the agent. If specified, this replaces all existing tools. If not specified, the existing value is retained. |
skills |
The skills available to the agent. If specified, this replaces all existing skills. If not specified, the existing value is retained. |
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. |
memory |
The AgentCore Memory configuration. Use the optionalValue wrapper to set a new value, or set it to null to clear the existing configuration. |
truncation |
The truncation configuration for managing conversation context. If not specified, the existing value is retained. |
maxIterations |
The maximum number of iterations the agent loop can execute per invocation. If not specified, the existing value is retained. |
maxTokens |
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. |
timeoutSeconds |
The maximum duration in seconds for the agent loop execution per invocation. If not specified, the existing value is retained. |
Value¶
A list with the following syntax:
list(
harness = list(
harnessId = "string",
harnessName = "string",
arn = "string",
status = "CREATING"|"CREATE_FAILED"|"UPDATING"|"UPDATE_FAILED"|"READY"|"DELETING"|"DELETE_FAILED",
executionRoleArn = "string",
createdAt = as.POSIXct(
"2015-01-01"
),
updatedAt = as.POSIXct(
"2015-01-01"
),
model = list(
bedrockModelConfig = list(
modelId = "string",
maxTokens = 123,
temperature = 123.0,
topP = 123.0
),
openAiModelConfig = list(
modelId = "string",
apiKeyArn = "string",
maxTokens = 123,
temperature = 123.0,
topP = 123.0
),
geminiModelConfig = list(
modelId = "string",
apiKeyArn = "string",
maxTokens = 123,
temperature = 123.0,
topP = 123.0,
topK = 123
)
),
systemPrompt = list(
list(
text = "string"
)
),
tools = list(
list(
type = "remote_mcp"|"agentcore_browser"|"agentcore_gateway"|"inline_function"|"agentcore_code_interpreter",
name = "string",
config = list(
remoteMcp = list(
url = "string",
headers = list(
"string"
)
),
agentCoreBrowser = list(
browserArn = "string"
),
agentCoreGateway = list(
gatewayArn = "string",
outboundAuth = list(
awsIam = list(),
none = list(),
oauth = list(
providerArn = "string",
scopes = list(
"string"
),
customParameters = list(
"string"
),
grantType = "CLIENT_CREDENTIALS"|"AUTHORIZATION_CODE"|"TOKEN_EXCHANGE",
defaultReturnUrl = "string"
)
)
),
inlineFunction = list(
description = "string",
inputSchema = list()
),
agentCoreCodeInterpreter = list(
codeInterpreterArn = "string"
)
)
)
),
skills = list(
list(
path = "string"
)
),
allowedTools = list(
"string"
),
truncation = list(
strategy = "sliding_window"|"summarization"|"none",
config = list(
slidingWindow = list(
messagesCount = 123
),
summarization = list(
summaryRatio = 123.0,
preserveRecentMessages = 123,
summarizationSystemPrompt = "string"
)
)
),
environment = list(
agentCoreRuntimeEnvironment = list(
agentRuntimeArn = "string",
agentRuntimeName = "string",
agentRuntimeId = "string",
lifecycleConfiguration = list(
idleRuntimeSessionTimeout = 123,
maxLifetime = 123
),
networkConfiguration = list(
networkMode = "PUBLIC"|"VPC",
networkModeConfig = list(
securityGroups = list(
"string"
),
subnets = list(
"string"
),
requireServiceS3Endpoint = TRUE|FALSE
)
),
filesystemConfigurations = list(
list(
sessionStorage = list(
mountPath = "string"
),
s3FilesAccessPoint = list(
accessPointArn = "string",
mountPath = "string"
),
efsAccessPoint = list(
accessPointArn = "string",
mountPath = "string"
)
)
)
)
),
environmentArtifact = list(
containerConfiguration = list(
containerUri = "string"
)
),
environmentVariables = list(
"string"
),
authorizerConfiguration = list(
customJWTAuthorizer = list(
discoveryUrl = "string",
allowedAudience = list(
"string"
),
allowedClients = list(
"string"
),
allowedScopes = list(
"string"
),
customClaims = list(
list(
inboundTokenClaimName = "string",
inboundTokenClaimValueType = "STRING"|"STRING_ARRAY",
authorizingClaimMatchValue = list(
claimMatchValue = list(
matchValueString = "string",
matchValueStringList = list(
"string"
)
),
claimMatchOperator = "EQUALS"|"CONTAINS"|"CONTAINS_ANY"
)
)
),
privateEndpoint = list(
selfManagedLatticeResource = list(
resourceConfigurationIdentifier = "string"
),
managedVpcResource = list(
vpcIdentifier = "string",
subnetIds = list(
"string"
),
endpointIpAddressType = "IPV4"|"IPV6",
securityGroupIds = list(
"string"
),
tags = list(
"string"
),
routingDomain = "string"
)
),
privateEndpointOverrides = list(
list(
domain = "string",
privateEndpoint = list(
selfManagedLatticeResource = list(
resourceConfigurationIdentifier = "string"
),
managedVpcResource = list(
vpcIdentifier = "string",
subnetIds = list(
"string"
),
endpointIpAddressType = "IPV4"|"IPV6",
securityGroupIds = list(
"string"
),
tags = list(
"string"
),
routingDomain = "string"
)
)
)
)
)
),
memory = list(
agentCoreMemoryConfiguration = list(
arn = "string",
actorId = "string",
messagesCount = 123,
retrievalConfig = list(
list(
topK = 123,
relevanceScore = 123.0,
strategyId = "string"
)
)
)
),
maxIterations = 123,
maxTokens = 123,
timeoutSeconds = 123,
failureReason = "string"
)
)
Request syntax¶
svc$update_harness(
harnessId = "string",
clientToken = "string",
executionRoleArn = "string",
environment = list(
agentCoreRuntimeEnvironment = list(
lifecycleConfiguration = list(
idleRuntimeSessionTimeout = 123,
maxLifetime = 123
),
networkConfiguration = list(
networkMode = "PUBLIC"|"VPC",
networkModeConfig = list(
securityGroups = list(
"string"
),
subnets = list(
"string"
),
requireServiceS3Endpoint = TRUE|FALSE
)
),
filesystemConfigurations = list(
list(
sessionStorage = list(
mountPath = "string"
),
s3FilesAccessPoint = list(
accessPointArn = "string",
mountPath = "string"
),
efsAccessPoint = list(
accessPointArn = "string",
mountPath = "string"
)
)
)
)
),
environmentArtifact = list(
optionalValue = list(
containerConfiguration = list(
containerUri = "string"
)
)
),
environmentVariables = list(
"string"
),
authorizerConfiguration = list(
optionalValue = list(
customJWTAuthorizer = list(
discoveryUrl = "string",
allowedAudience = list(
"string"
),
allowedClients = list(
"string"
),
allowedScopes = list(
"string"
),
customClaims = list(
list(
inboundTokenClaimName = "string",
inboundTokenClaimValueType = "STRING"|"STRING_ARRAY",
authorizingClaimMatchValue = list(
claimMatchValue = list(
matchValueString = "string",
matchValueStringList = list(
"string"
)
),
claimMatchOperator = "EQUALS"|"CONTAINS"|"CONTAINS_ANY"
)
)
),
privateEndpoint = list(
selfManagedLatticeResource = list(
resourceConfigurationIdentifier = "string"
),
managedVpcResource = list(
vpcIdentifier = "string",
subnetIds = list(
"string"
),
endpointIpAddressType = "IPV4"|"IPV6",
securityGroupIds = list(
"string"
),
tags = list(
"string"
),
routingDomain = "string"
)
),
privateEndpointOverrides = list(
list(
domain = "string",
privateEndpoint = list(
selfManagedLatticeResource = list(
resourceConfigurationIdentifier = "string"
),
managedVpcResource = list(
vpcIdentifier = "string",
subnetIds = list(
"string"
),
endpointIpAddressType = "IPV4"|"IPV6",
securityGroupIds = list(
"string"
),
tags = list(
"string"
),
routingDomain = "string"
)
)
)
)
)
)
),
model = list(
bedrockModelConfig = list(
modelId = "string",
maxTokens = 123,
temperature = 123.0,
topP = 123.0
),
openAiModelConfig = list(
modelId = "string",
apiKeyArn = "string",
maxTokens = 123,
temperature = 123.0,
topP = 123.0
),
geminiModelConfig = list(
modelId = "string",
apiKeyArn = "string",
maxTokens = 123,
temperature = 123.0,
topP = 123.0,
topK = 123
)
),
systemPrompt = list(
list(
text = "string"
)
),
tools = list(
list(
type = "remote_mcp"|"agentcore_browser"|"agentcore_gateway"|"inline_function"|"agentcore_code_interpreter",
name = "string",
config = list(
remoteMcp = list(
url = "string",
headers = list(
"string"
)
),
agentCoreBrowser = list(
browserArn = "string"
),
agentCoreGateway = list(
gatewayArn = "string",
outboundAuth = list(
awsIam = list(),
none = list(),
oauth = list(
providerArn = "string",
scopes = list(
"string"
),
customParameters = list(
"string"
),
grantType = "CLIENT_CREDENTIALS"|"AUTHORIZATION_CODE"|"TOKEN_EXCHANGE",
defaultReturnUrl = "string"
)
)
),
inlineFunction = list(
description = "string",
inputSchema = list()
),
agentCoreCodeInterpreter = list(
codeInterpreterArn = "string"
)
)
)
),
skills = list(
list(
path = "string"
)
),
allowedTools = list(
"string"
),
memory = list(
optionalValue = list(
agentCoreMemoryConfiguration = list(
arn = "string",
actorId = "string",
messagesCount = 123,
retrievalConfig = list(
list(
topK = 123,
relevanceScore = 123.0,
strategyId = "string"
)
)
)
)
),
truncation = list(
strategy = "sliding_window"|"summarization"|"none",
config = list(
slidingWindow = list(
messagesCount = 123
),
summarization = list(
summaryRatio = 123.0,
preserveRecentMessages = 123,
summarizationSystemPrompt = "string"
)
)
),
maxIterations = 123,
maxTokens = 123,
timeoutSeconds = 123
)