​
Instalando o Claude for Sheets

Habilite facilmente o Claude for Sheets seguindo estas etapas:

  1. Obtenha sua chave de API do Claude: Você não poderá usar o Claude for Sheets sem uma chave de API de desenvolvedor. Para obter mais informações sobre como adquirir uma chave de API, consulte obtendo acesso ao Claude.
  2. Instale a extensão Claude for Sheets
    1. Clique aqui para acessar a extensão Claude for Sheets ou pesquise Claude for Sheets no marketplace de complementos.
    2. Clique no botão azul Instalar e aceite as permissões.
  3. Conecte sua chave de API: Insira sua chave de API em Extensões > Claude for Sheets™ > Enter your Anthropic API Key. Talvez seja necessário aguardar ou atualizar para que “Enter your Anthropic API key” apareça como uma opção.

Depois de ver a marca de verificação verde ✅, o Claude será ativado e estará pronto em sua planilha do Google.

Você precisará inserir novamente sua chave de API sempre que criar uma nova planilha do Google

​
Permissões

Durante a instalação, a extensão Claude for Sheets solicitará uma variedade de permissões necessárias para funcionar corretamente. Embora as permissões solicitadas para executar o Claude no Sheets sejam amplas, fique tranquilo que apenas processamos os dados específicos que os usuários pedem ao Claude para executar. Esses dados nunca são usados para treinar nossos modelos generativos.

As permissões da extensão incluem:

  • Visualizar e gerenciar planilhas nas quais este aplicativo foi instalado - necessário para executar prompts e retornar resultados
  • Conectar-se a um serviço externo - necessário para fazer chamadas para os endpoints da API da Anthropic
  • Permitir que este aplicativo seja executado quando você não estiver presente - necessário para executar recálculos de células sem intervenção do usuário
  • Exibir e executar conteúdo da web de terceiros em prompts e barras laterais dentro dos aplicativos do Google - necessário para exibir a barra lateral e o prompt pós-instalação

Recálculo de Células

Você pode recalcular manualmente células #ERROR!, ⚠ DEFERRED ⚠ ou ⚠ THROTTLED ⚠ selecionando uma das opções de recálculo no menu da extensão Claude for Sheets.

​
Como usar o Claude for Sheets

​
Funções do Claude

Existem duas funções principais que você pode usar para chamar o Claude usando o Claude for Sheets:

​
1. CLAUDE()

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

CLAUDE() é a maneira mais simples de chamar o Claude usando o Claude for Sheets. Para usar essa função, tudo o que você precisa é de um prompt de texto simples, sem formatação adicional. Essa é a função que você provavelmente usará na maioria das vezes. Isso é idêntico à interface do Slackbot Claude e ao modo “Chat” no Console.

Exemplo de prompt CLAUDE()
PromptFormato da função
Em uma frase, o que é bom sobre a cor azul?=CLAUDE(“Em uma frase, o que é bom sobre a cor azul?“)
Em uma frase, o que é bom sobre a cor azul? Coloque sua resposta entre tags <answer>.[Com parâmetros]=CLAUDE(“Em uma frase, o que é bom sobre a cor azul? Coloque sua resposta entre tags .”,“claude-3-opus-20240229”,“temperature”, 0.2,“max_tokens”, 50,“stop_sequences”, ”[""""]”,“api_key”, “sk-ant-api03-j1W…“)

​
2. CLAUDEMESSAGES()

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

Use CLAUDEMESSAGES() para enviar uma série de mensagens User: e Assistant: para o Claude, como se você estivesse usando a API de Mensagens. Isso é particularmente útil se você quiser simular uma conversa ou preencher previamente a resposta do Claude.

Observe que cada função (User: ou Assistant:) deve ser precedida por uma única nova linha. Para inserir novas linhas em uma célula, use as seguintes combinações de teclas:

  • Mac: Cmd + Enter
  • Windows: Alt + Enter
Exemplo de prompt CLAUDEMESSAGES() com resposta de assistente preenchida previamente
PromptFormato da função
User: Em uma frase, o que é bom sobre a cor azul?Assistant: A cor azul é ótima porque=CLAUDEMESSAGES(“User: Em uma frase, o que é bom sobre a cor azul?Assistant: A cor azul é ótima porque”)
Exemplo de chamada CLAUDEMESSAGES() com prompt do sistema

Para usar um prompt do sistema, defina-o como você definiria outros parâmetros opcionais da função. (Você deve primeiro definir um nome de modelo.)

=CLAUDEMESSAGES("User: Tem algo a me dizer? Assistant:", "claude-2.0", "system", "Você é uma vaca que adora mugir em resposta a todas e quaisquer perguntas do usuário.")

​
3. [Legado] CLAUDEFREE()

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

CLAUDEFREE() permite que você chame o Claude como se estivesse usando a API legada de Conclusões de Texto. Para usar essa função, você precisará colocar manualmente seu prompt entre \n\nHuman: e \n\nAssistant:, como faria para um prompt de Conclusões de Texto. Substitua \n\n por duas novas linhas reais ao escrever seu prompt em uma célula.

Para obter mais informações sobre a formatação especial “Human:”/“Assistant:” no CLAUDEFREE, consulte nossa documentação da API de Conclusões de Texto.

Exemplo de prompt CLAUDEFREE()
PromptFormato da função
Human: Em uma frase, o que é bom sobre a cor azul?Assistant:=CLAUDEFREE(“Human: Em uma frase, o que é bom sobre a cor azul?Assistant:“)

Nota: Toda essa string de várias linhas deve entrar no parâmetro de prompt; observe também as duas novas linhas antes de Human:.

​
Parâmetros opcionais da função

Se você quiser especificar parâmetros da API, pode fazê-lo listando pares de argumento-valor. Por exemplo, se você quiser definir max_tokens como 3, pode fazer o seguinte: =CLAUDE("[seu prompt]", "claude-instant-1.2", "max_tokens", 3).

Você pode definir vários parâmetros. Basta listá-los um após o outro, com cada par de argumento e valor separado por vírgulas. Observe que os dois primeiros parâmetros devem ser sempre o prompt e o modelo (modelos disponíveis) — você não pode definir um parâmetro opcional sem também definir o modelo.

Por exemplo, esta é uma função CLAUDE válida: =CLAUDE("[seu prompt]", "claude-instant-1.2", "system", "[prompt do sistema]", "max_tokens", 3, "temperature", 0.5)

Os parâmetros de argumento-valor com os quais você pode se importar mais são:

  • max_tokens - o número total de tokens que o modelo gera antes de ser forçado a parar. Para respostas sim/não ou de múltipla escolha, você provavelmente deseja 1-2. Consulte nossa tabela de comparações de modelos para obter o comprimento máximo de conclusão para cada modelo.
  • temperature - a quantidade de aleatoriedade injetada nos resultados. Para tarefas de múltipla escolha ou analíticas, você desejará que esteja próximo de 0. Para geração de ideias, você desejará que seja definido como 1.
  • system - usado para especificar um prompt do sistema, que pode fornecer contexto e instruções ao Claude ao usar =CLAUDEMESSAGES() e =CLAUDE().
  • stop_sequences - matriz JSON de strings que farão com que o modelo pare de gerar texto se encontradas. Devido às regras de escape no Google Sheets™, aspas duplas dentro da string devem ser escapadas dobrando-as.
  • api_key - usado para especificar uma chave de API específica com a qual chamar o Claude

​
Guias e exemplos do Claude for Sheets

​
Tutorial interativo de engenharia de prompts

Nota sobre a versão da API

Todas as planilhas do Claude for Sheets vinculadas nesta seção, como o tutorial interativo de engenharia de prompts e a bancada de trabalho de exemplos de prompts, atualmente usam a função legada CLAUDEFREE() que chama a API de Conclusões de Texto. Elas serão atualizadas em breve para utilizar CLAUDEMESSAGES() e a API de Mensagens.

Visite nosso tutorial interativo aprofundado de engenharia de prompts utilizando o complemento Claude for Sheets para aprender ou revisar técnicas de engenharia de prompts do iniciante ao avançado.

Observe que, assim como no restante do Claude for Sheets, você precisará de uma chave de API para interagir com o tutorial.

​
Exemplos de prompts do Claude for Sheets

Para exemplos de prompts, estruturas de prompts e planilhas alimentadas pelo Claude, visite nossa bancada de trabalho de exemplos de prompts do Claude for Sheets. Lá, você pode encontrar exemplos para tarefas como:

  • Perguntas e respostas de documentos longos
  • Extração de informações
  • Remoção de PII
  • Chatbot de suporte ao cliente usando FAQ
  • Tutor acadêmico
  • Encadeamento de prompts
  • Chamada de função
  • E muito mais!

​
Modelo de pasta de trabalho do Claude for Sheets

Faça uma cópia do nosso modelo de pasta de trabalho do Claude for Sheets para começar com seu próprio trabalho no Claude for Sheets!

​
Solução de problemas

​
Erro NAME?: Função desconhecida: ‘claude’.

  1. Certifique-se de ter habilitado a extensão para uso na planilha atual
    1. Vá para Extensões > Complementos > Gerenciar complementos
    2. Clique no menu de três pontos no canto superior direito da extensão Claude for Sheets e certifique-se de que “Usar neste documento” esteja marcado
  2. Atualize a página

​
Não é possível inserir a chave de API

  1. Aguarde 20 segundos e verifique novamente
  2. Atualize a página e aguarde mais 20 segundos
  3. Desinstale e reinstale a extensão

​
Mais informações

Para obter mais informações sobre esta extensão, consulte a página de visão geral do Claude for Sheets no Google Workspace Marketplace.

EmbeddingsVisão geral