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, hooks, 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.
hooks

The lifecycle hooks to run at defined points in the agent loop. If specified, this replaces all existing hooks. If not specified, the existing hooks are 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",
    harnessVersion = "string",
    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,
        apiFormat = "converse_stream"|"responses"|"chat_completions",
        additionalParams = list()
      ),
      openAiModelConfig = list(
        modelId = "string",
        apiKeyArn = "string",
        apiBase = "string",
        maxTokens = 123,
        temperature = 123.0,
        topP = 123.0,
        apiFormat = "chat_completions"|"responses",
        additionalParams = list()
      ),
      geminiModelConfig = list(
        modelId = "string",
        apiKeyArn = "string",
        maxTokens = 123,
        temperature = 123.0,
        topP = 123.0,
        topK = 123,
        additionalParams = list()
      ),
      liteLlmModelConfig = list(
        modelId = "string",
        apiKeyArn = "string",
        apiBase = "string",
        maxTokens = 123,
        temperature = 123.0,
        topP = 123.0,
        additionalParams = list()
      )
    ),
    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",
        s3 = list(
          uri = "string"
        ),
        git = list(
          url = "string",
          path = "string",
          auth = list(
            credentialArn = "string",
            username = "string"
          )
        ),
        awsSkills = list(
          paths = list(
            "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"
            ),
            capacityProviderVolume = list(
              volumeName = "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"
        ),
        advertisedScopeMapping = 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"
              )
            )
          )
        ),
        allowedWorkloadConfiguration = list(
          hostingEnvironments = list(
            list(
              arn = "string"
            )
          ),
          workloadIdentities = list(
            "string"
          )
        )
      )
    ),
    memory = list(
      agentCoreMemoryConfiguration = list(
        arn = "string",
        actorId = "string",
        messagesCount = 123,
        retrievalConfig = list(
          list(
            topK = 123,
            relevanceScore = 123.0,
            strategyId = "string"
          )
        )
      ),
      managedMemoryConfiguration = list(
        arn = "string",
        strategies = list(
          "SEMANTIC"|"SUMMARIZATION"|"USER_PREFERENCE"|"EPISODIC"
        ),
        eventExpiryDuration = 123,
        encryptionKeyArn = "string"
      ),
      disabled = list()
    ),
    hooks = list(
      list(
        beforeInvocation = list(
          name = "string",
          target = list(
            lambda = list(
              arn = "string",
              timeoutSeconds = 123,
              failureMode = "allow"|"deny"
            ),
            sns = list(
              arn = "string"
            ),
            eventBridge = list(
              arn = "string"
            )
          )
        ),
        afterInvocation = list(
          name = "string",
          target = list(
            lambda = list(
              arn = "string",
              timeoutSeconds = 123,
              failureMode = "allow"|"deny"
            ),
            sns = list(
              arn = "string"
            ),
            eventBridge = list(
              arn = "string"
            )
          )
        ),
        beforeToolCall = list(
          name = "string",
          target = list(
            lambda = list(
              arn = "string",
              timeoutSeconds = 123,
              failureMode = "allow"|"deny"
            ),
            sns = list(
              arn = "string"
            ),
            eventBridge = list(
              arn = "string"
            )
          )
        ),
        afterToolCall = list(
          name = "string",
          target = list(
            lambda = list(
              arn = "string",
              timeoutSeconds = 123,
              failureMode = "allow"|"deny"
            ),
            sns = list(
              arn = "string"
            ),
            eventBridge = list(
              arn = "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"
          ),
          capacityProviderVolume = list(
            volumeName = "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"
        ),
        advertisedScopeMapping = 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"
              )
            )
          )
        ),
        allowedWorkloadConfiguration = list(
          hostingEnvironments = list(
            list(
              arn = "string"
            )
          ),
          workloadIdentities = list(
            "string"
          )
        )
      )
    )
  ),
  model = list(
    bedrockModelConfig = list(
      modelId = "string",
      maxTokens = 123,
      temperature = 123.0,
      topP = 123.0,
      apiFormat = "converse_stream"|"responses"|"chat_completions",
      additionalParams = list()
    ),
    openAiModelConfig = list(
      modelId = "string",
      apiKeyArn = "string",
      apiBase = "string",
      maxTokens = 123,
      temperature = 123.0,
      topP = 123.0,
      apiFormat = "chat_completions"|"responses",
      additionalParams = list()
    ),
    geminiModelConfig = list(
      modelId = "string",
      apiKeyArn = "string",
      maxTokens = 123,
      temperature = 123.0,
      topP = 123.0,
      topK = 123,
      additionalParams = list()
    ),
    liteLlmModelConfig = list(
      modelId = "string",
      apiKeyArn = "string",
      apiBase = "string",
      maxTokens = 123,
      temperature = 123.0,
      topP = 123.0,
      additionalParams = list()
    )
  ),
  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",
      s3 = list(
        uri = "string"
      ),
      git = list(
        url = "string",
        path = "string",
        auth = list(
          credentialArn = "string",
          username = "string"
        )
      ),
      awsSkills = list(
        paths = list(
          "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"
          )
        )
      ),
      managedMemoryConfiguration = list(
        arn = "string",
        strategies = list(
          "SEMANTIC"|"SUMMARIZATION"|"USER_PREFERENCE"|"EPISODIC"
        ),
        eventExpiryDuration = 123,
        encryptionKeyArn = "string"
      ),
      disabled = list()
    )
  ),
  truncation = list(
    strategy = "sliding_window"|"summarization"|"none",
    config = list(
      slidingWindow = list(
        messagesCount = 123
      ),
      summarization = list(
        summaryRatio = 123.0,
        preserveRecentMessages = 123,
        summarizationSystemPrompt = "string"
      )
    )
  ),
  hooks = list(
    list(
      beforeInvocation = list(
        name = "string",
        target = list(
          lambda = list(
            arn = "string",
            timeoutSeconds = 123,
            failureMode = "allow"|"deny"
          ),
          sns = list(
            arn = "string"
          ),
          eventBridge = list(
            arn = "string"
          )
        )
      ),
      afterInvocation = list(
        name = "string",
        target = list(
          lambda = list(
            arn = "string",
            timeoutSeconds = 123,
            failureMode = "allow"|"deny"
          ),
          sns = list(
            arn = "string"
          ),
          eventBridge = list(
            arn = "string"
          )
        )
      ),
      beforeToolCall = list(
        name = "string",
        target = list(
          lambda = list(
            arn = "string",
            timeoutSeconds = 123,
            failureMode = "allow"|"deny"
          ),
          sns = list(
            arn = "string"
          ),
          eventBridge = list(
            arn = "string"
          )
        )
      ),
      afterToolCall = list(
        name = "string",
        target = list(
          lambda = list(
            arn = "string",
            timeoutSeconds = 123,
            failureMode = "allow"|"deny"
          ),
          sns = list(
            arn = "string"
          ),
          eventBridge = list(
            arn = "string"
          )
        )
      )
    )
  ),
  maxIterations = 123,
  maxTokens = 123,
  timeoutSeconds = 123
)