项目介绍:gpttools
gpttools 是一个旨在帮助 R 包开发者更方便地在项目工作流中使用大型语言模型(LLMs)的工具包。LLMs 的使用正在改变我们处理知识工作中文本的方式。然而,用户需要慎重考虑使用这些模型可能带来的伦理影响。LLMs,或称基础模型的伦理问题,目前是一个非常活跃的讨论领域。
安装指南
用户可以通过以下两种方式安装 gpttools:
从 GitHub 安装
使用 {pak}
包从 GitHub 安装 gpttools:
# 首先安装 pak 包
install.packages("pak")
# 使用 pak 包安装 gpttools
pak::pak("JamesHWade/gpttools")
从 R-Universe 安装
用户也可以从 R-Universe 安装:
# 启用 jameshwade 的 R-Universe 仓库
options(repos = c(
jameshwade = "https://jameshwade.r-universe.dev",
CRAN = "https://cloud.r-project.org"
))
# 下载并安装 gpttools
install.packages("gpttools")
# 浏览 gpttools 的手册页
help(package = "gpttools")
可用的 AI 服务和模型
- OpenAI:支持 gpt-4-turbo、gpt-4、gpt-3.5-turbo 等模型
- HuggingFace:提供多种模型选项
- Anthropic:支持 claude-2.1、claude-instant-1.2 等模型
- Ollama:支持 mistral、llama2、mixtral、phi 等模型
- Perplexity:提供多种聊天和在线模型
- Google AI Studio:提供 Gemini 和 Palm (legacy) 模型
- Azure OpenAI:支持 gpt-4 和 gpt-3.5-turbo 等模型
默认 AI 服务:OpenAI
要开始使用,首先需要设置一个 API 服务。gpttools 默认使用 OpenAI 的服务。设置步骤如下:
- 创建 OpenAI 帐户。
- 生成 OpenAI API 密钥。
- 在 RStudio 中配置 API 密钥。
配置 OpenAI API 密钥
需要为 OpenAI API 创建一个 OPENAI_API_KEY
环境变量。这可以通过修改项目的 .Renviron 文件实现:
require(usethis)
edit_r_environ()
在 .Renviron 文件中添加以下行,并将 "<APIKEY>"
替换为实际的 API 密钥:
OPENAI_API_KEY="<APIKEY>"
需要注意的是,如果使用版本控制系统,例如 GitHub 或 GitLab,要确保将 .Renviron 文件添加到 .gitignore 文件中,以避免泄露 API 密钥。此外,OpenAI API 在没有有效支付信息的情况下将无法使用,这一限制由 OpenAI 施加。
替代 AI 服务提供商
除了 OpenAI,gpttools 也支持其他 AI 服务提供商,包括 Anthropic、HuggingFace、Google AI Studio、Azure OpenAI 和 Perplexity。这些提供商可以根据用户的喜好或特定需求进行选择。使用替代提供商时,需获得相关的 API 密钥或访问凭证,并进行类似的配置。
隐私声明
gpttools 与流行的语言模型(例如 gpt-4 turbo 和 claude-2.1)共同使用。使用这个包即表示你同意遵守 API 服务提供商制定的隐私条款。
AI 服务的数据共享
使用此 R 包时,用户通过光标高亮选择的文本或在内置应用程序中输入的提示将通过 API 请求发送到所选的 AI 服务提供商,这是根据各自提供商的隐私声明和条款进行的。
AI 服务提供商的数据使用与安全
我们不能保证通过 API 发送给任何 AI 服务提供商的数据的安全性,也无法提供各个服务如何处理或使用这些数据的详细信息。通常,这些提供商会在用户协议中说明他们会使用输入和结果来提高 AI 模型的性能。
限制数据共享
gpttools 设计为仅分享用户在内置应用程序中选择或输入的文本或代码。用户有责任确保没有无意中共享敏感数据。
重要提示:为保持数据的私密性,请勿高亮、输入或上传任何需要保密的数据、代码或文本。
行为规范
gpttools 项目附带了贡献者行为规范。通过为此项目贡献代码,参与者同意遵守该规范的条款。