Invocations

Provides coroutine-based methods for managing invocation records within the Norman persistence service.

The Invocations class allows creating new invocation entries, retrieving existing ones, fetching invocation history, and generating invocations based on model names and execution counts.

create_invocations(token, invocations) async

Coroutine

Create one or more new invocation records.


Parameters

  • token (Sensitive[str]) — Authentication token authorizing the request.

  • invocations (List[Invocation]) — List of Invocation objects representing executions to persist.


    Response Structure

  • response (List[Invocation]) — List of successfully created invocation objects returned from the server.

create_invocations_by_model_names(token, model_name_counter) async

Coroutine

Create invocation records in bulk, using model names and execution counts.

This method generates multiple invocation records for each specified model name, based on the provided count mapping.


Parameters

  • token (Sensitive[str]) — Authentication token authorizing the request.

  • model_name_counter (dict[str, int]) — Mapping of model names to the number of invocations to create. For example: python {"image_reverser_model": 3, "text_summary_model": 2}


Response Structure

  • response (List[Invocation]) — List of newly created invocation records corresponding to the counts provided.

get_invocation_history(token, constraints=None) async

Coroutine

Retrieve historical invocation records based on the provided query constraints.

Parameters

  • token (Sensitive[str]) — Authentication token authorizing the request.

  • constraints (Optional[QueryConstraints]) — Optional query object for filtering historical invocations.

Response Structure

  • response (dict[str, Invocation]) — Dictionary mapping invocation IDs to corresponding historical invocation objects.

get_invocations(token, constraints=None) async

Coroutine

Retrieve invocation records that match the provided query constraints.


Parameters

  • token (Sensitive[str]) — Authentication token authorizing the request.

  • constraints (Optional[QueryConstraints]) — Optional query object defining filters and pagination.

Response Structure

  • response (dict[str, Invocation]) — Dictionary mapping invocation IDs to their corresponding Invocation objects.

·

©

2026

·

©

2026