AgentsforBedrockRuntimeClient

Index > AgentsforBedrockRuntime > AgentsforBedrockRuntimeClient

Auto-generated documentation for AgentsforBedrockRuntime type annotations stubs module mypy-boto3-bedrock-agent-runtime.

AgentsforBedrockRuntimeClient

Type annotations and code completion for boto3.client("bedrock-agent-runtime"). boto3 documentation

# AgentsforBedrockRuntimeClient usage example

from boto3.session import Session
from mypy_boto3_bedrock_agent_runtime.client import AgentsforBedrockRuntimeClient

def get_bedrock-agent-runtime_client() -> AgentsforBedrockRuntimeClient:
    return Session().client("bedrock-agent-runtime")

Exceptions

boto3 client exceptions are generated in runtime. This class provides code completion for boto3.client("bedrock-agent-runtime").exceptions structure.

# Exceptions.exceptions usage example

client = boto3.client("bedrock-agent-runtime")

try:
    do_something(client)
except (
    client.exceptions.AccessDeniedException,
    client.exceptions.BadGatewayException,
    client.exceptions.ClientError,
    client.exceptions.ConflictException,
    client.exceptions.DependencyFailedException,
    client.exceptions.InternalServerException,
    client.exceptions.ModelNotReadyException,
    client.exceptions.ResourceNotFoundException,
    client.exceptions.ServiceQuotaExceededException,
    client.exceptions.ThrottlingException,
    client.exceptions.ValidationException,
) as e:
    print(e)

# Exceptions.exceptions type checking example

from mypy_boto3_bedrock_agent_runtime.client import Exceptions

def handle_error(exc: Exceptions.AccessDeniedException) -> None:
    ...

Methods

can_paginate

Type annotations and code completion for boto3.client("bedrock-agent-runtime").can_paginate method. boto3 documentation

# can_paginate method definition

def can_paginate(
    self,
    operation_name: str,
) -> bool:
    ...

generate_presigned_url

Type annotations and code completion for boto3.client("bedrock-agent-runtime").generate_presigned_url method. boto3 documentation

# generate_presigned_url method definition

def generate_presigned_url(
    self,
    ClientMethod: str,
    Params: Mapping[str, Any] = ...,
    ExpiresIn: int = 3600,
    HttpMethod: str = ...,
) -> str:
    ...

agentic_retrieve_stream

Retrieves information from one or more knowledge bases using an agentic approach.

Type annotations and code completion for boto3.client("bedrock-agent-runtime").agentic_retrieve_stream method. boto3 documentation

# agentic_retrieve_stream method definition

def agentic_retrieve_stream(
    self,
    *,
    agenticRetrieveConfiguration: AgenticRetrieveConfigurationTypeDef,  # (1)
    messages: Sequence[AgenticRetrieveMessageTypeDef],  # (2)
    retrievers: Sequence[AgenticRetrieverTypeDef],  # (3)
    generateResponse: bool = ...,
    memoryConfiguration: AgenticRetrieveMemoryConfigurationTypeDef = ...,  # (4)
    nextToken: str = ...,
    policyConfiguration: AgenticRetrievePolicyConfigurationTypeDef = ...,  # (5)
    userContext: UserContextTypeDef = ...,  # (6)
) -> AgenticRetrieveStreamResponseTypeDef:  # (7)
    ...

1. See AgenticRetrieveConfigurationTypeDef
2. See Sequence[AgenticRetrieveMessageTypeDef]
3. See Sequence[AgenticRetrieverTypeDef]
4. See AgenticRetrieveMemoryConfigurationTypeDef
5. See AgenticRetrievePolicyConfigurationTypeDef
6. See UserContextTypeDef
7. See AgenticRetrieveStreamResponseTypeDef

# agentic_retrieve_stream method usage example with argument unpacking

kwargs: AgenticRetrieveStreamRequestTypeDef = {  # (1)
    "agenticRetrieveConfiguration": ...,
    "messages": ...,
    "retrievers": ...,
}

parent.agentic_retrieve_stream(**kwargs)

1. See AgenticRetrieveStreamRequestTypeDef

check_ingested_document_acl

Checks whether a user has access to a specific document by verifying against the ingested access control list (ACL) in a knowledge base.

Type annotations and code completion for boto3.client("bedrock-agent-runtime").check_ingested_document_acl method. boto3 documentation

# check_ingested_document_acl method definition

def check_ingested_document_acl(
    self,
    *,
    dataSourceId: str,
    documentId: str,
    knowledgeBaseId: str,
    userContext: UserContextTypeDef,  # (1)
) -> CheckIngestedDocumentAclResponseTypeDef:  # (2)
    ...

1. See UserContextTypeDef
2. See CheckIngestedDocumentAclResponseTypeDef

# check_ingested_document_acl method usage example with argument unpacking

kwargs: CheckIngestedDocumentAclRequestTypeDef = {  # (1)
    "dataSourceId": ...,
    "documentId": ...,
    "knowledgeBaseId": ...,
    "userContext": ...,
}

parent.check_ingested_document_acl(**kwargs)

1. See CheckIngestedDocumentAclRequestTypeDef

create_invocation

Creates a new invocation within a session.

Type annotations and code completion for boto3.client("bedrock-agent-runtime").create_invocation method. boto3 documentation

# create_invocation method definition

def create_invocation(
    self,
    *,
    sessionIdentifier: str,
    description: str = ...,
    invocationId: str = ...,
) -> CreateInvocationResponseTypeDef:  # (1)
    ...

1. See CreateInvocationResponseTypeDef

# create_invocation method usage example with argument unpacking

kwargs: CreateInvocationRequestTypeDef = {  # (1)
    "sessionIdentifier": ...,
}

parent.create_invocation(**kwargs)

1. See CreateInvocationRequestTypeDef

create_session

Creates a session to temporarily store conversations for generative AI (GenAI) applications built with open-source frameworks such as LangGraph and LlamaIndex.

Type annotations and code completion for boto3.client("bedrock-agent-runtime").create_session method. boto3 documentation

# create_session method definition

def create_session(
    self,
    *,
    encryptionKeyArn: str = ...,
    sessionMetadata: Mapping[str, str] = ...,
    tags: Mapping[str, str] = ...,
) -> CreateSessionResponseTypeDef:  # (1)
    ...

1. See CreateSessionResponseTypeDef

# create_session method usage example with argument unpacking

kwargs: CreateSessionRequestTypeDef = {  # (1)
    "encryptionKeyArn": ...,
}

parent.create_session(**kwargs)

1. See CreateSessionRequestTypeDef

delete_agent_memory

Deletes memory from the specified memory identifier.

Type annotations and code completion for boto3.client("bedrock-agent-runtime").delete_agent_memory method. boto3 documentation

# delete_agent_memory method definition

def delete_agent_memory(
    self,
    *,
    agentAliasId: str,
    agentId: str,
    memoryId: str = ...,
    sessionId: str = ...,
) -> dict[str, Any]:
    ...

# delete_agent_memory method usage example with argument unpacking

kwargs: DeleteAgentMemoryRequestTypeDef = {  # (1)
    "agentAliasId": ...,
    "agentId": ...,
}

parent.delete_agent_memory(**kwargs)

1. See DeleteAgentMemoryRequestTypeDef

delete_session

Deletes a session that you ended.

Type annotations and code completion for boto3.client("bedrock-agent-runtime").delete_session method. boto3 documentation

# delete_session method definition

def delete_session(
    self,
    *,
    sessionIdentifier: str,
) -> dict[str, Any]:
    ...

# delete_session method usage example with argument unpacking

kwargs: DeleteSessionRequestTypeDef = {  # (1)
    "sessionIdentifier": ...,
}

parent.delete_session(**kwargs)

1. See DeleteSessionRequestTypeDef

end_session

Ends the session.

Type annotations and code completion for boto3.client("bedrock-agent-runtime").end_session method. boto3 documentation

# end_session method definition

def end_session(
    self,
    *,
    sessionIdentifier: str,
) -> EndSessionResponseTypeDef:  # (1)
    ...

1. See EndSessionResponseTypeDef

# end_session method usage example with argument unpacking

kwargs: EndSessionRequestTypeDef = {  # (1)
    "sessionIdentifier": ...,
}

parent.end_session(**kwargs)

1. See EndSessionRequestTypeDef

generate_query

Generates an SQL query from a natural language query.

Type annotations and code completion for boto3.client("bedrock-agent-runtime").generate_query method. boto3 documentation

# generate_query method definition

def generate_query(
    self,
    *,
    queryGenerationInput: QueryGenerationInputTypeDef,  # (1)
    transformationConfiguration: TransformationConfigurationTypeDef,  # (2)
) -> GenerateQueryResponseTypeDef:  # (3)
    ...

1. See QueryGenerationInputTypeDef
2. See TransformationConfigurationTypeDef
3. See GenerateQueryResponseTypeDef

# generate_query method usage example with argument unpacking

kwargs: GenerateQueryRequestTypeDef = {  # (1)
    "queryGenerationInput": ...,
    "transformationConfiguration": ...,
}

parent.generate_query(**kwargs)

1. See GenerateQueryRequestTypeDef

get_agent_memory

Gets the sessions stored in the memory of the agent.

Type annotations and code completion for boto3.client("bedrock-agent-runtime").get_agent_memory method. boto3 documentation

# get_agent_memory method definition

def get_agent_memory(
    self,
    *,
    agentAliasId: str,
    agentId: str,
    memoryId: str,
    memoryType: MemoryTypeType,  # (1)
    maxItems: int = ...,
    nextToken: str = ...,
) -> GetAgentMemoryResponseTypeDef:  # (2)
    ...

1. See MemoryTypeType
2. See GetAgentMemoryResponseTypeDef

# get_agent_memory method usage example with argument unpacking

kwargs: GetAgentMemoryRequestTypeDef = {  # (1)
    "agentAliasId": ...,
    "agentId": ...,
    "memoryId": ...,
    "memoryType": ...,
}

parent.get_agent_memory(**kwargs)

1. See GetAgentMemoryRequestTypeDef

get_document_content

Retrieves the content of an ingested document from a knowledge base.

Type annotations and code completion for boto3.client("bedrock-agent-runtime").get_document_content method. boto3 documentation

# get_document_content method definition

def get_document_content(
    self,
    *,
    dataSourceId: str,
    documentId: str,
    knowledgeBaseId: str,
    outputFormat: DocumentOutputFormatType = ...,  # (1)
    userContext: UserContextTypeDef = ...,  # (2)
) -> GetDocumentContentResponseTypeDef:  # (3)
    ...

1. See DocumentOutputFormatType
2. See UserContextTypeDef
3. See GetDocumentContentResponseTypeDef

# get_document_content method usage example with argument unpacking

kwargs: GetDocumentContentRequestTypeDef = {  # (1)
    "dataSourceId": ...,
    "documentId": ...,
    "knowledgeBaseId": ...,
}

parent.get_document_content(**kwargs)

1. See GetDocumentContentRequestTypeDef

get_execution_flow_snapshot

Retrieves the flow definition snapshot used for a flow execution.

Type annotations and code completion for boto3.client("bedrock-agent-runtime").get_execution_flow_snapshot method. boto3 documentation

# get_execution_flow_snapshot method definition

def get_execution_flow_snapshot(
    self,
    *,
    executionIdentifier: str,
    flowAliasIdentifier: str,
    flowIdentifier: str,
) -> GetExecutionFlowSnapshotResponseTypeDef:  # (1)
    ...

1. See GetExecutionFlowSnapshotResponseTypeDef

# get_execution_flow_snapshot method usage example with argument unpacking

kwargs: GetExecutionFlowSnapshotRequestTypeDef = {  # (1)
    "executionIdentifier": ...,
    "flowAliasIdentifier": ...,
    "flowIdentifier": ...,
}

parent.get_execution_flow_snapshot(**kwargs)

1. See GetExecutionFlowSnapshotRequestTypeDef

get_flow_execution

Retrieves details about a specific flow execution, including its status, start and end times, and any errors that occurred during execution.

Type annotations and code completion for boto3.client("bedrock-agent-runtime").get_flow_execution method. boto3 documentation

# get_flow_execution method definition

def get_flow_execution(
    self,
    *,
    executionIdentifier: str,
    flowAliasIdentifier: str,
    flowIdentifier: str,
) -> GetFlowExecutionResponseTypeDef:  # (1)
    ...

1. See GetFlowExecutionResponseTypeDef

# get_flow_execution method usage example with argument unpacking

kwargs: GetFlowExecutionRequestTypeDef = {  # (1)
    "executionIdentifier": ...,
    "flowAliasIdentifier": ...,
    "flowIdentifier": ...,
}

parent.get_flow_execution(**kwargs)

1. See GetFlowExecutionRequestTypeDef

get_ingested_document_acl

Retrieves the ingested access control list (ACL) for a specific document in a knowledge base.

Type annotations and code completion for boto3.client("bedrock-agent-runtime").get_ingested_document_acl method. boto3 documentation

# get_ingested_document_acl method definition

def get_ingested_document_acl(
    self,
    *,
    dataSourceId: str,
    documentId: str,
    knowledgeBaseId: str,
) -> GetIngestedDocumentAclResponseTypeDef:  # (1)
    ...

1. See GetIngestedDocumentAclResponseTypeDef

# get_ingested_document_acl method usage example with argument unpacking

kwargs: GetIngestedDocumentAclRequestTypeDef = {  # (1)
    "dataSourceId": ...,
    "documentId": ...,
    "knowledgeBaseId": ...,
}

parent.get_ingested_document_acl(**kwargs)

1. See GetIngestedDocumentAclRequestTypeDef

get_invocation_step

Retrieves the details of a specific invocation step within an invocation in a session.

Type annotations and code completion for boto3.client("bedrock-agent-runtime").get_invocation_step method. boto3 documentation

# get_invocation_step method definition

def get_invocation_step(
    self,
    *,
    invocationIdentifier: str,
    invocationStepId: str,
    sessionIdentifier: str,
) -> GetInvocationStepResponseTypeDef:  # (1)
    ...

1. See GetInvocationStepResponseTypeDef

# get_invocation_step method usage example with argument unpacking

kwargs: GetInvocationStepRequestTypeDef = {  # (1)
    "invocationIdentifier": ...,
    "invocationStepId": ...,
    "sessionIdentifier": ...,
}

parent.get_invocation_step(**kwargs)

1. See GetInvocationStepRequestTypeDef

get_session

Retrieves details about a specific session.

Type annotations and code completion for boto3.client("bedrock-agent-runtime").get_session method. boto3 documentation

# get_session method definition

def get_session(
    self,
    *,
    sessionIdentifier: str,
) -> GetSessionResponseTypeDef:  # (1)
    ...

1. See GetSessionResponseTypeDef

# get_session method usage example with argument unpacking

kwargs: GetSessionRequestTypeDef = {  # (1)
    "sessionIdentifier": ...,
}

parent.get_session(**kwargs)

1. See GetSessionRequestTypeDef

invoke_agent

Amazon Bedrock Agents (now Amazon Bedrock Agents Classic) is no longer open to new customers.

Type annotations and code completion for boto3.client("bedrock-agent-runtime").invoke_agent method. boto3 documentation

# invoke_agent method definition

def invoke_agent(
    self,
    *,
    agentAliasId: str,
    agentId: str,
    sessionId: str,
    bedrockModelConfigurations: BedrockModelConfigurationsTypeDef = ...,  # (1)
    enableTrace: bool = ...,
    endSession: bool = ...,
    inputText: str = ...,
    memoryId: str = ...,
    promptCreationConfigurations: PromptCreationConfigurationsTypeDef = ...,  # (2)
    sessionState: SessionStateTypeDef = ...,  # (3)
    sourceArn: str = ...,
    streamingConfigurations: StreamingConfigurationsTypeDef = ...,  # (4)
) -> InvokeAgentResponseTypeDef:  # (5)
    ...

1. See BedrockModelConfigurationsTypeDef
2. See PromptCreationConfigurationsTypeDef
3. See SessionStateTypeDef
4. See StreamingConfigurationsTypeDef
5. See InvokeAgentResponseTypeDef

# invoke_agent method usage example with argument unpacking

kwargs: InvokeAgentRequestTypeDef = {  # (1)
    "agentAliasId": ...,
    "agentId": ...,
    "sessionId": ...,
}

parent.invoke_agent(**kwargs)

1. See InvokeAgentRequestTypeDef

invoke_flow

Invokes an alias of a flow to run the inputs that you specify and return the output of each node as a stream.

Type annotations and code completion for boto3.client("bedrock-agent-runtime").invoke_flow method. boto3 documentation

# invoke_flow method definition

def invoke_flow(
    self,
    *,
    flowAliasIdentifier: str,
    flowIdentifier: str,
    inputs: Sequence[FlowInputTypeDef],  # (1)
    enableTrace: bool = ...,
    executionId: str = ...,
    modelPerformanceConfiguration: ModelPerformanceConfigurationTypeDef = ...,  # (2)
) -> InvokeFlowResponseTypeDef:  # (3)
    ...

1. See Sequence[FlowInputTypeDef]
2. See ModelPerformanceConfigurationTypeDef
3. See InvokeFlowResponseTypeDef

# invoke_flow method usage example with argument unpacking

kwargs: InvokeFlowRequestTypeDef = {  # (1)
    "flowAliasIdentifier": ...,
    "flowIdentifier": ...,
    "inputs": ...,
}

parent.invoke_flow(**kwargs)

1. See InvokeFlowRequestTypeDef

invoke_inline_agent

Invokes an inline Amazon Bedrock agent using the configurations you provide with the request.

Type annotations and code completion for boto3.client("bedrock-agent-runtime").invoke_inline_agent method. boto3 documentation

# invoke_inline_agent method definition

def invoke_inline_agent(
    self,
    *,
    foundationModel: str,
    instruction: str,
    sessionId: str,
    actionGroups: Sequence[AgentActionGroupTypeDef] = ...,  # (1)
    agentCollaboration: AgentCollaborationType = ...,  # (2)
    agentName: str = ...,
    bedrockModelConfigurations: InlineBedrockModelConfigurationsTypeDef = ...,  # (3)
    collaboratorConfigurations: Sequence[CollaboratorConfigurationTypeDef] = ...,  # (4)
    collaborators: Sequence[CollaboratorTypeDef] = ...,  # (5)
    customOrchestration: CustomOrchestrationTypeDef = ...,  # (6)
    customerEncryptionKeyArn: str = ...,
    enableTrace: bool = ...,
    endSession: bool = ...,
    guardrailConfiguration: GuardrailConfigurationWithArnTypeDef = ...,  # (7)
    idleSessionTTLInSeconds: int = ...,
    inlineSessionState: InlineSessionStateTypeDef = ...,  # (8)
    inputText: str = ...,
    knowledgeBases: Sequence[KnowledgeBaseTypeDef] = ...,  # (9)
    orchestrationType: OrchestrationTypeType = ...,  # (10)
    promptCreationConfigurations: PromptCreationConfigurationsTypeDef = ...,  # (11)
    promptOverrideConfiguration: PromptOverrideConfigurationTypeDef = ...,  # (12)
    streamingConfigurations: StreamingConfigurationsTypeDef = ...,  # (13)
) -> InvokeInlineAgentResponseTypeDef:  # (14)
    ...

1. See Sequence[AgentActionGroupTypeDef]
2. See AgentCollaborationType
3. See InlineBedrockModelConfigurationsTypeDef
4. See Sequence[CollaboratorConfigurationTypeDef]
5. See Sequence[CollaboratorTypeDef]
6. See CustomOrchestrationTypeDef
7. See GuardrailConfigurationWithArnTypeDef
8. See InlineSessionStateTypeDef
9. See Sequence[KnowledgeBaseTypeDef]
10. See OrchestrationTypeType
11. See PromptCreationConfigurationsTypeDef
12. See PromptOverrideConfigurationTypeDef
13. See StreamingConfigurationsTypeDef
14. See InvokeInlineAgentResponseTypeDef

# invoke_inline_agent method usage example with argument unpacking

kwargs: InvokeInlineAgentRequestTypeDef = {  # (1)
    "foundationModel": ...,
    "instruction": ...,
    "sessionId": ...,
}

parent.invoke_inline_agent(**kwargs)

1. See InvokeInlineAgentRequestTypeDef

list_flow_execution_events

Lists events that occurred during a flow execution.

Type annotations and code completion for boto3.client("bedrock-agent-runtime").list_flow_execution_events method. boto3 documentation

# list_flow_execution_events method definition

def list_flow_execution_events(
    self,
    *,
    eventType: FlowExecutionEventTypeType,  # (1)
    executionIdentifier: str,
    flowAliasIdentifier: str,
    flowIdentifier: str,
    maxResults: int = ...,
    nextToken: str = ...,
) -> ListFlowExecutionEventsResponseTypeDef:  # (2)
    ...

1. See FlowExecutionEventTypeType
2. See ListFlowExecutionEventsResponseTypeDef

# list_flow_execution_events method usage example with argument unpacking

kwargs: ListFlowExecutionEventsRequestTypeDef = {  # (1)
    "eventType": ...,
    "executionIdentifier": ...,
    "flowAliasIdentifier": ...,
    "flowIdentifier": ...,
}

parent.list_flow_execution_events(**kwargs)

1. See ListFlowExecutionEventsRequestTypeDef

list_flow_executions

Lists all executions of a flow.

Type annotations and code completion for boto3.client("bedrock-agent-runtime").list_flow_executions method. boto3 documentation

# list_flow_executions method definition

def list_flow_executions(
    self,
    *,
    flowIdentifier: str,
    flowAliasIdentifier: str = ...,
    maxResults: int = ...,
    nextToken: str = ...,
) -> ListFlowExecutionsResponseTypeDef:  # (1)
    ...

1. See ListFlowExecutionsResponseTypeDef

# list_flow_executions method usage example with argument unpacking

kwargs: ListFlowExecutionsRequestTypeDef = {  # (1)
    "flowIdentifier": ...,
}

parent.list_flow_executions(**kwargs)

1. See ListFlowExecutionsRequestTypeDef

list_invocation_steps

Lists all invocation steps associated with a session and optionally, an invocation within the session.

Type annotations and code completion for boto3.client("bedrock-agent-runtime").list_invocation_steps method. boto3 documentation

# list_invocation_steps method definition

def list_invocation_steps(
    self,
    *,
    sessionIdentifier: str,
    invocationIdentifier: str = ...,
    maxResults: int = ...,
    nextToken: str = ...,
) -> ListInvocationStepsResponseTypeDef:  # (1)
    ...

1. See ListInvocationStepsResponseTypeDef

# list_invocation_steps method usage example with argument unpacking

kwargs: ListInvocationStepsRequestTypeDef = {  # (1)
    "sessionIdentifier": ...,
}

parent.list_invocation_steps(**kwargs)

1. See ListInvocationStepsRequestTypeDef

list_invocations

Lists all invocations associated with a specific session.

Type annotations and code completion for boto3.client("bedrock-agent-runtime").list_invocations method. boto3 documentation

# list_invocations method definition

def list_invocations(
    self,
    *,
    sessionIdentifier: str,
    maxResults: int = ...,
    nextToken: str = ...,
) -> ListInvocationsResponseTypeDef:  # (1)
    ...

1. See ListInvocationsResponseTypeDef

# list_invocations method usage example with argument unpacking

kwargs: ListInvocationsRequestTypeDef = {  # (1)
    "sessionIdentifier": ...,
}

parent.list_invocations(**kwargs)

1. See ListInvocationsRequestTypeDef

list_sessions

Lists all sessions in your Amazon Web Services account.

Type annotations and code completion for boto3.client("bedrock-agent-runtime").list_sessions method. boto3 documentation

# list_sessions method definition

def list_sessions(
    self,
    *,
    maxResults: int = ...,
    nextToken: str = ...,
) -> ListSessionsResponseTypeDef:  # (1)
    ...

1. See ListSessionsResponseTypeDef

# list_sessions method usage example with argument unpacking

kwargs: ListSessionsRequestTypeDef = {  # (1)
    "maxResults": ...,
}

parent.list_sessions(**kwargs)

1. See ListSessionsRequestTypeDef

list_tags_for_resource

List all the tags for the resource you specify.

Type annotations and code completion for boto3.client("bedrock-agent-runtime").list_tags_for_resource method. boto3 documentation

# list_tags_for_resource method definition

def list_tags_for_resource(
    self,
    *,
    resourceArn: str,
) -> ListTagsForResourceResponseTypeDef:  # (1)
    ...

1. See ListTagsForResourceResponseTypeDef

# list_tags_for_resource method usage example with argument unpacking

kwargs: ListTagsForResourceRequestTypeDef = {  # (1)
    "resourceArn": ...,
}

parent.list_tags_for_resource(**kwargs)

1. See ListTagsForResourceRequestTypeDef

optimize_prompt

Optimizes a prompt for the task that you specify.

Type annotations and code completion for boto3.client("bedrock-agent-runtime").optimize_prompt method. boto3 documentation

# optimize_prompt method definition

def optimize_prompt(
    self,
    *,
    input: InputPromptTypeDef,  # (1)
    targetModelId: str,
) -> OptimizePromptResponseTypeDef:  # (2)
    ...

1. See InputPromptTypeDef
2. See OptimizePromptResponseTypeDef

# optimize_prompt method usage example with argument unpacking

kwargs: OptimizePromptRequestTypeDef = {  # (1)
    "input": ...,
    "targetModelId": ...,
}

parent.optimize_prompt(**kwargs)

1. See OptimizePromptRequestTypeDef

put_invocation_step

Add an invocation step to an invocation in a session.

Type annotations and code completion for boto3.client("bedrock-agent-runtime").put_invocation_step method. boto3 documentation

# put_invocation_step method definition

def put_invocation_step(
    self,
    *,
    invocationIdentifier: str,
    invocationStepTime: TimestampTypeDef,
    payload: InvocationStepPayloadUnionTypeDef,  # (1)
    sessionIdentifier: str,
    invocationStepId: str = ...,
) -> PutInvocationStepResponseTypeDef:  # (2)
    ...

1. See InvocationStepPayloadUnionTypeDef
2. See PutInvocationStepResponseTypeDef

# put_invocation_step method usage example with argument unpacking

kwargs: PutInvocationStepRequestTypeDef = {  # (1)
    "invocationIdentifier": ...,
    "invocationStepTime": ...,
    "payload": ...,
    "sessionIdentifier": ...,
}

parent.put_invocation_step(**kwargs)

1. See PutInvocationStepRequestTypeDef

rerank

Reranks the relevance of sources based on queries.

Type annotations and code completion for boto3.client("bedrock-agent-runtime").rerank method. boto3 documentation

# rerank method definition

def rerank(
    self,
    *,
    queries: Sequence[RerankQueryTypeDef],  # (1)
    rerankingConfiguration: RerankingConfigurationTypeDef,  # (2)
    sources: Sequence[RerankSourceTypeDef],  # (3)
    nextToken: str = ...,
) -> RerankResponseTypeDef:  # (4)
    ...

1. See Sequence[RerankQueryTypeDef]
2. See RerankingConfigurationTypeDef
3. See Sequence[RerankSourceTypeDef]
4. See RerankResponseTypeDef

# rerank method usage example with argument unpacking

kwargs: RerankRequestTypeDef = {  # (1)
    "queries": ...,
    "rerankingConfiguration": ...,
    "sources": ...,
}

parent.rerank(**kwargs)

1. See RerankRequestTypeDef

retrieve

Queries a knowledge base and retrieves information from it.

Type annotations and code completion for boto3.client("bedrock-agent-runtime").retrieve method. boto3 documentation

# retrieve method definition

def retrieve(
    self,
    *,
    knowledgeBaseId: str,
    retrievalQuery: KnowledgeBaseQueryTypeDef,  # (1)
    guardrailConfiguration: GuardrailConfigurationTypeDef = ...,  # (2)
    nextToken: str = ...,
    retrievalConfiguration: KnowledgeBaseRetrievalConfigurationTypeDef = ...,  # (3)
    userContext: UserContextTypeDef = ...,  # (4)
) -> RetrieveResponseTypeDef:  # (5)
    ...

1. See KnowledgeBaseQueryTypeDef
2. See GuardrailConfigurationTypeDef
3. See KnowledgeBaseRetrievalConfigurationTypeDef
4. See UserContextTypeDef
5. See RetrieveResponseTypeDef

# retrieve method usage example with argument unpacking

kwargs: RetrieveRequestTypeDef = {  # (1)
    "knowledgeBaseId": ...,
    "retrievalQuery": ...,
}

parent.retrieve(**kwargs)

1. See RetrieveRequestTypeDef

retrieve_and_generate

Queries a knowledge base and generates responses based on the retrieved results and using the specified foundation model or inference profile.

Type annotations and code completion for boto3.client("bedrock-agent-runtime").retrieve_and_generate method. boto3 documentation

# retrieve_and_generate method definition

def retrieve_and_generate(
    self,
    *,
    input: RetrieveAndGenerateInputTypeDef,  # (1)
    retrieveAndGenerateConfiguration: RetrieveAndGenerateConfigurationTypeDef = ...,  # (2)
    sessionConfiguration: RetrieveAndGenerateSessionConfigurationTypeDef = ...,  # (3)
    sessionId: str = ...,
    userContext: UserContextTypeDef = ...,  # (4)
) -> RetrieveAndGenerateResponseTypeDef:  # (5)
    ...

1. See RetrieveAndGenerateInputTypeDef
2. See RetrieveAndGenerateConfigurationTypeDef
3. See RetrieveAndGenerateSessionConfigurationTypeDef
4. See UserContextTypeDef
5. See RetrieveAndGenerateResponseTypeDef

# retrieve_and_generate method usage example with argument unpacking

kwargs: RetrieveAndGenerateRequestTypeDef = {  # (1)
    "input": ...,
}

parent.retrieve_and_generate(**kwargs)

1. See RetrieveAndGenerateRequestTypeDef

retrieve_and_generate_stream

Queries a knowledge base and generates responses based on the retrieved results, with output in streaming format.

Type annotations and code completion for boto3.client("bedrock-agent-runtime").retrieve_and_generate_stream method. boto3 documentation

# retrieve_and_generate_stream method definition

def retrieve_and_generate_stream(
    self,
    *,
    input: RetrieveAndGenerateInputTypeDef,  # (1)
    retrieveAndGenerateConfiguration: RetrieveAndGenerateConfigurationTypeDef = ...,  # (2)
    sessionConfiguration: RetrieveAndGenerateSessionConfigurationTypeDef = ...,  # (3)
    sessionId: str = ...,
    userContext: UserContextTypeDef = ...,  # (4)
) -> RetrieveAndGenerateStreamResponseTypeDef:  # (5)
    ...

1. See RetrieveAndGenerateInputTypeDef
2. See RetrieveAndGenerateConfigurationTypeDef
3. See RetrieveAndGenerateSessionConfigurationTypeDef
4. See UserContextTypeDef
5. See RetrieveAndGenerateStreamResponseTypeDef

# retrieve_and_generate_stream method usage example with argument unpacking

kwargs: RetrieveAndGenerateStreamRequestTypeDef = {  # (1)
    "input": ...,
}

parent.retrieve_and_generate_stream(**kwargs)

1. See RetrieveAndGenerateStreamRequestTypeDef

start_flow_execution

Starts an execution of an Amazon Bedrock flow.

Type annotations and code completion for boto3.client("bedrock-agent-runtime").start_flow_execution method. boto3 documentation

# start_flow_execution method definition

def start_flow_execution(
    self,
    *,
    flowAliasIdentifier: str,
    flowIdentifier: str,
    inputs: Sequence[FlowInputTypeDef],  # (1)
    flowExecutionName: str = ...,
    modelPerformanceConfiguration: ModelPerformanceConfigurationTypeDef = ...,  # (2)
) -> StartFlowExecutionResponseTypeDef:  # (3)
    ...

1. See Sequence[FlowInputTypeDef]
2. See ModelPerformanceConfigurationTypeDef
3. See StartFlowExecutionResponseTypeDef

# start_flow_execution method usage example with argument unpacking

kwargs: StartFlowExecutionRequestTypeDef = {  # (1)
    "flowAliasIdentifier": ...,
    "flowIdentifier": ...,
    "inputs": ...,
}

parent.start_flow_execution(**kwargs)

1. See StartFlowExecutionRequestTypeDef

stop_flow_execution

Stops an Amazon Bedrock flow's execution.

Type annotations and code completion for boto3.client("bedrock-agent-runtime").stop_flow_execution method. boto3 documentation

# stop_flow_execution method definition

def stop_flow_execution(
    self,
    *,
    executionIdentifier: str,
    flowAliasIdentifier: str,
    flowIdentifier: str,
) -> StopFlowExecutionResponseTypeDef:  # (1)
    ...

1. See StopFlowExecutionResponseTypeDef

# stop_flow_execution method usage example with argument unpacking

kwargs: StopFlowExecutionRequestTypeDef = {  # (1)
    "executionIdentifier": ...,
    "flowAliasIdentifier": ...,
    "flowIdentifier": ...,
}

parent.stop_flow_execution(**kwargs)

1. See StopFlowExecutionRequestTypeDef

tag_resource

Associate tags with a resource.

Type annotations and code completion for boto3.client("bedrock-agent-runtime").tag_resource method. boto3 documentation

# tag_resource method definition

def tag_resource(
    self,
    *,
    resourceArn: str,
    tags: Mapping[str, str],
) -> dict[str, Any]:
    ...

# tag_resource method usage example with argument unpacking

kwargs: TagResourceRequestTypeDef = {  # (1)
    "resourceArn": ...,
    "tags": ...,
}

parent.tag_resource(**kwargs)

1. See TagResourceRequestTypeDef

untag_resource

Remove tags from a resource.

Type annotations and code completion for boto3.client("bedrock-agent-runtime").untag_resource method. boto3 documentation

# untag_resource method definition

def untag_resource(
    self,
    *,
    resourceArn: str,
    tagKeys: Sequence[str],
) -> dict[str, Any]:
    ...

# untag_resource method usage example with argument unpacking

kwargs: UntagResourceRequestTypeDef = {  # (1)
    "resourceArn": ...,
    "tagKeys": ...,
}

parent.untag_resource(**kwargs)

1. See UntagResourceRequestTypeDef

update_session

Updates the metadata or encryption settings of a session.

Type annotations and code completion for boto3.client("bedrock-agent-runtime").update_session method. boto3 documentation

# update_session method definition

def update_session(
    self,
    *,
    sessionIdentifier: str,
    sessionMetadata: Mapping[str, str] = ...,
) -> UpdateSessionResponseTypeDef:  # (1)
    ...

1. See UpdateSessionResponseTypeDef

# update_session method usage example with argument unpacking

kwargs: UpdateSessionRequestTypeDef = {  # (1)
    "sessionIdentifier": ...,
}

parent.update_session(**kwargs)

1. See UpdateSessionRequestTypeDef

get_paginator

Type annotations and code completion for boto3.client("bedrock-agent-runtime").get_paginator method with overloads.

• client.get_paginator("get_agent_memory") -> GetAgentMemoryPaginator
• client.get_paginator("list_flow_execution_events") -> ListFlowExecutionEventsPaginator
• client.get_paginator("list_flow_executions") -> ListFlowExecutionsPaginator
• client.get_paginator("list_invocation_steps") -> ListInvocationStepsPaginator
• client.get_paginator("list_invocations") -> ListInvocationsPaginator
• client.get_paginator("list_sessions") -> ListSessionsPaginator
• client.get_paginator("rerank") -> RerankPaginator
• client.get_paginator("retrieve") -> RetrievePaginator