From f6cf1003961f860d9be6e98615919937ee22ce78 Mon Sep 17 00:00:00 2001
From: awstools <awstools@amazon.com>
Date: Wed, 27 Mar 2024 18:31:43 +0000
Subject: [PATCH] feat(client-bedrock-agent): This changes introduces metadata
 documents statistics and also updates the documentation for bedrock agent.

---
 clients/client-bedrock-agent/README.md        |    3 +-
 .../client-bedrock-agent/src/BedrockAgent.ts  |    3 +-
 .../src/BedrockAgentClient.ts                 |    3 +-
 .../AssociateAgentKnowledgeBaseCommand.ts     |   16 +-
 .../commands/CreateAgentActionGroupCommand.ts |   17 +-
 .../src/commands/CreateAgentAliasCommand.ts   |   16 +-
 .../src/commands/CreateAgentCommand.ts        |   37 +-
 .../src/commands/CreateDataSourceCommand.ts   |   19 +-
 .../commands/CreateKnowledgeBaseCommand.ts    |   45 +-
 .../commands/DeleteAgentActionGroupCommand.ts |   14 +-
 .../src/commands/DeleteAgentAliasCommand.ts   |   12 +-
 .../src/commands/DeleteAgentCommand.ts        |   14 +-
 .../src/commands/DeleteAgentVersionCommand.ts |   14 +-
 .../src/commands/DeleteDataSourceCommand.ts   |   14 +-
 .../commands/DeleteKnowledgeBaseCommand.ts    |   14 +-
 .../DisassociateAgentKnowledgeBaseCommand.ts  |   14 +-
 .../commands/GetAgentActionGroupCommand.ts    |   12 +-
 .../src/commands/GetAgentAliasCommand.ts      |   12 +-
 .../src/commands/GetAgentCommand.ts           |   12 +-
 .../commands/GetAgentKnowledgeBaseCommand.ts  |   12 +-
 .../src/commands/GetAgentVersionCommand.ts    |   12 +-
 .../src/commands/GetDataSourceCommand.ts      |   12 +-
 .../src/commands/GetIngestionJobCommand.ts    |   14 +-
 .../src/commands/GetKnowledgeBaseCommand.ts   |   12 +-
 .../commands/ListAgentActionGroupsCommand.ts  |   12 +-
 .../src/commands/ListAgentAliasesCommand.ts   |   12 +-
 .../ListAgentKnowledgeBasesCommand.ts         |   12 +-
 .../src/commands/ListAgentVersionsCommand.ts  |   12 +-
 .../src/commands/ListAgentsCommand.ts         |   10 +-
 .../src/commands/ListDataSourcesCommand.ts    |   12 +-
 .../src/commands/ListIngestionJobsCommand.ts  |   14 +-
 .../src/commands/ListKnowledgeBasesCommand.ts |   10 +-
 .../commands/ListTagsForResourceCommand.ts    |   12 +-
 .../src/commands/PrepareAgentCommand.ts       |   16 +-
 .../src/commands/StartIngestionJobCommand.ts  |   18 +-
 .../src/commands/TagResourceCommand.ts        |   14 +-
 .../src/commands/UntagResourceCommand.ts      |   12 +-
 .../commands/UpdateAgentActionGroupCommand.ts |   16 +-
 .../src/commands/UpdateAgentAliasCommand.ts   |   16 +-
 .../src/commands/UpdateAgentCommand.ts        |   18 +-
 .../UpdateAgentKnowledgeBaseCommand.ts        |   14 +-
 .../src/commands/UpdateDataSourceCommand.ts   |   17 +-
 .../commands/UpdateKnowledgeBaseCommand.ts    |   33 +-
 clients/client-bedrock-agent/src/index.ts     |    3 +-
 .../src/models/models_0.ts                    | 1165 +++++++------
 .../sdk-codegen/aws-models/bedrock-agent.json | 1448 +++++++++++------
 46 files changed, 1963 insertions(+), 1286 deletions(-)

diff --git a/clients/client-bedrock-agent/README.md b/clients/client-bedrock-agent/README.md
index b36713cf1573..f7f4bafc2597 100644
--- a/clients/client-bedrock-agent/README.md
+++ b/clients/client-bedrock-agent/README.md
@@ -6,8 +6,7 @@
 
 AWS SDK for JavaScript BedrockAgent Client for Node.js, Browser and React Native.
 
-An example service, deployed with the Octane Service creator,
-which will echo the string
+<p>Describes the API operations for creating and managing Amazon Bedrock agents.</p>
 
 ## Installing
 
diff --git a/clients/client-bedrock-agent/src/BedrockAgent.ts b/clients/client-bedrock-agent/src/BedrockAgent.ts
index 6ba5baf25d95..894928b3ac19 100644
--- a/clients/client-bedrock-agent/src/BedrockAgent.ts
+++ b/clients/client-bedrock-agent/src/BedrockAgent.ts
@@ -839,8 +839,7 @@ export interface BedrockAgent {
 }
 
 /**
- * An example service, deployed with the Octane Service creator,
- * which will echo the string
+ * <p>Describes the API operations for creating and managing Amazon Bedrock agents.</p>
  * @public
  */
 export class BedrockAgent extends BedrockAgentClient implements BedrockAgent {}
diff --git a/clients/client-bedrock-agent/src/BedrockAgentClient.ts b/clients/client-bedrock-agent/src/BedrockAgentClient.ts
index 265c9c7a2933..1fbed7bb855a 100644
--- a/clients/client-bedrock-agent/src/BedrockAgentClient.ts
+++ b/clients/client-bedrock-agent/src/BedrockAgentClient.ts
@@ -408,8 +408,7 @@ export type BedrockAgentClientResolvedConfigType = __SmithyResolvedConfiguration
 export interface BedrockAgentClientResolvedConfig extends BedrockAgentClientResolvedConfigType {}
 
 /**
- * An example service, deployed with the Octane Service creator,
- * which will echo the string
+ * <p>Describes the API operations for creating and managing Amazon Bedrock agents.</p>
  * @public
  */
 export class BedrockAgentClient extends __Client<
diff --git a/clients/client-bedrock-agent/src/commands/AssociateAgentKnowledgeBaseCommand.ts b/clients/client-bedrock-agent/src/commands/AssociateAgentKnowledgeBaseCommand.ts
index 7c62a4e4cfd0..2f647cde89db 100644
--- a/clients/client-bedrock-agent/src/commands/AssociateAgentKnowledgeBaseCommand.ts
+++ b/clients/client-bedrock-agent/src/commands/AssociateAgentKnowledgeBaseCommand.ts
@@ -32,7 +32,7 @@ export interface AssociateAgentKnowledgeBaseCommandOutput
     __MetadataBearer {}
 
 /**
- * Associate a Knowledge Base to an existing Amazon Bedrock Agent
+ * <p>Associates a knowledge base with an agent. If a knowledge base is associated and its <code>indexState</code> is set to <code>Enabled</code>, the agent queries the knowledge base for information to augment its response to the user.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
@@ -69,25 +69,25 @@ export interface AssociateAgentKnowledgeBaseCommandOutput
  * @see {@link BedrockAgentClientResolvedConfig | config} for BedrockAgentClient's `config` shape.
  *
  * @throws {@link AccessDeniedException} (client fault)
- *  This exception is thrown when a request is denied per access permissions
+ *  <p>The request is denied because of missing access permissions.</p>
  *
  * @throws {@link ConflictException} (client fault)
- *  This exception is thrown when there is a conflict performing an operation
+ *  <p>There was a conflict performing an operation.</p>
  *
  * @throws {@link InternalServerException} (server fault)
- *  This exception is thrown if there was an unexpected error during processing of request
+ *  <p>An internal server error occurred. Retry your request.</p>
  *
  * @throws {@link ResourceNotFoundException} (client fault)
- *  This exception is thrown when a resource referenced by the operation does not exist
+ *  <p>The specified resource ARN was not found. Check the ARN and try your request again.</p>
  *
  * @throws {@link ServiceQuotaExceededException} (client fault)
- *  This exception is thrown when a request is made beyond the service quota
+ *  <p>The number of requests exceeds the service quota. Resubmit your request later.</p>
  *
  * @throws {@link ThrottlingException} (client fault)
- *  This exception is thrown when the number of requests exceeds the limit
+ *  <p>The number of requests exceeds the limit. Resubmit your request later.</p>
  *
  * @throws {@link ValidationException} (client fault)
- *  This exception is thrown when the request's input validation fails
+ *  <p>Input validation failed. Check your request parameters and retry the request.</p>
  *
  * @throws {@link BedrockAgentServiceException}
  * <p>Base exception class for all service exceptions from BedrockAgent service.</p>
diff --git a/clients/client-bedrock-agent/src/commands/CreateAgentActionGroupCommand.ts b/clients/client-bedrock-agent/src/commands/CreateAgentActionGroupCommand.ts
index c20fbe510328..e3f42368412d 100644
--- a/clients/client-bedrock-agent/src/commands/CreateAgentActionGroupCommand.ts
+++ b/clients/client-bedrock-agent/src/commands/CreateAgentActionGroupCommand.ts
@@ -32,7 +32,8 @@ export interface CreateAgentActionGroupCommandInput extends CreateAgentActionGro
 export interface CreateAgentActionGroupCommandOutput extends CreateAgentActionGroupResponse, __MetadataBearer {}
 
 /**
- * Creates an Action Group for existing Amazon Bedrock Agent
+ * <p>Creates an action group for an agent. An action group represents the actions that an agent can carry out for the customer by defining the APIs that an agent can call and the logic for calling them.</p>
+ *          <p>To allow your agent to request the user for additional information when trying to complete a task, add an action group with the <code>parentActionGroupSignature</code> field set to <code>AMAZON.UserInput</code>. You must leave the <code>description</code>, <code>apiSchema</code>, and <code>actionGroupExecutor</code> fields blank for this action group. During orchestration, if your agent determines that it needs to invoke an API in an action group, but doesn't have enough information to complete the API request, it will invoke this action group instead and return an <a href="https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_Observation.html">Observation</a> reprompting the user for more information.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
@@ -94,25 +95,25 @@ export interface CreateAgentActionGroupCommandOutput extends CreateAgentActionGr
  * @see {@link BedrockAgentClientResolvedConfig | config} for BedrockAgentClient's `config` shape.
  *
  * @throws {@link AccessDeniedException} (client fault)
- *  This exception is thrown when a request is denied per access permissions
+ *  <p>The request is denied because of missing access permissions.</p>
  *
  * @throws {@link ConflictException} (client fault)
- *  This exception is thrown when there is a conflict performing an operation
+ *  <p>There was a conflict performing an operation.</p>
  *
  * @throws {@link InternalServerException} (server fault)
- *  This exception is thrown if there was an unexpected error during processing of request
+ *  <p>An internal server error occurred. Retry your request.</p>
  *
  * @throws {@link ResourceNotFoundException} (client fault)
- *  This exception is thrown when a resource referenced by the operation does not exist
+ *  <p>The specified resource ARN was not found. Check the ARN and try your request again.</p>
  *
  * @throws {@link ServiceQuotaExceededException} (client fault)
- *  This exception is thrown when a request is made beyond the service quota
+ *  <p>The number of requests exceeds the service quota. Resubmit your request later.</p>
  *
  * @throws {@link ThrottlingException} (client fault)
- *  This exception is thrown when the number of requests exceeds the limit
+ *  <p>The number of requests exceeds the limit. Resubmit your request later.</p>
  *
  * @throws {@link ValidationException} (client fault)
- *  This exception is thrown when the request's input validation fails
+ *  <p>Input validation failed. Check your request parameters and retry the request.</p>
  *
  * @throws {@link BedrockAgentServiceException}
  * <p>Base exception class for all service exceptions from BedrockAgent service.</p>
diff --git a/clients/client-bedrock-agent/src/commands/CreateAgentAliasCommand.ts b/clients/client-bedrock-agent/src/commands/CreateAgentAliasCommand.ts
index 93b7e03b204b..dcecb3e2a7da 100644
--- a/clients/client-bedrock-agent/src/commands/CreateAgentAliasCommand.ts
+++ b/clients/client-bedrock-agent/src/commands/CreateAgentAliasCommand.ts
@@ -27,7 +27,7 @@ export interface CreateAgentAliasCommandInput extends CreateAgentAliasRequest {}
 export interface CreateAgentAliasCommandOutput extends CreateAgentAliasResponse, __MetadataBearer {}
 
 /**
- * Creates an Alias for an existing Amazon Bedrock Agent
+ * <p>Creates an alias of an agent that can be used to deploy the agent.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
@@ -89,25 +89,25 @@ export interface CreateAgentAliasCommandOutput extends CreateAgentAliasResponse,
  * @see {@link BedrockAgentClientResolvedConfig | config} for BedrockAgentClient's `config` shape.
  *
  * @throws {@link AccessDeniedException} (client fault)
- *  This exception is thrown when a request is denied per access permissions
+ *  <p>The request is denied because of missing access permissions.</p>
  *
  * @throws {@link ConflictException} (client fault)
- *  This exception is thrown when there is a conflict performing an operation
+ *  <p>There was a conflict performing an operation.</p>
  *
  * @throws {@link InternalServerException} (server fault)
- *  This exception is thrown if there was an unexpected error during processing of request
+ *  <p>An internal server error occurred. Retry your request.</p>
  *
  * @throws {@link ResourceNotFoundException} (client fault)
- *  This exception is thrown when a resource referenced by the operation does not exist
+ *  <p>The specified resource ARN was not found. Check the ARN and try your request again.</p>
  *
  * @throws {@link ServiceQuotaExceededException} (client fault)
- *  This exception is thrown when a request is made beyond the service quota
+ *  <p>The number of requests exceeds the service quota. Resubmit your request later.</p>
  *
  * @throws {@link ThrottlingException} (client fault)
- *  This exception is thrown when the number of requests exceeds the limit
+ *  <p>The number of requests exceeds the limit. Resubmit your request later.</p>
  *
  * @throws {@link ValidationException} (client fault)
- *  This exception is thrown when the request's input validation fails
+ *  <p>Input validation failed. Check your request parameters and retry the request.</p>
  *
  * @throws {@link BedrockAgentServiceException}
  * <p>Base exception class for all service exceptions from BedrockAgent service.</p>
diff --git a/clients/client-bedrock-agent/src/commands/CreateAgentCommand.ts b/clients/client-bedrock-agent/src/commands/CreateAgentCommand.ts
index 12e9c2789607..a65e166dea86 100644
--- a/clients/client-bedrock-agent/src/commands/CreateAgentCommand.ts
+++ b/clients/client-bedrock-agent/src/commands/CreateAgentCommand.ts
@@ -32,7 +32,30 @@ export interface CreateAgentCommandInput extends CreateAgentRequest {}
 export interface CreateAgentCommandOutput extends CreateAgentResponse, __MetadataBearer {}
 
 /**
- * Creates an Amazon Bedrock Agent
+ * <p>Creates an agent that orchestrates interactions between foundation models, data sources, software applications, user conversations, and APIs to carry out tasks to help customers.</p>
+ *          <ul>
+ *             <li>
+ *                <p>Specify the following fields for security purposes.</p>
+ *                <ul>
+ *                   <li>
+ *                      <p>
+ *                         <code>agentResourceRoleArn</code> – The ARN of the role with permissions to create an agent.</p>
+ *                   </li>
+ *                   <li>
+ *                      <p>(Optional) <code>customerEncryptionKeyArn</code> – The ARN of a KMS key to encrypt the creation of the agent.</p>
+ *                   </li>
+ *                   <li>
+ *                      <p>(Optional) <code>idleSessionTTLinSeconds</code> – Specify the number of seconds for which the agent should maintain session information. After this time expires, the subsequent <code>InvokeAgent</code> request begins a new session.</p>
+ *                   </li>
+ *                </ul>
+ *             </li>
+ *             <li>
+ *                <p>To override the default prompt behavior for agent orchestration and to use advanced prompts, include a <code>promptOverrideConfiguration</code> object. For more information, see <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/advanced-prompts.html">Advanced prompts</a>.</p>
+ *             </li>
+ *             <li>
+ *                <p>If you agent fails to be created, the response returns a list of <code>failureReasons</code> alongside a list of <code>recommendedActions</code> for you to troubleshoot.</p>
+ *             </li>
+ *          </ul>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
@@ -131,22 +154,22 @@ export interface CreateAgentCommandOutput extends CreateAgentResponse, __Metadat
  * @see {@link BedrockAgentClientResolvedConfig | config} for BedrockAgentClient's `config` shape.
  *
  * @throws {@link AccessDeniedException} (client fault)
- *  This exception is thrown when a request is denied per access permissions
+ *  <p>The request is denied because of missing access permissions.</p>
  *
  * @throws {@link ConflictException} (client fault)
- *  This exception is thrown when there is a conflict performing an operation
+ *  <p>There was a conflict performing an operation.</p>
  *
  * @throws {@link InternalServerException} (server fault)
- *  This exception is thrown if there was an unexpected error during processing of request
+ *  <p>An internal server error occurred. Retry your request.</p>
  *
  * @throws {@link ServiceQuotaExceededException} (client fault)
- *  This exception is thrown when a request is made beyond the service quota
+ *  <p>The number of requests exceeds the service quota. Resubmit your request later.</p>
  *
  * @throws {@link ThrottlingException} (client fault)
- *  This exception is thrown when the number of requests exceeds the limit
+ *  <p>The number of requests exceeds the limit. Resubmit your request later.</p>
  *
  * @throws {@link ValidationException} (client fault)
- *  This exception is thrown when the request's input validation fails
+ *  <p>Input validation failed. Check your request parameters and retry the request.</p>
  *
  * @throws {@link BedrockAgentServiceException}
  * <p>Base exception class for all service exceptions from BedrockAgent service.</p>
diff --git a/clients/client-bedrock-agent/src/commands/CreateDataSourceCommand.ts b/clients/client-bedrock-agent/src/commands/CreateDataSourceCommand.ts
index cc258d8d48af..dd0b50bfb62f 100644
--- a/clients/client-bedrock-agent/src/commands/CreateDataSourceCommand.ts
+++ b/clients/client-bedrock-agent/src/commands/CreateDataSourceCommand.ts
@@ -27,7 +27,10 @@ export interface CreateDataSourceCommandInput extends CreateDataSourceRequest {}
 export interface CreateDataSourceCommandOutput extends CreateDataSourceResponse, __MetadataBearer {}
 
 /**
- * Create a new data source
+ * <p>Sets up a data source to be added to a knowledge base.</p>
+ *          <important>
+ *             <p>You can't change the <code>chunkingConfiguration</code> after you create the data source.</p>
+ *          </important>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
@@ -105,25 +108,25 @@ export interface CreateDataSourceCommandOutput extends CreateDataSourceResponse,
  * @see {@link BedrockAgentClientResolvedConfig | config} for BedrockAgentClient's `config` shape.
  *
  * @throws {@link AccessDeniedException} (client fault)
- *  This exception is thrown when a request is denied per access permissions
+ *  <p>The request is denied because of missing access permissions.</p>
  *
  * @throws {@link ConflictException} (client fault)
- *  This exception is thrown when there is a conflict performing an operation
+ *  <p>There was a conflict performing an operation.</p>
  *
  * @throws {@link InternalServerException} (server fault)
- *  This exception is thrown if there was an unexpected error during processing of request
+ *  <p>An internal server error occurred. Retry your request.</p>
  *
  * @throws {@link ResourceNotFoundException} (client fault)
- *  This exception is thrown when a resource referenced by the operation does not exist
+ *  <p>The specified resource ARN was not found. Check the ARN and try your request again.</p>
  *
  * @throws {@link ServiceQuotaExceededException} (client fault)
- *  This exception is thrown when a request is made beyond the service quota
+ *  <p>The number of requests exceeds the service quota. Resubmit your request later.</p>
  *
  * @throws {@link ThrottlingException} (client fault)
- *  This exception is thrown when the number of requests exceeds the limit
+ *  <p>The number of requests exceeds the limit. Resubmit your request later.</p>
  *
  * @throws {@link ValidationException} (client fault)
- *  This exception is thrown when the request's input validation fails
+ *  <p>Input validation failed. Check your request parameters and retry the request.</p>
  *
  * @throws {@link BedrockAgentServiceException}
  * <p>Base exception class for all service exceptions from BedrockAgent service.</p>
diff --git a/clients/client-bedrock-agent/src/commands/CreateKnowledgeBaseCommand.ts b/clients/client-bedrock-agent/src/commands/CreateKnowledgeBaseCommand.ts
index f8c6db41f2c5..63915cce534e 100644
--- a/clients/client-bedrock-agent/src/commands/CreateKnowledgeBaseCommand.ts
+++ b/clients/client-bedrock-agent/src/commands/CreateKnowledgeBaseCommand.ts
@@ -27,7 +27,38 @@ export interface CreateKnowledgeBaseCommandInput extends CreateKnowledgeBaseRequ
 export interface CreateKnowledgeBaseCommandOutput extends CreateKnowledgeBaseResponse, __MetadataBearer {}
 
 /**
- * Create a new knowledge base
+ * <p>Creates a knowledge base that contains data sources from which information can be queried and used by LLMs. To create a knowledge base, you must first set up your data sources and configure a supported vector store. For more information, see <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/knowledge-base-setup.html">Set up your data for ingestion</a>.</p>
+ *          <note>
+ *             <p>If you prefer to let Amazon Bedrock create and manage a vector store for you in Amazon OpenSearch Service, use the console. For more information, see <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/knowledge-base-create">Create a knowledge base</a>.</p>
+ *          </note>
+ *          <ul>
+ *             <li>
+ *                <p>Provide the <code>name</code> and an optional <code>description</code>.</p>
+ *             </li>
+ *             <li>
+ *                <p>Provide the ARN with permissions to create a knowledge base in the <code>roleArn</code> field.</p>
+ *             </li>
+ *             <li>
+ *                <p>Provide the embedding model to use in the <code>embeddingModelArn</code> field in the <code>knowledgeBaseConfiguration</code> object.</p>
+ *             </li>
+ *             <li>
+ *                <p>Provide the configuration for your vector store in the <code>storageConfiguration</code> object.</p>
+ *                <ul>
+ *                   <li>
+ *                      <p>For an Amazon OpenSearch Service database, use the <code>opensearchServerlessConfiguration</code> object. For more information, see <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/knowledge-base-setup-oss.html">Create a vector store in Amazon OpenSearch Service</a>.</p>
+ *                   </li>
+ *                   <li>
+ *                      <p>For an Amazon Aurora database, use the <code>RdsConfiguration</code> object. For more information, see <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/knowledge-base-setup-rds.html">Create a vector store in Amazon Aurora</a>.</p>
+ *                   </li>
+ *                   <li>
+ *                      <p>For a Pinecone database, use the <code>pineconeConfiguration</code> object. For more information, see <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/knowledge-base-setup-pinecone.html">Create a vector store in Pinecone</a>.</p>
+ *                   </li>
+ *                   <li>
+ *                      <p>For a Redis Enterprise Cloud database, use the <code>redisEnterpriseCloudConfiguration</code> object. For more information, see <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/knowledge-base-setup-redis.html">Create a vector store in Redis Enterprise Cloud</a>.</p>
+ *                   </li>
+ *                </ul>
+ *             </li>
+ *          </ul>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
@@ -168,22 +199,22 @@ export interface CreateKnowledgeBaseCommandOutput extends CreateKnowledgeBaseRes
  * @see {@link BedrockAgentClientResolvedConfig | config} for BedrockAgentClient's `config` shape.
  *
  * @throws {@link AccessDeniedException} (client fault)
- *  This exception is thrown when a request is denied per access permissions
+ *  <p>The request is denied because of missing access permissions.</p>
  *
  * @throws {@link ConflictException} (client fault)
- *  This exception is thrown when there is a conflict performing an operation
+ *  <p>There was a conflict performing an operation.</p>
  *
  * @throws {@link InternalServerException} (server fault)
- *  This exception is thrown if there was an unexpected error during processing of request
+ *  <p>An internal server error occurred. Retry your request.</p>
  *
  * @throws {@link ServiceQuotaExceededException} (client fault)
- *  This exception is thrown when a request is made beyond the service quota
+ *  <p>The number of requests exceeds the service quota. Resubmit your request later.</p>
  *
  * @throws {@link ThrottlingException} (client fault)
- *  This exception is thrown when the number of requests exceeds the limit
+ *  <p>The number of requests exceeds the limit. Resubmit your request later.</p>
  *
  * @throws {@link ValidationException} (client fault)
- *  This exception is thrown when the request's input validation fails
+ *  <p>Input validation failed. Check your request parameters and retry the request.</p>
  *
  * @throws {@link BedrockAgentServiceException}
  * <p>Base exception class for all service exceptions from BedrockAgent service.</p>
diff --git a/clients/client-bedrock-agent/src/commands/DeleteAgentActionGroupCommand.ts b/clients/client-bedrock-agent/src/commands/DeleteAgentActionGroupCommand.ts
index 685146c9590a..3cfa3e42c432 100644
--- a/clients/client-bedrock-agent/src/commands/DeleteAgentActionGroupCommand.ts
+++ b/clients/client-bedrock-agent/src/commands/DeleteAgentActionGroupCommand.ts
@@ -27,7 +27,7 @@ export interface DeleteAgentActionGroupCommandInput extends DeleteAgentActionGro
 export interface DeleteAgentActionGroupCommandOutput extends DeleteAgentActionGroupResponse, __MetadataBearer {}
 
 /**
- * Deletes an Action Group for existing Amazon Bedrock Agent.
+ * <p>Deletes an action group in an agent.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
@@ -53,22 +53,22 @@ export interface DeleteAgentActionGroupCommandOutput extends DeleteAgentActionGr
  * @see {@link BedrockAgentClientResolvedConfig | config} for BedrockAgentClient's `config` shape.
  *
  * @throws {@link AccessDeniedException} (client fault)
- *  This exception is thrown when a request is denied per access permissions
+ *  <p>The request is denied because of missing access permissions.</p>
  *
  * @throws {@link ConflictException} (client fault)
- *  This exception is thrown when there is a conflict performing an operation
+ *  <p>There was a conflict performing an operation.</p>
  *
  * @throws {@link InternalServerException} (server fault)
- *  This exception is thrown if there was an unexpected error during processing of request
+ *  <p>An internal server error occurred. Retry your request.</p>
  *
  * @throws {@link ResourceNotFoundException} (client fault)
- *  This exception is thrown when a resource referenced by the operation does not exist
+ *  <p>The specified resource ARN was not found. Check the ARN and try your request again.</p>
  *
  * @throws {@link ThrottlingException} (client fault)
- *  This exception is thrown when the number of requests exceeds the limit
+ *  <p>The number of requests exceeds the limit. Resubmit your request later.</p>
  *
  * @throws {@link ValidationException} (client fault)
- *  This exception is thrown when the request's input validation fails
+ *  <p>Input validation failed. Check your request parameters and retry the request.</p>
  *
  * @throws {@link BedrockAgentServiceException}
  * <p>Base exception class for all service exceptions from BedrockAgent service.</p>
diff --git a/clients/client-bedrock-agent/src/commands/DeleteAgentAliasCommand.ts b/clients/client-bedrock-agent/src/commands/DeleteAgentAliasCommand.ts
index 6e674cddd121..869b4fd19c7c 100644
--- a/clients/client-bedrock-agent/src/commands/DeleteAgentAliasCommand.ts
+++ b/clients/client-bedrock-agent/src/commands/DeleteAgentAliasCommand.ts
@@ -27,7 +27,7 @@ export interface DeleteAgentAliasCommandInput extends DeleteAgentAliasRequest {}
 export interface DeleteAgentAliasCommandOutput extends DeleteAgentAliasResponse, __MetadataBearer {}
 
 /**
- * Deletes an Alias for a Amazon Bedrock Agent
+ * <p>Deletes an alias of an agent.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
@@ -55,19 +55,19 @@ export interface DeleteAgentAliasCommandOutput extends DeleteAgentAliasResponse,
  * @see {@link BedrockAgentClientResolvedConfig | config} for BedrockAgentClient's `config` shape.
  *
  * @throws {@link AccessDeniedException} (client fault)
- *  This exception is thrown when a request is denied per access permissions
+ *  <p>The request is denied because of missing access permissions.</p>
  *
  * @throws {@link InternalServerException} (server fault)
- *  This exception is thrown if there was an unexpected error during processing of request
+ *  <p>An internal server error occurred. Retry your request.</p>
  *
  * @throws {@link ResourceNotFoundException} (client fault)
- *  This exception is thrown when a resource referenced by the operation does not exist
+ *  <p>The specified resource ARN was not found. Check the ARN and try your request again.</p>
  *
  * @throws {@link ThrottlingException} (client fault)
- *  This exception is thrown when the number of requests exceeds the limit
+ *  <p>The number of requests exceeds the limit. Resubmit your request later.</p>
  *
  * @throws {@link ValidationException} (client fault)
- *  This exception is thrown when the request's input validation fails
+ *  <p>Input validation failed. Check your request parameters and retry the request.</p>
  *
  * @throws {@link BedrockAgentServiceException}
  * <p>Base exception class for all service exceptions from BedrockAgent service.</p>
diff --git a/clients/client-bedrock-agent/src/commands/DeleteAgentCommand.ts b/clients/client-bedrock-agent/src/commands/DeleteAgentCommand.ts
index a2e60adf9bd9..7c48eef8c42d 100644
--- a/clients/client-bedrock-agent/src/commands/DeleteAgentCommand.ts
+++ b/clients/client-bedrock-agent/src/commands/DeleteAgentCommand.ts
@@ -27,7 +27,7 @@ export interface DeleteAgentCommandInput extends DeleteAgentRequest {}
 export interface DeleteAgentCommandOutput extends DeleteAgentResponse, __MetadataBearer {}
 
 /**
- * Deletes an Agent for existing Amazon Bedrock Agent
+ * <p>Deletes an agent.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
@@ -54,22 +54,22 @@ export interface DeleteAgentCommandOutput extends DeleteAgentResponse, __Metadat
  * @see {@link BedrockAgentClientResolvedConfig | config} for BedrockAgentClient's `config` shape.
  *
  * @throws {@link AccessDeniedException} (client fault)
- *  This exception is thrown when a request is denied per access permissions
+ *  <p>The request is denied because of missing access permissions.</p>
  *
  * @throws {@link ConflictException} (client fault)
- *  This exception is thrown when there is a conflict performing an operation
+ *  <p>There was a conflict performing an operation.</p>
  *
  * @throws {@link InternalServerException} (server fault)
- *  This exception is thrown if there was an unexpected error during processing of request
+ *  <p>An internal server error occurred. Retry your request.</p>
  *
  * @throws {@link ResourceNotFoundException} (client fault)
- *  This exception is thrown when a resource referenced by the operation does not exist
+ *  <p>The specified resource ARN was not found. Check the ARN and try your request again.</p>
  *
  * @throws {@link ThrottlingException} (client fault)
- *  This exception is thrown when the number of requests exceeds the limit
+ *  <p>The number of requests exceeds the limit. Resubmit your request later.</p>
  *
  * @throws {@link ValidationException} (client fault)
- *  This exception is thrown when the request's input validation fails
+ *  <p>Input validation failed. Check your request parameters and retry the request.</p>
  *
  * @throws {@link BedrockAgentServiceException}
  * <p>Base exception class for all service exceptions from BedrockAgent service.</p>
diff --git a/clients/client-bedrock-agent/src/commands/DeleteAgentVersionCommand.ts b/clients/client-bedrock-agent/src/commands/DeleteAgentVersionCommand.ts
index 6ee9044a157d..77767c4d64be 100644
--- a/clients/client-bedrock-agent/src/commands/DeleteAgentVersionCommand.ts
+++ b/clients/client-bedrock-agent/src/commands/DeleteAgentVersionCommand.ts
@@ -27,7 +27,7 @@ export interface DeleteAgentVersionCommandInput extends DeleteAgentVersionReques
 export interface DeleteAgentVersionCommandOutput extends DeleteAgentVersionResponse, __MetadataBearer {}
 
 /**
- * Deletes an Agent version for existing Amazon Bedrock Agent
+ * <p>Deletes a version of an agent.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
@@ -56,22 +56,22 @@ export interface DeleteAgentVersionCommandOutput extends DeleteAgentVersionRespo
  * @see {@link BedrockAgentClientResolvedConfig | config} for BedrockAgentClient's `config` shape.
  *
  * @throws {@link AccessDeniedException} (client fault)
- *  This exception is thrown when a request is denied per access permissions
+ *  <p>The request is denied because of missing access permissions.</p>
  *
  * @throws {@link ConflictException} (client fault)
- *  This exception is thrown when there is a conflict performing an operation
+ *  <p>There was a conflict performing an operation.</p>
  *
  * @throws {@link InternalServerException} (server fault)
- *  This exception is thrown if there was an unexpected error during processing of request
+ *  <p>An internal server error occurred. Retry your request.</p>
  *
  * @throws {@link ResourceNotFoundException} (client fault)
- *  This exception is thrown when a resource referenced by the operation does not exist
+ *  <p>The specified resource ARN was not found. Check the ARN and try your request again.</p>
  *
  * @throws {@link ThrottlingException} (client fault)
- *  This exception is thrown when the number of requests exceeds the limit
+ *  <p>The number of requests exceeds the limit. Resubmit your request later.</p>
  *
  * @throws {@link ValidationException} (client fault)
- *  This exception is thrown when the request's input validation fails
+ *  <p>Input validation failed. Check your request parameters and retry the request.</p>
  *
  * @throws {@link BedrockAgentServiceException}
  * <p>Base exception class for all service exceptions from BedrockAgent service.</p>
diff --git a/clients/client-bedrock-agent/src/commands/DeleteDataSourceCommand.ts b/clients/client-bedrock-agent/src/commands/DeleteDataSourceCommand.ts
index e346bb0f6b6f..6403fa8c3893 100644
--- a/clients/client-bedrock-agent/src/commands/DeleteDataSourceCommand.ts
+++ b/clients/client-bedrock-agent/src/commands/DeleteDataSourceCommand.ts
@@ -27,7 +27,7 @@ export interface DeleteDataSourceCommandInput extends DeleteDataSourceRequest {}
 export interface DeleteDataSourceCommandOutput extends DeleteDataSourceResponse, __MetadataBearer {}
 
 /**
- * Delete an existing data source
+ * <p>Deletes a data source from a knowledge base.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
@@ -55,22 +55,22 @@ export interface DeleteDataSourceCommandOutput extends DeleteDataSourceResponse,
  * @see {@link BedrockAgentClientResolvedConfig | config} for BedrockAgentClient's `config` shape.
  *
  * @throws {@link AccessDeniedException} (client fault)
- *  This exception is thrown when a request is denied per access permissions
+ *  <p>The request is denied because of missing access permissions.</p>
  *
  * @throws {@link ConflictException} (client fault)
- *  This exception is thrown when there is a conflict performing an operation
+ *  <p>There was a conflict performing an operation.</p>
  *
  * @throws {@link InternalServerException} (server fault)
- *  This exception is thrown if there was an unexpected error during processing of request
+ *  <p>An internal server error occurred. Retry your request.</p>
  *
  * @throws {@link ResourceNotFoundException} (client fault)
- *  This exception is thrown when a resource referenced by the operation does not exist
+ *  <p>The specified resource ARN was not found. Check the ARN and try your request again.</p>
  *
  * @throws {@link ThrottlingException} (client fault)
- *  This exception is thrown when the number of requests exceeds the limit
+ *  <p>The number of requests exceeds the limit. Resubmit your request later.</p>
  *
  * @throws {@link ValidationException} (client fault)
- *  This exception is thrown when the request's input validation fails
+ *  <p>Input validation failed. Check your request parameters and retry the request.</p>
  *
  * @throws {@link BedrockAgentServiceException}
  * <p>Base exception class for all service exceptions from BedrockAgent service.</p>
diff --git a/clients/client-bedrock-agent/src/commands/DeleteKnowledgeBaseCommand.ts b/clients/client-bedrock-agent/src/commands/DeleteKnowledgeBaseCommand.ts
index 3b672df0b35f..3f689c9a10dc 100644
--- a/clients/client-bedrock-agent/src/commands/DeleteKnowledgeBaseCommand.ts
+++ b/clients/client-bedrock-agent/src/commands/DeleteKnowledgeBaseCommand.ts
@@ -27,7 +27,7 @@ export interface DeleteKnowledgeBaseCommandInput extends DeleteKnowledgeBaseRequ
 export interface DeleteKnowledgeBaseCommandOutput extends DeleteKnowledgeBaseResponse, __MetadataBearer {}
 
 /**
- * Delete an existing knowledge base
+ * <p>Deletes a knowledge base. Before deleting a knowledge base, you should disassociate the knowledge base from any agents that it is associated with by making a <a href="https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_DisassociateAgentKnowledgeBase.html">DisassociateAgentKnowledgeBase</a> request.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
@@ -53,22 +53,22 @@ export interface DeleteKnowledgeBaseCommandOutput extends DeleteKnowledgeBaseRes
  * @see {@link BedrockAgentClientResolvedConfig | config} for BedrockAgentClient's `config` shape.
  *
  * @throws {@link AccessDeniedException} (client fault)
- *  This exception is thrown when a request is denied per access permissions
+ *  <p>The request is denied because of missing access permissions.</p>
  *
  * @throws {@link ConflictException} (client fault)
- *  This exception is thrown when there is a conflict performing an operation
+ *  <p>There was a conflict performing an operation.</p>
  *
  * @throws {@link InternalServerException} (server fault)
- *  This exception is thrown if there was an unexpected error during processing of request
+ *  <p>An internal server error occurred. Retry your request.</p>
  *
  * @throws {@link ResourceNotFoundException} (client fault)
- *  This exception is thrown when a resource referenced by the operation does not exist
+ *  <p>The specified resource ARN was not found. Check the ARN and try your request again.</p>
  *
  * @throws {@link ThrottlingException} (client fault)
- *  This exception is thrown when the number of requests exceeds the limit
+ *  <p>The number of requests exceeds the limit. Resubmit your request later.</p>
  *
  * @throws {@link ValidationException} (client fault)
- *  This exception is thrown when the request's input validation fails
+ *  <p>Input validation failed. Check your request parameters and retry the request.</p>
  *
  * @throws {@link BedrockAgentServiceException}
  * <p>Base exception class for all service exceptions from BedrockAgent service.</p>
diff --git a/clients/client-bedrock-agent/src/commands/DisassociateAgentKnowledgeBaseCommand.ts b/clients/client-bedrock-agent/src/commands/DisassociateAgentKnowledgeBaseCommand.ts
index e9699351cc47..f00108e4162d 100644
--- a/clients/client-bedrock-agent/src/commands/DisassociateAgentKnowledgeBaseCommand.ts
+++ b/clients/client-bedrock-agent/src/commands/DisassociateAgentKnowledgeBaseCommand.ts
@@ -32,7 +32,7 @@ export interface DisassociateAgentKnowledgeBaseCommandOutput
     __MetadataBearer {}
 
 /**
- * Disassociate an existing Knowledge Base from an Amazon Bedrock Agent
+ * <p>Disassociates a knowledge base from an agent.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
@@ -57,22 +57,22 @@ export interface DisassociateAgentKnowledgeBaseCommandOutput
  * @see {@link BedrockAgentClientResolvedConfig | config} for BedrockAgentClient's `config` shape.
  *
  * @throws {@link AccessDeniedException} (client fault)
- *  This exception is thrown when a request is denied per access permissions
+ *  <p>The request is denied because of missing access permissions.</p>
  *
  * @throws {@link ConflictException} (client fault)
- *  This exception is thrown when there is a conflict performing an operation
+ *  <p>There was a conflict performing an operation.</p>
  *
  * @throws {@link InternalServerException} (server fault)
- *  This exception is thrown if there was an unexpected error during processing of request
+ *  <p>An internal server error occurred. Retry your request.</p>
  *
  * @throws {@link ResourceNotFoundException} (client fault)
- *  This exception is thrown when a resource referenced by the operation does not exist
+ *  <p>The specified resource ARN was not found. Check the ARN and try your request again.</p>
  *
  * @throws {@link ThrottlingException} (client fault)
- *  This exception is thrown when the number of requests exceeds the limit
+ *  <p>The number of requests exceeds the limit. Resubmit your request later.</p>
  *
  * @throws {@link ValidationException} (client fault)
- *  This exception is thrown when the request's input validation fails
+ *  <p>Input validation failed. Check your request parameters and retry the request.</p>
  *
  * @throws {@link BedrockAgentServiceException}
  * <p>Base exception class for all service exceptions from BedrockAgent service.</p>
diff --git a/clients/client-bedrock-agent/src/commands/GetAgentActionGroupCommand.ts b/clients/client-bedrock-agent/src/commands/GetAgentActionGroupCommand.ts
index 47315212b52a..695473dd3f67 100644
--- a/clients/client-bedrock-agent/src/commands/GetAgentActionGroupCommand.ts
+++ b/clients/client-bedrock-agent/src/commands/GetAgentActionGroupCommand.ts
@@ -31,7 +31,7 @@ export interface GetAgentActionGroupCommandInput extends GetAgentActionGroupRequ
 export interface GetAgentActionGroupCommandOutput extends GetAgentActionGroupResponse, __MetadataBearer {}
 
 /**
- * Gets an Action Group for existing Amazon Bedrock Agent Version
+ * <p>Gets information about an action group for an agent.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
@@ -79,19 +79,19 @@ export interface GetAgentActionGroupCommandOutput extends GetAgentActionGroupRes
  * @see {@link BedrockAgentClientResolvedConfig | config} for BedrockAgentClient's `config` shape.
  *
  * @throws {@link AccessDeniedException} (client fault)
- *  This exception is thrown when a request is denied per access permissions
+ *  <p>The request is denied because of missing access permissions.</p>
  *
  * @throws {@link InternalServerException} (server fault)
- *  This exception is thrown if there was an unexpected error during processing of request
+ *  <p>An internal server error occurred. Retry your request.</p>
  *
  * @throws {@link ResourceNotFoundException} (client fault)
- *  This exception is thrown when a resource referenced by the operation does not exist
+ *  <p>The specified resource ARN was not found. Check the ARN and try your request again.</p>
  *
  * @throws {@link ThrottlingException} (client fault)
- *  This exception is thrown when the number of requests exceeds the limit
+ *  <p>The number of requests exceeds the limit. Resubmit your request later.</p>
  *
  * @throws {@link ValidationException} (client fault)
- *  This exception is thrown when the request's input validation fails
+ *  <p>Input validation failed. Check your request parameters and retry the request.</p>
  *
  * @throws {@link BedrockAgentServiceException}
  * <p>Base exception class for all service exceptions from BedrockAgent service.</p>
diff --git a/clients/client-bedrock-agent/src/commands/GetAgentAliasCommand.ts b/clients/client-bedrock-agent/src/commands/GetAgentAliasCommand.ts
index 1b285bc127ad..a67d1c72979b 100644
--- a/clients/client-bedrock-agent/src/commands/GetAgentAliasCommand.ts
+++ b/clients/client-bedrock-agent/src/commands/GetAgentAliasCommand.ts
@@ -27,7 +27,7 @@ export interface GetAgentAliasCommandInput extends GetAgentAliasRequest {}
 export interface GetAgentAliasCommandOutput extends GetAgentAliasResponse, __MetadataBearer {}
 
 /**
- * Describes an Alias for a Amazon Bedrock Agent
+ * <p>Gets information about an alias of an agent.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
@@ -79,19 +79,19 @@ export interface GetAgentAliasCommandOutput extends GetAgentAliasResponse, __Met
  * @see {@link BedrockAgentClientResolvedConfig | config} for BedrockAgentClient's `config` shape.
  *
  * @throws {@link AccessDeniedException} (client fault)
- *  This exception is thrown when a request is denied per access permissions
+ *  <p>The request is denied because of missing access permissions.</p>
  *
  * @throws {@link InternalServerException} (server fault)
- *  This exception is thrown if there was an unexpected error during processing of request
+ *  <p>An internal server error occurred. Retry your request.</p>
  *
  * @throws {@link ResourceNotFoundException} (client fault)
- *  This exception is thrown when a resource referenced by the operation does not exist
+ *  <p>The specified resource ARN was not found. Check the ARN and try your request again.</p>
  *
  * @throws {@link ThrottlingException} (client fault)
- *  This exception is thrown when the number of requests exceeds the limit
+ *  <p>The number of requests exceeds the limit. Resubmit your request later.</p>
  *
  * @throws {@link ValidationException} (client fault)
- *  This exception is thrown when the request's input validation fails
+ *  <p>Input validation failed. Check your request parameters and retry the request.</p>
  *
  * @throws {@link BedrockAgentServiceException}
  * <p>Base exception class for all service exceptions from BedrockAgent service.</p>
diff --git a/clients/client-bedrock-agent/src/commands/GetAgentCommand.ts b/clients/client-bedrock-agent/src/commands/GetAgentCommand.ts
index 253671b705b4..f8c3316e8b27 100644
--- a/clients/client-bedrock-agent/src/commands/GetAgentCommand.ts
+++ b/clients/client-bedrock-agent/src/commands/GetAgentCommand.ts
@@ -27,7 +27,7 @@ export interface GetAgentCommandInput extends GetAgentRequest {}
 export interface GetAgentCommandOutput extends GetAgentResponse, __MetadataBearer {}
 
 /**
- * Gets an Agent for existing Amazon Bedrock Agent
+ * <p>Gets information about an agent.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
@@ -95,19 +95,19 @@ export interface GetAgentCommandOutput extends GetAgentResponse, __MetadataBeare
  * @see {@link BedrockAgentClientResolvedConfig | config} for BedrockAgentClient's `config` shape.
  *
  * @throws {@link AccessDeniedException} (client fault)
- *  This exception is thrown when a request is denied per access permissions
+ *  <p>The request is denied because of missing access permissions.</p>
  *
  * @throws {@link InternalServerException} (server fault)
- *  This exception is thrown if there was an unexpected error during processing of request
+ *  <p>An internal server error occurred. Retry your request.</p>
  *
  * @throws {@link ResourceNotFoundException} (client fault)
- *  This exception is thrown when a resource referenced by the operation does not exist
+ *  <p>The specified resource ARN was not found. Check the ARN and try your request again.</p>
  *
  * @throws {@link ThrottlingException} (client fault)
- *  This exception is thrown when the number of requests exceeds the limit
+ *  <p>The number of requests exceeds the limit. Resubmit your request later.</p>
  *
  * @throws {@link ValidationException} (client fault)
- *  This exception is thrown when the request's input validation fails
+ *  <p>Input validation failed. Check your request parameters and retry the request.</p>
  *
  * @throws {@link BedrockAgentServiceException}
  * <p>Base exception class for all service exceptions from BedrockAgent service.</p>
diff --git a/clients/client-bedrock-agent/src/commands/GetAgentKnowledgeBaseCommand.ts b/clients/client-bedrock-agent/src/commands/GetAgentKnowledgeBaseCommand.ts
index 6c54edc3cc80..16ae8de6a31e 100644
--- a/clients/client-bedrock-agent/src/commands/GetAgentKnowledgeBaseCommand.ts
+++ b/clients/client-bedrock-agent/src/commands/GetAgentKnowledgeBaseCommand.ts
@@ -27,7 +27,7 @@ export interface GetAgentKnowledgeBaseCommandInput extends GetAgentKnowledgeBase
 export interface GetAgentKnowledgeBaseCommandOutput extends GetAgentKnowledgeBaseResponse, __MetadataBearer {}
 
 /**
- * Gets a knowledge base associated to an existing Amazon Bedrock Agent Version
+ * <p>Gets information about a knowledge base associated with an agent.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
@@ -62,19 +62,19 @@ export interface GetAgentKnowledgeBaseCommandOutput extends GetAgentKnowledgeBas
  * @see {@link BedrockAgentClientResolvedConfig | config} for BedrockAgentClient's `config` shape.
  *
  * @throws {@link AccessDeniedException} (client fault)
- *  This exception is thrown when a request is denied per access permissions
+ *  <p>The request is denied because of missing access permissions.</p>
  *
  * @throws {@link InternalServerException} (server fault)
- *  This exception is thrown if there was an unexpected error during processing of request
+ *  <p>An internal server error occurred. Retry your request.</p>
  *
  * @throws {@link ResourceNotFoundException} (client fault)
- *  This exception is thrown when a resource referenced by the operation does not exist
+ *  <p>The specified resource ARN was not found. Check the ARN and try your request again.</p>
  *
  * @throws {@link ThrottlingException} (client fault)
- *  This exception is thrown when the number of requests exceeds the limit
+ *  <p>The number of requests exceeds the limit. Resubmit your request later.</p>
  *
  * @throws {@link ValidationException} (client fault)
- *  This exception is thrown when the request's input validation fails
+ *  <p>Input validation failed. Check your request parameters and retry the request.</p>
  *
  * @throws {@link BedrockAgentServiceException}
  * <p>Base exception class for all service exceptions from BedrockAgent service.</p>
diff --git a/clients/client-bedrock-agent/src/commands/GetAgentVersionCommand.ts b/clients/client-bedrock-agent/src/commands/GetAgentVersionCommand.ts
index 9542133e4462..3a0e40d4fe4a 100644
--- a/clients/client-bedrock-agent/src/commands/GetAgentVersionCommand.ts
+++ b/clients/client-bedrock-agent/src/commands/GetAgentVersionCommand.ts
@@ -31,7 +31,7 @@ export interface GetAgentVersionCommandInput extends GetAgentVersionRequest {}
 export interface GetAgentVersionCommandOutput extends GetAgentVersionResponse, __MetadataBearer {}
 
 /**
- * Gets an Agent version for existing Amazon Bedrock Agent
+ * <p>Gets details about a version of an agent.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
@@ -98,19 +98,19 @@ export interface GetAgentVersionCommandOutput extends GetAgentVersionResponse, _
  * @see {@link BedrockAgentClientResolvedConfig | config} for BedrockAgentClient's `config` shape.
  *
  * @throws {@link AccessDeniedException} (client fault)
- *  This exception is thrown when a request is denied per access permissions
+ *  <p>The request is denied because of missing access permissions.</p>
  *
  * @throws {@link InternalServerException} (server fault)
- *  This exception is thrown if there was an unexpected error during processing of request
+ *  <p>An internal server error occurred. Retry your request.</p>
  *
  * @throws {@link ResourceNotFoundException} (client fault)
- *  This exception is thrown when a resource referenced by the operation does not exist
+ *  <p>The specified resource ARN was not found. Check the ARN and try your request again.</p>
  *
  * @throws {@link ThrottlingException} (client fault)
- *  This exception is thrown when the number of requests exceeds the limit
+ *  <p>The number of requests exceeds the limit. Resubmit your request later.</p>
  *
  * @throws {@link ValidationException} (client fault)
- *  This exception is thrown when the request's input validation fails
+ *  <p>Input validation failed. Check your request parameters and retry the request.</p>
  *
  * @throws {@link BedrockAgentServiceException}
  * <p>Base exception class for all service exceptions from BedrockAgent service.</p>
diff --git a/clients/client-bedrock-agent/src/commands/GetDataSourceCommand.ts b/clients/client-bedrock-agent/src/commands/GetDataSourceCommand.ts
index 1066fa707479..eacfc40b7577 100644
--- a/clients/client-bedrock-agent/src/commands/GetDataSourceCommand.ts
+++ b/clients/client-bedrock-agent/src/commands/GetDataSourceCommand.ts
@@ -27,7 +27,7 @@ export interface GetDataSourceCommandInput extends GetDataSourceRequest {}
 export interface GetDataSourceCommandOutput extends GetDataSourceResponse, __MetadataBearer {}
 
 /**
- * Get an existing data source
+ * <p>Gets information about a data source.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
@@ -82,19 +82,19 @@ export interface GetDataSourceCommandOutput extends GetDataSourceResponse, __Met
  * @see {@link BedrockAgentClientResolvedConfig | config} for BedrockAgentClient's `config` shape.
  *
  * @throws {@link AccessDeniedException} (client fault)
- *  This exception is thrown when a request is denied per access permissions
+ *  <p>The request is denied because of missing access permissions.</p>
  *
  * @throws {@link InternalServerException} (server fault)
- *  This exception is thrown if there was an unexpected error during processing of request
+ *  <p>An internal server error occurred. Retry your request.</p>
  *
  * @throws {@link ResourceNotFoundException} (client fault)
- *  This exception is thrown when a resource referenced by the operation does not exist
+ *  <p>The specified resource ARN was not found. Check the ARN and try your request again.</p>
  *
  * @throws {@link ThrottlingException} (client fault)
- *  This exception is thrown when the number of requests exceeds the limit
+ *  <p>The number of requests exceeds the limit. Resubmit your request later.</p>
  *
  * @throws {@link ValidationException} (client fault)
- *  This exception is thrown when the request's input validation fails
+ *  <p>Input validation failed. Check your request parameters and retry the request.</p>
  *
  * @throws {@link BedrockAgentServiceException}
  * <p>Base exception class for all service exceptions from BedrockAgent service.</p>
diff --git a/clients/client-bedrock-agent/src/commands/GetIngestionJobCommand.ts b/clients/client-bedrock-agent/src/commands/GetIngestionJobCommand.ts
index f7fa7b14c533..8cd344e368df 100644
--- a/clients/client-bedrock-agent/src/commands/GetIngestionJobCommand.ts
+++ b/clients/client-bedrock-agent/src/commands/GetIngestionJobCommand.ts
@@ -27,7 +27,7 @@ export interface GetIngestionJobCommandInput extends GetIngestionJobRequest {}
 export interface GetIngestionJobCommandOutput extends GetIngestionJobResponse, __MetadataBearer {}
 
 /**
- * Get an ingestion job
+ * <p>Gets information about a ingestion job, in which a data source is added to a knowledge base.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
@@ -50,8 +50,10 @@ export interface GetIngestionJobCommandOutput extends GetIngestionJobResponse, _
  * //     status: "STARTING" || "IN_PROGRESS" || "COMPLETE" || "FAILED", // required
  * //     statistics: { // IngestionJobStatistics
  * //       numberOfDocumentsScanned: Number("long"),
+ * //       numberOfMetadataDocumentsScanned: Number("long"),
  * //       numberOfNewDocumentsIndexed: Number("long"),
  * //       numberOfModifiedDocumentsIndexed: Number("long"),
+ * //       numberOfMetadataDocumentsModified: Number("long"),
  * //       numberOfDocumentsDeleted: Number("long"),
  * //       numberOfDocumentsFailed: Number("long"),
  * //     },
@@ -72,19 +74,19 @@ export interface GetIngestionJobCommandOutput extends GetIngestionJobResponse, _
  * @see {@link BedrockAgentClientResolvedConfig | config} for BedrockAgentClient's `config` shape.
  *
  * @throws {@link AccessDeniedException} (client fault)
- *  This exception is thrown when a request is denied per access permissions
+ *  <p>The request is denied because of missing access permissions.</p>
  *
  * @throws {@link InternalServerException} (server fault)
- *  This exception is thrown if there was an unexpected error during processing of request
+ *  <p>An internal server error occurred. Retry your request.</p>
  *
  * @throws {@link ResourceNotFoundException} (client fault)
- *  This exception is thrown when a resource referenced by the operation does not exist
+ *  <p>The specified resource ARN was not found. Check the ARN and try your request again.</p>
  *
  * @throws {@link ThrottlingException} (client fault)
- *  This exception is thrown when the number of requests exceeds the limit
+ *  <p>The number of requests exceeds the limit. Resubmit your request later.</p>
  *
  * @throws {@link ValidationException} (client fault)
- *  This exception is thrown when the request's input validation fails
+ *  <p>Input validation failed. Check your request parameters and retry the request.</p>
  *
  * @throws {@link BedrockAgentServiceException}
  * <p>Base exception class for all service exceptions from BedrockAgent service.</p>
diff --git a/clients/client-bedrock-agent/src/commands/GetKnowledgeBaseCommand.ts b/clients/client-bedrock-agent/src/commands/GetKnowledgeBaseCommand.ts
index f32af63a54a3..f8c39eac7f93 100644
--- a/clients/client-bedrock-agent/src/commands/GetKnowledgeBaseCommand.ts
+++ b/clients/client-bedrock-agent/src/commands/GetKnowledgeBaseCommand.ts
@@ -27,7 +27,7 @@ export interface GetKnowledgeBaseCommandInput extends GetKnowledgeBaseRequest {}
 export interface GetKnowledgeBaseCommandOutput extends GetKnowledgeBaseResponse, __MetadataBearer {}
 
 /**
- * Get an existing knowledge base
+ * <p>Gets information about a knoweldge base.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
@@ -113,19 +113,19 @@ export interface GetKnowledgeBaseCommandOutput extends GetKnowledgeBaseResponse,
  * @see {@link BedrockAgentClientResolvedConfig | config} for BedrockAgentClient's `config` shape.
  *
  * @throws {@link AccessDeniedException} (client fault)
- *  This exception is thrown when a request is denied per access permissions
+ *  <p>The request is denied because of missing access permissions.</p>
  *
  * @throws {@link InternalServerException} (server fault)
- *  This exception is thrown if there was an unexpected error during processing of request
+ *  <p>An internal server error occurred. Retry your request.</p>
  *
  * @throws {@link ResourceNotFoundException} (client fault)
- *  This exception is thrown when a resource referenced by the operation does not exist
+ *  <p>The specified resource ARN was not found. Check the ARN and try your request again.</p>
  *
  * @throws {@link ThrottlingException} (client fault)
- *  This exception is thrown when the number of requests exceeds the limit
+ *  <p>The number of requests exceeds the limit. Resubmit your request later.</p>
  *
  * @throws {@link ValidationException} (client fault)
- *  This exception is thrown when the request's input validation fails
+ *  <p>Input validation failed. Check your request parameters and retry the request.</p>
  *
  * @throws {@link BedrockAgentServiceException}
  * <p>Base exception class for all service exceptions from BedrockAgent service.</p>
diff --git a/clients/client-bedrock-agent/src/commands/ListAgentActionGroupsCommand.ts b/clients/client-bedrock-agent/src/commands/ListAgentActionGroupsCommand.ts
index 5dc643aaf823..648e3eb6afb2 100644
--- a/clients/client-bedrock-agent/src/commands/ListAgentActionGroupsCommand.ts
+++ b/clients/client-bedrock-agent/src/commands/ListAgentActionGroupsCommand.ts
@@ -27,7 +27,7 @@ export interface ListAgentActionGroupsCommandInput extends ListAgentActionGroups
 export interface ListAgentActionGroupsCommandOutput extends ListAgentActionGroupsResponse, __MetadataBearer {}
 
 /**
- * Lists an Action Group for existing Amazon Bedrock Agent Version
+ * <p>Lists the action groups for an agent and information about each one.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
@@ -64,19 +64,19 @@ export interface ListAgentActionGroupsCommandOutput extends ListAgentActionGroup
  * @see {@link BedrockAgentClientResolvedConfig | config} for BedrockAgentClient's `config` shape.
  *
  * @throws {@link AccessDeniedException} (client fault)
- *  This exception is thrown when a request is denied per access permissions
+ *  <p>The request is denied because of missing access permissions.</p>
  *
  * @throws {@link InternalServerException} (server fault)
- *  This exception is thrown if there was an unexpected error during processing of request
+ *  <p>An internal server error occurred. Retry your request.</p>
  *
  * @throws {@link ResourceNotFoundException} (client fault)
- *  This exception is thrown when a resource referenced by the operation does not exist
+ *  <p>The specified resource ARN was not found. Check the ARN and try your request again.</p>
  *
  * @throws {@link ThrottlingException} (client fault)
- *  This exception is thrown when the number of requests exceeds the limit
+ *  <p>The number of requests exceeds the limit. Resubmit your request later.</p>
  *
  * @throws {@link ValidationException} (client fault)
- *  This exception is thrown when the request's input validation fails
+ *  <p>Input validation failed. Check your request parameters and retry the request.</p>
  *
  * @throws {@link BedrockAgentServiceException}
  * <p>Base exception class for all service exceptions from BedrockAgent service.</p>
diff --git a/clients/client-bedrock-agent/src/commands/ListAgentAliasesCommand.ts b/clients/client-bedrock-agent/src/commands/ListAgentAliasesCommand.ts
index c0be045e13c9..16d7729d6b54 100644
--- a/clients/client-bedrock-agent/src/commands/ListAgentAliasesCommand.ts
+++ b/clients/client-bedrock-agent/src/commands/ListAgentAliasesCommand.ts
@@ -27,7 +27,7 @@ export interface ListAgentAliasesCommandInput extends ListAgentAliasesRequest {}
 export interface ListAgentAliasesCommandOutput extends ListAgentAliasesResponse, __MetadataBearer {}
 
 /**
- * Lists all the Aliases for an Amazon Bedrock Agent
+ * <p>Lists the aliases of an agent and information about each one.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
@@ -69,19 +69,19 @@ export interface ListAgentAliasesCommandOutput extends ListAgentAliasesResponse,
  * @see {@link BedrockAgentClientResolvedConfig | config} for BedrockAgentClient's `config` shape.
  *
  * @throws {@link AccessDeniedException} (client fault)
- *  This exception is thrown when a request is denied per access permissions
+ *  <p>The request is denied because of missing access permissions.</p>
  *
  * @throws {@link InternalServerException} (server fault)
- *  This exception is thrown if there was an unexpected error during processing of request
+ *  <p>An internal server error occurred. Retry your request.</p>
  *
  * @throws {@link ResourceNotFoundException} (client fault)
- *  This exception is thrown when a resource referenced by the operation does not exist
+ *  <p>The specified resource ARN was not found. Check the ARN and try your request again.</p>
  *
  * @throws {@link ThrottlingException} (client fault)
- *  This exception is thrown when the number of requests exceeds the limit
+ *  <p>The number of requests exceeds the limit. Resubmit your request later.</p>
  *
  * @throws {@link ValidationException} (client fault)
- *  This exception is thrown when the request's input validation fails
+ *  <p>Input validation failed. Check your request parameters and retry the request.</p>
  *
  * @throws {@link BedrockAgentServiceException}
  * <p>Base exception class for all service exceptions from BedrockAgent service.</p>
diff --git a/clients/client-bedrock-agent/src/commands/ListAgentKnowledgeBasesCommand.ts b/clients/client-bedrock-agent/src/commands/ListAgentKnowledgeBasesCommand.ts
index 63be5fa4d300..9ea273df4fbe 100644
--- a/clients/client-bedrock-agent/src/commands/ListAgentKnowledgeBasesCommand.ts
+++ b/clients/client-bedrock-agent/src/commands/ListAgentKnowledgeBasesCommand.ts
@@ -27,7 +27,7 @@ export interface ListAgentKnowledgeBasesCommandInput extends ListAgentKnowledgeB
 export interface ListAgentKnowledgeBasesCommandOutput extends ListAgentKnowledgeBasesResponse, __MetadataBearer {}
 
 /**
- * List of Knowledge Bases associated to an existing Amazon Bedrock Agent Version
+ * <p>Lists knowledge bases associated with an agent and information about each one.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
@@ -63,19 +63,19 @@ export interface ListAgentKnowledgeBasesCommandOutput extends ListAgentKnowledge
  * @see {@link BedrockAgentClientResolvedConfig | config} for BedrockAgentClient's `config` shape.
  *
  * @throws {@link AccessDeniedException} (client fault)
- *  This exception is thrown when a request is denied per access permissions
+ *  <p>The request is denied because of missing access permissions.</p>
  *
  * @throws {@link InternalServerException} (server fault)
- *  This exception is thrown if there was an unexpected error during processing of request
+ *  <p>An internal server error occurred. Retry your request.</p>
  *
  * @throws {@link ResourceNotFoundException} (client fault)
- *  This exception is thrown when a resource referenced by the operation does not exist
+ *  <p>The specified resource ARN was not found. Check the ARN and try your request again.</p>
  *
  * @throws {@link ThrottlingException} (client fault)
- *  This exception is thrown when the number of requests exceeds the limit
+ *  <p>The number of requests exceeds the limit. Resubmit your request later.</p>
  *
  * @throws {@link ValidationException} (client fault)
- *  This exception is thrown when the request's input validation fails
+ *  <p>Input validation failed. Check your request parameters and retry the request.</p>
  *
  * @throws {@link BedrockAgentServiceException}
  * <p>Base exception class for all service exceptions from BedrockAgent service.</p>
diff --git a/clients/client-bedrock-agent/src/commands/ListAgentVersionsCommand.ts b/clients/client-bedrock-agent/src/commands/ListAgentVersionsCommand.ts
index 65816b4dd06e..12f1ea7456ad 100644
--- a/clients/client-bedrock-agent/src/commands/ListAgentVersionsCommand.ts
+++ b/clients/client-bedrock-agent/src/commands/ListAgentVersionsCommand.ts
@@ -27,7 +27,7 @@ export interface ListAgentVersionsCommandInput extends ListAgentVersionsRequest
 export interface ListAgentVersionsCommandOutput extends ListAgentVersionsResponse, __MetadataBearer {}
 
 /**
- * Lists Agent Versions
+ * <p>Lists the versions of an agent and information about each version.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
@@ -64,19 +64,19 @@ export interface ListAgentVersionsCommandOutput extends ListAgentVersionsRespons
  * @see {@link BedrockAgentClientResolvedConfig | config} for BedrockAgentClient's `config` shape.
  *
  * @throws {@link AccessDeniedException} (client fault)
- *  This exception is thrown when a request is denied per access permissions
+ *  <p>The request is denied because of missing access permissions.</p>
  *
  * @throws {@link InternalServerException} (server fault)
- *  This exception is thrown if there was an unexpected error during processing of request
+ *  <p>An internal server error occurred. Retry your request.</p>
  *
  * @throws {@link ResourceNotFoundException} (client fault)
- *  This exception is thrown when a resource referenced by the operation does not exist
+ *  <p>The specified resource ARN was not found. Check the ARN and try your request again.</p>
  *
  * @throws {@link ThrottlingException} (client fault)
- *  This exception is thrown when the number of requests exceeds the limit
+ *  <p>The number of requests exceeds the limit. Resubmit your request later.</p>
  *
  * @throws {@link ValidationException} (client fault)
- *  This exception is thrown when the request's input validation fails
+ *  <p>Input validation failed. Check your request parameters and retry the request.</p>
  *
  * @throws {@link BedrockAgentServiceException}
  * <p>Base exception class for all service exceptions from BedrockAgent service.</p>
diff --git a/clients/client-bedrock-agent/src/commands/ListAgentsCommand.ts b/clients/client-bedrock-agent/src/commands/ListAgentsCommand.ts
index 9e03d45bddfb..58a2843bac02 100644
--- a/clients/client-bedrock-agent/src/commands/ListAgentsCommand.ts
+++ b/clients/client-bedrock-agent/src/commands/ListAgentsCommand.ts
@@ -27,7 +27,7 @@ export interface ListAgentsCommandInput extends ListAgentsRequest {}
 export interface ListAgentsCommandOutput extends ListAgentsResponse, __MetadataBearer {}
 
 /**
- * Lists Agents
+ * <p>Lists the agents belonging to an account and information about each agent.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
@@ -63,16 +63,16 @@ export interface ListAgentsCommandOutput extends ListAgentsResponse, __MetadataB
  * @see {@link BedrockAgentClientResolvedConfig | config} for BedrockAgentClient's `config` shape.
  *
  * @throws {@link AccessDeniedException} (client fault)
- *  This exception is thrown when a request is denied per access permissions
+ *  <p>The request is denied because of missing access permissions.</p>
  *
  * @throws {@link InternalServerException} (server fault)
- *  This exception is thrown if there was an unexpected error during processing of request
+ *  <p>An internal server error occurred. Retry your request.</p>
  *
  * @throws {@link ThrottlingException} (client fault)
- *  This exception is thrown when the number of requests exceeds the limit
+ *  <p>The number of requests exceeds the limit. Resubmit your request later.</p>
  *
  * @throws {@link ValidationException} (client fault)
- *  This exception is thrown when the request's input validation fails
+ *  <p>Input validation failed. Check your request parameters and retry the request.</p>
  *
  * @throws {@link BedrockAgentServiceException}
  * <p>Base exception class for all service exceptions from BedrockAgent service.</p>
diff --git a/clients/client-bedrock-agent/src/commands/ListDataSourcesCommand.ts b/clients/client-bedrock-agent/src/commands/ListDataSourcesCommand.ts
index 3645a71c101f..bb842cc28773 100644
--- a/clients/client-bedrock-agent/src/commands/ListDataSourcesCommand.ts
+++ b/clients/client-bedrock-agent/src/commands/ListDataSourcesCommand.ts
@@ -27,7 +27,7 @@ export interface ListDataSourcesCommandInput extends ListDataSourcesRequest {}
 export interface ListDataSourcesCommandOutput extends ListDataSourcesResponse, __MetadataBearer {}
 
 /**
- * List data sources
+ * <p>Lists the data sources in a knowledge base and information about each one.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
@@ -64,19 +64,19 @@ export interface ListDataSourcesCommandOutput extends ListDataSourcesResponse, _
  * @see {@link BedrockAgentClientResolvedConfig | config} for BedrockAgentClient's `config` shape.
  *
  * @throws {@link AccessDeniedException} (client fault)
- *  This exception is thrown when a request is denied per access permissions
+ *  <p>The request is denied because of missing access permissions.</p>
  *
  * @throws {@link InternalServerException} (server fault)
- *  This exception is thrown if there was an unexpected error during processing of request
+ *  <p>An internal server error occurred. Retry your request.</p>
  *
  * @throws {@link ResourceNotFoundException} (client fault)
- *  This exception is thrown when a resource referenced by the operation does not exist
+ *  <p>The specified resource ARN was not found. Check the ARN and try your request again.</p>
  *
  * @throws {@link ThrottlingException} (client fault)
- *  This exception is thrown when the number of requests exceeds the limit
+ *  <p>The number of requests exceeds the limit. Resubmit your request later.</p>
  *
  * @throws {@link ValidationException} (client fault)
- *  This exception is thrown when the request's input validation fails
+ *  <p>Input validation failed. Check your request parameters and retry the request.</p>
  *
  * @throws {@link BedrockAgentServiceException}
  * <p>Base exception class for all service exceptions from BedrockAgent service.</p>
diff --git a/clients/client-bedrock-agent/src/commands/ListIngestionJobsCommand.ts b/clients/client-bedrock-agent/src/commands/ListIngestionJobsCommand.ts
index fff7173c965b..0756f5b1ac49 100644
--- a/clients/client-bedrock-agent/src/commands/ListIngestionJobsCommand.ts
+++ b/clients/client-bedrock-agent/src/commands/ListIngestionJobsCommand.ts
@@ -27,7 +27,7 @@ export interface ListIngestionJobsCommandInput extends ListIngestionJobsRequest
 export interface ListIngestionJobsCommandOutput extends ListIngestionJobsResponse, __MetadataBearer {}
 
 /**
- * List ingestion jobs
+ * <p>Lists the ingestion jobs for a data source and information about each of them.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
@@ -67,8 +67,10 @@ export interface ListIngestionJobsCommandOutput extends ListIngestionJobsRespons
  * //       updatedAt: new Date("TIMESTAMP"), // required
  * //       statistics: { // IngestionJobStatistics
  * //         numberOfDocumentsScanned: Number("long"),
+ * //         numberOfMetadataDocumentsScanned: Number("long"),
  * //         numberOfNewDocumentsIndexed: Number("long"),
  * //         numberOfModifiedDocumentsIndexed: Number("long"),
+ * //         numberOfMetadataDocumentsModified: Number("long"),
  * //         numberOfDocumentsDeleted: Number("long"),
  * //         numberOfDocumentsFailed: Number("long"),
  * //       },
@@ -86,19 +88,19 @@ export interface ListIngestionJobsCommandOutput extends ListIngestionJobsRespons
  * @see {@link BedrockAgentClientResolvedConfig | config} for BedrockAgentClient's `config` shape.
  *
  * @throws {@link AccessDeniedException} (client fault)
- *  This exception is thrown when a request is denied per access permissions
+ *  <p>The request is denied because of missing access permissions.</p>
  *
  * @throws {@link InternalServerException} (server fault)
- *  This exception is thrown if there was an unexpected error during processing of request
+ *  <p>An internal server error occurred. Retry your request.</p>
  *
  * @throws {@link ResourceNotFoundException} (client fault)
- *  This exception is thrown when a resource referenced by the operation does not exist
+ *  <p>The specified resource ARN was not found. Check the ARN and try your request again.</p>
  *
  * @throws {@link ThrottlingException} (client fault)
- *  This exception is thrown when the number of requests exceeds the limit
+ *  <p>The number of requests exceeds the limit. Resubmit your request later.</p>
  *
  * @throws {@link ValidationException} (client fault)
- *  This exception is thrown when the request's input validation fails
+ *  <p>Input validation failed. Check your request parameters and retry the request.</p>
  *
  * @throws {@link BedrockAgentServiceException}
  * <p>Base exception class for all service exceptions from BedrockAgent service.</p>
diff --git a/clients/client-bedrock-agent/src/commands/ListKnowledgeBasesCommand.ts b/clients/client-bedrock-agent/src/commands/ListKnowledgeBasesCommand.ts
index 6800ccbbd8d4..3d6a42766f43 100644
--- a/clients/client-bedrock-agent/src/commands/ListKnowledgeBasesCommand.ts
+++ b/clients/client-bedrock-agent/src/commands/ListKnowledgeBasesCommand.ts
@@ -27,7 +27,7 @@ export interface ListKnowledgeBasesCommandInput extends ListKnowledgeBasesReques
 export interface ListKnowledgeBasesCommandOutput extends ListKnowledgeBasesResponse, __MetadataBearer {}
 
 /**
- * List Knowledge Bases
+ * <p>Lists the knowledge bases in an account and information about each of them.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
@@ -62,16 +62,16 @@ export interface ListKnowledgeBasesCommandOutput extends ListKnowledgeBasesRespo
  * @see {@link BedrockAgentClientResolvedConfig | config} for BedrockAgentClient's `config` shape.
  *
  * @throws {@link AccessDeniedException} (client fault)
- *  This exception is thrown when a request is denied per access permissions
+ *  <p>The request is denied because of missing access permissions.</p>
  *
  * @throws {@link InternalServerException} (server fault)
- *  This exception is thrown if there was an unexpected error during processing of request
+ *  <p>An internal server error occurred. Retry your request.</p>
  *
  * @throws {@link ThrottlingException} (client fault)
- *  This exception is thrown when the number of requests exceeds the limit
+ *  <p>The number of requests exceeds the limit. Resubmit your request later.</p>
  *
  * @throws {@link ValidationException} (client fault)
- *  This exception is thrown when the request's input validation fails
+ *  <p>Input validation failed. Check your request parameters and retry the request.</p>
  *
  * @throws {@link BedrockAgentServiceException}
  * <p>Base exception class for all service exceptions from BedrockAgent service.</p>
diff --git a/clients/client-bedrock-agent/src/commands/ListTagsForResourceCommand.ts b/clients/client-bedrock-agent/src/commands/ListTagsForResourceCommand.ts
index 354c3770dcd4..086bc9959075 100644
--- a/clients/client-bedrock-agent/src/commands/ListTagsForResourceCommand.ts
+++ b/clients/client-bedrock-agent/src/commands/ListTagsForResourceCommand.ts
@@ -27,7 +27,7 @@ export interface ListTagsForResourceCommandInput extends ListTagsForResourceRequ
 export interface ListTagsForResourceCommandOutput extends ListTagsForResourceResponse, __MetadataBearer {}
 
 /**
- * List tags for a resource
+ * <p>List all the tags for the resource you specify.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
@@ -54,19 +54,19 @@ export interface ListTagsForResourceCommandOutput extends ListTagsForResourceRes
  * @see {@link BedrockAgentClientResolvedConfig | config} for BedrockAgentClient's `config` shape.
  *
  * @throws {@link AccessDeniedException} (client fault)
- *  This exception is thrown when a request is denied per access permissions
+ *  <p>The request is denied because of missing access permissions.</p>
  *
  * @throws {@link InternalServerException} (server fault)
- *  This exception is thrown if there was an unexpected error during processing of request
+ *  <p>An internal server error occurred. Retry your request.</p>
  *
  * @throws {@link ResourceNotFoundException} (client fault)
- *  This exception is thrown when a resource referenced by the operation does not exist
+ *  <p>The specified resource ARN was not found. Check the ARN and try your request again.</p>
  *
  * @throws {@link ThrottlingException} (client fault)
- *  This exception is thrown when the number of requests exceeds the limit
+ *  <p>The number of requests exceeds the limit. Resubmit your request later.</p>
  *
  * @throws {@link ValidationException} (client fault)
- *  This exception is thrown when the request's input validation fails
+ *  <p>Input validation failed. Check your request parameters and retry the request.</p>
  *
  * @throws {@link BedrockAgentServiceException}
  * <p>Base exception class for all service exceptions from BedrockAgent service.</p>
diff --git a/clients/client-bedrock-agent/src/commands/PrepareAgentCommand.ts b/clients/client-bedrock-agent/src/commands/PrepareAgentCommand.ts
index 5e16761fcda8..af29f62fbf22 100644
--- a/clients/client-bedrock-agent/src/commands/PrepareAgentCommand.ts
+++ b/clients/client-bedrock-agent/src/commands/PrepareAgentCommand.ts
@@ -27,7 +27,7 @@ export interface PrepareAgentCommandInput extends PrepareAgentRequest {}
 export interface PrepareAgentCommandOutput extends PrepareAgentResponse, __MetadataBearer {}
 
 /**
- * Prepares an existing Amazon Bedrock Agent to receive runtime requests
+ * <p>Creates a <code>DRAFT</code> version of the agent that can be used for internal testing.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
@@ -55,25 +55,25 @@ export interface PrepareAgentCommandOutput extends PrepareAgentResponse, __Metad
  * @see {@link BedrockAgentClientResolvedConfig | config} for BedrockAgentClient's `config` shape.
  *
  * @throws {@link AccessDeniedException} (client fault)
- *  This exception is thrown when a request is denied per access permissions
+ *  <p>The request is denied because of missing access permissions.</p>
  *
  * @throws {@link ConflictException} (client fault)
- *  This exception is thrown when there is a conflict performing an operation
+ *  <p>There was a conflict performing an operation.</p>
  *
  * @throws {@link InternalServerException} (server fault)
- *  This exception is thrown if there was an unexpected error during processing of request
+ *  <p>An internal server error occurred. Retry your request.</p>
  *
  * @throws {@link ResourceNotFoundException} (client fault)
- *  This exception is thrown when a resource referenced by the operation does not exist
+ *  <p>The specified resource ARN was not found. Check the ARN and try your request again.</p>
  *
  * @throws {@link ServiceQuotaExceededException} (client fault)
- *  This exception is thrown when a request is made beyond the service quota
+ *  <p>The number of requests exceeds the service quota. Resubmit your request later.</p>
  *
  * @throws {@link ThrottlingException} (client fault)
- *  This exception is thrown when the number of requests exceeds the limit
+ *  <p>The number of requests exceeds the limit. Resubmit your request later.</p>
  *
  * @throws {@link ValidationException} (client fault)
- *  This exception is thrown when the request's input validation fails
+ *  <p>Input validation failed. Check your request parameters and retry the request.</p>
  *
  * @throws {@link BedrockAgentServiceException}
  * <p>Base exception class for all service exceptions from BedrockAgent service.</p>
diff --git a/clients/client-bedrock-agent/src/commands/StartIngestionJobCommand.ts b/clients/client-bedrock-agent/src/commands/StartIngestionJobCommand.ts
index 9a3204aea058..a3a012db9af6 100644
--- a/clients/client-bedrock-agent/src/commands/StartIngestionJobCommand.ts
+++ b/clients/client-bedrock-agent/src/commands/StartIngestionJobCommand.ts
@@ -27,7 +27,7 @@ export interface StartIngestionJobCommandInput extends StartIngestionJobRequest
 export interface StartIngestionJobCommandOutput extends StartIngestionJobResponse, __MetadataBearer {}
 
 /**
- * Start a new ingestion job
+ * <p>Begins an ingestion job, in which a data source is added to a knowledge base.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
@@ -51,8 +51,10 @@ export interface StartIngestionJobCommandOutput extends StartIngestionJobRespons
  * //     status: "STARTING" || "IN_PROGRESS" || "COMPLETE" || "FAILED", // required
  * //     statistics: { // IngestionJobStatistics
  * //       numberOfDocumentsScanned: Number("long"),
+ * //       numberOfMetadataDocumentsScanned: Number("long"),
  * //       numberOfNewDocumentsIndexed: Number("long"),
  * //       numberOfModifiedDocumentsIndexed: Number("long"),
+ * //       numberOfMetadataDocumentsModified: Number("long"),
  * //       numberOfDocumentsDeleted: Number("long"),
  * //       numberOfDocumentsFailed: Number("long"),
  * //     },
@@ -73,25 +75,25 @@ export interface StartIngestionJobCommandOutput extends StartIngestionJobRespons
  * @see {@link BedrockAgentClientResolvedConfig | config} for BedrockAgentClient's `config` shape.
  *
  * @throws {@link AccessDeniedException} (client fault)
- *  This exception is thrown when a request is denied per access permissions
+ *  <p>The request is denied because of missing access permissions.</p>
  *
  * @throws {@link ConflictException} (client fault)
- *  This exception is thrown when there is a conflict performing an operation
+ *  <p>There was a conflict performing an operation.</p>
  *
  * @throws {@link InternalServerException} (server fault)
- *  This exception is thrown if there was an unexpected error during processing of request
+ *  <p>An internal server error occurred. Retry your request.</p>
  *
  * @throws {@link ResourceNotFoundException} (client fault)
- *  This exception is thrown when a resource referenced by the operation does not exist
+ *  <p>The specified resource ARN was not found. Check the ARN and try your request again.</p>
  *
  * @throws {@link ServiceQuotaExceededException} (client fault)
- *  This exception is thrown when a request is made beyond the service quota
+ *  <p>The number of requests exceeds the service quota. Resubmit your request later.</p>
  *
  * @throws {@link ThrottlingException} (client fault)
- *  This exception is thrown when the number of requests exceeds the limit
+ *  <p>The number of requests exceeds the limit. Resubmit your request later.</p>
  *
  * @throws {@link ValidationException} (client fault)
- *  This exception is thrown when the request's input validation fails
+ *  <p>Input validation failed. Check your request parameters and retry the request.</p>
  *
  * @throws {@link BedrockAgentServiceException}
  * <p>Base exception class for all service exceptions from BedrockAgent service.</p>
diff --git a/clients/client-bedrock-agent/src/commands/TagResourceCommand.ts b/clients/client-bedrock-agent/src/commands/TagResourceCommand.ts
index a3cd1661dfa7..bf37842e26f6 100644
--- a/clients/client-bedrock-agent/src/commands/TagResourceCommand.ts
+++ b/clients/client-bedrock-agent/src/commands/TagResourceCommand.ts
@@ -27,7 +27,7 @@ export interface TagResourceCommandInput extends TagResourceRequest {}
 export interface TagResourceCommandOutput extends TagResourceResponse, __MetadataBearer {}
 
 /**
- * Tag a resource
+ * <p>Associate tags with a resource. For more information, see  <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/what-is-service.html">Tagging resources</a> in the Amazon Bedrock User Guide.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
@@ -53,22 +53,22 @@ export interface TagResourceCommandOutput extends TagResourceResponse, __Metadat
  * @see {@link BedrockAgentClientResolvedConfig | config} for BedrockAgentClient's `config` shape.
  *
  * @throws {@link AccessDeniedException} (client fault)
- *  This exception is thrown when a request is denied per access permissions
+ *  <p>The request is denied because of missing access permissions.</p>
  *
  * @throws {@link InternalServerException} (server fault)
- *  This exception is thrown if there was an unexpected error during processing of request
+ *  <p>An internal server error occurred. Retry your request.</p>
  *
  * @throws {@link ResourceNotFoundException} (client fault)
- *  This exception is thrown when a resource referenced by the operation does not exist
+ *  <p>The specified resource ARN was not found. Check the ARN and try your request again.</p>
  *
  * @throws {@link ServiceQuotaExceededException} (client fault)
- *  This exception is thrown when a request is made beyond the service quota
+ *  <p>The number of requests exceeds the service quota. Resubmit your request later.</p>
  *
  * @throws {@link ThrottlingException} (client fault)
- *  This exception is thrown when the number of requests exceeds the limit
+ *  <p>The number of requests exceeds the limit. Resubmit your request later.</p>
  *
  * @throws {@link ValidationException} (client fault)
- *  This exception is thrown when the request's input validation fails
+ *  <p>Input validation failed. Check your request parameters and retry the request.</p>
  *
  * @throws {@link BedrockAgentServiceException}
  * <p>Base exception class for all service exceptions from BedrockAgent service.</p>
diff --git a/clients/client-bedrock-agent/src/commands/UntagResourceCommand.ts b/clients/client-bedrock-agent/src/commands/UntagResourceCommand.ts
index 9a52b6b62071..b52f7a2b1cdf 100644
--- a/clients/client-bedrock-agent/src/commands/UntagResourceCommand.ts
+++ b/clients/client-bedrock-agent/src/commands/UntagResourceCommand.ts
@@ -27,7 +27,7 @@ export interface UntagResourceCommandInput extends UntagResourceRequest {}
 export interface UntagResourceCommandOutput extends UntagResourceResponse, __MetadataBearer {}
 
 /**
- * Untag a resource
+ * <p>Remove tags from a resource.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
@@ -53,19 +53,19 @@ export interface UntagResourceCommandOutput extends UntagResourceResponse, __Met
  * @see {@link BedrockAgentClientResolvedConfig | config} for BedrockAgentClient's `config` shape.
  *
  * @throws {@link AccessDeniedException} (client fault)
- *  This exception is thrown when a request is denied per access permissions
+ *  <p>The request is denied because of missing access permissions.</p>
  *
  * @throws {@link InternalServerException} (server fault)
- *  This exception is thrown if there was an unexpected error during processing of request
+ *  <p>An internal server error occurred. Retry your request.</p>
  *
  * @throws {@link ResourceNotFoundException} (client fault)
- *  This exception is thrown when a resource referenced by the operation does not exist
+ *  <p>The specified resource ARN was not found. Check the ARN and try your request again.</p>
  *
  * @throws {@link ThrottlingException} (client fault)
- *  This exception is thrown when the number of requests exceeds the limit
+ *  <p>The number of requests exceeds the limit. Resubmit your request later.</p>
  *
  * @throws {@link ValidationException} (client fault)
- *  This exception is thrown when the request's input validation fails
+ *  <p>Input validation failed. Check your request parameters and retry the request.</p>
  *
  * @throws {@link BedrockAgentServiceException}
  * <p>Base exception class for all service exceptions from BedrockAgent service.</p>
diff --git a/clients/client-bedrock-agent/src/commands/UpdateAgentActionGroupCommand.ts b/clients/client-bedrock-agent/src/commands/UpdateAgentActionGroupCommand.ts
index 958b4cc1746b..e6b104ebeac3 100644
--- a/clients/client-bedrock-agent/src/commands/UpdateAgentActionGroupCommand.ts
+++ b/clients/client-bedrock-agent/src/commands/UpdateAgentActionGroupCommand.ts
@@ -32,7 +32,7 @@ export interface UpdateAgentActionGroupCommandInput extends UpdateAgentActionGro
 export interface UpdateAgentActionGroupCommandOutput extends UpdateAgentActionGroupResponse, __MetadataBearer {}
 
 /**
- * Updates an existing Action Group for Amazon Bedrock Agent
+ * <p>Updates the configuration for an action group for an agent.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
@@ -94,25 +94,25 @@ export interface UpdateAgentActionGroupCommandOutput extends UpdateAgentActionGr
  * @see {@link BedrockAgentClientResolvedConfig | config} for BedrockAgentClient's `config` shape.
  *
  * @throws {@link AccessDeniedException} (client fault)
- *  This exception is thrown when a request is denied per access permissions
+ *  <p>The request is denied because of missing access permissions.</p>
  *
  * @throws {@link ConflictException} (client fault)
- *  This exception is thrown when there is a conflict performing an operation
+ *  <p>There was a conflict performing an operation.</p>
  *
  * @throws {@link InternalServerException} (server fault)
- *  This exception is thrown if there was an unexpected error during processing of request
+ *  <p>An internal server error occurred. Retry your request.</p>
  *
  * @throws {@link ResourceNotFoundException} (client fault)
- *  This exception is thrown when a resource referenced by the operation does not exist
+ *  <p>The specified resource ARN was not found. Check the ARN and try your request again.</p>
  *
  * @throws {@link ServiceQuotaExceededException} (client fault)
- *  This exception is thrown when a request is made beyond the service quota
+ *  <p>The number of requests exceeds the service quota. Resubmit your request later.</p>
  *
  * @throws {@link ThrottlingException} (client fault)
- *  This exception is thrown when the number of requests exceeds the limit
+ *  <p>The number of requests exceeds the limit. Resubmit your request later.</p>
  *
  * @throws {@link ValidationException} (client fault)
- *  This exception is thrown when the request's input validation fails
+ *  <p>Input validation failed. Check your request parameters and retry the request.</p>
  *
  * @throws {@link BedrockAgentServiceException}
  * <p>Base exception class for all service exceptions from BedrockAgent service.</p>
diff --git a/clients/client-bedrock-agent/src/commands/UpdateAgentAliasCommand.ts b/clients/client-bedrock-agent/src/commands/UpdateAgentAliasCommand.ts
index 7b0601ec9953..8b041fe654e0 100644
--- a/clients/client-bedrock-agent/src/commands/UpdateAgentAliasCommand.ts
+++ b/clients/client-bedrock-agent/src/commands/UpdateAgentAliasCommand.ts
@@ -27,7 +27,7 @@ export interface UpdateAgentAliasCommandInput extends UpdateAgentAliasRequest {}
 export interface UpdateAgentAliasCommandOutput extends UpdateAgentAliasResponse, __MetadataBearer {}
 
 /**
- * Updates an existing Alias for an Amazon Bedrock Agent
+ * <p>Updates configurations for an alias of an agent.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
@@ -86,25 +86,25 @@ export interface UpdateAgentAliasCommandOutput extends UpdateAgentAliasResponse,
  * @see {@link BedrockAgentClientResolvedConfig | config} for BedrockAgentClient's `config` shape.
  *
  * @throws {@link AccessDeniedException} (client fault)
- *  This exception is thrown when a request is denied per access permissions
+ *  <p>The request is denied because of missing access permissions.</p>
  *
  * @throws {@link ConflictException} (client fault)
- *  This exception is thrown when there is a conflict performing an operation
+ *  <p>There was a conflict performing an operation.</p>
  *
  * @throws {@link InternalServerException} (server fault)
- *  This exception is thrown if there was an unexpected error during processing of request
+ *  <p>An internal server error occurred. Retry your request.</p>
  *
  * @throws {@link ResourceNotFoundException} (client fault)
- *  This exception is thrown when a resource referenced by the operation does not exist
+ *  <p>The specified resource ARN was not found. Check the ARN and try your request again.</p>
  *
  * @throws {@link ServiceQuotaExceededException} (client fault)
- *  This exception is thrown when a request is made beyond the service quota
+ *  <p>The number of requests exceeds the service quota. Resubmit your request later.</p>
  *
  * @throws {@link ThrottlingException} (client fault)
- *  This exception is thrown when the number of requests exceeds the limit
+ *  <p>The number of requests exceeds the limit. Resubmit your request later.</p>
  *
  * @throws {@link ValidationException} (client fault)
- *  This exception is thrown when the request's input validation fails
+ *  <p>Input validation failed. Check your request parameters and retry the request.</p>
  *
  * @throws {@link BedrockAgentServiceException}
  * <p>Base exception class for all service exceptions from BedrockAgent service.</p>
diff --git a/clients/client-bedrock-agent/src/commands/UpdateAgentCommand.ts b/clients/client-bedrock-agent/src/commands/UpdateAgentCommand.ts
index e2e33354a09a..b2832317604b 100644
--- a/clients/client-bedrock-agent/src/commands/UpdateAgentCommand.ts
+++ b/clients/client-bedrock-agent/src/commands/UpdateAgentCommand.ts
@@ -32,7 +32,7 @@ export interface UpdateAgentCommandInput extends UpdateAgentRequest {}
 export interface UpdateAgentCommandOutput extends UpdateAgentResponse, __MetadataBearer {}
 
 /**
- * Updates an existing Amazon Bedrock Agent
+ * <p>Updates the configuration of an agent.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
@@ -43,7 +43,7 @@ export interface UpdateAgentCommandOutput extends UpdateAgentResponse, __Metadat
  *   agentId: "STRING_VALUE", // required
  *   agentName: "STRING_VALUE", // required
  *   instruction: "STRING_VALUE",
- *   foundationModel: "STRING_VALUE",
+ *   foundationModel: "STRING_VALUE", // required
  *   description: "STRING_VALUE",
  *   idleSessionTTLInSeconds: Number("int"),
  *   agentResourceRoleArn: "STRING_VALUE", // required
@@ -128,25 +128,25 @@ export interface UpdateAgentCommandOutput extends UpdateAgentResponse, __Metadat
  * @see {@link BedrockAgentClientResolvedConfig | config} for BedrockAgentClient's `config` shape.
  *
  * @throws {@link AccessDeniedException} (client fault)
- *  This exception is thrown when a request is denied per access permissions
+ *  <p>The request is denied because of missing access permissions.</p>
  *
  * @throws {@link ConflictException} (client fault)
- *  This exception is thrown when there is a conflict performing an operation
+ *  <p>There was a conflict performing an operation.</p>
  *
  * @throws {@link InternalServerException} (server fault)
- *  This exception is thrown if there was an unexpected error during processing of request
+ *  <p>An internal server error occurred. Retry your request.</p>
  *
  * @throws {@link ResourceNotFoundException} (client fault)
- *  This exception is thrown when a resource referenced by the operation does not exist
+ *  <p>The specified resource ARN was not found. Check the ARN and try your request again.</p>
  *
  * @throws {@link ServiceQuotaExceededException} (client fault)
- *  This exception is thrown when a request is made beyond the service quota
+ *  <p>The number of requests exceeds the service quota. Resubmit your request later.</p>
  *
  * @throws {@link ThrottlingException} (client fault)
- *  This exception is thrown when the number of requests exceeds the limit
+ *  <p>The number of requests exceeds the limit. Resubmit your request later.</p>
  *
  * @throws {@link ValidationException} (client fault)
- *  This exception is thrown when the request's input validation fails
+ *  <p>Input validation failed. Check your request parameters and retry the request.</p>
  *
  * @throws {@link BedrockAgentServiceException}
  * <p>Base exception class for all service exceptions from BedrockAgent service.</p>
diff --git a/clients/client-bedrock-agent/src/commands/UpdateAgentKnowledgeBaseCommand.ts b/clients/client-bedrock-agent/src/commands/UpdateAgentKnowledgeBaseCommand.ts
index 05816ce771bc..8f523879ccda 100644
--- a/clients/client-bedrock-agent/src/commands/UpdateAgentKnowledgeBaseCommand.ts
+++ b/clients/client-bedrock-agent/src/commands/UpdateAgentKnowledgeBaseCommand.ts
@@ -27,7 +27,7 @@ export interface UpdateAgentKnowledgeBaseCommandInput extends UpdateAgentKnowled
 export interface UpdateAgentKnowledgeBaseCommandOutput extends UpdateAgentKnowledgeBaseResponse, __MetadataBearer {}
 
 /**
- * Updates an existing Knowledge Base associated to an Amazon Bedrock Agent
+ * <p>Updates the configuration for a knowledge base that has been associated with an agent.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
@@ -64,22 +64,22 @@ export interface UpdateAgentKnowledgeBaseCommandOutput extends UpdateAgentKnowle
  * @see {@link BedrockAgentClientResolvedConfig | config} for BedrockAgentClient's `config` shape.
  *
  * @throws {@link AccessDeniedException} (client fault)
- *  This exception is thrown when a request is denied per access permissions
+ *  <p>The request is denied because of missing access permissions.</p>
  *
  * @throws {@link ConflictException} (client fault)
- *  This exception is thrown when there is a conflict performing an operation
+ *  <p>There was a conflict performing an operation.</p>
  *
  * @throws {@link InternalServerException} (server fault)
- *  This exception is thrown if there was an unexpected error during processing of request
+ *  <p>An internal server error occurred. Retry your request.</p>
  *
  * @throws {@link ResourceNotFoundException} (client fault)
- *  This exception is thrown when a resource referenced by the operation does not exist
+ *  <p>The specified resource ARN was not found. Check the ARN and try your request again.</p>
  *
  * @throws {@link ThrottlingException} (client fault)
- *  This exception is thrown when the number of requests exceeds the limit
+ *  <p>The number of requests exceeds the limit. Resubmit your request later.</p>
  *
  * @throws {@link ValidationException} (client fault)
- *  This exception is thrown when the request's input validation fails
+ *  <p>Input validation failed. Check your request parameters and retry the request.</p>
  *
  * @throws {@link BedrockAgentServiceException}
  * <p>Base exception class for all service exceptions from BedrockAgent service.</p>
diff --git a/clients/client-bedrock-agent/src/commands/UpdateDataSourceCommand.ts b/clients/client-bedrock-agent/src/commands/UpdateDataSourceCommand.ts
index 7e9ae8830124..037cdbdf4e51 100644
--- a/clients/client-bedrock-agent/src/commands/UpdateDataSourceCommand.ts
+++ b/clients/client-bedrock-agent/src/commands/UpdateDataSourceCommand.ts
@@ -27,7 +27,10 @@ export interface UpdateDataSourceCommandInput extends UpdateDataSourceRequest {}
 export interface UpdateDataSourceCommandOutput extends UpdateDataSourceResponse, __MetadataBearer {}
 
 /**
- * Update an existing data source
+ * <p>Updates configurations for a data source.</p>
+ *          <important>
+ *             <p>You can't change the <code>chunkingConfiguration</code> after you create the data source. Specify the existing <code>chunkingConfiguration</code>.</p>
+ *          </important>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
@@ -105,22 +108,22 @@ export interface UpdateDataSourceCommandOutput extends UpdateDataSourceResponse,
  * @see {@link BedrockAgentClientResolvedConfig | config} for BedrockAgentClient's `config` shape.
  *
  * @throws {@link AccessDeniedException} (client fault)
- *  This exception is thrown when a request is denied per access permissions
+ *  <p>The request is denied because of missing access permissions.</p>
  *
  * @throws {@link ConflictException} (client fault)
- *  This exception is thrown when there is a conflict performing an operation
+ *  <p>There was a conflict performing an operation.</p>
  *
  * @throws {@link InternalServerException} (server fault)
- *  This exception is thrown if there was an unexpected error during processing of request
+ *  <p>An internal server error occurred. Retry your request.</p>
  *
  * @throws {@link ResourceNotFoundException} (client fault)
- *  This exception is thrown when a resource referenced by the operation does not exist
+ *  <p>The specified resource ARN was not found. Check the ARN and try your request again.</p>
  *
  * @throws {@link ThrottlingException} (client fault)
- *  This exception is thrown when the number of requests exceeds the limit
+ *  <p>The number of requests exceeds the limit. Resubmit your request later.</p>
  *
  * @throws {@link ValidationException} (client fault)
- *  This exception is thrown when the request's input validation fails
+ *  <p>Input validation failed. Check your request parameters and retry the request.</p>
  *
  * @throws {@link BedrockAgentServiceException}
  * <p>Base exception class for all service exceptions from BedrockAgent service.</p>
diff --git a/clients/client-bedrock-agent/src/commands/UpdateKnowledgeBaseCommand.ts b/clients/client-bedrock-agent/src/commands/UpdateKnowledgeBaseCommand.ts
index 920c1c7cd1ab..47dc9d932815 100644
--- a/clients/client-bedrock-agent/src/commands/UpdateKnowledgeBaseCommand.ts
+++ b/clients/client-bedrock-agent/src/commands/UpdateKnowledgeBaseCommand.ts
@@ -27,7 +27,26 @@ export interface UpdateKnowledgeBaseCommandInput extends UpdateKnowledgeBaseRequ
 export interface UpdateKnowledgeBaseCommandOutput extends UpdateKnowledgeBaseResponse, __MetadataBearer {}
 
 /**
- * Update an existing knowledge base
+ * <p>Updates the configuration of a knowledge base with the fields that you specify. Because all fields will be overwritten, you must include the same values for fields that you want to keep the same.</p>
+ *          <p>You can change the following fields:</p>
+ *          <ul>
+ *             <li>
+ *                <p>
+ *                   <code>name</code>
+ *                </p>
+ *             </li>
+ *             <li>
+ *                <p>
+ *                   <code>description</code>
+ *                </p>
+ *             </li>
+ *             <li>
+ *                <p>
+ *                   <code>roleArn</code>
+ *                </p>
+ *             </li>
+ *          </ul>
+ *          <p>You can't change the <code>knowledgeBaseConfiguration</code> or <code>storageConfiguration</code> fields, so you must specify the same configurations as when you created the knowledge base. You can send a <a href="https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_GetKnowledgeBase.html">GetKnowledgeBase</a> request and copy the same configurations.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
@@ -165,22 +184,22 @@ export interface UpdateKnowledgeBaseCommandOutput extends UpdateKnowledgeBaseRes
  * @see {@link BedrockAgentClientResolvedConfig | config} for BedrockAgentClient's `config` shape.
  *
  * @throws {@link AccessDeniedException} (client fault)
- *  This exception is thrown when a request is denied per access permissions
+ *  <p>The request is denied because of missing access permissions.</p>
  *
  * @throws {@link ConflictException} (client fault)
- *  This exception is thrown when there is a conflict performing an operation
+ *  <p>There was a conflict performing an operation.</p>
  *
  * @throws {@link InternalServerException} (server fault)
- *  This exception is thrown if there was an unexpected error during processing of request
+ *  <p>An internal server error occurred. Retry your request.</p>
  *
  * @throws {@link ResourceNotFoundException} (client fault)
- *  This exception is thrown when a resource referenced by the operation does not exist
+ *  <p>The specified resource ARN was not found. Check the ARN and try your request again.</p>
  *
  * @throws {@link ThrottlingException} (client fault)
- *  This exception is thrown when the number of requests exceeds the limit
+ *  <p>The number of requests exceeds the limit. Resubmit your request later.</p>
  *
  * @throws {@link ValidationException} (client fault)
- *  This exception is thrown when the request's input validation fails
+ *  <p>Input validation failed. Check your request parameters and retry the request.</p>
  *
  * @throws {@link BedrockAgentServiceException}
  * <p>Base exception class for all service exceptions from BedrockAgent service.</p>
diff --git a/clients/client-bedrock-agent/src/index.ts b/clients/client-bedrock-agent/src/index.ts
index ba688fd018f8..a48d21e7b629 100644
--- a/clients/client-bedrock-agent/src/index.ts
+++ b/clients/client-bedrock-agent/src/index.ts
@@ -1,8 +1,7 @@
 // smithy-typescript generated code
 /* eslint-disable */
 /**
- * An example service, deployed with the Octane Service creator,
- * which will echo the string
+ * <p>Describes the API operations for creating and managing Amazon Bedrock agents.</p>
  *
  * @packageDocumentation
  */
diff --git a/clients/client-bedrock-agent/src/models/models_0.ts b/clients/client-bedrock-agent/src/models/models_0.ts
index 938c6117b941..79e7a399fe77 100644
--- a/clients/client-bedrock-agent/src/models/models_0.ts
+++ b/clients/client-bedrock-agent/src/models/models_0.ts
@@ -4,7 +4,7 @@ import { ExceptionOptionType as __ExceptionOptionType, SENSITIVE_STRING } from "
 import { BedrockAgentServiceException as __BaseException } from "./BedrockAgentServiceException";
 
 /**
- * This exception is thrown when a request is denied per access permissions
+ * <p>The request is denied because of missing access permissions.</p>
  * @public
  */
 export class AccessDeniedException extends __BaseException {
@@ -24,7 +24,7 @@ export class AccessDeniedException extends __BaseException {
 }
 
 /**
- * Type of Executors for an Action Group
+ * <p>Contains details about the Lambda function containing the business logic that is carried out upon invoking the action.</p>
  * @public
  */
 export type ActionGroupExecutor = ActionGroupExecutor.LambdaMember | ActionGroupExecutor.$UnknownMember;
@@ -34,7 +34,7 @@ export type ActionGroupExecutor = ActionGroupExecutor.LambdaMember | ActionGroup
  */
 export namespace ActionGroupExecutor {
   /**
-   * ARN of a Lambda.
+   * <p>The ARN of the Lambda function containing the business logic that is carried out upon invoking the action.</p>
    * @public
    */
   export interface LambdaMember {
@@ -62,7 +62,7 @@ export namespace ActionGroupExecutor {
 }
 
 /**
- * This exception is thrown when there is a conflict performing an operation
+ * <p>There was a conflict performing an operation.</p>
  * @public
  */
 export class ConflictException extends __BaseException {
@@ -96,25 +96,25 @@ export const ActionGroupState = {
 export type ActionGroupState = (typeof ActionGroupState)[keyof typeof ActionGroupState];
 
 /**
- * The identifier for the S3 resource.
+ * <p>Contains information about the S3 object containing the resource.</p>
  * @public
  */
 export interface S3Identifier {
   /**
-   * A bucket in S3.
+   * <p>The name of the S3 bucket.</p>
    * @public
    */
   s3BucketName?: string;
 
   /**
-   * A object key in S3.
+   * <p>The S3 object key containing the resource.</p>
    * @public
    */
   s3ObjectKey?: string;
 }
 
 /**
- * Contains information about the API Schema for the Action Group
+ * <p>Contains details about the OpenAPI schema for the action group. For more information, see <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/agents-api-schema.html">Action group OpenAPI schemas</a>. You can either include the schema directly in the <code>payload</code> field or you can upload it to an S3 bucket and specify the S3 bucket location in the <code>s3</code> field.</p>
  * @public
  */
 export type APISchema = APISchema.PayloadMember | APISchema.S3Member | APISchema.$UnknownMember;
@@ -124,7 +124,7 @@ export type APISchema = APISchema.PayloadMember | APISchema.S3Member | APISchema
  */
 export namespace APISchema {
   /**
-   * The identifier for the S3 resource.
+   * <p>Contains details about the S3 object containing the OpenAPI schema for the action group. For more information, see <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/agents-api-schema.html">Action group OpenAPI schemas</a>.</p>
    * @public
    */
   export interface S3Member {
@@ -134,7 +134,7 @@ export namespace APISchema {
   }
 
   /**
-   * String OpenAPI Payload
+   * <p>The JSON or YAML-formatted payload defining the OpenAPI schema for the action group. For more information, see <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/agents-api-schema.html">Action group OpenAPI schemas</a>.</p>
    * @public
    */
   export interface PayloadMember {
@@ -179,157 +179,159 @@ export const ActionGroupSignature = {
 export type ActionGroupSignature = (typeof ActionGroupSignature)[keyof typeof ActionGroupSignature];
 
 /**
- * Create Action Group Request
  * @public
  */
 export interface CreateAgentActionGroupRequest {
   /**
-   * Id generated at the server side when an Agent is created
+   * <p>The unique identifier of the agent for which to create the action group.</p>
    * @public
    */
   agentId: string | undefined;
 
   /**
-   * Draft Version of the Agent.
+   * <p>The version of the agent for which to create the action group.</p>
    * @public
    */
   agentVersion: string | undefined;
 
   /**
-   * Name for a resource.
+   * <p>The name to give the action group.</p>
    * @public
    */
   actionGroupName: string | undefined;
 
   /**
-   * Client specified token used for idempotency checks
+   * <p>A unique, case-sensitive identifier to ensure that the API request completes no more than one time. If this token matches a previous request,
+   *       Amazon Bedrock ignores the request, but does not return an error. For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/APIReference/Run_Instance_Idempotency.html">Ensuring idempotency</a>.</p>
    * @public
    */
   clientToken?: string;
 
   /**
-   * Description of the Resource.
+   * <p>A description of the action group.</p>
    * @public
    */
   description?: string;
 
   /**
-   * Action Group Signature for a BuiltIn Action
+   * <p>To allow your agent to request the user for additional information when trying to complete a task, set this field to <code>AMAZON.UserInput</code>. You must leave the <code>description</code>, <code>apiSchema</code>, and <code>actionGroupExecutor</code> fields blank for this action group.</p>
+   *          <p>During orchestration, if your agent determines that it needs to invoke an API in an action group, but doesn't have enough information to complete the API request, it will invoke this action group instead and return an <a href="https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_Observation.html">Observation</a> reprompting the user for more information.</p>
    * @public
    */
   parentActionGroupSignature?: ActionGroupSignature;
 
   /**
-   * Type of Executors for an Action Group
+   * <p>The ARN of the Lambda function containing the business logic that is carried out upon invoking the action.</p>
    * @public
    */
   actionGroupExecutor?: ActionGroupExecutor;
 
   /**
-   * Contains information about the API Schema for the Action Group
+   * <p>Contains either details about the S3 object containing the OpenAPI schema for the action group or the JSON or YAML-formatted payload defining the schema. For more information, see <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/agents-api-schema.html">Action group OpenAPI schemas</a>.</p>
    * @public
    */
   apiSchema?: APISchema;
 
   /**
-   * State of the action group
+   * <p>Specifies whether the action group is available for the agent to invoke or not when sending an <a href="https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvokeAgent.html">InvokeAgent</a> request.</p>
    * @public
    */
   actionGroupState?: ActionGroupState;
 }
 
 /**
- * Contains the information of an Agent Action Group
+ * <p>Contains details about an action group.</p>
  * @public
  */
 export interface AgentActionGroup {
   /**
-   * Identifier for a resource.
+   * <p>The unique identifier of the agent to which the action group belongs.</p>
    * @public
    */
   agentId: string | undefined;
 
   /**
-   * Agent Version.
+   * <p>The version of the agent to which the action group belongs.</p>
    * @public
    */
   agentVersion: string | undefined;
 
   /**
-   * Identifier for a resource.
+   * <p>The unique identifier of the action group.</p>
    * @public
    */
   actionGroupId: string | undefined;
 
   /**
-   * Name for a resource.
+   * <p>The name of the action group.</p>
    * @public
    */
   actionGroupName: string | undefined;
 
   /**
-   * Client specified token used for idempotency checks
+   * <p>A unique, case-sensitive identifier to ensure that the API request completes no more than one time. If this token matches a previous request,
+   *       Amazon Bedrock ignores the request, but does not return an error. For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/APIReference/Run_Instance_Idempotency.html">Ensuring idempotency</a>.</p>
    * @public
    */
   clientToken?: string;
 
   /**
-   * Description of the Resource.
+   * <p>The description of the action group.</p>
    * @public
    */
   description?: string;
 
   /**
-   * Time Stamp.
+   * <p>The time at which the action group was created.</p>
    * @public
    */
   createdAt: Date | undefined;
 
   /**
-   * Time Stamp.
+   * <p>The time at which the action group was last updated.</p>
    * @public
    */
   updatedAt: Date | undefined;
 
   /**
-   * Action Group Signature for a BuiltIn Action
+   * <p>If this field is set as <code>AMAZON.UserInput</code>, the agent can request the user for additional information when trying to complete a task. The <code>description</code>, <code>apiSchema</code>, and <code>actionGroupExecutor</code> fields must be blank for this action group.</p>
+   *          <p>During orchestration, if the agent determines that it needs to invoke an API in an action group, but doesn't have enough information to complete the API request, it will invoke this action group instead and return an <a href="https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_Observation.html">Observation</a> reprompting the user for more information.</p>
    * @public
    */
   parentActionSignature?: ActionGroupSignature;
 
   /**
-   * Type of Executors for an Action Group
+   * <p>The ARN of the Lambda function containing the business logic that is carried out upon invoking the action.</p>
    * @public
    */
   actionGroupExecutor?: ActionGroupExecutor;
 
   /**
-   * Contains information about the API Schema for the Action Group
+   * <p>Contains either details about the S3 object containing the OpenAPI schema for the action group or the JSON or YAML-formatted payload defining the schema. For more information, see <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/agents-api-schema.html">Action group OpenAPI schemas</a>.</p>
    * @public
    */
   apiSchema?: APISchema;
 
   /**
-   * State of the action group
+   * <p>Specifies whether the action group is available for the agent to invoke or not when sending an <a href="https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvokeAgent.html">InvokeAgent</a> request.</p>
    * @public
    */
   actionGroupState: ActionGroupState | undefined;
 }
 
 /**
- * Create Action Group Response
  * @public
  */
 export interface CreateAgentActionGroupResponse {
   /**
-   * Contains the information of an Agent Action Group
+   * <p>Contains details about the action group that was created.</p>
    * @public
    */
   agentActionGroup: AgentActionGroup | undefined;
 }
 
 /**
- * This exception is thrown if there was an unexpected error during processing of request
+ * <p>An internal server error occurred. Retry your request.</p>
  * @public
  */
 export class InternalServerException extends __BaseException {
@@ -349,7 +351,7 @@ export class InternalServerException extends __BaseException {
 }
 
 /**
- * This exception is thrown when a resource referenced by the operation does not exist
+ * <p>The specified resource ARN was not found. Check the ARN and try your request again.</p>
  * @public
  */
 export class ResourceNotFoundException extends __BaseException {
@@ -369,7 +371,7 @@ export class ResourceNotFoundException extends __BaseException {
 }
 
 /**
- * This exception is thrown when a request is made beyond the service quota
+ * <p>The number of requests exceeds the service quota. Resubmit your request later.</p>
  * @public
  */
 export class ServiceQuotaExceededException extends __BaseException {
@@ -389,7 +391,7 @@ export class ServiceQuotaExceededException extends __BaseException {
 }
 
 /**
- * This exception is thrown when the number of requests exceeds the limit
+ * <p>The number of requests exceeds the limit. Resubmit your request later.</p>
  * @public
  */
 export class ThrottlingException extends __BaseException {
@@ -409,32 +411,32 @@ export class ThrottlingException extends __BaseException {
 }
 
 /**
- * Stores information about a field passed inside a request that resulted in an exception
+ * <p>Stores information about a field passed inside a request that resulted in an validation error.</p>
  * @public
  */
 export interface ValidationExceptionField {
   /**
-   * Non Blank String
+   * <p>The name of the field.</p>
    * @public
    */
   name: string | undefined;
 
   /**
-   * Non Blank String
+   * <p>A message describing why this field failed validation.</p>
    * @public
    */
   message: string | undefined;
 }
 
 /**
- * This exception is thrown when the request's input validation fails
+ * <p>Input validation failed. Check your request parameters and retry the request.</p>
  * @public
  */
 export class ValidationException extends __BaseException {
   readonly name: "ValidationException" = "ValidationException";
   readonly $fault: "client" = "client";
   /**
-   * list of ValidationExceptionField
+   * <p>A list of objects containing fields that caused validation errors and their corresponding validation error messages.</p>
    * @public
    */
   fieldList?: ValidationExceptionField[];
@@ -454,228 +456,223 @@ export class ValidationException extends __BaseException {
 }
 
 /**
- * Delete Action Group Request
  * @public
  */
 export interface DeleteAgentActionGroupRequest {
   /**
-   * Id generated at the server side when an Agent is created
+   * <p>The unique identifier of the agent that the action group belongs to.</p>
    * @public
    */
   agentId: string | undefined;
 
   /**
-   * Draft Version of the Agent.
+   * <p>The version of the agent that the action group belongs to.</p>
    * @public
    */
   agentVersion: string | undefined;
 
   /**
-   * Id generated at the server side when an Agent ActionGroup is created
+   * <p>The unique identifier of the action group to delete.</p>
    * @public
    */
   actionGroupId: string | undefined;
 
   /**
-   * Skips checking if resource is in use when set to true. Defaults to false
+   * <p>By default, this value is <code>false</code> and deletion is stopped if the resource is in use. If you set it to <code>true</code>, the resource will be deleted even if the resource is in use.</p>
    * @public
    */
   skipResourceInUseCheck?: boolean;
 }
 
 /**
- * Delete Action Group Response
  * @public
  */
 export interface DeleteAgentActionGroupResponse {}
 
 /**
- * Get Action Group Request
  * @public
  */
 export interface GetAgentActionGroupRequest {
   /**
-   * Id generated at the server side when an Agent is created
+   * <p>The unique identifier of the agent that the action group belongs to.</p>
    * @public
    */
   agentId: string | undefined;
 
   /**
-   * Version number generated when a version is created
+   * <p>The version of the agent that the action group belongs to.</p>
    * @public
    */
   agentVersion: string | undefined;
 
   /**
-   * Id generated at the server side when an Agent Action Group is created
+   * <p>The unique identifier of the action group for which to get information.</p>
    * @public
    */
   actionGroupId: string | undefined;
 }
 
 /**
- * Get Action Group Response
  * @public
  */
 export interface GetAgentActionGroupResponse {
   /**
-   * Contains the information of an Agent Action Group
+   * <p>Contains details about the action group.</p>
    * @public
    */
   agentActionGroup: AgentActionGroup | undefined;
 }
 
 /**
- * List Action Groups Request
  * @public
  */
 export interface ListAgentActionGroupsRequest {
   /**
-   * Id generated at the server side when an Agent is Listed
+   * <p>The unique identifier of the agent.</p>
    * @public
    */
   agentId: string | undefined;
 
   /**
-   * Id generated at the server side when an Agent is Listed
+   * <p>The version of the agent.</p>
    * @public
    */
   agentVersion: string | undefined;
 
   /**
-   * Max Results.
+   * <p>The maximum number of results to return in the response. If the total number of results is greater than this value, use the token returned in the response in the <code>nextToken</code> field when making another request to return the next batch of results.</p>
    * @public
    */
   maxResults?: number;
 
   /**
-   * Opaque continuation token of previous paginated response.
+   * <p>If the total number of results is greater than the <code>maxResults</code> value provided in the request, enter the token returned in the <code>nextToken</code> field in the response in this field to return the next batch of results.</p>
    * @public
    */
   nextToken?: string;
 }
 
 /**
- * ActionGroup Summary
+ * <p>Contains details about an action group.</p>
  * @public
  */
 export interface ActionGroupSummary {
   /**
-   * Identifier for a resource.
+   * <p>The unique identifier of the action group.</p>
    * @public
    */
   actionGroupId: string | undefined;
 
   /**
-   * Name for a resource.
+   * <p>The name of the action group.</p>
    * @public
    */
   actionGroupName: string | undefined;
 
   /**
-   * State of the action group
+   * <p>Specifies whether the action group is available for the agent to invoke or not when
+   *       sending an <a href="https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvokeAgent.html">InvokeAgent</a>
+   *       request.</p>
    * @public
    */
   actionGroupState: ActionGroupState | undefined;
 
   /**
-   * Description of the Resource.
+   * <p>The description of the action group.</p>
    * @public
    */
   description?: string;
 
   /**
-   * Time Stamp.
+   * <p>The time at which the action group was last updated.</p>
    * @public
    */
   updatedAt: Date | undefined;
 }
 
 /**
- * List Action Groups Response
  * @public
  */
 export interface ListAgentActionGroupsResponse {
   /**
-   * List of ActionGroup Summaries
+   * <p>A list of objects, each of which contains information about an action group.</p>
    * @public
    */
   actionGroupSummaries: ActionGroupSummary[] | undefined;
 
   /**
-   * Opaque continuation token of previous paginated response.
+   * <p>If the total number of results is greater than the <code>maxResults</code> value provided in the request, use this token when making another request in the <code>nextToken</code> field to return the next batch of results.</p>
    * @public
    */
   nextToken?: string;
 }
 
 /**
- * Update Action Group Request
  * @public
  */
 export interface UpdateAgentActionGroupRequest {
   /**
-   * Id generated at the server side when an Agent is created
+   * <p>The unique identifier of the agent for which to update the action group.</p>
    * @public
    */
   agentId: string | undefined;
 
   /**
-   * Draft Version of the Agent.
+   * <p>The unique identifier of the agent version for which to update the action group.</p>
    * @public
    */
   agentVersion: string | undefined;
 
   /**
-   * Id generated at the server side when an Action Group is created under Agent
+   * <p>The unique identifier of the action group.</p>
    * @public
    */
   actionGroupId: string | undefined;
 
   /**
-   * Name for a resource.
+   * <p>Specifies a new name for the action group.</p>
    * @public
    */
   actionGroupName: string | undefined;
 
   /**
-   * Description of the Resource.
+   * <p>Specifies a new name for the action group.</p>
    * @public
    */
   description?: string;
 
   /**
-   * Action Group Signature for a BuiltIn Action
+   * <p>To allow your agent to request the user for additional information when trying to complete a task, set this field to <code>AMAZON.UserInput</code>. You must leave the <code>description</code>, <code>apiSchema</code>, and <code>actionGroupExecutor</code> fields blank for this action group.</p>
+   *          <p>During orchestration, if your agent determines that it needs to invoke an API in an action group, but doesn't have enough information to complete the API request, it will invoke this action group instead and return an <a href="https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_Observation.html">Observation</a> reprompting the user for more information.</p>
    * @public
    */
   parentActionGroupSignature?: ActionGroupSignature;
 
   /**
-   * Type of Executors for an Action Group
+   * <p>The ARN of the Lambda function containing the business logic that is carried out upon invoking the action.</p>
    * @public
    */
   actionGroupExecutor?: ActionGroupExecutor;
 
   /**
-   * State of the action group
+   * <p>Specifies whether the action group is available for the agent to invoke or not when sending an <a href="https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvokeAgent.html">InvokeAgent</a> request.</p>
    * @public
    */
   actionGroupState?: ActionGroupState;
 
   /**
-   * Contains information about the API Schema for the Action Group
+   * <p>Contains either details about the S3 object containing the OpenAPI schema for the action group or the JSON or YAML-formatted payload defining the schema. For more information, see <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/agents-api-schema.html">Action group OpenAPI schemas</a>.</p>
    * @public
    */
   apiSchema?: APISchema;
 }
 
 /**
- * Update Action Group Response
  * @public
  */
 export interface UpdateAgentActionGroupResponse {
   /**
-   * Contains the information of an Agent Action Group
+   * <p>Contains details about the action group that was updated.</p>
    * @public
    */
   agentActionGroup: AgentActionGroup | undefined;
@@ -702,36 +699,36 @@ export const AgentStatus = {
 export type AgentStatus = (typeof AgentStatus)[keyof typeof AgentStatus];
 
 /**
- * Configuration for inference in prompt configuration
+ * <p>Contains inference parameters to use when the agent invokes a foundation model in the part of the agent sequence defined by the <code>promptType</code>. For more information, see <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/model-parameters.html">Inference parameters for foundation models</a>.</p>
  * @public
  */
 export interface InferenceConfiguration {
   /**
-   * Controls randomness, higher values increase diversity
+   * <p>The likelihood of the model selecting higher-probability options while generating a response. A lower value makes the model more likely to choose higher-probability options, while a higher value makes the model more likely to choose lower-probability options.</p>
    * @public
    */
   temperature?: number;
 
   /**
-   * Cumulative probability cutoff for token selection
+   * <p>While generating a response, the model determines the probability of the following token at each point of generation. The value that you set for <code>Top P</code> determines the number of most-likely candidates from which the model chooses the next token in the sequence. For example, if you set <code>topP</code> to 80, the model only selects the next token from the top 80% of the probability distribution of next tokens.</p>
    * @public
    */
   topP?: number;
 
   /**
-   * Sample from the k most likely next tokens
+   * <p>While generating a response, the model determines the probability of the following token at each point of generation. The value that you set for <code>topK</code> is the number of most-likely candidates from which the model chooses the next token in the sequence. For example, if you set <code>topK</code> to 50, the model selects the next token from among the top 50 most likely choices.</p>
    * @public
    */
   topK?: number;
 
   /**
-   * Maximum length of output
+   * <p>The maximum number of tokens to allow in the generated response.</p>
    * @public
    */
   maximumLength?: number;
 
   /**
-   * List of stop sequences
+   * <p>A list of stop sequences. A stop sequence is a sequence of characters that causes the model to stop generating the response.</p>
    * @public
    */
   stopSequences?: string[];
@@ -782,210 +779,257 @@ export const PromptType = {
 export type PromptType = (typeof PromptType)[keyof typeof PromptType];
 
 /**
- * BasePromptConfiguration per Prompt Type.
+ * <p>Contains configurations to override a prompt template in one part of an agent sequence. For more information, see <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/advanced-prompts.html">Advanced prompts</a>.</p>
  * @public
  */
 export interface PromptConfiguration {
   /**
-   * Prompt Type.
+   * <p>The step in the agent sequence that this prompt configuration applies to.</p>
    * @public
    */
   promptType?: PromptType;
 
   /**
-   * Creation Mode for Prompt Configuration.
+   * <p>Specifies whether to override the default prompt template for this <code>promptType</code>. Set this value to <code>OVERRIDDEN</code> to use the prompt that you provide in the <code>basePromptTemplate</code>. If you leave it as <code>DEFAULT</code>, the agent uses a default prompt template.</p>
    * @public
    */
   promptCreationMode?: CreationMode;
 
   /**
-   * Prompt State.
+   * <p>Specifies whether to allow the agent to carry out the step specified in the <code>promptType</code>. If you set this value to <code>DISABLED</code>, the agent skips that step. The default state for each <code>promptType</code> is as follows.</p>
+   *          <ul>
+   *             <li>
+   *                <p>
+   *                   <code>PRE_PROCESSING</code> – <code>ENABLED</code>
+   *                </p>
+   *             </li>
+   *             <li>
+   *                <p>
+   *                   <code>ORCHESTRATION</code> – <code>ENABLED</code>
+   *                </p>
+   *             </li>
+   *             <li>
+   *                <p>
+   *                   <code>KNOWLEDGE_BASE_RESPONSE_GENERATION</code> – <code>ENABLED</code>
+   *                </p>
+   *             </li>
+   *             <li>
+   *                <p>
+   *                   <code>POST_PROCESSING</code> – <code>DISABLED</code>
+   *                </p>
+   *             </li>
+   *          </ul>
    * @public
    */
   promptState?: PromptState;
 
   /**
-   * Base Prompt Template.
+   * <p>Defines the prompt template with which to replace the default prompt template. You can use placeholder variables in the base prompt template to customize the prompt. For more information, see <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/prompt-placeholders.html">Prompt template placeholder variables</a>.</p>
    * @public
    */
   basePromptTemplate?: string;
 
   /**
-   * Configuration for inference in prompt configuration
+   * <p>Contains inference parameters to use when the agent invokes a foundation model in the part of the agent sequence defined by the <code>promptType</code>. For more information, see <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/model-parameters.html">Inference parameters for foundation models</a>.</p>
    * @public
    */
   inferenceConfiguration?: InferenceConfiguration;
 
   /**
-   * Creation Mode for Prompt Configuration.
+   * <p>Specifies whether to override the default parser Lambda function when parsing the raw foundation model output in the part of the agent sequence defined by the <code>promptType</code>. If you set the field as <code>OVERRIDEN</code>, the <code>overrideLambda</code> field in the <a href="https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_PromptOverrideConfiguration.html">PromptOverrideConfiguration</a> must be specified with the ARN of a Lambda function.</p>
    * @public
    */
   parserMode?: CreationMode;
 }
 
 /**
- * Configuration for prompt override.
+ * <p>Contains configurations to override prompts in different parts of an agent sequence. For more information, see <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/advanced-prompts.html">Advanced prompts</a>.</p>
  * @public
  */
 export interface PromptOverrideConfiguration {
   /**
-   * List of BasePromptConfiguration
+   * <p>Contains configurations to override a prompt template in one part of an agent sequence. For more information, see <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/advanced-prompts.html">Advanced prompts</a>.</p>
    * @public
    */
   promptConfigurations: PromptConfiguration[] | undefined;
 
   /**
-   * ARN of a Lambda.
+   * <p>The ARN of the Lambda function to use when parsing the raw foundation model output in parts of the agent sequence. If you specify this field, at least one of the <code>promptConfigurations</code> must contain a <code>parserMode</code> value that is set to <code>OVERRIDDEN</code>.</p>
    * @public
    */
   overrideLambda?: string;
 }
 
 /**
- * Contains the information of an agent
+ * <p>Contains details about an agent.</p>
  * @public
  */
 export interface Agent {
   /**
-   * Identifier for a resource.
+   * <p>The unique identifier of the agent.</p>
    * @public
    */
   agentId: string | undefined;
 
   /**
-   * Name for a resource.
+   * <p>The name of the agent.</p>
    * @public
    */
   agentName: string | undefined;
 
   /**
-   * Arn representation of the Agent.
+   * <p>The ARN of the agent.</p>
    * @public
    */
   agentArn: string | undefined;
 
   /**
-   * Draft Agent Version.
+   * <p>The version of the agent.</p>
    * @public
    */
   agentVersion: string | undefined;
 
   /**
-   * Client specified token used for idempotency checks
+   * <p>A unique, case-sensitive identifier to ensure that the API request completes no more than one time. If this token matches a previous request,
+   *       Amazon Bedrock ignores the request, but does not return an error. For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/APIReference/Run_Instance_Idempotency.html">Ensuring idempotency</a>.</p>
    * @public
    */
   clientToken?: string;
 
   /**
-   * Instruction for the agent.
+   * <p>Instructions that tell the agent what it should do and how it should interact with users.</p>
    * @public
    */
   instruction?: string;
 
   /**
-   * Schema Type for Action APIs.
+   * <p>The status of the agent and whether it is ready for use. The following statuses are possible:</p>
+   *          <ul>
+   *             <li>
+   *                <p>CREATING – The agent is being created.</p>
+   *             </li>
+   *             <li>
+   *                <p>PREPARING – The agent is being prepared.</p>
+   *             </li>
+   *             <li>
+   *                <p>PREPARED – The agent is prepared and ready to be invoked.</p>
+   *             </li>
+   *             <li>
+   *                <p>NOT_PREPARED – The agent has been created but not yet prepared.</p>
+   *             </li>
+   *             <li>
+   *                <p>FAILED – The agent API operation failed.</p>
+   *             </li>
+   *             <li>
+   *                <p>UPDATING – The agent is being updated.</p>
+   *             </li>
+   *             <li>
+   *                <p>DELETING – The agent is being deleted.</p>
+   *             </li>
+   *          </ul>
    * @public
    */
   agentStatus: AgentStatus | undefined;
 
   /**
-   * ARN or name of a Bedrock model.
+   * <p>The foundation model used for orchestration by the agent.</p>
    * @public
    */
   foundationModel?: string;
 
   /**
-   * Description of the Resource.
+   * <p>The description of the agent.</p>
    * @public
    */
   description?: string;
 
   /**
-   * Max Session Time.
+   * <p>The number of seconds for which Amazon Bedrock keeps information about a user's conversation with the agent.</p>
+   *          <p>A user interaction remains active for the amount of time specified. If no conversation occurs during this time, the session expires and Amazon Bedrock deletes any data provided before the timeout.</p>
    * @public
    */
   idleSessionTTLInSeconds: number | undefined;
 
   /**
-   * ARN of a IAM role.
+   * <p>The ARN of the IAM role with permissions to call API operations on the agent. The ARN must begin with <code>AmazonBedrockExecutionRoleForAgents_</code>.</p>
    * @public
    */
   agentResourceRoleArn: string | undefined;
 
   /**
-   * A KMS key ARN
+   * <p>The ARN of the KMS key that encrypts the agent.</p>
    * @public
    */
   customerEncryptionKeyArn?: string;
 
   /**
-   * Time Stamp.
+   * <p>The time at which the agent was created.</p>
    * @public
    */
   createdAt: Date | undefined;
 
   /**
-   * Time Stamp.
+   * <p>The time at which the agent was last updated.</p>
    * @public
    */
   updatedAt: Date | undefined;
 
   /**
-   * Time Stamp.
+   * <p>The time at which the agent was last prepared.</p>
    * @public
    */
   preparedAt?: Date;
 
   /**
-   * Failure Reasons for Error.
+   * <p>Contains reasons that the agent-related API that you invoked failed.</p>
    * @public
    */
   failureReasons?: string[];
 
   /**
-   * The recommended actions users can take to resolve an error in failureReasons.
+   * <p>Contains recommended actions to take for the agent-related API that you invoked to succeed.</p>
    * @public
    */
   recommendedActions?: string[];
 
   /**
-   * Configuration for prompt override.
+   * <p>Contains configurations to override prompt templates in different parts of an agent sequence. For more information, see <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/advanced-prompts.html">Advanced prompts</a>.</p>
    * @public
    */
   promptOverrideConfiguration?: PromptOverrideConfiguration;
 }
 
 /**
- * Details about the routing configuration for an Agent alias.
+ * <p>Contains details about the routing configuration of the alias.</p>
  * @public
  */
 export interface AgentAliasRoutingConfigurationListItem {
   /**
-   * Agent Version.
+   * <p>The version of the agent with which the alias is associated.</p>
    * @public
    */
   agentVersion: string | undefined;
 }
 
 /**
- * History event for an alias for an Agent.
+ * <p>Contains details about the history of the alias.</p>
  * @public
  */
 export interface AgentAliasHistoryEvent {
   /**
-   * Routing configuration for an Agent alias.
+   * <p>Contains details about the version of the agent with which the alias is associated.</p>
    * @public
    */
   routingConfiguration?: AgentAliasRoutingConfigurationListItem[];
 
   /**
-   * Time Stamp.
+   * <p>The date that the alias stopped being associated to the version in the <code>routingConfiguration</code> object</p>
    * @public
    */
   endDate?: Date;
 
   /**
-   * Time Stamp.
+   * <p>The date that the alias began being associated to the version in the <code>routingConfiguration</code> object.</p>
    * @public
    */
   startDate?: Date;
@@ -1009,120 +1053,138 @@ export const AgentAliasStatus = {
 export type AgentAliasStatus = (typeof AgentAliasStatus)[keyof typeof AgentAliasStatus];
 
 /**
- * Contains the information of an agent alias
+ * <p>Contains details about an alias of an agent.</p>
  * @public
  */
 export interface AgentAlias {
   /**
-   * Identifier for a resource.
+   * <p>The unique identifier of the agent.</p>
    * @public
    */
   agentId: string | undefined;
 
   /**
-   * Id for an Agent Alias generated at the server side.
+   * <p>The unique identifier of the alias of the agent.</p>
    * @public
    */
   agentAliasId: string | undefined;
 
   /**
-   * Name for a resource.
+   * <p>The name of the alias of the agent.</p>
    * @public
    */
   agentAliasName: string | undefined;
 
   /**
-   * Arn representation of the Agent Alias.
+   * <p>The ARN of the alias of the agent.</p>
    * @public
    */
   agentAliasArn: string | undefined;
 
   /**
-   * Client specified token used for idempotency checks
+   * <p>A unique, case-sensitive identifier to ensure that the API request completes no more than one time. If this token matches a previous request,
+   *       Amazon Bedrock ignores the request, but does not return an error. For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/APIReference/Run_Instance_Idempotency.html">Ensuring idempotency</a>.</p>
    * @public
    */
   clientToken?: string;
 
   /**
-   * Description of the Resource.
+   * <p>The description of the alias of the agent.</p>
    * @public
    */
   description?: string;
 
   /**
-   * Routing configuration for an Agent alias.
+   * <p>Contains details about the routing configuration of the alias.</p>
    * @public
    */
   routingConfiguration: AgentAliasRoutingConfigurationListItem[] | undefined;
 
   /**
-   * Time Stamp.
+   * <p>The time at which the alias of the agent was created.</p>
    * @public
    */
   createdAt: Date | undefined;
 
   /**
-   * Time Stamp.
+   * <p>The time at which the alias was last updated.</p>
    * @public
    */
   updatedAt: Date | undefined;
 
   /**
-   * The list of history events for an alias for an Agent.
+   * <p>Contains details about the history of the alias.</p>
    * @public
    */
   agentAliasHistoryEvents?: AgentAliasHistoryEvent[];
 
   /**
-   * The statuses an Agent Alias can be in.
+   * <p>The status of the alias of the agent and whether it is ready for use. The following statuses are possible:</p>
+   *          <ul>
+   *             <li>
+   *                <p>CREATING – The agent alias is being created.</p>
+   *             </li>
+   *             <li>
+   *                <p>PREPARED – The agent alias is finished being created or updated and is ready to be invoked.</p>
+   *             </li>
+   *             <li>
+   *                <p>FAILED – The agent alias API operation failed.</p>
+   *             </li>
+   *             <li>
+   *                <p>UPDATING – The agent alias is being updated.</p>
+   *             </li>
+   *             <li>
+   *                <p>DELETING – The agent alias is being deleted.</p>
+   *             </li>
+   *          </ul>
    * @public
    */
   agentAliasStatus: AgentAliasStatus | undefined;
 }
 
 /**
- * Summary of an alias for an Agent.
+ * <p>Contains details about an alias of an agent.</p>
  * @public
  */
 export interface AgentAliasSummary {
   /**
-   * Id for an Agent Alias generated at the server side.
+   * <p>Contains details about </p>
    * @public
    */
   agentAliasId: string | undefined;
 
   /**
-   * Name for a resource.
+   * <p>The name of the alias.</p>
    * @public
    */
   agentAliasName: string | undefined;
 
   /**
-   * Description of the Resource.
+   * <p>The description of the alias.</p>
    * @public
    */
   description?: string;
 
   /**
-   * Routing configuration for an Agent alias.
+   * <p>Contains details about the version of the agent with which the alias is associated.</p>
    * @public
    */
   routingConfiguration?: AgentAliasRoutingConfigurationListItem[];
 
   /**
-   * The statuses an Agent Alias can be in.
+   * <p>The status of the alias.</p>
    * @public
    */
   agentAliasStatus: AgentAliasStatus | undefined;
 
   /**
-   * Time Stamp.
+   * <p>The time at which the alias of the agent was created.</p>
    * @public
    */
   createdAt: Date | undefined;
 
   /**
-   * Time Stamp.
+   * <p>The time at which the alias was last updated.</p>
    * @public
    */
   updatedAt: Date | undefined;
@@ -1143,786 +1205,769 @@ export const KnowledgeBaseState = {
 export type KnowledgeBaseState = (typeof KnowledgeBaseState)[keyof typeof KnowledgeBaseState];
 
 /**
- * Contains the information of an Agent Knowledge Base.
+ * <p>Contains details about a knowledge base that is associated with an agent.</p>
  * @public
  */
 export interface AgentKnowledgeBase {
   /**
-   * Identifier for a resource.
+   * <p>The unique identifier of the agent with which the knowledge base is associated.</p>
    * @public
    */
   agentId: string | undefined;
 
   /**
-   * Agent Version.
+   * <p>The version of the agent with which the knowledge base is associated.</p>
    * @public
    */
   agentVersion: string | undefined;
 
   /**
-   * Identifier for a resource.
+   * <p>The unique identifier of the association between the agent and the knowledge base.</p>
    * @public
    */
   knowledgeBaseId: string | undefined;
 
   /**
-   * Description of the Resource.
+   * <p>The description of the association between the agent and the knowledge base.</p>
    * @public
    */
   description: string | undefined;
 
   /**
-   * Time Stamp.
+   * <p>The time at which the association between the agent and the knowledge base was created.</p>
    * @public
    */
   createdAt: Date | undefined;
 
   /**
-   * Time Stamp.
+   * <p>The time at which the association between the agent and the knowledge base was last updated.</p>
    * @public
    */
   updatedAt: Date | undefined;
 
   /**
-   * State of the knowledge base; whether it is enabled or disabled
+   * <p>Specifies whether to use the knowledge base or not when sending an <a href="https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvokeAgent.html">InvokeAgent</a> request.</p>
    * @public
    */
   knowledgeBaseState: KnowledgeBaseState | undefined;
 }
 
 /**
- * Agent Knowledge Base Summary
+ * <p>Contains details about a knowledge base associated with an agent.</p>
  * @public
  */
 export interface AgentKnowledgeBaseSummary {
   /**
-   * Identifier for a resource.
+   * <p>The unique identifier of the knowledge base associated with an agent.</p>
    * @public
    */
   knowledgeBaseId: string | undefined;
 
   /**
-   * Description of the Resource.
+   * <p>The description of the knowledge base associated with an agent.</p>
    * @public
    */
   description?: string;
 
   /**
-   * State of the knowledge base; whether it is enabled or disabled
+   * <p>Specifies whether the agent uses the knowledge base or not when sending an <a href="https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvokeAgent.html">InvokeAgent</a> request.</p>
    * @public
    */
   knowledgeBaseState: KnowledgeBaseState | undefined;
 
   /**
-   * Time Stamp.
+   * <p>The time at which the knowledge base associated with an agent was last updated.</p>
    * @public
    */
   updatedAt: Date | undefined;
 }
 
 /**
- * Create Agent Request
  * @public
  */
 export interface CreateAgentRequest {
   /**
-   * Name for a resource.
+   * <p>A name for the agent that you create.</p>
    * @public
    */
   agentName: string | undefined;
 
   /**
-   * Client specified token used for idempotency checks
+   * <p>A unique, case-sensitive identifier to ensure that the API request completes no more than one time. If this token matches a previous request,
+   *       Amazon Bedrock ignores the request, but does not return an error. For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/APIReference/Run_Instance_Idempotency.html">Ensuring idempotency</a>.</p>
    * @public
    */
   clientToken?: string;
 
   /**
-   * Instruction for the agent.
+   * <p>Instructions that tell the agent what it should do and how it should interact with users.</p>
    * @public
    */
   instruction?: string;
 
   /**
-   * ARN or name of a Bedrock model.
+   * <p>The foundation model to be used for orchestration by the agent you create.</p>
    * @public
    */
   foundationModel?: string;
 
   /**
-   * Description of the Resource.
+   * <p>A description of the agent.</p>
    * @public
    */
   description?: string;
 
   /**
-   * Max Session Time.
+   * <p>The number of seconds for which Amazon Bedrock keeps information about a user's conversation with the agent.</p>
+   *          <p>A user interaction remains active for the amount of time specified. If no conversation occurs during this time, the session expires and Amazon Bedrock deletes any data provided before the timeout.</p>
    * @public
    */
   idleSessionTTLInSeconds?: number;
 
   /**
-   * ARN of a IAM role.
+   * <p>The ARN of the IAM role with permissions to create the agent. The ARN must begin with <code>AmazonBedrockExecutionRoleForAgents_</code>.</p>
    * @public
    */
   agentResourceRoleArn: string | undefined;
 
   /**
-   * A KMS key ARN
+   * <p>The ARN of the KMS key with which to encrypt the agent.</p>
    * @public
    */
   customerEncryptionKeyArn?: string;
 
   /**
-   * A map of tag keys and values
+   * <p>Any tags that you want to attach to the agent.</p>
    * @public
    */
   tags?: Record<string, string>;
 
   /**
-   * Configuration for prompt override.
+   * <p>Contains configurations to override prompts in different parts of an agent sequence. For more information, see <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/advanced-prompts.html">Advanced prompts</a>.</p>
    * @public
    */
   promptOverrideConfiguration?: PromptOverrideConfiguration;
 }
 
 /**
- * Create Agent Response
  * @public
  */
 export interface CreateAgentResponse {
   /**
-   * Contains the information of an agent
+   * <p>Contains details about the agent created.</p>
    * @public
    */
   agent: Agent | undefined;
 }
 
 /**
- * Delete Agent Request
  * @public
  */
 export interface DeleteAgentRequest {
   /**
-   * Id generated at the server side when an Agent is created
+   * <p>The unique identifier of the agent to delete.</p>
    * @public
    */
   agentId: string | undefined;
 
   /**
-   * Skips checking if resource is in use when set to true. Defaults to false
+   * <p>By default, this value is <code>false</code> and deletion is stopped if the resource is in use. If you set it to <code>true</code>, the resource will be deleted even if the resource is in use.</p>
    * @public
    */
   skipResourceInUseCheck?: boolean;
 }
 
 /**
- * Delete Agent Response
  * @public
  */
 export interface DeleteAgentResponse {
   /**
-   * Identifier for a resource.
+   * <p>The unique identifier of the agent that was deleted.</p>
    * @public
    */
   agentId: string | undefined;
 
   /**
-   * Schema Type for Action APIs.
+   * <p>The status of the agent.</p>
    * @public
    */
   agentStatus: AgentStatus | undefined;
 }
 
 /**
- * Get Agent Request
  * @public
  */
 export interface GetAgentRequest {
   /**
-   * Id generated at the server side when an Agent is created
+   * <p>The unique identifier of the agent.</p>
    * @public
    */
   agentId: string | undefined;
 }
 
 /**
- * Get Agent Response
  * @public
  */
 export interface GetAgentResponse {
   /**
-   * Contains the information of an agent
+   * <p>Contains details about the agent.</p>
    * @public
    */
   agent: Agent | undefined;
 }
 
 /**
- * List Agent Request
  * @public
  */
 export interface ListAgentsRequest {
   /**
-   * Max Results.
+   * <p>The maximum number of results to return in the response. If the total number of results is greater than this value, use the token returned in the response in the <code>nextToken</code> field when making another request to return the next batch of results.</p>
    * @public
    */
   maxResults?: number;
 
   /**
-   * Opaque continuation token of previous paginated response.
+   * <p>If the total number of results is greater than the <code>maxResults</code> value provided in the request, enter the token returned in the <code>nextToken</code> field in the response in this field to return the next batch of results.</p>
    * @public
    */
   nextToken?: string;
 }
 
 /**
- * Summary of Agent.
+ * <p>Contains details about an agent.</p>
  * @public
  */
 export interface AgentSummary {
   /**
-   * Identifier for a resource.
+   * <p>The unique identifier of the agent.</p>
    * @public
    */
   agentId: string | undefined;
 
   /**
-   * Name for a resource.
+   * <p>The name of the agent.</p>
    * @public
    */
   agentName: string | undefined;
 
   /**
-   * Schema Type for Action APIs.
+   * <p>The status of the agent.</p>
    * @public
    */
   agentStatus: AgentStatus | undefined;
 
   /**
-   * Description of the Resource.
+   * <p>The description of the agent.</p>
    * @public
    */
   description?: string;
 
   /**
-   * Time Stamp.
+   * <p>The time at which the agent was last updated.</p>
    * @public
    */
   updatedAt: Date | undefined;
 
   /**
-   * Agent Version.
+   * <p>The latest version of the agent.</p>
    * @public
    */
   latestAgentVersion?: string;
 }
 
 /**
- * List Agent Response
  * @public
  */
 export interface ListAgentsResponse {
   /**
-   * List of AgentSummary.
+   * <p>A list of objects, each of which contains information about an agent.</p>
    * @public
    */
   agentSummaries: AgentSummary[] | undefined;
 
   /**
-   * Opaque continuation token of previous paginated response.
+   * <p>If the total number of results is greater than the <code>maxResults</code> value provided in the request, use this token when making another request in the <code>nextToken</code> field to return the next batch of results.</p>
    * @public
    */
   nextToken?: string;
 }
 
 /**
- * PrepareAgent Request
  * @public
  */
 export interface PrepareAgentRequest {
   /**
-   * Id generated at the server side when an Agent is created
+   * <p>The unique identifier of the agent for which to create a <code>DRAFT</code> version.</p>
    * @public
    */
   agentId: string | undefined;
 }
 
 /**
- * PrepareAgent Response
  * @public
  */
 export interface PrepareAgentResponse {
   /**
-   * Identifier for a resource.
+   * <p>The unique identifier of the agent for which the <code>DRAFT</code> version was created.</p>
    * @public
    */
   agentId: string | undefined;
 
   /**
-   * Schema Type for Action APIs.
+   * <p>The status of the <code>DRAFT</code> version and whether it is ready for use.</p>
    * @public
    */
   agentStatus: AgentStatus | undefined;
 
   /**
-   * Agent Version.
+   * <p>The version of the agent.</p>
    * @public
    */
   agentVersion: string | undefined;
 
   /**
-   * Time Stamp.
+   * <p>The time at which the <code>DRAFT</code> version of the agent was last prepared.</p>
    * @public
    */
   preparedAt: Date | undefined;
 }
 
 /**
- * Update Agent Request
  * @public
  */
 export interface UpdateAgentRequest {
   /**
-   * Id generated at the server side when an Agent is created
+   * <p>The unique identifier of the agent.</p>
    * @public
    */
   agentId: string | undefined;
 
   /**
-   * Name for a resource.
+   * <p>Specifies a new name for the agent.</p>
    * @public
    */
   agentName: string | undefined;
 
   /**
-   * Instruction for the agent.
+   * <p>Specifies new instructions that tell the agent what it should do and how it should interact with users.</p>
    * @public
    */
   instruction?: string;
 
   /**
-   * ARN or name of a Bedrock model.
+   * <p>Specifies a new foundation model to be used for orchestration by the agent.</p>
    * @public
    */
-  foundationModel?: string;
+  foundationModel: string | undefined;
 
   /**
-   * Description of the Resource.
+   * <p>Specifies a new description of the agent.</p>
    * @public
    */
   description?: string;
 
   /**
-   * Max Session Time.
+   * <p>The number of seconds for which Amazon Bedrock keeps information about a user's conversation with the agent.</p>
+   *          <p>A user interaction remains active for the amount of time specified. If no conversation occurs during this time, the session expires and Amazon Bedrock deletes any data provided before the timeout.</p>
    * @public
    */
   idleSessionTTLInSeconds?: number;
 
   /**
-   * ARN of a IAM role.
+   * <p>The ARN of the IAM role with permissions to update the agent. The ARN must begin with <code>AmazonBedrockExecutionRoleForAgents_</code>.</p>
    * @public
    */
   agentResourceRoleArn: string | undefined;
 
   /**
-   * A KMS key ARN
+   * <p>The ARN of the KMS key with which to encrypt the agent.</p>
    * @public
    */
   customerEncryptionKeyArn?: string;
 
   /**
-   * Configuration for prompt override.
+   * <p>Contains configurations to override prompts in different parts of an agent sequence. For more information, see <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/advanced-prompts.html">Advanced prompts</a>.</p>
    * @public
    */
   promptOverrideConfiguration?: PromptOverrideConfiguration;
 }
 
 /**
- * Update Agent Response
  * @public
  */
 export interface UpdateAgentResponse {
   /**
-   * Contains the information of an agent
+   * <p>Contains details about the agent that was updated.</p>
    * @public
    */
   agent: Agent | undefined;
 }
 
 /**
- * Contains the information of an agent version.
+ * <p>Contains details about a version of an agent.</p>
  * @public
  */
 export interface AgentVersion {
   /**
-   * Identifier for a resource.
+   * <p>The unique identifier of the agent that the version belongs to.</p>
    * @public
    */
   agentId: string | undefined;
 
   /**
-   * Name for a resource.
+   * <p>The name of the agent that the version belongs to.</p>
    * @public
    */
   agentName: string | undefined;
 
   /**
-   * Arn representation of the Agent.
+   * <p>The ARN of the agent that the version belongs to.</p>
    * @public
    */
   agentArn: string | undefined;
 
   /**
-   * Numerical Agent Version.
+   * <p>The version number.</p>
    * @public
    */
   version: string | undefined;
 
   /**
-   * Instruction for the agent.
+   * <p>The instructions provided to the agent.</p>
    * @public
    */
   instruction?: string;
 
   /**
-   * Schema Type for Action APIs.
+   * <p>The status of the agent that the version belongs to.</p>
    * @public
    */
   agentStatus: AgentStatus | undefined;
 
   /**
-   * ARN or name of a Bedrock model.
+   * <p>The foundation model that the version invokes.</p>
    * @public
    */
   foundationModel?: string;
 
   /**
-   * Description of the Resource.
+   * <p>The description of the version.</p>
    * @public
    */
   description?: string;
 
   /**
-   * Max Session Time.
+   * <p>The number of seconds for which Amazon Bedrock keeps information about a user's conversation with the agent.</p>
+   *          <p>A user interaction remains active for the amount of time specified. If no conversation occurs during this time, the session expires and Amazon Bedrock deletes any data provided before the timeout.</p>
    * @public
    */
   idleSessionTTLInSeconds: number | undefined;
 
   /**
-   * ARN of a IAM role.
+   * <p>The ARN of the IAM role with permissions to invoke API operations on the agent. The ARN must begin with <code>AmazonBedrockExecutionRoleForAgents_</code>.</p>
    * @public
    */
   agentResourceRoleArn: string | undefined;
 
   /**
-   * A KMS key ARN
+   * <p>The ARN of the KMS key that encrypts the agent.</p>
    * @public
    */
   customerEncryptionKeyArn?: string;
 
   /**
-   * Time Stamp.
+   * <p>The time at which the version was created.</p>
    * @public
    */
   createdAt: Date | undefined;
 
   /**
-   * Time Stamp.
+   * <p>The time at which the version was last updated.</p>
    * @public
    */
   updatedAt: Date | undefined;
 
   /**
-   * Failure Reasons for Error.
+   * <p>A list of reasons that the API operation on the version failed.</p>
    * @public
    */
   failureReasons?: string[];
 
   /**
-   * The recommended actions users can take to resolve an error in failureReasons.
+   * <p>A list of recommended actions to take for the failed API operation on the version to succeed.</p>
    * @public
    */
   recommendedActions?: string[];
 
   /**
-   * Configuration for prompt override.
+   * <p>Contains configurations to override prompt templates in different parts of an agent sequence. For more information, see <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/advanced-prompts.html">Advanced prompts</a>.</p>
    * @public
    */
   promptOverrideConfiguration?: PromptOverrideConfiguration;
 }
 
 /**
- * Summary of agent version.
+ * <p>Contains details about a version of an agent.</p>
  * @public
  */
 export interface AgentVersionSummary {
   /**
-   * Name for a resource.
+   * <p>The name of the agent to which the version belongs.</p>
    * @public
    */
   agentName: string | undefined;
 
   /**
-   * Schema Type for Action APIs.
+   * <p>The status of the agent to which the version belongs.</p>
    * @public
    */
   agentStatus: AgentStatus | undefined;
 
   /**
-   * Agent Version.
+   * <p>The version of the agent.</p>
    * @public
    */
   agentVersion: string | undefined;
 
   /**
-   * Time Stamp.
+   * <p>The time at which the version was created.</p>
    * @public
    */
   createdAt: Date | undefined;
 
   /**
-   * Time Stamp.
+   * <p>The time at which the version was last updated.</p>
    * @public
    */
   updatedAt: Date | undefined;
 
   /**
-   * Description of the Resource.
+   * <p>The description of the version of the agent.</p>
    * @public
    */
   description?: string;
 }
 
 /**
- * Create Agent Alias Request
  * @public
  */
 export interface CreateAgentAliasRequest {
   /**
-   * Id generated at the server side when an Agent is created
+   * <p>The unique identifier of the agent.</p>
    * @public
    */
   agentId: string | undefined;
 
   /**
-   * Name for a resource.
+   * <p>The name of the alias.</p>
    * @public
    */
   agentAliasName: string | undefined;
 
   /**
-   * Client specified token used for idempotency checks
+   * <p>A unique, case-sensitive identifier to ensure that the API request completes no more than one time. If this token matches a previous request,
+   *       Amazon Bedrock ignores the request, but does not return an error. For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/APIReference/Run_Instance_Idempotency.html">Ensuring idempotency</a>.</p>
    * @public
    */
   clientToken?: string;
 
   /**
-   * Description of the Resource.
+   * <p>A description of the alias of the agent.</p>
    * @public
    */
   description?: string;
 
   /**
-   * Routing configuration for an Agent alias.
+   * <p>Contains details about the routing configuration of the alias.</p>
    * @public
    */
   routingConfiguration?: AgentAliasRoutingConfigurationListItem[];
 
   /**
-   * A map of tag keys and values
+   * <p>Any tags that you want to attach to the alias of the agent.</p>
    * @public
    */
   tags?: Record<string, string>;
 }
 
 /**
- * Create Agent Alias Response
  * @public
  */
 export interface CreateAgentAliasResponse {
   /**
-   * Contains the information of an agent alias
+   * <p>Contains details about the alias that was created.</p>
    * @public
    */
   agentAlias: AgentAlias | undefined;
 }
 
 /**
- * Delete Agent Alias Request
  * @public
  */
 export interface DeleteAgentAliasRequest {
   /**
-   * Id generated at the server side when an Agent is created
+   * <p>The unique identifier of the agent that the alias belongs to.</p>
    * @public
    */
   agentId: string | undefined;
 
   /**
-   * Id generated at the server side when an Agent Alias is created
+   * <p>The unique identifier of the alias to delete.</p>
    * @public
    */
   agentAliasId: string | undefined;
 }
 
 /**
- * Delete Agent Alias Response
  * @public
  */
 export interface DeleteAgentAliasResponse {
   /**
-   * Identifier for a resource.
+   * <p>The unique identifier of the agent that the alias belongs to.</p>
    * @public
    */
   agentId: string | undefined;
 
   /**
-   * Id for an Agent Alias generated at the server side.
+   * <p>The unique identifier of the alias that was deleted.</p>
    * @public
    */
   agentAliasId: string | undefined;
 
   /**
-   * The statuses an Agent Alias can be in.
+   * <p>The status of the alias.</p>
    * @public
    */
   agentAliasStatus: AgentAliasStatus | undefined;
 }
 
 /**
- * Get Agent Alias Request
  * @public
  */
 export interface GetAgentAliasRequest {
   /**
-   * Id generated at the server side when an Agent is created
+   * <p>The unique identifier of the agent to which the alias to get information belongs.</p>
    * @public
    */
   agentId: string | undefined;
 
   /**
-   * Id generated at the server side when an Agent Alias is created
+   * <p>The unique identifier of the alias for which to get information.</p>
    * @public
    */
   agentAliasId: string | undefined;
 }
 
 /**
- * Get Agent Alias Response
  * @public
  */
 export interface GetAgentAliasResponse {
   /**
-   * Contains the information of an agent alias
+   * <p>Contains information about the alias.</p>
    * @public
    */
   agentAlias: AgentAlias | undefined;
 }
 
 /**
- * List Agent Aliases Request
  * @public
  */
 export interface ListAgentAliasesRequest {
   /**
-   * Id generated at the server side when an Agent is created
+   * <p>The unique identifier of the agent.</p>
    * @public
    */
   agentId: string | undefined;
 
   /**
-   * Max Results.
+   * <p>The maximum number of results to return in the response. If the total number of results is greater than this value, use the token returned in the response in the <code>nextToken</code> field when making another request to return the next batch of results.</p>
    * @public
    */
   maxResults?: number;
 
   /**
-   * Opaque continuation token of previous paginated response.
+   * <p>If the total number of results is greater than the <code>maxResults</code> value provided in the request, enter the token returned in the <code>nextToken</code> field in the response in this field to return the next batch of results.</p>
    * @public
    */
   nextToken?: string;
 }
 
 /**
- * List Agent Aliases Response
  * @public
  */
 export interface ListAgentAliasesResponse {
   /**
-   * The list of summaries of all the aliases for an Agent.
+   * <p>A list of objects, each of which contains information about an alias of the agent.</p>
    * @public
    */
   agentAliasSummaries: AgentAliasSummary[] | undefined;
 
   /**
-   * Opaque continuation token of previous paginated response.
+   * <p>If the total number of results is greater than the <code>maxResults</code> value provided in the request, use this token when making another request in the <code>nextToken</code> field to return the next batch of results.</p>
    * @public
    */
   nextToken?: string;
 }
 
 /**
- * Update Agent Alias Request
  * @public
  */
 export interface UpdateAgentAliasRequest {
   /**
-   * Id generated at the server side when an Agent is created
+   * <p>The unique identifier of the agent.</p>
    * @public
    */
   agentId: string | undefined;
 
   /**
-   * Id generated at the server side when an Agent Alias is created
+   * <p>The unique identifier of the alias.</p>
    * @public
    */
   agentAliasId: string | undefined;
 
   /**
-   * Name for a resource.
+   * <p>Specifies a new name for the alias.</p>
    * @public
    */
   agentAliasName: string | undefined;
 
   /**
-   * Description of the Resource.
+   * <p>Specifies a new description for the alias.</p>
    * @public
    */
   description?: string;
 
   /**
-   * Routing configuration for an Agent alias.
+   * <p>Contains details about the routing configuration of the alias.</p>
    * @public
    */
   routingConfiguration?: AgentAliasRoutingConfigurationListItem[];
 }
 
 /**
- * Update Agent Alias Response
  * @public
  */
 export interface UpdateAgentAliasResponse {
   /**
-   * Contains the information of an agent alias
+   * <p>Contains details about the alias that was updated.</p>
    * @public
    */
   agentAlias: AgentAlias | undefined;
 }
 
 /**
- * Configures an S3 data source location.
+ * <p>Contains information about the S3 configuration of the data source.</p>
  * @public
  */
 export interface S3DataSourceConfiguration {
   /**
-   * A S3 bucket ARN
+   * <p>The ARN of the bucket that contains the data source.</p>
    * @public
    */
   bucketArn: string | undefined;
 
   /**
-   * A list of S3 prefixes.
+   * <p>A list of S3 prefixes that define the object containing the data sources. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-prefixes.html">Organizing objects using prefixes</a>.</p>
    * @public
    */
   inclusionPrefixes?: string[];
@@ -1942,30 +1987,30 @@ export const DataSourceType = {
 export type DataSourceType = (typeof DataSourceType)[keyof typeof DataSourceType];
 
 /**
- * Specifies a raw data source location to ingest.
+ * <p>Contains details about how a data source is stored.</p>
  * @public
  */
 export interface DataSourceConfiguration {
   /**
-   * The type of the data source location.
+   * <p>The type of storage for the data source.</p>
    * @public
    */
   type: DataSourceType | undefined;
 
   /**
-   * Configures an S3 data source location.
+   * <p>Contains details about the configuration of the S3 object containing the data source.</p>
    * @public
    */
   s3Configuration?: S3DataSourceConfiguration;
 }
 
 /**
- * Server-side encryption configuration.
+ * <p>Contains the configuration for server-side encryption.</p>
  * @public
  */
 export interface ServerSideEncryptionConfiguration {
   /**
-   * A KMS key ARN
+   * <p>The ARN of the KMS key used to encrypt the resource.</p>
    * @public
    */
   kmsKeyArn?: string;
@@ -1986,48 +2031,58 @@ export const ChunkingStrategy = {
 export type ChunkingStrategy = (typeof ChunkingStrategy)[keyof typeof ChunkingStrategy];
 
 /**
- * Configures fixed size chunking strategy
+ * <p>Configurations for when you choose fixed-size chunking. If you set the <code>chunkingStrategy</code> as <code>NONE</code>, exclude this field.</p>
  * @public
  */
 export interface FixedSizeChunkingConfiguration {
   /**
-   * The maximum number of tokens per chunk.
+   * <p>The maximum number of tokens to include in a chunk.</p>
    * @public
    */
   maxTokens: number | undefined;
 
   /**
-   * The overlap percentage between adjacent chunks.
+   * <p>The percentage of overlap between adjacent chunks of a data source.</p>
    * @public
    */
   overlapPercentage: number | undefined;
 }
 
 /**
- * Configures chunking strategy
+ * <p>Details about how to chunk the documents in the data source. A <i>chunk</i> refers to an excerpt from a data source that is returned when the knowledge base that it belongs to is queried.</p>
  * @public
  */
 export interface ChunkingConfiguration {
   /**
-   * The type of chunking strategy
+   * <p>Knowledge base can split your source data into chunks. A <i>chunk</i> refers to an excerpt from a data source that is returned when the knowledge base that it belongs to is queried. You have the following options for chunking your data. If you opt for <code>NONE</code>, then you may want to pre-process your files by splitting them up such that each file corresponds to a chunk.</p>
+   *          <ul>
+   *             <li>
+   *                <p>
+   *                   <code>FIXED_SIZE</code> – Amazon Bedrock splits your source data into chunks of the approximate size that you set in the <code>fixedSizeChunkingConfiguration</code>.</p>
+   *             </li>
+   *             <li>
+   *                <p>
+   *                   <code>NONE</code> – Amazon Bedrock treats each file as one chunk. If you choose this option, you may want to pre-process your documents by splitting them into separate files.</p>
+   *             </li>
+   *          </ul>
    * @public
    */
   chunkingStrategy: ChunkingStrategy | undefined;
 
   /**
-   * Configures fixed size chunking strategy
+   * <p>Configurations for when you choose fixed-size chunking. If you set the <code>chunkingStrategy</code> as <code>NONE</code>, exclude this field.</p>
    * @public
    */
   fixedSizeChunkingConfiguration?: FixedSizeChunkingConfiguration;
 }
 
 /**
- * Configures ingestion for a vector knowledge base
+ * <p>Contains details about how to ingest the documents in a data source.</p>
  * @public
  */
 export interface VectorIngestionConfiguration {
   /**
-   * Configures chunking strategy
+   * <p>Details about how to chunk the documents in the data source. A <i>chunk</i> refers to an excerpt from a data source that is returned when the knowledge base that it belongs to is queried.</p>
    * @public
    */
   chunkingConfiguration?: ChunkingConfiguration;
@@ -2038,43 +2093,44 @@ export interface VectorIngestionConfiguration {
  */
 export interface CreateDataSourceRequest {
   /**
-   * Identifier for a resource.
+   * <p>The unique identifier of the knowledge base to which to add the data source.</p>
    * @public
    */
   knowledgeBaseId: string | undefined;
 
   /**
-   * Client specified token used for idempotency checks
+   * <p>A unique, case-sensitive identifier to ensure that the API request completes no more than one time. If this token matches a previous request,
+   *       Amazon Bedrock ignores the request, but does not return an error. For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/APIReference/Run_Instance_Idempotency.html">Ensuring idempotency</a>.</p>
    * @public
    */
   clientToken?: string;
 
   /**
-   * Name for a resource.
+   * <p>The name of the data source.</p>
    * @public
    */
   name: string | undefined;
 
   /**
-   * Description of the Resource.
+   * <p>A description of the data source.</p>
    * @public
    */
   description?: string;
 
   /**
-   * Specifies a raw data source location to ingest.
+   * <p>Contains metadata about where the data source is stored.</p>
    * @public
    */
   dataSourceConfiguration: DataSourceConfiguration | undefined;
 
   /**
-   * Server-side encryption configuration.
+   * <p>Contains details about the server-side encryption for the data source.</p>
    * @public
    */
   serverSideEncryptionConfiguration?: ServerSideEncryptionConfiguration;
 
   /**
-   * Configures ingestion for a vector knowledge base
+   * <p>Contains details about how to ingest the documents in the data source.</p>
    * @public
    */
   vectorIngestionConfiguration?: VectorIngestionConfiguration;
@@ -2095,66 +2151,74 @@ export const DataSourceStatus = {
 export type DataSourceStatus = (typeof DataSourceStatus)[keyof typeof DataSourceStatus];
 
 /**
- * Contains the information of a data source.
+ * <p>Contains details about a data source.</p>
  * @public
  */
 export interface DataSource {
   /**
-   * Identifier for a resource.
+   * <p>The unique identifier of the knowledge base to which the data source belongs.</p>
    * @public
    */
   knowledgeBaseId: string | undefined;
 
   /**
-   * Identifier for a resource.
+   * <p>The unique identifier of the data source.</p>
    * @public
    */
   dataSourceId: string | undefined;
 
   /**
-   * Name for a resource.
+   * <p>The name of the data source.</p>
    * @public
    */
   name: string | undefined;
 
   /**
-   * The status of a data source.
+   * <p>The status of the data source. The following statuses are possible:</p>
+   *          <ul>
+   *             <li>
+   *                <p>Available – The data source has been created and is ready for ingestion into the knowledge base.</p>
+   *             </li>
+   *             <li>
+   *                <p>Deleting – The data source is being deleted.</p>
+   *             </li>
+   *          </ul>
    * @public
    */
   status: DataSourceStatus | undefined;
 
   /**
-   * Description of the Resource.
+   * <p>The description of the data source.</p>
    * @public
    */
   description?: string;
 
   /**
-   * Specifies a raw data source location to ingest.
+   * <p>Contains details about how the data source is stored.</p>
    * @public
    */
   dataSourceConfiguration: DataSourceConfiguration | undefined;
 
   /**
-   * Server-side encryption configuration.
+   * <p>Contains details about the configuration of the server-side encryption.</p>
    * @public
    */
   serverSideEncryptionConfiguration?: ServerSideEncryptionConfiguration;
 
   /**
-   * Configures ingestion for a vector knowledge base
+   * <p>Contains details about how to ingest the documents in the data source.</p>
    * @public
    */
   vectorIngestionConfiguration?: VectorIngestionConfiguration;
 
   /**
-   * Time Stamp.
+   * <p>The time at which the data source was created.</p>
    * @public
    */
   createdAt: Date | undefined;
 
   /**
-   * Time Stamp.
+   * <p>The time at which the data source was last updated.</p>
    * @public
    */
   updatedAt: Date | undefined;
@@ -2165,7 +2229,7 @@ export interface DataSource {
  */
 export interface CreateDataSourceResponse {
   /**
-   * Contains the information of a data source.
+   * <p>Contains details about the data source.</p>
    * @public
    */
   dataSource: DataSource | undefined;
@@ -2176,13 +2240,13 @@ export interface CreateDataSourceResponse {
  */
 export interface DeleteDataSourceRequest {
   /**
-   * Identifier for a resource.
+   * <p>The unique identifier of the knowledge base from which to delete the data source.</p>
    * @public
    */
   knowledgeBaseId: string | undefined;
 
   /**
-   * Identifier for a resource.
+   * <p>The unique identifier of the data source to delete.</p>
    * @public
    */
   dataSourceId: string | undefined;
@@ -2193,19 +2257,19 @@ export interface DeleteDataSourceRequest {
  */
 export interface DeleteDataSourceResponse {
   /**
-   * Identifier for a resource.
+   * <p>The unique identifier of the knowledge base to which the data source that was deleted belonged.</p>
    * @public
    */
   knowledgeBaseId: string | undefined;
 
   /**
-   * Identifier for a resource.
+   * <p>The unique identifier of the data source that was deleted.</p>
    * @public
    */
   dataSourceId: string | undefined;
 
   /**
-   * The status of a data source.
+   * <p>The status of the data source.</p>
    * @public
    */
   status: DataSourceStatus | undefined;
@@ -2216,13 +2280,13 @@ export interface DeleteDataSourceResponse {
  */
 export interface GetDataSourceRequest {
   /**
-   * Identifier for a resource.
+   * <p>The unique identifier of the knowledge base that the data source was added to.</p>
    * @public
    */
   knowledgeBaseId: string | undefined;
 
   /**
-   * Identifier for a resource.
+   * <p>The unique identifier of the data source.</p>
    * @public
    */
   dataSourceId: string | undefined;
@@ -2233,7 +2297,7 @@ export interface GetDataSourceRequest {
  */
 export interface GetDataSourceResponse {
   /**
-   * Contains the information of a data source.
+   * <p>Contains details about the data source.</p>
    * @public
    */
   dataSource: DataSource | undefined;
@@ -2244,61 +2308,61 @@ export interface GetDataSourceResponse {
  */
 export interface ListDataSourcesRequest {
   /**
-   * Identifier for a resource.
+   * <p>The unique identifier of the knowledge base for which to return a list of information.</p>
    * @public
    */
   knowledgeBaseId: string | undefined;
 
   /**
-   * Max Results.
+   * <p>The maximum number of results to return in the response. If the total number of results is greater than this value, use the token returned in the response in the <code>nextToken</code> field when making another request to return the next batch of results.</p>
    * @public
    */
   maxResults?: number;
 
   /**
-   * Opaque continuation token of previous paginated response.
+   * <p>If the total number of results is greater than the <code>maxResults</code> value provided in the request, enter the token returned in the <code>nextToken</code> field in the response in this field to return the next batch of results.</p>
    * @public
    */
   nextToken?: string;
 }
 
 /**
- * Summary information of a data source.
+ * <p>Contains details about a data source.</p>
  * @public
  */
 export interface DataSourceSummary {
   /**
-   * Identifier for a resource.
+   * <p>The unique identifier of the knowledge base to which the data source belongs.</p>
    * @public
    */
   knowledgeBaseId: string | undefined;
 
   /**
-   * Identifier for a resource.
+   * <p>The unique identifier of the data source.</p>
    * @public
    */
   dataSourceId: string | undefined;
 
   /**
-   * Name for a resource.
+   * <p>The name of the data source.</p>
    * @public
    */
   name: string | undefined;
 
   /**
-   * The status of a data source.
+   * <p>The status of the data source.</p>
    * @public
    */
   status: DataSourceStatus | undefined;
 
   /**
-   * Description of the Resource.
+   * <p>The description of the data source.</p>
    * @public
    */
   description?: string;
 
   /**
-   * Time Stamp.
+   * <p>The time at which the data source was last updated.</p>
    * @public
    */
   updatedAt: Date | undefined;
@@ -2309,13 +2373,13 @@ export interface DataSourceSummary {
  */
 export interface ListDataSourcesResponse {
   /**
-   * list of data source summaries
+   * <p>A list of objects, each of which contains information about a data source.</p>
    * @public
    */
   dataSourceSummaries: DataSourceSummary[] | undefined;
 
   /**
-   * Opaque continuation token of previous paginated response.
+   * <p>If the total number of results is greater than the <code>maxResults</code> value provided in the request, use this token when making another request in the <code>nextToken</code> field to return the next batch of results.</p>
    * @public
    */
   nextToken?: string;
@@ -2326,43 +2390,43 @@ export interface ListDataSourcesResponse {
  */
 export interface UpdateDataSourceRequest {
   /**
-   * Identifier for a resource.
+   * <p>The unique identifier of the knowledge base to which the data source belongs.</p>
    * @public
    */
   knowledgeBaseId: string | undefined;
 
   /**
-   * Identifier for a resource.
+   * <p>The unique identifier of the data source.</p>
    * @public
    */
   dataSourceId: string | undefined;
 
   /**
-   * Name for a resource.
+   * <p>Specifies a new name for the data source.</p>
    * @public
    */
   name: string | undefined;
 
   /**
-   * Description of the Resource.
+   * <p>Specifies a new description for the data source.</p>
    * @public
    */
   description?: string;
 
   /**
-   * Specifies a raw data source location to ingest.
+   * <p>Contains details about the storage configuration of the data source.</p>
    * @public
    */
   dataSourceConfiguration: DataSourceConfiguration | undefined;
 
   /**
-   * Server-side encryption configuration.
+   * <p>Contains details about server-side encryption of the data source.</p>
    * @public
    */
   serverSideEncryptionConfiguration?: ServerSideEncryptionConfiguration;
 
   /**
-   * Configures ingestion for a vector knowledge base
+   * <p>Contains details about how to ingest the documents in the data source.</p>
    * @public
    */
   vectorIngestionConfiguration?: VectorIngestionConfiguration;
@@ -2373,7 +2437,7 @@ export interface UpdateDataSourceRequest {
  */
 export interface UpdateDataSourceResponse {
   /**
-   * Contains the information of a data source.
+   * <p>Contains details about the data source.</p>
    * @public
    */
   dataSource: DataSource | undefined;
@@ -2384,55 +2448,67 @@ export interface UpdateDataSourceResponse {
  */
 export interface GetIngestionJobRequest {
   /**
-   * Identifier for a resource.
+   * <p>The unique identifier of the knowledge base for which the ingestion job applies.</p>
    * @public
    */
   knowledgeBaseId: string | undefined;
 
   /**
-   * Identifier for a resource.
+   * <p>The unique identifier of the data source in the ingestion job.</p>
    * @public
    */
   dataSourceId: string | undefined;
 
   /**
-   * Identifier for a resource.
+   * <p>The unique identifier of the ingestion job.</p>
    * @public
    */
   ingestionJobId: string | undefined;
 }
 
 /**
- * The document level statistics of an ingestion job
+ * <p>Contains the statistics for the ingestion job.</p>
  * @public
  */
 export interface IngestionJobStatistics {
   /**
-   * Number of scanned documents
+   * <p>The total number of source documents that were scanned. Includes new, updated, and unchanged documents.</p>
    * @public
    */
   numberOfDocumentsScanned?: number;
 
   /**
-   * Number of indexed documents
+   * <p>The total number of metadata files that were scanned. Includes new, updated, and unchanged files.</p>
+   * @public
+   */
+  numberOfMetadataDocumentsScanned?: number;
+
+  /**
+   * <p>The number of new source documents in the data source that were successfully indexed.</p>
    * @public
    */
   numberOfNewDocumentsIndexed?: number;
 
   /**
-   * Number of modified documents indexed
+   * <p>The number of modified source documents in the data source that were successfully indexed.</p>
    * @public
    */
   numberOfModifiedDocumentsIndexed?: number;
 
   /**
-   * Number of deleted documents
+   * <p>The number of metadata files that were updated or deleted.</p>
+   * @public
+   */
+  numberOfMetadataDocumentsModified?: number;
+
+  /**
+   * <p>The number of source documents that was deleted.</p>
    * @public
    */
   numberOfDocumentsDeleted?: number;
 
   /**
-   * Number of failed documents
+   * <p>The number of source documents that failed to be ingested.</p>
    * @public
    */
   numberOfDocumentsFailed?: number;
@@ -2455,60 +2531,78 @@ export const IngestionJobStatus = {
 export type IngestionJobStatus = (typeof IngestionJobStatus)[keyof typeof IngestionJobStatus];
 
 /**
- * Contains the information of an ingestion job.
+ * <p>Contains details about an ingestion job, which converts a data source to embeddings for a vector store in knowledge base.</p>
+ *          <p>This data type is used in the following API operations:</p>
+ *          <ul>
+ *             <li>
+ *                <p>
+ *                   <a href="https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_StartIngestionJob.html#API_agent_StartIngestionJob_ResponseSyntax">StartIngestionJob response</a>
+ *                </p>
+ *             </li>
+ *             <li>
+ *                <p>
+ *                   <a href="https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_GetIngestionJob.html#API_agent_GetIngestionJob_ResponseSyntax">GetIngestionJob response</a>
+ *                </p>
+ *             </li>
+ *             <li>
+ *                <p>
+ *                   <a href="https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_ListIngestionJob.html#API_agent_ListIngestionJob_ResponseSyntax">ListIngestionJob response</a>
+ *                </p>
+ *             </li>
+ *          </ul>
  * @public
  */
 export interface IngestionJob {
   /**
-   * Identifier for a resource.
+   * <p>The unique identifier of the knowledge base to which the data source is being added.</p>
    * @public
    */
   knowledgeBaseId: string | undefined;
 
   /**
-   * Identifier for a resource.
+   * <p>The unique identifier of the ingested data source.</p>
    * @public
    */
   dataSourceId: string | undefined;
 
   /**
-   * Identifier for a resource.
+   * <p>The unique identifier of the ingestion job.</p>
    * @public
    */
   ingestionJobId: string | undefined;
 
   /**
-   * Description of the Resource.
+   * <p>The description of the ingestion job.</p>
    * @public
    */
   description?: string;
 
   /**
-   * The status of an ingestion job.
+   * <p>The status of the ingestion job.</p>
    * @public
    */
   status: IngestionJobStatus | undefined;
 
   /**
-   * The document level statistics of an ingestion job
+   * <p>Contains statistics about the ingestion job.</p>
    * @public
    */
   statistics?: IngestionJobStatistics;
 
   /**
-   * Failure Reasons for Error.
+   * <p>A list of reasons that the ingestion job failed.</p>
    * @public
    */
   failureReasons?: string[];
 
   /**
-   * Time Stamp.
+   * <p>The time at which the ingestion job started.</p>
    * @public
    */
   startedAt: Date | undefined;
 
   /**
-   * Time Stamp.
+   * <p>The time at which the ingestion job was last updated.</p>
    * @public
    */
   updatedAt: Date | undefined;
@@ -2519,7 +2613,7 @@ export interface IngestionJob {
  */
 export interface GetIngestionJobResponse {
   /**
-   * Contains the information of an ingestion job.
+   * <p>Contains details about the ingestion job.</p>
    * @public
    */
   ingestionJob: IngestionJob | undefined;
@@ -2553,24 +2647,24 @@ export const IngestionJobFilterOperator = {
 export type IngestionJobFilterOperator = (typeof IngestionJobFilterOperator)[keyof typeof IngestionJobFilterOperator];
 
 /**
- * Filters the response returned by ListIngestionJobs operation.
+ * <p>Defines a filter by which to filter the results.</p>
  * @public
  */
 export interface IngestionJobFilter {
   /**
-   * The name of the field to filter ingestion jobs.
+   * <p>The attribute by which to filter the results.</p>
    * @public
    */
   attribute: IngestionJobFilterAttribute | undefined;
 
   /**
-   * The operator used to filter ingestion jobs.
+   * <p>The operation to carry out between the attribute and the values.</p>
    * @public
    */
   operator: IngestionJobFilterOperator | undefined;
 
   /**
-   * The list of values used to filter ingestion jobs.
+   * <p>A list of values for the attribute.</p>
    * @public
    */
   values: string[] | undefined;
@@ -2606,18 +2700,18 @@ export const SortOrder = {
 export type SortOrder = (typeof SortOrder)[keyof typeof SortOrder];
 
 /**
- * Sorts the response returned by ListIngestionJobs operation.
+ * <p>Parameters by which to sort the results.</p>
  * @public
  */
 export interface IngestionJobSortBy {
   /**
-   * The name of the field to sort ingestion jobs.
+   * <p>The attribute by which to sort the results.</p>
    * @public
    */
   attribute: IngestionJobSortByAttribute | undefined;
 
   /**
-   * Order to sort results by.
+   * <p>The order by which to sort the results.</p>
    * @public
    */
   order: SortOrder | undefined;
@@ -2628,91 +2722,91 @@ export interface IngestionJobSortBy {
  */
 export interface ListIngestionJobsRequest {
   /**
-   * Identifier for a resource.
+   * <p>The unique identifier of the knowledge base for which to return ingestion jobs.</p>
    * @public
    */
   knowledgeBaseId: string | undefined;
 
   /**
-   * Identifier for a resource.
+   * <p>The unique identifier of the data source for which to return ingestion jobs.</p>
    * @public
    */
   dataSourceId: string | undefined;
 
   /**
-   * List of IngestionJobFilters
+   * <p>Contains a definition of a filter for which to filter the results.</p>
    * @public
    */
   filters?: IngestionJobFilter[];
 
   /**
-   * Sorts the response returned by ListIngestionJobs operation.
+   * <p>Contains details about how to sort the results.</p>
    * @public
    */
   sortBy?: IngestionJobSortBy;
 
   /**
-   * Max Results.
+   * <p>The maximum number of results to return in the response. If the total number of results is greater than this value, use the token returned in the response in the <code>nextToken</code> field when making another request to return the next batch of results.</p>
    * @public
    */
   maxResults?: number;
 
   /**
-   * Opaque continuation token of previous paginated response.
+   * <p>If the total number of results is greater than the <code>maxResults</code> value provided in the request, enter the token returned in the <code>nextToken</code> field in the response in this field to return the next batch of results.</p>
    * @public
    */
   nextToken?: string;
 }
 
 /**
- * Summary information of an ingestion job.
+ * <p>Contains details about an ingestion job.</p>
  * @public
  */
 export interface IngestionJobSummary {
   /**
-   * Identifier for a resource.
+   * <p>The unique identifier of the knowledge base to which the data source is added.</p>
    * @public
    */
   knowledgeBaseId: string | undefined;
 
   /**
-   * Identifier for a resource.
+   * <p>The unique identifier of the data source in the ingestion job.</p>
    * @public
    */
   dataSourceId: string | undefined;
 
   /**
-   * Identifier for a resource.
+   * <p>The unique identifier of the ingestion job.</p>
    * @public
    */
   ingestionJobId: string | undefined;
 
   /**
-   * Description of the Resource.
+   * <p>The description of the ingestion job.</p>
    * @public
    */
   description?: string;
 
   /**
-   * The status of an ingestion job.
+   * <p>The status of the ingestion job.</p>
    * @public
    */
   status: IngestionJobStatus | undefined;
 
   /**
-   * Time Stamp.
+   * <p>The time at which the ingestion job was started.</p>
    * @public
    */
   startedAt: Date | undefined;
 
   /**
-   * Time Stamp.
+   * <p>The time at which the ingestion job was last updated.</p>
    * @public
    */
   updatedAt: Date | undefined;
 
   /**
-   * The document level statistics of an ingestion job
+   * <p>Contains statistics for the ingestion job.</p>
    * @public
    */
   statistics?: IngestionJobStatistics;
@@ -2723,13 +2817,13 @@ export interface IngestionJobSummary {
  */
 export interface ListIngestionJobsResponse {
   /**
-   * List of IngestionJobSummaries
+   * <p>A list of objects, each of which contains information about an ingestion job.</p>
    * @public
    */
   ingestionJobSummaries: IngestionJobSummary[] | undefined;
 
   /**
-   * Opaque continuation token of previous paginated response.
+   * <p>If the total number of results is greater than the <code>maxResults</code> value provided in the request, use this token when making another request in the <code>nextToken</code> field to return the next batch of results.</p>
    * @public
    */
   nextToken?: string;
@@ -2740,25 +2834,26 @@ export interface ListIngestionJobsResponse {
  */
 export interface StartIngestionJobRequest {
   /**
-   * Identifier for a resource.
+   * <p>The unique identifier of the knowledge base to which to add the data source.</p>
    * @public
    */
   knowledgeBaseId: string | undefined;
 
   /**
-   * Identifier for a resource.
+   * <p>The unique identifier of the data source to ingest.</p>
    * @public
    */
   dataSourceId: string | undefined;
 
   /**
-   * Client specified token used for idempotency checks
+   * <p>A unique, case-sensitive identifier to ensure that the API request completes no more than one time. If this token matches a previous request,
+   *       Amazon Bedrock ignores the request, but does not return an error. For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/APIReference/Run_Instance_Idempotency.html">Ensuring idempotency</a>.</p>
    * @public
    */
   clientToken?: string;
 
   /**
-   * Description of the Resource.
+   * <p>A description of the ingestion job.</p>
    * @public
    */
   description?: string;
@@ -2769,55 +2864,53 @@ export interface StartIngestionJobRequest {
  */
 export interface StartIngestionJobResponse {
   /**
-   * Contains the information of an ingestion job.
+   * <p>An object containing information about the ingestion job.</p>
    * @public
    */
   ingestionJob: IngestionJob | undefined;
 }
 
 /**
- * Associate Agent Knowledge Base Request
  * @public
  */
 export interface AssociateAgentKnowledgeBaseRequest {
   /**
-   * Id generated at the server side when an Agent is created
+   * <p>The unique identifier of the agent with which you want to associate the knowledge base.</p>
    * @public
    */
   agentId: string | undefined;
 
   /**
-   * Draft Version of the Agent.
+   * <p>The version of the agent with which you want to associate the knowledge base.</p>
    * @public
    */
   agentVersion: string | undefined;
 
   /**
-   * Identifier for a resource.
+   * <p>The unique identifier of the knowledge base to associate with the agent.</p>
    * @public
    */
   knowledgeBaseId: string | undefined;
 
   /**
-   * Description of the Resource.
+   * <p>A description of what the agent should use the knowledge base for.</p>
    * @public
    */
   description: string | undefined;
 
   /**
-   * State of the knowledge base; whether it is enabled or disabled
+   * <p>Specifies whether to use the knowledge base or not when sending an <a href="https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvokeAgent.html">InvokeAgent</a> request.</p>
    * @public
    */
   knowledgeBaseState?: KnowledgeBaseState;
 }
 
 /**
- * Associate Agent Knowledge Base Response
  * @public
  */
 export interface AssociateAgentKnowledgeBaseResponse {
   /**
-   * Contains the information of an Agent Knowledge Base.
+   * <p>Contains details about the knowledge base that has been associated with the agent.</p>
    * @public
    */
   agentKnowledgeBase: AgentKnowledgeBase | undefined;
@@ -2837,246 +2930,246 @@ export const KnowledgeBaseType = {
 export type KnowledgeBaseType = (typeof KnowledgeBaseType)[keyof typeof KnowledgeBaseType];
 
 /**
- * Configurations for a vector knowledge base.
+ * <p>Contains details about the model used to create vector embeddings for the knowledge base.</p>
  * @public
  */
 export interface VectorKnowledgeBaseConfiguration {
   /**
-   * Arn of a Bedrock model.
+   * <p>The ARN of the model used to create vector embeddings for the knowledge base.</p>
    * @public
    */
   embeddingModelArn: string | undefined;
 }
 
 /**
- * Configures a bedrock knowledge base.
+ * <p>Contains details about the embeddings configuration of the knowledge base.</p>
  * @public
  */
 export interface KnowledgeBaseConfiguration {
   /**
-   * The type of a knowledge base.
+   * <p>The type of data that the data source is converted into for the knowledge base.</p>
    * @public
    */
   type: KnowledgeBaseType | undefined;
 
   /**
-   * Configurations for a vector knowledge base.
+   * <p>Contains details about the embeddings model that'sused to convert the data source.</p>
    * @public
    */
   vectorKnowledgeBaseConfiguration?: VectorKnowledgeBaseConfiguration;
 }
 
 /**
- * A mapping of Bedrock Knowledge Base fields to OpenSearch Serverless field names
+ * <p>Contains the names of the fields to which to map information about the vector store.</p>
  * @public
  */
 export interface OpenSearchServerlessFieldMapping {
   /**
-   * Name of the field
+   * <p>The name of the field in which Amazon Bedrock stores the vector embeddings for your data sources.</p>
    * @public
    */
   vectorField: string | undefined;
 
   /**
-   * Name of the field
+   * <p>The name of the field in which Amazon Bedrock stores the raw text from your data. The text is split according to the chunking strategy you choose.</p>
    * @public
    */
   textField: string | undefined;
 
   /**
-   * Name of the field
+   * <p>The name of the field in which Amazon Bedrock stores metadata about the vector store.</p>
    * @public
    */
   metadataField: string | undefined;
 }
 
 /**
- * Contains the configurations to use OpenSearch Serverless to store knowledge base data.
+ * <p>Contains details about the storage configuration of the knowledge base in Amazon OpenSearch Service. For more information, see <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/knowledge-base-setup-oss.html">Create a vector index in Amazon OpenSearch Service</a>.</p>
  * @public
  */
 export interface OpenSearchServerlessConfiguration {
   /**
-   * Arn of an OpenSearch Serverless collection.
+   * <p>The ARN of the OpenSearch Service vector store.</p>
    * @public
    */
   collectionArn: string | undefined;
 
   /**
-   * Arn of an OpenSearch Serverless index.
+   * <p>The name of the vector store.</p>
    * @public
    */
   vectorIndexName: string | undefined;
 
   /**
-   * A mapping of Bedrock Knowledge Base fields to OpenSearch Serverless field names
+   * <p>Contains the names of the fields to which to map information about the vector store.</p>
    * @public
    */
   fieldMapping: OpenSearchServerlessFieldMapping | undefined;
 }
 
 /**
- * A mapping of Bedrock Knowledge Base fields to Pinecone field names
+ * <p>Contains the names of the fields to which to map information about the vector store.</p>
  * @public
  */
 export interface PineconeFieldMapping {
   /**
-   * Name of the field
+   * <p>The name of the field in which Amazon Bedrock stores the raw text from your data. The text is split according to the chunking strategy you choose.</p>
    * @public
    */
   textField: string | undefined;
 
   /**
-   * Name of the field
+   * <p>The name of the field in which Amazon Bedrock stores metadata about the vector store.</p>
    * @public
    */
   metadataField: string | undefined;
 }
 
 /**
- * Contains the configurations to use Pinecone to store knowledge base data.
+ * <p>Contains details about the storage configuration of the knowledge base in Pinecone. For more information, see <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/knowledge-base-setup-pinecone.html">Create a vector index in Pinecone</a>.</p>
  * @public
  */
 export interface PineconeConfiguration {
   /**
-   * Pinecone connection string
+   * <p>The endpoint URL for your index management page.</p>
    * @public
    */
   connectionString: string | undefined;
 
   /**
-   * Arn of a SecretsManager Secret.
+   * <p>The ARN of the secret that you created in Secrets Manager that is linked to your Pinecone API key.</p>
    * @public
    */
   credentialsSecretArn: string | undefined;
 
   /**
-   * Pinecone namespace
+   * <p>The namespace to be used to write new data to your database.</p>
    * @public
    */
   namespace?: string;
 
   /**
-   * A mapping of Bedrock Knowledge Base fields to Pinecone field names
+   * <p>Contains the names of the fields to which to map information about the vector store.</p>
    * @public
    */
   fieldMapping: PineconeFieldMapping | undefined;
 }
 
 /**
- * A mapping of Bedrock Knowledge Base fields to RDS column names
+ * <p>Contains the names of the fields to which to map information about the vector store.</p>
  * @public
  */
 export interface RdsFieldMapping {
   /**
-   * Name of the column
+   * <p>The name of the field in which Amazon Bedrock stores the ID for each entry.</p>
    * @public
    */
   primaryKeyField: string | undefined;
 
   /**
-   * Name of the column
+   * <p>The name of the field in which Amazon Bedrock stores the vector embeddings for your data sources.</p>
    * @public
    */
   vectorField: string | undefined;
 
   /**
-   * Name of the column
+   * <p>The name of the field in which Amazon Bedrock stores the raw text from your data. The text is split according to the chunking strategy you choose.</p>
    * @public
    */
   textField: string | undefined;
 
   /**
-   * Name of the column
+   * <p>The name of the field in which Amazon Bedrock stores metadata about the vector store.</p>
    * @public
    */
   metadataField: string | undefined;
 }
 
 /**
- * Contains the configurations to use RDS to store knowledge base data.
+ * <p>Contains details about the storage configuration of the knowledge base in Amazon RDS. For more information, see <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/knowledge-base-setup-rds.html">Create a vector index in Amazon RDS</a>.</p>
  * @public
  */
 export interface RdsConfiguration {
   /**
-   * Arn of a RDS Resource.
+   * <p>The ARN of the vector store.</p>
    * @public
    */
   resourceArn: string | undefined;
 
   /**
-   * Arn of a SecretsManager Secret.
+   * <p>The ARN of the secret that you created in Secrets Manager that is linked to your Amazon RDS database.</p>
    * @public
    */
   credentialsSecretArn: string | undefined;
 
   /**
-   * Name of the database within RDS
+   * <p>The name of your Amazon RDS database.</p>
    * @public
    */
   databaseName: string | undefined;
 
   /**
-   * Name of the table within RDS
+   * <p>The name of the table in the database.</p>
    * @public
    */
   tableName: string | undefined;
 
   /**
-   * A mapping of Bedrock Knowledge Base fields to RDS column names
+   * <p>Contains the names of the fields to which to map information about the vector store.</p>
    * @public
    */
   fieldMapping: RdsFieldMapping | undefined;
 }
 
 /**
- * A mapping of Bedrock Knowledge Base fields to Redis Cloud field names
+ * <p>Contains the names of the fields to which to map information about the vector store.</p>
  * @public
  */
 export interface RedisEnterpriseCloudFieldMapping {
   /**
-   * Name of the field
+   * <p>The name of the field in which Amazon Bedrock stores the vector embeddings for your data sources.</p>
    * @public
    */
   vectorField: string | undefined;
 
   /**
-   * Name of the field
+   * <p>The name of the field in which Amazon Bedrock stores the raw text from your data. The text is split according to the chunking strategy you choose.</p>
    * @public
    */
   textField: string | undefined;
 
   /**
-   * Name of the field
+   * <p>The name of the field in which Amazon Bedrock stores metadata about the vector store.</p>
    * @public
    */
   metadataField: string | undefined;
 }
 
 /**
- * Contains the configurations to use Redis Enterprise Cloud to store knowledge base data.
+ * <p>Contains details about the storage configuration of the knowledge base in Redis Enterprise Cloud. For more information, see <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/knowledge-base-setup-oss.html">Create a vector index in Redis Enterprise Cloud</a>.</p>
  * @public
  */
 export interface RedisEnterpriseCloudConfiguration {
   /**
-   * Redis enterprise cloud endpoint
+   * <p>The endpoint URL of the Redis Enterprise Cloud database.</p>
    * @public
    */
   endpoint: string | undefined;
 
   /**
-   * Name of a redis enterprise cloud index
+   * <p>The name of the vector index.</p>
    * @public
    */
   vectorIndexName: string | undefined;
 
   /**
-   * Arn of a SecretsManager Secret.
+   * <p>The ARN of the secret that you created in Secrets Manager that is linked to your Redis Enterprise Cloud database.</p>
    * @public
    */
   credentialsSecretArn: string | undefined;
 
   /**
-   * A mapping of Bedrock Knowledge Base fields to Redis Cloud field names
+   * <p>Contains the names of the fields to which to map information about the vector store.</p>
    * @public
    */
   fieldMapping: RedisEnterpriseCloudFieldMapping | undefined;
@@ -3099,36 +3192,36 @@ export const KnowledgeBaseStorageType = {
 export type KnowledgeBaseStorageType = (typeof KnowledgeBaseStorageType)[keyof typeof KnowledgeBaseStorageType];
 
 /**
- * Configures the physical storage of ingested data in a knowledge base.
+ * <p>Contains the storage configuration of the knowledge base.</p>
  * @public
  */
 export interface StorageConfiguration {
   /**
-   * The storage type of a knowledge base.
+   * <p>The vector store service in which the knowledge base is stored.</p>
    * @public
    */
   type: KnowledgeBaseStorageType | undefined;
 
   /**
-   * Contains the configurations to use OpenSearch Serverless to store knowledge base data.
+   * <p>Contains the storage configuration of the knowledge base in Amazon OpenSearch Service.</p>
    * @public
    */
   opensearchServerlessConfiguration?: OpenSearchServerlessConfiguration;
 
   /**
-   * Contains the configurations to use Pinecone to store knowledge base data.
+   * <p>Contains the storage configuration of the knowledge base in Pinecone.</p>
    * @public
    */
   pineconeConfiguration?: PineconeConfiguration;
 
   /**
-   * Contains the configurations to use Redis Enterprise Cloud to store knowledge base data.
+   * <p>Contains the storage configuration of the knowledge base in Redis Enterprise Cloud.</p>
    * @public
    */
   redisEnterpriseCloudConfiguration?: RedisEnterpriseCloudConfiguration;
 
   /**
-   * Contains the configurations to use RDS to store knowledge base data.
+   * <p>Contains details about the storage configuration of the knowledge base in Amazon RDS. For more information, see <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/knowledge-base-setup-rds.html">Create a vector index in Amazon RDS</a>.</p>
    * @public
    */
   rdsConfiguration?: RdsConfiguration;
@@ -3139,43 +3232,44 @@ export interface StorageConfiguration {
  */
 export interface CreateKnowledgeBaseRequest {
   /**
-   * Client specified token used for idempotency checks
+   * <p>A unique, case-sensitive identifier to ensure that the API request completes no more than one time. If this token matches a previous request,
+   *       Amazon Bedrock ignores the request, but does not return an error. For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/APIReference/Run_Instance_Idempotency.html">Ensuring idempotency</a>.</p>
    * @public
    */
   clientToken?: string;
 
   /**
-   * Name for a resource.
+   * <p>A name for the knowledge base.</p>
    * @public
    */
   name: string | undefined;
 
   /**
-   * Description of the Resource.
+   * <p>A description of the knowledge base.</p>
    * @public
    */
   description?: string;
 
   /**
-   * ARN of a IAM role.
+   * <p>The ARN of the IAM role with permissions to create the knowledge base.</p>
    * @public
    */
   roleArn: string | undefined;
 
   /**
-   * Configures a bedrock knowledge base.
+   * <p>Contains details about the embeddings model used for the knowledge base.</p>
    * @public
    */
   knowledgeBaseConfiguration: KnowledgeBaseConfiguration | undefined;
 
   /**
-   * Configures the physical storage of ingested data in a knowledge base.
+   * <p>Contains details about the configuration of the vector database used for the knowledge base.</p>
    * @public
    */
   storageConfiguration: StorageConfiguration | undefined;
 
   /**
-   * A map of tag keys and values
+   * <p>Specify the key-value pairs for the tags that you want to attach to your knowledge base in this object.</p>
    * @public
    */
   tags?: Record<string, string>;
@@ -3199,72 +3293,89 @@ export const KnowledgeBaseStatus = {
 export type KnowledgeBaseStatus = (typeof KnowledgeBaseStatus)[keyof typeof KnowledgeBaseStatus];
 
 /**
- * Contains the information of a knowledge base.
+ * <p>Contains information about a knowledge base.</p>
  * @public
  */
 export interface KnowledgeBase {
   /**
-   * Identifier for a resource.
+   * <p>The unique identifier of the knowledge base.</p>
    * @public
    */
   knowledgeBaseId: string | undefined;
 
   /**
-   * Name for a resource.
+   * <p>The name of the knowledge base.</p>
    * @public
    */
   name: string | undefined;
 
   /**
-   * ARN of a KnowledgeBase
+   * <p>The ARN of the knowledge base.</p>
    * @public
    */
   knowledgeBaseArn: string | undefined;
 
   /**
-   * Description of the Resource.
+   * <p>The description of the knowledge base.</p>
    * @public
    */
   description?: string;
 
   /**
-   * ARN of a IAM role.
+   * <p>The ARN of the IAM role with permissions to invoke API operations on the knowledge base. The ARN must begin with <code>AmazonBedrockExecutionRoleForKnowledgeBase_</code>.</p>
    * @public
    */
   roleArn: string | undefined;
 
   /**
-   * Configures a bedrock knowledge base.
+   * <p>Contains details about the embeddings configuration of the knowledge base.</p>
    * @public
    */
   knowledgeBaseConfiguration: KnowledgeBaseConfiguration | undefined;
 
   /**
-   * Configures the physical storage of ingested data in a knowledge base.
+   * <p>Contains details about the storage configuration of the knowledge base.</p>
    * @public
    */
   storageConfiguration: StorageConfiguration | undefined;
 
   /**
-   * The status of a knowledge base.
+   * <p>The status of the knowledge base. The following statuses are possible:</p>
+   *          <ul>
+   *             <li>
+   *                <p>CREATING – The knowledge base is being created.</p>
+   *             </li>
+   *             <li>
+   *                <p>ACTIVE – The knowledge base is ready to be queried.</p>
+   *             </li>
+   *             <li>
+   *                <p>DELETING – The knowledge base is being deleted.</p>
+   *             </li>
+   *             <li>
+   *                <p>UPDATING – The knowledge base is being updated.</p>
+   *             </li>
+   *             <li>
+   *                <p>FAILED – The knowledge base API operation failed.</p>
+   *             </li>
+   *          </ul>
    * @public
    */
   status: KnowledgeBaseStatus | undefined;
 
   /**
-   * Time Stamp.
+   * <p>The time at which the knowledge base was created.</p>
    * @public
    */
   createdAt: Date | undefined;
 
   /**
-   * Time Stamp.
+   * <p>The time at which the knowledge base was last updated.</p>
    * @public
    */
   updatedAt: Date | undefined;
 
   /**
-   * Failure Reasons for Error.
+   * <p>A list of reasons that the API operation on the knowledge base failed.</p>
    * @public
    */
   failureReasons?: string[];
@@ -3275,7 +3386,7 @@ export interface KnowledgeBase {
  */
 export interface CreateKnowledgeBaseResponse {
   /**
-   * Contains the information of a knowledge base.
+   * <p>Contains details about the knowledge base.</p>
    * @public
    */
   knowledgeBase: KnowledgeBase | undefined;
@@ -3286,7 +3397,7 @@ export interface CreateKnowledgeBaseResponse {
  */
 export interface DeleteKnowledgeBaseRequest {
   /**
-   * Identifier for a resource.
+   * <p>The unique identifier of the knowledge base to delete.</p>
    * @public
    */
   knowledgeBaseId: string | undefined;
@@ -3297,79 +3408,75 @@ export interface DeleteKnowledgeBaseRequest {
  */
 export interface DeleteKnowledgeBaseResponse {
   /**
-   * Identifier for a resource.
+   * <p>The unique identifier of the knowledge base that was deleted.</p>
    * @public
    */
   knowledgeBaseId: string | undefined;
 
   /**
-   * The status of a knowledge base.
+   * <p>The status of the knowledge base and whether it has been successfully deleted.</p>
    * @public
    */
   status: KnowledgeBaseStatus | undefined;
 }
 
 /**
- * Disassociate Agent Knowledge Base Request
  * @public
  */
 export interface DisassociateAgentKnowledgeBaseRequest {
   /**
-   * Id generated at the server side when an Agent is created
+   * <p>The unique identifier of the agent from which to disassociate the knowledge base.</p>
    * @public
    */
   agentId: string | undefined;
 
   /**
-   * Draft Version of the Agent.
+   * <p>The version of the agent from which to disassociate the knowledge base.</p>
    * @public
    */
   agentVersion: string | undefined;
 
   /**
-   * Id generated at the server side when a Knowledge Base is associated to an Agent
+   * <p>The unique identifier of the knowledge base to disassociate.</p>
    * @public
    */
   knowledgeBaseId: string | undefined;
 }
 
 /**
- * Disassociate Agent Knowledge Base Response
  * @public
  */
 export interface DisassociateAgentKnowledgeBaseResponse {}
 
 /**
- * Get Agent Knowledge Base Request
  * @public
  */
 export interface GetAgentKnowledgeBaseRequest {
   /**
-   * Id generated at the server side when an Agent is created
+   * <p>The unique identifier of the agent with which the knowledge base is associated.</p>
    * @public
    */
   agentId: string | undefined;
 
   /**
-   * Version number generated when a version is created
+   * <p>The version of the agent with which the knowledge base is associated.</p>
    * @public
    */
   agentVersion: string | undefined;
 
   /**
-   * Id generated at the server side when a Knowledge Base is associated
+   * <p>The unique identifier of the knowledge base associated with the agent.</p>
    * @public
    */
   knowledgeBaseId: string | undefined;
 }
 
 /**
- * Get Agent Knowledge Base Response
  * @public
  */
 export interface GetAgentKnowledgeBaseResponse {
   /**
-   * Contains the information of an Agent Knowledge Base.
+   * <p>Contains details about a knowledge base attached to an agent.</p>
    * @public
    */
   agentKnowledgeBase: AgentKnowledgeBase | undefined;
@@ -3380,7 +3487,7 @@ export interface GetAgentKnowledgeBaseResponse {
  */
 export interface GetKnowledgeBaseRequest {
   /**
-   * Identifier for a resource.
+   * <p>The unique identifier of the knowledge base for which to get information.</p>
    * @public
    */
   knowledgeBaseId: string | undefined;
@@ -3391,55 +3498,53 @@ export interface GetKnowledgeBaseRequest {
  */
 export interface GetKnowledgeBaseResponse {
   /**
-   * Contains the information of a knowledge base.
+   * <p>Contains details about the knowledge base.</p>
    * @public
    */
   knowledgeBase: KnowledgeBase | undefined;
 }
 
 /**
- * List Agent Knowledge Bases Request
  * @public
  */
 export interface ListAgentKnowledgeBasesRequest {
   /**
-   * Id generated at the server side when an Agent is created
+   * <p>The unique identifier of the agent for which to return information about knowledge bases associated with it.</p>
    * @public
    */
   agentId: string | undefined;
 
   /**
-   * Version number generated when a version is created
+   * <p>The version of the agent for which to return information about knowledge bases associated with it.</p>
    * @public
    */
   agentVersion: string | undefined;
 
   /**
-   * Max Results.
+   * <p>The maximum number of results to return in the response. If the total number of results is greater than this value, use the token returned in the response in the <code>nextToken</code> field when making another request to return the next batch of results.</p>
    * @public
    */
   maxResults?: number;
 
   /**
-   * Opaque continuation token of previous paginated response.
+   * <p>If the total number of results is greater than the <code>maxResults</code> value provided in the request, enter the token returned in the <code>nextToken</code> field in the response in this field to return the next batch of results.</p>
    * @public
    */
   nextToken?: string;
 }
 
 /**
- * List Agent Knowledge Bases Response
  * @public
  */
 export interface ListAgentKnowledgeBasesResponse {
   /**
-   * List of Agent Knowledge Base Summaries
+   * <p>A list of objects, each of which contains information about a knowledge base associated with the agent.</p>
    * @public
    */
   agentKnowledgeBaseSummaries: AgentKnowledgeBaseSummary[] | undefined;
 
   /**
-   * Opaque continuation token of previous paginated response.
+   * <p>If the total number of results is greater than the <code>maxResults</code> value provided in the request, use this token when making another request in the <code>nextToken</code> field to return the next batch of results.</p>
    * @public
    */
   nextToken?: string;
@@ -3450,49 +3555,49 @@ export interface ListAgentKnowledgeBasesResponse {
  */
 export interface ListKnowledgeBasesRequest {
   /**
-   * Max Results.
+   * <p>The maximum number of results to return in the response. If the total number of results is greater than this value, use the token returned in the response in the <code>nextToken</code> field when making another request to return the next batch of results.</p>
    * @public
    */
   maxResults?: number;
 
   /**
-   * Opaque continuation token of previous paginated response.
+   * <p>If the total number of results is greater than the <code>maxResults</code> value provided in the request, enter the token returned in the <code>nextToken</code> field in the response in this field to return the next batch of results.</p>
    * @public
    */
   nextToken?: string;
 }
 
 /**
- * Summary information of a knowledge base.
+ * <p>Contains details about a knowledge base.</p>
  * @public
  */
 export interface KnowledgeBaseSummary {
   /**
-   * Identifier for a resource.
+   * <p>The unique identifier of the knowledge base.</p>
    * @public
    */
   knowledgeBaseId: string | undefined;
 
   /**
-   * Name for a resource.
+   * <p>The name of the knowledge base.</p>
    * @public
    */
   name: string | undefined;
 
   /**
-   * Description of the Resource.
+   * <p>The description of the knowledge base.</p>
    * @public
    */
   description?: string;
 
   /**
-   * The status of a knowledge base.
+   * <p>The status of the knowledge base.</p>
    * @public
    */
   status: KnowledgeBaseStatus | undefined;
 
   /**
-   * Time Stamp.
+   * <p>The time at which the knowledge base was last updated.</p>
    * @public
    */
   updatedAt: Date | undefined;
@@ -3503,61 +3608,59 @@ export interface KnowledgeBaseSummary {
  */
 export interface ListKnowledgeBasesResponse {
   /**
-   * List of KnowledgeBaseSummaries
+   * <p>A list of objects, each of which contains information about a knowledge base.</p>
    * @public
    */
   knowledgeBaseSummaries: KnowledgeBaseSummary[] | undefined;
 
   /**
-   * Opaque continuation token of previous paginated response.
+   * <p>If the total number of results is greater than the <code>maxResults</code> value provided in the request, use this token when making another request in the <code>nextToken</code> field to return the next batch of results.</p>
    * @public
    */
   nextToken?: string;
 }
 
 /**
- * Update Agent Knowledge Base Request
  * @public
  */
 export interface UpdateAgentKnowledgeBaseRequest {
   /**
-   * Id generated at the server side when an Agent is created
+   * <p>The unique identifier of the agent associated with the knowledge base that you want to update.</p>
    * @public
    */
   agentId: string | undefined;
 
   /**
-   * Draft Version of the Agent.
+   * <p>The version of the agent associated with the knowledge base that you want to update.</p>
    * @public
    */
   agentVersion: string | undefined;
 
   /**
-   * Id generated at the server side when a Knowledge Base is associated to an Agent
+   * <p>The unique identifier of the knowledge base that has been associated with an agent.</p>
    * @public
    */
   knowledgeBaseId: string | undefined;
 
   /**
-   * Description of the Resource.
+   * <p>Specifies a new description for the knowledge base associated with an agent.</p>
    * @public
    */
   description?: string;
 
   /**
-   * State of the knowledge base; whether it is enabled or disabled
+   * <p>Specifies whether the agent uses the knowledge base or not when sending an <a href="https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvokeAgent.html">InvokeAgent</a> request.</p>
    * @public
    */
   knowledgeBaseState?: KnowledgeBaseState;
 }
 
 /**
- * Update Agent Knowledge Base Response
  * @public
  */
 export interface UpdateAgentKnowledgeBaseResponse {
   /**
-   * Contains the information of an Agent Knowledge Base.
+   * <p>Contains details about the knowledge base that has been associated with an agent.</p>
    * @public
    */
   agentKnowledgeBase: AgentKnowledgeBase | undefined;
@@ -3568,37 +3671,37 @@ export interface UpdateAgentKnowledgeBaseResponse {
  */
 export interface UpdateKnowledgeBaseRequest {
   /**
-   * Identifier for a resource.
+   * <p>The unique identifier of the knowledge base to update.</p>
    * @public
    */
   knowledgeBaseId: string | undefined;
 
   /**
-   * Name for a resource.
+   * <p>Specifies a new name for the knowledge base.</p>
    * @public
    */
   name: string | undefined;
 
   /**
-   * Description of the Resource.
+   * <p>Specifies a new description for the knowledge base.</p>
    * @public
    */
   description?: string;
 
   /**
-   * ARN of a IAM role.
+   * <p>Specifies a different Amazon Resource Name (ARN) of the IAM role with permissions to modify the knowledge base.</p>
    * @public
    */
   roleArn: string | undefined;
 
   /**
-   * Configures a bedrock knowledge base.
+   * <p>Specifies the configuration for the embeddings model used for the knowledge base. You must use the same configuration as when the knowledge base was created.</p>
    * @public
    */
   knowledgeBaseConfiguration: KnowledgeBaseConfiguration | undefined;
 
   /**
-   * Configures the physical storage of ingested data in a knowledge base.
+   * <p>Specifies the configuration for the vector store used for the knowledge base. You must use the same configuration as when the knowledge base was created.</p>
    * @public
    */
   storageConfiguration: StorageConfiguration | undefined;
@@ -3609,7 +3712,7 @@ export interface UpdateKnowledgeBaseRequest {
  */
 export interface UpdateKnowledgeBaseResponse {
   /**
-   * Contains the information of a knowledge base.
+   * <p>Contains details about the knowledge base.</p>
    * @public
    */
   knowledgeBase: KnowledgeBase | undefined;
@@ -3620,7 +3723,7 @@ export interface UpdateKnowledgeBaseResponse {
  */
 export interface ListTagsForResourceRequest {
   /**
-   * ARN of Taggable resources: [Agent, AgentAlias, Knowledge-Base]
+   * <p>The ARN of the resource for which to list tags.</p>
    * @public
    */
   resourceArn: string | undefined;
@@ -3631,7 +3734,7 @@ export interface ListTagsForResourceRequest {
  */
 export interface ListTagsForResourceResponse {
   /**
-   * A map of tag keys and values
+   * <p>The key-value pairs for the tags associated with the resource.</p>
    * @public
    */
   tags?: Record<string, string>;
@@ -3642,13 +3745,13 @@ export interface ListTagsForResourceResponse {
  */
 export interface TagResourceRequest {
   /**
-   * ARN of Taggable resources: [Agent, AgentAlias, Knowledge-Base]
+   * <p>The ARN of the resource to tag.</p>
    * @public
    */
   resourceArn: string | undefined;
 
   /**
-   * A map of tag keys and values
+   * <p>An object containing key-value pairs that define the tags to attach to the resource.</p>
    * @public
    */
   tags: Record<string, string> | undefined;
@@ -3664,13 +3767,13 @@ export interface TagResourceResponse {}
  */
 export interface UntagResourceRequest {
   /**
-   * ARN of Taggable resources: [Agent, AgentAlias, Knowledge-Base]
+   * <p>The ARN of the resource from which to remove tags.</p>
    * @public
    */
   resourceArn: string | undefined;
 
   /**
-   * List of Tag Keys
+   * <p>A list of keys of the tags to remove from the resource.</p>
    * @public
    */
   tagKeys: string[] | undefined;
@@ -3682,120 +3785,114 @@ export interface UntagResourceRequest {
 export interface UntagResourceResponse {}
 
 /**
- * Delete Agent Version Request
  * @public
  */
 export interface DeleteAgentVersionRequest {
   /**
-   * Id generated at the server side when an Agent is created
+   * <p>The unique identifier of the agent that the version belongs to.</p>
    * @public
    */
   agentId: string | undefined;
 
   /**
-   * Numerical Agent Version.
+   * <p>The version of the agent to delete.</p>
    * @public
    */
   agentVersion: string | undefined;
 
   /**
-   * Skips checking if resource is in use when set to true. Defaults to false
+   * <p>By default, this value is <code>false</code> and deletion is stopped if the resource is in use. If you set it to <code>true</code>, the resource will be deleted even if the resource is in use.</p>
    * @public
    */
   skipResourceInUseCheck?: boolean;
 }
 
 /**
- * Delete Agent Version Response
  * @public
  */
 export interface DeleteAgentVersionResponse {
   /**
-   * Identifier for a resource.
+   * <p>The unique identifier of the agent that the version belongs to.</p>
    * @public
    */
   agentId: string | undefined;
 
   /**
-   * Numerical Agent Version.
+   * <p>The version that was deleted.</p>
    * @public
    */
   agentVersion: string | undefined;
 
   /**
-   * Schema Type for Action APIs.
+   * <p>The status of the agent version.</p>
    * @public
    */
   agentStatus: AgentStatus | undefined;
 }
 
 /**
- * Get Agent Version Request
  * @public
  */
 export interface GetAgentVersionRequest {
   /**
-   * Id generated at the server side when an Agent is created
+   * <p>The unique identifier of the agent.</p>
    * @public
    */
   agentId: string | undefined;
 
   /**
-   * Numerical Agent Version.
+   * <p>The version of the agent.</p>
    * @public
    */
   agentVersion: string | undefined;
 }
 
 /**
- * Get Agent Version Response
  * @public
  */
 export interface GetAgentVersionResponse {
   /**
-   * Contains the information of an agent version.
+   * <p>Contains details about the version of the agent.</p>
    * @public
    */
   agentVersion: AgentVersion | undefined;
 }
 
 /**
- * List Agent Versions Request
  * @public
  */
 export interface ListAgentVersionsRequest {
   /**
-   * Id generated at the server side when an Agent is created
+   * <p>The unique identifier of the agent.</p>
    * @public
    */
   agentId: string | undefined;
 
   /**
-   * Max Results.
+   * <p>The maximum number of results to return in the response. If the total number of results is greater than this value, use the token returned in the response in the <code>nextToken</code> field when making another request to return the next batch of results.</p>
    * @public
    */
   maxResults?: number;
 
   /**
-   * Opaque continuation token of previous paginated response.
+   * <p>If the total number of results is greater than the <code>maxResults</code> value provided in the request, enter the token returned in the <code>nextToken</code> field in the response in this field to return the next batch of results.</p>
    * @public
    */
   nextToken?: string;
 }
 
 /**
- * List Agent Versions Response
  * @public
  */
 export interface ListAgentVersionsResponse {
   /**
-   * List of AgentVersionSummary.
+   * <p>A list of objects, each of which contains information about a version of the agent.</p>
    * @public
    */
   agentVersionSummaries: AgentVersionSummary[] | undefined;
 
   /**
-   * Opaque continuation token of previous paginated response.
+   * <p>If the total number of results is greater than the <code>maxResults</code> value provided in the request, use this token when making another request in the <code>nextToken</code> field to return the next batch of results.</p>
    * @public
    */
   nextToken?: string;
diff --git a/codegen/sdk-codegen/aws-models/bedrock-agent.json b/codegen/sdk-codegen/aws-models/bedrock-agent.json
index 45d043b886b4..37d627b1a615 100644
--- a/codegen/sdk-codegen/aws-models/bedrock-agent.json
+++ b/codegen/sdk-codegen/aws-models/bedrock-agent.json
@@ -5,14 +5,20 @@
       "type": "union",
       "members": {
         "s3": {
-          "target": "com.amazonaws.bedrockagent#S3Identifier"
+          "target": "com.amazonaws.bedrockagent#S3Identifier",
+          "traits": {
+            "smithy.api#documentation": "<p>Contains details about the S3 object containing the OpenAPI schema for the action group. For more information, see <a href=\"https://docs.aws.amazon.com/bedrock/latest/userguide/agents-api-schema.html\">Action group OpenAPI schemas</a>.</p>"
+          }
         },
         "payload": {
-          "target": "com.amazonaws.bedrockagent#Payload"
+          "target": "com.amazonaws.bedrockagent#Payload",
+          "traits": {
+            "smithy.api#documentation": "<p>The JSON or YAML-formatted payload defining the OpenAPI schema for the action group. For more information, see <a href=\"https://docs.aws.amazon.com/bedrock/latest/userguide/agents-api-schema.html\">Action group OpenAPI schemas</a>.</p>"
+          }
         }
       },
       "traits": {
-        "smithy.api#documentation": "Contains information about the API Schema for the Action Group"
+        "smithy.api#documentation": "<p>Contains details about the OpenAPI schema for the action group. For more information, see <a href=\"https://docs.aws.amazon.com/bedrock/latest/userguide/agents-api-schema.html\">Action group OpenAPI schemas</a>. You can either include the schema directly in the <code>payload</code> field or you can upload it to an S3 bucket and specify the S3 bucket location in the <code>s3</code> field.</p>"
       }
     },
     "com.amazonaws.bedrockagent#AccessDeniedException": {
@@ -23,7 +29,7 @@
         }
       },
       "traits": {
-        "smithy.api#documentation": "This exception is thrown when a request is denied per access permissions",
+        "smithy.api#documentation": "<p>The request is denied because of missing access permissions.</p>",
         "smithy.api#error": "client",
         "smithy.api#httpError": 403
       }
@@ -32,11 +38,14 @@
       "type": "union",
       "members": {
         "lambda": {
-          "target": "com.amazonaws.bedrockagent#LambdaArn"
+          "target": "com.amazonaws.bedrockagent#LambdaArn",
+          "traits": {
+            "smithy.api#documentation": "<p>The ARN of the Lambda function containing the business logic that is carried out upon invoking the action.</p>"
+          }
         }
       },
       "traits": {
-        "smithy.api#documentation": "Type of Executors for an Action Group"
+        "smithy.api#documentation": "<p>Contains details about the Lambda function containing the business logic that is carried out upon invoking the action.</p>"
       }
     },
     "com.amazonaws.bedrockagent#ActionGroupResource": {
@@ -68,9 +77,6 @@
             "smithy.api#enumValue": "AMAZON.UserInput"
           }
         }
-      },
-      "traits": {
-        "smithy.api#documentation": "Action Group Signature for a BuiltIn Action"
       }
     },
     "com.amazonaws.bedrockagent#ActionGroupState": {
@@ -88,9 +94,6 @@
             "smithy.api#enumValue": "DISABLED"
           }
         }
-      },
-      "traits": {
-        "smithy.api#documentation": "State of the action group"
       }
     },
     "com.amazonaws.bedrockagent#ActionGroupSummaries": {
@@ -99,7 +102,6 @@
         "target": "com.amazonaws.bedrockagent#ActionGroupSummary"
       },
       "traits": {
-        "smithy.api#documentation": "List of ActionGroup Summaries",
         "smithy.api#length": {
           "max": 10
         }
@@ -111,33 +113,40 @@
         "actionGroupId": {
           "target": "com.amazonaws.bedrockagent#Id",
           "traits": {
+            "smithy.api#documentation": "<p>The unique identifier of the action group.</p>",
             "smithy.api#required": {}
           }
         },
         "actionGroupName": {
           "target": "com.amazonaws.bedrockagent#Name",
           "traits": {
+            "smithy.api#documentation": "<p>The name of the action group.</p>",
             "smithy.api#required": {}
           }
         },
         "actionGroupState": {
           "target": "com.amazonaws.bedrockagent#ActionGroupState",
           "traits": {
+            "smithy.api#documentation": "<p>Specifies whether the action group is available for the agent to invoke or not when\n      sending an <a href=\"https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvokeAgent.html\">InvokeAgent</a>\n      request.</p>",
             "smithy.api#required": {}
           }
         },
         "description": {
-          "target": "com.amazonaws.bedrockagent#Description"
+          "target": "com.amazonaws.bedrockagent#Description",
+          "traits": {
+            "smithy.api#documentation": "<p>The description of the action group.</p>"
+          }
         },
         "updatedAt": {
           "target": "com.amazonaws.bedrockagent#DateTimestamp",
           "traits": {
+            "smithy.api#documentation": "<p>The time at which the action group was last updated.</p>",
             "smithy.api#required": {}
           }
         }
       },
       "traits": {
-        "smithy.api#documentation": "ActionGroup Summary"
+        "smithy.api#documentation": "<p>Contains details about an action group.</p>"
       }
     },
     "com.amazonaws.bedrockagent#Agent": {
@@ -146,87 +155,123 @@
         "agentId": {
           "target": "com.amazonaws.bedrockagent#Id",
           "traits": {
+            "smithy.api#documentation": "<p>The unique identifier of the agent.</p>",
             "smithy.api#required": {}
           }
         },
         "agentName": {
           "target": "com.amazonaws.bedrockagent#Name",
           "traits": {
+            "smithy.api#documentation": "<p>The name of the agent.</p>",
             "smithy.api#required": {}
           }
         },
         "agentArn": {
           "target": "com.amazonaws.bedrockagent#AgentArn",
           "traits": {
+            "smithy.api#documentation": "<p>The ARN of the agent.</p>",
             "smithy.api#required": {}
           }
         },
         "agentVersion": {
           "target": "com.amazonaws.bedrockagent#DraftVersion",
           "traits": {
+            "smithy.api#documentation": "<p>The version of the agent.</p>",
             "smithy.api#required": {}
           }
         },
         "clientToken": {
-          "target": "com.amazonaws.bedrockagent#ClientToken"
+          "target": "com.amazonaws.bedrockagent#ClientToken",
+          "traits": {
+            "smithy.api#documentation": "<p>A unique, case-sensitive identifier to ensure that the API request completes no more than one time. If this token matches a previous request,\n      Amazon Bedrock ignores the request, but does not return an error. For more information, see <a href=\"https://docs.aws.amazon.com/AWSEC2/latest/APIReference/Run_Instance_Idempotency.html\">Ensuring idempotency</a>.</p>"
+          }
         },
         "instruction": {
-          "target": "com.amazonaws.bedrockagent#Instruction"
+          "target": "com.amazonaws.bedrockagent#Instruction",
+          "traits": {
+            "smithy.api#documentation": "<p>Instructions that tell the agent what it should do and how it should interact with users.</p>"
+          }
         },
         "agentStatus": {
           "target": "com.amazonaws.bedrockagent#AgentStatus",
           "traits": {
+            "smithy.api#documentation": "<p>The status of the agent and whether it is ready for use. The following statuses are possible:</p>\n         <ul>\n            <li>\n               <p>CREATING – The agent is being created.</p>\n            </li>\n            <li>\n               <p>PREPARING – The agent is being prepared.</p>\n            </li>\n            <li>\n               <p>PREPARED – The agent is prepared and ready to be invoked.</p>\n            </li>\n            <li>\n               <p>NOT_PREPARED – The agent has been created but not yet prepared.</p>\n            </li>\n            <li>\n               <p>FAILED – The agent API operation failed.</p>\n            </li>\n            <li>\n               <p>UPDATING – The agent is being updated.</p>\n            </li>\n            <li>\n               <p>DELETING – The agent is being deleted.</p>\n            </li>\n         </ul>",
             "smithy.api#required": {}
           }
         },
         "foundationModel": {
-          "target": "com.amazonaws.bedrockagent#ModelIdentifier"
+          "target": "com.amazonaws.bedrockagent#ModelIdentifier",
+          "traits": {
+            "smithy.api#documentation": "<p>The foundation model used for orchestration by the agent.</p>"
+          }
         },
         "description": {
-          "target": "com.amazonaws.bedrockagent#Description"
+          "target": "com.amazonaws.bedrockagent#Description",
+          "traits": {
+            "smithy.api#documentation": "<p>The description of the agent.</p>"
+          }
         },
         "idleSessionTTLInSeconds": {
           "target": "com.amazonaws.bedrockagent#SessionTTL",
           "traits": {
+            "smithy.api#documentation": "<p>The number of seconds for which Amazon Bedrock keeps information about a user's conversation with the agent.</p>\n         <p>A user interaction remains active for the amount of time specified. If no conversation occurs during this time, the session expires and Amazon Bedrock deletes any data provided before the timeout.</p>",
             "smithy.api#required": {}
           }
         },
         "agentResourceRoleArn": {
           "target": "com.amazonaws.bedrockagent#AgentRoleArn",
           "traits": {
+            "smithy.api#documentation": "<p>The ARN of the IAM role with permissions to call API operations on the agent. The ARN must begin with <code>AmazonBedrockExecutionRoleForAgents_</code>.</p>",
             "smithy.api#required": {}
           }
         },
         "customerEncryptionKeyArn": {
-          "target": "com.amazonaws.bedrockagent#KmsKeyArn"
+          "target": "com.amazonaws.bedrockagent#KmsKeyArn",
+          "traits": {
+            "smithy.api#documentation": "<p>The ARN of the KMS key that encrypts the agent.</p>"
+          }
         },
         "createdAt": {
           "target": "com.amazonaws.bedrockagent#DateTimestamp",
           "traits": {
+            "smithy.api#documentation": "<p>The time at which the agent was created.</p>",
             "smithy.api#required": {}
           }
         },
         "updatedAt": {
           "target": "com.amazonaws.bedrockagent#DateTimestamp",
           "traits": {
+            "smithy.api#documentation": "<p>The time at which the agent was last updated.</p>",
             "smithy.api#required": {}
           }
         },
         "preparedAt": {
-          "target": "com.amazonaws.bedrockagent#DateTimestamp"
+          "target": "com.amazonaws.bedrockagent#DateTimestamp",
+          "traits": {
+            "smithy.api#documentation": "<p>The time at which the agent was last prepared.</p>"
+          }
         },
         "failureReasons": {
-          "target": "com.amazonaws.bedrockagent#FailureReasons"
+          "target": "com.amazonaws.bedrockagent#FailureReasons",
+          "traits": {
+            "smithy.api#documentation": "<p>Contains reasons that the agent-related API that you invoked failed.</p>"
+          }
         },
         "recommendedActions": {
-          "target": "com.amazonaws.bedrockagent#RecommendedActions"
+          "target": "com.amazonaws.bedrockagent#RecommendedActions",
+          "traits": {
+            "smithy.api#documentation": "<p>Contains recommended actions to take for the agent-related API that you invoked to succeed.</p>"
+          }
         },
         "promptOverrideConfiguration": {
-          "target": "com.amazonaws.bedrockagent#PromptOverrideConfiguration"
+          "target": "com.amazonaws.bedrockagent#PromptOverrideConfiguration",
+          "traits": {
+            "smithy.api#documentation": "<p>Contains configurations to override prompt templates in different parts of an agent sequence. For more information, see <a href=\"https://docs.aws.amazon.com/bedrock/latest/userguide/advanced-prompts.html\">Advanced prompts</a>.</p>"
+          }
         }
       },
       "traits": {
-        "smithy.api#documentation": "Contains the information of an agent"
+        "smithy.api#documentation": "<p>Contains details about an agent.</p>"
       }
     },
     "com.amazonaws.bedrockagent#AgentActionGroup": {
@@ -235,63 +280,85 @@
         "agentId": {
           "target": "com.amazonaws.bedrockagent#Id",
           "traits": {
+            "smithy.api#documentation": "<p>The unique identifier of the agent to which the action group belongs.</p>",
             "smithy.api#required": {}
           }
         },
         "agentVersion": {
           "target": "com.amazonaws.bedrockagent#Version",
           "traits": {
+            "smithy.api#documentation": "<p>The version of the agent to which the action group belongs.</p>",
             "smithy.api#required": {}
           }
         },
         "actionGroupId": {
           "target": "com.amazonaws.bedrockagent#Id",
           "traits": {
+            "smithy.api#documentation": "<p>The unique identifier of the action group.</p>",
             "smithy.api#required": {}
           }
         },
         "actionGroupName": {
           "target": "com.amazonaws.bedrockagent#Name",
           "traits": {
+            "smithy.api#documentation": "<p>The name of the action group.</p>",
             "smithy.api#required": {}
           }
         },
         "clientToken": {
-          "target": "com.amazonaws.bedrockagent#ClientToken"
+          "target": "com.amazonaws.bedrockagent#ClientToken",
+          "traits": {
+            "smithy.api#documentation": "<p>A unique, case-sensitive identifier to ensure that the API request completes no more than one time. If this token matches a previous request,\n      Amazon Bedrock ignores the request, but does not return an error. For more information, see <a href=\"https://docs.aws.amazon.com/AWSEC2/latest/APIReference/Run_Instance_Idempotency.html\">Ensuring idempotency</a>.</p>"
+          }
         },
         "description": {
-          "target": "com.amazonaws.bedrockagent#Description"
+          "target": "com.amazonaws.bedrockagent#Description",
+          "traits": {
+            "smithy.api#documentation": "<p>The description of the action group.</p>"
+          }
         },
         "createdAt": {
           "target": "com.amazonaws.bedrockagent#DateTimestamp",
           "traits": {
+            "smithy.api#documentation": "<p>The time at which the action group was created.</p>",
             "smithy.api#required": {}
           }
         },
         "updatedAt": {
           "target": "com.amazonaws.bedrockagent#DateTimestamp",
           "traits": {
+            "smithy.api#documentation": "<p>The time at which the action group was last updated.</p>",
             "smithy.api#required": {}
           }
         },
         "parentActionSignature": {
-          "target": "com.amazonaws.bedrockagent#ActionGroupSignature"
+          "target": "com.amazonaws.bedrockagent#ActionGroupSignature",
+          "traits": {
+            "smithy.api#documentation": "<p>If this field is set as <code>AMAZON.UserInput</code>, the agent can request the user for additional information when trying to complete a task. The <code>description</code>, <code>apiSchema</code>, and <code>actionGroupExecutor</code> fields must be blank for this action group.</p>\n         <p>During orchestration, if the agent determines that it needs to invoke an API in an action group, but doesn't have enough information to complete the API request, it will invoke this action group instead and return an <a href=\"https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_Observation.html\">Observation</a> reprompting the user for more information.</p>"
+          }
         },
         "actionGroupExecutor": {
-          "target": "com.amazonaws.bedrockagent#ActionGroupExecutor"
+          "target": "com.amazonaws.bedrockagent#ActionGroupExecutor",
+          "traits": {
+            "smithy.api#documentation": "<p>The ARN of the Lambda function containing the business logic that is carried out upon invoking the action.</p>"
+          }
         },
         "apiSchema": {
-          "target": "com.amazonaws.bedrockagent#APISchema"
+          "target": "com.amazonaws.bedrockagent#APISchema",
+          "traits": {
+            "smithy.api#documentation": "<p>Contains either details about the S3 object containing the OpenAPI schema for the action group or the JSON or YAML-formatted payload defining the schema. For more information, see <a href=\"https://docs.aws.amazon.com/bedrock/latest/userguide/agents-api-schema.html\">Action group OpenAPI schemas</a>.</p>"
+          }
         },
         "actionGroupState": {
           "target": "com.amazonaws.bedrockagent#ActionGroupState",
           "traits": {
+            "smithy.api#documentation": "<p>Specifies whether the action group is available for the agent to invoke or not when sending an <a href=\"https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvokeAgent.html\">InvokeAgent</a> request.</p>",
             "smithy.api#required": {}
           }
         }
       },
       "traits": {
-        "smithy.api#documentation": "Contains the information of an Agent Action Group"
+        "smithy.api#documentation": "<p>Contains details about an action group.</p>"
       }
     },
     "com.amazonaws.bedrockagent#AgentAlias": {
@@ -300,69 +367,85 @@
         "agentId": {
           "target": "com.amazonaws.bedrockagent#Id",
           "traits": {
+            "smithy.api#documentation": "<p>The unique identifier of the agent.</p>",
             "smithy.api#required": {}
           }
         },
         "agentAliasId": {
           "target": "com.amazonaws.bedrockagent#AgentAliasId",
           "traits": {
+            "smithy.api#documentation": "<p>The unique identifier of the alias of the agent.</p>",
             "smithy.api#required": {}
           }
         },
         "agentAliasName": {
           "target": "com.amazonaws.bedrockagent#Name",
           "traits": {
+            "smithy.api#documentation": "<p>The name of the alias of the agent.</p>",
             "smithy.api#required": {}
           }
         },
         "agentAliasArn": {
           "target": "com.amazonaws.bedrockagent#AgentAliasArn",
           "traits": {
+            "smithy.api#documentation": "<p>The ARN of the alias of the agent.</p>",
             "smithy.api#required": {}
           }
         },
         "clientToken": {
-          "target": "com.amazonaws.bedrockagent#ClientToken"
+          "target": "com.amazonaws.bedrockagent#ClientToken",
+          "traits": {
+            "smithy.api#documentation": "<p>A unique, case-sensitive identifier to ensure that the API request completes no more than one time. If this token matches a previous request,\n      Amazon Bedrock ignores the request, but does not return an error. For more information, see <a href=\"https://docs.aws.amazon.com/AWSEC2/latest/APIReference/Run_Instance_Idempotency.html\">Ensuring idempotency</a>.</p>"
+          }
         },
         "description": {
-          "target": "com.amazonaws.bedrockagent#Description"
+          "target": "com.amazonaws.bedrockagent#Description",
+          "traits": {
+            "smithy.api#documentation": "<p>The description of the alias of the agent.</p>"
+          }
         },
         "routingConfiguration": {
           "target": "com.amazonaws.bedrockagent#AgentAliasRoutingConfiguration",
           "traits": {
+            "smithy.api#documentation": "<p>Contains details about the routing configuration of the alias.</p>",
             "smithy.api#required": {}
           }
         },
         "createdAt": {
           "target": "com.amazonaws.bedrockagent#DateTimestamp",
           "traits": {
+            "smithy.api#documentation": "<p>The time at which the alias of the agent was created.</p>",
             "smithy.api#required": {}
           }
         },
         "updatedAt": {
           "target": "com.amazonaws.bedrockagent#DateTimestamp",
           "traits": {
+            "smithy.api#documentation": "<p>The time at which the alias was last updated.</p>",
             "smithy.api#required": {}
           }
         },
         "agentAliasHistoryEvents": {
-          "target": "com.amazonaws.bedrockagent#AgentAliasHistoryEvents"
+          "target": "com.amazonaws.bedrockagent#AgentAliasHistoryEvents",
+          "traits": {
+            "smithy.api#documentation": "<p>Contains details about the history of the alias.</p>"
+          }
         },
         "agentAliasStatus": {
           "target": "com.amazonaws.bedrockagent#AgentAliasStatus",
           "traits": {
+            "smithy.api#documentation": "<p>The status of the alias of the agent and whether it is ready for use. The following statuses are possible:</p>\n         <ul>\n            <li>\n               <p>CREATING – The agent alias is being created.</p>\n            </li>\n            <li>\n               <p>PREPARED – The agent alias is finished being created or updated and is ready to be invoked.</p>\n            </li>\n            <li>\n               <p>FAILED – The agent alias API operation failed.</p>\n            </li>\n            <li>\n               <p>UPDATING – The agent alias is being updated.</p>\n            </li>\n            <li>\n               <p>DELETING – The agent alias is being deleted.</p>\n            </li>\n         </ul>",
             "smithy.api#required": {}
           }
         }
       },
       "traits": {
-        "smithy.api#documentation": "Contains the information of an agent alias"
+        "smithy.api#documentation": "<p>Contains details about an alias of an agent.</p>"
       }
     },
     "com.amazonaws.bedrockagent#AgentAliasArn": {
       "type": "string",
       "traits": {
-        "smithy.api#documentation": "Arn representation of the Agent Alias.",
         "smithy.api#length": {
           "max": 2048
         },
@@ -373,17 +456,26 @@
       "type": "structure",
       "members": {
         "routingConfiguration": {
-          "target": "com.amazonaws.bedrockagent#AgentAliasRoutingConfiguration"
+          "target": "com.amazonaws.bedrockagent#AgentAliasRoutingConfiguration",
+          "traits": {
+            "smithy.api#documentation": "<p>Contains details about the version of the agent with which the alias is associated.</p>"
+          }
         },
         "endDate": {
-          "target": "com.amazonaws.bedrockagent#DateTimestamp"
+          "target": "com.amazonaws.bedrockagent#DateTimestamp",
+          "traits": {
+            "smithy.api#documentation": "<p>The date that the alias stopped being associated to the version in the <code>routingConfiguration</code> object</p>"
+          }
         },
         "startDate": {
-          "target": "com.amazonaws.bedrockagent#DateTimestamp"
+          "target": "com.amazonaws.bedrockagent#DateTimestamp",
+          "traits": {
+            "smithy.api#documentation": "<p>The date that the alias began being associated to the version in the <code>routingConfiguration</code> object.</p>"
+          }
         }
       },
       "traits": {
-        "smithy.api#documentation": "History event for an alias for an Agent."
+        "smithy.api#documentation": "<p>Contains details about the history of the alias.</p>"
       }
     },
     "com.amazonaws.bedrockagent#AgentAliasHistoryEvents": {
@@ -392,7 +484,6 @@
         "target": "com.amazonaws.bedrockagent#AgentAliasHistoryEvent"
       },
       "traits": {
-        "smithy.api#documentation": "The list of history events for an alias for an Agent.",
         "smithy.api#length": {
           "max": 10
         }
@@ -401,7 +492,6 @@
     "com.amazonaws.bedrockagent#AgentAliasId": {
       "type": "string",
       "traits": {
-        "smithy.api#documentation": "Id for an Agent Alias generated at the server side.",
         "smithy.api#length": {
           "min": 10,
           "max": 10
@@ -415,7 +505,6 @@
         "target": "com.amazonaws.bedrockagent#AgentAliasRoutingConfigurationListItem"
       },
       "traits": {
-        "smithy.api#documentation": "Routing configuration for an Agent alias.",
         "smithy.api#length": {
           "max": 1
         }
@@ -427,12 +516,13 @@
         "agentVersion": {
           "target": "com.amazonaws.bedrockagent#Version",
           "traits": {
+            "smithy.api#documentation": "<p>The version of the agent with which the alias is associated.</p>",
             "smithy.api#required": {}
           }
         }
       },
       "traits": {
-        "smithy.api#documentation": "Details about the routing configuration for an Agent alias."
+        "smithy.api#documentation": "<p>Contains details about the routing configuration of the alias.</p>"
       }
     },
     "com.amazonaws.bedrockagent#AgentAliasStatus": {
@@ -468,9 +558,6 @@
             "smithy.api#enumValue": "DELETING"
           }
         }
-      },
-      "traits": {
-        "smithy.api#documentation": "The statuses an Agent Alias can be in."
       }
     },
     "com.amazonaws.bedrockagent#AgentAliasSummaries": {
@@ -479,7 +566,6 @@
         "target": "com.amazonaws.bedrockagent#AgentAliasSummary"
       },
       "traits": {
-        "smithy.api#documentation": "The list of summaries of all the aliases for an Agent.",
         "smithy.api#length": {
           "max": 10
         }
@@ -491,48 +577,58 @@
         "agentAliasId": {
           "target": "com.amazonaws.bedrockagent#AgentAliasId",
           "traits": {
+            "smithy.api#documentation": "<p>Contains details about </p>",
             "smithy.api#required": {}
           }
         },
         "agentAliasName": {
           "target": "com.amazonaws.bedrockagent#Name",
           "traits": {
+            "smithy.api#documentation": "<p>The name of the alias.</p>",
             "smithy.api#required": {}
           }
         },
         "description": {
-          "target": "com.amazonaws.bedrockagent#Description"
+          "target": "com.amazonaws.bedrockagent#Description",
+          "traits": {
+            "smithy.api#documentation": "<p>The description of the alias.</p>"
+          }
         },
         "routingConfiguration": {
-          "target": "com.amazonaws.bedrockagent#AgentAliasRoutingConfiguration"
+          "target": "com.amazonaws.bedrockagent#AgentAliasRoutingConfiguration",
+          "traits": {
+            "smithy.api#documentation": "<p>Contains details about the version of the agent with which the alias is associated.</p>"
+          }
         },
         "agentAliasStatus": {
           "target": "com.amazonaws.bedrockagent#AgentAliasStatus",
           "traits": {
+            "smithy.api#documentation": "<p>The status of the alias.</p>",
             "smithy.api#required": {}
           }
         },
         "createdAt": {
           "target": "com.amazonaws.bedrockagent#DateTimestamp",
           "traits": {
+            "smithy.api#documentation": "<p>The time at which the alias of the agent was created.</p>",
             "smithy.api#required": {}
           }
         },
         "updatedAt": {
           "target": "com.amazonaws.bedrockagent#DateTimestamp",
           "traits": {
+            "smithy.api#documentation": "<p>The time at which the alias was last updated.</p>",
             "smithy.api#required": {}
           }
         }
       },
       "traits": {
-        "smithy.api#documentation": "Summary of an alias for an Agent."
+        "smithy.api#documentation": "<p>Contains details about an alias of an agent.</p>"
       }
     },
     "com.amazonaws.bedrockagent#AgentArn": {
       "type": "string",
       "traits": {
-        "smithy.api#documentation": "Arn representation of the Agent.",
         "smithy.api#length": {
           "max": 2048
         },
@@ -545,48 +641,55 @@
         "agentId": {
           "target": "com.amazonaws.bedrockagent#Id",
           "traits": {
+            "smithy.api#documentation": "<p>The unique identifier of the agent with which the knowledge base is associated.</p>",
             "smithy.api#required": {}
           }
         },
         "agentVersion": {
           "target": "com.amazonaws.bedrockagent#Version",
           "traits": {
+            "smithy.api#documentation": "<p>The version of the agent with which the knowledge base is associated.</p>",
             "smithy.api#required": {}
           }
         },
         "knowledgeBaseId": {
           "target": "com.amazonaws.bedrockagent#Id",
           "traits": {
+            "smithy.api#documentation": "<p>The unique identifier of the association between the agent and the knowledge base.</p>",
             "smithy.api#required": {}
           }
         },
         "description": {
           "target": "com.amazonaws.bedrockagent#Description",
           "traits": {
+            "smithy.api#documentation": "<p>The description of the association between the agent and the knowledge base.</p>",
             "smithy.api#required": {}
           }
         },
         "createdAt": {
           "target": "com.amazonaws.bedrockagent#DateTimestamp",
           "traits": {
+            "smithy.api#documentation": "<p>The time at which the association between the agent and the knowledge base was created.</p>",
             "smithy.api#required": {}
           }
         },
         "updatedAt": {
           "target": "com.amazonaws.bedrockagent#DateTimestamp",
           "traits": {
+            "smithy.api#documentation": "<p>The time at which the association between the agent and the knowledge base was last updated.</p>",
             "smithy.api#required": {}
           }
         },
         "knowledgeBaseState": {
           "target": "com.amazonaws.bedrockagent#KnowledgeBaseState",
           "traits": {
+            "smithy.api#documentation": "<p>Specifies whether to use the knowledge base or not when sending an <a href=\"https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvokeAgent.html\">InvokeAgent</a> request.</p>",
             "smithy.api#required": {}
           }
         }
       },
       "traits": {
-        "smithy.api#documentation": "Contains the information of an Agent Knowledge Base."
+        "smithy.api#documentation": "<p>Contains details about a knowledge base that is associated with an agent.</p>"
       }
     },
     "com.amazonaws.bedrockagent#AgentKnowledgeBaseSummaries": {
@@ -595,7 +698,6 @@
         "target": "com.amazonaws.bedrockagent#AgentKnowledgeBaseSummary"
       },
       "traits": {
-        "smithy.api#documentation": "List of Agent Knowledge Base Summaries",
         "smithy.api#length": {
           "max": 10
         }
@@ -607,27 +709,33 @@
         "knowledgeBaseId": {
           "target": "com.amazonaws.bedrockagent#Id",
           "traits": {
+            "smithy.api#documentation": "<p>The unique identifier of the knowledge base associated with an agent.</p>",
             "smithy.api#required": {}
           }
         },
         "description": {
-          "target": "com.amazonaws.bedrockagent#Description"
+          "target": "com.amazonaws.bedrockagent#Description",
+          "traits": {
+            "smithy.api#documentation": "<p>The description of the knowledge base associated with an agent.</p>"
+          }
         },
         "knowledgeBaseState": {
           "target": "com.amazonaws.bedrockagent#KnowledgeBaseState",
           "traits": {
+            "smithy.api#documentation": "<p>Specifies whether the agent uses the knowledge base or not when sending an <a href=\"https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvokeAgent.html\">InvokeAgent</a> request.</p>",
             "smithy.api#required": {}
           }
         },
         "updatedAt": {
           "target": "com.amazonaws.bedrockagent#DateTimestamp",
           "traits": {
+            "smithy.api#documentation": "<p>The time at which the knowledge base associated with an agent was last updated.</p>",
             "smithy.api#required": {}
           }
         }
       },
       "traits": {
-        "smithy.api#documentation": "Agent Knowledge Base Summary"
+        "smithy.api#documentation": "<p>Contains details about a knowledge base associated with an agent.</p>"
       }
     },
     "com.amazonaws.bedrockagent#AgentResource": {
@@ -656,11 +764,10 @@
     "com.amazonaws.bedrockagent#AgentRoleArn": {
       "type": "string",
       "traits": {
-        "smithy.api#documentation": "ARN of a IAM role.",
         "smithy.api#length": {
           "max": 2048
         },
-        "smithy.api#pattern": "^arn:aws(-[^:]+)?:iam::([0-9]{12})?:role/(service-role/)?AmazonBedrockExecutionRoleForAgents.+$"
+        "smithy.api#pattern": "^arn:aws(-[^:]+)?:iam::([0-9]{12})?:role/(service-role/)?AmazonBedrockExecutionRoleForAgents_.+$"
       }
     },
     "com.amazonaws.bedrockagent#AgentStatus": {
@@ -714,9 +821,6 @@
             "smithy.api#enumValue": "UPDATING"
           }
         }
-      },
-      "traits": {
-        "smithy.api#documentation": "Schema Type for Action APIs."
       }
     },
     "com.amazonaws.bedrockagent#AgentSummaries": {
@@ -725,7 +829,6 @@
         "target": "com.amazonaws.bedrockagent#AgentSummary"
       },
       "traits": {
-        "smithy.api#documentation": "List of AgentSummary.",
         "smithy.api#length": {
           "max": 10
         }
@@ -737,36 +840,46 @@
         "agentId": {
           "target": "com.amazonaws.bedrockagent#Id",
           "traits": {
+            "smithy.api#documentation": "<p>The unique identifier of the agent.</p>",
             "smithy.api#required": {}
           }
         },
         "agentName": {
           "target": "com.amazonaws.bedrockagent#Name",
           "traits": {
+            "smithy.api#documentation": "<p>The name of the agent.</p>",
             "smithy.api#required": {}
           }
         },
         "agentStatus": {
           "target": "com.amazonaws.bedrockagent#AgentStatus",
           "traits": {
+            "smithy.api#documentation": "<p>The status of the agent.</p>",
             "smithy.api#required": {}
           }
         },
         "description": {
-          "target": "com.amazonaws.bedrockagent#Description"
+          "target": "com.amazonaws.bedrockagent#Description",
+          "traits": {
+            "smithy.api#documentation": "<p>The description of the agent.</p>"
+          }
         },
         "updatedAt": {
           "target": "com.amazonaws.bedrockagent#DateTimestamp",
           "traits": {
+            "smithy.api#documentation": "<p>The time at which the agent was last updated.</p>",
             "smithy.api#required": {}
           }
         },
         "latestAgentVersion": {
-          "target": "com.amazonaws.bedrockagent#Version"
+          "target": "com.amazonaws.bedrockagent#Version",
+          "traits": {
+            "smithy.api#documentation": "<p>The latest version of the agent.</p>"
+          }
         }
       },
       "traits": {
-        "smithy.api#documentation": "Summary of Agent."
+        "smithy.api#documentation": "<p>Contains details about an agent.</p>"
       }
     },
     "com.amazonaws.bedrockagent#AgentVersion": {
@@ -775,81 +888,111 @@
         "agentId": {
           "target": "com.amazonaws.bedrockagent#Id",
           "traits": {
+            "smithy.api#documentation": "<p>The unique identifier of the agent that the version belongs to.</p>",
             "smithy.api#required": {}
           }
         },
         "agentName": {
           "target": "com.amazonaws.bedrockagent#Name",
           "traits": {
+            "smithy.api#documentation": "<p>The name of the agent that the version belongs to.</p>",
             "smithy.api#required": {}
           }
         },
         "agentArn": {
           "target": "com.amazonaws.bedrockagent#AgentArn",
           "traits": {
+            "smithy.api#documentation": "<p>The ARN of the agent that the version belongs to.</p>",
             "smithy.api#required": {}
           }
         },
         "version": {
           "target": "com.amazonaws.bedrockagent#NumericalVersion",
           "traits": {
+            "smithy.api#documentation": "<p>The version number.</p>",
             "smithy.api#required": {}
           }
         },
         "instruction": {
-          "target": "com.amazonaws.bedrockagent#Instruction"
+          "target": "com.amazonaws.bedrockagent#Instruction",
+          "traits": {
+            "smithy.api#documentation": "<p>The instructions provided to the agent.</p>"
+          }
         },
         "agentStatus": {
           "target": "com.amazonaws.bedrockagent#AgentStatus",
           "traits": {
+            "smithy.api#documentation": "<p>The status of the agent that the version belongs to.</p>",
             "smithy.api#required": {}
           }
         },
         "foundationModel": {
-          "target": "com.amazonaws.bedrockagent#ModelIdentifier"
+          "target": "com.amazonaws.bedrockagent#ModelIdentifier",
+          "traits": {
+            "smithy.api#documentation": "<p>The foundation model that the version invokes.</p>"
+          }
         },
         "description": {
-          "target": "com.amazonaws.bedrockagent#Description"
+          "target": "com.amazonaws.bedrockagent#Description",
+          "traits": {
+            "smithy.api#documentation": "<p>The description of the version.</p>"
+          }
         },
         "idleSessionTTLInSeconds": {
           "target": "com.amazonaws.bedrockagent#SessionTTL",
           "traits": {
+            "smithy.api#documentation": "<p>The number of seconds for which Amazon Bedrock keeps information about a user's conversation with the agent.</p>\n         <p>A user interaction remains active for the amount of time specified. If no conversation occurs during this time, the session expires and Amazon Bedrock deletes any data provided before the timeout.</p>",
             "smithy.api#required": {}
           }
         },
         "agentResourceRoleArn": {
           "target": "com.amazonaws.bedrockagent#AgentRoleArn",
           "traits": {
+            "smithy.api#documentation": "<p>The ARN of the IAM role with permissions to invoke API operations on the agent. The ARN must begin with <code>AmazonBedrockExecutionRoleForAgents_</code>.</p>",
             "smithy.api#required": {}
           }
         },
         "customerEncryptionKeyArn": {
-          "target": "com.amazonaws.bedrockagent#KmsKeyArn"
+          "target": "com.amazonaws.bedrockagent#KmsKeyArn",
+          "traits": {
+            "smithy.api#documentation": "<p>The ARN of the KMS key that encrypts the agent.</p>"
+          }
         },
         "createdAt": {
           "target": "com.amazonaws.bedrockagent#DateTimestamp",
           "traits": {
+            "smithy.api#documentation": "<p>The time at which the version was created.</p>",
             "smithy.api#required": {}
           }
         },
         "updatedAt": {
           "target": "com.amazonaws.bedrockagent#DateTimestamp",
           "traits": {
+            "smithy.api#documentation": "<p>The time at which the version was last updated.</p>",
             "smithy.api#required": {}
           }
         },
         "failureReasons": {
-          "target": "com.amazonaws.bedrockagent#FailureReasons"
+          "target": "com.amazonaws.bedrockagent#FailureReasons",
+          "traits": {
+            "smithy.api#documentation": "<p>A list of reasons that the API operation on the version failed.</p>"
+          }
         },
         "recommendedActions": {
-          "target": "com.amazonaws.bedrockagent#RecommendedActions"
+          "target": "com.amazonaws.bedrockagent#RecommendedActions",
+          "traits": {
+            "smithy.api#documentation": "<p>A list of recommended actions to take for the failed API operation on the version to succeed.</p>"
+          }
         },
         "promptOverrideConfiguration": {
-          "target": "com.amazonaws.bedrockagent#PromptOverrideConfiguration"
+          "target": "com.amazonaws.bedrockagent#PromptOverrideConfiguration",
+          "traits": {
+            "smithy.api#documentation": "<p>Contains configurations to override prompt templates in different parts of an agent sequence. For more information, see <a href=\"https://docs.aws.amazon.com/bedrock/latest/userguide/advanced-prompts.html\">Advanced prompts</a>.</p>"
+          }
         }
       },
       "traits": {
-        "smithy.api#documentation": "Contains the information of an agent version."
+        "smithy.api#documentation": "<p>Contains details about a version of an agent.</p>"
       }
     },
     "com.amazonaws.bedrockagent#AgentVersionSummaries": {
@@ -858,7 +1001,6 @@
         "target": "com.amazonaws.bedrockagent#AgentVersionSummary"
       },
       "traits": {
-        "smithy.api#documentation": "List of AgentVersionSummary.",
         "smithy.api#length": {
           "max": 10
         }
@@ -870,39 +1012,47 @@
         "agentName": {
           "target": "com.amazonaws.bedrockagent#Name",
           "traits": {
+            "smithy.api#documentation": "<p>The name of the agent to which the version belongs.</p>",
             "smithy.api#required": {}
           }
         },
         "agentStatus": {
           "target": "com.amazonaws.bedrockagent#AgentStatus",
           "traits": {
+            "smithy.api#documentation": "<p>The status of the agent to which the version belongs.</p>",
             "smithy.api#required": {}
           }
         },
         "agentVersion": {
           "target": "com.amazonaws.bedrockagent#Version",
           "traits": {
+            "smithy.api#documentation": "<p>The version of the agent.</p>",
             "smithy.api#required": {}
           }
         },
         "createdAt": {
           "target": "com.amazonaws.bedrockagent#DateTimestamp",
           "traits": {
+            "smithy.api#documentation": "<p>The time at which the version was created.</p>",
             "smithy.api#required": {}
           }
         },
         "updatedAt": {
           "target": "com.amazonaws.bedrockagent#DateTimestamp",
           "traits": {
+            "smithy.api#documentation": "<p>The time at which the version was last updated.</p>",
             "smithy.api#required": {}
           }
         },
         "description": {
-          "target": "com.amazonaws.bedrockagent#Description"
+          "target": "com.amazonaws.bedrockagent#Description",
+          "traits": {
+            "smithy.api#documentation": "<p>The description of the version of the agent.</p>"
+          }
         }
       },
       "traits": {
-        "smithy.api#documentation": "Summary of agent version."
+        "smithy.api#documentation": "<p>Contains details about a version of an agent.</p>"
       }
     },
     "com.amazonaws.bedrockagent#AliasResource": {
@@ -977,7 +1127,7 @@
           "additionalExposedHeaders": ["x-amzn-errortype", "x-amzn-requestid", "x-amzn-trace-id"],
           "maxAge": 86400
         },
-        "smithy.api#documentation": "An example service, deployed with the Octane Service creator,\nwhich will echo the string",
+        "smithy.api#documentation": "<p>Describes the API operations for creating and managing Amazon Bedrock agents.</p>",
         "smithy.api#title": "Agents for Amazon Bedrock",
         "smithy.rules#endpointRuleSet": {
           "version": "1.0",
@@ -1677,7 +1827,7 @@
         }
       ],
       "traits": {
-        "smithy.api#documentation": "Associate a Knowledge Base to an existing Amazon Bedrock Agent",
+        "smithy.api#documentation": "<p>Associates a knowledge base with an agent. If a knowledge base is associated and its <code>indexState</code> is set to <code>Enabled</code>, the agent queries the knowledge base for information to augment its response to the user.</p>",
         "smithy.api#http": {
           "code": 200,
           "method": "PUT",
@@ -1693,7 +1843,7 @@
         "agentId": {
           "target": "com.amazonaws.bedrockagent#Id",
           "traits": {
-            "smithy.api#documentation": "Id generated at the server side when an Agent is created",
+            "smithy.api#documentation": "<p>The unique identifier of the agent with which you want to associate the knowledge base.</p>",
             "smithy.api#httpLabel": {},
             "smithy.api#required": {}
           }
@@ -1701,7 +1851,7 @@
         "agentVersion": {
           "target": "com.amazonaws.bedrockagent#DraftVersion",
           "traits": {
-            "smithy.api#documentation": "Draft Version of the Agent.",
+            "smithy.api#documentation": "<p>The version of the agent with which you want to associate the knowledge base.</p>",
             "smithy.api#httpLabel": {},
             "smithy.api#required": {}
           }
@@ -1709,21 +1859,25 @@
         "knowledgeBaseId": {
           "target": "com.amazonaws.bedrockagent#Id",
           "traits": {
+            "smithy.api#documentation": "<p>The unique identifier of the knowledge base to associate with the agent.</p>",
             "smithy.api#required": {}
           }
         },
         "description": {
           "target": "com.amazonaws.bedrockagent#Description",
           "traits": {
+            "smithy.api#documentation": "<p>A description of what the agent should use the knowledge base for.</p>",
             "smithy.api#required": {}
           }
         },
         "knowledgeBaseState": {
-          "target": "com.amazonaws.bedrockagent#KnowledgeBaseState"
+          "target": "com.amazonaws.bedrockagent#KnowledgeBaseState",
+          "traits": {
+            "smithy.api#documentation": "<p>Specifies whether to use the knowledge base or not when sending an <a href=\"https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvokeAgent.html\">InvokeAgent</a> request.</p>"
+          }
         }
       },
       "traits": {
-        "smithy.api#documentation": "Associate Agent Knowledge Base Request",
         "smithy.api#input": {}
       }
     },
@@ -1733,19 +1887,18 @@
         "agentKnowledgeBase": {
           "target": "com.amazonaws.bedrockagent#AgentKnowledgeBase",
           "traits": {
+            "smithy.api#documentation": "<p>Contains details about the knowledge base that has been associated with the agent.</p>",
             "smithy.api#required": {}
           }
         }
       },
       "traits": {
-        "smithy.api#documentation": "Associate Agent Knowledge Base Response",
         "smithy.api#output": {}
       }
     },
     "com.amazonaws.bedrockagent#BasePromptTemplate": {
       "type": "string",
       "traits": {
-        "smithy.api#documentation": "Base Prompt Template.",
         "smithy.api#length": {
           "min": 1,
           "max": 100000
@@ -1755,7 +1908,6 @@
     "com.amazonaws.bedrockagent#BedrockEmbeddingModelArn": {
       "type": "string",
       "traits": {
-        "smithy.api#documentation": "Arn of a Bedrock model.",
         "smithy.api#length": {
           "min": 20,
           "max": 1011
@@ -1769,15 +1921,19 @@
         "chunkingStrategy": {
           "target": "com.amazonaws.bedrockagent#ChunkingStrategy",
           "traits": {
+            "smithy.api#documentation": "<p>Knowledge base can split your source data into chunks. A <i>chunk</i> refers to an excerpt from a data source that is returned when the knowledge base that it belongs to is queried. You have the following options for chunking your data. If you opt for <code>NONE</code>, then you may want to pre-process your files by splitting them up such that each file corresponds to a chunk.</p>\n         <ul>\n            <li>\n               <p>\n                  <code>FIXED_SIZE</code> – Amazon Bedrock splits your source data into chunks of the approximate size that you set in the <code>fixedSizeChunkingConfiguration</code>.</p>\n            </li>\n            <li>\n               <p>\n                  <code>NONE</code> – Amazon Bedrock treats each file as one chunk. If you choose this option, you may want to pre-process your documents by splitting them into separate files.</p>\n            </li>\n         </ul>",
             "smithy.api#required": {}
           }
         },
         "fixedSizeChunkingConfiguration": {
-          "target": "com.amazonaws.bedrockagent#FixedSizeChunkingConfiguration"
+          "target": "com.amazonaws.bedrockagent#FixedSizeChunkingConfiguration",
+          "traits": {
+            "smithy.api#documentation": "<p>Configurations for when you choose fixed-size chunking. If you set the <code>chunkingStrategy</code> as <code>NONE</code>, exclude this field.</p>"
+          }
         }
       },
       "traits": {
-        "smithy.api#documentation": "Configures chunking strategy"
+        "smithy.api#documentation": "<p>Details about how to chunk the documents in the data source. A <i>chunk</i> refers to an excerpt from a data source that is returned when the knowledge base that it belongs to is queried.</p>"
       }
     },
     "com.amazonaws.bedrockagent#ChunkingStrategy": {
@@ -1795,15 +1951,11 @@
             "smithy.api#enumValue": "NONE"
           }
         }
-      },
-      "traits": {
-        "smithy.api#documentation": "The type of chunking strategy"
       }
     },
     "com.amazonaws.bedrockagent#ClientToken": {
       "type": "string",
       "traits": {
-        "smithy.api#documentation": "Client specified token used for idempotency checks",
         "smithy.api#length": {
           "min": 33,
           "max": 256
@@ -1814,7 +1966,6 @@
     "com.amazonaws.bedrockagent#ColumnName": {
       "type": "string",
       "traits": {
-        "smithy.api#documentation": "Name of the column",
         "smithy.api#length": {
           "max": 63
         },
@@ -1829,7 +1980,7 @@
         }
       },
       "traits": {
-        "smithy.api#documentation": "This exception is thrown when there is a conflict performing an operation",
+        "smithy.api#documentation": "<p>There was a conflict performing an operation.</p>",
         "smithy.api#error": "client",
         "smithy.api#httpError": 409
       }
@@ -1863,7 +2014,7 @@
         }
       ],
       "traits": {
-        "smithy.api#documentation": "Creates an Amazon Bedrock Agent",
+        "smithy.api#documentation": "<p>Creates an agent that orchestrates interactions between foundation models, data sources, software applications, user conversations, and APIs to carry out tasks to help customers.</p>\n         <ul>\n            <li>\n               <p>Specify the following fields for security purposes.</p>\n               <ul>\n                  <li>\n                     <p>\n                        <code>agentResourceRoleArn</code> – The ARN of the role with permissions to create an agent.</p>\n                  </li>\n                  <li>\n                     <p>(Optional) <code>customerEncryptionKeyArn</code> – The ARN of a KMS key to encrypt the creation of the agent.</p>\n                  </li>\n                  <li>\n                     <p>(Optional) <code>idleSessionTTLinSeconds</code> – Specify the number of seconds for which the agent should maintain session information. After this time expires, the subsequent <code>InvokeAgent</code> request begins a new session.</p>\n                  </li>\n               </ul>\n            </li>\n            <li>\n               <p>To override the default prompt behavior for agent orchestration and to use advanced prompts, include a <code>promptOverrideConfiguration</code> object. For more information, see <a href=\"https://docs.aws.amazon.com/bedrock/latest/userguide/advanced-prompts.html\">Advanced prompts</a>.</p>\n            </li>\n            <li>\n               <p>If you agent fails to be created, the response returns a list of <code>failureReasons</code> alongside a list of <code>recommendedActions</code> for you to troubleshoot.</p>\n            </li>\n         </ul>",
         "smithy.api#http": {
           "code": 202,
           "method": "PUT",
@@ -1905,7 +2056,7 @@
         }
       ],
       "traits": {
-        "smithy.api#documentation": "Creates an Action Group for existing Amazon Bedrock Agent",
+        "smithy.api#documentation": "<p>Creates an action group for an agent. An action group represents the actions that an agent can carry out for the customer by defining the APIs that an agent can call and the logic for calling them.</p>\n         <p>To allow your agent to request the user for additional information when trying to complete a task, add an action group with the <code>parentActionGroupSignature</code> field set to <code>AMAZON.UserInput</code>. You must leave the <code>description</code>, <code>apiSchema</code>, and <code>actionGroupExecutor</code> fields blank for this action group. During orchestration, if your agent determines that it needs to invoke an API in an action group, but doesn't have enough information to complete the API request, it will invoke this action group instead and return an <a href=\"https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_Observation.html\">Observation</a> reprompting the user for more information.</p>",
         "smithy.api#http": {
           "code": 200,
           "method": "PUT",
@@ -1921,7 +2072,7 @@
         "agentId": {
           "target": "com.amazonaws.bedrockagent#Id",
           "traits": {
-            "smithy.api#documentation": "Id generated at the server side when an Agent is created",
+            "smithy.api#documentation": "<p>The unique identifier of the agent for which to create the action group.</p>",
             "smithy.api#httpLabel": {},
             "smithy.api#required": {}
           }
@@ -1929,7 +2080,7 @@
         "agentVersion": {
           "target": "com.amazonaws.bedrockagent#DraftVersion",
           "traits": {
-            "smithy.api#documentation": "Draft Version of the Agent.",
+            "smithy.api#documentation": "<p>The version of the agent for which to create the action group.</p>",
             "smithy.api#httpLabel": {},
             "smithy.api#required": {}
           }
@@ -1937,33 +2088,49 @@
         "actionGroupName": {
           "target": "com.amazonaws.bedrockagent#Name",
           "traits": {
+            "smithy.api#documentation": "<p>The name to give the action group.</p>",
             "smithy.api#required": {}
           }
         },
         "clientToken": {
           "target": "com.amazonaws.bedrockagent#ClientToken",
           "traits": {
+            "smithy.api#documentation": "<p>A unique, case-sensitive identifier to ensure that the API request completes no more than one time. If this token matches a previous request,\n      Amazon Bedrock ignores the request, but does not return an error. For more information, see <a href=\"https://docs.aws.amazon.com/AWSEC2/latest/APIReference/Run_Instance_Idempotency.html\">Ensuring idempotency</a>.</p>",
             "smithy.api#idempotencyToken": {}
           }
         },
         "description": {
-          "target": "com.amazonaws.bedrockagent#Description"
+          "target": "com.amazonaws.bedrockagent#Description",
+          "traits": {
+            "smithy.api#documentation": "<p>A description of the action group.</p>"
+          }
         },
         "parentActionGroupSignature": {
-          "target": "com.amazonaws.bedrockagent#ActionGroupSignature"
+          "target": "com.amazonaws.bedrockagent#ActionGroupSignature",
+          "traits": {
+            "smithy.api#documentation": "<p>To allow your agent to request the user for additional information when trying to complete a task, set this field to <code>AMAZON.UserInput</code>. You must leave the <code>description</code>, <code>apiSchema</code>, and <code>actionGroupExecutor</code> fields blank for this action group.</p>\n         <p>During orchestration, if your agent determines that it needs to invoke an API in an action group, but doesn't have enough information to complete the API request, it will invoke this action group instead and return an <a href=\"https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_Observation.html\">Observation</a> reprompting the user for more information.</p>"
+          }
         },
         "actionGroupExecutor": {
-          "target": "com.amazonaws.bedrockagent#ActionGroupExecutor"
+          "target": "com.amazonaws.bedrockagent#ActionGroupExecutor",
+          "traits": {
+            "smithy.api#documentation": "<p>The ARN of the Lambda function containing the business logic that is carried out upon invoking the action.</p>"
+          }
         },
         "apiSchema": {
-          "target": "com.amazonaws.bedrockagent#APISchema"
+          "target": "com.amazonaws.bedrockagent#APISchema",
+          "traits": {
+            "smithy.api#documentation": "<p>Contains either details about the S3 object containing the OpenAPI schema for the action group or the JSON or YAML-formatted payload defining the schema. For more information, see <a href=\"https://docs.aws.amazon.com/bedrock/latest/userguide/agents-api-schema.html\">Action group OpenAPI schemas</a>.</p>"
+          }
         },
         "actionGroupState": {
-          "target": "com.amazonaws.bedrockagent#ActionGroupState"
+          "target": "com.amazonaws.bedrockagent#ActionGroupState",
+          "traits": {
+            "smithy.api#documentation": "<p>Specifies whether the action group is available for the agent to invoke or not when sending an <a href=\"https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvokeAgent.html\">InvokeAgent</a> request.</p>"
+          }
         }
       },
       "traits": {
-        "smithy.api#documentation": "Create Action Group Request",
         "smithy.api#input": {}
       }
     },
@@ -1973,12 +2140,12 @@
         "agentActionGroup": {
           "target": "com.amazonaws.bedrockagent#AgentActionGroup",
           "traits": {
+            "smithy.api#documentation": "<p>Contains details about the action group that was created.</p>",
             "smithy.api#required": {}
           }
         }
       },
       "traits": {
-        "smithy.api#documentation": "Create Action Group Response",
         "smithy.api#output": {}
       }
     },
@@ -2014,7 +2181,7 @@
         }
       ],
       "traits": {
-        "smithy.api#documentation": "Creates an Alias for an existing Amazon Bedrock Agent",
+        "smithy.api#documentation": "<p>Creates an alias of an agent that can be used to deploy the agent.</p>",
         "smithy.api#http": {
           "code": 202,
           "method": "PUT",
@@ -2030,7 +2197,7 @@
         "agentId": {
           "target": "com.amazonaws.bedrockagent#Id",
           "traits": {
-            "smithy.api#documentation": "Id generated at the server side when an Agent is created",
+            "smithy.api#documentation": "<p>The unique identifier of the agent.</p>",
             "smithy.api#httpLabel": {},
             "smithy.api#required": {}
           }
@@ -2038,27 +2205,37 @@
         "agentAliasName": {
           "target": "com.amazonaws.bedrockagent#Name",
           "traits": {
+            "smithy.api#documentation": "<p>The name of the alias.</p>",
             "smithy.api#required": {}
           }
         },
         "clientToken": {
           "target": "com.amazonaws.bedrockagent#ClientToken",
           "traits": {
+            "smithy.api#documentation": "<p>A unique, case-sensitive identifier to ensure that the API request completes no more than one time. If this token matches a previous request,\n      Amazon Bedrock ignores the request, but does not return an error. For more information, see <a href=\"https://docs.aws.amazon.com/AWSEC2/latest/APIReference/Run_Instance_Idempotency.html\">Ensuring idempotency</a>.</p>",
             "smithy.api#idempotencyToken": {}
           }
         },
         "description": {
-          "target": "com.amazonaws.bedrockagent#Description"
+          "target": "com.amazonaws.bedrockagent#Description",
+          "traits": {
+            "smithy.api#documentation": "<p>A description of the alias of the agent.</p>"
+          }
         },
         "routingConfiguration": {
-          "target": "com.amazonaws.bedrockagent#AgentAliasRoutingConfiguration"
+          "target": "com.amazonaws.bedrockagent#AgentAliasRoutingConfiguration",
+          "traits": {
+            "smithy.api#documentation": "<p>Contains details about the routing configuration of the alias.</p>"
+          }
         },
         "tags": {
-          "target": "com.amazonaws.bedrockagent#TagsMap"
+          "target": "com.amazonaws.bedrockagent#TagsMap",
+          "traits": {
+            "smithy.api#documentation": "<p>Any tags that you want to attach to the alias of the agent.</p>"
+          }
         }
       },
       "traits": {
-        "smithy.api#documentation": "Create Agent Alias Request",
         "smithy.api#input": {}
       }
     },
@@ -2068,12 +2245,12 @@
         "agentAlias": {
           "target": "com.amazonaws.bedrockagent#AgentAlias",
           "traits": {
+            "smithy.api#documentation": "<p>Contains details about the alias that was created.</p>",
             "smithy.api#required": {}
           }
         }
       },
       "traits": {
-        "smithy.api#documentation": "Create Agent Alias Response",
         "smithy.api#output": {}
       }
     },
@@ -2083,45 +2260,68 @@
         "agentName": {
           "target": "com.amazonaws.bedrockagent#Name",
           "traits": {
+            "smithy.api#documentation": "<p>A name for the agent that you create.</p>",
             "smithy.api#required": {}
           }
         },
         "clientToken": {
           "target": "com.amazonaws.bedrockagent#ClientToken",
           "traits": {
+            "smithy.api#documentation": "<p>A unique, case-sensitive identifier to ensure that the API request completes no more than one time. If this token matches a previous request,\n      Amazon Bedrock ignores the request, but does not return an error. For more information, see <a href=\"https://docs.aws.amazon.com/AWSEC2/latest/APIReference/Run_Instance_Idempotency.html\">Ensuring idempotency</a>.</p>",
             "smithy.api#idempotencyToken": {}
           }
         },
         "instruction": {
-          "target": "com.amazonaws.bedrockagent#Instruction"
+          "target": "com.amazonaws.bedrockagent#Instruction",
+          "traits": {
+            "smithy.api#documentation": "<p>Instructions that tell the agent what it should do and how it should interact with users.</p>"
+          }
         },
         "foundationModel": {
-          "target": "com.amazonaws.bedrockagent#ModelIdentifier"
+          "target": "com.amazonaws.bedrockagent#ModelIdentifier",
+          "traits": {
+            "smithy.api#documentation": "<p>The foundation model to be used for orchestration by the agent you create.</p>"
+          }
         },
         "description": {
-          "target": "com.amazonaws.bedrockagent#Description"
+          "target": "com.amazonaws.bedrockagent#Description",
+          "traits": {
+            "smithy.api#documentation": "<p>A description of the agent.</p>"
+          }
         },
         "idleSessionTTLInSeconds": {
-          "target": "com.amazonaws.bedrockagent#SessionTTL"
+          "target": "com.amazonaws.bedrockagent#SessionTTL",
+          "traits": {
+            "smithy.api#documentation": "<p>The number of seconds for which Amazon Bedrock keeps information about a user's conversation with the agent.</p>\n         <p>A user interaction remains active for the amount of time specified. If no conversation occurs during this time, the session expires and Amazon Bedrock deletes any data provided before the timeout.</p>"
+          }
         },
         "agentResourceRoleArn": {
           "target": "com.amazonaws.bedrockagent#AgentRoleArn",
           "traits": {
+            "smithy.api#documentation": "<p>The ARN of the IAM role with permissions to create the agent. The ARN must begin with <code>AmazonBedrockExecutionRoleForAgents_</code>.</p>",
             "smithy.api#required": {}
           }
         },
         "customerEncryptionKeyArn": {
-          "target": "com.amazonaws.bedrockagent#KmsKeyArn"
+          "target": "com.amazonaws.bedrockagent#KmsKeyArn",
+          "traits": {
+            "smithy.api#documentation": "<p>The ARN of the KMS key with which to encrypt the agent.</p>"
+          }
         },
         "tags": {
-          "target": "com.amazonaws.bedrockagent#TagsMap"
+          "target": "com.amazonaws.bedrockagent#TagsMap",
+          "traits": {
+            "smithy.api#documentation": "<p>Any tags that you want to attach to the agent.</p>"
+          }
         },
         "promptOverrideConfiguration": {
-          "target": "com.amazonaws.bedrockagent#PromptOverrideConfiguration"
+          "target": "com.amazonaws.bedrockagent#PromptOverrideConfiguration",
+          "traits": {
+            "smithy.api#documentation": "<p>Contains configurations to override prompts in different parts of an agent sequence. For more information, see <a href=\"https://docs.aws.amazon.com/bedrock/latest/userguide/advanced-prompts.html\">Advanced prompts</a>.</p>"
+          }
         }
       },
       "traits": {
-        "smithy.api#documentation": "Create Agent Request",
         "smithy.api#input": {}
       }
     },
@@ -2131,12 +2331,12 @@
         "agent": {
           "target": "com.amazonaws.bedrockagent#Agent",
           "traits": {
+            "smithy.api#documentation": "<p>Contains details about the agent created.</p>",
             "smithy.api#required": {}
           }
         }
       },
       "traits": {
-        "smithy.api#documentation": "Create Agent Response",
         "smithy.api#output": {}
       }
     },
@@ -2172,7 +2372,7 @@
         }
       ],
       "traits": {
-        "smithy.api#documentation": "Create a new data source",
+        "smithy.api#documentation": "<p>Sets up a data source to be added to a knowledge base.</p>\n         <important>\n            <p>You can't change the <code>chunkingConfiguration</code> after you create the data source.</p>\n         </important>",
         "smithy.api#http": {
           "code": 200,
           "method": "PUT",
@@ -2188,6 +2388,7 @@
         "knowledgeBaseId": {
           "target": "com.amazonaws.bedrockagent#Id",
           "traits": {
+            "smithy.api#documentation": "<p>The unique identifier of the knowledge base to which to add the data source.</p>",
             "smithy.api#httpLabel": {},
             "smithy.api#required": {}
           }
@@ -2195,29 +2396,41 @@
         "clientToken": {
           "target": "com.amazonaws.bedrockagent#ClientToken",
           "traits": {
+            "smithy.api#documentation": "<p>A unique, case-sensitive identifier to ensure that the API request completes no more than one time. If this token matches a previous request,\n      Amazon Bedrock ignores the request, but does not return an error. For more information, see <a href=\"https://docs.aws.amazon.com/AWSEC2/latest/APIReference/Run_Instance_Idempotency.html\">Ensuring idempotency</a>.</p>",
             "smithy.api#idempotencyToken": {}
           }
         },
         "name": {
           "target": "com.amazonaws.bedrockagent#Name",
           "traits": {
+            "smithy.api#documentation": "<p>The name of the data source.</p>",
             "smithy.api#required": {}
           }
         },
         "description": {
-          "target": "com.amazonaws.bedrockagent#Description"
+          "target": "com.amazonaws.bedrockagent#Description",
+          "traits": {
+            "smithy.api#documentation": "<p>A description of the data source.</p>"
+          }
         },
         "dataSourceConfiguration": {
           "target": "com.amazonaws.bedrockagent#DataSourceConfiguration",
           "traits": {
+            "smithy.api#documentation": "<p>Contains metadata about where the data source is stored.</p>",
             "smithy.api#required": {}
           }
         },
         "serverSideEncryptionConfiguration": {
-          "target": "com.amazonaws.bedrockagent#ServerSideEncryptionConfiguration"
+          "target": "com.amazonaws.bedrockagent#ServerSideEncryptionConfiguration",
+          "traits": {
+            "smithy.api#documentation": "<p>Contains details about the server-side encryption for the data source.</p>"
+          }
         },
         "vectorIngestionConfiguration": {
-          "target": "com.amazonaws.bedrockagent#VectorIngestionConfiguration"
+          "target": "com.amazonaws.bedrockagent#VectorIngestionConfiguration",
+          "traits": {
+            "smithy.api#documentation": "<p>Contains details about how to ingest the documents in the data source.</p>"
+          }
         }
       },
       "traits": {
@@ -2230,6 +2443,7 @@
         "dataSource": {
           "target": "com.amazonaws.bedrockagent#DataSource",
           "traits": {
+            "smithy.api#documentation": "<p>Contains details about the data source.</p>",
             "smithy.api#required": {}
           }
         }
@@ -2267,7 +2481,7 @@
         }
       ],
       "traits": {
-        "smithy.api#documentation": "Create a new knowledge base",
+        "smithy.api#documentation": "<p>Creates a knowledge base that contains data sources from which information can be queried and used by LLMs. To create a knowledge base, you must first set up your data sources and configure a supported vector store. For more information, see <a href=\"https://docs.aws.amazon.com/bedrock/latest/userguide/knowledge-base-setup.html\">Set up your data for ingestion</a>.</p>\n         <note>\n            <p>If you prefer to let Amazon Bedrock create and manage a vector store for you in Amazon OpenSearch Service, use the console. For more information, see <a href=\"https://docs.aws.amazon.com/bedrock/latest/userguide/knowledge-base-create\">Create a knowledge base</a>.</p>\n         </note>\n         <ul>\n            <li>\n               <p>Provide the <code>name</code> and an optional <code>description</code>.</p>\n            </li>\n            <li>\n               <p>Provide the ARN with permissions to create a knowledge base in the <code>roleArn</code> field.</p>\n            </li>\n            <li>\n               <p>Provide the embedding model to use in the <code>embeddingModelArn</code> field in the <code>knowledgeBaseConfiguration</code> object.</p>\n            </li>\n            <li>\n               <p>Provide the configuration for your vector store in the <code>storageConfiguration</code> object.</p>\n               <ul>\n                  <li>\n                     <p>For an Amazon OpenSearch Service database, use the <code>opensearchServerlessConfiguration</code> object. For more information, see <a href=\"https://docs.aws.amazon.com/bedrock/latest/userguide/knowledge-base-setup-oss.html\">Create a vector store in Amazon OpenSearch Service</a>.</p>\n                  </li>\n                  <li>\n                     <p>For an Amazon Aurora database, use the <code>RdsConfiguration</code> object. For more information, see <a href=\"https://docs.aws.amazon.com/bedrock/latest/userguide/knowledge-base-setup-rds.html\">Create a vector store in Amazon Aurora</a>.</p>\n                  </li>\n                  <li>\n                     <p>For a Pinecone database, use the <code>pineconeConfiguration</code> object. For more information, see <a href=\"https://docs.aws.amazon.com/bedrock/latest/userguide/knowledge-base-setup-pinecone.html\">Create a vector store in Pinecone</a>.</p>\n                  </li>\n                  <li>\n                     <p>For a Redis Enterprise Cloud database, use the <code>redisEnterpriseCloudConfiguration</code> object. For more information, see <a href=\"https://docs.aws.amazon.com/bedrock/latest/userguide/knowledge-base-setup-redis.html\">Create a vector store in Redis Enterprise Cloud</a>.</p>\n                  </li>\n               </ul>\n            </li>\n         </ul>",
         "smithy.api#http": {
           "code": 202,
           "method": "PUT",
@@ -2283,38 +2497,49 @@
         "clientToken": {
           "target": "com.amazonaws.bedrockagent#ClientToken",
           "traits": {
+            "smithy.api#documentation": "<p>A unique, case-sensitive identifier to ensure that the API request completes no more than one time. If this token matches a previous request,\n      Amazon Bedrock ignores the request, but does not return an error. For more information, see <a href=\"https://docs.aws.amazon.com/AWSEC2/latest/APIReference/Run_Instance_Idempotency.html\">Ensuring idempotency</a>.</p>",
             "smithy.api#idempotencyToken": {}
           }
         },
         "name": {
           "target": "com.amazonaws.bedrockagent#Name",
           "traits": {
+            "smithy.api#documentation": "<p>A name for the knowledge base.</p>",
             "smithy.api#required": {}
           }
         },
         "description": {
-          "target": "com.amazonaws.bedrockagent#Description"
+          "target": "com.amazonaws.bedrockagent#Description",
+          "traits": {
+            "smithy.api#documentation": "<p>A description of the knowledge base.</p>"
+          }
         },
         "roleArn": {
           "target": "com.amazonaws.bedrockagent#KnowledgeBaseRoleArn",
           "traits": {
+            "smithy.api#documentation": "<p>The ARN of the IAM role with permissions to create the knowledge base.</p>",
             "smithy.api#required": {}
           }
         },
         "knowledgeBaseConfiguration": {
           "target": "com.amazonaws.bedrockagent#KnowledgeBaseConfiguration",
           "traits": {
+            "smithy.api#documentation": "<p>Contains details about the embeddings model used for the knowledge base.</p>",
             "smithy.api#required": {}
           }
         },
         "storageConfiguration": {
           "target": "com.amazonaws.bedrockagent#StorageConfiguration",
           "traits": {
+            "smithy.api#documentation": "<p>Contains details about the configuration of the vector database used for the knowledge base.</p>",
             "smithy.api#required": {}
           }
         },
         "tags": {
-          "target": "com.amazonaws.bedrockagent#TagsMap"
+          "target": "com.amazonaws.bedrockagent#TagsMap",
+          "traits": {
+            "smithy.api#documentation": "<p>Specify the key-value pairs for the tags that you want to attach to your knowledge base in this object.</p>"
+          }
         }
       },
       "traits": {
@@ -2327,6 +2552,7 @@
         "knowledgeBase": {
           "target": "com.amazonaws.bedrockagent#KnowledgeBase",
           "traits": {
+            "smithy.api#documentation": "<p>Contains details about the knowledge base.</p>",
             "smithy.api#required": {}
           }
         }
@@ -2350,9 +2576,6 @@
             "smithy.api#enumValue": "OVERRIDDEN"
           }
         }
-      },
-      "traits": {
-        "smithy.api#documentation": "Creation Mode for Prompt Configuration."
       }
     },
     "com.amazonaws.bedrockagent#DataSource": {
@@ -2361,57 +2584,73 @@
         "knowledgeBaseId": {
           "target": "com.amazonaws.bedrockagent#Id",
           "traits": {
+            "smithy.api#documentation": "<p>The unique identifier of the knowledge base to which the data source belongs.</p>",
             "smithy.api#required": {}
           }
         },
         "dataSourceId": {
           "target": "com.amazonaws.bedrockagent#Id",
           "traits": {
+            "smithy.api#documentation": "<p>The unique identifier of the data source.</p>",
             "smithy.api#required": {}
           }
         },
         "name": {
           "target": "com.amazonaws.bedrockagent#Name",
           "traits": {
+            "smithy.api#documentation": "<p>The name of the data source.</p>",
             "smithy.api#required": {}
           }
         },
         "status": {
           "target": "com.amazonaws.bedrockagent#DataSourceStatus",
           "traits": {
+            "smithy.api#documentation": "<p>The status of the data source. The following statuses are possible:</p>\n         <ul>\n            <li>\n               <p>Available – The data source has been created and is ready for ingestion into the knowledge base.</p>\n            </li>\n            <li>\n               <p>Deleting – The data source is being deleted.</p>\n            </li>\n         </ul>",
             "smithy.api#required": {}
           }
         },
         "description": {
-          "target": "com.amazonaws.bedrockagent#Description"
+          "target": "com.amazonaws.bedrockagent#Description",
+          "traits": {
+            "smithy.api#documentation": "<p>The description of the data source.</p>"
+          }
         },
         "dataSourceConfiguration": {
           "target": "com.amazonaws.bedrockagent#DataSourceConfiguration",
           "traits": {
+            "smithy.api#documentation": "<p>Contains details about how the data source is stored.</p>",
             "smithy.api#required": {}
           }
         },
         "serverSideEncryptionConfiguration": {
-          "target": "com.amazonaws.bedrockagent#ServerSideEncryptionConfiguration"
+          "target": "com.amazonaws.bedrockagent#ServerSideEncryptionConfiguration",
+          "traits": {
+            "smithy.api#documentation": "<p>Contains details about the configuration of the server-side encryption.</p>"
+          }
         },
         "vectorIngestionConfiguration": {
-          "target": "com.amazonaws.bedrockagent#VectorIngestionConfiguration"
+          "target": "com.amazonaws.bedrockagent#VectorIngestionConfiguration",
+          "traits": {
+            "smithy.api#documentation": "<p>Contains details about how to ingest the documents in the data source.</p>"
+          }
         },
         "createdAt": {
           "target": "com.amazonaws.bedrockagent#DateTimestamp",
           "traits": {
+            "smithy.api#documentation": "<p>The time at which the data source was created.</p>",
             "smithy.api#required": {}
           }
         },
         "updatedAt": {
           "target": "com.amazonaws.bedrockagent#DateTimestamp",
           "traits": {
+            "smithy.api#documentation": "<p>The time at which the data source was last updated.</p>",
             "smithy.api#required": {}
           }
         }
       },
       "traits": {
-        "smithy.api#documentation": "Contains the information of a data source."
+        "smithy.api#documentation": "<p>Contains details about a data source.</p>"
       }
     },
     "com.amazonaws.bedrockagent#DataSourceConfiguration": {
@@ -2420,15 +2659,19 @@
         "type": {
           "target": "com.amazonaws.bedrockagent#DataSourceType",
           "traits": {
+            "smithy.api#documentation": "<p>The type of storage for the data source.</p>",
             "smithy.api#required": {}
           }
         },
         "s3Configuration": {
-          "target": "com.amazonaws.bedrockagent#S3DataSourceConfiguration"
+          "target": "com.amazonaws.bedrockagent#S3DataSourceConfiguration",
+          "traits": {
+            "smithy.api#documentation": "<p>Contains details about the configuration of the S3 object containing the data source.</p>"
+          }
         }
       },
       "traits": {
-        "smithy.api#documentation": "Specifies a raw data source location to ingest."
+        "smithy.api#documentation": "<p>Contains details about how a data source is stored.</p>"
       }
     },
     "com.amazonaws.bedrockagent#DataSourceResource": {
@@ -2466,18 +2709,12 @@
             "smithy.api#enumValue": "DELETING"
           }
         }
-      },
-      "traits": {
-        "smithy.api#documentation": "The status of a data source."
       }
     },
     "com.amazonaws.bedrockagent#DataSourceSummaries": {
       "type": "list",
       "member": {
         "target": "com.amazonaws.bedrockagent#DataSourceSummary"
-      },
-      "traits": {
-        "smithy.api#documentation": "list of data source summaries"
       }
     },
     "com.amazonaws.bedrockagent#DataSourceSummary": {
@@ -2486,39 +2723,47 @@
         "knowledgeBaseId": {
           "target": "com.amazonaws.bedrockagent#Id",
           "traits": {
+            "smithy.api#documentation": "<p>The unique identifier of the knowledge base to which the data source belongs.</p>",
             "smithy.api#required": {}
           }
         },
         "dataSourceId": {
           "target": "com.amazonaws.bedrockagent#Id",
           "traits": {
+            "smithy.api#documentation": "<p>The unique identifier of the data source.</p>",
             "smithy.api#required": {}
           }
         },
         "name": {
           "target": "com.amazonaws.bedrockagent#Name",
           "traits": {
+            "smithy.api#documentation": "<p>The name of the data source.</p>",
             "smithy.api#required": {}
           }
         },
         "status": {
           "target": "com.amazonaws.bedrockagent#DataSourceStatus",
           "traits": {
+            "smithy.api#documentation": "<p>The status of the data source.</p>",
             "smithy.api#required": {}
           }
         },
         "description": {
-          "target": "com.amazonaws.bedrockagent#Description"
+          "target": "com.amazonaws.bedrockagent#Description",
+          "traits": {
+            "smithy.api#documentation": "<p>The description of the data source.</p>"
+          }
         },
         "updatedAt": {
           "target": "com.amazonaws.bedrockagent#DateTimestamp",
           "traits": {
+            "smithy.api#documentation": "<p>The time at which the data source was last updated.</p>",
             "smithy.api#required": {}
           }
         }
       },
       "traits": {
-        "smithy.api#documentation": "Summary information of a data source."
+        "smithy.api#documentation": "<p>Contains details about a data source.</p>"
       }
     },
     "com.amazonaws.bedrockagent#DataSourceType": {
@@ -2530,15 +2775,11 @@
             "smithy.api#enumValue": "S3"
           }
         }
-      },
-      "traits": {
-        "smithy.api#documentation": "The type of the data source location."
       }
     },
     "com.amazonaws.bedrockagent#DateTimestamp": {
       "type": "timestamp",
       "traits": {
-        "smithy.api#documentation": "Time Stamp.",
         "smithy.api#timestampFormat": "date-time"
       }
     },
@@ -2571,7 +2812,7 @@
         }
       ],
       "traits": {
-        "smithy.api#documentation": "Deletes an Agent for existing Amazon Bedrock Agent",
+        "smithy.api#documentation": "<p>Deletes an agent.</p>",
         "smithy.api#http": {
           "code": 202,
           "method": "DELETE",
@@ -2610,7 +2851,7 @@
         }
       ],
       "traits": {
-        "smithy.api#documentation": "Deletes an Action Group for existing Amazon Bedrock Agent.",
+        "smithy.api#documentation": "<p>Deletes an action group in an agent.</p>",
         "smithy.api#http": {
           "code": 204,
           "method": "DELETE",
@@ -2626,7 +2867,7 @@
         "agentId": {
           "target": "com.amazonaws.bedrockagent#Id",
           "traits": {
-            "smithy.api#documentation": "Id generated at the server side when an Agent is created",
+            "smithy.api#documentation": "<p>The unique identifier of the agent that the action group belongs to.</p>",
             "smithy.api#httpLabel": {},
             "smithy.api#required": {}
           }
@@ -2634,7 +2875,7 @@
         "agentVersion": {
           "target": "com.amazonaws.bedrockagent#DraftVersion",
           "traits": {
-            "smithy.api#documentation": "Draft Version of the Agent.",
+            "smithy.api#documentation": "<p>The version of the agent that the action group belongs to.</p>",
             "smithy.api#httpLabel": {},
             "smithy.api#required": {}
           }
@@ -2642,7 +2883,7 @@
         "actionGroupId": {
           "target": "com.amazonaws.bedrockagent#Id",
           "traits": {
-            "smithy.api#documentation": "Id generated at the server side when an Agent ActionGroup is created",
+            "smithy.api#documentation": "<p>The unique identifier of the action group to delete.</p>",
             "smithy.api#httpLabel": {},
             "smithy.api#required": {}
           }
@@ -2651,13 +2892,12 @@
           "target": "smithy.api#Boolean",
           "traits": {
             "smithy.api#default": false,
-            "smithy.api#documentation": "Skips checking if resource is in use when set to true. Defaults to false",
+            "smithy.api#documentation": "<p>By default, this value is <code>false</code> and deletion is stopped if the resource is in use. If you set it to <code>true</code>, the resource will be deleted even if the resource is in use.</p>",
             "smithy.api#httpQuery": "skipResourceInUseCheck"
           }
         }
       },
       "traits": {
-        "smithy.api#documentation": "Delete Action Group Request",
         "smithy.api#input": {}
       }
     },
@@ -2665,7 +2905,6 @@
       "type": "structure",
       "members": {},
       "traits": {
-        "smithy.api#documentation": "Delete Action Group Response",
         "smithy.api#output": {}
       }
     },
@@ -2695,7 +2934,7 @@
         }
       ],
       "traits": {
-        "smithy.api#documentation": "Deletes an Alias for a Amazon Bedrock Agent",
+        "smithy.api#documentation": "<p>Deletes an alias of an agent.</p>",
         "smithy.api#http": {
           "code": 202,
           "method": "DELETE",
@@ -2711,7 +2950,7 @@
         "agentId": {
           "target": "com.amazonaws.bedrockagent#Id",
           "traits": {
-            "smithy.api#documentation": "Id generated at the server side when an Agent is created",
+            "smithy.api#documentation": "<p>The unique identifier of the agent that the alias belongs to.</p>",
             "smithy.api#httpLabel": {},
             "smithy.api#required": {}
           }
@@ -2719,14 +2958,13 @@
         "agentAliasId": {
           "target": "com.amazonaws.bedrockagent#AgentAliasId",
           "traits": {
-            "smithy.api#documentation": "Id generated at the server side when an Agent Alias is created",
+            "smithy.api#documentation": "<p>The unique identifier of the alias to delete.</p>",
             "smithy.api#httpLabel": {},
             "smithy.api#required": {}
           }
         }
       },
       "traits": {
-        "smithy.api#documentation": "Delete Agent Alias Request",
         "smithy.api#input": {}
       }
     },
@@ -2736,24 +2974,26 @@
         "agentId": {
           "target": "com.amazonaws.bedrockagent#Id",
           "traits": {
+            "smithy.api#documentation": "<p>The unique identifier of the agent that the alias belongs to.</p>",
             "smithy.api#required": {}
           }
         },
         "agentAliasId": {
           "target": "com.amazonaws.bedrockagent#AgentAliasId",
           "traits": {
+            "smithy.api#documentation": "<p>The unique identifier of the alias that was deleted.</p>",
             "smithy.api#required": {}
           }
         },
         "agentAliasStatus": {
           "target": "com.amazonaws.bedrockagent#AgentAliasStatus",
           "traits": {
+            "smithy.api#documentation": "<p>The status of the alias.</p>",
             "smithy.api#required": {}
           }
         }
       },
       "traits": {
-        "smithy.api#documentation": "Delete Agent Alias Response",
         "smithy.api#output": {}
       }
     },
@@ -2763,7 +3003,7 @@
         "agentId": {
           "target": "com.amazonaws.bedrockagent#Id",
           "traits": {
-            "smithy.api#documentation": "Id generated at the server side when an Agent is created",
+            "smithy.api#documentation": "<p>The unique identifier of the agent to delete.</p>",
             "smithy.api#httpLabel": {},
             "smithy.api#required": {}
           }
@@ -2772,13 +3012,12 @@
           "target": "smithy.api#Boolean",
           "traits": {
             "smithy.api#default": false,
-            "smithy.api#documentation": "Skips checking if resource is in use when set to true. Defaults to false",
+            "smithy.api#documentation": "<p>By default, this value is <code>false</code> and deletion is stopped if the resource is in use. If you set it to <code>true</code>, the resource will be deleted even if the resource is in use.</p>",
             "smithy.api#httpQuery": "skipResourceInUseCheck"
           }
         }
       },
       "traits": {
-        "smithy.api#documentation": "Delete Agent Request",
         "smithy.api#input": {}
       }
     },
@@ -2788,18 +3027,19 @@
         "agentId": {
           "target": "com.amazonaws.bedrockagent#Id",
           "traits": {
+            "smithy.api#documentation": "<p>The unique identifier of the agent that was deleted.</p>",
             "smithy.api#required": {}
           }
         },
         "agentStatus": {
           "target": "com.amazonaws.bedrockagent#AgentStatus",
           "traits": {
+            "smithy.api#documentation": "<p>The status of the agent.</p>",
             "smithy.api#required": {}
           }
         }
       },
       "traits": {
-        "smithy.api#documentation": "Delete Agent Response",
         "smithy.api#output": {}
       }
     },
@@ -2832,7 +3072,7 @@
         }
       ],
       "traits": {
-        "smithy.api#documentation": "Deletes an Agent version for existing Amazon Bedrock Agent",
+        "smithy.api#documentation": "<p>Deletes a version of an agent.</p>",
         "smithy.api#http": {
           "code": 202,
           "method": "DELETE",
@@ -2848,7 +3088,7 @@
         "agentId": {
           "target": "com.amazonaws.bedrockagent#Id",
           "traits": {
-            "smithy.api#documentation": "Id generated at the server side when an Agent is created",
+            "smithy.api#documentation": "<p>The unique identifier of the agent that the version belongs to.</p>",
             "smithy.api#httpLabel": {},
             "smithy.api#required": {}
           }
@@ -2856,6 +3096,7 @@
         "agentVersion": {
           "target": "com.amazonaws.bedrockagent#NumericalVersion",
           "traits": {
+            "smithy.api#documentation": "<p>The version of the agent to delete.</p>",
             "smithy.api#httpLabel": {},
             "smithy.api#required": {}
           }
@@ -2864,13 +3105,12 @@
           "target": "smithy.api#Boolean",
           "traits": {
             "smithy.api#default": false,
-            "smithy.api#documentation": "Skips checking if resource is in use when set to true. Defaults to false",
+            "smithy.api#documentation": "<p>By default, this value is <code>false</code> and deletion is stopped if the resource is in use. If you set it to <code>true</code>, the resource will be deleted even if the resource is in use.</p>",
             "smithy.api#httpQuery": "skipResourceInUseCheck"
           }
         }
       },
       "traits": {
-        "smithy.api#documentation": "Delete Agent Version Request",
         "smithy.api#input": {}
       }
     },
@@ -2880,24 +3120,26 @@
         "agentId": {
           "target": "com.amazonaws.bedrockagent#Id",
           "traits": {
+            "smithy.api#documentation": "<p>The unique identifier of the agent that the version belongs to.</p>",
             "smithy.api#required": {}
           }
         },
         "agentVersion": {
           "target": "com.amazonaws.bedrockagent#NumericalVersion",
           "traits": {
+            "smithy.api#documentation": "<p>The version that was deleted.</p>",
             "smithy.api#required": {}
           }
         },
         "agentStatus": {
           "target": "com.amazonaws.bedrockagent#AgentStatus",
           "traits": {
+            "smithy.api#documentation": "<p>The status of the agent version.</p>",
             "smithy.api#required": {}
           }
         }
       },
       "traits": {
-        "smithy.api#documentation": "Delete Agent Version Response",
         "smithy.api#output": {}
       }
     },
@@ -2930,7 +3172,7 @@
         }
       ],
       "traits": {
-        "smithy.api#documentation": "Delete an existing data source",
+        "smithy.api#documentation": "<p>Deletes a data source from a knowledge base.</p>",
         "smithy.api#http": {
           "code": 202,
           "method": "DELETE",
@@ -2946,6 +3188,7 @@
         "knowledgeBaseId": {
           "target": "com.amazonaws.bedrockagent#Id",
           "traits": {
+            "smithy.api#documentation": "<p>The unique identifier of the knowledge base from which to delete the data source.</p>",
             "smithy.api#httpLabel": {},
             "smithy.api#required": {}
           }
@@ -2953,6 +3196,7 @@
         "dataSourceId": {
           "target": "com.amazonaws.bedrockagent#Id",
           "traits": {
+            "smithy.api#documentation": "<p>The unique identifier of the data source to delete.</p>",
             "smithy.api#httpLabel": {},
             "smithy.api#required": {}
           }
@@ -2968,18 +3212,21 @@
         "knowledgeBaseId": {
           "target": "com.amazonaws.bedrockagent#Id",
           "traits": {
+            "smithy.api#documentation": "<p>The unique identifier of the knowledge base to which the data source that was deleted belonged.</p>",
             "smithy.api#required": {}
           }
         },
         "dataSourceId": {
           "target": "com.amazonaws.bedrockagent#Id",
           "traits": {
+            "smithy.api#documentation": "<p>The unique identifier of the data source that was deleted.</p>",
             "smithy.api#required": {}
           }
         },
         "status": {
           "target": "com.amazonaws.bedrockagent#DataSourceStatus",
           "traits": {
+            "smithy.api#documentation": "<p>The status of the data source.</p>",
             "smithy.api#required": {}
           }
         }
@@ -3017,7 +3264,7 @@
         }
       ],
       "traits": {
-        "smithy.api#documentation": "Delete an existing knowledge base",
+        "smithy.api#documentation": "<p>Deletes a knowledge base. Before deleting a knowledge base, you should disassociate the knowledge base from any agents that it is associated with by making a <a href=\"https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_DisassociateAgentKnowledgeBase.html\">DisassociateAgentKnowledgeBase</a> request.</p>",
         "smithy.api#http": {
           "code": 202,
           "method": "DELETE",
@@ -3033,6 +3280,7 @@
         "knowledgeBaseId": {
           "target": "com.amazonaws.bedrockagent#Id",
           "traits": {
+            "smithy.api#documentation": "<p>The unique identifier of the knowledge base to delete.</p>",
             "smithy.api#httpLabel": {},
             "smithy.api#required": {}
           }
@@ -3048,12 +3296,14 @@
         "knowledgeBaseId": {
           "target": "com.amazonaws.bedrockagent#Id",
           "traits": {
+            "smithy.api#documentation": "<p>The unique identifier of the knowledge base that was deleted.</p>",
             "smithy.api#required": {}
           }
         },
         "status": {
           "target": "com.amazonaws.bedrockagent#KnowledgeBaseStatus",
           "traits": {
+            "smithy.api#documentation": "<p>The status of the knowledge base and whether it has been successfully deleted.</p>",
             "smithy.api#required": {}
           }
         }
@@ -3065,7 +3315,6 @@
     "com.amazonaws.bedrockagent#Description": {
       "type": "string",
       "traits": {
-        "smithy.api#documentation": "Description of the Resource.",
         "smithy.api#length": {
           "min": 1,
           "max": 200
@@ -3101,7 +3350,7 @@
         }
       ],
       "traits": {
-        "smithy.api#documentation": "Disassociate an existing Knowledge Base from an Amazon Bedrock Agent",
+        "smithy.api#documentation": "<p>Disassociates a knowledge base from an agent.</p>",
         "smithy.api#http": {
           "code": 204,
           "method": "DELETE",
@@ -3117,7 +3366,7 @@
         "agentId": {
           "target": "com.amazonaws.bedrockagent#Id",
           "traits": {
-            "smithy.api#documentation": "Id generated at the server side when an Agent is created",
+            "smithy.api#documentation": "<p>The unique identifier of the agent from which to disassociate the knowledge base.</p>",
             "smithy.api#httpLabel": {},
             "smithy.api#required": {}
           }
@@ -3125,7 +3374,7 @@
         "agentVersion": {
           "target": "com.amazonaws.bedrockagent#DraftVersion",
           "traits": {
-            "smithy.api#documentation": "Draft Version of the Agent.",
+            "smithy.api#documentation": "<p>The version of the agent from which to disassociate the knowledge base.</p>",
             "smithy.api#httpLabel": {},
             "smithy.api#required": {}
           }
@@ -3133,14 +3382,13 @@
         "knowledgeBaseId": {
           "target": "com.amazonaws.bedrockagent#Id",
           "traits": {
-            "smithy.api#documentation": "Id generated at the server side when a Knowledge Base is associated to an Agent",
+            "smithy.api#documentation": "<p>The unique identifier of the knowledge base to disassociate.</p>",
             "smithy.api#httpLabel": {},
             "smithy.api#required": {}
           }
         }
       },
       "traits": {
-        "smithy.api#documentation": "Disassociate Agent Knowledge Base Request",
         "smithy.api#input": {}
       }
     },
@@ -3148,14 +3396,12 @@
       "type": "structure",
       "members": {},
       "traits": {
-        "smithy.api#documentation": "Disassociate Agent Knowledge Base Response",
         "smithy.api#output": {}
       }
     },
     "com.amazonaws.bedrockagent#DraftVersion": {
       "type": "string",
       "traits": {
-        "smithy.api#documentation": "Draft Agent Version.",
         "smithy.api#length": {
           "min": 5,
           "max": 5
@@ -3166,7 +3412,6 @@
     "com.amazonaws.bedrockagent#FailureReason": {
       "type": "string",
       "traits": {
-        "smithy.api#documentation": "Failure Reason for Error.",
         "smithy.api#length": {
           "max": 2048
         }
@@ -3178,7 +3423,6 @@
         "target": "com.amazonaws.bedrockagent#FailureReason"
       },
       "traits": {
-        "smithy.api#documentation": "Failure Reasons for Error.",
         "smithy.api#length": {
           "max": 2048
         }
@@ -3187,7 +3431,6 @@
     "com.amazonaws.bedrockagent#FieldName": {
       "type": "string",
       "traits": {
-        "smithy.api#documentation": "Name of the field",
         "smithy.api#length": {
           "max": 2048
         },
@@ -3200,7 +3443,7 @@
         "maxTokens": {
           "target": "smithy.api#Integer",
           "traits": {
-            "smithy.api#documentation": "The maximum number of tokens per chunk.",
+            "smithy.api#documentation": "<p>The maximum number of tokens to include in a chunk.</p>",
             "smithy.api#range": {
               "min": 1
             },
@@ -3210,7 +3453,7 @@
         "overlapPercentage": {
           "target": "smithy.api#Integer",
           "traits": {
-            "smithy.api#documentation": "The overlap percentage between adjacent chunks.",
+            "smithy.api#documentation": "<p>The percentage of overlap between adjacent chunks of a data source.</p>",
             "smithy.api#range": {
               "min": 1,
               "max": 99
@@ -3220,7 +3463,7 @@
         }
       },
       "traits": {
-        "smithy.api#documentation": "Configures fixed size chunking strategy"
+        "smithy.api#documentation": "<p>Configurations for when you choose fixed-size chunking. If you set the <code>chunkingStrategy</code> as <code>NONE</code>, exclude this field.</p>"
       }
     },
     "com.amazonaws.bedrockagent#GetAgent": {
@@ -3249,7 +3492,7 @@
         }
       ],
       "traits": {
-        "smithy.api#documentation": "Gets an Agent for existing Amazon Bedrock Agent",
+        "smithy.api#documentation": "<p>Gets information about an agent.</p>",
         "smithy.api#http": {
           "code": 200,
           "method": "GET",
@@ -3285,7 +3528,7 @@
         }
       ],
       "traits": {
-        "smithy.api#documentation": "Gets an Action Group for existing Amazon Bedrock Agent Version",
+        "smithy.api#documentation": "<p>Gets information about an action group for an agent.</p>",
         "smithy.api#http": {
           "code": 200,
           "method": "GET",
@@ -3301,7 +3544,7 @@
         "agentId": {
           "target": "com.amazonaws.bedrockagent#Id",
           "traits": {
-            "smithy.api#documentation": "Id generated at the server side when an Agent is created",
+            "smithy.api#documentation": "<p>The unique identifier of the agent that the action group belongs to.</p>",
             "smithy.api#httpLabel": {},
             "smithy.api#required": {}
           }
@@ -3309,7 +3552,7 @@
         "agentVersion": {
           "target": "com.amazonaws.bedrockagent#Version",
           "traits": {
-            "smithy.api#documentation": "Version number generated when a version is created",
+            "smithy.api#documentation": "<p>The version of the agent that the action group belongs to.</p>",
             "smithy.api#httpLabel": {},
             "smithy.api#required": {}
           }
@@ -3317,14 +3560,13 @@
         "actionGroupId": {
           "target": "com.amazonaws.bedrockagent#Id",
           "traits": {
-            "smithy.api#documentation": "Id generated at the server side when an Agent Action Group is created",
+            "smithy.api#documentation": "<p>The unique identifier of the action group for which to get information.</p>",
             "smithy.api#httpLabel": {},
             "smithy.api#required": {}
           }
         }
       },
       "traits": {
-        "smithy.api#documentation": "Get Action Group Request",
         "smithy.api#input": {}
       }
     },
@@ -3334,12 +3576,12 @@
         "agentActionGroup": {
           "target": "com.amazonaws.bedrockagent#AgentActionGroup",
           "traits": {
+            "smithy.api#documentation": "<p>Contains details about the action group.</p>",
             "smithy.api#required": {}
           }
         }
       },
       "traits": {
-        "smithy.api#documentation": "Get Action Group Response",
         "smithy.api#output": {}
       }
     },
@@ -3369,7 +3611,7 @@
         }
       ],
       "traits": {
-        "smithy.api#documentation": "Describes an Alias for a Amazon Bedrock Agent",
+        "smithy.api#documentation": "<p>Gets information about an alias of an agent.</p>",
         "smithy.api#http": {
           "code": 200,
           "method": "GET",
@@ -3385,7 +3627,7 @@
         "agentId": {
           "target": "com.amazonaws.bedrockagent#Id",
           "traits": {
-            "smithy.api#documentation": "Id generated at the server side when an Agent is created",
+            "smithy.api#documentation": "<p>The unique identifier of the agent to which the alias to get information belongs.</p>",
             "smithy.api#httpLabel": {},
             "smithy.api#required": {}
           }
@@ -3393,14 +3635,13 @@
         "agentAliasId": {
           "target": "com.amazonaws.bedrockagent#AgentAliasId",
           "traits": {
-            "smithy.api#documentation": "Id generated at the server side when an Agent Alias is created",
+            "smithy.api#documentation": "<p>The unique identifier of the alias for which to get information.</p>",
             "smithy.api#httpLabel": {},
             "smithy.api#required": {}
           }
         }
       },
       "traits": {
-        "smithy.api#documentation": "Get Agent Alias Request",
         "smithy.api#input": {}
       }
     },
@@ -3410,12 +3651,12 @@
         "agentAlias": {
           "target": "com.amazonaws.bedrockagent#AgentAlias",
           "traits": {
+            "smithy.api#documentation": "<p>Contains information about the alias.</p>",
             "smithy.api#required": {}
           }
         }
       },
       "traits": {
-        "smithy.api#documentation": "Get Agent Alias Response",
         "smithy.api#output": {}
       }
     },
@@ -3445,7 +3686,7 @@
         }
       ],
       "traits": {
-        "smithy.api#documentation": "Gets a knowledge base associated to an existing Amazon Bedrock Agent Version",
+        "smithy.api#documentation": "<p>Gets information about a knowledge base associated with an agent.</p>",
         "smithy.api#http": {
           "code": 200,
           "method": "GET",
@@ -3461,7 +3702,7 @@
         "agentId": {
           "target": "com.amazonaws.bedrockagent#Id",
           "traits": {
-            "smithy.api#documentation": "Id generated at the server side when an Agent is created",
+            "smithy.api#documentation": "<p>The unique identifier of the agent with which the knowledge base is associated.</p>",
             "smithy.api#httpLabel": {},
             "smithy.api#required": {}
           }
@@ -3469,7 +3710,7 @@
         "agentVersion": {
           "target": "com.amazonaws.bedrockagent#Version",
           "traits": {
-            "smithy.api#documentation": "Version number generated when a version is created",
+            "smithy.api#documentation": "<p>The version of the agent with which the knowledge base is associated.</p>",
             "smithy.api#httpLabel": {},
             "smithy.api#required": {}
           }
@@ -3477,14 +3718,13 @@
         "knowledgeBaseId": {
           "target": "com.amazonaws.bedrockagent#Id",
           "traits": {
-            "smithy.api#documentation": "Id generated at the server side when a Knowledge Base is associated",
+            "smithy.api#documentation": "<p>The unique identifier of the knowledge base associated with the agent.</p>",
             "smithy.api#httpLabel": {},
             "smithy.api#required": {}
           }
         }
       },
       "traits": {
-        "smithy.api#documentation": "Get Agent Knowledge Base Request",
         "smithy.api#input": {}
       }
     },
@@ -3494,12 +3734,12 @@
         "agentKnowledgeBase": {
           "target": "com.amazonaws.bedrockagent#AgentKnowledgeBase",
           "traits": {
+            "smithy.api#documentation": "<p>Contains details about a knowledge base attached to an agent.</p>",
             "smithy.api#required": {}
           }
         }
       },
       "traits": {
-        "smithy.api#documentation": "Get Agent Knowledge Base Response",
         "smithy.api#output": {}
       }
     },
@@ -3509,14 +3749,13 @@
         "agentId": {
           "target": "com.amazonaws.bedrockagent#Id",
           "traits": {
-            "smithy.api#documentation": "Id generated at the server side when an Agent is created",
+            "smithy.api#documentation": "<p>The unique identifier of the agent.</p>",
             "smithy.api#httpLabel": {},
             "smithy.api#required": {}
           }
         }
       },
       "traits": {
-        "smithy.api#documentation": "Get Agent Request",
         "smithy.api#input": {}
       }
     },
@@ -3526,12 +3765,12 @@
         "agent": {
           "target": "com.amazonaws.bedrockagent#Agent",
           "traits": {
+            "smithy.api#documentation": "<p>Contains details about the agent.</p>",
             "smithy.api#required": {}
           }
         }
       },
       "traits": {
-        "smithy.api#documentation": "Get Agent Response",
         "smithy.api#output": {}
       }
     },
@@ -3561,7 +3800,7 @@
         }
       ],
       "traits": {
-        "smithy.api#documentation": "Gets an Agent version for existing Amazon Bedrock Agent",
+        "smithy.api#documentation": "<p>Gets details about a version of an agent.</p>",
         "smithy.api#http": {
           "code": 200,
           "method": "GET",
@@ -3577,7 +3816,7 @@
         "agentId": {
           "target": "com.amazonaws.bedrockagent#Id",
           "traits": {
-            "smithy.api#documentation": "Id generated at the server side when an Agent is created",
+            "smithy.api#documentation": "<p>The unique identifier of the agent.</p>",
             "smithy.api#httpLabel": {},
             "smithy.api#required": {}
           }
@@ -3585,13 +3824,13 @@
         "agentVersion": {
           "target": "com.amazonaws.bedrockagent#NumericalVersion",
           "traits": {
+            "smithy.api#documentation": "<p>The version of the agent.</p>",
             "smithy.api#httpLabel": {},
             "smithy.api#required": {}
           }
         }
       },
       "traits": {
-        "smithy.api#documentation": "Get Agent Version Request",
         "smithy.api#input": {}
       }
     },
@@ -3601,12 +3840,12 @@
         "agentVersion": {
           "target": "com.amazonaws.bedrockagent#AgentVersion",
           "traits": {
+            "smithy.api#documentation": "<p>Contains details about the version of the agent.</p>",
             "smithy.api#required": {}
           }
         }
       },
       "traits": {
-        "smithy.api#documentation": "Get Agent Version Response",
         "smithy.api#output": {}
       }
     },
@@ -3636,7 +3875,7 @@
         }
       ],
       "traits": {
-        "smithy.api#documentation": "Get an existing data source",
+        "smithy.api#documentation": "<p>Gets information about a data source.</p>",
         "smithy.api#http": {
           "code": 200,
           "method": "GET",
@@ -3652,6 +3891,7 @@
         "knowledgeBaseId": {
           "target": "com.amazonaws.bedrockagent#Id",
           "traits": {
+            "smithy.api#documentation": "<p>The unique identifier of the knowledge base that the data source was added to.</p>",
             "smithy.api#httpLabel": {},
             "smithy.api#required": {}
           }
@@ -3659,6 +3899,7 @@
         "dataSourceId": {
           "target": "com.amazonaws.bedrockagent#Id",
           "traits": {
+            "smithy.api#documentation": "<p>The unique identifier of the data source.</p>",
             "smithy.api#httpLabel": {},
             "smithy.api#required": {}
           }
@@ -3674,6 +3915,7 @@
         "dataSource": {
           "target": "com.amazonaws.bedrockagent#DataSource",
           "traits": {
+            "smithy.api#documentation": "<p>Contains details about the data source.</p>",
             "smithy.api#required": {}
           }
         }
@@ -3708,7 +3950,7 @@
         }
       ],
       "traits": {
-        "smithy.api#documentation": "Get an ingestion job",
+        "smithy.api#documentation": "<p>Gets information about a ingestion job, in which a data source is added to a knowledge base.</p>",
         "smithy.api#http": {
           "code": 200,
           "method": "GET",
@@ -3724,6 +3966,7 @@
         "knowledgeBaseId": {
           "target": "com.amazonaws.bedrockagent#Id",
           "traits": {
+            "smithy.api#documentation": "<p>The unique identifier of the knowledge base for which the ingestion job applies.</p>",
             "smithy.api#httpLabel": {},
             "smithy.api#required": {}
           }
@@ -3731,6 +3974,7 @@
         "dataSourceId": {
           "target": "com.amazonaws.bedrockagent#Id",
           "traits": {
+            "smithy.api#documentation": "<p>The unique identifier of the data source in the ingestion job.</p>",
             "smithy.api#httpLabel": {},
             "smithy.api#required": {}
           }
@@ -3738,6 +3982,7 @@
         "ingestionJobId": {
           "target": "com.amazonaws.bedrockagent#Id",
           "traits": {
+            "smithy.api#documentation": "<p>The unique identifier of the ingestion job.</p>",
             "smithy.api#httpLabel": {},
             "smithy.api#required": {}
           }
@@ -3753,6 +3998,7 @@
         "ingestionJob": {
           "target": "com.amazonaws.bedrockagent#IngestionJob",
           "traits": {
+            "smithy.api#documentation": "<p>Contains details about the ingestion job.</p>",
             "smithy.api#required": {}
           }
         }
@@ -3787,7 +4033,7 @@
         }
       ],
       "traits": {
-        "smithy.api#documentation": "Get an existing knowledge base",
+        "smithy.api#documentation": "<p>Gets information about a knoweldge base.</p>",
         "smithy.api#http": {
           "code": 200,
           "method": "GET",
@@ -3803,6 +4049,7 @@
         "knowledgeBaseId": {
           "target": "com.amazonaws.bedrockagent#Id",
           "traits": {
+            "smithy.api#documentation": "<p>The unique identifier of the knowledge base for which to get information.</p>",
             "smithy.api#httpLabel": {},
             "smithy.api#required": {}
           }
@@ -3818,6 +4065,7 @@
         "knowledgeBase": {
           "target": "com.amazonaws.bedrockagent#KnowledgeBase",
           "traits": {
+            "smithy.api#documentation": "<p>Contains details about the knowledge base.</p>",
             "smithy.api#required": {}
           }
         }
@@ -3829,7 +4077,6 @@
     "com.amazonaws.bedrockagent#Id": {
       "type": "string",
       "traits": {
-        "smithy.api#documentation": "Identifier for a resource.",
         "smithy.api#pattern": "^[0-9a-zA-Z]{10}$"
       }
     },
@@ -3837,23 +4084,38 @@
       "type": "structure",
       "members": {
         "temperature": {
-          "target": "com.amazonaws.bedrockagent#Temperature"
+          "target": "com.amazonaws.bedrockagent#Temperature",
+          "traits": {
+            "smithy.api#documentation": "<p>The likelihood of the model selecting higher-probability options while generating a response. A lower value makes the model more likely to choose higher-probability options, while a higher value makes the model more likely to choose lower-probability options.</p>"
+          }
         },
         "topP": {
-          "target": "com.amazonaws.bedrockagent#TopP"
+          "target": "com.amazonaws.bedrockagent#TopP",
+          "traits": {
+            "smithy.api#documentation": "<p>While generating a response, the model determines the probability of the following token at each point of generation. The value that you set for <code>Top P</code> determines the number of most-likely candidates from which the model chooses the next token in the sequence. For example, if you set <code>topP</code> to 80, the model only selects the next token from the top 80% of the probability distribution of next tokens.</p>"
+          }
         },
         "topK": {
-          "target": "com.amazonaws.bedrockagent#TopK"
+          "target": "com.amazonaws.bedrockagent#TopK",
+          "traits": {
+            "smithy.api#documentation": "<p>While generating a response, the model determines the probability of the following token at each point of generation. The value that you set for <code>topK</code> is the number of most-likely candidates from which the model chooses the next token in the sequence. For example, if you set <code>topK</code> to 50, the model selects the next token from among the top 50 most likely choices.</p>"
+          }
         },
         "maximumLength": {
-          "target": "com.amazonaws.bedrockagent#MaximumLength"
+          "target": "com.amazonaws.bedrockagent#MaximumLength",
+          "traits": {
+            "smithy.api#documentation": "<p>The maximum number of tokens to allow in the generated response.</p>"
+          }
         },
         "stopSequences": {
-          "target": "com.amazonaws.bedrockagent#StopSequences"
+          "target": "com.amazonaws.bedrockagent#StopSequences",
+          "traits": {
+            "smithy.api#documentation": "<p>A list of stop sequences. A stop sequence is a sequence of characters that causes the model to stop generating the response.</p>"
+          }
         }
       },
       "traits": {
-        "smithy.api#documentation": "Configuration for inference in prompt configuration"
+        "smithy.api#documentation": "<p>Contains inference parameters to use when the agent invokes a foundation model in the part of the agent sequence defined by the <code>promptType</code>. For more information, see <a href=\"https://docs.aws.amazon.com/bedrock/latest/userguide/model-parameters.html\">Inference parameters for foundation models</a>.</p>"
       }
     },
     "com.amazonaws.bedrockagent#IngestionJob": {
@@ -3862,51 +4124,66 @@
         "knowledgeBaseId": {
           "target": "com.amazonaws.bedrockagent#Id",
           "traits": {
+            "smithy.api#documentation": "<p>The unique identifier of the knowledge base to which the data source is being added.</p>",
             "smithy.api#required": {}
           }
         },
         "dataSourceId": {
           "target": "com.amazonaws.bedrockagent#Id",
           "traits": {
+            "smithy.api#documentation": "<p>The unique identifier of the ingested data source.</p>",
             "smithy.api#required": {}
           }
         },
         "ingestionJobId": {
           "target": "com.amazonaws.bedrockagent#Id",
           "traits": {
+            "smithy.api#documentation": "<p>The unique identifier of the ingestion job.</p>",
             "smithy.api#required": {}
           }
         },
         "description": {
-          "target": "com.amazonaws.bedrockagent#Description"
+          "target": "com.amazonaws.bedrockagent#Description",
+          "traits": {
+            "smithy.api#documentation": "<p>The description of the ingestion job.</p>"
+          }
         },
         "status": {
           "target": "com.amazonaws.bedrockagent#IngestionJobStatus",
           "traits": {
+            "smithy.api#documentation": "<p>The status of the ingestion job.</p>",
             "smithy.api#required": {}
           }
         },
         "statistics": {
-          "target": "com.amazonaws.bedrockagent#IngestionJobStatistics"
+          "target": "com.amazonaws.bedrockagent#IngestionJobStatistics",
+          "traits": {
+            "smithy.api#documentation": "<p>Contains statistics about the ingestion job.</p>"
+          }
         },
         "failureReasons": {
-          "target": "com.amazonaws.bedrockagent#FailureReasons"
+          "target": "com.amazonaws.bedrockagent#FailureReasons",
+          "traits": {
+            "smithy.api#documentation": "<p>A list of reasons that the ingestion job failed.</p>"
+          }
         },
         "startedAt": {
           "target": "com.amazonaws.bedrockagent#DateTimestamp",
           "traits": {
+            "smithy.api#documentation": "<p>The time at which the ingestion job started.</p>",
             "smithy.api#required": {}
           }
         },
         "updatedAt": {
           "target": "com.amazonaws.bedrockagent#DateTimestamp",
           "traits": {
+            "smithy.api#documentation": "<p>The time at which the ingestion job was last updated.</p>",
             "smithy.api#required": {}
           }
         }
       },
       "traits": {
-        "smithy.api#documentation": "Contains the information of an ingestion job."
+        "smithy.api#documentation": "<p>Contains details about an ingestion job, which converts a data source to embeddings for a vector store in knowledge base.</p>\n         <p>This data type is used in the following API operations:</p>\n         <ul>\n            <li>\n               <p>\n                  <a href=\"https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_StartIngestionJob.html#API_agent_StartIngestionJob_ResponseSyntax\">StartIngestionJob response</a>\n               </p>\n            </li>\n            <li>\n               <p>\n                  <a href=\"https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_GetIngestionJob.html#API_agent_GetIngestionJob_ResponseSyntax\">GetIngestionJob response</a>\n               </p>\n            </li>\n            <li>\n               <p>\n                  <a href=\"https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_ListIngestionJob.html#API_agent_ListIngestionJob_ResponseSyntax\">ListIngestionJob response</a>\n               </p>\n            </li>\n         </ul>"
       }
     },
     "com.amazonaws.bedrockagent#IngestionJobFilter": {
@@ -3915,24 +4192,27 @@
         "attribute": {
           "target": "com.amazonaws.bedrockagent#IngestionJobFilterAttribute",
           "traits": {
+            "smithy.api#documentation": "<p>The attribute by which to filter the results.</p>",
             "smithy.api#required": {}
           }
         },
         "operator": {
           "target": "com.amazonaws.bedrockagent#IngestionJobFilterOperator",
           "traits": {
+            "smithy.api#documentation": "<p>The operation to carry out between the attribute and the values.</p>",
             "smithy.api#required": {}
           }
         },
         "values": {
           "target": "com.amazonaws.bedrockagent#IngestionJobFilterValues",
           "traits": {
+            "smithy.api#documentation": "<p>A list of values for the attribute.</p>",
             "smithy.api#required": {}
           }
         }
       },
       "traits": {
-        "smithy.api#documentation": "Filters the response returned by ListIngestionJobs operation."
+        "smithy.api#documentation": "<p>Defines a filter by which to filter the results.</p>"
       }
     },
     "com.amazonaws.bedrockagent#IngestionJobFilterAttribute": {
@@ -3944,9 +4224,6 @@
             "smithy.api#enumValue": "STATUS"
           }
         }
-      },
-      "traits": {
-        "smithy.api#documentation": "The name of the field to filter ingestion jobs."
       }
     },
     "com.amazonaws.bedrockagent#IngestionJobFilterOperator": {
@@ -3958,15 +4235,11 @@
             "smithy.api#enumValue": "EQ"
           }
         }
-      },
-      "traits": {
-        "smithy.api#documentation": "The operator used to filter ingestion jobs."
       }
     },
     "com.amazonaws.bedrockagent#IngestionJobFilterValue": {
       "type": "string",
       "traits": {
-        "smithy.api#documentation": "The value used to filter ingestion jobs.",
         "smithy.api#length": {
           "min": 0,
           "max": 100
@@ -3980,7 +4253,6 @@
         "target": "com.amazonaws.bedrockagent#IngestionJobFilterValue"
       },
       "traits": {
-        "smithy.api#documentation": "The list of values used to filter ingestion jobs.",
         "smithy.api#length": {
           "min": 0,
           "max": 10
@@ -3993,7 +4265,6 @@
         "target": "com.amazonaws.bedrockagent#IngestionJobFilter"
       },
       "traits": {
-        "smithy.api#documentation": "List of IngestionJobFilters",
         "smithy.api#length": {
           "min": 1,
           "max": 1
@@ -4020,18 +4291,20 @@
         "attribute": {
           "target": "com.amazonaws.bedrockagent#IngestionJobSortByAttribute",
           "traits": {
+            "smithy.api#documentation": "<p>The attribute by which to sort the results.</p>",
             "smithy.api#required": {}
           }
         },
         "order": {
           "target": "com.amazonaws.bedrockagent#SortOrder",
           "traits": {
+            "smithy.api#documentation": "<p>The order by which to sort the results.</p>",
             "smithy.api#required": {}
           }
         }
       },
       "traits": {
-        "smithy.api#documentation": "Sorts the response returned by ListIngestionJobs operation."
+        "smithy.api#documentation": "<p>Parameters by which to sort the results.</p>"
       }
     },
     "com.amazonaws.bedrockagent#IngestionJobSortByAttribute": {
@@ -4049,9 +4322,6 @@
             "smithy.api#enumValue": "STARTED_AT"
           }
         }
-      },
-      "traits": {
-        "smithy.api#documentation": "The name of the field to sort ingestion jobs."
       }
     },
     "com.amazonaws.bedrockagent#IngestionJobStatistics": {
@@ -4061,40 +4331,54 @@
           "target": "smithy.api#PrimitiveLong",
           "traits": {
             "smithy.api#default": 0,
-            "smithy.api#documentation": "Number of scanned documents"
+            "smithy.api#documentation": "<p>The total number of source documents that were scanned. Includes new, updated, and unchanged documents.</p>"
+          }
+        },
+        "numberOfMetadataDocumentsScanned": {
+          "target": "smithy.api#PrimitiveLong",
+          "traits": {
+            "smithy.api#default": 0,
+            "smithy.api#documentation": "<p>The total number of metadata files that were scanned. Includes new, updated, and unchanged files.</p>"
           }
         },
         "numberOfNewDocumentsIndexed": {
           "target": "smithy.api#PrimitiveLong",
           "traits": {
             "smithy.api#default": 0,
-            "smithy.api#documentation": "Number of indexed documents"
+            "smithy.api#documentation": "<p>The number of new source documents in the data source that were successfully indexed.</p>"
           }
         },
         "numberOfModifiedDocumentsIndexed": {
           "target": "smithy.api#PrimitiveLong",
           "traits": {
             "smithy.api#default": 0,
-            "smithy.api#documentation": "Number of modified documents indexed"
+            "smithy.api#documentation": "<p>The number of modified source documents in the data source that were successfully indexed.</p>"
+          }
+        },
+        "numberOfMetadataDocumentsModified": {
+          "target": "smithy.api#PrimitiveLong",
+          "traits": {
+            "smithy.api#default": 0,
+            "smithy.api#documentation": "<p>The number of metadata files that were updated or deleted.</p>"
           }
         },
         "numberOfDocumentsDeleted": {
           "target": "smithy.api#PrimitiveLong",
           "traits": {
             "smithy.api#default": 0,
-            "smithy.api#documentation": "Number of deleted documents"
+            "smithy.api#documentation": "<p>The number of source documents that was deleted.</p>"
           }
         },
         "numberOfDocumentsFailed": {
           "target": "smithy.api#PrimitiveLong",
           "traits": {
             "smithy.api#default": 0,
-            "smithy.api#documentation": "Number of failed documents"
+            "smithy.api#documentation": "<p>The number of source documents that failed to be ingested.</p>"
           }
         }
       },
       "traits": {
-        "smithy.api#documentation": "The document level statistics of an ingestion job"
+        "smithy.api#documentation": "<p>Contains the statistics for the ingestion job.</p>"
       }
     },
     "com.amazonaws.bedrockagent#IngestionJobStatus": {
@@ -4124,18 +4408,12 @@
             "smithy.api#enumValue": "FAILED"
           }
         }
-      },
-      "traits": {
-        "smithy.api#documentation": "The status of an ingestion job."
       }
     },
     "com.amazonaws.bedrockagent#IngestionJobSummaries": {
       "type": "list",
       "member": {
         "target": "com.amazonaws.bedrockagent#IngestionJobSummary"
-      },
-      "traits": {
-        "smithy.api#documentation": "List of IngestionJobSummaries"
       }
     },
     "com.amazonaws.bedrockagent#IngestionJobSummary": {
@@ -4144,54 +4422,65 @@
         "knowledgeBaseId": {
           "target": "com.amazonaws.bedrockagent#Id",
           "traits": {
+            "smithy.api#documentation": "<p>The unique identifier of the knowledge base to which the data source is added.</p>",
             "smithy.api#required": {}
           }
         },
         "dataSourceId": {
           "target": "com.amazonaws.bedrockagent#Id",
           "traits": {
+            "smithy.api#documentation": "<p>The unique identifier of the data source in the ingestion job.</p>",
             "smithy.api#required": {}
           }
         },
         "ingestionJobId": {
           "target": "com.amazonaws.bedrockagent#Id",
           "traits": {
+            "smithy.api#documentation": "<p>The unique identifier of the ingestion job.</p>",
             "smithy.api#required": {}
           }
         },
         "description": {
-          "target": "com.amazonaws.bedrockagent#Description"
+          "target": "com.amazonaws.bedrockagent#Description",
+          "traits": {
+            "smithy.api#documentation": "<p>The description of the ingestion job.</p>"
+          }
         },
         "status": {
           "target": "com.amazonaws.bedrockagent#IngestionJobStatus",
           "traits": {
+            "smithy.api#documentation": "<p>The status of the ingestion job.</p>",
             "smithy.api#required": {}
           }
         },
         "startedAt": {
           "target": "com.amazonaws.bedrockagent#DateTimestamp",
           "traits": {
+            "smithy.api#documentation": "<p>The time at which the ingestion job was started.</p>",
             "smithy.api#required": {}
           }
         },
         "updatedAt": {
           "target": "com.amazonaws.bedrockagent#DateTimestamp",
           "traits": {
+            "smithy.api#documentation": "<p>The time at which the ingestion job was last updated.</p>",
             "smithy.api#required": {}
           }
         },
         "statistics": {
-          "target": "com.amazonaws.bedrockagent#IngestionJobStatistics"
+          "target": "com.amazonaws.bedrockagent#IngestionJobStatistics",
+          "traits": {
+            "smithy.api#documentation": "<p>Contains statistics for the ingestion job.</p>"
+          }
         }
       },
       "traits": {
-        "smithy.api#documentation": "Summary information of an ingestion job."
+        "smithy.api#documentation": "<p>Contains details about an ingestion job.</p>"
       }
     },
     "com.amazonaws.bedrockagent#Instruction": {
       "type": "string",
       "traits": {
-        "smithy.api#documentation": "Instruction for the agent.",
         "smithy.api#length": {
           "min": 40,
           "max": 1200
@@ -4207,7 +4496,7 @@
         }
       },
       "traits": {
-        "smithy.api#documentation": "This exception is thrown if there was an unexpected error during processing of request",
+        "smithy.api#documentation": "<p>An internal server error occurred. Retry your request.</p>",
         "smithy.api#error": "server",
         "smithy.api#httpError": 500
       }
@@ -4215,7 +4504,6 @@
     "com.amazonaws.bedrockagent#KmsKeyArn": {
       "type": "string",
       "traits": {
-        "smithy.api#documentation": "A KMS key ARN",
         "smithy.api#length": {
           "min": 1,
           "max": 2048
@@ -4229,72 +4517,86 @@
         "knowledgeBaseId": {
           "target": "com.amazonaws.bedrockagent#Id",
           "traits": {
+            "smithy.api#documentation": "<p>The unique identifier of the knowledge base.</p>",
             "smithy.api#required": {}
           }
         },
         "name": {
           "target": "com.amazonaws.bedrockagent#Name",
           "traits": {
+            "smithy.api#documentation": "<p>The name of the knowledge base.</p>",
             "smithy.api#required": {}
           }
         },
         "knowledgeBaseArn": {
           "target": "com.amazonaws.bedrockagent#KnowledgeBaseArn",
           "traits": {
+            "smithy.api#documentation": "<p>The ARN of the knowledge base.</p>",
             "smithy.api#required": {}
           }
         },
         "description": {
-          "target": "com.amazonaws.bedrockagent#Description"
+          "target": "com.amazonaws.bedrockagent#Description",
+          "traits": {
+            "smithy.api#documentation": "<p>The description of the knowledge base.</p>"
+          }
         },
         "roleArn": {
           "target": "com.amazonaws.bedrockagent#KnowledgeBaseRoleArn",
           "traits": {
+            "smithy.api#documentation": "<p>The ARN of the IAM role with permissions to invoke API operations on the knowledge base. The ARN must begin with <code>AmazonBedrockExecutionRoleForKnowledgeBase_</code>.</p>",
             "smithy.api#required": {}
           }
         },
         "knowledgeBaseConfiguration": {
           "target": "com.amazonaws.bedrockagent#KnowledgeBaseConfiguration",
           "traits": {
+            "smithy.api#documentation": "<p>Contains details about the embeddings configuration of the knowledge base.</p>",
             "smithy.api#required": {}
           }
         },
         "storageConfiguration": {
           "target": "com.amazonaws.bedrockagent#StorageConfiguration",
           "traits": {
+            "smithy.api#documentation": "<p>Contains details about the storage configuration of the knowledge base.</p>",
             "smithy.api#required": {}
           }
         },
         "status": {
           "target": "com.amazonaws.bedrockagent#KnowledgeBaseStatus",
           "traits": {
+            "smithy.api#documentation": "<p>The status of the knowledge base. The following statuses are possible:</p>\n         <ul>\n            <li>\n               <p>CREATING – The knowledge base is being created.</p>\n            </li>\n            <li>\n               <p>ACTIVE – The knowledge base is ready to be queried.</p>\n            </li>\n            <li>\n               <p>DELETING – The knowledge base is being deleted.</p>\n            </li>\n            <li>\n               <p>UPDATING – The knowledge base is being updated.</p>\n            </li>\n            <li>\n               <p>FAILED – The knowledge base API operation failed.</p>\n            </li>\n         </ul>",
             "smithy.api#required": {}
           }
         },
         "createdAt": {
           "target": "com.amazonaws.bedrockagent#DateTimestamp",
           "traits": {
+            "smithy.api#documentation": "<p>The time at which the knowledge base was created.</p>",
             "smithy.api#required": {}
           }
         },
         "updatedAt": {
           "target": "com.amazonaws.bedrockagent#DateTimestamp",
           "traits": {
+            "smithy.api#documentation": "<p>The time at which the knowledge base was last updated.</p>",
             "smithy.api#required": {}
           }
         },
         "failureReasons": {
-          "target": "com.amazonaws.bedrockagent#FailureReasons"
+          "target": "com.amazonaws.bedrockagent#FailureReasons",
+          "traits": {
+            "smithy.api#documentation": "<p>A list of reasons that the API operation on the knowledge base failed.</p>"
+          }
         }
       },
       "traits": {
-        "smithy.api#documentation": "Contains the information of a knowledge base."
+        "smithy.api#documentation": "<p>Contains information about a knowledge base.</p>"
       }
     },
     "com.amazonaws.bedrockagent#KnowledgeBaseArn": {
       "type": "string",
       "traits": {
-        "smithy.api#documentation": "ARN of a KnowledgeBase",
         "smithy.api#length": {
           "max": 128
         },
@@ -4307,15 +4609,19 @@
         "type": {
           "target": "com.amazonaws.bedrockagent#KnowledgeBaseType",
           "traits": {
+            "smithy.api#documentation": "<p>The type of data that the data source is converted into for the knowledge base.</p>",
             "smithy.api#required": {}
           }
         },
         "vectorKnowledgeBaseConfiguration": {
-          "target": "com.amazonaws.bedrockagent#VectorKnowledgeBaseConfiguration"
+          "target": "com.amazonaws.bedrockagent#VectorKnowledgeBaseConfiguration",
+          "traits": {
+            "smithy.api#documentation": "<p>Contains details about the embeddings model that'sused to convert the data source.</p>"
+          }
         }
       },
       "traits": {
-        "smithy.api#documentation": "Configures a bedrock knowledge base."
+        "smithy.api#documentation": "<p>Contains details about the embeddings configuration of the knowledge base.</p>"
       }
     },
     "com.amazonaws.bedrockagent#KnowledgeBaseResource": {
@@ -4356,11 +4662,10 @@
     "com.amazonaws.bedrockagent#KnowledgeBaseRoleArn": {
       "type": "string",
       "traits": {
-        "smithy.api#documentation": "ARN of a IAM role.",
         "smithy.api#length": {
           "max": 2048
         },
-        "smithy.api#pattern": "^arn:aws(-[^:]+)?:iam::([0-9]{12})?:role/(service-role/)?AmazonBedrockExecutionRoleForKnowledgeBase.+$"
+        "smithy.api#pattern": "^arn:aws(-[^:]+)?:iam::([0-9]{12})?:role/.+$"
       }
     },
     "com.amazonaws.bedrockagent#KnowledgeBaseState": {
@@ -4378,9 +4683,6 @@
             "smithy.api#enumValue": "DISABLED"
           }
         }
-      },
-      "traits": {
-        "smithy.api#documentation": "State of the knowledge base; whether it is enabled or disabled"
       }
     },
     "com.amazonaws.bedrockagent#KnowledgeBaseStatus": {
@@ -4416,9 +4718,6 @@
             "smithy.api#enumValue": "FAILED"
           }
         }
-      },
-      "traits": {
-        "smithy.api#documentation": "The status of a knowledge base."
       }
     },
     "com.amazonaws.bedrockagent#KnowledgeBaseStorageType": {
@@ -4448,18 +4747,12 @@
             "smithy.api#enumValue": "RDS"
           }
         }
-      },
-      "traits": {
-        "smithy.api#documentation": "The storage type of a knowledge base."
       }
     },
     "com.amazonaws.bedrockagent#KnowledgeBaseSummaries": {
       "type": "list",
       "member": {
         "target": "com.amazonaws.bedrockagent#KnowledgeBaseSummary"
-      },
-      "traits": {
-        "smithy.api#documentation": "List of KnowledgeBaseSummaries"
       }
     },
     "com.amazonaws.bedrockagent#KnowledgeBaseSummary": {
@@ -4468,33 +4761,40 @@
         "knowledgeBaseId": {
           "target": "com.amazonaws.bedrockagent#Id",
           "traits": {
+            "smithy.api#documentation": "<p>The unique identifier of the knowledge base.</p>",
             "smithy.api#required": {}
           }
         },
         "name": {
           "target": "com.amazonaws.bedrockagent#Name",
           "traits": {
+            "smithy.api#documentation": "<p>The name of the knowledge base.</p>",
             "smithy.api#required": {}
           }
         },
         "description": {
-          "target": "com.amazonaws.bedrockagent#Description"
+          "target": "com.amazonaws.bedrockagent#Description",
+          "traits": {
+            "smithy.api#documentation": "<p>The description of the knowledge base.</p>"
+          }
         },
         "status": {
           "target": "com.amazonaws.bedrockagent#KnowledgeBaseStatus",
           "traits": {
+            "smithy.api#documentation": "<p>The status of the knowledge base.</p>",
             "smithy.api#required": {}
           }
         },
         "updatedAt": {
           "target": "com.amazonaws.bedrockagent#DateTimestamp",
           "traits": {
+            "smithy.api#documentation": "<p>The time at which the knowledge base was last updated.</p>",
             "smithy.api#required": {}
           }
         }
       },
       "traits": {
-        "smithy.api#documentation": "Summary information of a knowledge base."
+        "smithy.api#documentation": "<p>Contains details about a knowledge base.</p>"
       }
     },
     "com.amazonaws.bedrockagent#KnowledgeBaseType": {
@@ -4506,15 +4806,11 @@
             "smithy.api#enumValue": "VECTOR"
           }
         }
-      },
-      "traits": {
-        "smithy.api#documentation": "The type of a knowledge base."
       }
     },
     "com.amazonaws.bedrockagent#LambdaArn": {
       "type": "string",
       "traits": {
-        "smithy.api#documentation": "ARN of a Lambda.",
         "smithy.api#length": {
           "max": 2048
         },
@@ -4547,7 +4843,7 @@
         }
       ],
       "traits": {
-        "smithy.api#documentation": "Lists an Action Group for existing Amazon Bedrock Agent Version",
+        "smithy.api#documentation": "<p>Lists the action groups for an agent and information about each one.</p>",
         "smithy.api#http": {
           "code": 200,
           "method": "POST",
@@ -4569,7 +4865,7 @@
         "agentId": {
           "target": "com.amazonaws.bedrockagent#Id",
           "traits": {
-            "smithy.api#documentation": "Id generated at the server side when an Agent is Listed",
+            "smithy.api#documentation": "<p>The unique identifier of the agent.</p>",
             "smithy.api#httpLabel": {},
             "smithy.api#required": {}
           }
@@ -4577,20 +4873,25 @@
         "agentVersion": {
           "target": "com.amazonaws.bedrockagent#Version",
           "traits": {
-            "smithy.api#documentation": "Id generated at the server side when an Agent is Listed",
+            "smithy.api#documentation": "<p>The version of the agent.</p>",
             "smithy.api#httpLabel": {},
             "smithy.api#required": {}
           }
         },
         "maxResults": {
-          "target": "com.amazonaws.bedrockagent#MaxResults"
+          "target": "com.amazonaws.bedrockagent#MaxResults",
+          "traits": {
+            "smithy.api#documentation": "<p>The maximum number of results to return in the response. If the total number of results is greater than this value, use the token returned in the response in the <code>nextToken</code> field when making another request to return the next batch of results.</p>"
+          }
         },
         "nextToken": {
-          "target": "com.amazonaws.bedrockagent#NextToken"
+          "target": "com.amazonaws.bedrockagent#NextToken",
+          "traits": {
+            "smithy.api#documentation": "<p>If the total number of results is greater than the <code>maxResults</code> value provided in the request, enter the token returned in the <code>nextToken</code> field in the response in this field to return the next batch of results.</p>"
+          }
         }
       },
       "traits": {
-        "smithy.api#documentation": "List Action Groups Request",
         "smithy.api#input": {}
       }
     },
@@ -4600,15 +4901,18 @@
         "actionGroupSummaries": {
           "target": "com.amazonaws.bedrockagent#ActionGroupSummaries",
           "traits": {
+            "smithy.api#documentation": "<p>A list of objects, each of which contains information about an action group.</p>",
             "smithy.api#required": {}
           }
         },
         "nextToken": {
-          "target": "com.amazonaws.bedrockagent#NextToken"
+          "target": "com.amazonaws.bedrockagent#NextToken",
+          "traits": {
+            "smithy.api#documentation": "<p>If the total number of results is greater than the <code>maxResults</code> value provided in the request, use this token when making another request in the <code>nextToken</code> field to return the next batch of results.</p>"
+          }
         }
       },
       "traits": {
-        "smithy.api#documentation": "List Action Groups Response",
         "smithy.api#output": {}
       }
     },
@@ -4638,7 +4942,7 @@
         }
       ],
       "traits": {
-        "smithy.api#documentation": "Lists all the Aliases for an Amazon Bedrock Agent",
+        "smithy.api#documentation": "<p>Lists the aliases of an agent and information about each one.</p>",
         "smithy.api#http": {
           "code": 200,
           "method": "POST",
@@ -4660,20 +4964,25 @@
         "agentId": {
           "target": "com.amazonaws.bedrockagent#Id",
           "traits": {
-            "smithy.api#documentation": "Id generated at the server side when an Agent is created",
+            "smithy.api#documentation": "<p>The unique identifier of the agent.</p>",
             "smithy.api#httpLabel": {},
             "smithy.api#required": {}
           }
         },
         "maxResults": {
-          "target": "com.amazonaws.bedrockagent#MaxResults"
+          "target": "com.amazonaws.bedrockagent#MaxResults",
+          "traits": {
+            "smithy.api#documentation": "<p>The maximum number of results to return in the response. If the total number of results is greater than this value, use the token returned in the response in the <code>nextToken</code> field when making another request to return the next batch of results.</p>"
+          }
         },
         "nextToken": {
-          "target": "com.amazonaws.bedrockagent#NextToken"
+          "target": "com.amazonaws.bedrockagent#NextToken",
+          "traits": {
+            "smithy.api#documentation": "<p>If the total number of results is greater than the <code>maxResults</code> value provided in the request, enter the token returned in the <code>nextToken</code> field in the response in this field to return the next batch of results.</p>"
+          }
         }
       },
       "traits": {
-        "smithy.api#documentation": "List Agent Aliases Request",
         "smithy.api#input": {}
       }
     },
@@ -4683,15 +4992,18 @@
         "agentAliasSummaries": {
           "target": "com.amazonaws.bedrockagent#AgentAliasSummaries",
           "traits": {
+            "smithy.api#documentation": "<p>A list of objects, each of which contains information about an alias of the agent.</p>",
             "smithy.api#required": {}
           }
         },
         "nextToken": {
-          "target": "com.amazonaws.bedrockagent#NextToken"
+          "target": "com.amazonaws.bedrockagent#NextToken",
+          "traits": {
+            "smithy.api#documentation": "<p>If the total number of results is greater than the <code>maxResults</code> value provided in the request, use this token when making another request in the <code>nextToken</code> field to return the next batch of results.</p>"
+          }
         }
       },
       "traits": {
-        "smithy.api#documentation": "List Agent Aliases Response",
         "smithy.api#output": {}
       }
     },
@@ -4721,7 +5033,7 @@
         }
       ],
       "traits": {
-        "smithy.api#documentation": "List of Knowledge Bases associated to an existing Amazon Bedrock Agent Version",
+        "smithy.api#documentation": "<p>Lists knowledge bases associated with an agent and information about each one.</p>",
         "smithy.api#http": {
           "code": 200,
           "method": "POST",
@@ -4743,7 +5055,7 @@
         "agentId": {
           "target": "com.amazonaws.bedrockagent#Id",
           "traits": {
-            "smithy.api#documentation": "Id generated at the server side when an Agent is created",
+            "smithy.api#documentation": "<p>The unique identifier of the agent for which to return information about knowledge bases associated with it.</p>",
             "smithy.api#httpLabel": {},
             "smithy.api#required": {}
           }
@@ -4751,20 +5063,25 @@
         "agentVersion": {
           "target": "com.amazonaws.bedrockagent#Version",
           "traits": {
-            "smithy.api#documentation": "Version number generated when a version is created",
+            "smithy.api#documentation": "<p>The version of the agent for which to return information about knowledge bases associated with it.</p>",
             "smithy.api#httpLabel": {},
             "smithy.api#required": {}
           }
         },
         "maxResults": {
-          "target": "com.amazonaws.bedrockagent#MaxResults"
+          "target": "com.amazonaws.bedrockagent#MaxResults",
+          "traits": {
+            "smithy.api#documentation": "<p>The maximum number of results to return in the response. If the total number of results is greater than this value, use the token returned in the response in the <code>nextToken</code> field when making another request to return the next batch of results.</p>"
+          }
         },
         "nextToken": {
-          "target": "com.amazonaws.bedrockagent#NextToken"
+          "target": "com.amazonaws.bedrockagent#NextToken",
+          "traits": {
+            "smithy.api#documentation": "<p>If the total number of results is greater than the <code>maxResults</code> value provided in the request, enter the token returned in the <code>nextToken</code> field in the response in this field to return the next batch of results.</p>"
+          }
         }
       },
       "traits": {
-        "smithy.api#documentation": "List Agent Knowledge Bases Request",
         "smithy.api#input": {}
       }
     },
@@ -4774,15 +5091,18 @@
         "agentKnowledgeBaseSummaries": {
           "target": "com.amazonaws.bedrockagent#AgentKnowledgeBaseSummaries",
           "traits": {
+            "smithy.api#documentation": "<p>A list of objects, each of which contains information about a knowledge base associated with the agent.</p>",
             "smithy.api#required": {}
           }
         },
         "nextToken": {
-          "target": "com.amazonaws.bedrockagent#NextToken"
+          "target": "com.amazonaws.bedrockagent#NextToken",
+          "traits": {
+            "smithy.api#documentation": "<p>If the total number of results is greater than the <code>maxResults</code> value provided in the request, use this token when making another request in the <code>nextToken</code> field to return the next batch of results.</p>"
+          }
         }
       },
       "traits": {
-        "smithy.api#documentation": "List Agent Knowledge Bases Response",
         "smithy.api#output": {}
       }
     },
@@ -4812,7 +5132,7 @@
         }
       ],
       "traits": {
-        "smithy.api#documentation": "Lists Agent Versions",
+        "smithy.api#documentation": "<p>Lists the versions of an agent and information about each version.</p>",
         "smithy.api#http": {
           "code": 200,
           "method": "POST",
@@ -4834,20 +5154,25 @@
         "agentId": {
           "target": "com.amazonaws.bedrockagent#Id",
           "traits": {
-            "smithy.api#documentation": "Id generated at the server side when an Agent is created",
+            "smithy.api#documentation": "<p>The unique identifier of the agent.</p>",
             "smithy.api#httpLabel": {},
             "smithy.api#required": {}
           }
         },
         "maxResults": {
-          "target": "com.amazonaws.bedrockagent#MaxResults"
+          "target": "com.amazonaws.bedrockagent#MaxResults",
+          "traits": {
+            "smithy.api#documentation": "<p>The maximum number of results to return in the response. If the total number of results is greater than this value, use the token returned in the response in the <code>nextToken</code> field when making another request to return the next batch of results.</p>"
+          }
         },
         "nextToken": {
-          "target": "com.amazonaws.bedrockagent#NextToken"
+          "target": "com.amazonaws.bedrockagent#NextToken",
+          "traits": {
+            "smithy.api#documentation": "<p>If the total number of results is greater than the <code>maxResults</code> value provided in the request, enter the token returned in the <code>nextToken</code> field in the response in this field to return the next batch of results.</p>"
+          }
         }
       },
       "traits": {
-        "smithy.api#documentation": "List Agent Versions Request",
         "smithy.api#input": {}
       }
     },
@@ -4857,15 +5182,18 @@
         "agentVersionSummaries": {
           "target": "com.amazonaws.bedrockagent#AgentVersionSummaries",
           "traits": {
+            "smithy.api#documentation": "<p>A list of objects, each of which contains information about a version of the agent.</p>",
             "smithy.api#required": {}
           }
         },
         "nextToken": {
-          "target": "com.amazonaws.bedrockagent#NextToken"
+          "target": "com.amazonaws.bedrockagent#NextToken",
+          "traits": {
+            "smithy.api#documentation": "<p>If the total number of results is greater than the <code>maxResults</code> value provided in the request, use this token when making another request in the <code>nextToken</code> field to return the next batch of results.</p>"
+          }
         }
       },
       "traits": {
-        "smithy.api#documentation": "List Agent Versions Response",
         "smithy.api#output": {}
       }
     },
@@ -4892,7 +5220,7 @@
         }
       ],
       "traits": {
-        "smithy.api#documentation": "Lists Agents",
+        "smithy.api#documentation": "<p>Lists the agents belonging to an account and information about each agent.</p>",
         "smithy.api#http": {
           "code": 200,
           "method": "POST",
@@ -4912,14 +5240,19 @@
       "type": "structure",
       "members": {
         "maxResults": {
-          "target": "com.amazonaws.bedrockagent#MaxResults"
+          "target": "com.amazonaws.bedrockagent#MaxResults",
+          "traits": {
+            "smithy.api#documentation": "<p>The maximum number of results to return in the response. If the total number of results is greater than this value, use the token returned in the response in the <code>nextToken</code> field when making another request to return the next batch of results.</p>"
+          }
         },
         "nextToken": {
-          "target": "com.amazonaws.bedrockagent#NextToken"
+          "target": "com.amazonaws.bedrockagent#NextToken",
+          "traits": {
+            "smithy.api#documentation": "<p>If the total number of results is greater than the <code>maxResults</code> value provided in the request, enter the token returned in the <code>nextToken</code> field in the response in this field to return the next batch of results.</p>"
+          }
         }
       },
       "traits": {
-        "smithy.api#documentation": "List Agent Request",
         "smithy.api#input": {}
       }
     },
@@ -4929,15 +5262,18 @@
         "agentSummaries": {
           "target": "com.amazonaws.bedrockagent#AgentSummaries",
           "traits": {
+            "smithy.api#documentation": "<p>A list of objects, each of which contains information about an agent.</p>",
             "smithy.api#required": {}
           }
         },
         "nextToken": {
-          "target": "com.amazonaws.bedrockagent#NextToken"
+          "target": "com.amazonaws.bedrockagent#NextToken",
+          "traits": {
+            "smithy.api#documentation": "<p>If the total number of results is greater than the <code>maxResults</code> value provided in the request, use this token when making another request in the <code>nextToken</code> field to return the next batch of results.</p>"
+          }
         }
       },
       "traits": {
-        "smithy.api#documentation": "List Agent Response",
         "smithy.api#output": {}
       }
     },
@@ -4967,7 +5303,7 @@
         }
       ],
       "traits": {
-        "smithy.api#documentation": "List data sources",
+        "smithy.api#documentation": "<p>Lists the data sources in a knowledge base and information about each one.</p>",
         "smithy.api#http": {
           "code": 200,
           "method": "POST",
@@ -4989,15 +5325,22 @@
         "knowledgeBaseId": {
           "target": "com.amazonaws.bedrockagent#Id",
           "traits": {
+            "smithy.api#documentation": "<p>The unique identifier of the knowledge base for which to return a list of information.</p>",
             "smithy.api#httpLabel": {},
             "smithy.api#required": {}
           }
         },
         "maxResults": {
-          "target": "com.amazonaws.bedrockagent#MaxResults"
+          "target": "com.amazonaws.bedrockagent#MaxResults",
+          "traits": {
+            "smithy.api#documentation": "<p>The maximum number of results to return in the response. If the total number of results is greater than this value, use the token returned in the response in the <code>nextToken</code> field when making another request to return the next batch of results.</p>"
+          }
         },
         "nextToken": {
-          "target": "com.amazonaws.bedrockagent#NextToken"
+          "target": "com.amazonaws.bedrockagent#NextToken",
+          "traits": {
+            "smithy.api#documentation": "<p>If the total number of results is greater than the <code>maxResults</code> value provided in the request, enter the token returned in the <code>nextToken</code> field in the response in this field to return the next batch of results.</p>"
+          }
         }
       },
       "traits": {
@@ -5010,11 +5353,15 @@
         "dataSourceSummaries": {
           "target": "com.amazonaws.bedrockagent#DataSourceSummaries",
           "traits": {
+            "smithy.api#documentation": "<p>A list of objects, each of which contains information about a data source.</p>",
             "smithy.api#required": {}
           }
         },
         "nextToken": {
-          "target": "com.amazonaws.bedrockagent#NextToken"
+          "target": "com.amazonaws.bedrockagent#NextToken",
+          "traits": {
+            "smithy.api#documentation": "<p>If the total number of results is greater than the <code>maxResults</code> value provided in the request, use this token when making another request in the <code>nextToken</code> field to return the next batch of results.</p>"
+          }
         }
       },
       "traits": {
@@ -5047,7 +5394,7 @@
         }
       ],
       "traits": {
-        "smithy.api#documentation": "List ingestion jobs",
+        "smithy.api#documentation": "<p>Lists the ingestion jobs for a data source and information about each of them.</p>",
         "smithy.api#http": {
           "code": 200,
           "method": "POST",
@@ -5069,6 +5416,7 @@
         "knowledgeBaseId": {
           "target": "com.amazonaws.bedrockagent#Id",
           "traits": {
+            "smithy.api#documentation": "<p>The unique identifier of the knowledge base for which to return ingestion jobs.</p>",
             "smithy.api#httpLabel": {},
             "smithy.api#required": {}
           }
@@ -5076,21 +5424,34 @@
         "dataSourceId": {
           "target": "com.amazonaws.bedrockagent#Id",
           "traits": {
+            "smithy.api#documentation": "<p>The unique identifier of the data source for which to return ingestion jobs.</p>",
             "smithy.api#httpLabel": {},
             "smithy.api#required": {}
           }
         },
         "filters": {
-          "target": "com.amazonaws.bedrockagent#IngestionJobFilters"
+          "target": "com.amazonaws.bedrockagent#IngestionJobFilters",
+          "traits": {
+            "smithy.api#documentation": "<p>Contains a definition of a filter for which to filter the results.</p>"
+          }
         },
         "sortBy": {
-          "target": "com.amazonaws.bedrockagent#IngestionJobSortBy"
+          "target": "com.amazonaws.bedrockagent#IngestionJobSortBy",
+          "traits": {
+            "smithy.api#documentation": "<p>Contains details about how to sort the results.</p>"
+          }
         },
         "maxResults": {
-          "target": "com.amazonaws.bedrockagent#MaxResults"
+          "target": "com.amazonaws.bedrockagent#MaxResults",
+          "traits": {
+            "smithy.api#documentation": "<p>The maximum number of results to return in the response. If the total number of results is greater than this value, use the token returned in the response in the <code>nextToken</code> field when making another request to return the next batch of results.</p>"
+          }
         },
         "nextToken": {
-          "target": "com.amazonaws.bedrockagent#NextToken"
+          "target": "com.amazonaws.bedrockagent#NextToken",
+          "traits": {
+            "smithy.api#documentation": "<p>If the total number of results is greater than the <code>maxResults</code> value provided in the request, enter the token returned in the <code>nextToken</code> field in the response in this field to return the next batch of results.</p>"
+          }
         }
       },
       "traits": {
@@ -5103,11 +5464,15 @@
         "ingestionJobSummaries": {
           "target": "com.amazonaws.bedrockagent#IngestionJobSummaries",
           "traits": {
+            "smithy.api#documentation": "<p>A list of objects, each of which contains information about an ingestion job.</p>",
             "smithy.api#required": {}
           }
         },
         "nextToken": {
-          "target": "com.amazonaws.bedrockagent#NextToken"
+          "target": "com.amazonaws.bedrockagent#NextToken",
+          "traits": {
+            "smithy.api#documentation": "<p>If the total number of results is greater than the <code>maxResults</code> value provided in the request, use this token when making another request in the <code>nextToken</code> field to return the next batch of results.</p>"
+          }
         }
       },
       "traits": {
@@ -5137,7 +5502,7 @@
         }
       ],
       "traits": {
-        "smithy.api#documentation": "List Knowledge Bases",
+        "smithy.api#documentation": "<p>Lists the knowledge bases in an account and information about each of them.</p>",
         "smithy.api#http": {
           "code": 200,
           "method": "POST",
@@ -5157,10 +5522,16 @@
       "type": "structure",
       "members": {
         "maxResults": {
-          "target": "com.amazonaws.bedrockagent#MaxResults"
+          "target": "com.amazonaws.bedrockagent#MaxResults",
+          "traits": {
+            "smithy.api#documentation": "<p>The maximum number of results to return in the response. If the total number of results is greater than this value, use the token returned in the response in the <code>nextToken</code> field when making another request to return the next batch of results.</p>"
+          }
         },
         "nextToken": {
-          "target": "com.amazonaws.bedrockagent#NextToken"
+          "target": "com.amazonaws.bedrockagent#NextToken",
+          "traits": {
+            "smithy.api#documentation": "<p>If the total number of results is greater than the <code>maxResults</code> value provided in the request, enter the token returned in the <code>nextToken</code> field in the response in this field to return the next batch of results.</p>"
+          }
         }
       },
       "traits": {
@@ -5173,11 +5544,15 @@
         "knowledgeBaseSummaries": {
           "target": "com.amazonaws.bedrockagent#KnowledgeBaseSummaries",
           "traits": {
+            "smithy.api#documentation": "<p>A list of objects, each of which contains information about a knowledge base.</p>",
             "smithy.api#required": {}
           }
         },
         "nextToken": {
-          "target": "com.amazonaws.bedrockagent#NextToken"
+          "target": "com.amazonaws.bedrockagent#NextToken",
+          "traits": {
+            "smithy.api#documentation": "<p>If the total number of results is greater than the <code>maxResults</code> value provided in the request, use this token when making another request in the <code>nextToken</code> field to return the next batch of results.</p>"
+          }
         }
       },
       "traits": {
@@ -5210,7 +5585,7 @@
         }
       ],
       "traits": {
-        "smithy.api#documentation": "List tags for a resource",
+        "smithy.api#documentation": "<p>List all the tags for the resource you specify.</p>",
         "smithy.api#http": {
           "code": 200,
           "method": "GET",
@@ -5225,6 +5600,7 @@
         "resourceArn": {
           "target": "com.amazonaws.bedrockagent#TaggableResourcesArn",
           "traits": {
+            "smithy.api#documentation": "<p>The ARN of the resource for which to list tags.</p>",
             "smithy.api#httpLabel": {},
             "smithy.api#required": {}
           }
@@ -5238,7 +5614,10 @@
       "type": "structure",
       "members": {
         "tags": {
-          "target": "com.amazonaws.bedrockagent#TagsMap"
+          "target": "com.amazonaws.bedrockagent#TagsMap",
+          "traits": {
+            "smithy.api#documentation": "<p>The key-value pairs for the tags associated with the resource.</p>"
+          }
         }
       },
       "traits": {
@@ -5248,7 +5627,6 @@
     "com.amazonaws.bedrockagent#MaxResults": {
       "type": "integer",
       "traits": {
-        "smithy.api#documentation": "Max Results.",
         "smithy.api#range": {
           "min": 1,
           "max": 1000
@@ -5258,7 +5636,6 @@
     "com.amazonaws.bedrockagent#MaximumLength": {
       "type": "integer",
       "traits": {
-        "smithy.api#documentation": "Maximum length of output",
         "smithy.api#range": {
           "min": 0,
           "max": 4096
@@ -5268,7 +5645,6 @@
     "com.amazonaws.bedrockagent#ModelIdentifier": {
       "type": "string",
       "traits": {
-        "smithy.api#documentation": "ARN or name of a Bedrock model.",
         "smithy.api#length": {
           "min": 1,
           "max": 2048
@@ -5279,14 +5655,12 @@
     "com.amazonaws.bedrockagent#Name": {
       "type": "string",
       "traits": {
-        "smithy.api#documentation": "Name for a resource.",
         "smithy.api#pattern": "^([0-9a-zA-Z][_-]?){1,100}$"
       }
     },
     "com.amazonaws.bedrockagent#NextToken": {
       "type": "string",
       "traits": {
-        "smithy.api#documentation": "Opaque continuation token of previous paginated response.",
         "smithy.api#length": {
           "min": 1,
           "max": 2048
@@ -5297,21 +5671,18 @@
     "com.amazonaws.bedrockagent#NonBlankString": {
       "type": "string",
       "traits": {
-        "smithy.api#documentation": "Non Blank String",
         "smithy.api#pattern": "^[\\s\\S]+$"
       }
     },
     "com.amazonaws.bedrockagent#NumericalVersion": {
       "type": "string",
       "traits": {
-        "smithy.api#documentation": "Numerical Agent Version.",
         "smithy.api#pattern": "^[0-9]{1,5}$"
       }
     },
     "com.amazonaws.bedrockagent#OpenSearchServerlessCollectionArn": {
       "type": "string",
       "traits": {
-        "smithy.api#documentation": "Arn of an OpenSearch Serverless collection.",
         "smithy.api#length": {
           "max": 2048
         },
@@ -5324,24 +5695,27 @@
         "collectionArn": {
           "target": "com.amazonaws.bedrockagent#OpenSearchServerlessCollectionArn",
           "traits": {
+            "smithy.api#documentation": "<p>The ARN of the OpenSearch Service vector store.</p>",
             "smithy.api#required": {}
           }
         },
         "vectorIndexName": {
           "target": "com.amazonaws.bedrockagent#OpenSearchServerlessIndexName",
           "traits": {
+            "smithy.api#documentation": "<p>The name of the vector store.</p>",
             "smithy.api#required": {}
           }
         },
         "fieldMapping": {
           "target": "com.amazonaws.bedrockagent#OpenSearchServerlessFieldMapping",
           "traits": {
+            "smithy.api#documentation": "<p>Contains the names of the fields to which to map information about the vector store.</p>",
             "smithy.api#required": {}
           }
         }
       },
       "traits": {
-        "smithy.api#documentation": "Contains the configurations to use OpenSearch Serverless to store knowledge base data."
+        "smithy.api#documentation": "<p>Contains details about the storage configuration of the knowledge base in Amazon OpenSearch Service. For more information, see <a href=\"https://docs.aws.amazon.com/bedrock/latest/userguide/knowledge-base-setup-oss.html\">Create a vector index in Amazon OpenSearch Service</a>.</p>"
       }
     },
     "com.amazonaws.bedrockagent#OpenSearchServerlessFieldMapping": {
@@ -5350,30 +5724,32 @@
         "vectorField": {
           "target": "com.amazonaws.bedrockagent#FieldName",
           "traits": {
+            "smithy.api#documentation": "<p>The name of the field in which Amazon Bedrock stores the vector embeddings for your data sources.</p>",
             "smithy.api#required": {}
           }
         },
         "textField": {
           "target": "com.amazonaws.bedrockagent#FieldName",
           "traits": {
+            "smithy.api#documentation": "<p>The name of the field in which Amazon Bedrock stores the raw text from your data. The text is split according to the chunking strategy you choose.</p>",
             "smithy.api#required": {}
           }
         },
         "metadataField": {
           "target": "com.amazonaws.bedrockagent#FieldName",
           "traits": {
+            "smithy.api#documentation": "<p>The name of the field in which Amazon Bedrock stores metadata about the vector store.</p>",
             "smithy.api#required": {}
           }
         }
       },
       "traits": {
-        "smithy.api#documentation": "A mapping of Bedrock Knowledge Base fields to OpenSearch Serverless field names"
+        "smithy.api#documentation": "<p>Contains the names of the fields to which to map information about the vector store.</p>"
       }
     },
     "com.amazonaws.bedrockagent#OpenSearchServerlessIndexName": {
       "type": "string",
       "traits": {
-        "smithy.api#documentation": "Arn of an OpenSearch Serverless index.",
         "smithy.api#length": {
           "max": 2048
         },
@@ -5383,7 +5759,6 @@
     "com.amazonaws.bedrockagent#Payload": {
       "type": "string",
       "traits": {
-        "smithy.api#documentation": "String OpenAPI Payload",
         "smithy.api#sensitive": {}
       }
     },
@@ -5393,33 +5768,38 @@
         "connectionString": {
           "target": "com.amazonaws.bedrockagent#PineconeConnectionString",
           "traits": {
+            "smithy.api#documentation": "<p>The endpoint URL for your index management page.</p>",
             "smithy.api#required": {}
           }
         },
         "credentialsSecretArn": {
           "target": "com.amazonaws.bedrockagent#SecretArn",
           "traits": {
+            "smithy.api#documentation": "<p>The ARN of the secret that you created in Secrets Manager that is linked to your Pinecone API key.</p>",
             "smithy.api#required": {}
           }
         },
         "namespace": {
-          "target": "com.amazonaws.bedrockagent#PineconeNamespace"
+          "target": "com.amazonaws.bedrockagent#PineconeNamespace",
+          "traits": {
+            "smithy.api#documentation": "<p>The namespace to be used to write new data to your database.</p>"
+          }
         },
         "fieldMapping": {
           "target": "com.amazonaws.bedrockagent#PineconeFieldMapping",
           "traits": {
+            "smithy.api#documentation": "<p>Contains the names of the fields to which to map information about the vector store.</p>",
             "smithy.api#required": {}
           }
         }
       },
       "traits": {
-        "smithy.api#documentation": "Contains the configurations to use Pinecone to store knowledge base data."
+        "smithy.api#documentation": "<p>Contains details about the storage configuration of the knowledge base in Pinecone. For more information, see <a href=\"https://docs.aws.amazon.com/bedrock/latest/userguide/knowledge-base-setup-pinecone.html\">Create a vector index in Pinecone</a>.</p>"
       }
     },
     "com.amazonaws.bedrockagent#PineconeConnectionString": {
       "type": "string",
       "traits": {
-        "smithy.api#documentation": "Pinecone connection string",
         "smithy.api#length": {
           "max": 2048
         },
@@ -5432,24 +5812,25 @@
         "textField": {
           "target": "com.amazonaws.bedrockagent#FieldName",
           "traits": {
+            "smithy.api#documentation": "<p>The name of the field in which Amazon Bedrock stores the raw text from your data. The text is split according to the chunking strategy you choose.</p>",
             "smithy.api#required": {}
           }
         },
         "metadataField": {
           "target": "com.amazonaws.bedrockagent#FieldName",
           "traits": {
+            "smithy.api#documentation": "<p>The name of the field in which Amazon Bedrock stores metadata about the vector store.</p>",
             "smithy.api#required": {}
           }
         }
       },
       "traits": {
-        "smithy.api#documentation": "A mapping of Bedrock Knowledge Base fields to Pinecone field names"
+        "smithy.api#documentation": "<p>Contains the names of the fields to which to map information about the vector store.</p>"
       }
     },
     "com.amazonaws.bedrockagent#PineconeNamespace": {
       "type": "string",
       "traits": {
-        "smithy.api#documentation": "Pinecone namespace",
         "smithy.api#length": {
           "max": 2048
         },
@@ -5488,7 +5869,7 @@
         }
       ],
       "traits": {
-        "smithy.api#documentation": "Prepares an existing Amazon Bedrock Agent to receive runtime requests",
+        "smithy.api#documentation": "<p>Creates a <code>DRAFT</code> version of the agent that can be used for internal testing.</p>",
         "smithy.api#http": {
           "code": 202,
           "method": "POST",
@@ -5503,14 +5884,13 @@
         "agentId": {
           "target": "com.amazonaws.bedrockagent#Id",
           "traits": {
-            "smithy.api#documentation": "Id generated at the server side when an Agent is created",
+            "smithy.api#documentation": "<p>The unique identifier of the agent for which to create a <code>DRAFT</code> version.</p>",
             "smithy.api#httpLabel": {},
             "smithy.api#required": {}
           }
         }
       },
       "traits": {
-        "smithy.api#documentation": "PrepareAgent Request",
         "smithy.api#input": {}
       }
     },
@@ -5520,30 +5900,33 @@
         "agentId": {
           "target": "com.amazonaws.bedrockagent#Id",
           "traits": {
+            "smithy.api#documentation": "<p>The unique identifier of the agent for which the <code>DRAFT</code> version was created.</p>",
             "smithy.api#required": {}
           }
         },
         "agentStatus": {
           "target": "com.amazonaws.bedrockagent#AgentStatus",
           "traits": {
+            "smithy.api#documentation": "<p>The status of the <code>DRAFT</code> version and whether it is ready for use.</p>",
             "smithy.api#required": {}
           }
         },
         "agentVersion": {
           "target": "com.amazonaws.bedrockagent#Version",
           "traits": {
+            "smithy.api#documentation": "<p>The version of the agent.</p>",
             "smithy.api#required": {}
           }
         },
         "preparedAt": {
           "target": "com.amazonaws.bedrockagent#DateTimestamp",
           "traits": {
+            "smithy.api#documentation": "<p>The time at which the <code>DRAFT</code> version of the agent was last prepared.</p>",
             "smithy.api#required": {}
           }
         }
       },
       "traits": {
-        "smithy.api#documentation": "PrepareAgent Response",
         "smithy.api#output": {}
       }
     },
@@ -5551,26 +5934,44 @@
       "type": "structure",
       "members": {
         "promptType": {
-          "target": "com.amazonaws.bedrockagent#PromptType"
+          "target": "com.amazonaws.bedrockagent#PromptType",
+          "traits": {
+            "smithy.api#documentation": "<p>The step in the agent sequence that this prompt configuration applies to.</p>"
+          }
         },
         "promptCreationMode": {
-          "target": "com.amazonaws.bedrockagent#CreationMode"
+          "target": "com.amazonaws.bedrockagent#CreationMode",
+          "traits": {
+            "smithy.api#documentation": "<p>Specifies whether to override the default prompt template for this <code>promptType</code>. Set this value to <code>OVERRIDDEN</code> to use the prompt that you provide in the <code>basePromptTemplate</code>. If you leave it as <code>DEFAULT</code>, the agent uses a default prompt template.</p>"
+          }
         },
         "promptState": {
-          "target": "com.amazonaws.bedrockagent#PromptState"
+          "target": "com.amazonaws.bedrockagent#PromptState",
+          "traits": {
+            "smithy.api#documentation": "<p>Specifies whether to allow the agent to carry out the step specified in the <code>promptType</code>. If you set this value to <code>DISABLED</code>, the agent skips that step. The default state for each <code>promptType</code> is as follows.</p>\n         <ul>\n            <li>\n               <p>\n                  <code>PRE_PROCESSING</code> – <code>ENABLED</code>\n               </p>\n            </li>\n            <li>\n               <p>\n                  <code>ORCHESTRATION</code> – <code>ENABLED</code>\n               </p>\n            </li>\n            <li>\n               <p>\n                  <code>KNOWLEDGE_BASE_RESPONSE_GENERATION</code> – <code>ENABLED</code>\n               </p>\n            </li>\n            <li>\n               <p>\n                  <code>POST_PROCESSING</code> – <code>DISABLED</code>\n               </p>\n            </li>\n         </ul>"
+          }
         },
         "basePromptTemplate": {
-          "target": "com.amazonaws.bedrockagent#BasePromptTemplate"
+          "target": "com.amazonaws.bedrockagent#BasePromptTemplate",
+          "traits": {
+            "smithy.api#documentation": "<p>Defines the prompt template with which to replace the default prompt template. You can use placeholder variables in the base prompt template to customize the prompt. For more information, see <a href=\"https://docs.aws.amazon.com/bedrock/latest/userguide/prompt-placeholders.html\">Prompt template placeholder variables</a>.</p>"
+          }
         },
         "inferenceConfiguration": {
-          "target": "com.amazonaws.bedrockagent#InferenceConfiguration"
+          "target": "com.amazonaws.bedrockagent#InferenceConfiguration",
+          "traits": {
+            "smithy.api#documentation": "<p>Contains inference parameters to use when the agent invokes a foundation model in the part of the agent sequence defined by the <code>promptType</code>. For more information, see <a href=\"https://docs.aws.amazon.com/bedrock/latest/userguide/model-parameters.html\">Inference parameters for foundation models</a>.</p>"
+          }
         },
         "parserMode": {
-          "target": "com.amazonaws.bedrockagent#CreationMode"
+          "target": "com.amazonaws.bedrockagent#CreationMode",
+          "traits": {
+            "smithy.api#documentation": "<p>Specifies whether to override the default parser Lambda function when parsing the raw foundation model output in the part of the agent sequence defined by the <code>promptType</code>. If you set the field as <code>OVERRIDEN</code>, the <code>overrideLambda</code> field in the <a href=\"https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_PromptOverrideConfiguration.html\">PromptOverrideConfiguration</a> must be specified with the ARN of a Lambda function.</p>"
+          }
         }
       },
       "traits": {
-        "smithy.api#documentation": "BasePromptConfiguration per Prompt Type."
+        "smithy.api#documentation": "<p>Contains configurations to override a prompt template in one part of an agent sequence. For more information, see <a href=\"https://docs.aws.amazon.com/bedrock/latest/userguide/advanced-prompts.html\">Advanced prompts</a>.</p>"
       }
     },
     "com.amazonaws.bedrockagent#PromptConfigurations": {
@@ -5579,7 +5980,6 @@
         "target": "com.amazonaws.bedrockagent#PromptConfiguration"
       },
       "traits": {
-        "smithy.api#documentation": "List of BasePromptConfiguration",
         "smithy.api#length": {
           "max": 10
         }
@@ -5591,15 +5991,19 @@
         "promptConfigurations": {
           "target": "com.amazonaws.bedrockagent#PromptConfigurations",
           "traits": {
+            "smithy.api#documentation": "<p>Contains configurations to override a prompt template in one part of an agent sequence. For more information, see <a href=\"https://docs.aws.amazon.com/bedrock/latest/userguide/advanced-prompts.html\">Advanced prompts</a>.</p>",
             "smithy.api#required": {}
           }
         },
         "overrideLambda": {
-          "target": "com.amazonaws.bedrockagent#LambdaArn"
+          "target": "com.amazonaws.bedrockagent#LambdaArn",
+          "traits": {
+            "smithy.api#documentation": "<p>The ARN of the Lambda function to use when parsing the raw foundation model output in parts of the agent sequence. If you specify this field, at least one of the <code>promptConfigurations</code> must contain a <code>parserMode</code> value that is set to <code>OVERRIDDEN</code>.</p>"
+          }
         }
       },
       "traits": {
-        "smithy.api#documentation": "Configuration for prompt override.",
+        "smithy.api#documentation": "<p>Contains configurations to override prompts in different parts of an agent sequence. For more information, see <a href=\"https://docs.aws.amazon.com/bedrock/latest/userguide/advanced-prompts.html\">Advanced prompts</a>.</p>",
         "smithy.api#sensitive": {}
       }
     },
@@ -5618,9 +6022,6 @@
             "smithy.api#enumValue": "DISABLED"
           }
         }
-      },
-      "traits": {
-        "smithy.api#documentation": "Prompt State."
       }
     },
     "com.amazonaws.bedrockagent#PromptType": {
@@ -5650,15 +6051,11 @@
             "smithy.api#enumValue": "KNOWLEDGE_BASE_RESPONSE_GENERATION"
           }
         }
-      },
-      "traits": {
-        "smithy.api#documentation": "Prompt Type."
       }
     },
     "com.amazonaws.bedrockagent#RdsArn": {
       "type": "string",
       "traits": {
-        "smithy.api#documentation": "Arn of a RDS Resource.",
         "smithy.api#pattern": "^arn:aws(|-cn|-us-gov):rds:[a-zA-Z0-9-]*:[0-9]{12}:cluster:[a-zA-Z0-9-]{1,63}$"
       }
     },
@@ -5668,42 +6065,46 @@
         "resourceArn": {
           "target": "com.amazonaws.bedrockagent#RdsArn",
           "traits": {
+            "smithy.api#documentation": "<p>The ARN of the vector store.</p>",
             "smithy.api#required": {}
           }
         },
         "credentialsSecretArn": {
           "target": "com.amazonaws.bedrockagent#SecretArn",
           "traits": {
+            "smithy.api#documentation": "<p>The ARN of the secret that you created in Secrets Manager that is linked to your Amazon RDS database.</p>",
             "smithy.api#required": {}
           }
         },
         "databaseName": {
           "target": "com.amazonaws.bedrockagent#RdsDatabaseName",
           "traits": {
+            "smithy.api#documentation": "<p>The name of your Amazon RDS database.</p>",
             "smithy.api#required": {}
           }
         },
         "tableName": {
           "target": "com.amazonaws.bedrockagent#RdsTableName",
           "traits": {
+            "smithy.api#documentation": "<p>The name of the table in the database.</p>",
             "smithy.api#required": {}
           }
         },
         "fieldMapping": {
           "target": "com.amazonaws.bedrockagent#RdsFieldMapping",
           "traits": {
+            "smithy.api#documentation": "<p>Contains the names of the fields to which to map information about the vector store.</p>",
             "smithy.api#required": {}
           }
         }
       },
       "traits": {
-        "smithy.api#documentation": "Contains the configurations to use RDS to store knowledge base data."
+        "smithy.api#documentation": "<p>Contains details about the storage configuration of the knowledge base in Amazon RDS. For more information, see <a href=\"https://docs.aws.amazon.com/bedrock/latest/userguide/knowledge-base-setup-rds.html\">Create a vector index in Amazon RDS</a>.</p>"
       }
     },
     "com.amazonaws.bedrockagent#RdsDatabaseName": {
       "type": "string",
       "traits": {
-        "smithy.api#documentation": "Name of the database within RDS",
         "smithy.api#length": {
           "max": 63
         },
@@ -5716,36 +6117,39 @@
         "primaryKeyField": {
           "target": "com.amazonaws.bedrockagent#ColumnName",
           "traits": {
+            "smithy.api#documentation": "<p>The name of the field in which Amazon Bedrock stores the ID for each entry.</p>",
             "smithy.api#required": {}
           }
         },
         "vectorField": {
           "target": "com.amazonaws.bedrockagent#ColumnName",
           "traits": {
+            "smithy.api#documentation": "<p>The name of the field in which Amazon Bedrock stores the vector embeddings for your data sources.</p>",
             "smithy.api#required": {}
           }
         },
         "textField": {
           "target": "com.amazonaws.bedrockagent#ColumnName",
           "traits": {
+            "smithy.api#documentation": "<p>The name of the field in which Amazon Bedrock stores the raw text from your data. The text is split according to the chunking strategy you choose.</p>",
             "smithy.api#required": {}
           }
         },
         "metadataField": {
           "target": "com.amazonaws.bedrockagent#ColumnName",
           "traits": {
+            "smithy.api#documentation": "<p>The name of the field in which Amazon Bedrock stores metadata about the vector store.</p>",
             "smithy.api#required": {}
           }
         }
       },
       "traits": {
-        "smithy.api#documentation": "A mapping of Bedrock Knowledge Base fields to RDS column names"
+        "smithy.api#documentation": "<p>Contains the names of the fields to which to map information about the vector store.</p>"
       }
     },
     "com.amazonaws.bedrockagent#RdsTableName": {
       "type": "string",
       "traits": {
-        "smithy.api#documentation": "Name of the table within RDS",
         "smithy.api#length": {
           "max": 63
         },
@@ -5755,7 +6159,6 @@
     "com.amazonaws.bedrockagent#RecommendedAction": {
       "type": "string",
       "traits": {
-        "smithy.api#documentation": "The recommended action users can take to resolve an error in failureReasons.",
         "smithy.api#length": {
           "max": 2048
         }
@@ -5767,7 +6170,6 @@
         "target": "com.amazonaws.bedrockagent#RecommendedAction"
       },
       "traits": {
-        "smithy.api#documentation": "The recommended actions users can take to resolve an error in failureReasons.",
         "smithy.api#length": {
           "max": 2048
         }
@@ -5779,36 +6181,39 @@
         "endpoint": {
           "target": "com.amazonaws.bedrockagent#RedisEnterpriseCloudEndpoint",
           "traits": {
+            "smithy.api#documentation": "<p>The endpoint URL of the Redis Enterprise Cloud database.</p>",
             "smithy.api#required": {}
           }
         },
         "vectorIndexName": {
           "target": "com.amazonaws.bedrockagent#RedisEnterpriseCloudIndexName",
           "traits": {
+            "smithy.api#documentation": "<p>The name of the vector index.</p>",
             "smithy.api#required": {}
           }
         },
         "credentialsSecretArn": {
           "target": "com.amazonaws.bedrockagent#SecretArn",
           "traits": {
+            "smithy.api#documentation": "<p>The ARN of the secret that you created in Secrets Manager that is linked to your Redis Enterprise Cloud database.</p>",
             "smithy.api#required": {}
           }
         },
         "fieldMapping": {
           "target": "com.amazonaws.bedrockagent#RedisEnterpriseCloudFieldMapping",
           "traits": {
+            "smithy.api#documentation": "<p>Contains the names of the fields to which to map information about the vector store.</p>",
             "smithy.api#required": {}
           }
         }
       },
       "traits": {
-        "smithy.api#documentation": "Contains the configurations to use Redis Enterprise Cloud to store knowledge base data."
+        "smithy.api#documentation": "<p>Contains details about the storage configuration of the knowledge base in Redis Enterprise Cloud. For more information, see <a href=\"https://docs.aws.amazon.com/bedrock/latest/userguide/knowledge-base-setup-oss.html\">Create a vector index in Redis Enterprise Cloud</a>.</p>"
       }
     },
     "com.amazonaws.bedrockagent#RedisEnterpriseCloudEndpoint": {
       "type": "string",
       "traits": {
-        "smithy.api#documentation": "Redis enterprise cloud endpoint",
         "smithy.api#length": {
           "max": 2048
         },
@@ -5821,30 +6226,32 @@
         "vectorField": {
           "target": "com.amazonaws.bedrockagent#FieldName",
           "traits": {
+            "smithy.api#documentation": "<p>The name of the field in which Amazon Bedrock stores the vector embeddings for your data sources.</p>",
             "smithy.api#required": {}
           }
         },
         "textField": {
           "target": "com.amazonaws.bedrockagent#FieldName",
           "traits": {
+            "smithy.api#documentation": "<p>The name of the field in which Amazon Bedrock stores the raw text from your data. The text is split according to the chunking strategy you choose.</p>",
             "smithy.api#required": {}
           }
         },
         "metadataField": {
           "target": "com.amazonaws.bedrockagent#FieldName",
           "traits": {
+            "smithy.api#documentation": "<p>The name of the field in which Amazon Bedrock stores metadata about the vector store.</p>",
             "smithy.api#required": {}
           }
         }
       },
       "traits": {
-        "smithy.api#documentation": "A mapping of Bedrock Knowledge Base fields to Redis Cloud field names"
+        "smithy.api#documentation": "<p>Contains the names of the fields to which to map information about the vector store.</p>"
       }
     },
     "com.amazonaws.bedrockagent#RedisEnterpriseCloudIndexName": {
       "type": "string",
       "traits": {
-        "smithy.api#documentation": "Name of a redis enterprise cloud index",
         "smithy.api#length": {
           "max": 2048
         },
@@ -5859,7 +6266,7 @@
         }
       },
       "traits": {
-        "smithy.api#documentation": "This exception is thrown when a resource referenced by the operation does not exist",
+        "smithy.api#documentation": "<p>The specified resource ARN was not found. Check the ARN and try your request again.</p>",
         "smithy.api#error": "client",
         "smithy.api#httpError": 404
       }
@@ -5867,7 +6274,6 @@
     "com.amazonaws.bedrockagent#S3BucketArn": {
       "type": "string",
       "traits": {
-        "smithy.api#documentation": "A S3 bucket ARN",
         "smithy.api#length": {
           "min": 1,
           "max": 2048
@@ -5878,7 +6284,6 @@
     "com.amazonaws.bedrockagent#S3BucketName": {
       "type": "string",
       "traits": {
-        "smithy.api#documentation": "A bucket in S3.",
         "smithy.api#length": {
           "min": 3,
           "max": 63
@@ -5892,35 +6297,44 @@
         "bucketArn": {
           "target": "com.amazonaws.bedrockagent#S3BucketArn",
           "traits": {
+            "smithy.api#documentation": "<p>The ARN of the bucket that contains the data source.</p>",
             "smithy.api#required": {}
           }
         },
         "inclusionPrefixes": {
-          "target": "com.amazonaws.bedrockagent#S3Prefixes"
+          "target": "com.amazonaws.bedrockagent#S3Prefixes",
+          "traits": {
+            "smithy.api#documentation": "<p>A list of S3 prefixes that define the object containing the data sources. For more information, see <a href=\"https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-prefixes.html\">Organizing objects using prefixes</a>.</p>"
+          }
         }
       },
       "traits": {
-        "smithy.api#documentation": "Configures an S3 data source location."
+        "smithy.api#documentation": "<p>Contains information about the S3 configuration of the data source.</p>"
       }
     },
     "com.amazonaws.bedrockagent#S3Identifier": {
       "type": "structure",
       "members": {
         "s3BucketName": {
-          "target": "com.amazonaws.bedrockagent#S3BucketName"
+          "target": "com.amazonaws.bedrockagent#S3BucketName",
+          "traits": {
+            "smithy.api#documentation": "<p>The name of the S3 bucket.</p>"
+          }
         },
         "s3ObjectKey": {
-          "target": "com.amazonaws.bedrockagent#S3ObjectKey"
+          "target": "com.amazonaws.bedrockagent#S3ObjectKey",
+          "traits": {
+            "smithy.api#documentation": "<p>The S3 object key containing the resource.</p>"
+          }
         }
       },
       "traits": {
-        "smithy.api#documentation": "The identifier for the S3 resource."
+        "smithy.api#documentation": "<p>Contains information about the S3 object containing the resource.</p>"
       }
     },
     "com.amazonaws.bedrockagent#S3ObjectKey": {
       "type": "string",
       "traits": {
-        "smithy.api#documentation": "A object key in S3.",
         "smithy.api#length": {
           "min": 1,
           "max": 1024
@@ -5931,7 +6345,6 @@
     "com.amazonaws.bedrockagent#S3Prefix": {
       "type": "string",
       "traits": {
-        "smithy.api#documentation": "Prefix for s3 object.",
         "smithy.api#length": {
           "min": 1,
           "max": 300
@@ -5944,7 +6357,6 @@
         "target": "com.amazonaws.bedrockagent#S3Prefix"
       },
       "traits": {
-        "smithy.api#documentation": "A list of S3 prefixes.",
         "smithy.api#length": {
           "min": 1,
           "max": 1
@@ -5954,7 +6366,6 @@
     "com.amazonaws.bedrockagent#SecretArn": {
       "type": "string",
       "traits": {
-        "smithy.api#documentation": "Arn of a SecretsManager Secret.",
         "smithy.api#pattern": "^arn:aws(|-cn|-us-gov):secretsmanager:[a-z0-9-]{1,20}:([0-9]{12}|):secret:[a-zA-Z0-9!/_+=.@-]{1,512}$"
       }
     },
@@ -5962,11 +6373,14 @@
       "type": "structure",
       "members": {
         "kmsKeyArn": {
-          "target": "com.amazonaws.bedrockagent#KmsKeyArn"
+          "target": "com.amazonaws.bedrockagent#KmsKeyArn",
+          "traits": {
+            "smithy.api#documentation": "<p>The ARN of the KMS key used to encrypt the resource.</p>"
+          }
         }
       },
       "traits": {
-        "smithy.api#documentation": "Server-side encryption configuration."
+        "smithy.api#documentation": "<p>Contains the configuration for server-side encryption.</p>"
       }
     },
     "com.amazonaws.bedrockagent#ServiceQuotaExceededException": {
@@ -5977,7 +6391,7 @@
         }
       },
       "traits": {
-        "smithy.api#documentation": "This exception is thrown when a request is made beyond the service quota",
+        "smithy.api#documentation": "<p>The number of requests exceeds the service quota. Resubmit your request later.</p>",
         "smithy.api#error": "client",
         "smithy.api#httpError": 402
       }
@@ -5985,7 +6399,6 @@
     "com.amazonaws.bedrockagent#SessionTTL": {
       "type": "integer",
       "traits": {
-        "smithy.api#documentation": "Max Session Time.",
         "smithy.api#range": {
           "min": 60,
           "max": 3600
@@ -6007,9 +6420,6 @@
             "smithy.api#enumValue": "DESCENDING"
           }
         }
-      },
-      "traits": {
-        "smithy.api#documentation": "Order to sort results by."
       }
     },
     "com.amazonaws.bedrockagent#StartIngestionJob": {
@@ -6044,7 +6454,7 @@
         }
       ],
       "traits": {
-        "smithy.api#documentation": "Start a new ingestion job",
+        "smithy.api#documentation": "<p>Begins an ingestion job, in which a data source is added to a knowledge base.</p>",
         "smithy.api#http": {
           "code": 202,
           "method": "PUT",
@@ -6060,6 +6470,7 @@
         "knowledgeBaseId": {
           "target": "com.amazonaws.bedrockagent#Id",
           "traits": {
+            "smithy.api#documentation": "<p>The unique identifier of the knowledge base to which to add the data source.</p>",
             "smithy.api#httpLabel": {},
             "smithy.api#required": {}
           }
@@ -6067,6 +6478,7 @@
         "dataSourceId": {
           "target": "com.amazonaws.bedrockagent#Id",
           "traits": {
+            "smithy.api#documentation": "<p>The unique identifier of the data source to ingest.</p>",
             "smithy.api#httpLabel": {},
             "smithy.api#required": {}
           }
@@ -6074,11 +6486,15 @@
         "clientToken": {
           "target": "com.amazonaws.bedrockagent#ClientToken",
           "traits": {
+            "smithy.api#documentation": "<p>A unique, case-sensitive identifier to ensure that the API request completes no more than one time. If this token matches a previous request,\n      Amazon Bedrock ignores the request, but does not return an error. For more information, see <a href=\"https://docs.aws.amazon.com/AWSEC2/latest/APIReference/Run_Instance_Idempotency.html\">Ensuring idempotency</a>.</p>",
             "smithy.api#idempotencyToken": {}
           }
         },
         "description": {
-          "target": "com.amazonaws.bedrockagent#Description"
+          "target": "com.amazonaws.bedrockagent#Description",
+          "traits": {
+            "smithy.api#documentation": "<p>A description of the ingestion job.</p>"
+          }
         }
       },
       "traits": {
@@ -6091,6 +6507,7 @@
         "ingestionJob": {
           "target": "com.amazonaws.bedrockagent#IngestionJob",
           "traits": {
+            "smithy.api#documentation": "<p>An object containing information about the ingestion job.</p>",
             "smithy.api#required": {}
           }
         }
@@ -6105,7 +6522,6 @@
         "target": "smithy.api#String"
       },
       "traits": {
-        "smithy.api#documentation": "List of stop sequences",
         "smithy.api#length": {
           "min": 0,
           "max": 4
@@ -6118,30 +6534,42 @@
         "type": {
           "target": "com.amazonaws.bedrockagent#KnowledgeBaseStorageType",
           "traits": {
+            "smithy.api#documentation": "<p>The vector store service in which the knowledge base is stored.</p>",
             "smithy.api#required": {}
           }
         },
         "opensearchServerlessConfiguration": {
-          "target": "com.amazonaws.bedrockagent#OpenSearchServerlessConfiguration"
+          "target": "com.amazonaws.bedrockagent#OpenSearchServerlessConfiguration",
+          "traits": {
+            "smithy.api#documentation": "<p>Contains the storage configuration of the knowledge base in Amazon OpenSearch Service.</p>"
+          }
         },
         "pineconeConfiguration": {
-          "target": "com.amazonaws.bedrockagent#PineconeConfiguration"
+          "target": "com.amazonaws.bedrockagent#PineconeConfiguration",
+          "traits": {
+            "smithy.api#documentation": "<p>Contains the storage configuration of the knowledge base in Pinecone.</p>"
+          }
         },
         "redisEnterpriseCloudConfiguration": {
-          "target": "com.amazonaws.bedrockagent#RedisEnterpriseCloudConfiguration"
+          "target": "com.amazonaws.bedrockagent#RedisEnterpriseCloudConfiguration",
+          "traits": {
+            "smithy.api#documentation": "<p>Contains the storage configuration of the knowledge base in Redis Enterprise Cloud.</p>"
+          }
         },
         "rdsConfiguration": {
-          "target": "com.amazonaws.bedrockagent#RdsConfiguration"
+          "target": "com.amazonaws.bedrockagent#RdsConfiguration",
+          "traits": {
+            "smithy.api#documentation": "<p>Contains details about the storage configuration of the knowledge base in Amazon RDS. For more information, see <a href=\"https://docs.aws.amazon.com/bedrock/latest/userguide/knowledge-base-setup-rds.html\">Create a vector index in Amazon RDS</a>.</p>"
+          }
         }
       },
       "traits": {
-        "smithy.api#documentation": "Configures the physical storage of ingested data in a knowledge base."
+        "smithy.api#documentation": "<p>Contains the storage configuration of the knowledge base.</p>"
       }
     },
     "com.amazonaws.bedrockagent#TagKey": {
       "type": "string",
       "traits": {
-        "smithy.api#documentation": "Key of a tag",
         "smithy.api#length": {
           "min": 1,
           "max": 128
@@ -6155,7 +6583,6 @@
         "target": "com.amazonaws.bedrockagent#TagKey"
       },
       "traits": {
-        "smithy.api#documentation": "List of Tag Keys",
         "smithy.api#length": {
           "min": 0,
           "max": 200
@@ -6191,7 +6618,7 @@
         }
       ],
       "traits": {
-        "smithy.api#documentation": "Tag a resource",
+        "smithy.api#documentation": "<p>Associate tags with a resource. For more information, see  <a href=\"https://docs.aws.amazon.com/bedrock/latest/userguide/what-is-service.html\">Tagging resources</a> in the Amazon Bedrock User Guide.</p>",
         "smithy.api#http": {
           "code": 200,
           "method": "POST",
@@ -6205,6 +6632,7 @@
         "resourceArn": {
           "target": "com.amazonaws.bedrockagent#TaggableResourcesArn",
           "traits": {
+            "smithy.api#documentation": "<p>The ARN of the resource to tag.</p>",
             "smithy.api#httpLabel": {},
             "smithy.api#required": {}
           }
@@ -6212,6 +6640,7 @@
         "tags": {
           "target": "com.amazonaws.bedrockagent#TagsMap",
           "traits": {
+            "smithy.api#documentation": "<p>An object containing key-value pairs that define the tags to attach to the resource.</p>",
             "smithy.api#required": {}
           }
         }
@@ -6230,7 +6659,6 @@
     "com.amazonaws.bedrockagent#TagValue": {
       "type": "string",
       "traits": {
-        "smithy.api#documentation": "Value of a tag",
         "smithy.api#length": {
           "min": 0,
           "max": 256
@@ -6241,7 +6669,6 @@
     "com.amazonaws.bedrockagent#TaggableResourcesArn": {
       "type": "string",
       "traits": {
-        "smithy.api#documentation": "ARN of Taggable resources: [Agent, AgentAlias, Knowledge-Base]",
         "smithy.api#length": {
           "min": 20,
           "max": 1011
@@ -6270,15 +6697,11 @@
       },
       "value": {
         "target": "com.amazonaws.bedrockagent#TagValue"
-      },
-      "traits": {
-        "smithy.api#documentation": "A map of tag keys and values"
       }
     },
     "com.amazonaws.bedrockagent#Temperature": {
       "type": "float",
       "traits": {
-        "smithy.api#documentation": "Controls randomness, higher values increase diversity",
         "smithy.api#range": {
           "min": 0,
           "max": 1
@@ -6293,7 +6716,7 @@
         }
       },
       "traits": {
-        "smithy.api#documentation": "This exception is thrown when the number of requests exceeds the limit",
+        "smithy.api#documentation": "<p>The number of requests exceeds the limit. Resubmit your request later.</p>",
         "smithy.api#error": "client",
         "smithy.api#httpError": 429
       }
@@ -6301,7 +6724,6 @@
     "com.amazonaws.bedrockagent#TopK": {
       "type": "integer",
       "traits": {
-        "smithy.api#documentation": "Sample from the k most likely next tokens",
         "smithy.api#range": {
           "min": 0,
           "max": 500
@@ -6311,7 +6733,6 @@
     "com.amazonaws.bedrockagent#TopP": {
       "type": "float",
       "traits": {
-        "smithy.api#documentation": "Cumulative probability cutoff for token selection",
         "smithy.api#range": {
           "min": 0,
           "max": 1
@@ -6344,7 +6765,7 @@
         }
       ],
       "traits": {
-        "smithy.api#documentation": "Untag a resource",
+        "smithy.api#documentation": "<p>Remove tags from a resource.</p>",
         "smithy.api#http": {
           "code": 200,
           "method": "DELETE",
@@ -6359,6 +6780,7 @@
         "resourceArn": {
           "target": "com.amazonaws.bedrockagent#TaggableResourcesArn",
           "traits": {
+            "smithy.api#documentation": "<p>The ARN of the resource from which to remove tags.</p>",
             "smithy.api#httpLabel": {},
             "smithy.api#required": {}
           }
@@ -6366,6 +6788,7 @@
         "tagKeys": {
           "target": "com.amazonaws.bedrockagent#TagKeyList",
           "traits": {
+            "smithy.api#documentation": "<p>A list of keys of the tags to remove from the resource.</p>",
             "smithy.api#httpQuery": "tagKeys",
             "smithy.api#required": {}
           }
@@ -6414,7 +6837,7 @@
         }
       ],
       "traits": {
-        "smithy.api#documentation": "Updates an existing Amazon Bedrock Agent",
+        "smithy.api#documentation": "<p>Updates the configuration of an agent.</p>",
         "smithy.api#http": {
           "code": 202,
           "method": "PUT",
@@ -6456,7 +6879,7 @@
         }
       ],
       "traits": {
-        "smithy.api#documentation": "Updates an existing Action Group for Amazon Bedrock Agent",
+        "smithy.api#documentation": "<p>Updates the configuration for an action group for an agent.</p>",
         "smithy.api#http": {
           "code": 200,
           "method": "PUT",
@@ -6472,7 +6895,7 @@
         "agentId": {
           "target": "com.amazonaws.bedrockagent#Id",
           "traits": {
-            "smithy.api#documentation": "Id generated at the server side when an Agent is created",
+            "smithy.api#documentation": "<p>The unique identifier of the agent for which to update the action group.</p>",
             "smithy.api#httpLabel": {},
             "smithy.api#required": {}
           }
@@ -6480,7 +6903,7 @@
         "agentVersion": {
           "target": "com.amazonaws.bedrockagent#DraftVersion",
           "traits": {
-            "smithy.api#documentation": "Draft Version of the Agent.",
+            "smithy.api#documentation": "<p>The unique identifier of the agent version for which to update the action group.</p>",
             "smithy.api#httpLabel": {},
             "smithy.api#required": {}
           }
@@ -6488,7 +6911,7 @@
         "actionGroupId": {
           "target": "com.amazonaws.bedrockagent#Id",
           "traits": {
-            "smithy.api#documentation": "Id generated at the server side when an Action Group is created under Agent",
+            "smithy.api#documentation": "<p>The unique identifier of the action group.</p>",
             "smithy.api#httpLabel": {},
             "smithy.api#required": {}
           }
@@ -6496,27 +6919,42 @@
         "actionGroupName": {
           "target": "com.amazonaws.bedrockagent#Name",
           "traits": {
+            "smithy.api#documentation": "<p>Specifies a new name for the action group.</p>",
             "smithy.api#required": {}
           }
         },
         "description": {
-          "target": "com.amazonaws.bedrockagent#Description"
+          "target": "com.amazonaws.bedrockagent#Description",
+          "traits": {
+            "smithy.api#documentation": "<p>Specifies a new name for the action group.</p>"
+          }
         },
         "parentActionGroupSignature": {
-          "target": "com.amazonaws.bedrockagent#ActionGroupSignature"
+          "target": "com.amazonaws.bedrockagent#ActionGroupSignature",
+          "traits": {
+            "smithy.api#documentation": "<p>To allow your agent to request the user for additional information when trying to complete a task, set this field to <code>AMAZON.UserInput</code>. You must leave the <code>description</code>, <code>apiSchema</code>, and <code>actionGroupExecutor</code> fields blank for this action group.</p>\n         <p>During orchestration, if your agent determines that it needs to invoke an API in an action group, but doesn't have enough information to complete the API request, it will invoke this action group instead and return an <a href=\"https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_Observation.html\">Observation</a> reprompting the user for more information.</p>"
+          }
         },
         "actionGroupExecutor": {
-          "target": "com.amazonaws.bedrockagent#ActionGroupExecutor"
+          "target": "com.amazonaws.bedrockagent#ActionGroupExecutor",
+          "traits": {
+            "smithy.api#documentation": "<p>The ARN of the Lambda function containing the business logic that is carried out upon invoking the action.</p>"
+          }
         },
         "actionGroupState": {
-          "target": "com.amazonaws.bedrockagent#ActionGroupState"
+          "target": "com.amazonaws.bedrockagent#ActionGroupState",
+          "traits": {
+            "smithy.api#documentation": "<p>Specifies whether the action group is available for the agent to invoke or not when sending an <a href=\"https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvokeAgent.html\">InvokeAgent</a> request.</p>"
+          }
         },
         "apiSchema": {
-          "target": "com.amazonaws.bedrockagent#APISchema"
+          "target": "com.amazonaws.bedrockagent#APISchema",
+          "traits": {
+            "smithy.api#documentation": "<p>Contains either details about the S3 object containing the OpenAPI schema for the action group or the JSON or YAML-formatted payload defining the schema. For more information, see <a href=\"https://docs.aws.amazon.com/bedrock/latest/userguide/agents-api-schema.html\">Action group OpenAPI schemas</a>.</p>"
+          }
         }
       },
       "traits": {
-        "smithy.api#documentation": "Update Action Group Request",
         "smithy.api#input": {}
       }
     },
@@ -6526,12 +6964,12 @@
         "agentActionGroup": {
           "target": "com.amazonaws.bedrockagent#AgentActionGroup",
           "traits": {
+            "smithy.api#documentation": "<p>Contains details about the action group that was updated.</p>",
             "smithy.api#required": {}
           }
         }
       },
       "traits": {
-        "smithy.api#documentation": "Update Action Group Response",
         "smithy.api#output": {}
       }
     },
@@ -6567,7 +7005,7 @@
         }
       ],
       "traits": {
-        "smithy.api#documentation": "Updates an existing Alias for an Amazon Bedrock Agent",
+        "smithy.api#documentation": "<p>Updates configurations for an alias of an agent.</p>",
         "smithy.api#http": {
           "code": 202,
           "method": "PUT",
@@ -6583,7 +7021,7 @@
         "agentId": {
           "target": "com.amazonaws.bedrockagent#Id",
           "traits": {
-            "smithy.api#documentation": "Id generated at the server side when an Agent is created",
+            "smithy.api#documentation": "<p>The unique identifier of the agent.</p>",
             "smithy.api#httpLabel": {},
             "smithy.api#required": {}
           }
@@ -6591,7 +7029,7 @@
         "agentAliasId": {
           "target": "com.amazonaws.bedrockagent#AgentAliasId",
           "traits": {
-            "smithy.api#documentation": "Id generated at the server side when an Agent Alias is created",
+            "smithy.api#documentation": "<p>The unique identifier of the alias.</p>",
             "smithy.api#httpLabel": {},
             "smithy.api#required": {}
           }
@@ -6599,18 +7037,24 @@
         "agentAliasName": {
           "target": "com.amazonaws.bedrockagent#Name",
           "traits": {
+            "smithy.api#documentation": "<p>Specifies a new name for the alias.</p>",
             "smithy.api#required": {}
           }
         },
         "description": {
-          "target": "com.amazonaws.bedrockagent#Description"
+          "target": "com.amazonaws.bedrockagent#Description",
+          "traits": {
+            "smithy.api#documentation": "<p>Specifies a new description for the alias.</p>"
+          }
         },
         "routingConfiguration": {
-          "target": "com.amazonaws.bedrockagent#AgentAliasRoutingConfiguration"
+          "target": "com.amazonaws.bedrockagent#AgentAliasRoutingConfiguration",
+          "traits": {
+            "smithy.api#documentation": "<p>Contains details about the routing configuration of the alias.</p>"
+          }
         }
       },
       "traits": {
-        "smithy.api#documentation": "Update Agent Alias Request",
         "smithy.api#input": {}
       }
     },
@@ -6620,12 +7064,12 @@
         "agentAlias": {
           "target": "com.amazonaws.bedrockagent#AgentAlias",
           "traits": {
+            "smithy.api#documentation": "<p>Contains details about the alias that was updated.</p>",
             "smithy.api#required": {}
           }
         }
       },
       "traits": {
-        "smithy.api#documentation": "Update Agent Alias Response",
         "smithy.api#output": {}
       }
     },
@@ -6658,7 +7102,7 @@
         }
       ],
       "traits": {
-        "smithy.api#documentation": "Updates an existing Knowledge Base associated to an Amazon Bedrock Agent",
+        "smithy.api#documentation": "<p>Updates the configuration for a knowledge base that has been associated with an agent.</p>",
         "smithy.api#http": {
           "code": 200,
           "method": "PUT",
@@ -6674,7 +7118,7 @@
         "agentId": {
           "target": "com.amazonaws.bedrockagent#Id",
           "traits": {
-            "smithy.api#documentation": "Id generated at the server side when an Agent is created",
+            "smithy.api#documentation": "<p>The unique identifier of the agent associated with the knowledge base that you want to update.</p>",
             "smithy.api#httpLabel": {},
             "smithy.api#required": {}
           }
@@ -6682,7 +7126,7 @@
         "agentVersion": {
           "target": "com.amazonaws.bedrockagent#DraftVersion",
           "traits": {
-            "smithy.api#documentation": "Draft Version of the Agent.",
+            "smithy.api#documentation": "<p>The version of the agent associated with the knowledge base that you want to update.</p>",
             "smithy.api#httpLabel": {},
             "smithy.api#required": {}
           }
@@ -6690,20 +7134,25 @@
         "knowledgeBaseId": {
           "target": "com.amazonaws.bedrockagent#Id",
           "traits": {
-            "smithy.api#documentation": "Id generated at the server side when a Knowledge Base is associated to an Agent",
+            "smithy.api#documentation": "<p>The unique identifier of the knowledge base that has been associated with an agent.</p>",
             "smithy.api#httpLabel": {},
             "smithy.api#required": {}
           }
         },
         "description": {
-          "target": "com.amazonaws.bedrockagent#Description"
+          "target": "com.amazonaws.bedrockagent#Description",
+          "traits": {
+            "smithy.api#documentation": "<p>Specifies a new description for the knowledge base associated with an agent.</p>"
+          }
         },
         "knowledgeBaseState": {
-          "target": "com.amazonaws.bedrockagent#KnowledgeBaseState"
+          "target": "com.amazonaws.bedrockagent#KnowledgeBaseState",
+          "traits": {
+            "smithy.api#documentation": "<p>Specifies whether the agent uses the knowledge base or not when sending an <a href=\"https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvokeAgent.html\">InvokeAgent</a> request.</p>"
+          }
         }
       },
       "traits": {
-        "smithy.api#documentation": "Update Agent Knowledge Base Request",
         "smithy.api#input": {}
       }
     },
@@ -6713,12 +7162,12 @@
         "agentKnowledgeBase": {
           "target": "com.amazonaws.bedrockagent#AgentKnowledgeBase",
           "traits": {
+            "smithy.api#documentation": "<p>Contains details about the knowledge base that has been associated with an agent.</p>",
             "smithy.api#required": {}
           }
         }
       },
       "traits": {
-        "smithy.api#documentation": "Update Agent Knowledge Base Response",
         "smithy.api#output": {}
       }
     },
@@ -6728,7 +7177,7 @@
         "agentId": {
           "target": "com.amazonaws.bedrockagent#Id",
           "traits": {
-            "smithy.api#documentation": "Id generated at the server side when an Agent is created",
+            "smithy.api#documentation": "<p>The unique identifier of the agent.</p>",
             "smithy.api#httpLabel": {},
             "smithy.api#required": {}
           }
@@ -6736,36 +7185,57 @@
         "agentName": {
           "target": "com.amazonaws.bedrockagent#Name",
           "traits": {
+            "smithy.api#documentation": "<p>Specifies a new name for the agent.</p>",
             "smithy.api#required": {}
           }
         },
         "instruction": {
-          "target": "com.amazonaws.bedrockagent#Instruction"
+          "target": "com.amazonaws.bedrockagent#Instruction",
+          "traits": {
+            "smithy.api#documentation": "<p>Specifies new instructions that tell the agent what it should do and how it should interact with users.</p>"
+          }
         },
         "foundationModel": {
-          "target": "com.amazonaws.bedrockagent#ModelIdentifier"
+          "target": "com.amazonaws.bedrockagent#ModelIdentifier",
+          "traits": {
+            "smithy.api#clientOptional": {},
+            "smithy.api#documentation": "<p>Specifies a new foundation model to be used for orchestration by the agent.</p>",
+            "smithy.api#required": {}
+          }
         },
         "description": {
-          "target": "com.amazonaws.bedrockagent#Description"
+          "target": "com.amazonaws.bedrockagent#Description",
+          "traits": {
+            "smithy.api#documentation": "<p>Specifies a new description of the agent.</p>"
+          }
         },
         "idleSessionTTLInSeconds": {
-          "target": "com.amazonaws.bedrockagent#SessionTTL"
+          "target": "com.amazonaws.bedrockagent#SessionTTL",
+          "traits": {
+            "smithy.api#documentation": "<p>The number of seconds for which Amazon Bedrock keeps information about a user's conversation with the agent.</p>\n         <p>A user interaction remains active for the amount of time specified. If no conversation occurs during this time, the session expires and Amazon Bedrock deletes any data provided before the timeout.</p>"
+          }
         },
         "agentResourceRoleArn": {
           "target": "com.amazonaws.bedrockagent#AgentRoleArn",
           "traits": {
+            "smithy.api#documentation": "<p>The ARN of the IAM role with permissions to update the agent. The ARN must begin with <code>AmazonBedrockExecutionRoleForAgents_</code>.</p>",
             "smithy.api#required": {}
           }
         },
         "customerEncryptionKeyArn": {
-          "target": "com.amazonaws.bedrockagent#KmsKeyArn"
+          "target": "com.amazonaws.bedrockagent#KmsKeyArn",
+          "traits": {
+            "smithy.api#documentation": "<p>The ARN of the KMS key with which to encrypt the agent.</p>"
+          }
         },
         "promptOverrideConfiguration": {
-          "target": "com.amazonaws.bedrockagent#PromptOverrideConfiguration"
+          "target": "com.amazonaws.bedrockagent#PromptOverrideConfiguration",
+          "traits": {
+            "smithy.api#documentation": "<p>Contains configurations to override prompts in different parts of an agent sequence. For more information, see <a href=\"https://docs.aws.amazon.com/bedrock/latest/userguide/advanced-prompts.html\">Advanced prompts</a>.</p>"
+          }
         }
       },
       "traits": {
-        "smithy.api#documentation": "Update Agent Request",
         "smithy.api#input": {}
       }
     },
@@ -6775,12 +7245,12 @@
         "agent": {
           "target": "com.amazonaws.bedrockagent#Agent",
           "traits": {
+            "smithy.api#documentation": "<p>Contains details about the agent that was updated.</p>",
             "smithy.api#required": {}
           }
         }
       },
       "traits": {
-        "smithy.api#documentation": "Update Agent Response",
         "smithy.api#output": {}
       }
     },
@@ -6813,7 +7283,7 @@
         }
       ],
       "traits": {
-        "smithy.api#documentation": "Update an existing data source",
+        "smithy.api#documentation": "<p>Updates configurations for a data source.</p>\n         <important>\n            <p>You can't change the <code>chunkingConfiguration</code> after you create the data source. Specify the existing <code>chunkingConfiguration</code>.</p>\n         </important>",
         "smithy.api#http": {
           "code": 200,
           "method": "PUT",
@@ -6829,6 +7299,7 @@
         "knowledgeBaseId": {
           "target": "com.amazonaws.bedrockagent#Id",
           "traits": {
+            "smithy.api#documentation": "<p>The unique identifier of the knowledge base to which the data source belongs.</p>",
             "smithy.api#httpLabel": {},
             "smithy.api#required": {}
           }
@@ -6836,6 +7307,7 @@
         "dataSourceId": {
           "target": "com.amazonaws.bedrockagent#Id",
           "traits": {
+            "smithy.api#documentation": "<p>The unique identifier of the data source.</p>",
             "smithy.api#httpLabel": {},
             "smithy.api#required": {}
           }
@@ -6843,23 +7315,34 @@
         "name": {
           "target": "com.amazonaws.bedrockagent#Name",
           "traits": {
+            "smithy.api#documentation": "<p>Specifies a new name for the data source.</p>",
             "smithy.api#required": {}
           }
         },
         "description": {
-          "target": "com.amazonaws.bedrockagent#Description"
+          "target": "com.amazonaws.bedrockagent#Description",
+          "traits": {
+            "smithy.api#documentation": "<p>Specifies a new description for the data source.</p>"
+          }
         },
         "dataSourceConfiguration": {
           "target": "com.amazonaws.bedrockagent#DataSourceConfiguration",
           "traits": {
+            "smithy.api#documentation": "<p>Contains details about the storage configuration of the data source.</p>",
             "smithy.api#required": {}
           }
         },
         "serverSideEncryptionConfiguration": {
-          "target": "com.amazonaws.bedrockagent#ServerSideEncryptionConfiguration"
+          "target": "com.amazonaws.bedrockagent#ServerSideEncryptionConfiguration",
+          "traits": {
+            "smithy.api#documentation": "<p>Contains details about server-side encryption of the data source.</p>"
+          }
         },
         "vectorIngestionConfiguration": {
-          "target": "com.amazonaws.bedrockagent#VectorIngestionConfiguration"
+          "target": "com.amazonaws.bedrockagent#VectorIngestionConfiguration",
+          "traits": {
+            "smithy.api#documentation": "<p>Contains details about how to ingest the documents in the data source.</p>"
+          }
         }
       },
       "traits": {
@@ -6872,6 +7355,7 @@
         "dataSource": {
           "target": "com.amazonaws.bedrockagent#DataSource",
           "traits": {
+            "smithy.api#documentation": "<p>Contains details about the data source.</p>",
             "smithy.api#required": {}
           }
         }
@@ -6909,7 +7393,7 @@
         }
       ],
       "traits": {
-        "smithy.api#documentation": "Update an existing knowledge base",
+        "smithy.api#documentation": "<p>Updates the configuration of a knowledge base with the fields that you specify. Because all fields will be overwritten, you must include the same values for fields that you want to keep the same.</p>\n         <p>You can change the following fields:</p>\n         <ul>\n            <li>\n               <p>\n                  <code>name</code>\n               </p>\n            </li>\n            <li>\n               <p>\n                  <code>description</code>\n               </p>\n            </li>\n            <li>\n               <p>\n                  <code>roleArn</code>\n               </p>\n            </li>\n         </ul>\n         <p>You can't change the <code>knowledgeBaseConfiguration</code> or <code>storageConfiguration</code> fields, so you must specify the same configurations as when you created the knowledge base. You can send a <a href=\"https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_GetKnowledgeBase.html\">GetKnowledgeBase</a> request and copy the same configurations.</p>",
         "smithy.api#http": {
           "code": 202,
           "method": "PUT",
@@ -6925,6 +7409,7 @@
         "knowledgeBaseId": {
           "target": "com.amazonaws.bedrockagent#Id",
           "traits": {
+            "smithy.api#documentation": "<p>The unique identifier of the knowledge base to update.</p>",
             "smithy.api#httpLabel": {},
             "smithy.api#required": {}
           }
@@ -6932,27 +7417,34 @@
         "name": {
           "target": "com.amazonaws.bedrockagent#Name",
           "traits": {
+            "smithy.api#documentation": "<p>Specifies a new name for the knowledge base.</p>",
             "smithy.api#required": {}
           }
         },
         "description": {
-          "target": "com.amazonaws.bedrockagent#Description"
+          "target": "com.amazonaws.bedrockagent#Description",
+          "traits": {
+            "smithy.api#documentation": "<p>Specifies a new description for the knowledge base.</p>"
+          }
         },
         "roleArn": {
           "target": "com.amazonaws.bedrockagent#KnowledgeBaseRoleArn",
           "traits": {
+            "smithy.api#documentation": "<p>Specifies a different Amazon Resource Name (ARN) of the IAM role with permissions to modify the knowledge base.</p>",
             "smithy.api#required": {}
           }
         },
         "knowledgeBaseConfiguration": {
           "target": "com.amazonaws.bedrockagent#KnowledgeBaseConfiguration",
           "traits": {
+            "smithy.api#documentation": "<p>Specifies the configuration for the embeddings model used for the knowledge base. You must use the same configuration as when the knowledge base was created.</p>",
             "smithy.api#required": {}
           }
         },
         "storageConfiguration": {
           "target": "com.amazonaws.bedrockagent#StorageConfiguration",
           "traits": {
+            "smithy.api#documentation": "<p>Specifies the configuration for the vector store used for the knowledge base. You must use the same configuration as when the knowledge base was created.</p>",
             "smithy.api#required": {}
           }
         }
@@ -6967,6 +7459,7 @@
         "knowledgeBase": {
           "target": "com.amazonaws.bedrockagent#KnowledgeBase",
           "traits": {
+            "smithy.api#documentation": "<p>Contains details about the knowledge base.</p>",
             "smithy.api#required": {}
           }
         }
@@ -6982,11 +7475,14 @@
           "target": "com.amazonaws.bedrockagent#NonBlankString"
         },
         "fieldList": {
-          "target": "com.amazonaws.bedrockagent#ValidationExceptionFieldList"
+          "target": "com.amazonaws.bedrockagent#ValidationExceptionFieldList",
+          "traits": {
+            "smithy.api#documentation": "<p>A list of objects containing fields that caused validation errors and their corresponding validation error messages.</p>"
+          }
         }
       },
       "traits": {
-        "smithy.api#documentation": "This exception is thrown when the request's input validation fails",
+        "smithy.api#documentation": "<p>Input validation failed. Check your request parameters and retry the request.</p>",
         "smithy.api#error": "client",
         "smithy.api#httpError": 400
       }
@@ -6997,38 +7493,40 @@
         "name": {
           "target": "com.amazonaws.bedrockagent#NonBlankString",
           "traits": {
+            "smithy.api#documentation": "<p>The name of the field.</p>",
             "smithy.api#required": {}
           }
         },
         "message": {
           "target": "com.amazonaws.bedrockagent#NonBlankString",
           "traits": {
+            "smithy.api#documentation": "<p>A message describing why this field failed validation.</p>",
             "smithy.api#required": {}
           }
         }
       },
       "traits": {
-        "smithy.api#documentation": "Stores information about a field passed inside a request that resulted in an exception"
+        "smithy.api#documentation": "<p>Stores information about a field passed inside a request that resulted in an validation error.</p>"
       }
     },
     "com.amazonaws.bedrockagent#ValidationExceptionFieldList": {
       "type": "list",
       "member": {
         "target": "com.amazonaws.bedrockagent#ValidationExceptionField"
-      },
-      "traits": {
-        "smithy.api#documentation": "list of ValidationExceptionField"
       }
     },
     "com.amazonaws.bedrockagent#VectorIngestionConfiguration": {
       "type": "structure",
       "members": {
         "chunkingConfiguration": {
-          "target": "com.amazonaws.bedrockagent#ChunkingConfiguration"
+          "target": "com.amazonaws.bedrockagent#ChunkingConfiguration",
+          "traits": {
+            "smithy.api#documentation": "<p>Details about how to chunk the documents in the data source. A <i>chunk</i> refers to an excerpt from a data source that is returned when the knowledge base that it belongs to is queried.</p>"
+          }
         }
       },
       "traits": {
-        "smithy.api#documentation": "Configures ingestion for a vector knowledge base"
+        "smithy.api#documentation": "<p>Contains details about how to ingest the documents in a data source.</p>"
       }
     },
     "com.amazonaws.bedrockagent#VectorKnowledgeBaseConfiguration": {
@@ -7037,18 +7535,18 @@
         "embeddingModelArn": {
           "target": "com.amazonaws.bedrockagent#BedrockEmbeddingModelArn",
           "traits": {
+            "smithy.api#documentation": "<p>The ARN of the model used to create vector embeddings for the knowledge base.</p>",
             "smithy.api#required": {}
           }
         }
       },
       "traits": {
-        "smithy.api#documentation": "Configurations for a vector knowledge base."
+        "smithy.api#documentation": "<p>Contains details about the model used to create vector embeddings for the knowledge base.</p>"
       }
     },
     "com.amazonaws.bedrockagent#Version": {
       "type": "string",
       "traits": {
-        "smithy.api#documentation": "Agent Version.",
         "smithy.api#length": {
           "min": 1,
           "max": 5