@aws-sdk/client-bedrock-agent-runtime 3.1110.0 → 3.1112.0

package/dist-types/models/models_1.d.ts

@@ -1,5 +1,576 @@
-import type { AgentCollaboration, ImageFormat, OrchestrationType, RerankingModelType, RetrieveAndGenerateType, SearchType, SessionStatus } from "./enums";
-import type { AgentActionGroup, AgenticRetrieveConfiguration, AgenticRetrieveMessage, AgenticRetrievePolicyConfiguration, BedrockModelConfigurations, CollaboratorConfiguration, ConversationHistory, CustomOrchestration, ExternalSourcesRetrieveAndGenerateConfiguration, FilterAttribute, GenerationConfiguration, GuardrailConfiguration, GuardrailConfigurationWithArn, ImplicitFilterConfiguration, InlineBedrockModelConfigurations, InlineSessionState, InputFile, InvocationResultMember, KnowledgeBaseQuery, ManagedSearchRerankingConfiguration, OrchestrationConfiguration, PromptCreationConfigurations, PromptOverrideConfiguration, RetrieveAndGenerateInput, RetrieveAndGenerateSessionConfiguration, StreamingConfigurations, UserContext, VectorSearchRerankingConfiguration } from "./models_0";
+import type { DocumentType as __DocumentType } from "@smithy/types";
+import type { AgentCollaboration, GuadrailAction, ImageFormat, InputImageFormat, KnowledgeBaseQueryType, OrchestrationType, RerankingModelType, RetrieveAndGenerateType, SearchType, SessionStatus } from "./enums";
+import type { AccessDeniedException, BadGatewayException, ConflictException, DependencyFailedException, InternalServerException, ResourceNotFoundException, ServiceQuotaExceededException, ThrottlingException, ValidationException } from "./errors";
+import type { AgentActionGroup, AgenticRetrieveConfiguration, AgenticRetrieveMemoryConfiguration, AgenticRetrieveMessage, AgenticRetrievePolicyConfiguration, BedrockModelConfigurations, CitationEvent, CollaboratorConfiguration, ConversationHistory, CustomOrchestration, ExternalSourcesRetrieveAndGenerateConfiguration, FilterAttribute, GenerationConfiguration, GuardrailConfiguration, GuardrailConfigurationWithArn, GuardrailEvent, ImplicitFilterConfiguration, InlineBedrockModelConfigurations, InlineSessionState, InputFile, InvocationResultMember, ManagedSearchRerankingConfiguration, OrchestrationConfiguration, PromptCreationConfigurations, PromptOverrideConfiguration, RetrievalResultContent, RetrievalResultLocation, RetrieveAndGenerateInput, RetrieveAndGenerateSessionConfiguration, StreamingConfigurations, UserContext, VectorSearchRerankingConfiguration } from "./models_0";
+/**
+ * <p>A retrieve and generate output event.</p>
+ * @public
+ */
+export interface RetrieveAndGenerateOutputEvent {
+    /**
+     * <p>A text response.</p>
+     * @public
+     */
+    text: string | undefined;
+}
+/**
+ * <p>A retrieve and generate stream response output.</p>
+ * @public
+ */
+export type RetrieveAndGenerateStreamResponseOutput = RetrieveAndGenerateStreamResponseOutput.AccessDeniedExceptionMember | RetrieveAndGenerateStreamResponseOutput.BadGatewayExceptionMember | RetrieveAndGenerateStreamResponseOutput.CitationMember | RetrieveAndGenerateStreamResponseOutput.ConflictExceptionMember | RetrieveAndGenerateStreamResponseOutput.DependencyFailedExceptionMember | RetrieveAndGenerateStreamResponseOutput.GuardrailMember | RetrieveAndGenerateStreamResponseOutput.InternalServerExceptionMember | RetrieveAndGenerateStreamResponseOutput.OutputMember | RetrieveAndGenerateStreamResponseOutput.ResourceNotFoundExceptionMember | RetrieveAndGenerateStreamResponseOutput.ServiceQuotaExceededExceptionMember | RetrieveAndGenerateStreamResponseOutput.ThrottlingExceptionMember | RetrieveAndGenerateStreamResponseOutput.ValidationExceptionMember | RetrieveAndGenerateStreamResponseOutput.$UnknownMember;
+/**
+ * @public
+ */
+export declare namespace RetrieveAndGenerateStreamResponseOutput {
+    /**
+     * <p>An output event.</p>
+     * @public
+     */
+    interface OutputMember {
+        output: RetrieveAndGenerateOutputEvent;
+        citation?: never;
+        guardrail?: never;
+        internalServerException?: never;
+        validationException?: never;
+        resourceNotFoundException?: never;
+        serviceQuotaExceededException?: never;
+        throttlingException?: never;
+        accessDeniedException?: never;
+        conflictException?: never;
+        dependencyFailedException?: never;
+        badGatewayException?: never;
+        $unknown?: never;
+    }
+    /**
+     * <p>A citation event.</p>
+     * @public
+     */
+    interface CitationMember {
+        output?: never;
+        citation: CitationEvent;
+        guardrail?: never;
+        internalServerException?: never;
+        validationException?: never;
+        resourceNotFoundException?: never;
+        serviceQuotaExceededException?: never;
+        throttlingException?: never;
+        accessDeniedException?: never;
+        conflictException?: never;
+        dependencyFailedException?: never;
+        badGatewayException?: never;
+        $unknown?: never;
+    }
+    /**
+     * <p>A guardrail event.</p>
+     * @public
+     */
+    interface GuardrailMember {
+        output?: never;
+        citation?: never;
+        guardrail: GuardrailEvent;
+        internalServerException?: never;
+        validationException?: never;
+        resourceNotFoundException?: never;
+        serviceQuotaExceededException?: never;
+        throttlingException?: never;
+        accessDeniedException?: never;
+        conflictException?: never;
+        dependencyFailedException?: never;
+        badGatewayException?: never;
+        $unknown?: never;
+    }
+    /**
+     * <p>An internal server error occurred. Retry your request.</p>
+     * @public
+     */
+    interface InternalServerExceptionMember {
+        output?: never;
+        citation?: never;
+        guardrail?: never;
+        internalServerException: InternalServerException;
+        validationException?: never;
+        resourceNotFoundException?: never;
+        serviceQuotaExceededException?: never;
+        throttlingException?: never;
+        accessDeniedException?: never;
+        conflictException?: never;
+        dependencyFailedException?: never;
+        badGatewayException?: never;
+        $unknown?: never;
+    }
+    /**
+     * <p>The input fails to satisfy the constraints specified by <i>Amazon Bedrock</i>. For troubleshooting this error, see <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/troubleshooting-api-error-codes.html#ts-validation-error">ValidationError</a> in the Amazon Bedrock User Guide.</p>
+     * @public
+     */
+    interface ValidationExceptionMember {
+        output?: never;
+        citation?: never;
+        guardrail?: never;
+        internalServerException?: never;
+        validationException: ValidationException;
+        resourceNotFoundException?: never;
+        serviceQuotaExceededException?: never;
+        throttlingException?: never;
+        accessDeniedException?: never;
+        conflictException?: never;
+        dependencyFailedException?: never;
+        badGatewayException?: never;
+        $unknown?: never;
+    }
+    /**
+     * <p>The specified resource ARN was not found. For troubleshooting this error, see <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/troubleshooting-api-error-codes.html#ts-resource-not-found">ResourceNotFound</a> in the Amazon Bedrock User Guide.</p>
+     * @public
+     */
+    interface ResourceNotFoundExceptionMember {
+        output?: never;
+        citation?: never;
+        guardrail?: never;
+        internalServerException?: never;
+        validationException?: never;
+        resourceNotFoundException: ResourceNotFoundException;
+        serviceQuotaExceededException?: never;
+        throttlingException?: never;
+        accessDeniedException?: never;
+        conflictException?: never;
+        dependencyFailedException?: never;
+        badGatewayException?: never;
+        $unknown?: never;
+    }
+    /**
+     * <p>Your request exceeds the service quota for your account. You can view your quotas at <a href="https://docs.aws.amazon.com/servicequotas/latest/userguide/gs-request-quota.html">Viewing service quotas</a>. You can resubmit your request later.</p>
+     * @public
+     */
+    interface ServiceQuotaExceededExceptionMember {
+        output?: never;
+        citation?: never;
+        guardrail?: never;
+        internalServerException?: never;
+        validationException?: never;
+        resourceNotFoundException?: never;
+        serviceQuotaExceededException: ServiceQuotaExceededException;
+        throttlingException?: never;
+        accessDeniedException?: never;
+        conflictException?: never;
+        dependencyFailedException?: never;
+        badGatewayException?: never;
+        $unknown?: never;
+    }
+    /**
+     * <p>Your request was denied due to exceeding the account quotas for <i>Amazon Bedrock</i>. For troubleshooting this error, see <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/troubleshooting-api-error-codes.html#ts-throttling-exception">ThrottlingException</a> in the Amazon Bedrock User Guide.</p>
+     * @public
+     */
+    interface ThrottlingExceptionMember {
+        output?: never;
+        citation?: never;
+        guardrail?: never;
+        internalServerException?: never;
+        validationException?: never;
+        resourceNotFoundException?: never;
+        serviceQuotaExceededException?: never;
+        throttlingException: ThrottlingException;
+        accessDeniedException?: never;
+        conflictException?: never;
+        dependencyFailedException?: never;
+        badGatewayException?: never;
+        $unknown?: never;
+    }
+    /**
+     * <p>The request is denied because you do not have sufficient permissions to perform the requested action. For troubleshooting this error, see <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/troubleshooting-api-error-codes.html#ts-access-denied">AccessDeniedException</a> in the Amazon Bedrock User Guide.</p>
+     * @public
+     */
+    interface AccessDeniedExceptionMember {
+        output?: never;
+        citation?: never;
+        guardrail?: never;
+        internalServerException?: never;
+        validationException?: never;
+        resourceNotFoundException?: never;
+        serviceQuotaExceededException?: never;
+        throttlingException?: never;
+        accessDeniedException: AccessDeniedException;
+        conflictException?: never;
+        dependencyFailedException?: never;
+        badGatewayException?: never;
+        $unknown?: never;
+    }
+    /**
+     * <p>Error occurred because of a conflict while performing an operation.</p>
+     * @public
+     */
+    interface ConflictExceptionMember {
+        output?: never;
+        citation?: never;
+        guardrail?: never;
+        internalServerException?: never;
+        validationException?: never;
+        resourceNotFoundException?: never;
+        serviceQuotaExceededException?: never;
+        throttlingException?: never;
+        accessDeniedException?: never;
+        conflictException: ConflictException;
+        dependencyFailedException?: never;
+        badGatewayException?: never;
+        $unknown?: never;
+    }
+    /**
+     * <p>The request failed due to a dependency error.</p>
+     * @public
+     */
+    interface DependencyFailedExceptionMember {
+        output?: never;
+        citation?: never;
+        guardrail?: never;
+        internalServerException?: never;
+        validationException?: never;
+        resourceNotFoundException?: never;
+        serviceQuotaExceededException?: never;
+        throttlingException?: never;
+        accessDeniedException?: never;
+        conflictException?: never;
+        dependencyFailedException: DependencyFailedException;
+        badGatewayException?: never;
+        $unknown?: never;
+    }
+    /**
+     * <p>The request failed due to a bad gateway error.</p>
+     * @public
+     */
+    interface BadGatewayExceptionMember {
+        output?: never;
+        citation?: never;
+        guardrail?: never;
+        internalServerException?: never;
+        validationException?: never;
+        resourceNotFoundException?: never;
+        serviceQuotaExceededException?: never;
+        throttlingException?: never;
+        accessDeniedException?: never;
+        conflictException?: never;
+        dependencyFailedException?: never;
+        badGatewayException: BadGatewayException;
+        $unknown?: never;
+    }
+    /**
+     * @public
+     */
+    interface $UnknownMember {
+        output?: never;
+        citation?: never;
+        guardrail?: never;
+        internalServerException?: never;
+        validationException?: never;
+        resourceNotFoundException?: never;
+        serviceQuotaExceededException?: never;
+        throttlingException?: never;
+        accessDeniedException?: never;
+        conflictException?: never;
+        dependencyFailedException?: never;
+        badGatewayException?: never;
+        $unknown: [string, any];
+    }
+    /**
+     * @deprecated unused in schema-serde mode.
+     *
+     */
+    interface Visitor<T> {
+        output: (value: RetrieveAndGenerateOutputEvent) => T;
+        citation: (value: CitationEvent) => T;
+        guardrail: (value: GuardrailEvent) => T;
+        internalServerException: (value: InternalServerException) => T;
+        validationException: (value: ValidationException) => T;
+        resourceNotFoundException: (value: ResourceNotFoundException) => T;
+        serviceQuotaExceededException: (value: ServiceQuotaExceededException) => T;
+        throttlingException: (value: ThrottlingException) => T;
+        accessDeniedException: (value: AccessDeniedException) => T;
+        conflictException: (value: ConflictException) => T;
+        dependencyFailedException: (value: DependencyFailedException) => T;
+        badGatewayException: (value: BadGatewayException) => T;
+        _: (name: string, value: any) => T;
+    }
+}
+/**
+ * @public
+ */
+export interface RetrieveAndGenerateStreamResponse {
+    /**
+     * <p>A stream of events from the model.</p>
+     * @public
+     */
+    stream: AsyncIterable<RetrieveAndGenerateStreamResponseOutput> | undefined;
+    /**
+     * <p>The session ID.</p>
+     * @public
+     */
+    sessionId: string | undefined;
+}
+/**
+ * <p>Contains the image data for multimodal knowledge base queries, including format and content.</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-runtime_Retrieve.html#API_agent-runtime_Retrieve_RequestSyntax">Retrieve request</a> – in the <code>image</code> field</p> </li> </ul>
+ * @public
+ */
+export interface InputImage {
+    /**
+     * <p>The format of the input image. Supported formats include png, gif, jpeg, and webp.</p>
+     * @public
+     */
+    format: InputImageFormat | undefined;
+    /**
+     * <p>The base64-encoded image data for inline image content. Maximum size is 5MB.</p>
+     * @public
+     */
+    inlineContent: Uint8Array | undefined;
+}
+/**
+ * <p>Contains the query made to the 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-runtime_Retrieve.html#API_agent-runtime_Retrieve_RequestSyntax">Retrieve request</a> – in the <code>retrievalQuery</code> field</p> </li> </ul>
+ * @public
+ */
+export interface KnowledgeBaseQuery {
+    /**
+     * <p>The type of query being performed.</p>
+     * @public
+     */
+    type?: KnowledgeBaseQueryType | undefined;
+    /**
+     * <p>The text of the query made to the knowledge base.</p>
+     * @public
+     */
+    text?: string | undefined;
+    /**
+     * <p>An image to include in the knowledge base query for multimodal retrieval.</p>
+     * @public
+     */
+    image?: InputImage | undefined;
+}
+/**
+ * <p>Details about a result from querying the 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-runtime_Retrieve.html#API_agent-runtime_Retrieve_ResponseSyntax">Retrieve response</a> – in the <code>retrievalResults</code> field</p> </li> </ul>
+ * @public
+ */
+export interface KnowledgeBaseRetrievalResult {
+    /**
+     * <p>Contains information about the content of the chunk.</p>
+     * @public
+     */
+    content: RetrievalResultContent | undefined;
+    /**
+     * <p>Contains information about the location of the data source.</p>
+     * @public
+     */
+    location?: RetrievalResultLocation | undefined;
+    /**
+     * <p>The level of relevance of the result to the query.</p>
+     * @public
+     */
+    score?: number | undefined;
+    /**
+     * <p>Contains metadata attributes and their values for the file in the data source. For more information, see <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/knowledge-base-ds.html#kb-ds-metadata">Metadata and filtering</a>.</p>
+     * @public
+     */
+    metadata?: Record<string, __DocumentType> | undefined;
+    /**
+     * <p>The unique identifier of the document. Use with <code>GetDocumentContent</code> to retrieve the full document.</p>
+     * @public
+     */
+    documentId?: string | undefined;
+}
+/**
+ * @public
+ */
+export interface RetrieveResponse {
+    /**
+     * <p>A list of results from querying the knowledge base.</p>
+     * @public
+     */
+    retrievalResults: KnowledgeBaseRetrievalResult[] | undefined;
+    /**
+     * <p>Specifies if there is a guardrail intervention in the response.</p>
+     * @public
+     */
+    guardrailAction?: GuadrailAction | undefined;
+    /**
+     * <p>If there are more results than can fit in the response, the response returns a <code>nextToken</code>. Use this token in the <code>nextToken</code> field of another request to retrieve the next batch of results.</p>
+     * @public
+     */
+    nextToken?: string | undefined;
+}
+/**
+ * @public
+ */
+export interface CreateSessionRequest {
+    /**
+     * <p>A map of key-value pairs containing attributes to be persisted across the session. For example, the user's ID, their language preference, and the type of device they are using.</p>
+     * @public
+     */
+    sessionMetadata?: Record<string, string> | undefined;
+    /**
+     * <p>The Amazon Resource Name (ARN) of the KMS key to use to encrypt the session data. The user or role creating the session must have permission to use the key. For more information, see <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/session-encryption.html">Amazon Bedrock session encryption</a>. </p>
+     * @public
+     */
+    encryptionKeyArn?: string | undefined;
+    /**
+     * <p>Specify the key-value pairs for the tags that you want to attach to the session.</p>
+     * @public
+     */
+    tags?: Record<string, string> | undefined;
+}
+/**
+ * @public
+ */
+export interface CreateSessionResponse {
+    /**
+     * <p>The unique identifier for the session.</p>
+     * @public
+     */
+    sessionId: string | undefined;
+    /**
+     * <p>The Amazon Resource Name (ARN) of the created session.</p>
+     * @public
+     */
+    sessionArn: string | undefined;
+    /**
+     * <p>The current status of the session.</p>
+     * @public
+     */
+    sessionStatus: SessionStatus | undefined;
+    /**
+     * <p>The timestamp for when the session was created.</p>
+     * @public
+     */
+    createdAt: Date | undefined;
+}
+/**
+ * @public
+ */
+export interface DeleteSessionRequest {
+    /**
+     * <p>The unique identifier for the session to be deleted. You can specify either the session's <code>sessionId</code> or its Amazon Resource Name (ARN).</p>
+     * @public
+     */
+    sessionIdentifier: string | undefined;
+}
+/**
+ * @public
+ */
+export interface DeleteSessionResponse {
+}
+/**
+ * @public
+ */
+export interface EndSessionRequest {
+    /**
+     * <p>The unique identifier for the session to end. You can specify either the session's <code>sessionId</code> or its Amazon Resource Name (ARN).</p>
+     * @public
+     */
+    sessionIdentifier: string | undefined;
+}
+/**
+ * @public
+ */
+export interface EndSessionResponse {
+    /**
+     * <p>The unique identifier of the session you ended.</p>
+     * @public
+     */
+    sessionId: string | undefined;
+    /**
+     * <p>The Amazon Resource Name (ARN) of the session you ended.</p>
+     * @public
+     */
+    sessionArn: string | undefined;
+    /**
+     * <p>The current status of the session you ended.</p>
+     * @public
+     */
+    sessionStatus: SessionStatus | undefined;
+}
+/**
+ * @public
+ */
+export interface GetSessionRequest {
+    /**
+     * <p>A unique identifier for the session to retrieve. You can specify either the session's <code>sessionId</code> or its Amazon Resource Name (ARN).</p>
+     * @public
+     */
+    sessionIdentifier: string | undefined;
+}
+/**
+ * @public
+ */
+export interface GetSessionResponse {
+    /**
+     * <p>The unique identifier for the session in UUID format.</p>
+     * @public
+     */
+    sessionId: string | undefined;
+    /**
+     * <p>The Amazon Resource Name (ARN) of the session.</p>
+     * @public
+     */
+    sessionArn: string | undefined;
+    /**
+     * <p>The current status of the session.</p>
+     * @public
+     */
+    sessionStatus: SessionStatus | undefined;
+    /**
+     * <p>The timestamp for when the session was created.</p>
+     * @public
+     */
+    createdAt: Date | undefined;
+    /**
+     * <p>The timestamp for when the session was last modified.</p>
+     * @public
+     */
+    lastUpdatedAt: Date | undefined;
+    /**
+     * <p>A map of key-value pairs containing attributes persisted across the session.</p>
+     * @public
+     */
+    sessionMetadata?: Record<string, string> | undefined;
+    /**
+     * <p>The Amazon Resource Name (ARN) of the Key Management Service key used to encrypt the session data. For more information, see <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/session-encryption.html">Amazon Bedrock session encryption</a>.</p>
+     * @public
+     */
+    encryptionKeyArn?: string | undefined;
+}
+/**
+ * @public
+ */
+export interface CreateInvocationRequest {
+    /**
+     * <p>A unique identifier for the invocation in UUID format.</p>
+     * @public
+     */
+    invocationId?: string | undefined;
+    /**
+     * <p>A description for the interactions in the invocation. For example, "User asking about weather in Seattle".</p>
+     * @public
+     */
+    description?: string | undefined;
+    /**
+     * <p>The unique identifier for the associated session for the invocation. You can specify either the session's <code>sessionId</code> or its Amazon Resource Name (ARN). </p>
+     * @public
+     */
+    sessionIdentifier: string | undefined;
+}
+/**
+ * @public
+ */
+export interface CreateInvocationResponse {
+    /**
+     * <p>The unique identifier for the session associated with the invocation.</p>
+     * @public
+     */
+    sessionId: string | undefined;
+    /**
+     * <p>The unique identifier for the invocation.</p>
+     * @public
+     */
+    invocationId: string | undefined;
+    /**
+     * <p>The timestamp for when the invocation was created.</p>
+     * @public
+     */
+    createdAt: Date | undefined;
+}
 /**
  * @public
  */
@@ -890,7 +1461,7 @@ export interface ManagedSearchConfiguration {
      */
     numberOfResults?: number | undefined;
     /**
-     * <p>Specifies the filters to use on the metadata attributes in the knowledge base data sources before returning results. For more information, see <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/kb-test-config.html">Query configurations</a>. See the examples below to see how to use these filters.</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-runtime_Retrieve.html#API_agent-runtime_Retrieve_RequestSyntax">Retrieve request</a> – in the <code>filter</code> field</p> </li> <li> <p> <a href="https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_RetrieveAndGenerate.html#API_agent-runtime_RetrieveAndGenerate_RequestSyntax">RetrieveAndGenerate request</a> – in the <code>filter</code> field</p> </li> </ul>
+     * <p>Filters the metadata of the retrieved results so that Amazon Bedrock returns only results that match the filter.</p>
      * @public
      */
     filter?: RetrievalFilter | undefined;
@@ -1021,6 +1592,11 @@ export interface AgenticRetrieveStreamRequest {
      * @public
      */
     userContext?: UserContext | undefined;
+    /**
+     * <p>The configuration for using an Amazon Bedrock AgentCore Memory resource with this retrieval.</p>
+     * @public
+     */
+    memoryConfiguration?: AgenticRetrieveMemoryConfiguration | undefined;
     /**
      * <p>Whether to generate a response based on the retrieved results.</p>
      * @public
@@ -1141,7 +1717,7 @@ export interface RetrieveRequest {
      */
     nextToken?: string | undefined;
     /**
-     * <p>Contains information about the user making the request. Use this to pass user identity information for access control filtering, so that retrieval results only include documents the user is authorized to access.</p>
+     * <p>Contains information about the user making the request. This is used for access control filtering to ensure that retrieval results only include documents the user is authorized to access.</p>
      * @public
      */
     userContext?: UserContext | undefined;
@@ -1253,7 +1829,7 @@ export interface RetrieveAndGenerateRequest {
      */
     sessionConfiguration?: RetrieveAndGenerateSessionConfiguration | undefined;
     /**
-     * <p>Contains information about the user making the request. Use this to pass user identity information for access control filtering, so that retrieval results only include documents the user is authorized to access.</p>
+     * <p>Contains information about the user making the request. This is used for access control filtering to ensure that retrieval results only include documents the user is authorized to access.</p>
      * @public
      */
     userContext?: UserContext | undefined;
@@ -1283,7 +1859,7 @@ export interface RetrieveAndGenerateStreamRequest {
      */
     sessionConfiguration?: RetrieveAndGenerateSessionConfiguration | undefined;
     /**
-     * <p>Contains information about the user making the request. Use this to pass user identity information for access control filtering, so that retrieval results only include documents the user is authorized to access.</p>
+     * <p>Contains information about the user making the request. This is used for access control filtering to ensure that retrieval results only include documents the user is authorized to access.</p>
      * @public
      */
     userContext?: UserContext | undefined;