openai excel functions

Fonctions de l'API OpenAI pour Excel

Créer des complétions de chat OpenAI à partir de formules Excel

Complément Excel orienté développeur qui fournit =OAI.CHAT_COMPLETE() pour appeler l'API de complétion et les assistants. Utilisez la puissance des feuilles de calcul pour une ingénierie rapide, une décomposition rapide, des systèmes de prototypage, et bien plus encore.

Pourquoi ce complément

• Gratuit - utilisez votre propre clé API
• Confidentiel : les appels sont directement dirigés vers l'API d'OpenAI
• Complet - prend en charge tous les modèles et paramètres
• Observable - afficher et utiliser toutes les données de requête et de réponse API
• Source ouverte

Conçu pour les développeurs d'IA générative - d'autres produits sont disponibles et peuvent être plus adaptés à l'utilisation de l'IA générative dans des feuilles de calcul générales. En règle générale, nous n'incluons pas de fonctions pratiques pour les tâches qui peuvent être raisonnablement accomplies à l'aide des fonctions Excel intégrées.

Blogue

Lisez notre article Ingénierie rapide avec des feuilles de calcul sur le blog Scott Logic, où vous trouverez également beaucoup plus d'informations sur l'intelligence artificielle et tout ce qui concerne les logiciels.

Installation

Le complément est installé via un processus de « chargement latéral », dans lequel vous chargez le fichier manifeste dans Excel, qui charge ensuite le code du complément directement depuis GitHub. Il n’est pas publié sur Office Store.

Tout d’abord, téléchargez le fichier manifest.xml . Vous n'aurez pas besoin de modifier cela ou de télécharger quoi que ce soit d'autre - ne tenez pas compte de ces instructions dans les instructions liées suivantes.

Suivez les instructions de chargement latéral pour votre plateforme :

• Sur le Web, utilisez la technique du « chargement latéral manuel ».
• Sous Windows, utilisez l'option « Configurer la confiance manuellement » à l'étape appropriée.

Tapez =OAI. dans la barre de formule ou dans une cellule, et vous devriez voir les nouvelles fonctions.

Désinstallation

Sur le Web, effacez les cookies de votre navigateur pour son domaine.

Pour les autres plates-formes, videz le cache Office.

Usage

OAI.CHAT_COMPLETE() appelle l'API pour créer des complétions. Il est courant de configurer une feuille contenant des paramètres pour l'appel de modèle. La première colonne est utilisée comme clés de paramètres et la seconde comme valeurs. Le paramètre API_KEY est obligatoire et sa valeur doit provenir de la console OpenAI.

OAI.COST() calcule le(s) coût(s) de facturation des cellules de complétion. Enveloppez-le avec SUM() pour calculer un total.

Consultez les métadonnées de la fonction pour une documentation complète des fonctions et des paramètres. La présentation par Excel de la documentation des fonctions personnalisées varie en termes d'exhaustivité selon la plate-forme, mais elle est préférable dans la boîte de dialogue Insérer une fonction et/ou sur la plate-forme de bureau.

Prudence

Nous vous conseillons d'être prudent afin d'éviter d'engager involontairement des coûts excessifs lorsque vous travaillez avec de nombreuses cellules de complétion ou des complétions coûteuses. Les modifications apportées aux cellules de dépendance peuvent entraîner un recalcul en masse, et certaines actions dans Excel peuvent déclencher un recalcul complet. Vous souhaiterez peut-être changer le mode de calcul dans Excel d’automatique à manuel. Un maximum de 10 requêtes API sont effectuées en parallèle - pour annuler les requêtes en attente ou en attente, annuler votre modification ou supprimer la formule.

Utilisation des résultats d'achèvement

Les complétions remplissent la cellule avec un type de données personnalisé qui inclut la demande et la réponse API complètes. Sa valeur texte est le contenu du premier choix de complétion.

Pour obtenir la valeur du texte à utiliser dans les formules, utilisez la fonction VALUETOTEXT() . Pour obtenir d'autres données de requête/réponse, utilisez la notation par points pour le chemin de la propriété (par exemple A123.response.model ).

Pour afficher les données d'achèvement, ouvrez la fiche d'entité. La propriété lines fournit une vue ligne par ligne du contenu de complétion.

Pour extraire une réponse finale qui suit une chaîne de pensée, vous pouvez utiliser une formule telle que :

 =TEXTAFTER(VALUETOTEXT(A123), "<!-- END CoT -->" & CHAR(10))

Développement de compléments

Instructions pour démarrer le travail de développement

Conditions préalables

Si vous êtes sous Windows, configurez NPM pour utiliser un shell compatible sh, par exemple :

npm config set script-shell " C: \ Program Files \ git \ bin \ bash.exe "

Configurez votre IDE pour qu'il respecte le formatage du code du projet. Pour VSCode, ceux-ci seront chargés à partir des paramètres de l'espace de travail dans .vscode/ ; pour les autres éditeurs/IDE, vous devrez configurer de manière équivalente. Vous devrez peut-être désactiver/désactiver tous les paramètres personnels ou extensions qui interfèrent.

Installer et exécuter

1. Installez les dépendances npm ( npm i )
2. Générer et installer des certificats ( npm run install-certs )
3. Exécutez le serveur local ( npm start ).

De plus, vous devrez peut-être accéder à la racine de votre navigateur et faire temporairement confiance à la paire de clés de certificat nouvellement créée.

Ouvrir dans Excel Web

1. Ouvrez une feuille de calcul dans Excel sur le Web et ajoutez les paramètres de chaîne de requête suivants

 wdaddindevserverport=3000&wdaddinmanifestfile=manifest-localhost.xml&wdaddinmanifestguid=00aeeb98-f4d9-4db0-a1e6-cdc652c08e34

2. Si vous êtes invité à activer le mode développeur Excel, faites-le.

Vous devriez maintenant pouvoir utiliser les fonctions normalement. Lorsque vous effectuez une modification, vous devrez recharger la fenêtre du navigateur.

Ouvrir dans le bureau Excel

npm run sideload:desktop

Fichiers clés

Chemin	Description
src/fonctions/fonctions.json	Les métadonnées qui détaillent chaque fonction et référencent sa mise en œuvre.
src/fonctions/fonctions.mjs	Les fonctions JavaScript qui implémentent les fonctions.
partagé.html	Page racine chargée en arrière-plan lors du démarrage du complément.
manifeste-local.xml	Une version de manifest.xml qui fait référence à https://localhost:3000/ pour une utilisation en matière de développement de compléments.
manifeste.xml	Configure l'endroit à partir duquel le complément doit être chargé et les fonctionnalités qu'il utilisera.