Bedrock Agent Runtime  >  Operations  >  create_invocation

create_invocation

Operation

create_invocation async

create_invocation(input: CreateInvocationInput, plugins: list[Plugin] | None = None) -> CreateInvocationOutput

Creates a new invocation within a session. An invocation groups the related invocation steps that store the content from a conversation. For more information about sessions, see Store and retrieve conversation history and context with Amazon Bedrock sessions.

Related APIs

• ListInvocations

• ListSessions

• GetSession

Parameters:

Name	Type	Description	Default
input	CreateInvocationInput	An instance of CreateInvocationInput.	required
plugins	list[Plugin] | None	A list of callables that modify the configuration dynamically. Changes made by these plugins only apply for the duration of the operation execution and will not affect any other operation invocations.	None

Returns:

Type	Description
CreateInvocationOutput	An instance of CreateInvocationOutput.

Input

CreateInvocationInput dataclass

Dataclass for CreateInvocationInput structure.

Attributes

description class-attribute instance-attribute

description: str | None = None

A description for the interactions in the invocation. For example, "User asking about weather in Seattle".

invocation_id class-attribute instance-attribute

invocation_id: str | None = None

A unique identifier for the invocation in UUID format.

session_identifier class-attribute instance-attribute

session_identifier: str | None = None

The unique identifier for the associated session for the invocation. You can specify either the session's sessionId or its Amazon Resource Name (ARN).

Output

CreateInvocationOutput dataclass

Dataclass for CreateInvocationOutput structure.

Attributes

created_at instance-attribute

created_at: datetime

The timestamp for when the invocation was created.

invocation_id instance-attribute

invocation_id: str

The unique identifier for the invocation.

session_id instance-attribute

session_id: str

The unique identifier for the session associated with the invocation.