openai excel functions

Функции API OpenAI для Excel

Создание дополнений чата OpenAI на основе формул Excel

Ориентированная на разработчиков надстройка Excel, которая предоставляет =OAI.CHAT_COMPLETE() для вызова API завершения и вспомогательных функций. Используйте возможности электронных таблиц для быстрого проектирования, оперативной декомпозиции, создания прототипов систем и многого другого.

Зачем эта надстройка

• Бесплатно — используйте свой собственный ключ API
• Конфиденциально — вызовы направляются непосредственно в API OpenAI.
• Комплексный — поддерживает все модели и параметры.
• Observable — просмотр и использование всех данных запросов и ответов API.
• Открытый исходный код

Создано с учетом требований разработчиков генеративного ИИ. Доступны и другие продукты, которые могут быть более подходящими для использования генеративного ИИ в электронных таблицах общего характера. Как правило, мы не включаем удобные функции для задач, которые можно выполнить с помощью встроенных функций Excel.

Блог

Прочтите нашу публикацию «Быстрое проектирование с помощью электронных таблиц» в блоге Scott Logic, где вы также найдете гораздо больше об искусственном интеллекте и программном обеспечении.

Установка

Надстройка устанавливается посредством процесса «неопубликованной загрузки», при котором вы загружаете файл манифеста в Excel, который затем загружает код надстройки непосредственно из GitHub. Он не публикуется в Office Store.

Сначала загрузите файл manifest.xml . Вам не нужно будет изменять это или загружать что-либо еще — не обращайте внимания на подобные инструкции в следующих связанных инструкциях.

Следуйте инструкциям по загрузке неопубликованных приложений для вашей платформы:

• В Интернете используйте метод «загрузки неопубликованных файлов вручную».
• В Windows используйте опцию «Настроить доверие вручную» на соответствующем шаге.

Тип =OAI. в строке формул или ячейке, и вы должны увидеть новые функции.

Удаление

В Интернете очистите файлы cookie браузера для своего домена.

На других платформах очистите кеш Office.

Использование

OAI.CHAT_COMPLETE() вызывает API для создания дополнений. Обычно для вызова модели создается лист, содержащий параметры. Первый столбец используется в качестве ключей параметров, а второй — в качестве значений. Параметр API_KEY является обязательным, и его значение должно быть получено из консоли OpenAI.

OAI.COST() вычисляет стоимость выставления счета для ячеек завершения. Оберните его с помощью SUM() чтобы вычислить сумму.

Полную документацию по функциям и параметрам см. в метаданных функции. Представление документации пользовательских функций в Excel различается по полноте в зависимости от платформы, но лучше всего использовать диалоговое окно «Вставка функции» и/или платформу настольного компьютера.

Осторожность

Мы советуем соблюдать осторожность, чтобы избежать непреднамеренных чрезмерных затрат при работе с большим количеством ячеек заканчивания или дорогостоящими заканчиваниями. Изменения в ячейках зависимостей могут вызвать массовый пересчет, а определенные действия в Excel могут вызвать полный пересчет. Возможно, вы захотите переключить режим вычислений в Excel с автоматического на ручной. Параллельно выполняется не более 10 запросов API — для отмены ожидающих или ожидающих запросов, отмены изменений или удаления формулы.

Использование результатов завершения

Завершения заполняют ячейку пользовательским типом данных, который включает полный запрос и ответ API. Его текстовое значение — это содержимое первого варианта завершения.

Чтобы получить текстовое значение для использования в формулах, используйте функцию VALUETOTEXT() . Чтобы получить другие данные запроса/ответа, используйте точечную запись пути к свойству (например, A123.response.model ).

Для просмотра данных о завершении откройте карточку объекта. lines обеспечивает построчное представление содержимого завершения.

Чтобы получить окончательный ответ, который следует за цепочкой мыслей, вы можете использовать такую ​​формулу, как:

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

Разработка надстройки

Инструкции по началу разработки

Предварительные условия

Если вы используете Windows, настройте NPM на использование sh-совместимой оболочки, например:

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

Настройте свою IDE так, чтобы она соответствовала форматированию кода проекта. Для VSCode они будут загружены из настроек рабочей области в .vscode/ ; для других редакторов/IDE вам потребуется настроить аналогично. Возможно, вам придется отменить/отключить любые личные настройки или расширения, которые мешают.

Установите и запустите

1. Установите зависимости npm ( npm i )
2. Сгенерируйте и установите сертификаты ( npm run install-certs )
3. Запустите локальный сервер ( npm start ).

Кроме того, вам может потребоваться перейти в корень браузера и временно доверять вновь созданной паре сертификат-ключ.

Открыть в веб-версии Excel

1. Откройте электронную таблицу в Excel в Интернете и добавьте следующие параметры строки запроса.

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

2. Если вам будет предложено включить режим разработчика Excel, сделайте это.

Теперь вы сможете использовать функции как обычно. При внесении изменений вам потребуется перезагрузить окно браузера.

Открыть на рабочем столе Excel

npm run sideload:desktop

Ключевые файлы

Путь	Описание
источник/функции/functions.json	Метаданные, описывающие каждую функцию и ссылающиеся на ее реализацию.
источник/функции/functions.mjs	Функции JavaScript, реализующие функции.
общий.html	Корневая страница загружается в фоновом режиме во время запуска надстройки.
манифест-local.xml	Версия манифеста.xml, которая ссылается на https://localhost:3000/ для использования при разработке надстроек.
манифест.xml	Настраивает, откуда надстройка должна быть загружена и какие функции она будет использовать.