btw_tool_env_describe_data_frame: Tool: Describe data frame

In btw: A Toolkit for Connecting R and Large Language Models

Tool: Describe data frame

Description

Tool: Describe data frame

Usage

btw_tool_env_describe_data_frame(
  data_frame,
  format = c("skim", "glimpse", "print", "json"),
  max_rows = 5,
  max_cols = 100,
  package = NULL,
  `_intent` = ""
)

Arguments

data_frame	The data frame to describe
format	One of "skim", "glimpse", "print", or "json". "skim" is the most information-dense format for describing the data. It uses and returns the same information as skimr::skim() but formatting as a JSON object that describes the dataset. To glimpse the data column-by-column, use "glimpse". This is particularly helpful for getting a sense of data frame column names, types, and distributions, when pairings of entries in individual rows aren't particularly important. To just print out the data frame, use print(). To get a json representation of the data, use "json". This is particularly helpful when the pairings among entries in specific rows are important to demonstrate.
max_rows	The maximum number of rows to show in the data frame. Only applies when format = "json".
max_cols	The maximum number of columns to show in the data frame. Only applies when format = "json".
package	The name of the package that provides the data set. If not provided, data_frame must be loaded in the current environment, or may also be inferred from the name of the data frame, e.g. "dplyr::storms".
_intent	An optional string describing the intent of the tool use. When the tool is used by an LLM, the model will use this argument to explain why it called the tool.

Value

A character vector containing a representation of the data frame. Will error if the named data frame is not found in the environment.

See Also

btw_this.data.frame(), btw_tools()

Other Tools: btw_tool_docs_package_news(), btw_tool_env_describe_environment(), btw_tool_files_code_search(), btw_tool_files_list_files(), btw_tool_files_read_text_file(), btw_tool_files_write_text_file(), btw_tool_ide_read_current_editor(), btw_tool_package_docs, btw_tool_search_packages(), btw_tool_session_package_info(), btw_tool_session_platform_info(), btw_tool_web_read_url(), btw_tools()

Examples

btw_tool_env_describe_data_frame(mtcars)

btw documentation built on Nov. 5, 2025, 7:45 p.m.