A Chat
is an sequence of sequence of user and assistant Turns sent
to a specific Provider. A Chat
is a mutable R6 object that takes care of
managing the state associated with the chat; i.e. it records the messages
that you send to the server, and the messages that you receive back.
If you register a tool (i.e. an R function that the assistant can call on
your behalf), it also takes care of the tool loop.
You should generally not create this object yourself,
but instead call chat_openai()
or friends instead.
Methods
Method new()
Usage
Chat$new(provider, turns, seed = NULL, echo = "none")
Arguments
provider
A provider object.
turns
An unnamed list of turns to start the chat with (i.e., continuing a previous conversation). If
NULL
or zero-length list, the conversation begins from scratch.seed
Optional integer seed that ChatGPT uses to try and make output more reproducible.
echo
One of the following options:
none
: don't emit any output (default when running in a function).text
: echo text output as it streams in (default when running at the console).all
: echo all input and output.
Note this only affects the
chat()
method.
Method turns()
The turns that have been sent and received so far (optionally starting with the system prompt, if any).
Method tokens()
List the number of tokens consumed by each assistant turn. Currently tokens are recorded for assistant turns only; so user turns will have zeros.
Method last_turn()
The last turn returned by the assistant.
Usage
Chat$last_turn(role = c("assistant", "user", "system"))
Method chat()
Submit input to the chatbot, and return the response as a simple string (probably Markdown).
Arguments
...
The input to send to the chatbot. Can be strings or images (see
content_image_file()
andcontent_image_url()
.echo
Whether to emit the response to stdout as it is received. If
NULL
, then the value ofecho
set when the chat object was created will be used.
Method extract_data()
Extract structured data
Arguments
...
The input to send to the chatbot. Will typically include the phrase "extract structured data".
spec
A type specification for the extracted data. Should be created with a
type_()
function.echo
Whether to emit the response to stdout as it is received. Set to "text" to stream JSON data as it's generated (not supported by all providers).
Method extract_data_async()
Extract structured data, asynchronously. Returns a promise that resolves to an object matching the type specification.
Arguments
...
The input to send to the chatbot. Will typically include the phrase "extract structured data".
spec
A type specification for the extracted data. Should be created with a
type_()
function.echo
Whether to emit the response to stdout as it is received. Set to "text" to stream JSON data as it's generated (not supported by all providers).
Method chat_async()
Submit input to the chatbot, and receive a promise that resolves with the response all at once. Returns a promise that resolves to a string (probably Markdown).
Method stream()
Submit input to the chatbot, returning streaming results. Returns A coro generator that yields strings. While iterating, the generator will block while waiting for more content from the chatbot.
Method stream_async()
Submit input to the chatbot, returning asynchronously streaming results. Returns a coro async generator that yields string promises.
Method register_tool()
Register a tool (an R function) that the chatbot can use. If the chatbot decides to use the function, elmer will automatically call it and submit the results back.
Arguments
tool_def
Tool definition created by
tool()
.