kiln_ai.adapters.repair.repair_task
1import json 2from typing import Type 3 4from pydantic import BaseModel, Field 5 6from kiln_ai.adapters.prompt_builders import BasePromptBuilder, prompt_builder_registry 7from kiln_ai.datamodel import Priority, Project, Task, TaskRequirement, TaskRun 8 9 10# TODO add evaluator rating 11class RepairTaskInput(BaseModel): 12 original_prompt: str 13 original_input: str 14 original_output: str 15 evaluator_feedback: str = Field( 16 min_length=1, 17 description="Feedback from an evaluator on how to repair the task run.", 18 ) 19 20 21class RepairTaskRun(Task, parent_of={}): 22 def __init__(self, original_task: Task): 23 # Keep the typechecker happy 24 tmp_project = Project(name="Repair") 25 super().__init__( 26 name="Repair", 27 parent=tmp_project, 28 description="Repair a task run, given feedback from an evaluator about how the response can be improved.", 29 instruction="You are an assistant which helps improve output from another assistant (original assistant). You'll be provided a task that the original assistant executed (prompt), \ 30the input it was given, and the output it generated. An evaluator has determined that the output it generated did not satisfy the task and should be improved. The evaluator will provide \ 31feedback describing what should be improved. Your job is to understand the evaluator's feedback and improve the response.", 32 requirements=[ 33 TaskRequirement( 34 name="Follow Eval Feedback", 35 instruction="The evaluator's feedback is the most important thing to consider. If it conflicts with the original task instruction or prompt, prioritize the evaluator's feedback.", 36 priority=Priority.p0, 37 ) 38 ], 39 input_json_schema=json.dumps(RepairTaskInput.model_json_schema()), 40 output_json_schema=original_task.output_json_schema, 41 ) 42 43 @classmethod 44 def _original_prompt(cls, run: TaskRun, task: Task) -> str: 45 prompt_builder_class: Type[BasePromptBuilder] | None = None 46 prompt_builder_name = ( 47 run.output.source.properties.get("prompt_builder_name", None) 48 if run.output.source 49 else None 50 ) 51 if prompt_builder_name is not None and isinstance(prompt_builder_name, str): 52 prompt_builder_class = prompt_builder_registry.get( 53 prompt_builder_name, None 54 ) 55 if prompt_builder_class is None: 56 raise ValueError(f"No prompt builder found for name: {prompt_builder_name}") 57 prompt_builder = prompt_builder_class(task=task) 58 if not isinstance(prompt_builder, BasePromptBuilder): 59 raise ValueError( 60 f"Prompt builder {prompt_builder_name} is not a valid prompt builder" 61 ) 62 return prompt_builder.build_prompt() 63 64 @classmethod 65 def build_repair_task_input( 66 cls, original_task: Task, task_run: TaskRun, evaluator_feedback: str 67 ) -> RepairTaskInput: 68 original_prompt = cls._original_prompt(task_run, original_task) 69 return RepairTaskInput( 70 original_prompt=original_prompt, 71 original_input=task_run.input, 72 original_output=task_run.output.output, 73 evaluator_feedback=evaluator_feedback, 74 )
12class RepairTaskInput(BaseModel): 13 original_prompt: str 14 original_input: str 15 original_output: str 16 evaluator_feedback: str = Field( 17 min_length=1, 18 description="Feedback from an evaluator on how to repair the task run.", 19 )
Usage docs: https://docs.pydantic.dev/2.10/concepts/models/
A base class for creating Pydantic models.
Attributes:
__class_vars__: The names of the class variables defined on the model.
__private_attributes__: Metadata about the private attributes of the model.
__signature__: The synthesized __init__
[Signature
][inspect.Signature] of the model.
__pydantic_complete__: Whether model building is completed, or if there are still undefined fields.
__pydantic_core_schema__: The core schema of the model.
__pydantic_custom_init__: Whether the model has a custom `__init__` function.
__pydantic_decorators__: Metadata containing the decorators defined on the model.
This replaces `Model.__validators__` and `Model.__root_validators__` from Pydantic V1.
__pydantic_generic_metadata__: Metadata for generic models; contains data used for a similar purpose to
__args__, __origin__, __parameters__ in typing-module generics. May eventually be replaced by these.
__pydantic_parent_namespace__: Parent namespace of the model, used for automatic rebuilding of models.
__pydantic_post_init__: The name of the post-init method for the model, if defined.
__pydantic_root_model__: Whether the model is a [`RootModel`][pydantic.root_model.RootModel].
__pydantic_serializer__: The `pydantic-core` `SchemaSerializer` used to dump instances of the model.
__pydantic_validator__: The `pydantic-core` `SchemaValidator` used to validate instances of the model.
__pydantic_fields__: A dictionary of field names and their corresponding [`FieldInfo`][pydantic.fields.FieldInfo] objects.
__pydantic_computed_fields__: A dictionary of computed field names and their corresponding [`ComputedFieldInfo`][pydantic.fields.ComputedFieldInfo] objects.
__pydantic_extra__: A dictionary containing extra values, if [`extra`][pydantic.config.ConfigDict.extra]
is set to `'allow'`.
__pydantic_fields_set__: The names of fields explicitly set during instantiation.
__pydantic_private__: Values of private attributes set on the model instance.
22class RepairTaskRun(Task, parent_of={}): 23 def __init__(self, original_task: Task): 24 # Keep the typechecker happy 25 tmp_project = Project(name="Repair") 26 super().__init__( 27 name="Repair", 28 parent=tmp_project, 29 description="Repair a task run, given feedback from an evaluator about how the response can be improved.", 30 instruction="You are an assistant which helps improve output from another assistant (original assistant). You'll be provided a task that the original assistant executed (prompt), \ 31the input it was given, and the output it generated. An evaluator has determined that the output it generated did not satisfy the task and should be improved. The evaluator will provide \ 32feedback describing what should be improved. Your job is to understand the evaluator's feedback and improve the response.", 33 requirements=[ 34 TaskRequirement( 35 name="Follow Eval Feedback", 36 instruction="The evaluator's feedback is the most important thing to consider. If it conflicts with the original task instruction or prompt, prioritize the evaluator's feedback.", 37 priority=Priority.p0, 38 ) 39 ], 40 input_json_schema=json.dumps(RepairTaskInput.model_json_schema()), 41 output_json_schema=original_task.output_json_schema, 42 ) 43 44 @classmethod 45 def _original_prompt(cls, run: TaskRun, task: Task) -> str: 46 prompt_builder_class: Type[BasePromptBuilder] | None = None 47 prompt_builder_name = ( 48 run.output.source.properties.get("prompt_builder_name", None) 49 if run.output.source 50 else None 51 ) 52 if prompt_builder_name is not None and isinstance(prompt_builder_name, str): 53 prompt_builder_class = prompt_builder_registry.get( 54 prompt_builder_name, None 55 ) 56 if prompt_builder_class is None: 57 raise ValueError(f"No prompt builder found for name: {prompt_builder_name}") 58 prompt_builder = prompt_builder_class(task=task) 59 if not isinstance(prompt_builder, BasePromptBuilder): 60 raise ValueError( 61 f"Prompt builder {prompt_builder_name} is not a valid prompt builder" 62 ) 63 return prompt_builder.build_prompt() 64 65 @classmethod 66 def build_repair_task_input( 67 cls, original_task: Task, task_run: TaskRun, evaluator_feedback: str 68 ) -> RepairTaskInput: 69 original_prompt = cls._original_prompt(task_run, original_task) 70 return RepairTaskInput( 71 original_prompt=original_prompt, 72 original_input=task_run.input, 73 original_output=task_run.output.output, 74 evaluator_feedback=evaluator_feedback, 75 )
Represents a specific task to be performed, with associated requirements and validation rules.
Contains the task definition, requirements, input/output schemas, and maintains a collection of task runs.
23 def __init__(self, original_task: Task): 24 # Keep the typechecker happy 25 tmp_project = Project(name="Repair") 26 super().__init__( 27 name="Repair", 28 parent=tmp_project, 29 description="Repair a task run, given feedback from an evaluator about how the response can be improved.", 30 instruction="You are an assistant which helps improve output from another assistant (original assistant). You'll be provided a task that the original assistant executed (prompt), \ 31the input it was given, and the output it generated. An evaluator has determined that the output it generated did not satisfy the task and should be improved. The evaluator will provide \ 32feedback describing what should be improved. Your job is to understand the evaluator's feedback and improve the response.", 33 requirements=[ 34 TaskRequirement( 35 name="Follow Eval Feedback", 36 instruction="The evaluator's feedback is the most important thing to consider. If it conflicts with the original task instruction or prompt, prioritize the evaluator's feedback.", 37 priority=Priority.p0, 38 ) 39 ], 40 input_json_schema=json.dumps(RepairTaskInput.model_json_schema()), 41 output_json_schema=original_task.output_json_schema, 42 )
Create a new model by parsing and validating input data from keyword arguments.
Raises [ValidationError
][pydantic_core.ValidationError] if the input data cannot be
validated to form a valid model.
self
is explicitly positional-only to allow self
as a field name.
65 @classmethod 66 def build_repair_task_input( 67 cls, original_task: Task, task_run: TaskRun, evaluator_feedback: str 68 ) -> RepairTaskInput: 69 original_prompt = cls._original_prompt(task_run, original_task) 70 return RepairTaskInput( 71 original_prompt=original_prompt, 72 original_input=task_run.input, 73 original_output=task_run.output.output, 74 evaluator_feedback=evaluator_feedback, 75 )
Configuration for the model, should be a dictionary conforming to [ConfigDict
][pydantic.config.ConfigDict].
122 def wrapped_model_post_init(self: BaseModel, context: Any, /) -> None: 123 """We need to both initialize private attributes and call the user-defined model_post_init 124 method. 125 """ 126 init_private_attributes(self, context) 127 original_model_post_init(self, context)
We need to both initialize private attributes and call the user-defined model_post_init method.