@aws-sdk/client-bedrock-agent-runtime 3.556.0 → 3.561.0

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

@@ -14,7 +14,7 @@ export declare class AccessDeniedException extends __BaseException {
     constructor(opts: __ExceptionOptionType<AccessDeniedException, __BaseException>);
 }
 /**
- * <p>A parameter in the Lambda input event.</p>
+ * <p>A parameter for the API request or function.</p>
  * @public
  */
 export interface Parameter {
@@ -35,7 +35,7 @@ export interface Parameter {
     value?: string;
 }
 /**
- * <p>The parameters in the request body for the Lambda input event.</p>
+ * <p>The parameters in the API request body.</p>
  * @public
  */
 export interface RequestBody {
@@ -46,7 +46,7 @@ export interface RequestBody {
     content?: Record<string, Parameter[]>;
 }
 /**
- * <p>Contains information about the action group being invoked.</p>
+ * <p>Contains information about the action group being invoked. For more information about the possible structures, see the InvocationInput tab in <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/trace-orchestration.html">OrchestrationTrace</a> in the Amazon Bedrock User Guide.</p>
  * @public
  */
 export interface ActionGroupInvocationInput {
@@ -75,6 +75,11 @@ export interface ActionGroupInvocationInput {
      * @public
      */
     requestBody?: RequestBody;
+    /**
+     * <p>The function in the action group to call.</p>
+     * @public
+     */
+    function?: string;
 }
 /**
  * <p>Contains the JSON-formatted string returned by the API invoked by the action group.</p>
@@ -145,6 +150,162 @@ export declare class InternalServerException extends __BaseException {
      */
     constructor(opts: __ExceptionOptionType<InternalServerException, __BaseException>);
 }
+/**
+ * <p>Contains the body of the API response.</p>
+ *          <p>This data type is used in the following API operations:</p>
+ *          <ul>
+ *             <li>
+ *                <p>In the <code>returnControlInvocationResults</code> field of the <a href="https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_Retrieve.html#API_agent-runtime_Retrieve_RequestSyntax">Retrieve request</a>
+ *                </p>
+ *             </li>
+ *          </ul>
+ * @public
+ */
+export interface ContentBody {
+    /**
+     * <p>The body of the API response.</p>
+     * @public
+     */
+    body?: string;
+}
+/**
+ * @public
+ * @enum
+ */
+export declare const ResponseState: {
+    readonly FAILURE: "FAILURE";
+    readonly REPROMPT: "REPROMPT";
+};
+/**
+ * @public
+ */
+export type ResponseState = (typeof ResponseState)[keyof typeof ResponseState];
+/**
+ * <p>Contains information about the API operation that was called from the action group and the response body that was returned.</p>
+ *          <p>This data type is used in the following API operations:</p>
+ *          <ul>
+ *             <li>
+ *                <p>In the <code>returnControlInvocationResults</code> of the <a href="https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_Retrieve.html#API_agent-runtime_Retrieve_RequestSyntax">Retrieve request</a>
+ *                </p>
+ *             </li>
+ *          </ul>
+ * @public
+ */
+export interface ApiResult {
+    /**
+     * <p>The action group that the API operation belongs to.</p>
+     * @public
+     */
+    actionGroup: string | undefined;
+    /**
+     * <p>The HTTP method for the API operation.</p>
+     * @public
+     */
+    httpMethod?: string;
+    /**
+     * <p>The path to the API operation.</p>
+     * @public
+     */
+    apiPath?: string;
+    /**
+     * <p>The response body from the API operation. The key of the object is the content type. The response may be returned directly or from the Lambda function.</p>
+     * @public
+     */
+    responseBody?: Record<string, ContentBody>;
+    /**
+     * <p>http status code from API execution response (for example: 200, 400, 500).</p>
+     * @public
+     */
+    httpStatusCode?: number;
+    /**
+     * <p>Controls the final response state returned to end user when API/Function execution failed. When this state is FAILURE, the request would fail with dependency failure exception. When this state is REPROMPT, the API/function response will be sent to model for re-prompt</p>
+     * @public
+     */
+    responseState?: ResponseState;
+}
+/**
+ * <p>Contains information about the function that was called from the action group and the response that was returned.</p>
+ *          <p>This data type is used in the following API operations:</p>
+ *          <ul>
+ *             <li>
+ *                <p>In the <code>returnControlInvocationResults</code> of the <a href="https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_Retrieve.html#API_agent-runtime_Retrieve_RequestSyntax">Retrieve request</a>
+ *                </p>
+ *             </li>
+ *          </ul>
+ * @public
+ */
+export interface FunctionResult {
+    /**
+     * <p>The action group that the function belongs to.</p>
+     * @public
+     */
+    actionGroup: string | undefined;
+    /**
+     * <p>The name of the function that was called.</p>
+     * @public
+     */
+    function?: string;
+    /**
+     * <p>The response from the function call using the parameters. The response may be returned directly or from the Lambda function.</p>
+     * @public
+     */
+    responseBody?: Record<string, ContentBody>;
+    /**
+     * <p>Controls the final response state returned to end user when API/Function execution failed. When this state is FAILURE, the request would fail with dependency failure exception. When this state is REPROMPT, the API/function response will be sent to model for re-prompt</p>
+     * @public
+     */
+    responseState?: ResponseState;
+}
+/**
+ * <p>A result from the action group invocation.</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>
+ *                </p>
+ *             </li>
+ *          </ul>
+ * @public
+ */
+export type InvocationResultMember = InvocationResultMember.ApiResultMember | InvocationResultMember.FunctionResultMember | InvocationResultMember.$UnknownMember;
+/**
+ * @public
+ */
+export declare namespace InvocationResultMember {
+    /**
+     * <p>The result from the API response from the action group invocation.</p>
+     * @public
+     */
+    interface ApiResultMember {
+        apiResult: ApiResult;
+        functionResult?: never;
+        $unknown?: never;
+    }
+    /**
+     * <p>The result from the function from the action group invocation.</p>
+     * @public
+     */
+    interface FunctionResultMember {
+        apiResult?: never;
+        functionResult: FunctionResult;
+        $unknown?: never;
+    }
+    /**
+     * @public
+     */
+    interface $UnknownMember {
+        apiResult?: never;
+        functionResult?: never;
+        $unknown: [string, any];
+    }
+    interface Visitor<T> {
+        apiResult: (value: ApiResult) => T;
+        functionResult: (value: FunctionResult) => T;
+        _: (name: string, value: any) => T;
+    }
+    const visit: <T>(value: InvocationResultMember, visitor: Visitor<T>) => T;
+}
 /**
  * <p>Contains parameters that specify various attributes that persist across a session or prompt. You can define session state attributes as key-value pairs when writing a <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/agents-lambda.html">Lambda function</a> for an action group or pass them when making an <a href="https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvokeAgent.html">InvokeAgent</a> request. Use session state attributes to control and provide conversational context for your agent and to help customize your agent's behavior. For more information, see <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/agents-session-state.html">Control session context</a>.</p>
  * @public
@@ -160,6 +321,16 @@ export interface SessionState {
      * @public
      */
     promptSessionAttributes?: Record<string, string>;
+    /**
+     * <p>Contains information about the results from the action group invocation.</p>
+     * @public
+     */
+    returnControlInvocationResults?: InvocationResultMember[];
+    /**
+     * <p>The identifier of the invocation.</p>
+     * @public
+     */
+    invocationId?: string;
 }
 /**
  * @public
@@ -199,7 +370,7 @@ export interface InvokeAgentRequest {
      * <p>The prompt text to send the agent.</p>
      * @public
      */
-    inputText: string | undefined;
+    inputText?: string;
 }
 /**
  * <p>Contains information about where the text with a citation begins and ends in the generated output.</p>
@@ -458,7 +629,7 @@ export interface PayloadPart {
     attribution?: Attribution;
 }
 /**
- * <p>The specified resource ARN was not found. Check the ARN and try your request again.</p>
+ * <p>The specified resource Amazon Resource Name (ARN) was not found. Check the Amazon Resource Name (ARN) and try your request again.</p>
  * @public
  */
 export declare class ResourceNotFoundException extends __BaseException {
@@ -469,6 +640,232 @@ export declare class ResourceNotFoundException extends __BaseException {
      */
     constructor(opts: __ExceptionOptionType<ResourceNotFoundException, __BaseException>);
 }
+/**
+ * <p>Information about a parameter to provide to the API request.</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>
+ *                </p>
+ *             </li>
+ *          </ul>
+ * @public
+ */
+export interface ApiParameter {
+    /**
+     * <p>The name of the parameter.</p>
+     * @public
+     */
+    name?: string;
+    /**
+     * <p>The data type for the parameter.</p>
+     * @public
+     */
+    type?: string;
+    /**
+     * <p>The value of the parameter.</p>
+     * @public
+     */
+    value?: string;
+}
+/**
+ * <p>Contains the parameters in the request body.</p>
+ * @public
+ */
+export interface PropertyParameters {
+    /**
+     * <p>A list of parameters in the request body.</p>
+     * @public
+     */
+    properties?: Parameter[];
+}
+/**
+ * <p>The request body to provide for the API request, as the agent elicited from the user.</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>
+ *                </p>
+ *             </li>
+ *          </ul>
+ * @public
+ */
+export interface ApiRequestBody {
+    /**
+     * <p>The content of the request body. The key of the object in this field is a media type defining the format of the request body.</p>
+     * @public
+     */
+    content?: Record<string, PropertyParameters>;
+}
+/**
+ * <p>Contains information about the API operation that the agent predicts should be called.</p>
+ *          <p>This data type is used in the following API operations:</p>
+ *          <ul>
+ *             <li>
+ *                <p>In the <code>returnControl</code> field of the <a href="https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_Retrieve.html#API_agent-runtime_Retrieve_ResponseSyntax">Retrieve response</a>
+ *                </p>
+ *             </li>
+ *          </ul>
+ * @public
+ */
+export interface ApiInvocationInput {
+    /**
+     * <p>The action group that the API operation belongs to.</p>
+     * @public
+     */
+    actionGroup: string | undefined;
+    /**
+     * <p>The HTTP method of the API operation.</p>
+     * @public
+     */
+    httpMethod?: string;
+    /**
+     * <p>The path to the API operation.</p>
+     * @public
+     */
+    apiPath?: string;
+    /**
+     * <p>The parameters to provide for the API request, as the agent elicited from the user.</p>
+     * @public
+     */
+    parameters?: ApiParameter[];
+    /**
+     * <p>The request body to provide for the API request, as the agent elicited from the user.</p>
+     * @public
+     */
+    requestBody?: ApiRequestBody;
+}
+/**
+ * <p>Contains information about a parameter of the function.</p>
+ *          <p>This data type is used in the following API operations:</p>
+ *          <ul>
+ *             <li>
+ *                <p>In the <code>returnControl</code> field of the <a href="https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_Retrieve.html#API_agent-runtime_Retrieve_ResponseSyntax">Retrieve response</a>
+ *                </p>
+ *             </li>
+ *          </ul>
+ * @public
+ */
+export interface FunctionParameter {
+    /**
+     * <p>The name of the parameter.</p>
+     * @public
+     */
+    name?: string;
+    /**
+     * <p>The data type of the parameter.</p>
+     * @public
+     */
+    type?: string;
+    /**
+     * <p>The value of the parameter.</p>
+     * @public
+     */
+    value?: string;
+}
+/**
+ * <p>Contains information about the function that the agent predicts should be called.</p>
+ *          <p>This data type is used in the following API operations:</p>
+ *          <ul>
+ *             <li>
+ *                <p>In the <code>returnControl</code> field of the <a href="https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_Retrieve.html#API_agent-runtime_Retrieve_ResponseSyntax">Retrieve response</a>
+ *                </p>
+ *             </li>
+ *          </ul>
+ * @public
+ */
+export interface FunctionInvocationInput {
+    /**
+     * <p>The action group that the function belongs to.</p>
+     * @public
+     */
+    actionGroup: string | undefined;
+    /**
+     * <p>A list of parameters of the function.</p>
+     * @public
+     */
+    parameters?: FunctionParameter[];
+    /**
+     * <p>The name of the function.</p>
+     * @public
+     */
+    function?: string;
+}
+/**
+ * <p>Contains details about the API operation or function that the agent predicts should be called.</p>
+ *          <p>This data type is used in the following API operations:</p>
+ *          <ul>
+ *             <li>
+ *                <p>In the <code>returnControl</code> field of the <a href="https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_Retrieve.html#API_agent-runtime_Retrieve_ResponseSyntax">Retrieve response</a>
+ *                </p>
+ *             </li>
+ *          </ul>
+ * @public
+ */
+export type InvocationInputMember = InvocationInputMember.ApiInvocationInputMember | InvocationInputMember.FunctionInvocationInputMember | InvocationInputMember.$UnknownMember;
+/**
+ * @public
+ */
+export declare namespace InvocationInputMember {
+    /**
+     * <p>Contains information about the API operation that the agent predicts should be called.</p>
+     * @public
+     */
+    interface ApiInvocationInputMember {
+        apiInvocationInput: ApiInvocationInput;
+        functionInvocationInput?: never;
+        $unknown?: never;
+    }
+    /**
+     * <p>Contains information about the function that the agent predicts should be called.</p>
+     * @public
+     */
+    interface FunctionInvocationInputMember {
+        apiInvocationInput?: never;
+        functionInvocationInput: FunctionInvocationInput;
+        $unknown?: never;
+    }
+    /**
+     * @public
+     */
+    interface $UnknownMember {
+        apiInvocationInput?: never;
+        functionInvocationInput?: never;
+        $unknown: [string, any];
+    }
+    interface Visitor<T> {
+        apiInvocationInput: (value: ApiInvocationInput) => T;
+        functionInvocationInput: (value: FunctionInvocationInput) => T;
+        _: (name: string, value: any) => T;
+    }
+    const visit: <T>(value: InvocationInputMember, visitor: Visitor<T>) => T;
+}
+/**
+ * <p>Contains information to return from the action group that the agent has predicted to invoke.</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>
+ *                </p>
+ *             </li>
+ *          </ul>
+ * @public
+ */
+export interface ReturnControlPayload {
+    /**
+     * <p>A list of objects that contain information about the parameters and inputs that need to be sent into the API operation or function, based on what the agent determines from its session with the user.</p>
+     * @public
+     */
+    invocationInputs?: InvocationInputMember[];
+    /**
+     * <p>The identifier of the action group invocation.</p>
+     * @public
+     */
+    invocationId?: string;
+}
 /**
  * <p>The number of requests exceeds the service quota. Resubmit your request later.</p>
  * @public
@@ -1153,6 +1550,11 @@ export interface TracePart {
      * @public
      */
     sessionId?: string;
+    /**
+     * <p>The version of the agent.</p>
+     * @public
+     */
+    agentVersion?: string;
     /**
      * <p>Contains one part of the agent's reasoning process and results from calling API actions and querying knowledge bases. You can use the trace to understand how the agent arrived at the response it provided the customer. For more information, see <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/agents-test.html#trace-enablement">Trace enablement</a>.</p>
      * @public
@@ -1175,7 +1577,7 @@ export declare class ValidationException extends __BaseException {
  * <p>The response from invoking the agent and associated citations and trace information.</p>
  * @public
  */
-export type ResponseStream = ResponseStream.AccessDeniedExceptionMember | ResponseStream.BadGatewayExceptionMember | ResponseStream.ChunkMember | ResponseStream.ConflictExceptionMember | ResponseStream.DependencyFailedExceptionMember | ResponseStream.InternalServerExceptionMember | ResponseStream.ResourceNotFoundExceptionMember | ResponseStream.ServiceQuotaExceededExceptionMember | ResponseStream.ThrottlingExceptionMember | ResponseStream.TraceMember | ResponseStream.ValidationExceptionMember | ResponseStream.$UnknownMember;
+export type ResponseStream = ResponseStream.AccessDeniedExceptionMember | ResponseStream.BadGatewayExceptionMember | ResponseStream.ChunkMember | ResponseStream.ConflictExceptionMember | ResponseStream.DependencyFailedExceptionMember | ResponseStream.InternalServerExceptionMember | ResponseStream.ResourceNotFoundExceptionMember | ResponseStream.ReturnControlMember | ResponseStream.ServiceQuotaExceededExceptionMember | ResponseStream.ThrottlingExceptionMember | ResponseStream.TraceMember | ResponseStream.ValidationExceptionMember | ResponseStream.$UnknownMember;
 /**
  * @public
  */
@@ -1187,6 +1589,7 @@ export declare namespace ResponseStream {
     interface ChunkMember {
         chunk: PayloadPart;
         trace?: never;
+        returnControl?: never;
         internalServerException?: never;
         validationException?: never;
         resourceNotFoundException?: never;
@@ -1199,12 +1602,32 @@ export declare namespace ResponseStream {
         $unknown?: never;
     }
     /**
-     * <p>Contains information about the agent and session, alongside the agent's reasoning process and results from calling API actions and querying knowledge bases and metadata about the trace. You can use the trace to understand how the agent arrived at the response it provided the customer. For more information, see <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/trace-events.html">Trace events</a>.</p>
+     * <p>Contains information about the agent and session, alongside the agent's reasoning process and results from calling actions and querying knowledge bases and metadata about the trace. You can use the trace to understand how the agent arrived at the response it provided the customer. For more information, see <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/trace-events.html">Trace events</a>.</p>
      * @public
      */
     interface TraceMember {
         chunk?: never;
         trace: TracePart;
+        returnControl?: never;
+        internalServerException?: never;
+        validationException?: never;
+        resourceNotFoundException?: never;
+        serviceQuotaExceededException?: never;
+        throttlingException?: never;
+        accessDeniedException?: never;
+        conflictException?: never;
+        dependencyFailedException?: never;
+        badGatewayException?: never;
+        $unknown?: never;
+    }
+    /**
+     * <p>Contains the parameters and information that the agent elicited from the customer to carry out an action. This information is returned to the system and can be used in your own setup for fulfilling the action.</p>
+     * @public
+     */
+    interface ReturnControlMember {
+        chunk?: never;
+        trace?: never;
+        returnControl: ReturnControlPayload;
         internalServerException?: never;
         validationException?: never;
         resourceNotFoundException?: never;
@@ -1223,6 +1646,7 @@ export declare namespace ResponseStream {
     interface InternalServerExceptionMember {
         chunk?: never;
         trace?: never;
+        returnControl?: never;
         internalServerException: InternalServerException;
         validationException?: never;
         resourceNotFoundException?: never;
@@ -1241,6 +1665,7 @@ export declare namespace ResponseStream {
     interface ValidationExceptionMember {
         chunk?: never;
         trace?: never;
+        returnControl?: never;
         internalServerException?: never;
         validationException: ValidationException;
         resourceNotFoundException?: never;
@@ -1253,12 +1678,13 @@ export declare namespace ResponseStream {
         $unknown?: never;
     }
     /**
-     * <p>The specified resource ARN was not found. Check the ARN and try your request again.</p>
+     * <p>The specified resource Amazon Resource Name (ARN) was not found. Check the Amazon Resource Name (ARN) and try your request again.</p>
      * @public
      */
     interface ResourceNotFoundExceptionMember {
         chunk?: never;
         trace?: never;
+        returnControl?: never;
         internalServerException?: never;
         validationException?: never;
         resourceNotFoundException: ResourceNotFoundException;
@@ -1277,6 +1703,7 @@ export declare namespace ResponseStream {
     interface ServiceQuotaExceededExceptionMember {
         chunk?: never;
         trace?: never;
+        returnControl?: never;
         internalServerException?: never;
         validationException?: never;
         resourceNotFoundException?: never;
@@ -1295,6 +1722,7 @@ export declare namespace ResponseStream {
     interface ThrottlingExceptionMember {
         chunk?: never;
         trace?: never;
+        returnControl?: never;
         internalServerException?: never;
         validationException?: never;
         resourceNotFoundException?: never;
@@ -1313,6 +1741,7 @@ export declare namespace ResponseStream {
     interface AccessDeniedExceptionMember {
         chunk?: never;
         trace?: never;
+        returnControl?: never;
         internalServerException?: never;
         validationException?: never;
         resourceNotFoundException?: never;
@@ -1331,6 +1760,7 @@ export declare namespace ResponseStream {
     interface ConflictExceptionMember {
         chunk?: never;
         trace?: never;
+        returnControl?: never;
         internalServerException?: never;
         validationException?: never;
         resourceNotFoundException?: never;
@@ -1349,6 +1779,7 @@ export declare namespace ResponseStream {
     interface DependencyFailedExceptionMember {
         chunk?: never;
         trace?: never;
+        returnControl?: never;
         internalServerException?: never;
         validationException?: never;
         resourceNotFoundException?: never;
@@ -1367,6 +1798,7 @@ export declare namespace ResponseStream {
     interface BadGatewayExceptionMember {
         chunk?: never;
         trace?: never;
+        returnControl?: never;
         internalServerException?: never;
         validationException?: never;
         resourceNotFoundException?: never;
@@ -1384,6 +1816,7 @@ export declare namespace ResponseStream {
     interface $UnknownMember {
         chunk?: never;
         trace?: never;
+        returnControl?: never;
         internalServerException?: never;
         validationException?: never;
         resourceNotFoundException?: never;
@@ -1398,6 +1831,7 @@ export declare namespace ResponseStream {
     interface Visitor<T> {
         chunk: (value: PayloadPart) => T;
         trace: (value: TracePart) => T;
+        returnControl: (value: ReturnControlPayload) => T;
         internalServerException: (value: InternalServerException) => T;
         validationException: (value: ValidationException) => T;
         resourceNotFoundException: (value: ResourceNotFoundException) => T;
@@ -1480,6 +1914,103 @@ export interface PromptTemplate {
      */
     textPromptTemplate?: string;
 }
+/**
+ * <p>Contains the generation configuration of the external source wrapper object.</p>
+ * @public
+ */
+export interface ExternalSourcesGenerationConfiguration {
+    /**
+     * <p>Contain the textPromptTemplate string for the external source wrapper object.</p>
+     * @public
+     */
+    promptTemplate?: PromptTemplate;
+}
+/**
+ * <p>This property contains the document to chat with, along with its attributes.</p>
+ * @public
+ */
+export interface ByteContentDoc {
+    /**
+     * <p>The file name of the document contained in the wrapper object.</p>
+     * @public
+     */
+    identifier: string | undefined;
+    /**
+     * <p>The MIME type of the document contained in the wrapper object.</p>
+     * @public
+     */
+    contentType: string | undefined;
+    /**
+     * <p>The byte value of the file to upload, encoded as a Base-64 string.</p>
+     * @public
+     */
+    data: Uint8Array | undefined;
+}
+/**
+ * <p>The unique wrapper object of the document from the S3 location.</p>
+ * @public
+ */
+export interface S3ObjectDoc {
+    /**
+     * <p>The file location of the S3 wrapper object.</p>
+     * @public
+     */
+    uri: string | undefined;
+}
+/**
+ * @public
+ * @enum
+ */
+export declare const ExternalSourceType: {
+    readonly BYTE_CONTENT: "BYTE_CONTENT";
+    readonly S3: "S3";
+};
+/**
+ * @public
+ */
+export type ExternalSourceType = (typeof ExternalSourceType)[keyof typeof ExternalSourceType];
+/**
+ * <p>The unique external source of the content contained in the wrapper object.</p>
+ * @public
+ */
+export interface ExternalSource {
+    /**
+     * <p>The source type of the external source wrapper object.</p>
+     * @public
+     */
+    sourceType: ExternalSourceType | undefined;
+    /**
+     * <p>The S3 location of the external source wrapper object.</p>
+     * @public
+     */
+    s3Location?: S3ObjectDoc;
+    /**
+     * <p>The identifier, contentType, and data of the external source wrapper object.</p>
+     * @public
+     */
+    byteContent?: ByteContentDoc;
+}
+/**
+ * <p>The configurations of the external source wrapper object in the retrieveAndGenerate function.</p>
+ * @public
+ */
+export interface ExternalSourcesRetrieveAndGenerateConfiguration {
+    /**
+     * <p>The modelArn used with the external source wrapper object in the retrieveAndGenerate function.</p>
+     * @public
+     */
+    modelArn: string | undefined;
+    /**
+     * <p>The document used with the external source wrapper object in the retrieveAndGenerate function.</p>
+     * @public
+     */
+    sources: ExternalSource[] | undefined;
+    /**
+     * <p>The prompt used with the external source wrapper object with the retrieveAndGenerate function.</p>
+     * @public
+     */
+    generationConfiguration?: ExternalSourcesGenerationConfiguration;
+}
 /**
  * <p>Contains configurations for response generation based on the knowledge base query results.</p>
  *          <p>This data type is used in the following API operations:</p>
@@ -1540,6 +2071,7 @@ export type SearchType = (typeof SearchType)[keyof typeof SearchType];
  * @enum
  */
 export declare const RetrieveAndGenerateType: {
+    readonly EXTERNAL_SOURCES: "EXTERNAL_SOURCES";
     readonly KNOWLEDGE_BASE: "KNOWLEDGE_BASE";
 };
 /**
@@ -2057,6 +2589,11 @@ export interface RetrieveAndGenerateConfiguration {
      * @public
      */
     knowledgeBaseConfiguration?: KnowledgeBaseRetrieveAndGenerateConfiguration;
+    /**
+     * <p>The configuration used with the external source wrapper object in the retrieveAndGenerate function.</p>
+     * @public
+     */
+    externalSourcesConfiguration?: ExternalSourcesRetrieveAndGenerateConfiguration;
 }
 /**
  * @public
@@ -2091,6 +2628,18 @@ export declare const ActionGroupInvocationInputFilterSensitiveLog: (obj: ActionG
  * @internal
  */
 export declare const ActionGroupInvocationOutputFilterSensitiveLog: (obj: ActionGroupInvocationOutput) => any;
+/**
+ * @internal
+ */
+export declare const ApiResultFilterSensitiveLog: (obj: ApiResult) => any;
+/**
+ * @internal
+ */
+export declare const InvocationResultMemberFilterSensitiveLog: (obj: InvocationResultMember) => any;
+/**
+ * @internal
+ */
+export declare const SessionStateFilterSensitiveLog: (obj: SessionState) => any;
 /**
  * @internal
  */
@@ -2127,6 +2676,18 @@ export declare const AttributionFilterSensitiveLog: (obj: Attribution) => any;
  * @internal
  */
 export declare const PayloadPartFilterSensitiveLog: (obj: PayloadPart) => any;
+/**
+ * @internal
+ */
+export declare const ApiInvocationInputFilterSensitiveLog: (obj: ApiInvocationInput) => any;
+/**
+ * @internal
+ */
+export declare const InvocationInputMemberFilterSensitiveLog: (obj: InvocationInputMember) => any;
+/**
+ * @internal
+ */
+export declare const ReturnControlPayloadFilterSensitiveLog: (obj: ReturnControlPayload) => any;
 /**
  * @internal
  */
@@ -2215,6 +2776,22 @@ export declare const RetrieveAndGenerateInputFilterSensitiveLog: (obj: RetrieveA
  * @internal
  */
 export declare const PromptTemplateFilterSensitiveLog: (obj: PromptTemplate) => any;
+/**
+ * @internal
+ */
+export declare const ExternalSourcesGenerationConfigurationFilterSensitiveLog: (obj: ExternalSourcesGenerationConfiguration) => any;
+/**
+ * @internal
+ */
+export declare const ByteContentDocFilterSensitiveLog: (obj: ByteContentDoc) => any;
+/**
+ * @internal
+ */
+export declare const ExternalSourceFilterSensitiveLog: (obj: ExternalSource) => any;
+/**
+ * @internal
+ */
+export declare const ExternalSourcesRetrieveAndGenerateConfigurationFilterSensitiveLog: (obj: ExternalSourcesRetrieveAndGenerateConfiguration) => any;
 /**
  * @internal
  */