Installazione di Claude for Sheets

Abilita facilmente Claude for Sheets seguendo questi passaggi:

  1. Ottieni la tua chiave API di Claude: Non sarai in grado di utilizzare Claude for Sheets senza una chiave API per sviluppatori. Per ulteriori informazioni su come acquisire una chiave API, consulta ottenere l’accesso a Claude.
  2. Installa l’estensione Claude for Sheets
    1. Clicca qui per accedere all’estensione Claude for Sheets o cerca Claude for Sheets nel marketplace delle estensioni.
    2. Clicca sul pulsante blu Installa e accetta le autorizzazioni.
  3. Collega la tua chiave API: Inserisci la tua chiave API in Estensioni > Claude for Sheets™ > Inserisci la tua chiave API Anthropic. Potrebbe essere necessario attendere o aggiornare affinché “Inserisci la tua chiave API Anthropic” appaia come opzione.

Dopo aver visto il segno di spunta verde ✅, Claude sarà attivato e pronto all’interno del tuo Google Sheet.

Dovrai reinserire la tua chiave API ogni volta che crei un nuovo Google Sheet

Autorizzazioni

Durante l’installazione, l’estensione Claude for Sheets richiederà una varietà di autorizzazioni necessarie per funzionare correttamente. Sebbene le autorizzazioni richieste per eseguire Claude in Sheets siano ampie, ti assicuriamo che elaboriamo solo le parti specifiche dei dati su cui gli utenti chiedono a Claude di eseguire. Questi dati non vengono mai utilizzati per addestrare i nostri modelli generativi.

Le autorizzazioni dell’estensione includono:

  • Visualizzare e gestire i fogli di calcolo in cui è stata installata questa applicazione - necessario per eseguire i prompt e restituire i risultati
  • Connettersi a un servizio esterno - necessario per effettuare chiamate agli endpoint API di Anthropic
  • Consentire a questa applicazione di essere eseguita quando non sei presente - necessario per eseguire i ricalcoli delle celle senza l’intervento dell’utente
  • Visualizzare ed eseguire contenuti web di terze parti nei prompt e nelle barre laterali all’interno delle applicazioni Google - necessario per visualizzare la barra laterale e il prompt post-installazione

Ricalcolo delle celle

Puoi ricalcolare manualmente le celle #ERROR!, ⚠ DEFERRED ⚠ o ⚠ THROTTLED ⚠ selezionando tra le opzioni di ricalcolo nel menu dell’estensione Claude for Sheets.


Come utilizzare Claude for Sheets

Funzioni di Claude

Ci sono due funzioni principali che puoi utilizzare per chiamare Claude utilizzando Claude for Sheets:

1. CLAUDE()

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

CLAUDE() è il modo più semplice per chiamare Claude utilizzando Claude for Sheets. Per utilizzare questa funzione, tutto ciò di cui hai bisogno è un prompt in testo semplice senza formattazione aggiuntiva. Questa è la funzione che probabilmente vorrai utilizzare la maggior parte delle volte. È identica all’interfaccia Slackbot di Claude e alla modalità “Chat” sulla Console.

Esempio di prompt CLAUDE()
PromptFormato della funzione
In una frase, cosa c’è di buono nel colore blu?=CLAUDE(“In una frase, cosa c’è di buono nel colore blu?“)
In una frase, cosa c’è di buono nel colore blu? Restituisci la tua risposta tra tag <answer>.[Con parametri]=CLAUDE(“In una frase, cosa c’è di buono nel colore blu? Restituisci la tua risposta tra tag .”,“claude-3-opus-20240229”,“temperature”, 0.2,“max_tokens”, 50,“stop_sequences”, ”[""""]”,“api_key”, “sk-ant-api03-j1W…“)

2. CLAUDEMESSAGES()

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

Utilizza CLAUDEMESSAGES() per inviare una serie di messaggi User: e Assistant: a Claude, come se stessi utilizzando l’API Messages. Questo è particolarmente utile se vuoi simulare una conversazione o precompilare la risposta di Claude.

Nota che ogni ruolo (User: o Assistant:) deve essere preceduto da una singola nuova riga. Per inserire nuove righe in una cella, utilizza le seguenti combinazioni di tasti:

  • Mac: Cmd + Invio
  • Windows: Alt + Invio
Esempio di prompt CLAUDEMESSAGES() con risposta precompilata dell’assistente
PromptFormato della funzione
User: In una frase, cosa c’è di buono nel colore blu?Assistant: Il colore blu è fantastico perché=CLAUDEMESSAGES(“User: In una frase, cosa c’è di buono nel colore blu?Assistant: Il colore blu è fantastico perché”)
Esempio di chiamata CLAUDEMESSAGES() con prompt di sistema

Per utilizzare un prompt di sistema, impostalo come imposteresti altri parametri opzionali della funzione. (Devi prima impostare un nome di modello.)

=CLAUDEMESSAGES("User: Hai qualcosa da dirmi? Assistant:", "claude-2.0", "system", "Sei una mucca che ama muggire in risposta a qualsiasi domanda dell'utente.")

3. [Legacy] CLAUDEFREE()

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

CLAUDEFREE() ti consente di chiamare Claude come se stessi utilizzando la legacy API Text Completions. Per utilizzare questa funzione, dovrai inserire manualmente il tuo prompt tra \n\nHuman: e \n\nAssistant: come faresti per un prompt di Text Completions. Sostituisci \n\n con due nuove righe effettive quando scrivi il tuo prompt in una cella.

Per ulteriori informazioni sulla formattazione speciale “Human:”/“Assistant:” in CLAUDEFREE, consulta la nostra documentazione sull’API Text Completions.

Esempio di prompt CLAUDEFREE()
PromptFormato della funzione
Human: In una frase, cosa c’è di buono nel colore blu?Assistant:=CLAUDEFREE(“Human: In una frase, cosa c’è di buono nel colore blu?Assistant:“)

Nota: Questa intera stringa multilinea dovrebbe andare nel parametro prompt; nota anche le due nuove righe prima di Human:.

Parametri opzionali della funzione

Se vuoi specificare i parametri dell’API, puoi farlo elencando coppie argomento-valore. Ad esempio, se vuoi impostare max_tokens a 3, puoi farlo come segue: =CLAUDE("[tuo prompt]", "claude-instant-1.2", "max_tokens", 3).

Puoi impostare più parametri. Semplicemente elencali uno dopo l’altro, con ogni coppia argomento-valore separata da virgole. Nota che i primi due parametri devono sempre essere il prompt e il modello (modelli disponibili) — non puoi impostare un parametro opzionale senza impostare anche il modello.

Ad esempio, questa è una funzione CLAUDE valida: =CLAUDE("[tuo prompt]", "claude-instant-1.2", "system", "[prompt di sistema]", "max_tokens", 3, "temperature", 0.5)

I parametri argomento-valore che potrebbero interessarti di più sono:

  • max_tokens - il numero totale di token che il modello produce prima di essere forzato a fermarsi. Per risposte sì/no o a scelta multipla, probabilmente vorrai 1-2. Consulta la nostra tabella di confronto dei modelli per la lunghezza massima di completamento per ogni modello.
  • temperature - la quantità di casualità iniettata nei risultati. Per attività a scelta multipla o analitiche, la vorrai vicina a 0. Per la generazione di idee, la vorrai impostata a 1.
  • system - utilizzato per specificare un prompt di sistema, che può fornire contesto e istruzioni a Claude quando si utilizza =CLAUDEMESSAGES() e =CLAUDE().
  • stop_sequences - array JSON di stringhe che faranno sì che il modello smetta di generare testo se incontrate. A causa delle regole di escape in Google Sheets™, le virgolette doppie all’interno della stringa devono essere precedute da un carattere di escape raddoppiandole.
  • api_key - utilizzato per specificare una particolare chiave API con cui chiamare Claude

Guide ed esempi di Claude for Sheets

Tutorial interattivo di ingegneria dei prompt

Nota sulla versione dell’API

Tutti i fogli di calcolo di Claude for Sheets collegati all’interno di questa sezione, come il tutorial interattivo di ingegneria dei prompt e il workbench di esempi di prompting, attualmente utilizzano la funzione legacy CLAUDEFREE() che chiama l’API Text Completions. Questi saranno presto aggiornati per utilizzare CLAUDEMESSAGES() e l’API Messages.

Visita il nostro approfondito tutorial interattivo di ingegneria dei prompt che utilizza l’add-on Claude for Sheets per imparare o ripassare le tecniche di ingegneria dei prompt da principiante ad avanzate.

Nota che, proprio come per il resto di Claude for Sheets, avrai bisogno di una chiave API per interagire con il tutorial.

Esempi di prompting di Claude for Sheets

Per esempi di prompt, strutture di prompting e fogli di calcolo basati su Claude, visita il nostro workbench di esempi di prompting di Claude for Sheets. Lì, puoi trovare esempi per attività come le seguenti:

  • Q&A su documenti lunghi
  • Estrazione di informazioni
  • Rimozione di PII
  • Chatbot di supporto clienti utilizzando FAQ
  • Tutor accademico
  • Concatenamento di prompt
  • Chiamata di funzioni
  • E molto altro!

Modello di cartella di lavoro di Claude for Sheets

Fai una copia del nostro modello di cartella di lavoro di Claude for Sheets per iniziare con il tuo lavoro su Claude for Sheets!


Risoluzione dei problemi

Errore NAME?: Funzione sconosciuta: ‘claude’.

  1. Assicurati di aver abilitato l’estensione per l’uso nel foglio corrente
    1. Vai a Estensioni > Componenti aggiuntivi > Gestisci componenti aggiuntivi
    2. Fai clic sul menu con i tre puntini nell’angolo in alto a destra dell’estensione Claude for Sheets e assicurati che “Usa in questo documento” sia selezionato
  2. Aggiorna la pagina

Impossibile inserire la chiave API

  1. Attendi 20 secondi, quindi controlla di nuovo
  2. Aggiorna la pagina e attendi di nuovo 20 secondi
  3. Disinstalla e reinstalla l’estensione

Ulteriori informazioni

Per ulteriori informazioni riguardanti questa estensione, consulta la pagina di panoramica del Google Workspace Marketplace di Claude for Sheets.