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

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

@@ -26,7 +26,7 @@ declare const InvokeAgentCommand_base: {
     getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
 };
 /**
- * <p>Sends a prompt for the agent to process and respond to.</p>
+ * <p>Sends a prompt for the agent to process and respond to. Use return control event type for function calling.</p>
  *          <note>
  *             <p>The CLI doesn't support <code>InvokeAgent</code>.</p>
  *          </note>
@@ -41,7 +41,10 @@ declare const InvokeAgentCommand_base: {
  *                <p>End a conversation by setting <code>endSession</code> to <code>true</code>.</p>
  *             </li>
  *             <li>
- *                <p>Include attributes for the session or prompt in the <code>sessionState</code> object.</p>
+ *                <p>In the <code>sessionState</code> object, you can include attributes for the session or prompt or parameters returned from the action group.</p>
+ *             </li>
+ *             <li>
+ *                <p>Use return control event type for function calling.</p>
  *             </li>
  *          </ul>
  *          <p>The response is returned in the <code>bytes</code> field of the <code>chunk</code> object.</p>
@@ -70,13 +73,40 @@ declare const InvokeAgentCommand_base: {
  *     promptSessionAttributes: { // PromptSessionAttributesMap
  *       "<keys>": "STRING_VALUE",
  *     },
+ *     returnControlInvocationResults: [ // ReturnControlInvocationResults
+ *       { // InvocationResultMember Union: only one key present
+ *         apiResult: { // ApiResult
+ *           actionGroup: "STRING_VALUE", // required
+ *           httpMethod: "STRING_VALUE",
+ *           apiPath: "STRING_VALUE",
+ *           responseBody: { // ResponseBody
+ *             "<keys>": { // ContentBody
+ *               body: "STRING_VALUE",
+ *             },
+ *           },
+ *           httpStatusCode: Number("int"),
+ *           responseState: "FAILURE" || "REPROMPT",
+ *         },
+ *         functionResult: { // FunctionResult
+ *           actionGroup: "STRING_VALUE", // required
+ *           function: "STRING_VALUE",
+ *           responseBody: {
+ *             "<keys>": {
+ *               body: "STRING_VALUE",
+ *             },
+ *           },
+ *           responseState: "FAILURE" || "REPROMPT",
+ *         },
+ *       },
+ *     ],
+ *     invocationId: "STRING_VALUE",
  *   },
  *   agentId: "STRING_VALUE", // required
  *   agentAliasId: "STRING_VALUE", // required
  *   sessionId: "STRING_VALUE", // required
  *   endSession: true || false,
  *   enableTrace: true || false,
- *   inputText: "STRING_VALUE", // required
+ *   inputText: "STRING_VALUE",
  * };
  * const command = new InvokeAgentCommand(input);
  * const response = await client.send(command);
@@ -120,6 +150,7 @@ declare const InvokeAgentCommand_base: {
  * //       agentId: "STRING_VALUE",
  * //       agentAliasId: "STRING_VALUE",
  * //       sessionId: "STRING_VALUE",
+ * //       agentVersion: "STRING_VALUE",
  * //       trace: { // Trace Union: only one key present
  * //         preProcessingTrace: { // PreProcessingTrace Union: only one key present
  * //           modelInvocationInput: { // ModelInvocationInput
@@ -177,6 +208,7 @@ declare const InvokeAgentCommand_base: {
  * //                   ],
  * //                 },
  * //               },
+ * //               function: "STRING_VALUE",
  * //             },
  * //             knowledgeBaseLookupInput: { // KnowledgeBaseLookupInput
  * //               text: "STRING_VALUE",
@@ -264,6 +296,49 @@ declare const InvokeAgentCommand_base: {
  * //         },
  * //       },
  * //     },
+ * //     returnControl: { // ReturnControlPayload
+ * //       invocationInputs: [ // InvocationInputs
+ * //         { // InvocationInputMember Union: only one key present
+ * //           apiInvocationInput: { // ApiInvocationInput
+ * //             actionGroup: "STRING_VALUE", // required
+ * //             httpMethod: "STRING_VALUE",
+ * //             apiPath: "STRING_VALUE",
+ * //             parameters: [ // ApiParameters
+ * //               { // ApiParameter
+ * //                 name: "STRING_VALUE",
+ * //                 type: "STRING_VALUE",
+ * //                 value: "STRING_VALUE",
+ * //               },
+ * //             ],
+ * //             requestBody: { // ApiRequestBody
+ * //               content: { // ApiContentMap
+ * //                 "<keys>": { // PropertyParameters
+ * //                   properties: [ // ParameterList
+ * //                     {
+ * //                       name: "STRING_VALUE",
+ * //                       type: "STRING_VALUE",
+ * //                       value: "STRING_VALUE",
+ * //                     },
+ * //                   ],
+ * //                 },
+ * //               },
+ * //             },
+ * //           },
+ * //           functionInvocationInput: { // FunctionInvocationInput
+ * //             actionGroup: "STRING_VALUE", // required
+ * //             parameters: [ // FunctionParameters
+ * //               { // FunctionParameter
+ * //                 name: "STRING_VALUE",
+ * //                 type: "STRING_VALUE",
+ * //                 value: "STRING_VALUE",
+ * //               },
+ * //             ],
+ * //             function: "STRING_VALUE",
+ * //           },
+ * //         },
+ * //       ],
+ * //       invocationId: "STRING_VALUE",
+ * //     },
  * //     internalServerException: { // InternalServerException
  * //       message: "STRING_VALUE",
  * //     },
@@ -322,7 +397,7 @@ declare const InvokeAgentCommand_base: {
  *  <p>An internal server error occurred. Retry your request.</p>
  *
  * @throws {@link ResourceNotFoundException} (client fault)
- *  <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>
  *
  * @throws {@link ServiceQuotaExceededException} (client fault)
  *  <p>The number of requests exceeds the service quota. Resubmit your request later.</p>

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
@@ -170,7 +191,7 @@ declare const RetrieveAndGenerateCommand_base: {
  *  <p>An internal server error occurred. Retry your request.</p>
  *
  * @throws {@link ResourceNotFoundException} (client fault)
- *  <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>
  *
  * @throws {@link ServiceQuotaExceededException} (client fault)
  *  <p>The number of requests exceeds the service quota. Resubmit your request later.</p>

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

@@ -141,7 +141,7 @@ declare const RetrieveCommand_base: {
  *  <p>An internal server error occurred. Retry your request.</p>
  *
  * @throws {@link ResourceNotFoundException} (client fault)
- *  <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>
  *
  * @throws {@link ServiceQuotaExceededException} (client fault)
  *  <p>The number of requests exceeds the service quota. Resubmit your request later.</p>