|
3095 | 3095 | "input":{"shape":"UpdateHarnessRequest"}, |
3096 | 3096 | "output":{"shape":"UpdateHarnessResponse"}, |
3097 | 3097 | "errors":[ |
| 3098 | + {"shape":"ServiceQuotaExceededException"}, |
3098 | 3099 | {"shape":"AccessDeniedException"}, |
3099 | 3100 | {"shape":"ConflictException"}, |
3100 | 3101 | {"shape":"ValidationException"}, |
|
7003 | 7004 | "shape":"HarnessTruncationConfiguration", |
7004 | 7005 | "documentation":"<p>The truncation configuration for managing conversation context when it exceeds model limits.</p>" |
7005 | 7006 | }, |
| 7007 | + "hooks":{ |
| 7008 | + "shape":"HarnessHooks", |
| 7009 | + "documentation":"<p>The lifecycle hooks to run at defined points in the agent loop.</p>" |
| 7010 | + }, |
7006 | 7011 | "maxIterations":{ |
7007 | 7012 | "shape":"Integer", |
7008 | 7013 | "documentation":"<p>The maximum number of iterations the agent loop can execute per invocation.</p>" |
|
13646 | 13651 | "shape":"HarnessMemoryConfiguration", |
13647 | 13652 | "documentation":"<p>AgentCore Memory instance configuration for short and long term memory.</p>" |
13648 | 13653 | }, |
| 13654 | + "hooks":{ |
| 13655 | + "shape":"HarnessHooks", |
| 13656 | + "documentation":"<p>The lifecycle hooks configured for the harness.</p>" |
| 13657 | + }, |
13649 | 13658 | "maxIterations":{ |
13650 | 13659 | "shape":"Integer", |
13651 | 13660 | "documentation":"<p>The maximum number of iterations in the agent loop allowed before exiting per invocation.</p>" |
|
13665 | 13674 | }, |
13666 | 13675 | "documentation":"<p>Representation of a harness.</p>" |
13667 | 13676 | }, |
| 13677 | + "HarnessAfterInvocationHook":{ |
| 13678 | + "type":"structure", |
| 13679 | + "required":[ |
| 13680 | + "name", |
| 13681 | + "target" |
| 13682 | + ], |
| 13683 | + "members":{ |
| 13684 | + "name":{ |
| 13685 | + "shape":"HarnessHookName", |
| 13686 | + "documentation":"<p>The name of the hook.</p>" |
| 13687 | + }, |
| 13688 | + "target":{ |
| 13689 | + "shape":"HarnessHookTarget", |
| 13690 | + "documentation":"<p>The target that receives the hook event.</p>" |
| 13691 | + } |
| 13692 | + }, |
| 13693 | + "documentation":"<p>The configuration for a hook that runs after an invocation completes.</p>" |
| 13694 | + }, |
| 13695 | + "HarnessAfterToolCallHook":{ |
| 13696 | + "type":"structure", |
| 13697 | + "required":[ |
| 13698 | + "name", |
| 13699 | + "target" |
| 13700 | + ], |
| 13701 | + "members":{ |
| 13702 | + "name":{ |
| 13703 | + "shape":"HarnessHookName", |
| 13704 | + "documentation":"<p>The name of the hook.</p>" |
| 13705 | + }, |
| 13706 | + "target":{ |
| 13707 | + "shape":"HarnessHookTarget", |
| 13708 | + "documentation":"<p>The target that receives the hook event.</p>" |
| 13709 | + } |
| 13710 | + }, |
| 13711 | + "documentation":"<p>The configuration for a hook that runs after a tool call completes.</p>" |
| 13712 | + }, |
13668 | 13713 | "HarnessAgentCoreBrowserConfig":{ |
13669 | 13714 | "type":"structure", |
13670 | 13715 | "members":{ |
|
13852 | 13897 | }, |
13853 | 13898 | "documentation":"<p>Configuration for an Amazon Bedrock model provider.</p>" |
13854 | 13899 | }, |
| 13900 | + "HarnessBeforeInvocationHook":{ |
| 13901 | + "type":"structure", |
| 13902 | + "required":[ |
| 13903 | + "name", |
| 13904 | + "target" |
| 13905 | + ], |
| 13906 | + "members":{ |
| 13907 | + "name":{ |
| 13908 | + "shape":"HarnessHookName", |
| 13909 | + "documentation":"<p>The name of the hook.</p>" |
| 13910 | + }, |
| 13911 | + "target":{ |
| 13912 | + "shape":"HarnessHookTarget", |
| 13913 | + "documentation":"<p>The target that receives the hook event.</p>" |
| 13914 | + } |
| 13915 | + }, |
| 13916 | + "documentation":"<p>The configuration for a hook that runs before an invocation begins.</p>" |
| 13917 | + }, |
| 13918 | + "HarnessBeforeToolCallHook":{ |
| 13919 | + "type":"structure", |
| 13920 | + "required":[ |
| 13921 | + "name", |
| 13922 | + "target" |
| 13923 | + ], |
| 13924 | + "members":{ |
| 13925 | + "name":{ |
| 13926 | + "shape":"HarnessHookName", |
| 13927 | + "documentation":"<p>The name of the hook.</p>" |
| 13928 | + }, |
| 13929 | + "target":{ |
| 13930 | + "shape":"HarnessHookTarget", |
| 13931 | + "documentation":"<p>The target that receives the hook event.</p>" |
| 13932 | + } |
| 13933 | + }, |
| 13934 | + "documentation":"<p>The configuration for a hook that runs before the agent calls a tool.</p>" |
| 13935 | + }, |
13855 | 13936 | "HarnessBrowserArn":{ |
13856 | 13937 | "type":"string", |
13857 | 13938 | "documentation":"<p>Browser ARN for Harness tool configuration. Accepts both managed (aws.browser.v1) and custom browser ARNs.</p>", |
|
13985 | 14066 | "documentation":"<p>The environment provider request configuration.</p>", |
13986 | 14067 | "union":true |
13987 | 14068 | }, |
| 14069 | + "HarnessEventBridgeBusArn":{ |
| 14070 | + "type":"string", |
| 14071 | + "documentation":"<p>The ARN of an Amazon EventBridge event bus.</p>", |
| 14072 | + "max":2048, |
| 14073 | + "min":20, |
| 14074 | + "pattern":"arn:aws(-[^:]+)?:events:[a-z0-9-]+:[0-9]{12}:event-bus/.+" |
| 14075 | + }, |
13988 | 14076 | "HarnessGatewayOutboundAuth":{ |
13989 | 14077 | "type":"structure", |
13990 | 14078 | "members":{ |
@@ -14042,6 +14130,117 @@ |
14042 | 14130 | }, |
14043 | 14131 | "documentation":"<p>Configuration for a Google Gemini model provider. Requires an API key stored in AgentCore Identity.</p>" |
14044 | 14132 | }, |
| 14133 | + "HarnessHook":{ |
| 14134 | + "type":"structure", |
| 14135 | + "members":{ |
| 14136 | + "beforeInvocation":{ |
| 14137 | + "shape":"HarnessBeforeInvocationHook", |
| 14138 | + "documentation":"<p>A hook that runs before an invocation begins.</p>" |
| 14139 | + }, |
| 14140 | + "afterInvocation":{ |
| 14141 | + "shape":"HarnessAfterInvocationHook", |
| 14142 | + "documentation":"<p>A hook that runs after an invocation completes.</p>" |
| 14143 | + }, |
| 14144 | + "beforeToolCall":{ |
| 14145 | + "shape":"HarnessBeforeToolCallHook", |
| 14146 | + "documentation":"<p>A hook that runs before the agent calls a tool.</p>" |
| 14147 | + }, |
| 14148 | + "afterToolCall":{ |
| 14149 | + "shape":"HarnessAfterToolCallHook", |
| 14150 | + "documentation":"<p>A hook that runs after a tool call completes.</p>" |
| 14151 | + } |
| 14152 | + }, |
| 14153 | + "documentation":"<p>A lifecycle hook configuration. Specify one hook type.</p>", |
| 14154 | + "union":true |
| 14155 | + }, |
| 14156 | + "HarnessHookEventBridgeTarget":{ |
| 14157 | + "type":"structure", |
| 14158 | + "required":["arn"], |
| 14159 | + "members":{ |
| 14160 | + "arn":{ |
| 14161 | + "shape":"HarnessEventBridgeBusArn", |
| 14162 | + "documentation":"<p>The ARN of the Amazon EventBridge event bus to send hook events to.</p>" |
| 14163 | + } |
| 14164 | + }, |
| 14165 | + "documentation":"<p>The configuration for an Amazon EventBridge hook target.</p>" |
| 14166 | + }, |
| 14167 | + "HarnessHookFailureMode":{ |
| 14168 | + "type":"string", |
| 14169 | + "documentation":"<p>The behavior when a synchronous hook target fails.</p>", |
| 14170 | + "enum":[ |
| 14171 | + "allow", |
| 14172 | + "deny" |
| 14173 | + ] |
| 14174 | + }, |
| 14175 | + "HarnessHookLambdaTarget":{ |
| 14176 | + "type":"structure", |
| 14177 | + "required":["arn"], |
| 14178 | + "members":{ |
| 14179 | + "arn":{ |
| 14180 | + "shape":"HarnessLambdaFunctionArn", |
| 14181 | + "documentation":"<p>The ARN of the Lambda function to invoke.</p>" |
| 14182 | + }, |
| 14183 | + "timeoutSeconds":{ |
| 14184 | + "shape":"HarnessHookLambdaTargetTimeoutSecondsInteger", |
| 14185 | + "documentation":"<p>The maximum number of seconds to wait for the Lambda function response. The default is 60 seconds.</p>" |
| 14186 | + }, |
| 14187 | + "failureMode":{ |
| 14188 | + "shape":"HarnessHookFailureMode", |
| 14189 | + "documentation":"<p>The behavior when the Lambda function times out, returns an error, or returns an invalid response. The default is <code>DENY</code>.</p>" |
| 14190 | + } |
| 14191 | + }, |
| 14192 | + "documentation":"<p>The configuration for an AWS Lambda hook target.</p>" |
| 14193 | + }, |
| 14194 | + "HarnessHookLambdaTargetTimeoutSecondsInteger":{ |
| 14195 | + "type":"integer", |
| 14196 | + "box":true, |
| 14197 | + "max":900, |
| 14198 | + "min":1 |
| 14199 | + }, |
| 14200 | + "HarnessHookName":{ |
| 14201 | + "type":"string", |
| 14202 | + "documentation":"<p>The name of a lifecycle hook.</p>", |
| 14203 | + "max":64, |
| 14204 | + "min":1, |
| 14205 | + "pattern":"[a-zA-Z0-9_-]+" |
| 14206 | + }, |
| 14207 | + "HarnessHookSnsTarget":{ |
| 14208 | + "type":"structure", |
| 14209 | + "required":["arn"], |
| 14210 | + "members":{ |
| 14211 | + "arn":{ |
| 14212 | + "shape":"HarnessSnsTopicArn", |
| 14213 | + "documentation":"<p>The ARN of the Amazon SNS topic to publish hook events to.</p>" |
| 14214 | + } |
| 14215 | + }, |
| 14216 | + "documentation":"<p>The configuration for an Amazon SNS hook target.</p>" |
| 14217 | + }, |
| 14218 | + "HarnessHookTarget":{ |
| 14219 | + "type":"structure", |
| 14220 | + "members":{ |
| 14221 | + "lambda":{ |
| 14222 | + "shape":"HarnessHookLambdaTarget", |
| 14223 | + "documentation":"<p>A Lambda hook target that invokes an AWS Lambda function synchronously and waits for its response.</p>" |
| 14224 | + }, |
| 14225 | + "sns":{ |
| 14226 | + "shape":"HarnessHookSnsTarget", |
| 14227 | + "documentation":"<p>An Amazon SNS hook target that publishes the hook event without waiting for a response.</p>" |
| 14228 | + }, |
| 14229 | + "eventBridge":{ |
| 14230 | + "shape":"HarnessHookEventBridgeTarget", |
| 14231 | + "documentation":"<p>An Amazon EventBridge hook target that sends the hook event without waiting for a response.</p>" |
| 14232 | + } |
| 14233 | + }, |
| 14234 | + "documentation":"<p>The target that receives lifecycle hook events. Specify one target type.</p>", |
| 14235 | + "union":true |
| 14236 | + }, |
| 14237 | + "HarnessHooks":{ |
| 14238 | + "type":"list", |
| 14239 | + "member":{"shape":"HarnessHook"}, |
| 14240 | + "documentation":"<p>The lifecycle hooks configured to run at defined points in the agent loop.</p>", |
| 14241 | + "max":20, |
| 14242 | + "min":0 |
| 14243 | + }, |
14045 | 14244 | "HarnessId":{ |
14046 | 14245 | "type":"string", |
14047 | 14246 | "pattern":"[a-zA-Z][a-zA-Z0-9_]{0,39}-[a-zA-Z0-9]{10}" |
|
14070 | 14269 | "min":1, |
14071 | 14270 | "sensitive":true |
14072 | 14271 | }, |
| 14272 | + "HarnessLambdaFunctionArn":{ |
| 14273 | + "type":"string", |
| 14274 | + "documentation":"<p>The ARN of an AWS Lambda function.</p>", |
| 14275 | + "max":2048, |
| 14276 | + "min":20, |
| 14277 | + "pattern":"arn:aws(-[^:]+)?:lambda:[a-z0-9-]+:[0-9]{12}:function:.+" |
| 14278 | + }, |
14073 | 14279 | "HarnessLiteLlmApiBase":{ |
14074 | 14280 | "type":"string", |
14075 | 14281 | "max":16383, |
|
14200 | 14406 | "type":"string", |
14201 | 14407 | "pattern":"[a-zA-Z][a-zA-Z0-9_]{0,39}" |
14202 | 14408 | }, |
| 14409 | + "HarnessOpenAiApiBase":{ |
| 14410 | + "type":"string", |
| 14411 | + "max":16383, |
| 14412 | + "min":1, |
| 14413 | + "sensitive":true |
| 14414 | + }, |
14203 | 14415 | "HarnessOpenAiApiFormat":{ |
14204 | 14416 | "type":"string", |
14205 | 14417 | "enum":[ |
|
14222 | 14434 | "shape":"ApiKeyArn", |
14223 | 14435 | "documentation":"<p>The ARN of your OpenAI API key on AgentCore Identity.</p>" |
14224 | 14436 | }, |
| 14437 | + "apiBase":{ |
| 14438 | + "shape":"HarnessOpenAiApiBase", |
| 14439 | + "documentation":"<p>Optional custom endpoint URL for an OpenAI-compatible endpoint.</p>" |
| 14440 | + }, |
14225 | 14441 | "maxTokens":{ |
14226 | 14442 | "shape":"MaxTokens", |
14227 | 14443 | "documentation":"<p>The maximum number of tokens to allow in the generated response per model call.</p>" |
|
14375 | 14591 | }, |
14376 | 14592 | "documentation":"<p>Configuration for sliding window truncation strategy.</p>" |
14377 | 14593 | }, |
| 14594 | + "HarnessSnsTopicArn":{ |
| 14595 | + "type":"string", |
| 14596 | + "documentation":"<p>The ARN of an Amazon SNS topic.</p>", |
| 14597 | + "max":2048, |
| 14598 | + "min":20, |
| 14599 | + "pattern":"arn:aws(-[^:]+)?:sns:[a-z0-9-]+:[0-9]{12}:.+" |
| 14600 | + }, |
14378 | 14601 | "HarnessStatus":{ |
14379 | 14602 | "type":"string", |
14380 | 14603 | "enum":[ |
|
23522 | 23745 | "shape":"HarnessTruncationConfiguration", |
23523 | 23746 | "documentation":"<p>The truncation configuration for managing conversation context. If not specified, the existing value is retained.</p>" |
23524 | 23747 | }, |
| 23748 | + "hooks":{ |
| 23749 | + "shape":"HarnessHooks", |
| 23750 | + "documentation":"<p>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.</p>" |
| 23751 | + }, |
23525 | 23752 | "maxIterations":{ |
23526 | 23753 | "shape":"Integer", |
23527 | 23754 | "documentation":"<p>The maximum number of iterations the agent loop can execute per invocation. If not specified, the existing value is retained.</p>" |
|
0 commit comments