@aws-sdk/client-bedrock-agent-runtime 3.560.0 → 3.563.0

package/dist-cjs/index.js

@@ -31,10 +31,15 @@ __export(src_exports, {
   BedrockAgentRuntime: () => BedrockAgentRuntime,
   BedrockAgentRuntimeClient: () => BedrockAgentRuntimeClient,
   BedrockAgentRuntimeServiceException: () => BedrockAgentRuntimeServiceException,
+  ByteContentDocFilterSensitiveLog: () => ByteContentDocFilterSensitiveLog,
   CitationFilterSensitiveLog: () => CitationFilterSensitiveLog,
   ConflictException: () => ConflictException,
   CreationMode: () => CreationMode,
   DependencyFailedException: () => DependencyFailedException,
+  ExternalSourceFilterSensitiveLog: () => ExternalSourceFilterSensitiveLog,
+  ExternalSourceType: () => ExternalSourceType,
+  ExternalSourcesGenerationConfigurationFilterSensitiveLog: () => ExternalSourcesGenerationConfigurationFilterSensitiveLog,
+  ExternalSourcesRetrieveAndGenerateConfigurationFilterSensitiveLog: () => ExternalSourcesRetrieveAndGenerateConfigurationFilterSensitiveLog,
   FailureTraceFilterSensitiveLog: () => FailureTraceFilterSensitiveLog,
   FinalResponseFilterSensitiveLog: () => FinalResponseFilterSensitiveLog,
   GeneratedResponsePartFilterSensitiveLog: () => GeneratedResponsePartFilterSensitiveLog,
@@ -569,11 +574,16 @@ var ResponseStream;
     return visitor._(value.$unknown[0], value.$unknown[1]);
   }, "visit");
 })(ResponseStream || (ResponseStream = {}));
+var ExternalSourceType = {
+  BYTE_CONTENT: "BYTE_CONTENT",
+  S3: "S3"
+};
 var SearchType = {
   HYBRID: "HYBRID",
   SEMANTIC: "SEMANTIC"
 };
 var RetrieveAndGenerateType = {
+  EXTERNAL_SOURCES: "EXTERNAL_SOURCES",
   KNOWLEDGE_BASE: "KNOWLEDGE_BASE"
 };
 var RetrievalFilter;
@@ -845,6 +855,26 @@ var PromptTemplateFilterSensitiveLog = /* @__PURE__ */ __name((obj) => ({
   ...obj,
   ...obj.textPromptTemplate && { textPromptTemplate: import_smithy_client.SENSITIVE_STRING }
 }), "PromptTemplateFilterSensitiveLog");
+var ExternalSourcesGenerationConfigurationFilterSensitiveLog = /* @__PURE__ */ __name((obj) => ({
+  ...obj,
+  ...obj.promptTemplate && { promptTemplate: PromptTemplateFilterSensitiveLog(obj.promptTemplate) }
+}), "ExternalSourcesGenerationConfigurationFilterSensitiveLog");
+var ByteContentDocFilterSensitiveLog = /* @__PURE__ */ __name((obj) => ({
+  ...obj,
+  ...obj.identifier && { identifier: import_smithy_client.SENSITIVE_STRING },
+  ...obj.data && { data: import_smithy_client.SENSITIVE_STRING }
+}), "ByteContentDocFilterSensitiveLog");
+var ExternalSourceFilterSensitiveLog = /* @__PURE__ */ __name((obj) => ({
+  ...obj,
+  ...obj.byteContent && { byteContent: ByteContentDocFilterSensitiveLog(obj.byteContent) }
+}), "ExternalSourceFilterSensitiveLog");
+var ExternalSourcesRetrieveAndGenerateConfigurationFilterSensitiveLog = /* @__PURE__ */ __name((obj) => ({
+  ...obj,
+  ...obj.sources && { sources: obj.sources.map((item) => ExternalSourceFilterSensitiveLog(item)) },
+  ...obj.generationConfiguration && {
+    generationConfiguration: ExternalSourcesGenerationConfigurationFilterSensitiveLog(obj.generationConfiguration)
+  }
+}), "ExternalSourcesRetrieveAndGenerateConfigurationFilterSensitiveLog");
 var GenerationConfigurationFilterSensitiveLog = /* @__PURE__ */ __name((obj) => ({
   ...obj,
   ...obj.promptTemplate && { promptTemplate: PromptTemplateFilterSensitiveLog(obj.promptTemplate) }
@@ -928,6 +958,11 @@ var RetrieveAndGenerateConfigurationFilterSensitiveLog = /* @__PURE__ */ __name(
     knowledgeBaseConfiguration: KnowledgeBaseRetrieveAndGenerateConfigurationFilterSensitiveLog(
       obj.knowledgeBaseConfiguration
     )
+  },
+  ...obj.externalSourcesConfiguration && {
+    externalSourcesConfiguration: ExternalSourcesRetrieveAndGenerateConfigurationFilterSensitiveLog(
+      obj.externalSourcesConfiguration
+    )
   }
 }), "RetrieveAndGenerateConfigurationFilterSensitiveLog");
 var RetrieveAndGenerateRequestFilterSensitiveLog = /* @__PURE__ */ __name((obj) => ({
@@ -1363,6 +1398,32 @@ var de_ValidationException_event = /* @__PURE__ */ __name(async (output, context
   };
   return de_ValidationExceptionRes(parsedOutput, context);
 }, "de_ValidationException_event");
+var se_ByteContentDoc = /* @__PURE__ */ __name((input, context) => {
+  return (0, import_smithy_client.take)(input, {
+    contentType: [],
+    data: context.base64Encoder,
+    identifier: []
+  });
+}, "se_ByteContentDoc");
+var se_ExternalSource = /* @__PURE__ */ __name((input, context) => {
+  return (0, import_smithy_client.take)(input, {
+    byteContent: (_) => se_ByteContentDoc(_, context),
+    s3Location: import_smithy_client._json,
+    sourceType: []
+  });
+}, "se_ExternalSource");
+var se_ExternalSources = /* @__PURE__ */ __name((input, context) => {
+  return input.filter((e) => e != null).map((entry) => {
+    return se_ExternalSource(entry, context);
+  });
+}, "se_ExternalSources");
+var se_ExternalSourcesRetrieveAndGenerateConfiguration = /* @__PURE__ */ __name((input, context) => {
+  return (0, import_smithy_client.take)(input, {
+    generationConfiguration: import_smithy_client._json,
+    modelArn: [],
+    sources: (_) => se_ExternalSources(_, context)
+  });
+}, "se_ExternalSourcesRetrieveAndGenerateConfiguration");
 var se_FilterAttribute = /* @__PURE__ */ __name((input, context) => {
   return (0, import_smithy_client.take)(input, {
     key: [],
@@ -1415,6 +1476,7 @@ var se_RetrievalFilterList = /* @__PURE__ */ __name((input, context) => {
 }, "se_RetrievalFilterList");
 var se_RetrieveAndGenerateConfiguration = /* @__PURE__ */ __name((input, context) => {
   return (0, import_smithy_client.take)(input, {
+    externalSourcesConfiguration: (_) => se_ExternalSourcesRetrieveAndGenerateConfiguration(_, context),
     knowledgeBaseConfiguration: (_) => se_KnowledgeBaseRetrieveAndGenerateConfiguration(_, context),
     type: []
   });
@@ -1712,6 +1774,7 @@ var paginateRetrieve = (0, import_core.createPaginator)(BedrockAgentRuntimeClien
   Trace,
   ValidationException,
   ResponseStream,
+  ExternalSourceType,
   SearchType,
   RetrieveAndGenerateType,
   RetrievalFilter,
@@ -1754,6 +1817,10 @@ var paginateRetrieve = (0, import_core.createPaginator)(BedrockAgentRuntimeClien
   InvokeAgentResponseFilterSensitiveLog,
   RetrieveAndGenerateInputFilterSensitiveLog,
   PromptTemplateFilterSensitiveLog,
+  ExternalSourcesGenerationConfigurationFilterSensitiveLog,
+  ByteContentDocFilterSensitiveLog,
+  ExternalSourceFilterSensitiveLog,
+  ExternalSourcesRetrieveAndGenerateConfigurationFilterSensitiveLog,
   GenerationConfigurationFilterSensitiveLog,
   RetrieveAndGenerateOutputFilterSensitiveLog,
   RetrieveAndGenerateResponseFilterSensitiveLog,

package/dist-es/models/models_0.js

@@ -242,11 +242,16 @@ export var ResponseStream;
         return visitor._(value.$unknown[0], value.$unknown[1]);
     };
 })(ResponseStream || (ResponseStream = {}));
+export const ExternalSourceType = {
+    BYTE_CONTENT: "BYTE_CONTENT",
+    S3: "S3",
+};
 export const SearchType = {
     HYBRID: "HYBRID",
     SEMANTIC: "SEMANTIC",
 };
 export const RetrieveAndGenerateType = {
+    EXTERNAL_SOURCES: "EXTERNAL_SOURCES",
     KNOWLEDGE_BASE: "KNOWLEDGE_BASE",
 };
 export var RetrievalFilter;
@@ -516,6 +521,26 @@ export const PromptTemplateFilterSensitiveLog = (obj) => ({
     ...obj,
     ...(obj.textPromptTemplate && { textPromptTemplate: SENSITIVE_STRING }),
 });
+export const ExternalSourcesGenerationConfigurationFilterSensitiveLog = (obj) => ({
+    ...obj,
+    ...(obj.promptTemplate && { promptTemplate: PromptTemplateFilterSensitiveLog(obj.promptTemplate) }),
+});
+export const ByteContentDocFilterSensitiveLog = (obj) => ({
+    ...obj,
+    ...(obj.identifier && { identifier: SENSITIVE_STRING }),
+    ...(obj.data && { data: SENSITIVE_STRING }),
+});
+export const ExternalSourceFilterSensitiveLog = (obj) => ({
+    ...obj,
+    ...(obj.byteContent && { byteContent: ByteContentDocFilterSensitiveLog(obj.byteContent) }),
+});
+export const ExternalSourcesRetrieveAndGenerateConfigurationFilterSensitiveLog = (obj) => ({
+    ...obj,
+    ...(obj.sources && { sources: obj.sources.map((item) => ExternalSourceFilterSensitiveLog(item)) }),
+    ...(obj.generationConfiguration && {
+        generationConfiguration: ExternalSourcesGenerationConfigurationFilterSensitiveLog(obj.generationConfiguration),
+    }),
+});
 export const GenerationConfigurationFilterSensitiveLog = (obj) => ({
     ...obj,
     ...(obj.promptTemplate && { promptTemplate: PromptTemplateFilterSensitiveLog(obj.promptTemplate) }),
@@ -598,6 +623,9 @@ export const RetrieveAndGenerateConfigurationFilterSensitiveLog = (obj) => ({
     ...(obj.knowledgeBaseConfiguration && {
         knowledgeBaseConfiguration: KnowledgeBaseRetrieveAndGenerateConfigurationFilterSensitiveLog(obj.knowledgeBaseConfiguration),
     }),
+    ...(obj.externalSourcesConfiguration && {
+        externalSourcesConfiguration: ExternalSourcesRetrieveAndGenerateConfigurationFilterSensitiveLog(obj.externalSourcesConfiguration),
+    }),
 });
 export const RetrieveAndGenerateRequestFilterSensitiveLog = (obj) => ({
     ...obj,

package/dist-es/protocols/Aws_restJson1.js

@@ -407,6 +407,34 @@ const de_ValidationException_event = async (output, context) => {
     };
     return de_ValidationExceptionRes(parsedOutput, context);
 };
+const se_ByteContentDoc = (input, context) => {
+    return take(input, {
+        contentType: [],
+        data: context.base64Encoder,
+        identifier: [],
+    });
+};
+const se_ExternalSource = (input, context) => {
+    return take(input, {
+        byteContent: (_) => se_ByteContentDoc(_, context),
+        s3Location: _json,
+        sourceType: [],
+    });
+};
+const se_ExternalSources = (input, context) => {
+    return input
+        .filter((e) => e != null)
+        .map((entry) => {
+        return se_ExternalSource(entry, context);
+    });
+};
+const se_ExternalSourcesRetrieveAndGenerateConfiguration = (input, context) => {
+    return take(input, {
+        generationConfiguration: _json,
+        modelArn: [],
+        sources: (_) => se_ExternalSources(_, context),
+    });
+};
 const se_FilterAttribute = (input, context) => {
     return take(input, {
         key: [],
@@ -461,6 +489,7 @@ const se_RetrievalFilterList = (input, context) => {
 };
 const se_RetrieveAndGenerateConfiguration = (input, context) => {
     return take(input, {
+        externalSourcesConfiguration: (_) => se_ExternalSourcesRetrieveAndGenerateConfiguration(_, context),
         knowledgeBaseConfiguration: (_) => se_KnowledgeBaseRetrieveAndGenerateConfiguration(_, context),
         type: [],
     });

package/dist-types/commands/RetrieveAndGenerateCommand.d.ts

@@ -39,7 +39,7 @@ declare const RetrieveAndGenerateCommand_base: {
  *     text: "STRING_VALUE", // required
  *   },
  *   retrieveAndGenerateConfiguration: { // RetrieveAndGenerateConfiguration
- *     type: "KNOWLEDGE_BASE", // required
+ *     type: "KNOWLEDGE_BASE" || "EXTERNAL_SOURCES", // required
  *     knowledgeBaseConfiguration: { // KnowledgeBaseRetrieveAndGenerateConfiguration
  *       knowledgeBaseId: "STRING_VALUE", // required
  *       modelArn: "STRING_VALUE", // required
@@ -103,6 +103,27 @@ declare const RetrieveAndGenerateCommand_base: {
  *         },
  *       },
  *     },
+ *     externalSourcesConfiguration: { // ExternalSourcesRetrieveAndGenerateConfiguration
+ *       modelArn: "STRING_VALUE", // required
+ *       sources: [ // ExternalSources // required
+ *         { // ExternalSource
+ *           sourceType: "S3" || "BYTE_CONTENT", // required
+ *           s3Location: { // S3ObjectDoc
+ *             uri: "STRING_VALUE", // required
+ *           },
+ *           byteContent: { // ByteContentDoc
+ *             identifier: "STRING_VALUE", // required
+ *             contentType: "STRING_VALUE", // required
+ *             data: new Uint8Array(), // e.g. Buffer.from("") or new TextEncoder().encode("")             // required
+ *           },
+ *         },
+ *       ],
+ *       generationConfiguration: { // ExternalSourcesGenerationConfiguration
+ *         promptTemplate: {
+ *           textPromptTemplate: "STRING_VALUE",
+ *         },
+ *       },
+ *     },
  *   },
  *   sessionConfiguration: { // RetrieveAndGenerateSessionConfiguration
  *     kmsKeyArn: "STRING_VALUE", // required

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

@@ -1914,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>
@@ -1974,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";
 };
 /**
@@ -2491,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
@@ -2673,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
  */

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

@@ -749,6 +749,33 @@ export interface RetrieveAndGenerateInput {
 export interface PromptTemplate {
   textPromptTemplate?: string;
 }
+export interface ExternalSourcesGenerationConfiguration {
+  promptTemplate?: PromptTemplate;
+}
+export interface ByteContentDoc {
+  identifier: string | undefined;
+  contentType: string | undefined;
+  data: Uint8Array | undefined;
+}
+export interface S3ObjectDoc {
+  uri: string | undefined;
+}
+export declare const ExternalSourceType: {
+  readonly BYTE_CONTENT: "BYTE_CONTENT";
+  readonly S3: "S3";
+};
+export type ExternalSourceType =
+  (typeof ExternalSourceType)[keyof typeof ExternalSourceType];
+export interface ExternalSource {
+  sourceType: ExternalSourceType | undefined;
+  s3Location?: S3ObjectDoc;
+  byteContent?: ByteContentDoc;
+}
+export interface ExternalSourcesRetrieveAndGenerateConfiguration {
+  modelArn: string | undefined;
+  sources: ExternalSource[] | undefined;
+  generationConfiguration?: ExternalSourcesGenerationConfiguration;
+}
 export interface GenerationConfiguration {
   promptTemplate?: PromptTemplate;
 }
@@ -762,6 +789,7 @@ export declare const SearchType: {
 };
 export type SearchType = (typeof SearchType)[keyof typeof SearchType];
 export declare const RetrieveAndGenerateType: {
+  readonly EXTERNAL_SOURCES: "EXTERNAL_SOURCES";
   readonly KNOWLEDGE_BASE: "KNOWLEDGE_BASE";
 };
 export type RetrieveAndGenerateType =
@@ -1011,6 +1039,7 @@ export interface RetrieveRequest {
 export interface RetrieveAndGenerateConfiguration {
   type: RetrieveAndGenerateType | undefined;
   knowledgeBaseConfiguration?: KnowledgeBaseRetrieveAndGenerateConfiguration;
+  externalSourcesConfiguration?: ExternalSourcesRetrieveAndGenerateConfiguration;
 }
 export interface RetrieveAndGenerateRequest {
   sessionId?: string;
@@ -1115,6 +1144,18 @@ export declare const RetrieveAndGenerateInputFilterSensitiveLog: (
 export declare const PromptTemplateFilterSensitiveLog: (
   obj: PromptTemplate
 ) => any;
+export declare const ExternalSourcesGenerationConfigurationFilterSensitiveLog: (
+  obj: ExternalSourcesGenerationConfiguration
+) => any;
+export declare const ByteContentDocFilterSensitiveLog: (
+  obj: ByteContentDoc
+) => any;
+export declare const ExternalSourceFilterSensitiveLog: (
+  obj: ExternalSource
+) => any;
+export declare const ExternalSourcesRetrieveAndGenerateConfigurationFilterSensitiveLog: (
+  obj: ExternalSourcesRetrieveAndGenerateConfiguration
+) => any;
 export declare const GenerationConfigurationFilterSensitiveLog: (
   obj: GenerationConfiguration
 ) => any;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@aws-sdk/client-bedrock-agent-runtime",
   "description": "AWS SDK for JavaScript Bedrock Agent Runtime Client for Node.js, Browser and React Native",
-  "version": "3.560.0",
+  "version": "3.563.0",
   "scripts": {
     "build": "concurrently 'yarn:build:cjs' 'yarn:build:es' 'yarn:build:types'",
     "build:cjs": "node ../../scripts/compilation/inline client-bedrock-agent-runtime",
@@ -22,7 +22,7 @@
     "@aws-crypto/sha256-js": "3.0.0",
     "@aws-sdk/client-sts": "3.556.0",
     "@aws-sdk/core": "3.556.0",
-    "@aws-sdk/credential-provider-node": "3.556.0",
+    "@aws-sdk/credential-provider-node": "3.563.0",
     "@aws-sdk/middleware-host-header": "3.535.0",
     "@aws-sdk/middleware-logger": "3.535.0",
     "@aws-sdk/middleware-recursion-detection": "3.535.0",