安装 Claude for Sheets

按照以下步骤轻松启用 Claude for Sheets:

  1. 获取您的 Claude API 密钥:没有开发者 API 密钥,您将无法使用 Claude for Sheets。有关如何获取 API 密钥的更多信息,请参阅获取 Claude 访问权限
  2. 安装 Claude for Sheets 扩展
    1. 点击此处 访问 Claude for Sheets 扩展或在插件市场中搜索 Claude for Sheets
    2. 点击蓝色的 安装 按钮并接受权限
  3. 连接您的 API 密钥:在 扩展程序 > Claude for Sheets™ > 输入您的 Anthropic API 密钥 中输入您的 API 密钥。您可能需要等待或刷新才能看到”输入您的 Anthropic API 密钥”选项。

在看到绿色的”已验证”复选标记 ✅ 后,Claude 将在您的 Google Sheet 中激活并准备就绪。

每次创建新的 Google Sheet 时,您都必须重新输入 API 密钥

权限

在安装过程中,Claude for Sheets 扩展将请求各种权限以正常运行。尽管运行 Claude in Sheets 所请求的权限很广泛,但请放心,我们只处理用户要求 Claude 运行的特定数据。这些数据永远不会用于训练我们的生成模型。

扩展权限包括:

  • 查看和管理已安装此应用程序的电子表格 - 需要运行提示并返回结果
  • 连接到外部服务 - 需要调用 Anthropic 的 API 端点
  • 允许此应用程序在您不在时运行 - 需要在没有用户干预的情况下运行单元格重新计算
  • 在 Google 应用程序内的提示和侧边栏中显示和运行第三方网络内容 - 需要显示侧边栏和安装后提示

单元格重新计算

您可以通过从 Claude for Sheets 扩展菜单中选择重新计算选项,手动重新计算 #ERROR!⚠ DEFERRED ⚠⚠ THROTTLED ⚠ 单元格。


如何使用 Claude for Sheets

Claude 函数

您可以使用两个主要函数通过 Claude for Sheets 调用 Claude:

1. CLAUDE()

=CLAUDE(prompt, model, params...)

CLAUDE() 是使用 Claude for Sheets 调用 Claude 的最简单方法。要使用此函数,您只需要一个没有额外格式的纯文本提示。这可能是您大多数时候想要使用的函数。这与 Slackbot Claude 界面和 Console 上的”聊天”模式相同。

CLAUDE() 提示示例
提示函数格式
用一句话说明蓝色的好处是什么?=CLAUDE(“用一句话说明蓝色的好处是什么?“)
用一句话说明蓝色的好处是什么?在 <answer> 标签中输出您的答案。[带有 参数]=CLAUDE(“用一句话说明蓝色的好处是什么?在 标签中输出您的答案。”,“claude-3-opus-20240229”,“temperature”, 0.2,“max_tokens”, 50,“stop_sequences”, ”[""""]”,“api_key”, “sk-ant-api03-j1W…“)

2. CLAUDEMESSAGES()

=CLAUDEMESSAGES(prompt, model, params...)

使用 CLAUDEMESSAGES() 向 Claude 发送一系列 User:Assistant: 消息,就像您使用 Messages API 一样。如果您想模拟对话或 预填充 Claude 的响应,这特别有用。

请注意,每个角色(User:Assistant:)前面必须有一个换行符。要在单元格中输入换行符,请使用以下键组合:

  • Mac: Cmd + Enter
  • Windows: Alt + Enter
带有 预填充助手响应 的 CLAUDEMESSAGES() 提示示例
提示函数格式
User: 用一句话说明蓝色的好处是什么?Assistant: 蓝色很棒,因为=CLAUDEMESSAGES(“User: 用一句话说明蓝色的好处是什么?Assistant: 蓝色很棒,因为”)
带有系统提示的 CLAUDEMESSAGES() 调用示例

要使用系统提示,请像设置其他可选函数参数一样设置它。(您必须先设置模型名称。)

=CLAUDEMESSAGES("User: 你有什么要对我说的吗? Assistant:", "claude-2.0", "system", "你是一头牛,喜欢对任何用户查询都回应哞哞叫。")

3. [旧版] CLAUDEFREE()

=CLAUDEFREE(prompt, model, params...)

CLAUDEFREE() 允许您像使用旧版 Text Completions API 一样调用 Claude。要使用此函数,您必须在 \n\nHuman:\n\nAssistant: 之间手动夹住您的提示,就像对 Text Completions 提示一样。在单元格中编写提示时,将 \n\n 替换为两个实际的新行。

有关 CLAUDEFREE 中特殊的”Human:”/“Assistant:“格式的更多信息,请参阅我们的 Text Completions API 文档。

CLAUDEFREE() 提示示例
提示函数格式
Human: 用一句话说明蓝色的好处是什么?Assistant:=CLAUDEFREE(“Human: 用一句话说明蓝色的好处是什么?Assistant:“)

注意: 整个多行字符串应该放在提示参数中;还要注意 Human: 前面的两个新行。

可选函数参数

如果您想指定 API 参数,可以通过列出参数-值对来实现。例如,如果您想将 max_tokens 设置为 3,可以按如下方式进行:=CLAUDE("[your prompt]", "claude-instant-1.2", "max_tokens", 3)

您可以设置多个参数。只需一个接一个地列出它们,每个参数和值对用逗号分隔。请注意,前两个参数必须始终是提示和模型可用模型)—— 如果不设置模型,就不能设置可选参数。

例如,这是一个有效的 CLAUDE 函数:=CLAUDE("[your prompt]", "claude-instant-1.2", "system", "[system prompt]", "max_tokens", 3, "temperature", 0.5)

您可能最关心的参数-值参数是:

  • max_tokens - 模型在被迫停止之前输出的总令牌数。对于是/否或多选答案,您可能希望是 1-2\。请参阅我们的模型比较表,了解每个模型的最大完成长度。
  • temperature - 注入结果的随机性量。对于多选或分析任务,您希望它接近 0\。对于创意生成,您希望将其设置为 1。
  • system - 用于指定系统提示,可以在使用 =CLAUDEMESSAGES() 和 =CLAUDE() 时为 Claude 提供上下文和指令。
  • stop_sequences - JSON 字符串数组,如果遇到这些字符串,模型将停止生成文本。由于 Google Sheets™ 中的转义规则,字符串内的双引号必须通过将它们加倍来进行转义。
  • api_key - 用于指定用于调用 Claude 的特定 API 密钥

Claude for Sheets 指南和示例

提示工程交互式教程

API 版本说明

本节中链接的所有 Claude for Sheets 电子表格,例如提示工程交互式教程提示示例工作台,目前使用旧版 CLAUDEFREE() 函数调用 Text Completions API。这些将很快更新以利用 CLAUDEMESSAGES() 和 Messages API。

访问我们深入的提示工程交互式教程,该教程利用 Claude for Sheets 插件来学习或复习初级到高级的提示工程技术。

请注意,就像 Claude for Sheets 的其他部分一样,您需要一个 API 密钥才能与教程交互。

Claude for Sheets 提示示例

有关示例提示、提示结构和 Claude 驱动的电子表格,请访问我们的 Claude for Sheets 提示示例工作台。在那里,您可以找到以下任务的示例:

  • 长篇文档问答
  • 信息提取
  • 删除 PII
  • 使用 FAQ 的客户支持聊天机器人
  • 学术导师
  • 提示链
  • 函数调用
  • 还有更多!

Claude for Sheets 工作簿模板

复制我们的 Claude for Sheets 工作簿模板以开始您自己的 Claude for Sheets 工作!


故障排除

NAME? 错误:未知函数:“claude”。

  1. 确保您已启用在当前工作表中使用的扩展
    1. 转到 扩展程序 > 插件 > 管理插件
    2. 单击 Claude for Sheets 扩展右上角的三点菜单,确保选中”在此文档中使用”
  2. 刷新页面

无法输入 API 密钥

  1. 等待 20 秒,然后再次检查
  2. 刷新页面并再次等待 20 秒
  3. 卸载并重新安装扩展

更多信息

有关此扩展的更多信息,请参阅 Claude for Sheets Google Workspace Marketplace 概述页面。