Fill in the Blank

Add variation to your content through randomized placeholders — Great for
inspiring creativity in language model prompts.


``ts
const prompt = Would a ${animal} make a good ${profession}?;
// "Would a finch make a good scientist?"
// "Would a leopard make a good architect?"
// "Would a rhinoceros make a good farmer?"
`

`ts
const prompt = 'Write a poem.' + creativity;
// Write a poem. Consider mentioning running, ox, the color green, being surprised, parsley, submarine, electric kettle, rectangle, jazz music, or scientist.
`

Blanks

Fill in the Blank provides blanks for common types of entities:

- animal: elephant, tiger, etc.
- appliance: refrigerator, toaster, etc.
- color: red, blue, green, etc.
- degree: somewhat, very, etc.
- emotion: happy, sad, etc.
- exercise: running, skiing, etc.
- greeting: hello, hi, etc.
- letter: a, b, c, etc.
- musicGenre: pop, rock, etc.
- percent: 2%, 50%, 73%, etc.
- plant: daisy, pine, tulip, etc.
- profession: doctor, lawyer, etc.
- programmingLanguage: Ruby, TypeScript, etc.
- shape: circle, square, etc.
- vehicle: bus, submarine, van, etc.

Custom blanks can be implemented using the blank function:

`ts
const clothing = blank('hat', 'shirt', 'shorts', 'shoes');
const prompt = What color ${clothing} should I wear?;
`

Prompting

To get more varied responses from a language model, you can include the
creativity blank in the prompt, for example:

`ts
const prompt = 'Write a poem.' + creativity;
`

This will insert a random topic that the model can use to guide its response.

To generate multiple possible topics, use the ideas blank:

`ts
const prompt = Write a story by combining two of these ideas: ${ideas};
`

Note that the behavior will be highly dependent on your model, settings, and
other prompt content, and getting desirable results will likely require
iteration.

Q&A

$3

Even with high temperatures, language models will often return the same response
for simple queries like "Write me a joke". Fill in the Blank can provide
variation in system instructions that adds creativity to the responses. For
example, try adding something like this to your system prompt:

`ts
You are a ${emotion} ${profession} who enjoys ${exercise}. You like ${musicGenre} music and you ride a ${vehicle} to work.;
`

$3

Not entirely. The order of the options is shuffled, however the blanks keep
track of options that have already been used, and will use all available options
before looping around. Additionally, the same option will not be returned twice
in a row (even when looping around).

$3

You can, but you don't have to. A blank is a function that returns a placeholder
string and whose toString method also returns a placeholder string. This means
that, in contexts where objects are automatically cast to strings, color and
color()` are functionally equivalent. Invoking them is more universally
applicable, however, leaving off the parentheses may be more readable in longer
content, such as prompts.