pyrit.prompt_converter.HumanInTheLoopConverter#

class HumanInTheLoopConverter(converters: list[PromptConverter] | None = None)[source]#

Bases: PromptConverter

Allows review of each prompt sent to a target before sending it.

Users can choose to send the prompt as is, modify the prompt, or run the prompt through one of the passed-in converters before sending it.

__init__(converters: list[PromptConverter] | None = None)[source]#

Initializes the converter with a list of possible converters to run input through.

Parameters:

converters (List[PromptConverter], Optional) – List of possible converters to run input through.

Methods

__init__([converters])

Initializes the converter with a list of possible converters to run input through.

convert_async(*, prompt[, input_type])

Converts the given prompt by allowing user interaction before sending it to a target.

convert_tokens_async(*, prompt[, ...])

Converts substrings within a prompt that are enclosed by specified start and end tokens.

get_identifier()

Returns an identifier dictionary for the converter.

input_supported(input_type)

Checks if the input type is supported by the converter.

output_supported(output_type)

Checks if the output type is supported by the converter.

Attributes

supported_input_types

Returns a list of supported input types for the converter.

supported_output_types

Returns a list of supported output types for the converter.

async convert_async(*, prompt: str, input_type: Literal['text', 'image_path', 'audio_path', 'video_path', 'url', 'reasoning', 'error'] = 'text') ConverterResult[source]#

Converts the given prompt by allowing user interaction before sending it to a target.

User is given three options to choose from:
  1. Proceed with sending the prompt as is.

  2. Manually modify the prompt.

  3. Run the prompt through a converter before sending it.

Parameters:
  • prompt (str) – The prompt to be converted.

  • input_type (PromptDataType) – The type of input data.

Returns:

The result containing the modified prompt.

Return type:

ConverterResult

Raises:

ValueError – If no converters are provided and the user chooses to run a converter.

input_supported(input_type: Literal['text', 'image_path', 'audio_path', 'video_path', 'url', 'reasoning', 'error']) bool[source]#

Checks if the input type is supported by the converter.

Parameters:

input_type (PromptDataType) – The input type to check.

Returns:

True if the input type is supported, False otherwise.

Return type:

bool

output_supported(output_type: Literal['text', 'image_path', 'audio_path', 'video_path', 'url', 'reasoning', 'error']) bool[source]#

Checks if the output type is supported by the converter.

Parameters:

output_type (PromptDataType) – The output type to check.

Returns:

True if the output type is supported, False otherwise.

Return type:

bool