Invoke Agent
| bedrockagentruntime_invoke_agent | R Documentation |
Sends a prompt for the agent to process and respond to¶
Description¶
Sends a prompt for the agent to process and respond to. Note the following fields for the request:
-
To continue the same conversation with an agent, use the same
sessionIdvalue in the request. -
To activate trace enablement, turn
enableTracetotrue. Trace enablement helps you follow the agent's reasoning process that led it to the information it processed, the actions it took, and the final result it yielded. For more information, see Trace enablement. -
End a conversation by setting
endSessiontotrue. -
In the
sessionStateobject, you can include attributes for the session or prompt or, if you configured an action group to return control, results from invocation of the action group.
The response contains both chunk and trace attributes.
The final response is returned in the bytes field of the chunk
object. The invoke_agent returns one chunk for the entire interaction.
-
The
attributionobject contains citations for parts of the response. -
If you set
enableTracetotruein the request, you can trace the agent's steps and reasoning process that led it to the response. -
If the action predicted was configured to return control, the response returns parameters for the action, elicited from the user, in the
returnControlfield. -
Errors are also surfaced in the response.
Usage¶
bedrockagentruntime_invoke_agent(agentAliasId, agentId,
bedrockModelConfigurations, enableTrace, endSession, inputText,
memoryId, sessionId, sessionState, sourceArn, streamingConfigurations)
Arguments¶
agentAliasId |
[required] The alias of the agent to use. |
agentId |
[required] The unique identifier of the agent to use. |
bedrockModelConfigurations |
Model performance settings for the request. |
enableTrace |
Specifies whether to turn on the trace or not to track the agent's reasoning process. For more information, see Trace enablement. |
endSession |
Specifies whether to end the session with the agent or not. |
inputText |
The prompt text to send the agent. If you include |
memoryId |
The unique identifier of the agent memory. |
sessionId |
[required] The unique identifier of the session. Use the same value across requests to continue the same conversation. |
sessionState |
Contains parameters that specify various attributes of the session. For more information, see Control session context. If you include |
sourceArn |
The ARN of the resource making the request. |
streamingConfigurations |
Specifies the configurations for streaming. To use agent streaming, you need permissions to perform the
|
Value¶
A list with the following syntax:
list(
completion = list(
accessDeniedException = list(
message = "string"
),
badGatewayException = list(
message = "string",
resourceName = "string"
),
chunk = list(
attribution = list(
citations = list(
list(
generatedResponsePart = list(
textResponsePart = list(
span = list(
end = 123,
start = 123
),
text = "string"
)
),
retrievedReferences = list(
list(
content = list(
byteContent = "string",
row = list(
list(
columnName = "string",
columnValue = "string",
type = "BLOB"|"BOOLEAN"|"DOUBLE"|"NULL"|"LONG"|"STRING"
)
),
text = "string",
type = "TEXT"|"IMAGE"|"ROW"
),
location = list(
confluenceLocation = list(
url = "string"
),
customDocumentLocation = list(
id = "string"
),
kendraDocumentLocation = list(
uri = "string"
),
s3Location = list(
uri = "string"
),
salesforceLocation = list(
url = "string"
),
sharePointLocation = list(
url = "string"
),
sqlLocation = list(
query = "string"
),
type = "S3"|"WEB"|"CONFLUENCE"|"SALESFORCE"|"SHAREPOINT"|"CUSTOM"|"KENDRA"|"SQL",
webLocation = list(
url = "string"
)
),
metadata = list(
list()
)
)
)
)
)
),
bytes = raw
),
conflictException = list(
message = "string"
),
dependencyFailedException = list(
message = "string",
resourceName = "string"
),
files = list(
files = list(
list(
bytes = raw,
name = "string",
type = "string"
)
)
),
internalServerException = list(
message = "string",
reason = "string"
),
modelNotReadyException = list(
message = "string"
),
resourceNotFoundException = list(
message = "string"
),
returnControl = list(
invocationId = "string",
invocationInputs = list(
list(
apiInvocationInput = list(
actionGroup = "string",
actionInvocationType = "RESULT"|"USER_CONFIRMATION"|"USER_CONFIRMATION_AND_RESULT",
agentId = "string",
apiPath = "string",
collaboratorName = "string",
httpMethod = "string",
parameters = list(
list(
name = "string",
type = "string",
value = "string"
)
),
requestBody = list(
content = list(
list(
properties = list(
list(
name = "string",
type = "string",
value = "string"
)
)
)
)
)
),
functionInvocationInput = list(
actionGroup = "string",
actionInvocationType = "RESULT"|"USER_CONFIRMATION"|"USER_CONFIRMATION_AND_RESULT",
agentId = "string",
collaboratorName = "string",
function = "string",
parameters = list(
list(
name = "string",
type = "string",
value = "string"
)
)
)
)
)
),
serviceQuotaExceededException = list(
message = "string"
),
throttlingException = list(
message = "string"
),
trace = list(
agentAliasId = "string",
agentId = "string",
agentVersion = "string",
callerChain = list(
list(
agentAliasArn = "string"
)
),
collaboratorName = "string",
eventTime = as.POSIXct(
"2015-01-01"
),
sessionId = "string",
trace = list(
customOrchestrationTrace = list(
event = list(
text = "string"
),
traceId = "string"
),
failureTrace = list(
failureCode = 123,
failureReason = "string",
metadata = list(
clientRequestId = "string",
endTime = as.POSIXct(
"2015-01-01"
),
operationTotalTimeMs = 123,
startTime = as.POSIXct(
"2015-01-01"
),
totalTimeMs = 123,
usage = list(
inputTokens = 123,
outputTokens = 123
)
),
traceId = "string"
),
guardrailTrace = list(
action = "INTERVENED"|"NONE",
inputAssessments = list(
list(
contentPolicy = list(
filters = list(
list(
action = "BLOCKED",
confidence = "NONE"|"LOW"|"MEDIUM"|"HIGH",
type = "INSULTS"|"HATE"|"SEXUAL"|"VIOLENCE"|"MISCONDUCT"|"PROMPT_ATTACK"
)
)
),
sensitiveInformationPolicy = list(
piiEntities = list(
list(
action = "BLOCKED"|"ANONYMIZED",
match = "string",
type = "ADDRESS"|"AGE"|"AWS_ACCESS_KEY"|"AWS_SECRET_KEY"|"CA_HEALTH_NUMBER"|"CA_SOCIAL_INSURANCE_NUMBER"|"CREDIT_DEBIT_CARD_CVV"|"CREDIT_DEBIT_CARD_EXPIRY"|"CREDIT_DEBIT_CARD_NUMBER"|"DRIVER_ID"|"EMAIL"|"INTERNATIONAL_BANK_ACCOUNT_NUMBER"|"IP_ADDRESS"|"LICENSE_PLATE"|"MAC_ADDRESS"|"NAME"|"PASSWORD"|"PHONE"|"PIN"|"SWIFT_CODE"|"UK_NATIONAL_HEALTH_SERVICE_NUMBER"|"UK_NATIONAL_INSURANCE_NUMBER"|"UK_UNIQUE_TAXPAYER_REFERENCE_NUMBER"|"URL"|"USERNAME"|"US_BANK_ACCOUNT_NUMBER"|"US_BANK_ROUTING_NUMBER"|"US_INDIVIDUAL_TAX_IDENTIFICATION_NUMBER"|"US_PASSPORT_NUMBER"|"US_SOCIAL_SECURITY_NUMBER"|"VEHICLE_IDENTIFICATION_NUMBER"
)
),
regexes = list(
list(
action = "BLOCKED"|"ANONYMIZED",
match = "string",
name = "string",
regex = "string"
)
)
),
topicPolicy = list(
topics = list(
list(
action = "BLOCKED",
name = "string",
type = "DENY"
)
)
),
wordPolicy = list(
customWords = list(
list(
action = "BLOCKED",
match = "string"
)
),
managedWordLists = list(
list(
action = "BLOCKED",
match = "string",
type = "PROFANITY"
)
)
)
)
),
metadata = list(
clientRequestId = "string",
endTime = as.POSIXct(
"2015-01-01"
),
operationTotalTimeMs = 123,
startTime = as.POSIXct(
"2015-01-01"
),
totalTimeMs = 123,
usage = list(
inputTokens = 123,
outputTokens = 123
)
),
outputAssessments = list(
list(
contentPolicy = list(
filters = list(
list(
action = "BLOCKED",
confidence = "NONE"|"LOW"|"MEDIUM"|"HIGH",
type = "INSULTS"|"HATE"|"SEXUAL"|"VIOLENCE"|"MISCONDUCT"|"PROMPT_ATTACK"
)
)
),
sensitiveInformationPolicy = list(
piiEntities = list(
list(
action = "BLOCKED"|"ANONYMIZED",
match = "string",
type = "ADDRESS"|"AGE"|"AWS_ACCESS_KEY"|"AWS_SECRET_KEY"|"CA_HEALTH_NUMBER"|"CA_SOCIAL_INSURANCE_NUMBER"|"CREDIT_DEBIT_CARD_CVV"|"CREDIT_DEBIT_CARD_EXPIRY"|"CREDIT_DEBIT_CARD_NUMBER"|"DRIVER_ID"|"EMAIL"|"INTERNATIONAL_BANK_ACCOUNT_NUMBER"|"IP_ADDRESS"|"LICENSE_PLATE"|"MAC_ADDRESS"|"NAME"|"PASSWORD"|"PHONE"|"PIN"|"SWIFT_CODE"|"UK_NATIONAL_HEALTH_SERVICE_NUMBER"|"UK_NATIONAL_INSURANCE_NUMBER"|"UK_UNIQUE_TAXPAYER_REFERENCE_NUMBER"|"URL"|"USERNAME"|"US_BANK_ACCOUNT_NUMBER"|"US_BANK_ROUTING_NUMBER"|"US_INDIVIDUAL_TAX_IDENTIFICATION_NUMBER"|"US_PASSPORT_NUMBER"|"US_SOCIAL_SECURITY_NUMBER"|"VEHICLE_IDENTIFICATION_NUMBER"
)
),
regexes = list(
list(
action = "BLOCKED"|"ANONYMIZED",
match = "string",
name = "string",
regex = "string"
)
)
),
topicPolicy = list(
topics = list(
list(
action = "BLOCKED",
name = "string",
type = "DENY"
)
)
),
wordPolicy = list(
customWords = list(
list(
action = "BLOCKED",
match = "string"
)
),
managedWordLists = list(
list(
action = "BLOCKED",
match = "string",
type = "PROFANITY"
)
)
)
)
),
traceId = "string"
),
orchestrationTrace = list(
invocationInput = list(
actionGroupInvocationInput = list(
actionGroupName = "string",
apiPath = "string",
executionType = "LAMBDA"|"RETURN_CONTROL",
function = "string",
invocationId = "string",
parameters = list(
list(
name = "string",
type = "string",
value = "string"
)
),
requestBody = list(
content = list(
list(
list(
name = "string",
type = "string",
value = "string"
)
)
)
),
verb = "string"
),
agentCollaboratorInvocationInput = list(
agentCollaboratorAliasArn = "string",
agentCollaboratorName = "string",
input = list(
returnControlResults = list(
invocationId = "string",
returnControlInvocationResults = list(
list(
apiResult = list(
actionGroup = "string",
agentId = "string",
apiPath = "string",
confirmationState = "CONFIRM"|"DENY",
httpMethod = "string",
httpStatusCode = 123,
responseBody = list(
list(
body = "string",
images = list(
list(
format = "png"|"jpeg"|"gif"|"webp",
source = list(
bytes = raw
)
)
)
)
),
responseState = "FAILURE"|"REPROMPT"
),
functionResult = list(
actionGroup = "string",
agentId = "string",
confirmationState = "CONFIRM"|"DENY",
function = "string",
responseBody = list(
list(
body = "string",
images = list(
list(
format = "png"|"jpeg"|"gif"|"webp",
source = list(
bytes = raw
)
)
)
)
),
responseState = "FAILURE"|"REPROMPT"
)
)
)
),
text = "string",
type = "TEXT"|"RETURN_CONTROL"
)
),
codeInterpreterInvocationInput = list(
code = "string",
files = list(
"string"
)
),
invocationType = "ACTION_GROUP"|"KNOWLEDGE_BASE"|"FINISH"|"ACTION_GROUP_CODE_INTERPRETER"|"AGENT_COLLABORATOR",
knowledgeBaseLookupInput = list(
knowledgeBaseId = "string",
text = "string"
),
traceId = "string"
),
modelInvocationInput = list(
foundationModel = "string",
inferenceConfiguration = list(
maximumLength = 123,
stopSequences = list(
"string"
),
temperature = 123.0,
topK = 123,
topP = 123.0
),
overrideLambda = "string",
parserMode = "DEFAULT"|"OVERRIDDEN",
promptCreationMode = "DEFAULT"|"OVERRIDDEN",
text = "string",
traceId = "string",
type = "PRE_PROCESSING"|"ORCHESTRATION"|"KNOWLEDGE_BASE_RESPONSE_GENERATION"|"POST_PROCESSING"|"ROUTING_CLASSIFIER"
),
modelInvocationOutput = list(
metadata = list(
clientRequestId = "string",
endTime = as.POSIXct(
"2015-01-01"
),
operationTotalTimeMs = 123,
startTime = as.POSIXct(
"2015-01-01"
),
totalTimeMs = 123,
usage = list(
inputTokens = 123,
outputTokens = 123
)
),
rawResponse = list(
content = "string"
),
reasoningContent = list(
reasoningText = list(
signature = "string",
text = "string"
),
redactedContent = raw
),
traceId = "string"
),
observation = list(
actionGroupInvocationOutput = list(
metadata = list(
clientRequestId = "string",
endTime = as.POSIXct(
"2015-01-01"
),
operationTotalTimeMs = 123,
startTime = as.POSIXct(
"2015-01-01"
),
totalTimeMs = 123,
usage = list(
inputTokens = 123,
outputTokens = 123
)
),
text = "string"
),
agentCollaboratorInvocationOutput = list(
agentCollaboratorAliasArn = "string",
agentCollaboratorName = "string",
metadata = list(
clientRequestId = "string",
endTime = as.POSIXct(
"2015-01-01"
),
operationTotalTimeMs = 123,
startTime = as.POSIXct(
"2015-01-01"
),
totalTimeMs = 123,
usage = list(
inputTokens = 123,
outputTokens = 123
)
),
output = list(
returnControlPayload = list(
invocationId = "string",
invocationInputs = list(
list(
apiInvocationInput = list(
actionGroup = "string",
actionInvocationType = "RESULT"|"USER_CONFIRMATION"|"USER_CONFIRMATION_AND_RESULT",
agentId = "string",
apiPath = "string",
collaboratorName = "string",
httpMethod = "string",
parameters = list(
list(
name = "string",
type = "string",
value = "string"
)
),
requestBody = list(
content = list(
list(
properties = list(
list(
name = "string",
type = "string",
value = "string"
)
)
)
)
)
),
functionInvocationInput = list(
actionGroup = "string",
actionInvocationType = "RESULT"|"USER_CONFIRMATION"|"USER_CONFIRMATION_AND_RESULT",
agentId = "string",
collaboratorName = "string",
function = "string",
parameters = list(
list(
name = "string",
type = "string",
value = "string"
)
)
)
)
)
),
text = "string",
type = "TEXT"|"RETURN_CONTROL"
)
),
codeInterpreterInvocationOutput = list(
executionError = "string",
executionOutput = "string",
executionTimeout = TRUE|FALSE,
files = list(
"string"
),
metadata = list(
clientRequestId = "string",
endTime = as.POSIXct(
"2015-01-01"
),
operationTotalTimeMs = 123,
startTime = as.POSIXct(
"2015-01-01"
),
totalTimeMs = 123,
usage = list(
inputTokens = 123,
outputTokens = 123
)
)
),
finalResponse = list(
metadata = list(
clientRequestId = "string",
endTime = as.POSIXct(
"2015-01-01"
),
operationTotalTimeMs = 123,
startTime = as.POSIXct(
"2015-01-01"
),
totalTimeMs = 123,
usage = list(
inputTokens = 123,
outputTokens = 123
)
),
text = "string"
),
knowledgeBaseLookupOutput = list(
metadata = list(
clientRequestId = "string",
endTime = as.POSIXct(
"2015-01-01"
),
operationTotalTimeMs = 123,
startTime = as.POSIXct(
"2015-01-01"
),
totalTimeMs = 123,
usage = list(
inputTokens = 123,
outputTokens = 123
)
),
retrievedReferences = list(
list(
content = list(
byteContent = "string",
row = list(
list(
columnName = "string",
columnValue = "string",
type = "BLOB"|"BOOLEAN"|"DOUBLE"|"NULL"|"LONG"|"STRING"
)
),
text = "string",
type = "TEXT"|"IMAGE"|"ROW"
),
location = list(
confluenceLocation = list(
url = "string"
),
customDocumentLocation = list(
id = "string"
),
kendraDocumentLocation = list(
uri = "string"
),
s3Location = list(
uri = "string"
),
salesforceLocation = list(
url = "string"
),
sharePointLocation = list(
url = "string"
),
sqlLocation = list(
query = "string"
),
type = "S3"|"WEB"|"CONFLUENCE"|"SALESFORCE"|"SHAREPOINT"|"CUSTOM"|"KENDRA"|"SQL",
webLocation = list(
url = "string"
)
),
metadata = list(
list()
)
)
)
),
repromptResponse = list(
source = "ACTION_GROUP"|"KNOWLEDGE_BASE"|"PARSER",
text = "string"
),
traceId = "string",
type = "ACTION_GROUP"|"AGENT_COLLABORATOR"|"KNOWLEDGE_BASE"|"FINISH"|"ASK_USER"|"REPROMPT"
),
rationale = list(
text = "string",
traceId = "string"
)
),
postProcessingTrace = list(
modelInvocationInput = list(
foundationModel = "string",
inferenceConfiguration = list(
maximumLength = 123,
stopSequences = list(
"string"
),
temperature = 123.0,
topK = 123,
topP = 123.0
),
overrideLambda = "string",
parserMode = "DEFAULT"|"OVERRIDDEN",
promptCreationMode = "DEFAULT"|"OVERRIDDEN",
text = "string",
traceId = "string",
type = "PRE_PROCESSING"|"ORCHESTRATION"|"KNOWLEDGE_BASE_RESPONSE_GENERATION"|"POST_PROCESSING"|"ROUTING_CLASSIFIER"
),
modelInvocationOutput = list(
metadata = list(
clientRequestId = "string",
endTime = as.POSIXct(
"2015-01-01"
),
operationTotalTimeMs = 123,
startTime = as.POSIXct(
"2015-01-01"
),
totalTimeMs = 123,
usage = list(
inputTokens = 123,
outputTokens = 123
)
),
parsedResponse = list(
text = "string"
),
rawResponse = list(
content = "string"
),
reasoningContent = list(
reasoningText = list(
signature = "string",
text = "string"
),
redactedContent = raw
),
traceId = "string"
)
),
preProcessingTrace = list(
modelInvocationInput = list(
foundationModel = "string",
inferenceConfiguration = list(
maximumLength = 123,
stopSequences = list(
"string"
),
temperature = 123.0,
topK = 123,
topP = 123.0
),
overrideLambda = "string",
parserMode = "DEFAULT"|"OVERRIDDEN",
promptCreationMode = "DEFAULT"|"OVERRIDDEN",
text = "string",
traceId = "string",
type = "PRE_PROCESSING"|"ORCHESTRATION"|"KNOWLEDGE_BASE_RESPONSE_GENERATION"|"POST_PROCESSING"|"ROUTING_CLASSIFIER"
),
modelInvocationOutput = list(
metadata = list(
clientRequestId = "string",
endTime = as.POSIXct(
"2015-01-01"
),
operationTotalTimeMs = 123,
startTime = as.POSIXct(
"2015-01-01"
),
totalTimeMs = 123,
usage = list(
inputTokens = 123,
outputTokens = 123
)
),
parsedResponse = list(
isValid = TRUE|FALSE,
rationale = "string"
),
rawResponse = list(
content = "string"
),
reasoningContent = list(
reasoningText = list(
signature = "string",
text = "string"
),
redactedContent = raw
),
traceId = "string"
)
),
routingClassifierTrace = list(
invocationInput = list(
actionGroupInvocationInput = list(
actionGroupName = "string",
apiPath = "string",
executionType = "LAMBDA"|"RETURN_CONTROL",
function = "string",
invocationId = "string",
parameters = list(
list(
name = "string",
type = "string",
value = "string"
)
),
requestBody = list(
content = list(
list(
list(
name = "string",
type = "string",
value = "string"
)
)
)
),
verb = "string"
),
agentCollaboratorInvocationInput = list(
agentCollaboratorAliasArn = "string",
agentCollaboratorName = "string",
input = list(
returnControlResults = list(
invocationId = "string",
returnControlInvocationResults = list(
list(
apiResult = list(
actionGroup = "string",
agentId = "string",
apiPath = "string",
confirmationState = "CONFIRM"|"DENY",
httpMethod = "string",
httpStatusCode = 123,
responseBody = list(
list(
body = "string",
images = list(
list(
format = "png"|"jpeg"|"gif"|"webp",
source = list(
bytes = raw
)
)
)
)
),
responseState = "FAILURE"|"REPROMPT"
),
functionResult = list(
actionGroup = "string",
agentId = "string",
confirmationState = "CONFIRM"|"DENY",
function = "string",
responseBody = list(
list(
body = "string",
images = list(
list(
format = "png"|"jpeg"|"gif"|"webp",
source = list(
bytes = raw
)
)
)
)
),
responseState = "FAILURE"|"REPROMPT"
)
)
)
),
text = "string",
type = "TEXT"|"RETURN_CONTROL"
)
),
codeInterpreterInvocationInput = list(
code = "string",
files = list(
"string"
)
),
invocationType = "ACTION_GROUP"|"KNOWLEDGE_BASE"|"FINISH"|"ACTION_GROUP_CODE_INTERPRETER"|"AGENT_COLLABORATOR",
knowledgeBaseLookupInput = list(
knowledgeBaseId = "string",
text = "string"
),
traceId = "string"
),
modelInvocationInput = list(
foundationModel = "string",
inferenceConfiguration = list(
maximumLength = 123,
stopSequences = list(
"string"
),
temperature = 123.0,
topK = 123,
topP = 123.0
),
overrideLambda = "string",
parserMode = "DEFAULT"|"OVERRIDDEN",
promptCreationMode = "DEFAULT"|"OVERRIDDEN",
text = "string",
traceId = "string",
type = "PRE_PROCESSING"|"ORCHESTRATION"|"KNOWLEDGE_BASE_RESPONSE_GENERATION"|"POST_PROCESSING"|"ROUTING_CLASSIFIER"
),
modelInvocationOutput = list(
metadata = list(
clientRequestId = "string",
endTime = as.POSIXct(
"2015-01-01"
),
operationTotalTimeMs = 123,
startTime = as.POSIXct(
"2015-01-01"
),
totalTimeMs = 123,
usage = list(
inputTokens = 123,
outputTokens = 123
)
),
rawResponse = list(
content = "string"
),
traceId = "string"
),
observation = list(
actionGroupInvocationOutput = list(
metadata = list(
clientRequestId = "string",
endTime = as.POSIXct(
"2015-01-01"
),
operationTotalTimeMs = 123,
startTime = as.POSIXct(
"2015-01-01"
),
totalTimeMs = 123,
usage = list(
inputTokens = 123,
outputTokens = 123
)
),
text = "string"
),
agentCollaboratorInvocationOutput = list(
agentCollaboratorAliasArn = "string",
agentCollaboratorName = "string",
metadata = list(
clientRequestId = "string",
endTime = as.POSIXct(
"2015-01-01"
),
operationTotalTimeMs = 123,
startTime = as.POSIXct(
"2015-01-01"
),
totalTimeMs = 123,
usage = list(
inputTokens = 123,
outputTokens = 123
)
),
output = list(
returnControlPayload = list(
invocationId = "string",
invocationInputs = list(
list(
apiInvocationInput = list(
actionGroup = "string",
actionInvocationType = "RESULT"|"USER_CONFIRMATION"|"USER_CONFIRMATION_AND_RESULT",
agentId = "string",
apiPath = "string",
collaboratorName = "string",
httpMethod = "string",
parameters = list(
list(
name = "string",
type = "string",
value = "string"
)
),
requestBody = list(
content = list(
list(
properties = list(
list(
name = "string",
type = "string",
value = "string"
)
)
)
)
)
),
functionInvocationInput = list(
actionGroup = "string",
actionInvocationType = "RESULT"|"USER_CONFIRMATION"|"USER_CONFIRMATION_AND_RESULT",
agentId = "string",
collaboratorName = "string",
function = "string",
parameters = list(
list(
name = "string",
type = "string",
value = "string"
)
)
)
)
)
),
text = "string",
type = "TEXT"|"RETURN_CONTROL"
)
),
codeInterpreterInvocationOutput = list(
executionError = "string",
executionOutput = "string",
executionTimeout = TRUE|FALSE,
files = list(
"string"
),
metadata = list(
clientRequestId = "string",
endTime = as.POSIXct(
"2015-01-01"
),
operationTotalTimeMs = 123,
startTime = as.POSIXct(
"2015-01-01"
),
totalTimeMs = 123,
usage = list(
inputTokens = 123,
outputTokens = 123
)
)
),
finalResponse = list(
metadata = list(
clientRequestId = "string",
endTime = as.POSIXct(
"2015-01-01"
),
operationTotalTimeMs = 123,
startTime = as.POSIXct(
"2015-01-01"
),
totalTimeMs = 123,
usage = list(
inputTokens = 123,
outputTokens = 123
)
),
text = "string"
),
knowledgeBaseLookupOutput = list(
metadata = list(
clientRequestId = "string",
endTime = as.POSIXct(
"2015-01-01"
),
operationTotalTimeMs = 123,
startTime = as.POSIXct(
"2015-01-01"
),
totalTimeMs = 123,
usage = list(
inputTokens = 123,
outputTokens = 123
)
),
retrievedReferences = list(
list(
content = list(
byteContent = "string",
row = list(
list(
columnName = "string",
columnValue = "string",
type = "BLOB"|"BOOLEAN"|"DOUBLE"|"NULL"|"LONG"|"STRING"
)
),
text = "string",
type = "TEXT"|"IMAGE"|"ROW"
),
location = list(
confluenceLocation = list(
url = "string"
),
customDocumentLocation = list(
id = "string"
),
kendraDocumentLocation = list(
uri = "string"
),
s3Location = list(
uri = "string"
),
salesforceLocation = list(
url = "string"
),
sharePointLocation = list(
url = "string"
),
sqlLocation = list(
query = "string"
),
type = "S3"|"WEB"|"CONFLUENCE"|"SALESFORCE"|"SHAREPOINT"|"CUSTOM"|"KENDRA"|"SQL",
webLocation = list(
url = "string"
)
),
metadata = list(
list()
)
)
)
),
repromptResponse = list(
source = "ACTION_GROUP"|"KNOWLEDGE_BASE"|"PARSER",
text = "string"
),
traceId = "string",
type = "ACTION_GROUP"|"AGENT_COLLABORATOR"|"KNOWLEDGE_BASE"|"FINISH"|"ASK_USER"|"REPROMPT"
)
)
)
),
validationException = list(
message = "string"
)
),
contentType = "string",
memoryId = "string",
sessionId = "string"
)
Request syntax¶
svc$invoke_agent(
agentAliasId = "string",
agentId = "string",
bedrockModelConfigurations = list(
performanceConfig = list(
latency = "standard"|"optimized"
)
),
enableTrace = TRUE|FALSE,
endSession = TRUE|FALSE,
inputText = "string",
memoryId = "string",
sessionId = "string",
sessionState = list(
conversationHistory = list(
messages = list(
list(
content = list(
list(
text = "string"
)
),
role = "user"|"assistant"
)
)
),
files = list(
list(
name = "string",
source = list(
byteContent = list(
data = raw,
mediaType = "string"
),
s3Location = list(
uri = "string"
),
sourceType = "S3"|"BYTE_CONTENT"
),
useCase = "CODE_INTERPRETER"|"CHAT"
)
),
invocationId = "string",
knowledgeBaseConfigurations = list(
list(
knowledgeBaseId = "string",
retrievalConfiguration = list(
vectorSearchConfiguration = list(
filter = list(
andAll = list(
list()
),
equals = list(
key = "string",
value = list()
),
greaterThan = list(
key = "string",
value = list()
),
greaterThanOrEquals = list(
key = "string",
value = list()
),
in = list(
key = "string",
value = list()
),
lessThan = list(
key = "string",
value = list()
),
lessThanOrEquals = list(
key = "string",
value = list()
),
listContains = list(
key = "string",
value = list()
),
notEquals = list(
key = "string",
value = list()
),
notIn = list(
key = "string",
value = list()
),
orAll = list(
list()
),
startsWith = list(
key = "string",
value = list()
),
stringContains = list(
key = "string",
value = list()
)
),
implicitFilterConfiguration = list(
metadataAttributes = list(
list(
description = "string",
key = "string",
type = "STRING"|"NUMBER"|"BOOLEAN"|"STRING_LIST"
)
),
modelArn = "string"
),
numberOfResults = 123,
overrideSearchType = "HYBRID"|"SEMANTIC",
rerankingConfiguration = list(
bedrockRerankingConfiguration = list(
metadataConfiguration = list(
selectionMode = "SELECTIVE"|"ALL",
selectiveModeConfiguration = list(
fieldsToExclude = list(
list(
fieldName = "string"
)
),
fieldsToInclude = list(
list(
fieldName = "string"
)
)
)
),
modelConfiguration = list(
additionalModelRequestFields = list(
list()
),
modelArn = "string"
),
numberOfRerankedResults = 123
),
type = "BEDROCK_RERANKING_MODEL"
)
)
)
)
),
promptSessionAttributes = list(
"string"
),
returnControlInvocationResults = list(
list(
apiResult = list(
actionGroup = "string",
agentId = "string",
apiPath = "string",
confirmationState = "CONFIRM"|"DENY",
httpMethod = "string",
httpStatusCode = 123,
responseBody = list(
list(
body = "string",
images = list(
list(
format = "png"|"jpeg"|"gif"|"webp",
source = list(
bytes = raw
)
)
)
)
),
responseState = "FAILURE"|"REPROMPT"
),
functionResult = list(
actionGroup = "string",
agentId = "string",
confirmationState = "CONFIRM"|"DENY",
function = "string",
responseBody = list(
list(
body = "string",
images = list(
list(
format = "png"|"jpeg"|"gif"|"webp",
source = list(
bytes = raw
)
)
)
)
),
responseState = "FAILURE"|"REPROMPT"
)
)
),
sessionAttributes = list(
"string"
)
),
sourceArn = "string",
streamingConfigurations = list(
applyGuardrailInterval = 123,
streamFinalResponse = TRUE|FALSE
)
)