openaiRtools (version 0.2.2)

list_messages: List Messages in a Thread (Convenience Function)

Description

Shortcut that creates an OpenAI client from the OPENAI_API_KEY environment variable and lists messages in a thread. After a run completes, the assistant's reply appears in this list.

Usage

list_messages(thread_id, ...)

Value

A list with $data — a list of message objects, newest first (by default). Access reply text via: msgs$data[[1]]$content[[1]]$text$value.

Arguments

thread_id

Character. Required. The thread ID.

...

Additional parameters passed to MessagesClient$list(), such as limit, order ("asc"/"desc"), after, run_id.

Examples

if (FALSE) {
Sys.setenv(OPENAI_API_KEY = "sk-xxxxxx")

# Read latest messages (newest first)
msgs <- list_messages("thread_abc123")
cat("Assistant reply:", msgs$data[[1]]$content[[1]]$text$value)

# Print full conversation chronologically
msgs <- list_messages("thread_abc123", order = "asc")
for (m in msgs$data) {
  cat(toupper(m$role), ":", m$content[[1]]$text$value, "\n\n")
}
}