Embabel Agent Documentation/com.embabel.agent.api.common.nested/ObjectCreator

ObjectCreator

interface ObjectCreator<T>

Interface to create objects of the given type from a prompt or messages. Allows setting strongly typed examples.

Functions

fromMessages

abstract fun fromMessages(messages: List<Message>): T

Create an object of the desired typed from messages

fromPrompt

open fun fromPrompt(prompt: String): T

Create an object of the desired type using the given prompt and LLM options from context (process context or implementing class). Prompts are typically created within the scope of an

fromTemplate

abstract fun fromTemplate(templateName: String, model: Map<String, Any>): T

Create an object of this type from the given template

withExample

abstract fun withExample(example: ObjectCreationExample<T>): ObjectCreator<T>

open fun withExample(description: String, value: T): ObjectCreator<T>

Add an example of the desired output to the prompt. This will be included in JSON. It is possible to call this method multiple times. This will override PromptRunner.withGenerateExamples

withExamples

open fun withExamples(vararg examples: ObjectCreationExample<T>): ObjectCreator<T>

Convenience method to add multiple examples using vararg syntax. Each example will be added as a prompt contributor to improve LLM output quality.

open fun withExamples(examples: Iterable<ObjectCreationExample<T>>): ObjectCreator<T>

Convenience method to add multiple examples from a list or other iterable. Each example will be added as a prompt contributor to improve LLM output quality.

withoutProperties

open fun withoutProperties(vararg properties: String): ObjectCreator<T>

Excludes the given properties when creating an object.

withoutProperties

fun <T> ObjectCreator<T>.withoutProperties(vararg properties: KProperty1<T, Any>): ObjectCreator<T>

Excludes the given properties when creating an object.

withProperties

open fun withProperties(vararg properties: String): ObjectCreator<T>

Includes the given properties when creating an object.

withProperties

fun <T> ObjectCreator<T>.withProperties(vararg properties: KProperty1<T, Any>): ObjectCreator<T>

Includes the given properties when creating an object.

withPropertyFilter

abstract fun withPropertyFilter(filter: Predicate<String>): ObjectCreator<T>

Adds a filter that determines which properties are to be included when creating an object.