openai excel functions

Funciones API de OpenAI para Excel

Cree finalizaciones de chat OpenAI a partir de fórmulas de Excel

Complemento de Excel orientado al desarrollador que proporciona =OAI.CHAT_COMPLETE() para llamar a la API de finalización y ayudantes. Utilice el poder de las hojas de cálculo para ingeniería rápida, descomposición rápida, creación de prototipos de sistemas y más.

¿Por qué este complemento?

• Gratis: use su propia clave API
• Confidencial: las llamadas van directamente a la API de OpenAI
• Integral: admite todos los modelos y parámetros
• Observable: vea y utilice todos los datos de solicitud y respuesta de API
• Código abierto

Creado pensando en los desarrolladores de IA generativa: hay otros productos disponibles que pueden ser más adecuados para usar IA generativa en hojas de cálculo generales. Como regla general, no incluimos funciones de conveniencia para tareas que se pueden realizar razonablemente usando funciones integradas de Excel.

Blog

Lea nuestra publicación Ingeniería rápida con hojas de cálculo en el blog de Scott Logic, donde también encontrará mucho más sobre inteligencia artificial y todo lo relacionado con el software.

Instalación

El complemento se instala mediante un proceso de "carga", en el que se carga el archivo de manifiesto en Excel, que luego carga el código del complemento directamente desde GitHub. No está publicado en Office Store.

Primero, descargue el archivo manifest.xml . No necesitará modificar esto ni descargar nada más; ignore dichas instrucciones en las siguientes instrucciones vinculadas.

Siga las instrucciones de descarga para su plataforma:

• En la web, utilice la técnica de "carga manual".
• En Windows, utilice la opción "configurar la confianza manualmente" en el paso correspondiente.

Tipo =OAI. en la barra de fórmulas o en una celda, y debería ver las nuevas funciones.

Desinstalación

En la web, borre las cookies de su navegador para su dominio.

Para otras plataformas, borre el caché de Office.

Uso

OAI.CHAT_COMPLETE() llama a la API para crear terminaciones. Es típico configurar una hoja que contiene parámetros para la llamada del modelo. La primera columna se utiliza como claves de parámetros y la segunda como valores. El parámetro API_KEY es obligatorio y su valor debe obtenerse de la consola OpenAI.

OAI.COST() calcula los costos de facturación de las celdas de finalización. Envuélvalo con SUM() para calcular un total.

Consulte los metadatos de la función para obtener documentación completa de funciones y parámetros. La presentación de Excel de la documentación de funciones personalizadas varía en su integridad según la plataforma, pero es mejor en el cuadro de diálogo Insertar función y/o en la plataforma de escritorio.

Precaución

Recomendamos precaución para evitar incurrir involuntariamente en costos excesivos cuando se trabaja con muchas celdas de terminación o terminaciones costosas. Los cambios en las celdas de dependencia pueden provocar un recálculo masivo y determinadas acciones en Excel pueden desencadenar un recálculo completo. Es posible que desee cambiar el modo de cálculo en Excel de automático a manual. Se realizan un máximo de 10 solicitudes de API en paralelo: para cancelar solicitudes en espera o pendientes, deshacer el cambio o eliminar la fórmula.

Usando resultados de finalización

Las completaciones completan la celda con un tipo de datos personalizado que incluye la solicitud y respuesta completa de la API. Su valor de texto es el contenido de la primera opción de finalización.

Para obtener el valor del texto para usarlo en fórmulas, use la función VALUETOTEXT() . Para obtener otros datos de solicitud/respuesta, utilice la notación de puntos en la ruta de la propiedad (por ejemplo, A123.response.model ).

Para ver los datos de finalización, abra la tarjeta de entidad. La propiedad lines proporciona una vista línea por línea del contenido de finalización.

Para extraer una respuesta final que siga una cadena de pensamiento, puedes usar una fórmula como:

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

Desarrollo de complementos

Instrucciones para comenzar con el trabajo de desarrollo.

Requisitos previos

Si está en Windows, configure NPM para usar un shell compatible con sh, por ejemplo:

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

Configure su IDE para que se ajuste al formato del código del proyecto. Para VSCode, estos se cargarán desde la configuración del espacio de trabajo en .vscode/ ; para otros editores/IDE deberá configurar de manera equivalente. Es posible que deba desarmar/deshabilitar cualquier configuración personal o extensión que interfiera.

Instalar y ejecutar

1. Instale las dependencias de npm ( npm i )
2. Generar e instalar certificados ( npm run install-certs )
3. Ejecute el servidor local ( npm start ).

Además, es posible que deba navegar hasta la raíz de su navegador y confiar temporalmente en el par de claves de certificado recién creado.

Abrir en Excel web

1. Abra una hoja de cálculo en Excel en la web y agregue los siguientes parámetros de cadena de consulta

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

2. Si se le solicita que habilite el modo de desarrollador de Excel, hágalo.

Ahora debería poder utilizar las funciones normalmente. Cuando realice un cambio, deberá recargar la ventana del navegador.

Abrir en el escritorio de Excel

npm run sideload:desktop

Archivos clave

Camino	Descripción
src/funciones/funciones.json	Los metadatos que detallan cada función y hacen referencia a su implementación.
src/funciones/funciones.mjs	Las funciones de JavaScript que implementan las funciones.
compartido.html	Página raíz cargada en segundo plano durante el inicio del complemento.
manifiesto-local.xml	Una versión de manifest.xml que hace referencia a https://localhost:3000/ para uso en desarrollo de complementos.
manifiesto.xml	Configura desde dónde se debe cargar el complemento y qué funciones utilizará.