interpolate: Helpers for interpolating data into prompts

In ellmer: Chat with Large Language Models

Helpers for interpolating data into prompts

Description

These functions are lightweight wrappers around glue that make it easier to interpolate dynamic data into a static prompt. Compared to glue, these functions expect you to wrap dynamic values in {{ }}, making it easier to include R code and JSON in your prompt.

Usage

interpolate(prompt, ..., .envir = parent.frame())

interpolate_file(path, ..., .envir = parent.frame())

Arguments

prompt	A prompt string. You should not generally expose this to the end user, since glue interpolation makes it easy to run arbitrary code.
...	Define additional temporary variables for substitution.
.envir	Environment to evaluate ... expressions in. Used when wrapping in another function. See vignette("wrappers", package = "glue") for more details.
path	A path to a prompt file (often a .md).

Value

A {glue} string.

Examples

joke <- "You're a cool dude who loves to make jokes. Tell me a joke about {{topic}}."

# You can supply valuese directly:
interpolate(joke, topic = "bananas")

# Or allow interpolate to find them in the current environment:
topic <- "applies"
interpolate(joke)

ellmer documentation built on April 4, 2025, 3:53 a.m.