feat(client-bedrock-agent): This release adds the Agent Lifecycle Paused State feature to Amazon Bedrock agents. By using an agent's alias, you can temporarily suspend agent operations during maintenance, updates, or other situations.

awstools · awstools · commit 26fec8800771 · 2025-06-02T18:10:39.000Z
diff --git a/clients/client-bedrock-agent/src/commands/CreateAgentAliasCommand.ts b/clients/client-bedrock-agent/src/commands/CreateAgentAliasCommand.ts
@@ -84,6 +84,7 @@ export interface CreateAgentAliasCommandOutput extends CreateAgentAliasResponse,
  * //     failureReasons: [ // FailureReasons
  * //       "STRING_VALUE",
  * //     ],
+ * //     aliasInvocationState: "ACCEPT_INVOCATIONS" || "REJECT_INVOCATIONS",
  * //   },
  * // };
  *
diff --git a/clients/client-bedrock-agent/src/commands/GetAgentAliasCommand.ts b/clients/client-bedrock-agent/src/commands/GetAgentAliasCommand.ts
@@ -73,6 +73,7 @@ export interface GetAgentAliasCommandOutput extends GetAgentAliasResponse, __Met
  * //     failureReasons: [ // FailureReasons
  * //       "STRING_VALUE",
  * //     ],
+ * //     aliasInvocationState: "ACCEPT_INVOCATIONS" || "REJECT_INVOCATIONS",
  * //   },
  * // };
  *
diff --git a/clients/client-bedrock-agent/src/commands/ListAgentAliasesCommand.ts b/clients/client-bedrock-agent/src/commands/ListAgentAliasesCommand.ts
@@ -57,6 +57,7 @@ export interface ListAgentAliasesCommandOutput extends ListAgentAliasesResponse,
  * //       agentAliasStatus: "CREATING" || "PREPARED" || "FAILED" || "UPDATING" || "DELETING" || "DISSOCIATED", // required
  * //       createdAt: new Date("TIMESTAMP"), // required
  * //       updatedAt: new Date("TIMESTAMP"), // required
+ * //       aliasInvocationState: "ACCEPT_INVOCATIONS" || "REJECT_INVOCATIONS",
  * //     },
  * //   ],
  * //   nextToken: "STRING_VALUE",
diff --git a/clients/client-bedrock-agent/src/commands/UpdateAgentAliasCommand.ts b/clients/client-bedrock-agent/src/commands/UpdateAgentAliasCommand.ts
@@ -46,6 +46,7 @@ export interface UpdateAgentAliasCommandOutput extends UpdateAgentAliasResponse,
  *       provisionedThroughput: "STRING_VALUE",
  *     },
  *   ],
+ *   aliasInvocationState: "ACCEPT_INVOCATIONS" || "REJECT_INVOCATIONS",
  * };
  * const command = new UpdateAgentAliasCommand(input);
  * const response = await client.send(command);
@@ -81,6 +82,7 @@ export interface UpdateAgentAliasCommandOutput extends UpdateAgentAliasResponse,
  * //     failureReasons: [ // FailureReasons
  * //       "STRING_VALUE",
  * //     ],
+ * //     aliasInvocationState: "ACCEPT_INVOCATIONS" || "REJECT_INVOCATIONS",
  * //   },
  * // };
  *
diff --git a/clients/client-bedrock-agent/src/models/models_0.ts b/clients/client-bedrock-agent/src/models/models_0.ts
@@ -472,7 +472,7 @@ export interface CreateAgentActionGroupRequest {
    *             Computer use is a new Anthropic Claude model capability (in beta) available with Anthropic Claude 3.7 Sonnet and Claude 3.5 Sonnet v2 only.
    *             When operating computer use functionality, we recommend taking additional security precautions,
    *             such as executing computer actions in virtual environments with restricted data access and limited internet connectivity.
-   *              For more information, see <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/agent-computer-use.html">Configure an Amazon Bedrock Agent to complete tasks with computer use tools</a>.
+   *              For more information, see <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/agents-computer-use.html">Configure an Amazon Bedrock Agent to complete tasks with computer use tools</a>.
    *           </p>
    *                </important>
    *                <ul>
@@ -500,7 +500,7 @@ export interface CreateAgentActionGroupRequest {
    * <p>The configuration settings for a computer use action.</p>
    *          <important>
    *             <p>
-   *         Computer use is a new Anthropic Claude model capability (in beta) available with Anthropic Claude 3.7 Sonnet and Claude 3.5 Sonnet v2 only. For more information, see <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/agent-computer-use.html">Configure an Amazon Bedrock Agent to complete tasks with computer use tools</a>.
+   *         Computer use is a new Anthropic Claude model capability (in beta) available with Anthropic Claude 3.7 Sonnet and Claude 3.5 Sonnet v2 only. For more information, see <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/agents-computer-use.html">Configure an Amazon Bedrock Agent to complete tasks with computer use tools</a>.
    *       </p>
    *          </important>
    * @public
@@ -597,7 +597,7 @@ export interface AgentActionGroup {
    * <p>The configuration settings for a computer use action.</p>
    *          <important>
    *             <p>
-   *         Computer use is a new Anthropic Claude model capability (in beta) available with Claude 3.7 Sonnet and Claude 3.5 Sonnet v2 only. For more information, see <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/agent-computer-use.html">Configure an Amazon Bedrock Agent to complete tasks with computer use tools</a>.
+   *         Computer use is a new Anthropic Claude model capability (in beta) available with Claude 3.7 Sonnet and Claude 3.5 Sonnet v2 only. For more information, see <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/agents-computer-use.html">Configure an Amazon Bedrock Agent to complete tasks with computer use tools</a>.
    *       </p>
    *          </important>
    * @public
@@ -967,7 +967,7 @@ export interface UpdateAgentActionGroupRequest {
    *             Computer use is a new Anthropic Claude model capability (in beta) available with Anthropic Claude 3.7 Sonnet and Claude 3.5 Sonnet v2 only.
    *             When operating computer use functionality, we recommend taking additional security precautions,
    *             such as executing computer actions in virtual environments with restricted data access and limited internet connectivity.
-   *              For more information, see <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/agent-computer-use.html">Configure an Amazon Bedrock Agent to complete tasks with computer use tools</a>.
+   *              For more information, see <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/agents-computer-use.html">Configure an Amazon Bedrock Agent to complete tasks with computer use tools</a>.
    *           </p>
    *                </important>
    *                <ul>
@@ -996,7 +996,7 @@ export interface UpdateAgentActionGroupRequest {
    * <p>The configuration settings for a computer use action.</p>
    *          <important>
    *             <p>
-   *         Computer use is a new Anthropic Claude model capability (in beta) available with Claude 3.7 Sonnet and Claude 3.5 Sonnet v2 only. For more information, see <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/agent-computer-use.html">Configure an Amazon Bedrock Agent to complete tasks with computer use tools</a>.
+   *         Computer use is a new Anthropic Claude model capability (in beta) available with Claude 3.7 Sonnet and Claude 3.5 Sonnet v2 only. For more information, see <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/agents-computer-use.html">Configure an Amazon Bedrock Agent to complete tasks with computer use tools</a>.
    *       </p>
    *          </important>
    * @public
@@ -1316,7 +1316,7 @@ export interface PromptConfiguration {
    *          <ul>
    *             <li>
    *                <p>
-   *                   <code>PRE_PROCESSING</code> – <code>ENABLED</code>
+   *                   <code>PRE_PROCESSING</code> – <code>DISABLED</code>
    *                </p>
    *             </li>
    *             <li>
@@ -1627,6 +1627,26 @@ export const AgentAliasStatus = {
  */
 export type AgentAliasStatus = (typeof AgentAliasStatus)[keyof typeof AgentAliasStatus];
 
+/**
+ * @public
+ * @enum
+ */
+export const AliasInvocationState = {
+  /**
+   * Agent is actively processing requests
+   */
+  ACCEPT_INVOCATIONS: "ACCEPT_INVOCATIONS",
+  /**
+   * Agent is paused and will not accept new requests
+   */
+  REJECT_INVOCATIONS: "REJECT_INVOCATIONS",
+} as const;
+
+/**
+ * @public
+ */
+export type AliasInvocationState = (typeof AliasInvocationState)[keyof typeof AliasInvocationState];
+
 /**
  * <p>Contains details about an alias of an agent.</p>
  * @public
@@ -1724,6 +1744,15 @@ export interface AgentAlias {
    * @public
    */
   failureReasons?: string[] | undefined;
+
+  /**
+   * <p>The invocation state for the agent alias. If the agent alias is running,
+   *       the value is <code>ACCEPT_INVOCATIONS</code>. If the agent alias is paused,
+   *       the value is <code>REJECT_INVOCATIONS</code>. Use the <code>UpdateAgentAlias</code> operation
+   *       to change the invocation state.</p>
+   * @public
+   */
+  aliasInvocationState?: AliasInvocationState | undefined;
 }
 
 /**
@@ -1772,6 +1801,15 @@ export interface AgentAliasSummary {
    * @public
    */
   updatedAt: Date | undefined;
+
+  /**
+   * <p>The invocation state for the agent alias. If the agent alias is running,
+   *       the value is <code>ACCEPT_INVOCATIONS</code>. If the agent alias is paused,
+   *       the value is <code>REJECT_INVOCATIONS</code>. Use the <code>UpdateAgentAlias</code> operation
+   *     to change the invocation state.</p>
+   * @public
+   */
+  aliasInvocationState?: AliasInvocationState | undefined;
 }
 
 /**
@@ -3050,6 +3088,16 @@ export interface UpdateAgentAliasRequest {
    * @public
    */
   routingConfiguration?: AgentAliasRoutingConfigurationListItem[] | undefined;
+
+  /**
+   * <p>The invocation state for the agent alias. To pause the agent alias, set the value to
+   *         <code>REJECT_INVOCATIONS</code>. To start the agent alias running again, set the value to
+   *         <code>ACCEPT_INVOCATIONS</code>. Use the <code>GetAgentAlias</code>, or
+   *         <code>ListAgentAliases</code>, operation to get the invocation state of an agent
+   *       alias.</p>
+   * @public
+   */
+  aliasInvocationState?: AliasInvocationState | undefined;
 }
 
 /**
@@ -9163,24 +9211,6 @@ export interface IngestionJobStatistics {
   numberOfDocumentsFailed?: number | undefined;
 }
 
-/**
- * @public
- * @enum
- */
-export const IngestionJobStatus = {
-  COMPLETE: "COMPLETE",
-  FAILED: "FAILED",
-  IN_PROGRESS: "IN_PROGRESS",
-  STARTING: "STARTING",
-  STOPPED: "STOPPED",
-  STOPPING: "STOPPING",
-} as const;
-
-/**
- * @public
- */
-export type IngestionJobStatus = (typeof IngestionJobStatus)[keyof typeof IngestionJobStatus];
-
 /**
  * @internal
  */
diff --git a/clients/client-bedrock-agent/src/models/models_1.ts b/clients/client-bedrock-agent/src/models/models_1.ts
@@ -23,7 +23,6 @@ import {
   FlowValidation,
   FlowValidationFilterSensitiveLog,
   IngestionJobStatistics,
-  IngestionJobStatus,
   InlineCodeFlowNodeConfiguration,
   InlineCodeFlowNodeConfigurationFilterSensitiveLog,
   InputFlowNodeConfiguration,
@@ -48,6 +47,24 @@ import {
   StorageFlowNodeConfiguration,
 } from "./models_0";
 
+/**
+ * @public
+ * @enum
+ */
+export const IngestionJobStatus = {
+  COMPLETE: "COMPLETE",
+  FAILED: "FAILED",
+  IN_PROGRESS: "IN_PROGRESS",
+  STARTING: "STARTING",
+  STOPPED: "STOPPED",
+  STOPPING: "STOPPING",
+} as const;
+
+/**
+ * @public
+ */
+export type IngestionJobStatus = (typeof IngestionJobStatus)[keyof typeof IngestionJobStatus];
+
 /**
  * <p>Contains details about a data ingestion job. Data sources are ingested into a knowledge base so that Large Language Models (LLMs) can use your data.</p>
  *          <p>This data type is used in the following API operations:</p>
@@ -4047,7 +4064,10 @@ export namespace FlowNodeConfiguration {
  *                   <code>LoopInput</code> - The entry point node for the loop. This node receives inputs from nodes outside the loop and from previous loop iterations.</p>
  *             </li>
  *             <li>
- *                <p>Body nodes - These can be </p>
+ *                <p>Body nodes - The processing nodes that execute within each loop iteration.
+ *                     These can be nodes for handling data in your flow, such as a prompt or Lambda
+ *                     function nodes. Some node types aren't supported inside a DoWhile loop body. For
+ *                     more information, see <a href="https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_LoopIncompatibleNodeTypeFlowValidationDetails.html">LoopIncompatibleNodeTypeFlowValidationDetails</a>.</p>
  *             </li>
  *             <li>
  *                <p>
diff --git a/clients/client-bedrock-agent/src/protocols/Aws_restJson1.ts b/clients/client-bedrock-agent/src/protocols/Aws_restJson1.ts
@@ -1791,6 +1791,7 @@ export const se_UpdateAgentAliasCommand = async (
   body = JSON.stringify(
     take(input, {
       agentAliasName: [],
+      aliasInvocationState: [],
       description: [],
       routingConfiguration: (_) => _json(_),
     })
@@ -4780,6 +4781,7 @@ const de_AgentAlias = (output: any, context: __SerdeContext): AgentAlias => {
     agentAliasName: __expectString,
     agentAliasStatus: __expectString,
     agentId: __expectString,
+    aliasInvocationState: __expectString,
     clientToken: __expectString,
     createdAt: (_: any) => __expectNonNull(__parseRfc3339DateTimeWithOffset(_)),
     description: __expectString,
@@ -4836,6 +4838,7 @@ const de_AgentAliasSummary = (output: any, context: __SerdeContext): AgentAliasS
     agentAliasId: __expectString,
     agentAliasName: __expectString,
     agentAliasStatus: __expectString,
+    aliasInvocationState: __expectString,
     createdAt: (_: any) => __expectNonNull(__parseRfc3339DateTimeWithOffset(_)),
     description: __expectString,
     routingConfiguration: _json,
diff --git a/codegen/sdk-codegen/aws-models/bedrock-agent.json b/codegen/sdk-codegen/aws-models/bedrock-agent.json

Original file line number	Diff line number	Diff line change
`@@ -84,6 +84,7 @@ export interface CreateAgentAliasCommandOutput extends CreateAgentAliasResponse,`
`84`	`84`	`* // failureReasons: [ // FailureReasons`
`85`	`85`	`* // "STRING_VALUE",`
`86`	`86`	`* // ],`
	`87`	`+ * // aliasInvocationState: "ACCEPT_INVOCATIONS" \|\| "REJECT_INVOCATIONS",`
`87`	`88`	`* // },`
`88`	`89`	`* // };`
`89`	`90`	`*`
Original file line number	Diff line number	Diff line change
`@@ -73,6 +73,7 @@ export interface GetAgentAliasCommandOutput extends GetAgentAliasResponse, __Met`
`73`	`73`	`* // failureReasons: [ // FailureReasons`
`74`	`74`	`* // "STRING_VALUE",`
`75`	`75`	`* // ],`
	`76`	`+ * // aliasInvocationState: "ACCEPT_INVOCATIONS" \|\| "REJECT_INVOCATIONS",`
`76`	`77`	`* // },`
`77`	`78`	`* // };`
`78`	`79`	`*`