tidyprompt：R语言中的LLM提示工程利器

tidyprompt是一个R语言包，为构建提示词和处理大语言模型交互逻辑提供了优雅的解决方案，引入了提示词包装器概念，支持结构化输出、自动反馈重试、推理模式和函数调用等高级功能。

在数据科学和统计分析领域，R语言一直是研究人员和数据分析师的首选工具。随着大语言模型（LLM）的兴起，R用户也迫切需要一种优雅的方式来与这些强大的AI模型交互。然而，大多数LLM工具都是为Python生态系统设计的，R用户往往需要使用复杂的API调用或切换到其他语言。

tidyprompt项目正是为了解决这一问题而诞生的。它的设计理念借鉴了R语言中广受欢迎的ggplot2和tidyverse生态系统的管道操作符（|>），让R用户能够以熟悉的方式构建复杂的LLM交互流程。开发者将其形容为"创建提示词和处理LLM交互的ggplot2"，这个比喻准确地传达了其设计哲学。

tidyprompt引入了一个核心概念——提示词包装器（prompt wraps）。这些包装器是构建块，可以用来将简单的提示词快速转换为高级提示词。与仅仅修改提示词文本不同，提示词包装器还会添加提取和验证函数，这些函数将应用于LLM的响应。更重要的是，这些函数可以向LLM发送反馈，实现迭代式的交互优化。

这种设计模式让R用户能够以一种声明式、可组合的方式构建LLM应用，类似于tidyverse中处理数据的方式。每个包装器都是一个独立的、可重用的组件，可以按需组合，构建出复杂的交互流程。

tidyprompt提供了丰富的功能，使R用户能够充分利用LLM的能力：

结构化输出：可以要求LLM以特定类型和格式返回结构化输出。用户可以使用预构建的提示词包装器，也可以使用自己的R代码进行验证。

自动反馈与重试：当输出不符合预期时，自动向LLM提供反馈，允许LLM重试其答案。这种机制大大提高了获得满意结果的概率。

推理模式：可以让LLM以特定模式回答问题，如思维链（chain-of-thought）或ReAct（推理与行动）模式。

函数调用：赋予LLM自动调用R函数（工具）的能力。通过这种方式，LLM可以检索信息或执行其他操作。tidyprompt还支持R代码生成和评估，允许LLM运行R代码。

MCP工具支持：支持来自Model Context Protocol（MCP）服务器的工具，进一步扩展了功能范围。

与ellmer兼容：tidyprompt可以与流行的R包ellmer（用于与LLM API交互）无缝集成，支持从ellmer聊天对象连接到LLM提供商。

tidyprompt的语法设计直观易懂，以下是一些典型用例：

基本整数回答：

"What is 5+5?" |>
  answer_as_integer() |>
  send_prompt(llm_provider_ollama())
#> [1] 10

布尔值回答：

"Are you a large language model?" |>
  answer_as_boolean() |>
  send_prompt(llm_provider_ollama())
#> [1] TRUE

正则匹配验证：

"What animal is the biggest?" |>
  answer_as_regex_match("^(cat|dog|elephant)$") |>
  send_prompt(llm_provider_ollama())
#> [1] "elephant"

工具调用示例：

"What is something fun that happened in November 2024?" |>
  answer_as_text(max_words = 25) |>
  answer_using_tools(getwiki::search_wiki) |>
  send_prompt(llm_provider_ollama())

生成R统计模型：

model <- paste0(
  "Using my data, create a statistical model",
  " investigating the relationship between two variables."
) |>
  answer_using_r(
    objects_to_use = list(data = cars),
    evaluate_code = TRUE,
    return_mode = "object"
  ) |>
  prompt_wrap(
    validation_fn = function(x) {
      if (!inherits(x, "lm"))
        return(llm_feedback("The output should be a linear model object."))
      return(TRUE)
    }
  ) |>
  send_prompt(llm_provider_ollama())
summary(model)

tidyprompt支持多种验证机制，包括LLM自我验证、人工验证和退出机制。例如，对于无法回答的问题，可以使用quit_if()包装器优雅地处理：

"How many years old is my neighbor's dog?" |>
  answer_as_integer() |>
  quit_if() |>
  send_prompt(llm_provider_ollama())
#> NULL

这种设计允许在LLM回答不确定或无法回答时，系统能够优雅地处理而不是产生幻觉。

tidyprompt的设计充分考虑了与R现有生态系统的兼容性。它不仅可以与ellmer包集成，还支持ellmer定义的结构化输出和工具。当使用ellmer LLM提供商时，这些功能会调用原生的ellmer函数来获取结构化输出和注册工具。

此外，由于mcptools::mcp_tools()返回的是ellmer工具定义，answer_using_tools()也支持来自MCP服务器的工具。这意味着tidyprompt扩展了ellmer（及其他包）的可能性。

对于R用户和数据科学家来说，tidyprompt提供了几个重要的价值：

降低LLM使用门槛：R用户无需学习Python或复杂的API文档，就可以开始使用LLM。

保持工作流一致性：可以在现有的R数据分析流程中无缝集成LLM功能，无需切换语言或环境。

增强的可靠性：通过验证和反馈机制，减少LLM幻觉和错误输出的风险。

可重复的研究：结构化的提示词和验证逻辑使得LLM辅助的分析更具可重复性和透明度。