AI Sheet Formulas

AI Sheet Formulas intègre le flux de travail IA du module directement dans la grille du tableur. Au lieu d'ouvrir la barre latérale pour chaque tâche, vous pouvez saisir une formule personnalisée comme =AIASK(...) et obtenir des résultats générés par l'IA qui se répartissent dans la feuille.

Pour des exemples à copier de chaque formule, ouvrez Extensions → Text To Table Converter → ✨ AI Sheet Formulas.

Avant de commencer#

• Ouvrez une fois la barre latérale du module et terminez la connexion avec le même compte ou profil.
• Définissez AI Permission sur Allow dans Settings. Les formules ne peuvent pas demander d'autorisation depuis une cellule.
• Chaque appel de formule qui atteint l'IA compte comme une requête IA, quel que soit le nombre de lignes de sa plage. Le forfait gratuit inclut 25 requêtes IA tous les 30 jours ; Pro est illimité.
• Les résultats sont mis en cache pendant 6 heures. Recalculer une formule avec la même instruction et les mêmes données renvoie la réponse en cache et ne compte pas comme une nouvelle requête.
• Utilisez des formules à plage, comme A2:A50, plutôt que de faire glisser vers le bas une formule à cellule unique.

Formules disponibles#

• =AIASK(instruction, [input_range], [refresh])
• =AITAG(value, tags, [refresh])
• =AITRANSLATE(input_range, target_language, [refresh])
• =AIVOCAB(text_range, language, [refresh])
• =AIPATTERN(example_range, target_range, [refresh])
• =AIDRAFT(prompt, context_range, [refresh])
• =AIMERGE(instruction, input_range, [refresh])
• =AISPLIT(input_range, split_instruction, [refresh])
• =AITABLE(prompt, [context_range], [refresh])
• =AIREVERSECALC(target_ref, input_range_ref, [max_candidates], [tolerance], [refresh])

Rôle de chaque formule#

• AIASK : extraction par lot, nettoyage ou réponse à des questions sur une plage
• AITAG : étiquette chaque valeur à partir d'une liste de tags autorisés
• AITRANSLATE : traduit chaque valeur dans une langue cible
• AIVOCAB : lit toute la plage et renvoie un élément de vocabulaire clé sous la forme Term | Pronunciation | Meaning | Example sentence (l'argument de langue définit la langue de la signification et de l'exemple)
• AIPATTERN : apprend un modèle de transformation à partir de paires exemple entrée-sortie, puis l'applique à une plage cible
• AIDRAFT : génère une rédaction par ligne
• AIMERGE : fusionne chaque ligne en une seule cellule de synthèse ou de sortie rédigée par l'IA
• AISPLIT : divise chaque ligne d'entrée en éléments structurés répartis sur plusieurs colonnes
• AITABLE : génère un tableau texte complet avec en-têtes, réparti sur plusieurs lignes et colonnes
• AIREVERSECALC : propose des formules candidates capables de retrouver une valeur cible à partir d'une plage source

Exemples courants#

=AIASK("Extract the primary domain from this email address", A2:A50, $Z$1)

=AITAG(A2:A200, "van life, freedom, outdoors", $Z$1)

=AITRANSLATE(A2:A200, "German", $Z$1)

=AIVOCAB(A2:A50, "English", $Z$1)

=AIPATTERN(A2:B5, A6:A100, $Z$1)

=AIDRAFT("Write a 2-sentence polite rejection email citing this reason:", C2:C20, $Z$1)

=AIMERGE("Summarize each row in one sentence", A2:C50, $Z$1)

=AISPLIT(A2:A50, "Split into Name, City, Issue", $Z$1)

=AITABLE("List the top 5 US cities by population with columns for State, Mayor, and Population", , $Z$1)

=AIREVERSECALC("E10", "A2:C10", 5, 0.01, $Z$1)

Limites de lot et remarques sur la sortie#

Limites importantes#

• Les noms de formules s'écrivent AI... sans point, par exemple AIASK et non AI.ASK.
• Les fonctions personnalisées de formule sont disponibles uniquement dans Google Sheets™.
• Les sorties des formules sont du texte brut uniquement. Utilisez AI Agents si vous avez besoin de mise en forme après la génération.
• Les fonctions personnalisées de Google Apps Script ont une limite stricte d'exécution de 30 secondes.
• AITABLE et AISPLIT peuvent s'étendre sur une grande zone. Effacez d'abord toute la zone de sortie pour éviter #REF!.
• AIREVERSECALC attend des références de style A1 sous forme de texte, comme "E10" et "A2:C10". La cellule cible doit contenir un nombre, et les formules proposées n'utilisent que +, -, * et /.
• Les plages d'exemples de AIPATTERN doivent comporter exactement deux colonnes : l'entrée et la sortie attendue.
• Les formules par ligne acceptent au total jusqu'à 24 000 caractères de données d'entrée.
• Les lignes d'entrée vides sont ignorées et renvoient des cellules vides.
• Ne faites pas glisser AIASK ou des formules similaires sur 50 lignes distinctes. Chaque copie est une requête IA distincte et une exécution distincte de 30 secondes. Utilisez plutôt une seule formule à plage.

Bonnes pratiques#

• L'argument facultatif [refresh] (par exemple une case à cocher en $Z$1) force Sheets à recalculer la formule. Il ne contourne pas le cache de 6 heures : pour obtenir une réponse différente, modifiez l'instruction ou les données d'entrée.
• Gardez de petites paires d'exemples représentatives pour AIPATTERN. Quatre à six exemples suffisent généralement.
• Libérez suffisamment d'espace avant d'exécuter AISPLIT, AITABLE ou AIVOCAB.
• Concentrez AIREVERSECALC sur une petite plage source numérique.
• Si une formule expire, réduisez la taille de la plage avant de réessayer.

Dépannage#

• Error: AI permission must be set to Allow in add-on Settings.

Ouvrez Settings, définissez AI Permission sur Allow, puis recalculez la feuille.

• Error: AI usage limit reached.

Votre quota IA est épuisé. Attendez la réinitialisation ou passez à une offre supérieure, puis réessayez.

• Error: AIASK supports up to 200 rows. Use fewer rows. (ou le même message pour une autre formule)

Les données d'entrée dépassent la limite de lot de cette formule. Divisez-les en plages plus petites.

• Error: AIASK input too large. Reduce text length or rows.

Le texte cumulé dépasse la limite de caractères. Utilisez moins de lignes ou des cellules plus courtes.

• Error: no result (try fewer rows)

La réponse de l'IA a été interrompue avant d'atteindre ces lignes. Exécutez la formule sur une plage plus petite.

• Error: AI response malformed. Try again.

L'IA a renvoyé un contenu que le module n'a pas pu lire. Recalculez, ou modifiez légèrement l'instruction.

• Error: AI call failed. Try again later.

Réessayez avec moins de lignes. Si l'erreur persiste, vérifiez l'état du module ou du serveur.

• #REF!

Des cellules du chemin de déversement contiennent déjà des données. Effacez d'abord la zone de sortie.

• #ERROR!

La fonction a probablement atteint la limite de 30 secondes d'Apps Script. Réduisez la plage et réessayez.

Guides associés#

• AI Agents - Utilisez des workflows IA pilotés depuis la barre latérale pour le nettoyage de feuille, la mise en forme, les formules et les requêtes de suivi.

• Settings - Consultez les autorisations IA et les autres paramètres qui affectent les fonctions IA.